@surgeapi/node 0.25.6 → 0.26.0

package/resources/messages.d.ts

@@ -0,0 +1,263 @@
+import { APIResource } from "../core/resource.js";
+import * as MessagesAPI from "./messages.js";
+import * as ContactsAPI from "./contacts.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+export declare class Messages extends APIResource {
+    /**
+     * Creates and enqueues a new message to be sent.
+     *
+     * Messages are always sent asynchronously. When you hit this endpoint, the message
+     * will be created within Surge's system and enqueued for sending, and then the id
+     * for the new message will be returned. When the message is actually sent, a
+     * `message.sent` webhook event will be triggered and sent to any webhook endpoints
+     * that you have subscribed to this event type. Then a `message.delivered` webhook
+     * event will be triggered when the carrier sends us a delivery receipt.
+     *
+     * By default all messages will be sent immediately. If you would like to schedule
+     * sending for some time up to 60 days in the future, you can do that by providing
+     * a value for the `send_at` field. This should be formatted as an ISO8601 datetime
+     * like `2028-10-14T18:06:00Z`.
+     *
+     * You must include either a `body` or `attachments` field (or both) in the request
+     * body. The `body` field should contain the text of the message you want to send,
+     * and the `attachments` field should be an array of objects with a `url` field
+     * pointing to the file you want to attach. Surge will download these files and
+     * send them as attachments in the message.
+     *
+     * You can provide either a `conversation` object or a `to` field to specify the
+     * intended recipient of the message, but an error will be returned if both fields
+     * are provided. Similarly the `from` field cannot be used together with the
+     * `conversation` field, and `conversation.phone_number` should be specified
+     * instead.
+     *
+     * @example
+     * ```ts
+     * const message = await client.messages.create(
+     *   'acct_01j9a43avnfqzbjfch6pygv1td',
+     *   {
+     *     conversation: {
+     *       contact: { phone_number: '+18015551234' },
+     *     },
+     *   },
+     * );
+     * ```
+     */
+    create(accountID: string, body: MessageCreateParams, options?: RequestOptions): APIPromise<Message>;
+}
+/**
+ * Params for creating an attachment
+ */
+export interface AttachmentParams {
+    /**
+     * The URL of the attachment.
+     */
+    url: string;
+}
+/**
+ * A Message is a communication sent to a Contact.
+ */
+export interface Message {
+    /**
+     * Unique identifier for the object.
+     */
+    id?: string;
+    attachments?: Array<Message.Attachment>;
+    /**
+     * The message body.
+     */
+    body?: string;
+    /**
+     * A conversation with a Contact
+     */
+    conversation?: Message.Conversation;
+}
+export declare namespace Message {
+    /**
+     * An Attachment is a file that can be sent with a message.
+     */
+    interface Attachment {
+        /**
+         * Unique identifier for the object.
+         */
+        id?: string;
+        /**
+         * The type of attachment.
+         */
+        type?: string;
+        /**
+         * The URL of the attachment.
+         */
+        url?: string;
+    }
+    /**
+     * A conversation with a Contact
+     */
+    interface Conversation {
+        /**
+         * Unique identifier for the object.
+         */
+        id: string;
+        /**
+         * A contact who has consented to receive messages
+         */
+        contact: ContactsAPI.Contact;
+        /**
+         * This is the phone number tied to the Surge account.
+         */
+        phone_number?: Conversation.PhoneNumber;
+    }
+    namespace Conversation {
+        /**
+         * This is the phone number tied to the Surge account.
+         */
+        interface PhoneNumber {
+            /**
+             * Unique identifier for the phone number
+             */
+            id: string;
+            /**
+             * The canonical format of the phone number.
+             */
+            number: string;
+            /**
+             * Whether the phone number is local, toll-free, or short code
+             */
+            type: 'local' | 'toll_free' | 'short_code' | 'demo';
+        }
+    }
+}
+/**
+ * Payload for creating a message. Either an attachment or the body must be given.
+ * You can specify the recipient either using the 'conversation' parameter or the
+ * 'to'/'from' parameters, but not both.
+ */
+export type MessageParams = MessageParams.MessageParamsWithConversation | MessageParams.SimpleMessageParams;
+export declare namespace MessageParams {
+    /**
+     * Create a message while including parameters for the conversation in which the
+     * message should be sent.
+     */
+    interface MessageParamsWithConversation {
+        /**
+         * Params for selecting or creating a new conversation. Either the id or the
+         * Contact must be given.
+         */
+        conversation: MessageParamsWithConversation.Conversation;
+        attachments?: Array<MessagesAPI.AttachmentParams>;
+        /**
+         * The message body.
+         */
+        body?: string;
+        /**
+         * An optional datetime for scheduling message up to a couple of months in the
+         * future.
+         */
+        send_at?: string;
+    }
+    namespace MessageParamsWithConversation {
+        /**
+         * Params for selecting or creating a new conversation. Either the id or the
+         * Contact must be given.
+         */
+        interface Conversation {
+            /**
+             * Parameters for creating a contact
+             */
+            contact: ContactsAPI.ContactParams;
+            /**
+             * The phone number from which to send the message. This can be either the phone
+             * number in E.164 format or a Surge phone number id.
+             */
+            phone_number?: string;
+        }
+    }
+    /**
+     * Create a basic message by specifying just the to/from phone numbers.
+     */
+    interface SimpleMessageParams {
+        /**
+         * The recipient's phone number in E.164 format. Cannot be used together with
+         * 'conversation'.
+         */
+        to: string;
+        attachments?: Array<MessagesAPI.AttachmentParams>;
+        /**
+         * The message body.
+         */
+        body?: string;
+        /**
+         * The sender's phone number in E.164 format or phone number ID. If omitted, uses
+         * the account's default phone number. Cannot be used together with 'conversation'.
+         */
+        from?: string;
+        /**
+         * An optional datetime for scheduling message up to a couple of months in the
+         * future.
+         */
+        send_at?: string;
+    }
+}
+export type MessageCreateParams = MessageCreateParams.MessageParamsWithConversation | MessageCreateParams.SimpleMessageParams;
+export declare namespace MessageCreateParams {
+    interface MessageParamsWithConversation {
+        /**
+         * Params for selecting or creating a new conversation. Either the id or the
+         * Contact must be given.
+         */
+        conversation: MessageParamsWithConversation.Conversation;
+        attachments?: Array<AttachmentParams>;
+        /**
+         * The message body.
+         */
+        body?: string;
+        /**
+         * An optional datetime for scheduling message up to a couple of months in the
+         * future.
+         */
+        send_at?: string;
+    }
+    namespace MessageParamsWithConversation {
+        /**
+         * Params for selecting or creating a new conversation. Either the id or the
+         * Contact must be given.
+         */
+        interface Conversation {
+            /**
+             * Parameters for creating a contact
+             */
+            contact: ContactsAPI.ContactParams;
+            /**
+             * The phone number from which to send the message. This can be either the phone
+             * number in E.164 format or a Surge phone number id.
+             */
+            phone_number?: string;
+        }
+    }
+    interface SimpleMessageParams {
+        /**
+         * The recipient's phone number in E.164 format. Cannot be used together with
+         * 'conversation'.
+         */
+        to: string;
+        attachments?: Array<AttachmentParams>;
+        /**
+         * The message body.
+         */
+        body?: string;
+        /**
+         * The sender's phone number in E.164 format or phone number ID. If omitted, uses
+         * the account's default phone number. Cannot be used together with 'conversation'.
+         */
+        from?: string;
+        /**
+         * An optional datetime for scheduling message up to a couple of months in the
+         * future.
+         */
+        send_at?: string;
+    }
+}
+export declare namespace Messages {
+    export { type AttachmentParams as AttachmentParams, type Message as Message, type MessageParams as MessageParams, type MessageCreateParams as MessageCreateParams, };
+}
+//# sourceMappingURL=messages.d.ts.map

