@zavudev/sdk 0.31.0 → 0.38.0

package/resources/contacts/channels.d.mts

@@ -0,0 +1,127 @@
+import { APIResource } from "../../core/resource.mjs";
+import * as ContactsAPI from "./contacts.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class Channels extends APIResource {
+    /**
+     * Update a contact's channel properties.
+     *
+     * @example
+     * ```ts
+     * const channel = await client.contacts.channels.update(
+     *   'channelId',
+     *   { contactId: 'contactId' },
+     * );
+     * ```
+     */
+    update(channelID: string, params: ChannelUpdateParams, options?: RequestOptions): APIPromise<ChannelUpdateResponse>;
+    /**
+     * Add a new communication channel to an existing contact.
+     *
+     * @example
+     * ```ts
+     * const response = await client.contacts.channels.add(
+     *   'contactId',
+     *   {
+     *     channel: 'email',
+     *     identifier: 'john.work@company.com',
+     *     label: 'work',
+     *   },
+     * );
+     * ```
+     */
+    add(contactID: string, body: ChannelAddParams, options?: RequestOptions): APIPromise<ChannelAddResponse>;
+    /**
+     * Remove a communication channel from a contact. Cannot remove the last channel.
+     *
+     * @example
+     * ```ts
+     * await client.contacts.channels.remove('channelId', {
+     *   contactId: 'contactId',
+     * });
+     * ```
+     */
+    remove(channelID: string, params: ChannelRemoveParams, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Set a channel as the primary channel for its type.
+     *
+     * @example
+     * ```ts
+     * const response = await client.contacts.channels.setPrimary(
+     *   'channelId',
+     *   { contactId: 'contactId' },
+     * );
+     * ```
+     */
+    setPrimary(channelID: string, params: ChannelSetPrimaryParams, options?: RequestOptions): APIPromise<ChannelSetPrimaryResponse>;
+}
+export interface ChannelUpdateResponse {
+    /**
+     * A communication channel for a contact.
+     */
+    channel: ContactsAPI.ContactChannel;
+}
+export interface ChannelAddResponse {
+    /**
+     * A communication channel for a contact.
+     */
+    channel: ContactsAPI.ContactChannel;
+}
+export interface ChannelSetPrimaryResponse {
+    /**
+     * A communication channel for a contact.
+     */
+    channel: ContactsAPI.ContactChannel;
+}
+export interface ChannelUpdateParams {
+    /**
+     * Path param
+     */
+    contactId: string;
+    /**
+     * Body param: Optional label for the channel. Set to null to clear.
+     */
+    label?: string | null;
+    /**
+     * Body param
+     */
+    metadata?: {
+        [key: string]: string;
+    };
+    /**
+     * Body param: Whether the channel is verified.
+     */
+    verified?: boolean;
+}
+export interface ChannelAddParams {
+    /**
+     * Channel type.
+     */
+    channel: 'sms' | 'whatsapp' | 'email' | 'telegram' | 'voice';
+    /**
+     * Channel identifier (phone number in E.164 format or email address).
+     */
+    identifier: string;
+    /**
+     * ISO country code for phone numbers.
+     */
+    countryCode?: string;
+    /**
+     * Whether this should be the primary channel for its type.
+     */
+    isPrimary?: boolean;
+    /**
+     * Optional label for the channel.
+     */
+    label?: string;
+}
+export interface ChannelRemoveParams {
+    contactId: string;
+}
+export interface ChannelSetPrimaryParams {
+    contactId: string;
+}
+export declare namespace Channels {
+    export { type ChannelUpdateResponse as ChannelUpdateResponse, type ChannelAddResponse as ChannelAddResponse, type ChannelSetPrimaryResponse as ChannelSetPrimaryResponse, type ChannelUpdateParams as ChannelUpdateParams, type ChannelAddParams as ChannelAddParams, type ChannelRemoveParams as ChannelRemoveParams, type ChannelSetPrimaryParams as ChannelSetPrimaryParams, };
+}
+//# sourceMappingURL=channels.d.mts.map

