posipaki 0.46.1 → 0.47.0

package/dist/index.d.ts

@@ -20,7 +20,7 @@ declare function defineActor<Args, InternalState, InMsg extends Message, OutMsg
 //#endregion
 //#region src/version.d.ts
 /** posipaki's release version.  Must equal package.json's `version`. */
-declare const LIB_VERSION = "0.46.1";
+declare const LIB_VERSION = "0.47.0";
 //#endregion
 export { type ActorConfig, type ActorContext, type ActorDecorated, type ActorDefinition, type ActorPlugin, type ActorReflection, type AnyProcess, AsyncProcess, type AsyncProcessFn, type ExitMessage, type HandlerFn, type HandlerOptions, type HookResult, LIB_VERSION, type Message, type MethodOptions, type PluginTransform, Process, type ProcessCtx, type ProcessFn, type SenderInfo, type SenderOrigin, type SpawnedFrom, type StopMessage, type WithSender, type WithoutSender, asyncify, callHook, chainHook, defineActor, defineMessages, mergeConfigs, propagateError, runDispatch, runDispatchAsync, spawn, spawnAsync, stopPropagation };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -2,7 +2,7 @@ import { i as runDispatch } from "./util-Brtfgv68.js";
 import { a as spawnAsync, i as runDispatchAsync, o as asyncify, t as AsyncProcess } from "./process.async-B1FqZyD1.js";
 import { n as chainHook, o as propagateError, r as mergeConfigs, s as stopPropagation, t as callHook } from "./hooks-CgXhmY4r.js";
 import { n as defineMessages, t as defineActor } from "./define-actor-DR1P1PA5.js";
