@lssm/lib.bus 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217073102

package/dist/contracts/dist/server/mcp/registerResources.js

@@ -1 +1,2 @@
-import"@modelcontextprotocol/sdk/server/mcp.js";import"node:buffer";
+import "@modelcontextprotocol/sdk/server/mcp.js";
+import "node:buffer";

package/dist/contracts/dist/server/mcp/registerTools.js

@@ -1 +1 @@
-import"../../jsonschema.js";
+import "../../jsonschema.js";

package/dist/contracts/dist/server/provider-mcp.js

@@ -1 +1 @@
-import"./mcp/createMcpServer.js";
+import "./mcp/createMcpServer.js";

package/dist/contracts/dist/server/rest-elysia.js

@@ -1 +1 @@
-import"./rest-generic.js";
+import "./rest-generic.js";

package/dist/contracts/dist/server/rest-express.js

@@ -1 +1 @@
-import"./rest-generic.js";
+import "./rest-generic.js";

package/dist/contracts/dist/server/rest-generic.js

@@ -1 +1 @@
-import"../jsonschema.js";
+import "../jsonschema.js";

package/dist/contracts/dist/server/rest-next-app.js

@@ -1 +1 @@
-import"./rest-generic.js";
+import "./rest-generic.js";

package/dist/contracts/dist/server/rest-next-pages.js

@@ -1 +1 @@
-import"./rest-generic.js";
+import "./rest-generic.js";

package/dist/contracts/dist/spec.js

@@ -1 +1,34 @@
-const e=e=>({...e,meta:{...e.meta,kind:`command`},policy:{...e.policy,idempotent:e.policy?.policy?.idempotent??!1}}),t=e=>({...e,meta:{...e.meta,kind:`query`},policy:{...e.policy,idempotent:!0}});export{t as n,e as t};
+//#region ../contracts/dist/spec.js
+/**
+* Helper to define a Command (write operation).
+* Sets `kind: 'command'` and defaults `idempotent: false`.
+*/
+const defineCommand = (spec) => ({
+	...spec,
+	meta: {
+		...spec.meta,
+		kind: "command"
+	},
+	policy: {
+		...spec.policy,
+		idempotent: spec.policy?.["policy"]?.idempotent ?? false
+	}
+});
+/**
+* Helper to define a Query (read-only operation).
+* Sets `kind: 'query'` and forces `idempotent: true`.
+*/
+const defineQuery = (spec) => ({
+	...spec,
+	meta: {
+		...spec.meta,
+		kind: "query"
+	},
+	policy: {
+		...spec.policy,
+		idempotent: true
+	}
+});
+
+//#endregion
+export { defineCommand, defineQuery };

package/dist/contracts/dist/telemetry/index.js

@@ -1 +1 @@
-import"./tracker.js";
+import "./tracker.js";

package/dist/contracts/dist/telemetry/tracker.js

@@ -1 +1 @@
-import"crypto";
+import "crypto";

package/dist/contracts/dist/tests/index.js

@@ -1 +1 @@
-import"./runner.js";
+import "./runner.js";

package/dist/contracts/dist/tests/runner.js

@@ -1 +1,2 @@
-import"../index.js";import"node:assert";
+import "../index.js";
+import "node:assert";

package/dist/contracts/dist/workflow/index.js

@@ -1 +1 @@
-import"./runner.js";
+import "./runner.js";

package/dist/contracts/dist/workflow/runner.js

@@ -1 +1 @@
-import"node:crypto";
+import "node:crypto";

package/dist/eventBus.js

