Adding the phone number apis for usage in lkcli (#764)

Author: nishadmusthafa

phonenumberclient.go

@@ -0,0 +1,127 @@
+// Copyright 2024 LiveKit, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package lksdk
+
+import (
+	"context"
+	"net/http"
+	"time"
+
+	"github.com/twitchtv/twirp"
+
+	"github.com/livekit/protocol/livekit"
+	"github.com/livekit/protocol/utils/xtwirp"
+	"github.com/livekit/server-sdk-go/v2/signalling"
+)
+
+type PhoneNumberClient struct {
+	phoneNumberClient livekit.PhoneNumberService
+	authBase
+}
+
+// NewPhoneNumberClient creates a LiveKit Phone Number client.
+func NewPhoneNumberClient(url string, apiKey string, secretKey string, opts ...twirp.ClientOption) *PhoneNumberClient {
+	opts = append(opts, xtwirp.DefaultClientOptions()...)
+	return &PhoneNumberClient{
+		phoneNumberClient: livekit.NewPhoneNumberServiceProtobufClient(signalling.ToHttpURL(url), &http.Client{}, opts...),
+		authBase: authBase{
+			apiKey:    apiKey,
+			apiSecret: secretKey,
+		},
+	}
+}
+
+// SearchPhoneNumbers searches for available phone numbers in inventory.
+func (p *PhoneNumberClient) SearchPhoneNumbers(ctx context.Context, in *livekit.SearchPhoneNumbersRequest) (*livekit.SearchPhoneNumbersResponse, error) {
+	if in == nil {
+		return nil, ErrInvalidParameter
+	}
+
+	ctx, err := p.withAuth(ctx, withSIPGrant{Admin: true})
+	if err != nil {
+		return nil, err
+	}
+
+	// Add timeout to prevent connection issues
+	ctx, cancel := context.WithTimeout(ctx, 30*time.Second)
+	defer cancel()
+
+	return p.phoneNumberClient.SearchPhoneNumbers(ctx, in)
+}
+
+// PurchasePhoneNumber purchases a phone number from inventory.
+func (p *PhoneNumberClient) PurchasePhoneNumber(ctx context.Context, in *livekit.PurchasePhoneNumberRequest) (*livekit.PurchasePhoneNumberResponse, error) {
+	if in == nil {
+		return nil, ErrInvalidParameter
+	}
+
+	ctx, err := p.withAuth(ctx, withSIPGrant{Admin: true})
+	if err != nil {
+		return nil, err
+	}
+	return p.phoneNumberClient.PurchasePhoneNumber(ctx, in)
+}
+
+// ListPhoneNumbers lists phone numbers for a project.
+func (p *PhoneNumberClient) ListPhoneNumbers(ctx context.Context, in *livekit.ListPhoneNumbersRequest) (*livekit.ListPhoneNumbersResponse, error) {
+	if in == nil {
+		return nil, ErrInvalidParameter
+	}
+
+	ctx, err := p.withAuth(ctx, withSIPGrant{Admin: true})
+	if err != nil {
+		return nil, err
+	}
+	return p.phoneNumberClient.ListPhoneNumbers(ctx, in)
+}
+
+// GetPhoneNumber gets a phone number from a project.
+func (p *PhoneNumberClient) GetPhoneNumber(ctx context.Context, in *livekit.GetPhoneNumberRequest) (*livekit.GetPhoneNumberResponse, error) {
+	if in == nil {
+		return nil, ErrInvalidParameter
+	}
+
+	ctx, err := p.withAuth(ctx, withSIPGrant{Admin: true})
+	if err != nil {
+		return nil, err
+	}
+	return p.phoneNumberClient.GetPhoneNumber(ctx, in)
+}
+
+// UpdatePhoneNumber updates a phone number in a project.
+func (p *PhoneNumberClient) UpdatePhoneNumber(ctx context.Context, in *livekit.UpdatePhoneNumberRequest) (*livekit.UpdatePhoneNumberResponse, error) {
+	if in == nil {
+		return nil, ErrInvalidParameter
+	}
+
+	ctx, err := p.withAuth(ctx, withSIPGrant{Admin: true})
+	if err != nil {
+		return nil, err
+	}
+	return p.phoneNumberClient.UpdatePhoneNumber(ctx, in)
+}
+
+// ReleasePhoneNumbers releases phone numbers.
+func (p *PhoneNumberClient) ReleasePhoneNumbers(ctx context.Context, in *livekit.ReleasePhoneNumbersRequest) (*livekit.ReleasePhoneNumbersResponse, error) {
+	if in == nil {
+		return nil, ErrInvalidParameter
+	}
+
+	ctx, err := p.withAuth(ctx, withSIPGrant{Admin: true})
+	if err != nil {
+		return nil, err
+	}
+	return p.phoneNumberClient.ReleasePhoneNumbers(ctx, in)
+}