-import { t as LIB_VERSION } from "./version-BYC8xwip.js";
+import { t as LIB_VERSION } from "./version-DRbb_jh2.js";
 //#region src/process.ts
 /** @deprecated Use {@link spawnAsync} instead. */
 function spawn(fn, pname, tp) {

package/dist/remote/node.js

@@ -1,4 +1,4 @@
-import { t as LIB_VERSION } from "../version-BYC8xwip.js";
+import { t as LIB_VERSION } from "../version-DRbb_jh2.js";
 import { D as channelThrough, L as isProto, O as errorFrame$1, S as json1Channel, W as lowBand, a as remoteClient, k as errorReason$1, n as WebSocketTransport, o as pumpOutput, p as StreamStore, r as readParts, s as stderrSink, u as serveRemoteActor, y as VERSION } from "../websocket-Dnorztuc.js";
 import { chmod, mkdir, mkdtemp, open, readFile, rm, stat, unlink } from "node:fs/promises";
 import { execFile, spawn } from "node:child_process";

package/dist/{version-BYC8xwip.js → version-DRbb_jh2.js}

@@ -1,7 +1,7 @@
 //#region src/version.ts
 /** posipaki's release version.  Must equal package.json's `version`. */
-const LIB_VERSION = "0.46.1";
+const LIB_VERSION = "0.47.0";
 //#endregion
 export { LIB_VERSION as t };
 
-//# sourceMappingURL=version-BYC8xwip.js.map
+//# sourceMappingURL=version-DRbb_jh2.js.map

package/dist/{version-BYC8xwip.js.map → version-DRbb_jh2.js.map}

@@ -1 +1 @@
-{"version":3,"file":"version-BYC8xwip.js","names":[],"sources":["../src/version.ts"],"sourcesContent":["// ── Library identity ───────────────────────────────────────────────────────\n//\n// posipaki's own release version, as a plain inlined string.  A consumer that\n// stages artifacts onto a host it knows nothing about has to name those\n// artifacts after which posipaki they speak, and the bundle that runs there has\n// no node_modules and no posipaki on disk — it can never read a file to find out.\n//\n// It is not the protocol version: that is `VERSION` in ./remote (`json.v1`), and\n// it does not move between releases.  The two answer different questions.\n//\n// version.test.ts pins this to package.json, so a release that forgets to bump it\n// fails the suite rather than shipping a lie.\n\n/** posipaki's release version.  Must equal package.json's `version`. */\nexport const LIB_VERSION = \"0.46.1\";\n"],"mappings":";;AAcA,MAAa,cAAc"}
+{"version":3,"file":"version-DRbb_jh2.js","names":[],"sources":["../src/version.ts"],"sourcesContent":["// ── Library identity ───────────────────────────────────────────────────────\n//\n// posipaki's own release version, as a plain inlined string.  A consumer that\n// stages artifacts onto a host it knows nothing about has to name those\n// artifacts after which posipaki they speak, and the bundle that runs there has\n// no node_modules and no posipaki on disk — it can never read a file to find out.\n//\n// It is not the protocol version: that is `VERSION` in ./remote (`json.v1`), and\n// it does not move between releases.  The two answer different questions.\n//\n// version.test.ts pins this to package.json, so a release that forgets to bump it\n// fails the suite rather than shipping a lie.\n\n/** posipaki's release version.  Must equal package.json's `version`. */\nexport const LIB_VERSION = \"0.47.0\";\n"],"mappings":";;AAcA,MAAa,cAAc"}

package/dist/xfetch.d.ts

@@ -1,44 +1,55 @@
 import { d as WithSender, n as ExitMessage, o as ProcessCtx } from "./types-U3NvKgpg.js";
 import { t as Process } from "./process-eCAv2tIS.js";
 //#region src/xfetch.d.ts
+/**
+ * A fetch init, plus the deadline that is not in the standard.
+ *
+ * `timeout` is Bun's socket idle deadline: the request fails if the connection stays idle that long.
+ * Bun's default is five minutes, which a slow generation outlives; this is the only place a caller can
+ * say otherwise. On a runtime that does not know the field, `fetch` ignores it.
+ */
+type FetchInit = RequestInit & {
+  timeout?: number | boolean;
+};
+/** Arguments for a fetch process: a URL, and the init the caller wants sent with it. */
+type FetchArgs = {
+  url: URL;
+  init?: FetchInit;
+};
 /** State of an in-flight or completed fetch. */
-type FetchState<T> = {
+type FetchState = {
   code: "pending" | "loading" | "aborted" | "failed" | "ok";
-  data: T | null;
+  /** The answer's body as text, whatever its content-type said. */
   text: string | null;
   status: number;
   responseHeaders: Record<string, string>;
 };
-/** Arguments for a fetch process. */
-type FetchArgs<T> = {
-  url: URL;
-  method?: "GET";
-  body?: undefined;
-  headers?: Record<string, string>;
-} | {
-  url: URL;
-  method?: "POST" | "PUT" | "PATCH";
-  body: T;
-  headers?: Record<string, string>;
-};
 /** Messages emitted by a fetch process during its lifecycle. */
-type FetchMessage<T> = {
+type FetchMessage = {
   type: "OK";
-  data?: T | null;
-  text?: string | null;
+  text: string;
   status: number;
   responseHeaders: Record<string, string>;
 } | {
-  type: "ERROR" | "LOADING" | "ABORTED" | "STOP";
+  type: "ERROR";
+  /** What went wrong, in the words of whatever threw: `socket hang up`, `The operation timed out.` */
+  reason: string;
+} | {
+  type: "LOADING" | "ABORTED" | "STOP";
 } | ExitMessage;
 /** A process that performs an HTTP fetch. */
-type FetchProcess<D> = Process<FetchArgs<D>, FetchState<D>, FetchMessage<D>, FetchMessage<D>>;
+type FetchProcess = Process<FetchArgs, FetchState, FetchMessage, FetchMessage>;
 /**
- * A fetch wrapper implemented as a process. Supports GET/POST/PUT/PATCH,
- * JSON detection, abort via AbortController, and yields a
- * {@link FetchState} with the current status.
+ * Fetch, as a process.
+ *
+ * A pipe and nothing more: the init is handed to `fetch` untouched, the answer's body comes back as
+ * text with its status and headers, and a failure carries its cause.  It parses nothing, shapes no
+ * request, and imposes no deadline of its own.
+ *
+ * It is a process because a request may run for minutes: the caller's loop must stay able to hear
+ * HEARTBEAT and STOP while it waits, and `STOP` aborts the request through the signal below.
  */
-declare function xfetch<Type>({ pname, toParent, sendSelf }: ProcessCtx<FetchArgs<Type>, FetchState<Type>, FetchMessage<Type>, FetchMessage<Type>>, { method, url, body, headers: callerHeaders }: FetchArgs<Type>): Generator<FetchState<Type> | null, void, WithSender<FetchMessage<Type>>>;
+declare function xfetch({ pname, toParent, sendSelf }: ProcessCtx<FetchArgs, FetchState, FetchMessage, FetchMessage>, { url, init }: FetchArgs): Generator<FetchState | null, void, WithSender<FetchMessage>>;
 //#endregion
-export { FetchArgs, FetchMessage, FetchProcess, FetchState, xfetch };
+export { FetchArgs, FetchInit, FetchMessage, FetchProcess, FetchState, xfetch };
 //# sourceMappingURL=xfetch.d.ts.map

package/dist/xfetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"xfetch.d.ts","names":[],"sources":["../src/xfetch.ts"],"mappings":";;;;KAOY,WAAW;EACrB;EACA,MAAM;EACN;EACA;EACA,iBAAiB;;;KAIP,UAAU;EAEhB,KAAK;EACL;EACA;EACA,UAAU;;EAGV,KAAK;EACL;EACA,MAAM;EACN,UAAU;;;KAIJ,aAAa;EAEnB;EACA,OAAO;EACP;EACA;EACA,iBAAiB;;EAEjB;IACF;;KAGQ,aAAa,KAAK,QAC5B,UAAU,IACV,WAAW,IACX,aAAa,IACb,aAAa;;;;;;iBA0BL,OAAO,QAEb,OACA,UACA,YACC,WAAW,UAAU,OAAO,WAAW,OAAO,aAAa,OAAO,aAAa,UAChF,QAAgB,KAAK,MAAM,SAAS,iBAAiB,UAAU,QAChE,UAAU,WAAW,oBAAoB,WAAW,aAAa"}
+{"version":3,"file":"xfetch.d.ts","names":[],"sources":["../src/xfetch.ts"],"mappings":";;;;;;;;;;KAaY,YAAY;EACtB;;;KAIU;EACV,KAAK;EACL,OAAO;;;KAIG;EACV;;EAEA;EACA;EACA,iBAAiB;;;KAIP;EAEN;EACA;EACA;EACA,iBAAiB;;EAGjB;;EAEA;;EAEA;IACF;;KAGQ,eAAe,QAAQ,WAAW,YAAY,cAAc;;;;;;;;;;;iBA+B9D,SAEN,OACA,UACA,YACC,WAAW,WAAW,YAAY,cAAc,iBACjD,KAAK,QAAQ,YACd,UAAU,yBAAyB,WAAW"}

package/dist/xfetch.js

@@ -1,8 +1,5 @@
 import { i as runDispatch } from "./util-Brtfgv68.js";
 //#region src/xfetch.ts
-function isJsonHelper(res) {
-	return res.headers.get("content-type") === "application/json";
-}
 /** Convert a Headers object to a plain Record. */
 function headersToRecord(h) {
 	const out = {};
@@ -11,57 +8,52 @@ function headersToRecord(h) {
 	});
 	return out;
 }
+/** The cause of a failure, in words.  A bare word is what made a 300 s deadline look like a network fault. */
+function reasonOf(e) {
+	if (e instanceof Error) return e.message || e.name;
+	return String(e);
+}
 /**
-* A fetch wrapper implemented as a process. Supports GET/POST/PUT/PATCH,
-* JSON detection, abort via AbortController, and yields a
-* {@link FetchState} with the current status.
+* Fetch, as a process.
+*
+* A pipe and nothing more: the init is handed to `fetch` untouched, the answer's body comes back as
+* text with its status and headers, and a failure carries its cause.  It parses nothing, shapes no
+* request, and imposes no deadline of its own.
+*
+* It is a process because a request may run for minutes: the caller's loop must stay able to hear
+* HEARTBEAT and STOP while it waits, and `STOP` aborts the request through the signal below.
 */
-function* xfetch({ pname, toParent, sendSelf }, { method = "GET", url, body, headers: callerHeaders }) {
+function* xfetch({ pname, toParent, sendSelf }, { url, init }) {
 	const state = {
 		code: "pending",
-		data: null,
 		text: null,
 		status: 0,
 		responseHeaders: {}
 	};
 	yield state;
 	const controller = new AbortController();
-	const signal = controller.signal;
 	const toSelf = sendSelf;
 	(async function doRequest() {
 		try {
 			toSelf({ type: "LOADING" });
-			const serializedBody = method === "GET" ? void 0 : JSON.stringify(body);
-			const headers = new Headers(callerHeaders ?? {});
-			if (serializedBody && !headers.get("content-type")) headers.set("content-type", "application/json");
-			const res = await fetch(url.href, {
-				method,
-				signal,
-				body: serializedBody,
-				headers
+			const requestInit = {
+				...init,
+				signal: controller.signal
+			};
+			const res = await fetch(url.href, requestInit);
+			const text = await res.text();
+			toSelf({
+				type: "OK",
+				text,
+				status: res.status,
+				responseHeaders: headersToRecord(res.headers)
 			});
-			const status = res.status;
-			const responseHeaders = headersToRecord(res.headers);
-			if (isJsonHelper(res)) {
-				const data = await res.json();
-				toSelf({
-					type: "OK",
-					data,
-					status,
-					responseHeaders
-				});
-			} else {
-				const text = await res.text();
-				toSelf({
-					type: "OK",
-					text,
-					status,
-					responseHeaders
-				});
-			}
 		} catch (e) {
 			if (e instanceof DOMException && e.name === "AbortError") toSelf({ type: "ABORTED" });
-			else toSelf({ type: "ERROR" });
+			else toSelf({
+				type: "ERROR",
+				reason: reasonOf(e)
+			});
 		}
 	})();
 	const isDone = () => !(state.code === "pending" || state.code === "loading");
@@ -80,8 +72,7 @@ function* xfetch({ pname, toParent, sendSelf }, { method = "GET", url, body, hea
 		if (msg.type === "OK") {
 			toParent(msg);
 			state.code = "ok";
-			state.data = msg.data || null;
-			state.text = msg.text || null;
+			state.text = msg.text;
 			state.status = msg.status;
 			state.responseHeaders = msg.responseHeaders;
 		}

package/dist/xfetch.js.map

@@ -1 +1 @@
-{"version":3,"file":"xfetch.js","names":[],"sources":["../src/xfetch.ts"],"sourcesContent":["import { runDispatch } from \"./util.js\";\nimport type { ExitMessage, WithSender, ProcessCtx } from \"./types.js\";\nimport type { Process } from \"./process.js\";\n\n// ---- types ------------------------------------------------------------------\n\n/** State of an in-flight or completed fetch. */\nexport type FetchState<T> = {\n  code: \"pending\" | \"loading\" | \"aborted\" | \"failed\" | \"ok\";\n  data: T | null;\n  text: string | null;\n  status: number;\n  responseHeaders: Record<string, string>;\n};\n\n/** Arguments for a fetch process. */\nexport type FetchArgs<T> =\n  | {\n      url: URL;\n      method?: \"GET\";\n      body?: undefined;\n      headers?: Record<string, string>;\n    }\n  | {\n      url: URL;\n      method?: \"POST\" | \"PUT\" | \"PATCH\";\n      body: T;\n      headers?: Record<string, string>;\n    };\n\n/** Messages emitted by a fetch process during its lifecycle. */\nexport type FetchMessage<T> =\n  | {\n      type: \"OK\";\n      data?: T | null;\n      text?: string | null;\n      status: number;\n      responseHeaders: Record<string, string>;\n    }\n  | { type: \"ERROR\" | \"LOADING\" | \"ABORTED\" | \"STOP\" }\n  | ExitMessage;\n\n/** A process that performs an HTTP fetch. */\nexport type FetchProcess<D> = Process<\n  FetchArgs<D>,\n  FetchState<D>,\n  FetchMessage<D>,\n  FetchMessage<D>\n>;\n\n// ---- helpers ----------------------------------------------------------------\n\nfunction isJsonHelper(res: Response): boolean {\n  const ct = res.headers.get(\"content-type\");\n  return ct === \"application/json\";\n}\n\n/** Convert a Headers object to a plain Record. */\nfunction headersToRecord(h: Headers): Record<string, string> {\n  const out: Record<string, string> = {};\n  h.forEach((v, k) => {\n    out[k] = v;\n  });\n  return out;\n}\n\n// ---- xfetch -----------------------------------------------------------------\n\n/**\n * A fetch wrapper implemented as a process. Supports GET/POST/PUT/PATCH,\n * JSON detection, abort via AbortController, and yields a\n * {@link FetchState} with the current status.\n */\nfunction* xfetch<Type>(\n  {\n    pname,\n    toParent,\n    sendSelf,\n  }: ProcessCtx<FetchArgs<Type>, FetchState<Type>, FetchMessage<Type>, FetchMessage<Type>>,\n  { method = \"GET\", url, body, headers: callerHeaders }: FetchArgs<Type>,\n): Generator<FetchState<Type> | null, void, WithSender<FetchMessage<Type>>> {\n  const state: FetchState<Type> = {\n    code: \"pending\",\n    data: null,\n    text: null,\n    status: 0,\n    responseHeaders: {},\n  };\n  yield state;\n\n  const controller = new AbortController();\n  const signal = controller.signal;\n  const toSelf = sendSelf;\n\n  (async function doRequest() {\n    try {\n      toSelf({ type: \"LOADING\" });\n      const serializedBody = method === \"GET\" ? undefined : JSON.stringify(body);\n      const headers = new Headers(callerHeaders ?? {});\n      if (serializedBody && !headers.get(\"content-type\")) {\n        headers.set(\"content-type\", \"application/json\");\n      }\n      const res: Response = await fetch(url.href, {\n        method,\n        signal,\n        body: serializedBody,\n        headers,\n      });\n      const status = res.status;\n      const responseHeaders = headersToRecord(res.headers);\n      if (isJsonHelper(res)) {\n        const data = (await res.json()) as Type;\n        toSelf({ type: \"OK\", data, status, responseHeaders });\n      } else {\n        const text = await res.text();\n        toSelf({ type: \"OK\", text, status, responseHeaders });\n      }\n    } catch (e) {\n      const isAborted = e instanceof DOMException && e.name === \"AbortError\";\n      if (isAborted) {\n        toSelf({ type: \"ABORTED\" });\n      } else {\n        toSelf({ type: \"ERROR\" });\n      }\n    }\n  })();\n\n  const isDone = (): boolean => !(state.code === \"pending\" || state.code === \"loading\");\n\n  yield* runDispatch<WithSender<FetchMessage<Type>>>(\n    pname,\n    (maybe: WithSender<FetchMessage<Type>>) => {\n      const [msg, _sender] = maybe;\n      if (msg.type === \"STOP\") {\n        controller.abort();\n      }\n      if (msg.type === \"ABORTED\") {\n        toParent(msg);\n        state.code = \"aborted\";\n      }\n      if (msg.type === \"ERROR\") {\n        toParent(msg);\n        state.code = \"failed\";\n      }\n      if (msg.type === \"LOADING\") {\n        state.code = \"loading\";\n      }\n      if (msg.type === \"OK\") {\n        toParent(msg);\n        state.code = \"ok\";\n        state.data = msg.data || null;\n        state.text = msg.text || null;\n        state.status = msg.status;\n        state.responseHeaders = msg.responseHeaders;\n      }\n    },\n    isDone,\n    false,\n  );\n}\n\nexport { xfetch };\n"],"mappings":";;AAoDA,SAAS,aAAa,KAAwB;CAE5C,OADW,IAAI,QAAQ,IAAI,cACnB,MAAM;AAChB;;AAGA,SAAS,gBAAgB,GAAoC;CAC3D,MAAM,MAA8B,CAAC;CACrC,EAAE,SAAS,GAAG,MAAM;EAClB,IAAI,KAAK;CACX,CAAC;CACD,OAAO;AACT;;;;;;AASA,UAAU,OACR,EACE,OACA,UACA,YAEF,EAAE,SAAS,OAAO,KAAK,MAAM,SAAS,iBACoC;CAC1E,MAAM,QAA0B;EAC9B,MAAM;EACN,MAAM;EACN,MAAM;EACN,QAAQ;EACR,iBAAiB,CAAC;CACpB;CACA,MAAM;CAEN,MAAM,aAAa,IAAI,gBAAgB;CACvC,MAAM,SAAS,WAAW;CAC1B,MAAM,SAAS;CAEf,CAAC,eAAe,YAAY;EAC1B,IAAI;GACF,OAAO,EAAE,MAAM,UAAU,CAAC;GAC1B,MAAM,iBAAiB,WAAW,QAAQ,KAAA,IAAY,KAAK,UAAU,IAAI;GACzE,MAAM,UAAU,IAAI,QAAQ,iBAAiB,CAAC,CAAC;GAC/C,IAAI,kBAAkB,CAAC,QAAQ,IAAI,cAAc,GAC/C,QAAQ,IAAI,gBAAgB,kBAAkB;GAEhD,MAAM,MAAgB,MAAM,MAAM,IAAI,MAAM;IAC1C;IACA;IACA,MAAM;IACN;GACF,CAAC;GACD,MAAM,SAAS,IAAI;GACnB,MAAM,kBAAkB,gBAAgB,IAAI,OAAO;GACnD,IAAI,aAAa,GAAG,GAAG;IACrB,MAAM,OAAQ,MAAM,IAAI,KAAK;IAC7B,OAAO;KAAE,MAAM;KAAM;KAAM;KAAQ;IAAgB,CAAC;GACtD,OAAO;IACL,MAAM,OAAO,MAAM,IAAI,KAAK;IAC5B,OAAO;KAAE,MAAM;KAAM;KAAM;KAAQ;IAAgB,CAAC;GACtD;EACF,SAAS,GAAG;GAEV,IADkB,aAAa,gBAAgB,EAAE,SAAS,cAExD,OAAO,EAAE,MAAM,UAAU,CAAC;QAE1B,OAAO,EAAE,MAAM,QAAQ,CAAC;EAE5B;CACF,EAAA,CAAG;CAEH,MAAM,eAAwB,EAAE,MAAM,SAAS,aAAa,MAAM,SAAS;CAE3E,OAAO,YACL,QACC,UAA0C;EACzC,MAAM,CAAC,KAAK,WAAW;EACvB,IAAI,IAAI,SAAS,QACf,WAAW,MAAM;EAEnB,IAAI,IAAI,SAAS,WAAW;GAC1B,SAAS,GAAG;GACZ,MAAM,OAAO;EACf;EACA,IAAI,IAAI,SAAS,SAAS;GACxB,SAAS,GAAG;GACZ,MAAM,OAAO;EACf;EACA,IAAI,IAAI,SAAS,WACf,MAAM,OAAO;EAEf,IAAI,IAAI,SAAS,MAAM;GACrB,SAAS,GAAG;GACZ,MAAM,OAAO;GACb,MAAM,OAAO,IAAI,QAAQ;GACzB,MAAM,OAAO,IAAI,QAAQ;GACzB,MAAM,SAAS,IAAI;GACnB,MAAM,kBAAkB,IAAI;EAC9B;CACF,GACA,QACA,KACF;AACF"}
+{"version":3,"file":"xfetch.js","names":[],"sources":["../src/xfetch.ts"],"sourcesContent":["import { runDispatch } from \"./util.js\";\nimport type { ExitMessage, WithSender, ProcessCtx } from \"./types.js\";\nimport type { Process } from \"./process.js\";\n\n// ---- types ------------------------------------------------------------------\n\n/**\n * A fetch init, plus the deadline that is not in the standard.\n *\n * `timeout` is Bun's socket idle deadline: the request fails if the connection stays idle that long.\n * Bun's default is five minutes, which a slow generation outlives; this is the only place a caller can\n * say otherwise. On a runtime that does not know the field, `fetch` ignores it.\n */\nexport type FetchInit = RequestInit & {\n  timeout?: number | boolean;\n};\n\n/** Arguments for a fetch process: a URL, and the init the caller wants sent with it. */\nexport type FetchArgs = {\n  url: URL;\n  init?: FetchInit;\n};\n\n/** State of an in-flight or completed fetch. */\nexport type FetchState = {\n  code: \"pending\" | \"loading\" | \"aborted\" | \"failed\" | \"ok\";\n  /** The answer's body as text, whatever its content-type said. */\n  text: string | null;\n  status: number;\n  responseHeaders: Record<string, string>;\n};\n\n/** Messages emitted by a fetch process during its lifecycle. */\nexport type FetchMessage =\n  | {\n      type: \"OK\";\n      text: string;\n      status: number;\n      responseHeaders: Record<string, string>;\n    }\n  | {\n      type: \"ERROR\";\n      /** What went wrong, in the words of whatever threw: `socket hang up`, `The operation timed out.` */\n      reason: string;\n    }\n  | { type: \"LOADING\" | \"ABORTED\" | \"STOP\" }\n  | ExitMessage;\n\n/** A process that performs an HTTP fetch. */\nexport type FetchProcess = Process<FetchArgs, FetchState, FetchMessage, FetchMessage>;\n\n// ---- helpers ----------------------------------------------------------------\n\n/** Convert a Headers object to a plain Record. */\nfunction headersToRecord(h: Headers): Record<string, string> {\n  const out: Record<string, string> = {};\n  h.forEach((v, k) => {\n    out[k] = v;\n  });\n  return out;\n}\n\n/** The cause of a failure, in words.  A bare word is what made a 300 s deadline look like a network fault. */\nfunction reasonOf(e: unknown): string {\n  if (e instanceof Error) return e.message || e.name;\n  return String(e);\n}\n\n// ---- xfetch -----------------------------------------------------------------\n\n/**\n * Fetch, as a process.\n *\n * A pipe and nothing more: the init is handed to `fetch` untouched, the answer's body comes back as\n * text with its status and headers, and a failure carries its cause.  It parses nothing, shapes no\n * request, and imposes no deadline of its own.\n *\n * It is a process because a request may run for minutes: the caller's loop must stay able to hear\n * HEARTBEAT and STOP while it waits, and `STOP` aborts the request through the signal below.\n */\nfunction* xfetch(\n  {\n    pname,\n    toParent,\n    sendSelf,\n  }: ProcessCtx<FetchArgs, FetchState, FetchMessage, FetchMessage>,\n  { url, init }: FetchArgs,\n): Generator<FetchState | null, void, WithSender<FetchMessage>> {\n  const state: FetchState = {\n    code: \"pending\",\n    text: null,\n    status: 0,\n    responseHeaders: {},\n  };\n  yield state;\n\n  const controller = new AbortController();\n  const toSelf = sendSelf;\n\n  (async function doRequest() {\n    try {\n      toSelf({ type: \"LOADING\" });\n      // Our signal wins: the caller's STOP has to be able to abort whatever was sent.\n      const requestInit: FetchInit = { ...init, signal: controller.signal };\n      const res: Response = await fetch(url.href, requestInit);\n      const text = await res.text();\n      toSelf({\n        type: \"OK\",\n        text,\n        status: res.status,\n        responseHeaders: headersToRecord(res.headers),\n      });\n    } catch (e) {\n      if (e instanceof DOMException && e.name === \"AbortError\") {\n        toSelf({ type: \"ABORTED\" });\n      } else {\n        toSelf({ type: \"ERROR\", reason: reasonOf(e) });\n      }\n    }\n  })();\n\n  const isDone = (): boolean => !(state.code === \"pending\" || state.code === \"loading\");\n\n  yield* runDispatch<WithSender<FetchMessage>>(\n    pname,\n    (maybe: WithSender<FetchMessage>) => {\n      const [msg, _sender] = maybe;\n      if (msg.type === \"STOP\") {\n        controller.abort();\n      }\n      if (msg.type === \"ABORTED\") {\n        toParent(msg);\n        state.code = \"aborted\";\n      }\n      if (msg.type === \"ERROR\") {\n        toParent(msg);\n        state.code = \"failed\";\n      }\n      if (msg.type === \"LOADING\") {\n        state.code = \"loading\";\n      }\n      if (msg.type === \"OK\") {\n        toParent(msg);\n        state.code = \"ok\";\n        state.text = msg.text;\n        state.status = msg.status;\n        state.responseHeaders = msg.responseHeaders;\n      }\n    },\n    isDone,\n    false,\n  );\n}\n\nexport { xfetch };\n"],"mappings":";;;AAsDA,SAAS,gBAAgB,GAAoC;CAC3D,MAAM,MAA8B,CAAC;CACrC,EAAE,SAAS,GAAG,MAAM;EAClB,IAAI,KAAK;CACX,CAAC;CACD,OAAO;AACT;;AAGA,SAAS,SAAS,GAAoB;CACpC,IAAI,aAAa,OAAO,OAAO,EAAE,WAAW,EAAE;CAC9C,OAAO,OAAO,CAAC;AACjB;;;;;;;;;;;AAcA,UAAU,OACR,EACE,OACA,UACA,YAEF,EAAE,KAAK,QACuD;CAC9D,MAAM,QAAoB;EACxB,MAAM;EACN,MAAM;EACN,QAAQ;EACR,iBAAiB,CAAC;CACpB;CACA,MAAM;CAEN,MAAM,aAAa,IAAI,gBAAgB;CACvC,MAAM,SAAS;CAEf,CAAC,eAAe,YAAY;EAC1B,IAAI;GACF,OAAO,EAAE,MAAM,UAAU,CAAC;GAE1B,MAAM,cAAyB;IAAE,GAAG;IAAM,QAAQ,WAAW;GAAO;GACpE,MAAM,MAAgB,MAAM,MAAM,IAAI,MAAM,WAAW;GACvD,MAAM,OAAO,MAAM,IAAI,KAAK;GAC5B,OAAO;IACL,MAAM;IACN;IACA,QAAQ,IAAI;IACZ,iBAAiB,gBAAgB,IAAI,OAAO;GAC9C,CAAC;EACH,SAAS,GAAG;GACV,IAAI,aAAa,gBAAgB,EAAE,SAAS,cAC1C,OAAO,EAAE,MAAM,UAAU,CAAC;QAE1B,OAAO;IAAE,MAAM;IAAS,QAAQ,SAAS,CAAC;GAAE,CAAC;EAEjD;CACF,EAAA,CAAG;CAEH,MAAM,eAAwB,EAAE,MAAM,SAAS,aAAa,MAAM,SAAS;CAE3E,OAAO,YACL,QACC,UAAoC;EACnC,MAAM,CAAC,KAAK,WAAW;EACvB,IAAI,IAAI,SAAS,QACf,WAAW,MAAM;EAEnB,IAAI,IAAI,SAAS,WAAW;GAC1B,SAAS,GAAG;GACZ,MAAM,OAAO;EACf;EACA,IAAI,IAAI,SAAS,SAAS;GACxB,SAAS,GAAG;GACZ,MAAM,OAAO;EACf;EACA,IAAI,IAAI,SAAS,WACf,MAAM,OAAO;EAEf,IAAI,IAAI,SAAS,MAAM;GACrB,SAAS,GAAG;GACZ,MAAM,OAAO;GACb,MAAM,OAAO,IAAI;GACjB,MAAM,SAAS,IAAI;GACnB,MAAM,kBAAkB,IAAI;EAC9B;CACF,GACA,QACA,KACF;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "posipaki",
-  "version": "0.46.1",
+  "version": "0.47.0",
   "homepage": "https://posipaki-docs.muromec.nl/",
   "repository": {
     "type": "git",