@voltro/protocol 0.86.0 → 0.87.0

package/dist/idempotency.js

@@ -9,58 +9,113 @@ var t = (e, t, n) => `${e ?? "(global)"}|${t.toUpperCase()}|${n}`, n = (e, t, n,
 	get message() {
 		return "this mutation requires a live native WebSocket connection";
 	}
-}, i = async (e, t, n, r, i, o = a) => {
-	let s = await e.claim(t, n, i, r, o);
-	return s === "claimed" ? { kind: "fresh" } : s.status === "completed" && s.response ? {
-		kind: "replay",
-		response: s.response
-	} : { kind: "conflict" };
-}, a = 3e4, o = (e, t, n, r = a, i = Date.now) => {
-	let o = setInterval(() => {
-		e.renew(t, n, i()).catch(() => {});
-	}, Math.max(1, Math.floor(r / 3)));
-	return o.unref?.(), () => clearInterval(o);
-}, s = (e, t, n, r, i) => e.complete(t, n, r, i), c = (e, t, n) => e.release(t, n), l = () => {
-	let e = /* @__PURE__ */ new Map(), t = (e, t) => `${e}\u0000${t}`;
+}, i = async (e, t, n, r, i, o, s = a) => {
+	if (!/^[0-9a-f]{64}$/.test(r)) throw Error("Invalid idempotency input fingerprint");
+	let c = await e.claim(t, n, r, o, i, s);
+	if (c.kind === "claimed") {
+		let e = c.claim;
+		if (typeof e.id != "string" || e.id.length === 0 || e.scope !== t || e.key !== n || e.inputHash !== r) throw Error("Idempotency store returned an invalid claim identity");
+		return {
+			kind: "fresh",
+			claim: Object.freeze({
+				scope: t,
+				key: n,
+				id: e.id,
+				inputHash: r
+			})
+		};
+	}
+	if (c.kind === "existing") {
+		if (c.record.scope !== t || c.record.key !== n) throw Error("Idempotency store returned an invalid receipt identity");
+		return typeof c.record.inputHash == "string" ? c.record.inputHash === r ? c.record.status === "completed" && c.record.response ? {
+			kind: "replay",
+			response: c.record.response
+		} : { kind: "conflict" } : { kind: "input-conflict" } : { kind: "input-unbound" };
+	}
+	if (c.kind === "conflict") return { kind: "conflict" };
+	throw Error("Idempotency store returned an invalid acquisition result");
+}, a = 3e4, o = (e, t, n = a, r = Date.now) => {
+	let i = Object.freeze({
+		scope: t.scope,
+		key: t.key,
+		id: t.id,
+		inputHash: t.inputHash
+	}), o = !1, s = setInterval(() => {
+		o || (o = !0, e.renew(i, r()).then((e) => {
+			e || clearInterval(s);
+		}, () => {}).finally(() => {
+			o = !1;
+		}));
+	}, Math.max(1, Math.floor(n / 3)));
+	return s.unref?.(), () => clearInterval(s);
+}, s = (e, t, n, r) => e.complete(t, n, r), c = (e, t) => e.release(t), l = 0n, u = () => {
+	let e = /* @__PURE__ */ new Map(), t = (e, t) => JSON.stringify([e, t]), n = (n) => {
+		let r = e.get(t(n.scope, n.key));
+		return r?.status === "in_flight" && r.id === n.id && r.inputHash === n.inputHash ? r : void 0;
+	};
 	return {
 		get: async (n, r) => e.get(t(n, r)) ?? null,
-		claim: async (n, r, i, a, o) => {
-			let s = e.get(t(n, r));
-			return s && i - s.createdAt < u(s.status, a, o) ? s : (e.set(t(n, r), {
+		claim: async (n, r, i, a, o, s) => {
+			let c = e.get(t(n, r));
+			if (c && c.inputHash !== i || c && a - c.createdAt < d(c.status, o, s)) return {
+				kind: "existing",
+				record: c
+			};
+			let u = `memory:${(++l).toString(36)}`;
+			return e.set(t(n, r), {
+				id: u,
 				scope: n,
 				key: r,
+				inputHash: i,
 				status: "in_flight",
 				response: null,
-				createdAt: i
-			}), "claimed");
+				createdAt: a
+			}), {
+				kind: "claimed",
+				claim: Object.freeze({
+					id: u,
+					scope: n,
+					key: r,
+					inputHash: i
+				})
+			};
 		},
-		complete: async (n, r, i, a) => {
-			e.set(t(n, r), {
-				scope: n,
-				key: r,
+		complete: async (r, i, a) => {
+			let o = n(r);
+			return o ? (e.set(t(r.scope, r.key), {
+				...o,
 				status: "completed",
 				response: i,
 				createdAt: a
-			});
-		},
-		release: async (n, r) => {
-			e.delete(t(n, r));
+			}), !0) : !1;
 		},
-		renew: async (n, r, i) => {
-			let a = e.get(t(n, r));
-			a?.status === "in_flight" && e.set(t(n, r), {
+		release: async (r) => n(r) ? e.delete(t(r.scope, r.key)) : !1,
+		renew: async (r, i) => {
+			let a = n(r);
+			return a ? (e.set(t(r.scope, r.key), {
 				...a,
 				createdAt: i
-			});
+			}), !0) : !1;
 		}
 	};
-}, u = (e, t, n) => e === "completed" ? t : Math.min(t, n), d = class extends e.TaggedError()("MutationInFlight", {
+}, d = (e, t, n) => e === "completed" ? t : Math.min(t, n), f = class extends e.TaggedError()("MutationInFlight", {
 	traceId: e.String,
 	retryAfterMs: e.Number
 }) {
 	get message() {
 		return `a request with this idempotency key is still in flight — replay the same key after ${this.retryAfterMs}ms`;
 	}
-}, f = 1e3;
+}, p = 1e3, m = class extends e.TaggedError()("MutationIdempotencyRefused", {
+	traceId: e.String,
+	reason: e.Literals([
+		"input-conflict",
+		"input-unbound",
+		"input-unavailable"
+	])
+}) {
+	get message() {
+		return this.reason === "input-unavailable" ? "This request input could not be captured safely. This attempt was stopped before execution." : "This request cannot be safely matched to the original operation. Check its current state before starting another action.";
+	}
+};
 //#endregion
-export { a as DEFAULT_IN_FLIGHT_LEASE_MS, f as MUTATION_IN_FLIGHT_RETRY_AFTER_MS, r as MutationConnectionRequired, d as MutationInFlight, i as beginIdempotent, c as failIdempotent, s as finishIdempotent, u as freshFor, o as holdIdempotentClaim, t as idempotencyScope, l as memoryIdempotencyStore, n as wsMutationIdempotencyScope };
+export { a as DEFAULT_IN_FLIGHT_LEASE_MS, p as MUTATION_IN_FLIGHT_RETRY_AFTER_MS, r as MutationConnectionRequired, m as MutationIdempotencyRefused, f as MutationInFlight, i as beginIdempotent, c as failIdempotent, s as finishIdempotent, d as freshFor, o as holdIdempotentClaim, t as idempotencyScope, u as memoryIdempotencyStore, n as wsMutationIdempotencyScope };

package/dist/idempotencyInput.js

@@ -0,0 +1,123 @@
+import { canonicalJson as e } from "./canonicalJson.js";
+import { Schema as t } from "effect";
+//#region src/idempotencyInput.ts
+var n = (t) => {
+	let n = /* @__PURE__ */ new WeakMap(), r = 0, i = (e, t = () => !1) => {
+		if (Object.getOwnPropertySymbols(e).length) throw Error("Unsupported wire fields");
+		return Object.getOwnPropertyNames(e).sort().filter((e) => !t(e)).map((t) => {
+			let n = Object.getOwnPropertyDescriptor(e, t);
+			if (!("value" in n)) throw Error("Unsupported wire accessor");
+			return [t, o(n.value)];
+		});
+	}, a = (e, t = 0, n = e.byteLength) => {
+		let r = "";
+		for (let i of new Uint8Array(e, t, n)) r += i.toString(16).padStart(2, "0");
+		return r;
+	}, o = (e) => {
+		if (e === null) return ["null"];
+		if (e === void 0) return ["undefined"];
+		if (typeof e == "string" || typeof e == "boolean") return [typeof e, e];
+		if (typeof e == "number") return ["number", Object.is(e, -0) ? "-0" : String(e)];
+		if (typeof e == "bigint") return ["bigint", String(e)];
+		if (typeof e != "object") throw Error("Unsupported wire value");
+		let t = n.get(e);
+		if (t !== void 0) return ["reference", t];
+		let s = r++;
+		if (n.set(e, s), Array.isArray(e)) {
+			if (Object.getPrototypeOf(e) !== Array.prototype) throw Error("Unsupported wire array prototype");
+			return [
+				"array",
+				s,
+				e.length,
+				i(e, (e) => e === "length")
+			];
+		}
+		if (Object.getPrototypeOf(e) === Date.prototype) return [
+			"date",
+			s,
+			String(Date.prototype.getTime.call(e)),
+			i(e)
+		];
+		if (Object.getPrototypeOf(e) === Map.prototype) return [
+			"map",
+			s,
+			Array.from(Map.prototype.entries.call(e), ([e, t]) => [o(e), o(t)]),
+			i(e)
+		];
+		if (Object.getPrototypeOf(e) === Set.prototype) return [
+			"set",
+			s,
+			Array.from(Set.prototype.values.call(e), o),
+			i(e)
+		];
+		if (Object.getPrototypeOf(e) === ArrayBuffer.prototype) return [
+			"buffer",
+			s,
+			a(e),
+			i(e)
+		];
+		if (ArrayBuffer.isView(e)) {
+			if (!(e.buffer instanceof ArrayBuffer)) throw Error("Shared wire memory is not a snapshot");
+			let t = Object.getOwnPropertyDescriptor(Object.getPrototypeOf(e), "constructor")?.value;
+			if (typeof t != "function" || ![
+				"DataView",
+				"Int8Array",
+				"Uint8Array",
+				"Uint8ClampedArray",
+				"Int16Array",
+				"Uint16Array",
+				"Int32Array",
+				"Uint32Array",
+				"Float16Array",
+				"Float32Array",
+				"Float64Array",
+				"BigInt64Array",
+				"BigUint64Array"
+			].includes(t.name) || globalThis[t.name] !== t) throw Error("Unsupported wire view prototype");
+			return [
+				"view",
+				s,
+				t.name,
+				o(e.buffer),
+				e.byteOffset,
+				e.byteLength,
+				i(e, (t) => !(e instanceof DataView) && /^(0|[1-9]\d*)$/.test(t))
+			];
+		}
+		let c = Object.getPrototypeOf(e);
+		if (c !== null && c !== Object.prototype) throw Error("Unsupported wire object");
+		return [
+			"object",
+			s,
+			i(e)
+		];
+	};
+	return e(o(t));
+}, r = async (r, i, a, o = void 0) => {
+	try {
+		let s = t.encodeUnknownSync(r), c = t.decodeUnknownSync(r), l = s(i), u = n(l), d = c(structuredClone(l));
+		if (n(s(d)) !== u) throw Error("Input does not round trip");
+		let f = e({
+			protocol: "voltro-idempotency-input-v1",
+			principal: {
+				type: a.type,
+				id: a.id,
+				tenantId: a.tenantId,
+				kind: a.type === "user" ? a.kind ?? null : null,
+				service: a.type === "service" ? a.service : null,
+				auditActor: a.type === "serviceAccount" ? a.auditActorId === void 0 ? ["implicit"] : ["explicit", a.auditActorId] : null
+			},
+			wire: u,
+			transport: n(o)
+		}), p = await globalThis.crypto.subtle.digest("SHA-256", new TextEncoder().encode(f)), m = "";
+		for (let e of new Uint8Array(p)) m += e.toString(16).padStart(2, "0");
+		return Object.freeze({
+			input: d,
+			fingerprint: m
+		});
+	} catch {
+		throw Error("Mutation input cannot be captured for idempotent execution");
+	}
+};
+//#endregion
+export { r as prepareIdempotentInput };