@voltro/protocol 0.84.0 → 0.86.0

package/dist/inspectProjection.js

@@ -0,0 +1,133 @@
+import { canonicalInspectValue as e } from "./inspectValueIdentity.js";
+import { projectStorageReplicaAnswers as t } from "./inspectStorageProjection.js";
+//#region src/inspectProjection.ts
+var n = (e) => typeof e == "object" && e && !Array.isArray(e) ? e : void 0, r = (e) => Array.isArray(e) && e.every((e) => n(e) !== void 0) ? e : void 0, i = (e) => typeof e == "number" && Number.isFinite(e) ? e : 0, a = /* @__PURE__ */ new Set([
+	"counter",
+	"gauge",
+	"histogram",
+	"summary",
+	"frequency"
+]), o = (e) => {
+	let t = r(e);
+	return t?.every((e) => typeof e.name == "string" && a.has(String(e.type))) ? t : void 0;
+}, s = (a) => {
+	let s = n(a), c = n(s?.data), l = r(c?.results);
+	if (!s || !c?.selection || !l) return a;
+	let u = l.filter((e) => e.status === "answered").map((e) => ({
+		replicaId: String(e.replicaId),
+		observation: n(e.observation),
+		data: n(e.observation)?.data
+	}));
+	if (u.length === 0) throw Error("None of the selected replicas answered. Check replica availability and retry.");
+	let d = u.map((e) => ({
+		...e,
+		object: n(e.data)
+	})), f = (e) => d.reduce((t, n) => t + i(n.object?.[e]), 0), p = -Infinity;
+	for (let e of u) p = Math.max(p, i(e.observation?.capturedAt));
+	let m = {
+		capturedAt: p,
+		bufferSize: f("bufferSize"),
+		bufferCapacity: f("bufferCapacity")
+	}, h, g = u.every((e) => n(e.data)) ? t(u.map((e) => ({
+		replicaId: e.replicaId,
+		capturedAt: i(e.observation?.capturedAt),
+		data: n(e.data)
+	}))) : void 0;
+	if (g !== void 0) return {
+		...s,
+		data: g
+	};
+	if (d.every((e) => r(e.object?.plugins))) {
+		let t = d.map((e) => r(e.object.plugins)), n = t[0].filter((n) => t.every((t) => t.some((t) => e(t) === e(n)))), i = new Set(n.map(e)), a = [...new Set(t.flatMap((t) => t.filter((t) => !i.has(e(t))).map((e) => String(e.name))))].sort();
+		h = {
+			capturedAt: p,
+			plugins: n,
+			inventoryConflicts: a
+		};
+	} else if (d.every((e) => r(e.object?.records))) {
+		let e = d.flatMap((e) => r(e.object?.records).map((t) => ({
+			...t,
+			fields: {
+				...n(t.fields),
+				"voltro.replica": e.replicaId
+			}
+		}))).sort((e, t) => i(e.ts) - i(t.ts));
+		h = {
+			...m,
+			returned: e.length,
+			records: e
+		};
+	} else if (d.every((e) => r(e.object?.traces))) {
+		let e = /* @__PURE__ */ new Map();
+		for (let t of d) for (let i of r(t.object?.traces)) {
+			let a = String(i.traceId), o = (r(i.spans) ?? []).map((e) => ({
+				...e,
+				attributes: {
+					...n(e.attributes),
+					"voltro.replica": t.replicaId
+				}
+			})), s = e.get(a) ?? [];
+			s.push({
+				...i,
+				spans: o
+			}), e.set(a, s);
+		}
+		let t = [...e.values()].map((e) => {
+			let t = e.flatMap((e) => r(e.spans) ?? []).sort((e, t) => i(e.startMs) - i(t.startMs)), n = e[0], a = i(n.startMs);
+			for (let t = 1; t < e.length; t += 1) {
+				let r = e[t], o = i(r.startMs);
+				o < a && (n = r, a = o);
+			}
+			let o = -Infinity, s = -Infinity, c = 0, l = !1, u = !1, d = !1;
+			for (let t of e) o = Math.max(o, i(t.startMs) + i(t.durationMs)), l ||= t.hasError === !0, u ||= t.deliveryCount !== void 0, d ||= t.lastDeliveryMs !== void 0, c += i(t.deliveryCount), s = Math.max(s, i(t.lastDeliveryMs));
+			return {
+				...n,
+				startMs: a,
+				durationMs: Math.max(0, o - a),
+				spanCount: t.length,
+				hasError: l,
+				spans: t,
+				...u ? { deliveryCount: c } : {},
+				...d ? { lastDeliveryMs: s } : {}
+			};
+		}).sort((e, t) => t.startMs - e.startMs);
+		h = {
+			...m,
+			returned: t.length,
+			traces: t
+		};
+	} else if (d.every((e) => r(e.object?.buckets) && typeof e.object?.windowMs == "number")) {
+		let e = -Infinity;
+		for (let t of d) e = Math.max(e, i(t.object?.windowMs));
+		h = {
+			capturedAt: p,
+			windowMs: e,
+			totalSamples: f("totalSamples"),
+			buckets: d.flatMap((e) => r(e.object?.buckets).map((t) => ({
+				...t,
+				tag: `${String(t.tag)} [${e.replicaId}]`
+			})))
+		};
+	} else if (u.every((e) => o(e.data))) h = u.flatMap((e) => o(e.data).map((t) => ({
+		...t,
+		labels: {
+			...n(t.labels),
+			voltro_replica: e.replicaId
+		}
+	})));
+	else if (d.every((e) => o(e.object?.samples))) h = { samples: d.flatMap((e) => o(e.object?.samples).map((t) => ({
+		...t,
+		labels: {
+			...n(t.labels),
+			voltro_replica: e.replicaId
+		}
+	}))) };
+	else if (l.length === 1 && u.length === 1) h = u[0].data;
+	else throw Error("This view must compare observations per replica; its values cannot be safely combined.");
+	return {
+		...s,
+		data: h
+	};
+};
+//#endregion
+export { s as projectReplicaObservation };