package/resources/contacts/channels.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.d.mts","sourceRoot":"","sources":["../../src/resources/contacts/channels.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,WAAW;OAChB,EAAE,UAAU,EAAE;OAEd,EAAE,cAAc,EAAE;AAGzB,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;OAUG;IACH,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,qBAAqB,CAAC;IAKpC;;;;;;;;;;;;;;OAcG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,kBAAkB,CAAC;IAIxG;;;;;;;;;OASG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAQlG;;;;;;;;;;OAUG;IACH,UAAU,CACR,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,yBAAyB,CAAC;CAIzC;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC,cAAc,CAAC;CACrC;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC,cAAc,CAAC;CACrC;AAED,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC,cAAc,CAAC;CACrC;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,OAAO,EAAE,KAAK,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;IAE7D;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,uBAAuB,IAAI,uBAAuB,GACxD,CAAC;CACH"}

package/resources/contacts/channels.d.ts

@@ -0,0 +1,127 @@
+import { APIResource } from "../../core/resource.js";
+import * as ContactsAPI from "./contacts.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Channels extends APIResource {
+    /**
+     * Update a contact's channel properties.
+     *
+     * @example
+     * ```ts
+     * const channel = await client.contacts.channels.update(
+     *   'channelId',
+     *   { contactId: 'contactId' },
+     * );
+     * ```
+     */
+    update(channelID: string, params: ChannelUpdateParams, options?: RequestOptions): APIPromise<ChannelUpdateResponse>;
+    /**
+     * Add a new communication channel to an existing contact.
+     *
+     * @example
+     * ```ts
+     * const response = await client.contacts.channels.add(
+     *   'contactId',
+     *   {
+     *     channel: 'email',
+     *     identifier: 'john.work@company.com',
+     *     label: 'work',
+     *   },
+     * );
+     * ```
+     */
+    add(contactID: string, body: ChannelAddParams, options?: RequestOptions): APIPromise<ChannelAddResponse>;
+    /**
+     * Remove a communication channel from a contact. Cannot remove the last channel.
+     *
+     * @example
+     * ```ts
+     * await client.contacts.channels.remove('channelId', {
+     *   contactId: 'contactId',
+     * });
+     * ```
+     */
+    remove(channelID: string, params: ChannelRemoveParams, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Set a channel as the primary channel for its type.
+     *
+     * @example
+     * ```ts
+     * const response = await client.contacts.channels.setPrimary(
+     *   'channelId',
+     *   { contactId: 'contactId' },
+     * );
+     * ```
+     */
+    setPrimary(channelID: string, params: ChannelSetPrimaryParams, options?: RequestOptions): APIPromise<ChannelSetPrimaryResponse>;
+}
+export interface ChannelUpdateResponse {
+    /**
+     * A communication channel for a contact.
+     */
+    channel: ContactsAPI.ContactChannel;
+}
+export interface ChannelAddResponse {
+    /**
+     * A communication channel for a contact.
+     */
+    channel: ContactsAPI.ContactChannel;
+}
+export interface ChannelSetPrimaryResponse {
+    /**
+     * A communication channel for a contact.
+     */
+    channel: ContactsAPI.ContactChannel;
+}
+export interface ChannelUpdateParams {
+    /**
+     * Path param
+     */
+    contactId: string;
+    /**
+     * Body param: Optional label for the channel. Set to null to clear.
+     */
+    label?: string | null;
+    /**
+     * Body param
+     */
+    metadata?: {
+        [key: string]: string;
+    };
+    /**
+     * Body param: Whether the channel is verified.
+     */
+    verified?: boolean;
+}
+export interface ChannelAddParams {
+    /**
+     * Channel type.
+     */
+    channel: 'sms' | 'whatsapp' | 'email' | 'telegram' | 'voice';
+    /**
+     * Channel identifier (phone number in E.164 format or email address).
+     */
+    identifier: string;
+    /**
+     * ISO country code for phone numbers.
+     */
+    countryCode?: string;
+    /**
+     * Whether this should be the primary channel for its type.
+     */
+    isPrimary?: boolean;
+    /**
+     * Optional label for the channel.
+     */
+    label?: string;
+}
+export interface ChannelRemoveParams {
+    contactId: string;
+}
+export interface ChannelSetPrimaryParams {
+    contactId: string;
+}
+export declare namespace Channels {
+    export { type ChannelUpdateResponse as ChannelUpdateResponse, type ChannelAddResponse as ChannelAddResponse, type ChannelSetPrimaryResponse as ChannelSetPrimaryResponse, type ChannelUpdateParams as ChannelUpdateParams, type ChannelAddParams as ChannelAddParams, type ChannelRemoveParams as ChannelRemoveParams, type ChannelSetPrimaryParams as ChannelSetPrimaryParams, };
+}
+//# sourceMappingURL=channels.d.ts.map

