telnyx 7.27.0 → 7.29.0

package/resources/email/ip-pools/ip-pools.d.ts

@@ -0,0 +1,184 @@
+import { APIResource } from "../../../core/resource.js";
+import * as DedicatedIPsAPI from "../dedicated-ips/dedicated-ips.js";
+import * as IPsAPI from "./ips.js";
+import { IPCreateParams, IPCreateResponse, IPDeleteParams, IPs } from "./ips.js";
+import { APIPromise } from "../../../core/api-promise.js";
+import { RequestOptions } from "../../../internal/request-options.js";
+/**
+ * Group dedicated IPs into pools for sending.
+ */
+export declare class IPPools extends APIResource {
+    ips: IPsAPI.IPs;
+    /**
+     * List the account's dedicated-IP pools. Member IPs are not included (`ips` is
+     * empty); retrieve a pool to see its members.
+     *
+     * @example
+     * ```ts
+     * const ipPools = await client.email.ipPools.list();
+     * ```
+     */
+    list(options?: RequestOptions): APIPromise<IPPoolListResponse>;
+    /**
+     * Create an account-scoped pool of dedicated IPs. Set `is_default` or `domain_id`
+     * for the pool to carry mail; a pool with neither carries none.
+     *
+     * @example
+     * ```ts
+     * const ipPoolShowResponse =
+     *   await client.email.ipPools.create({
+     *     name: 'primary-pool',
+     *     is_default: true,
+     *   });
+     * ```
+     */
+    create(body: IPPoolCreateParams, options?: RequestOptions): APIPromise<IPPoolShowResponse>;
+    /**
+     * Delete the pool. Member IPs are kept but leave the pool, so they carry no mail
+     * until added to another pool. Deleting a pool changes routing for subsequently
+     * resolved messages. It does not reroute messages already assigned to the deleted
+     * pool. Deleting a pool that still has IPs requires `force=true` and `drain=true`.
+     *
+     * @example
+     * ```ts
+     * await client.email.ipPools.delete(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * );
+     * ```
+     */
+    delete(id: string, params?: IPPoolDeleteParams | null | undefined, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Retrieve a single IP pool by its identifier, including its dedicated-IP members
+     * with billing state.
+     *
+     * @example
+     * ```ts
+     * const ipPoolShowResponse =
+     *   await client.email.ipPools.retrieve(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   );
+     * ```
+     */
+    retrieve(id: string, options?: RequestOptions): APIPromise<IPPoolShowResponse>;
+    /**
+     * Rename the pool, set or clear the default flag, or change its domain scope.
+     * Routing follows the new settings for subsequent mail.
+     *
+     * @example
+     * ```ts
+     * const ipPoolShowResponse =
+     *   await client.email.ipPools.update(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *     { name: 'renamed-pool' },
+     *   );
+     * ```
+     */
+    update(id: string, body: IPPoolUpdateParams, options?: RequestOptions): APIPromise<IPPoolShowResponse>;
+}
+/**
+ * An account-scoped pool of dedicated IPs. Mail uses a pool only when the pool is
+ * scoped to the sending domain (`domain_id`) or is the account default
+ * (`is_default`).
+ */
+export interface IPPool {
+    id?: string;
+    created_at?: string;
+    /**
+     * Email domain this pool is scoped to. The pool carries that domain's mail. Null
+     * when the pool is not domain-scoped.
+     */
+    domain_id?: string | null;
+    /**
+     * Member IPs with their routing weights. Populated by Retrieve an IP pool; list,
+     * create, and update responses return an empty array.
+     */
+    ips?: Array<IPPool.IP>;
+    /**
+     * Whether this is the account's default pool. The default pool carries mail for
+     * sending domains that have no domain-scoped pool. At most one per account.
+     */
+    is_default?: boolean;
+    /**
+     * Pool name, unique within the account.
+     */
+    name?: string;
+    record_type?: 'ip_pool';
+    updated_at?: string;
+}
+export declare namespace IPPool {
+    /**
+     * A dedicated IP as a member of a pool, with its routing weight in this pool.
+     * Weight is a positive integer (default 100).
+     */
+    interface IP extends DedicatedIPsAPI.DedicatedIP {
+        /**
+         * Relative routing weight of this IP within the pool.
+         */
+        weight?: number;
+    }
+}
+export interface IPPoolShowResponse {
+    /**
+     * An account-scoped pool of dedicated IPs. Mail uses a pool only when the pool is
+     * scoped to the sending domain (`domain_id`) or is the account default
+     * (`is_default`).
+     */
+    data: IPPool;
+}
+export interface IPPoolListResponse {
+    data: Array<IPPool>;
+}
+export interface IPPoolCreateParams {
+    /**
+     * Pool name: 1-64 characters of lowercase letters, digits, `.`, `_`, and `-`,
+     * starting and ending with a letter or digit. Must be unique within the account
+     * and must not start with `dip_`.
+     */
+    name: string;
+    /**
+     * Scope the pool to one of the account's email domains; the pool then carries that
+     * domain's mail. Scope at most one pool to each domain.
+     */
+    domain_id?: string;
+    /**
+     * Make this the account's default pool, which carries mail for sending domains
+     * without a domain-scoped pool. An account can have one default pool. Defaults to
+     * `false`.
+     */
+    is_default?: boolean;
+}
+export interface IPPoolDeleteParams {
+    /**
+     * Set together with `force=true` to delete a pool that still has IPs. Acknowledges
+     * deletion while the pool still has members; this flag does not reroute already
+     * queued messages.
+     */
+    drain?: boolean;
+    /**
+     * Set together with `drain=true` to delete a pool that still has IPs. Either flag
+     * alone has no effect.
+     */
+    force?: boolean;
+}
+export interface IPPoolUpdateParams {
+    /**
+     * Scope the pool to one of the account's email domains, or `null` to remove the
+     * scope.
+     */
+    domain_id?: string | null;
+    /**
+     * Set or clear the account default flag. An account can have one default pool.
+     */
+    is_default?: boolean;
+    /**
+     * Pool name: 1-64 characters of lowercase letters, digits, `.`, `_`, and `-`,
+     * starting and ending with a letter or digit. Must be unique within the account
+     * and must not start with `dip_`.
+     */
+    name?: string;
+}
+export declare namespace IPPools {
+    export { type IPPool as IPPool, type IPPoolShowResponse as IPPoolShowResponse, type IPPoolListResponse as IPPoolListResponse, type IPPoolCreateParams as IPPoolCreateParams, type IPPoolDeleteParams as IPPoolDeleteParams, type IPPoolUpdateParams as IPPoolUpdateParams, };
+    export { IPs as IPs, type IPCreateResponse as IPCreateResponse, type IPCreateParams as IPCreateParams, type IPDeleteParams as IPDeleteParams, };
+}
+//# sourceMappingURL=ip-pools.d.ts.map

package/resources/email/ip-pools/ip-pools.d.ts.map

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

package/resources/email/ip-pools/ip-pools.js

@@ -0,0 +1,102 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IPPools = void 0;
+const tslib_1 = require("../../../internal/tslib.js");
+const resource_1 = require("../../../core/resource.js");
+const IPsAPI = tslib_1.__importStar(require("./ips.js"));
+const ips_1 = require("./ips.js");
+const headers_1 = require("../../../internal/headers.js");
+const path_1 = require("../../../internal/utils/path.js");
+/**
+ * Group dedicated IPs into pools for sending.
+ */
+class IPPools extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.ips = new IPsAPI.IPs(this._client);
+    }
+    /**
+     * List the account's dedicated-IP pools. Member IPs are not included (`ips` is
+     * empty); retrieve a pool to see its members.
+     *
+     * @example
+     * ```ts
+     * const ipPools = await client.email.ipPools.list();
+     * ```
+     */
+    list(options) {
+        return this._client.get('/email/ip_pools', options);
+    }
+    /**
+     * Create an account-scoped pool of dedicated IPs. Set `is_default` or `domain_id`
+     * for the pool to carry mail; a pool with neither carries none.
+     *
+     * @example
+     * ```ts
+     * const ipPoolShowResponse =
+     *   await client.email.ipPools.create({
+     *     name: 'primary-pool',
+     *     is_default: true,
+     *   });
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/email/ip_pools', { body, ...options });
+    }
+    /**
+     * Delete the pool. Member IPs are kept but leave the pool, so they carry no mail
+     * until added to another pool. Deleting a pool changes routing for subsequently
+     * resolved messages. It does not reroute messages already assigned to the deleted
+     * pool. Deleting a pool that still has IPs requires `force=true` and `drain=true`.
+     *
+     * @example
+     * ```ts
+     * await client.email.ipPools.delete(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * );
+     * ```
+     */
+    delete(id, params = {}, options) {
+        const { drain, force } = params ?? {};
+        return this._client.delete((0, path_1.path) `/email/ip_pools/${id}`, {
+            query: { drain, force },
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Retrieve a single IP pool by its identifier, including its dedicated-IP members
+     * with billing state.
+     *
+     * @example
+     * ```ts
+     * const ipPoolShowResponse =
+     *   await client.email.ipPools.retrieve(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   );
+     * ```
+     */
+    retrieve(id, options) {
+        return this._client.get((0, path_1.path) `/email/ip_pools/${id}`, options);
+    }
+    /**
+     * Rename the pool, set or clear the default flag, or change its domain scope.
+     * Routing follows the new settings for subsequent mail.
+     *
+     * @example
+     * ```ts
+     * const ipPoolShowResponse =
+     *   await client.email.ipPools.update(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *     { name: 'renamed-pool' },
+     *   );
+     * ```
+     */
+    update(id, body, options) {
+        return this._client.patch((0, path_1.path) `/email/ip_pools/${id}`, { body, ...options });
+    }
+}
+exports.IPPools = IPPools;
+IPPools.IPs = ips_1.IPs;
+//# sourceMappingURL=ip-pools.js.map

package/resources/email/ip-pools/ip-pools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ip-pools.js","sourceRoot":"","sources":["../../../src/resources/email/ip-pools/ip-pools.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,wDAAqD;AAErD,yDAAgC;AAChC,kCAA8E;AAE9E,0DAAyD;AAEzD,0DAAoD;AAEpD;;GAEG;AACH,MAAa,OAAQ,SAAQ,sBAAW;IAAxC;;QACE,QAAG,GAAe,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA0FjD,CAAC;IAxFC;;;;;;;;OAQG;IACH,IAAI,CAAC,OAAwB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAwB,EAAE,OAAwB;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CACJ,EAAU,EACV,SAAgD,EAAE,EAClD,OAAwB;QAExB,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,mBAAmB,EAAE,EAAE,EAAE;YACtD,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;YACvB,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;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,mBAAmB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,EAAU,EAAE,IAAwB,EAAE,OAAwB;QACnE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,mBAAmB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;CACF;AA3FD,0BA2FC;AA2HD,OAAO,CAAC,GAAG,GAAG,SAAG,CAAC"}

package/resources/email/ip-pools/ip-pools.mjs

@@ -0,0 +1,97 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../../core/resource.mjs";
+import * as IPsAPI from "./ips.mjs";
+import { IPs } from "./ips.mjs";
+import { buildHeaders } from "../../../internal/headers.mjs";
+import { path } from "../../../internal/utils/path.mjs";
+/**
+ * Group dedicated IPs into pools for sending.
+ */
+export class IPPools extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.ips = new IPsAPI.IPs(this._client);
+    }
+    /**
+     * List the account's dedicated-IP pools. Member IPs are not included (`ips` is
+     * empty); retrieve a pool to see its members.
+     *
+     * @example
+     * ```ts
+     * const ipPools = await client.email.ipPools.list();
+     * ```
+     */
+    list(options) {
+        return this._client.get('/email/ip_pools', options);
+    }
+    /**
+     * Create an account-scoped pool of dedicated IPs. Set `is_default` or `domain_id`
+     * for the pool to carry mail; a pool with neither carries none.
+     *
+     * @example
+     * ```ts
+     * const ipPoolShowResponse =
+     *   await client.email.ipPools.create({
+     *     name: 'primary-pool',
+     *     is_default: true,
+     *   });
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/email/ip_pools', { body, ...options });
+    }
+    /**
+     * Delete the pool. Member IPs are kept but leave the pool, so they carry no mail
+     * until added to another pool. Deleting a pool changes routing for subsequently
+     * resolved messages. It does not reroute messages already assigned to the deleted
+     * pool. Deleting a pool that still has IPs requires `force=true` and `drain=true`.
+     *
+     * @example
+     * ```ts
+     * await client.email.ipPools.delete(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * );
+     * ```
+     */
+    delete(id, params = {}, options) {
+        const { drain, force } = params ?? {};
+        return this._client.delete(path `/email/ip_pools/${id}`, {
+            query: { drain, force },
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Retrieve a single IP pool by its identifier, including its dedicated-IP members
+     * with billing state.
+     *
+     * @example
+     * ```ts
+     * const ipPoolShowResponse =
+     *   await client.email.ipPools.retrieve(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   );
+     * ```
+     */
+    retrieve(id, options) {
+        return this._client.get(path `/email/ip_pools/${id}`, options);
+    }
+    /**
+     * Rename the pool, set or clear the default flag, or change its domain scope.
+     * Routing follows the new settings for subsequent mail.
+     *
+     * @example
+     * ```ts
+     * const ipPoolShowResponse =
+     *   await client.email.ipPools.update(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *     { name: 'renamed-pool' },
+     *   );
+     * ```
+     */
+    update(id, body, options) {
+        return this._client.patch(path `/email/ip_pools/${id}`, { body, ...options });
+    }
+}
+IPPools.IPs = IPs;
+//# sourceMappingURL=ip-pools.mjs.map

package/resources/email/ip-pools/ip-pools.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ip-pools.mjs","sourceRoot":"","sources":["../../../src/resources/email/ip-pools/ip-pools.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,mCAA+B;AAErD,OAAO,KAAK,MAAM,kBAAc;AAChC,OAAO,EAAoD,GAAG,EAAE,kBAAc;AAE9E,OAAO,EAAE,YAAY,EAAE,sCAAkC;AAEzD,OAAO,EAAE,IAAI,EAAE,yCAAqC;AAEpD;;GAEG;AACH,MAAM,OAAO,OAAQ,SAAQ,WAAW;IAAxC;;QACE,QAAG,GAAe,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA0FjD,CAAC;IAxFC;;;;;;;;OAQG;IACH,IAAI,CAAC,OAAwB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAwB,EAAE,OAAwB;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CACJ,EAAU,EACV,SAAgD,EAAE,EAClD,OAAwB;QAExB,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,mBAAmB,EAAE,EAAE,EAAE;YACtD,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;YACvB,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;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,mBAAmB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,EAAU,EAAE,IAAwB,EAAE,OAAwB;QACnE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,mBAAmB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;CACF;AA2HD,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC"}

package/resources/email/ip-pools/ips.d.mts

@@ -0,0 +1,83 @@
+import { APIResource } from "../../../core/resource.mjs";
+import { APIPromise } from "../../../core/api-promise.mjs";
+import { RequestOptions } from "../../../internal/request-options.mjs";
+/**
+ * Group dedicated IPs into pools for sending.
+ */
+export declare class IPs extends APIResource {
+    /**
+     * Add a dedicated IP to the pool with an optional routing weight. An IP can belong
+     * to one pool; to move an IP that is already in a pool, use
+     * `PATCH /email/dedicated_ips/{id}` with `pool_id`.
+     *
+     * @example
+     * ```ts
+     * const ip = await client.email.ipPools.ips.create(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   {
+     *     dedicated_ip_id: '6a7f9a30-1234-4b5c-8d9e-0f1a2b3c4d5e',
+     *     weight: 100,
+     *   },
+     * );
+     * ```
+     */
+    create(id: string, body: IPCreateParams, options?: RequestOptions): APIPromise<IPCreateResponse>;
+    /**
+     * Remove the dedicated IP from the pool. The IP is kept but carries no mail until
+     * added to a pool again. Removing the last IP requires `force=true` and
+     * `drain=true`.
+     *
+     * @example
+     * ```ts
+     * await client.email.ipPools.ips.delete(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   { id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' },
+     * );
+     * ```
+     */
+    delete(ipID: string, params: IPDeleteParams, options?: RequestOptions): APIPromise<void>;
+}
+export interface IPCreateResponse {
+    data: IPCreateResponse.Data;
+}
+export declare namespace IPCreateResponse {
+    interface Data {
+        created_at?: string;
+        dedicated_ip_id?: string;
+        pool_id?: string;
+        weight?: number;
+    }
+}
+export interface IPCreateParams {
+    /**
+     * The dedicated IP to add. It must belong to the account, must not be released,
+     * and must not already be in a pool.
+     */
+    dedicated_ip_id: string;
+    /**
+     * Relative routing weight for this IP in the pool. Positive integer; defaults
+     * to 100.
+     */
+    weight?: number;
+}
+export interface IPDeleteParams {
+    /**
+     * Path param: The IP pool identifier (UUID).
+     */
+    id: string;
+    /**
+     * Query param: Set together with `force=true` to remove the last IP in the pool.
+     * Acknowledges that mail routed to the emptied pool is held until the pool has a
+     * sendable IP again.
+     */
+    drain?: boolean;
+    /**
+     * Query param: Set together with `drain=true` to remove the last IP in the pool.
+     * Either flag alone has no effect.
+     */
+    force?: boolean;
+}
+export declare namespace IPs {
+    export { type IPCreateResponse as IPCreateResponse, type IPCreateParams as IPCreateParams, type IPDeleteParams as IPDeleteParams, };
+}
+//# sourceMappingURL=ips.d.mts.map

package/resources/email/ip-pools/ips.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ips.d.mts","sourceRoot":"","sources":["../../../src/resources/email/ip-pools/ips.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,mCAA+B;AACrD,OAAO,EAAE,UAAU,EAAE,sCAAkC;AAEvD,OAAO,EAAE,cAAc,EAAE,8CAA0C;AAGnE;;GAEG;AACH,qBAAa,GAAI,SAAQ,WAAW;IAClC;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,gBAAgB,CAAC;IAIhG;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAQzF;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC;CAC7B;AAED,yBAAiB,gBAAgB,CAAC;IAChC,UAAiB,IAAI;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QAEpB,eAAe,CAAC,EAAE,MAAM,CAAC;QAEzB,OAAO,CAAC,EAAE,MAAM,CAAC;QAEjB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;CACF;AAED,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,CAAC,OAAO,WAAW,GAAG,CAAC;IAC3B,OAAO,EACL,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,cAAc,IAAI,cAAc,GACtC,CAAC;CACH"}

package/resources/email/ip-pools/ips.d.ts

@@ -0,0 +1,83 @@
+import { APIResource } from "../../../core/resource.js";
+import { APIPromise } from "../../../core/api-promise.js";
+import { RequestOptions } from "../../../internal/request-options.js";
+/**
+ * Group dedicated IPs into pools for sending.
+ */
+export declare class IPs extends APIResource {
+    /**
+     * Add a dedicated IP to the pool with an optional routing weight. An IP can belong
+     * to one pool; to move an IP that is already in a pool, use
+     * `PATCH /email/dedicated_ips/{id}` with `pool_id`.
+     *
+     * @example
+     * ```ts
+     * const ip = await client.email.ipPools.ips.create(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   {
+     *     dedicated_ip_id: '6a7f9a30-1234-4b5c-8d9e-0f1a2b3c4d5e',
+     *     weight: 100,
+     *   },
+     * );
+     * ```
+     */
+    create(id: string, body: IPCreateParams, options?: RequestOptions): APIPromise<IPCreateResponse>;
+    /**
+     * Remove the dedicated IP from the pool. The IP is kept but carries no mail until
+     * added to a pool again. Removing the last IP requires `force=true` and
+     * `drain=true`.
+     *
+     * @example
+     * ```ts
+     * await client.email.ipPools.ips.delete(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   { id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' },
+     * );
+     * ```
+     */
+    delete(ipID: string, params: IPDeleteParams, options?: RequestOptions): APIPromise<void>;
+}
+export interface IPCreateResponse {
+    data: IPCreateResponse.Data;
+}
+export declare namespace IPCreateResponse {
+    interface Data {
+        created_at?: string;
+        dedicated_ip_id?: string;
+        pool_id?: string;
+        weight?: number;
+    }
+}
+export interface IPCreateParams {
+    /**
+     * The dedicated IP to add. It must belong to the account, must not be released,
+     * and must not already be in a pool.
+     */
+    dedicated_ip_id: string;
+    /**
+     * Relative routing weight for this IP in the pool. Positive integer; defaults
+     * to 100.
+     */
+    weight?: number;
+}
+export interface IPDeleteParams {
+    /**
+     * Path param: The IP pool identifier (UUID).
+     */
+    id: string;
+    /**
+     * Query param: Set together with `force=true` to remove the last IP in the pool.
+     * Acknowledges that mail routed to the emptied pool is held until the pool has a
+     * sendable IP again.
+     */
+    drain?: boolean;
+    /**
+     * Query param: Set together with `drain=true` to remove the last IP in the pool.
+     * Either flag alone has no effect.
+     */
+    force?: boolean;
+}
+export declare namespace IPs {
+    export { type IPCreateResponse as IPCreateResponse, type IPCreateParams as IPCreateParams, type IPDeleteParams as IPDeleteParams, };
+}
+//# sourceMappingURL=ips.d.ts.map

package/resources/email/ip-pools/ips.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ips.d.ts","sourceRoot":"","sources":["../../../src/resources/email/ip-pools/ips.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,kCAA+B;AACrD,OAAO,EAAE,UAAU,EAAE,qCAAkC;AAEvD,OAAO,EAAE,cAAc,EAAE,6CAA0C;AAGnE;;GAEG;AACH,qBAAa,GAAI,SAAQ,WAAW;IAClC;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,gBAAgB,CAAC;IAIhG;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAQzF;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC;CAC7B;AAED,yBAAiB,gBAAgB,CAAC;IAChC,UAAiB,IAAI;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QAEpB,eAAe,CAAC,EAAE,MAAM,CAAC;QAEzB,OAAO,CAAC,EAAE,MAAM,CAAC;QAEjB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;CACF;AAED,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,CAAC,OAAO,WAAW,GAAG,CAAC;IAC3B,OAAO,EACL,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,cAAc,IAAI,cAAc,GACtC,CAAC;CACH"}

package/resources/email/ip-pools/ips.js

@@ -0,0 +1,54 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IPs = void 0;
+const resource_1 = require("../../../core/resource.js");
+const headers_1 = require("../../../internal/headers.js");
+const path_1 = require("../../../internal/utils/path.js");
+/**
+ * Group dedicated IPs into pools for sending.
+ */
+class IPs extends resource_1.APIResource {
+    /**
+     * Add a dedicated IP to the pool with an optional routing weight. An IP can belong
+     * to one pool; to move an IP that is already in a pool, use
+     * `PATCH /email/dedicated_ips/{id}` with `pool_id`.
+     *
+     * @example
+     * ```ts
+     * const ip = await client.email.ipPools.ips.create(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   {
+     *     dedicated_ip_id: '6a7f9a30-1234-4b5c-8d9e-0f1a2b3c4d5e',
+     *     weight: 100,
+     *   },
+     * );
+     * ```
+     */
+    create(id, body, options) {
+        return this._client.post((0, path_1.path) `/email/ip_pools/${id}/ips`, { body, ...options });
+    }
+    /**
+     * Remove the dedicated IP from the pool. The IP is kept but carries no mail until
+     * added to a pool again. Removing the last IP requires `force=true` and
+     * `drain=true`.
+     *
+     * @example
+     * ```ts
+     * await client.email.ipPools.ips.delete(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   { id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' },
+     * );
+     * ```
+     */
+    delete(ipID, params, options) {
+        const { id, drain, force } = params;
+        return this._client.delete((0, path_1.path) `/email/ip_pools/${id}/ips/${ipID}`, {
+            query: { drain, force },
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+exports.IPs = IPs;
+//# sourceMappingURL=ips.js.map

package/resources/email/ip-pools/ips.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ips.js","sourceRoot":"","sources":["../../../src/resources/email/ip-pools/ips.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAqD;AAErD,0DAAyD;AAEzD,0DAAoD;AAEpD;;GAEG;AACH,MAAa,GAAI,SAAQ,sBAAW;IAClC;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,EAAU,EAAE,IAAoB,EAAE,OAAwB;QAC/D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,mBAAmB,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClF,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAY,EAAE,MAAsB,EAAE,OAAwB;QACnE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,mBAAmB,EAAE,QAAQ,IAAI,EAAE,EAAE;YAClE,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;YACvB,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;CACF;AA1CD,kBA0CC"}