package/dist/inspectStorageProjection.js

@@ -0,0 +1,86 @@
+import { canonicalInspectValue as e } from "./inspectValueIdentity.js";
+//#region src/inspectStorageProjection.ts
+var t = (e) => typeof e == "object" && e && !Array.isArray(e) ? e : void 0, n = (e) => Array.isArray(e) && e.every((e) => t(e)) ? e : void 0, r = (e) => {
+	let n = t(e);
+	if (n && ["catalogueId", "objectNamespace"].every((e) => typeof n[e] == "string" && /^[a-f0-9]{64}$/.test(n[e])) && typeof n.storageInstance == "string" && n.storageInstance.trim()) return {
+		catalogueId: n.catalogueId,
+		objectNamespace: n.objectNamespace,
+		storageInstance: n.storageInstance
+	};
+}, i = (e) => {
+	if (typeof e != "number" || !Number.isSafeInteger(e) || e < 0) throw Error("Storage observation contains an invalid counter.");
+	return e;
+}, a = (e, t) => i(e + t), o = (o) => {
+	if (!o.length || !o.every((e) => r(e.data.source))) return;
+	let s = /* @__PURE__ */ new Map();
+	for (let t of o) {
+		let n = r(t.data.source), i = s.get(n.catalogueId);
+		if (i) {
+			if (e(i.source) !== e(n) || e(i.data) !== e(t.data)) throw Error("Replicas returned different snapshots for the same storage catalogue. Compare the replicas or retry the read; counters have not been combined.");
+			i.replicaIds.push(t.replicaId), i.capturedAt = Math.max(i.capturedAt, t.capturedAt);
+		} else s.set(n.catalogueId, {
+			source: n,
+			data: t.data,
+			replicaIds: [t.replicaId],
+			capturedAt: t.capturedAt
+		});
+	}
+	let c = [...s.values()].sort((e, t) => e.source.catalogueId.localeCompare(t.source.catalogueId)), l = c.map((e) => ({
+		...e.source,
+		replicaIds: [...new Set(e.replicaIds)].sort(),
+		capturedAt: e.capturedAt
+	}));
+	if (c.every((e) => n(e.data.refs) && t(e.data.page))) {
+		let e = c.map((e) => t(e.data.page));
+		if (e.some((t) => t.search !== e[0].search || t.offset !== e[0].offset)) throw Error("Storage replica pages do not describe the same query.");
+		let r = i(e[0].offset), o = e.some((e) => e.nextOffset !== null) ? a(r, 50) : null;
+		if (e.some((e) => e.nextOffset !== null && e.nextOffset !== o)) throw Error("Storage replica pages contain an invalid continuation.");
+		return {
+			sources: l,
+			refs: c.flatMap((e) => n(e.data.refs).map((t) => ({
+				...t,
+				source: {
+					...e.source,
+					replicaIds: [...new Set(e.replicaIds)].sort()
+				}
+			}))).sort((e, t) => String(t.createdAt).localeCompare(String(e.createdAt)) || String(t.id).localeCompare(String(e.id)) || e.source.catalogueId.localeCompare(t.source.catalogueId)),
+			page: {
+				search: e[0].search,
+				offset: r,
+				nextOffset: o
+			}
+		};
+	}
+	if (c.every((e) => typeof e.data.provider == "string" && typeof e.data.bucket == "string" && t(e.data.byTenant) && t(e.data.visibility))) {
+		let e = /* @__PURE__ */ new Map(), n = 0, r = 0;
+		for (let o of c) {
+			for (let [n, r] of Object.entries(t(o.data.byTenant))) {
+				let o = t(r);
+				if (!o) throw Error("Storage tenant observation is unreadable.");
+				let s = e.get(n) ?? {
+					count: 0,
+					bytes: 0
+				};
+				e.set(n, {
+					count: a(s.count, i(o.count)),
+					bytes: a(s.bytes, i(o.bytes))
+				});
+			}
+			let s = t(o.data.visibility);
+			n = a(n, i(s.public)), r = a(r, i(s.private));
+		}
+		let o = [...new Set(c.map((e) => String(e.data.provider)))].sort(), s = [...new Set(c.map((e) => String(e.data.bucket)))].sort();
+		return {
+			sources: l,
+			provider: o.length === 1 ? o[0] : o.join(", "),
+			bucket: s.length === 1 ? s[0] : s.join(", "),
+			byTenant: Object.fromEntries(e),
+			visibility: {
+				public: n,
+				private: r
+			}
+		};
+	}
+};
+//#endregion
+export { o as projectStorageReplicaAnswers };

