@hitch42/applet 0.1.1-beta.12 → 0.1.1-beta.14

package/dist/_internal/server.d.ts

@@ -1,5 +1,5 @@
 import { t as AnyWorkflowDefinition } from "../workflow-DurM6Fwx.js";
-import { d as listEmailTrackersInputSchema, i as createEmailPixelInputSchema, p as markEmailTrackerSentBodySchema, t as TelephonyMessageReceivedEvent } from "../telephony-protocol-D-nf3Gca.js";
+import { I as markEmailTrackerSentBodySchema, k as listEmailTrackersInputSchema, m as createEmailPixelInputSchema, n as TelephonyMessageReceivedEvent, t as EmailMessageReceivedEvent } from "../email-protocol-DqJ6YCiC.js";
 import { z } from "zod";
 //#region src/server/entry.d.ts
 declare function createWorkerEntry(server: {
@@ -8,6 +8,9 @@ declare function createWorkerEntry(server: {
   telephony?: {
     onMessageReceived?: (event: TelephonyMessageReceivedEvent) => void | Promise<void>;
   };
+  email?: {
+    onMessageReceived?: (event: EmailMessageReceivedEvent) => void | Promise<void>;
+  };
 }, options: {
   code: string;
 }): {

package/dist/_internal/server.js

@@ -1,4 +1,4 @@
-import { c as listEmailTrackersInputSchema, t as createEmailPixelInputSchema, u as markEmailTrackerSentBodySchema } from "../email-DBTVhNB_.js";
+import { C as markEmailTrackerSentBodySchema, g as listEmailTrackersInputSchema, t as createEmailPixelInputSchema } from "../email-WA4jnzZ0.js";
 import { a as HITCH_ORG_CODE_HEADER, c as HITCH_SCHEDULE_HEADER, d as HITCH_USER_HEADER, f as HITCH_WORKFLOW_HEADER, i as HITCH_ORGANIZATION_HEADER, l as HITCH_SCHEDULE_RUN_HEADER, m as HITCH_WORKFLOW_RUN_HEADER, n as HITCH_APPLET_HEADER, o as HITCH_RELEASE_HEADER, p as HITCH_WORKFLOW_INVOCATION_HEADER, r as HITCH_APPLET_TOKEN_HEADER, u as HITCH_SESSION_HEADER } from "../headers-DkNr9MLJ.js";
 import { a as getRequestContext, o as runWithRequestContext, r as toMilliseconds, t as MAX_DURATION_MS } from "../workflow-CTo2kZF1.js";
 import { a as errorNote, c as requestIdFrom, i as createNoteLog, r as cloudflareRequestFields, s as publishNote, t as APP_CONTEXT_CHANNEL } from "../log-context-zu8U9Sjm.js";
@@ -14,6 +14,16 @@ const telephonyMessageReceivedEventSchema = z.object({
 	occurredAt: z.iso.datetime()
 });
 //#endregion
+//#region src/server/email-protocol.ts
+const emailMessageReceivedEventSchema = z.object({
+	eventId: z.string(),
+	type: z.literal("message.received"),
+	messageId: z.string(),
+	mailboxId: z.string(),
+	threadId: z.string(),
+	occurredAt: z.iso.datetime()
+});
+//#endregion
 //#region src/server/workflow-run.ts
 const MAX_RESULT_SIZE = 1048576;
 function errorMessage(error) {
@@ -208,6 +218,21 @@ function createWorkerEntry(server, options) {
 						return jsonError(500, error instanceof Error ? error.message : String(error));
 					}
 				}
+				if (pathname === "/api/__hitch/email/message-received" && request.method === "POST") {
+					log.set({ route: "/api/__hitch/email/message-received" });
+					if (identity.kind !== "applet") return jsonError(403, "applet_identity_required");
+					const parsed = await request.json().then((body) => emailMessageReceivedEventSchema.safeParse(body)).catch(() => void 0);
+					if (!parsed?.success) return jsonError(400, "malformed_request");
+					const onMessageReceived = server.email?.onMessageReceived;
+					if (!onMessageReceived) return jsonError(404, "no_email_handler");
+					try {
+						await onMessageReceived(parsed.data);
+						return Response.json({ ok: true });
+					} catch (error) {
+						publishNote(requestId, errorNote(error), APP_CONTEXT_CHANNEL);
+						return jsonError(500, error instanceof Error ? error.message : String(error));
+					}
+				}
 				if (pathname.startsWith(WORKFLOW_PATH_PREFIX)) {
 					log.set({ route: `${WORKFLOW_PATH_PREFIX}:code` });
 					const parsed = await request.json().then((body) => workflowInvocationRequestSchema.safeParse(body)).catch(() => void 0);

package/dist/applet.js

@@ -99,23 +99,23 @@ async function main() {
 	const noLogFlags = values.run === void 0 && values.filter === void 0 && values.level === void 0 && values.limit === void 0 && values.live === void 0 && values.search === void 0 && values.since === void 0;
 	const noModeFlags = values["client-only"] === void 0 && values["server-only"] === void 0;
 	if (positionals.length === 1 && positionals[0] === "bootstrap" && noModeFlags && noGitFlags && noVariableFlags && noLogFlags) {
-		await (await import("./init-6oGPM46R.js")).runBootstrap({ install: values["no-install"] !== true });
+		await (await import("./init-CD-xOYWV.js")).runBootstrap({ install: values["no-install"] !== true });
 		return;
 	}
 	if (positionals.length === 1 && positionals[0] === "generate" && values["no-install"] === void 0 && noModeFlags && noGitFlags && noVariableFlags && noLogFlags) {
-		await (await import("./generate-Dox-OYt6.js")).runGenerate();
+		await (await import("./generate-CtbF9Zxd.js")).runGenerate();
 		return;
 	}
 	if (positionals.length === 1 && positionals[0] === "build" && values["no-install"] === void 0 && noModeFlags && noGitFlags && noVariableFlags && noLogFlags) {
-		await (await import("./build-Bh_S5BUv.js")).runBuild();
+		await (await import("./build-CeRZYhM9.js")).runBuild();
 		return;
 	}
 	if (positionals.length === 1 && positionals[0] === "deploy" && values["no-install"] === void 0 && noModeFlags && noGitFlags && noVariableFlags && noLogFlags) {
-		await (await import("./deploy-wGYjwXrx.js")).runDeploy({});
+		await (await import("./deploy-CaGPhe2h.js")).runDeploy({});
 		return;
 	}
 	if (positionals.length === 2 && positionals[0] === "init" && noModeFlags && noVariableFlags && noLogFlags) {
-		await (await import("./init-6oGPM46R.js")).runInit(positionals[1], {
+		await (await import("./init-CD-xOYWV.js")).runInit(positionals[1], {
 			commit: values["no-commit"] !== true,
 			git: values["no-git"] !== true,
 			install: values["no-install"] !== true
@@ -123,7 +123,7 @@ async function main() {
 		return;
 	}
 	if (positionals.length === 2 && positionals[0] === "new" && noGitFlags && noVariableFlags && noLogFlags) {
-		await (await import("./init-6oGPM46R.js")).runNew({
+		await (await import("./init-CD-xOYWV.js")).runNew({
 			code: positionals[1],
 			clientOnly: values["client-only"],
 			install: values["no-install"] !== true,
@@ -132,7 +132,7 @@ async function main() {
 		return;
 	}
 	if ((positionals.length === 1 || positionals.length === 2) && positionals[0] === "logs" && values["no-install"] === void 0 && noModeFlags && noGitFlags && noVariableFlags) {
-		await (await import("./logs-DSjuEN0Q.js")).runLogs({
+		await (await import("./logs-BySh9fnH.js")).runLogs({
 			code: positionals[1],
 			filter: values.filter,
 			run: values.run,
@@ -145,14 +145,14 @@ async function main() {
 		return;
 	}
 	if (positionals.length === 3 && positionals[0] === "schedules" && positionals[1] === "run" && values["no-install"] === void 0 && noModeFlags && noGitFlags && noLogFlags && values.secret === void 0) {
-		await (await import("./schedules-C8_Svr4h.js")).runSchedule({
+		await (await import("./schedules-B_p9U-vM.js")).runSchedule({
 			code: positionals[2],
 			yes: values.yes
 		});
 		return;
 	}
 	if ((positionals.length === 3 || positionals.length === 4) && positionals[0] === "variables" && positionals[1] === "set" && values["no-install"] === void 0 && noModeFlags && noGitFlags && noLogFlags) {
-		await (await import("./variables-DT5RyHdH.js")).runVariablesSet({
+		await (await import("./variables-D9nEFyOK.js")).runVariablesSet({
 			key: positionals[2],
 			secret: values.secret,
 			value: positionals[3],
@@ -161,11 +161,11 @@ async function main() {
 		return;
 	}
 	if (positionals.length === 2 && positionals[0] === "variables" && positionals[1] === "list" && values["no-install"] === void 0 && noModeFlags && noGitFlags && noVariableFlags && noLogFlags) {
-		await (await import("./variables-DT5RyHdH.js")).runVariablesList();
+		await (await import("./variables-D9nEFyOK.js")).runVariablesList();
 		return;
 	}
 	if (positionals.length === 3 && positionals[0] === "variables" && positionals[1] === "delete" && values["no-install"] === void 0 && noModeFlags && noGitFlags && values.secret === void 0 && noLogFlags) {
-		await (await import("./variables-DT5RyHdH.js")).runVariablesDelete({
+		await (await import("./variables-D9nEFyOK.js")).runVariablesDelete({
 			key: positionals[2],
 			yes: values.yes
 		});

package/dist/build-CeRZYhM9.js

@@ -0,0 +1,2 @@
+import { i as runBuild } from "./build-CwOM9C0W.js";
+export { runBuild };

package/dist/{build-CEfFoIZZ.js → build-CwOM9C0W.js}

@@ -1,4 +1,4 @@
-import { i as prepareAppletProjects, r as prepareAppletProject } from "./project-BRZGd6xq.js";
+import { i as prepareAppletProjects, r as prepareAppletProject } from "./project-z7x0omdw.js";
 import { rm } from "node:fs/promises";
 import { resolve } from "node:path";
 import { spawn } from "node:child_process";

package/dist/client.d.ts

@@ -1,5 +1,5 @@
-import { f as RegisteredContract, m as RegisteredRouter, p as RegisteredManifest } from "./manifest-C6_F4bL8.js";
-import { t as NarrowContract } from "./contract-CsUpTBe0.js";
+import { f as RegisteredContract, m as RegisteredRouter, p as RegisteredManifest } from "./manifest-ARAy2HP7.js";
+import { t as NarrowContract } from "./contract-CZdT22tB.js";
 import { t as WithBatchRecorder } from "./batch-Qa4B4-Yp.js";
 import { o as WithFilesUpload } from "./upload-DKZzz5kW.js";
 import { RouterClient } from "@orpc/server";

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

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

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

@@ -1,6 +1,6 @@
 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 { n as buildPreparedApplet, r as prepareWorkspaceBuild, t as buildApplet } from "./build-CwOM9C0W.js";
 import { createRequire } from "node:module";
 import { createHash } from "node:crypto";
 import { existsSync } from "node:fs";

package/dist/email-WA4jnzZ0.js

@@ -0,0 +1,211 @@
+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 {
+		mailboxes: { list: oc.route({
+			method: "GET",
+			path: "/v1/email/mailboxes"
+		}).input(z.void()).output(listHitchEmailMailboxesOutputSchema) },
+		threads: {
+			list: oc.route({
+				method: "GET",
+				path: "/v1/email/threads"
+			}).input(listHitchEmailThreadsInputSchema).output(listHitchEmailThreadsOutputSchema),
+			get: oc.route({
+				method: "GET",
+				path: "/v1/email/threads/{id}"
+			}).input(hitchEmailIdInputSchema).output(hitchEmailThreadSchema)
+		},
+		messages: {
+			list: oc.route({
+				method: "GET",
+				path: "/v1/email/messages"
+			}).input(listHitchEmailMessagesInputSchema).output(listHitchEmailMessagesOutputSchema),
+			get: oc.route({
+				method: "GET",
+				path: "/v1/email/messages/{id}"
+			}).input(hitchEmailIdInputSchema).output(hitchEmailMessageSchema),
+			send: oc.route({
+				method: "POST",
+				path: "/v1/email/messages",
+				successStatus: 201
+			}).input(sendHitchEmailInputSchema).output(hitchEmailMessageSchema),
+			raw: oc.route({
+				method: "GET",
+				path: "/v1/email/messages/{id}/raw"
+			}).input(hitchEmailIdInputSchema).output(getHitchEmailRawOutputSchema)
+		},
+		attachments: { get: oc.route({
+			method: "GET",
+			path: "/v1/email/attachments/{id}"
+		}).input(hitchEmailIdInputSchema).output(getHitchEmailAttachmentOutputSchema) },
+		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)
+		}
+	};
+}
+const hitchEmailAddressSchema = z.object({
+	address: z.string(),
+	name: z.string().nullable()
+});
+const hitchMailboxSchema = z.object({
+	id: z.uuid(),
+	address: z.string(),
+	label: z.string(),
+	enabled: z.boolean(),
+	receive: z.boolean(),
+	canRead: z.boolean(),
+	canSend: z.boolean()
+});
+const hitchEmailAttachmentSchema = z.object({
+	id: z.uuid(),
+	filename: z.string(),
+	contentType: z.string(),
+	sizeBytes: z.number(),
+	contentId: z.string().nullable(),
+	inline: z.boolean()
+});
+const hitchEmailMessageSchema = z.object({
+	id: z.uuid(),
+	mailboxId: z.uuid(),
+	threadId: z.uuid(),
+	direction: z.enum(["inbound", "outbound"]),
+	status: z.enum([
+		"received",
+		"unknown",
+		"sent",
+		"failed"
+	]),
+	messageId: z.string().nullable(),
+	inReplyTo: z.string().nullable(),
+	references: z.array(z.string()),
+	from: hitchEmailAddressSchema,
+	to: z.array(hitchEmailAddressSchema),
+	cc: z.array(hitchEmailAddressSchema),
+	bcc: z.array(hitchEmailAddressSchema),
+	replyTo: z.array(hitchEmailAddressSchema),
+	subject: z.string(),
+	text: z.string().nullable(),
+	html: z.string().nullable(),
+	sentAt: z.string().nullable(),
+	automated: z.string().nullable(),
+	authentication: z.object({
+		spf: z.string().nullable(),
+		dkim: z.string().nullable(),
+		dmarc: z.string().nullable()
+	}).nullable(),
+	parseError: z.string().nullable(),
+	attachments: z.array(hitchEmailAttachmentSchema),
+	userId: z.uuid().nullable(),
+	appletId: z.uuid().nullable(),
+	requestId: z.string().nullable(),
+	errorDetail: z.string().nullable(),
+	createdAt: z.string()
+});
+const hitchEmailThreadSchema = z.object({
+	id: z.uuid(),
+	mailboxId: z.uuid(),
+	subject: z.string(),
+	messageCount: z.number(),
+	lastMessageAt: z.string(),
+	createdAt: z.string()
+});
+const listHitchEmailMailboxesOutputSchema = z.object({ data: z.array(hitchMailboxSchema) });
+const listHitchEmailThreadsOutputSchema = z.object({
+	data: z.array(hitchEmailThreadSchema),
+	nextCursor: z.string().nullable()
+});
+const listHitchEmailMessagesOutputSchema = z.object({
+	data: z.array(hitchEmailMessageSchema),
+	nextCursor: z.string().nullable()
+});
+const getHitchEmailRawOutputSchema = z.object({ url: z.string() });
+const getHitchEmailAttachmentOutputSchema = z.object({
+	url: z.string(),
+	filename: z.string(),
+	contentType: z.string(),
+	sizeBytes: z.number()
+});
+const hitchEmailIdInputSchema = z.object({ id: z.uuid() });
+const listHitchEmailThreadsInputSchema = z.object({
+	mailboxId: z.uuid().optional(),
+	cursor: z.string().optional(),
+	limit: z.number().int().min(1).max(200).optional()
+});
+const listHitchEmailMessagesInputSchema = z.object({
+	mailboxId: z.uuid().optional(),
+	address: z.string().optional(),
+	threadId: z.uuid().optional(),
+	direction: z.enum(["inbound", "outbound"]).optional(),
+	since: z.iso.datetime().optional(),
+	until: z.iso.datetime().optional(),
+	cursor: z.string().optional(),
+	limit: z.number().int().min(1).max(50).optional()
+});
+const sendHitchEmailInputSchema = z.object({
+	mailboxId: z.uuid(),
+	to: z.array(z.string()).max(50).optional(),
+	cc: z.array(z.string()).max(50).optional(),
+	bcc: z.array(z.string()).max(50).optional(),
+	subject: z.string().max(998).optional(),
+	text: z.string().optional(),
+	html: z.string().optional(),
+	replyToMessageId: z.uuid().optional(),
+	attachmentFileIds: z.array(z.uuid()).max(32).optional(),
+	requestId: z.string().min(1).max(200).optional()
+});
+//#endregion
+export { markEmailTrackerSentBodySchema as C, listHitchEmailThreadsOutputSchema as S, sendHitchEmailInputSchema as T, listEmailTrackersOutputSchema as _, emailTagsSchema as a, listHitchEmailMessagesOutputSchema as b, getHitchEmailAttachmentOutputSchema as c, hitchEmailAttachmentSchema as d, hitchEmailIdInputSchema as f, listEmailTrackersInputSchema as g, hitchMailboxSchema as h, emailTagKeySchema as i, getHitchEmailRawOutputSchema as l, hitchEmailThreadSchema as m, createEmailPixelOutputSchema as n, emailTrackerSchema as o, hitchEmailMessageSchema as p, emailContract as r, getEmailTrackerInputSchema as s, createEmailPixelInputSchema as t, hitchEmailAddressSchema as u, listHitchEmailMailboxesOutputSchema as v, markEmailTrackerSentInputSchema as w, listHitchEmailThreadsInputSchema as x, listHitchEmailMessagesInputSchema as y };

package/dist/email-protocol-DqJ6YCiC.d.ts

@@ -0,0 +1,230 @@
+import { ContractProcedure, Meta } from "@orpc/contract";
+import { z } from "zod";
+//#region src/hitch/email.d.ts
+type EmailTags = Record<string, string>;
+type CreateEmailPixelInput = {
+  tags?: EmailTags;
+};
+type CreateEmailPixelOutput = {
+  id: string;
+  url: string;
+};
+type GetEmailTrackerInput = {
+  id: string;
+};
+type MarkEmailTrackerSentInput = {
+  id: string;
+  sentAt?: string;
+};
+type EmailTracker = {
+  id: string;
+  url: string;
+  tags: EmailTags;
+  createdAt: string;
+  sentAt: string | null;
+  firstHitAt: string | null;
+  lastHitAt: string | null;
+};
+type ListEmailTrackersInput = {
+  filter?: EmailTags;
+  sentAt?: {
+    $gte?: string;
+    $lt?: string;
+  };
+  cursor?: string;
+  limit?: number;
+};
+type ListEmailTrackersOutput = {
+  trackers: EmailTracker[];
+  nextCursor: string | null;
+};
+declare const emailTagKeySchema: z.ZodType<string, string>;
+declare const emailTagsSchema: z.ZodType<EmailTags, EmailTags>;
+declare const createEmailPixelInputSchema: z.ZodType<CreateEmailPixelInput, CreateEmailPixelInput>;
+declare const createEmailPixelOutputSchema: z.ZodType<CreateEmailPixelOutput, CreateEmailPixelOutput>;
+declare const getEmailTrackerInputSchema: z.ZodType<GetEmailTrackerInput, GetEmailTrackerInput>;
+declare const markEmailTrackerSentInputSchema: z.ZodType<MarkEmailTrackerSentInput, MarkEmailTrackerSentInput>;
+declare const markEmailTrackerSentBodySchema: z.ZodType<{
+  sentAt?: string;
+}, {
+  sentAt?: string;
+}>;
+declare const emailTrackerSchema: z.ZodType<EmailTracker, EmailTracker>;
+declare const listEmailTrackersInputSchema: z.ZodType<ListEmailTrackersInput, ListEmailTrackersInput>;
+declare const listEmailTrackersOutputSchema: z.ZodType<ListEmailTrackersOutput, ListEmailTrackersOutput>;
+type EmailContract = {
+  mailboxes: {
+    list: ContractProcedure<z.ZodType<void, void>, z.ZodType<HitchEmailMailboxesOutput, HitchEmailMailboxesOutput>, Record<never, never>, Meta>;
+  };
+  threads: {
+    list: ContractProcedure<z.ZodType<ListHitchEmailThreadsInput, ListHitchEmailThreadsInput>, z.ZodType<HitchEmailThreadsOutput, HitchEmailThreadsOutput>, Record<never, never>, Meta>;
+    get: ContractProcedure<z.ZodType<HitchEmailIdInput, HitchEmailIdInput>, z.ZodType<HitchEmailThread, HitchEmailThread>, Record<never, never>, Meta>;
+  };
+  messages: {
+    /** Newest first. Pass threadId to page through one thread. */
+    list: ContractProcedure<z.ZodType<ListHitchEmailMessagesInput, ListHitchEmailMessagesInput>, z.ZodType<HitchEmailMessagesOutput, HitchEmailMessagesOutput>, Record<never, never>, Meta>;
+    get: ContractProcedure<z.ZodType<HitchEmailIdInput, HitchEmailIdInput>, z.ZodType<HitchEmailMessage, HitchEmailMessage>, Record<never, never>, Meta>;
+    send: ContractProcedure<z.ZodType<SendHitchEmailInput, SendHitchEmailInput>, z.ZodType<HitchEmailMessage, HitchEmailMessage>, Record<never, never>, Meta>;
+    raw: ContractProcedure<z.ZodType<HitchEmailIdInput, HitchEmailIdInput>, z.ZodType<HitchEmailRawOutput, HitchEmailRawOutput>, Record<never, never>, Meta>;
+  };
+  attachments: {
+    get: ContractProcedure<z.ZodType<HitchEmailIdInput, HitchEmailIdInput>, z.ZodType<HitchEmailAttachmentOutput, HitchEmailAttachmentOutput>, Record<never, never>, Meta>;
+  };
+  tracking: {
+    createPixel: ContractProcedure<z.ZodType<CreateEmailPixelInput | undefined, CreateEmailPixelInput | undefined>, z.ZodType<CreateEmailPixelOutput, CreateEmailPixelOutput>, Record<never, never>, Meta>;
+    markSent: ContractProcedure<z.ZodType<MarkEmailTrackerSentInput, MarkEmailTrackerSentInput>, z.ZodType<EmailTracker, EmailTracker>, Record<never, never>, Meta>;
+    get: ContractProcedure<z.ZodType<GetEmailTrackerInput, GetEmailTrackerInput>, z.ZodType<EmailTracker, EmailTracker>, Record<never, never>, Meta>;
+    list: ContractProcedure<z.ZodType<ListEmailTrackersInput | undefined, ListEmailTrackersInput | undefined>, z.ZodType<ListEmailTrackersOutput, ListEmailTrackersOutput>, Record<never, never>, Meta>;
+  };
+};
+declare function emailContract(appletCode: string): EmailContract;
+type HitchEmailAddress = {
+  address: string;
+  name: string | null;
+};
+type HitchMailbox = {
+  id: string;
+  address: string;
+  label: string;
+  enabled: boolean;
+  receive: boolean;
+  canRead: boolean;
+  canSend: boolean;
+};
+type HitchEmailAttachment = {
+  id: string;
+  filename: string;
+  contentType: string;
+  sizeBytes: number;
+  contentId: string | null;
+  inline: boolean;
+};
+type HitchEmailMessage = {
+  id: string;
+  mailboxId: string;
+  threadId: string;
+  direction: "inbound" | "outbound";
+  status: "received" | "unknown" | "sent" | "failed";
+  messageId: string | null;
+  inReplyTo: string | null;
+  references: string[];
+  from: HitchEmailAddress;
+  to: HitchEmailAddress[];
+  cc: HitchEmailAddress[];
+  bcc: HitchEmailAddress[];
+  replyTo: HitchEmailAddress[];
+  subject: string;
+  text: string | null;
+  html: string | null;
+  sentAt: string | null;
+  automated: string | null;
+  authentication: {
+    spf: string | null;
+    dkim: string | null;
+    dmarc: string | null;
+  } | null;
+  parseError: string | null;
+  attachments: HitchEmailAttachment[];
+  userId: string | null;
+  appletId: string | null;
+  requestId: string | null;
+  errorDetail: string | null;
+  createdAt: string;
+};
+type HitchEmailThread = {
+  id: string;
+  mailboxId: string;
+  subject: string;
+  messageCount: number;
+  lastMessageAt: string;
+  createdAt: string;
+};
+type ListHitchEmailThreadsInput = {
+  mailboxId?: string;
+  cursor?: string;
+  limit?: number;
+};
+type ListHitchEmailMessagesInput = {
+  mailboxId?: string;
+  address?: string;
+  threadId?: string;
+  direction?: "inbound" | "outbound";
+  since?: string;
+  until?: string;
+  cursor?: string;
+  limit?: number;
+};
+type SendHitchEmailInput = {
+  mailboxId: string;
+  to?: string[];
+  cc?: string[];
+  bcc?: string[];
+  subject?: string;
+  text?: string;
+  html?: string;
+  replyToMessageId?: string;
+  attachmentFileIds?: string[];
+  requestId?: string;
+};
+type HitchEmailIdInput = {
+  id: string;
+};
+type HitchEmailMailboxesOutput = {
+  data: HitchMailbox[];
+};
+type HitchEmailThreadsOutput = {
+  data: HitchEmailThread[];
+  nextCursor: string | null;
+};
+type HitchEmailMessagesOutput = {
+  data: HitchEmailMessage[];
+  nextCursor: string | null;
+};
+type HitchEmailRawOutput = {
+  url: string;
+};
+type HitchEmailAttachmentOutput = {
+  url: string;
+  filename: string;
+  contentType: string;
+  sizeBytes: number;
+};
+declare const hitchEmailAddressSchema: z.ZodType<HitchEmailAddress, HitchEmailAddress>;
+declare const hitchMailboxSchema: z.ZodType<HitchMailbox, HitchMailbox>;
+declare const hitchEmailAttachmentSchema: z.ZodType<HitchEmailAttachment, HitchEmailAttachment>;
+declare const hitchEmailMessageSchema: z.ZodType<HitchEmailMessage, HitchEmailMessage>;
+declare const hitchEmailThreadSchema: z.ZodType<HitchEmailThread, HitchEmailThread>;
+declare const listHitchEmailMailboxesOutputSchema: z.ZodType<HitchEmailMailboxesOutput, HitchEmailMailboxesOutput>;
+declare const listHitchEmailThreadsOutputSchema: z.ZodType<HitchEmailThreadsOutput, HitchEmailThreadsOutput>;
+declare const listHitchEmailMessagesOutputSchema: z.ZodType<HitchEmailMessagesOutput, HitchEmailMessagesOutput>;
+declare const getHitchEmailRawOutputSchema: z.ZodType<HitchEmailRawOutput, HitchEmailRawOutput>;
+declare const getHitchEmailAttachmentOutputSchema: z.ZodType<HitchEmailAttachmentOutput, HitchEmailAttachmentOutput>;
+declare const hitchEmailIdInputSchema: z.ZodType<HitchEmailIdInput, HitchEmailIdInput>;
+declare const listHitchEmailThreadsInputSchema: z.ZodType<ListHitchEmailThreadsInput, ListHitchEmailThreadsInput>;
+declare const listHitchEmailMessagesInputSchema: z.ZodType<ListHitchEmailMessagesInput, ListHitchEmailMessagesInput>;
+declare const sendHitchEmailInputSchema: z.ZodType<SendHitchEmailInput, SendHitchEmailInput>;
+//#endregion
+//#region src/server/telephony-protocol.d.ts
+/** Handle events at least once and without order. Use eventId for idempotency.
+ * Read the message with hitch.telephony.messages.get({ id: messageId }). */
+type TelephonyMessageReceivedEvent = {
+  eventId: string;
+  type: "message.received";
+  messageId: string;
+  numberId: string;
+  occurredAt: string;
+};
+//#endregion
+//#region src/server/email-protocol.d.ts
+/** Handle events at least once and without order. Use eventId for idempotency.
+ * Read the message with hitch.email.messages.get({ id: messageId }). */
+type EmailMessageReceivedEvent = {
+  eventId: string;
+  type: "message.received";
+  messageId: string;
+  mailboxId: string;
+  threadId: string;
+  occurredAt: string;
+};
+//#endregion
+export { listEmailTrackersOutputSchema as A, hitchEmailAddressSchema as C, hitchEmailThreadSchema as D, hitchEmailMessageSchema as E, listHitchEmailThreadsOutputSchema as F, markEmailTrackerSentBodySchema as I, markEmailTrackerSentInputSchema as L, listHitchEmailMessagesInputSchema as M, listHitchEmailMessagesOutputSchema as N, hitchMailboxSchema as O, listHitchEmailThreadsInputSchema as P, sendHitchEmailInputSchema as R, getHitchEmailRawOutputSchema as S, hitchEmailIdInputSchema as T, emailTagKeySchema as _, HitchEmailAddress as a, getEmailTrackerInputSchema as b, HitchEmailThread as c, ListHitchEmailMessagesInput as d, ListHitchEmailThreadsInput as f, emailContract as g, createEmailPixelOutputSchema as h, EmailTracker as i, listHitchEmailMailboxesOutputSchema as j, listEmailTrackersInputSchema as k, HitchMailbox as l, createEmailPixelInputSchema as m, TelephonyMessageReceivedEvent as n, HitchEmailAttachment as o, SendHitchEmailInput as p, EmailContract as r, HitchEmailMessage as s, EmailMessageReceivedEvent as t, ListEmailTrackersOutput as u, emailTagsSchema as v, hitchEmailAttachmentSchema as w, getHitchEmailAttachmentOutputSchema as x, emailTrackerSchema as y };

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

@@ -1,7 +1,7 @@
 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 { r as prepareAppletProject } from "./project-z7x0omdw.js";
+import { t as loadAppletConfig } from "./load-config-BeQZ2yOa.js";
 import { createRequire } from "node:module";
 import { existsSync } from "node:fs";
 import { access, mkdir, mkdtemp, readFile, readdir, rename, rm, writeFile } from "node:fs/promises";
@@ -310,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\";\nimport type { TelephonyMessageReceivedEvent } from \"@hitch42/applet\";\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, EmailMessageReceivedEvent } from \"@hitch42/applet\";\n" : ""}
 ${catalogType}
 
 type Expect<T extends true> = T;
@@ -324,6 +324,7 @@ type _SrcServerMainMustDefaultExportRouterAndValidWorkflows = Expect<
     router: AnyRouter;
     workflows?: Record<string, WorkflowDefinition<any, any>>;
     telephony?: { onMessageReceived?: (event: TelephonyMessageReceivedEvent) => void | Promise<void> };
+    email?: { onMessageReceived?: (event: EmailMessageReceivedEvent) => void | Promise<void> };
   }
     ? true
     : false

package/dist/generate-CtbF9Zxd.js

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

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { _ as RegisteredWorkflows, a as AppletSourceDefinition, c as appletManifestSchema, d as RegisteredCatalog, f as RegisteredContract, g as RegisteredVariables, h as RegisteredVariableKeys, i as AppletPackages, l as appletSourceDefinitionSchema, m as RegisteredRouter, n as AppletManifest, o as RegisteredAppletSourceDefinition, p as RegisteredManifest, r as AppletManifestObject, s as appletDefinitionSchema, t as AppletDefinition, u as HitchRegister, v as registerHitchContract } from "./manifest-C6_F4bL8.js";
-import { n as pruneContract, t as NarrowContract } from "./contract-CsUpTBe0.js";
+import { _ as RegisteredWorkflows, a as AppletSourceDefinition, c as appletManifestSchema, d as RegisteredCatalog, f as RegisteredContract, g as RegisteredVariables, h as RegisteredVariableKeys, i as AppletPackages, l as appletSourceDefinitionSchema, m as RegisteredRouter, n as AppletManifest, o as RegisteredAppletSourceDefinition, p as RegisteredManifest, r as AppletManifestObject, s as appletDefinitionSchema, t as AppletDefinition, u as HitchRegister, v as registerHitchContract } from "./manifest-ARAy2HP7.js";
+import { n as pruneContract, t as NarrowContract } from "./contract-CZdT22tB.js";
 import { a as UploadedHitchFile, c as createFileOutputSchema, d as getFileOutputSchema, i as UploadProgress, l as fileSchema, n as FilesUpload, r as UploadFileOptions, s as uploadFile, t as FilesClient, u as filesContract } from "./upload-DKZzz5kW.js";
-import { a as createEmailPixelOutputSchema, c as emailTagsSchema, d as listEmailTrackersInputSchema, f as listEmailTrackersOutputSchema, i as createEmailPixelInputSchema, l as emailTrackerSchema, m as markEmailTrackerSentInputSchema, n as EmailTracker, o as emailContract, r as ListEmailTrackersOutput, s as emailTagKeySchema, t as TelephonyMessageReceivedEvent, u as getEmailTrackerInputSchema } from "./telephony-protocol-D-nf3Gca.js";
+import { A as listEmailTrackersOutputSchema, C as hitchEmailAddressSchema, D as hitchEmailThreadSchema, E as hitchEmailMessageSchema, F as listHitchEmailThreadsOutputSchema, L as markEmailTrackerSentInputSchema, M as listHitchEmailMessagesInputSchema, N as listHitchEmailMessagesOutputSchema, O as hitchMailboxSchema, P as listHitchEmailThreadsInputSchema, R as sendHitchEmailInputSchema, S as getHitchEmailRawOutputSchema, T as hitchEmailIdInputSchema, _ as emailTagKeySchema, a as HitchEmailAddress, b as getEmailTrackerInputSchema, c as HitchEmailThread, d as ListHitchEmailMessagesInput, f as ListHitchEmailThreadsInput, g as emailContract, h as createEmailPixelOutputSchema, i as EmailTracker, j as listHitchEmailMailboxesOutputSchema, k as listEmailTrackersInputSchema, l as HitchMailbox, m as createEmailPixelInputSchema, n as TelephonyMessageReceivedEvent, o as HitchEmailAttachment, p as SendHitchEmailInput, r as EmailContract, s as HitchEmailMessage, t as EmailMessageReceivedEvent, u as ListEmailTrackersOutput, v as emailTagsSchema, w as hitchEmailAttachmentSchema, x as getHitchEmailAttachmentOutputSchema, y as emailTrackerSchema } from "./email-protocol-DqJ6YCiC.js";
 import { ContractProcedure, Meta } from "@orpc/contract";
 import { z } from "zod";
 //#region ../shared/auth/src/workspace.d.mts
@@ -183,4 +183,4 @@ type TeamsContract = {
 };
 declare const teamsContract: TeamsContract;
 //#endregion
-export { type AppletDefinition, type AppletManifest, type AppletManifestObject, type AppletPackages, type AppletSourceDefinition, type EmailTracker, type FilesClient, type FilesUpload, type HitchConfig, type HitchMe, type HitchMessage, type HitchPhoneNumber, type HitchRegister, type HitchTeam, type HitchTeamMember, type ListEmailTrackersOutput, type ListHitchMessagesInput, type NarrowContract, type RegisteredAppletSourceDefinition, type RegisteredCatalog, type RegisteredContract, type RegisteredManifest, type RegisteredRouter, type RegisteredVariableKeys, type RegisteredVariables, type RegisteredWorkflows, type SendHitchMessageInput, type TelephonyContract, type TelephonyMessageReceivedEvent, type UploadFileOptions, type UploadProgress, type UploadedHitchFile, appletDefinitionSchema, appletManifestSchema, appletSourceDefinitionSchema, createEmailPixelInputSchema, createEmailPixelOutputSchema, createFileOutputSchema, emailContract, emailTagKeySchema, emailTagsSchema, emailTrackerSchema, fileSchema, filesContract, getEmailTrackerInputSchema, getFileOutputSchema, hitchMessageSchema, hitchPhoneNumberSchema, listEmailTrackersInputSchema, listEmailTrackersOutputSchema, listHitchMessagesInputSchema, listHitchMessagesOutputSchema, listHitchNumbersOutputSchema, markEmailTrackerSentInputSchema, meContract, meSchema, pruneContract, registerHitchContract, sendHitchMessageInputSchema, teamMemberSchema, teamSchema, teamsContract, telephonyContract, uploadFile };
+export { type AppletDefinition, type AppletManifest, type AppletManifestObject, type AppletPackages, type AppletSourceDefinition, type EmailContract, type EmailMessageReceivedEvent, type EmailTracker, type FilesClient, type FilesUpload, type HitchConfig, type HitchEmailAddress, type HitchEmailAttachment, type HitchEmailMessage, type HitchEmailThread, type HitchMailbox, type HitchMe, type HitchMessage, type HitchPhoneNumber, type HitchRegister, type HitchTeam, type HitchTeamMember, type ListEmailTrackersOutput, type ListHitchEmailMessagesInput, type ListHitchEmailThreadsInput, type ListHitchMessagesInput, type NarrowContract, type RegisteredAppletSourceDefinition, type RegisteredCatalog, type RegisteredContract, type RegisteredManifest, type RegisteredRouter, type RegisteredVariableKeys, type RegisteredVariables, type RegisteredWorkflows, type SendHitchEmailInput, type SendHitchMessageInput, type TelephonyContract, type TelephonyMessageReceivedEvent, type UploadFileOptions, type UploadProgress, type UploadedHitchFile, appletDefinitionSchema, appletManifestSchema, appletSourceDefinitionSchema, createEmailPixelInputSchema, createEmailPixelOutputSchema, createFileOutputSchema, emailContract, emailTagKeySchema, emailTagsSchema, emailTrackerSchema, fileSchema, filesContract, getEmailTrackerInputSchema, getFileOutputSchema, getHitchEmailAttachmentOutputSchema, getHitchEmailRawOutputSchema, hitchEmailAddressSchema, hitchEmailAttachmentSchema, hitchEmailIdInputSchema, hitchEmailMessageSchema, hitchEmailThreadSchema, hitchMailboxSchema, hitchMessageSchema, hitchPhoneNumberSchema, listEmailTrackersInputSchema, listEmailTrackersOutputSchema, listHitchEmailMailboxesOutputSchema, listHitchEmailMessagesInputSchema, listHitchEmailMessagesOutputSchema, listHitchEmailThreadsInputSchema, listHitchEmailThreadsOutputSchema, listHitchMessagesInputSchema, listHitchMessagesOutputSchema, listHitchNumbersOutputSchema, markEmailTrackerSentInputSchema, meContract, meSchema, pruneContract, registerHitchContract, sendHitchEmailInputSchema, sendHitchMessageInputSchema, teamMemberSchema, teamSchema, teamsContract, telephonyContract, uploadFile };

package/dist/index.js

@@ -1,7 +1,7 @@
 import { i as registerHitchContract, t as uploadFile } from "./upload-DRbVhuDm.js";
-import { a as emailTagsSchema, c as listEmailTrackersInputSchema, d as markEmailTrackerSentInputSchema, i as emailTagKeySchema, l as listEmailTrackersOutputSchema, n as createEmailPixelOutputSchema, o as emailTrackerSchema, r as emailContract, s as getEmailTrackerInputSchema, t as createEmailPixelInputSchema } from "./email-DBTVhNB_.js";
+import { S as listHitchEmailThreadsOutputSchema, T as sendHitchEmailInputSchema, _ as listEmailTrackersOutputSchema, a as emailTagsSchema, b as listHitchEmailMessagesOutputSchema, c as getHitchEmailAttachmentOutputSchema, d as hitchEmailAttachmentSchema, f as hitchEmailIdInputSchema, g as listEmailTrackersInputSchema, h as hitchMailboxSchema, i as emailTagKeySchema, l as getHitchEmailRawOutputSchema, m as hitchEmailThreadSchema, n as createEmailPixelOutputSchema, o as emailTrackerSchema, p as hitchEmailMessageSchema, r as emailContract, s as getEmailTrackerInputSchema, t as createEmailPixelInputSchema, u as hitchEmailAddressSchema, v as listHitchEmailMailboxesOutputSchema, w as markEmailTrackerSentInputSchema, x as listHitchEmailThreadsInputSchema, y as listHitchEmailMessagesInputSchema } from "./email-WA4jnzZ0.js";
 import { n as meSchema, t as meContract } from "./me-BW7Paary.js";
-import { n as appletManifestSchema, r as appletSourceDefinitionSchema, t as appletDefinitionSchema } from "./manifest-CJSL9GuC.js";
+import { n as appletManifestSchema, r as appletSourceDefinitionSchema, t as appletDefinitionSchema } from "./manifest-CuY3ICpN.js";
 import { oc } from "@orpc/contract";
 import { z } from "zod";
 //#region src/hitch/contract.ts
@@ -249,4 +249,4 @@ const teamsContract = {
 	}).input(teamIdInputSchema).output(teamMembersOutputSchema) }
 };
 //#endregion
-export { appletDefinitionSchema, appletManifestSchema, appletSourceDefinitionSchema, createEmailPixelInputSchema, createEmailPixelOutputSchema, createFileOutputSchema, emailContract, emailTagKeySchema, emailTagsSchema, emailTrackerSchema, fileSchema, filesContract, getEmailTrackerInputSchema, getFileOutputSchema, hitchMessageSchema, hitchPhoneNumberSchema, listEmailTrackersInputSchema, listEmailTrackersOutputSchema, listHitchMessagesInputSchema, listHitchMessagesOutputSchema, listHitchNumbersOutputSchema, markEmailTrackerSentInputSchema, meContract, meSchema, pruneContract, registerHitchContract, sendHitchMessageInputSchema, teamMemberSchema, teamSchema, teamsContract, telephonyContract, uploadFile };
+export { appletDefinitionSchema, appletManifestSchema, appletSourceDefinitionSchema, createEmailPixelInputSchema, createEmailPixelOutputSchema, createFileOutputSchema, emailContract, emailTagKeySchema, emailTagsSchema, emailTrackerSchema, fileSchema, filesContract, getEmailTrackerInputSchema, getFileOutputSchema, getHitchEmailAttachmentOutputSchema, getHitchEmailRawOutputSchema, hitchEmailAddressSchema, hitchEmailAttachmentSchema, hitchEmailIdInputSchema, hitchEmailMessageSchema, hitchEmailThreadSchema, hitchMailboxSchema, hitchMessageSchema, hitchPhoneNumberSchema, listEmailTrackersInputSchema, listEmailTrackersOutputSchema, listHitchEmailMailboxesOutputSchema, listHitchEmailMessagesInputSchema, listHitchEmailMessagesOutputSchema, listHitchEmailThreadsInputSchema, listHitchEmailThreadsOutputSchema, listHitchMessagesInputSchema, listHitchMessagesOutputSchema, listHitchNumbersOutputSchema, markEmailTrackerSentInputSchema, meContract, meSchema, pruneContract, registerHitchContract, sendHitchEmailInputSchema, sendHitchMessageInputSchema, teamMemberSchema, teamSchema, teamsContract, telephonyContract, uploadFile };

package/dist/{init-6oGPM46R.js → init-CD-xOYWV.js}

@@ -1,8 +1,8 @@
-import { a as ORG_CODE_PATTERN, i as APPLET_CODE_PATTERN } from "./manifest-CJSL9GuC.js";
+import { a as ORG_CODE_PATTERN, i as APPLET_CODE_PATTERN } from "./manifest-CuY3ICpN.js";
 import { d as resolveAuthForOrg, f as resolveInstanceUrl, i as readWorkspaceConfig } from "./workspace-D0dnnlxL.js";
-import { n as runGenerate } from "./generate-BEIYs17x.js";
-import { a as writeAppletSupport, n as loadCliManifest, o as writeWorkspaceSupport, t as assertWorkspaceCli } from "./project-BRZGd6xq.js";
-import { n as loadAppletSourceDefinition } from "./load-config-xEdTXs0y.js";
+import { n as runGenerate } from "./generate-CORu1X2X.js";
+import { a as writeAppletSupport, n as loadCliManifest, o as writeWorkspaceSupport, t as assertWorkspaceCli } from "./project-z7x0omdw.js";
+import { n as loadAppletSourceDefinition } from "./load-config-BeQZ2yOa.js";
 import { access, cp, mkdir, readdir, writeFile } from "node:fs/promises";
 import { relative, resolve } from "node:path";
 import { spawn } from "node:child_process";

package/dist/{load-config-xEdTXs0y.js → load-config-BeQZ2yOa.js}

@@ -1,4 +1,4 @@
-import { r as appletSourceDefinitionSchema } from "./manifest-CJSL9GuC.js";
+import { r as appletSourceDefinitionSchema } from "./manifest-CuY3ICpN.js";
 import { t as resolveWorkspaceOrg } from "./workspace-D0dnnlxL.js";
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";

package/dist/{logs-DSjuEN0Q.js → logs-BySh9fnH.js}

@@ -1,6 +1,6 @@
-import { i as APPLET_CODE_PATTERN } from "./manifest-CJSL9GuC.js";
+import { i as APPLET_CODE_PATTERN } from "./manifest-CuY3ICpN.js";
 import { i as readWorkspaceConfig, n as fetchWithOrgAuth, t as resolveWorkspaceOrg } from "./workspace-D0dnnlxL.js";
-import { t as loadAppletConfig } from "./load-config-xEdTXs0y.js";
+import { t as loadAppletConfig } from "./load-config-BeQZ2yOa.js";
 import { z } from "zod";
 //#region src/logs.ts
 const LOG_LEVELS = [

package/dist/{manifest-C6_F4bL8.d.ts → manifest-ARAy2HP7.d.ts}

@@ -39,6 +39,9 @@ interface AppletManifest {
     send?: boolean;
     events?: readonly "message.received"[];
   };
+  email?: {
+    events: readonly "message.received"[];
+  };
   schedules?: readonly {
     code: string;
     name: string;

package/dist/{manifest-CJSL9GuC.js → manifest-CuY3ICpN.js}

@@ -78,6 +78,7 @@ const appletManifestShape = {
 		send: z.boolean().optional(),
 		events: z.array(z.literal("message.received")).min(1).refine((events) => new Set(events).size === events.length).readonly().optional()
 	}).refine((telephony) => telephony.events === void 0 || telephony.read === true, "telephony.events needs telephony.read").optional(),
+	email: z.strictObject({ events: z.array(z.literal("message.received")).min(1).refine((events) => new Set(events).size === events.length).readonly() }).optional(),
 	schedules: appletManifestSchedulesSchema.optional(),
 	variables: appletManifestVariablesSchema.optional(),
 	objects: appletManifestObjectsSchema
@@ -111,6 +112,7 @@ const appletDefinitionSchema = z.strictObject({
 	code: appletManifestShape.code,
 	requiresChangeset: appletManifestShape.requiresChangeset,
 	telephony: appletManifestShape.telephony,
+	email: appletManifestShape.email,
 	schedules: appletManifestShape.schedules,
 	variables: appletManifestShape.variables,
 	objects: appletManifestShape.objects
@@ -183,6 +185,7 @@ const appletSourceDefinitionSchema = z.strictObject({
 	code: appletManifestShape.code,
 	requiresChangeset: appletManifestShape.requiresChangeset,
 	telephony: appletManifestShape.telephony,
+	email: appletManifestShape.email,
 	schedules: appletManifestShape.schedules,
 	variables: appletManifestShape.variables,
 	objects: appletManifestShape.objects,

package/dist/{project-BRZGd6xq.js → project-z7x0omdw.js}

@@ -1,5 +1,5 @@
 import { i as readWorkspaceConfig, l as organizationInstanceUrl, s as DEFAULT_INSTANCE_URL } from "./workspace-D0dnnlxL.js";
-import { n as loadAppletSourceDefinition } from "./load-config-xEdTXs0y.js";
+import { n as loadAppletSourceDefinition } from "./load-config-BeQZ2yOa.js";
 import { z } from "zod";
 import { existsSync } from "node:fs";
 import { cp, mkdir, readFile, readdir, rm, symlink, writeFile } from "node:fs/promises";

package/dist/{schedules-C8_Svr4h.js → schedules-B_p9U-vM.js}

@@ -1,4 +1,4 @@
-import { t as loadAppletConfig } from "./load-config-xEdTXs0y.js";
+import { t as loadAppletConfig } from "./load-config-BeQZ2yOa.js";
 import { t as question } from "./prompt-ChS-grYO.js";
 import { RPCLink } from "@orpc/client/fetch";
 import { readFile } from "node:fs/promises";

package/dist/server.d.ts

@@ -1,6 +1,6 @@
 import { a as createWorkflow, i as WorkflowStep, n as WorkflowDefinition, r as WorkflowDuration } from "./workflow-DurM6Fwx.js";
-import { _ as RegisteredWorkflows, f as RegisteredContract, g as RegisteredVariables, p as RegisteredManifest } from "./manifest-C6_F4bL8.js";
-import { t as NarrowContract } from "./contract-CsUpTBe0.js";
+import { _ as RegisteredWorkflows, f as RegisteredContract, g as RegisteredVariables, p as RegisteredManifest } from "./manifest-ARAy2HP7.js";
+import { t as NarrowContract } from "./contract-CZdT22tB.js";
 import { t as WithBatchRecorder } from "./batch-Qa4B4-Yp.js";
 import { o as WithFilesUpload } from "./upload-DKZzz5kW.js";
 import { ContractRouterClient } from "@orpc/contract";

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

@@ -1,5 +1,5 @@
 import { n as fetchWithOrgAuth } from "./workspace-D0dnnlxL.js";
-import { t as loadAppletConfig } from "./load-config-xEdTXs0y.js";
+import { t as loadAppletConfig } from "./load-config-BeQZ2yOa.js";
 import { t as question } from "./prompt-ChS-grYO.js";
 import { z } from "zod";
 //#region src/variables.ts

package/dist/vite.d.ts

@@ -1,4 +1,4 @@
-import { o as RegisteredAppletSourceDefinition } from "./manifest-C6_F4bL8.js";
+import { o as RegisteredAppletSourceDefinition } from "./manifest-ARAy2HP7.js";
 import { PluginOption } from "vite";
 //#region src/vite.d.ts
 declare function applet<const M extends RegisteredAppletSourceDefinition>(sourceDefinition: M): PluginOption[];

package/dist/vite.js

@@ -1,10 +1,10 @@
 import { n as meSchema } from "./me-BW7Paary.js";
-import { i as APPLET_CODE_PATTERN, n as appletManifestSchema, r as appletSourceDefinitionSchema } from "./manifest-CJSL9GuC.js";
+import { i as APPLET_CODE_PATTERN, n as appletManifestSchema, r as appletSourceDefinitionSchema } from "./manifest-CuY3ICpN.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 { c as writeClientEntry, i as writeRegisterDeclaration, l as writeManifestGen, r as syncContract, s as writeAppletRoot, u as writeServerEntry } from "./generate-CORu1X2X.js";
 import { randomUUID } from "node:crypto";
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { appendFile, readdir, rm, writeFile } from "node:fs/promises";
@@ -296,16 +296,17 @@ function createDevWorkflows(options) {
 const APPLET_COMPATIBILITY_DATE = "2026-07-14";
 const APPLET_COMPATIBILITY_FLAGS = ["nodejs_compat"];
 let activeDevListener;
-function clientBootstrapScript(parentOrigin, appletCode) {
+function clientBootstrapScript(parentOrigin, appletCode, cacheQueries) {
 	return `(function () {
   var parentOrigin = ${parentOrigin === void 0 ? "null" : JSON.stringify(parentOrigin)};
   var appletCode = ${JSON.stringify(appletCode)};
   var appletCodePattern = ${APPLET_CODE_PATTERN.toString()};
+  var cacheQueries = ${cacheQueries} && window.parent !== window && parentOrigin !== null;
 
   Object.defineProperty(window, "__hitchCacheContext", {
     configurable: false,
     writable: false,
-    value: window.parent !== window && parentOrigin !== null
+    value: cacheQueries
       ? fetch("/__applet/context/" + encodeURIComponent(appletCode), {
           credentials: "same-origin",
           headers: { accept: "application/json" }
@@ -324,7 +325,7 @@ function clientBootstrapScript(parentOrigin, appletCode) {
   Object.defineProperty(window, "__hitchCacheDatabase", {
     configurable: false,
     writable: false,
-    value: window.parent !== window && parentOrigin !== null
+    value: cacheQueries
       ? (function () {
           var database = (${openQueryCacheDatabase.toString()})();
           database.catch(function () {});
@@ -475,6 +476,7 @@ function applet(sourceDefinition) {
 		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.email?.events.length) throw new Error("An applet with email 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");
@@ -567,8 +569,7 @@ function applet(sourceDefinition) {
 				devContext = {
 					person,
 					proxy,
-					orgUrl,
-					cacheBuster: randomUUID()
+					orgUrl
 				};
 				if (hasServer && devListener === void 0) {
 					if (activeDevListener?.listening) activeDevListener.close();
@@ -626,7 +627,7 @@ function applet(sourceDefinition) {
 		configureServer(server) {
 			if (devContext === void 0) return;
 			const { manifest } = requireAppletConfig();
-			const { person, proxy, orgUrl, cacheBuster } = devContext;
+			const { person, proxy, orgUrl } = devContext;
 			const orgOrigin = new URL(orgUrl).origin;
 			devLogger = server.config.logger;
 			const skipSleep = process.env.HITCH_DEV_SKIP_SLEEP === "1";
@@ -684,24 +685,6 @@ function applet(sourceDefinition) {
 			server.middlewares.use((request, response, next) => {
 				if (request.url === mount || request.url?.startsWith(`${mount}?`)) request.url = `${mount}/${request.url.slice(mount.length)}`;
 				const url = request.url ?? "";
-				const pathname = url.split("?", 1)[0] ?? "";
-				if (pathname.startsWith("/__applet/context/")) {
-					if (pathname !== `/__applet/context/${manifest.code}` || request.method !== "GET") {
-						response.writeHead(404).end();
-						return;
-					}
-					if (refusesClient(request.headers, request.socket.remoteAddress)) {
-						response.writeHead(403).end();
-						return;
-					}
-					response.setHeader("Cache-Control", "no-store");
-					response.setHeader("Content-Type", "application/json; charset=utf-8");
-					response.end(JSON.stringify({
-						cacheBuster,
-						cacheScope: person.id
-					}));
-					return;
-				}
 				if (url === "/_hitch/client.js" || url.startsWith("/_hitch/client.js?")) {
 					response.statusCode = 200;
 					response.setHeader("Cache-Control", "no-store");
@@ -738,7 +721,7 @@ function applet(sourceDefinition) {
 		},
 		transformIndexHtml: {
 			order: "post",
-			handler(html) {
+			handler(html, { server }) {
 				const parentOrigin = devContext?.orgUrl === void 0 ? themeStylesheetUrl === void 0 ? void 0 : new URL(themeStylesheetUrl).origin : new URL(devContext.orgUrl).origin;
 				return {
 					html: themeStylesheetUrl === void 0 ? html : html.replace("href=\"/theme.css\"", `href="${themeStylesheetUrl}"`),
@@ -752,7 +735,7 @@ function applet(sourceDefinition) {
 						injectTo: "head-prepend"
 					}, {
 						tag: "script",
-						children: clientBootstrapScript(parentOrigin, requireAppletConfig().manifest.code),
+						children: clientBootstrapScript(parentOrigin, requireAppletConfig().manifest.code, server === void 0),
 						injectTo: "head-prepend"
 					}]
 				};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hitch42/applet",
-  "version": "0.1.1-beta.12",
+  "version": "0.1.1-beta.14",
   "license": "MIT",
   "bin": {
     "applet": "./dist/applet.js"

package/dist/build-Bh_S5BUv.js

@@ -1,2 +0,0 @@
-import { i as runBuild } from "./build-CEfFoIZZ.js";
-export { runBuild };

package/dist/email-DBTVhNB_.js

@@ -1,62 +0,0 @@
-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-Dox-OYt6.js

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

package/dist/telephony-protocol-D-nf3Gca.d.ts

@@ -1,76 +0,0 @@
-import { ContractProcedure, Meta } from "@orpc/contract";
-import { z } from "zod";
-//#region src/hitch/email.d.ts
-type EmailTags = Record<string, string>;
-type CreateEmailPixelInput = {
-  tags?: EmailTags;
-};
-type CreateEmailPixelOutput = {
-  id: string;
-  url: string;
-};
-type GetEmailTrackerInput = {
-  id: string;
-};
-type MarkEmailTrackerSentInput = {
-  id: string;
-  sentAt?: string;
-};
-type EmailTracker = {
-  id: string;
-  url: string;
-  tags: EmailTags;
-  createdAt: string;
-  sentAt: string | null;
-  firstHitAt: string | null;
-  lastHitAt: string | null;
-};
-type ListEmailTrackersInput = {
-  filter?: EmailTags;
-  sentAt?: {
-    $gte?: string;
-    $lt?: string;
-  };
-  cursor?: string;
-  limit?: number;
-};
-type ListEmailTrackersOutput = {
-  trackers: EmailTracker[];
-  nextCursor: string | null;
-};
-declare const emailTagKeySchema: z.ZodType<string, string>;
-declare const emailTagsSchema: z.ZodType<EmailTags, EmailTags>;
-declare const createEmailPixelInputSchema: z.ZodType<CreateEmailPixelInput, CreateEmailPixelInput>;
-declare const createEmailPixelOutputSchema: z.ZodType<CreateEmailPixelOutput, CreateEmailPixelOutput>;
-declare const getEmailTrackerInputSchema: z.ZodType<GetEmailTrackerInput, GetEmailTrackerInput>;
-declare const markEmailTrackerSentInputSchema: z.ZodType<MarkEmailTrackerSentInput, MarkEmailTrackerSentInput>;
-declare const markEmailTrackerSentBodySchema: z.ZodType<{
-  sentAt?: string;
-}, {
-  sentAt?: string;
-}>;
-declare const emailTrackerSchema: z.ZodType<EmailTracker, EmailTracker>;
-declare const listEmailTrackersInputSchema: z.ZodType<ListEmailTrackersInput, ListEmailTrackersInput>;
-declare const listEmailTrackersOutputSchema: z.ZodType<ListEmailTrackersOutput, ListEmailTrackersOutput>;
-type EmailContract = {
-  tracking: {
-    createPixel: ContractProcedure<z.ZodType<CreateEmailPixelInput | undefined, CreateEmailPixelInput | undefined>, z.ZodType<CreateEmailPixelOutput, CreateEmailPixelOutput>, Record<never, never>, Meta>;
-    markSent: ContractProcedure<z.ZodType<MarkEmailTrackerSentInput, MarkEmailTrackerSentInput>, z.ZodType<EmailTracker, EmailTracker>, Record<never, never>, Meta>;
-    get: ContractProcedure<z.ZodType<GetEmailTrackerInput, GetEmailTrackerInput>, z.ZodType<EmailTracker, EmailTracker>, Record<never, never>, Meta>;
-    list: ContractProcedure<z.ZodType<ListEmailTrackersInput | undefined, ListEmailTrackersInput | undefined>, z.ZodType<ListEmailTrackersOutput, ListEmailTrackersOutput>, Record<never, never>, Meta>;
-  };
-};
-declare function emailContract(appletCode: string): EmailContract;
-//#endregion
-//#region src/server/telephony-protocol.d.ts
-/** Handle events at least once and without order. Use eventId for idempotency.
- * Read the message with hitch.telephony.messages.get({ id: messageId }). */
-type TelephonyMessageReceivedEvent = {
-  eventId: string;
-  type: "message.received";
-  messageId: string;
-  numberId: string;
-  occurredAt: string;
-};
-//#endregion
-export { createEmailPixelOutputSchema as a, emailTagsSchema as c, listEmailTrackersInputSchema as d, listEmailTrackersOutputSchema as f, createEmailPixelInputSchema as i, emailTrackerSchema as l, markEmailTrackerSentInputSchema as m, EmailTracker as n, emailContract as o, markEmailTrackerSentBodySchema as p, ListEmailTrackersOutput as r, emailTagKeySchema as s, TelephonyMessageReceivedEvent as t, getEmailTrackerInputSchema as u };