@shware/workflow 0.4.0 → 2.0.0

package/dist/dsl/template.d.mts

@@ -1,76 +1,26 @@
-import { DiscordTemplate, EmailTemplate, PropsSchema, PushTemplate, SlackTemplate } from "../templates.mjs";
+import { DiscordTemplate, EmailTemplate, PushTemplate, SlackTemplate } from "../templates.mjs";
 import * as core from "zod/v4/core";
 //#region src/dsl/template.d.ts
 export type Channel = 'email' | 'sms' | 'push' | 'in_app' | 'slack' | 'discord' | 'survey';
 export type EmptyProps = Record<never, never>;
-/**
- * Template reference: a top-level named asset, reusable across workflows and
- * versioned on its own. The props shape is declared here and checked at use.
- */
+/** A template by key, its props typed by hand: for the channels without template definitions. */
 export interface TemplateRef<C extends Channel = Channel, P extends object = EmptyProps> {
   readonly channel: C;
   readonly key: string;
   readonly __props?: P;
 }
 export interface TemplateFactory {
-  email<P extends object = EmptyProps>(key: string): TemplateRef<'email', P>;
   sms<P extends object = EmptyProps>(key: string): TemplateRef<'sms', P>;
-  push<P extends object = EmptyProps>(key: string): TemplateRef<'push', P>;
   inApp<P extends object = EmptyProps>(key: string): TemplateRef<'in_app', P>;
-  slack<P extends object = EmptyProps>(key: string): TemplateRef<'slack', P>;
-  discord<P extends object = EmptyProps>(key: string): TemplateRef<'discord', P>;
   survey<P extends object = EmptyProps>(key: string): TemplateRef<'survey', P>;
 }
 /**
- * Unbound template references, props typed by hand. Email and push refs come
- * from the registries (`templates<Emails, Pushes>()`), which type both key and
- * props; this is the low-level form for channels without a registry (sms,
- * slack, …) and for tests.
+ * Template references for the channels an app-supplied sender renders:
  *
- *   const alert = template.slack<{ plan: string }>('cs_churn_alert');
+ *   const code = template.sms<{ code: string }>('login_code');
  */
 export declare const template: TemplateFactory;
 /** Template props: the input type of the template's Zod `props` schema — what the DSL passes. */
 export type PropsOf<M> = M extends EmailTemplate<infer S> | PushTemplate<infer S> | DiscordTemplate<infer S, never> | SlackTemplate<infer S, never> ? core.input<S> extends object ? core.input<S> : EmptyProps : never;
-/**
- * The channel registries: what the config registers as `templates` and what
- * `templates()` derives the references from — one type for both. Leave it
- * inferred, or check it with `satisfies TemplateRegistry`: annotating a value
- * as the bare type widens the keys to `string`.
- */
-export interface TemplateRegistry<E extends Readonly<Record<string, EmailTemplate>> = Readonly<Record<string, EmailTemplate>>, P extends Readonly<Record<string, PushTemplate>> = Readonly<Record<string, PushTemplate>>> {
-  readonly email?: E;
-  readonly push?: P;
-  /** Discord webhook templates, each typed by the host's Env its `webhook` reads. */
-  readonly discord?: Readonly<Record<string, DiscordTemplate<PropsSchema, never>>>;
-  readonly slack?: Readonly<Record<string, SlackTemplate<PropsSchema, never>>>;
-}
-/** One channel's registry in `R`, without the `undefined` of an optional field; `never` when absent. */
-type ChannelRegistry<R, K extends 'email' | 'push' | 'discord' | 'slack'> = K extends keyof R ? Exclude<R[K], undefined> : never;
-/** One reference per registered key, each typed by its own template's `props`. */
-export type TemplateRefTable<C extends Channel, R> = { readonly [K in keyof R & string]: TemplateRef<C, PropsOf<R[K]>>; };
-/** `t.email.<key>` / `t.push.<key>`; a channel the registry leaves out is an empty table. */
-export interface TemplateRefs<R extends TemplateRegistry> {
-  readonly email: [ChannelRegistry<R, 'email'>] extends [never] ? EmptyProps : TemplateRefTable<'email', ChannelRegistry<R, 'email'>>;
-  readonly push: [ChannelRegistry<R, 'push'>] extends [never] ? EmptyProps : TemplateRefTable<'push', ChannelRegistry<R, 'push'>>;
-  readonly discord: [ChannelRegistry<R, 'discord'>] extends [never] ? EmptyProps : TemplateRefTable<'discord', ChannelRegistry<R, 'discord'>>;
-  readonly slack: [ChannelRegistry<R, 'slack'>] extends [never] ? EmptyProps : TemplateRefTable<'slack', ChannelRegistry<R, 'slack'>>;
-}
-/**
- * Template references derived from the registries themselves: **the
- * registries type the keys** — an unregistered key fails to compile, and a
- * push template is not accepted where an email is — and each template's
- * `props` schema types its use sites. Templates are registered once; the
- * config takes the registries, the workflows take the references:
- *
- *   export const registry = { email, push };
- *   export const t = templates(registry);
- *   flow.email(t.email.welcome, { name: u.name });
- *
- * Each reference is a plain `{ channel, key }` built from the registry's own
- * keys; no template is rendered, and the registries are left untouched.
- */
-export declare function templates<const R extends TemplateRegistry>(registry: R): TemplateRefs<R>;
 //#endregion
-export {};
 //# sourceMappingURL=template.d.mts.map

package/dist/dsl/template.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"template.d.mts","names":[],"sources":["../../src/dsl/template.ts"],"mappings":";;;YAyBY;YAEA,aAAa;;;;;iBAMR,YAAY,UAAU,UAAU,SAAS,mBAAmB;WAClE,SAAS;WACT;WACA,UAAU;;iBAGJ;EACf,MAAM,mBAAmB,YAAY,cAAc,qBAAqB;EACxE,IAAI,mBAAmB,YAAY,cAAc,mBAAmB;EACpE,KAAK,mBAAmB,YAAY,cAAc,oBAAoB;EACtE,MAAM,mBAAmB,YAAY,cAAc,sBAAsB;EACzE,MAAM,mBAAmB,YAAY,cAAc,qBAAqB;EACxE,QAAQ,mBAAmB,YAAY,cAAc,uBAAuB;EAC5E,OAAO,mBAAmB,YAAY,cAAc,sBAAsB;;;;;;;;;;qBAe/D,UAAU;;YAaX,QAAQ,KAAK,UACrB,oBAAoB,KACpB,mBAAmB,KACnB,sBAAsB,YACtB,oBAAoB,YACpB,KAAK,MAAM,oBACT,KAAK,MAAM,KACX;;;;;;;iBASW,iBACf,UAAU,SAAS,eAAe,kBAAkB,SAAS,eAAe,iBAC5E,UAAU,SAAS,eAAe,iBAAiB,SAAS,eAAe;WAElE,QAAQ;WACR,OAAO;;WAEP,UAAU,SAAS,eAAe,gBAAgB;WAClD,QAAQ,SAAS,eAAe,cAAc;;;KAIpD,gBAAgB,GAAG,oDAAoD,gBAAgB,IACxF,QAAQ,EAAE;;YAIF,iBAAiB,UAAU,SAAS,iBACpC,WAAW,aAAa,YAAY,GAAG,QAAQ,EAAE;;iBAI5C,aAAa,UAAU;WAC7B,QAAQ,gBAAgB,+BAC7B,aACA,0BAA0B,gBAAgB;WACrC,OAAO,gBAAgB,8BAC5B,aACA,yBAAyB,gBAAgB;WACpC,UAAU,gBAAgB,iCAC/B,aACA,4BAA4B,gBAAgB;WACvC,QAAQ,gBAAgB,+BAC7B,aACA,0BAA0B,gBAAgB;;;;;;;;;;;;;;;;wBAiBhC,gBAAgB,UAAU,kBAAkB,UAAU,IAAI,aAAa"}
+{"version":3,"file":"template.d.mts","names":[],"sources":["../../src/dsl/template.ts"],"mappings":";;;YAUY;YAEA,aAAa;;iBAGR,YAAY,UAAU,UAAU,SAAS,mBAAmB;WAClE,SAAS;WACT;WACA,UAAU;;iBAGJ;EACf,IAAI,mBAAmB,YAAY,cAAc,mBAAmB;EACpE,MAAM,mBAAmB,YAAY,cAAc,sBAAsB;EACzE,OAAO,mBAAmB,YAAY,cAAc,sBAAsB;;;;;;;qBAY/D,UAAU;;YAOX,QAAQ,KAAK,UACrB,oBAAoB,KACpB,mBAAmB,KACnB,sBAAsB,YACtB,oBAAoB,YACpB,KAAK,MAAM,oBACT,KAAK,MAAM,KACX"}

package/dist/dsl/template.mjs

@@ -1,63 +1,19 @@
-import { isDiscordTemplate, isEmailTemplate, isPushTemplate, isSlackTemplate } from "../templates.mjs";
 //#region src/dsl/template.ts
 const makeTemplate = (channel) => (key) => ({
 	channel,
 	key
 });
 /**
-* Unbound template references, props typed by hand. Email and push refs come
-* from the registries (`templates<Emails, Pushes>()`), which type both key and
-* props; this is the low-level form for channels without a registry (sms,
-* slack, …) and for tests.
+* Template references for the channels an app-supplied sender renders:
 *
-*   const alert = template.slack<{ plan: string }>('cs_churn_alert');
+*   const code = template.sms<{ code: string }>('login_code');
 */
 const template = {
-	email: makeTemplate("email"),
 	sms: makeTemplate("sms"),
-	push: makeTemplate("push"),
 	inApp: makeTemplate("in_app"),
-	slack: makeTemplate("slack"),
-	discord: makeTemplate("discord"),
 	survey: makeTemplate("survey")
 };
-/**
-* Template references derived from the registries themselves: **the
-* registries type the keys** — an unregistered key fails to compile, and a
-* push template is not accepted where an email is — and each template's
-* `props` schema types its use sites. Templates are registered once; the
-* config takes the registries, the workflows take the references:
-*
-*   export const registry = { email, push };
-*   export const t = templates(registry);
-*   flow.email(t.email.welcome, { name: u.name });
-*
-* Each reference is a plain `{ channel, key }` built from the registry's own
-* keys; no template is rendered, and the registries are left untouched.
-*/
-function templates(registry) {
-	return {
-		email: refTable("email", registry.email, isEmailTemplate),
-		push: refTable("push", registry.push, isPushTemplate),
-		discord: refTable("discord", registry.discord, isDiscordTemplate),
-		slack: refTable("slack", registry.slack, isSlackTemplate)
-	};
-}
-const ARTICLE = {
-	email: "an email",
-	push: "a push",
-	discord: "a Discord",
-	slack: "a Slack"
-};
-function refTable(channel, entries, is) {
-	const table = Object.create(null);
-	for (const [key, entry] of Object.entries(entries ?? {})) {
-		if (!is(entry)) throw new TypeError(`templates(): '${key}' in the ${channel} registry is not ${ARTICLE[channel]} template`);
-		table[key] = template[channel](key);
-	}
-	return Object.freeze(table);
-}
 //#endregion
