@edgebasejs/core 0.1.7 → 0.1.9

package/dist/core/src/realtime/change-notifier.d.ts

@@ -0,0 +1,50 @@
+import type { SubscriptionManager } from './subscription-manager';
+import type { ChangeMessage } from './message-types';
+import type { User } from '@edgebasejs/types';
+export interface WebSocketClient {
+    send(message: string): void;
+    close(): void;
+    isOpen(): boolean;
+}
+/**
+ * Notifies subscribed clients about data changes
+ * Manages broadcasting changes to WebSocket connections
+ */
+export declare class ChangeNotifier {
+    private subscriptionManager;
+    private clients;
+    constructor(subscriptionManager: SubscriptionManager);
+    /**
+     * Register a WebSocket client connection
+     */
+    registerClient(connectionId: string, client: WebSocketClient): void;
+    /**
+     * Unregister a WebSocket client connection
+     */
+    unregisterClient(connectionId: string): void;
+    /**
+     * Broadcast a change to all subscribed clients
+     */
+    notifyChange(entity: string, operation: 'create' | 'update' | 'delete', record: Record<string, unknown>, recordId: string, user: User, version?: number): Promise<void>;
+    /**
+     * Send a message to a specific connection
+     */
+    private sendToConnection;
+    /**
+     * Broadcast a message to all clients
+     */
+    broadcastToAll(message: ChangeMessage, filterSubscriptions?: string[]): void;
+    /**
+     * Send heartbeat to all connected clients
+     */
+    sendHeartbeat(): void;
+    /**
+     * Send error message to a specific client
+     */
+    sendError(connectionId: string, code: string, message: string): void;
+    /**
+     * Get connected clients count
+     */
+    getConnectedClientsCount(): number;
+}
+//# sourceMappingURL=change-notifier.d.ts.map

package/dist/core/src/realtime/change-notifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-notifier.d.ts","sourceRoot":"","sources":["../../../../src/realtime/change-notifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,IAAI,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,cAAc;IAGb,OAAO,CAAC,mBAAmB;IAFvC,OAAO,CAAC,OAAO,CAAsC;gBAEjC,mBAAmB,EAAE,mBAAmB;IAE5D;;OAEG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI;IAInE;;OAEG;IACH,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAI5C;;OAEG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,EACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IA+BhB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,mBAAmB,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IA8B5E;;OAEG;IACH,aAAa,IAAI,IAAI;IAqBrB;;OAEG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAoBpE;;OAEG;IACH,wBAAwB,IAAI,MAAM;CAGnC"}

package/dist/core/src/realtime/change-notifier.js

