@fonoster/sdk 0.30.0 → 0.31.0

package/README.md

@@ -64,7 +64,7 @@ In Node.js:
 ```typescript
 const SDK = require("@fonoster/sdk");
 const ACCESS_KEY_ID = "WO00000000000000000000000000000000";
-const ENDPOINT = "api.fonoster.com";
+const ENDPOINT = "api.fonoster.ai";
 const client = new SDK.Client({ accessKeyId: ACCESS_KEY_ID, endpoint: ENDPOINT });
 ```
 
@@ -75,7 +75,7 @@ In the browser:
 ```typescript
 const SDK = require("@fonoster/sdk");
 const ACCESS_KEY_ID = "WO00000000000000000000000000000000";
-const URL = "https://api.fonoster.com/v1beta2";
+const URL = "https://api.fonoster.ai/v1beta2";
 const client = new SDK.WebClient({ accessKeyId: ACCESS_KEY_ID, url: URL });
 ```
 
@@ -956,7 +956,7 @@ const request = {
     config: {
       conversationSettings: {
         firstMessage: "Hello, how can I help you today?",
-        systemPrompt: "You are a helpful assistant.",
+        systemPrompt: "You are a helpful agent.",
         systemErrorMessage: "I'm sorry, I didn't catch that. Can you say that again?",
         goodbyeMessage: "Thank you for calling. Have a great day!",
         languageModel: {
@@ -1140,6 +1140,7 @@ Retrieves a list of Calls from a Workspace.
 | request | <code>ListCallsRequest</code> | The request object that contains the necessary information to retrieve a list of Calls |
 | request.pageSize | <code>number</code> | The number of Calls to retrieve |
 | request.pageToken | <code>string</code> | The token to retrieve the next page of Calls |
+| request.appRef | <code>string</code> | Optional. Lists only the Calls the App with this reference handled |
 
 **Example**  
 ```js
@@ -1147,7 +1148,8 @@ const calls = new SDK.Calls(client); // Existing client object
 
 const request = {
   pageSize: 10,
-  pageToken: "00000000-0000-0000-0000-000000000000"
+  pageToken: "00000000-0000-0000-0000-000000000000",
+  appRef: "00000000-0000-0000-0000-000000000000" // Optional: only this App's Calls
 };
 
 calls

package/dist/node/Agents.js

@@ -114,15 +114,8 @@ class Agents {
             request: { ref },
             enumMapping: [["privacy", agents_pb_1.Privacy]]
         });
-        const credentials = response?.credentials?.toObject();
-        const domain = response?.domain?.toObject();
-        return response
-            ? {
-                ...response,
-                credentials,
-                domain
-            }
-            : null;
+        // The domain and credentials come back as plain objects (objectToJson).
+        return response ?? null;
     }
     /**
      * Updates an existing Agent in the Workspace.
@@ -192,19 +185,11 @@ class Agents {
             enumMapping: [["privacy", agents_pb_1.Privacy]],
             repeatableObjectMapping: [["itemsList", agents_pb_1.Agent]]
         });
-        // Manually extract nested objects for each agent
-        const processedItems = response.items?.map((agent) => {
-            const credentials = agent?.credentials?.toObject();
-            const domain = agent?.domain?.toObject();
-            return {
-                ...agent,
-                credentials,
-                domain
-            };
-        });
+        // Each agent's domain and credentials come back as plain objects
+        // (objectToJson); calling toObject() on them threw "toObject is not a function".
         return {
             ...response,
-            items: processedItems || []
+            items: response.items ?? []
         };
     }
     /**

package/dist/node/Applications.js

@@ -69,14 +69,18 @@ const REQUEST_OBJECTS = [
     ["speech", applications_pb_1.SpeechDefaults],
     ["audio", applications_pb_1.AudioFormat],
     ["listeners", applications_pb_1.Listener],
-    ["amd", applications_pb_1.AmdSettings]
+    ["amd", applications_pb_1.AmdSettings],
+    ["filters", applications_pb_1.AudioFilter]
 ];
+/** Repeated messages of an Application in responses (their options Structs are converted after). */
+const RESPONSE_REPEATED = [["filtersList", applications_pb_1.AudioFilter]];
 /** Repeated fields come back as `listenersList` when empty; always return `listeners`. */
 function withSessionFields(app) {
-    const { listenersList, ...rest } = app;
+    const { listenersList, filtersList, ...rest } = app;
     return {
         ...rest,
-        listeners: (rest.listeners ?? listenersList ?? [])
+        listeners: (rest.listeners ?? listenersList ?? []),
+        filters: (rest.filters ?? filtersList ?? [])
     };
 }
 class Applications {
@@ -151,7 +155,8 @@ class Applications {
             metadata: this.client.getMetadata(),
             request: { ref },
             enumMapping: [["type", applications_pb_1.ApplicationType]],
-            objectMapping: [["intelligence", applications_pb_1.ProductContainer]]
+            objectMapping: [["intelligence", applications_pb_1.ProductContainer]],
+            repeatableObjectMapping: RESPONSE_REPEATED
         });
         return withSessionFields((0, utils_1.buildStructOverrideReverse)(response));
     }
@@ -220,7 +225,10 @@ class Applications {
             request,
             enumMapping: [["type", applications_pb_1.ApplicationType]],
             objectMapping: [["intelligence", applications_pb_1.ProductContainer]],
-            repeatableObjectMapping: [["itemsList", applications_pb_1.Application]]
+            repeatableObjectMapping: [
+                ["itemsList", applications_pb_1.Application],
+                ...RESPONSE_REPEATED
+            ]
         });
         return {
             items: response.items.map((item) => withSessionFields((0, utils_1.buildStructOverrideReverse)(item))),

package/dist/node/Billing.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * 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.
+ */
+import { BillingSummary, CreatePortalSessionRequest, CreatePortalSessionResponse, CreateTopUpRequest, UpdateAutoRechargeRequest } from "@fonoster/types";
+import { FonosterClient } from "./client/types";
+/**
+ * @classdesc Fonoster Cloud's billing for the owner signed in: the balance in credits
+ * (1 credit = $0.01) by source, the plan, top-ups, auto-recharge and the Stripe Customer Portal.
+ * Only workspace owners may call it, and only on Fonoster Cloud (the capabilities say
+ * `billing.enabled`). The account is always the caller's: it covers every workspace they own.
+ *
+ * @example
+ * const billing = new SDK.Billing(client);
+ * const { balance, sources } = await billing.getBilling();
+ * await billing.createTopUp({ credits: 1000 });
+ */
+declare class Billing {
+    private readonly client;
+    constructor(client: FonosterClient);
+    /** The balance by source, the plan and auto-recharge. */
+    getBilling(): Promise<BillingSummary>;
+    /** Turns auto-recharge on or off, with its threshold and amount in credits. */
+    updateAutoRecharge(request: UpdateAutoRechargeRequest): Promise<BillingSummary>;
+    /**
+     * Buys top-up credits, charged to the payment method added in the Customer Portal, with tax on
+     * top. The credits appear once the payment succeeds.
+     */
+    createTopUp(request: CreateTopUpRequest): Promise<BillingSummary>;
+    /** Moves the owner from the Trial to Pay-as-you-go. Needs a payment method first. */
+    subscribe(): Promise<BillingSummary>;
+    /** A Stripe Customer Portal link for payment methods and invoices. */
+    createPortalSession(request: CreatePortalSessionRequest): Promise<CreatePortalSessionResponse>;
+    private summary;
+}
+export { Billing };

package/dist/node/Billing.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Billing = void 0;
+const makeRpcRequest_1 = require("./client/makeRpcRequest");
+const billing_pb_1 = require("./generated/node/billing_pb");
+/**
+ * @classdesc Fonoster Cloud's billing for the owner signed in: the balance in credits
+ * (1 credit = $0.01) by source, the plan, top-ups, auto-recharge and the Stripe Customer Portal.
+ * Only workspace owners may call it, and only on Fonoster Cloud (the capabilities say
+ * `billing.enabled`). The account is always the caller's: it covers every workspace they own.
+ *
+ * @example
+ * const billing = new SDK.Billing(client);
+ * const { balance, sources } = await billing.getBilling();
+ * await billing.createTopUp({ credits: 1000 });
+ */
+class Billing {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** The balance by source, the plan and auto-recharge. */
+    async getBilling() {
+        const client = this.client.getBillingClient();
+        return this.summary((0, makeRpcRequest_1.makeRpcRequest)({
+            method: client.getBilling.bind(client),
+            requestPBObjectConstructor: billing_pb_1.GetBillingRequest,
+            metadata: this.client.getMetadata(),
+            request: {},
+            repeatableObjectMapping: [["sourcesList", billing_pb_1.CreditSource]]
+        }));
+    }
+    /** Turns auto-recharge on or off, with its threshold and amount in credits. */
+    async updateAutoRecharge(request) {
+        const client = this.client.getBillingClient();
+        return this.summary((0, makeRpcRequest_1.makeRpcRequest)({
+            method: client.updateAutoRecharge.bind(client),
+            requestPBObjectConstructor: billing_pb_1.UpdateAutoRechargeRequest,
+            metadata: this.client.getMetadata(),
+            request,
+            repeatableObjectMapping: [["sourcesList", billing_pb_1.CreditSource]]
+        }));
+    }
+    /**
+     * Buys top-up credits, charged to the payment method added in the Customer Portal, with tax on
+     * top. The credits appear once the payment succeeds.
+     */
+    async createTopUp(request) {
+        const client = this.client.getBillingClient();
+        return this.summary((0, makeRpcRequest_1.makeRpcRequest)({
+            method: client.createTopUp.bind(client),
+            requestPBObjectConstructor: billing_pb_1.CreateTopUpRequest,
+            metadata: this.client.getMetadata(),
+            request,
+            repeatableObjectMapping: [["sourcesList", billing_pb_1.CreditSource]]
+        }));
+    }
+    /** Moves the owner from the Trial to Pay-as-you-go. Needs a payment method first. */
+    async subscribe() {
+        const client = this.client.getBillingClient();
+        return this.summary((0, makeRpcRequest_1.makeRpcRequest)({
+            method: client.subscribe.bind(client),
+            requestPBObjectConstructor: billing_pb_1.SubscribeRequest,
+            metadata: this.client.getMetadata(),
+            request: {},
+            repeatableObjectMapping: [["sourcesList", billing_pb_1.CreditSource]]
+        }));
+    }
+    /** A Stripe Customer Portal link for payment methods and invoices. */
+    async createPortalSession(request) {
+        const client = this.client.getBillingClient();
+        return (0, makeRpcRequest_1.makeRpcRequest)({
+            method: client.createPortalSession.bind(client),
+            requestPBObjectConstructor: billing_pb_1.CreatePortalSessionRequest,
+            metadata: this.client.getMetadata(),
+            request
+        });
+    }
+    async summary(raw) {
+        const { sources, ...rest } = await raw;
+        return { ...rest, sources: sources ?? [] };
+    }
+}
+exports.Billing = Billing;

package/dist/node/CallRecords.js

@@ -33,11 +33,14 @@ class CallRecords {
     constructor(client, options = {}) {
         this.client = client;
         this.baseUrl = options.baseUrl?.replace(/\/+$/, "");
+        // Called as a method below, so never store the global unbound: in browsers a detached
+        // `fetch` throws "Illegal invocation".
         this.fetchFn =
-            options.fetch ?? globalThis.fetch;
+            options.fetch ??
+                ((input, init) => globalThis.fetch(input, init));
     }
     url(path, query = {}) {
-        const base = this.baseUrl ?? this.client.getHttpUrl?.() ?? "https://api.fonoster.com";
+        const base = this.baseUrl ?? this.client.getHttpUrl?.() ?? "https://api.fonoster.ai";
         const qs = Object.entries(query)
             .filter(([, v]) => v !== undefined && v !== null && v !== "")
             .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`)

package/dist/node/Calls.d.ts

@@ -126,13 +126,15 @@ declare class Calls {
      * @param {ListCallsRequest} request - The request object that contains the necessary information to retrieve a list of Calls
      * @param {number} request.pageSize - The number of Calls to retrieve
      * @param {string} request.pageToken - The token to retrieve the next page of Calls
+     * @param {string} request.appRef - Optional. Lists only the Calls the App with this reference handled
      * @return {Promise<ListCallsResponse>} - The response object that contains the list of Calls
      * @example
      * const calls = new SDK.Calls(client); // Existing client object
      *
      * const request = {
      *   pageSize: 10,
-     *   pageToken: "00000000-0000-0000-0000-000000000000"
+     *   pageToken: "00000000-0000-0000-0000-000000000000",
+     *   appRef: "00000000-0000-0000-0000-000000000000" // Optional: only this App's Calls
      * };
      *
      * calls

package/dist/node/Calls.js

@@ -175,13 +175,15 @@ class Calls {
      * @param {ListCallsRequest} request - The request object that contains the necessary information to retrieve a list of Calls
      * @param {number} request.pageSize - The number of Calls to retrieve
      * @param {string} request.pageToken - The token to retrieve the next page of Calls
+     * @param {string} request.appRef - Optional. Lists only the Calls the App with this reference handled
      * @return {Promise<ListCallsResponse>} - The response object that contains the list of Calls
      * @example
      * const calls = new SDK.Calls(client); // Existing client object
      *
      * const request = {
      *   pageSize: 10,
-     *   pageToken: "00000000-0000-0000-0000-000000000000"
+     *   pageToken: "00000000-0000-0000-0000-000000000000",
+     *   appRef: "00000000-0000-0000-0000-000000000000" // Optional: only this App's Calls
      * };
      *
      * calls

package/dist/node/Numbers.js

@@ -110,13 +110,8 @@ class Numbers {
             metadata: this.client.getMetadata(),
             request: { ref }
         });
-        const trunk = response?.trunk?.toObject();
-        return response
-            ? {
-                ...response,
-                trunk
-            }
-            : null;
+        // The trunk comes back as a plain object (objectToJson).
+        return response ?? null;
     }
     /**
      * Updates an existing Number in the Workspace.

package/dist/node/Providers.js

@@ -8,7 +8,8 @@ function toItem(raw) {
     const out = {};
     for (const [key, value] of Object.entries(raw)) {
         const name = key.endsWith("List") ? key.slice(0, -4) : key;
-        if (value === "")
+        // Proto3 defaults: "" is unset, and keyless is false for anything but a keyless provider.
+        if (value === "" || (name === "keyless" && !value))
             continue;
         out[name] = value;
     }
@@ -82,7 +83,8 @@ class Providers {
                 const out = {};
                 for (const [key, value] of Object.entries(w)) {
                     const name = key.endsWith("List") ? key.slice(0, -4) : key;
-                    if (value === "")
+                    // Proto3 defaults: "" is unset, and keyless is false for anything but a keyless provider.
+                    if (value === "" || (name === "keyless" && !value))
                         continue;
                     out[name] = value;
                 }

package/dist/node/Regions.js

@@ -33,8 +33,11 @@ class Regions {
     constructor(client, options = {}) {
         this.client = client;
         this.baseUrl = options.baseUrl?.replace(/\/+$/, "");
+        // Called as a method below, so never store the global unbound: in browsers a detached
+        // `fetch` throws "Illegal invocation".
         this.fetchFn =
-            options.fetch ?? globalThis.fetch;
+            options.fetch ??
+                ((input, init) => globalThis.fetch(input, init));
     }
     headers(auth, body) {
         const h = {};
@@ -51,7 +54,7 @@ class Regions {
         return h;
     }
     async json(path, method = "GET", body, auth = true) {
-        const base = this.baseUrl ?? this.client.getHttpUrl?.() ?? "https://api.fonoster.com";
+        const base = this.baseUrl ?? this.client.getHttpUrl?.() ?? "https://api.fonoster.ai";
         const attempt = () => this.fetchFn(`${base}/api/regions${path}`, {
             method,
             headers: this.headers(auth, body),

package/dist/node/Usage.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * 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.
+ */
+import { GetUsageRequest, GetUsageResponse } from "@fonoster/types";
+import { FonosterClient } from "./client/types";
+/**
+ * @classdesc What the workspace consumed: call minutes, speech, language-model tokens, noise
+ * cancelling, answering-machine detections, recordings and storage. Quantities only, never money.
+ * Each total says whose key a vendor was called with (`keySource`: `workspace` or `platform`).
+ *
+ * @example
+ * const usage = new SDK.Usage(client);
+ * const { rows } = await usage.getUsage({
+ *   fromDay: "2026-10-01",
+ *   toDay: "2026-10-31",
+ *   groupBy: ["key_source"]
+ * });
+ */
+declare class Usage {
+    private readonly client;
+    constructor(client: FonosterClient);
+    /**
+     * Usage totals for a range of days (UTC, inclusive), split by meter and by the dimensions in
+     * `groupBy` (day, workspace, provider, model, key_source, origin). With `allOwned`, a workspace
+     * owner gets every workspace they own.
+     */
+    getUsage(request: GetUsageRequest): Promise<GetUsageResponse>;
+}
+export { Usage };

package/dist/node/Usage.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Usage = void 0;
+const makeRpcRequest_1 = require("./client/makeRpcRequest");
+const usage_pb_1 = require("./generated/node/usage_pb");
+/**
+ * @classdesc What the workspace consumed: call minutes, speech, language-model tokens, noise
+ * cancelling, answering-machine detections, recordings and storage. Quantities only, never money.
+ * Each total says whose key a vendor was called with (`keySource`: `workspace` or `platform`).
+ *
+ * @example
+ * const usage = new SDK.Usage(client);
+ * const { rows } = await usage.getUsage({
+ *   fromDay: "2026-10-01",
+ *   toDay: "2026-10-31",
+ *   groupBy: ["key_source"]
+ * });
+ */
+class Usage {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Usage totals for a range of days (UTC, inclusive), split by meter and by the dimensions in
+     * `groupBy` (day, workspace, provider, model, key_source, origin). With `allOwned`, a workspace
+     * owner gets every workspace they own.
+     */
+    async getUsage(request) {
+        const client = this.client.getUsageClient();
+        const raw = await (0, makeRpcRequest_1.makeRpcRequest)({
+            method: client.getUsage.bind(client),
+            requestPBObjectConstructor: usage_pb_1.GetUsageRequest,
+            metadata: this.client.getMetadata(),
+            request: { groupBy: [], ...request },
+            repeatableObjectMapping: [["rowsList", usage_pb_1.UsageRow]]
+        });
+        return { rows: raw.rows ?? [] };
+    }
+}
+exports.Usage = Usage;

package/dist/node/client/AbstractClient.d.ts

@@ -21,11 +21,13 @@ import { GetCapabilitiesResponse as GetCapabilitiesResponsePB } from "../generat
 import { ApplicationsClient, CallsClient, CapabilitiesClient, FonosterClient, IdentityClient, SecretsClient } from "./types";
 import { AclsClient } from "./types/AclsClient";
 import { AgentsClient } from "./types/AgentsClient";
+import { BillingClient } from "./types/BillingClient";
 import { CredentialsClient } from "./types/CredentialsClient";
 import { DomainsClient } from "./types/DomainsClient";
 import { NumbersClient } from "./types/NumbersClient";
 import { ProvidersClient } from "./types/ProvidersClient";
 import { TrunksClient } from "./types/TrunksClient";
+import { UsageClient } from "./types/UsageClient";
 import { WebhooksClient } from "./types/WebhooksClient";
 type AuthMethod = "password" | "email_code" | "github";
 /** The deployment's capabilities, from the Capabilities service. */
@@ -60,6 +62,13 @@ type Capabilities = {
      * Empty lists when the operator listed none or the server is older.
      */
     connection: ConnectionDetails;
+    /**
+     * How SIP names (trunk inbound URIs, domains) are checked: "domain" (one
+     * label under `sip.<domain>`, the default) or "any" (any host or IP).
+     */
+    sip: {
+        names: "domain" | "any";
+    };
 };
 type SipTransport = "udp" | "tcp" | "tls" | "ws" | "wss";
 type ConnectionDetails = {
@@ -143,6 +152,8 @@ declare abstract class AbstractClient implements FonosterClient {
     abstract getCallsClient(): CallsClient;
     abstract getWebhooksClient(): WebhooksClient;
     abstract getProvidersClient(): ProvidersClient;
+    abstract getUsageClient(): UsageClient;
+    abstract getBillingClient(): BillingClient;
     abstract getHttpUrl(): string;
 }
 export { AbstractClient, AuthMethod, Capabilities, ConnectionDetails, toConnectionDetails };

package/dist/node/client/AbstractClient.js

@@ -168,7 +168,11 @@ class AbstractClient {
                     regions: {
                         private: response.getRegions()?.getPrivate() ?? false
                     },
-                    connection: toConnectionDetails(response)
+                    connection: toConnectionDetails(response),
+                    sip: {
+                        // Older servers don't send it; they checked nothing.
+                        names: response.getSip()?.getNames() === "domain" ? "domain" : "any"
+                    }
                 });
             });
         });

