@godman-protocols/signal 0.2.0 → 0.3.0

package/dist/bus.d.ts

@@ -1,53 +0,0 @@
-/**
- * SIGNAL — Event Bus and Pub/Sub for Agent Swarms
- * In-memory EventBus implementation
- * @version 0.2.0
- */
-import type { AgentId, DeliveryReceipt, Event, Subscription, SubscriptionId, Timestamp } from './types.js';
-/**
- * Match a topic against a glob-style filter.
- * - `*` matches exactly one segment
- * - `**` matches zero or more segments
- * - Exact strings match literally
- */
-export declare function topicMatches(filter: string, topic: string): boolean;
-/**
- * Create a signed event.
- */
-export declare function createEvent(publisher: AgentId, topic: string, payload: unknown, secret: string, options?: {
-    id?: string;
-    idempotencyKey?: string;
-    publishedAt?: Timestamp;
-}): Event;
-type EventHandler = (event: Event) => void | Promise<void>;
-export declare class EventBus {
-    private subs;
-    private seenIdempotencyKeys;
-    private receipts;
-    /**
-     * Subscribe to events matching a topic filter.
-     */
-    subscribe(subscriberAgent: AgentId, topicFilter: string, handler: EventHandler, deliveryMode?: 'at-least-once' | 'at-most-once'): Subscription;
-    /**
-     * Unsubscribe. Marks the subscription as cancelled.
-     */
-    unsubscribe(subscriptionId: SubscriptionId): void;
-    /**
-     * Publish an event to all matching subscribers.
-     * Deduplicates by idempotencyKey.
-     * Returns delivery receipts.
-     */
-    publish(event: Event): Promise<DeliveryReceipt[]>;
-    /**
-     * Get all delivery receipts.
-     */
-    getReceipts(): ReadonlyArray<DeliveryReceipt>;
-    /**
-     * Get active subscription count.
-     */
-    get subscriptionCount(): number;
-}
-/** Default singleton bus for single-process use */
-export declare const defaultBus: EventBus;
-export {};
-//# sourceMappingURL=bus.d.ts.map

package/dist/bus.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../src/bus.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,OAAO,EACP,eAAe,EACf,KAAK,EACL,YAAY,EACZ,cAAc,EACd,SAAS,EACV,MAAM,YAAY,CAAC;AAMpB;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAInE;AAuBD;;GAEG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,OAAO,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,SAAS,CAAA;CAAO,GAC9E,KAAK,CAOP;AAMD,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAO3D,qBAAa,QAAQ;IACnB,OAAO,CAAC,IAAI,CAA0C;IACtD,OAAO,CAAC,mBAAmB,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAyB;IAEzC;;OAEG;IACH,SAAS,CACP,eAAe,EAAE,OAAO,EACxB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,YAAY,EACrB,YAAY,GAAE,eAAe,GAAG,cAAgC,GAC/D,YAAY;IAaf;;OAEG;IACH,WAAW,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI;IAOjD;;;;OAIG;IACG,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAwCvD;;OAEG;IACH,WAAW,IAAI,aAAa,CAAC,eAAe,CAAC;IAI7C;;OAEG;IACH,IAAI,iBAAiB,IAAI,MAAM,CAE9B;CACF;AAED,mDAAmD;AACnD,eAAO,MAAM,UAAU,UAAiB,CAAC"}

package/dist/bus.js

