@stoneforge/shared-routes 0.1.0

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Shared Types for Collaborate Routes
+ *
+ * Defines the services interface that both main server and orchestrator-server satisfy.
+ * Uses duck-typed interfaces to avoid circular dependency on @stoneforge/quarry.
+ */
+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/dist/ws/broadcaster.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Event Broadcaster
+ *
+ * Singleton service for broadcasting events to connected WebSocket clients.
+ * Uses a polling mechanism to check for new events in the database.
+ */
+import type { QuarryLikeAPI } from '../types.js';
+import type { WebSocketEvent } from './types.js';
+/**
+ * Listener callback for events
+ */
+export type EventListener = (event: WebSocketEvent) => void;
+/**
+ * Event Broadcaster Service
+ *
+ * Polls the database for new events and broadcasts them to listeners.
+ */
+export declare class EventBroadcaster {
+    private api;
+    private listeners;
+    private lastEventId;
+    private pollInterval;
+    private pollIntervalMs;
+    constructor(api: QuarryLikeAPI, pollIntervalMs?: number);
+    /**
+     * Add a listener for events
+     */
+    addListener(listener: EventListener): void;
+    /**
+     * Remove a listener
+     */
+    removeListener(listener: EventListener): void;
+    /**
+     * Get the number of active listeners
+     */
+    get listenerCount(): number;
+    /**
+     * Start polling for events
+     */
+    start(): Promise<void>;
+    /**
+     * Stop polling for events
+     */
+    stop(): void;
+    /**
+     * Initialize the last event ID from the database
+     */
+    private initializeLastEventId;
+    /**
+     * Poll for new events and broadcast them
+     */
+    private pollForEvents;
+}
+/**
+ * Initialize the event broadcaster with an API instance
+ */
+export declare function initializeBroadcaster(api: QuarryLikeAPI, pollIntervalMs?: number): EventBroadcaster;
+/**
+ * Get the broadcaster instance
+ */
+export declare function getBroadcaster(): EventBroadcaster | null;
+//# sourceMappingURL=broadcaster.d.ts.map

package/dist/ws/broadcaster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcaster.d.ts","sourceRoot":"","sources":["../../src/ws/broadcaster.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAejD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;AAE5D;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,GAAG,CAAgB;IAC3B,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,cAAc,CAAS;gBAEnB,GAAG,EAAE,aAAa,EAAE,cAAc,GAAE,MAAY;IAK5D;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAI1C;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAI7C;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB5B;;OAEG;IACH,IAAI,IAAI,IAAI;IAQZ;;OAEG;YACW,qBAAqB;IAcnC;;OAEG;YACW,aAAa;CA6C5B;AAOD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,aAAa,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAKnG;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,gBAAgB,GAAG,IAAI,CAExD"}

package/dist/ws/broadcaster.js

