@shware/workflow 0.0.0-stage → 0.0.0

package/dist/templates.cjs

@@ -0,0 +1,247 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
+let zod_mini = require("zod/mini");
+zod_mini = require_runtime.__toESM(zod_mini, 1);
+//#region src/templates.ts
+/** Declare a Discord webhook template. Throws when `props` is unsupported or `preview` does not parse. */
+function discordTemplate(definition) {
+	assertSupportedSchema(definition.props, definition.title);
+	parsePreview(definition.props, definition.preview, "discord", definition.title);
+	return {
+		kind: "discord-template",
+		version: 1,
+		...definition
+	};
+}
+/** Declare a Slack webhook template. Throws when `props` is unsupported or `preview` does not parse. */
+function slackTemplate(definition) {
+	assertSupportedSchema(definition.props, definition.title);
+	parsePreview(definition.props, definition.preview, "slack", definition.title);
+	return {
+		kind: "slack-template",
+		version: 1,
+		...definition
+	};
+}
+/** Declare an email template. Throws when `props` uses an unsupported schema or `preview` does not parse. */
+function emailTemplate(definition) {
+	assertSupportedSchema(definition.props, definition.title);
+	parsePreview(definition.props, definition.preview, "email", definition.title);
+	return {
+		kind: "email-template",
+		version: 1,
+		...definition
+	};
+}
+/** Declare a push template. Throws when `props` uses an unsupported schema or `preview` does not parse. */
+function pushTemplate(definition) {
+	assertSupportedSchema(definition.props, definition.title);
+	parsePreview(definition.props, definition.preview, "push", definition.title);
+	return {
+		kind: "push-template",
+		version: 1,
+		...definition
+	};
+}
+function isEmailTemplate(value) {
+	return isMarked(value, "email-template");
+}
+function isPushTemplate(value) {
+	return isMarked(value, "push-template");
+}
+function isDiscordTemplate(value) {
+	return isMarked(value, "discord-template");
+}
+function isSlackTemplate(value) {
+	return isMarked(value, "slack-template");
+}
+const CHANNEL_OF = {
+	"email-template": "email",
+	"push-template": "push",
+	"discord-template": "discord",
+	"slack-template": "slack"
+};
+function isMarked(value, kind) {
+	return typeof value === "object" && value !== null && value.kind === kind && value.version === 1;
+}
+/**
+* A template refused its input (`phase: 'props'` — the component/content was
+* never called) or its content function returned something that is not a
+* notification (`phase: 'content'` — called, but nothing is sent). Never a
+* provider failure: a sender must not read it as a dead device token.
+*/
+var TemplateValidationError = class extends Error {
+	channel;
+	template;
+	phase;
+	issues;
+	name = "TemplateValidationError";
+	constructor(channel, template, phase, issues) {
+		super(`${channel} template '${template}' ${phase === "props" ? "rejected its props" : "returned invalid content"}: ${issues.map((i) => `${i.path || "(root)"} ${i.message}`).join("; ")}`);
+		this.channel = channel;
+		this.template = template;
+		this.phase = phase;
+		this.issues = issues;
+	}
+};
+function issuesOf(error) {
+	return error.issues.map((issue) => ({
+		path: issue.path.map(String).join("."),
+		message: issue.message
+	}));
+}
+/**
+* Parse message props against a template's schema and return the parsed value
+* — the only value anything downstream may use. Throws TemplateValidationError.
+*/
+function parseTemplateProps(template, key, props) {
+	const channel = CHANNEL_OF[template.kind];
+	const result = zod_mini.safeParse(template.props, props);
+	if (!result.success) throw new TemplateValidationError(channel, key, "props", issuesOf(result.error));
+	return result.data;
+}
+const pushContentSchema = zod_mini.strictObject({
+	title: zod_mini.string(),
+	body: zod_mini.string(),
+	image: zod_mini.optional(zod_mini.string()),
+	url: zod_mini.optional(zod_mini.string())
+});
+/** Run a push template's content over parsed props and check the notification it returns. */
+function renderPushContent(template, key, props) {
+	const parsed = parseTemplateProps(template, key, props);
+	const output = template.content(parsed);
+	const result = zod_mini.safeParse(pushContentSchema, output);
+	if (!result.success) throw new TemplateValidationError("push", key, "content", issuesOf(result.error));
+	return result.data;
+}
+/**
+* What a Discord webhook accepts at all: something to show (content, an embed, a poll or
+* components) and content within Discord's 2000 characters. The rest of the body is Discord's to
+* judge; its types come from `discord-api-types`.
+*/
+const discordContentSchema = zod_mini.looseObject({
+	content: zod_mini.optional(zod_mini.string().check(zod_mini.maxLength(2e3))),
+	embeds: zod_mini.optional(zod_mini.array(zod_mini.looseObject({})))
+});
+const slackContentSchema = zod_mini.looseObject({
+	text: zod_mini.string().check(zod_mini.minLength(1)),
+	blocks: zod_mini.optional(zod_mini.array(zod_mini.looseObject({ type: zod_mini.string() })))
+});
+/** Run a Discord template's content over parsed props and check the message it returns. */
+function renderDiscordContent(template, key, props) {
+	const output = template.content(parseTemplateProps(template, key, props));
+	const result = zod_mini.safeParse(discordContentSchema, output);
+	const empty = result.success && !result.data.content && (result.data.embeds?.length ?? 0) === 0 && output.poll === void 0 && (output.components?.length ?? 0) === 0;
+	if (!result.success || empty) throw new TemplateValidationError("discord", key, "content", result.success ? [{
+		path: "",
+		message: "a Discord message needs content, an embed, a poll or components"
+	}] : issuesOf(result.error));
+	return output;
+}
+/** Run a Slack template's content over parsed props and check the message it returns. */
+function renderSlackContent(template, key, props) {
+	const output = template.content(parseTemplateProps(template, key, props));
+	const result = zod_mini.safeParse(slackContentSchema, output);
+	if (!result.success) throw new TemplateValidationError("slack", key, "content", issuesOf(result.error));
+	return output;
+}
+function parsePreview(schema, preview, channel, title) {
+	const result = zod_mini.safeParse(schema, preview);
+	if (!result.success) throw new TemplateValidationError(channel, title, "props", issuesOf(result.error).map((i) => Object.assign(i, { message: `preview: ${i.message}` })));
+}
+const SCALAR_TYPES = /* @__PURE__ */ new Set([
+	"string",
+	"number",
+	"boolean",
+	"enum"
+]);
+/** Throws when `schema` is outside the v1 subset (see the header). */
+function assertSupportedSchema(schema, where) {
+	const fail = (reason) => {
+		throw new TypeError(`template '${where}': unsupported props schema — ${reason}`);
+	};
+	const def = schema?._zod?.def;
+	if (def?.type !== "object") fail("props must be a z.strictObject({...})");
+	const object = def;
+	if (object.catchall?._zod.def.type !== "never") fail("props must be strict (z.strictObject): unknown fields would be dropped or passed through");
+	rejectCustomChecks(object, where, fail);
+	for (const [field, value] of Object.entries(object.shape)) {
+		let fieldDef = value._zod.def;
+		if (fieldDef.type === "optional") {
+			rejectCustomChecks(fieldDef, `${where}.${field}`, fail);
+			fieldDef = fieldDef.innerType._zod.def;
+		}
+		if (fieldDef.type === "literal") {
+			if (!fieldDef.values.every((v) => [
+				"string",
+				"number",
+				"boolean"
+			].includes(typeof v))) fail(`field '${field}' is a literal of a non-scalar value`);
+		} else if (!SCALAR_TYPES.has(fieldDef.type)) fail(`field '${field}' is ${fieldDef.type}; only string, number, boolean, enum and literal fields (optionally .optional()) are supported`);
+		if (fieldDef.coerce === true) fail(`field '${field}' coerces its input (z.coerce), which would change what the props mean`);
+		rejectCustomChecks(fieldDef, `${where}.${field}`, fail);
+	}
+}
+/**
+* Checks the subset refuses: `custom` runs arbitrary code (`.refine()`), and
+* `overwrite` changes the value (`.overwrite()`, `.trim()`, `.toLowerCase()`…)
+* — the props are parsed more than once on the way to a send (the validator,
+* then the renderer), so a value-changing check would apply twice and the
+* email would differ from the preview.
+*/
+function rejectCustomChecks(def, where, fail) {
+	for (const check of def.checks ?? []) {
+		if (check._zod.def.check === "custom") fail(`'${where}' uses a custom refinement, which the template subset does not support`);
+		if (check._zod.def.check === "overwrite") fail(`'${where}' changes the value (.overwrite, .trim, .toLowerCase, …), which the template subset does not support`);
+	}
+}
+/**
+* The engine's MessageValidator over the template registries: the message's
+* props are parsed by its template (the parsed value is what gets sent); a
+* push's content is also run once and checked, so an invalid notification
+* stops the send before any device; Discord and Slack content likewise. Channels without a
+* registry here (sms, …) pass through to their app-supplied senders.
+*/
+function registryValidator(registries) {
+	return { validate({ channel, template, props }) {
+		if (channel === "email") return parseTemplateProps(lookup(registries.email, "email", template), template, props);
+		if (channel === "push") {
+			const entry = lookup(registries.push, "push", template);
+			renderPushContent(entry, template, props);
+			return parseTemplateProps(entry, template, props);
+		}
+		if (channel === "discord") {
+			const entry = lookup(registries.discord, "discord", template);
+			renderDiscordContent(entry, template, props);
+			return parseTemplateProps(entry, template, props);
+		}
+		if (channel === "slack") {
+			const entry = lookup(registries.slack, "slack", template);
+			renderSlackContent(entry, template, props);
+			return parseTemplateProps(entry, template, props);
+		}
+		return props;
+	} };
+}
+function lookup(registry, channel, key) {
+	if (registry === void 0 || !Object.hasOwn(registry, key)) throw new Error(`${channel} template '${key}' is not registered`);
+	return registry[key];
+}
+//#endregion
+exports.TemplateValidationError = TemplateValidationError;
+exports.assertSupportedSchema = assertSupportedSchema;
+exports.discordTemplate = discordTemplate;
+exports.emailTemplate = emailTemplate;
+exports.isDiscordTemplate = isDiscordTemplate;
+exports.isEmailTemplate = isEmailTemplate;
+exports.isPushTemplate = isPushTemplate;
+exports.isSlackTemplate = isSlackTemplate;
+exports.parseTemplateProps = parseTemplateProps;
+exports.pushTemplate = pushTemplate;
+exports.registryValidator = registryValidator;
+exports.renderDiscordContent = renderDiscordContent;
+exports.renderPushContent = renderPushContent;
+exports.renderSlackContent = renderSlackContent;
+exports.slackTemplate = slackTemplate;
+
+//# sourceMappingURL=templates.cjs.map

