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

package/dist/telephony.js

@@ -28,9 +28,12 @@ const createTelephonyApi = (baseUrl = location.origin) => {
 		return response.json();
 	};
 	return {
-		token: (deviceKey) => request("voice/token", {
+		token: (deviceKey, acceptsCalls) => request("voice/token", {
 			method: "POST",
-			body: JSON.stringify({ deviceKey })
+			body: JSON.stringify({
+				deviceKey,
+				acceptsCalls
+			})
 		}),
 		startCall: (numberId, to) => request("calls", {
 			method: "POST",
@@ -165,14 +168,18 @@ const DEVICE_KEY = "hitch:telephony:device";
 let singleton;
 var Phone = class {
 	state = {
+		owner: false,
 		status: "off",
 		error: null,
+		incoming: null,
 		active: null
 	};
 	listeners = /* @__PURE__ */ new Set();
 	api;
 	client = null;
 	currentCall = null;
+	incomingCall = null;
+	acceptsCalls;
 	connectPromise = null;
 	releaseLock = null;
 	lockAbortController = null;
@@ -186,8 +193,11 @@ var Phone = class {
 	audio = null;
 	firstLogin = true;
 	callStarting = false;
+	reconnectOnPageShow = false;
+	connectionRequested = false;
 	constructor(options = {}) {
 		this.api = createTelephonyApi(options.baseUrl);
+		this.acceptsCalls = options.acceptsCalls ?? false;
 	}
 	subscribe = (listener) => {
 		this.listeners.add(listener);
@@ -248,6 +258,7 @@ var Phone = class {
 		};
 	}
 	connect = () => {
+		this.connectionRequested = true;
 		this.connectPromise ??= this.connectInternal().finally(() => {
 			this.connectPromise = null;
 		});
@@ -255,6 +266,8 @@ var Phone = class {
 	};
 	async connectInternal() {
 		if (this.state.status === "ready") return;
+		window.addEventListener("pagehide", this.pageHide);
+		window.addEventListener("pageshow", this.pageShow);
 		this.channel ??= new BroadcastChannel("hitch:telephony");
 		this.channel.onmessage = this.onChannelMessage;
 		this.update({
@@ -275,8 +288,10 @@ var Phone = class {
 					});
 					this.ownsPhone = true;
 					this.update({
+						owner: true,
 						status: "connecting",
 						error: null,
+						incoming: null,
 						active: null
 					});
 					await this.connectOwned();
@@ -297,6 +312,7 @@ var Phone = class {
 			return;
 		}
 		this.ownsPhone = true;
+		this.update({ owner: true });
 		await this.connectOwned();
 	}
 	async connectOwned() {
@@ -311,7 +327,7 @@ var Phone = class {
 				8e3
 			]) {
 				if (delay) await new Promise((resolve) => setTimeout(resolve, delay));
-				const { token } = await this.api.token(deviceKey);
+				const { token } = await this.api.token(deviceKey, this.acceptsCalls);
 				const { TelnyxRTC: Client } = await import("@telnyx/webrtc");
 				const client = new Client({
 					login_token: token,
@@ -320,15 +336,35 @@ var Phone = class {
 				this.client = client;
 				client.on("telnyx.notification", ({ type, call }) => {
 					if (type !== "callUpdate" || !call) return;
-					if (call.direction === "inbound") {
-						call.hangup();
+					if (call === this.currentCall) {
+						this.onCallUpdate(call);
+						return;
+					}
+					if (call.direction !== "inbound") return;
+					if ([
+						"hangup",
+						"destroy",
+						"purge"
+					].includes(call.state)) {
+						if (call === this.incomingCall) {
+							this.incomingCall = null;
+							this.update({ incoming: null });
+						}
+						return;
+					}
+					if (!this.acceptsCalls || this.currentCall || this.callStarting || this.incomingCall && this.incomingCall !== call) {
+						call.hangup().catch((error) => console.error("Call decline failed", error));
 						return;
 					}
-					if (call === this.currentCall) this.onCallUpdate(call);
+					this.incomingCall = call;
+					if (call.state === "ringing") this.update({ incoming: {
+						id: call.id,
+						from: call.options.remoteCallerNumber ?? ""
+					} });
 				});
 				client.on("telnyx.warning", (warning) => {
 					if (Number(warning.warning.code) !== 34001) return;
-					this.api.token(deviceKey).then(({ token: nextToken }) => client.login({ creds: { login_token: nextToken } })).catch((error) => {
+					this.api.token(deviceKey, this.acceptsCalls).then(({ token: nextToken }) => client.login({ creds: { login_token: nextToken } })).catch((error) => {
 						console.error("Phone token renewal failed", error);
 						this.update({ error: String(error) });
 					});
@@ -341,7 +377,6 @@ var Phone = class {
 					});
 					this.firstLogin = false;
 					this.update({ status: "ready" });
-					window.addEventListener("pagehide", this.disconnect);
 					return;
 				} catch (error) {
 					await client.disconnect().catch((disconnectError) => console.error("Phone disconnect failed", disconnectError));
@@ -351,6 +386,7 @@ var Phone = class {
 			}
 		} catch (error) {
 			this.update({
+				owner: false,
 				status: "error",
 				error: error instanceof Error ? error.message : String(error)
 			});
@@ -360,13 +396,16 @@ var Phone = class {
 		}
 	}
 	disconnect = () => {
+		this.connectionRequested = false;
 		this.lockAbortController?.abort();
 		this.lockAbortController = null;
 		this.connectResolve?.();
 		this.connectResolve = null;
 		if (this.pollTimer) clearTimeout(this.pollTimer);
 		this.pollTimer = null;
-		window.removeEventListener("pagehide", this.disconnect);
+		window.removeEventListener("pagehide", this.pageHide);
+		window.removeEventListener("pageshow", this.pageShow);
+		this.reconnectOnPageShow = false;
 		window.removeEventListener("beforeunload", this.beforeUnload);
 		this.client?.disconnect().catch((error) => console.error("Phone disconnect failed", error));
 		this.client = null;
@@ -377,20 +416,35 @@ var Phone = class {
 		this.pendingCommands.clear();
 		this.releaseLock?.();
 		this.releaseLock = null;
+		this.currentCall = null;
+		this.incomingCall = null;
 		this.update({
+			owner: false,
 			status: "off",
+			incoming: null,
 			active: null
 		});
 		this.ownsPhone = false;
 		this.channel?.close();
 		this.channel = null;
 	};
+	pageHide = () => {
+		const reconnect = this.connectionRequested;
+		this.disconnect();
+		this.reconnectOnPageShow = reconnect;
+		if (reconnect) window.addEventListener("pageshow", this.pageShow);
+	};
+	pageShow = (event) => {
+		if (!event.persisted || !this.reconnectOnPageShow) return;
+		this.reconnectOnPageShow = false;
+		this.connect();
+	};
 	beforeUnload = (event) => {
 		event.preventDefault();
 		event.returnValue = "";
 	};
 	call = async ({ numberId, to }) => {
-		if (this.callStarting || this.state.active) throw new Error("A call is already in progress.");
+		if (this.callStarting || this.state.active || this.incomingCall || this.state.incoming) throw new Error("A call is already in progress.");
 		if (this.state.status !== "ready") throw new Error("The phone is not ready.");
 		if (!this.ownsPhone) return this.sendCommand("call", {
 			numberId,
@@ -417,6 +471,7 @@ var Phone = class {
 			this.update({
 				error: null,
 				active: {
+					direction: "outbound",
 					callId,
 					to,
 					from: callerNumber,
@@ -432,6 +487,62 @@ var Phone = class {
 			this.callStarting = false;
 		}
 	};
+	answer = async () => {
+		if (!this.state.incoming) throw new Error("There is no incoming call.");
+		if (!this.ownsPhone) return this.sendCommand("answer", this.state.incoming.id);
+		const call = this.incomingCall;
+		if (!call) throw new Error("There is no incoming call.");
+		if (!this.client) throw new Error("The phone is not ready.");
+		this.audio ??= document.createElement("audio");
+		this.audio.autoplay = true;
+		this.audio.hidden = true;
+		if (!this.audio.isConnected) document.body.append(this.audio);
+		this.client.remoteElement = this.audio;
+		call.options.remoteElement = this.audio;
+		this.currentCall = call;
+		this.incomingCall = null;
+		this.update({
+			incoming: null,
+			error: null,
+			active: {
+				direction: "inbound",
+				from: this.state.incoming.from,
+				state: "connecting",
+				muted: false,
+				startedAt: Date.now(),
+				recording: false
+			}
+		});
+		window.addEventListener("beforeunload", this.beforeUnload);
+		try {
+			await call.answer();
+		} catch (error) {
+			if (this.currentCall === call) {
+				this.currentCall = null;
+				this.incomingCall = call;
+				this.update({
+					active: null,
+					incoming: {
+						id: call.id,
+						from: call.options.remoteCallerNumber ?? ""
+					}
+				});
+				window.removeEventListener("beforeunload", this.beforeUnload);
+			}
+			throw error;
+		}
+	};
+	decline = async () => {
+		if (!this.state.incoming) throw new Error("There is no incoming call.");
+		if (!this.ownsPhone) return this.sendCommand("decline", this.state.incoming.id);
+		const call = this.incomingCall;
+		if (!call) throw new Error("There is no incoming call.");
+		await call.hangup();
+		if (this.incomingCall === call) {
+			this.incomingCall = null;
+			this.update({ incoming: null });
+		}
+	};
 	sendCommand(action, value) {
 		const id = crypto.randomUUID();
 		return new Promise((resolve, reject) => {
@@ -462,7 +573,10 @@ var Phone = class {
 		else if (data.type === "state" && !this.ownsPhone && "state" in data) {
 			const state = data.state;
 			if (typeof state !== "object" || state === null || !("status" in state)) return;
-			this.state = state;
+			this.state = {
+				...state,
+				owner: false
+			};
 			this.listeners.forEach((listener) => listener());
 			this.connectResolve?.();
 			this.connectResolve = null;
@@ -483,6 +597,10 @@ var Phone = class {
 		}));
 	};
 	async runCommand(data) {
+		if (data.action === "answer" || data.action === "decline") {
+			if (!this.incomingCall || data.value !== this.incomingCall.id) throw new Error("That call is no longer ringing.");
+			return data.action === "answer" ? this.answer() : this.decline();
+		}
 		if (data.action === "call") {
 			const value = data.value;
 			if (!value || typeof value !== "object" || !("numberId" in value) || !("to" in value) || typeof value.numberId !== "string" || typeof value.to !== "string") throw new Error("Invalid call command.");
@@ -518,7 +636,7 @@ var Phone = class {
 		}
 	}
 	async pollCall(callId) {
-		if (this.state.active?.callId !== callId || this.state.active.state === "active") return;
+		if (this.state.active?.direction !== "outbound" || this.state.active.callId !== callId || this.state.active.state === "active") return;
 		try {
 			const { status } = await this.api.getCall(callId);
 			if ([
@@ -533,7 +651,8 @@ var Phone = class {
 		} catch (error) {
 			console.error("Call status check failed", error);
 		}
-		if (this.getSnapshot().active?.callId === callId) this.pollTimer = setTimeout(() => void this.pollCall(callId), 1e4);
+		const active = this.getSnapshot().active;
+		if (active?.direction === "outbound" && active.callId === callId) this.pollTimer = setTimeout(() => void this.pollCall(callId), 1e4);
 	}
 	onCallUpdate(call) {
 		const active = this.state.active;
@@ -562,15 +681,15 @@ var Phone = class {
 			return;
 		}
 		const mapped = state === "active" ? "active" : state === "held" ? "held" : state === "ringing" ? "ringing" : "connecting";
-		if (mapped === "active" && active.recording && !this.stopRecording && !this.recordingPromise) {
+		if (mapped === "active" && active.direction === "outbound" && active.recording && !this.stopRecording && !this.recordingPromise) {
 			this.recordingPromise = startRecording(active.callId, call, this.api, (error) => {
 				console.error("Call recording failed", error);
-				if (this.state.active?.callId === active.callId) this.update({ active: {
+				if (this.state.active?.direction === "outbound" && this.state.active.callId === active.callId) this.update({ active: {
 					...this.state.active,
 					recording: false
 				} });
 			}).then((stop) => {
-				if (this.state.active?.callId === active.callId) this.stopRecording = stop;
+				if (this.state.active?.direction === "outbound" && this.state.active.callId === active.callId) this.stopRecording = stop;
 				return stop;
 			});
 			this.recordingPromise.catch((error) => {

package/dist/{upload-YbRKEqR6.d.ts → upload-DKZzz5kW.d.ts}

@@ -36,13 +36,13 @@ type FileOutput = {
   data: HitchFile;
   downloadUrl: string;
 };
-declare const fileSchema: z.ZodType<HitchFile>;
-declare const createFileOutputSchema: z.ZodType<CreateFileOutput>;
-declare const getFileOutputSchema: z.ZodType<FileOutput>;
+declare const fileSchema: z.ZodType<HitchFile, HitchFile>;
+declare const createFileOutputSchema: z.ZodType<CreateFileOutput, CreateFileOutput>;
+declare const getFileOutputSchema: z.ZodType<FileOutput, FileOutput>;
 type FilesContract = {
-  create: ContractProcedure<z.ZodType<CreateFileInput>, z.ZodType<CreateFileOutput>, Record<never, never>, Meta>;
-  confirm: ContractProcedure<z.ZodType<FileIdInput>, z.ZodType<FileOutput>, Record<never, never>, Meta>;
-  get: ContractProcedure<z.ZodType<FileIdInput>, z.ZodType<FileOutput>, Record<never, never>, Meta>;
+  create: ContractProcedure<z.ZodType<CreateFileInput, CreateFileInput>, z.ZodType<CreateFileOutput, CreateFileOutput>, Record<never, never>, Meta>;
+  confirm: ContractProcedure<z.ZodType<FileIdInput, FileIdInput>, z.ZodType<FileOutput, FileOutput>, Record<never, never>, Meta>;
+  get: ContractProcedure<z.ZodType<FileIdInput, FileIdInput>, z.ZodType<FileOutput, FileOutput>, Record<never, never>, Meta>;
 };
 declare const filesContract: FilesContract;
 //#endregion

package/dist/{variables-Bwnr7oxf.js → variables-DT5RyHdH.js}

@@ -1,5 +1,5 @@
-import { n as fetchWithOrgAuth } from "./workspace-XVtM12ZC.js";
-import { t as loadAppletConfig } from "./load-config-BYSxDVAl.js";
+import { n as fetchWithOrgAuth } from "./workspace-D0dnnlxL.js";
+import { t as loadAppletConfig } from "./load-config-xEdTXs0y.js";
 import { t as question } from "./prompt-ChS-grYO.js";
 import { z } from "zod";
 //#region src/variables.ts
@@ -14,12 +14,12 @@ const variableResponseSchema = z.object({ data: variableRowSchema });
 const variablesResponseSchema = z.object({ data: z.array(variableRowSchema) });
 async function getValue(options) {
 	if (options.value !== void 0) return options.value;
-	if (!(options.stdinIsTTY ?? process.stdin.isTTY === true)) throw new Error("A value is required when stdin is not a TTY.");
+	if (process.stdin.isTTY !== true) throw new Error("A value is required when stdin is not a TTY.");
 	return question("Value: ", true);
 }
 async function confirmLiveChange(code, options) {
 	if (options.yes === true) return;
-	if (!(options.stdinIsTTY ?? process.stdin.isTTY === true)) throw new Error("Confirmation requires a TTY. Pass -y to continue.");
+	if (process.stdin.isTTY !== true) throw new Error("Confirmation requires a TTY. Pass -y to continue.");
 	const answer = await question(`This modifies the live applet "${code}". Continue? [y/N] `);
 	if (!["y", "yes"].includes(answer.trim().toLowerCase())) throw new Error("Variable change cancelled.");
 }
@@ -45,19 +45,19 @@ function variablesError(status, code, message) {
 	const details = [code, message].filter((value) => value !== void 0).join(": ");
 	return /* @__PURE__ */ new Error(`Variables request failed (${status})${details ? `: ${details}` : ""}.`);
 }
-async function requestForApplet(options, request) {
+async function requestForApplet(request) {
 	const { code, org } = await loadAppletConfig(process.cwd());
 	return {
 		code,
-		response: await fetchWithOrgAuth(org, options, (instanceUrl, accessToken) => request(instanceUrl, accessToken, code))
+		response: await fetchWithOrgAuth(org, (instanceUrl, accessToken) => request(instanceUrl, accessToken, code))
 	};
 }
 async function runVariablesSet(options) {
 	const value = await getValue(options);
 	const manifest = await loadAppletConfig(process.cwd());
 	await confirmLiveChange(manifest.code, options);
-	const fetcher = options.fetch ?? globalThis.fetch;
-	const response = await fetchWithOrgAuth(manifest.org, options, (instanceUrl, accessToken) => fetcher(`${instanceUrl}/api/v1/applets/${encodeURIComponent(manifest.code)}/variables/${encodeURIComponent(options.key)}`, {
+	const fetcher = globalThis.fetch;
+	const response = await fetchWithOrgAuth(manifest.org, (instanceUrl, accessToken) => fetcher(`${instanceUrl}/api/v1/applets/${encodeURIComponent(manifest.code)}/variables/${encodeURIComponent(options.key)}`, {
 		method: "PUT",
 		headers: {
 			Authorization: `Bearer ${accessToken}`,
@@ -75,9 +75,9 @@ async function runVariablesSet(options) {
 	const { data } = variableResponseSchema.parse(await response.json());
 	console.log(`Set ${data.key} ${data.secret ? "(secret)" : data.value ?? value} for applet "${manifest.code}".`);
 }
-async function runVariablesList(options) {
-	const fetcher = options.fetch ?? globalThis.fetch;
-	const { code, response } = await requestForApplet(options, (instanceUrl, accessToken, appletCode) => fetcher(`${instanceUrl}/api/v1/applets/${encodeURIComponent(appletCode)}/variables`, { headers: { Authorization: `Bearer ${accessToken}` } }));
+async function runVariablesList() {
+	const fetcher = globalThis.fetch;
+	const { code, response } = await requestForApplet((instanceUrl, accessToken, appletCode) => fetcher(`${instanceUrl}/api/v1/applets/${encodeURIComponent(appletCode)}/variables`, { headers: { Authorization: `Bearer ${accessToken}` } }));
 	if (!response.ok) {
 		const { code: errorCode, message } = await readErrorDetails(response);
 		throw variablesError(response.status, errorCode, message);
@@ -92,8 +92,8 @@ async function runVariablesList(options) {
 async function runVariablesDelete(options) {
 	const manifest = await loadAppletConfig(process.cwd());
 	await confirmLiveChange(manifest.code, options);
-	const fetcher = options.fetch ?? globalThis.fetch;
-	const response = await fetchWithOrgAuth(manifest.org, options, (instanceUrl, accessToken) => fetcher(`${instanceUrl}/api/v1/applets/${encodeURIComponent(manifest.code)}/variables/${encodeURIComponent(options.key)}`, {
+	const fetcher = globalThis.fetch;
+	const response = await fetchWithOrgAuth(manifest.org, (instanceUrl, accessToken) => fetcher(`${instanceUrl}/api/v1/applets/${encodeURIComponent(manifest.code)}/variables/${encodeURIComponent(options.key)}`, {
 		method: "DELETE",
 		headers: { Authorization: `Bearer ${accessToken}` }
 	}));

package/dist/vite.d.ts

@@ -1,63 +1,6 @@
-import { o as RegisteredAppletSourceDefinition } from "./manifest-DD_SGkS6.js";
+import { o as RegisteredAppletSourceDefinition } from "./manifest-C6_F4bL8.js";
 import { PluginOption } from "vite";
-//#region ../shared/auth/src/store.d.mts
-interface SessionCredentials {
-  type: "session";
-  accessToken: string;
-  expiresAt?: number;
-  organizationId: string;
-  orgCode: string;
-}
-interface StoreOptions {
-  env?: NodeJS.ProcessEnv;
-  homeDir?: string;
-}
-//#endregion
-//#region ../shared/auth/src/device.d.mts
-interface MeResponse {
-  memberships: Array<{
-    code: string;
-    name: string;
-    orgId: string;
-  }>;
-  organization: {
-    code: string;
-    id: string;
-  } | null;
-  person: {
-    email: string;
-    firstName: string;
-    id: string;
-    lastName: string;
-  };
-}
-interface DeviceLoginOptions {
-  expectedOrg?: string;
-  fetch?: typeof fetch;
-  noBrowser?: boolean;
-  now?: () => number;
-  openUrl?: (url: string) => void | Promise<void>;
-  print?: (message: string) => void;
-  sleep?: (milliseconds: number) => Promise<void>;
-  store?: StoreOptions;
-}
-interface DeviceLoginResult {
-  credentials: SessionCredentials;
-  me: MeResponse;
-  membership: MeResponse["memberships"][number];
-}
-declare function loginWithDevice(instanceUrl: string, options?: DeviceLoginOptions): Promise<DeviceLoginResult>;
-//#endregion
-//#region src/auth.d.ts
-interface OrgAuthOptions {
-  fetch?: typeof fetch;
-  login?: typeof loginWithDevice;
-  stdinIsTTY?: boolean;
-  store?: StoreOptions;
-}
-//#endregion
 //#region src/vite.d.ts
-type AppletOptions = OrgAuthOptions;
-declare function applet<const M extends RegisteredAppletSourceDefinition>(sourceDefinition: M, options?: AppletOptions): PluginOption[];
+declare function applet<const M extends RegisteredAppletSourceDefinition>(sourceDefinition: M): PluginOption[];
 //#endregion
-export { AppletOptions, applet };
+export { applet };

package/dist/vite.js

@@ -1,8 +1,10 @@
 import { n as meSchema } from "./me-BW7Paary.js";
-import { i as APPLET_CODE_PATTERN, n as appletManifestSchema, r as appletSourceDefinitionSchema } from "./manifest-Bp87Uz0a.js";
-import { a as workflowOutcomeSchema, c as HITCH_SESSION_HEADER, l as HITCH_USER_HEADER, n as runWorkflowJournal } from "./workflow-engine-MogejNfF.js";
-import { c as organizationInstanceUrl, d as resolveInstanceUrl, l as rejectEnvironmentKey, s as bearerToken, t as resolveWorkspaceOrg, u as resolveAuthForOrg } from "./workspace-XVtM12ZC.js";
-import { c as writeClientEntry, i as writeRegisterDeclaration, l as writeManifestGen, r as syncContract, s as writeAppletRoot, u as writeServerEntry } from "./generate-BxYHdoAQ.js";
+import { i as APPLET_CODE_PATTERN, n as appletManifestSchema, r as appletSourceDefinitionSchema } from "./manifest-CJSL9GuC.js";
+import { a as openQueryCacheDatabase } from "./query-cache-CXmAyLv3.js";
+import { d as HITCH_USER_HEADER, u as HITCH_SESSION_HEADER } from "./headers-DkNr9MLJ.js";
+import { a as workflowOutcomeSchema, n as runWorkflowJournal } from "./workflow-engine-BOTzURKM.js";
+import { c as bearerToken, d as resolveAuthForOrg, f as resolveInstanceUrl, l as organizationInstanceUrl, t as resolveWorkspaceOrg, u as rejectEnvironmentKey } from "./workspace-D0dnnlxL.js";
+import { c as writeClientEntry, i as writeRegisterDeclaration, l as writeManifestGen, r as syncContract, s as writeAppletRoot, u as writeServerEntry } from "./generate-BEIYs17x.js";
 import { randomUUID } from "node:crypto";
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { appendFile, readdir, rm, writeFile } from "node:fs/promises";
@@ -52,7 +54,7 @@ function createDevProxy(options) {
 		[...headers.keys()].filter((name) => REQUEST_DROP.has(name) || name.startsWith("x-hitch-")).forEach((name) => headers.delete(name));
 		headers.set("authorization", `Bearer ${options.token}`);
 		const url = new URL(request.url);
-		const upstream = await (options.fetch ?? globalThis.fetch)(`${options.orgUrl}${url.pathname}${url.search}`, {
+		const upstream = await globalThis.fetch(`${options.orgUrl}${url.pathname}${url.search}`, {
 			method: request.method,
 			headers,
 			body: request.body,
@@ -317,6 +319,20 @@ function clientBootstrapScript(parentOrigin, appletCode) {
       : null
   });
 
+  // Opened here so it is ready by the time the applet module restores its
+  // query cache. A failure is reported when the module reads the promise.
+  Object.defineProperty(window, "__hitchCacheDatabase", {
+    configurable: false,
+    writable: false,
+    value: window.parent !== window && parentOrigin !== null
+      ? (function () {
+          var database = (${openQueryCacheDatabase.toString()})();
+          database.catch(function () {});
+          return database;
+        })()
+      : null
+  });
+
   function applyTheme(theme) {
     document.documentElement.classList.toggle("dark", theme === "dark");
   }
@@ -421,7 +437,7 @@ function clientBootstrapScript(parentOrigin, appletCode) {
   });
 })();`;
 }
-function applet(sourceDefinition, options = {}) {
+function applet(sourceDefinition) {
 	const parsedSourceDefinition = appletSourceDefinitionSchema.safeParse(sourceDefinition);
 	if (!parsedSourceDefinition.success) {
 		const raw = sourceDefinition;
@@ -458,7 +474,7 @@ function applet(sourceDefinition, options = {}) {
 		const routesDirectory = resolve(resolvedRoot, "src/client/routes");
 		const hasClient = existsSync(routesDirectory);
 		const hasServer = existsSync(resolve(resolvedRoot, "src/server/main.ts"));
-		if (!hasServer && parsedDefinition.data.telephony?.events.length) throw new Error("An applet with telephony events must have src/server/main.ts.");
+		if (!hasServer && parsedDefinition.data.telephony?.events?.length) throw new Error("An applet with telephony events must have src/server/main.ts.");
 		if (!hasServer && (parsedDefinition.data.schedules?.length ?? 0) > 0) throw new Error("An applet with schedules must have src/server/main.ts.");
 		const legacyMain = resolve(resolvedRoot, "src/client/main.tsx");
 		const indexHtml = resolve(resolvedRoot, "index.html");
@@ -489,6 +505,11 @@ function applet(sourceDefinition, options = {}) {
 		org: resolveWorkspaceOrg(callerRoot),
 		...parsedDefinition.data
 	});
+	const clsxFromCn = {
+		name: "hitch-clsx",
+		resolveId: (id) => id === "clsx" ? "\0hitch:clsx" : void 0,
+		load: (id) => id === "\0hitch:clsx" ? "export { clsx, clsx as default } from \"cn\";" : void 0
+	};
 	const orchestrator = {
 		name: "hitch-applet",
 		enforce: "pre",
@@ -508,9 +529,9 @@ function applet(sourceDefinition, options = {}) {
 				});
 				clearedOutDir = true;
 			}
-			if (environment.command === "build") themeStylesheetUrl = `${organizationInstanceUrl(await resolveInstanceUrl(void 0, options.store), manifest.org)}/theme.css`;
-			if (environment.command === "build" && manifest.objects.length > 0) {
-				contractSync ??= syncContract(resolve(root, ".hitch"), manifest, options);
+			if (environment.command === "build") themeStylesheetUrl = `${organizationInstanceUrl(await resolveInstanceUrl(), manifest.org)}/theme.css`;
+			if (environment.command === "build") {
+				contractSync ??= syncContract(resolve(root, ".hitch"), manifest);
 				await contractSync;
 			}
 			const hasHitchGen = existsSync(resolve(root, ".hitch/index.ts"));
@@ -526,12 +547,12 @@ function applet(sourceDefinition, options = {}) {
 				hasHitchGen ? void 0 : writeRegisterDeclaration(resolve(root, ".hitch"))
 			]);
 			if (environment.command === "serve" && environment.mode !== "test" && environment.isPreview !== true) {
-				const instanceUrl = await resolveInstanceUrl(void 0, options.store);
+				const instanceUrl = await resolveInstanceUrl();
 				const orgUrl = organizationInstanceUrl(instanceUrl, manifest.org);
-				const auth = await resolveAuthForOrg(instanceUrl, manifest.org, options.store);
+				const auth = await resolveAuthForOrg(instanceUrl, manifest.org);
 				if (auth === void 0) throw new Error("Not logged in. Run applet login.");
 				const token = bearerToken(auth);
-				const meResponse = await (options.fetch ?? globalThis.fetch)(`${orgUrl}/api/v1/me`, { headers: { authorization: `Bearer ${token}` } });
+				const meResponse = await globalThis.fetch(`${orgUrl}/api/v1/me`, { headers: { authorization: `Bearer ${token}` } });
 				rejectEnvironmentKey(meResponse, auth);
 				if (meResponse.status === 401) throw new Error("Your login expired. Run applet login.");
 				if (!meResponse.ok) throw new Error(`Hitch returned ${meResponse.status} for /api/v1/me.`);
@@ -540,7 +561,6 @@ function applet(sourceDefinition, options = {}) {
 					orgUrl,
 					token,
 					source: auth.source,
-					fetch: options.fetch,
 					warn: (message) => devLogger?.warn(message),
 					intercept: (request) => devWorkflows?.handle(request)
 				});
@@ -585,8 +605,18 @@ function applet(sourceDefinition, options = {}) {
 					}
 				}
 			}
+			if (environment.mode === "test") {
+				const colocated = (await readdir(resolve(root, "src"), { recursive: true })).filter((path) => /\.(test|spec)\.[cm]?[jt]sx?$/.test(path));
+				if (colocated.length > 0) throw new Error(`Applet tests run only from the test folder. Move ${colocated.map((path) => `src/${path}`).join(", ")} to test/.`);
+			}
 			return {
 				base: `/${manifest.code}/`,
+				test: { include: ["test/**/*.test.{ts,tsx}"] },
+				resolve: { alias: {
+					"clsx/lite": "cn/lite",
+					"tailwind-merge": "cn"
+				} },
+				optimizeDeps: { rolldownOptions: { plugins: [clsxFromCn] } },
 				...hasServer && { environments: { worker: { build: { rollupOptions: { output: { codeSplitting: false } } } } } }
 			};
 		},
@@ -777,9 +807,14 @@ function applet(sourceDefinition, options = {}) {
 		...plugin,
 		apply: ((_config, { mode }) => mode !== "test")
 	}));
+	const hasClientSource = existsSync(resolve("src/client/routes"));
 	return [
 		orchestrator,
-		...existsSync(resolve("src/client/routes")) ? [tanstackRouter({
+		{
+			...clsxFromCn,
+			enforce: "pre"
+		},
+		...hasClientSource ? [tanstackRouter({
 			generatedRouteTree: ".hitch/routeTree.gen.ts",
 			routesDirectory: "src/client/routes",
 			routeFileIgnorePattern: "__root",

package/dist/{workflow-engine-MogejNfF.js → workflow-engine-BOTzURKM.js}

@@ -1,10 +1,4 @@
 import { z } from "zod";
-//#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_TOKEN_HEADER = "x-hitch-applet-token";
-//#endregion
 //#region src/server/workflow-protocol.ts
 const journalEntrySchema = z.discriminatedUnion("kind", [
 	z.object({
@@ -114,4 +108,4 @@ async function runWorkflowJournal(engine, invoke) {
 	}
 }
 //#endregion
-export { workflowOutcomeSchema as a, HITCH_SESSION_HEADER as c, workflowInvocationRequestSchema as i, HITCH_USER_HEADER as l, runWorkflowJournal as n, HITCH_APPLET_HEADER as o, journalEntrySchema as r, HITCH_APPLET_TOKEN_HEADER as s, WorkflowFailedError as t };
+export { workflowOutcomeSchema as a, workflowInvocationRequestSchema as i, runWorkflowJournal as n, journalEntrySchema as r, WorkflowFailedError as t };