@@ -0,0 +1,146 @@
+/**
+ * Event Broadcaster
+ *
+ * Singleton service for broadcasting events to connected WebSocket clients.
+ * Uses a polling mechanism to check for new events in the database.
+ */
+/**
+ * Event Broadcaster Service
+ *
+ * Polls the database for new events and broadcasts them to listeners.
+ */
+export class EventBroadcaster {
+    api;
+    listeners = new Set();
+    lastEventId = 0;
+    pollInterval = null;
+    pollIntervalMs;
+    constructor(api, pollIntervalMs = 500) {
+        this.api = api;
+        this.pollIntervalMs = pollIntervalMs;
+    }
+    /**
+     * Add a listener for events
+     */
+    addListener(listener) {
+        this.listeners.add(listener);
+    }
+    /**
+     * Remove a listener
+     */
+    removeListener(listener) {
+        this.listeners.delete(listener);
+    }
+    /**
+     * Get the number of active listeners
+     */
+    get listenerCount() {
+        return this.listeners.size;
+    }
+    /**
+     * Start polling for events
+     */
+    async start() {
+        if (this.pollInterval) {
+            return;
+        }
+        // Initialize last event ID from database
+        await this.initializeLastEventId();
+        // Start polling
+        this.pollInterval = setInterval(() => {
+            this.pollForEvents().catch((err) => {
+                console.error('[ws] Error polling for events:', err);
+            });
+        }, this.pollIntervalMs);
+        console.log(`[ws] Event broadcaster started (polling every ${this.pollIntervalMs}ms)`);
+    }
+    /**
+     * Stop polling for events
+     */
+    stop() {
+        if (this.pollInterval) {
+            clearInterval(this.pollInterval);
+            this.pollInterval = null;
+            console.log('[ws] Event broadcaster stopped');
+        }
+    }
+    /**
+     * Initialize the last event ID from the database
+     */
+    async initializeLastEventId() {
+        try {
+            // Access the backend through the API's internal structure
+            // The API stores the backend, but we need to get it indirectly
+            const backend = this.api.backend;
+            const rows = backend.query('SELECT MAX(id) as id FROM events');
+            if (rows.length > 0 && rows[0].id) {
+                this.lastEventId = rows[0].id;
+            }
+        }
+        catch (err) {
+            console.error('[ws] Error initializing last event ID:', err);
+        }
+    }
+    /**
+     * Poll for new events and broadcast them
+     */
+    async pollForEvents() {
+        if (this.listeners.size === 0) {
+            return;
+        }
+        try {
+            // Access the backend through the API
+            const backend = this.api.backend;
+            // Query for events newer than our last known event
+            const events = backend.query('SELECT e.*, el.type as element_type FROM events e LEFT JOIN elements el ON e.element_id = el.id WHERE e.id > ? ORDER BY e.id ASC LIMIT 100', [this.lastEventId]);
+            for (const event of events) {
+                const wsEvent = {
+                    id: event.id,
+                    elementId: event.element_id,
+                    eventType: event.event_type,
+                    actor: event.actor,
+                    oldValue: event.old_value ? JSON.parse(event.old_value) : null,
+                    newValue: event.new_value ? JSON.parse(event.new_value) : null,
+                    createdAt: event.created_at,
+                    elementType: event.element_type ?? 'unknown',
+                };
+                // Broadcast to all listeners
+                for (const listener of this.listeners) {
+                    try {
+                        listener(wsEvent);
+                    }
+                    catch (err) {
+                        console.error('[ws] Error in event listener:', err);
+                    }
+                }
+                // Update last event ID
+                if (event.id > this.lastEventId) {
+                    this.lastEventId = event.id;
+                }
+            }
+        }
+        catch (err) {
+            console.error('[ws] Error polling for events:', err);
+        }
+    }
+}
+/**
+ * Singleton broadcaster instance
+ */
+let broadcaster = null;
+/**
+ * Initialize the event broadcaster with an API instance
+ */
+export function initializeBroadcaster(api, pollIntervalMs) {
+    if (!broadcaster) {
+        broadcaster = new EventBroadcaster(api, pollIntervalMs);
+    }
+    return broadcaster;
+}
+/**
+ * Get the broadcaster instance
+ */
+export function getBroadcaster() {
+    return broadcaster;
+}
+//# sourceMappingURL=broadcaster.js.map

package/dist/ws/broadcaster.js.map

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

package/dist/ws/handler.d.ts

@@ -0,0 +1,11 @@
+/**
+ * WebSocket Handler Utilities
+ *
+ * Pure functions for event subscription filtering.
+ */
+import type { WebSocketEvent, SubscriptionChannel } from './types.js';
+/**
+ * Check if a client should receive an event based on their subscriptions
+ */
+export declare function shouldReceiveEvent(subscriptions: Set<SubscriptionChannel>, event: WebSocketEvent): boolean;
+//# sourceMappingURL=handler.d.ts.map

package/dist/ws/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/ws/handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGtE;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,GAAG,CAAC,mBAAmB,CAAC,EACvC,KAAK,EAAE,cAAc,GACpB,OAAO,CA+BT"}

package/dist/ws/handler.js

