@sumicom/quicksave-message-bus 0.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Quicksave, KingYoung Technology
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/client.d.ts

@@ -0,0 +1,44 @@
+import type { ClientTransport } from './transport.js';
+export type SubscribeCallbacks<S = unknown, U = unknown> = {
+    onSnapshot: (data: S) => void;
+    onUpdate: (data: U) => void;
+    onError?: (error: string) => void;
+};
+export type CommandOptions = {
+    /** Timeout in ms. 0 or undefined disables. */
+    timeoutMs?: number;
+    /**
+     * If the transport is disconnected when command is issued, queue until
+     * reconnect. Default: false (reject immediately).
+     */
+    queueWhileDisconnected?: boolean;
+};
+export declare class MessageBusClient {
+    private transport;
+    private pending;
+    private subs;
+    private queue;
+    constructor(transport: ClientTransport);
+    /**
+     * Issue a one-shot command. Resolves with the server's response data,
+     * rejects with the server's error string or a timeout.
+     */
+    command<R = unknown, P = unknown>(verb: string, payload: P, opts?: CommandOptions): Promise<R>;
+    /**
+     * Subscribe to a path. If another subscriber is already attached, the new
+     * callbacks immediately receive the last snapshot (if any) without a
+     * wire-level resubscribe; refcount is incremented.
+     *
+     * Returns an unsubscribe function. On the last unsubscribe for a path, an
+     * `unsub` frame is sent.
+     */
+    subscribe<S = unknown, U = unknown>(path: string, callbacks: SubscribeCallbacks<S, U>): () => void;
+    private handleFrame;
+    private handleResult;
+    private handleSnapshot;
+    private handleUpdate;
+    private handleSubError;
+    private handleConnected;
+    private handleDisconnected;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGtD,MAAM,MAAM,kBAAkB,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI;IACzD,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IAC9B,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IAC5B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,CAAC;AAoBF,MAAM,MAAM,cAAc,GAAG;IAC3B,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC,CAAC;AAQF,qBAAa,gBAAgB;IAKf,OAAO,CAAC,SAAS;IAJ7B,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,IAAI,CAAwC;IACpD,OAAO,CAAC,KAAK,CAAyB;gBAElB,SAAS,EAAE,eAAe;IAM9C;;;OAGG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,EACV,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,CAAC,CAAC;IA8Bb;;;;;;;OAOG;IACH,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAChC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,GAClC,MAAM,IAAI;IA+Cb,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,kBAAkB;CAiB3B"}

package/dist/client.js

@@ -0,0 +1,195 @@
+let idCounter = 0;
+function nextId() {
+    idCounter = (idCounter + 1) | 0;
+    return `c${Date.now().toString(36)}-${idCounter.toString(36)}`;
+}
+export class MessageBusClient {
+    transport;
+    pending = new Map();
+    subs = new Map();
+    queue = [];
+    constructor(transport) {
+        this.transport = transport;
+        transport.onFrame((frame) => this.handleFrame(frame));
+        transport.onConnected(() => this.handleConnected());
+        transport.onDisconnected(() => this.handleDisconnected());
+    }
+    /**
+     * Issue a one-shot command. Resolves with the server's response data,
+     * rejects with the server's error string or a timeout.
+     */
+    command(verb, payload, opts = {}) {
+        return new Promise((resolve, reject) => {
+            const id = nextId();
+            const pending = {
+                resolve: (data) => resolve(data),
+                reject,
+            };
+            if (opts.timeoutMs && opts.timeoutMs > 0) {
+                pending.timer = setTimeout(() => {
+                    if (this.pending.delete(id)) {
+                        reject(new Error(`Command "${verb}" timed out after ${opts.timeoutMs}ms`));
+                    }
+                }, opts.timeoutMs);
+            }
+            this.pending.set(id, pending);
+            const send = () => {
+                this.transport.send({ kind: 'cmd', id, verb, payload });
+            };
+            if (this.transport.isConnected()) {
+                send();
+            }
+            else if (opts.queueWhileDisconnected) {
+                this.queue.push(send);
+            }
+            else {
+                this.pending.delete(id);
+                if (pending.timer)
+                    clearTimeout(pending.timer);
+                reject(new Error(`Transport is disconnected; cannot send "${verb}"`));
+            }
+        });
+    }
+    /**
+     * Subscribe to a path. If another subscriber is already attached, the new
+     * callbacks immediately receive the last snapshot (if any) without a
+     * wire-level resubscribe; refcount is incremented.
+     *
+     * Returns an unsubscribe function. On the last unsubscribe for a path, an
+     * `unsub` frame is sent.
+     */
+    subscribe(path, callbacks) {
+        const cb = callbacks;
+        let state = this.subs.get(path);
+        if (!state) {
+            state = {
+                path,
+                refcount: 0,
+                subscribers: new Set(),
+                wireActive: false,
+            };
+            this.subs.set(path, state);
+        }
+        state.subscribers.add(cb);
+        state.refcount++;
+        // If we already have a cached snapshot, replay it to the new subscriber.
+        if (state.lastSnapshot) {
+            queueMicrotask(() => {
+                if (state.subscribers.has(cb))
+                    cb.onSnapshot(state.lastSnapshot.data);
+            });
+        }
+        // Ensure a wire-level subscription exists.
+        if (!state.wireActive) {
+            const send = () => {
+                if (!this.subs.get(path))
+                    return;
+                this.transport.send({ kind: 'sub', path });
+                state.wireActive = true;
+            };
+            if (this.transport.isConnected())
+                send();
+            else
+                this.queue.push(send);
+        }
+        let released = false;
+        return () => {
+            if (released)
+                return;
+            released = true;
+            const current = this.subs.get(path);
+            if (!current)
+                return;
+            current.subscribers.delete(cb);
+            current.refcount = Math.max(0, current.refcount - 1);
+            if (current.refcount === 0) {
+                this.subs.delete(path);
+                if (current.wireActive && this.transport.isConnected()) {
+                    this.transport.send({ kind: 'unsub', path });
+                }
+            }
+        };
+    }
+    handleFrame(frame) {
+        switch (frame.kind) {
+            case 'result':
+                this.handleResult(frame);
+                return;
+            case 'snap':
+                this.handleSnapshot(frame.path, frame.data);
+                return;
+            case 'upd':
+                this.handleUpdate(frame.path, frame.data);
+                return;
+            case 'sub-error':
+                this.handleSubError(frame.path, frame.error);
+                return;
+        }
+    }
+    handleResult(frame) {
+        const pending = this.pending.get(frame.id);
+        if (!pending)
+            return;
+        this.pending.delete(frame.id);
+        if (pending.timer)
+            clearTimeout(pending.timer);
+        if (frame.ok)
+            pending.resolve(frame.data);
+        else
+            pending.reject(new Error(frame.error));
+    }
+    handleSnapshot(path, data) {
+        const state = this.subs.get(path);
+        if (!state)
+            return;
+        state.lastSnapshot = { data };
+        for (const cb of state.subscribers)
+            cb.onSnapshot(data);
+    }
+    handleUpdate(path, data) {
+        const state = this.subs.get(path);
+        if (!state)
+            return;
+        state.lastSnapshot = { data };
+        for (const cb of state.subscribers)
+            cb.onUpdate(data);
+    }
+    handleSubError(path, error) {
+        const state = this.subs.get(path);
+        if (!state)
+            return;
+        for (const cb of state.subscribers)
+            cb.onError?.(error);
+    }
+    handleConnected() {
+        // Flush any queued sends (commands issued while disconnected).
+        const pending = this.queue;
+        this.queue = [];
+        for (const fn of pending)
+            fn();
+        // Re-establish wire subscriptions.
+        for (const state of this.subs.values()) {
+            this.transport.send({ kind: 'sub', path: state.path });
+            state.wireActive = true;
+        }
+    }
+    handleDisconnected() {
+        for (const state of this.subs.values()) {
+            state.wireActive = false;
+        }
+        // Reject all in-flight commands. They were sent to a peer that's no
+        // longer reachable; waiting for their timeout would surface misleading
+        // "timed out after Nms" errors to the caller. The caller can retry
+        // after reconnect if needed.
+        if (this.pending.size > 0) {
+            const stranded = Array.from(this.pending.values());
+            this.pending.clear();
+            for (const p of stranded) {
+                if (p.timer)
+                    clearTimeout(p.timer);
+                p.reject(new Error('Transport disconnected before response'));
+            }
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { MessageBusServer } from './server.js';
+export type { CommandHandler, SubscribeHandler } from './server.js';
+export { MessageBusClient } from './client.js';
+export type { CommandOptions, SubscribeCallbacks } from './client.js';
+export type { ClientTransport, PeerId, ServerTransport, } from './transport.js';
+export type { AnyFrame, ClientFrame, CommandFrame, CommandResultFrame, PathParams, ServerFrame, SnapshotFrame, SubscribeErrorFrame, SubscribeFrame, UnsubscribeFrame, UpdateFrame, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtE,YAAY,EACV,eAAe,EACf,MAAM,EACN,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { MessageBusServer } from './server.js';
+export { MessageBusClient } from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/path.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Path matching for subscription patterns.
+ *
+ * Patterns use `:name` for single-segment params (e.g. `/sessions/:id`).
+ * Segments are separated by `/`. Leading `/` is optional but normalized away.
+ *
+ * Priority: static segments beat params at the same position.
+ * Example: `/sessions/active` is preferred over `/sessions/:id` when matching
+ * the path `/sessions/active`.
+ */
+export type PathPattern = {
+    pattern: string;
+    segments: Segment[];
+    specificity: number;
+};
+type Segment = {
+    kind: 'static';
+    value: string;
+} | {
+    kind: 'param';
+    name: string;
+};
+export declare function parsePattern(pattern: string): PathPattern;
+export declare function matchPattern(pattern: PathPattern, path: string): Record<string, string> | null;
+/**
+ * Sort patterns by descending specificity so the first match wins.
+ * Mutates the input array.
+ */
+export declare function sortPatternsBySpecificity<T extends {
+    pattern: PathPattern;
+}>(entries: T[]): T[];
+export {};
+//# sourceMappingURL=path.d.ts.map

package/dist/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../src/path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,KAAK,OAAO,GACR;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAQpC,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAoBzD;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAiB/B;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS;IAAE,OAAO,EAAE,WAAW,CAAA;CAAE,EAC1E,OAAO,EAAE,CAAC,EAAE,GACX,CAAC,EAAE,CAGL"}

package/dist/path.js

@@ -0,0 +1,68 @@
+/**
+ * Path matching for subscription patterns.
+ *
+ * Patterns use `:name` for single-segment params (e.g. `/sessions/:id`).
+ * Segments are separated by `/`. Leading `/` is optional but normalized away.
+ *
+ * Priority: static segments beat params at the same position.
+ * Example: `/sessions/active` is preferred over `/sessions/:id` when matching
+ * the path `/sessions/active`.
+ */
+function normalize(path) {
+    if (path.length === 0)
+        return '';
+    const trimmed = path.startsWith('/') ? path.slice(1) : path;
+    return trimmed.endsWith('/') ? trimmed.slice(0, -1) : trimmed;
+}
+export function parsePattern(pattern) {
+    const normalized = normalize(pattern);
+    const rawSegments = normalized.length === 0 ? [] : normalized.split('/');
+    const segments = rawSegments.map((seg) => {
+        if (seg.startsWith(':')) {
+            const name = seg.slice(1);
+            if (name.length === 0) {
+                throw new Error(`Invalid pattern "${pattern}": param must have a name`);
+            }
+            return { kind: 'param', name };
+        }
+        return { kind: 'static', value: seg };
+    });
+    // Specificity: each static segment contributes a higher weight than a param.
+    // Longer paths are more specific than shorter ones at equal static counts.
+    let specificity = 0;
+    for (const seg of segments) {
+        specificity = specificity * 4 + (seg.kind === 'static' ? 2 : 1);
+    }
+    return { pattern, segments, specificity };
+}
+export function matchPattern(pattern, path) {
+    const pathSegments = normalize(path).split('/');
+    const normalizedPath = normalize(path);
+    const actualSegments = normalizedPath.length === 0 ? [] : pathSegments;
+    if (actualSegments.length !== pattern.segments.length)
+        return null;
+    const params = {};
+    for (let i = 0; i < pattern.segments.length; i++) {
+        const patternSeg = pattern.segments[i];
+        const pathSeg = actualSegments[i];
+        if (patternSeg.kind === 'static') {
+            if (patternSeg.value !== pathSeg)
+                return null;
+        }
+        else {
+            if (pathSeg.length === 0)
+                return null;
+            params[patternSeg.name] = pathSeg;
+        }
+    }
+    return params;
+}
+/**
+ * Sort patterns by descending specificity so the first match wins.
+ * Mutates the input array.
+ */
+export function sortPatternsBySpecificity(entries) {
+    entries.sort((a, b) => b.pattern.specificity - a.pattern.specificity);
+    return entries;
+}
+//# sourceMappingURL=path.js.map

package/dist/path.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,47 @@
+import type { ServerTransport, PeerId } from './transport.js';
+import type { PathParams } from './types.js';
+export type CommandHandler<P = unknown, R = unknown> = (payload: P, ctx: {
+    peer: PeerId;
+}) => Promise<R> | R;
+export type SubscribeHandler<Path extends string = string, S = unknown, _U = unknown> = {
+    snapshot: (ctx: {
+        path: string;
+        params: PathParams<Path>;
+        peer: PeerId;
+    }) => Promise<S> | S;
+    onSubscribed?: (ctx: {
+        path: string;
+        params: PathParams<Path>;
+        peer: PeerId;
+    }) => void;
+    onUnsubscribed?: (ctx: {
+        path: string;
+        params: PathParams<Path>;
+        peer: PeerId;
+    }) => void;
+};
+export declare class MessageBusServer {
+    private transport;
+    private commands;
+    private subscriptions;
+    private active;
+    private byPeer;
+    constructor(transport: ServerTransport);
+    onCommand<P = unknown, R = unknown>(verb: string, handler: CommandHandler<P, R>): void;
+    onSubscribe<Path extends string, S = unknown, U = unknown>(pattern: Path, handler: SubscribeHandler<Path, S, U>): void;
+    /**
+     * Broadcast an update to every peer currently subscribed to `path`.
+     * Returns the number of peers that received the update.
+     */
+    publish<U = unknown>(path: string, data: U): number;
+    /** Number of peers currently subscribed to the exact `path`. */
+    subscriberCount(path: string): number;
+    private handleFrame;
+    private handleCommand;
+    private handleSubscribe;
+    private sendSnapshot;
+    private handleUnsubscribe;
+    private handlePeerDisconnected;
+    private findMatch;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,YAAY,CAAC;AAE1D,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI,CACrD,OAAO,EAAE,CAAC,EACV,GAAG,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,KAClB,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAEpB,MAAM,MAAM,gBAAgB,CAC1B,IAAI,SAAS,MAAM,GAAG,MAAM,EAC5B,CAAC,GAAG,OAAO,EAKX,EAAE,GAAG,OAAO,IACV;IACF,QAAQ,EAAE,CAAC,GAAG,EAAE;QACd,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACrB,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,IAAI,CAAC;IACX,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,IAAI,CAAC;CACZ,CAAC;AAcF,qBAAa,gBAAgB;IAMf,OAAO,CAAC,SAAS;IAL7B,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,aAAa,CAA2B;IAChD,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,MAAM,CAAkC;gBAE5B,SAAS,EAAE,eAAe;IAK9C,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,GAC5B,IAAI;IAOP,WAAW,CAAC,IAAI,SAAS,MAAM,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EACvD,OAAO,EAAE,IAAI,EACb,OAAO,EAAE,gBAAgB,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,GACpC,IAAI;IAYP;;;OAGG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM;IAWnD,gEAAgE;IAChE,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQrC,OAAO,CAAC,WAAW;YAcL,aAAa;YA6Bb,eAAe;YAkDf,YAAY;IAiB1B,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,sBAAsB;IAmB9B,OAAO,CAAC,SAAS;CASlB"}

package/dist/server.js

@@ -0,0 +1,196 @@
+import { matchPattern, parsePattern, sortPatternsBySpecificity, } from './path.js';
+export class MessageBusServer {
+    transport;
+    commands = new Map();
+    subscriptions = [];
+    active = new Map();
+    byPeer = new Map();
+    constructor(transport) {
+        this.transport = transport;
+        transport.onFrame((peer, frame) => this.handleFrame(peer, frame));
+        transport.onPeerDisconnected((peer) => this.handlePeerDisconnected(peer));
+    }
+    onCommand(verb, handler) {
+        if (this.commands.has(verb)) {
+            throw new Error(`Command "${verb}" is already registered`);
+        }
+        this.commands.set(verb, handler);
+    }
+    onSubscribe(pattern, handler) {
+        const parsed = parsePattern(pattern);
+        if (this.subscriptions.some((e) => e.pattern.pattern === parsed.pattern)) {
+            throw new Error(`Subscription pattern "${pattern}" is already registered`);
+        }
+        this.subscriptions.push({
+            pattern: parsed,
+            handler: handler,
+        });
+        sortPatternsBySpecificity(this.subscriptions);
+    }
+    /**
+     * Broadcast an update to every peer currently subscribed to `path`.
+     * Returns the number of peers that received the update.
+     */
+    publish(path, data) {
+        let count = 0;
+        for (const sub of this.active.values()) {
+            if (sub.path === path) {
+                this.transport.send(sub.peer, { kind: 'upd', path, data });
+                count++;
+            }
+        }
+        return count;
+    }
+    /** Number of peers currently subscribed to the exact `path`. */
+    subscriberCount(path) {
+        let count = 0;
+        for (const sub of this.active.values()) {
+            if (sub.path === path)
+                count++;
+        }
+        return count;
+    }
+    handleFrame(peer, frame) {
+        switch (frame.kind) {
+            case 'cmd':
+                void this.handleCommand(peer, frame.id, frame.verb, frame.payload);
+                return;
+            case 'sub':
+                void this.handleSubscribe(peer, frame.path);
+                return;
+            case 'unsub':
+                this.handleUnsubscribe(peer, frame.path);
+                return;
+        }
+    }
+    async handleCommand(peer, id, verb, payload) {
+        const handler = this.commands.get(verb);
+        if (!handler) {
+            this.transport.send(peer, {
+                kind: 'result',
+                id,
+                ok: false,
+                error: `Unknown command: ${verb}`,
+            });
+            return;
+        }
+        try {
+            const data = await handler(payload, { peer });
+            this.transport.send(peer, { kind: 'result', id, ok: true, data });
+        }
+        catch (err) {
+            this.transport.send(peer, {
+                kind: 'result',
+                id,
+                ok: false,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    async handleSubscribe(peer, path) {
+        const key = subKey(peer, path);
+        if (this.active.has(key)) {
+            // Duplicate subscribe from same peer — client layer dedups, but be
+            // defensive on the wire. Re-send snapshot using existing handler.
+            const existing = this.active.get(key);
+            await this.sendSnapshot(peer, existing);
+            return;
+        }
+        const matched = this.findMatch(path);
+        if (!matched) {
+            this.transport.send(peer, {
+                kind: 'sub-error',
+                path,
+                error: `No subscription handler for path: ${path}`,
+            });
+            return;
+        }
+        const entry = {
+            peer,
+            path,
+            pattern: matched.entry.pattern,
+            params: matched.params,
+        };
+        this.active.set(key, entry);
+        let peerSet = this.byPeer.get(peer);
+        if (!peerSet) {
+            peerSet = new Set();
+            this.byPeer.set(peer, peerSet);
+        }
+        peerSet.add(key);
+        try {
+            await this.sendSnapshot(peer, entry);
+        }
+        catch (err) {
+            this.active.delete(key);
+            peerSet.delete(key);
+            this.transport.send(peer, {
+                kind: 'sub-error',
+                path,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            return;
+        }
+        matched.entry.handler.onSubscribed?.({
+            path,
+            params: entry.params,
+            peer,
+        });
+    }
+    async sendSnapshot(peer, entry) {
+        const handler = this.subscriptions.find((e) => e.pattern.pattern === entry.pattern.pattern)?.handler;
+        if (!handler) {
+            throw new Error(`Subscription pattern "${entry.pattern.pattern}" is no longer registered`);
+        }
+        const data = await handler.snapshot({
+            path: entry.path,
+            params: entry.params,
+            peer,
+        });
+        this.transport.send(peer, { kind: 'snap', path: entry.path, data });
+    }
+    handleUnsubscribe(peer, path) {
+        const key = subKey(peer, path);
+        const entry = this.active.get(key);
+        if (!entry)
+            return;
+        this.active.delete(key);
+        this.byPeer.get(peer)?.delete(key);
+        const handler = this.subscriptions.find((e) => e.pattern.pattern === entry.pattern.pattern)?.handler;
+        handler?.onUnsubscribed?.({
+            path: entry.path,
+            params: entry.params,
+            peer,
+        });
+    }
+    handlePeerDisconnected(peer) {
+        const keys = this.byPeer.get(peer);
+        if (!keys)
+            return;
+        for (const key of keys) {
+            const entry = this.active.get(key);
+            if (!entry)
+                continue;
+            this.active.delete(key);
+            const handler = this.subscriptions.find((e) => e.pattern.pattern === entry.pattern.pattern)?.handler;
+            handler?.onUnsubscribed?.({
+                path: entry.path,
+                params: entry.params,
+                peer,
+            });
+        }
+        this.byPeer.delete(peer);
+    }
+    findMatch(path) {
+        for (const entry of this.subscriptions) {
+            const params = matchPattern(entry.pattern, path);
+            if (params)
+                return { entry, params };
+        }
+        return null;
+    }
+}
+function subKey(peer, path) {
+    return `${peer}\u0000${path}`;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/transport.d.ts

@@ -0,0 +1,30 @@
+import type { ClientFrame, ServerFrame } from './types.js';
+/** Identifier for a connected client from the server's perspective. */
+export type PeerId = string;
+/**
+ * Server-side transport. Frames are addressed per-peer so the server can
+ * deliver snapshots/updates to specific subscribers.
+ *
+ * Transports are responsible for wrapping the frame JSON in whatever envelope
+ * the underlying wire needs (encryption, routing metadata, etc.) and for
+ * emitting `peer-connected` / `peer-disconnected` so the server can track
+ * liveness and drop subscriptions.
+ */
+export interface ServerTransport {
+    send(peer: PeerId, frame: ServerFrame): void;
+    onFrame(handler: (peer: PeerId, frame: ClientFrame) => void): void;
+    onPeerConnected(handler: (peer: PeerId) => void): void;
+    onPeerDisconnected(handler: (peer: PeerId) => void): void;
+}
+/**
+ * Client-side transport. A client has exactly one upstream, so frames are
+ * not addressed.
+ */
+export interface ClientTransport {
+    send(frame: ClientFrame): void;
+    onFrame(handler: (frame: ServerFrame) => void): void;
+    onConnected(handler: () => void): void;
+    onDisconnected(handler: () => void): void;
+    isConnected(): boolean;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE3D,uEAAuE;AACvE,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAE5B;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7C,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI,CAAC;IACnE,eAAe,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IACvD,kBAAkB,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;CAC3D;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI,CAAC;IACrD,WAAW,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACvC,cAAc,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC1C,WAAW,IAAI,OAAO,CAAC;CACxB"}

package/dist/transport.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":""}

package/dist/transports/fake.d.ts

@@ -0,0 +1,53 @@
+import type { ClientTransport, PeerId, ServerTransport } from '../transport.js';
+import type { ClientFrame, ServerFrame } from '../types.js';
+/**
+ * In-memory transport pair for testing. Supports multiple clients connecting
+ * to a single server. Messages are delivered via `queueMicrotask` to surface
+ * any ordering assumptions.
+ */
+export declare class FakePipe {
+    readonly server: FakeServerTransport;
+    private clients;
+    private idCounter;
+    constructor();
+    /** Create a new client connected to the shared server. */
+    createClient(): FakeClientTransport;
+    /** Used internally by clients to deliver frames to the server. */
+    _deliverToServer(peer: PeerId, frame: ClientFrame): void;
+    /** Used internally by the server to deliver frames to a client. */
+    _deliverToClient(peer: PeerId, frame: ServerFrame): void;
+    _notifyServerOfConnect(peer: PeerId): void;
+    _notifyServerOfDisconnect(peer: PeerId): void;
+}
+export declare class FakeServerTransport implements ServerTransport {
+    private frameHandlers;
+    private connectHandlers;
+    private disconnectHandlers;
+    private pipes;
+    send(peer: PeerId, frame: ServerFrame): void;
+    onFrame(handler: (peer: PeerId, frame: ClientFrame) => void): void;
+    onPeerConnected(handler: (peer: PeerId) => void): void;
+    onPeerDisconnected(handler: (peer: PeerId) => void): void;
+    _registerPeer(peer: PeerId, pipe: FakePipe): void;
+    _receive(peer: PeerId, frame: ClientFrame): void;
+    _peerConnected(peer: PeerId): void;
+    _peerDisconnected(peer: PeerId): void;
+}
+export declare class FakeClientTransport implements ClientTransport {
+    private peerId;
+    private pipe;
+    private frameHandlers;
+    private connectHandlers;
+    private disconnectHandlers;
+    private connected;
+    constructor(peerId: PeerId, pipe: FakePipe);
+    connect(): void;
+    disconnect(): void;
+    send(frame: ClientFrame): void;
+    onFrame(handler: (frame: ServerFrame) => void): void;
+    onConnected(handler: () => void): void;
+    onDisconnected(handler: () => void): void;
+    isConnected(): boolean;
+    _receive(frame: ServerFrame): void;
+}
+//# sourceMappingURL=fake.d.ts.map

package/dist/transports/fake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake.d.ts","sourceRoot":"","sources":["../../src/transports/fake.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,MAAM,EACN,eAAe,EAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE5D;;;;GAIG;AACH,qBAAa,QAAQ;IACnB,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,OAAO,CAAC,OAAO,CAA0C;IACzD,OAAO,CAAC,SAAS,CAAK;;IAMtB,0DAA0D;IAC1D,YAAY,IAAI,mBAAmB;IAOnC,kEAAkE;IAClE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI;IAIxD,mEAAmE;IACnE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI;IAMxD,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI1C,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAI9C;AAED,qBAAa,mBAAoB,YAAW,eAAe;IACzD,OAAO,CAAC,aAAa,CAAyD;IAC9E,OAAO,CAAC,eAAe,CAAqC;IAC5D,OAAO,CAAC,kBAAkB,CAAqC;IAC/D,OAAO,CAAC,KAAK,CAA+B;IAE5C,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI;IAM5C,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IAIlE,eAAe,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAItD,kBAAkB,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIzD,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI;IAIjD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI;IAIhD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIlC,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAItC;AAED,qBAAa,mBAAoB,YAAW,eAAe;IAOvD,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,IAAI;IAPd,OAAO,CAAC,aAAa,CAA2C;IAChE,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,kBAAkB,CAAyB;IACnD,OAAO,CAAC,SAAS,CAAS;gBAGhB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,QAAQ;IAGxB,OAAO,IAAI,IAAI;IAWf,UAAU,IAAI,IAAI;IAOlB,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAO9B,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IAIpD,WAAW,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAItC,cAAc,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIzC,WAAW,IAAI,OAAO;IAItB,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;CAGnC"}

package/dist/transports/fake.js

@@ -0,0 +1,130 @@
+/**
+ * In-memory transport pair for testing. Supports multiple clients connecting
+ * to a single server. Messages are delivered via `queueMicrotask` to surface
+ * any ordering assumptions.
+ */
+export class FakePipe {
+    server;
+    clients = new Map();
+    idCounter = 0;
+    constructor() {
+        this.server = new FakeServerTransport();
+    }
+    /** Create a new client connected to the shared server. */
+    createClient() {
+        const peerId = `peer-${++this.idCounter}`;
+        const client = new FakeClientTransport(peerId, this);
+        this.clients.set(peerId, client);
+        return client;
+    }
+    /** Used internally by clients to deliver frames to the server. */
+    _deliverToServer(peer, frame) {
+        queueMicrotask(() => this.server._receive(peer, frame));
+    }
+    /** Used internally by the server to deliver frames to a client. */
+    _deliverToClient(peer, frame) {
+        const client = this.clients.get(peer);
+        if (!client)
+            return;
+        queueMicrotask(() => client._receive(frame));
+    }
+    _notifyServerOfConnect(peer) {
+        queueMicrotask(() => this.server._peerConnected(peer));
+    }
+    _notifyServerOfDisconnect(peer) {
+        this.clients.delete(peer);
+        queueMicrotask(() => this.server._peerDisconnected(peer));
+    }
+}
+export class FakeServerTransport {
+    frameHandlers = [];
+    connectHandlers = [];
+    disconnectHandlers = [];
+    pipes = new Map();
+    send(peer, frame) {
+        const pipe = this.pipes.get(peer);
+        if (!pipe)
+            return;
+        pipe._deliverToClient(peer, frame);
+    }
+    onFrame(handler) {
+        this.frameHandlers.push(handler);
+    }
+    onPeerConnected(handler) {
+        this.connectHandlers.push(handler);
+    }
+    onPeerDisconnected(handler) {
+        this.disconnectHandlers.push(handler);
+    }
+    _registerPeer(peer, pipe) {
+        this.pipes.set(peer, pipe);
+    }
+    _receive(peer, frame) {
+        for (const handler of this.frameHandlers)
+            handler(peer, frame);
+    }
+    _peerConnected(peer) {
+        for (const handler of this.connectHandlers)
+            handler(peer);
+    }
+    _peerDisconnected(peer) {
+        this.pipes.delete(peer);
+        for (const handler of this.disconnectHandlers)
+            handler(peer);
+    }
+}
+export class FakeClientTransport {
+    peerId;
+    pipe;
+    frameHandlers = [];
+    connectHandlers = [];
+    disconnectHandlers = [];
+    connected = false;
+    constructor(peerId, pipe) {
+        this.peerId = peerId;
+        this.pipe = pipe;
+    }
+    connect() {
+        if (this.connected)
+            return;
+        this.connected = true;
+        this.pipe.server._registerPeer(this.peerId, this.pipe);
+        this.pipe._notifyServerOfConnect(this.peerId);
+        // Fire local handlers on next microtask so subscribers can wire up first.
+        queueMicrotask(() => {
+            for (const handler of this.connectHandlers)
+                handler();
+        });
+    }
+    disconnect() {
+        if (!this.connected)
+            return;
+        this.connected = false;
+        this.pipe._notifyServerOfDisconnect(this.peerId);
+        for (const handler of this.disconnectHandlers)
+            handler();
+    }
+    send(frame) {
+        if (!this.connected) {
+            throw new Error('FakeClientTransport: not connected');
+        }
+        this.pipe._deliverToServer(this.peerId, frame);
+    }
+    onFrame(handler) {
+        this.frameHandlers.push(handler);
+    }
+    onConnected(handler) {
+        this.connectHandlers.push(handler);
+    }
+    onDisconnected(handler) {
+        this.disconnectHandlers.push(handler);
+    }
+    isConnected() {
+        return this.connected;
+    }
+    _receive(frame) {
+        for (const handler of this.frameHandlers)
+            handler(frame);
+    }
+}
+//# sourceMappingURL=fake.js.map

package/dist/transports/fake.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Wire frames exchanged between client and server.
+ *
+ * Commands are one-shot request/response.
+ * Subscriptions deliver an initial snapshot followed by updates until unsub.
+ */
+export type CommandFrame = {
+    kind: 'cmd';
+    id: string;
+    verb: string;
+    payload: unknown;
+};
+export type CommandResultFrame = {
+    kind: 'result';
+    id: string;
+    ok: true;
+    data: unknown;
+} | {
+    kind: 'result';
+    id: string;
+    ok: false;
+    error: string;
+};
+export type SubscribeFrame = {
+    kind: 'sub';
+    path: string;
+};
+export type SnapshotFrame = {
+    kind: 'snap';
+    path: string;
+    data: unknown;
+};
+export type UpdateFrame = {
+    kind: 'upd';
+    path: string;
+    data: unknown;
+};
+export type SubscribeErrorFrame = {
+    kind: 'sub-error';
+    path: string;
+    error: string;
+};
+export type UnsubscribeFrame = {
+    kind: 'unsub';
+    path: string;
+};
+export type ClientFrame = CommandFrame | SubscribeFrame | UnsubscribeFrame;
+export type ServerFrame = CommandResultFrame | SnapshotFrame | UpdateFrame | SubscribeErrorFrame;
+export type AnyFrame = ClientFrame | ServerFrame;
+/** Extract `:param` names from a path pattern as a union of string literals. */
+export type PathParams<P extends string> = P extends `${string}:${infer Param}/${infer Rest}` ? {
+    [K in Param | keyof PathParams<`/${Rest}`>]: string;
+} : P extends `${string}:${infer Param}` ? {
+    [K in Param]: string;
+} : Record<string, never>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,KAAK,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,cAAc,GAAG,gBAAgB,CAAC;AAC3E,MAAM,MAAM,WAAW,GACnB,kBAAkB,GAClB,aAAa,GACb,WAAW,GACX,mBAAmB,CAAC;AAExB,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;AAEjD,gFAAgF;AAChF,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,IACrC,CAAC,SAAS,GAAG,MAAM,IAAI,MAAM,KAAK,IAAI,MAAM,IAAI,EAAE,GAC9C;KAAG,CAAC,IAAI,KAAK,GAAG,MAAM,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,GAAG,MAAM;CAAE,GACvD,CAAC,SAAS,GAAG,MAAM,IAAI,MAAM,KAAK,EAAE,GAClC;KAAG,CAAC,IAAI,KAAK,GAAG,MAAM;CAAE,GACxB,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Wire frames exchanged between client and server.
+ *
+ * Commands are one-shot request/response.
+ * Subscriptions deliver an initial snapshot followed by updates until unsub.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@sumicom/quicksave-message-bus",
+  "version": "0.7.0",
+  "description": "Transport-agnostic command + subscribe message bus for Quicksave",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/KingYoung-Sumicom/quicksave.git",
+    "directory": "packages/message-bus"
+  },
+  "homepage": "https://github.com/KingYoung-Sumicom/quicksave#readme",
+  "bugs": {
+    "url": "https://github.com/KingYoung-Sumicom/quicksave/issues"
+  },
+  "keywords": [
+    "quicksave",
+    "message-bus",
+    "transport"
+  ],
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "publishConfig": {
+    "branch": "stable"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./fake": {
+      "import": "./dist/transports/fake.js",
+      "types": "./dist/transports/fake.d.ts"
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:unit": "vitest run",
+    "test:watch": "vitest"
+  }
+}