@@ -0,0 +1,145 @@
+/**
+ * Notifies subscribed clients about data changes
+ * Manages broadcasting changes to WebSocket connections
+ */
+export class ChangeNotifier {
+    constructor(subscriptionManager) {
+        this.subscriptionManager = subscriptionManager;
+        this.clients = new Map();
+    }
+    /**
+     * Register a WebSocket client connection
+     */
+    registerClient(connectionId, client) {
+        this.clients.set(connectionId, client);
+    }
+    /**
+     * Unregister a WebSocket client connection
+     */
+    unregisterClient(connectionId) {
+        this.clients.delete(connectionId);
+    }
+    /**
+     * Broadcast a change to all subscribed clients
+     */
+    async notifyChange(entity, operation, record, recordId, user, version) {
+        const subscriptions = this.subscriptionManager.getSubscriptionsForEntity(entity);
+        for (const subscription of subscriptions) {
+            // Check if user has access (basic check - should be extended with full access rules)
+            // For now, assume user can see their own data
+            if (subscription.userId !== user.id) {
+                // In production, would check RLS rules here
+                continue;
+            }
+            // Check if subscription filters match the record
+            if (!this.subscriptionManager.matchesFilter(subscription, record)) {
+                continue;
+            }
+            // Send change message to client
+            const message = {
+                type: 'change',
+                entity,
+                operation,
+                record: operation !== 'delete' ? record : undefined,
+                recordId,
+                timestamp: Date.now(),
+                version,
+            };
+            this.sendToConnection(subscription.subscriptionId, message);
+        }
+    }
+    /**
+     * Send a message to a specific connection
+     */
+    sendToConnection(subscriptionId, message) {
+        const subscription = this.subscriptionManager.getSubscription(subscriptionId);
+        if (!subscription)
+            return;
+        // Find the connection for this subscription
+        const subscriptions = this.subscriptionManager.getSubscriptionsForEntity(subscription.entity);
+        const matchingSub = subscriptions.find((s) => s.subscriptionId === subscriptionId);
+        if (!matchingSub)
+            return;
+        // This is a placeholder - in actual implementation, we'd need to track
+        // which connection ID corresponds to which subscription
+        // For now, we'll send to all connections and let them filter
+        this.broadcastToAll(message, [subscriptionId]);
+    }
+    /**
+     * Broadcast a message to all clients
+     */
+    broadcastToAll(message, filterSubscriptions) {
+        const messageStr = JSON.stringify(message);
+        for (const [connectionId, client] of this.clients.entries()) {
+            if (!client.isOpen()) {
+                this.unregisterClient(connectionId);
+                continue;
+            }
+            // If filter subscriptions provided, only send to relevant clients
+            if (filterSubscriptions) {
+                const subscriptions = this.subscriptionManager.getSubscriptionsForConnection(connectionId);
+                const hasMatchingSubscription = subscriptions.some((sub) => filterSubscriptions.includes(sub.subscriptionId));
+                if (!hasMatchingSubscription) {
+                    continue;
+                }
+            }
+            try {
+                client.send(messageStr);
+            }
+            catch (error) {
+                console.error(`Failed to send message to client ${connectionId}:`, error);
+                this.unregisterClient(connectionId);
+            }
+        }
+    }
+    /**
+     * Send heartbeat to all connected clients
+     */
+    sendHeartbeat() {
+        const heartbeatMsg = JSON.stringify({
+            type: 'heartbeat',
+            timestamp: Date.now(),
+        });
+        for (const [connectionId, client] of this.clients.entries()) {
+            if (!client.isOpen()) {
+                this.unregisterClient(connectionId);
+                continue;
+            }
+            try {
+                client.send(heartbeatMsg);
+            }
+            catch (error) {
+                console.error(`Failed to send heartbeat to client ${connectionId}:`, error);
+                this.unregisterClient(connectionId);
+            }
+        }
+    }
+    /**
+     * Send error message to a specific client
+     */
+    sendError(connectionId, code, message) {
+        const client = this.clients.get(connectionId);
+        if (!client || !client.isOpen()) {
+            return;
+        }
+        const errorMsg = JSON.stringify({
+            type: 'error',
+            code,
+            message,
+        });
+        try {
+            client.send(errorMsg);
+        }
+        catch (error) {
+            console.error(`Failed to send error to client ${connectionId}:`, error);
+            this.unregisterClient(connectionId);
+        }
+    }
+    /**
+     * Get connected clients count
+     */
+    getConnectedClientsCount() {
+        return this.clients.size;
+    }
+}
+//# sourceMappingURL=change-notifier.js.map

package/dist/core/src/realtime/change-notifier.js.map

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

package/dist/core/src/realtime/message-types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * WebSocket message types for real-time subscriptions
+ */
+export type SubscriptionMessage = SubscribeMessage | UnsubscribeMessage | ChangeMessage | ErrorMessage | HeartbeatMessage;
+export interface SubscribeMessage {
+    type: 'subscribe';
+    entity: string;
+    filters?: Record<string, unknown>;
+}
+export interface UnsubscribeMessage {
+    type: 'unsubscribe';
+    entity: string;
+}
+export interface ChangeMessage {
+    type: 'change';
+    entity: string;
+    operation: 'create' | 'update' | 'delete';
+    record?: Record<string, unknown>;
+    recordId?: string;
+    timestamp: number;
+    version?: number;
+}
+export interface ErrorMessage {
+    type: 'error';
+    code: string;
+    message: string;
+}
+export interface HeartbeatMessage {
+    type: 'heartbeat';
+    timestamp: number;
+}
+export interface SubscriptionState {
+    subscriptionId: string;
+    userId: string;
+    entity: string;
+    filters?: Record<string, unknown>;
+    createdAt: number;
+}
+//# sourceMappingURL=message-types.d.ts.map

