@primitivedotdev/sdk 0.8.0 → 0.10.0

package/dist/{api-BH8PnmHs.js → api-CLLpjjWy.js}

@@ -1,12 +1,10 @@
-import { __export } from "./chunk-Cl8Af3a2.js";
-import { formatAddress } from "./received-email-Q6Cha3wc.js";
-
+import { t as __exportAll } from "./chunk-pbuEa-1d.js";
+import { r as formatAddress } from "./received-email-D6tKtWwW.js";
 //#region src/api/generated/core/bodySerializer.gen.ts
 const jsonBodySerializer = { bodySerializer: (body) => JSON.stringify(body, (_key, value) => typeof value === "bigint" ? value.toString() : value) };
-
 //#endregion
 //#region src/api/generated/core/serverSentEvents.gen.ts
-function createSseClient({ onRequest, onSseError, onSseEvent, responseTransformer, responseValidator, sseDefaultRetryDelay, sseMaxRetryAttempts, sseMaxRetryDelay, sseSleepFn, url,...options }) {
+function createSseClient({ onRequest, onSseError, onSseEvent, responseTransformer, responseValidator, sseDefaultRetryDelay, sseMaxRetryAttempts, sseMaxRetryDelay, sseSleepFn, url, ...options }) {
 	let lastEventId;
 	const sleep = sseSleepFn ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
 	const createStream = async function* () {
@@ -28,8 +26,7 @@ function createSseClient({ onRequest, onSseError, onSseEvent, responseTransforme
 				};
 				let request = new Request(url, requestInit);
 				if (onRequest) request = await onRequest(url, requestInit);
-				const _fetch = options.fetch ?? globalThis.fetch;
-				const response = await _fetch(request);
+				const response = await (options.fetch ?? globalThis.fetch)(request);
 				if (!response.ok) throw new Error(`SSE failed: ${response.status} ${response.statusText}`);
 				if (!response.body) throw new Error("No body in SSE response");
 				const reader = response.body.pipeThrough(new TextDecoderStream()).getReader();
@@ -91,15 +88,12 @@ function createSseClient({ onRequest, onSseError, onSseEvent, responseTransforme
 			} catch (error) {
 				onSseError?.(error);
 				if (sseMaxRetryAttempts !== void 0 && attempt >= sseMaxRetryAttempts) break;
-				const backoff = Math.min(retryDelay * 2 ** (attempt - 1), sseMaxRetryDelay ?? 3e4);
-				await sleep(backoff);
+				await sleep(Math.min(retryDelay * 2 ** (attempt - 1), sseMaxRetryDelay ?? 3e4));
 			}
 		}
 	};
-	const stream = createStream();
-	return { stream };
+	return { stream: createStream() };
 }
-
 //#endregion
 //#region src/api/generated/core/pathSerializer.gen.ts
 const separatorArrayExplode = (style) => {
@@ -128,12 +122,12 @@ const separatorObjectExplode = (style) => {
 };
 const serializeArrayParam = ({ allowReserved, explode, name, style, value }) => {
 	if (!explode) {
-		const joinedValues$1 = (allowReserved ? value : value.map((v) => encodeURIComponent(v))).join(separatorArrayNoExplode(style));
+		const joinedValues = (allowReserved ? value : value.map((v) => encodeURIComponent(v))).join(separatorArrayNoExplode(style));
 		switch (style) {
-			case "label": return `.${joinedValues$1}`;
-			case "matrix": return `;${name}=${joinedValues$1}`;
-			case "simple": return joinedValues$1;
-			default: return `${name}=${joinedValues$1}`;
+			case "label": return `.${joinedValues}`;
+			case "matrix": return `;${name}=${joinedValues}`;
+			case "simple": return joinedValues;
+			default: return `${name}=${joinedValues}`;
 		}
 	}
 	const separator = separatorArrayExplode(style);
@@ -163,12 +157,12 @@ const serializeObjectParam = ({ allowReserved, explode, name, style, value, valu
 				allowReserved ? v : encodeURIComponent(v)
 			];
 		});
-		const joinedValues$1 = values.join(",");
+		const joinedValues = values.join(",");
 		switch (style) {
-			case "form": return `${name}=${joinedValues$1}`;
-			case "label": return `.${joinedValues$1}`;
-			case "matrix": return `;${name}=${joinedValues$1}`;
-			default: return joinedValues$1;
+			case "form": return `${name}=${joinedValues}`;
+			case "label": return `.${joinedValues}`;
+			case "matrix": return `;${name}=${joinedValues}`;
+			default: return joinedValues;
 		}
 	}
 	const separator = separatorObjectExplode(style);
@@ -179,7 +173,6 @@ const serializeObjectParam = ({ allowReserved, explode, name, style, value, valu
 	})).join(separator);
 	return style === "label" || style === "matrix" ? separator + joinedValues : joinedValues;
 };
