@trycourier/courier 7.10.2 → 7.11.0

package/src/resources/journeys/templates.ts

@@ -0,0 +1,318 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as Shared from '../shared';
+import * as JourneysAPI from './journeys';
+import * as NotificationsAPI from '../notifications/notifications';
+import { APIPromise } from '../../core/api-promise';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Templates extends APIResource {
+  /**
+   * Create a notification template scoped to this journey. Defaults to `DRAFT`
+   * state; pass `state: "PUBLISHED"` to publish on create.
+   *
+   * @example
+   * ```ts
+   * const journeyTemplateGetResponse =
+   *   await client.journeys.templates.create('x', {
+   *     channel: 'email',
+   *     notification: {
+   *       name: 'Welcome email',
+   *       tags: [],
+   *       brand: null,
+   *       subscription: null,
+   *       content: {
+   *         version: '2022-01-01',
+   *         elements: [{ type: 'text' }],
+   *       },
+   *     },
+   *   });
+   * ```
+   */
+  create(
+    templateID: string,
+    body: TemplateCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<JourneysAPI.JourneyTemplateGetResponse> {
+    return this._client.post(path`/journeys/${templateID}/templates`, { body, ...options });
+  }
+
+  /**
+   * Fetch a journey-scoped notification template by id. Pass `?version=draft`
+   * (default `published`) to retrieve the working draft, or `?version=vN` for a
+   * historical version.
+   *
+   * @example
+   * ```ts
+   * const journeyTemplateGetResponse =
+   *   await client.journeys.templates.retrieve('x', {
+   *     templateId: 'x',
+   *   });
+   * ```
+   */
+  retrieve(
+    notificationID: string,
+    params: TemplateRetrieveParams,
+    options?: RequestOptions,
+  ): APIPromise<JourneysAPI.JourneyTemplateGetResponse> {
+    const { templateId } = params;
+    return this._client.get(path`/journeys/${templateId}/templates/${notificationID}`, options);
+  }
+
+  /**
+   * List notification templates scoped to this journey. Journey-scoped notification
+   * templates can only be referenced from `send` nodes within the same journey.
+   *
+   * @example
+   * ```ts
+   * const journeyTemplateListResponse =
+   *   await client.journeys.templates.list('x');
+   * ```
+   */
+  list(
+    templateID: string,
+    query: TemplateListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<JourneysAPI.JourneyTemplateListResponse> {
+    return this._client.get(path`/journeys/${templateID}/templates`, { query, ...options });
+  }
+
+  /**
+   * Archive the journey-scoped notification template. Archived templates cannot be
+   * sent.
+   *
+   * @example
+   * ```ts
+   * await client.journeys.templates.archive('x', {
+   *   templateId: 'x',
+   * });
+   * ```
+   */
+  archive(notificationID: string, params: TemplateArchiveParams, options?: RequestOptions): APIPromise<void> {
+    const { templateId } = params;
+    return this._client.delete(path`/journeys/${templateId}/templates/${notificationID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * List published versions of the journey-scoped notification template, ordered
+   * most recent first.
+   *
+   * @example
+   * ```ts
+   * const notificationTemplateVersionListResponse =
+   *   await client.journeys.templates.listVersions('x', {
+   *     templateId: 'x',
+   *   });
+   * ```
+   */
+  listVersions(
+    notificationID: string,
+    params: TemplateListVersionsParams,
+    options?: RequestOptions,
+  ): APIPromise<NotificationsAPI.NotificationTemplateVersionListResponse> {
+    const { templateId } = params;
+    return this._client.get(path`/journeys/${templateId}/templates/${notificationID}/versions`, options);
+  }
+
+  /**
+   * Publish the current draft of the journey-scoped notification template as a new
+   * version. Optionally roll back to a prior version by passing
+   * `{ "version": "vN" }`.
+   *
+   * @example
+   * ```ts
+   * await client.journeys.templates.publish('x', {
+   *   templateId: 'x',
+   * });
+   * ```
+   */
+  publish(notificationID: string, params: TemplatePublishParams, options?: RequestOptions): APIPromise<void> {
+    const { templateId, ...body } = params;
+    return this._client.post(path`/journeys/${templateId}/templates/${notificationID}/publish`, {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Replace the journey-scoped notification template draft.
+   *
+   * @example
+   * ```ts
+   * const journeyTemplateGetResponse =
+   *   await client.journeys.templates.replace('x', {
+   *     templateId: 'x',
+   *     notification: {
+   *       brand: { id: 'id' },
+   *       content: { elements: [{}], version: '2022-01-01' },
+   *       name: 'name',
+   *       subscription: { topic_id: 'topic_id' },
+   *       tags: ['string'],
+   *     },
+   *   });
+   * ```
+   */
+  replace(
+    notificationID: string,
+    params: TemplateReplaceParams,
+    options?: RequestOptions,
+  ): APIPromise<JourneysAPI.JourneyTemplateGetResponse> {
+    const { templateId, ...body } = params;
+    return this._client.put(path`/journeys/${templateId}/templates/${notificationID}`, { body, ...options });
+  }
+}
+
+export interface TemplateCreateParams {
+  channel: string;
+
+  notification: TemplateCreateParams.Notification;
+
+  providerKey?: string;
+
+  state?: string;
+}
+
+export namespace TemplateCreateParams {
+  export interface Notification {
+    brand: Notification.Brand | null;
+
+    content: Notification.Content;
+
+    name: string;
+
+    subscription: Notification.Subscription | null;
+
+    tags: Array<string>;
+  }
+
+  export namespace Notification {
+    export interface Brand {
+      id: string;
+    }
+
+    export interface Content {
+      elements: Array<Shared.ElementalNode>;
+
+      version: '2022-01-01';
+
+      scope?: 'default' | 'strict';
+    }
+
+    export interface Subscription {
+      topic_id: string;
+    }
+  }
+}
+
+export interface TemplateRetrieveParams {
+  /**
+   * Journey id
+   */
+  templateId: string;
+}
+
+export interface TemplateListParams {
+  /**
+   * Pagination cursor from a prior response.
+   */
+  cursor?: string;
+
+  /**
+   * Page size. Minimum 1, maximum 100.
+   */
+  limit?: number;
+}
+
+export interface TemplateArchiveParams {
+  /**
+   * Journey id
+   */
+  templateId: string;
+}
+
+export interface TemplateListVersionsParams {
+  /**
+   * Journey id
+   */
+  templateId: string;
+}
+
+export interface TemplatePublishParams {
+  /**
+   * Path param: Journey id
+   */
+  templateId: string;
+
+  /**
+   * Body param
+   */
+  version?: string;
+}
+
+export interface TemplateReplaceParams {
+  /**
+   * Path param: Journey id
+   */
+  templateId: string;
+
+  /**
+   * Body param
+   */
+  notification: TemplateReplaceParams.Notification;
+
+  /**
+   * Body param
+   */
+  state?: string;
+}
+
+export namespace TemplateReplaceParams {
+  export interface Notification {
+    brand: Notification.Brand | null;
+
+    content: Notification.Content;
+
+    name: string;
+
+    subscription: Notification.Subscription | null;
+
+    tags: Array<string>;
+  }
+
+  export namespace Notification {
+    export interface Brand {
+      id: string;
+    }
+
+    export interface Content {
+      elements: Array<Shared.ElementalNode>;
+
+      version: '2022-01-01';
+
+      scope?: 'default' | 'strict';
+    }
+
+    export interface Subscription {
+      topic_id: string;
+    }
+  }
+}
+
+export declare namespace Templates {
+  export {
+    type TemplateCreateParams as TemplateCreateParams,
+    type TemplateRetrieveParams as TemplateRetrieveParams,
+    type TemplateListParams as TemplateListParams,
+    type TemplateArchiveParams as TemplateArchiveParams,
+    type TemplateListVersionsParams as TemplateListVersionsParams,
+    type TemplatePublishParams as TemplatePublishParams,
+    type TemplateReplaceParams as TemplateReplaceParams,
+  };
+}

package/src/resources/journeys.ts

@@ -1,174 +1,3 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../core/resource';
-import { APIPromise } from '../core/api-promise';
-import { RequestOptions } from '../internal/request-options';
-import { path } from '../internal/utils/path';
-
-export class Journeys extends APIResource {
-  /**
-   * Get the list of journeys.
-   *
-   * @example
-   * ```ts
-   * const journeysListResponse = await client.journeys.list();
-   * ```
-   */
-  list(
-    query: JourneyListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<JourneysListResponse> {
-    return this._client.get('/journeys', { query, ...options });
-  }
-
-  /**
-   * Invoke a journey run from a journey template.
-   *
-   * @example
-   * ```ts
-   * const journeysInvokeResponse = await client.journeys.invoke(
-   *   'templateId',
-   *   {
-   *     data: { order_id: 'order-456', amount: 99.99 },
-   *     user_id: 'user-123',
-   *   },
-   * );
-   * ```
-   */
-  invoke(
-    templateID: string,
-    body: JourneyInvokeParams,
-    options?: RequestOptions,
-  ): APIPromise<JourneysInvokeResponse> {
-    return this._client.post(path`/journeys/${templateID}/invoke`, { body, ...options });
-  }
-}
-
-/**
- * A journey template representing an automation workflow.
- */
-export interface Journey {
-  /**
-   * The unique identifier of the journey.
-   */
-  id: string;
-
-  /**
-   * The name of the journey.
-   */
-  name: string;
-
-  /**
-   * The version of the journey (published or draft).
-   */
-  version: 'published' | 'draft';
-
-  /**
-   * ISO 8601 timestamp when the journey was created.
-   */
-  createdAt?: string;
-
-  /**
-   * ISO 8601 timestamp when the journey was last updated.
-   */
-  updatedAt?: string;
-}
-
-/**
- * Request body for invoking a journey. Requires either a user identifier or a
- * profile with contact information. User identifiers can be provided via user_id
- * field, or resolved from profile/data objects (user_id, userId, or anonymousId
- * fields).
- */
-export interface JourneysInvokeRequest {
-  /**
-   * Data payload passed to the journey. The expected shape can be predefined using
-   * the schema builder in the journey editor. This data is available in journey
-   * steps for condition evaluation and template variable interpolation. Can also
-   * contain user identifiers (user_id, userId, anonymousId) if not provided
-   * elsewhere.
-   */
-  data?: { [key: string]: unknown };
-
-  /**
-   * Profile data for the user. Can contain contact information (email,
-   * phone_number), user identifiers (user_id, userId, anonymousId), or any custom
-   * profile fields. Profile fields are merged with any existing stored profile for
-   * the user. Include context.tenant_id to load a tenant-scoped profile for
-   * multi-tenant scenarios.
-   */
-  profile?: { [key: string]: unknown };
-
-  /**
-   * A unique identifier for the user. If not provided, the system will attempt to
-   * resolve the user identifier from profile or data objects.
-   */
-  user_id?: string;
-}
-
-export interface JourneysInvokeResponse {
-  /**
-   * A unique identifier for the journey run that was created.
-   */
-  runId: string;
-}
-
-export interface JourneysListResponse {
-  /**
-   * A cursor token for pagination. Present when there are more results available.
-   */
-  cursor?: string;
-
-  templates?: Array<Journey>;
-}
-
-export interface JourneyListParams {
-  /**
-   * A cursor token for pagination. Use the cursor from the previous response to
-   * fetch the next page of results.
-   */
-  cursor?: string;
-
-  /**
-   * The version of journeys to retrieve. Accepted values are published (for
-   * published journeys) or draft (for draft journeys). Defaults to published.
-   */
-  version?: 'published' | 'draft';
-}
-
-export interface JourneyInvokeParams {
-  /**
-   * Data payload passed to the journey. The expected shape can be predefined using
-   * the schema builder in the journey editor. This data is available in journey
-   * steps for condition evaluation and template variable interpolation. Can also
-   * contain user identifiers (user_id, userId, anonymousId) if not provided
-   * elsewhere.
-   */
-  data?: { [key: string]: unknown };
-
-  /**
-   * Profile data for the user. Can contain contact information (email,
-   * phone_number), user identifiers (user_id, userId, anonymousId), or any custom
-   * profile fields. Profile fields are merged with any existing stored profile for
-   * the user. Include context.tenant_id to load a tenant-scoped profile for
-   * multi-tenant scenarios.
-   */
-  profile?: { [key: string]: unknown };
-
-  /**
-   * A unique identifier for the user. If not provided, the system will attempt to
-   * resolve the user identifier from profile or data objects.
-   */
-  user_id?: string;
-}
-
-export declare namespace Journeys {
-  export {
-    type Journey as Journey,
-    type JourneysInvokeRequest as JourneysInvokeRequest,
-    type JourneysInvokeResponse as JourneysInvokeResponse,
-    type JourneysListResponse as JourneysListResponse,
-    type JourneyListParams as JourneyListParams,
-    type JourneyInvokeParams as JourneyInvokeParams,
-  };
-}
+export * from './journeys/index';

package/src/resources/tenants/index.ts

@@ -6,6 +6,7 @@ export {
   type TemplateListResponse,
   type TemplateRetrieveParams,
   type TemplateListParams,
+  type TemplateDeleteParams,
   type TemplatePublishParams,
   type TemplateReplaceParams,
 } from './templates/index';

package/src/resources/tenants/templates/index.ts

@@ -5,6 +5,7 @@ export {
   type TemplateListResponse,
   type TemplateRetrieveParams,
   type TemplateListParams,
+  type TemplateDeleteParams,
   type TemplatePublishParams,
   type TemplateReplaceParams,
 } from './templates';

package/src/resources/tenants/templates/templates.ts

@@ -6,6 +6,7 @@ import * as TenantsAPI from '../tenants';
 import * as VersionsAPI from './versions';
 import { VersionRetrieveParams, Versions } from './versions';
 import { APIPromise } from '../../../core/api-promise';
+import { buildHeaders } from '../../../internal/headers';
 import { RequestOptions } from '../../../internal/request-options';
 import { path } from '../../../internal/utils/path';
 
@@ -50,6 +51,29 @@ export class Templates extends APIResource {
     return this._client.get(path`/tenants/${tenantID}/templates`, { query, ...options });
   }
 
+  /**
+   * Deletes the tenant's notification template with the given `template_id`.
+   *
+   * Returns **204 No Content** with an empty body on success.
+   *
+   * Returns **404** if there is no template with this ID for the tenant, including a
+   * second `DELETE` after a successful removal.
+   *
+   * @example
+   * ```ts
+   * await client.tenants.templates.delete('template_id', {
+   *   tenant_id: 'tenant_id',
+   * });
+   * ```
+   */
+  delete(templateID: string, params: TemplateDeleteParams, options?: RequestOptions): APIPromise<void> {
+    const { tenant_id } = params;
+    return this._client.delete(path`/tenants/${tenant_id}/templates/${templateID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
   /**
    * Publishes a specific version of a notification template for a tenant.
    *
@@ -174,6 +198,13 @@ export interface TemplateListParams {
   limit?: number | null;
 }
 
+export interface TemplateDeleteParams {
+  /**
+   * Id of the tenant that owns the template.
+   */
+  tenant_id: string;
+}
+
 export interface TemplatePublishParams {
   /**
    * Path param: Id of the tenant that owns the template.
@@ -214,6 +245,7 @@ export declare namespace Templates {
     type TemplateListResponse as TemplateListResponse,
     type TemplateRetrieveParams as TemplateRetrieveParams,
     type TemplateListParams as TemplateListParams,
+    type TemplateDeleteParams as TemplateDeleteParams,
     type TemplatePublishParams as TemplatePublishParams,
     type TemplateReplaceParams as TemplateReplaceParams,
   };

package/src/resources/tenants/tenants.ts

@@ -7,6 +7,7 @@ import * as PreferencesAPI from './preferences/preferences';
 import { Preferences } from './preferences/preferences';
 import * as TemplatesAPI from './templates/templates';
 import {
+  TemplateDeleteParams,
   TemplateListParams,
   TemplateListResponse,
   TemplatePublishParams,
@@ -463,6 +464,7 @@ export declare namespace Tenants {
     type TemplateListResponse as TemplateListResponse,
     type TemplateRetrieveParams as TemplateRetrieveParams,
     type TemplateListParams as TemplateListParams,
+    type TemplateDeleteParams as TemplateDeleteParams,
     type TemplatePublishParams as TemplatePublishParams,
     type TemplateReplaceParams as TemplateReplaceParams,
   };

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '7.10.2'; // x-release-please-version
+export const VERSION = '7.11.0'; // x-release-please-version

package/uploads.d.mts

@@ -1,2 +1,3 @@
+/** @deprecated Import from ./core/uploads instead */
 export * from "./core/uploads.mjs";
 //# sourceMappingURL=uploads.d.mts.map

package/uploads.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"uploads.d.mts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}
+{"version":3,"file":"uploads.d.mts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,mCAA+B"}

package/uploads.d.ts

@@ -1,2 +1,3 @@
+/** @deprecated Import from ./core/uploads instead */
 export * from "./core/uploads.js";
 //# sourceMappingURL=uploads.d.ts.map

package/uploads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uploads.d.ts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}
+{"version":3,"file":"uploads.d.ts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,kCAA+B"}

package/uploads.mjs

@@ -1,2 +1,3 @@
+/** @deprecated Import from ./core/uploads instead */
 export * from "./core/uploads.mjs";
 //# sourceMappingURL=uploads.mjs.map

package/uploads.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"uploads.mjs","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}
+{"version":3,"file":"uploads.mjs","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,mCAA+B"}

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "7.10.2";
+export declare const VERSION = "7.11.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "7.10.2";
+export declare const VERSION = "7.11.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '7.10.2'; // x-release-please-version
+exports.VERSION = '7.11.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '7.10.2'; // x-release-please-version
+export const VERSION = '7.11.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map