package/dist/core/src/realtime/message-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-types.d.ts","sourceRoot":"","sources":["../../../../src/realtime/message-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,mBAAmB,GAC3B,gBAAgB,GAChB,kBAAkB,GAClB,aAAa,GACb,YAAY,GACZ,gBAAgB,CAAC;AAErB,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/core/src/realtime/message-types.js

@@ -0,0 +1,5 @@
+/**
+ * WebSocket message types for real-time subscriptions
+ */
+export {};
+//# sourceMappingURL=message-types.js.map

package/dist/core/src/realtime/message-types.js.map

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

package/dist/core/src/realtime/subscription-manager.d.ts

@@ -0,0 +1,67 @@
+import type { SyncDatabase } from '../sync/sync-engine';
+import type { SubscriptionState } from './message-types';
+/**
+ * Manages active WebSocket subscriptions
+ * Tracks which clients are subscribed to which entities and filters
+ */
+export declare class SubscriptionManager {
+    private db;
+    private subscriptions;
+    private userSubscriptions;
+    private entitySubscriptions;
+    private connectionSubscriptions;
+    constructor(db: SyncDatabase);
+    /**
+     * Create a new subscription
+     */
+    subscribe(userId: string, connectionId: string, entity: string, filters?: Record<string, unknown>): Promise<string>;
+    /**
+     * Remove a subscription
+     */
+    unsubscribe(subscriptionId: string): Promise<void>;
+    /**
+     * Remove all subscriptions for a connection
+     */
+    disconnectClient(connectionId: string): Promise<void>;
+    /**
+     * Get all subscriptions for an entity
+     */
+    getSubscriptionsForEntity(entity: string): SubscriptionState[];
+    /**
+     * Get all subscriptions for a user
+     */
+    getSubscriptionsForUser(userId: string): SubscriptionState[];
+    /**
+     * Get all subscriptions for a connection
+     */
+    getSubscriptionsForConnection(connectionId: string): SubscriptionState[];
+    /**
+     * Update last heartbeat for a subscription
+     */
+    updateHeartbeat(subscriptionId: string): Promise<void>;
+    /**
+     * Get subscription by ID
+     */
+    getSubscription(subscriptionId: string): SubscriptionState | undefined;
+    /**
+     * Check if a subscription matches a filter
+     */
+    matchesFilter(subscription: SubscriptionState, data: Record<string, unknown>): boolean;
+    /**
+     * Load subscriptions from database on startup
+     */
+    loadFromDatabase(): Promise<void>;
+    /**
+     * Cleanup expired subscriptions
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Get subscription statistics
+     */
+    getStats(): {
+        totalSubscriptions: number;
+        activeConnections: number;
+        entitiesWithSubscriptions: number;
+    };
+}
+//# sourceMappingURL=subscription-manager.d.ts.map