package/resources/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/resources/messages.ts"],"names":[],"mappings":"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"}

package/resources/messages.js

@@ -0,0 +1,52 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Messages = void 0;
+const resource_1 = require("../core/resource.js");
+const path_1 = require("../internal/utils/path.js");
+class Messages extends resource_1.APIResource {
+    /**
+     * Creates and enqueues a new message to be sent.
+     *
+     * Messages are always sent asynchronously. When you hit this endpoint, the message
+     * will be created within Surge's system and enqueued for sending, and then the id
+     * for the new message will be returned. When the message is actually sent, a
+     * `message.sent` webhook event will be triggered and sent to any webhook endpoints
+     * that you have subscribed to this event type. Then a `message.delivered` webhook
+     * event will be triggered when the carrier sends us a delivery receipt.
+     *
+     * By default all messages will be sent immediately. If you would like to schedule
+     * sending for some time up to 60 days in the future, you can do that by providing
+     * a value for the `send_at` field. This should be formatted as an ISO8601 datetime
+     * like `2028-10-14T18:06:00Z`.
+     *
+     * You must include either a `body` or `attachments` field (or both) in the request
+     * body. The `body` field should contain the text of the message you want to send,
+     * and the `attachments` field should be an array of objects with a `url` field
+     * pointing to the file you want to attach. Surge will download these files and
+     * send them as attachments in the message.
+     *
+     * You can provide either a `conversation` object or a `to` field to specify the
+     * intended recipient of the message, but an error will be returned if both fields
+     * are provided. Similarly the `from` field cannot be used together with the
+     * `conversation` field, and `conversation.phone_number` should be specified
+     * instead.
+     *
+     * @example
+     * ```ts
+     * const message = await client.messages.create(
+     *   'acct_01j9a43avnfqzbjfch6pygv1td',
+     *   {
+     *     conversation: {
+     *       contact: { phone_number: '+18015551234' },
+     *     },
+     *   },
+     * );
+     * ```
+     */
+    create(accountID, body, options) {
+        return this._client.post((0, path_1.path) `/accounts/${accountID}/messages`, { body, ...options });
+    }
+}
+exports.Messages = Messages;
+//# sourceMappingURL=messages.js.map