package/dist/node/client/Client.d.ts

@@ -44,6 +44,8 @@ export declare class Client extends AbstractClient {
     getNumbersClient(): any;
     getWebhooksClient(): any;
     getProvidersClient(): any;
+    getUsageClient(): any;
+    getBillingClient(): any;
     getHttpUrl(): string;
     getCredentialsClient(): any;
 }

package/dist/node/client/Client.js

@@ -23,6 +23,7 @@ const grpc_js_1 = require("@grpc/grpc-js");
 const acls_grpc_pb_1 = require("../generated/node/acls_grpc_pb");
 const agents_grpc_pb_1 = require("../generated/node/agents_grpc_pb");
 const applications_grpc_pb_1 = require("../generated/node/applications_grpc_pb");
+const billing_grpc_pb_1 = require("../generated/node/billing_grpc_pb");
 const calls_grpc_pb_1 = require("../generated/node/calls_grpc_pb");
 const capabilities_grpc_pb_1 = require("../generated/node/capabilities_grpc_pb");
 const credentials_grpc_pb_1 = require("../generated/node/credentials_grpc_pb");
@@ -32,10 +33,11 @@ const numbers_grpc_pb_1 = require("../generated/node/numbers_grpc_pb");
 const providers_grpc_pb_1 = require("../generated/node/providers_grpc_pb");
 const secrets_grpc_pb_1 = require("../generated/node/secrets_grpc_pb");
 const trunks_grpc_pb_1 = require("../generated/node/trunks_grpc_pb");