@@ -1 +1,32 @@
-import{t as e}from"./contracts/dist/events.js";import"./contracts/dist/index.js";function t(e){return new TextEncoder().encode(JSON.stringify(e))}function n(e){return JSON.parse(new TextDecoder().decode(e))}function r(n,r){return async(i,a)=>{let o={id:crypto.randomUUID(),occurredAt:new Date().toISOString(),name:r.name,version:r.version,payload:i,traceId:a};await n.publish(e(r.name,r.version),t(o))}}export{n as decodeEvent,t as encodeEvent,r as makePublisher};
+import { eventKey } from "./contracts/dist/events.js";
+import "./contracts/dist/index.js";
+
+//#region src/eventBus.ts
+/** Helper to encode a typed event envelope into JSON string */
+function encodeEvent(envelope) {
+	return new TextEncoder().encode(JSON.stringify(envelope));
+}
+/** Helper to decode JSON string into a typed event envelope */
+function decodeEvent(data) {
+	return JSON.parse(new TextDecoder().decode(data));
+}
+/**
+* Create a typed publisher function for a given event spec.
+* It ensures payload conformance at compile time and builds the correct topic.
+*/
+function makePublisher(bus, spec) {
+	return async (payload, traceId) => {
+		const envelope = {
+			id: crypto.randomUUID(),
+			occurredAt: (/* @__PURE__ */ new Date()).toISOString(),
+			name: spec.name,
+			version: spec.version,
+			payload,
+			traceId
+		};
+		await bus.publish(eventKey(spec.name, spec.version), encodeEvent(envelope));
+	};
+}
+
+//#endregion
+export { decodeEvent, encodeEvent, makePublisher };

package/dist/filtering.js