package/resources/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/resources/messages.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAK/C,oDAA8C;AAE9C,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACH,MAAM,CAAC,SAAiB,EAAE,IAAyB,EAAE,OAAwB;QAC3E,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,aAAa,SAAS,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxF,CAAC;CACF;AA3CD,4BA2CC"}

package/resources/messages.mjs

@@ -0,0 +1,48 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+import { path } from "../internal/utils/path.mjs";
+export class Messages extends APIResource {
+    /**
+     * Creates and enqueues a new message to be sent.
+     *
+     * Messages are always sent asynchronously. When you hit this endpoint, the message
+     * will be created within Surge's system and enqueued for sending, and then the id
+     * for the new message will be returned. When the message is actually sent, a
+     * `message.sent` webhook event will be triggered and sent to any webhook endpoints
+     * that you have subscribed to this event type. Then a `message.delivered` webhook
+     * event will be triggered when the carrier sends us a delivery receipt.
+     *
+     * By default all messages will be sent immediately. If you would like to schedule
+     * sending for some time up to 60 days in the future, you can do that by providing
+     * a value for the `send_at` field. This should be formatted as an ISO8601 datetime
+     * like `2028-10-14T18:06:00Z`.
+     *
+     * You must include either a `body` or `attachments` field (or both) in the request
+     * body. The `body` field should contain the text of the message you want to send,
+     * and the `attachments` field should be an array of objects with a `url` field
+     * pointing to the file you want to attach. Surge will download these files and
+     * send them as attachments in the message.
+     *
+     * You can provide either a `conversation` object or a `to` field to specify the
+     * intended recipient of the message, but an error will be returned if both fields
+     * are provided. Similarly the `from` field cannot be used together with the
+     * `conversation` field, and `conversation.phone_number` should be specified
+     * instead.
+     *
+     * @example
+     * ```ts
+     * const message = await client.messages.create(
+     *   'acct_01j9a43avnfqzbjfch6pygv1td',
+     *   {
+     *     conversation: {
+     *       contact: { phone_number: '+18015551234' },
+     *     },
+     *   },
+     * );
+     * ```
+     */
+    create(accountID, body, options) {
+        return this._client.post(path `/accounts/${accountID}/messages`, { body, ...options });
+    }
+}
+//# sourceMappingURL=messages.mjs.map