-export { template, templates };
+export { template };
 
 //# sourceMappingURL=template.mjs.map

package/dist/dsl/template.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"template.mjs","names":[],"sources":["../../src/dsl/template.ts"],"sourcesContent":["/**\n * Templates — named message-content assets. The DSL only ever holds a\n * reference ({ channel, key, phantom props }); the content itself (react-email\n * components) lives in the app and meets the reference again in the studio and\n * at send time via the registry.\n *\n * Type technique: `templates(registry)` derives the references from the\n * registries so **the registries type the keys** — an unregistered key fails\n * to compile — while `PropsOf<M>` reads the props contract off each template's\n * Zod schema, so it is written exactly once.\n */\n\nimport type * as core from 'zod/v4/core';\nimport {\n  type DiscordTemplate,\n  type EmailTemplate,\n  type PropsSchema,\n  type PushTemplate,\n  type SlackTemplate,\n  isDiscordTemplate,\n  isEmailTemplate,\n  isPushTemplate,\n  isSlackTemplate,\n} from '../templates';\n\nexport type Channel = 'email' | 'sms' | 'push' | 'in_app' | 'slack' | 'discord' | 'survey';\n\nexport type EmptyProps = Record<never, never>;\n\n/**\n * Template reference: a top-level named asset, reusable across workflows and\n * versioned on its own. The props shape is declared here and checked at use.\n */\nexport interface TemplateRef<C extends Channel = Channel, P extends object = EmptyProps> {\n  readonly channel: C;\n  readonly key: string;\n  readonly __props?: P;\n}\n\nexport interface TemplateFactory {\n  email<P extends object = EmptyProps>(key: string): TemplateRef<'email', P>;\n  sms<P extends object = EmptyProps>(key: string): TemplateRef<'sms', P>;\n  push<P extends object = EmptyProps>(key: string): TemplateRef<'push', P>;\n  inApp<P extends object = EmptyProps>(key: string): TemplateRef<'in_app', P>;\n  slack<P extends object = EmptyProps>(key: string): TemplateRef<'slack', P>;\n  discord<P extends object = EmptyProps>(key: string): TemplateRef<'discord', P>;\n  survey<P extends object = EmptyProps>(key: string): TemplateRef<'survey', P>;\n}\n\nconst makeTemplate =\n  <C extends Channel>(channel: C) =>\n  <P extends object = EmptyProps>(key: string): TemplateRef<C, P> => ({ channel, key });\n\n/**\n * Unbound template references, props typed by hand. Email and push refs come\n * from the registries (`templates<Emails, Pushes>()`), which type both key and\n * props; this is the low-level form for channels without a registry (sms,\n * slack, …) and for tests.\n *\n *   const alert = template.slack<{ plan: string }>('cs_churn_alert');\n */\nexport const template: TemplateFactory = {\n  email: makeTemplate('email'),\n  sms: makeTemplate('sms'),\n  push: makeTemplate('push'),\n  inApp: makeTemplate('in_app'),\n  slack: makeTemplate('slack'),\n  discord: makeTemplate('discord'),\n  survey: makeTemplate('survey'),\n};\n\n/* ----------------------------- Template registry ---------------------------- */\n\n/** Template props: the input type of the template's Zod `props` schema — what the DSL passes. */\nexport type PropsOf<M> = M extends\n  | EmailTemplate<infer S>\n  | PushTemplate<infer S>\n  | DiscordTemplate<infer S, never>\n  | SlackTemplate<infer S, never>\n  ? core.input<S> extends object\n    ? core.input<S>\n    : EmptyProps\n  : never;\n\n/**\n * The channel registries: what the config registers as `templates` and what\n * `templates()` derives the references from — one type for both. Leave it\n * inferred, or check it with `satisfies TemplateRegistry`: annotating a value\n * as the bare type widens the keys to `string`.\n */\nexport interface TemplateRegistry<\n  E extends Readonly<Record<string, EmailTemplate>> = Readonly<Record<string, EmailTemplate>>,\n  P extends Readonly<Record<string, PushTemplate>> = Readonly<Record<string, PushTemplate>>,\n> {\n  readonly email?: E;\n  readonly push?: P;\n  /** Discord webhook templates, each typed by the host's Env its `webhook` reads. */\n  readonly discord?: Readonly<Record<string, DiscordTemplate<PropsSchema, never>>>;\n  readonly slack?: Readonly<Record<string, SlackTemplate<PropsSchema, never>>>;\n}\n\n/** One channel's registry in `R`, without the `undefined` of an optional field; `never` when absent. */\ntype ChannelRegistry<R, K extends 'email' | 'push' | 'discord' | 'slack'> = K extends keyof R\n  ? Exclude<R[K], undefined>\n  : never;\n\n/** One reference per registered key, each typed by its own template's `props`. */\nexport type TemplateRefTable<C extends Channel, R> = {\n  readonly [K in keyof R & string]: TemplateRef<C, PropsOf<R[K]>>;\n};\n\n/** `t.email.<key>` / `t.push.<key>`; a channel the registry leaves out is an empty table. */\nexport interface TemplateRefs<R extends TemplateRegistry> {\n  readonly email: [ChannelRegistry<R, 'email'>] extends [never]\n    ? EmptyProps\n    : TemplateRefTable<'email', ChannelRegistry<R, 'email'>>;\n  readonly push: [ChannelRegistry<R, 'push'>] extends [never]\n    ? EmptyProps\n    : TemplateRefTable<'push', ChannelRegistry<R, 'push'>>;\n  readonly discord: [ChannelRegistry<R, 'discord'>] extends [never]\n    ? EmptyProps\n    : TemplateRefTable<'discord', ChannelRegistry<R, 'discord'>>;\n  readonly slack: [ChannelRegistry<R, 'slack'>] extends [never]\n    ? EmptyProps\n    : TemplateRefTable<'slack', ChannelRegistry<R, 'slack'>>;\n}\n\n/**\n * Template references derived from the registries themselves: **the\n * registries type the keys** — an unregistered key fails to compile, and a\n * push template is not accepted where an email is — and each template's\n * `props` schema types its use sites. Templates are registered once; the\n * config takes the registries, the workflows take the references:\n *\n *   export const registry = { email, push };\n *   export const t = templates(registry);\n *   flow.email(t.email.welcome, { name: u.name });\n *\n * Each reference is a plain `{ channel, key }` built from the registry's own\n * keys; no template is rendered, and the registries are left untouched.\n */\nexport function templates<const R extends TemplateRegistry>(registry: R): TemplateRefs<R> {\n  return {\n    email: refTable('email', registry.email, isEmailTemplate),\n    push: refTable('push', registry.push, isPushTemplate),\n    discord: refTable('discord', registry.discord, isDiscordTemplate),\n    slack: refTable('slack', registry.slack, isSlackTemplate),\n  } as unknown as TemplateRefs<R>;\n}\n\nconst ARTICLE: Record<'email' | 'push' | 'discord' | 'slack', string> = {\n  email: 'an email',\n  push: 'a push',\n  discord: 'a Discord',\n  slack: 'a Slack',\n};\n\nfunction refTable(\n  channel: 'email' | 'push' | 'discord' | 'slack',\n  entries: Readonly<Record<string, unknown>> | undefined,\n  is: (value: unknown) => boolean\n): Readonly<Record<string, TemplateRef>> {\n  const table: Record<string, TemplateRef> = Object.create(null);\n  for (const [key, entry] of Object.entries(entries ?? {})) {\n    if (!is(entry)) {\n      throw new TypeError(\n        `templates(): '${key}' in the ${channel} registry is not ${ARTICLE[channel]} template`\n      );\n    }\n    table[key] = template[channel](key);\n  }\n  return Object.freeze(table);\n}\n"],"mappings":";;AAiDA,MAAM,gBACgB,aACY,SAAoC;CAAE;CAAS;AAAI;;;;;;;;;AAUrF,MAAa,WAA4B;CACvC,OAAO,aAAa,OAAO;CAC3B,KAAK,aAAa,KAAK;CACvB,MAAM,aAAa,MAAM;CACzB,OAAO,aAAa,QAAQ;CAC5B,OAAO,aAAa,OAAO;CAC3B,SAAS,aAAa,SAAS;CAC/B,QAAQ,aAAa,QAAQ;AAC/B;;;;;;;;;;;;;;;AAwEA,SAAgB,UAA4C,UAA8B;CACxF,OAAO;EACL,OAAO,SAAS,SAAS,SAAS,OAAO,eAAe;EACxD,MAAM,SAAS,QAAQ,SAAS,MAAM,cAAc;EACpD,SAAS,SAAS,WAAW,SAAS,SAAS,iBAAiB;EAChE,OAAO,SAAS,SAAS,SAAS,OAAO,eAAe;CAC1D;AACF;AAEA,MAAM,UAAkE;CACtE,OAAO;CACP,MAAM;CACN,SAAS;CACT,OAAO;AACT;AAEA,SAAS,SACP,SACA,SACA,IACuC;CACvC,MAAM,QAAqC,OAAO,OAAO,IAAI;CAC7D,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,WAAW,CAAC,CAAC,GAAG;EACxD,IAAI,CAAC,GAAG,KAAK,GACX,MAAM,IAAI,UACR,iBAAiB,IAAI,WAAW,QAAQ,mBAAmB,QAAQ,SAAS,UAC9E;EAEF,MAAM,OAAO,SAAS,QAAQ,CAAC,GAAG;CACpC;CACA,OAAO,OAAO,OAAO,KAAK;AAC5B"}
+{"version":3,"file":"template.mjs","names":[],"sources":["../../src/dsl/template.ts"],"sourcesContent":["/**\n * Templates in the DSL. The four channels with template definitions (email, push, discord,\n * slack) take the definition itself — `.email(welcome, props)` — so its Zod `props` schema types\n * the call (`PropsOf`) and its `id` lands in the IR. The channels rendered by app-supplied\n * senders (sms, in-app, survey) have no definition; they take a hand-typed reference by key.\n */\n\nimport type * as core from 'zod/v4/core';\nimport type { DiscordTemplate, EmailTemplate, PushTemplate, SlackTemplate } from '../templates';\n\nexport type Channel = 'email' | 'sms' | 'push' | 'in_app' | 'slack' | 'discord' | 'survey';\n\nexport type EmptyProps = Record<never, never>;\n\n/** A template by key, its props typed by hand: for the channels without template definitions. */\nexport interface TemplateRef<C extends Channel = Channel, P extends object = EmptyProps> {\n  readonly channel: C;\n  readonly key: string;\n  readonly __props?: P;\n}\n\nexport interface TemplateFactory {\n  sms<P extends object = EmptyProps>(key: string): TemplateRef<'sms', P>;\n  inApp<P extends object = EmptyProps>(key: string): TemplateRef<'in_app', P>;\n  survey<P extends object = EmptyProps>(key: string): TemplateRef<'survey', P>;\n}\n\nconst makeTemplate =\n  <C extends Channel>(channel: C) =>\n  <P extends object = EmptyProps>(key: string): TemplateRef<C, P> => ({ channel, key });\n\n/**\n * Template references for the channels an app-supplied sender renders:\n *\n *   const code = template.sms<{ code: string }>('login_code');\n */\nexport const template: TemplateFactory = {\n  sms: makeTemplate('sms'),\n  inApp: makeTemplate('in_app'),\n  survey: makeTemplate('survey'),\n};\n\n/** Template props: the input type of the template's Zod `props` schema — what the DSL passes. */\nexport type PropsOf<M> = M extends\n  | EmailTemplate<infer S>\n  | PushTemplate<infer S>\n  | DiscordTemplate<infer S, never>\n  | SlackTemplate<infer S, never>\n  ? core.input<S> extends object\n    ? core.input<S>\n    : EmptyProps\n  : never;\n"],"mappings":";AA2BA,MAAM,gBACgB,aACY,SAAoC;CAAE;CAAS;AAAI;;;;;;AAOrF,MAAa,WAA4B;CACvC,KAAK,aAAa,KAAK;CACvB,OAAO,aAAa,QAAQ;CAC5B,QAAQ,aAAa,QAAQ;AAC/B"}