@@ -1 +1,130 @@
-import{decodeEvent as e}from"./eventBus.js";function t(e,t){if(t.eventName){let n=t.eventName.replace(/\*/g,`.*`);if(!RegExp(`^${n}$`).test(e.name))return!1}if(t.domain&&!e.name.startsWith(t.domain+`.`)||t.version!==void 0&&e.version!==t.version||t.actorId&&e.metadata?.actorId!==t.actorId||t.orgId&&e.metadata?.orgId!==t.orgId)return!1;if(t.tags){let n=e.metadata?.tags??{};for(let[e,r]of Object.entries(t.tags))if(n[e]!==r)return!1}return!(t.predicate&&!t.predicate(e))}function n(n,r,i){return async a=>n.subscribe(a,async n=>{let a=e(n);t(a,r)&&await i(a)})}var r=class{constructor(e,t){this.bus=e,this.domain=t}async publish(e,t,n){let r=e.name.startsWith(this.domain+`.`)?e.name:`${this.domain}.${e.name}`,i={id:crypto.randomUUID(),occurredAt:new Date().toISOString(),name:r,version:e.version,payload:t,metadata:n},a=new TextEncoder().encode(JSON.stringify(i));await this.bus.publish(`${r}.v${e.version}`,a)}async subscribeAll(t){return this.bus.subscribe(`${this.domain}.*`,async n=>{await t(e(n))})}async subscribeFiltered(n,r){let i={...n,domain:this.domain};return this.bus.subscribe(`${this.domain}.*`,async n=>{let a=e(n);t(a,i)&&await r(a)})}};function i(e,t){return new r(e,t)}var a=class{routes=[];route(e,t){return this.routes.push({filter:e,handler:t}),this}async dispatch(e){let n=this.routes.filter(n=>t(e,n.filter));await Promise.all(n.map(t=>t.handler(e)))}createSubscriber(t){return async n=>t.subscribe(n,async t=>{let n=e(t);await this.dispatch(n)})}};function o(){return new a}export{r as DomainEventBus,a as EventRouter,i as createDomainBus,o as createEventRouter,n as createFilteredSubscriber,t as matchesFilter};
+import { decodeEvent } from "./eventBus.js";
+
+//#region src/filtering.ts
+/**
+* Check if an event matches a filter.
+*/
+function matchesFilter(envelope, filter) {
+	if (filter.eventName) {
+		const pattern = filter.eventName.replace(/\*/g, ".*");
+		if (!(/* @__PURE__ */ new RegExp(`^${pattern}$`)).test(envelope.name)) return false;
+	}
+	if (filter.domain) {
+		if (!envelope.name.startsWith(filter.domain + ".")) return false;
+	}
+	if (filter.version !== void 0 && envelope.version !== filter.version) return false;
+	if (filter.actorId && envelope.metadata?.actorId !== filter.actorId) return false;
+	if (filter.orgId && envelope.metadata?.orgId !== filter.orgId) return false;
+	if (filter.tags) {
+		const eventTags = envelope.metadata?.tags ?? {};
+		for (const [key, value] of Object.entries(filter.tags)) if (eventTags[key] !== value) return false;
+	}
+	if (filter.predicate && !filter.predicate(envelope)) return false;
+	return true;
+}
+/**
+* Create a filtered subscriber that only receives matching events.
+*/
+function createFilteredSubscriber(bus, filter, handler) {
+	return async (topic) => {
+		return bus.subscribe(topic, async (bytes) => {
+			const envelope = decodeEvent(bytes);
+			if (matchesFilter(envelope, filter)) await handler(envelope);
+		});
+	};
+}
+/**
+* Domain-specific event bus that filters by domain prefix.
+*/
+var DomainEventBus = class {
+	constructor(bus, domain) {
+		this.bus = bus;
+		this.domain = domain;
+	}
+	/**
+	* Publish a domain event.
+	*/
+	async publish(spec, payload, metadata) {
+		const eventName = spec.name.startsWith(this.domain + ".") ? spec.name : `${this.domain}.${spec.name}`;
+		const envelope = {
+			id: crypto.randomUUID(),
+			occurredAt: (/* @__PURE__ */ new Date()).toISOString(),
+			name: eventName,
+			version: spec.version,
+			payload,
+			metadata
+		};
+		const bytes = new TextEncoder().encode(JSON.stringify(envelope));
+		await this.bus.publish(`${eventName}.v${spec.version}`, bytes);
+	}
+	/**
+	* Subscribe to all domain events.
+	*/
+	async subscribeAll(handler) {
+		return this.bus.subscribe(`${this.domain}.*`, async (bytes) => {
+			await handler(decodeEvent(bytes));
+		});
+	}
+	/**
+	* Subscribe with filter.
+	*/
+	async subscribeFiltered(filter, handler) {
+		const fullFilter = {
+			...filter,
+			domain: this.domain
+		};
+		return this.bus.subscribe(`${this.domain}.*`, async (bytes) => {
+			const envelope = decodeEvent(bytes);
+			if (matchesFilter(envelope, fullFilter)) await handler(envelope);
+		});
+	}
+};
+/**
+* Create a domain-scoped event bus.
+*/
+function createDomainBus(bus, domain) {
+	return new DomainEventBus(bus, domain);
+}
+/**
+* Event router that routes events to different handlers based on filters.
+*/
+var EventRouter = class {
+	routes = [];
+	/**
+	* Add a route.
+	*/
+	route(filter, handler) {
+		this.routes.push({
+			filter,
+			handler
+		});
+		return this;
+	}
+	/**
+	* Route an event to matching handlers.
+	*/
+	async dispatch(envelope) {
+		const matchingRoutes = this.routes.filter((r) => matchesFilter(envelope, r.filter));
+		await Promise.all(matchingRoutes.map((r) => r.handler(envelope)));
+	}
+	/**
+	* Create a subscriber that routes events.
+	*/
+	createSubscriber(bus) {
+		return async (topic) => {
+			return bus.subscribe(topic, async (bytes) => {
+				const envelope = decodeEvent(bytes);
+				await this.dispatch(envelope);
+			});
+		};
+	}
+};
+/**
+* Create an event router.
+*/
+function createEventRouter() {
+	return new EventRouter();
+}
+
+//#endregion
+export { DomainEventBus, EventRouter, createDomainBus, createEventRouter, createFilteredSubscriber, matchesFilter };

package/dist/inMemoryBus.js

