@cowliss/cli 0.7.0 → 0.9.0

package/dist/guest/driver-emails.d.ts

@@ -0,0 +1,12 @@
+import { GuestModule, GuestOutput } from "./driver.js";
+//#region src/guest/driver-emails.d.ts
+/**
+ * The template half of the driver (spec: Guest protocol). It answers the
+ * two inputs a bundle built from `emails/` can get, `manifest` and
+ * `template`, and it is the only guest entry that imports `render.ts`:
+ * react and react-dom reach a bundle through this file or not at all.
+ * `driver.ts` is the journey half and holds everything both kinds share.
+ */
+declare function runGuest(module: GuestModule, input: unknown): Promise<GuestOutput>;
+//#endregion
+export { runGuest };

package/dist/guest/{driver-C1bsCjZT.js → driver-emails.js}

@@ -1,5 +1,5 @@
-import { a as manifestOutputSchema, i as journeyStepOutputSchema, o as templateRenderOutputSchema, r as guestInputSchema, t as CapabilityError } from "./journeys-Dpsp225V.js";
-import { z } from "zod";
+import { o as templateRenderOutputSchema, r as guestInputSchema, t as CapabilityError } from "./journeys-F8Yk8s1P.js";
+import { n as readManifest, t as asTemplate } from "./driver-poSdZIj8.js";
 import { createElement } from "react";
 import { renderToStaticMarkup } from "react-dom/server.browser";
 
@@ -30,154 +30,6 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 
-//#endregion
-//#region src/guest/api.ts
-/**
-* The journaled capability implementation (spec: Guest protocol). Every
-* `api` method funnels into `call`, which either replays the matching
-* journal entry or records the pending call and hangs, letting the driver
-* report the suspension.
-*/
-/** A replayed call did not match the journal: the execution cannot continue. */
-var NondeterminismError = class extends Error {
-	expected;
-	actual;
-	constructor(expected, actual) {
-		super(`Journey replay diverged: the journal recorded "${expected.name}" but the code called "${actual.name}" with different arguments`);
-		this.name = "NondeterminismError";
-		this.expected = expected;
-		this.actual = actual;
-	}
-};
-/**
-* Structural equality over JSON values. Key order differs between a
-* literal in journey code and the same object round-tripped through the
-* journal, so comparing serialized forms would report a divergence that
-* is not one.
-*/
-function sameValue(a, b) {
-	if (a === b) return true;
-	if (Array.isArray(a) || Array.isArray(b)) return Array.isArray(a) && Array.isArray(b) && a.length === b.length && a.every((item, index) => sameValue(item, b[index]));
-	if (typeof a !== "object" || typeof b !== "object" || !a || !b) return false;
-	const left = a;
-	const right = b;
-	const keys = /* @__PURE__ */ new Set([...Object.keys(left), ...Object.keys(right)]);
-	for (const key of keys) if (!sameValue(left[key], right[key])) return false;
-	return true;
-}
-function formatLogArg(value) {
-	if (typeof value === "string") return value;
-	try {
-		return JSON.stringify(value) ?? String(value);
-	} catch {
-		return String(value);
-	}
-}
-/**
-* Builds the `api` a journey's `run` receives, over the step's journal.
-* The returned state is the driver's window into the run: the pending
-* call, the captured logs, and the clock the shims read.
-*/
-function createApi(input, journey) {
-	let cursor = 0;
-	let markSuspended = () => {};
-	const state = {
-		clock: { now: input.now },
-		logs: [],
-		pending: null,
-		suspended: new Promise((resolve) => {
-			markSuspended = resolve;
-		})
-	};
-	function call(command) {
-		if (command.name !== "restart" && cursor >= input.limits.calls) throw new CapabilityError("call_limit_exceeded", `Journey exceeded the per-execution limit of ${input.limits.calls} capability calls; use api.restart() for loops`);
-		const entry = input.journal[cursor];
-		if (!entry) {
-			if (!state.pending) {
-				state.pending = command;
-				markSuspended();
-			}
-			return new Promise(() => {});
-		}
-		if (entry.call.name !== command.name || !sameValue(entry.call.args, command.args)) throw new NondeterminismError(entry.call, command);
-		cursor += 1;
-		state.clock.now = cursor < input.journal.length ? entry.at : input.now;
-		if (entry.result.ok) return Promise.resolve(entry.result.value);
-		return Promise.reject(new CapabilityError(entry.result.error.code, entry.result.error.message));
-	}
-	return {
-		api: {
-			sleep: (duration) => call({
-				name: "sleep",
-				args: { duration }
-			}),
-			waitForEvent: (name, options) => call({
-				name: "waitForEvent",
-				args: {
-					event: name,
-					timeout: options.timeout
-				}
-			}),
-			send: {
-				email: (args) => call({
-					name: "send.email",
-					args: {
-						template: args.template,
-						props: args.props,
-						from: args.from ?? journey.from,
-						replyTo: args.replyTo
-					}
-				}),
-				webhook: (args) => call({
-					name: "send.webhook",
-					args
-				})
-			},
-			traits: {
-				set: (key, value) => call({
-					name: "traits.set",
-					args: {
-						key,
-						value
-					}
-				}),
-				unset: (key) => call({
-					name: "traits.unset",
-					args: { key }
-				})
-			},
-			profile: { get: () => call({
-				name: "profile.get",
-				args: {}
-			}) },
-			profiles: { get: (id) => call({
-				name: "profiles.get",
-				args: { id }
-			}) },
-			events: { track: (name, properties) => call({
-				name: "events.track",
-				args: {
-					event: name,
-					properties
-				}
-			}) },
-			log: (...args) => {
-				if (cursor < input.journal.length) return;
-				if (state.logs.length >= input.limits.logLines) return;
-				state.logs.push({
-					level: "info",
-					message: args.map(formatLogArg).join(" ").slice(0, input.limits.logLineBytes)
-				});
-			},
-			restart: (args) => call({
-				name: "restart",
-				args: { event: args?.event }
-			})
-		},
-		state
-	};
-}
-
 //#endregion
 //#region ../../node_modules/.pnpm/domelementtype@2.3.0/node_modules/domelementtype/lib/esm/index.js
 /** Types of elements found in htmlparser2's DOM */