package/resources/messages.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.mjs","sourceRoot":"","sources":["../src/resources/messages.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAKf,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACH,MAAM,CAAC,SAAiB,EAAE,IAAyB,EAAE,OAAwB;QAC3E,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,aAAa,SAAS,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxF,CAAC;CACF"}

package/resources/phone-numbers.d.mts

@@ -0,0 +1,90 @@
+import { APIResource } from "../core/resource.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+export declare class PhoneNumbers extends APIResource {
+    /**
+     * Purchase a new phone number for the account. You can specify search criteria or
+     * let the system select a random number.
+     *
+     * @example
+     * ```ts
+     * const phoneNumber = await client.phoneNumbers.purchase(
+     *   'acct_01j9a43avnfqzbjfch6pygv1td',
+     * );
+     * ```
+     */
+    purchase(accountID: string, body: PhoneNumberPurchaseParams, options?: RequestOptions): APIPromise<PhoneNumber>;
+}
+/**
+ * A phone number that can be used to send and receive messages and calls
+ */
+export interface PhoneNumber {
+    /**
+     * Unique identifier for the phone number
+     */
+    id: string;
+    /**
+     * The phone number in E.164 format
+     */
+    number: string;
+    /**
+     * Whether the phone number is local, toll-free, or short code
+     */
+    type: 'local' | 'toll_free';
+}
+/**
+ * Parameters for purchasing a new phone number. The system will automatically
+ * infer the type in certain cases:
+ *
+ * - If only area_code is provided, type is inferred from the area code
+ * - If only latitude/longitude are provided, type is inferred as 'local'
+ * - Otherwise, type must be explicitly specified
+ */
+export interface PhoneNumberPurchaseParams {
+    /**
+     * The desired area code for this phone number. If provided without type, the type
+     * will be inferred.
+     */
+    area_code?: string;
+    /**
+     * Latitude to search for nearby phone numbers. Must be used with longitude. If
+     * provided without type, type will be inferred as 'local'.
+     */
+    latitude?: number;
+    /**
+     * Longitude to search for nearby phone numbers. Must be used with latitude. If
+     * provided without type, type will be inferred as 'local'.
+     */
+    longitude?: number;
+    /**
+     * Whether the phone number is local or toll-free. Can be omitted if area_code or
+     * latitude/longitude are provided.
+     */
+    type?: 'local' | 'toll_free';
+}
+export interface PhoneNumberPurchaseParams {
+    /**
+     * The desired area code for this phone number. If provided without type, the type
+     * will be inferred.
+     */
+    area_code?: string;
+    /**
+     * Latitude to search for nearby phone numbers. Must be used with longitude. If
+     * provided without type, type will be inferred as 'local'.
+     */
+    latitude?: number;
+    /**
+     * Longitude to search for nearby phone numbers. Must be used with latitude. If
+     * provided without type, type will be inferred as 'local'.
+     */
+    longitude?: number;
+    /**
+     * Whether the phone number is local or toll-free. Can be omitted if area_code or
+     * latitude/longitude are provided.
+     */
+    type?: 'local' | 'toll_free';
+}
+export declare namespace PhoneNumbers {
+    export { type PhoneNumber as PhoneNumber, type PhoneNumberPurchaseParams as PhoneNumberPurchaseParams };
+}
+//# sourceMappingURL=phone-numbers.d.mts.map