package/dist/core/src/realtime/subscription-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-manager.d.ts","sourceRoot":"","sources":["../../../../src/realtime/subscription-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD;;;GAGG;AACH,qBAAa,mBAAmB;IAMlB,OAAO,CAAC,EAAE;IALtB,OAAO,CAAC,aAAa,CAAwC;IAC7D,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,mBAAmB,CAAkC;IAC7D,OAAO,CAAC,uBAAuB,CAAkC;gBAE7C,EAAE,EAAE,YAAY;IAEpC;;OAEG;IACG,SAAS,CACb,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,MAAM,CAAC;IAqDlB;;OAEG;IACG,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBxD;;OAEG;IACG,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3D;;OAEG;IACH,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAS9D;;OAEG;IACH,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAS5D;;OAEG;IACH,6BAA6B,CAAC,YAAY,EAAE,MAAM,GAAG,iBAAiB,EAAE;IASxE;;OAEG;IACG,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5D;;OAEG;IACH,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAItE;;OAEG;IACH,aAAa,CAAC,YAAY,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAatF;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IA4DvC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB9B;;OAEG;IACH,QAAQ,IAAI;QACV,kBAAkB,EAAE,MAAM,CAAC;QAC3B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,yBAAyB,EAAE,MAAM,CAAC;KACnC;CAOF"}

package/dist/core/src/realtime/subscription-manager.js