@@ -1 +1,28 @@
-var e=class{listeners=new Map;async publish(e,t){let n=this.listeners.get(e);n&&await Promise.all([...n].map(e=>e(t)))}async subscribe(e,t){let n=String(e),r=this.listeners.get(n);return r||(r=new Set,this.listeners.set(n,r)),r.add(t),async()=>{r?.delete(t)}}};export{e as InMemoryBus};
+//#region src/inMemoryBus.ts
+/**
+* In-memory bus for dev/test. Not for production scale.
+* Subscribers receive events synchronously in the order they were published.
+*/
+var InMemoryBus = class {
+	listeners = /* @__PURE__ */ new Map();
+	async publish(topic, payload) {
+		const handlers = this.listeners.get(topic);
+		if (!handlers) return;
+		await Promise.all([...handlers].map((h) => h(payload)));
+	}
+	async subscribe(topic, handler) {
+		const topicStr = String(topic);
+		let set = this.listeners.get(topicStr);
+		if (!set) {
+			set = /* @__PURE__ */ new Set();
+			this.listeners.set(topicStr, set);
+		}
+		set.add(handler);
+		return async () => {
+			set?.delete(handler);
+		};
+	}
+};
+
+//#endregion
+export { InMemoryBus };

package/dist/index.js

@@ -1 +1,8 @@
-import{decodeEvent as e,encodeEvent as t,makePublisher as n}from"./eventBus.js";import{AuditableEventBus as r,InMemoryAuditStorage as i,createAuditableEventBus as a,makeAuditablePublisher as o}from"./auditableBus.js";import{DomainEventBus as s,EventRouter as c,createDomainBus as l,createEventRouter as u,createFilteredSubscriber as d,matchesFilter as f}from"./filtering.js";import{InMemoryBus as p}from"./inMemoryBus.js";import{subscribeEvent as m}from"./subscriber.js";import{MetadataContext as h,createMetadataContext as g,createMetadataFromContext as _,mergeMetadata as v}from"./metadata.js";export{r as AuditableEventBus,s as DomainEventBus,c as EventRouter,i as InMemoryAuditStorage,p as InMemoryBus,h as MetadataContext,a as createAuditableEventBus,l as createDomainBus,u as createEventRouter,d as createFilteredSubscriber,g as createMetadataContext,_ as createMetadataFromContext,e as decodeEvent,t as encodeEvent,o as makeAuditablePublisher,n as makePublisher,f as matchesFilter,v as mergeMetadata,m as subscribeEvent};
+import { decodeEvent, encodeEvent, makePublisher } from "./eventBus.js";
+import { AuditableEventBus, InMemoryAuditStorage, createAuditableEventBus, makeAuditablePublisher } from "./auditableBus.js";
+import { DomainEventBus, EventRouter, createDomainBus, createEventRouter, createFilteredSubscriber, matchesFilter } from "./filtering.js";
+import { InMemoryBus } from "./inMemoryBus.js";
+import { subscribeEvent } from "./subscriber.js";
+import { MetadataContext, createMetadataContext, createMetadataFromContext, mergeMetadata } from "./metadata.js";
+
+export { AuditableEventBus, DomainEventBus, EventRouter, InMemoryAuditStorage, InMemoryBus, MetadataContext, createAuditableEventBus, createDomainBus, createEventRouter, createFilteredSubscriber, createMetadataContext, createMetadataFromContext, decodeEvent, encodeEvent, makeAuditablePublisher, makePublisher, matchesFilter, mergeMetadata, subscribeEvent };

package/dist/metadata.js