-
 //#endregion
 //#region src/api/generated/core/utils.gen.ts
 const PATH_PARAM_RE = /\{[^{}]+\}/g;
@@ -248,18 +241,12 @@ const getUrl = ({ baseUrl, path, query, querySerializer, url: _url }) => {
 };
 function getValidRequestBody(options) {
 	const hasBody = options.body !== void 0;
-	const isSerializedBody = hasBody && options.bodySerializer;
-	if (isSerializedBody) {
-		if ("serializedBody" in options) {
-			const hasSerializedBody = options.serializedBody !== void 0 && options.serializedBody !== "";
-			return hasSerializedBody ? options.serializedBody : null;
-		}
+	if (hasBody && options.bodySerializer) {
+		if ("serializedBody" in options) return options.serializedBody !== void 0 && options.serializedBody !== "" ? options.serializedBody : null;
 		return options.body !== "" ? options.body : null;
 	}
 	if (hasBody) return options.body;
-	return void 0;
 }
-
 //#endregion
 //#region src/api/generated/core/auth.gen.ts
 const getAuthToken = async (auth, callback) => {
@@ -269,10 +256,9 @@ const getAuthToken = async (auth, callback) => {
 	if (auth.scheme === "basic") return `Basic ${btoa(token)}`;
 	return token;
 };
-
 //#endregion
 //#region src/api/generated/client/utils.gen.ts
-const createQuerySerializer = ({ parameters = {},...args } = {}) => {
+const createQuerySerializer = ({ parameters = {}, ...args } = {}) => {
 	const querySerializer = (queryParams) => {
 		const search = [];
 		if (queryParams && typeof queryParams === "object") for (const name in queryParams) {
@@ -328,14 +314,13 @@ const getParseAs = (contentType) => {
 		"video/"
 	].some((type) => cleanContent.startsWith(type))) return "blob";
 	if (cleanContent.startsWith("text/")) return "text";
-	return;
 };
 const checkForExistence = (options, name) => {
 	if (!name) return false;
 	if (options.headers.has(name) || options.query?.[name] || options.headers.get("Cookie")?.includes(`${name}=`)) return true;
 	return false;
 };
-const setAuthParams = async ({ security,...options }) => {
+const setAuthParams = async ({ security, ...options }) => {
 	for (const auth of security) {
 		if (checkForExistence(options, auth.name)) continue;
 		const token = await getAuthToken(auth, options.auth);
@@ -349,7 +334,6 @@ const setAuthParams = async ({ security,...options }) => {
 			case "cookie":
 				options.headers.append("Cookie", `${name}=${token}`);
 				break;
-			case "header":
 			default:
 				options.headers.set(name, token);
 				break;
@@ -444,14 +428,13 @@ const createConfig = (override = {}) => ({
 	querySerializer: defaultQuerySerializer,
 	...override
 });
-
 //#endregion
 //#region src/api/generated/client/client.gen.ts
 const createClient = (config = {}) => {
 	let _config = mergeConfigs(createConfig(), config);
 	const getConfig = () => ({ ..._config });
-	const setConfig = (config$1) => {
-		_config = mergeConfigs(_config, config$1);
+	const setConfig = (config) => {
+		_config = mergeConfigs(_config, config);
 		return getConfig();
 	};
 	const interceptors = createInterceptors();
@@ -471,10 +454,9 @@ const createClient = (config = {}) => {
 		if (opts.body !== void 0 && opts.bodySerializer) opts.serializedBody = opts.bodySerializer(opts.body);
 		if (opts.body === void 0 || opts.serializedBody === "") opts.headers.delete("Content-Type");
 		const resolvedOpts = opts;
-		const url = buildUrl(resolvedOpts);
 		return {
 			opts: resolvedOpts,
-			url
+			url: buildUrl(resolvedOpts)
 		};
 	};
 	const request = async (options) => {
@@ -484,26 +466,26 @@ const createClient = (config = {}) => {
 			...opts,
 			body: getValidRequestBody(opts)
 		};
-		let request$1 = new Request(url, requestInit);
-		for (const fn of interceptors.request.fns) if (fn) request$1 = await fn(request$1, opts);
+		let request = new Request(url, requestInit);
+		for (const fn of interceptors.request.fns) if (fn) request = await fn(request, opts);
 		const _fetch = opts.fetch;
 		let response;
 		try {
-			response = await _fetch(request$1);
-		} catch (error$1) {
-			let finalError$1 = error$1;
-			for (const fn of interceptors.error.fns) if (fn) finalError$1 = await fn(error$1, void 0, request$1, opts);
-			finalError$1 = finalError$1 || {};
-			if (opts.throwOnError) throw finalError$1;
+			response = await _fetch(request);
+		} catch (error) {
+			let finalError = error;
+			for (const fn of interceptors.error.fns) if (fn) finalError = await fn(error, void 0, request, opts);
+			finalError = finalError || {};
+			if (opts.throwOnError) throw finalError;
 			return opts.responseStyle === "data" ? void 0 : {
-				error: finalError$1,
-				request: request$1,
+				error: finalError,
+				request,
 				response: void 0
 			};
 		}
-		for (const fn of interceptors.response.fns) if (fn) response = await fn(response, request$1, opts);
+		for (const fn of interceptors.response.fns) if (fn) response = await fn(response, request, opts);
 		const result = {
-			request: request$1,
+			request,
 			response
 		};
 		if (response.ok) {
@@ -522,7 +504,6 @@ const createClient = (config = {}) => {
 					case "stream":
 						emptyData = response.body;
 						break;
-					case "json":
 					default:
 						emptyData = {};
 						break;
@@ -566,7 +547,7 @@ const createClient = (config = {}) => {
 		} catch {}
 		const error = jsonError ?? textError;
 		let finalError = error;
-		for (const fn of interceptors.error.fns) if (fn) finalError = await fn(error, response, request$1, opts);
+		for (const fn of interceptors.error.fns) if (fn) finalError = await fn(error, response, request, opts);
 		finalError = finalError || {};
 		if (opts.throwOnError) throw finalError;
 		return opts.responseStyle === "data" ? void 0 : {
@@ -585,10 +566,10 @@ const createClient = (config = {}) => {
 			body: opts.body,
 			headers: opts.headers,
 			method,
-			onRequest: async (url$1, init) => {
-				let request$1 = new Request(url$1, init);
-				for (const fn of interceptors.request.fns) if (fn) request$1 = await fn(request$1, opts);
-				return request$1;
+			onRequest: async (url, init) => {
+				let request = new Request(url, init);
+				for (const fn of interceptors.request.fns) if (fn) request = await fn(request, opts);
+				return request;
 			},
 			serializedBody: getValidRequestBody(opts),
 			url
@@ -626,15 +607,12 @@ const createClient = (config = {}) => {
 		trace: makeMethodFn("TRACE")
 	};
 };
-
 //#endregion
 //#region src/api/generated/client.gen.ts
 const client$1 = createClient(createConfig({ baseUrl: "https://www.primitive.dev/api/v1" }));
-
 //#endregion
 //#region src/api/generated/sdk.gen.ts
-var sdk_gen_exports = {};
-__export(sdk_gen_exports, {
+var sdk_gen_exports = /* @__PURE__ */ __exportAll({
 	addDomain: () => addDomain,
 	createEndpoint: () => createEndpoint,
 	createFilter: () => createFilter,
@@ -655,6 +633,7 @@ __export(sdk_gen_exports, {
 	listFilters: () => listFilters,
 	replayDelivery: () => replayDelivery,
 	replayEmailWebhooks: () => replayEmailWebhooks,
+	replyToEmail: () => replyToEmail,
 	rotateWebhookSecret: () => rotateWebhookSecret,
 	sendEmail: () => sendEmail,
 	testEndpoint: () => testEndpoint,
@@ -894,6 +873,35 @@ const downloadAttachments = (options) => (options.client ?? client$1).get({
 	...options
 });
 /**
+* Reply to an inbound email
+*
+* Sends an outbound reply to the inbound email identified by `id`.
+* Threading headers (`In-Reply-To`, `References`), recipient
+* derivation (Reply-To, then From, then bare sender), and the
+* `Re:` subject prefix are all derived server-side from the
+* stored inbound row. The request body carries only the message
+* body and optional `wait` flag; passing any header or recipient
+* override is rejected by the schema (`additionalProperties:
+* false`).
+*
+* Forwards through the same gates as `/send-mail`: the response
+* status, error envelope, and `idempotent_replay` flag mirror
+* the send-mail contract verbatim.
+*
+*/
+const replyToEmail = (options) => (options.client ?? client$1).post({
+	security: [{
+		scheme: "bearer",
+		type: "http"
+	}],
+	url: "/emails/{id}/reply",
+	...options,
+	headers: {
+		"Content-Type": "application/json",
+		...options.headers
+	}
+});
+/**
 * Replay email webhooks
 *
 * Re-delivers the webhook payload for this email to all active
@@ -1110,7 +1118,6 @@ const sendEmail = (options) => (options.client ?? client$1).post({
 		...options.headers
 	}
 });
-
 //#endregion
 //#region src/api/index.ts
 const DEFAULT_BASE_URL = "https://www.primitive.dev/api/v1";
@@ -1122,7 +1129,6 @@ const MAX_TO_HEADER_LENGTH = 320;
 function createDefaultAuth(apiKey) {
 	return (security) => {
 		if (security.type === "http" && security.scheme === "bearer") return apiKey;
-		return void 0;
 	};
 }
 function validateAddressHeader(field, value) {
@@ -1218,7 +1224,7 @@ function parseRetryAfterHeader(response) {
 var PrimitiveApiClient = class {
 	client;
 	constructor(options = {}) {
-		const { apiKey, auth, baseUrl = DEFAULT_BASE_URL,...config } = options;
+		const { apiKey, auth, baseUrl = DEFAULT_BASE_URL, ...config } = options;
 		this.client = createClient(createConfig({
 			...config,
 			auth: auth ?? createDefaultAuth(apiKey),
@@ -1235,54 +1241,52 @@ var PrimitiveApiClient = class {
 var PrimitiveClient = class extends PrimitiveApiClient {
 	async send(input) {
 		validateSendInput(input);
-		const body = {
-			from: input.from,
-			to: input.to,
-			subject: input.subject,
-			...input.bodyText !== void 0 ? { body_text: input.bodyText } : {},
-			...input.bodyHtml !== void 0 ? { body_html: input.bodyHtml } : {},
-			...input.thread?.inReplyTo ? { in_reply_to: input.thread.inReplyTo } : {},
-			...input.thread?.references?.length ? { references: input.thread.references } : {},
-			...input.wait !== void 0 ? { wait: input.wait } : {},
-			...input.waitTimeoutMs !== void 0 ? { wait_timeout_ms: input.waitTimeoutMs } : {}
-		};
-		const result = await sendEmail({
-			body,
+		return unwrapSendResult(await sendEmail({
+			body: {
+				from: input.from,
+				to: input.to,
+				subject: input.subject,
+				...input.bodyText !== void 0 ? { body_text: input.bodyText } : {},
+				...input.bodyHtml !== void 0 ? { body_html: input.bodyHtml } : {},
+				...input.thread?.inReplyTo ? { in_reply_to: input.thread.inReplyTo } : {},
+				...input.thread?.references?.length ? { references: input.thread.references } : {},
+				...input.wait !== void 0 ? { wait: input.wait } : {},
+				...input.waitTimeoutMs !== void 0 ? { wait_timeout_ms: input.waitTimeoutMs } : {}
+			},
 			...input.idempotencyKey ? { headers: { "Idempotency-Key": input.idempotencyKey } } : {},
 			client: this.client,
 			responseStyle: "fields"
-		});
-		const response = result.response;
-		if (result.error) {
-			const parsed = parseApiErrorPayload(result.error);
-			throw new PrimitiveApiError(parsed.message, {
-				payload: result.error,
-				status: response?.status,
-				code: parsed.code,
-				gates: parsed.gates,
-				requestId: parsed.requestId,
-				retryAfter: parseRetryAfterHeader(response),
-				details: parsed.details
-			});
-		}
-		if (!result.data?.data) throw new PrimitiveApiError("Primitive API returned no send result", {
-			payload: result,
-			status: response?.status
-		});
-		return mapSendResult(result.data.data);
+		}));
 	}
+	/**
+	* Reply to an inbound email.
+	*
+	* Calls `POST /emails/{id}/reply`. The server derives recipients
+	* (Reply-To, then From, then sender), subject (`Re: <parent>` with
+	* idempotent prefix), and threading headers (`In-Reply-To`,
+	* `References`) from the stored inbound row. The customer controls
+	* only the body, an optional `from` override, and the `wait` flag.
+	*
+	* Subject overrides are intentionally not supported: Gmail's
+	* Conversation View needs both a References match and a normalized-
+	* subject match to thread, so a custom subject silently breaks the
+	* thread for half the recipient population.
+	*/
 	async reply(email, input) {
 		const resolved = typeof input === "string" ? { text: input } : input;
-		return this.send({
-			from: resolved.from ?? email.receivedBy,
-			to: email.replyTarget.address,
-			subject: resolved.subject ?? email.replySubject,
-			bodyText: resolved.text,
-			thread: {
-				...email.thread.messageId ? { inReplyTo: email.thread.messageId } : {},
-				references: email.thread.messageId ? [...email.thread.references, email.thread.messageId] : email.thread.references
-			}
-		});
+		if ("subject" in resolved) throw new TypeError("reply does not support a subject override; the server prepends 'Re:' to the parent's subject for thread continuity");
+		if (!resolved.text && !resolved.html) throw new TypeError("reply requires text or html");
+		return unwrapSendResult(await replyToEmail({
+			body: {
+				...resolved.text !== void 0 ? { body_text: resolved.text } : {},
+				...resolved.html !== void 0 ? { body_html: resolved.html } : {},
+				...resolved.from !== void 0 ? { from: resolved.from } : {},
+				...resolved.wait !== void 0 ? { wait: resolved.wait } : {}
+			},
+			path: { id: email.id },
+			client: this.client,
+			responseStyle: "fields"
+		}));
 	}
 	async forward(email, input) {
 		validateForwardInput(input);
@@ -1295,7 +1299,7 @@ var PrimitiveClient = class extends PrimitiveApiClient {
 	}
 };
 function buildForwardText(email, intro) {
-	const lines = [
+	return [
 		...intro ? [intro.trim(), ""] : [],
 		"---------- Forwarded message ----------",
 		`From: ${formatAddress(email.sender)}`,
@@ -1305,8 +1309,33 @@ function buildForwardText(email, intro) {
 		...email.thread.messageId ? [`Message-ID: ${email.thread.messageId}`] : [],
 		"",
 		email.text ?? ""
-	];
-	return lines.join("\n").trimEnd();
+	].join("\n").trimEnd();
+}
+/**
+* Shared response handler for `send`, `reply`, and any future
+* operation that returns a SendMailResult envelope. Unifies the
+* error-mapping path so the network call sites only have to invoke
+* the generated operation.
+*/
+function unwrapSendResult(result) {
+	const response = result.response;
+	if (result.error) {
+		const parsed = parseApiErrorPayload(result.error);
+		throw new PrimitiveApiError(parsed.message, {
+			payload: result.error,
+			status: response?.status,
+			code: parsed.code,
+			gates: parsed.gates,
+			requestId: parsed.requestId,
+			retryAfter: parseRetryAfterHeader(response),
+			details: parsed.details
+		});
+	}
+	if (!result.data?.data) throw new PrimitiveApiError("Primitive API returned no send result", {
+		payload: result,
+		status: response?.status
+	});
+	return mapSendResult(result.data.data);
 }
 function mapSendResult(result) {
 	return {
@@ -1318,6 +1347,7 @@ function mapSendResult(result) {
 		clientIdempotencyKey: result.client_idempotency_key,
 		requestId: result.request_id,
 		contentHash: result.content_hash,
+		idempotentReplay: result.idempotent_replay ?? false,
 		...result.delivery_status !== void 0 ? { deliveryStatus: result.delivery_status } : {},
 		...result.smtp_response_code !== void 0 ? { smtpResponseCode: result.smtp_response_code } : {},
 		...result.smtp_response_text !== void 0 ? { smtpResponseText: result.smtp_response_text } : {}
@@ -1333,6 +1363,5 @@ function client(options = {}) {
 	return new PrimitiveClient(options);
 }
 const operations = sdk_gen_exports;
-
 //#endregion
-export { DEFAULT_BASE_URL, PrimitiveApiClient, PrimitiveApiError, PrimitiveClient, addDomain, client, createEndpoint, createFilter, createPrimitiveApiClient, createPrimitiveClient, deleteDomain, deleteEmail, deleteEndpoint, deleteFilter, downloadAttachments, downloadRawEmail, getAccount, getEmail, getStorageStats, getWebhookSecret, listDeliveries, listDomains, listEmails, listEndpoints, listFilters, operations, replayDelivery, replayEmailWebhooks, rotateWebhookSecret, sendEmail, testEndpoint, updateAccount, updateDomain, updateEndpoint, updateFilter, verifyDomain };
+export { rotateWebhookSecret as A, listDomains as C, replayDelivery as D, listFilters as E, updateEndpoint as F, updateFilter as I, verifyDomain as L, testEndpoint as M, updateAccount as N, replayEmailWebhooks as O, updateDomain as P, listDeliveries as S, listEndpoints as T, downloadRawEmail as _, client as a, getStorageStats as b, operations as c, createFilter as d, deleteDomain as f, downloadAttachments as g, deleteFilter as h, PrimitiveClient as i, sendEmail as j, replyToEmail as k, addDomain as l, deleteEndpoint as m, PrimitiveApiClient as n, createPrimitiveApiClient as o, deleteEmail as p, PrimitiveApiError as r, createPrimitiveClient as s, DEFAULT_BASE_URL as t, createEndpoint as u, getAccount as v, listEmails as w, getWebhookSecret as x, getEmail as y };

package/dist/chunk-pbuEa-1d.js

@@ -0,0 +1,13 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+export { __exportAll as t };

package/dist/contract/index.d.ts

@@ -1,10 +1,7 @@
-import { EmailAddress, EmailAnalysis, EmailAuth, EmailReceivedEvent, ParsedDataComplete, ParsedDataFailed, ParsedError, RawContentDownloadOnly, RawContentInline, WebhookAttachment } from "../types-CIOzt1FY.js";
-import "../received-email-C67Z7Dha.js";
-import { SignResult, StandardWebhooksSignResult, WEBHOOK_VERSION$1 as WEBHOOK_VERSION, signStandardWebhooksPayload$1 as signStandardWebhooksPayload, signWebhookPayload$1 as signWebhookPayload } from "../index-CuuP1JkG.js";
+import { C as ParsedDataFailed, D as RawContentDownloadOnly, M as WebhookAttachment, O as RawContentInline, S as ParsedDataComplete, c as EmailAnalysis, l as EmailAuth, s as EmailAddress, u as EmailReceivedEvent, w as ParsedError } from "../types-9vXGZjPd.js";
+import { C as signStandardWebhooksPayload, h as WEBHOOK_VERSION, j as signWebhookPayload, k as SignResult, x as StandardWebhooksSignResult } from "../index-CbEivn3S.js";
 
 //#region src/contract/contract.d.ts
-/** Maximum raw email size for inline inclusion (256 KB). */
-
 /** Maximum raw email size for inline inclusion (256 KB). */
 declare const RAW_EMAIL_INLINE_THRESHOLD = 262144;
 /** Parsed content input when parsing succeeded. */
@@ -143,8 +140,7 @@ declare function generateEventId(endpoint_id: string, email_id: string): string;
  * ```
  */
 declare function buildEmailReceivedEvent(input: EmailReceivedEventInput, options?: {
-  /** Override the attempted-at timestamp, typically for tests. */
-  attempted_at?: string;
+  /** Override the attempted-at timestamp, typically for tests. */attempted_at?: string;
 }): EmailReceivedEvent;
 /**
  * Input for building an `EmailReceivedEvent` directly from parser output.
@@ -222,5 +218,6 @@ interface BuildEventFromParsedDataOptions {
  * @throws Error if `smtpRcptTo` is empty.
  * @throws WebhookValidationError if the assembled event fails schema validation.
  */
-declare function buildEventFromParsedData(params: BuildEventFromParsedDataOptions): EmailReceivedEvent; //#endregion
-export { BuildEventFromParsedDataOptions, EmailAddress, EmailAnalysis, EmailAuth, EmailReceivedEvent, EmailReceivedEventInput, ParsedDataComplete, ParsedDataFailed, ParsedError, ParsedInput, ParsedInputComplete, ParsedInputFailed, RAW_EMAIL_INLINE_THRESHOLD, RawContentDownloadOnly, RawContentInline, SignResult, StandardWebhooksSignResult, WEBHOOK_VERSION, WebhookAttachment, buildEmailReceivedEvent, buildEventFromParsedData, generateEventId, signStandardWebhooksPayload, signWebhookPayload };
+declare function buildEventFromParsedData(params: BuildEventFromParsedDataOptions): EmailReceivedEvent;
+//#endregion
+export { BuildEventFromParsedDataOptions, type EmailAddress, type EmailAnalysis, type EmailAuth, type EmailReceivedEvent, EmailReceivedEventInput, type ParsedDataComplete, type ParsedDataFailed, type ParsedError, ParsedInput, ParsedInputComplete, ParsedInputFailed, RAW_EMAIL_INLINE_THRESHOLD, type RawContentDownloadOnly, type RawContentInline, type SignResult, type StandardWebhooksSignResult, WEBHOOK_VERSION, type WebhookAttachment, buildEmailReceivedEvent, buildEventFromParsedData, generateEventId, signStandardWebhooksPayload, signWebhookPayload };

package/dist/contract/index.js

@@ -1,9 +1,25 @@
-import "../address-parser-CfPHs3mE.js";
-import "../received-email-Q6Cha3wc.js";
-import { WEBHOOK_VERSION, signStandardWebhooksPayload, signWebhookPayload, validateEmailReceivedEvent } from "../webhook-2TALcBQz.js";
+import { E as signStandardWebhooksPayload, L as validateEmailReceivedEvent, M as signWebhookPayload, d as WEBHOOK_VERSION } from "../webhook-zkN4wUTs.js";
 import { createHash } from "node:crypto";
-
 //#region src/contract/contract.ts
+/**
+* Primitive Contract
+*
+* This module exposes the exact functions used by Primitive servers to construct
+* webhook payloads. It serves two purposes:
+*
+* 1. **Build-time type safety**: Primitive producer code can import these types
+*    and functions so schema changes surface as TypeScript errors instead of
+*    runtime contract drift.
+*
+* 2. **Debugging transparency**: If you receive a malformed payload, you can
+*    compare it against these exact types and builder functions to identify
+*    which side broke the contract.
+*
+* This package is also useful for building test fixtures that match real
+* payloads exactly.
+*
+* @module @primitivedotdev/sdk/contract
+*/
 /** Maximum raw email size for inline inclusion (256 KB). */
 const RAW_EMAIL_INLINE_THRESHOLD = 262144;
 /**
@@ -42,8 +58,7 @@ function validateTimestamp(timestamp, fieldName) {
 */
 function generateEventId(endpoint_id, email_id) {
 	const hashInput = `email.received:${WEBHOOK_VERSION}:${endpoint_id}:${email_id}`;
-	const hash = createHash("sha256").update(hashInput).digest("hex");
-	return `evt_${hash}`;
+	return `evt_${createHash("sha256").update(hashInput).digest("hex")}`;
 }
 /**
 * Build an `EmailReceivedEvent` from producer-side input.
@@ -94,13 +109,12 @@ function generateEventId(endpoint_id, email_id) {
 */
 function buildEmailReceivedEvent(input, options) {
 	const event_id = generateEventId(input.endpoint_id, input.email_id);
-	const attempted_at = options?.attempted_at ? validateTimestamp(options.attempted_at, "attempted_at") : new Date().toISOString();
+	const attempted_at = options?.attempted_at ? validateTimestamp(options.attempted_at, "attempted_at") : (/* @__PURE__ */ new Date()).toISOString();
 	const raw_size_bytes = input.raw_bytes.length;
 	if (input.raw_size_bytes !== raw_size_bytes) throw new Error(`[@primitivedotdev/sdk/contract] Invalid raw_size_bytes: ${input.raw_size_bytes}. Expected ${raw_size_bytes} based on raw_bytes length`);
 	const raw_sha256 = createHash("sha256").update(input.raw_bytes).digest("hex");
 	if (input.raw_sha256 !== raw_sha256) throw new Error(`[@primitivedotdev/sdk/contract] Invalid raw_sha256: "${input.raw_sha256}". Expected ${raw_sha256} based on raw_bytes`);
-	const shouldInline = raw_size_bytes <= RAW_EMAIL_INLINE_THRESHOLD;
-	const rawContent = shouldInline ? {
+	const rawContent = raw_size_bytes <= 262144 ? {
 		included: true,
 		encoding: "base64",
 		max_inline_bytes: RAW_EMAIL_INLINE_THRESHOLD,
@@ -158,7 +172,7 @@ function buildEmailReceivedEvent(input, options) {
 		attachments: [],
 		attachments_download_url: null
 	};
-	const event = {
+	return validateEmailReceivedEvent({
 		id: event_id,
 		event: "email.received",
 		version: WEBHOOK_VERSION,
@@ -193,8 +207,7 @@ function buildEmailReceivedEvent(input, options) {
 			analysis: input.analysis,
 			auth: input.auth
 		}
-	};
-	return validateEmailReceivedEvent(event);
+	});
 }
 /**
 * Build an `EmailReceivedEvent` from parsed email data plus delivery metadata.
@@ -241,7 +254,7 @@ function buildEventFromParsedData(params) {
 		references: parsed.references,
 		attachments: parsed.attachments
 	};
-	const input = {
+	return buildEmailReceivedEvent({
 		email_id: params.emailId,
 		endpoint_id: params.endpointId,
 		message_id: params.messageId,
@@ -263,9 +276,7 @@ function buildEventFromParsedData(params) {
 		parsed: parsedInput,
 		auth: params.auth,
 		analysis: params.analysis
-	};
-	return buildEmailReceivedEvent(input, params.buildOptions);
+	}, params.buildOptions);
 }
-
 //#endregion
-export { RAW_EMAIL_INLINE_THRESHOLD, WEBHOOK_VERSION, buildEmailReceivedEvent, buildEventFromParsedData, generateEventId, signStandardWebhooksPayload, signWebhookPayload };
+export { RAW_EMAIL_INLINE_THRESHOLD, WEBHOOK_VERSION, buildEmailReceivedEvent, buildEventFromParsedData, generateEventId, signStandardWebhooksPayload, signWebhookPayload };