package/dist/dsl/workflow.cjs

@@ -110,7 +110,7 @@ var WorkflowBuilderImpl = class extends require_dsl_flow.FlowBuilderImpl {
 *     id: 'onboarding',
 *     name: 'Onboarding',
 *     trigger: trigger.event(e.sign_up),
-*   }).email(t.email.welcome);
+*   }).email(email.welcome);
 */
 function workflow(definition) {
 	return new WorkflowBuilderImpl(definition, require_provenance.captureLoc(workflow));

package/dist/dsl/workflow.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.cjs","names":["FlowBuilderImpl","condIR","durationIR","WorkflowIRSchema","semanticHash","captureLoc"],"sources":["../../src/dsl/workflow.ts"],"sourcesContent":["import { semanticHash } from '../hash';\nimport {\n  type GoalIR,\n  IR_VERSION,\n  type MetaIR,\n  type NodeIR,\n  type SourceLocIR,\n  type WorkflowIR,\n  WorkflowIR as WorkflowIRSchema,\n} from '../ir';\nimport { captureLoc } from '../provenance';\nimport { type Duration, durationIR } from './base';\nimport { type Condition, condIR } from './condition';\nimport { type FlowBuilder, FlowBuilderImpl } from './flow';\nimport type { TriggerInternal, TriggerRef } from './trigger';\n\n/**\n * The workflow — a named flow chain plus its configuration (options =\n * configuration, the chain = steps), and the compiler back half: `toIR()`\n * deep-clones the collected nodes, assigns structural-path ids, computes the\n * contentHash (metadata stripped, see hash.ts) and self-checks the result\n * against the authoritative IR schema.\n */\n\n/** Full conversion-goal configuration (customer.io's Goal & Exit semantics). */\nexport interface GoalOptions {\n  condition: Condition;\n  /** Attribution window: how long after entry a match still counts as a conversion. Unbounded by default. */\n  within?: Duration;\n  /** Exit on conversion. Defaults to true — this is what absorbs all those True→Exit arms in a UI canvas. */\n  exitOnMatch?: boolean;\n}\n\nexport interface WorkflowDefinition {\n  /**\n   * Wire identity — engine instances, the entry ledger and stats keys are all\n   * built on it (`WorkflowIR.id`), so it is not something to rename for\n   * readability; `name` is.\n   */\n  id: string;\n\n  /** Trigger: a trigger.xxx() asset. TODO: multiple triggers, entry frequency / re-entry policy. */\n  trigger: TriggerRef;\n\n  /**\n   * Conversion goal: feeds reporting (conversion rate / attribution) and by\n   * default exits on match. Checked before each node runs. Pass a condition\n   * for the shorthand, or GoalOptions for the full form.\n   */\n  goal?: Condition | GoalOptions;\n\n  /** Plain exit condition: leaving without counting as a conversion (unsubscribed, no longer eligible). Coexists with goal. */\n  exitWhen?: Condition;\n\n  /*\n   * Everything below is human-facing metadata: it lands in IR's `meta` field\n   * and is **excluded from contentHash**. Editing it neither invalidates the\n   * version in-flight users are pinned to nor shows up as a change in plan.\n   */\n\n  /** Human label: what the studio shows instead of the id. */\n  name?: string;\n\n  /** One line on what this flow does (UI lists, plan output). */\n  description?: string;\n}\n\nexport interface WorkflowBuilder extends FlowBuilder {\n  toIR(): WorkflowIR;\n}\n\n/**\n * Assign node ids from the structural path (rules in ir.ts's header). Written\n * in place into the tree toIR deep-cloned, never into the builder's own nodes.\n */\nfunction assignIds(nodes: NodeIR[], prefix: string): void {\n  nodes.forEach((node, i) => {\n    const id = prefix === '' ? String(i) : `${prefix}.${i}`;\n    node.id = id;\n    switch (node.type) {\n      case 'branch':\n        node.cases.forEach((c, ci) => assignIds(c.flow, `${id}.c${ci}`));\n        if (node.otherwise) assignIds(node.otherwise, `${id}.o`);\n        break;\n      case 'cohort':\n        node.arms.forEach((arm) => assignIds(arm.flow, `${id}.${arm.name}`));\n        break;\n      case 'wait_until':\n        if (Array.isArray(node.onTimeout)) assignIds(node.onTimeout, `${id}.t`);\n        break;\n      default:\n        break;\n    }\n  });\n}\n\n/**\n * Ids are derived, never authored, so a duplicate is always a compiler bug —\n * and a silent one: assignIds writes in place, so the second write simply wins\n * and two nodes ship as one. What that costs is concrete, because an id is the\n * durable step name (`step.do('{id}:send')`), the message idempotency key\n * (`{instanceId}:{id}`) and the cohort bucket seed: the twins share a\n * checkpoint, and the second send is suppressed as a duplicate of the first.\n * Cheap to check once at the end of the compile, so it is checked.\n */\nfunction assertUniqueIds(nodes: readonly NodeIR[], seen = new Set<string>()): void {\n  for (const node of nodes) {\n    if (seen.has(node.id)) {\n      throw new Error(\n        `toIR(): node id '${node.id}' is used twice — ids are durable step names and message idempotency keys, so they must be unique`\n      );\n    }\n    seen.add(node.id);\n    switch (node.type) {\n      case 'branch':\n        for (const branchCase of node.cases) assertUniqueIds(branchCase.flow, seen);\n        if (node.otherwise) assertUniqueIds(node.otherwise, seen);\n        break;\n      case 'cohort':\n        for (const arm of node.arms) assertUniqueIds(arm.flow, seen);\n        break;\n      case 'wait_until':\n        if (Array.isArray(node.onTimeout)) assertUniqueIds(node.onTimeout, seen);\n        break;\n      default:\n        break;\n    }\n  }\n}\n\nclass WorkflowBuilderImpl extends FlowBuilderImpl implements WorkflowBuilder {\n  constructor(\n    private readonly options: WorkflowDefinition,\n    /** Callsite of the workflow() call (provenance; lands in meta.loc). */\n    private readonly loc: SourceLocIR | undefined\n  ) {\n    super();\n  }\n\n  private goalIR(): GoalIR | undefined {\n    const goal = this.options.goal;\n    if (goal === undefined) return undefined;\n    if ('__condition' in goal) {\n      return { condition: condIR(goal), exitOnMatch: true };\n    }\n    return {\n      condition: condIR(goal.condition),\n      ...(goal.within !== undefined ? { within: durationIR(goal.within) } : {}),\n      exitOnMatch: goal.exitOnMatch ?? true,\n    };\n  }\n\n  private metaIR(): MetaIR | undefined {\n    const { name, description } = this.options;\n    if (name === undefined && description === undefined && this.loc === undefined) {\n      return undefined;\n    }\n    return {\n      ...(name !== undefined ? { name } : {}),\n      ...(description !== undefined ? { description } : {}),\n      ...(this.loc !== undefined ? { loc: this.loc } : {}),\n    };\n  }\n\n  toIR(): WorkflowIR {\n    const flowNodes = structuredClone(this.nodes);\n    assignIds(flowNodes, '');\n    assertUniqueIds(flowNodes);\n    const goal = this.goalIR();\n    const meta = this.metaIR();\n    const body = {\n      irVersion: IR_VERSION,\n      id: this.options.id,\n      ...(meta !== undefined ? { meta } : {}),\n      trigger: (this.options.trigger as TriggerInternal).ir,\n      ...(goal !== undefined ? { goal } : {}),\n      ...(this.options.exitWhen !== undefined ? { exitWhen: condIR(this.options.exitWhen) } : {}),\n      flow: flowNodes,\n    };\n    // semanticHash strips meta / label / reason, so metadata edits leave contentHash alone\n    // Self-check: the compiler's output must pass IR's authoritative schema\n    return WorkflowIRSchema.parse({ ...body, contentHash: semanticHash(body) });\n  }\n}\n\n/**\n * Workflow definition: an id, configuration (trigger / goal / exitWhen),\n * optional labels, and chained steps.\n *\n *   export const onboarding = workflow({\n *     id: 'onboarding',\n *     name: 'Onboarding',\n *     trigger: trigger.event(e.sign_up),\n *   }).email(t.email.welcome);\n */\nexport function workflow(definition: WorkflowDefinition): WorkflowBuilder {\n  return new WorkflowBuilderImpl(definition, captureLoc(workflow));\n}\n"],"mappings":"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"}
+{"version":3,"file":"workflow.cjs","names":["FlowBuilderImpl","condIR","durationIR","WorkflowIRSchema","semanticHash","captureLoc"],"sources":["../../src/dsl/workflow.ts"],"sourcesContent":["import { semanticHash } from '../hash';\nimport {\n  type GoalIR,\n  IR_VERSION,\n  type MetaIR,\n  type NodeIR,\n  type SourceLocIR,\n  type WorkflowIR,\n  WorkflowIR as WorkflowIRSchema,\n} from '../ir';\nimport { captureLoc } from '../provenance';\nimport { type Duration, durationIR } from './base';\nimport { type Condition, condIR } from './condition';\nimport { type FlowBuilder, FlowBuilderImpl } from './flow';\nimport type { TriggerInternal, TriggerRef } from './trigger';\n\n/**\n * The workflow — a named flow chain plus its configuration (options =\n * configuration, the chain = steps), and the compiler back half: `toIR()`\n * deep-clones the collected nodes, assigns structural-path ids, computes the\n * contentHash (metadata stripped, see hash.ts) and self-checks the result\n * against the authoritative IR schema.\n */\n\n/** Full conversion-goal configuration (customer.io's Goal & Exit semantics). */\nexport interface GoalOptions {\n  condition: Condition;\n  /** Attribution window: how long after entry a match still counts as a conversion. Unbounded by default. */\n  within?: Duration;\n  /** Exit on conversion. Defaults to true — this is what absorbs all those True→Exit arms in a UI canvas. */\n  exitOnMatch?: boolean;\n}\n\nexport interface WorkflowDefinition {\n  /**\n   * Wire identity — engine instances, the entry ledger and stats keys are all\n   * built on it (`WorkflowIR.id`), so it is not something to rename for\n   * readability; `name` is.\n   */\n  id: string;\n\n  /** Trigger: a trigger.xxx() asset. TODO: multiple triggers, entry frequency / re-entry policy. */\n  trigger: TriggerRef;\n\n  /**\n   * Conversion goal: feeds reporting (conversion rate / attribution) and by\n   * default exits on match. Checked before each node runs. Pass a condition\n   * for the shorthand, or GoalOptions for the full form.\n   */\n  goal?: Condition | GoalOptions;\n\n  /** Plain exit condition: leaving without counting as a conversion (unsubscribed, no longer eligible). Coexists with goal. */\n  exitWhen?: Condition;\n\n  /*\n   * Everything below is human-facing metadata: it lands in IR's `meta` field\n   * and is **excluded from contentHash**. Editing it neither invalidates the\n   * version in-flight users are pinned to nor shows up as a change in plan.\n   */\n\n  /** Human label: what the studio shows instead of the id. */\n  name?: string;\n\n  /** One line on what this flow does (UI lists, plan output). */\n  description?: string;\n}\n\nexport interface WorkflowBuilder extends FlowBuilder {\n  toIR(): WorkflowIR;\n}\n\n/**\n * Assign node ids from the structural path (rules in ir.ts's header). Written\n * in place into the tree toIR deep-cloned, never into the builder's own nodes.\n */\nfunction assignIds(nodes: NodeIR[], prefix: string): void {\n  nodes.forEach((node, i) => {\n    const id = prefix === '' ? String(i) : `${prefix}.${i}`;\n    node.id = id;\n    switch (node.type) {\n      case 'branch':\n        node.cases.forEach((c, ci) => assignIds(c.flow, `${id}.c${ci}`));\n        if (node.otherwise) assignIds(node.otherwise, `${id}.o`);\n        break;\n      case 'cohort':\n        node.arms.forEach((arm) => assignIds(arm.flow, `${id}.${arm.name}`));\n        break;\n      case 'wait_until':\n        if (Array.isArray(node.onTimeout)) assignIds(node.onTimeout, `${id}.t`);\n        break;\n      default:\n        break;\n    }\n  });\n}\n\n/**\n * Ids are derived, never authored, so a duplicate is always a compiler bug —\n * and a silent one: assignIds writes in place, so the second write simply wins\n * and two nodes ship as one. What that costs is concrete, because an id is the\n * durable step name (`step.do('{id}:send')`), the message idempotency key\n * (`{instanceId}:{id}`) and the cohort bucket seed: the twins share a\n * checkpoint, and the second send is suppressed as a duplicate of the first.\n * Cheap to check once at the end of the compile, so it is checked.\n */\nfunction assertUniqueIds(nodes: readonly NodeIR[], seen = new Set<string>()): void {\n  for (const node of nodes) {\n    if (seen.has(node.id)) {\n      throw new Error(\n        `toIR(): node id '${node.id}' is used twice — ids are durable step names and message idempotency keys, so they must be unique`\n      );\n    }\n    seen.add(node.id);\n    switch (node.type) {\n      case 'branch':\n        for (const branchCase of node.cases) assertUniqueIds(branchCase.flow, seen);\n        if (node.otherwise) assertUniqueIds(node.otherwise, seen);\n        break;\n      case 'cohort':\n        for (const arm of node.arms) assertUniqueIds(arm.flow, seen);\n        break;\n      case 'wait_until':\n        if (Array.isArray(node.onTimeout)) assertUniqueIds(node.onTimeout, seen);\n        break;\n      default:\n        break;\n    }\n  }\n}\n\nclass WorkflowBuilderImpl extends FlowBuilderImpl implements WorkflowBuilder {\n  constructor(\n    private readonly options: WorkflowDefinition,\n    /** Callsite of the workflow() call (provenance; lands in meta.loc). */\n    private readonly loc: SourceLocIR | undefined\n  ) {\n    super();\n  }\n\n  private goalIR(): GoalIR | undefined {\n    const goal = this.options.goal;\n    if (goal === undefined) return undefined;\n    if ('__condition' in goal) {\n      return { condition: condIR(goal), exitOnMatch: true };\n    }\n    return {\n      condition: condIR(goal.condition),\n      ...(goal.within !== undefined ? { within: durationIR(goal.within) } : {}),\n      exitOnMatch: goal.exitOnMatch ?? true,\n    };\n  }\n\n  private metaIR(): MetaIR | undefined {\n    const { name, description } = this.options;\n    if (name === undefined && description === undefined && this.loc === undefined) {\n      return undefined;\n    }\n    return {\n      ...(name !== undefined ? { name } : {}),\n      ...(description !== undefined ? { description } : {}),\n      ...(this.loc !== undefined ? { loc: this.loc } : {}),\n    };\n  }\n\n  toIR(): WorkflowIR {\n    const flowNodes = structuredClone(this.nodes);\n    assignIds(flowNodes, '');\n    assertUniqueIds(flowNodes);\n    const goal = this.goalIR();\n    const meta = this.metaIR();\n    const body = {\n      irVersion: IR_VERSION,\n      id: this.options.id,\n      ...(meta !== undefined ? { meta } : {}),\n      trigger: (this.options.trigger as TriggerInternal).ir,\n      ...(goal !== undefined ? { goal } : {}),\n      ...(this.options.exitWhen !== undefined ? { exitWhen: condIR(this.options.exitWhen) } : {}),\n      flow: flowNodes,\n    };\n    // semanticHash strips meta / label / reason, so metadata edits leave contentHash alone\n    // Self-check: the compiler's output must pass IR's authoritative schema\n    return WorkflowIRSchema.parse({ ...body, contentHash: semanticHash(body) });\n  }\n}\n\n/**\n * Workflow definition: an id, configuration (trigger / goal / exitWhen),\n * optional labels, and chained steps.\n *\n *   export const onboarding = workflow({\n *     id: 'onboarding',\n *     name: 'Onboarding',\n *     trigger: trigger.event(e.sign_up),\n *   }).email(email.welcome);\n */\nexport function workflow(definition: WorkflowDefinition): WorkflowBuilder {\n  return new WorkflowBuilderImpl(definition, captureLoc(workflow));\n}\n"],"mappings":"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"}

package/dist/dsl/workflow.d.cts

@@ -52,7 +52,7 @@ export interface WorkflowBuilder extends FlowBuilder {
  *     id: 'onboarding',
  *     name: 'Onboarding',
  *     trigger: trigger.event(e.sign_up),
- *   }).email(t.email.welcome);
+ *   }).email(email.welcome);
  */
 export declare function workflow(definition: WorkflowDefinition): WorkflowBuilder;
 //#endregion