package/resources/phone-numbers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone-numbers.d.mts","sourceRoot":"","sources":["../src/resources/phone-numbers.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;;;;;;;;;OAUG;IACH,QAAQ,CACN,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,yBAAyB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,WAAW,CAAC;CAG3B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,OAAO,GAAG,WAAW,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;CAC9B;AAED,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;CAC9B;AAED,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,OAAO,EAAE,KAAK,WAAW,IAAI,WAAW,EAAE,KAAK,yBAAyB,IAAI,yBAAyB,EAAE,CAAC;CACzG"}

package/resources/phone-numbers.d.ts

@@ -0,0 +1,90 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+export declare class PhoneNumbers extends APIResource {
+    /**
+     * Purchase a new phone number for the account. You can specify search criteria or
+     * let the system select a random number.
+     *
+     * @example
+     * ```ts
+     * const phoneNumber = await client.phoneNumbers.purchase(
+     *   'acct_01j9a43avnfqzbjfch6pygv1td',
+     * );
+     * ```
+     */
+    purchase(accountID: string, body: PhoneNumberPurchaseParams, options?: RequestOptions): APIPromise<PhoneNumber>;
+}
+/**
+ * A phone number that can be used to send and receive messages and calls
+ */
+export interface PhoneNumber {
+    /**
+     * Unique identifier for the phone number
+     */
+    id: string;
+    /**
+     * The phone number in E.164 format
+     */
+    number: string;
+    /**
+     * Whether the phone number is local, toll-free, or short code
+     */
+    type: 'local' | 'toll_free';
+}
+/**
+ * Parameters for purchasing a new phone number. The system will automatically
+ * infer the type in certain cases:
+ *
+ * - If only area_code is provided, type is inferred from the area code
+ * - If only latitude/longitude are provided, type is inferred as 'local'
+ * - Otherwise, type must be explicitly specified
+ */
+export interface PhoneNumberPurchaseParams {
+    /**
+     * The desired area code for this phone number. If provided without type, the type
+     * will be inferred.
+     */
+    area_code?: string;
+    /**
+     * Latitude to search for nearby phone numbers. Must be used with longitude. If
+     * provided without type, type will be inferred as 'local'.
+     */
+    latitude?: number;
+    /**
+     * Longitude to search for nearby phone numbers. Must be used with latitude. If
+     * provided without type, type will be inferred as 'local'.
+     */
+    longitude?: number;
+    /**
+     * Whether the phone number is local or toll-free. Can be omitted if area_code or
+     * latitude/longitude are provided.
+     */
+    type?: 'local' | 'toll_free';
+}
+export interface PhoneNumberPurchaseParams {
+    /**
+     * The desired area code for this phone number. If provided without type, the type
+     * will be inferred.
+     */
+    area_code?: string;
+    /**
+     * Latitude to search for nearby phone numbers. Must be used with longitude. If
+     * provided without type, type will be inferred as 'local'.
+     */
+    latitude?: number;
+    /**
+     * Longitude to search for nearby phone numbers. Must be used with latitude. If
+     * provided without type, type will be inferred as 'local'.
+     */
+    longitude?: number;
+    /**
+     * Whether the phone number is local or toll-free. Can be omitted if area_code or
+     * latitude/longitude are provided.
+     */
+    type?: 'local' | 'toll_free';
+}
+export declare namespace PhoneNumbers {
+    export { type PhoneNumber as PhoneNumber, type PhoneNumberPurchaseParams as PhoneNumberPurchaseParams };
+}
+//# sourceMappingURL=phone-numbers.d.ts.map