+const usage_grpc_pb_1 = require("../generated/node/usage_grpc_pb");
 const webhooks_grpc_pb_1 = require("../generated/node/webhooks_grpc_pb");
 const AbstractClient_1 = require("./AbstractClient");
 const TokenRefresherNode_1 = require("./TokenRefresherNode");
-const DEFAULT_ENDPOINT = "api.fonoster.com";
+const DEFAULT_ENDPOINT = "api.fonoster.ai";
 class Client extends AbstractClient_1.AbstractClient {
     endpoint;
     httpUrl;
@@ -123,6 +125,16 @@ class Client extends AbstractClient_1.AbstractClient {
             interceptors: [this.tokenRefresherInterceptor]
         });
     }
+    getUsageClient() {
+        return new usage_grpc_pb_1.UsageClient(this.endpoint, this.channelCredentials, {
+            interceptors: [this.tokenRefresherInterceptor]
+        });
+    }
+    getBillingClient() {
+        return new billing_grpc_pb_1.BillingClient(this.endpoint, this.channelCredentials, {
+            interceptors: [this.tokenRefresherInterceptor]
+        });
+    }
     getHttpUrl() {
         return (this.httpUrl ?? `https://${this.endpoint.replace(/:\d+$/, "")}`).replace(/\/+$/, "");
     }