@@ -5482,173 +5334,20 @@ function renderTemplateModule(template, props) {
 }
 
 //#endregion
-//#region src/guest/shims.ts
+//#region src/guest/driver-emails.ts
 /**
-* A hash of the seed string into a 32-bit state (FNV-1a). The seed derives
-* from the execution id, so the same execution replays the same numbers.
-*/
-function hashSeed(seed) {
-	let hash = 2166136261;
-	for (let index = 0; index < seed.length; index += 1) {
-		hash ^= seed.charCodeAt(index);
-		hash = Math.imul(hash, 16777619);
-	}
-	return hash >>> 0;
-}
-/** mulberry32: small, fast, and good enough for journey branching. */
-function mulberry32(seed) {
-	let state = hashSeed(seed);
-	return () => {
-		state = state + 1831565813 | 0;
-		let value = Math.imul(state ^ state >>> 15, 1 | state);
-		value = value + Math.imul(value ^ value >>> 7, 61 | value) ^ value;
-		return ((value ^ value >>> 14) >>> 0) / 4294967296;
-	};
-}
-const BLOCKED = [
-	"setTimeout",
-	"setInterval",
-	"setImmediate",
-	"fetch",
-	"XMLHttpRequest",
-	"queueMicrotask"
-];
-function blocked(name) {
-	return () => {
-		throw new CapabilityError("capability_unavailable", `${name} is not available in journeys: use the api object, which is journaled and replays exactly`);
-	};
-}
-/**
-* Installs the shims and returns the undo. Call it before user code runs
-* and restore in a `finally`, so a driver embedded in a Node process does
-* not leak a frozen clock into its host.
-*/
-function installShims(options) {
-	const globals = globalThis;
-	const saved = /* @__PURE__ */ new Map();
-	const save = (name) => {
-		saved.set(name, name in globals ? globals[name] : void 0);
-	};
-	const RealDate = Date;
-	class GuestDate extends RealDate {
-		constructor(...args) {
-			if (args.length === 0) super(options.clock.now);
-			else super(...args);
-		}
-		static now() {
-			return options.clock.now;
-		}
-	}
-	save("Date");
-	globals.Date = GuestDate;
-	const realRandom = Math.random;
-	Math.random = mulberry32(options.seed);
-	for (const name of BLOCKED) {
-		save(name);
-		globals[name] = blocked(name);
-	}
-	return () => {
-		Math.random = realRandom;
-		for (const [name, value] of saved) if (value === void 0) delete globals[name];
-		else globals[name] = value;
-	};
-}
-
-//#endregion
-//#region src/guest/driver.ts
-function asJourney(module) {
-	const journey = module.default;
-	if (!journey || typeof journey.run !== "function") throw new Error("Journey module must default-export defineJourney({ ... }) with a run function");
-	return journey;
-}
-function asTemplate(module) {
-	const template = module;
-	if (typeof template.default !== "function" || !template.props) throw new Error("Template module must export a default component and a zod `props` schema");
-	return template;
-}
-function readManifest(module) {
-	if (module.default && typeof module.default.run === "function") {
-		const journey = asJourney(module);
-		return manifestOutputSchema.parse({
-			kind: "journey",
-			trigger: journey.trigger,
-			purpose: journey.purpose,
-			enrollment: journey.enrollment,
-			description: journey.description,
-			from: journey.from,
-			tags: journey.tags
-		});
-	}
-	const template = asTemplate(module);
-	return manifestOutputSchema.parse({
-		kind: "template",
-		tags: template.tags,
-		sendClass: template.sendClass ?? "marketing",
-		verifyLink: template.verifyLink ?? false,
-		unsubscribeLink: template.unsubscribeLink ?? false,
-		propsSchema: z.toJSONSchema(template.props, { target: "draft-2020-12" })
-	});
-}
-async function runJourneyStep(module, input) {
-	const journey = asJourney(module);
-	const { api, state } = createApi(input, journey);
-	const restore = installShims({
-		clock: state.clock,
-		seed: input.seed
-	});
-	try {
-		if (await Promise.race([journey.run(input.event, api).then(() => true), state.suspended.then(() => false)])) return journeyStepOutput({
-			status: "done",
-			logs: state.logs
-		});
-		return journeyStepOutput({
-			status: "suspend",
-			call: state.pending,
-			logs: state.logs
-		});
-	} catch (error) {
-		if (error instanceof NondeterminismError) return journeyStepOutput({
-			status: "error",
-			error: {
-				code: "journey_nondeterministic",
-				message: error.message
-			},
-			nondeterministic: {
-				expected: error.expected,
-				actual: error.actual
-			},
-			logs: state.logs
-		});
-		const thrown = error instanceof Error ? error : new Error(String(error));
-		return journeyStepOutput({
-			status: "error",
-			error: {
-				code: "journey_error",
-				message: thrown.message,
-				stack: thrown.stack
-			},
-			logs: state.logs
-		});
-	} finally {
-		restore();
-	}
-}
-function journeyStepOutput(output) {
-	return journeyStepOutputSchema.parse(output);
-}
-/**
-* Runs one guest invocation. `module` is the tenant module namespace the
-* bundle's entry imported; `input` is the raw JSON the host handed over.
+* The template half of the driver (spec: Guest protocol). It answers the
+* two inputs a bundle built from `emails/` can get, `manifest` and
+* `template`, and it is the only guest entry that imports `render.ts`:
+* react and react-dom reach a bundle through this file or not at all.
+* `driver.ts` is the journey half and holds everything both kinds share.
 */
 async function runGuest(module, input) {
 	const parsed = guestInputSchema.parse(input);
 	if (parsed.kind === "manifest") return readManifest(module);
-	if (parsed.kind === "template") return renderTemplate(module, parsed);
-	return runJourneyStep(module, parsed);
-}
-function renderTemplate(module, input) {
-	return templateRenderOutputSchema.parse(renderTemplateModule(asTemplate(module), input.props));
+	if (parsed.kind === "journey") throw new Error("A template bundle cannot run a journey step.");
+	return templateRenderOutputSchema.parse(renderTemplateModule(asTemplate(module), parsed.props));
 }
 
 //#endregion