package/dist/inspectValueIdentity.js

@@ -0,0 +1,4 @@
+//#region src/inspectValueIdentity.ts
+var e = (e) => JSON.stringify(t(e)), t = (e) => Array.isArray(e) ? e.map(t) : typeof e == "object" && e ? Object.fromEntries(Object.entries(e).sort(([e], [t]) => e.localeCompare(t)).map(([e, n]) => [e, t(n)])) : e;
+//#endregion
+export { e as canonicalInspectValue };

package/dist/inspectWorkflowExecution.js

@@ -0,0 +1,34 @@
+import { Schema as e } from "effect";
+//#region src/inspectWorkflowExecution.ts
+var t = e.NonEmptyString.pipe(e.check(e.isMaxLength(1024)), e.check(e.makeFilter((e) => e.trim().length > 0 && !/[\u0000-\u001f\u007f]/.test(e)))), n = e.Struct({
+	workflowName: t,
+	executionId: t
+}), r = n.fields, i = e.Union([
+	e.Struct({
+		...r,
+		kind: e.Literal("not-observed")
+	}),
+	e.Struct({
+		...r,
+		kind: e.Literal("pending")
+	}),
+	e.Struct({
+		...r,
+		kind: e.Literal("delivery-failed")
+	}),
+	e.Struct({
+		...r,
+		kind: e.Literal("suspended")
+	}),
+	e.Struct({
+		...r,
+		kind: e.Literal("completed"),
+		outcome: e.Literals([
+			"succeeded",
+			"failed",
+			"cancelled"
+		])
+	})
+]);
+//#endregion
+export { i as InspectWorkflowExecutionObservationSchema, n as InspectWorkflowExecutionTargetSchema };

package/dist/inspectWorkflowQueuedStart.js