@@ -1 +1,81 @@
-function e(e){return{actorId:e.userId,actorType:e.userId?`user`:`system`,orgId:e.orgId,tenantId:e.orgId,sessionId:e.sessionId,requestId:e.requestId,traceId:e.traceId||crypto.randomUUID(),clientIp:e.clientIp,userAgent:e.userAgent}}function t(e,t){return{...e,...t,tags:{...e.tags,...t.tags}}}var n=class e{metadata;constructor(e={}){this.metadata={...e},this.metadata.traceId||(this.metadata.traceId=crypto.randomUUID())}get(){return{...this.metadata}}set(e,t){return this.metadata[e]=t,this}tag(e,t){return this.metadata.tags={...this.metadata.tags,[e]:t},this}child(n={}){return new e(t(this.metadata,{...n,spanId:crypto.randomUUID()}))}};function r(e){return new n(e)}export{n as MetadataContext,r as createMetadataContext,e as createMetadataFromContext,t as mergeMetadata};
+//#region src/metadata.ts
+/**
+* Create metadata from request context.
+*/
+function createMetadataFromContext(context) {
+	return {
+		actorId: context.userId,
+		actorType: context.userId ? "user" : "system",
+		orgId: context.orgId,
+		tenantId: context.orgId,
+		sessionId: context.sessionId,
+		requestId: context.requestId,
+		traceId: context.traceId || crypto.randomUUID(),
+		clientIp: context.clientIp,
+		userAgent: context.userAgent
+	};
+}
+/**
+* Merge metadata with overrides.
+*/
+function mergeMetadata(base, overrides) {
+	return {
+		...base,
+		...overrides,
+		tags: {
+			...base.tags,
+			...overrides.tags
+		}
+	};
+}
+/**
+* Create a metadata context that can be passed through operations.
+*/
+var MetadataContext = class MetadataContext {
+	metadata;
+	constructor(initial = {}) {
+		this.metadata = { ...initial };
+		if (!this.metadata.traceId) this.metadata.traceId = crypto.randomUUID();
+	}
+	/**
+	* Get the current metadata.
+	*/
+	get() {
+		return { ...this.metadata };
+	}
+	/**
+	* Set a metadata value.
+	*/
+	set(key, value) {
+		this.metadata[key] = value;
+		return this;
+	}
+	/**
+	* Add a tag.
+	*/
+	tag(key, value) {
+		this.metadata.tags = {
+			...this.metadata.tags,
+			[key]: value
+		};
+		return this;
+	}
+	/**
+	* Create a child context with the same trace.
+	*/
+	child(overrides = {}) {
+		return new MetadataContext(mergeMetadata(this.metadata, {
+			...overrides,
+			spanId: crypto.randomUUID()
+		}));
+	}
+};
+/**
+* Create a new metadata context.
+*/
+function createMetadataContext(initial) {
+	return new MetadataContext(initial);
+}
+
+//#endregion
+export { MetadataContext, createMetadataContext, createMetadataFromContext, mergeMetadata };

package/dist/subscriber.js

@@ -1 +1,18 @@
-import{decodeEvent as e}from"./eventBus.js";async function t(t,n,r){let i=`${n.name}.v${n.version}`;return t.subscribe(i,async t=>{let i=e(t);i.name!==n.name||i.version!==n.version||await r(i.payload,{traceId:i.traceId,deliveryId:i.id})})}export{t as subscribeEvent};
+import { decodeEvent } from "./eventBus.js";
+
+//#region src/subscriber.ts
+/** Typed subscription using your EventSpec */
+async function subscribeEvent(bus, spec, handler) {
+	const topic = `${spec.name}.v${spec.version}`;
+	return bus.subscribe(topic, async (u8) => {
+		const env = decodeEvent(u8);
+		if (env.name !== spec.name || env.version !== spec.version) return;
+		await handler(env.payload, {
+			traceId: env.traceId,
+			deliveryId: env.id
+		});
+	});
+}
+
+//#endregion
+export { subscribeEvent };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/lib.bus",
-  "version": "0.0.0-canary-20251217063201",
+  "version": "0.0.0-canary-20251217073102",
   "scripts": {
     "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
     "publish:pkg:canary": "bun publish:pkg --tag canary",
@@ -14,15 +14,15 @@
     "lint:check": "eslint src"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "0.0.0-canary-20251217063201",
-    "@lssm/tool.typescript": "0.0.0-canary-20251217063201",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251217073102",
+    "@lssm/tool.typescript": "0.0.0-canary-20251217073102",
     "@types/express": "^5.0.3",
     "tsdown": "^0.17.4",
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@lssm/lib.schema": "0.0.0-canary-20251217063201",
-    "@lssm/lib.contracts": "0.0.0-canary-20251217063201"
+    "@lssm/lib.schema": "0.0.0-canary-20251217073102",
+    "@lssm/lib.contracts": "0.0.0-canary-20251217073102"
   },
   "peerDependencies": {
     "elysia": "^1.4.19",