@hitch42/applet 0.1.1-beta.7 → 0.1.1-beta.9

package/dist/client.d.ts

@@ -1,7 +1,7 @@
-import { f as RegisteredContract, m as RegisteredRouter, p as RegisteredManifest } from "./manifest-C489nYUy.js";
-import { t as NarrowContract } from "./contract-DB9QQhD9.js";
+import { f as RegisteredContract, m as RegisteredRouter, p as RegisteredManifest } from "./manifest-C6_F4bL8.js";
+import { t as NarrowContract } from "./contract-CsUpTBe0.js";
 import { t as WithBatchRecorder } from "./batch-Qa4B4-Yp.js";
-import { o as WithFilesUpload } from "./upload-YbRKEqR6.js";
+import { o as WithFilesUpload } from "./upload-DKZzz5kW.js";
 import { RouterClient } from "@orpc/server";
 import { ContractRouterClient } from "@orpc/contract";
 import { NestedClient } from "@orpc/client";

package/dist/{contract-DB9QQhD9.d.ts → contract-CsUpTBe0.d.ts}

@@ -1,4 +1,4 @@
-import { n as AppletManifest } from "./manifest-C489nYUy.js";
+import { n as AppletManifest } from "./manifest-C6_F4bL8.js";
 import { AnyContractRouter } from "@orpc/contract";
 //#region src/hitch/contract.d.ts
 type ManifestObjectFor<Manifest, Code> = Manifest extends {

package/dist/{deploy-CqrtNJ1x.js → deploy-wGYjwXrx.js}

@@ -1,11 +1,12 @@
-import { i as readWorkspaceConfig, n as fetchWithOrgAuth } from "./workspace-B6lenAS5.js";
-import { a as loadGitHubActionsSources, n as githubActionsContext, r as hitchResponseError, t as fetchWithGitHubActions } from "./ci-gPrwo6C0.js";
-import { n as buildPreparedApplet, r as prepareWorkspaceBuild, t as buildApplet } from "./build-DauirTcY.js";
+import { i as readWorkspaceConfig, n as fetchWithOrgAuth } from "./workspace-D0dnnlxL.js";
+import { a as loadGitHubActionsSources, n as githubActionsContext, r as hitchResponseError, t as fetchWithGitHubActions } from "./ci-BKw14X2h.js";
+import { n as buildPreparedApplet, r as prepareWorkspaceBuild, t as buildApplet } from "./build-CEfFoIZZ.js";
 import { createRequire } from "node:module";
+import { createHash } from "node:crypto";
 import { existsSync } from "node:fs";
-import { readFile, readdir } from "node:fs/promises";
-import { relative, resolve, sep } from "node:path";
-import { execFile } from "node:child_process";
+import { lstat, readFile, readdir, readlink } from "node:fs/promises";
+import { dirname, relative, resolve, sep } from "node:path";
+import { execFile, spawn } from "node:child_process";
 import { promisify } from "node:util";
 import { createGzip } from "node:zlib";
 //#region \0rolldown/runtime.js
@@ -2307,11 +2308,112 @@ var require_pack = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	}
 }));
 //#endregion
-//#region src/deploy.ts
+//#region src/source-hash.ts
 var import_tar_stream = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.extract = require_extract();
 	exports.pack = require_pack();
 })))(), 1);
