@quereus/sync-coordinator 0.3.5 → 0.3.7

package/dist/src/service/index.js

@@ -0,0 +1,7 @@
+/**
+ * Service layer exports.
+ */
+export { CoordinatorService, } from './coordinator-service.js';
+export { StoreManager, } from './store-manager.js';
+export { isValidDatabaseId, parseDatabaseId, formatDatabaseId, } from './database-ids.js';
+//# sourceMappingURL=index.js.map

package/dist/src/service/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/service/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,OAAO,EACL,kBAAkB,GAEnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,YAAY,GAGb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,gBAAgB,GACjB,MAAM,mBAAmB,CAAC"}

package/dist/src/service/store-manager.d.ts

@@ -0,0 +1,85 @@
+/**
+ * StoreManager - Multi-tenant LevelDB store management
+ *
+ * Manages lazy loading and cleanup of per-database LevelDB stores.
+ * Each database gets its own isolated store, opened on-demand and
+ * closed after idle timeout.
+ */
+import { StoreEventEmitter } from '@quereus/store';
+import { LevelDBStore } from '@quereus/plugin-leveldb';
+import { type SyncManager } from '@quereus/sync';
+export interface StoreEntry {
+    databaseId: string;
+    store: LevelDBStore;
+    syncManager: SyncManager;
+    storeEvents: StoreEventEmitter;
+    refCount: number;
+    lastAccess: number;
+}
+export interface StoreManagerConfig {
+    /** Base directory for all database stores */
+    dataDir: string;
+    /** Maximum number of stores to keep open (LRU eviction) */
+    maxOpenStores: number;
+    /** Idle timeout in ms before closing a store with refCount=0 */
+    idleTimeoutMs: number;
+    /** Interval for cleanup checks */
+    cleanupIntervalMs: number;
+    /** Sync config passed to createSyncModule */
+    syncConfig?: {
+        tombstoneTTL?: number;
+        batchSize?: number;
+    };
+}
+/**
+ * Manages multiple LevelDB stores for multi-tenant sync.
+ */
+export declare class StoreManager {
+    private readonly config;
+    private readonly stores;
+    private cleanupTimer;
+    private shutdownPromise;
+    constructor(config?: Partial<StoreManagerConfig>);
+    /**
+     * Start the store manager (begins cleanup interval).
+     */
+    start(): void;
+    /**
+     * Get or open a store for a database. Increments refCount.
+     */
+    acquire(databaseId: string): Promise<StoreEntry>;
+    /**
+     * Release a store reference. Decrements refCount.
+     */
+    release(databaseId: string): void;
+    /**
+     * Check if a store is currently open.
+     */
+    isOpen(databaseId: string): boolean;
+    /**
+     * Get an open store without acquiring (for read-only checks).
+     */
+    get(databaseId: string): StoreEntry | undefined;
+    /**
+     * Get count of open stores.
+     */
+    get openCount(): number;
+    /**
+     * Shutdown all stores.
+     */
+    shutdown(): Promise<void>;
+    private openStore;
+    /**
+     * Cleanup idle stores with refCount=0 past timeout.
+     */
+    private cleanup;
+    /**
+     * Evict least recently used store (with refCount=0).
+     */
+    private evictLRU;
+    /**
+     * Close a specific store.
+     */
+    private closeStore;
+}
+//# sourceMappingURL=store-manager.d.ts.map

package/dist/src/service/store-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-manager.d.ts","sourceRoot":"","sources":["../../../src/service/store-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,eAAe,CAAC;AAIvB,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,6CAA6C;IAC7C,UAAU,CAAC,EAAE;QACX,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AASD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IACxD,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,eAAe,CAA8B;gBAEzC,MAAM,GAAE,OAAO,CAAC,kBAAkB,CAAM;IAIpD;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAsBtD;;OAEG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IASjC;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAInC;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI/C;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YA0BjB,SAAS;IA2BvB;;OAEG;YACW,OAAO;IAmBrB;;OAEG;YACW,QAAQ;IAoBtB;;OAEG;YACW,UAAU;CAYzB"}

