@shware/workflow 2.0.1 → 3.1.0

package/dist/aws/function-url.cjs

@@ -0,0 +1,62 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/aws/function-url.ts
+/**
+* An HTTP request, told apart by the event's own top-level shape — the Function URL wraps
+* every request in `requestContext.http`, so no request body can pass for anything else.
+*/
+function isFunctionUrlEvent(event) {
+	if (typeof event !== "object" || event === null) return false;
+	const { requestContext, rawPath } = event;
+	return typeof rawPath === "string" && typeof requestContext === "object" && requestContext !== null && typeof requestContext.http === "object" && requestContext.http !== null && typeof requestContext.http.method === "string";
+}
+function fromBase64(value) {
+	const binary = atob(value);
+	const bytes = new Uint8Array(binary.length);
+	for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
+	return bytes;
+}
+function toBase64(bytes) {
+	let binary = "";
+	for (let i = 0; i < bytes.length; i += 32768) binary += String.fromCharCode(...bytes.subarray(i, i + 32768));
+	return btoa(binary);
+}
+function toRequest(event) {
+	const method = event.requestContext.http.method.toUpperCase();
+	const headers = new Headers();
+	for (const [name, value] of Object.entries(event.headers ?? {})) if (value !== void 0) headers.set(name, value);
+	if (event.cookies !== void 0 && event.cookies.length > 0) headers.set("cookie", event.cookies.join("; "));
+	const host = event.requestContext.domainName ?? headers.get("host") ?? "localhost";
+	const query = event.rawQueryString === void 0 || event.rawQueryString === "" ? "" : `?${event.rawQueryString}`;
+	const hasBody = method !== "GET" && method !== "HEAD" && event.body !== void 0;
+	return new Request(`https://${host}${event.rawPath}${query}`, {
+		method,
+		headers,
+		...hasBody ? { body: event.isBase64Encoded === true ? fromBase64(event.body ?? "") : event.body } : {}
+	});
+}
+/** Content types sent as text; everything else (a tracking pixel) goes back base64. */
+const TEXTUAL = /^(text\/|application\/(json|javascript|xml|x-www-form-urlencoded)|image\/svg\+xml)/i;
+async function fromResponse(response, method) {
+	const headers = {};
+	const cookies = [];
+	response.headers.forEach((value, name) => {
+		if (name === "set-cookie") cookies.push(value);
+		else headers[name] = value;
+	});
+	const contentType = response.headers.get("content-type") ?? "";
+	const bytes = method.toUpperCase() === "HEAD" ? /* @__PURE__ */ new Uint8Array() : new Uint8Array(await response.arrayBuffer());
+	const textual = bytes.length === 0 || TEXTUAL.test(contentType);
+	return {
+		statusCode: response.status,
+		headers,
+		...cookies.length === 0 ? {} : { cookies },
+		body: textual ? new TextDecoder().decode(bytes) : toBase64(bytes),
+		isBase64Encoded: !textual
+	};
+}
+//#endregion
+exports.fromResponse = fromResponse;
+exports.isFunctionUrlEvent = isFunctionUrlEvent;
+exports.toRequest = toRequest;
+
+//# sourceMappingURL=function-url.cjs.map