package/resources/phone-numbers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone-numbers.d.ts","sourceRoot":"","sources":["../src/resources/phone-numbers.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;;;;;;;;;OAUG;IACH,QAAQ,CACN,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,yBAAyB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,WAAW,CAAC;CAG3B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,OAAO,GAAG,WAAW,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;CAC9B;AAED,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;CAC9B;AAED,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,OAAO,EAAE,KAAK,WAAW,IAAI,WAAW,EAAE,KAAK,yBAAyB,IAAI,yBAAyB,EAAE,CAAC;CACzG"}

package/resources/phone-numbers.js

@@ -0,0 +1,24 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PhoneNumbers = void 0;
+const resource_1 = require("../core/resource.js");
+const path_1 = require("../internal/utils/path.js");
+class PhoneNumbers extends resource_1.APIResource {
+    /**
+     * Purchase a new phone number for the account. You can specify search criteria or
+     * let the system select a random number.
+     *
+     * @example
+     * ```ts
+     * const phoneNumber = await client.phoneNumbers.purchase(
+     *   'acct_01j9a43avnfqzbjfch6pygv1td',
+     * );
+     * ```
+     */
+    purchase(accountID, body, options) {
+        return this._client.post((0, path_1.path) `/accounts/${accountID}/phone_numbers`, { body, ...options });
+    }
+}
+exports.PhoneNumbers = PhoneNumbers;
+//# sourceMappingURL=phone-numbers.js.map

package/resources/phone-numbers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone-numbers.js","sourceRoot":"","sources":["../src/resources/phone-numbers.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAG/C,oDAA8C;AAE9C,MAAa,YAAa,SAAQ,sBAAW;IAC3C;;;;;;;;;;OAUG;IACH,QAAQ,CACN,SAAiB,EACjB,IAA+B,EAC/B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,aAAa,SAAS,gBAAgB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7F,CAAC;CACF;AAnBD,oCAmBC"}

package/resources/phone-numbers.mjs

@@ -0,0 +1,20 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+import { path } from "../internal/utils/path.mjs";
+export class PhoneNumbers extends APIResource {
+    /**
+     * Purchase a new phone number for the account. You can specify search criteria or
+     * let the system select a random number.
+     *
+     * @example
+     * ```ts
+     * const phoneNumber = await client.phoneNumbers.purchase(
+     *   'acct_01j9a43avnfqzbjfch6pygv1td',
+     * );
+     * ```
+     */
+    purchase(accountID, body, options) {
+        return this._client.post(path `/accounts/${accountID}/phone_numbers`, { body, ...options });
+    }
+}
+//# sourceMappingURL=phone-numbers.mjs.map

package/resources/phone-numbers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone-numbers.mjs","sourceRoot":"","sources":["../src/resources/phone-numbers.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,YAAa,SAAQ,WAAW;IAC3C;;;;;;;;;;OAUG;IACH,QAAQ,CACN,SAAiB,EACjB,IAA+B,EAC/B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,aAAa,SAAS,gBAAgB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7F,CAAC;CACF"}

package/resources/shared.d.mts

@@ -0,0 +1,20 @@
+/**
+ * An error response
+ */
+export interface Error {
+    /**
+     * A human-readable error message.
+     */
+    message: string;
+    /**
+     * A unique error code.
+     */
+    type: string;
+    /**
+     * Additional details about the error.
+     */
+    detail?: {
+        [key: string]: unknown;
+    };
+}
+//# sourceMappingURL=shared.d.mts.map

package/resources/shared.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.mts","sourceRoot":"","sources":["../src/resources/shared.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CACrC"}

package/resources/shared.d.ts

@@ -0,0 +1,20 @@
+/**
+ * An error response
+ */
+export interface Error {
+    /**
+     * A human-readable error message.
+     */
+    message: string;
+    /**
+     * A unique error code.
+     */
+    type: string;
+    /**
+     * Additional details about the error.
+     */
+    detail?: {
+        [key: string]: unknown;
+    };
+}
+//# sourceMappingURL=shared.d.ts.map

package/resources/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../src/resources/shared.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CACrC"}