@cowliss/sdk 0.19.0 → 0.20.0

package/CHANGELOG.md

@@ -4,6 +4,12 @@
 
 What changed in each version of `@cowliss/sdk` after 0.16.0, newest first. Earlier versions are listed on [npm](https://www.npmjs.com/package/@cowliss/sdk?activeTab=versions).
 
+## 0.20.0 (2026-10-02)
+
+### Features
+
+- cow.templates.preview renders a template with your own props
+
 ## 0.19.0 (2026-10-02)
 
 ### Features

package/README.md

@@ -60,6 +60,13 @@ delivery id. A message to a profile goes to its `email` trait, skips anyone
 who turned that purpose off, and carries an unsubscribe link. Mail that
 follows a rule or a wait belongs in a journey.
 
+Render a pushed template with your own props, exactly as a send to an address
+would, without sending it:
+
+```ts
+const { subject, html } = await cow.templates.preview({ key: "receipt", props: { name: "Ada" } });
+```
+
 Send someone to their hosted email preferences page from your own "Manage
 email preferences" button. The link works for an hour, so ask for it on the
 click:

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import type { BatchBody, BatchResultDto, ErrorCode, EventDto, GetPreferencesInput, IdentifyInput, Preferences, PreferencesLink, PreferencesLinkInput, ProfileDto, SendEmailInput, SendEmailResult, SetPreferencesInput, TrackInput } from "./types.js";
+import type { BatchBody, BatchResultDto, ErrorCode, EventDto, GetPreferencesInput, IdentifyInput, Preferences, PreferencesLink, PreferencesLinkInput, PreviewEmailInput, ProfileDto, SendEmailInput, SendEmailResult, SetPreferencesInput, TemplatePreview, TrackInput } from "./types.js";
 export type * from "./types.js";
 /**
  * The Cowliss TS client SDK. Small typed surface over the ingestion API:
@@ -112,6 +112,14 @@ export declare class Cow {
             idempotencyKey?: string;
         }) => Promise<SendEmailResult>;
     };
+    /**
+     * Templates as a send renders them. `preview` renders a pushed template
+     * with your own props, exactly as `emails.send` to an address would, and
+     * sends nothing: for showing your operators the message before it goes.
+     */
+    templates: {
+        preview: (input: WithDefaultSource<PreviewEmailInput>) => Promise<TemplatePreview>;
+    };
     /**
      * One person's email preferences, `to` naming them as in `emails.send`.
      *

package/dist/index.js

@@ -132,6 +132,16 @@ export class Cow {
     emails = {
         send: ({ idempotencyKey, ...input }) => this.#watch(async () => this.#post("/v1/emails", { data: { ...input, sourceId: this.#sourceFor(input) } }, idempotencyKey ?? crypto.randomUUID())),
     };
+    /**
+     * Templates as a send renders them. `preview` renders a pushed template
+     * with your own props, exactly as `emails.send` to an address would, and
+     * sends nothing: for showing your operators the message before it goes.
+     */
+    templates = {
+        preview: (input) => this.#watch(async () => this.#post("/v1/email-previews", {
+            data: { ...input, sourceId: this.#sourceFor(input) },
+        })),
+    };
     /**
      * One person's email preferences, `to` naming them as in `emails.send`.
      *

package/dist/types.d.ts

@@ -161,6 +161,20 @@ export type SendEmailResult = {
     /** The delivery this send left behind: the row in Deliveries. */
     deliveryId: string;
 };
+/** A template key and the props a send would pass it. */
+export type PreviewEmailInput = {
+    sourceId: string;
+    key: string;
+    props?: Record<string, unknown>;
+};
+/** What a send of the template would carry. */
+export type TemplatePreview = {
+    subject: string;
+    html: string;
+    text: string;
+    /** The version that rendered it: the latest one that finished compiling. */
+    versionId: string;
+};
 /** One profile, named the way a send to a profile names it. */
 export type PreferencesLinkInput = {
     sourceId: string;

package/dist/version.autogenerated.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.19.0";
+export declare const SDK_VERSION = "0.20.0";

package/dist/version.autogenerated.js

@@ -1,2 +1,2 @@
 // Generated by scripts/version.ts from package.json. Do not edit.
-export const SDK_VERSION = "0.19.0";
+export const SDK_VERSION = "0.20.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cowliss/sdk",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "type": "module",
   "exports": {
     ".": {