@trycourier/courier 7.7.1 → 7.9.0

package/resources/providers/providers.d.ts

@@ -0,0 +1,182 @@
+import { APIResource } from "../../core/resource.js";
+import * as Shared from "../shared.js";
+import * as CatalogAPI from "./catalog.js";
+import { Catalog, CatalogListParams, CatalogListResponse } from "./catalog.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Providers extends APIResource {
+    catalog: CatalogAPI.Catalog;
+    /**
+     * Create a new provider configuration. The `provider` field must be a known
+     * Courier provider key (see catalog).
+     */
+    create(body: ProviderCreateParams, options?: RequestOptions): APIPromise<Provider>;
+    /**
+     * Fetch a single provider configuration by ID.
+     */
+    retrieve(id: string, options?: RequestOptions): APIPromise<Provider>;
+    /**
+     * Update an existing provider configuration. The `provider` key is required. All
+     * other fields are optional — omitted fields are cleared from the stored
+     * configuration (this is a full replacement, not a partial merge).
+     */
+    update(id: string, body: ProviderUpdateParams, options?: RequestOptions): APIPromise<Provider>;
+    /**
+     * List configured provider integrations for the current workspace. Supports
+     * cursor-based pagination.
+     */
+    list(query?: ProviderListParams | null | undefined, options?: RequestOptions): APIPromise<ProviderListResponse>;
+    /**
+     * Delete a provider configuration. Returns 409 if the provider is still referenced
+     * by routing or notifications.
+     */
+    delete(id: string, options?: RequestOptions): APIPromise<void>;
+}
+/**
+ * A configured provider in the workspace.
+ */
+export interface Provider {
+    /**
+     * A unique identifier for the provider configuration.
+     */
+    id: string;
+    /**
+     * Unix timestamp (ms) of when the provider was created.
+     */
+    created: number;
+    /**
+     * The provider key (e.g. "sendgrid", "twilio", "slack").
+     */
+    provider: string;
+    /**
+     * Provider-specific settings (snake_case keys on the wire).
+     */
+    settings: {
+        [key: string]: unknown;
+    };
+    /**
+     * Display title. Defaults to "Default Configuration" when not explicitly set.
+     */
+    title: string;
+    /**
+     * Optional alias for this configuration.
+     */
+    alias?: string;
+    /**
+     * Unix timestamp (ms) of when the provider was last updated.
+     */
+    updated?: number | null;
+}
+/**
+ * A provider type from the catalog. Contains the key, display name, description,
+ * and a `settings` object describing configuration schema fields.
+ */
+export interface ProvidersCatalogEntry {
+    /**
+     * Courier taxonomy channel (e.g. email, push, sms, direct_message, inbox,
+     * webhook).
+     */
+    channel: string;
+    /**
+     * Short description of the provider.
+     */
+    description: string;
+    /**
+     * Human-readable display name.
+     */
+    name: string;
+    /**
+     * The provider key (e.g. "sendgrid", "twilio").
+     */
+    provider: string;
+    /**
+     * Map of setting field names (snake_case) to their schema descriptors. Each
+     * descriptor has `type` and `required`. Empty when the provider has no
+     * configurable schema.
+     */
+    settings: {
+        [key: string]: ProvidersCatalogEntry.Settings;
+    };
+}
+export declare namespace ProvidersCatalogEntry {
+    /**
+     * Describes a single configuration field in the provider catalog.
+     */
+    interface Settings {
+        /**
+         * Whether this field is required when configuring the provider.
+         */
+        required: boolean;
+        /**
+         * The field's data type (e.g. "string", "boolean", "enum").
+         */
+        type: string;
+        /**
+         * Allowed values when `type` is "enum".
+         */
+        values?: Array<string>;
+    }
+}
+/**
+ * Paginated list of provider configurations.
+ */
+export interface ProviderListResponse {
+    paging: Shared.Paging;
+    results: Array<Provider>;
+}
+export interface ProviderCreateParams {
+    /**
+     * The provider key identifying the type (e.g. "sendgrid", "twilio"). Must be a
+     * known Courier provider — see the catalog endpoint for valid keys.
+     */
+    provider: string;
+    /**
+     * Optional alias for this configuration.
+     */
+    alias?: string;
+    /**
+     * Provider-specific settings (snake_case keys). Defaults to an empty object when
+     * omitted. Use the catalog endpoint to discover required fields for a given
+     * provider — omitting a required field returns a 400 validation error.
+     */
+    settings?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Optional display title. Omit to use "Default Configuration".
+     */
+    title?: string;
+}
+export interface ProviderUpdateParams {
+    /**
+     * The provider key identifying the type.
+     */
+    provider: string;
+    /**
+     * Updated alias. Omit to clear.
+     */
+    alias?: string;
+    /**
+     * Provider-specific settings (snake_case keys). Replaces the full settings object
+     * — omitted settings fields are removed. Use the catalog endpoint to check
+     * required fields.
+     */
+    settings?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Updated display title.
+     */
+    title?: string;
+}
+export interface ProviderListParams {
+    /**
+     * Opaque cursor for fetching the next page.
+     */
+    cursor?: string;
+}
+export declare namespace Providers {
+    export { type Provider as Provider, type ProvidersCatalogEntry as ProvidersCatalogEntry, type ProviderListResponse as ProviderListResponse, type ProviderCreateParams as ProviderCreateParams, type ProviderUpdateParams as ProviderUpdateParams, type ProviderListParams as ProviderListParams, };
+    export { Catalog as Catalog, type CatalogListResponse as CatalogListResponse, type CatalogListParams as CatalogListParams, };
+}
+//# sourceMappingURL=providers.d.ts.map