-export { runGuest as t };
+export { runGuest };

package/dist/guest/driver-poSdZIj8.js

@@ -0,0 +1,320 @@
+import { a as manifestOutputSchema, i as journeyStepOutputSchema, r as guestInputSchema, t as CapabilityError } from "./journeys-F8Yk8s1P.js";
+import { z } from "zod";
+
+//#region src/guest/api.ts
+/**
+* The journaled capability implementation (spec: Guest protocol). Every
+* `api` method funnels into `call`, which either replays the matching
+* journal entry or records the pending call and hangs, letting the driver
+* report the suspension.
+*/
+/** A replayed call did not match the journal: the execution cannot continue. */
+var NondeterminismError = class extends Error {
+	expected;
+	actual;
+	constructor(expected, actual) {
+		super(`Journey replay diverged: the journal recorded "${expected.name}" but the code called "${actual.name}" with different arguments`);
+		this.name = "NondeterminismError";
+		this.expected = expected;
+		this.actual = actual;
+	}
+};
+/**
+* Structural equality over JSON values. Key order differs between a
+* literal in journey code and the same object round-tripped through the
+* journal, so comparing serialized forms would report a divergence that
+* is not one.
+*/
+function sameValue(a, b) {
+	if (a === b) return true;
+	if (Array.isArray(a) || Array.isArray(b)) return Array.isArray(a) && Array.isArray(b) && a.length === b.length && a.every((item, index) => sameValue(item, b[index]));
+	if (typeof a !== "object" || typeof b !== "object" || !a || !b) return false;
+	const left = a;
+	const right = b;
+	const keys = /* @__PURE__ */ new Set([...Object.keys(left), ...Object.keys(right)]);
+	for (const key of keys) if (!sameValue(left[key], right[key])) return false;
+	return true;
+}
+function formatLogArg(value) {
+	if (typeof value === "string") return value;
+	try {
+		return JSON.stringify(value) ?? String(value);
+	} catch {
+		return String(value);
+	}
+}
+/**
+* Builds the `api` a journey's `run` receives, over the step's journal.
+* The returned state is the driver's window into the run: the pending
+* call, the captured logs, and the clock the shims read.
+*/
+function createApi(input, journey) {
+	let cursor = 0;
+	let markSuspended = () => {};
+	const state = {
+		clock: { now: input.now },
+		logs: [],
+		pending: null,
+		suspended: new Promise((resolve) => {
+			markSuspended = resolve;
+		})
+	};
+	function call(command) {
+		if (command.name !== "restart" && cursor >= input.limits.calls) throw new CapabilityError("call_limit_exceeded", `Journey exceeded the per-execution limit of ${input.limits.calls} capability calls; use api.restart() for loops`);
+		const entry = input.journal[cursor];
+		if (!entry) {
+			if (!state.pending) {
+				state.pending = command;
+				markSuspended();
+			}
+			return new Promise(() => {});
+		}
+		if (entry.call.name !== command.name || !sameValue(entry.call.args, command.args)) throw new NondeterminismError(entry.call, command);
+		cursor += 1;
+		state.clock.now = cursor < input.journal.length ? entry.at : input.now;
+		if (entry.result.ok) return Promise.resolve(entry.result.value);
+		return Promise.reject(new CapabilityError(entry.result.error.code, entry.result.error.message));
+	}
+	return {
+		api: {
+			sleep: (duration) => call({
+				name: "sleep",
+				args: { duration }
+			}),
+			waitForEvent: (name, options) => call({
+				name: "waitForEvent",
+				args: {
+					event: name,
+					timeout: options.timeout
+				}
+			}),
+			send: {
+				email: (args) => call({
+					name: "send.email",
+					args: {
+						template: args.template,
+						props: args.props,
+						from: args.from ?? journey.from,
+						replyTo: args.replyTo
+					}
+				}),
+				webhook: (args) => call({
+					name: "send.webhook",
+					args
+				})
+			},
+			traits: {
+				set: (key, value) => call({
+					name: "traits.set",
+					args: {
+						key,
+						value
+					}
+				}),
+				unset: (key) => call({
+					name: "traits.unset",
+					args: { key }
+				})
+			},
+			profile: { get: () => call({
+				name: "profile.get",
+				args: {}
+			}) },
+			profiles: { get: (id) => call({
+				name: "profiles.get",
+				args: { id }
+			}) },
+			events: { track: (name, properties) => call({
+				name: "events.track",
+				args: {
+					event: name,
+					properties
+				}
+			}) },
+			log: (...args) => {
+				if (cursor < input.journal.length) return;
+				if (state.logs.length >= input.limits.logLines) return;
+				state.logs.push({
+					level: "info",
+					message: args.map(formatLogArg).join(" ").slice(0, input.limits.logLineBytes)
+				});
+			},
+			restart: (args) => call({
+				name: "restart",
+				args: { event: args?.event }
+			})
+		},
+		state
+	};
+}
+
+//#endregion
+//#region src/guest/shims.ts
+/**
+* A hash of the seed string into a 32-bit state (FNV-1a). The seed derives
+* from the execution id, so the same execution replays the same numbers.
+*/
+function hashSeed(seed) {
+	let hash = 2166136261;
+	for (let index = 0; index < seed.length; index += 1) {
+		hash ^= seed.charCodeAt(index);
+		hash = Math.imul(hash, 16777619);
+	}
+	return hash >>> 0;
+}
+/** mulberry32: small, fast, and good enough for journey branching. */
+function mulberry32(seed) {
+	let state = hashSeed(seed);
+	return () => {
+		state = state + 1831565813 | 0;
+		let value = Math.imul(state ^ state >>> 15, 1 | state);
+		value = value + Math.imul(value ^ value >>> 7, 61 | value) ^ value;
+		return ((value ^ value >>> 14) >>> 0) / 4294967296;
+	};
+}
+const BLOCKED = [
+	"setTimeout",
+	"setInterval",
+	"setImmediate",
+	"fetch",
+	"XMLHttpRequest",
+	"queueMicrotask"
+];
+function blocked(name) {
+	return () => {
+		throw new CapabilityError("capability_unavailable", `${name} is not available in journeys: use the api object, which is journaled and replays exactly`);
+	};
+}
+/**
+* Installs the shims and returns the undo. Call it before user code runs
+* and restore in a `finally`, so a driver embedded in a Node process does
+* not leak a frozen clock into its host.
+*/
+function installShims(options) {
+	const globals = globalThis;
+	const saved = /* @__PURE__ */ new Map();
+	const save = (name) => {
+		saved.set(name, name in globals ? globals[name] : void 0);
+	};
+	const RealDate = Date;
+	class GuestDate extends RealDate {
+		constructor(...args) {
+			if (args.length === 0) super(options.clock.now);
+			else super(...args);
+		}
+		static now() {
+			return options.clock.now;
+		}
+	}
+	save("Date");
+	globals.Date = GuestDate;
+	const realRandom = Math.random;
+	Math.random = mulberry32(options.seed);
+	for (const name of BLOCKED) {
+		save(name);
+		globals[name] = blocked(name);
+	}
+	return () => {
+		Math.random = realRandom;
+		for (const [name, value] of saved) if (value === void 0) delete globals[name];
+		else globals[name] = value;
+	};
+}
+
+//#endregion
+//#region src/guest/driver.ts
+function asJourney(module) {
+	const journey = module.default;
+	if (!journey || typeof journey.run !== "function") throw new Error("Journey module must default-export defineJourney({ ... }) with a run function");
+	return journey;
+}
+function asTemplate(module) {
+	const template = module;
+	if (typeof template.default !== "function" || !template.props) throw new Error("Template module must export a default component and a zod `props` schema");
+	return template;
+}
+function readManifest(module) {
+	if (module.default && typeof module.default.run === "function") {
+		const journey = asJourney(module);
+		return manifestOutputSchema.parse({
+			kind: "journey",
+			trigger: journey.trigger,
+			purpose: journey.purpose,
+			enrollment: journey.enrollment,
+			description: journey.description,
+			from: journey.from,
+			tags: journey.tags
+		});
+	}
+	const template = asTemplate(module);
+	return manifestOutputSchema.parse({
+		kind: "template",
+		tags: template.tags,
+		sendClass: template.sendClass ?? "marketing",
+		verifyLink: template.verifyLink ?? false,
+		unsubscribeLink: template.unsubscribeLink ?? false,
+		propsSchema: z.toJSONSchema(template.props, { target: "draft-2020-12" })
+	});
+}
+async function runJourneyStep(module, input) {
+	const journey = asJourney(module);
+	const { api, state } = createApi(input, journey);
+	const restore = installShims({
+		clock: state.clock,
+		seed: input.seed
+	});
+	try {
+		if (await Promise.race([journey.run(input.event, api).then(() => true), state.suspended.then(() => false)])) return journeyStepOutput({
+			status: "done",
+			logs: state.logs
+		});
+		return journeyStepOutput({
+			status: "suspend",
+			call: state.pending,
+			logs: state.logs
+		});
+	} catch (error) {
+		if (error instanceof NondeterminismError) return journeyStepOutput({
+			status: "error",
+			error: {
+				code: "journey_nondeterministic",
+				message: error.message
+			},
+			nondeterministic: {
+				expected: error.expected,
+				actual: error.actual
+			},
+			logs: state.logs
+		});
+		const thrown = error instanceof Error ? error : new Error(String(error));
+		return journeyStepOutput({
+			status: "error",
+			error: {
+				code: "journey_error",
+				message: thrown.message,
+				stack: thrown.stack
+			},
+			logs: state.logs
+		});
+	} finally {
+		restore();
+	}
+}
+function journeyStepOutput(output) {
+	return journeyStepOutputSchema.parse(output);
+}
+/**
+* Runs one guest invocation against a journey bundle. `module` is the tenant
+* module namespace the bundle's entry imported; `input` is the raw JSON the
+* host handed over. A `template` input is a host bug, not a tenant one: this
+* bundle was built from `journeys/` and carries no renderer.
+*/
+async function runGuest(module, input) {
+	const parsed = guestInputSchema.parse(input);
+	if (parsed.kind === "manifest") return readManifest(module);
+	if (parsed.kind === "template") throw new Error("A journey bundle cannot render a template.");
+	return runJourneyStep(module, parsed);
+}
+
+//#endregion
+export { readManifest as n, runGuest as r, asTemplate as t };