@trycourier/courier 8.0.0 → 9.1.0

package/src/resources/journeys/runs.ts

@@ -0,0 +1,104 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as JourneysAPI from './journeys';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+/**
+ * Build, version, publish, invoke, and cancel multi-step notification workflows, along with the templates scoped to them.
+ */
+export class Runs extends APIResource {
+  /**
+   * Fetch one Journey run by id. Returns `404` for an unknown run, a run belonging
+   * to another workspace, a run past the 95-day retention window, or an Automation
+   * run id — the same body in every case, so the response never reveals whether a
+   * run exists elsewhere.
+   *
+   * @example
+   * ```ts
+   * const journeyRunResponse =
+   *   await client.journeys.runs.retrieve('x');
+   * ```
+   */
+  retrieve(runID: string, options?: RequestOptions): APIPromise<JourneysAPI.JourneyRunResponse> {
+    return this._client.get(path`/journeys/runs/${runID}`, options);
+  }
+
+  /**
+   * List runs of the workspace's Journeys, newest first, filtered by status,
+   * Journey, or date range and paged by cursor. Runs of v2 Automations are listed by
+   * `GET /automations/runs` instead — the two surfaces never return each other's
+   * runs. Runs are retained for 95 days.
+   *
+   * @example
+   * ```ts
+   * const journeyRunListResponse =
+   *   await client.journeys.runs.list();
+   * ```
+   */
+  list(
+    query: RunListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<JourneysAPI.JourneyRunListResponse> {
+    return this._client.get('/journeys/runs', { query, ...options });
+  }
+
+  /**
+   * List the per-node state of one Journey run, in full — this endpoint is not
+   * paginated. Each step's `node_id` is the id of the node in the published Journey,
+   * so a step maps directly onto the Journey graph. `message_id` is present on send
+   * steps that produced a message; follow it to `GET /messages/{message_id}` for
+   * delivery status.
+   *
+   * @example
+   * ```ts
+   * const journeyRunStepsResponse =
+   *   await client.journeys.runs.listSteps('x');
+   * ```
+   */
+  listSteps(runID: string, options?: RequestOptions): APIPromise<JourneysAPI.JourneyRunStepsResponse> {
+    return this._client.get(path`/journeys/runs/${runID}/steps`, options);
+  }
+}
+
+export interface RunListParams {
+  /**
+   * A cursor token for pagination. Use the `next_cursor` from the previous response
+   * to fetch the next page of results. Treat it as opaque.
+   */
+  cursor?: string;
+
+  /**
+   * An inclusive upper bound on `created_at`, in the same format as `start_date`.
+   */
+  end_date?: string;
+
+  /**
+   * The number of runs to return per page, between `1` and `50`. Defaults to `20`.
+   * Values outside the range are clamped, and a non-numeric value falls back to
+   * `20`.
+   */
+  limit?: string;
+
+  /**
+   * An inclusive lower bound on `created_at`, as an ISO 8601 date or timestamp (e.g.
+   * `2026-08-18` or `2026-08-18T20:06:36.259Z`). Any other format returns `400`.
+   */
+  start_date?: string;
+
+  /**
+   * A comma-separated list of run statuses to filter on, e.g. `PROCESSED,ERROR`.
+   */
+  status?: string;
+
+  /**
+   * A comma-separated list of Journey ids to filter on.
+   */
+  template_id?: string;
+}
+
+export declare namespace Runs {
+  export { type RunListParams as RunListParams };
+}

package/src/resources/notifications/notifications.ts

@@ -124,21 +124,6 @@ export class Notifications extends APIResource {
     });
   }
 
-  /**
-   * Copies a notification template within the same workspace and environment,
-   * appending " COPY" to the title. The copy is standalone and independently
-   * editable.
-   *
-   * @example
-   * ```ts
-   * const notificationTemplateResponse =
-   *   await client.notifications.duplicate('id');
-   * ```
-   */
-  duplicate(id: string, options?: RequestOptions): APIPromise<NotificationTemplateResponse> {
-    return this._client.post(path`/notifications/${id}/duplicate`, options);
-  }
-
   /**
    * Returns a notification template's published versions, most recent first, for
    * comparison or rollback. Paged.

package/src/resources/shared.ts

@@ -14,6 +14,13 @@ export interface AirshipProfileAudience {
 
 export type Alignment = 'center' | 'left' | 'right' | 'full';
 
+/**
+ * Apple Push Notification device tokens. Supply either a single `token` or a
+ * `tokens` value. A bare string is rejected by the provider — the token must be
+ * wrapped in this object.
+ */
+export type Apn = Token | MultipleTokens;
+
 export interface AudienceFilter {
   /**
    * Send to users only if they are member of the account
@@ -259,6 +266,9 @@ export interface ElementalTextNodeWithType extends ElementalBaseNode {
   type?: 'text';
 }
 
+/**
+ * Expo push tokens. Supply either a single `token` or a `tokens` value.
+ */
 export type Expo = Token | MultipleTokens;
 
 /**
@@ -394,7 +404,11 @@ export interface MsTeamsRecipient {
 }
 
 export interface MultipleTokens {
-  tokens: Array<Token>;
+  /**
+   * One device token, or an array of them. The values are the token strings
+   * themselves — not objects.
+   */
+  tokens: string | Array<string>;
 }
 
 export interface NotificationPreferenceDetails {
@@ -550,7 +564,12 @@ export interface UserProfile {
 
   airship?: AirshipProfile | null;
 
-  apn?: string | null;
+  /**
+   * Apple Push Notification device tokens. Supply either a single `token` or a
+   * `tokens` value. A bare string is rejected by the provider — the token must be
+   * wrapped in this object.
+   */
+  apn?: Apn | null;
 
   /**
    * Routes a push notification through the AWS SNS provider. The target ARN must be
@@ -573,6 +592,9 @@ export interface UserProfile {
 
   email_verified?: boolean | null;
 
+  /**
+   * Expo push tokens. Supply either a single `token` or a `tokens` value.
+   */
   expo?: Expo | null;
 
   facebookPSID?: string | null;

package/src/resources/users/preferences.ts

@@ -244,6 +244,20 @@ export interface TopicPreference {
    * custom_routing) rather than the topic's default routing.
    */
   has_custom_routing?: boolean | null;
+
+  /**
+   * The unique identifier of the section this topic belongs to. Always present when
+   * listing a user's preferences; omitted by the single-topic read when the topic
+   * has no resolvable section.
+   */
+  section_id?: string;
+
+  /**
+   * The display name of the section this topic belongs to. Always present when
+   * listing a user's preferences; omitted by the single-topic read when the topic
+   * has no resolvable section.
+   */
+  section_name?: string;
 }
 
 export interface PreferenceRetrieveResponse {

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '8.0.0'; // x-release-please-version
+export const VERSION = '9.1.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "8.0.0";
+export declare const VERSION = "9.1.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 = '8.0.0'; // x-release-please-version
+exports.VERSION = '9.1.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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