@@ -0,0 +1,229 @@
+/**
+ * Manages active WebSocket subscriptions
+ * Tracks which clients are subscribed to which entities and filters
+ */
+export class SubscriptionManager {
+    constructor(db) {
+        this.db = db;
+        this.subscriptions = new Map();
+        this.userSubscriptions = new Map();
+        this.entitySubscriptions = new Map();
+        this.connectionSubscriptions = new Map();
+    }
+    /**
+     * Create a new subscription
+     */
+    async subscribe(userId, connectionId, entity, filters) {
+        const subscriptionId = `sub_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+        const now = Date.now();
+        const subscription = {
+            subscriptionId,
+            userId,
+            entity,
+            filters,
+            createdAt: now,
+        };
+        // Store in memory
+        this.subscriptions.set(subscriptionId, subscription);
+        // Update indexes
+        if (!this.userSubscriptions.has(userId)) {
+            this.userSubscriptions.set(userId, new Set());
+        }
+        this.userSubscriptions.get(userId).add(subscriptionId);
+        if (!this.entitySubscriptions.has(entity)) {
+            this.entitySubscriptions.set(entity, new Set());
+        }
+        this.entitySubscriptions.get(entity).add(subscriptionId);
+        if (!this.connectionSubscriptions.has(connectionId)) {
+            this.connectionSubscriptions.set(connectionId, new Set());
+        }
+        this.connectionSubscriptions.get(connectionId).add(subscriptionId);
+        // Persist to database
+        await this.db.run(`INSERT INTO subscriptions (id, user_id, entity, connection_id, created_at, last_heartbeat)
+       VALUES (?, ?, ?, ?, ?, ?)`, [subscriptionId, userId, entity, connectionId, now, now]);
+        // Store filters if provided
+        if (filters) {
+            for (const [key, value] of Object.entries(filters)) {
+                const filterId = `filter_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+                await this.db.run(`INSERT INTO subscription_filters (id, subscription_id, filter_key, filter_value, created_at)
+           VALUES (?, ?, ?, ?, ?)`, [filterId, subscriptionId, key, JSON.stringify(value), now]);
+            }
+        }
+        return subscriptionId;
+    }
+    /**
+     * Remove a subscription
+     */
+    async unsubscribe(subscriptionId) {
+        const subscription = this.subscriptions.get(subscriptionId);
+        if (!subscription)
+            return;
+        // Remove from memory
+        this.subscriptions.delete(subscriptionId);
+        // Update indexes
+        this.userSubscriptions.get(subscription.userId)?.delete(subscriptionId);
+        this.entitySubscriptions.get(subscription.entity)?.delete(subscriptionId);
+        // Find and update connection subscriptions
+        for (const [connId, subs] of this.connectionSubscriptions.entries()) {
+            if (subs.has(subscriptionId)) {
+                subs.delete(subscriptionId);
+                if (subs.size === 0) {
+                    this.connectionSubscriptions.delete(connId);
+                }
+            }
+        }
+        // Remove from database
+        await this.db.run('DELETE FROM subscriptions WHERE id = ?', [subscriptionId]);
+    }
+    /**
+     * Remove all subscriptions for a connection
+     */
+    async disconnectClient(connectionId) {
+        const subscriptionIds = this.connectionSubscriptions.get(connectionId);
+        if (!subscriptionIds)
+            return;
+        for (const subId of subscriptionIds) {
+            await this.unsubscribe(subId);
+        }
+    }
+    /**
+     * Get all subscriptions for an entity
+     */
+    getSubscriptionsForEntity(entity) {
+        const subscriptionIds = this.entitySubscriptions.get(entity);
+        if (!subscriptionIds)
+            return [];
+        return Array.from(subscriptionIds)
+            .map((id) => this.subscriptions.get(id))
+            .filter((sub) => sub !== undefined);
+    }
+    /**
+     * Get all subscriptions for a user
+     */
+    getSubscriptionsForUser(userId) {
+        const subscriptionIds = this.userSubscriptions.get(userId);
+        if (!subscriptionIds)
+            return [];
+        return Array.from(subscriptionIds)
+            .map((id) => this.subscriptions.get(id))
+            .filter((sub) => sub !== undefined);
+    }
+    /**
+     * Get all subscriptions for a connection
+     */
+    getSubscriptionsForConnection(connectionId) {
+        const subscriptionIds = this.connectionSubscriptions.get(connectionId);
+        if (!subscriptionIds)
+            return [];
+        return Array.from(subscriptionIds)
+            .map((id) => this.subscriptions.get(id))
+            .filter((sub) => sub !== undefined);
+    }
+    /**
+     * Update last heartbeat for a subscription
+     */
+    async updateHeartbeat(subscriptionId) {
+        const subscription = this.subscriptions.get(subscriptionId);
+        if (!subscription)
+            return;
+        const now = Date.now();
+        subscription.createdAt = now; // Update in-memory
+        await this.db.run('UPDATE subscriptions SET last_heartbeat = ? WHERE id = ?', [now, subscriptionId]);
+    }
+    /**
+     * Get subscription by ID
+     */
+    getSubscription(subscriptionId) {
+        return this.subscriptions.get(subscriptionId);
+    }
+    /**
+     * Check if a subscription matches a filter
+     */
+    matchesFilter(subscription, data) {
+        if (!subscription.filters)
+            return true;
+        for (const [key, filterValue] of Object.entries(subscription.filters)) {
+            const dataValue = data[key];
+            if (dataValue !== filterValue) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Load subscriptions from database on startup
+     */
+    async loadFromDatabase() {
+        try {
+            const results = await this.db.getAll(`SELECT id, user_id, entity, connection_id, created_at
+         FROM subscriptions
+         WHERE last_heartbeat > ?`, [Date.now() - 3600000] // Only load subscriptions from last hour
+            );
+            for (const row of results) {
+                const subscriptionId = row.id;
+                const userId = row.user_id;
+                const entity = row.entity;
+                const connectionId = row.connection_id;
+                const createdAt = row.created_at;
+                // Load filters for this subscription
+                const filterResults = await this.db.getAll('SELECT filter_key, filter_value FROM subscription_filters WHERE subscription_id = ?', [subscriptionId]);
+                const filters = {};
+                for (const filterRow of filterResults) {
+                    const key = filterRow.filter_key;
+                    const value = JSON.parse(filterRow.filter_value);
+                    filters[key] = value;
+                }
+                const subscription = {
+                    subscriptionId,
+                    userId,
+                    entity,
+                    filters: Object.keys(filters).length > 0 ? filters : undefined,
+                    createdAt,
+                };
+                this.subscriptions.set(subscriptionId, subscription);
+                // Update indexes
+                if (!this.userSubscriptions.has(userId)) {
+                    this.userSubscriptions.set(userId, new Set());
+                }
+                this.userSubscriptions.get(userId).add(subscriptionId);
+                if (!this.entitySubscriptions.has(entity)) {
+                    this.entitySubscriptions.set(entity, new Set());
+                }
+                this.entitySubscriptions.get(entity).add(subscriptionId);
+                if (!this.connectionSubscriptions.has(connectionId)) {
+                    this.connectionSubscriptions.set(connectionId, new Set());
+                }
+                this.connectionSubscriptions.get(connectionId).add(subscriptionId);
+            }
+        }
+        catch (error) {
+            console.error('Failed to load subscriptions from database:', error);
+        }
+    }
+    /**
+     * Cleanup expired subscriptions
+     */
+    async cleanup() {
+        const oneDayAgo = Date.now() - 86400000;
+        // Delete old subscriptions from database
+        await this.db.run('DELETE FROM subscriptions WHERE last_heartbeat < ?', [oneDayAgo]);
+        // Remove disconnected subscriptions from memory
+        const staleSubscriptions = Array.from(this.subscriptions.entries())
+            .filter(([_, sub]) => sub.createdAt < oneDayAgo)
+            .map(([id]) => id);
+        for (const subId of staleSubscriptions) {
+            this.subscriptions.delete(subId);
+        }
+    }
+    /**
+     * Get subscription statistics
+     */
+    getStats() {
+        return {
+            totalSubscriptions: this.subscriptions.size,
+            activeConnections: this.connectionSubscriptions.size,
+            entitiesWithSubscriptions: this.entitySubscriptions.size,
+        };
+    }
+}
+//# sourceMappingURL=subscription-manager.js.map

package/dist/core/src/realtime/subscription-manager.js.map

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

package/dist/core/src/search/search-manager.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Full-text search manager using SQLite FTS5
+ * Handles search index creation, updating, and querying
+ */
+export interface SearchIndex {
+    entity: string;
+    columns: string[];
+    tokenize?: string;
+    prefix?: number[];
+    contentless?: boolean;
+}
+export interface SearchQuery {
+    entity: string;
+    query: string;
+    columns?: string[];
+    limit?: number;
+    offset?: number;
+    highlight?: boolean;
+    rank?: boolean;
+}
+export interface SearchResult {
+    id: string;
+    rank?: number;
+    snippet?: string;
+    [key: string]: any;
+}
+export interface SearchResponse {
+    results: SearchResult[];
+    total: number;
+    hasMore: boolean;
+}
+export interface SearchDatabase {
+    run(sql: string, params: any[]): Promise<any>;
+    getOne(sql: string, params: any[]): Promise<any>;
+    getAll(sql: string, params: any[]): Promise<any[]>;
+}
+/**
+ * Search manager for full-text search
+ */
+export declare class SearchManager {
+    private db;
+    private indexes;
+    constructor(db: SearchDatabase);
+    /**
+     * Register a search index for an entity
+     */
+    registerIndex(index: SearchIndex): void;
+    /**
+     * Create FTS5 virtual table for an entity
+     */
+    createSearchIndex(entity: string): Promise<void>;
+    /**
+     * Create triggers to automatically update FTS index
+     */
+    private createSyncTriggers;
+    /**
+     * Rebuild search index from scratch
+     */
+    rebuildIndex(entity: string): Promise<number>;
+    /**
+     * Search for records
+     */
+    search(query: SearchQuery): Promise<SearchResponse>;
+    /**
+     * Build FTS5 query string from user query
+     */
+    private buildFTSQuery;
+    /**
+     * Delete search index
+     */
+    deleteSearchIndex(entity: string): Promise<void>;
+    /**
+     * Optimize search index (FTS5 optimize)
+     */
+    optimizeIndex(entity: string): Promise<void>;
+    /**
+     * Get search index statistics
+     */
+    getIndexStats(entity: string): Promise<{
+        entity: string;
+        documentCount: number;
+        indexSize: number;
+    }>;
+    /**
+     * Get all registered indexes
+     */
+    getRegisteredIndexes(): SearchIndex[];
+    /**
+     * Check if an entity has a search index
+     */
+    hasIndex(entity: string): boolean;
+}
+//# sourceMappingURL=search-manager.d.ts.map