@@ -0,0 +1,38 @@
+/**
+ * WebSocket Handler Utilities
+ *
+ * Pure functions for event subscription filtering.
+ */
+import { getChannelForElementType } from './types.js';
+/**
+ * Check if a client should receive an event based on their subscriptions
+ */
+export function shouldReceiveEvent(subscriptions, event) {
+    // Wildcard subscription receives all events
+    if (subscriptions.has('*')) {
+        return true;
+    }
+    // Check for element type channel
+    const channel = getChannelForElementType(event.elementType);
+    if (channel && subscriptions.has(channel)) {
+        return true;
+    }
+    // Check for channel-specific message subscription
+    // For messages, also check messages:${channelId} subscriptions
+    if (event.elementType === 'message' && event.newValue) {
+        const channelId = event.newValue.channel;
+        if (channelId && subscriptions.has(`messages:${channelId}`)) {
+            return true;
+        }
+    }
+    // Check for entity-specific inbox subscription
+    // For inbox items, also check inbox:${recipientId} subscriptions
+    if (event.elementType === 'inbox-item' && event.newValue) {
+        const recipientId = event.newValue.recipientId;
+        if (recipientId && subscriptions.has(`inbox:${recipientId}`)) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=handler.js.map

package/dist/ws/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../src/ws/handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,aAAuC,EACvC,KAAqB;IAErB,4CAA4C;IAC5C,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iCAAiC;IACjC,MAAM,OAAO,GAAG,wBAAwB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC5D,IAAI,OAAO,IAAI,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kDAAkD;IAClD,+DAA+D;IAC/D,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACtD,MAAM,SAAS,GAAI,KAAK,CAAC,QAAoC,CAAC,OAA6B,CAAC;QAC5F,IAAI,SAAS,IAAI,aAAa,CAAC,GAAG,CAAC,YAAY,SAAS,EAAyB,CAAC,EAAE,CAAC;YACnF,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,iEAAiE;IACjE,IAAI,KAAK,CAAC,WAAW,KAAK,YAAY,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACzD,MAAM,WAAW,GAAI,KAAK,CAAC,QAAoC,CAAC,WAAiC,CAAC;QAClG,IAAI,WAAW,IAAI,aAAa,CAAC,GAAG,CAAC,SAAS,WAAW,EAAyB,CAAC,EAAE,CAAC;YACpF,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/ws/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * WebSocket Module
+ *
+ * Shared types, broadcaster, and handler utilities for the event-subscription WebSocket protocol.
+ */
+export type { SubscriptionChannel, ClientMessageType, SubscribeMessage, UnsubscribeMessage, PingMessage, ClientMessage, ServerMessageType, WebSocketEvent, EventMessage, PongMessage, ErrorMessage, SubscribedMessage, UnsubscribedMessage, ServerMessage, } from './types.js';
+export { getChannelForElementType, parseClientMessage } from './types.js';
+export { EventBroadcaster, initializeBroadcaster, getBroadcaster } from './broadcaster.js';
+export type { EventListener } from './broadcaster.js';
+export { shouldReceiveEvent } from './handler.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ws/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ws/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAG1E,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC3F,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/ws/index.js

@@ -0,0 +1,11 @@
+/**
+ * WebSocket Module
+ *
+ * Shared types, broadcaster, and handler utilities for the event-subscription WebSocket protocol.
+ */
+export { getChannelForElementType, parseClientMessage } from './types.js';
+// Broadcaster
+export { EventBroadcaster, initializeBroadcaster, getBroadcaster } from './broadcaster.js';
+// Handler utilities
+export { shouldReceiveEvent } from './handler.js';
+//# sourceMappingURL=index.js.map

package/dist/ws/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ws/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmBH,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE1E,cAAc;AACd,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAG3F,oBAAoB;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/ws/types.d.ts

@@ -0,0 +1,85 @@
+/**
+ * WebSocket Types
+ *
+ * Message types and interfaces for the WebSocket event-subscription protocol.
+ */
+import type { Event } from '@stoneforge/core';
+/**
+ * Valid subscription channels
+ */
+export type SubscriptionChannel = 'tasks' | 'plans' | 'workflows' | 'entities' | 'documents' | 'channels' | 'messages' | 'teams' | 'inbox' | '*' | `messages:${string}` | `inbox:${string}`;
+/**
+ * Client -> Server message types
+ */
+export type ClientMessageType = 'subscribe' | 'unsubscribe' | 'ping';
+/**
+ * Client -> Server messages
+ */
+export interface SubscribeMessage {
+    type: 'subscribe';
+    channels: SubscriptionChannel[];
+}
+export interface UnsubscribeMessage {
+    type: 'unsubscribe';
+    channels: SubscriptionChannel[];
+}
+export interface PingMessage {
+    type: 'ping';
+}
+export type ClientMessage = SubscribeMessage | UnsubscribeMessage | PingMessage;
+/**
+ * Server -> Client message types
+ */
+export type ServerMessageType = 'event' | 'pong' | 'error' | 'subscribed' | 'unsubscribed';
+/**
+ * Extended event with element type information
+ */
+export interface WebSocketEvent extends Omit<Event, 'id'> {
+    id: number;
+    elementType: string;
+}
+/**
+ * Event broadcast message
+ */
+export interface EventMessage {
+    type: 'event';
+    event: WebSocketEvent;
+}
+/**
+ * Pong response
+ */
+export interface PongMessage {
+    type: 'pong';
+}
+/**
+ * Error message
+ */
+export interface ErrorMessage {
+    type: 'error';
+    code: string;
+    message: string;
+}
+/**
+ * Subscription confirmation
+ */
+export interface SubscribedMessage {
+    type: 'subscribed';
+    channels: SubscriptionChannel[];
+}
+/**
+ * Unsubscription confirmation
+ */
+export interface UnsubscribedMessage {
+    type: 'unsubscribed';
+    channels: SubscriptionChannel[];
+}
+export type ServerMessage = EventMessage | PongMessage | ErrorMessage | SubscribedMessage | UnsubscribedMessage;
+/**
+ * Map element types to subscription channels
+ */
+export declare function getChannelForElementType(elementType: string): SubscriptionChannel | null;
+/**
+ * Parse a client message from JSON
+ */
+export declare function parseClientMessage(data: string): ClientMessage | null;
+//# sourceMappingURL=types.d.ts.map

package/dist/ws/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ws/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B,OAAO,GACP,OAAO,GACP,WAAW,GACX,UAAU,GACV,WAAW,GACX,UAAU,GACV,UAAU,GACV,OAAO,GACP,OAAO,GACP,GAAG,GACH,YAAY,MAAM,EAAE,GACpB,SAAS,MAAM,EAAE,CAAC;AAEtB;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,aAAa,GAAG,MAAM,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,WAAW,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,YAAY,GAAG,cAAc,CAAC;AAE3F;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,cAAc,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC;AAED,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,iBAAiB,GACjB,mBAAmB,CAAC;AAExB;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAuBxF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CA6BrE"}

package/dist/ws/types.js

@@ -0,0 +1,63 @@
+/**
+ * WebSocket Types
+ *
+ * Message types and interfaces for the WebSocket event-subscription protocol.
+ */
+/**
+ * Map element types to subscription channels
+ */
+export function getChannelForElementType(elementType) {
+    switch (elementType) {
+        case 'task':
+            return 'tasks';
+        case 'plan':
+            return 'plans';
+        case 'workflow':
+            return 'workflows';
+        case 'entity':
+            return 'entities';
+        case 'document':
+            return 'documents';
+        case 'channel':
+            return 'channels';
+        case 'message':
+            return 'messages';
+        case 'team':
+            return 'teams';
+        case 'inbox-item':
+            return 'inbox';
+        default:
+            return null;
+    }
+}
+/**
+ * Parse a client message from JSON
+ */
+export function parseClientMessage(data) {
+    try {
+        const parsed = JSON.parse(data);
+        if (typeof parsed !== 'object' || parsed === null) {
+            return null;
+        }
+        if (parsed.type === 'ping') {
+            return { type: 'ping' };
+        }
+        if (parsed.type === 'subscribe' && Array.isArray(parsed.channels)) {
+            return {
+                type: 'subscribe',
+                channels: parsed.channels.filter((c) => typeof c === 'string'),
+            };
+        }
+        if (parsed.type === 'unsubscribe' && Array.isArray(parsed.channels)) {
+            return {
+                type: 'unsubscribe',
+                channels: parsed.channels.filter((c) => typeof c === 'string'),
+            };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/ws/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ws/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAyGH;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,WAAmB;IAC1D,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,MAAM;YACT,OAAO,OAAO,CAAC;QACjB,KAAK,MAAM;YACT,OAAO,OAAO,CAAC;QACjB,KAAK,UAAU;YACb,OAAO,WAAW,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,UAAU,CAAC;QACpB,KAAK,UAAU;YACb,OAAO,WAAW,CAAC;QACrB,KAAK,SAAS;YACZ,OAAO,UAAU,CAAC;QACpB,KAAK,SAAS;YACZ,OAAO,UAAU,CAAC;QACpB,KAAK,MAAM;YACT,OAAO,OAAO,CAAC;QACjB,KAAK,YAAY;YACf,OAAO,OAAO,CAAC;QACjB;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAClD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC3B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC1B,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClE,OAAO;gBACL,IAAI,EAAE,WAAW;gBACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;aACxE,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpE,OAAO;gBACL,IAAI,EAAE,aAAa;gBACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;aACxE,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@stoneforge/shared-routes",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Shared route factories for Stoneforge servers",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "bun": "./src/index.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsc",
+    "lint": "tsc --noEmit",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@stoneforge/core": "^0.1.0",
+    "@stoneforge/storage": "^0.1.0",
+    "hono": "^4.7.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.0.0"
+  }
+}