package/resources/contacts/channels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../../src/resources/contacts/channels.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,WAAW;OAChB,EAAE,UAAU,EAAE;OAEd,EAAE,cAAc,EAAE;AAGzB,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;OAUG;IACH,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,qBAAqB,CAAC;IAKpC;;;;;;;;;;;;;;OAcG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,kBAAkB,CAAC;IAIxG;;;;;;;;;OASG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAQlG;;;;;;;;;;OAUG;IACH,UAAU,CACR,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,yBAAyB,CAAC;CAIzC;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC,cAAc,CAAC;CACrC;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC,cAAc,CAAC;CACrC;AAED,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC,cAAc,CAAC;CACrC;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,OAAO,EAAE,KAAK,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;IAE7D;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,uBAAuB,IAAI,uBAAuB,GACxD,CAAC;CACH"}

package/resources/contacts/channels.js

@@ -0,0 +1,76 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Channels = void 0;
+const resource_1 = require("../../core/resource.js");
+const headers_1 = require("../../internal/headers.js");
+const path_1 = require("../../internal/utils/path.js");
+class Channels extends resource_1.APIResource {
+    /**
+     * Update a contact's channel properties.
+     *
+     * @example
+     * ```ts
+     * const channel = await client.contacts.channels.update(
+     *   'channelId',
+     *   { contactId: 'contactId' },
+     * );
+     * ```
+     */
+    update(channelID, params, options) {
+        const { contactId, ...body } = params;
+        return this._client.patch((0, path_1.path) `/v1/contacts/${contactId}/channels/${channelID}`, { body, ...options });
+    }
+    /**
+     * Add a new communication channel to an existing contact.
+     *
+     * @example
+     * ```ts
+     * const response = await client.contacts.channels.add(
+     *   'contactId',
+     *   {
+     *     channel: 'email',
+     *     identifier: 'john.work@company.com',
+     *     label: 'work',
+     *   },
+     * );
+     * ```
+     */
+    add(contactID, body, options) {
+        return this._client.post((0, path_1.path) `/v1/contacts/${contactID}/channels`, { body, ...options });
+    }
+    /**
+     * Remove a communication channel from a contact. Cannot remove the last channel.
+     *
+     * @example
+     * ```ts
+     * await client.contacts.channels.remove('channelId', {
+     *   contactId: 'contactId',
+     * });
+     * ```
+     */
+    remove(channelID, params, options) {
+        const { contactId } = params;
+        return this._client.delete((0, path_1.path) `/v1/contacts/${contactId}/channels/${channelID}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Set a channel as the primary channel for its type.
+     *
+     * @example
+     * ```ts
+     * const response = await client.contacts.channels.setPrimary(
+     *   'channelId',
+     *   { contactId: 'contactId' },
+     * );
+     * ```
+     */
+    setPrimary(channelID, params, options) {
+        const { contactId } = params;
+        return this._client.post((0, path_1.path) `/v1/contacts/${contactId}/channels/${channelID}/primary`, options);
+    }
+}
+exports.Channels = Channels;
+//# sourceMappingURL=channels.js.map

package/resources/contacts/channels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.js","sourceRoot":"","sources":["../../src/resources/contacts/channels.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAGlD,uDAAsD;AAEtD,uDAAiD;AAEjD,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;;;;;;;OAUG;IACH,MAAM,CACJ,SAAiB,EACjB,MAA2B,EAC3B,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,gBAAgB,SAAS,aAAa,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzG,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,GAAG,CAAC,SAAiB,EAAE,IAAsB,EAAE,OAAwB;QACrE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,gBAAgB,SAAS,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,SAAiB,EAAE,MAA2B,EAAE,OAAwB;QAC7E,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,gBAAgB,SAAS,aAAa,SAAS,EAAE,EAAE;YAChF,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,UAAU,CACR,SAAiB,EACjB,MAA+B,EAC/B,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,gBAAgB,SAAS,aAAa,SAAS,UAAU,EAAE,OAAO,CAAC,CAAC;IACnG,CAAC;CACF;AA7ED,4BA6EC"}

package/resources/contacts/channels.mjs

@@ -0,0 +1,72 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import { buildHeaders } from "../../internal/headers.mjs";
+import { path } from "../../internal/utils/path.mjs";
+export class Channels extends APIResource {
+    /**
+     * Update a contact's channel properties.
+     *
+     * @example
+     * ```ts
+     * const channel = await client.contacts.channels.update(
+     *   'channelId',
+     *   { contactId: 'contactId' },
+     * );
+     * ```
+     */
+    update(channelID, params, options) {
+        const { contactId, ...body } = params;
+        return this._client.patch(path `/v1/contacts/${contactId}/channels/${channelID}`, { body, ...options });
+    }
+    /**
+     * Add a new communication channel to an existing contact.
+     *
+     * @example
+     * ```ts
+     * const response = await client.contacts.channels.add(
+     *   'contactId',
+     *   {
+     *     channel: 'email',
+     *     identifier: 'john.work@company.com',
+     *     label: 'work',
+     *   },
+     * );
+     * ```
+     */
+    add(contactID, body, options) {
+        return this._client.post(path `/v1/contacts/${contactID}/channels`, { body, ...options });
+    }
+    /**
+     * Remove a communication channel from a contact. Cannot remove the last channel.
+     *
+     * @example
+     * ```ts
+     * await client.contacts.channels.remove('channelId', {
+     *   contactId: 'contactId',
+     * });
+     * ```
+     */
+    remove(channelID, params, options) {
+        const { contactId } = params;
+        return this._client.delete(path `/v1/contacts/${contactId}/channels/${channelID}`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Set a channel as the primary channel for its type.
+     *
+     * @example
+     * ```ts
+     * const response = await client.contacts.channels.setPrimary(
+     *   'channelId',
+     *   { contactId: 'contactId' },
+     * );
+     * ```
+     */
+    setPrimary(channelID, params, options) {
+        const { contactId } = params;
+        return this._client.post(path `/v1/contacts/${contactId}/channels/${channelID}/primary`, options);
+    }
+}
+//# sourceMappingURL=channels.mjs.map

package/resources/contacts/channels.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.mjs","sourceRoot":"","sources":["../../src/resources/contacts/channels.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;OAUG;IACH,MAAM,CACJ,SAAiB,EACjB,MAA2B,EAC3B,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,gBAAgB,SAAS,aAAa,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzG,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,GAAG,CAAC,SAAiB,EAAE,IAAsB,EAAE,OAAwB;QACrE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,gBAAgB,SAAS,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,SAAiB,EAAE,MAA2B,EAAE,OAAwB;QAC7E,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,gBAAgB,SAAS,aAAa,SAAS,EAAE,EAAE;YAChF,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,UAAU,CACR,SAAiB,EACjB,MAA+B,EAC/B,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,gBAAgB,SAAS,aAAa,SAAS,UAAU,EAAE,OAAO,CAAC,CAAC;IACnG,CAAC;CACF"}

package/resources/contacts/contacts.d.mts

@@ -0,0 +1,262 @@
+import { APIResource } from "../../core/resource.mjs";
+import * as ChannelsAPI from "./channels.mjs";
+import { ChannelAddParams, ChannelAddResponse, ChannelRemoveParams, ChannelSetPrimaryParams, ChannelSetPrimaryResponse, ChannelUpdateParams, ChannelUpdateResponse, Channels } from "./channels.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { Cursor, type CursorParams, PagePromise } from "../../core/pagination.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class Contacts extends APIResource {
+    channels: ChannelsAPI.Channels;
+    /**
+     * Create a new contact with one or more communication channels.
+     *
+     * @example
+     * ```ts
+     * const contact = await client.contacts.create({
+     *   channels: [
+     *     {
+     *       channel: 'sms',
+     *       identifier: '+14155551234',
+     *       isPrimary: true,
+     *     },
+     *   ],
+     *   displayName: 'John Doe',
+     * });
+     * ```
+     */
+    create(body: ContactCreateParams, options?: RequestOptions): APIPromise<Contact>;
+    /**
+     * Get contact
+     *
+     * @example
+     * ```ts
+     * const contact = await client.contacts.retrieve('contactId');
+     * ```
+     */
+    retrieve(contactID: string, options?: RequestOptions): APIPromise<Contact>;
+    /**
+     * Update contact
+     *
+     * @example
+     * ```ts
+     * const contact = await client.contacts.update('contactId');
+     * ```
+     */
+    update(contactID: string, body: ContactUpdateParams, options?: RequestOptions): APIPromise<Contact>;
+    /**
+     * List contacts with their communication channels.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const contact of client.contacts.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query?: ContactListParams | null | undefined, options?: RequestOptions): PagePromise<ContactsCursor, Contact>;
+    /**
+     * Dismiss the merge suggestion for a contact.
+     *
+     * @example
+     * ```ts
+     * await client.contacts.dismissMergeSuggestion('contactId');
+     * ```
+     */
+    dismissMergeSuggestion(contactID: string, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Merge a source contact into this contact. All channels from the source contact
+     * will be moved to the target contact, and the source contact will be marked as
+     * merged.
+     *
+     * @example
+     * ```ts
+     * const contact = await client.contacts.merge('contactId', {
+     *   sourceContactId: 'jx7xyz789',
+     * });
+     * ```
+     */
+    merge(contactID: string, body: ContactMergeParams, options?: RequestOptions): APIPromise<Contact>;
+    /**
+     * Get contact by phone number
+     *
+     * @example
+     * ```ts
+     * const contact = await client.contacts.retrieveByPhone(
+     *   'phoneNumber',
+     * );
+     * ```
+     */
+    retrieveByPhone(phoneNumber: string, options?: RequestOptions): APIPromise<Contact>;
+}
+export type ContactsCursor = Cursor<Contact>;
+export interface Contact {
+    id: string;
+    /**
+     * List of available messaging channels for this contact.
+     */
+    availableChannels: Array<string>;
+    createdAt: string;
+    metadata: {
+        [key: string]: string;
+    };
+    /**
+     * Whether this contact has been verified.
+     */
+    verified: boolean;
+    /**
+     * All communication channels for this contact.
+     */
+    channels?: Array<ContactChannel>;
+    countryCode?: string;
+    /**
+     * Preferred channel for this contact.
+     */
+    defaultChannel?: 'sms' | 'whatsapp' | 'telegram' | 'email' | 'instagram' | 'voice';
+    /**
+     * Display name for the contact.
+     */
+    displayName?: string;
+    /**
+     * DEPRECATED: Use primaryPhone instead. Primary phone number in E.164 format.
+     */
+    phoneNumber?: string;
+    /**
+     * Primary email address.
+     */
+    primaryEmail?: string;
+    /**
+     * Primary phone number in E.164 format.
+     */
+    primaryPhone?: string;
+    /**
+     * Contact's WhatsApp profile name. Only available for WhatsApp contacts.
+     */
+    profileName?: string | null;
+    /**
+     * ID of a contact suggested for merging.
+     */
+    suggestedMergeWith?: string;
+    updatedAt?: string;
+}
+/**
+ * A communication channel for a contact.
+ */
+export interface ContactChannel {
+    id: string;
+    /**
+     * Channel type.
+     */
+    channel: 'sms' | 'whatsapp' | 'email' | 'telegram' | 'voice';
+    createdAt: string;
+    /**
+     * Channel identifier (phone number or email address).
+     */
+    identifier: string;
+    /**
+     * Whether this is the primary channel for its type.
+     */
+    isPrimary: boolean;
+    /**
+     * Whether this channel has been verified.
+     */
+    verified: boolean;
+    /**
+     * ISO country code for phone numbers.
+     */
+    countryCode?: string;
+    /**
+     * Optional label for the channel.
+     */
+    label?: string;
+    /**
+     * Last time a message was received on this channel.
+     */
+    lastInboundAt?: string;
+    metadata?: {
+        [key: string]: string;
+    };
+    /**
+     * Delivery metrics for this channel.
+     */
+    metrics?: ContactChannel.Metrics;
+    updatedAt?: string;
+}
+export declare namespace ContactChannel {
+    /**
+     * Delivery metrics for this channel.
+     */
+    interface Metrics {
+        avgDeliveryTimeMs?: number;
+        failureCount?: number;
+        lastSuccessAt?: string;
+        successCount?: number;
+        totalAttempts?: number;
+    }
+}
+export interface ContactCreateParams {
+    /**
+     * Communication channels for the contact.
+     */
+    channels: Array<ContactCreateParams.Channel>;
+    /**
+     * Display name for the contact.
+     */
+    displayName?: string;
+    /**
+     * Arbitrary metadata to associate with the contact.
+     */
+    metadata?: {
+        [key: string]: string;
+    };
+}
+export declare namespace ContactCreateParams {
+    /**
+     * Input for creating a contact channel.
+     */
+    interface Channel {
+        /**
+         * Channel type.
+         */
+        channel: 'sms' | 'whatsapp' | 'email' | 'telegram' | 'voice';
+        /**
+         * Channel identifier (phone number in E.164 format or email address).
+         */
+        identifier: string;
+        /**
+         * ISO country code for phone numbers.
+         */
+        countryCode?: string;
+        /**
+         * Whether this should be the primary channel for its type.
+         */
+        isPrimary?: boolean;
+        /**
+         * Optional label for the channel.
+         */
+        label?: string;
+    }
+}
+export interface ContactUpdateParams {
+    /**
+     * Preferred channel for this contact. Set to null to clear.
+     */
+    defaultChannel?: 'sms' | 'whatsapp' | 'telegram' | 'email' | 'instagram' | 'voice' | null;
+    metadata?: {
+        [key: string]: string;
+    };
+}
+export interface ContactListParams extends CursorParams {
+    phoneNumber?: string;
+}
+export interface ContactMergeParams {
+    /**
+     * ID of the contact to merge into the target contact. The source contact will be
+     * marked as merged.
+     */
+    sourceContactId: string;
+}
+export declare namespace Contacts {
+    export { type Contact as Contact, type ContactChannel as ContactChannel, type ContactsCursor as ContactsCursor, type ContactCreateParams as ContactCreateParams, type ContactUpdateParams as ContactUpdateParams, type ContactListParams as ContactListParams, type ContactMergeParams as ContactMergeParams, };
+    export { Channels as Channels, type ChannelUpdateResponse as ChannelUpdateResponse, type ChannelAddResponse as ChannelAddResponse, type ChannelSetPrimaryResponse as ChannelSetPrimaryResponse, type ChannelUpdateParams as ChannelUpdateParams, type ChannelAddParams as ChannelAddParams, type ChannelRemoveParams as ChannelRemoveParams, type ChannelSetPrimaryParams as ChannelSetPrimaryParams, };
+}
+//# sourceMappingURL=contacts.d.mts.map