package/dist/node/client/types/BillingClient.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * 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.
+ */
+import { BillingSummary, CreatePortalSessionRequest, CreatePortalSessionResponse, CreateTopUpRequest, GetBillingRequest, SubscribeRequest, UpdateAutoRechargeRequest } from "../../generated/web/billing_pb";
+import { ClientFunction } from "./common";
+type BillingClient = {
+    getBilling: ClientFunction<GetBillingRequest, BillingSummary>;
+    updateAutoRecharge: ClientFunction<UpdateAutoRechargeRequest, BillingSummary>;
+    createTopUp: ClientFunction<CreateTopUpRequest, BillingSummary>;
+    subscribe: ClientFunction<SubscribeRequest, BillingSummary>;
+    createPortalSession: ClientFunction<CreatePortalSessionRequest, CreatePortalSessionResponse>;
+};
+export { BillingClient };

package/dist/node/client/types/BillingClient.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/node/client/types/FonosterClient.d.ts

@@ -19,6 +19,7 @@
 import { AclsClient } from "./AclsClient";
 import { AgentsClient } from "./AgentsClient";
 import { ApplicationsClient } from "./ApplicationsClient";
+import { BillingClient } from "./BillingClient";
 import { CallsClient } from "./CallsClient";
 import { CapabilitiesClient } from "./CapabilitiesClient";
 import { CredentialsClient } from "./CredentialsClient";
