@contractspec/lib.bus 1.56.1 → 1.58.0

package/dist/auditableBus.d.ts

@@ -1,117 +1,112 @@
-import { EventBus } from "./eventBus.js";
-import { EventMetadata } from "./metadata.js";
-import { EventEnvelope, EventKey, EventSpec } from "@contractspec/lib.contracts";
-import { AnySchemaModel } from "@contractspec/lib.schema";
-
-//#region src/auditableBus.d.ts
-
+import { type EventEnvelope, type EventKey, type EventSpec } from '@contractspec/lib.contracts';
+import type { AnySchemaModel } from '@contractspec/lib.schema';
+import type { EventBus } from './eventBus';
+import type { EventMetadata } from './metadata';
 /**
  * Extended event envelope with metadata for auditing.
  */
-interface AuditableEventEnvelope<T = unknown> extends EventEnvelope<T> {
-  metadata?: EventMetadata;
+export interface AuditableEventEnvelope<T = unknown> extends EventEnvelope<T> {
+    metadata?: EventMetadata;
 }
 /**
  * Audit record for persisting event history.
  */
-interface AuditRecord {
-  id: string;
-  eventKey: string;
-  eventVersion: string;
-  payload: unknown;
-  metadata?: EventMetadata;
-  occurredAt: string;
-  traceId?: string;
-  recordedAt: Date;
+export interface AuditRecord {
+    id: string;
+    eventKey: string;
+    eventVersion: string;
+    payload: unknown;
+    metadata?: EventMetadata;
+    occurredAt: string;
+    traceId?: string;
+    recordedAt: Date;
 }
 /**
  * Audit storage adapter interface.
  */
-interface AuditStorage {
-  /** Store an audit record */
-  store(record: AuditRecord): Promise<void>;
-  /** Query audit records */
-  query?(options: AuditQueryOptions): Promise<AuditRecord[]>;
+export interface AuditStorage {
+    /** Store an audit record */
+    store(record: AuditRecord): Promise<void>;
+    /** Query audit records */
+    query?(options: AuditQueryOptions): Promise<AuditRecord[]>;
 }
 /**
  * Options for querying audit records.
  */
-interface AuditQueryOptions {
-  eventKey?: string;
-  actorId?: string;
-  targetId?: string;
-  orgId?: string;
-  traceId?: string;
-  from?: Date;
-  to?: Date;
-  limit?: number;
-  offset?: number;
+export interface AuditQueryOptions {
+    eventKey?: string;
+    actorId?: string;
+    targetId?: string;
+    orgId?: string;
+    traceId?: string;
+    from?: Date;
+    to?: Date;
+    limit?: number;
+    offset?: number;
 }
 /**
  * Options for creating an auditable event bus.
  */
-interface AuditableEventBusOptions {
-  /** Underlying event bus for publishing */
-  bus: EventBus;
-  /** Audit storage adapter */
-  storage?: AuditStorage;
-  /** Default metadata to include with all events */
-  defaultMetadata?: EventMetadata;
-  /** Filter function to decide which events to audit */
-  shouldAudit?: (eventKey: string, envelope: AuditableEventEnvelope) => boolean;
-  /** Transform function for audit records */
-  transformAuditRecord?: (record: AuditRecord) => AuditRecord;
+export interface AuditableEventBusOptions {
+    /** Underlying event bus for publishing */
+    bus: EventBus;
+    /** Audit storage adapter */
+    storage?: AuditStorage;
+    /** Default metadata to include with all events */
+    defaultMetadata?: EventMetadata;
+    /** Filter function to decide which events to audit */
+    shouldAudit?: (eventKey: string, envelope: AuditableEventEnvelope) => boolean;
+    /** Transform function for audit records */
+    transformAuditRecord?: (record: AuditRecord) => AuditRecord;
 }
 /**
  * AuditableEventBus wraps an EventBus to automatically record events for audit trail.
  */
-declare class AuditableEventBus implements EventBus {
-  private readonly bus;
-  private readonly storage?;
-  private readonly defaultMetadata;
-  private readonly shouldAudit;
-  private readonly transformAuditRecord?;
-  constructor(options: AuditableEventBusOptions);
-  /**
-   * Publish an event and optionally record it for audit.
-   */
-  publish(topic: EventKey, bytes: Uint8Array): Promise<void>;
-  /**
-   * Subscribe to events from the underlying bus.
-   */
-  subscribe(topic: EventKey | string, handler: (bytes: Uint8Array) => Promise<void>): Promise<() => Promise<void>>;
-  /**
-   * Query audit records (if storage supports it).
-   */
-  queryAudit(options: AuditQueryOptions): Promise<AuditRecord[]>;
+export declare class AuditableEventBus implements EventBus {
+    private readonly bus;
+    private readonly storage?;
+    private readonly defaultMetadata;
+    private readonly shouldAudit;
+    private readonly transformAuditRecord?;
+    constructor(options: AuditableEventBusOptions);
+    /**
+     * Publish an event and optionally record it for audit.
+     */
+    publish(topic: EventKey, bytes: Uint8Array): Promise<void>;
+    /**
+     * Subscribe to events from the underlying bus.
+     */
+    subscribe(topic: EventKey | string, handler: (bytes: Uint8Array) => Promise<void>): Promise<() => Promise<void>>;
+    /**
+     * Query audit records (if storage supports it).
+     */
+    queryAudit(options: AuditQueryOptions): Promise<AuditRecord[]>;
 }
 /**
  * Create an auditable publisher that includes metadata.
  */
-declare function makeAuditablePublisher<T extends AnySchemaModel>(bus: AuditableEventBus | EventBus, spec: EventSpec<T>, defaultMetadata?: EventMetadata): (payload: T, options?: {
-  traceId?: string;
-  metadata?: EventMetadata;
+export declare function makeAuditablePublisher<T extends AnySchemaModel>(bus: AuditableEventBus | EventBus, spec: EventSpec<T>, defaultMetadata?: EventMetadata): (payload: T, options?: {
+    traceId?: string;
+    metadata?: EventMetadata;
 }) => Promise<void>;
 /**
  * In-memory audit storage for development/testing.
  */
-declare class InMemoryAuditStorage implements AuditStorage {
-  private records;
-  store(record: AuditRecord): Promise<void>;
-  query(options: AuditQueryOptions): Promise<AuditRecord[]>;
-  /**
-   * Get all records (for testing).
-   */
-  getAll(): AuditRecord[];
-  /**
-   * Clear all records (for testing).
-   */
-  clear(): void;
+export declare class InMemoryAuditStorage implements AuditStorage {
+    private records;
+    store(record: AuditRecord): Promise<void>;
+    query(options: AuditQueryOptions): Promise<AuditRecord[]>;
+    /**
+     * Get all records (for testing).
+     */
+    getAll(): AuditRecord[];
+    /**
+     * Clear all records (for testing).
+     */
+    clear(): void;
 }
 /**
  * Create an auditable event bus with in-memory storage.
  */
-declare function createAuditableEventBus(bus: EventBus, options?: Omit<AuditableEventBusOptions, 'bus'>): AuditableEventBus;
-//#endregion
-export { AuditQueryOptions, AuditRecord, AuditStorage, AuditableEventBus, AuditableEventBusOptions, AuditableEventEnvelope, InMemoryAuditStorage, createAuditableEventBus, makeAuditablePublisher };
+export declare function createAuditableEventBus(bus: EventBus, options?: Omit<AuditableEventBusOptions, 'bus'>): AuditableEventBus;
 //# sourceMappingURL=auditableBus.d.ts.map

package/dist/auditableBus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auditableBus.d.ts","names":[],"sources":["../src/auditableBus.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAcA;AAA2E,UAA1D,sBAA0D,CAAA,IAAA,OAAA,CAAA,SAAd,aAAc,CAAA,CAAA,CAAA,CAAA;EAC9D,QAAA,CAAA,EAAA,aAAA;;;AAMb;AAcA;AAEgB,UAhBC,WAAA,CAgBD;EAAc,EAAA,EAAA,MAAA;EAEZ,QAAA,EAAA,MAAA;EAA4B,YAAA,EAAA,MAAA;EAAR,OAAA,EAAA,OAAA;EAAO,QAAA,CAAA,EAbhC,aAagC;EAM5B,UAAA,EAAA,MAAA;EAeA,OAAA,CAAA,EAAA,MAAA;EAEV,UAAA,EAjCO,IAiCP;;;;;AAQ2C,UAnCjC,YAAA,CAmCiC;EAAW;EAMhD,KAAA,CAAA,MAAA,EAvCG,WAuCe,CAAA,EAvCD,OAuCC,CAAA,IAAA,CAAA;EAUR;EAWA,KAAA,EAAA,OAAA,EA1DL,iBA0DK,CAAA,EA1De,OA0Df,CA1DuB,WA0DvB,EAAA,CAAA;;;;;AA0Ca,UA9FnB,iBAAA,CA8FmB;EACjB,QAAA,CAAA,EAAA,MAAA;EAAd,OAAA,CAAA,EAAA,MAAA;EAOuB,QAAA,CAAA,EAAA,MAAA;EAA4B,KAAA,CAAA,EAAA,MAAA;EAAR,OAAA,CAAA,EAAA,MAAA;EAvEN,IAAA,CAAA,EAzBjC,IAyBiC;EAAQ,EAAA,CAAA,EAxB3C,IAwB2C;EAkFlC,KAAA,CAAA,EAAA,MAAA;EAAiC,MAAA,CAAA,EAAA,MAAA;;;;;AAG7B,UArGH,wBAAA,CAqGG;EAGP;EACgC,GAAA,EAvGtC,QAuGsC;EAAe;EAAA,OAAA,CAAA,EArGhD,YAqGgD;EAwB/C;EAGS,eAAA,CAAA,EA9HF,aA8HE;EAAc;EAIb,WAAA,CAAA,EAAA,CAAA,QAAA,EAAA,MAAA,EAAA,QAAA,EAhIsB,sBAgItB,EAAA,GAAA,OAAA;EAA4B;EAAR,oBAAA,CAAA,EAAA,CAAA,MAAA,EA9HT,WA8HS,EAAA,GA9HO,WA8HP;;;;AAiE3C;AACO,cA1LM,iBAAA,YAA6B,QA0LnC,CAAA;EACU,iBAAA,GAAA;EAAL,iBAAA,OAAA;EACT,iBAAA,eAAA;EAAiB,iBAAA,WAAA;;uBAlLG;;;;iBAWA,iBAAiB,aAAa;;;;mBAyC1C,oCACU,eAAe,gBAC/B,cAAc;;;;sBAOS,oBAAoB,QAAQ;;;;;iBAWxC,iCAAiC,qBAC1C,oBAAoB,gBACnB,UAAU,sBACE,0BAGP;;aACgC;MAAe;;;;cAwB/C,oBAAA,YAAgC;;gBAGvB,cAAc;iBAIb,oBAAoB,QAAQ;;;;YAkDvC;;;;;;;;;iBAeI,uBAAA,MACT,oBACK,KAAK,mCACd"}
+{"version":3,"file":"auditableBus.d.ts","sourceRoot":"","sources":["../src/auditableBus.ts"],"names":[],"mappings":"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"}

package/dist/auditableBus.js

@@ -1,137 +1,154 @@
-import { decodeEvent, encodeEvent } from "./eventBus.js";
-import { eventKey } from "@contractspec/lib.contracts";
+// @bun
+// src/eventBus.ts
+import {
+  eventKey
+} from "@contractspec/lib.contracts";
+function encodeEvent(envelope) {
+  return new TextEncoder().encode(JSON.stringify(envelope));
+}
+function decodeEvent(data) {
+  return JSON.parse(new TextDecoder().decode(data));
+}
+function makePublisher(bus, spec) {
+  return async (payload, traceId) => {
+    const envelope = {
+      id: crypto.randomUUID(),
+      occurredAt: new Date().toISOString(),
+      key: spec.meta.key,
+      version: spec.meta.version,
+      payload,
+      traceId
+    };
+    await bus.publish(eventKey(spec.meta.key, spec.meta.version), encodeEvent(envelope));
+  };
+}
 
-//#region src/auditableBus.ts
-/**
-* AuditableEventBus wraps an EventBus to automatically record events for audit trail.
-*/
-var AuditableEventBus = class {
-	bus;
-	storage;
-	defaultMetadata;
-	shouldAudit;
-	transformAuditRecord;
-	constructor(options) {
-		this.bus = options.bus;
-		this.storage = options.storage;
-		this.defaultMetadata = options.defaultMetadata ?? {};
-		this.shouldAudit = options.shouldAudit ?? (() => true);
-		this.transformAuditRecord = options.transformAuditRecord;
-	}
-	/**
-	* Publish an event and optionally record it for audit.
-	*/
-	async publish(topic, bytes) {
-		await this.bus.publish(topic, bytes);
-		if (this.storage) try {
-			const envelope = decodeEvent(bytes);
-			if (this.shouldAudit(envelope.key, envelope)) {
-				let record = {
-					id: crypto.randomUUID(),
-					eventKey: envelope.key,
-					eventVersion: envelope.version,
-					payload: envelope.payload,
-					metadata: {
-						...this.defaultMetadata,
-						...envelope.metadata
-					},
-					occurredAt: envelope.occurredAt,
-					traceId: envelope.traceId,
-					recordedAt: /* @__PURE__ */ new Date()
-				};
-				if (this.transformAuditRecord) record = this.transformAuditRecord(record);
-				await this.storage.store(record);
-			}
-		} catch (error) {
-			console.error("Failed to record audit:", error);
-		}
-	}
-	/**
-	* Subscribe to events from the underlying bus.
-	*/
-	async subscribe(topic, handler) {
-		return this.bus.subscribe(topic, handler);
-	}
-	/**
-	* Query audit records (if storage supports it).
-	*/
-	async queryAudit(options) {
-		if (!this.storage?.query) throw new Error("Audit storage does not support querying");
-		return this.storage.query(options);
-	}
-};
-/**
-* Create an auditable publisher that includes metadata.
-*/
+// src/auditableBus.ts
+import {
+  eventKey as eventKey2
+} from "@contractspec/lib.contracts";
+class AuditableEventBus {
+  bus;
+  storage;
+  defaultMetadata;
+  shouldAudit;
+  transformAuditRecord;
+  constructor(options) {
+    this.bus = options.bus;
+    this.storage = options.storage;
+    this.defaultMetadata = options.defaultMetadata ?? {};
+    this.shouldAudit = options.shouldAudit ?? (() => true);
+    this.transformAuditRecord = options.transformAuditRecord;
+  }
+  async publish(topic, bytes) {
+    await this.bus.publish(topic, bytes);
+    if (this.storage) {
+      try {
+        const envelope = decodeEvent(bytes);
+        if (this.shouldAudit(envelope.key, envelope)) {
+          let record = {
+            id: crypto.randomUUID(),
+            eventKey: envelope.key,
+            eventVersion: envelope.version,
+            payload: envelope.payload,
+            metadata: {
+              ...this.defaultMetadata,
+              ...envelope.metadata
+            },
+            occurredAt: envelope.occurredAt,
+            traceId: envelope.traceId,
+            recordedAt: new Date
+          };
+          if (this.transformAuditRecord) {
+            record = this.transformAuditRecord(record);
+          }
+          await this.storage.store(record);
+        }
+      } catch (error) {
+        console.error("Failed to record audit:", error);
+      }
+    }
+  }
+  async subscribe(topic, handler) {
+    return this.bus.subscribe(topic, handler);
+  }
+  async queryAudit(options) {
+    if (!this.storage?.query) {
+      throw new Error("Audit storage does not support querying");
+    }
+    return this.storage.query(options);
+  }
+}
 function makeAuditablePublisher(bus, spec, defaultMetadata) {
-	return async (payload, options) => {
-		const envelope = {
-			id: crypto.randomUUID(),
-			occurredAt: (/* @__PURE__ */ new Date()).toISOString(),
-			key: spec.meta.key,
-			version: spec.meta.version,
-			payload,
-			traceId: options?.traceId,
-			metadata: {
-				...defaultMetadata,
-				...options?.metadata
-			}
-		};
-		await bus.publish(eventKey(spec.meta.key, spec.meta.version), encodeEvent(envelope));
-	};
+  return async (payload, options) => {
+    const envelope = {
+      id: crypto.randomUUID(),
+      occurredAt: new Date().toISOString(),
+      key: spec.meta.key,
+      version: spec.meta.version,
+      payload,
+      traceId: options?.traceId,
+      metadata: {
+        ...defaultMetadata,
+        ...options?.metadata
+      }
+    };
+    await bus.publish(eventKey2(spec.meta.key, spec.meta.version), encodeEvent(envelope));
+  };
+}
+
+class InMemoryAuditStorage {
+  records = [];
+  async store(record) {
+    this.records.push(record);
+  }
+  async query(options) {
+    let results = [...this.records];
+    if (options.eventKey) {
+      results = results.filter((r) => r.eventKey === options.eventKey);
+    }
+    if (options.actorId) {
+      results = results.filter((r) => r.metadata?.actorId === options.actorId);
+    }
+    if (options.targetId) {
+      results = results.filter((r) => r.metadata?.targetId === options.targetId);
+    }
+    if (options.orgId) {
+      results = results.filter((r) => r.metadata?.orgId === options.orgId);
+    }
+    if (options.traceId) {
+      results = results.filter((r) => r.traceId === options.traceId);
+    }
+    if (options.from) {
+      const from = options.from;
+      results = results.filter((r) => new Date(r.occurredAt) >= from);
+    }
+    if (options.to) {
+      const to = options.to;
+      results = results.filter((r) => new Date(r.occurredAt) <= to);
+    }
+    results.sort((a, b) => new Date(b.occurredAt).getTime() - new Date(a.occurredAt).getTime());
+    const offset = options.offset ?? 0;
+    const limit = options.limit ?? 100;
+    return results.slice(offset, offset + limit);
+  }
+  getAll() {
+    return [...this.records];
+  }
+  clear() {
+    this.records = [];
+  }
 }
-/**
-* In-memory audit storage for development/testing.
-*/
-var InMemoryAuditStorage = class {
-	records = [];
-	async store(record) {
-		this.records.push(record);
-	}
-	async query(options) {
-		let results = [...this.records];
-		if (options.eventKey) results = results.filter((r) => r.eventKey === options.eventKey);
-		if (options.actorId) results = results.filter((r) => r.metadata?.actorId === options.actorId);
-		if (options.targetId) results = results.filter((r) => r.metadata?.targetId === options.targetId);
-		if (options.orgId) results = results.filter((r) => r.metadata?.orgId === options.orgId);
-		if (options.traceId) results = results.filter((r) => r.traceId === options.traceId);
-		if (options.from) {
-			const from = options.from;
-			results = results.filter((r) => new Date(r.occurredAt) >= from);
-		}
-		if (options.to) {
-			const to = options.to;
-			results = results.filter((r) => new Date(r.occurredAt) <= to);
-		}
-		results.sort((a, b) => new Date(b.occurredAt).getTime() - new Date(a.occurredAt).getTime());
-		const offset = options.offset ?? 0;
-		const limit = options.limit ?? 100;
-		return results.slice(offset, offset + limit);
-	}
-	/**
-	* Get all records (for testing).
-	*/
-	getAll() {
-		return [...this.records];
-	}
-	/**
-	* Clear all records (for testing).
-	*/
-	clear() {
-		this.records = [];
-	}
-};
-/**
-* Create an auditable event bus with in-memory storage.
-*/
 function createAuditableEventBus(bus, options) {
-	return new AuditableEventBus({
-		bus,
-		storage: options?.storage ?? new InMemoryAuditStorage(),
-		...options
-	});
+  return new AuditableEventBus({
+    bus,
+    storage: options?.storage ?? new InMemoryAuditStorage,
+    ...options
+  });
 }
-
-//#endregion
-export { AuditableEventBus, InMemoryAuditStorage, createAuditableEventBus, makeAuditablePublisher };
-//# sourceMappingURL=auditableBus.js.map
+export {
+  makeAuditablePublisher,
+  createAuditableEventBus,
+  InMemoryAuditStorage,
+  AuditableEventBus
+};

package/dist/browser/auditableBus.js

@@ -0,0 +1,153 @@
+// src/eventBus.ts
+import {
+  eventKey
+} from "@contractspec/lib.contracts";
+function encodeEvent(envelope) {
+  return new TextEncoder().encode(JSON.stringify(envelope));
+}
+function decodeEvent(data) {
+  return JSON.parse(new TextDecoder().decode(data));
+}
+function makePublisher(bus, spec) {
+  return async (payload, traceId) => {
+    const envelope = {
+      id: crypto.randomUUID(),
+      occurredAt: new Date().toISOString(),
+      key: spec.meta.key,
+      version: spec.meta.version,
+      payload,
+      traceId
+    };
+    await bus.publish(eventKey(spec.meta.key, spec.meta.version), encodeEvent(envelope));
+  };
+}
+
+// src/auditableBus.ts
+import {
+  eventKey as eventKey2
+} from "@contractspec/lib.contracts";
+class AuditableEventBus {
+  bus;
+  storage;
+  defaultMetadata;
+  shouldAudit;
+  transformAuditRecord;
+  constructor(options) {
+    this.bus = options.bus;
+    this.storage = options.storage;
+    this.defaultMetadata = options.defaultMetadata ?? {};
+    this.shouldAudit = options.shouldAudit ?? (() => true);
+    this.transformAuditRecord = options.transformAuditRecord;
+  }
+  async publish(topic, bytes) {
+    await this.bus.publish(topic, bytes);
+    if (this.storage) {
+      try {
+        const envelope = decodeEvent(bytes);
+        if (this.shouldAudit(envelope.key, envelope)) {
+          let record = {
+            id: crypto.randomUUID(),
+            eventKey: envelope.key,
+            eventVersion: envelope.version,
+            payload: envelope.payload,
+            metadata: {
+              ...this.defaultMetadata,
+              ...envelope.metadata
+            },
+            occurredAt: envelope.occurredAt,
+            traceId: envelope.traceId,
+            recordedAt: new Date
+          };
+          if (this.transformAuditRecord) {
+            record = this.transformAuditRecord(record);
+          }
+          await this.storage.store(record);
+        }
+      } catch (error) {
+        console.error("Failed to record audit:", error);
+      }
+    }
+  }
+  async subscribe(topic, handler) {
+    return this.bus.subscribe(topic, handler);
+  }
+  async queryAudit(options) {
+    if (!this.storage?.query) {
+      throw new Error("Audit storage does not support querying");
+    }
+    return this.storage.query(options);
+  }
+}
+function makeAuditablePublisher(bus, spec, defaultMetadata) {
+  return async (payload, options) => {
+    const envelope = {
+      id: crypto.randomUUID(),
+      occurredAt: new Date().toISOString(),
+      key: spec.meta.key,
+      version: spec.meta.version,
+      payload,
+      traceId: options?.traceId,
+      metadata: {
+        ...defaultMetadata,
+        ...options?.metadata
+      }
+    };
+    await bus.publish(eventKey2(spec.meta.key, spec.meta.version), encodeEvent(envelope));
+  };
+}
+
+class InMemoryAuditStorage {
+  records = [];
+  async store(record) {
+    this.records.push(record);
+  }
+  async query(options) {
+    let results = [...this.records];
+    if (options.eventKey) {
+      results = results.filter((r) => r.eventKey === options.eventKey);
+    }
+    if (options.actorId) {
+      results = results.filter((r) => r.metadata?.actorId === options.actorId);
+    }
+    if (options.targetId) {
+      results = results.filter((r) => r.metadata?.targetId === options.targetId);
+    }
+    if (options.orgId) {
+      results = results.filter((r) => r.metadata?.orgId === options.orgId);
+    }
+    if (options.traceId) {
+      results = results.filter((r) => r.traceId === options.traceId);
+    }
+    if (options.from) {
+      const from = options.from;
+      results = results.filter((r) => new Date(r.occurredAt) >= from);
+    }
+    if (options.to) {
+      const to = options.to;
+      results = results.filter((r) => new Date(r.occurredAt) <= to);
+    }
+    results.sort((a, b) => new Date(b.occurredAt).getTime() - new Date(a.occurredAt).getTime());
+    const offset = options.offset ?? 0;
+    const limit = options.limit ?? 100;
+    return results.slice(offset, offset + limit);
+  }
+  getAll() {
+    return [...this.records];
+  }
+  clear() {
+    this.records = [];
+  }
+}
+function createAuditableEventBus(bus, options) {
+  return new AuditableEventBus({
+    bus,
+    storage: options?.storage ?? new InMemoryAuditStorage,
+    ...options
+  });
+}
+export {
+  makeAuditablePublisher,
+  createAuditableEventBus,
+  InMemoryAuditStorage,
+  AuditableEventBus
+};