package/dist/src/service/store-manager.js

@@ -0,0 +1,194 @@
+/**
+ * StoreManager - Multi-tenant LevelDB store management
+ *
+ * Manages lazy loading and cleanup of per-database LevelDB stores.
+ * Each database gets its own isolated store, opened on-demand and
+ * closed after idle timeout.
+ */
+import { join } from 'node:path';
+import { StoreEventEmitter } from '@quereus/store';
+import { LevelDBStore } from '@quereus/plugin-leveldb';
+import { createSyncModule, } from '@quereus/sync';
+import { serviceLog } from '../common/logger.js';
+import { getDatabaseStoragePath, parseDatabaseId } from './database-ids.js';
+const DEFAULT_CONFIG = {
+    dataDir: './data',
+    maxOpenStores: 100,
+    idleTimeoutMs: 5 * 60 * 1000, // 5 minutes
+    cleanupIntervalMs: 30 * 1000, // 30 seconds
+};
+/**
+ * Manages multiple LevelDB stores for multi-tenant sync.
+ */
+export class StoreManager {
+    config;
+    stores = new Map();
+    cleanupTimer = null;
+    shutdownPromise = null;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Start the store manager (begins cleanup interval).
+     */
+    start() {
+        if (this.cleanupTimer)
+            return;
+        this.cleanupTimer = setInterval(() => this.cleanup(), this.config.cleanupIntervalMs);
+        serviceLog('StoreManager started with dataDir: %s', this.config.dataDir);
+    }
+    /**
+     * Get or open a store for a database. Increments refCount.
+     */
+    async acquire(databaseId) {
+        // Check if already open
+        let entry = this.stores.get(databaseId);
+        if (entry) {
+            entry.refCount++;
+            entry.lastAccess = Date.now();
+            serviceLog('Store acquired (cached): %s, refCount=%d', databaseId, entry.refCount);
+            return entry;
+        }
+        // Check if we need to evict before opening new
+        if (this.stores.size >= this.config.maxOpenStores) {
+            await this.evictLRU();
+        }
+        // Open new store
+        entry = await this.openStore(databaseId);
+        this.stores.set(databaseId, entry);
+        serviceLog('Store acquired (opened): %s', databaseId);
+        return entry;
+    }
+    /**
+     * Release a store reference. Decrements refCount.
+     */
+    release(databaseId) {
+        const entry = this.stores.get(databaseId);
+        if (!entry)
+            return;
+        entry.refCount = Math.max(0, entry.refCount - 1);
+        entry.lastAccess = Date.now();
+        serviceLog('Store released: %s, refCount=%d', databaseId, entry.refCount);
+    }
+    /**
+     * Check if a store is currently open.
+     */
+    isOpen(databaseId) {
+        return this.stores.has(databaseId);
+    }
+    /**
+     * Get an open store without acquiring (for read-only checks).
+     */
+    get(databaseId) {
+        return this.stores.get(databaseId);
+    }
+    /**
+     * Get count of open stores.
+     */
+    get openCount() {
+        return this.stores.size;
+    }
+    /**
+     * Shutdown all stores.
+     */
+    async shutdown() {
+        if (this.shutdownPromise)
+            return this.shutdownPromise;
+        this.shutdownPromise = (async () => {
+            if (this.cleanupTimer) {
+                clearInterval(this.cleanupTimer);
+                this.cleanupTimer = null;
+            }
+            const closePromises = Array.from(this.stores.entries()).map(async ([id, entry]) => {
+                try {
+                    await entry.store.close();
+                    serviceLog('Store closed: %s', id);
+                }
+                catch (err) {
+                    serviceLog('Error closing store %s: %O', id, err);
+                }
+            });
+            await Promise.all(closePromises);
+            this.stores.clear();
+            serviceLog('StoreManager shutdown complete');
+        })();
+        return this.shutdownPromise;
+    }
+    async openStore(databaseId) {
+        // Validate database ID format
+        parseDatabaseId(databaseId);
+        const storagePath = getDatabaseStoragePath(databaseId);
+        const fullPath = join(this.config.dataDir, storagePath);
+        serviceLog('Opening store at: %s', fullPath);
+        const store = await LevelDBStore.open({
+            path: fullPath,
+            createIfMissing: true,
+        });
+        const storeEvents = new StoreEventEmitter();
+        const { syncManager } = await createSyncModule(store, storeEvents, this.config.syncConfig);
+        return {
+            databaseId,
+            store,
+            syncManager,
+            storeEvents,
+            refCount: 1,
+            lastAccess: Date.now(),
+        };
+    }
+    /**
+     * Cleanup idle stores with refCount=0 past timeout.
+     */
+    async cleanup() {
+        const now = Date.now();
+        const toClose = [];
+        for (const [id, entry] of this.stores) {
+            if (entry.refCount === 0 && now - entry.lastAccess > this.config.idleTimeoutMs) {
+                toClose.push(id);
+            }
+        }
+        for (const id of toClose) {
+            await this.closeStore(id);
+        }
+        if (toClose.length > 0) {
+            serviceLog('Cleanup: closed %d idle stores', toClose.length);
+        }
+    }
+    /**
+     * Evict least recently used store (with refCount=0).
+     */
+    async evictLRU() {
+        let oldest = null;
+        for (const [id, entry] of this.stores) {
+            // Only evict stores with no active references
+            if (entry.refCount === 0) {
+                if (!oldest || entry.lastAccess < oldest.lastAccess) {
+                    oldest = { id, lastAccess: entry.lastAccess };
+                }
+            }
+        }
+        if (oldest) {
+            await this.closeStore(oldest.id);
+            serviceLog('Evicted LRU store: %s', oldest.id);
+        }
+        else {
+            serviceLog('Warning: Cannot evict, all stores have active references');
+        }
+    }
+    /**
+     * Close a specific store.
+     */
+    async closeStore(databaseId) {
+        const entry = this.stores.get(databaseId);
+        if (!entry)
+            return;
+        try {
+            await entry.store.close();
+            this.stores.delete(databaseId);
+            serviceLog('Store closed: %s', databaseId);
+        }
+        catch (err) {
+            serviceLog('Error closing store %s: %O', databaseId, err);
+        }
+    }
+}
+//# sourceMappingURL=store-manager.js.map