@@ -1,141 +0,0 @@
-/**
- * SIGNAL — Event Bus and Pub/Sub for Agent Swarms
- * In-memory EventBus implementation
- * @version 0.2.0
- */
-import { createHmac, randomUUID } from 'node:crypto';
-// ---------------------------------------------------------------------------
-// Topic matching
-// ---------------------------------------------------------------------------
-/**
- * Match a topic against a glob-style filter.
- * - `*` matches exactly one segment
- * - `**` matches zero or more segments
- * - Exact strings match literally
- */
-export function topicMatches(filter, topic) {
-    const filterParts = filter.split('.');
-    const topicParts = topic.split('.');
-    return matchParts(filterParts, 0, topicParts, 0);
-}
-function matchParts(f, fi, t, ti) {
-    if (fi === f.length && ti === t.length)
-        return true;
-    if (fi === f.length)
-        return false;
-    if (f[fi] === '**') {
-        // ** can match zero or more segments
-        for (let i = ti; i <= t.length; i++) {
-            if (matchParts(f, fi + 1, t, i))
-                return true;
-        }
-        return false;
-    }
-    if (ti === t.length)
-        return false;
-    if (f[fi] === '*' || f[fi] === t[ti]) {
-        return matchParts(f, fi + 1, t, ti + 1);
-    }
-    return false;
-}
-// ---------------------------------------------------------------------------
-// Event creation
-// ---------------------------------------------------------------------------
-/**
- * Create a signed event.
- */
-export function createEvent(publisher, topic, payload, secret, options = {}) {
-    const id = options.id ?? randomUUID();
-    const publishedAt = options.publishedAt ?? new Date().toISOString();
-    const idempotencyKey = options.idempotencyKey ?? id;
-    const sigPayload = `${id}:${topic}:${publisher}:${publishedAt}`;
-    const signature = createHmac('sha256', secret).update(sigPayload, 'utf8').digest('hex');
-    return { id, topic, publisher, publishedAt, idempotencyKey, payload, signature };
-}
-export class EventBus {
-    subs = new Map();
-    seenIdempotencyKeys = new Set();
-    receipts = [];
-    /**
-     * Subscribe to events matching a topic filter.
-     */
-    subscribe(subscriberAgent, topicFilter, handler, deliveryMode = 'at-least-once') {
-        const sub = {
-            id: randomUUID(),
-            subscriberAgent,
-            topicFilter,
-            deliveryMode,
-            createdAt: new Date().toISOString(),
-            cancelledAt: null,
-        };
-        this.subs.set(sub.id, { subscription: sub, handler });
-        return sub;
-    }
-    /**
-     * Unsubscribe. Marks the subscription as cancelled.
-     */
-    unsubscribe(subscriptionId) {
-        const entry = this.subs.get(subscriptionId);
-        if (!entry)
-            throw new Error(`Subscription ${subscriptionId} not found`);
-        entry.subscription.cancelledAt = new Date().toISOString();
-        this.subs.delete(subscriptionId);
-    }
-    /**
-     * Publish an event to all matching subscribers.
-     * Deduplicates by idempotencyKey.
-     * Returns delivery receipts.
-     */
-    async publish(event) {
-        // Idempotency check
-        if (this.seenIdempotencyKeys.has(event.idempotencyKey)) {
-            const receipt = {
-                eventId: event.id,
-                subscriptionId: 'none',
-                receivedAt: new Date().toISOString(),
-                status: 'duplicate-skipped',
-            };
-            this.receipts.push(receipt);
-            return [receipt];
-        }
-        this.seenIdempotencyKeys.add(event.idempotencyKey);
-        const newReceipts = [];
-        for (const [, entry] of this.subs) {
-            if (entry.subscription.cancelledAt)
-                continue;
-            if (!topicMatches(entry.subscription.topicFilter, event.topic))
-                continue;
-            let status = 'processed';
-            try {
-                await entry.handler(event);
-            }
-            catch {
-                status = 'failed';
-            }
-            const receipt = {
-                eventId: event.id,
-                subscriptionId: entry.subscription.id,
-                receivedAt: new Date().toISOString(),
-                status,
-            };
-            newReceipts.push(receipt);
-        }
-        this.receipts.push(...newReceipts);
-        return newReceipts;
-    }
-    /**
-     * Get all delivery receipts.
-     */
-    getReceipts() {
-        return [...this.receipts];
-    }
-    /**
-     * Get active subscription count.
-     */
-    get subscriptionCount() {
-        return this.subs.size;
-    }
-}
-/** Default singleton bus for single-process use */
-export const defaultBus = new EventBus();
-//# sourceMappingURL=bus.js.map

package/dist/bus.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bus.js","sourceRoot":"","sources":["../src/bus.ts"],"names":[],"mappings":"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"}

package/src/bus.ts