package/dist/dsl/workflow.d.mts

@@ -52,7 +52,7 @@ export interface WorkflowBuilder extends FlowBuilder {
  *     id: 'onboarding',
  *     name: 'Onboarding',
  *     trigger: trigger.event(e.sign_up),
- *   }).email(t.email.welcome);
+ *   }).email(email.welcome);
  */
 export declare function workflow(definition: WorkflowDefinition): WorkflowBuilder;
 //#endregion

package/dist/dsl/workflow.mjs

@@ -109,7 +109,7 @@ var WorkflowBuilderImpl = class extends FlowBuilderImpl {
 *     id: 'onboarding',
 *     name: 'Onboarding',
 *     trigger: trigger.event(e.sign_up),
-*   }).email(t.email.welcome);
+*   }).email(email.welcome);
 */
 function workflow(definition) {
 	return new WorkflowBuilderImpl(definition, captureLoc(workflow));

package/dist/dsl/workflow.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.mjs","names":["WorkflowIRSchema"],"sources":["../../src/dsl/workflow.ts"],"sourcesContent":["import { semanticHash } from '../hash';\nimport {\n  type GoalIR,\n  IR_VERSION,\n  type MetaIR,\n  type NodeIR,\n  type SourceLocIR,\n  type WorkflowIR,\n  WorkflowIR as WorkflowIRSchema,\n} from '../ir';\nimport { captureLoc } from '../provenance';\nimport { type Duration, durationIR } from './base';\nimport { type Condition, condIR } from './condition';\nimport { type FlowBuilder, FlowBuilderImpl } from './flow';\nimport type { TriggerInternal, TriggerRef } from './trigger';\n\n/**\n * The workflow — a named flow chain plus its configuration (options =\n * configuration, the chain = steps), and the compiler back half: `toIR()`\n * deep-clones the collected nodes, assigns structural-path ids, computes the\n * contentHash (metadata stripped, see hash.ts) and self-checks the result\n * against the authoritative IR schema.\n */\n\n/** Full conversion-goal configuration (customer.io's Goal & Exit semantics). */\nexport interface GoalOptions {\n  condition: Condition;\n  /** Attribution window: how long after entry a match still counts as a conversion. Unbounded by default. */\n  within?: Duration;\n  /** Exit on conversion. Defaults to true — this is what absorbs all those True→Exit arms in a UI canvas. */\n  exitOnMatch?: boolean;\n}\n\nexport interface WorkflowDefinition {\n  /**\n   * Wire identity — engine instances, the entry ledger and stats keys are all\n   * built on it (`WorkflowIR.id`), so it is not something to rename for\n   * readability; `name` is.\n   */\n  id: string;\n\n  /** Trigger: a trigger.xxx() asset. TODO: multiple triggers, entry frequency / re-entry policy. */\n  trigger: TriggerRef;\n\n  /**\n   * Conversion goal: feeds reporting (conversion rate / attribution) and by\n   * default exits on match. Checked before each node runs. Pass a condition\n   * for the shorthand, or GoalOptions for the full form.\n   */\n  goal?: Condition | GoalOptions;\n\n  /** Plain exit condition: leaving without counting as a conversion (unsubscribed, no longer eligible). Coexists with goal. */\n  exitWhen?: Condition;\n\n  /*\n   * Everything below is human-facing metadata: it lands in IR's `meta` field\n   * and is **excluded from contentHash**. Editing it neither invalidates the\n   * version in-flight users are pinned to nor shows up as a change in plan.\n   */\n\n  /** Human label: what the studio shows instead of the id. */\n  name?: string;\n\n  /** One line on what this flow does (UI lists, plan output). */\n  description?: string;\n}\n\nexport interface WorkflowBuilder extends FlowBuilder {\n  toIR(): WorkflowIR;\n}\n\n/**\n * Assign node ids from the structural path (rules in ir.ts's header). Written\n * in place into the tree toIR deep-cloned, never into the builder's own nodes.\n */\nfunction assignIds(nodes: NodeIR[], prefix: string): void {\n  nodes.forEach((node, i) => {\n    const id = prefix === '' ? String(i) : `${prefix}.${i}`;\n    node.id = id;\n    switch (node.type) {\n      case 'branch':\n        node.cases.forEach((c, ci) => assignIds(c.flow, `${id}.c${ci}`));\n        if (node.otherwise) assignIds(node.otherwise, `${id}.o`);\n        break;\n      case 'cohort':\n        node.arms.forEach((arm) => assignIds(arm.flow, `${id}.${arm.name}`));\n        break;\n      case 'wait_until':\n        if (Array.isArray(node.onTimeout)) assignIds(node.onTimeout, `${id}.t`);\n        break;\n      default:\n        break;\n    }\n  });\n}\n\n/**\n * Ids are derived, never authored, so a duplicate is always a compiler bug —\n * and a silent one: assignIds writes in place, so the second write simply wins\n * and two nodes ship as one. What that costs is concrete, because an id is the\n * durable step name (`step.do('{id}:send')`), the message idempotency key\n * (`{instanceId}:{id}`) and the cohort bucket seed: the twins share a\n * checkpoint, and the second send is suppressed as a duplicate of the first.\n * Cheap to check once at the end of the compile, so it is checked.\n */\nfunction assertUniqueIds(nodes: readonly NodeIR[], seen = new Set<string>()): void {\n  for (const node of nodes) {\n    if (seen.has(node.id)) {\n      throw new Error(\n        `toIR(): node id '${node.id}' is used twice — ids are durable step names and message idempotency keys, so they must be unique`\n      );\n    }\n    seen.add(node.id);\n    switch (node.type) {\n      case 'branch':\n        for (const branchCase of node.cases) assertUniqueIds(branchCase.flow, seen);\n        if (node.otherwise) assertUniqueIds(node.otherwise, seen);\n        break;\n      case 'cohort':\n        for (const arm of node.arms) assertUniqueIds(arm.flow, seen);\n        break;\n      case 'wait_until':\n        if (Array.isArray(node.onTimeout)) assertUniqueIds(node.onTimeout, seen);\n        break;\n      default:\n        break;\n    }\n  }\n}\n\nclass WorkflowBuilderImpl extends FlowBuilderImpl implements WorkflowBuilder {\n  constructor(\n    private readonly options: WorkflowDefinition,\n    /** Callsite of the workflow() call (provenance; lands in meta.loc). */\n    private readonly loc: SourceLocIR | undefined\n  ) {\n    super();\n  }\n\n  private goalIR(): GoalIR | undefined {\n    const goal = this.options.goal;\n    if (goal === undefined) return undefined;\n    if ('__condition' in goal) {\n      return { condition: condIR(goal), exitOnMatch: true };\n    }\n    return {\n      condition: condIR(goal.condition),\n      ...(goal.within !== undefined ? { within: durationIR(goal.within) } : {}),\n      exitOnMatch: goal.exitOnMatch ?? true,\n    };\n  }\n\n  private metaIR(): MetaIR | undefined {\n    const { name, description } = this.options;\n    if (name === undefined && description === undefined && this.loc === undefined) {\n      return undefined;\n    }\n    return {\n      ...(name !== undefined ? { name } : {}),\n      ...(description !== undefined ? { description } : {}),\n      ...(this.loc !== undefined ? { loc: this.loc } : {}),\n    };\n  }\n\n  toIR(): WorkflowIR {\n    const flowNodes = structuredClone(this.nodes);\n    assignIds(flowNodes, '');\n    assertUniqueIds(flowNodes);\n    const goal = this.goalIR();\n    const meta = this.metaIR();\n    const body = {\n      irVersion: IR_VERSION,\n      id: this.options.id,\n      ...(meta !== undefined ? { meta } : {}),\n      trigger: (this.options.trigger as TriggerInternal).ir,\n      ...(goal !== undefined ? { goal } : {}),\n      ...(this.options.exitWhen !== undefined ? { exitWhen: condIR(this.options.exitWhen) } : {}),\n      flow: flowNodes,\n    };\n    // semanticHash strips meta / label / reason, so metadata edits leave contentHash alone\n    // Self-check: the compiler's output must pass IR's authoritative schema\n    return WorkflowIRSchema.parse({ ...body, contentHash: semanticHash(body) });\n  }\n}\n\n/**\n * Workflow definition: an id, configuration (trigger / goal / exitWhen),\n * optional labels, and chained steps.\n *\n *   export const onboarding = workflow({\n *     id: 'onboarding',\n *     name: 'Onboarding',\n *     trigger: trigger.event(e.sign_up),\n *   }).email(t.email.welcome);\n */\nexport function workflow(definition: WorkflowDefinition): WorkflowBuilder {\n  return new WorkflowBuilderImpl(definition, captureLoc(workflow));\n}\n"],"mappings":"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"}
+{"version":3,"file":"workflow.mjs","names":["WorkflowIRSchema"],"sources":["../../src/dsl/workflow.ts"],"sourcesContent":["import { semanticHash } from '../hash';\nimport {\n  type GoalIR,\n  IR_VERSION,\n  type MetaIR,\n  type NodeIR,\n  type SourceLocIR,\n  type WorkflowIR,\n  WorkflowIR as WorkflowIRSchema,\n} from '../ir';\nimport { captureLoc } from '../provenance';\nimport { type Duration, durationIR } from './base';\nimport { type Condition, condIR } from './condition';\nimport { type FlowBuilder, FlowBuilderImpl } from './flow';\nimport type { TriggerInternal, TriggerRef } from './trigger';\n\n/**\n * The workflow — a named flow chain plus its configuration (options =\n * configuration, the chain = steps), and the compiler back half: `toIR()`\n * deep-clones the collected nodes, assigns structural-path ids, computes the\n * contentHash (metadata stripped, see hash.ts) and self-checks the result\n * against the authoritative IR schema.\n */\n\n/** Full conversion-goal configuration (customer.io's Goal & Exit semantics). */\nexport interface GoalOptions {\n  condition: Condition;\n  /** Attribution window: how long after entry a match still counts as a conversion. Unbounded by default. */\n  within?: Duration;\n  /** Exit on conversion. Defaults to true — this is what absorbs all those True→Exit arms in a UI canvas. */\n  exitOnMatch?: boolean;\n}\n\nexport interface WorkflowDefinition {\n  /**\n   * Wire identity — engine instances, the entry ledger and stats keys are all\n   * built on it (`WorkflowIR.id`), so it is not something to rename for\n   * readability; `name` is.\n   */\n  id: string;\n\n  /** Trigger: a trigger.xxx() asset. TODO: multiple triggers, entry frequency / re-entry policy. */\n  trigger: TriggerRef;\n\n  /**\n   * Conversion goal: feeds reporting (conversion rate / attribution) and by\n   * default exits on match. Checked before each node runs. Pass a condition\n   * for the shorthand, or GoalOptions for the full form.\n   */\n  goal?: Condition | GoalOptions;\n\n  /** Plain exit condition: leaving without counting as a conversion (unsubscribed, no longer eligible). Coexists with goal. */\n  exitWhen?: Condition;\n\n  /*\n   * Everything below is human-facing metadata: it lands in IR's `meta` field\n   * and is **excluded from contentHash**. Editing it neither invalidates the\n   * version in-flight users are pinned to nor shows up as a change in plan.\n   */\n\n  /** Human label: what the studio shows instead of the id. */\n  name?: string;\n\n  /** One line on what this flow does (UI lists, plan output). */\n  description?: string;\n}\n\nexport interface WorkflowBuilder extends FlowBuilder {\n  toIR(): WorkflowIR;\n}\n\n/**\n * Assign node ids from the structural path (rules in ir.ts's header). Written\n * in place into the tree toIR deep-cloned, never into the builder's own nodes.\n */\nfunction assignIds(nodes: NodeIR[], prefix: string): void {\n  nodes.forEach((node, i) => {\n    const id = prefix === '' ? String(i) : `${prefix}.${i}`;\n    node.id = id;\n    switch (node.type) {\n      case 'branch':\n        node.cases.forEach((c, ci) => assignIds(c.flow, `${id}.c${ci}`));\n        if (node.otherwise) assignIds(node.otherwise, `${id}.o`);\n        break;\n      case 'cohort':\n        node.arms.forEach((arm) => assignIds(arm.flow, `${id}.${arm.name}`));\n        break;\n      case 'wait_until':\n        if (Array.isArray(node.onTimeout)) assignIds(node.onTimeout, `${id}.t`);\n        break;\n      default:\n        break;\n    }\n  });\n}\n\n/**\n * Ids are derived, never authored, so a duplicate is always a compiler bug —\n * and a silent one: assignIds writes in place, so the second write simply wins\n * and two nodes ship as one. What that costs is concrete, because an id is the\n * durable step name (`step.do('{id}:send')`), the message idempotency key\n * (`{instanceId}:{id}`) and the cohort bucket seed: the twins share a\n * checkpoint, and the second send is suppressed as a duplicate of the first.\n * Cheap to check once at the end of the compile, so it is checked.\n */\nfunction assertUniqueIds(nodes: readonly NodeIR[], seen = new Set<string>()): void {\n  for (const node of nodes) {\n    if (seen.has(node.id)) {\n      throw new Error(\n        `toIR(): node id '${node.id}' is used twice — ids are durable step names and message idempotency keys, so they must be unique`\n      );\n    }\n    seen.add(node.id);\n    switch (node.type) {\n      case 'branch':\n        for (const branchCase of node.cases) assertUniqueIds(branchCase.flow, seen);\n        if (node.otherwise) assertUniqueIds(node.otherwise, seen);\n        break;\n      case 'cohort':\n        for (const arm of node.arms) assertUniqueIds(arm.flow, seen);\n        break;\n      case 'wait_until':\n        if (Array.isArray(node.onTimeout)) assertUniqueIds(node.onTimeout, seen);\n        break;\n      default:\n        break;\n    }\n  }\n}\n\nclass WorkflowBuilderImpl extends FlowBuilderImpl implements WorkflowBuilder {\n  constructor(\n    private readonly options: WorkflowDefinition,\n    /** Callsite of the workflow() call (provenance; lands in meta.loc). */\n    private readonly loc: SourceLocIR | undefined\n  ) {\n    super();\n  }\n\n  private goalIR(): GoalIR | undefined {\n    const goal = this.options.goal;\n    if (goal === undefined) return undefined;\n    if ('__condition' in goal) {\n      return { condition: condIR(goal), exitOnMatch: true };\n    }\n    return {\n      condition: condIR(goal.condition),\n      ...(goal.within !== undefined ? { within: durationIR(goal.within) } : {}),\n      exitOnMatch: goal.exitOnMatch ?? true,\n    };\n  }\n\n  private metaIR(): MetaIR | undefined {\n    const { name, description } = this.options;\n    if (name === undefined && description === undefined && this.loc === undefined) {\n      return undefined;\n    }\n    return {\n      ...(name !== undefined ? { name } : {}),\n      ...(description !== undefined ? { description } : {}),\n      ...(this.loc !== undefined ? { loc: this.loc } : {}),\n    };\n  }\n\n  toIR(): WorkflowIR {\n    const flowNodes = structuredClone(this.nodes);\n    assignIds(flowNodes, '');\n    assertUniqueIds(flowNodes);\n    const goal = this.goalIR();\n    const meta = this.metaIR();\n    const body = {\n      irVersion: IR_VERSION,\n      id: this.options.id,\n      ...(meta !== undefined ? { meta } : {}),\n      trigger: (this.options.trigger as TriggerInternal).ir,\n      ...(goal !== undefined ? { goal } : {}),\n      ...(this.options.exitWhen !== undefined ? { exitWhen: condIR(this.options.exitWhen) } : {}),\n      flow: flowNodes,\n    };\n    // semanticHash strips meta / label / reason, so metadata edits leave contentHash alone\n    // Self-check: the compiler's output must pass IR's authoritative schema\n    return WorkflowIRSchema.parse({ ...body, contentHash: semanticHash(body) });\n  }\n}\n\n/**\n * Workflow definition: an id, configuration (trigger / goal / exitWhen),\n * optional labels, and chained steps.\n *\n *   export const onboarding = workflow({\n *     id: 'onboarding',\n *     name: 'Onboarding',\n *     trigger: trigger.event(e.sign_up),\n *   }).email(email.welcome);\n */\nexport function workflow(definition: WorkflowDefinition): WorkflowBuilder {\n  return new WorkflowBuilderImpl(definition, captureLoc(workflow));\n}\n"],"mappings":"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"}

package/dist/email-context.cjs

@@ -0,0 +1,29 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let react = require("react");
+//#region src/email-context.ts
+/**
+* `@shware/workflow/email-context` — the email being rendered, for its components: the resolved
+* metadata (`resolveEmail`) of the template, so a shared layout renders the unsubscribe link the
+* template resolves to instead of a URL of its own. The renderer (`@shware/workflow/react-email`)
+* and the studio's preview both provide it; the props stay the template's own.
+*
+*   const { unsubscribeUrl } = useEmailContext();
+*   {unsubscribeUrl !== undefined && <Link href={unsubscribeUrl}>Unsubscribe</Link>}
+*
+* Browser-safe: React only — no react-dom/server, no Worker bindings.
+*/
+const EmailContext = (0, react.createContext)(void 0);
+function EmailProvider({ email, children }) {
+	return (0, react.createElement)(EmailContext.Provider, { value: email }, children);
+}
+/** The email being rendered; throws outside a render the SDK or the studio provides. */
+function useEmailContext() {
+	const email = (0, react.useContext)(EmailContext);
+	if (email === void 0) throw new Error("useEmailContext() is called outside an email render: render the template with @shware/workflow/react-email's registryRenderer, or wrap it in <EmailProvider email={resolveEmail(template, config.email)}>");
+	return email;
+}
+//#endregion
+exports.EmailProvider = EmailProvider;
+exports.useEmailContext = useEmailContext;
+
+//# sourceMappingURL=email-context.cjs.map

package/dist/email-context.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-context.cjs","names":["createContext","createElement","useContext"],"sources":["../src/email-context.ts"],"sourcesContent":["import { type ReactNode, createContext, createElement, useContext } from 'react';\nimport type { ResolvedEmail } from './email';\n\n/**\n * `@shware/workflow/email-context` — the email being rendered, for its components: the resolved\n * metadata (`resolveEmail`) of the template, so a shared layout renders the unsubscribe link the\n * template resolves to instead of a URL of its own. The renderer (`@shware/workflow/react-email`)\n * and the studio's preview both provide it; the props stay the template's own.\n *\n *   const { unsubscribeUrl } = useEmailContext();\n *   {unsubscribeUrl !== undefined && <Link href={unsubscribeUrl}>Unsubscribe</Link>}\n *\n * Browser-safe: React only — no react-dom/server, no Worker bindings.\n */\n\nconst EmailContext = createContext<ResolvedEmail | undefined>(undefined);\n\nexport function EmailProvider({\n  email,\n  children,\n}: {\n  email: ResolvedEmail;\n  children?: ReactNode;\n}): ReactNode {\n  return createElement(EmailContext.Provider, { value: email }, children);\n}\n\n/** The email being rendered; throws outside a render the SDK or the studio provides. */\nexport function useEmailContext(): ResolvedEmail {\n  const email = useContext(EmailContext);\n  if (email === undefined) {\n    throw new Error(\n      'useEmailContext() is called outside an email render: render the template with ' +\n        \"@shware/workflow/react-email's registryRenderer, or wrap it in <EmailProvider email={resolveEmail(template, config.email)}>\"\n    );\n  }\n  return email;\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,MAAM,gBAAA,GAAeA,MAAAA,cAAAA,CAAyC,KAAA,CAAS;AAEvE,SAAgB,cAAc,EAC5B,OACA,YAIY;CACZ,QAAA,GAAOC,MAAAA,cAAAA,CAAc,aAAa,UAAU,EAAE,OAAO,MAAM,GAAG,QAAQ;AACxE;;AAGA,SAAgB,kBAAiC;CAC/C,MAAM,SAAA,GAAQC,MAAAA,WAAAA,CAAW,YAAY;CACrC,IAAI,UAAU,KAAA,GACZ,MAAM,IAAI,MACR,2MAEF;CAEF,OAAO;AACT"}

package/dist/email-context.d.cts

@@ -0,0 +1,11 @@
+import { ResolvedEmail } from "./email.cjs";
+import { ReactNode } from "react";
+//#region src/email-context.d.ts
+export declare function EmailProvider({ email, children }: {
+  email: ResolvedEmail;
+  children?: ReactNode;
+}): ReactNode;
+/** The email being rendered; throws outside a render the SDK or the studio provides. */
+export declare function useEmailContext(): ResolvedEmail;
+//#endregion
+//# sourceMappingURL=email-context.d.cts.map

package/dist/email-context.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-context.d.cts","names":[],"sources":["../src/email-context.ts"],"mappings":";;;wBAiBgB,gBACd,OACA;EAEA,OAAO;EACP,WAAW;IACT;;wBAKY,mBAAmB"}

package/dist/email-context.d.mts

@@ -0,0 +1,11 @@
+import { ResolvedEmail } from "./email.mjs";
+import { ReactNode } from "react";
+//#region src/email-context.d.ts
+export declare function EmailProvider({ email, children }: {
+  email: ResolvedEmail;
+  children?: ReactNode;
+}): ReactNode;
+/** The email being rendered; throws outside a render the SDK or the studio provides. */
+export declare function useEmailContext(): ResolvedEmail;
+//#endregion
+//# sourceMappingURL=email-context.d.mts.map

package/dist/email-context.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-context.d.mts","names":[],"sources":["../src/email-context.ts"],"mappings":";;;wBAiBgB,gBACd,OACA;EAEA,OAAO;EACP,WAAW;IACT;;wBAKY,mBAAmB"}

package/dist/email-context.mjs

@@ -0,0 +1,27 @@
+import { createContext, createElement, useContext } from "react";
+//#region src/email-context.ts
+/**
+* `@shware/workflow/email-context` — the email being rendered, for its components: the resolved
+* metadata (`resolveEmail`) of the template, so a shared layout renders the unsubscribe link the
+* template resolves to instead of a URL of its own. The renderer (`@shware/workflow/react-email`)
+* and the studio's preview both provide it; the props stay the template's own.
+*
+*   const { unsubscribeUrl } = useEmailContext();
+*   {unsubscribeUrl !== undefined && <Link href={unsubscribeUrl}>Unsubscribe</Link>}
+*
+* Browser-safe: React only — no react-dom/server, no Worker bindings.
+*/
+const EmailContext = createContext(void 0);
+function EmailProvider({ email, children }) {
+	return createElement(EmailContext.Provider, { value: email }, children);
+}
+/** The email being rendered; throws outside a render the SDK or the studio provides. */
+function useEmailContext() {
+	const email = useContext(EmailContext);
+	if (email === void 0) throw new Error("useEmailContext() is called outside an email render: render the template with @shware/workflow/react-email's registryRenderer, or wrap it in <EmailProvider email={resolveEmail(template, config.email)}>");
+	return email;
+}
+//#endregion
+export { EmailProvider, useEmailContext };
+
+//# sourceMappingURL=email-context.mjs.map

package/dist/email-context.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-context.mjs","names":[],"sources":["../src/email-context.ts"],"sourcesContent":["import { type ReactNode, createContext, createElement, useContext } from 'react';\nimport type { ResolvedEmail } from './email';\n\n/**\n * `@shware/workflow/email-context` — the email being rendered, for its components: the resolved\n * metadata (`resolveEmail`) of the template, so a shared layout renders the unsubscribe link the\n * template resolves to instead of a URL of its own. The renderer (`@shware/workflow/react-email`)\n * and the studio's preview both provide it; the props stay the template's own.\n *\n *   const { unsubscribeUrl } = useEmailContext();\n *   {unsubscribeUrl !== undefined && <Link href={unsubscribeUrl}>Unsubscribe</Link>}\n *\n * Browser-safe: React only — no react-dom/server, no Worker bindings.\n */\n\nconst EmailContext = createContext<ResolvedEmail | undefined>(undefined);\n\nexport function EmailProvider({\n  email,\n  children,\n}: {\n  email: ResolvedEmail;\n  children?: ReactNode;\n}): ReactNode {\n  return createElement(EmailContext.Provider, { value: email }, children);\n}\n\n/** The email being rendered; throws outside a render the SDK or the studio provides. */\nexport function useEmailContext(): ResolvedEmail {\n  const email = useContext(EmailContext);\n  if (email === undefined) {\n    throw new Error(\n      'useEmailContext() is called outside an email render: render the template with ' +\n        \"@shware/workflow/react-email's registryRenderer, or wrap it in <EmailProvider email={resolveEmail(template, config.email)}>\"\n    );\n  }\n  return email;\n}\n"],"mappings":";;;;;;;;;;;;;AAeA,MAAM,eAAe,cAAyC,KAAA,CAAS;AAEvE,SAAgB,cAAc,EAC5B,OACA,YAIY;CACZ,OAAO,cAAc,aAAa,UAAU,EAAE,OAAO,MAAM,GAAG,QAAQ;AACxE;;AAGA,SAAgB,kBAAiC;CAC/C,MAAM,QAAQ,WAAW,YAAY;CACrC,IAAI,UAAU,KAAA,GACZ,MAAM,IAAI,MACR,2MAEF;CAEF,OAAO;AACT"}

package/dist/email.cjs

@@ -0,0 +1,72 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/email.ts
+/** `Name <email>`, or the bare address. */
+function formatEmailAddress(address) {
+	if (typeof address === "string") return address;
+	return address.name === void 0 ? address.email : `${address.name} <${address.email}>`;
+}
+/** The template's metadata, its `unsubscribeUrl` falling back to the config's. Leaves both untouched. */
+function resolveEmail(template, config) {
+	const unsubscribeUrl = template.unsubscribeUrl ?? config?.unsubscribeUrl;
+	return {
+		from: template.from,
+		...template.replyTo === void 0 ? {} : { replyTo: template.replyTo },
+		...unsubscribeUrl === void 0 ? {} : { unsubscribeUrl }
+	};
+}
+const ADDRESS = /^[^\s@<>]+@[^\s@<>]+$/;
+/** Throws naming `where` when `address` is neither `user@host` nor `{ email: 'user@host', name? }`. */
+function assertEmailAddress(address, where) {
+	const email = typeof address === "object" && address !== null ? address.email : address;
+	const name = typeof address === "object" && address !== null ? address.name : void 0;
+	if (typeof email !== "string" || !ADDRESS.test(email)) throw new TypeError(`${where} must be an email address or { email, name? }`);
+	if (name !== void 0 && typeof name !== "string") throw new TypeError(`${where}.name must be a string`);
+}
+/** Throws naming `where` unless `url` is an absolute http(s) URL; '' and null are not a way to leave it out. */
+function assertUnsubscribeUrl(url, where) {
+	let parsed;
+	try {
+		parsed = typeof url === "string" ? new URL(url) : void 0;
+	} catch {
+		parsed = void 0;
+	}
+	if (parsed === void 0 || parsed.protocol !== "https:" && parsed.protocol !== "http:") throw new TypeError(`${where} must be an http(s) URL (leave it out for none)`);
+}
+/** The config's `email` and every registered template's metadata; throws on the first invalid value. */
+function assertEmailConfig(config, templates) {
+	if (Object.hasOwn(config, "emails")) throw new TypeError("the config's `emails` is gone: `from` and `replyTo` are declared on each emailTemplate, and the rest moved to `email: { unsubscribeUrl, tracking }`");
+	const email = config.email;
+	if (email !== void 0) {
+		if (email.unsubscribeUrl !== void 0) assertUnsubscribeUrl(email.unsubscribeUrl, "email.unsubscribeUrl");
+		const quick = email.tracking?.quickClickMs;
+		if (quick !== void 0 && !(typeof quick === "number" && Number.isFinite(quick) && quick >= 0)) throw new TypeError("email.tracking.quickClickMs must be a non-negative number");
+	}
+	for (const template of templates) assertEmailMetadata(template, `email template '${template.id}'`);
+}
+/** A template's own `from` / `replyTo` / `unsubscribeUrl`, as `emailTemplate` checks them. */
+function assertEmailMetadata(template, where) {
+	assertEmailAddress(template.from, `${where}: from`);
+	if (template.replyTo !== void 0) assertEmailAddress(template.replyTo, `${where}: replyTo`);
+	if (template.unsubscribeUrl !== void 0) assertUnsubscribeUrl(template.unsubscribeUrl, `${where}: unsubscribeUrl`);
+}
+/** The unsubscribe link may carry its own query (a token, a list): the path names it. */
+function isUnsubscribeLink(url, unsubscribeUrl) {
+	if (unsubscribeUrl === void 0) return false;
+	try {
+		const a = new URL(url);
+		const b = new URL(unsubscribeUrl);
+		return a.origin === b.origin && a.pathname === b.pathname;
+	} catch {
+		return false;
+	}
+}
+//#endregion
+exports.assertEmailAddress = assertEmailAddress;
+exports.assertEmailConfig = assertEmailConfig;
+exports.assertEmailMetadata = assertEmailMetadata;
+exports.assertUnsubscribeUrl = assertUnsubscribeUrl;
+exports.formatEmailAddress = formatEmailAddress;
+exports.isUnsubscribeLink = isUnsubscribeLink;
+exports.resolveEmail = resolveEmail;
+
+//# sourceMappingURL=email.cjs.map

package/dist/email.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.cjs","names":[],"sources":["../src/email.ts"],"sourcesContent":["import type { EmailTemplate } from './templates';\n\n/**\n * Email metadata: who a template's email comes from, where replies go, and the unsubscribe link\n * its layout carries. Each `emailTemplate` declares its own `from` (and `replyTo`, if replies should\n * go elsewhere); the unsubscribe link is the template's `unsubscribeUrl`, else the config's\n * `email.unsubscribeUrl`, else none. `resolveEmail` is that rule, and the sender, the renderer,\n * the Worker's preview and the studio all go through it. No React and no I/O here, so a browser\n * can import it.\n */\n\n/** An address as the transports take it: bare, or with a display name. */\nexport type EmailAddress = string | { email: string; name?: string };\n\n/** `Name <email>`, or the bare address. */\nexport function formatEmailAddress(address: EmailAddress): string {\n  if (typeof address === 'string') return address;\n  return address.name === undefined ? address.email : `${address.name} <${address.email}>`;\n}\n\n/** The config's `email`: what every email template shares. */\nexport interface EmailConfig {\n  /**\n   * The unsubscribe link of every email template that names none of its own. The layout reads it\n   * with `useEmailContext()`; sent, it is tracked like every link, but following it shows a\n   * confirmation page, and only the confirmation (a POST no link scanner sends) unsubscribes.\n   */\n  unsubscribeUrl?: string;\n  /** How the Worker tells a person's opens and clicks from a machine's (see the reporting classifier). */\n  tracking?: {\n    /**\n     * An open or click this many milliseconds after delivery is a weak machine signal — machine\n     * only together with another (a second link within seconds); 1000 by default. A person\n     * tapping a mail notification can click within a few seconds, so keep it short.\n     */\n    quickClickMs?: number;\n  };\n}\n\n/** One template's email metadata, resolved against the config. */\nexport interface ResolvedEmail {\n  from: EmailAddress;\n  /** Absent when the template names none: the email goes out without a Reply-To. */\n  replyTo?: EmailAddress;\n  /** Absent when neither the template nor the config names one: the email has no unsubscribe link. */\n  unsubscribeUrl?: string;\n}\n\n/** The template's metadata, its `unsubscribeUrl` falling back to the config's. Leaves both untouched. */\nexport function resolveEmail(\n  template: Pick<EmailTemplate, 'from' | 'replyTo' | 'unsubscribeUrl'>,\n  config?: EmailConfig\n): ResolvedEmail {\n  const unsubscribeUrl = template.unsubscribeUrl ?? config?.unsubscribeUrl;\n  return {\n    from: template.from,\n    ...(template.replyTo === undefined ? {} : { replyTo: template.replyTo }),\n    ...(unsubscribeUrl === undefined ? {} : { unsubscribeUrl }),\n  };\n}\n\nconst ADDRESS = /^[^\\s@<>]+@[^\\s@<>]+$/;\n\n/** Throws naming `where` when `address` is neither `user@host` nor `{ email: 'user@host', name? }`. */\nexport function assertEmailAddress(address: unknown, where: string): void {\n  const email =\n    typeof address === 'object' && address !== null\n      ? (address as { email?: unknown }).email\n      : address;\n  const name =\n    typeof address === 'object' && address !== null\n      ? (address as { name?: unknown }).name\n      : undefined;\n  if (typeof email !== 'string' || !ADDRESS.test(email)) {\n    throw new TypeError(`${where} must be an email address or { email, name? }`);\n  }\n  if (name !== undefined && typeof name !== 'string') {\n    throw new TypeError(`${where}.name must be a string`);\n  }\n}\n\n/** Throws naming `where` unless `url` is an absolute http(s) URL; '' and null are not a way to leave it out. */\nexport function assertUnsubscribeUrl(url: unknown, where: string): void {\n  let parsed: URL | undefined;\n  try {\n    parsed = typeof url === 'string' ? new URL(url) : undefined;\n  } catch {\n    parsed = undefined;\n  }\n  if (parsed === undefined || (parsed.protocol !== 'https:' && parsed.protocol !== 'http:')) {\n    throw new TypeError(`${where} must be an http(s) URL (leave it out for none)`);\n  }\n}\n\n/** The config's `email` and every registered template's metadata; throws on the first invalid value. */\nexport function assertEmailConfig(\n  config: { email?: EmailConfig },\n  templates: Iterable<EmailTemplate>\n): void {\n  if (Object.hasOwn(config, 'emails')) {\n    throw new TypeError(\n      \"the config's `emails` is gone: `from` and `replyTo` are declared on each emailTemplate, \" +\n        'and the rest moved to `email: { unsubscribeUrl, tracking }`'\n    );\n  }\n  const email = config.email;\n  if (email !== undefined) {\n    if (email.unsubscribeUrl !== undefined) {\n      assertUnsubscribeUrl(email.unsubscribeUrl, 'email.unsubscribeUrl');\n    }\n    const quick = email.tracking?.quickClickMs;\n    if (\n      quick !== undefined &&\n      !(typeof quick === 'number' && Number.isFinite(quick) && quick >= 0)\n    ) {\n      throw new TypeError('email.tracking.quickClickMs must be a non-negative number');\n    }\n  }\n  for (const template of templates)\n    assertEmailMetadata(template, `email template '${template.id}'`);\n}\n\n/** A template's own `from` / `replyTo` / `unsubscribeUrl`, as `emailTemplate` checks them. */\nexport function assertEmailMetadata(\n  template: { from?: unknown; replyTo?: unknown; unsubscribeUrl?: unknown },\n  where: string\n): void {\n  assertEmailAddress(template.from, `${where}: from`);\n  if (template.replyTo !== undefined) assertEmailAddress(template.replyTo, `${where}: replyTo`);\n  if (template.unsubscribeUrl !== undefined) {\n    assertUnsubscribeUrl(template.unsubscribeUrl, `${where}: unsubscribeUrl`);\n  }\n}\n\n/** The unsubscribe link may carry its own query (a token, a list): the path names it. */\nexport function isUnsubscribeLink(url: string, unsubscribeUrl: string | undefined): boolean {\n  if (unsubscribeUrl === undefined) return false;\n  try {\n    const a = new URL(url);\n    const b = new URL(unsubscribeUrl);\n    return a.origin === b.origin && a.pathname === b.pathname;\n  } catch {\n    return false;\n  }\n}\n"],"mappings":";;;AAeA,SAAgB,mBAAmB,SAA+B;CAChE,IAAI,OAAO,YAAY,UAAU,OAAO;CACxC,OAAO,QAAQ,SAAS,KAAA,IAAY,QAAQ,QAAQ,GAAG,QAAQ,KAAK,IAAI,QAAQ,MAAM;AACxF;;AA+BA,SAAgB,aACd,UACA,QACe;CACf,MAAM,iBAAiB,SAAS,kBAAkB,QAAQ;CAC1D,OAAO;EACL,MAAM,SAAS;EACf,GAAI,SAAS,YAAY,KAAA,IAAY,CAAC,IAAI,EAAE,SAAS,SAAS,QAAQ;EACtE,GAAI,mBAAmB,KAAA,IAAY,CAAC,IAAI,EAAE,eAAe;CAC3D;AACF;AAEA,MAAM,UAAU;;AAGhB,SAAgB,mBAAmB,SAAkB,OAAqB;CACxE,MAAM,QACJ,OAAO,YAAY,YAAY,YAAY,OACtC,QAAgC,QACjC;CACN,MAAM,OACJ,OAAO,YAAY,YAAY,YAAY,OACtC,QAA+B,OAChC,KAAA;CACN,IAAI,OAAO,UAAU,YAAY,CAAC,QAAQ,KAAK,KAAK,GAClD,MAAM,IAAI,UAAU,GAAG,MAAM,8CAA8C;CAE7E,IAAI,SAAS,KAAA,KAAa,OAAO,SAAS,UACxC,MAAM,IAAI,UAAU,GAAG,MAAM,uBAAuB;AAExD;;AAGA,SAAgB,qBAAqB,KAAc,OAAqB;CACtE,IAAI;CACJ,IAAI;EACF,SAAS,OAAO,QAAQ,WAAW,IAAI,IAAI,GAAG,IAAI,KAAA;CACpD,QAAQ;EACN,SAAS,KAAA;CACX;CACA,IAAI,WAAW,KAAA,KAAc,OAAO,aAAa,YAAY,OAAO,aAAa,SAC/E,MAAM,IAAI,UAAU,GAAG,MAAM,gDAAgD;AAEjF;;AAGA,SAAgB,kBACd,QACA,WACM;CACN,IAAI,OAAO,OAAO,QAAQ,QAAQ,GAChC,MAAM,IAAI,UACR,qJAEF;CAEF,MAAM,QAAQ,OAAO;CACrB,IAAI,UAAU,KAAA,GAAW;EACvB,IAAI,MAAM,mBAAmB,KAAA,GAC3B,qBAAqB,MAAM,gBAAgB,sBAAsB;EAEnE,MAAM,QAAQ,MAAM,UAAU;EAC9B,IACE,UAAU,KAAA,KACV,EAAE,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,KAAK,SAAS,IAElE,MAAM,IAAI,UAAU,2DAA2D;CAEnF;CACA,KAAK,MAAM,YAAY,WACrB,oBAAoB,UAAU,mBAAmB,SAAS,GAAG,EAAE;AACnE;;AAGA,SAAgB,oBACd,UACA,OACM;CACN,mBAAmB,SAAS,MAAM,GAAG,MAAM,OAAO;CAClD,IAAI,SAAS,YAAY,KAAA,GAAW,mBAAmB,SAAS,SAAS,GAAG,MAAM,UAAU;CAC5F,IAAI,SAAS,mBAAmB,KAAA,GAC9B,qBAAqB,SAAS,gBAAgB,GAAG,MAAM,iBAAiB;AAE5E;;AAGA,SAAgB,kBAAkB,KAAa,gBAA6C;CAC1F,IAAI,mBAAmB,KAAA,GAAW,OAAO;CACzC,IAAI;EACF,MAAM,IAAI,IAAI,IAAI,GAAG;EACrB,MAAM,IAAI,IAAI,IAAI,cAAc;EAChC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE;CACnD,QAAQ;EACN,OAAO;CACT;AACF"}

package/dist/email.d.cts

@@ -0,0 +1,63 @@
+import { EmailTemplate } from "./templates.cjs";
+//#region src/email.d.ts
+/**
+ * Email metadata: who a template's email comes from, where replies go, and the unsubscribe link
+ * its layout carries. Each `emailTemplate` declares its own `from` (and `replyTo`, if replies should
+ * go elsewhere); the unsubscribe link is the template's `unsubscribeUrl`, else the config's
+ * `email.unsubscribeUrl`, else none. `resolveEmail` is that rule, and the sender, the renderer,
+ * the Worker's preview and the studio all go through it. No React and no I/O here, so a browser
+ * can import it.
+ */
+/** An address as the transports take it: bare, or with a display name. */
+export type EmailAddress = string | {
+  email: string;
+  name?: string;
+};
+/** `Name <email>`, or the bare address. */
+export declare function formatEmailAddress(address: EmailAddress): string;
+/** The config's `email`: what every email template shares. */
+export interface EmailConfig {
+  /**
+   * The unsubscribe link of every email template that names none of its own. The layout reads it
+   * with `useEmailContext()`; sent, it is tracked like every link, but following it shows a
+   * confirmation page, and only the confirmation (a POST no link scanner sends) unsubscribes.
+   */
+  unsubscribeUrl?: string;
+  /** How the Worker tells a person's opens and clicks from a machine's (see the reporting classifier). */
+  tracking?: {
+    /**
+     * An open or click this many milliseconds after delivery is a weak machine signal — machine
+     * only together with another (a second link within seconds); 1000 by default. A person
+     * tapping a mail notification can click within a few seconds, so keep it short.
+     */
+    quickClickMs?: number;
+  };
+}
+/** One template's email metadata, resolved against the config. */
+export interface ResolvedEmail {
+  from: EmailAddress;
+  /** Absent when the template names none: the email goes out without a Reply-To. */
+  replyTo?: EmailAddress;
+  /** Absent when neither the template nor the config names one: the email has no unsubscribe link. */
+  unsubscribeUrl?: string;
+}
+/** The template's metadata, its `unsubscribeUrl` falling back to the config's. Leaves both untouched. */
+export declare function resolveEmail(template: Pick<EmailTemplate, 'from' | 'replyTo' | 'unsubscribeUrl'>, config?: EmailConfig): ResolvedEmail;
+/** Throws naming `where` when `address` is neither `user@host` nor `{ email: 'user@host', name? }`. */
+export declare function assertEmailAddress(address: unknown, where: string): void;
+/** Throws naming `where` unless `url` is an absolute http(s) URL; '' and null are not a way to leave it out. */
+export declare function assertUnsubscribeUrl(url: unknown, where: string): void;
+/** The config's `email` and every registered template's metadata; throws on the first invalid value. */
+export declare function assertEmailConfig(config: {
+  email?: EmailConfig;
+}, templates: Iterable<EmailTemplate>): void;
+/** A template's own `from` / `replyTo` / `unsubscribeUrl`, as `emailTemplate` checks them. */
+export declare function assertEmailMetadata(template: {
+  from?: unknown;
+  replyTo?: unknown;
+  unsubscribeUrl?: unknown;
+}, where: string): void;
+/** The unsubscribe link may carry its own query (a token, a list): the path names it. */
+export declare function isUnsubscribeLink(url: string, unsubscribeUrl: string | undefined): boolean;
+//#endregion
+//# sourceMappingURL=email.d.cts.map

package/dist/email.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.cts","names":[],"sources":["../src/email.ts"],"mappings":";;;;;;;;;;;YAYY;EAA0B;EAAe;;;wBAGrC,mBAAmB,SAAS;;iBAM3B;;;;;;EAMf;;EAEA;;;;;;IAME;;;;iBAKa;EACf,MAAM;;EAEN,UAAU;;EAEV;;;wBAIc,aACd,UAAU,KAAK,uDACf,SAAS,cACR;;wBAYa,mBAAmB,kBAAkB;;wBAkBrC,qBAAqB,cAAc;;wBAanC,kBACd;EAAU,QAAQ;GAClB,WAAW,SAAS;;wBA0BN,oBACd;EAAY;EAAgB;EAAmB;GAC/C;;wBAUc,kBAAkB,aAAa"}