@trycourier/courier 7.10.2 → 7.19.1

package/src/resources/notifications/checks.ts

@@ -9,7 +9,7 @@ import { path } from '../../internal/utils/path';
 
 export class Checks extends APIResource {
   /**
-   * Replace the checks for a notification template submission.
+   * Replace the submission checks for a notification template.
    *
    * @example
    * ```ts
@@ -38,7 +38,7 @@ export class Checks extends APIResource {
   }
 
   /**
-   * Retrieve the checks for a notification template submission.
+   * Retrieve the submission checks for a notification template.
    *
    * @example
    * ```ts
@@ -58,7 +58,7 @@ export class Checks extends APIResource {
   }
 
   /**
-   * Cancel a notification template submission.
+   * Cancel a submission for a notification template.
    *
    * @example
    * ```ts

package/src/resources/shared.ts

@@ -33,6 +33,13 @@ export interface AudienceFilterConfig {
    * Array of filter rules (single conditions or nested groups)
    */
   filters: Array<FilterConfig>;
+
+  /**
+   * The logical operator (AND/OR) combining the rules in `filters`. Required when
+   * `filters` contains more than one rule. If omitted, the top-level `operator`
+   * field on the request is used instead.
+   */
+  operator?: 'AND' | 'OR';
 }
 
 /**

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/resources/users/index.ts

@@ -2,11 +2,17 @@
 
 export {
   Preferences,
+  type BulkPreferenceTopic,
   type TopicPreference,
   type PreferenceRetrieveResponse,
+  type PreferenceBulkReplaceResponse,
+  type PreferenceBulkUpdateResponse,
   type PreferenceRetrieveTopicResponse,
   type PreferenceUpdateOrCreateTopicResponse,
   type PreferenceRetrieveParams,
+  type PreferenceBulkReplaceParams,
+  type PreferenceBulkUpdateParams,
+  type PreferenceDeleteTopicParams,
   type PreferenceRetrieveTopicParams,
   type PreferenceUpdateOrCreateTopicParams,
 } from './preferences';

package/src/resources/users/preferences.ts

@@ -3,6 +3,7 @@
 import { APIResource } from '../../core/resource';
 import * as Shared from '../shared';
 import { APIPromise } from '../../core/api-promise';
+import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
@@ -25,6 +26,125 @@ export class Preferences extends APIResource {
     return this._client.get(path`/users/${userID}/preferences`, { query, ...options });
   }
 
+  /**
+   * Replace a user's complete set of preference overrides in a single request. The
+   * topics in the request body become the recipient's entire set of overrides:
+   * listed topics are created or updated, and every existing override that is not
+   * included in the body is reset to its topic default. Submitting an empty `topics`
+   * array is a valid clear-all that resets every existing override.
+   *
+   * This operation is validation-atomic (all-or-nothing): structural validation
+   * fails fast with a single `400`, and if any topic is semantically invalid (an
+   * unknown topic, a `REQUIRED` topic that cannot be opted out, or a custom routing
+   * request that is not available on the workspace's plan) the request returns a
+   * single `400` aggregating every failure in `errors` and writes nothing. On
+   * success it returns `200` with `items` (the complete resulting override set) and
+   * `deleted` (the ids of the overrides that were reset to default).
+   *
+   * Every `topic_id` in the response — in `items`, `deleted`, and any `errors` — is
+   * returned in Courier's canonical topic id form, regardless of the form supplied
+   * in the request.
+   *
+   * @example
+   * ```ts
+   * const response = await client.users.preferences.bulkReplace(
+   *   'user_id',
+   *   {
+   *     topics: [
+   *       {
+   *         topic_id: '74Q4QGFBEX481DP6JRPMV751H4XT',
+   *         status: 'OPTED_IN',
+   *         has_custom_routing: true,
+   *         custom_routing: ['inbox', 'email'],
+   *       },
+   *     ],
+   *   },
+   * );
+   * ```
+   */
+  bulkReplace(
+    userID: string,
+    params: PreferenceBulkReplaceParams,
+    options?: RequestOptions,
+  ): APIPromise<PreferenceBulkReplaceResponse> {
+    const { tenant_id, ...body } = params;
+    return this._client.put(path`/users/${userID}/preferences`, { query: { tenant_id }, body, ...options });
+  }
+
+  /**
+   * Additively create or update a user's preferences for one or more subscription
+   * topics in a single request. Only the topics included in the request body are
+   * created or updated; any existing overrides for topics not listed are left
+   * untouched.
+   *
+   * Structural validation of the request body fails fast with a single `400`. Beyond
+   * that, each topic is processed independently (partial-success, not
+   * all-or-nothing): valid topics are written and returned in `items`, while topics
+   * that cannot be applied are collected in `errors` with a per-topic `reason` (for
+   * example an unknown topic, a `REQUIRED` topic that cannot be opted out, a custom
+   * routing request that is not available on the workspace's plan, or a write
+   * failure). The request therefore returns `200` with both lists whenever the body
+   * is structurally valid.
+   *
+   * Every `topic_id` in the response — in both `items` and `errors` — is returned in
+   * Courier's canonical topic id form, regardless of the form supplied in the
+   * request.
+   *
+   * @example
+   * ```ts
+   * const response = await client.users.preferences.bulkUpdate(
+   *   'user_id',
+   *   {
+   *     topics: [
+   *       {
+   *         topic_id: '74Q4QGFBEX481DP6JRPMV751H4XT',
+   *         status: 'OPTED_IN',
+   *         has_custom_routing: true,
+   *         custom_routing: ['inbox', 'email'],
+   *       },
+   *       {
+   *         topic_id: '5Q4QGFBEX481DP6JRPMV751H4YU',
+   *         status: 'OPTED_OUT',
+   *       },
+   *     ],
+   *   },
+   * );
+   * ```
+   */
+  bulkUpdate(
+    userID: string,
+    params: PreferenceBulkUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<PreferenceBulkUpdateResponse> {
+    const { tenant_id, ...body } = params;
+    return this._client.post(path`/users/${userID}/preferences`, { query: { tenant_id }, body, ...options });
+  }
+
+  /**
+   * Remove a user's preferences for a specific subscription topic, resetting the
+   * topic to its effective default. This operation is idempotent: deleting a
+   * preference that does not exist succeeds with no error.
+   *
+   * @example
+   * ```ts
+   * await client.users.preferences.deleteTopic('topic_id', {
+   *   user_id: 'user_id',
+   * });
+   * ```
+   */
+  deleteTopic(
+    topicID: string,
+    params: PreferenceDeleteTopicParams,
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    const { user_id, tenant_id } = params;
+    return this._client.delete(path`/users/${user_id}/preferences/${topicID}`, {
+      query: { tenant_id },
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
   /**
    * Fetch user preferences for a specific subscription topic.
    *
@@ -78,6 +198,23 @@ export class Preferences extends APIResource {
   }
 }
 
+/**
+ * A single topic override echoed in a bulk preference response.
+ */
+export interface BulkPreferenceTopic {
+  custom_routing: Array<Shared.ChannelClassification>;
+
+  has_custom_routing: boolean;
+
+  /**
+   * The applied subscription status. Echoes the requested value, so it is always
+   * OPTED_IN or OPTED_OUT.
+   */
+  status: 'OPTED_IN' | 'OPTED_OUT';
+
+  topic_id: string;
+}
+
 export interface TopicPreference {
   default_status: Shared.PreferenceStatus;
 
@@ -107,6 +244,44 @@ export interface PreferenceRetrieveResponse {
   paging: Shared.Paging;
 }
 
+export interface PreferenceBulkReplaceResponse {
+  /**
+   * The ids of the overrides that were reset to their topic default.
+   */
+  deleted: Array<string>;
+
+  /**
+   * The complete resulting set of topic overrides for the user.
+   */
+  items: Array<BulkPreferenceTopic>;
+}
+
+export interface PreferenceBulkUpdateResponse {
+  /**
+   * The topics that could not be applied, each with a reason.
+   */
+  errors: Array<PreferenceBulkUpdateResponse.Error>;
+
+  /**
+   * The topics that were successfully created or updated.
+   */
+  items: Array<BulkPreferenceTopic>;
+}
+
+export namespace PreferenceBulkUpdateResponse {
+  /**
+   * A single topic that could not be applied in a bulk preference request.
+   */
+  export interface Error {
+    /**
+     * A human-readable explanation of why the topic could not be applied.
+     */
+    reason: string;
+
+    topic_id: string;
+  }
+}
+
 export interface PreferenceRetrieveTopicResponse {
   topic: TopicPreference;
 }
@@ -122,6 +297,94 @@ export interface PreferenceRetrieveParams {
   tenant_id?: string | null;
 }
 
+export interface PreferenceBulkReplaceParams {
+  /**
+   * Body param: The complete set of topic overrides for the user. Up to 50 topics
+   * may be provided. Any existing override not listed here is reset to its topic
+   * default; an empty array resets every existing override.
+   */
+  topics: Array<PreferenceBulkReplaceParams.Topic>;
+
+  /**
+   * Query param: Replace the preferences of a user for this specific tenant context.
+   */
+  tenant_id?: string | null;
+}
+
+export namespace PreferenceBulkReplaceParams {
+  export interface Topic {
+    /**
+     * The subscription status to apply for this topic.
+     */
+    status: 'OPTED_IN' | 'OPTED_OUT';
+
+    /**
+     * A unique identifier associated with a subscription topic.
+     */
+    topic_id: string;
+
+    /**
+     * The channels a user has chosen to receive notifications through for this topic.
+     */
+    custom_routing?: Array<Shared.ChannelClassification>;
+
+    /**
+     * Whether the recipient has chosen specific delivery channels for this topic.
+     */
+    has_custom_routing?: boolean;
+  }
+}
+
+export interface PreferenceBulkUpdateParams {
+  /**
+   * Body param: The topics to create or update. Between 1 and 50 topics may be
+   * provided in a single request.
+   */
+  topics: Array<PreferenceBulkUpdateParams.Topic>;
+
+  /**
+   * Query param: Update the preferences of a user for this specific tenant context.
+   */
+  tenant_id?: string | null;
+}
+
+export namespace PreferenceBulkUpdateParams {
+  export interface Topic {
+    /**
+     * The subscription status to apply for this topic.
+     */
+    status: 'OPTED_IN' | 'OPTED_OUT';
+
+    /**
+     * A unique identifier associated with a subscription topic.
+     */
+    topic_id: string;
+
+    /**
+     * The channels a user has chosen to receive notifications through for this topic.
+     */
+    custom_routing?: Array<Shared.ChannelClassification>;
+
+    /**
+     * Whether the recipient has chosen specific delivery channels for this topic.
+     */
+    has_custom_routing?: boolean;
+  }
+}
+
+export interface PreferenceDeleteTopicParams {
+  /**
+   * Path param: A unique identifier associated with the user whose preferences you
+   * wish to delete.
+   */
+  user_id: string;
+
+  /**
+   * Query param: Delete the preferences of a user for this specific tenant context.
+   */
+  tenant_id?: string | null;
+}
+
 export interface PreferenceRetrieveTopicParams {
   /**
    * Path param: A unique identifier associated with the user whose preferences you
@@ -168,11 +431,17 @@ export namespace PreferenceUpdateOrCreateTopicParams {
 
 export declare namespace Preferences {
   export {
+    type BulkPreferenceTopic as BulkPreferenceTopic,
     type TopicPreference as TopicPreference,
     type PreferenceRetrieveResponse as PreferenceRetrieveResponse,
+    type PreferenceBulkReplaceResponse as PreferenceBulkReplaceResponse,
+    type PreferenceBulkUpdateResponse as PreferenceBulkUpdateResponse,
     type PreferenceRetrieveTopicResponse as PreferenceRetrieveTopicResponse,
     type PreferenceUpdateOrCreateTopicResponse as PreferenceUpdateOrCreateTopicResponse,
     type PreferenceRetrieveParams as PreferenceRetrieveParams,
+    type PreferenceBulkReplaceParams as PreferenceBulkReplaceParams,
+    type PreferenceBulkUpdateParams as PreferenceBulkUpdateParams,
+    type PreferenceDeleteTopicParams as PreferenceDeleteTopicParams,
     type PreferenceRetrieveTopicParams as PreferenceRetrieveTopicParams,
     type PreferenceUpdateOrCreateTopicParams as PreferenceUpdateOrCreateTopicParams,
   };

package/src/resources/users/users.ts

@@ -3,6 +3,12 @@
 import { APIResource } from '../../core/resource';
 import * as PreferencesAPI from './preferences';
 import {
+  BulkPreferenceTopic,
+  PreferenceBulkReplaceParams,
+  PreferenceBulkReplaceResponse,
+  PreferenceBulkUpdateParams,
+  PreferenceBulkUpdateResponse,
+  PreferenceDeleteTopicParams,
   PreferenceRetrieveParams,
   PreferenceRetrieveResponse,
   PreferenceRetrieveTopicParams,
@@ -46,11 +52,17 @@ Users.Tokens = Tokens;
 export declare namespace Users {
   export {
     Preferences as Preferences,
+    type BulkPreferenceTopic as BulkPreferenceTopic,
     type TopicPreference as TopicPreference,
     type PreferenceRetrieveResponse as PreferenceRetrieveResponse,
+    type PreferenceBulkReplaceResponse as PreferenceBulkReplaceResponse,
+    type PreferenceBulkUpdateResponse as PreferenceBulkUpdateResponse,
     type PreferenceRetrieveTopicResponse as PreferenceRetrieveTopicResponse,
     type PreferenceUpdateOrCreateTopicResponse as PreferenceUpdateOrCreateTopicResponse,
     type PreferenceRetrieveParams as PreferenceRetrieveParams,
+    type PreferenceBulkReplaceParams as PreferenceBulkReplaceParams,
+    type PreferenceBulkUpdateParams as PreferenceBulkUpdateParams,
+    type PreferenceDeleteTopicParams as PreferenceDeleteTopicParams,
     type PreferenceRetrieveTopicParams as PreferenceRetrieveTopicParams,
     type PreferenceUpdateOrCreateTopicParams as PreferenceUpdateOrCreateTopicParams,
   };

package/src/resources/workspace-preferences/index.ts

@@ -0,0 +1,25 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Topics,
+  type TopicCreateParams,
+  type TopicRetrieveParams,
+  type TopicArchiveParams,
+  type TopicReplaceParams,
+} from './topics';
+export {
+  WorkspacePreferences,
+  type PublishPreferencesRequest,
+  type PublishPreferencesResponse,
+  type WorkspacePreferenceCreateRequest,
+  type WorkspacePreferenceGetResponse,
+  type WorkspacePreferenceListResponse,
+  type WorkspacePreferenceReplaceRequest,
+  type WorkspacePreferenceTopicCreateRequest,
+  type WorkspacePreferenceTopicGetResponse,
+  type WorkspacePreferenceTopicListResponse,
+  type WorkspacePreferenceTopicReplaceRequest,
+  type WorkspacePreferenceCreateParams,
+  type WorkspacePreferencePublishParams,
+  type WorkspacePreferenceReplaceParams,
+} from './workspace-preferences';