@@ -1,180 +0,0 @@
-/**
- * SIGNAL — Event Bus and Pub/Sub for Agent Swarms
- * In-memory EventBus implementation
- * @version 0.2.0
- */
-
-import { createHmac, randomUUID } from 'node:crypto';
-import type {
-  AgentId,
-  DeliveryReceipt,
-  Event,
-  Subscription,
-  SubscriptionId,
-  Timestamp,
-} from './types.js';
-
-// ---------------------------------------------------------------------------
-// Topic matching
-// ---------------------------------------------------------------------------
-
-/**
- * Match a topic against a glob-style filter.
- * - `*` matches exactly one segment
- * - `**` matches zero or more segments
- * - Exact strings match literally
- */
-export function topicMatches(filter: string, topic: string): boolean {
-  const filterParts = filter.split('.');
-  const topicParts = topic.split('.');
-  return matchParts(filterParts, 0, topicParts, 0);
-}
-
-function matchParts(f: string[], fi: number, t: string[], ti: number): boolean {
-  if (fi === f.length && ti === t.length) return true;
-  if (fi === f.length) return false;
-  if (f[fi] === '**') {
-    // ** can match zero or more segments
-    for (let i = ti; i <= t.length; i++) {
-      if (matchParts(f, fi + 1, t, i)) return true;
-    }
-    return false;
-  }
-  if (ti === t.length) return false;
-  if (f[fi] === '*' || f[fi] === t[ti]) {
-    return matchParts(f, fi + 1, t, ti + 1);
-  }
-  return false;
-}
-
-// ---------------------------------------------------------------------------
-// Event creation
-// ---------------------------------------------------------------------------
-
-/**
- * Create a signed event.
- */
-export function createEvent(
-  publisher: AgentId,
-  topic: string,
-  payload: unknown,
-  secret: string,
-  options: { id?: string; idempotencyKey?: string; publishedAt?: Timestamp } = {}
-): Event {
-  const id = options.id ?? randomUUID();
-  const publishedAt = options.publishedAt ?? new Date().toISOString();
-  const idempotencyKey = options.idempotencyKey ?? id;
-  const sigPayload = `${id}:${topic}:${publisher}:${publishedAt}`;
-  const signature = createHmac('sha256', secret).update(sigPayload, 'utf8').digest('hex');
-  return { id, topic, publisher, publishedAt, idempotencyKey, payload, signature };
-}
-
-// ---------------------------------------------------------------------------
-// EventBus
-// ---------------------------------------------------------------------------
-
-type EventHandler = (event: Event) => void | Promise<void>;
-
-interface InternalSub {
-  subscription: Subscription;
-  handler: EventHandler;
-}
-
-export class EventBus {
-  private subs = new Map<SubscriptionId, InternalSub>();
-  private seenIdempotencyKeys = new Set<string>();
-  private receipts: DeliveryReceipt[] = [];
-
-  /**
-   * Subscribe to events matching a topic filter.
-   */
-  subscribe(
-    subscriberAgent: AgentId,
-    topicFilter: string,
-    handler: EventHandler,
-    deliveryMode: 'at-least-once' | 'at-most-once' = 'at-least-once'
-  ): Subscription {
-    const sub: Subscription = {
-      id: randomUUID(),
-      subscriberAgent,
-      topicFilter,
-      deliveryMode,
-      createdAt: new Date().toISOString(),
-      cancelledAt: null,
-    };
-    this.subs.set(sub.id, { subscription: sub, handler });
-    return sub;
-  }
-
-  /**
-   * Unsubscribe. Marks the subscription as cancelled.
-   */
-  unsubscribe(subscriptionId: SubscriptionId): void {
-    const entry = this.subs.get(subscriptionId);
-    if (!entry) throw new Error(`Subscription ${subscriptionId} not found`);
-    entry.subscription.cancelledAt = new Date().toISOString();
-    this.subs.delete(subscriptionId);
-  }
-
-  /**
-   * Publish an event to all matching subscribers.
-   * Deduplicates by idempotencyKey.
-   * Returns delivery receipts.
-   */
-  async publish(event: Event): Promise<DeliveryReceipt[]> {
-    // Idempotency check
-    if (this.seenIdempotencyKeys.has(event.idempotencyKey)) {
-      const receipt: DeliveryReceipt = {
-        eventId: event.id,
-        subscriptionId: 'none',
-        receivedAt: new Date().toISOString(),
-        status: 'duplicate-skipped',
-      };
-      this.receipts.push(receipt);
-      return [receipt];
-    }
-    this.seenIdempotencyKeys.add(event.idempotencyKey);
-
-    const newReceipts: DeliveryReceipt[] = [];
-
-    for (const [, entry] of this.subs) {
-      if (entry.subscription.cancelledAt) continue;
-      if (!topicMatches(entry.subscription.topicFilter, event.topic)) continue;
-
-      let status: DeliveryReceipt['status'] = 'processed';
-      try {
-        await entry.handler(event);
-      } catch {
-        status = 'failed';
-      }
-
-      const receipt: DeliveryReceipt = {
-        eventId: event.id,
-        subscriptionId: entry.subscription.id,
-        receivedAt: new Date().toISOString(),
-        status,
-      };
-      newReceipts.push(receipt);
-    }
-
-    this.receipts.push(...newReceipts);
-    return newReceipts;
-  }
-
-  /**
-   * Get all delivery receipts.
-   */
-  getReceipts(): ReadonlyArray<DeliveryReceipt> {
-    return [...this.receipts];
-  }
-
-  /**
-   * Get active subscription count.
-   */
-  get subscriptionCount(): number {
-    return this.subs.size;
-  }
-}
-
-/** Default singleton bus for single-process use */
-export const defaultBus = new EventBus();