package/dist/aws/function-url.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-url.cjs","names":[],"sources":["../../src/aws/function-url.ts"],"sourcesContent":["/**\n * Lambda Function URL events (payload format 2.0) as fetch `Request`s, and `Response`s back as\n * the result Lambda turns into the HTTP response — so the host's HTTP API runs unchanged.\n */\n\nexport interface FunctionUrlEvent {\n  version?: string;\n  rawPath: string;\n  rawQueryString?: string;\n  headers?: Record<string, string | undefined>;\n  cookies?: string[];\n  body?: string;\n  isBase64Encoded?: boolean;\n  requestContext: {\n    domainName?: string;\n    http: { method: string; sourceIp?: string; userAgent?: string };\n  };\n}\n\nexport interface FunctionUrlResult {\n  statusCode: number;\n  headers: Record<string, string>;\n  cookies?: string[];\n  body: string;\n  isBase64Encoded: boolean;\n}\n\n/**\n * An HTTP request, told apart by the event's own top-level shape — the Function URL wraps\n * every request in `requestContext.http`, so no request body can pass for anything else.\n */\nexport function isFunctionUrlEvent(event: unknown): event is FunctionUrlEvent {\n  if (typeof event !== 'object' || event === null) return false;\n  // Untrusted until checked: every level may be missing\n  const { requestContext, rawPath } = event as {\n    requestContext?: { http?: { method?: unknown } | null } | null;\n    rawPath?: unknown;\n  };\n  return (\n    typeof rawPath === 'string' &&\n    typeof requestContext === 'object' &&\n    requestContext !== null &&\n    typeof requestContext.http === 'object' &&\n    requestContext.http !== null &&\n    typeof requestContext.http.method === 'string'\n  );\n}\n\nfunction fromBase64(value: string): Uint8Array {\n  const binary = atob(value);\n  const bytes = new Uint8Array(binary.length);\n  for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);\n  return bytes;\n}\n\nfunction toBase64(bytes: Uint8Array): string {\n  let binary = '';\n  for (let i = 0; i < bytes.length; i += 0x8000) {\n    binary += String.fromCharCode(...bytes.subarray(i, i + 0x8000));\n  }\n  return btoa(binary);\n}\n\nexport function toRequest(event: FunctionUrlEvent): Request {\n  const method = event.requestContext.http.method.toUpperCase();\n  const headers = new Headers();\n  for (const [name, value] of Object.entries(event.headers ?? {})) {\n    if (value !== undefined) headers.set(name, value);\n  }\n  if (event.cookies !== undefined && event.cookies.length > 0) {\n    headers.set('cookie', event.cookies.join('; '));\n  }\n  const host = event.requestContext.domainName ?? headers.get('host') ?? 'localhost';\n  const query =\n    event.rawQueryString === undefined || event.rawQueryString === ''\n      ? ''\n      : `?${event.rawQueryString}`;\n  const hasBody = method !== 'GET' && method !== 'HEAD' && event.body !== undefined;\n  return new Request(`https://${host}${event.rawPath}${query}`, {\n    method,\n    headers,\n    ...(hasBody\n      ? { body: event.isBase64Encoded === true ? fromBase64(event.body ?? '') : event.body }\n      : {}),\n  });\n}\n\n/** Content types sent as text; everything else (a tracking pixel) goes back base64. */\nconst TEXTUAL =\n  /^(text\\/|application\\/(json|javascript|xml|x-www-form-urlencoded)|image\\/svg\\+xml)/i;\n\nexport async function fromResponse(response: Response, method: string): Promise<FunctionUrlResult> {\n  const headers: Record<string, string> = {};\n  const cookies: string[] = [];\n  response.headers.forEach((value, name) => {\n    if (name === 'set-cookie') cookies.push(value);\n    else headers[name] = value;\n  });\n  const contentType = response.headers.get('content-type') ?? '';\n  const head = method.toUpperCase() === 'HEAD';\n  const bytes = head ? new Uint8Array() : new Uint8Array(await response.arrayBuffer());\n  const textual = bytes.length === 0 || TEXTUAL.test(contentType);\n  return {\n    statusCode: response.status,\n    headers,\n    ...(cookies.length === 0 ? {} : { cookies }),\n    body: textual ? new TextDecoder().decode(bytes) : toBase64(bytes),\n    isBase64Encoded: !textual,\n  };\n}\n"],"mappings":";;;;;;AA+BA,SAAgB,mBAAmB,OAA2C;CAC5E,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CAExD,MAAM,EAAE,gBAAgB,YAAY;CAIpC,OACE,OAAO,YAAY,YACnB,OAAO,mBAAmB,YAC1B,mBAAmB,QACnB,OAAO,eAAe,SAAS,YAC/B,eAAe,SAAS,QACxB,OAAO,eAAe,KAAK,WAAW;AAE1C;AAEA,SAAS,WAAW,OAA2B;CAC7C,MAAM,SAAS,KAAK,KAAK;CACzB,MAAM,QAAQ,IAAI,WAAW,OAAO,MAAM;CAC1C,KAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK,MAAM,KAAK,OAAO,WAAW,CAAC;CACtE,OAAO;AACT;AAEA,SAAS,SAAS,OAA2B;CAC3C,IAAI,SAAS;CACb,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK,OACrC,UAAU,OAAO,aAAa,GAAG,MAAM,SAAS,GAAG,IAAI,KAAM,CAAC;CAEhE,OAAO,KAAK,MAAM;AACpB;AAEA,SAAgB,UAAU,OAAkC;CAC1D,MAAM,SAAS,MAAM,eAAe,KAAK,OAAO,YAAY;CAC5D,MAAM,UAAU,IAAI,QAAQ;CAC5B,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,MAAM,WAAW,CAAC,CAAC,GAC5D,IAAI,UAAU,KAAA,GAAW,QAAQ,IAAI,MAAM,KAAK;CAElD,IAAI,MAAM,YAAY,KAAA,KAAa,MAAM,QAAQ,SAAS,GACxD,QAAQ,IAAI,UAAU,MAAM,QAAQ,KAAK,IAAI,CAAC;CAEhD,MAAM,OAAO,MAAM,eAAe,cAAc,QAAQ,IAAI,MAAM,KAAK;CACvE,MAAM,QACJ,MAAM,mBAAmB,KAAA,KAAa,MAAM,mBAAmB,KAC3D,KACA,IAAI,MAAM;CAChB,MAAM,UAAU,WAAW,SAAS,WAAW,UAAU,MAAM,SAAS,KAAA;CACxE,OAAO,IAAI,QAAQ,WAAW,OAAO,MAAM,UAAU,SAAS;EAC5D;EACA;EACA,GAAI,UACA,EAAE,MAAM,MAAM,oBAAoB,OAAO,WAAW,MAAM,QAAQ,EAAE,IAAI,MAAM,KAAK,IACnF,CAAC;CACP,CAAC;AACH;;AAGA,MAAM,UACJ;AAEF,eAAsB,aAAa,UAAoB,QAA4C;CACjG,MAAM,UAAkC,CAAC;CACzC,MAAM,UAAoB,CAAC;CAC3B,SAAS,QAAQ,SAAS,OAAO,SAAS;EACxC,IAAI,SAAS,cAAc,QAAQ,KAAK,KAAK;OACxC,QAAQ,QAAQ;CACvB,CAAC;CACD,MAAM,cAAc,SAAS,QAAQ,IAAI,cAAc,KAAK;CAE5D,MAAM,QADO,OAAO,YAAY,MAAM,yBACjB,IAAI,WAAW,IAAI,IAAI,WAAW,MAAM,SAAS,YAAY,CAAC;CACnF,MAAM,UAAU,MAAM,WAAW,KAAK,QAAQ,KAAK,WAAW;CAC9D,OAAO;EACL,YAAY,SAAS;EACrB;EACA,GAAI,QAAQ,WAAW,IAAI,CAAC,IAAI,EAAE,QAAQ;EAC1C,MAAM,UAAU,IAAI,YAAY,CAAC,CAAC,OAAO,KAAK,IAAI,SAAS,KAAK;EAChE,iBAAiB,CAAC;CACpB;AACF"}

package/dist/aws/function-url.d.cts

@@ -0,0 +1,38 @@
+//#region src/aws/function-url.d.ts
+/**
+ * Lambda Function URL events (payload format 2.0) as fetch `Request`s, and `Response`s back as
+ * the result Lambda turns into the HTTP response — so the host's HTTP API runs unchanged.
+ */
+export interface FunctionUrlEvent {
+  version?: string;
+  rawPath: string;
+  rawQueryString?: string;
+  headers?: Record<string, string | undefined>;
+  cookies?: string[];
+  body?: string;
+  isBase64Encoded?: boolean;
+  requestContext: {
+    domainName?: string;
+    http: {
+      method: string;
+      sourceIp?: string;
+      userAgent?: string;
+    };
+  };
+}
+export interface FunctionUrlResult {
+  statusCode: number;
+  headers: Record<string, string>;
+  cookies?: string[];
+  body: string;
+  isBase64Encoded: boolean;
+}
+/**
+ * An HTTP request, told apart by the event's own top-level shape — the Function URL wraps
+ * every request in `requestContext.http`, so no request body can pass for anything else.
+ */
+export declare function isFunctionUrlEvent(event: unknown): event is FunctionUrlEvent;
+export declare function toRequest(event: FunctionUrlEvent): Request;
+export declare function fromResponse(response: Response, method: string): Promise<FunctionUrlResult>;
+//#endregion
+//# sourceMappingURL=function-url.d.cts.map

package/dist/aws/function-url.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-url.d.cts","names":[],"sources":["../../src/aws/function-url.ts"],"mappings":";;;;;iBAKiB;EACf;EACA;EACA;EACA,UAAU;EACV;EACA;EACA;EACA;IACE;IACA;MAAQ;MAAgB;MAAmB;;;;iBAI9B;EACf;EACA,SAAS;EACT;EACA;EACA;;;;;;wBAOc,mBAAmB,iBAAiB,SAAS;wBAgC7C,UAAU,OAAO,mBAAmB;wBA4B9B,aAAa,UAAU,UAAU,iBAAiB,QAAQ"}

package/dist/aws/function-url.d.mts

@@ -0,0 +1,38 @@
+//#region src/aws/function-url.d.ts
+/**
+ * Lambda Function URL events (payload format 2.0) as fetch `Request`s, and `Response`s back as
+ * the result Lambda turns into the HTTP response — so the host's HTTP API runs unchanged.
+ */
+export interface FunctionUrlEvent {
+  version?: string;
+  rawPath: string;
+  rawQueryString?: string;
+  headers?: Record<string, string | undefined>;
+  cookies?: string[];
+  body?: string;
+  isBase64Encoded?: boolean;
+  requestContext: {
+    domainName?: string;
+    http: {
+      method: string;
+      sourceIp?: string;
+      userAgent?: string;
+    };
+  };
+}
+export interface FunctionUrlResult {
+  statusCode: number;
+  headers: Record<string, string>;
+  cookies?: string[];
+  body: string;
+  isBase64Encoded: boolean;
+}
+/**
+ * An HTTP request, told apart by the event's own top-level shape — the Function URL wraps
+ * every request in `requestContext.http`, so no request body can pass for anything else.
+ */
+export declare function isFunctionUrlEvent(event: unknown): event is FunctionUrlEvent;
+export declare function toRequest(event: FunctionUrlEvent): Request;
+export declare function fromResponse(response: Response, method: string): Promise<FunctionUrlResult>;
+//#endregion
+//# sourceMappingURL=function-url.d.mts.map

package/dist/aws/function-url.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-url.d.mts","names":[],"sources":["../../src/aws/function-url.ts"],"mappings":";;;;;iBAKiB;EACf;EACA;EACA;EACA,UAAU;EACV;EACA;EACA;EACA;IACE;IACA;MAAQ;MAAgB;MAAmB;;;;iBAI9B;EACf;EACA,SAAS;EACT;EACA;EACA;;;;;;wBAOc,mBAAmB,iBAAiB,SAAS;wBAgC7C,UAAU,OAAO,mBAAmB;wBA4B9B,aAAa,UAAU,UAAU,iBAAiB,QAAQ"}

package/dist/aws/function-url.mjs

@@ -0,0 +1,59 @@
+//#region src/aws/function-url.ts
+/**
+* An HTTP request, told apart by the event's own top-level shape — the Function URL wraps
+* every request in `requestContext.http`, so no request body can pass for anything else.
+*/
+function isFunctionUrlEvent(event) {
+	if (typeof event !== "object" || event === null) return false;
+	const { requestContext, rawPath } = event;
+	return typeof rawPath === "string" && typeof requestContext === "object" && requestContext !== null && typeof requestContext.http === "object" && requestContext.http !== null && typeof requestContext.http.method === "string";
+}
+function fromBase64(value) {
+	const binary = atob(value);
+	const bytes = new Uint8Array(binary.length);
+	for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
+	return bytes;
+}
+function toBase64(bytes) {
+	let binary = "";
+	for (let i = 0; i < bytes.length; i += 32768) binary += String.fromCharCode(...bytes.subarray(i, i + 32768));
+	return btoa(binary);
+}
+function toRequest(event) {
+	const method = event.requestContext.http.method.toUpperCase();
+	const headers = new Headers();
+	for (const [name, value] of Object.entries(event.headers ?? {})) if (value !== void 0) headers.set(name, value);
+	if (event.cookies !== void 0 && event.cookies.length > 0) headers.set("cookie", event.cookies.join("; "));
+	const host = event.requestContext.domainName ?? headers.get("host") ?? "localhost";
+	const query = event.rawQueryString === void 0 || event.rawQueryString === "" ? "" : `?${event.rawQueryString}`;
+	const hasBody = method !== "GET" && method !== "HEAD" && event.body !== void 0;
+	return new Request(`https://${host}${event.rawPath}${query}`, {
+		method,
+		headers,
+		...hasBody ? { body: event.isBase64Encoded === true ? fromBase64(event.body ?? "") : event.body } : {}
+	});
+}
+/** Content types sent as text; everything else (a tracking pixel) goes back base64. */
+const TEXTUAL = /^(text\/|application\/(json|javascript|xml|x-www-form-urlencoded)|image\/svg\+xml)/i;
+async function fromResponse(response, method) {
+	const headers = {};
+	const cookies = [];
+	response.headers.forEach((value, name) => {
+		if (name === "set-cookie") cookies.push(value);
+		else headers[name] = value;
+	});
+	const contentType = response.headers.get("content-type") ?? "";
+	const bytes = method.toUpperCase() === "HEAD" ? /* @__PURE__ */ new Uint8Array() : new Uint8Array(await response.arrayBuffer());
+	const textual = bytes.length === 0 || TEXTUAL.test(contentType);
+	return {
+		statusCode: response.status,
+		headers,
+		...cookies.length === 0 ? {} : { cookies },
+		body: textual ? new TextDecoder().decode(bytes) : toBase64(bytes),
+		isBase64Encoded: !textual
+	};
+}
+//#endregion
+export { fromResponse, isFunctionUrlEvent, toRequest };
+
+//# sourceMappingURL=function-url.mjs.map

package/dist/aws/function-url.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-url.mjs","names":[],"sources":["../../src/aws/function-url.ts"],"sourcesContent":["/**\n * Lambda Function URL events (payload format 2.0) as fetch `Request`s, and `Response`s back as\n * the result Lambda turns into the HTTP response — so the host's HTTP API runs unchanged.\n */\n\nexport interface FunctionUrlEvent {\n  version?: string;\n  rawPath: string;\n  rawQueryString?: string;\n  headers?: Record<string, string | undefined>;\n  cookies?: string[];\n  body?: string;\n  isBase64Encoded?: boolean;\n  requestContext: {\n    domainName?: string;\n    http: { method: string; sourceIp?: string; userAgent?: string };\n  };\n}\n\nexport interface FunctionUrlResult {\n  statusCode: number;\n  headers: Record<string, string>;\n  cookies?: string[];\n  body: string;\n  isBase64Encoded: boolean;\n}\n\n/**\n * An HTTP request, told apart by the event's own top-level shape — the Function URL wraps\n * every request in `requestContext.http`, so no request body can pass for anything else.\n */\nexport function isFunctionUrlEvent(event: unknown): event is FunctionUrlEvent {\n  if (typeof event !== 'object' || event === null) return false;\n  // Untrusted until checked: every level may be missing\n  const { requestContext, rawPath } = event as {\n    requestContext?: { http?: { method?: unknown } | null } | null;\n    rawPath?: unknown;\n  };\n  return (\n    typeof rawPath === 'string' &&\n    typeof requestContext === 'object' &&\n    requestContext !== null &&\n    typeof requestContext.http === 'object' &&\n    requestContext.http !== null &&\n    typeof requestContext.http.method === 'string'\n  );\n}\n\nfunction fromBase64(value: string): Uint8Array {\n  const binary = atob(value);\n  const bytes = new Uint8Array(binary.length);\n  for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);\n  return bytes;\n}\n\nfunction toBase64(bytes: Uint8Array): string {\n  let binary = '';\n  for (let i = 0; i < bytes.length; i += 0x8000) {\n    binary += String.fromCharCode(...bytes.subarray(i, i + 0x8000));\n  }\n  return btoa(binary);\n}\n\nexport function toRequest(event: FunctionUrlEvent): Request {\n  const method = event.requestContext.http.method.toUpperCase();\n  const headers = new Headers();\n  for (const [name, value] of Object.entries(event.headers ?? {})) {\n    if (value !== undefined) headers.set(name, value);\n  }\n  if (event.cookies !== undefined && event.cookies.length > 0) {\n    headers.set('cookie', event.cookies.join('; '));\n  }\n  const host = event.requestContext.domainName ?? headers.get('host') ?? 'localhost';\n  const query =\n    event.rawQueryString === undefined || event.rawQueryString === ''\n      ? ''\n      : `?${event.rawQueryString}`;\n  const hasBody = method !== 'GET' && method !== 'HEAD' && event.body !== undefined;\n  return new Request(`https://${host}${event.rawPath}${query}`, {\n    method,\n    headers,\n    ...(hasBody\n      ? { body: event.isBase64Encoded === true ? fromBase64(event.body ?? '') : event.body }\n      : {}),\n  });\n}\n\n/** Content types sent as text; everything else (a tracking pixel) goes back base64. */\nconst TEXTUAL =\n  /^(text\\/|application\\/(json|javascript|xml|x-www-form-urlencoded)|image\\/svg\\+xml)/i;\n\nexport async function fromResponse(response: Response, method: string): Promise<FunctionUrlResult> {\n  const headers: Record<string, string> = {};\n  const cookies: string[] = [];\n  response.headers.forEach((value, name) => {\n    if (name === 'set-cookie') cookies.push(value);\n    else headers[name] = value;\n  });\n  const contentType = response.headers.get('content-type') ?? '';\n  const head = method.toUpperCase() === 'HEAD';\n  const bytes = head ? new Uint8Array() : new Uint8Array(await response.arrayBuffer());\n  const textual = bytes.length === 0 || TEXTUAL.test(contentType);\n  return {\n    statusCode: response.status,\n    headers,\n    ...(cookies.length === 0 ? {} : { cookies }),\n    body: textual ? new TextDecoder().decode(bytes) : toBase64(bytes),\n    isBase64Encoded: !textual,\n  };\n}\n"],"mappings":";;;;;AA+BA,SAAgB,mBAAmB,OAA2C;CAC5E,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CAExD,MAAM,EAAE,gBAAgB,YAAY;CAIpC,OACE,OAAO,YAAY,YACnB,OAAO,mBAAmB,YAC1B,mBAAmB,QACnB,OAAO,eAAe,SAAS,YAC/B,eAAe,SAAS,QACxB,OAAO,eAAe,KAAK,WAAW;AAE1C;AAEA,SAAS,WAAW,OAA2B;CAC7C,MAAM,SAAS,KAAK,KAAK;CACzB,MAAM,QAAQ,IAAI,WAAW,OAAO,MAAM;CAC1C,KAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK,MAAM,KAAK,OAAO,WAAW,CAAC;CACtE,OAAO;AACT;AAEA,SAAS,SAAS,OAA2B;CAC3C,IAAI,SAAS;CACb,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK,OACrC,UAAU,OAAO,aAAa,GAAG,MAAM,SAAS,GAAG,IAAI,KAAM,CAAC;CAEhE,OAAO,KAAK,MAAM;AACpB;AAEA,SAAgB,UAAU,OAAkC;CAC1D,MAAM,SAAS,MAAM,eAAe,KAAK,OAAO,YAAY;CAC5D,MAAM,UAAU,IAAI,QAAQ;CAC5B,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,MAAM,WAAW,CAAC,CAAC,GAC5D,IAAI,UAAU,KAAA,GAAW,QAAQ,IAAI,MAAM,KAAK;CAElD,IAAI,MAAM,YAAY,KAAA,KAAa,MAAM,QAAQ,SAAS,GACxD,QAAQ,IAAI,UAAU,MAAM,QAAQ,KAAK,IAAI,CAAC;CAEhD,MAAM,OAAO,MAAM,eAAe,cAAc,QAAQ,IAAI,MAAM,KAAK;CACvE,MAAM,QACJ,MAAM,mBAAmB,KAAA,KAAa,MAAM,mBAAmB,KAC3D,KACA,IAAI,MAAM;CAChB,MAAM,UAAU,WAAW,SAAS,WAAW,UAAU,MAAM,SAAS,KAAA;CACxE,OAAO,IAAI,QAAQ,WAAW,OAAO,MAAM,UAAU,SAAS;EAC5D;EACA;EACA,GAAI,UACA,EAAE,MAAM,MAAM,oBAAoB,OAAO,WAAW,MAAM,QAAQ,EAAE,IAAI,MAAM,KAAK,IACnF,CAAC;CACP,CAAC;AACH;;AAGA,MAAM,UACJ;AAEF,eAAsB,aAAa,UAAoB,QAA4C;CACjG,MAAM,UAAkC,CAAC;CACzC,MAAM,UAAoB,CAAC;CAC3B,SAAS,QAAQ,SAAS,OAAO,SAAS;EACxC,IAAI,SAAS,cAAc,QAAQ,KAAK,KAAK;OACxC,QAAQ,QAAQ;CACvB,CAAC;CACD,MAAM,cAAc,SAAS,QAAQ,IAAI,cAAc,KAAK;CAE5D,MAAM,QADO,OAAO,YAAY,MAAM,yBACjB,IAAI,WAAW,IAAI,IAAI,WAAW,MAAM,SAAS,YAAY,CAAC;CACnF,MAAM,UAAU,MAAM,WAAW,KAAK,QAAQ,KAAK,WAAW;CAC9D,OAAO;EACL,YAAY,SAAS;EACrB;EACA,GAAI,QAAQ,WAAW,IAAI,CAAC,IAAI,EAAE,QAAQ;EAC1C,MAAM,UAAU,IAAI,YAAY,CAAC,CAAC,OAAO,KAAK,IAAI,SAAS,KAAK;EAChE,iBAAiB,CAAC;CACpB;AACF"}

package/dist/aws/index.cjs

@@ -0,0 +1,160 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_http2_client = require("../http2-client.cjs");
+const require_aws_engine_step = require("./engine-step.cjs");
+const require_aws_function_url = require("./function-url.cjs");
+const require_host_router = require("../host/router.cjs");
+const require_host_execute = require("../host/execute.cjs");
+const require_host_journey_host = require("../host/journey-host.cjs");
+const require_aws_instances = require("./instances.cjs");
+const require_aws_lambda_api = require("./lambda-api.cjs");
+let _aws_durable_execution_sdk_js = require("@aws/durable-execution-sdk-js");
+let node_async_hooks = require("node:async_hooks");
+//#region src/aws/index.ts
+/**
+* `@shware/workflow/aws` — the journey host as one Lambda durable function behind a Function
+* URL, on Postgres.
+*
+* The one handler tells three inputs apart by the event's top-level shape: a Function URL
+* request (the HTTP API — ingest, identify, devices, tracking, bundle, preview), an internal run
+* (one journey instance: one durable execution, started by an asynchronous invoke of this
+* function's own numbered version), and a scheduled maintenance tick. An HTTP body can never
+* pass for the other two: the Function URL always wraps it.
+*
+*   const journeys = journeyLambda({
+*     config,
+*     env,                                        // parsed from process.env (zod)
+*     store: (env, database) => postgresJsStore(env.DATABASE_URL, database),
+*     email: (env) => sesEmailTransport({ region: env.AWS_REGION }),
+*   });
+*   export const handler = journeys.handler;
+*/
+/** The scheduled tick (EventBridge Scheduler's payload): the segment sweep and maintenance. */
+const SWEEP_EVENT_TYPE = "$workflow.sweep";
+/** This function's ARN without its qualifier, from the ARN it was invoked under. */
+function unqualified(invokedFunctionArn) {
+	return invokedFunctionArn.split(":").slice(0, 7).join(":");
+}
+const json = (body, status = 200) => new Response(JSON.stringify(body), {
+	status,
+	headers: { "content-type": "application/json" }
+});
+function journeyLambda(options) {
+	const { env: baseEnv, lambda: lambdaOption, startRetryMs, stopDrainMs, ...hostOptions } = options;
+	const host = require_host_journey_host.createJourneyHost({
+		...hostOptions,
+		store: (env, database) => options.store(env, database)
+	}, { apnsFetch: require_http2_client.http2Fetch() });
+	const lambda = lambdaOption ?? require_aws_lambda_api.sdkLambdaApi();
+	const ownHashes = new Set(host.bundle().workflows.map((workflow) => workflow.contentHash));
+	const scope = new node_async_hooks.AsyncLocalStorage();
+	/** The version this code was published as: `$LATEST` while developing. */
+	const ownVersion = () => process.env.AWS_LAMBDA_FUNCTION_VERSION ?? "$LATEST";
+	/** Numbered versions are ordered: the bundle compiled into a later one goes live by itself. */
+	const bundleVersion = () => {
+		const version = ownVersion();
+		return /^\d+$/.test(version) ? {
+			id: version,
+			createdAt: Number(version)
+		} : void 0;
+	};
+	/** The store and the env (with the instance port) of this invocation, opened on first use. */
+	const open = (context) => {
+		const invocation = scope.getStore();
+		if (invocation === void 0) throw new Error("journeyLambda: outside an invocation");
+		const placeholder = { ...baseEnv };
+		invocation.lease ??= host.lease(placeholder);
+		const { store } = invocation.lease;
+		const executions = store.executions;
+		if (executions === void 0) throw new Error("journeyLambda needs a store with an execution registry (PostgresJourneyStore)");
+		const functionArn = unqualified(context.lambdaContext.invokedFunctionArn);
+		const target = async (contentHash, version) => {
+			if (version !== void 0 && /^\d+$/.test(version)) return `${functionArn}:${version}`;
+			if (ownHashes.has(contentHash)) return `${functionArn}:${ownVersion()}`;
+			throw new Error(`no published version is known to carry workflow IR ${contentHash}`);
+		};
+		const instances = new require_aws_instances.AwsInstances({
+			store,
+			executions,
+			lambda,
+			target,
+			...startRetryMs === void 0 ? {} : { startRetryMs },
+			...stopDrainMs === void 0 ? {} : { stopDrainMs }
+		});
+		return {
+			store,
+			env: {
+				...baseEnv,
+				JOURNEY: instances
+			},
+			executions
+		};
+	};
+	const run = async (input, context) => {
+		const { store, env, executions } = open(context);
+		const { instanceId, params } = input;
+		await context.step("$workflow:started", async () => {
+			await executions.markSubmitted(instanceId, context.executionContext.durableExecutionArn, Date.now());
+		});
+		return require_host_execute.executeJourney({
+			instanceId,
+			params,
+			enteredAtMs: input.enteredAtMs,
+			step: new require_aws_engine_step.AwsEngineStep(context, store, executions, lambda, params.userId, instanceId)
+		}, host.runParts(env, store, params));
+	};
+	const http = (event, context) => {
+		const serve = async () => {
+			const method = event.requestContext.http.method;
+			try {
+				const { store, env } = open(context);
+				const request = require_aws_function_url.toRequest(event);
+				if (new URL(request.url).pathname === "/deploy") return await require_aws_function_url.fromResponse(json({ error: "deploy by publishing a version (POST /bundle/deploy applies its own bundle)" }, 409), method);
+				await host.applyOwnBundle(env, bundleVersion());
+				return await require_aws_function_url.fromResponse(await host.handle(request, env, store), method);
+			} catch (error) {
+				console.error("[workflow] request failed", error);
+				return require_aws_function_url.fromResponse(json({ error: "internal error" }, 500), method);
+			}
+		};
+		const method = event.requestContext.http.method.toUpperCase();
+		if (method === "GET" || method === "HEAD") return serve();
+		return context.step("http", serve, { retryStrategy: () => ({ shouldRetry: false }) });
+	};
+	const sweep = (context) => context.step("sweep", async () => {
+		const { store, env } = open(context);
+		await host.applyOwnBundle(env, bundleVersion());
+		return require_host_router.sweepSegments(env, store);
+	}, { retryStrategy: () => ({ shouldRetry: false }) });
+	const durable = (0, _aws_durable_execution_sdk_js.withDurableExecution)(async (input, context) => {
+		if (require_aws_function_url.isFunctionUrlEvent(input)) return http(input, context);
+		if (require_aws_instances.isRunInput(input)) return run(input, context);
+		if (typeof input === "object" && input !== null && input.type === "$workflow.sweep") return sweep(context);
+		throw new Error("journeyLambda: unrecognized event (not a Function URL request, run or sweep)");
+	});
+	const handler = async (event, context) => {
+		const invocation = {};
+		try {
+			return await scope.run(invocation, () => durable(event, context));
+		} finally {
+			await invocation.lease?.close().catch((error) => {
+				console.error("[workflow] closing the store failed", error);
+			});
+		}
+	};
+	return { handler };
+}
+//#endregion
+exports.AwsEngineStep = require_aws_engine_step.AwsEngineStep;
+exports.AwsInstances = require_aws_instances.AwsInstances;
+exports.RUN_EVENT_TYPE = require_aws_instances.RUN_EVENT_TYPE;
+exports.SWEEP_EVENT_TYPE = SWEEP_EVENT_TYPE;
+exports.executionName = require_aws_instances.executionName;
+exports.fromResponse = require_aws_function_url.fromResponse;
+exports.isFunctionUrlEvent = require_aws_function_url.isFunctionUrlEvent;
+exports.isRunInput = require_aws_instances.isRunInput;
+exports.journeyLambda = journeyLambda;
+exports.sdkLambdaApi = require_aws_lambda_api.sdkLambdaApi;
+exports.stepRetry = require_aws_engine_step.stepRetry;
+exports.toRequest = require_aws_function_url.toRequest;
+
+//# sourceMappingURL=index.cjs.map

package/dist/aws/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["createJourneyHost","http2Fetch","sdkLambdaApi","AsyncLocalStorage","AwsInstances","executeJourney","AwsEngineStep","toRequest","fromResponse","sweepSegments","withDurableExecution","isFunctionUrlEvent","isRunInput"],"sources":["../../src/aws/index.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks';\nimport {\n  type DurableContext,\n  type DurableExecutionInvocationInput,\n  type DurableExecutionInvocationOutput,\n  withDurableExecution,\n} from '@aws/durable-execution-sdk-js';\nimport type { JourneyEnv } from '../cloudflare/bindings';\nimport type { JourneyOutcome } from '../engine/ports';\nimport { executeJourney } from '../host/execute';\nimport { type JourneyHostOptions, createJourneyHost } from '../host/journey-host';\nimport { type SweepResult, sweepSegments } from '../host/router';\nimport { http2Fetch } from '../http2-client';\nimport type { BundleVersion, ExecutionRegistry, JourneyStore, StoreLease } from '../store/index';\nimport { AwsEngineStep } from './engine-step';\nimport {\n  type FunctionUrlEvent,\n  type FunctionUrlResult,\n  fromResponse,\n  isFunctionUrlEvent,\n  toRequest,\n} from './function-url';\nimport { AwsInstances, type RunInput, isRunInput } from './instances';\nimport { type LambdaApi, sdkLambdaApi } from './lambda-api';\n\n/**\n * `@shware/workflow/aws` — the journey host as one Lambda durable function behind a Function\n * URL, on Postgres.\n *\n * The one handler tells three inputs apart by the event's top-level shape: a Function URL\n * request (the HTTP API — ingest, identify, devices, tracking, bundle, preview), an internal run\n * (one journey instance: one durable execution, started by an asynchronous invoke of this\n * function's own numbered version), and a scheduled maintenance tick. An HTTP body can never\n * pass for the other two: the Function URL always wraps it.\n *\n *   const journeys = journeyLambda({\n *     config,\n *     env,                                        // parsed from process.env (zod)\n *     store: (env, database) => postgresJsStore(env.DATABASE_URL, database),\n *     email: (env) => sesEmailTransport({ region: env.AWS_REGION }),\n *   });\n *   export const handler = journeys.handler;\n */\n\n/** The scheduled tick (EventBridge Scheduler's payload): the segment sweep and maintenance. */\nexport const SWEEP_EVENT_TYPE = '$workflow.sweep';\n\n/** What journeyLambda reads from its env: `JourneyEnv` without the binding it supplies itself. */\nexport type JourneyLambdaEnv = Omit<JourneyEnv, 'JOURNEY' | 'DB' | 'WORKFLOW_KV' | 'EMAIL'>;\n\nexport interface JourneyLambdaOptions<Env extends JourneyLambdaEnv> extends Omit<\n  JourneyHostOptions<Env & JourneyEnv>,\n  'env' | 'store'\n> {\n  /** The validated environment (parsed from `process.env` with zod by the app). */\n  env: Env;\n  /** The Postgres store: AWS needs its execution registry (`postgresJsStore`). */\n  store: (env: Env, database: { schema: string }) => JourneyStore | StoreLease;\n  /** The Lambda control plane; `@aws-sdk/client-lambda` with the execution role by default. */\n  lambda?: LambdaApi;\n  /** How long an unconfirmed start is retried (default 12 hours; keep it under the retention). */\n  startRetryMs?: number;\n  /**\n   * How long an erasure waits after stopping an execution before it erases: an invocation\n   * running at the stop goes on to its next checkpoint. Set it to at least the function's\n   * timeout; 15 minutes (Lambda's maximum) by default.\n   */\n  stopDrainMs?: number;\n}\n\n/**\n * The Lambda invocation context, as far as the handler's signature needs it — declared here so\n * the package's types do not depend on `@types/aws-lambda`. Lambda passes the full object.\n */\nexport interface LambdaContext {\n  functionName: string;\n  functionVersion: string;\n  invokedFunctionArn: string;\n  awsRequestId: string;\n  getRemainingTimeInMillis(): number;\n}\n\nexport interface JourneyLambda {\n  /** Export as the function's handler. */\n  handler: (\n    event: DurableExecutionInvocationInput,\n    context: LambdaContext\n  ) => Promise<DurableExecutionInvocationOutput>;\n}\n\ninterface Invocation {\n  lease?: Required<StoreLease>;\n}\n\n/** This function's ARN without its qualifier, from the ARN it was invoked under. */\nfunction unqualified(invokedFunctionArn: string): string {\n  return invokedFunctionArn.split(':').slice(0, 7).join(':');\n}\n\nconst json = (body: unknown, status = 200) =>\n  new Response(JSON.stringify(body), { status, headers: { 'content-type': 'application/json' } });\n\nexport function journeyLambda<Env extends JourneyLambdaEnv>(\n  options: JourneyLambdaOptions<Env>\n): JourneyLambda {\n  type HostEnv = Env & JourneyEnv;\n  const { env: baseEnv, lambda: lambdaOption, startRetryMs, stopDrainMs, ...hostOptions } = options;\n  const host = createJourneyHost<HostEnv>(\n    { ...hostOptions, store: (env, database) => options.store(env, database) },\n    // Node 24's fetch cannot reach APNs (HTTP/2 only): see http2-client.ts for when this can go\n    { apnsFetch: http2Fetch() }\n  );\n  const lambda = lambdaOption ?? sdkLambdaApi();\n  const ownHashes = new Set(host.bundle().workflows.map((workflow) => workflow.contentHash));\n  const scope = new AsyncLocalStorage<Invocation>();\n\n  /** The version this code was published as: `$LATEST` while developing. */\n  const ownVersion = () => process.env.AWS_LAMBDA_FUNCTION_VERSION ?? '$LATEST';\n  /** Numbered versions are ordered: the bundle compiled into a later one goes live by itself. */\n  const bundleVersion = (): BundleVersion | undefined => {\n    const version = ownVersion();\n    return /^\\d+$/.test(version) ? { id: version, createdAt: Number(version) } : undefined;\n  };\n\n  /** The store and the env (with the instance port) of this invocation, opened on first use. */\n  const open = (\n    context: DurableContext\n  ): { store: JourneyStore; env: HostEnv; executions: ExecutionRegistry } => {\n    const invocation = scope.getStore();\n    if (invocation === undefined) throw new Error('journeyLambda: outside an invocation');\n    const placeholder = { ...baseEnv } as unknown as HostEnv;\n    invocation.lease ??= host.lease(placeholder);\n    const { store } = invocation.lease;\n    const executions = store.executions;\n    if (executions === undefined) {\n      throw new Error(\n        'journeyLambda needs a store with an execution registry (PostgresJourneyStore)'\n      );\n    }\n    const functionArn = unqualified(context.lambdaContext.invokedFunctionArn);\n    const target = async (contentHash: string, version?: string): Promise<string> => {\n      // An execution runs the code its IR was compiled with: the version whose bundle put the\n      // route there, read in the same row as the hash — never a separately read \"live\" version,\n      // which a release between the two reads would make another bundle's\n      if (version !== undefined && /^\\d+$/.test(version)) return `${functionArn}:${version}`;\n      // A forced deploy records no version: only this code's own workflows can run here\n      if (ownHashes.has(contentHash)) return `${functionArn}:${ownVersion()}`;\n      throw new Error(`no published version is known to carry workflow IR ${contentHash}`);\n    };\n    const instances = new AwsInstances({\n      store,\n      executions,\n      lambda,\n      target,\n      ...(startRetryMs === undefined ? {} : { startRetryMs }),\n      ...(stopDrainMs === undefined ? {} : { stopDrainMs }),\n    });\n    return { store, env: { ...baseEnv, JOURNEY: instances }, executions };\n  };\n\n  const run = async (input: RunInput, context: DurableContext): Promise<JourneyOutcome> => {\n    const { store, env, executions } = open(context);\n    const { instanceId, params } = input;\n    // Running is the proof the start got through, whatever became of the invoke's response\n    await context.step('$workflow:started', async () => {\n      await executions.markSubmitted(\n        instanceId,\n        context.executionContext.durableExecutionArn,\n        Date.now()\n      );\n    });\n    return executeJourney(\n      {\n        instanceId,\n        params,\n        enteredAtMs: input.enteredAtMs,\n        step: new AwsEngineStep(context, store, executions, lambda, params.userId, instanceId),\n      },\n      host.runParts(env, store, params)\n    );\n  };\n\n  const http = (event: FunctionUrlEvent, context: DurableContext): Promise<FunctionUrlResult> => {\n    const serve = async (): Promise<FunctionUrlResult> => {\n      const method = event.requestContext.http.method;\n      try {\n        const { store, env } = open(context);\n        const request = toRequest(event);\n        // Only the bundle compiled into a version may route: one is never swapped in by hand\n        if (new URL(request.url).pathname === '/deploy') {\n          return await fromResponse(\n            json(\n              {\n                error:\n                  'deploy by publishing a version (POST /bundle/deploy applies its own bundle)',\n              },\n              409\n            ),\n            method\n          );\n        }\n        await host.applyOwnBundle(env, bundleVersion());\n        return await fromResponse(await host.handle(request, env, store), method);\n      } catch (error) {\n        console.error('[workflow] request failed', error);\n        return fromResponse(json({ error: 'internal error' }, 500), method);\n      }\n    };\n    // A read (the bundle, a preview, a tracked link or pixel) answers straight from the handler:\n    // its body can be large, and a step would checkpoint all of it. A write runs in one step,\n    // never retried — the caller is waiting, and retries the request itself\n    const method = event.requestContext.http.method.toUpperCase();\n    if (method === 'GET' || method === 'HEAD') return serve();\n    return context.step('http', serve, { retryStrategy: () => ({ shouldRetry: false }) });\n  };\n\n  const sweep = (context: DurableContext): Promise<SweepResult> =>\n    context.step(\n      'sweep',\n      async () => {\n        const { store, env } = open(context);\n        await host.applyOwnBundle(env, bundleVersion());\n        return sweepSegments(env, store);\n      },\n      { retryStrategy: () => ({ shouldRetry: false }) }\n    );\n\n  const durable = withDurableExecution(async (input: unknown, context: DurableContext) => {\n    if (isFunctionUrlEvent(input)) return http(input, context);\n    if (isRunInput(input)) return run(input, context);\n    if (\n      typeof input === 'object' &&\n      input !== null &&\n      (input as { type?: unknown }).type === SWEEP_EVENT_TYPE\n    ) {\n      return sweep(context);\n    }\n    throw new Error('journeyLambda: unrecognized event (not a Function URL request, run or sweep)');\n  });\n\n  const handler = async (\n    event: DurableExecutionInvocationInput,\n    context: LambdaContext\n  ): Promise<DurableExecutionInvocationOutput> => {\n    const invocation: Invocation = {};\n    try {\n      // The durable wrapper reads the whole context Lambda passed, not just the fields above\n      return await scope.run(invocation, () =>\n        durable(event, context as Parameters<typeof durable>[1])\n      );\n    } finally {\n      // Outside the durable wrapper: a suspended run returns PENDING without unwinding the\n      // handler, so a `finally` in there would never release the connection\n      await invocation.lease?.close().catch((error: unknown) => {\n        console.error('[workflow] closing the store failed', error);\n      });\n    }\n  };\n\n  return { handler };\n}\n\nexport { AwsEngineStep, stepRetry } from './engine-step';\nexport { AwsInstances, RUN_EVENT_TYPE, executionName, isRunInput } from './instances';\nexport type { AwsInstancesOptions, RunInput } from './instances';\nexport { sdkLambdaApi } from './lambda-api';\nexport type { ExecutionState, LambdaApi } from './lambda-api';\nexport { fromResponse, isFunctionUrlEvent, toRequest } from './function-url';\nexport type { FunctionUrlEvent, FunctionUrlResult } from './function-url';\n"],"mappings":"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"}

package/dist/aws/index.d.cts

@@ -0,0 +1,68 @@
+import { JourneyEnv } from "../cloudflare/bindings.cjs";
+import { JourneyStore, StoreLease } from "../store/index.cjs";
+import { ExecutionState, LambdaApi, sdkLambdaApi } from "./lambda-api.cjs";
+import { AwsEngineStep, stepRetry } from "./engine-step.cjs";
+import { FunctionUrlEvent, FunctionUrlResult, fromResponse, isFunctionUrlEvent, toRequest } from "./function-url.cjs";
+import { JourneyHostOptions } from "../host/journey-host.cjs";
+import { AwsInstances, AwsInstancesOptions, RUN_EVENT_TYPE, RunInput, executionName, isRunInput } from "./instances.cjs";
+import { DurableExecutionInvocationInput, DurableExecutionInvocationOutput } from "@aws/durable-execution-sdk-js";
+//#region src/aws/index.d.ts
+/**
+ * `@shware/workflow/aws` — the journey host as one Lambda durable function behind a Function
+ * URL, on Postgres.
+ *
+ * The one handler tells three inputs apart by the event's top-level shape: a Function URL
+ * request (the HTTP API — ingest, identify, devices, tracking, bundle, preview), an internal run
+ * (one journey instance: one durable execution, started by an asynchronous invoke of this
+ * function's own numbered version), and a scheduled maintenance tick. An HTTP body can never
+ * pass for the other two: the Function URL always wraps it.
+ *
+ *   const journeys = journeyLambda({
+ *     config,
+ *     env,                                        // parsed from process.env (zod)
+ *     store: (env, database) => postgresJsStore(env.DATABASE_URL, database),
+ *     email: (env) => sesEmailTransport({ region: env.AWS_REGION }),
+ *   });
+ *   export const handler = journeys.handler;
+ */
+/** The scheduled tick (EventBridge Scheduler's payload): the segment sweep and maintenance. */
+export declare const SWEEP_EVENT_TYPE = "$workflow.sweep";
+/** What journeyLambda reads from its env: `JourneyEnv` without the binding it supplies itself. */
+export type JourneyLambdaEnv = Omit<JourneyEnv, 'JOURNEY' | 'DB' | 'WORKFLOW_KV' | 'EMAIL'>;
+export interface JourneyLambdaOptions<Env extends JourneyLambdaEnv> extends Omit<JourneyHostOptions<Env & JourneyEnv>, 'env' | 'store'> {
+  /** The validated environment (parsed from `process.env` with zod by the app). */
+  env: Env;
+  /** The Postgres store: AWS needs its execution registry (`postgresJsStore`). */
+  store: (env: Env, database: {
+    schema: string;
+  }) => JourneyStore | StoreLease;
+  /** The Lambda control plane; `@aws-sdk/client-lambda` with the execution role by default. */
+  lambda?: LambdaApi;
+  /** How long an unconfirmed start is retried (default 12 hours; keep it under the retention). */
+  startRetryMs?: number;
+  /**
+   * How long an erasure waits after stopping an execution before it erases: an invocation
+   * running at the stop goes on to its next checkpoint. Set it to at least the function's
+   * timeout; 15 minutes (Lambda's maximum) by default.
+   */
+  stopDrainMs?: number;
+}
+/**
+ * The Lambda invocation context, as far as the handler's signature needs it — declared here so
+ * the package's types do not depend on `@types/aws-lambda`. Lambda passes the full object.
+ */
+export interface LambdaContext {
+  functionName: string;
+  functionVersion: string;
+  invokedFunctionArn: string;
+  awsRequestId: string;
+  getRemainingTimeInMillis(): number;
+}
+export interface JourneyLambda {
+  /** Export as the function's handler. */
+  handler: (event: DurableExecutionInvocationInput, context: LambdaContext) => Promise<DurableExecutionInvocationOutput>;
+}
+export declare function journeyLambda<Env extends JourneyLambdaEnv>(options: JourneyLambdaOptions<Env>): JourneyLambda;
+//#endregion
+export { AwsEngineStep, AwsInstances, type AwsInstancesOptions, type ExecutionState, type FunctionUrlEvent, type FunctionUrlResult, type LambdaApi, RUN_EVENT_TYPE, type RunInput, executionName, fromResponse, isFunctionUrlEvent, isRunInput, sdkLambdaApi, stepRetry, toRequest };
+//# sourceMappingURL=index.d.cts.map

package/dist/aws/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/aws/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA6Ca;;YAGD,mBAAmB,KAAK;iBAEnB,qBAAqB,YAAY,0BAA0B,KAC1E,mBAAmB,MAAM;;EAIzB,KAAK;;EAEL,QAAQ,KAAK,KAAK;IAAY;QAAqB,eAAe;;EAElE,SAAS;;EAET;;;;;;EAMA;;;;;;iBAOe;EACf;EACA;EACA;EACA;EACA;;iBAGe;;EAEf,UACE,OAAO,iCACP,SAAS,kBACN,QAAQ;;wBAeC,cAAc,YAAY,kBACxC,SAAS,qBAAqB,OAC7B"}

package/dist/aws/index.d.mts

@@ -0,0 +1,68 @@
+import { JourneyEnv } from "../cloudflare/bindings.mjs";
+import { JourneyStore, StoreLease } from "../store/index.mjs";
+import { ExecutionState, LambdaApi, sdkLambdaApi } from "./lambda-api.mjs";
+import { AwsEngineStep, stepRetry } from "./engine-step.mjs";
+import { FunctionUrlEvent, FunctionUrlResult, fromResponse, isFunctionUrlEvent, toRequest } from "./function-url.mjs";
+import { JourneyHostOptions } from "../host/journey-host.mjs";
+import { AwsInstances, AwsInstancesOptions, RUN_EVENT_TYPE, RunInput, executionName, isRunInput } from "./instances.mjs";
+import { DurableExecutionInvocationInput, DurableExecutionInvocationOutput } from "@aws/durable-execution-sdk-js";
+//#region src/aws/index.d.ts
+/**
+ * `@shware/workflow/aws` — the journey host as one Lambda durable function behind a Function
+ * URL, on Postgres.
+ *
+ * The one handler tells three inputs apart by the event's top-level shape: a Function URL
+ * request (the HTTP API — ingest, identify, devices, tracking, bundle, preview), an internal run
+ * (one journey instance: one durable execution, started by an asynchronous invoke of this
+ * function's own numbered version), and a scheduled maintenance tick. An HTTP body can never
+ * pass for the other two: the Function URL always wraps it.
+ *
+ *   const journeys = journeyLambda({
+ *     config,
+ *     env,                                        // parsed from process.env (zod)
+ *     store: (env, database) => postgresJsStore(env.DATABASE_URL, database),
+ *     email: (env) => sesEmailTransport({ region: env.AWS_REGION }),
+ *   });
+ *   export const handler = journeys.handler;
+ */
+/** The scheduled tick (EventBridge Scheduler's payload): the segment sweep and maintenance. */
+export declare const SWEEP_EVENT_TYPE = "$workflow.sweep";
+/** What journeyLambda reads from its env: `JourneyEnv` without the binding it supplies itself. */
+export type JourneyLambdaEnv = Omit<JourneyEnv, 'JOURNEY' | 'DB' | 'WORKFLOW_KV' | 'EMAIL'>;
+export interface JourneyLambdaOptions<Env extends JourneyLambdaEnv> extends Omit<JourneyHostOptions<Env & JourneyEnv>, 'env' | 'store'> {
+  /** The validated environment (parsed from `process.env` with zod by the app). */
+  env: Env;
+  /** The Postgres store: AWS needs its execution registry (`postgresJsStore`). */
+  store: (env: Env, database: {
+    schema: string;
+  }) => JourneyStore | StoreLease;
+  /** The Lambda control plane; `@aws-sdk/client-lambda` with the execution role by default. */
+  lambda?: LambdaApi;
+  /** How long an unconfirmed start is retried (default 12 hours; keep it under the retention). */
+  startRetryMs?: number;
+  /**
+   * How long an erasure waits after stopping an execution before it erases: an invocation
+   * running at the stop goes on to its next checkpoint. Set it to at least the function's
+   * timeout; 15 minutes (Lambda's maximum) by default.
+   */
+  stopDrainMs?: number;
+}
+/**
+ * The Lambda invocation context, as far as the handler's signature needs it — declared here so
+ * the package's types do not depend on `@types/aws-lambda`. Lambda passes the full object.
+ */
+export interface LambdaContext {
+  functionName: string;
+  functionVersion: string;
+  invokedFunctionArn: string;
+  awsRequestId: string;
+  getRemainingTimeInMillis(): number;
+}
+export interface JourneyLambda {
+  /** Export as the function's handler. */
+  handler: (event: DurableExecutionInvocationInput, context: LambdaContext) => Promise<DurableExecutionInvocationOutput>;
+}
+export declare function journeyLambda<Env extends JourneyLambdaEnv>(options: JourneyLambdaOptions<Env>): JourneyLambda;
+//#endregion
+export { AwsEngineStep, AwsInstances, type AwsInstancesOptions, type ExecutionState, type FunctionUrlEvent, type FunctionUrlResult, type LambdaApi, RUN_EVENT_TYPE, type RunInput, executionName, fromResponse, isFunctionUrlEvent, isRunInput, sdkLambdaApi, stepRetry, toRequest };
+//# sourceMappingURL=index.d.mts.map

package/dist/aws/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/aws/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA6Ca;;YAGD,mBAAmB,KAAK;iBAEnB,qBAAqB,YAAY,0BAA0B,KAC1E,mBAAmB,MAAM;;EAIzB,KAAK;;EAEL,QAAQ,KAAK,KAAK;IAAY;QAAqB,eAAe;;EAElE,SAAS;;EAET;;;;;;EAMA;;;;;;iBAOe;EACf;EACA;EACA;EACA;EACA;;iBAGe;;EAEf,UACE,OAAO,iCACP,SAAS,kBACN,QAAQ;;wBAeC,cAAc,YAAY,kBACxC,SAAS,qBAAqB,OAC7B"}