package/dist/src/service/store-manager.js.map

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

package/dist/src/service/types.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Service layer types - hooks, sessions, and operations.
+ */
+import type { WebSocket } from 'ws';
+import type { FastifyRequest } from 'fastify';
+import type { SiteId, HLC, ChangeSet, ApplyResult } from '@quereus/sync';
+/**
+ * Authenticated client identity.
+ * Extend this interface for custom auth data.
+ */
+export interface ClientIdentity {
+    /** Client's site ID for sync */
+    siteId: SiteId;
+    /** Optional user ID from authentication */
+    userId?: string;
+    /** Optional additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Active WebSocket client session.
+ */
+export interface ClientSession {
+    /** Unique connection identifier */
+    connectionId: string;
+    /** Database ID for multi-tenant routing (e.g., 'a1-s42') */
+    databaseId: string;
+    /** Client's replica site ID */
+    siteId: SiteId;
+    /** Authenticated identity */
+    identity: ClientIdentity;
+    /** Last HLC client synced to */
+    lastSyncHLC: HLC | undefined;
+    /** Connection timestamp */
+    connectedAt: number;
+    /** The WebSocket connection */
+    socket: WebSocket;
+}
+/**
+ * Context provided to authentication hook.
+ */
+export interface AuthContext {
+    /** Database ID for multi-tenant routing (e.g., 'a1-s42') */
+    databaseId: string;
+    /** Authorization header value */
+    token?: string;
+    /** Client-provided site ID */
+    siteId?: SiteId;
+    /** Raw site ID string from header */
+    siteIdRaw?: string;
+    /** Original HTTP request (if available) */
+    request?: FastifyRequest;
+    /** WebSocket connection (if WebSocket auth) */
+    socket?: WebSocket;
+}
+/**
+ * Sync operations that can be authorized.
+ */
+export type SyncOperation = {
+    type: 'get_changes';
+    sinceHLC?: HLC;
+} | {
+    type: 'apply_changes';
+    changeCount: number;
+} | {
+    type: 'get_snapshot';
+} | {
+    type: 'resume_snapshot';
+};
+/**
+ * A change that was rejected during validation.
+ */
+export interface RejectedChange {
+    /** The rejected change */
+    change: ChangeSet;
+    /** Reason for rejection */
+    reason: string;
+    /** Error code for programmatic handling */
+    code?: string;
+}
+/**
+ * Result of change validation.
+ */
+export interface ValidationResult {
+    /** Changes approved for application */
+    approved: ChangeSet[];
+    /** Changes that were rejected */
+    rejected: RejectedChange[];
+}
+/**
+ * Coordinator service hooks for customization.
+ * All hooks are optional; defaults allow all operations.
+ */
+export interface CoordinatorHooks {
+    /**
+     * Authenticate an incoming request/connection.
+     * Called before any sync operation.
+     *
+     * @param context - Auth context with token and request info
+     * @returns Client identity on success
+     * @throws Error to reject authentication
+     */
+    onAuthenticate?(context: AuthContext): Promise<ClientIdentity>;
+    /**
+     * Authorize a specific operation for a client.
+     * Called after authentication, before executing the operation.
+     *
+     * @param client - Authenticated client identity
+     * @param operation - The operation being requested
+     * @returns true to allow, false to deny
+     */
+    onAuthorize?(client: ClientIdentity, operation: SyncOperation): Promise<boolean>;
+    /**
+     * Validate changes before applying them.
+     * Can modify, filter, or reject changes.
+     *
+     * @param client - Authenticated client identity
+     * @param changes - Changes to validate
+     * @returns Approved and rejected changes
+     */
+    onBeforeApplyChanges?(client: ClientIdentity, changes: ChangeSet[]): Promise<ValidationResult>;
+    /**
+     * Called after changes are successfully applied.
+     * Useful for logging, metrics, or triggering side effects.
+     *
+     * @param client - Authenticated client identity
+     * @param changes - Changes that were applied
+     * @param result - Result of the apply operation
+     */
+    onAfterApplyChanges?(client: ClientIdentity, changes: ChangeSet[], result: ApplyResult): void;
+    /**
+     * Called when a WebSocket client connects.
+     * Return false to reject the connection.
+     *
+     * @param client - Authenticated client identity
+     * @param socket - The WebSocket connection
+     * @returns true to accept, false to reject
+     */
+    onClientConnect?(client: ClientIdentity, socket: WebSocket): Promise<boolean>;
+    /**
+     * Called when a WebSocket client disconnects.
+     *
+     * @param client - Client identity of disconnected client
+     */
+    onClientDisconnect?(client: ClientIdentity): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/service/types.d.ts.map

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

package/dist/src/service/types.js

@@ -0,0 +1,5 @@
+/**
+ * Service layer types - hooks, sessions, and operations.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/service/types.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quereus/sync-coordinator",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "type": "module",
   "description": "Standalone coordinator backend for Quereus Sync - production-ready sync server",
   "keywords": [
@@ -45,9 +45,10 @@
   "dependencies": {
     "@fastify/cors": "^10.0.2",
     "@fastify/websocket": "^11.0.2",
-    "@quereus/plugin-store": "*",
-    "@quereus/plugin-sync": "*",
+    "@quereus/plugin-leveldb": "workspace:^",
     "@quereus/quereus": "*",
+    "@quereus/store": "*",
+    "@quereus/sync": "*",
     "commander": "^14.0.0",
     "debug": "^4.4.0",
     "fastify": "^5.2.1"