@trycourier/courier 9.4.2 → 9.4.4

package/resources/tenants/templates/templates.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"templates.mjs","sourceRoot":"","sources":["../../../src/resources/tenants/templates/templates.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,mCAA+B;AAGrD,OAAO,KAAK,WAAW,uBAAmB;AAC1C,OAAO,EAAyB,QAAQ,EAAE,uBAAmB;AAE7D,OAAO,EAAE,YAAY,EAAE,sCAAkC;AAEzD,OAAO,EAAE,IAAI,EAAE,yCAAqC;AAEpD;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,WAAW;IAA1C;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAkH1E,CAAC;IAhHC;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,UAAkB,EAClB,MAA8B,EAC9B,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,YAAY,SAAS,cAAc,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;IACxF,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAAgB,EAChB,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,YAAY,QAAQ,YAAY,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvF,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,UAAkB,EAAE,MAA4B,EAAE,OAAwB;QAC/E,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,YAAY,SAAS,cAAc,UAAU,EAAE,EAAE;YAC9E,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;;;;;;;;;;;;OAYG;IACH,OAAO,CACL,UAAkB,EAClB,MAA6B,EAC7B,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,YAAY,SAAS,cAAc,UAAU,UAAU,EAAE;YACpF,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CACL,UAAkB,EAClB,MAA6B,EAC7B,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,YAAY,SAAS,cAAc,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrG,CAAC;CACF;AA8GD,SAAS,CAAC,QAAQ,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"templates.mjs","sourceRoot":"","sources":["../../../src/resources/tenants/templates/templates.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,mCAA+B;AAGrD,OAAO,KAAK,WAAW,uBAAmB;AAC1C,OAAO,EAAyB,QAAQ,EAAE,uBAAmB;AAE7D,OAAO,EAAE,YAAY,EAAE,sCAAkC;AAEzD,OAAO,EAAE,IAAI,EAAE,yCAAqC;AAEpD;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,WAAW;IAA1C;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA4H1E,CAAC;IA1HC;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,UAAkB,EAClB,MAA8B,EAC9B,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,YAAY,SAAS,cAAc,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;IACxF,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAAgB,EAChB,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,YAAY,QAAQ,YAAY,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvF,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,UAAkB,EAAE,MAA4B,EAAE,OAAwB;QAC/E,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,YAAY,SAAS,cAAc,UAAU,EAAE,EAAE;YAC9E,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;;;;;;;;;;;;OAYG;IACH,OAAO,CACL,UAAkB,EAClB,MAA6B,EAC7B,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,YAAY,SAAS,cAAc,UAAU,UAAU,EAAE;YACpF,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,OAAO,CACL,UAAkB,EAClB,MAA6B,EAC7B,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,YAAY,SAAS,cAAc,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrG,CAAC;CACF;AA8GD,SAAS,CAAC,QAAQ,GAAG,QAAQ,CAAC"}

package/src/client.ts

@@ -1457,6 +1457,7 @@ export declare namespace Courier {
   export type ElementalMetaNode = API.ElementalMetaNode;
   export type ElementalMetaNodeWithType = API.ElementalMetaNodeWithType;
   export type ElementalNode = API.ElementalNode;
+  export type ElementalNodeNonChannel = API.ElementalNodeNonChannel;
   export type ElementalQuoteNode = API.ElementalQuoteNode;
   export type ElementalQuoteNodeWithType = API.ElementalQuoteNodeWithType;
   export type ElementalTextNode = API.ElementalTextNode;

package/src/resources/journeys/templates.ts

@@ -17,6 +17,13 @@ export class Templates extends APIResource {
    * Create a notification template scoped to this journey. Defaults to `DRAFT`
    * state; pass `state: "PUBLISHED"` to publish on create.
    *
+   * The content tree must contain exactly one channel block whose `channel` matches
+   * the `channel` on the request — a journey-scoped template carries a single
+   * channel. Top-level elements, or a block for a different channel, return `400`.
+   * The template designer renders only the channel block matching the tab it draws,
+   * so content stored without one cannot be opened. An empty `elements` array is
+   * accepted.
+   *
    * @example
    * ```ts
    * const journeyTemplateGetResponse =
@@ -29,7 +36,7 @@ export class Templates extends APIResource {
    *       subscription: null,
    *       content: {
    *         version: '2022-01-01',
-   *         elements: [{ type: 'text' }],
+   *         elements: [{ type: 'channel' }],
    *       },
    *     },
    *   });

package/src/resources/notifications/notifications.ts

@@ -26,6 +26,16 @@ export class Notifications extends APIResource {
    * Create a notification template. Requires all fields in the notification object.
    * Templates are created in draft state by default.
    *
+   * Content must place its elements inside a channel block —
+   * `{ "type": "channel", "channel": "email", "elements": [...] }` — or the request
+   * returns `400`. The template designer renders only the channel block matching the
+   * tab it draws, so content stored without one cannot be opened. An empty
+   * `elements` array is accepted, and the requirement applies to creation only:
+   * `PUT /notifications/{id}` still accepts unwrapped content. Note this endpoint
+   * takes versioned content only — the `{ title, body }` shorthand accepted by
+   * `/send` is rejected here with an `invalid_request_error` on
+   * `notification.content.version`.
+   *
    * @example
    * ```ts
    * const notificationTemplateResponse =
@@ -864,9 +874,12 @@ export interface NotificationTemplateSummary {
 }
 
 /**
- * Request body for replacing a notification template. Same shape as create. All
- * fields required (PUT = full replacement), except `alias`, whose omission means
- * "leave the existing aliases alone".
+ * Request body for replacing a notification template. All fields are required,
+ * since `PUT` is a full replacement, except `alias`, whose omission leaves the
+ * existing aliases in place. Unlike `NotificationTemplateCreateRequest`,
+ * `notification.content` is not required to place its elements inside a channel
+ * block: the requirement applies to creation only, so templates already stored
+ * without one stay editable.
  */
 export interface NotificationTemplateUpdateRequest {
   /**

package/src/resources/shared.ts

@@ -225,6 +225,13 @@ export interface ElementalChannelNode extends ElementalBaseNode {
    */
   channel?: string;
 
+  /**
+   * An array of elements to apply to the channel. If `raw` has not been specified,
+   * `elements` is `required`. Channel elements cannot nest, so these are any node
+   * except another channel block.
+   */
+  elements?: Array<ElementalNodeNonChannel> | null;
+
   /**
    * Email only. Document-level base font size (CSS px, e.g. `16px`) for body content
    * — text, quote, list and action button labels. Heading styles (`h1`/`h2`/`h3`)
@@ -422,6 +429,76 @@ export type ElementalNode =
   | ElementalQuoteNodeWithType
   | ElementalHTMLNodeWithType;
 
+/**
+ * Any Elemental node except a channel block. Channel elements are only valid as
+ * top-level elements, so the `elements` nested inside one can never be another
+ * channel. Keeping this union channel-free also keeps the schema acyclic; a
+ * recursive `$ref` here breaks the generated Python models.
+ */
+export type ElementalNodeNonChannel =
+  | ElementalNodeNonChannel.UnionMember0
+  | ElementalNodeNonChannel.UnionMember1
+  | ElementalNodeNonChannel.UnionMember2
+  | ElementalNodeNonChannel.UnionMember3
+  | ElementalNodeNonChannel.UnionMember4
+  | ElementalNodeNonChannel.UnionMember5
+  | ElementalNodeNonChannel.UnionMember6;
+
+export namespace ElementalNodeNonChannel {
+  /**
+   * Represents a body of text to be rendered inside of the notification.
+   */
+  export interface UnionMember0 extends Shared.ElementalTextNode {
+    type?: 'text';
+  }
+
+  /**
+   * The meta element contains information describing the notification that may be
+   * used by a particular channel or provider. One important field is the title field
+   * which will be used as the title for channels that support it.
+   */
+  export interface UnionMember1 extends Shared.ElementalMetaNode {
+    type?: 'meta';
+  }
+
+  /**
+   * Used to embed an image into the notification.
+   */
+  export interface UnionMember2 extends Shared.ElementalImageNode {
+    type?: 'image';
+  }
+
+  /**
+   * Allows the user to execute an action. Can be a button or a link.
+   */
+  export interface UnionMember3 extends Shared.ElementalActionNode {
+    type?: 'action';
+  }
+
+  /**
+   * Renders a dividing line between elements.
+   */
+  export interface UnionMember4 extends Shared.ElementalDividerNode {
+    type?: 'divider';
+  }
+
+  /**
+   * Renders a quote block.
+   */
+  export interface UnionMember5 extends Shared.ElementalQuoteNode {
+    type?: 'quote';
+  }
+
+  /**
+   * Raw HTML string inside an Elemental document. When rendering a message, this
+   * node is turned into output only for the email channel; for other channels it
+   * produces no blocks.
+   */
+  export interface UnionMember6 extends Shared.ElementalHTMLNode {
+    type?: 'html';
+  }
+}
+
 /**
  * Renders a quote block.
  */
@@ -474,12 +551,6 @@ export interface ElementalQuoteNodeWithType extends ElementalQuoteNode {
  * Represents a body of text to be rendered inside of the notification.
  */
 export interface ElementalTextNode extends ElementalBaseNode {
-  /**
-   * The text content displayed in the notification. Either this field must be
-   * specified, or the elements field
-   */
-  content: string;
-
   /**
    * Text alignment.
    */
@@ -495,6 +566,12 @@ export interface ElementalTextNode extends ElementalBaseNode {
    */
   color?: string | null;
 
+  /**
+   * The text content displayed in the notification. Either this field must be
+   * specified, or the elements field
+   */
+  content?: string;
+
   /**
    * CSS px font size for this text block, e.g. `16px`. Overrides the size of the
    * `text_style` preset. Email only.

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

@@ -104,6 +104,16 @@ export class Templates extends APIResource {
    * Creates or updates a notification template scoped to one tenant, letting a
    * tenant override the content the workspace template would send.
    *
+   * This is an upsert: it creates when the tenant has no template under
+   * `template_id`, and updates when it does. On the create half, content must place
+   * its elements inside a channel block —
+   * `{ "type": "channel", "channel": "email", "elements": [...] }` — or the request
+   * returns `400`. The template designer renders only the channel block matching the
+   * tab it draws, so content stored without one cannot be opened. An empty
+   * `elements` array is accepted, as is the `{ title, body }` shorthand, which has
+   * no elements to wrap. Updates are not checked, so tenant templates already stored
+   * without a wrapper stay editable.
+   *
    * @example
    * ```ts
    * const putTenantTemplateResponse =
@@ -112,7 +122,7 @@ export class Templates extends APIResource {
    *     template: {
    *       content: {
    *         version: '2022-01-01',
-   *         elements: [{ type: 'text' }],
+   *         elements: [{ type: 'channel' }],
    *       },
    *       routing: { method: 'single', channels: ['email'] },
    *     },

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '9.4.2'; // x-release-please-version
+export const VERSION = '9.4.4'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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