@@ -0,0 +1,31 @@
+import { Schema as e } from "effect";
+//#region src/inspectWorkflowQueuedStart.ts
+var t = e.NonEmptyString.pipe(e.check(e.isMaxLength(1024)), e.check(e.makeFilter((e) => e.trim().length > 0 && !/[\u0000-\u001f\u007f]/.test(e)))), n = e.Struct({
+	workflowName: t,
+	receiptId: t,
+	tenantId: e.NullOr(t)
+}), r = n.fields, i = e.Union([
+	e.Struct({
+		...r,
+		kind: e.Literal("pending")
+	}),
+	e.Struct({
+		...r,
+		kind: e.Literal("accepted"),
+		executionId: t
+	}),
+	e.Struct({
+		...r,
+		kind: e.Literal("not-executed"),
+		reason: e.Literals([
+			"dropped",
+			"skipped",
+			"superseded",
+			"cancelled",
+			"abandoned",
+			"rejected"
+		])
+	})
+]);
+//#endregion
+export { i as InspectWorkflowQueuedStartObservationSchema, n as InspectWorkflowQueuedStartTargetSchema };

package/dist/jsonSchema.js

@@ -0,0 +1,54 @@
+import { Schema as e, SchemaAST as t } from "effect";
+//#region src/jsonSchema.ts
+var n = (e) => typeof e == "object" && !!e && !Array.isArray(e), r = (e, t = /* @__PURE__ */ new Map()) => {
+	let n = t.get(e);
+	if (n !== void 0) return n;
+	let r = i(e, t);
+	return t.set(e, r), r;
+}, i = (n, i) => n.encoding === void 0 ? t.isNumber(n) ? e.make(n).check(e.isFinite()).ast : t.isObjects(n) ? new t.Objects(n.propertySignatures.map((e) => new t.PropertySignature(e.name, r(e.type, i))), n.indexSignatures.map((e) => new t.IndexSignature(e.parameter, r(e.type, i))), n.annotations, n.checks, void 0, n.context) : t.isArrays(n) ? new t.Arrays(n.isMutable, n.elements.map((e) => r(e, i)), n.rest.map((e) => r(e, i)), n.annotations, n.checks, void 0, n.context) : t.isUnion(n) ? new t.Union(n.types.map((e) => r(e, i)), n.options, n.annotations, n.checks, void 0, n.context) : t.isSuspend(n) ? new t.Suspend(() => r(n.thunk(), i), n.annotations, n.checks, void 0, n.context) : n : n, a = (e) => {
+	if (Array.isArray(e)) return e.map(a);
+	if (!n(e)) return e;
+	let t = e.not;
+	if (n(t) && t.type === "null" && Object.keys(e).length === 1) return {
+		type: "object",
+		properties: {},
+		additionalProperties: !1
+	};
+	let r = e.anyOf;
+	if (Array.isArray(r)) {
+		if (r.length === 2) {
+			let t = r.find((e) => n(e) && e.type === "number"), i = r.find((e) => n(e) && e.type === "string" && Array.isArray(e.enum) && e.enum.includes("Infinity"));
+			if (n(t) && i !== void 0) {
+				let { anyOf: n, ...r } = e;
+				return a({
+					...r,
+					...t
+				});
+			}
+		}
+		if (r.length === 1 && n(r[0])) {
+			let { anyOf: t, ...n } = e;
+			return a({
+				...n,
+				...r[0]
+			});
+		}
+	}
+	let i = {};
+	for (let [t, n] of Object.entries(e)) i[t] = a(n);
+	return i;
+}, o = (t, n = {}) => {
+	let i = e.make(r(t.ast)), o = e.toJsonSchemaDocument(i, n.closed === !1 ? {} : { onExcessProperty: "error" });
+	return {
+		schema: a(o.schema),
+		definitions: a(o.definitions)
+	};
+}, s = (e, t = {}) => {
+	let { schema: n, definitions: r } = o(e, t);
+	return Object.keys(r).length === 0 ? n : {
+		...n,
+		$defs: r
+	};
+};
+//#endregion
+export { r as finiteNumberView, o as jsonSchemaDocumentOf, s as jsonSchemaOf, a as plainJsonSchema };

package/dist/jwt.d.ts

@@ -289,33 +289,31 @@ declare type StrategyResolution = {
     readonly reason: string;
 };
 