package/resources/providers/providers.d.ts.map

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

package/resources/providers/providers.js

@@ -0,0 +1,57 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Providers = void 0;
+const tslib_1 = require("../../internal/tslib.js");
+const resource_1 = require("../../core/resource.js");
+const CatalogAPI = tslib_1.__importStar(require("./catalog.js"));
+const catalog_1 = require("./catalog.js");
+const headers_1 = require("../../internal/headers.js");
+const path_1 = require("../../internal/utils/path.js");
+class Providers extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.catalog = new CatalogAPI.Catalog(this._client);
+    }
+    /**
+     * Create a new provider configuration. The `provider` field must be a known
+     * Courier provider key (see catalog).
+     */
+    create(body, options) {
+        return this._client.post('/providers', { body, ...options });
+    }
+    /**
+     * Fetch a single provider configuration by ID.
+     */
+    retrieve(id, options) {
+        return this._client.get((0, path_1.path) `/providers/${id}`, options);
+    }
+    /**
+     * Update an existing provider configuration. The `provider` key is required. All
+     * other fields are optional — omitted fields are cleared from the stored
+     * configuration (this is a full replacement, not a partial merge).
+     */
+    update(id, body, options) {
+        return this._client.post((0, path_1.path) `/providers/${id}`, { body, ...options });
+    }
+    /**
+     * List configured provider integrations for the current workspace. Supports
+     * cursor-based pagination.
+     */
+    list(query = {}, options) {
+        return this._client.get('/providers', { query, ...options });
+    }
+    /**
+     * Delete a provider configuration. Returns 409 if the provider is still referenced
+     * by routing or notifications.
+     */
+    delete(id, options) {
+        return this._client.delete((0, path_1.path) `/providers/${id}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+exports.Providers = Providers;
+Providers.Catalog = catalog_1.Catalog;
+//# sourceMappingURL=providers.js.map

package/resources/providers/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../src/resources/providers/providers.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAElD,iEAAwC;AACxC,0CAA4E;AAE5E,uDAAsD;AAEtD,uDAAiD;AAEjD,MAAa,SAAU,SAAQ,sBAAW;IAA1C;;QACE,YAAO,GAAuB,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA+CrE,CAAC;IA7CC;;;OAGG;IACH,MAAM,CAAC,IAA0B,EAAE,OAAwB;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,cAAc,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,EAAU,EAAE,IAA0B,EAAE,OAAwB;QACrE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,cAAc,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;OAGG;IACH,IAAI,CACF,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,cAAc,EAAE,EAAE,EAAE;YACjD,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;AAhDD,8BAgDC;AAmKD,SAAS,CAAC,OAAO,GAAG,iBAAO,CAAC"}

package/resources/providers/providers.mjs

@@ -0,0 +1,52 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import * as CatalogAPI from "./catalog.mjs";
+import { Catalog } from "./catalog.mjs";
+import { buildHeaders } from "../../internal/headers.mjs";
+import { path } from "../../internal/utils/path.mjs";
+export class Providers extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.catalog = new CatalogAPI.Catalog(this._client);
+    }
+    /**
+     * Create a new provider configuration. The `provider` field must be a known
+     * Courier provider key (see catalog).
+     */
+    create(body, options) {
+        return this._client.post('/providers', { body, ...options });
+    }
+    /**
+     * Fetch a single provider configuration by ID.
+     */
+    retrieve(id, options) {
+        return this._client.get(path `/providers/${id}`, options);
+    }
+    /**
+     * Update an existing provider configuration. The `provider` key is required. All
+     * other fields are optional — omitted fields are cleared from the stored
+     * configuration (this is a full replacement, not a partial merge).
+     */
+    update(id, body, options) {
+        return this._client.post(path `/providers/${id}`, { body, ...options });
+    }
+    /**
+     * List configured provider integrations for the current workspace. Supports
+     * cursor-based pagination.
+     */
+    list(query = {}, options) {
+        return this._client.get('/providers', { query, ...options });
+    }
+    /**
+     * Delete a provider configuration. Returns 409 if the provider is still referenced
+     * by routing or notifications.
+     */
+    delete(id, options) {
+        return this._client.delete(path `/providers/${id}`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+Providers.Catalog = Catalog;
+//# sourceMappingURL=providers.mjs.map

package/resources/providers/providers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.mjs","sourceRoot":"","sources":["../../src/resources/providers/providers.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,KAAK,UAAU;OACf,EAAE,OAAO,EAA0C;OAEnD,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,SAAU,SAAQ,WAAW;IAA1C;;QACE,YAAO,GAAuB,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA+CrE,CAAC;IA7CC;;;OAGG;IACH,MAAM,CAAC,IAA0B,EAAE,OAAwB;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,cAAc,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,EAAU,EAAE,IAA0B,EAAE,OAAwB;QACrE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,cAAc,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;OAGG;IACH,IAAI,CACF,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,cAAc,EAAE,EAAE,EAAE;YACjD,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF;AAmKD,SAAS,CAAC,OAAO,GAAG,OAAO,CAAC"}

package/resources/providers.d.mts

@@ -0,0 +1,2 @@
+export * from "./providers/index.mjs";
+//# sourceMappingURL=providers.d.mts.map

package/resources/providers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.mts","sourceRoot":"","sources":["../src/resources/providers.ts"],"names":[],"mappings":""}

package/resources/providers.d.ts

@@ -0,0 +1,2 @@
+export * from "./providers/index.js";
+//# sourceMappingURL=providers.d.ts.map

package/resources/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/resources/providers.ts"],"names":[],"mappings":""}

package/resources/providers.js

@@ -0,0 +1,6 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("../internal/tslib.js");
+tslib_1.__exportStar(require("./providers/index.js"), exports);
+//# sourceMappingURL=providers.js.map

package/resources/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../src/resources/providers.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,+DAAkC"}

package/resources/providers.mjs

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export * from "./providers/index.mjs";
+//# sourceMappingURL=providers.mjs.map

package/resources/providers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.mjs","sourceRoot":"","sources":["../src/resources/providers.ts"],"names":[],"mappings":"AAAA,sFAAsF"}

package/resources/routing-strategies.d.mts

@@ -0,0 +1,304 @@
+import { APIResource } from "../core/resource.mjs";
+import * as Shared from "./shared.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+export declare class RoutingStrategies extends APIResource {
+    /**
+     * Create a routing strategy. Requires a name and routing configuration at minimum.
+     * Channels and providers default to empty if omitted.
+     *
+     * @example
+     * ```ts
+     * const routingStrategyMutationResponse =
+     *   await client.routingStrategies.create({
+     *     name: 'Email via SendGrid',
+     *     routing: { method: 'single', channels: ['email'] },
+     *     channels: { email: { providers: ['sendgrid', 'ses'] } },
+     *     description:
+     *       'Routes email through sendgrid with SES failover',
+     *     providers: { sendgrid: { override: {} } },
+     *     tags: ['production', 'email'],
+     *   });
+     * ```
+     */
+    create(body: RoutingStrategyCreateParams, options?: RequestOptions): APIPromise<RoutingStrategyMutationResponse>;
+    /**
+     * Retrieve a routing strategy by ID. Returns the full entity including routing
+     * content and metadata.
+     *
+     * @example
+     * ```ts
+     * const routingStrategyGetResponse =
+     *   await client.routingStrategies.retrieve('id');
+     * ```
+     */
+    retrieve(id: string, options?: RequestOptions): APIPromise<RoutingStrategyGetResponse>;
+    /**
+     * List routing strategies in your workspace. Returns metadata only (no
+     * routing/channels/providers content). Use GET /routing-strategies/{id} for full
+     * details.
+     *
+     * @example
+     * ```ts
+     * const routingStrategyListResponse =
+     *   await client.routingStrategies.list();
+     * ```
+     */
+    list(query?: RoutingStrategyListParams | null | undefined, options?: RequestOptions): APIPromise<RoutingStrategyListResponse>;
+    /**
+     * Archive a routing strategy. The strategy must not have associated notification
+     * templates. Unlink all templates before archiving.
+     *
+     * @example
+     * ```ts
+     * await client.routingStrategies.archive('id');
+     * ```
+     */
+    archive(id: string, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Replace a routing strategy. Full document replacement; the caller must send the
+     * complete desired state. Missing optional fields are cleared.
+     *
+     * @example
+     * ```ts
+     * const routingStrategyMutationResponse =
+     *   await client.routingStrategies.replace('id', {
+     *     name: 'Email via SendGrid v2',
+     *     routing: { method: 'single', channels: ['email'] },
+     *     channels: { email: { providers: ['ses', 'sendgrid'] } },
+     *     description: 'Updated routing with SES primary',
+     *     providers: { ses: { override: {} } },
+     *     tags: ['production', 'email', 'v2'],
+     *   });
+     * ```
+     */
+    replace(id: string, body: RoutingStrategyReplaceParams, options?: RequestOptions): APIPromise<RoutingStrategyMutationResponse>;
+}
+/**
+ * Request body for creating a routing strategy.
+ */
+export interface RoutingStrategyCreateRequest {
+    /**
+     * Human-readable name for the routing strategy.
+     */
+    name: string;
+    /**
+     * Routing tree defining channel selection method and order.
+     */
+    routing: Shared.MessageRouting;
+    /**
+     * Per-channel delivery configuration. Defaults to empty if omitted.
+     */
+    channels?: Shared.MessageChannels | null;
+    /**
+     * Optional description of the routing strategy.
+     */
+    description?: string | null;
+    /**
+     * Per-provider delivery configuration. Defaults to empty if omitted.
+     */
+    providers?: Shared.MessageProviders | null;
+    /**
+     * Optional tags for categorization.
+     */
+    tags?: Array<string> | null;
+}
+/**
+ * Full routing strategy entity returned by GET.
+ */
+export interface RoutingStrategyGetResponse {
+    /**
+     * The routing strategy ID (rs\_ prefix).
+     */
+    id: string;
+    /**
+     * Per-channel delivery configuration. May be empty.
+     */
+    channels: Shared.MessageChannels;
+    /**
+     * Epoch milliseconds when the strategy was created.
+     */
+    created: number;
+    /**
+     * User ID of the creator.
+     */
+    creator: string;
+    /**
+     * Human-readable name.
+     */
+    name: string;
+    /**
+     * Per-provider delivery configuration. May be empty.
+     */
+    providers: Shared.MessageProviders;
+    /**
+     * Routing tree defining channel selection method and order.
+     */
+    routing: Shared.MessageRouting;
+    /**
+     * Description of the routing strategy.
+     */
+    description?: string | null;
+    /**
+     * Tags for categorization.
+     */
+    tags?: Array<string> | null;
+    /**
+     * Epoch milliseconds of last update.
+     */
+    updated?: number | null;
+    /**
+     * User ID of the last updater.
+     */
+    updater?: string | null;
+}
+/**
+ * Paginated list of routing strategy summaries.
+ */
+export interface RoutingStrategyListResponse {
+    paging: Shared.Paging;
+    results: Array<RoutingStrategySummary>;
+}
+/**
+ * Response returned by create and replace operations.
+ */
+export interface RoutingStrategyMutationResponse {
+    /**
+     * The routing strategy ID (rs\_ prefix).
+     */
+    id: string;
+}
+/**
+ * Request body for replacing a routing strategy. Full document replacement;
+ * missing optional fields are cleared.
+ */
+export interface RoutingStrategyReplaceRequest {
+    /**
+     * Human-readable name for the routing strategy.
+     */
+    name: string;
+    /**
+     * Routing tree defining channel selection method and order.
+     */
+    routing: Shared.MessageRouting;
+    /**
+     * Per-channel delivery configuration. Omit to clear.
+     */
+    channels?: Shared.MessageChannels | null;
+    /**
+     * Optional description. Omit or null to clear.
+     */
+    description?: string | null;
+    /**
+     * Per-provider delivery configuration. Omit to clear.
+     */
+    providers?: Shared.MessageProviders | null;
+    /**
+     * Optional tags. Omit or null to clear.
+     */
+    tags?: Array<string> | null;
+}
+/**
+ * Routing strategy metadata returned in list responses. Does not include
+ * routing/channels/providers content.
+ */
+export interface RoutingStrategySummary {
+    /**
+     * The routing strategy ID (rs\_ prefix).
+     */
+    id: string;
+    /**
+     * Epoch milliseconds when the strategy was created.
+     */
+    created: number;
+    /**
+     * User ID of the creator.
+     */
+    creator: string;
+    /**
+     * Human-readable name.
+     */
+    name: string;
+    /**
+     * Description of the routing strategy.
+     */
+    description?: string | null;
+    /**
+     * Tags for categorization.
+     */
+    tags?: Array<string> | null;
+    /**
+     * Epoch milliseconds of last update.
+     */
+    updated?: number | null;
+    /**
+     * User ID of the last updater.
+     */
+    updater?: string | null;
+}
+export interface RoutingStrategyCreateParams {
+    /**
+     * Human-readable name for the routing strategy.
+     */
+    name: string;
+    /**
+     * Routing tree defining channel selection method and order.
+     */
+    routing: Shared.MessageRouting;
+    /**
+     * Per-channel delivery configuration. Defaults to empty if omitted.
+     */
+    channels?: Shared.MessageChannels | null;
+    /**
+     * Optional description of the routing strategy.
+     */
+    description?: string | null;
+    /**
+     * Per-provider delivery configuration. Defaults to empty if omitted.
+     */
+    providers?: Shared.MessageProviders | null;
+    /**
+     * Optional tags for categorization.
+     */
+    tags?: Array<string> | null;
+}
+export interface RoutingStrategyListParams {
+    /**
+     * Opaque pagination cursor from a previous response. Omit for the first page.
+     */
+    cursor?: string | null;
+    /**
+     * Maximum number of results per page. Default 20, max 100.
+     */
+    limit?: number;
+}
+export interface RoutingStrategyReplaceParams {
+    /**
+     * Human-readable name for the routing strategy.
+     */
+    name: string;
+    /**
+     * Routing tree defining channel selection method and order.
+     */
+    routing: Shared.MessageRouting;
+    /**
+     * Per-channel delivery configuration. Omit to clear.
+     */
+    channels?: Shared.MessageChannels | null;
+    /**
+     * Optional description. Omit or null to clear.
+     */
+    description?: string | null;
+    /**
+     * Per-provider delivery configuration. Omit to clear.
+     */
+    providers?: Shared.MessageProviders | null;
+    /**
+     * Optional tags. Omit or null to clear.
+     */
+    tags?: Array<string> | null;
+}
+export declare namespace RoutingStrategies {
+    export { type RoutingStrategyCreateRequest as RoutingStrategyCreateRequest, type RoutingStrategyGetResponse as RoutingStrategyGetResponse, type RoutingStrategyListResponse as RoutingStrategyListResponse, type RoutingStrategyMutationResponse as RoutingStrategyMutationResponse, type RoutingStrategyReplaceRequest as RoutingStrategyReplaceRequest, type RoutingStrategySummary as RoutingStrategySummary, type RoutingStrategyCreateParams as RoutingStrategyCreateParams, type RoutingStrategyListParams as RoutingStrategyListParams, type RoutingStrategyReplaceParams as RoutingStrategyReplaceParams, };
+}
+//# sourceMappingURL=routing-strategies.d.mts.map

package/resources/routing-strategies.d.mts.map

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