@quereus/sync-coordinator 0.5.0 → 0.6.0

package/package.json

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

package/dist/src/service/database-ids.d.ts

@@ -1,64 +0,0 @@
-/**
- * Database ID utilities for multi-tenant sync
- *
- * NOTE: This is an application-specific format used by the quoomb app.
- * Other applications can provide their own database ID format and validation
- * via the StoreManagerHooks interface. These utilities are exported as
- * examples and can be used directly if the format fits your needs.
- *
- * Database ID format: {accountId}-{dbType}{dbNum}
- * - accountId: Short system-assigned ID (e.g., 'a1', 'b7', 'z42', 'local')
- * - dbType: 's' for scenario, 'd' for dynamics, 'a' for account
- * - dbNum: Short numeric ID scoped under account (e.g., '1', '42')
- *
- * Examples:
- * - 'local-s1' = local account's scenario 1
- * - 'a1-s1' = account a1's scenario 1
- * - 'a1-d1' = account a1's dynamics 1 (same site as s1)
- * - 'a1-acc' = account a1's account database
- * - 'b7-s42' = account b7's scenario 42
- */
-/**
- * Parse a database ID into its components.
- */
-export interface ParsedDatabaseId {
-    accountId: string;
-    dbType: 'scenario' | 'dynamics' | 'account';
-    dbNum?: number;
-}
-/**
- * Parse a database ID string.
- * @throws if the format is invalid
- */
-export declare function parseDatabaseId(databaseId: string): ParsedDatabaseId;
-/**
- * Format a database ID from components.
- */
-export declare function formatDatabaseId(accountId: string, dbType: 'scenario' | 'dynamics' | 'account', dbNum?: number): string;
-/**
- * Encode a number as a short base62 string.
- * e.g., 0 -> 'a', 61 -> '9', 62 -> 'ba'
- */
-export declare function numberToBase62(num: number): string;
-/**
- * Decode a base62 string to a number.
- */
-export declare function base62ToNumber(str: string): number;
-/**
- * Generate a short account ID.
- * Format: single letter prefix + base62 number
- * e.g., 'a1', 'a42', 'b1', 'z999'
- *
- * The counter should be stored and incremented by the coordinator.
- */
-export declare function generateAccountId(counter: number): string;
-/**
- * Get storage path for a database.
- * Returns the directory path relative to the data root.
- */
-export declare function getDatabaseStoragePath(databaseId: string): string;
-/**
- * Validate a database ID format.
- */
-export declare function isValidDatabaseId(databaseId: string): boolean;
-//# sourceMappingURL=database-ids.d.ts.map

package/dist/src/service/database-ids.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"database-ids.d.ts","sourceRoot":"","sources":["../../../src/service/database-ids.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAmCpE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,EAC3C,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CASR;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAUlD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQlD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOzD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAIjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAO7D"}

package/dist/src/service/database-ids.js

@@ -1,134 +0,0 @@
-/**
- * Database ID utilities for multi-tenant sync
- *
- * NOTE: This is an application-specific format used by the quoomb app.
- * Other applications can provide their own database ID format and validation
- * via the StoreManagerHooks interface. These utilities are exported as
- * examples and can be used directly if the format fits your needs.
- *
- * Database ID format: {accountId}-{dbType}{dbNum}
- * - accountId: Short system-assigned ID (e.g., 'a1', 'b7', 'z42', 'local')
- * - dbType: 's' for scenario, 'd' for dynamics, 'a' for account
- * - dbNum: Short numeric ID scoped under account (e.g., '1', '42')
- *
- * Examples:
- * - 'local-s1' = local account's scenario 1
- * - 'a1-s1' = account a1's scenario 1
- * - 'a1-d1' = account a1's dynamics 1 (same site as s1)
- * - 'a1-acc' = account a1's account database
- * - 'b7-s42' = account b7's scenario 42
- */
-// Base62 alphabet for short IDs (lowercase first for nicer URLs)
-const BASE62 = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
-/**
- * Parse a database ID string.
- * @throws if the format is invalid
- */
-export function parseDatabaseId(databaseId) {
-    const parts = databaseId.split('-');
-    if (parts.length !== 2) {
-        throw new Error(`Invalid database ID format: ${databaseId}`);
-    }
-    const [accountId, dbPart] = parts;
-    if (!accountId || accountId.length === 0) {
-        throw new Error(`Invalid account ID in database ID: ${databaseId}`);
-    }
-    // Account database: "acc"
-    if (dbPart === 'acc') {
-        return { accountId, dbType: 'account' };
-    }
-    // Scenario or dynamics: "s1", "d42", etc.
-    const typeChar = dbPart[0];
-    const numStr = dbPart.slice(1);
-    if (typeChar !== 's' && typeChar !== 'd') {
-        throw new Error(`Invalid database type in database ID: ${databaseId}`);
-    }
-    const dbNum = parseInt(numStr, 10);
-    if (isNaN(dbNum) || dbNum < 1) {
-        throw new Error(`Invalid database number in database ID: ${databaseId}`);
-    }
-    return {
-        accountId,
-        dbType: typeChar === 's' ? 'scenario' : 'dynamics',
-        dbNum,
-    };
-}
-/**
- * Format a database ID from components.
- */
-export function formatDatabaseId(accountId, dbType, dbNum) {
-    if (dbType === 'account') {
-        return `${accountId}-acc`;
-    }
-    if (dbNum === undefined) {
-        throw new Error(`dbNum required for ${dbType} database`);
-    }
-    const typeChar = dbType === 'scenario' ? 's' : 'd';
-    return `${accountId}-${typeChar}${dbNum}`;
-}
-/**
- * Encode a number as a short base62 string.
- * e.g., 0 -> 'a', 61 -> '9', 62 -> 'ba'
- */
-export function numberToBase62(num) {
-    if (num < 0)
-        throw new Error('Number must be non-negative');
-    if (num === 0)
-        return BASE62[0];
-    let result = '';
-    while (num > 0) {
-        result = BASE62[num % 62] + result;
-        num = Math.floor(num / 62);
-    }
-    return result;
-}
-/**
- * Decode a base62 string to a number.
- */
-export function base62ToNumber(str) {
-    let num = 0;
-    for (const char of str) {
-        const idx = BASE62.indexOf(char);
-        if (idx === -1)
-            throw new Error(`Invalid base62 character: ${char}`);
-        num = num * 62 + idx;
-    }
-    return num;
-}
-/**
- * Generate a short account ID.
- * Format: single letter prefix + base62 number
- * e.g., 'a1', 'a42', 'b1', 'z999'
- *
- * The counter should be stored and incremented by the coordinator.
- */
-export function generateAccountId(counter) {
-    // Use lowercase letter prefix (a-z) based on counter / 1000
-    // This gives us 26,000 accounts per letter, expandable
-    const prefixIdx = Math.floor(counter / 1000) % 26;
-    const prefix = String.fromCharCode(97 + prefixIdx); // 'a' = 97
-    const suffix = counter % 1000;
-    return `${prefix}${suffix + 1}`; // +1 to make it 1-based
-}
-/**
- * Get storage path for a database.
- * Returns the directory path relative to the data root.
- */
-export function getDatabaseStoragePath(databaseId) {
-    const parsed = parseDatabaseId(databaseId);
-    // Store under account ID directory
-    return `${parsed.accountId}/${databaseId}`;
-}
-/**
- * Validate a database ID format.
- */
-export function isValidDatabaseId(databaseId) {
-    try {
-        parseDatabaseId(databaseId);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-//# sourceMappingURL=database-ids.js.map

package/dist/src/service/database-ids.js.map

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