-declare const Subject: Schema.Union<[Schema.Struct<{
-    type: Schema.Literal<["user"]>;
-    id: typeof Schema.String;
-    tenantId: typeof Schema.String;
-    scopes: Schema.optional<Schema.Array$<typeof Schema.String>>;
-    metadata: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+declare const Subject: Schema.Union<readonly [Schema.Struct<{
+    readonly type: Schema.Literal<"user">;
+    readonly id: Schema.String;
+    readonly tenantId: Schema.String;
+    readonly scopes: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
 }>, Schema.Struct<{
-    type: Schema.Literal<["apiKey"]>;
-    id: typeof Schema.String;
-    tenantId: typeof Schema.String;
-    scopes: Schema.optional<Schema.Array$<typeof Schema.String>>;
-    metadata: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+    readonly type: Schema.Literal<"apiKey">;
+    readonly id: Schema.String;
+    readonly tenantId: Schema.String;
+    readonly scopes: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
 }>, Schema.Struct<{
-    type: Schema.Literal<["serviceAccount"]>;
-    id: typeof Schema.String;
-    tenantId: typeof Schema.String;
+    readonly type: Schema.Literal<"serviceAccount">;
+    readonly id: Schema.String;
+    readonly tenantId: Schema.String;
     /** Application actor used for audit columns; null means machine work with
      * no application actor. Identity only, never a permission grant. */
-    auditActorId: Schema.optionalWith<Schema.NullOr<typeof Schema.String>, {
-        exact: true;
-    }>;
-    scopes: Schema.optional<Schema.Array$<typeof Schema.String>>;
-    metadata: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+    readonly auditActorId: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+    readonly scopes: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
 }>, Schema.Struct<{
-    type: Schema.Literal<["anonymous"]>;
-    id: typeof Schema.Null;
-    tenantId: Schema.NullOr<typeof Schema.String>;
+    readonly type: Schema.Literal<"anonymous">;
+    readonly id: Schema.Null;
+    readonly tenantId: Schema.NullOr<Schema.String>;
     /**
      * Set when this caller PRESENTED a credential and it was rejected — an
      * expired token above all. Absent when they presented none.
@@ -332,21 +330,21 @@ declare const Subject: Schema.Union<[Schema.Struct<{
      * must not break an `openAccess` procedure that needs no session at all. The
      * fact travels, and only a guard that actually refuses spends it.
      */
-    credentialRejected: Schema.optional<typeof Schema.String>;
+    readonly credentialRejected: Schema.optional<Schema.String>;
 }>, Schema.Struct<{
-    type: Schema.Literal<["system"]>;
-    id: typeof Schema.String;
-    tenantId: typeof Schema.Null;
-    scopes: Schema.optional<Schema.Array$<typeof Schema.String>>;
-    metadata: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+    readonly type: Schema.Literal<"system">;
+    readonly id: Schema.String;
+    readonly tenantId: Schema.Null;
+    readonly scopes: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
 }>, Schema.Struct<{
-    type: Schema.Literal<["service"]>;
-    id: typeof Schema.String;
+    readonly type: Schema.Literal<"service">;
+    readonly id: Schema.String;
     /** The calling app's name, as the callee lists it in `serviceCallers`. */
-    service: typeof Schema.String;
-    tenantId: typeof Schema.Null;
-    scopes: Schema.optional<Schema.Array$<typeof Schema.String>>;
-    metadata: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+    readonly service: Schema.String;
+    readonly tenantId: Schema.Null;
+    readonly scopes: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
 }>]>;
 
 declare type Subject = typeof Subject.Type;

package/dist/outbox.js

@@ -0,0 +1,10 @@
+//#region src/outbox.ts
+function e(e, t) {
+	if (typeof e != "object" || !e) throw Error(`Outbox handler ${t}: definition must be an object`);
+	let n = e;
+	if (typeof n.effect != "string" || n.effect.trim() === "") throw Error(`Outbox handler ${t}: effect must be a non-empty string`);
+	if (typeof n.handler != "function") throw Error(`Outbox handler ${t}: handler must be a function`);
+	if (n.maxAttempts !== void 0 && (typeof n.maxAttempts != "number" || !Number.isSafeInteger(n.maxAttempts) || n.maxAttempts < 1)) throw Error(`Outbox handler ${t}: maxAttempts must be a positive safe integer`);
+}
+//#endregion
+export { e as validateOutboxHandlerDefinition };

package/dist/pairing.js

@@ -0,0 +1,75 @@
+//#region src/pairing.ts
+var e = "voltro-dev", t = "pair", n = "voltro:pairing", r = (e) => {
+	try {
+		let t = new URL(e);
+		return t.protocol === "http:" || t.protocol === "https:";
+	} catch {
+		return !1;
+	}
+}, i = (e) => {
+	try {
+		let t = new URL(e).hostname;
+		return t === "localhost" || t === "127.0.0.1" || t === "::1" || t === "[::1]";
+	} catch {
+		return !1;
+	}
+}, a = (n) => {
+	if (!r(n.api)) throw Error(`pairingLink: api must be an http(s) url, got ${JSON.stringify(n.api)}`);
+	if (i(n.api)) throw Error("pairingLink: api must be the LAN address — a device cannot reach localhost on this machine");
+	if (!/^[A-Za-z0-9_-]+$/.test(n.name)) throw Error(`pairingLink: name must be a plain identifier, got ${JSON.stringify(n.name)}`);
+	let a = new URLSearchParams({
+		api: n.api,
+		name: n.name
+	});
+	return n.token !== void 0 && n.token.length > 0 && a.set("token", n.token), `${e}://${t}?${a.toString()}`;
+}, o = (e) => {
+	let t;
+	try {
+		t = new URL(e);
+	} catch {
+		return null;
+	}
+	if (t.protocol !== "voltro-dev:" || (t.host || t.pathname.replace(/^\/+/, "")) !== "pair") return null;
+	let n = t.searchParams.get("api") ?? "", a = t.searchParams.get("name") ?? "", o = t.searchParams.get("token");
+	return !r(n) || i(n) || !/^[A-Za-z0-9_-]+$/.test(a) ? null : {
+		api: n,
+		name: a,
+		...o !== null && o.length > 0 ? { token: o } : {}
+	};
+}, s = (e) => "getItem" in e ? {
+	get: async (t) => e.getItem(t),
+	set: async (t, n) => {
+		await e.setItem(t, n);
+	},
+	remove: e.removeItem ? async (t) => {
+		await e.removeItem(t);
+	} : null
+} : {
+	get: async (t) => e.get(t),
+	set: async (t, n) => {
+		await e.set(t, n);
+	},
+	remove: e.remove ? async (t) => {
+		await e.remove(t);
+	} : null
+}, c = async (e, t) => {
+	await s(e).set(n, JSON.stringify(t));
+}, l = async (e) => {
+	let t = await s(e).get(n);
+	if (t === null || t === "") return null;
+	try {
+		let e = JSON.parse(t);
+		return typeof e.api != "string" || typeof e.name != "string" || !r(e.api) ? null : {
+			api: e.api,
+			name: e.name,
+			...typeof e.token == "string" && e.token.length > 0 ? { token: e.token } : {}
+		};
+	} catch {
+		return null;
+	}
+}, u = async (e) => {
+	let t = s(e);
+	t.remove ? await t.remove(n) : await t.set(n, "");
+};
+//#endregion
+export { t as PAIRING_HOST, e as PAIRING_SCHEME, n as PAIRING_STORAGE_KEY, c as applyPairing, u as clearPairing, a as pairingLink, o as parsePairingLink, l as readPairing };

package/dist/plugin.js

@@ -0,0 +1,61 @@
+import { Context as e, Layer as t } from "effect";
+//#region src/plugin.ts
+var n = (e) => e, r = (e) => e, i = (e) => {
+	let t = e.alias?.trim(), n = e.instance?.trim(), r = t !== void 0 && t !== "" ? t : e.base;
+	return n !== void 0 && n !== "" ? `${r}#${n}` : r;
+}, a = (e) => {
+	if (e.length !== 0) return (t, n) => e.reduceRight((e, t) => t(e, n), t);
+}, o = (n, r) => {
+	let i = e.Service(n);
+	return {
+		Tag: i,
+		Live: t.succeed(i, r)
+	};
+}, s = (e, t, n) => {
+	if (!t) return { ok: !0 };
+	let r = n === void 0 ? null : c(n);
+	if (!r) return {
+		ok: !0,
+		unverified: `plugin "${e}" requires framework ${t}, but the running framework version is ${n === void 0 ? "unknown" : `unreadable ("${n}")`} — not checked.`
+	};
+	let i = t.trim();
+	if (i === "*" || i === "") return { ok: !0 };
+	let a = i.split(/\s+/);
+	for (let i of a) if (!u(i, r)) return {
+		ok: !1,
+		reason: `plugin "${e}" requires framework ${t}, running ${n}`
+	};
+	return { ok: !0 };
+}, c = (e) => {
+	let t = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9a-zA-Z.-]+))?$/.exec(e.trim());
+	return t ? {
+		major: Number(t[1]),
+		minor: Number(t[2]),
+		patch: Number(t[3]),
+		pre: t[4] ?? ""
+	} : null;
+}, l = (e, t) => e.major === t.major ? e.minor === t.minor ? e.patch === t.patch ? e.pre && !t.pre ? -1 : !e.pre && t.pre ? 1 : e.pre && t.pre ? e.pre < t.pre ? -1 : +(e.pre > t.pre) : 0 : e.patch - t.patch : e.minor - t.minor : e.major - t.major, u = (e, t) => {
+	if (e === "*") return !0;
+	if (e.startsWith("^")) {
+		let n = c(e.slice(1));
+		return !n || t.major !== n.major ? !1 : l(t, n) >= 0;
+	}
+	if (e.startsWith("~")) {
+		let n = c(e.slice(1));
+		return !n || t.major !== n.major || t.minor !== n.minor ? !1 : l(t, n) >= 0;
+	}
+	let n = /^(>=|<=|>|<)(.+)$/.exec(e);
+	if (n) {
+		let e = n[1], r = c(n[2]);
+		if (!r) return !1;
+		let i = l(t, r);
+		if (e === ">=") return i >= 0;
+		if (e === "<=") return i <= 0;
+		if (e === ">") return i > 0;
+		if (e === "<") return i < 0;
+	}
+	let r = c(e);
+	return r ? l(t, r) === 0 : !1;
+};
+//#endregion
+export { s as checkFrameworkCompat, a as composeRpcInterceptors, n as definePlugin, r as definePluginRoute, o as definePluginService, i as pluginInstanceName };

