@voltro/protocol 0.69.0 → 0.70.0

package/dist/restFormat-Bnngx-zI.js

@@ -0,0 +1,232 @@
+import { Schema as e } from "effect";
+import * as t from "effect/SchemaAST";
+import * as n from "effect/Option";
+//#region src/idempotency.ts
+var r = (e, t, n) => `${e ?? "(global)"}|${t.toUpperCase()}|${n}`, i = (e, t, n, r) => r === void 0 ? `${e ?? "(global)"}|${t ?? "(anon)"}|WS|${n}` : `WS-connection:${JSON.stringify([
+	e ?? null,
+	t ?? null,
+	n,
+	r
+])}`, a = class extends e.TaggedError()("MutationConnectionRequired", { traceId: e.String }) {
+	get message() {
+		return "this mutation requires a live native WebSocket connection";
+	}
+}, o = async (e, t, n, r, i) => {
+	let a = await e.claim(t, n, i, r);
+	return a === "claimed" ? { kind: "fresh" } : a.status === "completed" && a.response ? {
+		kind: "replay",
+		response: a.response
+	} : { kind: "conflict" };
+}, 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}`;
+	return {
+		get: async (n, r) => e.get(t(n, r)) ?? null,
+		claim: async (n, r, i, a) => {
+			let o = e.get(t(n, r));
+			return o && i - o.createdAt < a ? o : (e.set(t(n, r), {
+				scope: n,
+				key: r,
+				status: "in_flight",
+				response: null,
+				createdAt: i
+			}), "claimed");
+		},
+		complete: async (n, r, i, a) => {
+			e.set(t(n, r), {
+				scope: n,
+				key: r,
+				status: "completed",
+				response: i,
+				createdAt: a
+			});
+		},
+		release: async (n, r) => {
+			e.delete(t(n, r));
+		}
+	};
+}, u = 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`;
+	}
+}, d = 1e3, f = /* @__PURE__ */ new Set(), p = (e) => {
+	for (let t of f) try {
+		t(e);
+	} catch {}
+}, m = (e) => (f.add(e), () => {
+	f.delete(e);
+}), h = {
+	rpc: {
+		name: "rpc",
+		dates: "epoch-ms",
+		errors: "tagged",
+		envelope: "none",
+		pagination: "body-cursor",
+		cursorField: "nextCursor",
+		cursorParam: "cursor",
+		naming: "camelCase",
+		etag: !1
+	},
+	standard: {
+		name: "standard",
+		dates: "iso",
+		errors: "problem-details",
+		envelope: "none",
+		pagination: "link-header",
+		cursorField: "nextCursor",
+		cursorParam: "cursor",
+		naming: "camelCase",
+		etag: !0
+	},
+	jsonapi: {
+		name: "jsonapi",
+		dates: "iso",
+		errors: "problem-details",
+		envelope: "jsonapi",
+		pagination: "link-header",
+		cursorField: "nextCursor",
+		cursorParam: "cursor",
+		naming: "camelCase",
+		etag: !0
+	}
+}, g = [
+	"rpc",
+	"standard",
+	"jsonapi"
+], _ = (e, t = void 0) => {
+	let n = (e) => {
+		if (e?.profile !== void 0) {
+			if (typeof e.profile == "string") {
+				let t = h[e.profile];
+				if (t === void 0) throw Error(`publicApi.profile: unknown profile '${String(e.profile)}' — one of ${g.join(", ")}, or a RestFormat object`);
+				return t;
+			}
+			return e.profile;
+		}
+	}, r = (e, t) => t === void 0 ? e : {
+		...e,
+		...t.dates === void 0 ? {} : { dates: t.dates },
+		...t.errors === void 0 ? {} : { errors: t.errors },
+		...t.envelope === void 0 ? {} : { envelope: t.envelope },
+		...t.pagination === void 0 ? {} : { pagination: t.pagination },
+		...t.cursorField === void 0 ? {} : { cursorField: t.cursorField },
+		...t.cursorParam === void 0 ? {} : { cursorParam: t.cursorParam },
+		...t.naming === void 0 ? {} : { naming: t.naming },
+		...t.etag === void 0 ? {} : { etag: t.etag }
+	}, i = r(n(e) ?? h.rpc, e);
+	return r(n(t) ?? i, t);
+}, v = (e) => e.replace(/([a-z0-9])([A-Z])/g, "$1_$2").replace(/([A-Z])([A-Z][a-z])/g, "$1_$2").toLowerCase(), y = (e, t) => {
+	if (typeof e != "object" || !e || Array.isArray(e)) return e;
+	let n = {};
+	for (let [r, i] of Object.entries(e)) n[t(r)] = i;
+	return n;
+}, b = (e) => n.getOrUndefined(t.getIdentifierAnnotation(e)), x = (n, r) => {
+	if (r.dates === "epoch-ms" && r.naming === "camelCase") return n;
+	let i = /* @__PURE__ */ new Map(), a = (e) => {
+		let t = i.get(e);
+		if (t !== void 0) return t;
+		let n = o(e);
+		return i.set(e, n), n;
+	}, o = (n) => {
+		switch (n._tag) {
+			case "Transformation":
+				if (r.dates === "iso" && b(n) === "DateFromNumber") {
+					let r = e.DateFromString.ast;
+					return new t.Transformation(r.from, r.to, r.transformation, {
+						...r.annotations,
+						...n.annotations,
+						[t.IdentifierAnnotationId]: "DateFromString",
+						[t.JSONSchemaAnnotationId]: {
+							type: "string",
+							format: "date-time"
+						}
+					});
+				}
+				return n;
+			case "Refinement": return new t.Refinement(a(n.from), n.filter, n.annotations);
+			case "Union": return t.Union.make(n.types.map(a), n.annotations);
+			case "TupleType": return new t.TupleType(n.elements.map((e) => new t.OptionalType(a(e.type), e.isOptional, e.annotations)), n.rest.map((e) => new t.Type(a(e.type), e.annotations)), n.isReadonly, n.annotations);
+			case "Suspend": return new t.Suspend(() => a(n.f()), n.annotations);
+			case "TypeLiteral": {
+				let i = n.propertySignatures.map((e) => new t.PropertySignature(e.name, a(e.type), e.isOptional, e.isReadonly, e.annotations)), o = new t.TypeLiteral(i, n.indexSignatures, n.annotations);
+				if (r.naming !== "snake_case") return o;
+				let s = i.map((e) => typeof e.name == "string" ? v(e.name) : e.name);
+				if (s.every((e, t) => e === i[t].name)) return o;
+				let c = new t.TypeLiteral(i.map((e, n) => new t.PropertySignature(s[n], t.encodedAST(e.type), e.isOptional, e.isReadonly, e.annotations)), n.indexSignatures, n.annotations), l = new Map(i.map((e, t) => [String(s[t]), String(e.name)])), u = new Map(i.map((e, t) => [String(e.name), String(s[t])]));
+				return e.transform(e.make(c), e.make(o), {
+					strict: !1,
+					decode: (e) => y(e, (e) => l.get(e) ?? e),
+					encode: (e) => y(e, (e) => u.get(e) ?? e)
+				}).ast;
+			}
+			default: return n;
+		}
+	};
+	return e.make(a(n.ast));
+}, S = (e) => `urn:voltro:error:${e}`, C = (e) => e.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/([A-Z])([A-Z][a-z])/g, "$1 $2"), w = (e) => ({
+	type: S(e.tag),
+	title: C(e.tag),
+	status: e.status,
+	...e.message.length > 0 ? { detail: e.message } : {},
+	...e.fields
+}), T = "application/problem+json; charset=utf-8", E = "application/vnd.api+json; charset=utf-8", D = (e, t, n) => e.encodeError === void 0 ? e.errors === "problem-details" ? e.envelope === "jsonapi" ? {
+	body: { errors: [{
+		status: String(t.status),
+		code: t.tag,
+		title: C(t.tag),
+		...t.message.length > 0 ? { detail: t.message } : {},
+		...Object.keys(t.fields).length > 0 ? { meta: t.fields } : {}
+	}] },
+	contentType: E
+} : {
+	body: w(t),
+	contentType: T
+} : { body: {
+	error: t.tag === "InvalidRequest" || t.tag === "InternalServerError" || t.tag === "Unauthorized" || t.tag === "Forbidden" || t.tag === "Gone" || t.tag === "MethodNotAllowed" || t.tag === "Conflict" ? t.message : t.tag,
+	...t.fields
+} } : e.encodeError(t, n), O = (e, t) => {
+	if (typeof e != "object" || !e || Array.isArray(e)) return {
+		cursor: void 0,
+		rest: e
+	};
+	let n = e[t];
+	return typeof n != "string" && typeof n != "number" ? {
+		cursor: void 0,
+		rest: e
+	} : {
+		cursor: String(n),
+		rest: e
+	};
+}, k = (e, t, n) => {
+	let r = new URLSearchParams(e.query);
+	return r.set(n, t), `<${e.path}?${r.toString()}>; rel="next"`;
+}, A = (e, t) => {
+	if (typeof e != "object" || !e || Array.isArray(e)) return e;
+	let { id: n, ...r } = e;
+	return {
+		type: t,
+		...n === void 0 ? {} : { id: String(n) },
+		attributes: r
+	};
+}, j = (e, t, n) => {
+	if (e.encodeSuccess !== void 0) return e.encodeSuccess(t, n);
+	let { cursor: r } = O(t, e.cursorField), i = e.pagination === "link-header" && r !== void 0 ? { Link: k(n, r, e.cursorParam) } : void 0, a = (e, t) => ({
+		body: e,
+		...i ? { headers: i } : {},
+		...t ? { contentType: t } : {}
+	});
+	if (e.envelope === "none") return a(t);
+	if (e.envelope === "data") return a({
+		data: t,
+		...r !== void 0 && e.pagination === "link-header" ? { next: r } : {}
+	});
+	let o = n.source ?? n.tag.split(".")[0] ?? "resource", s = Array.isArray(t) ? t : typeof t == "object" && t && Array.isArray(t.items) ? t.items : void 0;
+	return a({
+		data: s === void 0 ? A(t, o) : s.map((e) => A(e, o)),
+		...r === void 0 ? {} : { links: { next: k(n, r, e.cursorParam).replace(/^<|>; rel="next"$/g, "") } }
+	}, E);
+};
+//#endregion
+export { i as S, o as _, j as a, r as b, S as c, v as d, p as f, u as g, a as h, D as i, _ as l, d as m, T as n, k as o, m as p, g as r, w as s, E as t, x as u, c as v, l as x, s as y };