+const execFileAsync$1 = promisify(execFile);
+function gitEnvironment() {
+	return Object.fromEntries(Object.entries(process.env).filter(([key]) => !key.startsWith("GIT_")));
+}
+var SourceHashUnavailableError = class extends Error {
+	constructor() {
+		super("Git is unavailable or the applet is outside a git repository.");
+	}
+};
+function isMissingPath(error) {
+	return error instanceof Error && "code" in error && (error.code === "ENOENT" || error.code === "ENOTDIR");
+}
+async function hashFiles(topLevel, paths, env) {
+	if (paths.length === 0) return [];
+	return new Promise((resolveHashes, reject) => {
+		const child = spawn("git", ["hash-object", "--stdin-paths"], {
+			cwd: topLevel,
+			env
+		});
+		const stdout = [];
+		const stderr = [];
+		child.stdout.on("data", (chunk) => stdout.push(chunk));
+		child.stderr.on("data", (chunk) => stderr.push(chunk));
+		child.stdin.on("error", reject);
+		child.on("error", reject);
+		child.on("close", (code) => {
+			if (code !== 0) {
+				reject(/* @__PURE__ */ new Error(`git hash-object failed (${code}): ${Buffer.concat(stderr).toString("utf8").trim()}`));
+				return;
+			}
+			const hashes = Buffer.concat(stdout).toString("utf8").trimEnd().split("\n");
+			if (hashes.length !== paths.length || hashes.some((hash) => !/^[0-9a-f]{40,64}$/.test(hash))) {
+				reject(/* @__PURE__ */ new Error("git hash-object returned an unexpected number of hashes."));
+				return;
+			}
+			resolveHashes(hashes);
+		});
+		child.stdin.end(paths.map((path) => `"${path.split("").map((character) => character < " " || character === "" || character === "\"" || character === "\\" ? `\\${character.charCodeAt(0).toString(8).padStart(3, "0")}` : character).join("")}"\n`).join(""));
+	});
+}
+async function sourceHashes(appletRoots) {
+	if (appletRoots.length === 0) return /* @__PURE__ */ new Map();
+	const env = gitEnvironment();
+	const workspaceRoot = dirname(dirname(appletRoots[0]));
+	let topLevel;
+	try {
+		const { stdout } = await execFileAsync$1("git", ["rev-parse", "--show-toplevel"], {
+			cwd: workspaceRoot,
+			env
+		});
+		topLevel = stdout.trim();
+	} catch (error) {
+		if (isMissingPath(error) || error instanceof Error && error.message.includes("not a git repository")) throw new SourceHashUnavailableError();
+		throw error;
+	}
+	const { stdout } = await execFileAsync$1("git", [
+		"ls-files",
+		"-z",
+		"--cached",
+		"--others",
+		"--exclude-standard"
+	], {
+		cwd: topLevel,
+		env,
+		maxBuffer: 67108864
+	});
+	const paths = [...new Set(stdout.split("\0").filter(Boolean))];
+	const present = (await Promise.all(paths.map(async (path) => {
+		const absolutePath = resolve(topLevel, path);
+		try {
+			const stat = await lstat(absolutePath);
+			if (stat.isFile()) return {
+				path,
+				kind: "file"
+			};
+			if (stat.isSymbolicLink()) return {
+				path,
+				kind: "link",
+				contentId: await readlink(absolutePath)
+			};
+			return;
+		} catch (error) {
+			if (isMissingPath(error)) return void 0;
+			throw error;
+		}
+	}))).filter((entry) => entry !== void 0);
+	const regularPaths = present.filter((entry) => entry.kind === "file").map((entry) => entry.path);
+	const hashes = await hashFiles(topLevel, regularPaths, env);
+	const contentIds = /* @__PURE__ */ new Map();
+	present.filter((entry) => entry.kind === "link").forEach((entry) => contentIds.set(entry.path, entry.contentId));
+	regularPaths.forEach((path, index) => contentIds.set(path, hashes[index]));
+	const appletsDirectory = relative(topLevel, resolve(workspaceRoot, "applets")).split(sep).join("/");
+	return new Map(appletRoots.map((appletRoot) => {
+		const appletDirectory = relative(topLevel, appletRoot).split(sep).join("/");
+		const digest = createHash("sha256");
+		[...contentIds.entries()].filter(([path]) => path !== appletsDirectory && !path.startsWith(`${appletsDirectory}/`) || path.startsWith(`${appletDirectory}/`)).sort(([left], [right]) => Buffer.compare(Buffer.from(left), Buffer.from(right))).forEach(([path, contentId]) => digest.update(`${path}\0${contentId}\n`));
+		return [appletRoot, digest.digest("hex")];
+	}));
+}
+//#endregion
+//#region src/deploy.ts
 const execFileAsync = promisify(execFile);
 var WorkspaceDeployError = class extends Error {
 	constructor(failedApplets) {
@@ -2363,9 +2465,6 @@ async function createBundle(distDir) {
 	body.set(bundle);
 	return body;
 }
-function gitEnvironment() {
-	return Object.fromEntries(Object.entries(process.env).filter(([key]) => !key.startsWith("GIT_")));
-}
 async function readGitInfo(appletRoot) {
 	const env = gitEnvironment();
 	try {
@@ -2399,13 +2498,14 @@ function releaseForm(manifest, bundle) {
 	body.set("bundle", new File([bundle], "bundle.tar.gz", { type: "application/gzip" }));
 	return body;
 }
-async function deployWithOrgAuth(appletRoot, distDir, manifest, options) {
-	const fetcher = options.fetch ?? globalThis.fetch;
+async function deployWithOrgAuth(appletRoot, distDir, manifest, sourceHash) {
+	const fetcher = globalThis.fetch;
 	const [bundle, git] = await Promise.all([createBundle(distDir), readGitInfo(appletRoot)]);
-	return fetchWithOrgAuth(manifest.org, options, (instanceUrl, accessToken) => {
+	return fetchWithOrgAuth(manifest.org, (instanceUrl, accessToken) => {
 		const body = releaseForm(manifest, bundle);
 		body.set("gitDirty", String(git.gitDirty));
 		if (git.gitSha !== void 0) body.set("gitSha", git.gitSha);
+		if (sourceHash !== void 0) body.set("sourceHash", sourceHash);
 		return fetcher(`${instanceUrl}/api/v1/applets/${manifest.code}/releases`, {
 			method: "POST",
 			headers: { Authorization: `Bearer ${accessToken}` },
@@ -2413,12 +2513,13 @@ async function deployWithOrgAuth(appletRoot, distDir, manifest, options) {
 		});
 	});
 }
-async function deployWithGitHubActions(context, appletRoot, distDir, manifest, options) {
-	const fetcher = options.fetch ?? globalThis.fetch;
+async function deployWithGitHubActions(context, appletRoot, distDir, manifest, sourceHash) {
+	const fetcher = globalThis.fetch;
 	const [bundle, sourceDirectory] = await Promise.all([createBundle(distDir), repositoryDirectory(appletRoot)]);
-	return fetchWithGitHubActions(context, options, (instanceUrl, accessToken) => {
+	return fetchWithGitHubActions(context, (instanceUrl, accessToken) => {
 		const body = releaseForm(manifest, bundle);
 		body.set("source_directory", sourceDirectory);
+		if (sourceHash !== void 0) body.set("source_hash", sourceHash);
 		return fetcher(`${instanceUrl}/api/ci/v1/applets/${manifest.code}/releases`, {
 			method: "POST",
 			headers: { Authorization: `Bearer ${accessToken}` },
@@ -2426,12 +2527,13 @@ async function deployWithGitHubActions(context, appletRoot, distDir, manifest, o
 		});
 	});
 }
-async function deployApplet(appletRoot, options, logPrefix = "") {
-	const github = githubActionsContext(options.store?.env ?? process.env);
+async function deployApplet(appletRoot, options, logPrefix = "", sourceHash) {
+	const github = githubActionsContext();
+	sourceHash ??= (await computeSourceHash([appletRoot], github !== void 0)).get(appletRoot);
 	if (options.dist === void 0) await buildApplet(appletRoot);
 	const distDir = resolve(appletRoot, options.dist ?? ".hitch/dist");
 	const manifest = await readManifest(distDir);
-	const response = github === void 0 ? await deployWithOrgAuth(appletRoot, distDir, manifest, options) : await deployWithGitHubActions(github, appletRoot, distDir, manifest, options);
+	const response = github === void 0 ? await deployWithOrgAuth(appletRoot, distDir, manifest, sourceHash) : await deployWithGitHubActions(github, appletRoot, distDir, manifest, sourceHash);
 	if (!response.ok) throw await hitchResponseError(response, "Deploy failed");
 	const result = await response.json();
 	console.log(`${logPrefix}Deployed release ${result.data.id} (${result.promoted ? "promoted" : "not promoted"}).`);
@@ -2452,95 +2554,44 @@ async function workspaceAppletRoots(workspaceRoot) {
 	if (roots.length === 0) throw new Error(`No applets were found under ${appletsDir}.`);
 	return roots;
 }
-async function gitChanged(topLevel, base, pathspecs, env) {
+async function computeSourceHash(appletRoots, required) {
 	try {
-		await execFileAsync("git", [
-			"diff",
-			"--quiet",
-			base,
-			"HEAD",
-			"--",
-			...pathspecs
-		], {
-			cwd: topLevel,
-			env
-		});
-		return false;
+		return await sourceHashes(appletRoots);
 	} catch (error) {
-		if (error instanceof Error && "code" in error && error.code === 1) return true;
+		if (!required && error instanceof SourceHashUnavailableError) return /* @__PURE__ */ new Map();
 		throw error;
 	}
 }
-async function hasCommit(topLevel, sha, env) {
-	const git = (args) => execFileAsync("git", args, {
-		cwd: topLevel,
-		env
-	});
-	return git([
-		"cat-file",
-		"-e",
-		`${sha}^{commit}`
-	]).catch(() => git([
-		"fetch",
-		"--depth=1",
-		"origin",
-		sha
-	])).then(() => true, () => false);
-}
-async function ciDeployDecisions(github, workspaceRoot, appletRoots, options) {
-	const env = gitEnvironment();
-	const [sources, { stdout: topLevelOutput }, directories] = await Promise.all([
-		loadGitHubActionsSources(github, options),
-		execFileAsync("git", ["rev-parse", "--show-toplevel"], {
-			cwd: workspaceRoot,
-			env
-		}),
-		Promise.all(appletRoots.map((appletRoot) => repositoryDirectory(appletRoot)))
-	]);
-	const topLevel = topLevelOutput.trim();
-	const appletsDirectory = relative(topLevel, resolve(workspaceRoot, "applets")).split(sep).join("/");
-	const baseByDirectory = new Map(sources.map((source) => [source.sourceDirectory, source.gitSha]));
-	const bases = new Set(directories.flatMap((directory) => baseByDirectory.get(directory) ?? []));
-	const sharedChanges = /* @__PURE__ */ new Map();
-	for (const base of bases) sharedChanges.set(base, await hasCommit(topLevel, base, env) ? await gitChanged(topLevel, base, [`:(exclude)${appletsDirectory}`], env) : void 0);
-	const decisions = await Promise.all(appletRoots.map(async (appletRoot, index) => {
-		const directory = directories[index];
-		const base = baseByDirectory.get(directory) ?? null;
-		if (base === null) return [appletRoot, {
-			deploy: true,
-			reason: "no CI release to compare"
-		}];
-		const short = base.slice(0, 7);
-		const sharedChanged = sharedChanges.get(base);
-		if (sharedChanged === void 0) return [appletRoot, {
-			deploy: true,
-			reason: `commit ${short} is not in the repository`
-		}];
-		if (await gitChanged(topLevel, base, [directory], env)) return [appletRoot, {
+async function ciDeployDecisions(github, appletRoots, hashes) {
+	const [sources, directories] = await Promise.all([loadGitHubActionsSources(github), Promise.all(appletRoots.map((appletRoot) => repositoryDirectory(appletRoot)))]);
+	const hashByDirectory = new Map(sources.map((source) => [source.sourceDirectory, source.sourceHash]));
+	return new Map(appletRoots.map((appletRoot, index) => {
+		const sourceHash = hashByDirectory.get(directories[index]);
+		if (sourceHash === null || sourceHash === void 0) return [appletRoot, {
 			deploy: true,
-			reason: `${directory} changed since ${short}`
+			reason: "no release with a source hash to compare"
 		}];
-		if (sharedChanged) return [appletRoot, {
+		if (sourceHash !== hashes.get(appletRoot)) return [appletRoot, {
 			deploy: true,
-			reason: `files outside ${appletsDirectory} changed since ${short}`
+			reason: "files changed since the current release"
 		}];
 		return [appletRoot, {
 			deploy: false,
-			reason: `no changes since ${short}`
+			reason: "no changes since the current release"
 		}];
 	}));
-	return new Map(decisions);
 }
 async function runDeploy(options) {
 	const root = process.cwd();
-	const github = githubActionsContext(options.store?.env ?? process.env);
+	const github = githubActionsContext();
 	if (existsSync(resolve(root, "applet.manifest.ts"))) {
 		await deployApplet(root, options);
 		return;
 	}
 	if (readWorkspaceConfig(root) === void 0) throw new Error("Run applet deploy in an applet folder or in the workspace root.");
 	const appletRoots = await workspaceAppletRoots(root);
-	const decisions = github === void 0 ? void 0 : await ciDeployDecisions(github, root, appletRoots, options);
+	const hashes = await computeSourceHash(appletRoots, github !== void 0);
+	const decisions = github === void 0 ? void 0 : await ciDeployDecisions(github, appletRoots, hashes);
 	const selectedRoots = appletRoots.filter((appletRoot) => {
 		const name = relative(root, appletRoot);
 		const decision = decisions?.get(appletRoot);
@@ -2554,14 +2605,14 @@ async function runDeploy(options) {
 	});
 	if (selectedRoots.length === 0) return;
 	if (options.dist === void 0) await prepareWorkspaceBuild(root, appletRoots);
-	const interactive = github === void 0 && (options.stdinIsTTY ?? process.stdin.isTTY === true);
+	const interactive = github === void 0 && process.stdin.isTTY === true;
 	const deploy = async (appletRoot) => {
 		const logPrefix = `[${relative(root, appletRoot)}] `;
 		if (options.dist === void 0) await buildPreparedApplet(appletRoot, ".hitch/dist", interactive ? "" : logPrefix);
 		await deployApplet(appletRoot, {
 			...options,
 			dist: options.dist ?? ".hitch/dist"
-		}, logPrefix);
+		}, logPrefix, hashes.get(appletRoot));
 	};
 	if (interactive) {
 		for (const appletRoot of selectedRoots) await deploy(appletRoot);

package/dist/email-DBTVhNB_.js

@@ -0,0 +1,62 @@
+import { oc } from "@orpc/contract";
+import { z } from "zod";
+//#region src/hitch/email.ts
+const emailTagKeySchema = z.string().regex(/^[A-Za-z][A-Za-z0-9_]{0,63}$/);
+const emailTagsSchema = z.record(emailTagKeySchema, z.string().min(1).max(200)).refine((tags) => Object.keys(tags).length <= 10);
+const createEmailPixelInputSchema = z.object({ tags: emailTagsSchema.optional() }).strict();
+const createEmailPixelOutputSchema = z.object({
+	id: z.uuid(),
+	url: z.url()
+});
+const getEmailTrackerInputSchema = z.object({ id: z.uuid() });
+const markEmailTrackerSentInputSchema = z.object({
+	id: z.uuid(),
+	sentAt: z.iso.datetime({ offset: true }).optional()
+}).strict();
+const markEmailTrackerSentBodySchema = z.object({ sentAt: z.iso.datetime({ offset: true }).optional() }).strict();
+const emailTrackerSchema = z.object({
+	id: z.uuid(),
+	url: z.url(),
+	tags: emailTagsSchema,
+	createdAt: z.iso.datetime(),
+	sentAt: z.iso.datetime().nullable(),
+	firstHitAt: z.iso.datetime().nullable(),
+	lastHitAt: z.iso.datetime().nullable()
+});
+const listEmailTrackersInputSchema = z.object({
+	filter: emailTagsSchema.optional(),
+	sentAt: z.object({
+		$gte: z.iso.datetime({ offset: true }).optional(),
+		$lt: z.iso.datetime({ offset: true }).optional()
+	}).strict().optional(),
+	cursor: z.uuid().optional(),
+	limit: z.number().int().min(1).max(200).optional()
+}).strict();
+const listEmailTrackersOutputSchema = z.object({
+	trackers: z.array(emailTrackerSchema),
+	nextCursor: z.uuid().nullable()
+});
+function emailContract(appletCode) {
+	const path = `/v1/applets/${encodeURIComponent(appletCode)}/email/tracking`;
+	return { tracking: {
+		createPixel: oc.route({
+			method: "POST",
+			path: `${path}/pixels`,
+			successStatus: 201
+		}).input(createEmailPixelInputSchema.optional()).output(createEmailPixelOutputSchema),
+		markSent: oc.route({
+			method: "POST",
+			path: `${path}/{id}/sent`
+		}).input(markEmailTrackerSentInputSchema).output(emailTrackerSchema),
+		get: oc.route({
+			method: "GET",
+			path: `${path}/{id}`
+		}).input(getEmailTrackerInputSchema).output(emailTrackerSchema),
+		list: oc.route({
+			method: "POST",
+			path: `${path}/list`
+		}).input(listEmailTrackersInputSchema.optional()).output(listEmailTrackersOutputSchema)
+	} };
+}
+//#endregion
+export { emailTagsSchema as a, listEmailTrackersInputSchema as c, markEmailTrackerSentInputSchema as d, emailTagKeySchema as i, listEmailTrackersOutputSchema as l, createEmailPixelOutputSchema as n, emailTrackerSchema as o, emailContract as r, getEmailTrackerInputSchema as s, createEmailPixelInputSchema as t, markEmailTrackerSentBodySchema as u };

package/dist/{generate-BIifT6PK.js → generate-BEIYs17x.js}

@@ -1,7 +1,7 @@
-import { l as resolveInstanceUrl, n as fetchWithOrgAuth, s as organizationInstanceUrl } from "./workspace-B6lenAS5.js";
-import { i as loadGitHubActionsBuildInputs, n as githubActionsContext } from "./ci-gPrwo6C0.js";
-import { t as loadAppletConfig } from "./load-config-BknBkdRs.js";
-import { r as prepareAppletProject } from "./project-C_rtpjp8.js";
+import { f as resolveInstanceUrl, l as organizationInstanceUrl, n as fetchWithOrgAuth } from "./workspace-D0dnnlxL.js";
+import { i as loadGitHubActionsBuildInputs, n as githubActionsContext } from "./ci-BKw14X2h.js";
+import { r as prepareAppletProject } from "./project-BRZGd6xq.js";
+import { t as loadAppletConfig } from "./load-config-xEdTXs0y.js";
 import { createRequire } from "node:module";
 import { existsSync } from "node:fs";
 import { access, mkdir, mkdtemp, readFile, readdir, rename, rm, writeFile } from "node:fs/promises";
@@ -55,7 +55,7 @@ export default createWorkerEntry(server, { code: ${JSON.stringify(appletCode)} }
 }
 //#endregion
 //#region src/typegen/operations.ts
-const RECORD_ROUTE = /^\/v1\/([^/]+)(?:\/(\{id\}|query|update|aggregate))?$/;
+const RECORD_ROUTE = /^\/v1\/([^/]+)(?:\/(\{id\}(?:\/history)?|query|update|aggregate))?$/;
 const COMPONENT_REF_PREFIX$1 = "#/components/schemas/";
 const BATCH_PATH = "/v1/batch";
 const BATCH_ITEM_PATH = "paths./v1/batch.post.requestBody.content.application/json.schema.properties.requests.items";
@@ -64,6 +64,7 @@ const VERBS = {
 	"get:": "list",
 	"post:": "create",
 	"get:{id}": "get",
+	"get:{id}/history": "history",
 	"patch:{id}": "update",
 	"delete:{id}": "delete",
 	"post:query": "query",
@@ -74,6 +75,7 @@ const COMPONENT_RESPONSE_STATUS = {
 	list: "200",
 	create: "201",
 	get: "200",
+	history: "200",
 	update: "200",
 	query: "200"
 };
@@ -149,10 +151,13 @@ function prepareBatchOperation(operation, manifest) {
 		if (manifest === void 0) return true;
 		const object = manifest.objects.find(({ code }) => code === objectCode);
 		if (object === void 0) return false;
-		if (verb === "create") return object.canCreate;
-		if (verb === "delete") return object.canDelete;
-		if (verb === "update" || verb === "updateWhere") return object.readWrite.length > 0;
-		return true;
+		switch (verb) {
+			case "create": return object.canCreate;
+			case "delete": return object.canDelete;
+			case "update":
+			case "updateWhere": return object.readWrite.length > 0;
+			default: return true;
+		}
 	});
 	if (entries.length === 0) return void 0;
 	items.oneOf = entries;
@@ -166,7 +171,7 @@ function prepareRecordSpec(spec, manifest) {
 	const prepared = structuredClone(spec);
 	prepared.paths = Object.fromEntries(Object.entries(prepared.paths).flatMap(([path, pathItem]) => {
 		if (path === BATCH_PATH) {
-			if (!isObject$2(pathItem) || pathItem.post === void 0) return [];
+			if (!isObject$2(pathItem)) return [];
 			const operation = prepareBatchOperation(pathItem.post, manifest);
 			return operation === void 0 ? [] : [[path, { post: operation }]];
 		}
@@ -194,6 +199,37 @@ function prepareRecordSpec(spec, manifest) {
 		});
 		return operations.length > 0 ? [[path, Object.fromEntries(operations)]] : [];
 	}));
+	manifest?.objects.forEach(({ code, optionalAttributes }) => {
+		if (optionalAttributes === void 0 || optionalAttributes.length === 0) return;
+		const responsePath = `/v1/${code}/{id}`;
+		const response = prepared.paths[responsePath]?.get?.responses;
+		const schema = isObject$2(response) && isObject$2(response["200"]) ? response["200"].content : void 0;
+		const mediaType = isObject$2(schema) && isObject$2(schema["application/json"]) ? schema["application/json"] : void 0;
+		const ref = isObject$2(mediaType) && isObject$2(mediaType.schema) ? mediaType.schema.$ref : void 0;
+		const recordPath = `paths.${responsePath}.get.responses.200.content.application/json.schema`;
+		if (typeof ref !== "string" || !ref.startsWith(COMPONENT_REF_PREFIX$1)) throw new Error(`object "${code}": ${recordPath} expected a component schema $ref, found ${describeValue$1(mediaType)}`);
+		const componentName = ref.slice(21);
+		const components = isObject$2(prepared.components) ? prepared.components : void 0;
+		const record = (isObject$2(components?.schemas) ? components.schemas : void 0)?.[componentName];
+		const componentPath = `components.schemas.${componentName}`;
+		if (!isObject$2(record) || !isObject$2(record.properties)) throw new Error(`object "${code}": ${componentPath}.properties expected an object, found ${describeValue$1(isObject$2(record) ? record.properties : record)}`);
+		const properties = record.properties;
+		optionalAttributes.forEach((attributeCode) => {
+			const property = properties[attributeCode];
+			const propertyPath = `${componentPath}.properties.${attributeCode}`;
+			if (!isObject$2(property)) throw new Error(`object "${code}": ${propertyPath} expected an object, found ${describeValue$1(property)}`);
+			const types = Array.isArray(property.type) ? property.type : [property.type];
+			properties[attributeCode] = property.type !== void 0 ? {
+				...property,
+				type: types.includes("null") ? types : [...types, "null"],
+				...Array.isArray(property.enum) && !property.enum.includes(null) ? { enum: [...property.enum, null] } : {}
+			} : Array.isArray(property.oneOf) ? {
+				...property,
+				oneOf: [...property.oneOf, { type: "null" }]
+			} : Array.isArray(property.anyOf) && property.anyOf.some((item) => isObject$2(item) && item.type === "null") ? property : { anyOf: [property, { type: "null" }] };
+		});
+		if (Array.isArray(record.required)) record.required = record.required.filter((name) => !optionalAttributes.includes(name));
+	});
 	return prepared;
 }
 function describeValue$1(value, expectedRef = false) {
@@ -274,7 +310,7 @@ ${Object.entries(catalog).map(([objectCode, attributeCodes]) => `  ${JSON.string
 };`;
 	return `// Generated by @hitch42/applet — do not edit.
 import type manifest from "./manifest.gen.ts";
-${options.hasServer ? "import type server from \"../src/server/main.ts\";\nimport type * as serverModule from \"../src/server/main.ts\";\n" : ""}${options.hasClient ? "import type { Route as indexRoute } from \"../src/client/routes/index.tsx\";\n" : ""}${options.hasServer ? "import type { AnyRouter } from \"@orpc/server\";\n" : ""}${options.hasClient ? "import type { AnyRoute } from \"@tanstack/react-router\";\n" : ""}${options.hasServer ? "import type { WorkflowDefinition } from \"@hitch42/applet/server\";\n" : ""}
+${options.hasServer ? "import type server from \"../src/server/main.ts\";\nimport type * as serverModule from \"../src/server/main.ts\";\n" : ""}${options.hasClient ? "import type { Route as indexRoute } from \"../src/client/routes/index.tsx\";\n" : ""}${options.hasServer ? "import type { AnyRouter } from \"@orpc/server\";\n" : ""}${options.hasClient ? "import type { AnyRoute } from \"@tanstack/react-router\";\n" : ""}${options.hasServer ? "import type { WorkflowDefinition } from \"@hitch42/applet/server\";\nimport type { TelephonyMessageReceivedEvent } from \"@hitch42/applet\";\n" : ""}
 ${catalogType}
 
 type Expect<T extends true> = T;
@@ -287,6 +323,7 @@ type _SrcServerMainMustDefaultExportRouterAndValidWorkflows = Expect<
   typeof server extends {
     router: AnyRouter;
     workflows?: Record<string, WorkflowDefinition<any, any>>;
+    telephony?: { onMessageReceived?: (event: TelephonyMessageReceivedEvent) => void | Promise<void> };
   }
     ? true
     : false
@@ -352,33 +389,31 @@ async function responseJson(response) {
 		throw new Error("Failed to parse the organization's OpenAPI spec.", { cause: error });
 	}
 }
-async function loadAuthenticatedSpec(manifest, options) {
-	const github = githubActionsContext(options.store?.env ?? process.env);
-	if (github !== void 0) return (await loadGitHubActionsBuildInputs(github, options, manifest.requiresChangeset)).openapi;
-	const fetcher = options.fetch ?? globalThis.fetch;
-	const response = await fetchWithOrgAuth(manifest.org, options, (instanceUrl, accessToken) => fetcher(`${instanceUrl}/api/v1/openapi.json${manifest.requiresChangeset === void 0 ? "" : `?changeset_id=${encodeURIComponent(manifest.requiresChangeset)}`}`, { headers: { Authorization: `Bearer ${accessToken}` } }));
+async function loadAuthenticatedSpec(manifest) {
+	const github = githubActionsContext();
+	if (github !== void 0) return (await loadGitHubActionsBuildInputs(github, manifest.requiresChangeset)).openapi;
+	const response = await fetchWithOrgAuth(manifest.org, (instanceUrl, accessToken) => globalThis.fetch(`${instanceUrl}/api/v1/openapi.json${manifest.requiresChangeset === void 0 ? "" : `?changeset_id=${encodeURIComponent(manifest.requiresChangeset)}`}`, { headers: { Authorization: `Bearer ${accessToken}` } }));
 	if (!response.ok) throw new Error(`Failed to load the organization's OpenAPI spec (${response.status}).`);
 	return responseJson(response);
 }
-async function loadThemeStylesheet(orgCode, options) {
-	const fetcher = options.fetch ?? globalThis.fetch;
-	const instanceUrl = await resolveInstanceUrl(void 0, options.store);
-	const response = await fetcher(`${organizationInstanceUrl(instanceUrl, orgCode)}/theme.css`);
+async function loadThemeStylesheet(orgCode) {
+	const instanceUrl = await resolveInstanceUrl();
+	const response = await globalThis.fetch(`${organizationInstanceUrl(instanceUrl, orgCode)}/theme.css`);
 	if (!response.ok) throw new Error(`Failed to load the organization's theme (${response.status}).`);
 	return response.text();
 }
-async function loadBuildInputs(manifest, options) {
-	const github = githubActionsContext(options.store?.env ?? process.env);
+async function loadBuildInputs(manifest) {
+	const github = githubActionsContext();
 	if (github !== void 0) {
-		const inputs = await loadGitHubActionsBuildInputs(github, options, manifest.requiresChangeset);
+		const inputs = await loadGitHubActionsBuildInputs(github, manifest.requiresChangeset);
 		return {
 			spec: inputs.openapi,
 			theme: inputs.theme
 		};
 	}
 	return {
-		spec: await loadAuthenticatedSpec(manifest, options),
-		theme: await loadThemeStylesheet(manifest.org, options)
+		spec: await loadAuthenticatedSpec(manifest),
+		theme: await loadThemeStylesheet(manifest.org)
 	};
 }
 async function generateContract(spec, outDir) {
@@ -420,16 +455,16 @@ async function writeContractFiles(outDir, manifest, spec) {
 	await writeManifestGen(outDir, manifest);
 	await writeRegisterDeclaration(outDir, catalog);
 	await writeFile(resolve(outDir, "index.ts"), `// Generated by applet generate — do not edit.
-import { filesContract as files, meContract as me, pruneContract, registerHitchContract, teamsContract as teams } from "@hitch42/applet";
+import { emailContract, filesContract as files, meContract as me, pruneContract, registerHitchContract, teamsContract as teams, telephonyContract as telephony } from "@hitch42/applet";
 import manifest from "./manifest.gen.ts";
 
 ${Object.hasOwn(preparedSpec.paths, "/v1/batch") ? `import { contract as generated } from "./orpc.gen.ts";
 
 const { batch, ...records } = generated;
 
-export const contract = { records, batch, files, me, teams } as const;` : `import { contract as records } from "./orpc.gen.ts";
+export const contract = { records, batch, email: emailContract(manifest.code), files, me, teams, telephony } as const;` : `import { contract as records } from "./orpc.gen.ts";
 
-export const contract = { records, files, me, teams } as const;`}
+export const contract = { records, email: emailContract(manifest.code), files, me, teams, telephony } as const;`}
 registerHitchContract(pruneContract(contract, manifest));
 
 declare module "@hitch42/applet" {
@@ -441,15 +476,18 @@ declare module "@hitch42/applet" {
 export type * from "./zod.gen.ts";
 `);
 }
-async function syncContract(outDir, manifest, options = {}) {
-	await writeContractFiles(outDir, manifest, await loadAuthenticatedSpec(manifest, options));
+async function syncContract(outDir, manifest) {
+	await writeContractFiles(outDir, manifest, manifest.objects.length === 0 ? {
+		paths: {},
+		components: { schemas: {} }
+	} : await loadAuthenticatedSpec(manifest));
 }
-async function runGenerate(options) {
+async function runGenerate() {
 	await prepareAppletProject();
 	const root = process.cwd();
 	const outDir = resolve("./.hitch");
 	const manifest = await loadAppletConfig(process.cwd());
-	const { spec, theme: themeStylesheet } = await loadBuildInputs(manifest, options);
+	const { spec, theme: themeStylesheet } = await loadBuildInputs(manifest);
 	const stagedDir = await mkdtemp(resolve("./.hitch.tmp-"));
 	const backupDir = `${stagedDir}.backup`;
 	let staged = true;

package/dist/generate-Dox-OYt6.js

@@ -0,0 +1,2 @@
+import { n as runGenerate } from "./generate-BEIYs17x.js";
+export { runGenerate };

package/dist/headers-DkNr9MLJ.js

@@ -0,0 +1,17 @@
+//#region src/headers.ts
+const HITCH_USER_HEADER = "x-hitch-user";
+const HITCH_SESSION_HEADER = "x-hitch-session";
+const HITCH_APPLET_HEADER = "x-hitch-applet";
+const HITCH_APPLET_CODE_HEADER = "x-hitch-applet-code";
+const HITCH_APPLET_TOKEN_HEADER = "x-hitch-applet-token";
+const HITCH_SCHEDULE_RUN_HEADER = "x-hitch-schedule-run";
+const HITCH_SCHEDULE_HEADER = "x-hitch-schedule";
+const HITCH_ORG_CODE_HEADER = "x-hitch-org-code";
+const HITCH_ORGANIZATION_HEADER = "x-hitch-organization";
+const HITCH_RELEASE_HEADER = "x-hitch-release";
+const HITCH_REQUEST_HOST_HEADER = "x-hitch-request-host";
+const HITCH_WORKFLOW_RUN_HEADER = "x-hitch-workflow-run";
+const HITCH_WORKFLOW_HEADER = "x-hitch-workflow";
+const HITCH_WORKFLOW_INVOCATION_HEADER = "x-hitch-workflow-invocation";
+//#endregion
+export { HITCH_ORG_CODE_HEADER as a, HITCH_SCHEDULE_HEADER as c, HITCH_USER_HEADER as d, HITCH_WORKFLOW_HEADER as f, HITCH_ORGANIZATION_HEADER as i, HITCH_SCHEDULE_RUN_HEADER as l, HITCH_WORKFLOW_RUN_HEADER as m, HITCH_APPLET_HEADER as n, HITCH_RELEASE_HEADER as o, HITCH_WORKFLOW_INVOCATION_HEADER as p, HITCH_APPLET_TOKEN_HEADER as r, HITCH_REQUEST_HOST_HEADER as s, HITCH_APPLET_CODE_HEADER as t, HITCH_SESSION_HEADER as u };