package/dist/pluginNaming.js

@@ -0,0 +1,32 @@
+//#region src/pluginNaming.ts
+var e = (e) => {
+	let t = e.startsWith("@") ? e.replace(/^@[^/]+\//, "") : e;
+	return (t.startsWith("plugin-") ? t.slice(7) : t).replace(/-([a-zA-Z0-9])/g, (e, t) => t.toUpperCase());
+}, t = (e) => {
+	let t = e.startsWith("@") ? e.replace(/^@[^/]+\//, "") : e;
+	return (t.startsWith("plugin-") ? t.slice(7) : t).replace(/#/g, "--").replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
+}, n = Symbol.for("@voltro/protocol/pluginAliases"), r = () => {
+	let e = globalThis, t = e[n];
+	if (t instanceof Map) return t;
+	let r = /* @__PURE__ */ new Map();
+	return e[n] = r, r;
+}, i = (e) => {
+	let t = r();
+	for (let [n, r] of Object.entries(e)) {
+		if (r === "") continue;
+		let e = t.get(n);
+		e === void 0 ? t.set(n, /* @__PURE__ */ new Set([r])) : e.add(r);
+	}
+}, a = () => {
+	r().clear();
+}, o = (t, n) => {
+	let i = r().get(t);
+	if (i === void 0 || i.size === 0) return `${e(t)}.${n}`;
+	if (i.size === 1) for (let e of i) return `${e}.${n}`;
+	let a, o = 0;
+	for (let e of i) e.includes("#") || (a = e, o++);
+	if (o === 1) return `${a}.${n}`;
+	throw Error(`[voltro] ${t} is installed more than once (${[...i].sort().join(", ")}) and no single install is the primary one, so a plugin hook cannot tell which of them it addresses. Call the route by its full tag instead — e.g. useSubscription(api, '${[...i].sort()[0]}.${n}').`);
+};
+//#endregion
+export { e as pluginAlias, t as pluginSlug, o as pluginTag, i as registerPluginAliases, a as resetPluginAliases };