package/dist/session.d.ts

@@ -162,18 +162,18 @@ declare const SessionPayload_2: Schema.Struct<{
     v: Schema.Literal<[2]>;
     /** WHO, never WHAT-THEY-MAY-DO. `SubjectIdentity` has no `scopes` field. */
     subject: Schema.Union<[Schema.Struct<{
-        id: typeof Schema.String;
         type: Schema.Literal<["user"]>;
+        id: typeof Schema.String;
         tenantId: typeof Schema.String;
         metadata: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
     }>, Schema.Struct<{
-        id: typeof Schema.String;
         type: Schema.Literal<["apiKey"]>;
+        id: typeof Schema.String;
         tenantId: typeof Schema.String;
         metadata: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
     }>, Schema.Struct<{
-        id: typeof Schema.String;
         type: Schema.Literal<["serviceAccount"]>;
+        id: typeof Schema.String;
         tenantId: typeof Schema.String;
         metadata: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
     }>, Schema.Struct<{
@@ -182,8 +182,8 @@ declare const SessionPayload_2: Schema.Struct<{
         tenantId: Schema.NullOr<typeof Schema.String>;
         credentialRejected: Schema.optional<typeof Schema.String>;
     }>, Schema.Struct<{
-        id: typeof Schema.String;
         type: Schema.Literal<["system"]>;
+        id: typeof Schema.String;
         tenantId: typeof Schema.Null;
         metadata: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
     }>]>;
@@ -308,18 +308,18 @@ declare const Subject: Schema.Union<[Schema.Struct<{
 declare type Subject = typeof Subject.Type;
 
 declare const SubjectIdentity: Schema.Union<[Schema.Struct<{
-    id: typeof Schema.String;
     type: Schema.Literal<["user"]>;
+    id: typeof Schema.String;
     tenantId: typeof Schema.String;
     metadata: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
 }>, Schema.Struct<{
-    id: typeof Schema.String;
     type: Schema.Literal<["apiKey"]>;
+    id: typeof Schema.String;
     tenantId: typeof Schema.String;
     metadata: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
 }>, Schema.Struct<{
-    id: typeof Schema.String;
     type: Schema.Literal<["serviceAccount"]>;
+    id: typeof Schema.String;
     tenantId: typeof Schema.String;
     metadata: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
 }>, Schema.Struct<{
@@ -344,8 +344,8 @@ declare const SubjectIdentity: Schema.Union<[Schema.Struct<{
      */
     credentialRejected: Schema.optional<typeof Schema.String>;
 }>, Schema.Struct<{
-    id: typeof Schema.String;
     type: Schema.Literal<["system"]>;
+    id: typeof Schema.String;
     tenantId: typeof Schema.Null;
     metadata: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
 }>]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/protocol",
-  "version": "0.69.0",
+  "version": "0.70.0",
   "description": "The Voltro wire + plugin contract — defineQuery/Mutation/Action/Stream, definePlugin, sessions / JWT / API-keys, and the RPC protocol.",
   "keywords": [
     "voltro",
@@ -59,8 +59,8 @@
   },
   "dependencies": {
     "@effect/sql": "^0.52.1",
-    "@voltro/database": "0.69.0",
-    "@voltro/logger": "0.69.0",
+    "@voltro/database": "0.70.0",
+    "@voltro/logger": "0.70.0",
     "jose": "^6.2.10"
   },
   "peerDependencies": {

package/dist/serverErrorBus-BTnTpMqj.js

@@ -1,60 +0,0 @@
-import { Schema as e } from "effect";
-//#region src/idempotency.ts
-var t = (e, t, n) => `${e ?? "(global)"}|${t.toUpperCase()}|${n}`, n = (e, t, n, r) => r === void 0 ? `${e ?? "(global)"}|${t ?? "(anon)"}|WS|${n}` : `WS-connection:${JSON.stringify([
-	e ?? null,
-	t ?? null,
-	n,
-	r
-])}`, r = class extends e.TaggedError()("MutationConnectionRequired", { traceId: e.String }) {
-	get message() {
-		return "this mutation requires a live native WebSocket connection";
-	}
-}, i = async (e, t, n, r, i) => {
-	let a = await e.claim(t, n, i, r);
-	return a === "claimed" ? { kind: "fresh" } : a.status === "completed" && a.response ? {
-		kind: "replay",
-		response: a.response
-	} : { kind: "conflict" };
-}, a = (e, t, n, r, i) => e.complete(t, n, r, i), o = (e, t, n) => e.release(t, n), s = () => {
-	let e = /* @__PURE__ */ new Map(), t = (e, t) => `${e}\u0000${t}`;
-	return {
-		get: async (n, r) => e.get(t(n, r)) ?? null,
-		claim: async (n, r, i, a) => {
-			let o = e.get(t(n, r));
-			return o && i - o.createdAt < a ? o : (e.set(t(n, r), {
-				scope: n,
-				key: r,
-				status: "in_flight",
-				response: null,
-				createdAt: i
-			}), "claimed");
-		},
-		complete: async (n, r, i, a) => {
-			e.set(t(n, r), {
-				scope: n,
-				key: r,
-				status: "completed",
-				response: i,
-				createdAt: a
-			});
-		},
-		release: async (n, r) => {
-			e.delete(t(n, r));
-		}
-	};
-}, c = 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`;
-	}
-}, l = 1e3, u = /* @__PURE__ */ new Set(), d = (e) => {
-	for (let t of u) try {
-		t(e);
-	} catch {}
-}, f = (e) => (u.add(e), () => {
-	u.delete(e);
-});
-//#endregion
-export { c as a, a as c, n as d, r as i, t as l, f as n, i as o, l as r, o as s, d as t, s as u };