package/dist/templates.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.cjs","names":["z"],"sources":["../src/templates.ts"],"sourcesContent":["import type { Block, KnownBlock } from '@slack/types';\nimport type { RESTPostAPIWebhookWithTokenJSONBody } from 'discord-api-types/v10';\nimport * as z from 'zod/mini';\nimport type * as core from 'zod/v4/core';\nimport type { ScalarIR } from './ir';\n\n/**\n * Template definitions — `emailTemplate`, `pushTemplate`, `discordTemplate` and `slackTemplate`. One\n * object per template, and its Zod `props` schema is the only source of the\n * props type: the DSL's `.email()/.push()` arguments, the `preview`, and the\n * `component`/`content` parameter are all derived from it, and every render\n * parses the props against it first (types alone check nothing at run time).\n *\n * Kept free of React and of any renderer: the definitions are plain data plus\n * a function, so the DSL, the Worker and the studio can all import them; the\n * React rendering lives in `@shware/workflow/react-email`.\n *\n * Supported schemas (v1): a strict object (`z.strictObject`) whose fields are\n * string / number / boolean — optionally as enums or literals, optionally\n * `.optional()`, with the built-in checks (min, email, …). That is exactly\n * what IR message props can carry, and it keeps input and output identical, so\n * producer, studio and sender never disagree about a transformed value.\n * Anything else (nested objects, arrays, null, default/transform/coerce,\n * custom refinements) is rejected when the template is declared.\n */\n\n/** A strict Zod object schema of scalar fields — the accepted shape of `props`. */\nexport type PropsSchema = core.$ZodObject;\n\n/** What a push template's `content` returns: the notification itself. */\nexport interface PushContent {\n  title: string;\n  body: string;\n  /** Rich image URL (iOS attachment / Android BigPicture). */\n  image?: string;\n  /** Where a tap leads: the page a browser push opens (the site's root when absent). */\n  url?: string;\n}\n\n/** A Discord webhook message (`discord-api-types`): content, embeds, username, allowed mentions… */\nexport type DiscordContent = RESTPostAPIWebhookWithTokenJSONBody;\n\n/** A Slack incoming-webhook message: the fallback `text` and, usually, Block Kit `blocks`. */\nexport interface SlackContent {\n  /** Shown in notifications and wherever blocks cannot be; required even with blocks. */\n  text: string;\n  blocks?: (KnownBlock | Block)[];\n  username?: string;\n  icon_emoji?: string;\n  icon_url?: string;\n  mrkdwn?: boolean;\n  unfurl_links?: boolean;\n  unfurl_media?: boolean;\n}\n\n/** The channels a template can be declared for. */\nexport type TemplateChannel = 'email' | 'push' | 'discord' | 'slack';\n\ninterface TemplateBase<S extends PropsSchema> {\n  /** Display name in the studio (not the email subject, not the notification title). */\n  readonly title: string;\n  readonly description?: string | undefined;\n  readonly props: S;\n  /** Sample props for the studio; parsed against `props` when the template is declared. */\n  readonly preview: core.input<S>;\n}\n\nexport interface EmailTemplate<S extends PropsSchema = PropsSchema> extends TemplateBase<S> {\n  readonly kind: 'email-template';\n  readonly version: 1;\n  readonly subject: string;\n  /** The email body: a component over the parsed props (rendered by `@shware/workflow/react-email`). */\n  readonly component: (props: Readonly<core.output<S>>) => unknown;\n}\n\nexport interface PushTemplate<S extends PropsSchema = PropsSchema> extends TemplateBase<S> {\n  readonly kind: 'push-template';\n  readonly version: 1;\n  /** The notification, from the parsed props. Synchronous and pure; its result is checked before sending. */\n  readonly content: (props: Readonly<core.output<S>>) => PushContent;\n}\n\n/**\n * A message posted to a team channel through an incoming webhook (Discord, Slack). The webhook\n * URL is a secret, so it lives in the Worker's environment and the template reads it from there\n * at send time: `webhook: (env: Env) => env.WEBHOOK_DISCORD_ALERTS`, with `Env` the host's\n * zod-validated environment (`journeyWorker({ env: schema })`). The studio never calls it.\n */\ninterface WebhookTemplateBase<S extends PropsSchema, Env> extends TemplateBase<S> {\n  readonly version: 1;\n  // A method, so a template typed by the host's Env still fits a registry of any Env\n  webhook(env: Env): string | undefined;\n}\n\nexport interface DiscordTemplate<\n  S extends PropsSchema = PropsSchema,\n  Env = Record<string, unknown>,\n> extends WebhookTemplateBase<S, Env> {\n  readonly kind: 'discord-template';\n  /** The message, from the parsed props. Synchronous and pure; checked before sending. */\n  readonly content: (props: Readonly<core.output<S>>) => DiscordContent;\n}\n\nexport interface SlackTemplate<\n  S extends PropsSchema = PropsSchema,\n  Env = Record<string, unknown>,\n> extends WebhookTemplateBase<S, Env> {\n  readonly kind: 'slack-template';\n  /** The message, from the parsed props. Synchronous and pure; checked before sending. */\n  readonly content: (props: Readonly<core.output<S>>) => SlackContent;\n}\n\n/** Strips a Promise return out of the accepted callback types: async content is rejected at the type level. */\ntype Sync<T> = T extends Promise<unknown> ? never : T;\n\nexport interface EmailTemplateDefinition<S extends PropsSchema> {\n  title: string;\n  description?: string;\n  props: S;\n  subject: string;\n  preview: NoInfer<core.input<S>>;\n  component: (props: NoInfer<Readonly<core.output<S>>>) => unknown;\n}\n\nexport interface PushTemplateDefinition<S extends PropsSchema, R> {\n  title: string;\n  description?: string;\n  props: S;\n  preview: NoInfer<core.input<S>>;\n  content: (props: NoInfer<Readonly<core.output<S>>>) => Sync<R> & PushContent;\n}\n\nexport interface WebhookTemplateDefinition<S extends PropsSchema, Env, C> {\n  title: string;\n  description?: string;\n  props: S;\n  preview: NoInfer<core.input<S>>;\n  /** The webhook URL, read from the Worker's environment when a message is sent. */\n  webhook: (env: Env) => string | undefined;\n  content: (props: NoInfer<Readonly<core.output<S>>>) => Sync<C>;\n}\n\n/** Declare a Discord webhook template. Throws when `props` is unsupported or `preview` does not parse. */\nexport function discordTemplate<S extends PropsSchema, Env = Record<string, unknown>>(\n  definition: WebhookTemplateDefinition<S, Env, DiscordContent>\n): DiscordTemplate<S, Env> {\n  assertSupportedSchema(definition.props, definition.title);\n  parsePreview(definition.props, definition.preview, 'discord', definition.title);\n  return { kind: 'discord-template', version: 1, ...definition };\n}\n\n/** Declare a Slack webhook template. Throws when `props` is unsupported or `preview` does not parse. */\nexport function slackTemplate<S extends PropsSchema, Env = Record<string, unknown>>(\n  definition: WebhookTemplateDefinition<S, Env, SlackContent>\n): SlackTemplate<S, Env> {\n  assertSupportedSchema(definition.props, definition.title);\n  parsePreview(definition.props, definition.preview, 'slack', definition.title);\n  return { kind: 'slack-template', version: 1, ...definition };\n}\n\n/** Declare an email template. Throws when `props` uses an unsupported schema or `preview` does not parse. */\nexport function emailTemplate<S extends PropsSchema>(\n  definition: EmailTemplateDefinition<S>\n): EmailTemplate<S> {\n  assertSupportedSchema(definition.props, definition.title);\n  parsePreview(definition.props, definition.preview, 'email', definition.title);\n  return { kind: 'email-template', version: 1, ...definition };\n}\n\n/** Declare a push template. Throws when `props` uses an unsupported schema or `preview` does not parse. */\nexport function pushTemplate<S extends PropsSchema, R extends PushContent>(\n  definition: PushTemplateDefinition<S, R>\n): PushTemplate<S> {\n  assertSupportedSchema(definition.props, definition.title);\n  parsePreview(definition.props, definition.preview, 'push', definition.title);\n  return { kind: 'push-template', version: 1, ...definition } as unknown as PushTemplate<S>;\n}\n\nexport function isEmailTemplate(value: unknown): value is EmailTemplate {\n  return isMarked(value, 'email-template');\n}\n\nexport function isPushTemplate(value: unknown): value is PushTemplate {\n  return isMarked(value, 'push-template');\n}\n\nexport function isDiscordTemplate(value: unknown): value is DiscordTemplate {\n  return isMarked(value, 'discord-template');\n}\n\nexport function isSlackTemplate(value: unknown): value is SlackTemplate {\n  return isMarked(value, 'slack-template');\n}\n\n/** Any declared template. */\nexport type AnyTemplate = EmailTemplate | PushTemplate | DiscordTemplate | SlackTemplate;\n\nconst CHANNEL_OF: Record<AnyTemplate['kind'], TemplateChannel> = {\n  'email-template': 'email',\n  'push-template': 'push',\n  'discord-template': 'discord',\n  'slack-template': 'slack',\n};\n\nfunction isMarked(value: unknown, kind: string): boolean {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    (value as { kind?: unknown }).kind === kind &&\n    (value as { version?: unknown }).version === 1\n  );\n}\n\n/* ------------------------------- validation -------------------------------- */\n\n/** One failed field, with the dotted path the studio and the logs show. */\nexport interface TemplateIssue {\n  path: string;\n  message: string;\n}\n\n/**\n * A template refused its input (`phase: 'props'` — the component/content was\n * never called) or its content function returned something that is not a\n * notification (`phase: 'content'` — called, but nothing is sent). Never a\n * provider failure: a sender must not read it as a dead device token.\n */\nexport class TemplateValidationError extends Error {\n  override readonly name = 'TemplateValidationError';\n  constructor(\n    readonly channel: TemplateChannel,\n    readonly template: string,\n    readonly phase: 'props' | 'content',\n    readonly issues: TemplateIssue[]\n  ) {\n    super(\n      `${channel} template '${template}' ${phase === 'props' ? 'rejected its props' : 'returned invalid content'}: ${issues\n        .map((i) => `${i.path || '(root)'} ${i.message}`)\n        .join('; ')}`\n    );\n  }\n}\n\nfunction issuesOf(error: core.$ZodError): TemplateIssue[] {\n  return error.issues.map((issue) => ({\n    path: issue.path.map(String).join('.'),\n    message: issue.message,\n  }));\n}\n\n/**\n * Parse message props against a template's schema and return the parsed value\n * — the only value anything downstream may use. Throws TemplateValidationError.\n */\nexport function parseTemplateProps<S extends PropsSchema>(\n  template: EmailTemplate<S> | PushTemplate<S> | DiscordTemplate<S> | SlackTemplate<S>,\n  key: string,\n  props: Record<string, unknown>\n): core.output<S> {\n  const channel = CHANNEL_OF[template.kind];\n  const result = z.safeParse(template.props, props);\n  if (!result.success) {\n    throw new TemplateValidationError(channel, key, 'props', issuesOf(result.error));\n  }\n  return result.data;\n}\n\nconst pushContentSchema = z.strictObject({\n  title: z.string(),\n  body: z.string(),\n  image: z.optional(z.string()),\n  url: z.optional(z.string()),\n});\n\n/** Run a push template's content over parsed props and check the notification it returns. */\nexport function renderPushContent(\n  template: PushTemplate,\n  key: string,\n  props: Record<string, unknown>\n): PushContent {\n  const parsed = parseTemplateProps(template, key, props);\n  const output: unknown = template.content(parsed);\n  // A Promise (async content smuggled past the types) is an object without title/body: refused here\n  const result = z.safeParse(pushContentSchema, output);\n  if (!result.success) {\n    throw new TemplateValidationError('push', key, 'content', issuesOf(result.error));\n  }\n  return result.data;\n}\n\n/**\n * What a Discord webhook accepts at all: something to show (content, an embed, a poll or\n * components) and content within Discord's 2000 characters. The rest of the body is Discord's to\n * judge; its types come from `discord-api-types`.\n */\nconst discordContentSchema = z.looseObject({\n  content: z.optional(z.string().check(z.maxLength(2000))),\n  embeds: z.optional(z.array(z.looseObject({}))),\n});\n\nconst slackContentSchema = z.looseObject({\n  text: z.string().check(z.minLength(1)),\n  blocks: z.optional(z.array(z.looseObject({ type: z.string() }))),\n});\n\n/** Run a Discord template's content over parsed props and check the message it returns. */\nexport function renderDiscordContent(\n  template: DiscordTemplate,\n  key: string,\n  props: Record<string, unknown>\n): DiscordContent {\n  const output: unknown = template.content(parseTemplateProps(template, key, props));\n  const result = z.safeParse(discordContentSchema, output);\n  const empty =\n    result.success &&\n    !result.data.content &&\n    (result.data.embeds?.length ?? 0) === 0 &&\n    (output as { poll?: unknown; components?: unknown[] }).poll === undefined &&\n    ((output as { components?: unknown[] }).components?.length ?? 0) === 0;\n  if (!result.success || empty) {\n    const issues = result.success\n      ? [{ path: '', message: 'a Discord message needs content, an embed, a poll or components' }]\n      : issuesOf(result.error);\n    throw new TemplateValidationError('discord', key, 'content', issues);\n  }\n  return output as DiscordContent;\n}\n\n/** Run a Slack template's content over parsed props and check the message it returns. */\nexport function renderSlackContent(\n  template: SlackTemplate,\n  key: string,\n  props: Record<string, unknown>\n): SlackContent {\n  const output: unknown = template.content(parseTemplateProps(template, key, props));\n  const result = z.safeParse(slackContentSchema, output);\n  if (!result.success) {\n    throw new TemplateValidationError('slack', key, 'content', issuesOf(result.error));\n  }\n  return output as SlackContent;\n}\n\nfunction parsePreview(\n  schema: PropsSchema,\n  preview: unknown,\n  channel: TemplateChannel,\n  title: string\n) {\n  const result = z.safeParse(schema, preview);\n  if (!result.success) {\n    throw new TemplateValidationError(\n      channel,\n      title,\n      'props',\n      issuesOf(result.error).map((i) => Object.assign(i, { message: `preview: ${i.message}` }))\n    );\n  }\n}\n\n/* ---------------------------- supported schemas ---------------------------- */\n\nconst SCALAR_TYPES = new Set(['string', 'number', 'boolean', 'enum']);\n\n/** Throws when `schema` is outside the v1 subset (see the header). */\nexport function assertSupportedSchema(schema: unknown, where: string): void {\n  const fail = (reason: string): never => {\n    throw new TypeError(`template '${where}': unsupported props schema — ${reason}`);\n  };\n  const def = (schema as core.$ZodType | undefined)?._zod?.def;\n  if (def?.type !== 'object') fail('props must be a z.strictObject({...})');\n  const object = def as core.$ZodObjectDef;\n  if (object.catchall?._zod.def.type !== 'never') {\n    fail(\n      'props must be strict (z.strictObject): unknown fields would be dropped or passed through'\n    );\n  }\n  rejectCustomChecks(object, where, fail);\n  for (const [field, value] of Object.entries(object.shape)) {\n    let fieldDef = value._zod.def;\n    if (fieldDef.type === 'optional') {\n      // The wrapper carries checks of its own (`.optional().overwrite(...)`): refuse them too\n      rejectCustomChecks(fieldDef, `${where}.${field}`, fail);\n      fieldDef = (fieldDef as core.$ZodOptionalDef).innerType._zod.def;\n    }\n    if (fieldDef.type === 'literal') {\n      const values = (fieldDef as core.$ZodLiteralDef<core.util.Literal>).values;\n      if (!values.every((v) => ['string', 'number', 'boolean'].includes(typeof v))) {\n        fail(`field '${field}' is a literal of a non-scalar value`);\n      }\n    } else if (!SCALAR_TYPES.has(fieldDef.type)) {\n      fail(\n        `field '${field}' is ${fieldDef.type}; only string, number, boolean, enum and literal fields (optionally .optional()) are supported`\n      );\n    }\n    if ((fieldDef as { coerce?: boolean }).coerce === true) {\n      fail(`field '${field}' coerces its input (z.coerce), which would change what the props mean`);\n    }\n    rejectCustomChecks(fieldDef, `${where}.${field}`, fail);\n  }\n}\n\n/**\n * Checks the subset refuses: `custom` runs arbitrary code (`.refine()`), and\n * `overwrite` changes the value (`.overwrite()`, `.trim()`, `.toLowerCase()`…)\n * — the props are parsed more than once on the way to a send (the validator,\n * then the renderer), so a value-changing check would apply twice and the\n * email would differ from the preview.\n */\nfunction rejectCustomChecks(def: core.$ZodTypeDef, where: string, fail: (reason: string) => never) {\n  for (const check of def.checks ?? []) {\n    if (check._zod.def.check === 'custom') {\n      fail(`'${where}' uses a custom refinement, which the template subset does not support`);\n    }\n    if (check._zod.def.check === 'overwrite') {\n      fail(\n        `'${where}' changes the value (.overwrite, .trim, .toLowerCase, …), which the template subset does not support`\n      );\n    }\n  }\n}\n\n/** The scalar props a template accepts, as the IR resolves them before parsing. */\nexport type ResolvedProps = Record<string, ScalarIR | undefined>;\n\n/**\n * The engine's MessageValidator over the template registries: the message's\n * props are parsed by its template (the parsed value is what gets sent); a\n * push's content is also run once and checked, so an invalid notification\n * stops the send before any device; Discord and Slack content likewise. Channels without a\n * registry here (sms, …) pass through to their app-supplied senders.\n */\nexport function registryValidator(registries: {\n  email?: Record<string, EmailTemplate> | undefined;\n  push?: Record<string, PushTemplate> | undefined;\n  discord?: Readonly<Record<string, DiscordTemplate<PropsSchema, never>>> | undefined;\n  slack?: Readonly<Record<string, SlackTemplate<PropsSchema, never>>> | undefined;\n}): {\n  validate(message: { channel: string; template: string; props: ResolvedProps }): ResolvedProps;\n} {\n  return {\n    validate({ channel, template, props }) {\n      if (channel === 'email') {\n        return parseTemplateProps(\n          lookup(registries.email, 'email', template),\n          template,\n          props\n        ) as ResolvedProps;\n      }\n      if (channel === 'push') {\n        const entry = lookup(registries.push, 'push', template);\n        renderPushContent(entry, template, props);\n        return parseTemplateProps(entry, template, props) as ResolvedProps;\n      }\n      if (channel === 'discord') {\n        const entry = lookup(registries.discord, 'discord', template) as DiscordTemplate;\n        renderDiscordContent(entry, template, props);\n        return parseTemplateProps(entry, template, props) as ResolvedProps;\n      }\n      if (channel === 'slack') {\n        const entry = lookup(registries.slack, 'slack', template) as SlackTemplate;\n        renderSlackContent(entry, template, props);\n        return parseTemplateProps(entry, template, props) as ResolvedProps;\n      }\n      return props;\n    },\n  };\n}\n\nfunction lookup<T>(registry: Record<string, T> | undefined, channel: string, key: string): T {\n  if (registry === undefined || !Object.hasOwn(registry, key)) {\n    throw new Error(`${channel} template '${key}' is not registered`);\n  }\n  return registry[key];\n}\n"],"mappings":"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"}

package/dist/templates.d.cts

@@ -0,0 +1,187 @@
+import { ScalarIR } from "./ir.cjs";
+import { Block, KnownBlock } from "@slack/types";
+import { RESTPostAPIWebhookWithTokenJSONBody } from "discord-api-types/v10";
+import * as core from "zod/v4/core";
+//#region src/templates.d.ts
+/**
+ * Template definitions — `emailTemplate`, `pushTemplate`, `discordTemplate` and `slackTemplate`. One
+ * object per template, and its Zod `props` schema is the only source of the
+ * props type: the DSL's `.email()/.push()` arguments, the `preview`, and the
+ * `component`/`content` parameter are all derived from it, and every render
+ * parses the props against it first (types alone check nothing at run time).
+ *
+ * Kept free of React and of any renderer: the definitions are plain data plus
+ * a function, so the DSL, the Worker and the studio can all import them; the
+ * React rendering lives in `@shware/workflow/react-email`.
+ *
+ * Supported schemas (v1): a strict object (`z.strictObject`) whose fields are
+ * string / number / boolean — optionally as enums or literals, optionally
+ * `.optional()`, with the built-in checks (min, email, …). That is exactly
+ * what IR message props can carry, and it keeps input and output identical, so
+ * producer, studio and sender never disagree about a transformed value.
+ * Anything else (nested objects, arrays, null, default/transform/coerce,
+ * custom refinements) is rejected when the template is declared.
+ */
+/** A strict Zod object schema of scalar fields — the accepted shape of `props`. */
+export type PropsSchema = core.$ZodObject;
+/** What a push template's `content` returns: the notification itself. */
+export interface PushContent {
+  title: string;
+  body: string;
+  /** Rich image URL (iOS attachment / Android BigPicture). */
+  image?: string;
+  /** Where a tap leads: the page a browser push opens (the site's root when absent). */
+  url?: string;
+}
+/** A Discord webhook message (`discord-api-types`): content, embeds, username, allowed mentions… */
+export type DiscordContent = RESTPostAPIWebhookWithTokenJSONBody;
+/** A Slack incoming-webhook message: the fallback `text` and, usually, Block Kit `blocks`. */
+export interface SlackContent {
+  /** Shown in notifications and wherever blocks cannot be; required even with blocks. */
+  text: string;
+  blocks?: (KnownBlock | Block)[];
+  username?: string;
+  icon_emoji?: string;
+  icon_url?: string;
+  mrkdwn?: boolean;
+  unfurl_links?: boolean;
+  unfurl_media?: boolean;
+}
+/** The channels a template can be declared for. */
+export type TemplateChannel = 'email' | 'push' | 'discord' | 'slack';
+interface TemplateBase<S extends PropsSchema> {
+  /** Display name in the studio (not the email subject, not the notification title). */
+  readonly title: string;
+  readonly description?: string | undefined;
+  readonly props: S;
+  /** Sample props for the studio; parsed against `props` when the template is declared. */
+  readonly preview: core.input<S>;
+}
+export interface EmailTemplate<S extends PropsSchema = PropsSchema> extends TemplateBase<S> {
+  readonly kind: 'email-template';
+  readonly version: 1;
+  readonly subject: string;
+  /** The email body: a component over the parsed props (rendered by `@shware/workflow/react-email`). */
+  readonly component: (props: Readonly<core.output<S>>) => unknown;
+}
+export interface PushTemplate<S extends PropsSchema = PropsSchema> extends TemplateBase<S> {
+  readonly kind: 'push-template';
+  readonly version: 1;
+  /** The notification, from the parsed props. Synchronous and pure; its result is checked before sending. */
+  readonly content: (props: Readonly<core.output<S>>) => PushContent;
+}
+/**
+ * A message posted to a team channel through an incoming webhook (Discord, Slack). The webhook
+ * URL is a secret, so it lives in the Worker's environment and the template reads it from there
+ * at send time: `webhook: (env: Env) => env.WEBHOOK_DISCORD_ALERTS`, with `Env` the host's
+ * zod-validated environment (`journeyWorker({ env: schema })`). The studio never calls it.
+ */
+interface WebhookTemplateBase<S extends PropsSchema, Env> extends TemplateBase<S> {
+  readonly version: 1;
+  webhook(env: Env): string | undefined;
+}
+export interface DiscordTemplate<S extends PropsSchema = PropsSchema, Env = Record<string, unknown>> extends WebhookTemplateBase<S, Env> {
+  readonly kind: 'discord-template';
+  /** The message, from the parsed props. Synchronous and pure; checked before sending. */
+  readonly content: (props: Readonly<core.output<S>>) => DiscordContent;
+}
+export interface SlackTemplate<S extends PropsSchema = PropsSchema, Env = Record<string, unknown>> extends WebhookTemplateBase<S, Env> {
+  readonly kind: 'slack-template';
+  /** The message, from the parsed props. Synchronous and pure; checked before sending. */
+  readonly content: (props: Readonly<core.output<S>>) => SlackContent;
+}
+/** Strips a Promise return out of the accepted callback types: async content is rejected at the type level. */
+type Sync<T> = T extends Promise<unknown> ? never : T;
+export interface EmailTemplateDefinition<S extends PropsSchema> {
+  title: string;
+  description?: string;
+  props: S;
+  subject: string;
+  preview: NoInfer<core.input<S>>;
+  component: (props: NoInfer<Readonly<core.output<S>>>) => unknown;
+}
+export interface PushTemplateDefinition<S extends PropsSchema, R> {
+  title: string;
+  description?: string;
+  props: S;
+  preview: NoInfer<core.input<S>>;
+  content: (props: NoInfer<Readonly<core.output<S>>>) => Sync<R> & PushContent;
+}
+export interface WebhookTemplateDefinition<S extends PropsSchema, Env, C> {
+  title: string;
+  description?: string;
+  props: S;
+  preview: NoInfer<core.input<S>>;
+  /** The webhook URL, read from the Worker's environment when a message is sent. */
+  webhook: (env: Env) => string | undefined;
+  content: (props: NoInfer<Readonly<core.output<S>>>) => Sync<C>;
+}
+/** Declare a Discord webhook template. Throws when `props` is unsupported or `preview` does not parse. */
+export declare function discordTemplate<S extends PropsSchema, Env = Record<string, unknown>>(definition: WebhookTemplateDefinition<S, Env, DiscordContent>): DiscordTemplate<S, Env>;
+/** Declare a Slack webhook template. Throws when `props` is unsupported or `preview` does not parse. */
+export declare function slackTemplate<S extends PropsSchema, Env = Record<string, unknown>>(definition: WebhookTemplateDefinition<S, Env, SlackContent>): SlackTemplate<S, Env>;
+/** Declare an email template. Throws when `props` uses an unsupported schema or `preview` does not parse. */
+export declare function emailTemplate<S extends PropsSchema>(definition: EmailTemplateDefinition<S>): EmailTemplate<S>;
+/** Declare a push template. Throws when `props` uses an unsupported schema or `preview` does not parse. */
+export declare function pushTemplate<S extends PropsSchema, R extends PushContent>(definition: PushTemplateDefinition<S, R>): PushTemplate<S>;
+export declare function isEmailTemplate(value: unknown): value is EmailTemplate;
+export declare function isPushTemplate(value: unknown): value is PushTemplate;
+export declare function isDiscordTemplate(value: unknown): value is DiscordTemplate;
+export declare function isSlackTemplate(value: unknown): value is SlackTemplate;
+/** Any declared template. */
+export type AnyTemplate = EmailTemplate | PushTemplate | DiscordTemplate | SlackTemplate;
+/** One failed field, with the dotted path the studio and the logs show. */
+export interface TemplateIssue {
+  path: string;
+  message: string;
+}
+/**
+ * A template refused its input (`phase: 'props'` — the component/content was
+ * never called) or its content function returned something that is not a
+ * notification (`phase: 'content'` — called, but nothing is sent). Never a
+ * provider failure: a sender must not read it as a dead device token.
+ */
+export declare class TemplateValidationError extends Error {
+  readonly channel: TemplateChannel;
+  readonly template: string;
+  readonly phase: 'props' | 'content';
+  readonly issues: TemplateIssue[];
+  readonly name = "TemplateValidationError";
+  constructor(channel: TemplateChannel, template: string, phase: 'props' | 'content', issues: TemplateIssue[]);
+}
+/**
+ * Parse message props against a template's schema and return the parsed value
+ * — the only value anything downstream may use. Throws TemplateValidationError.
+ */
+export declare function parseTemplateProps<S extends PropsSchema>(template: EmailTemplate<S> | PushTemplate<S> | DiscordTemplate<S> | SlackTemplate<S>, key: string, props: Record<string, unknown>): core.output<S>;
+/** Run a push template's content over parsed props and check the notification it returns. */
+export declare function renderPushContent(template: PushTemplate, key: string, props: Record<string, unknown>): PushContent;
+/** Run a Discord template's content over parsed props and check the message it returns. */
+export declare function renderDiscordContent(template: DiscordTemplate, key: string, props: Record<string, unknown>): DiscordContent;
+/** Run a Slack template's content over parsed props and check the message it returns. */
+export declare function renderSlackContent(template: SlackTemplate, key: string, props: Record<string, unknown>): SlackContent;
+/** Throws when `schema` is outside the v1 subset (see the header). */
+export declare function assertSupportedSchema(schema: unknown, where: string): void;
+/** The scalar props a template accepts, as the IR resolves them before parsing. */
+export type ResolvedProps = Record<string, ScalarIR | undefined>;
+/**
+ * The engine's MessageValidator over the template registries: the message's
+ * props are parsed by its template (the parsed value is what gets sent); a
+ * push's content is also run once and checked, so an invalid notification
+ * stops the send before any device; Discord and Slack content likewise. Channels without a
+ * registry here (sms, …) pass through to their app-supplied senders.
+ */
+export declare function registryValidator(registries: {
+  email?: Record<string, EmailTemplate> | undefined;
+  push?: Record<string, PushTemplate> | undefined;
+  discord?: Readonly<Record<string, DiscordTemplate<PropsSchema, never>>> | undefined;
+  slack?: Readonly<Record<string, SlackTemplate<PropsSchema, never>>> | undefined;
+}): {
+  validate(message: {
+    channel: string;
+    template: string;
+    props: ResolvedProps;
+  }): ResolvedProps;
+};
+//#endregion
+//# sourceMappingURL=templates.d.cts.map

package/dist/templates.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.cts","names":[],"sources":["../src/templates.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;YA2BY,cAAc,KAAK;;iBAGd;EACf;EACA;;EAEA;;EAEA;;;YAIU,iBAAiB;;iBAGZ;;EAEf;EACA,UAAU,aAAa;EACvB;EACA;EACA;EACA;EACA;EACA;;;YAIU;UAEF,aAAa,UAAU;;WAEtB;WACA;WACA,OAAO;;WAEP,SAAS,KAAK,MAAM;;iBAGd,cAAc,UAAU,cAAc,qBAAqB,aAAa;WAC9E;WACA;WACA;;WAEA,YAAY,OAAO,SAAS,KAAK,OAAO;;iBAGlC,aAAa,UAAU,cAAc,qBAAqB,aAAa;WAC7E;WACA;;WAEA,UAAU,OAAO,SAAS,KAAK,OAAO,QAAQ;;;;;;;;UAS/C,oBAAoB,UAAU,aAAa,aAAa,aAAa;WACpE;EAET,QAAQ,KAAK;;iBAGE,gBACf,UAAU,cAAc,aACxB,MAAM,iCACE,oBAAoB,GAAG;WACtB;;WAEA,UAAU,OAAO,SAAS,KAAK,OAAO,QAAQ;;iBAGxC,cACf,UAAU,cAAc,aACxB,MAAM,iCACE,oBAAoB,GAAG;WACtB;;WAEA,UAAU,OAAO,SAAS,KAAK,OAAO,QAAQ;;;KAIpD,KAAK,KAAK,UAAU,2BAA2B;iBAEnC,wBAAwB,UAAU;EACjD;EACA;EACA,OAAO;EACP;EACA,SAAS,QAAQ,KAAK,MAAM;EAC5B,YAAY,OAAO,QAAQ,SAAS,KAAK,OAAO;;iBAGjC,uBAAuB,UAAU,aAAa;EAC7D;EACA;EACA,OAAO;EACP,SAAS,QAAQ,KAAK,MAAM;EAC5B,UAAU,OAAO,QAAQ,SAAS,KAAK,OAAO,SAAS,KAAK,KAAK;;iBAGlD,0BAA0B,UAAU,aAAa,KAAK;EACrE;EACA;EACA,OAAO;EACP,SAAS,QAAQ,KAAK,MAAM;;EAE5B,UAAU,KAAK;EACf,UAAU,OAAO,QAAQ,SAAS,KAAK,OAAO,SAAS,KAAK;;;wBAI9C,gBAAgB,UAAU,aAAa,MAAM,yBAC3D,YAAY,0BAA0B,GAAG,KAAK,kBAC7C,gBAAgB,GAAG;;wBAON,cAAc,UAAU,aAAa,MAAM,yBACzD,YAAY,0BAA0B,GAAG,KAAK,gBAC7C,cAAc,GAAG;;wBAOJ,cAAc,UAAU,aACtC,YAAY,wBAAwB,KACnC,cAAc;;wBAOD,aAAa,UAAU,aAAa,UAAU,aAC5D,YAAY,uBAAuB,GAAG,KACrC,aAAa;wBAMA,gBAAgB,iBAAiB,SAAS;wBAI1C,eAAe,iBAAiB,SAAS;wBAIzC,kBAAkB,iBAAiB,SAAS;wBAI5C,gBAAgB,iBAAiB,SAAS;;YAK9C,cAAc,gBAAgB,eAAe,kBAAkB;;iBAqB1D;EACf;EACA;;;;;;;;qBASW,gCAAgC;WAGhC,SAAS;WACT;WACA;WACA,QAAQ;WALD;EAClB,YACW,SAAS,iBACT,kBACA,4BACA,QAAQ;;;;;;wBAqBL,mBAAmB,UAAU,aAC3C,UAAU,cAAc,KAAK,aAAa,KAAK,gBAAgB,KAAK,cAAc,IAClF,aACA,OAAO,0BACN,KAAK,OAAO;;wBAiBC,kBACd,UAAU,cACV,aACA,OAAO,0BACN;;wBA2Ba,qBACd,UAAU,iBACV,aACA,OAAO,0BACN;;wBAmBa,mBACd,UAAU,eACV,aACA,OAAO,0BACN;;wBA+Ba,sBAAsB,iBAAiB;;YA0D3C,gBAAgB,eAAe;;;;;;;;wBAS3B,kBAAkB;EAChC,QAAQ,eAAe;EACvB,OAAO,eAAe;EACtB,UAAU,SAAS,eAAe,gBAAgB;EAClD,QAAQ,SAAS,eAAe,cAAc;;EAE9C,SAAS;IAAW;IAAiB;IAAkB,OAAO;MAAkB"}