@@ -28,6 +29,7 @@ import { NumbersClient } from "./NumbersClient";
 import { ProvidersClient } from "./ProvidersClient";
 import { SecretsClient } from "./SecretsClient";
 import { TrunksClient } from "./TrunksClient";
+import { UsageClient } from "./UsageClient";
 import { WebhooksClient } from "./WebhooksClient";
 interface FonosterClient {
     getAccessToken(): string;
@@ -45,7 +47,9 @@ interface FonosterClient {
     getAclsClient(): AclsClient;
     getWebhooksClient(): WebhooksClient;
     getProvidersClient(): ProvidersClient;
-    /** Base URL of the HTTP API (/api/records), e.g. https://api.fonoster.com. */
+    getUsageClient(): UsageClient;
+    getBillingClient(): BillingClient;
+    /** Base URL of the HTTP API (/api/records), e.g. https://api.fonoster.ai. */
     getHttpUrl?(): string;
     getMetadata(): unknown;
     refreshToken(): Promise<void>;

package/dist/node/client/types/UsageClient.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * 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.
+ */
+import { GetUsageRequest, GetUsageResponse } from "../../generated/web/usage_pb";
+import { ClientFunction } from "./common";
+type UsageClient = {
+    getUsage: ClientFunction<GetUsageRequest, GetUsageResponse>;
+};
+export { UsageClient };

package/dist/node/client/types/UsageClient.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });