@feltdb/core 0.4.13 → 0.4.15

package/dist/cli/commands.js

@@ -4,10 +4,10 @@
 import fs from 'fs';
 import path from 'path';
 import http from 'http';
+import net from 'net';
 import { createRequire } from 'module';
 import { spawn, spawnSync } from 'child_process';
 import { createFeltDB, diffFlowSpec, formatFlowSpec, parseFlowSpec, planFlowSpecMigration, validateFlowSpec } from '@feltdb/core';
-const RELEASE_VERSION = '0.4.13';
 function loadProjectEnvironment(file = path.resolve('.env.local')) {
     if (!fs.existsSync(file))
         return;
@@ -24,6 +24,19 @@ function loadProjectEnvironment(file = path.resolve('.env.local')) {
             process.env[key] = value;
     }
 }
+async function availablePort(preferred, host = '127.0.0.1') {
+    for (let port = preferred; port < preferred + 100; port += 1) {
+        const available = await new Promise(resolve => {
+            const server = net.createServer();
+            server.unref();
+            server.once('error', () => resolve(false));
+            server.listen(port, host, () => server.close(() => resolve(true)));
+        });
+        if (available)
+            return port;
+    }
+    throw new Error(`No available port found between ${preferred} and ${preferred + 99}`);
+}
 export async function handleCommand(command, args) {
     switch (command) {
         case 'studio':
@@ -387,35 +400,36 @@ async function handleDev(args) {
     const runtimeNamespace = config.runtime === 'managed'
         ? process.env.VITE_FELTDB_MANAGED_NAMESPACE || config.namespace
         : config.namespace;
-    const appPort = args.includes('--port') ? args[args.indexOf('--port') + 1] || '5173' : '5173';
-    const studioPort = args.includes('--studio-port') ? args[args.indexOf('--studio-port') + 1] || '3000' : '3000';
-    let selfHosted;
+    const requestedAppPort = Number(args.includes('--port') ? args[args.indexOf('--port') + 1] || '5173' : '5173');
+    const requestedStudioPort = Number(args.includes('--studio-port') ? args[args.indexOf('--studio-port') + 1] || '3000' : '3000');
+    const appPort = String(await availablePort(requestedAppPort));
+    const studioPort = String(await availablePort(requestedStudioPort));
+    if (appPort !== String(requestedAppPort))
+        console.log(`Port ${requestedAppPort} is busy; using ${appPort} for the application.`);
+    if (studioPort !== String(requestedStudioPort))
+        console.log(`Port ${requestedStudioPort} is busy; using ${studioPort} for Studio.`);
+    process.env.APP_PORT = appPort;
+    process.env.STUDIO_PORT = studioPort;
+    let selfHostedStarted = false;
     const stopSelfHosted = () => {
-        if (selfHosted && !selfHosted.killed)
-            selfHosted.kill('SIGTERM');
+        if (selfHostedStarted) {
+            spawnSync('docker', ['compose', 'stop', 'feltdb'], { cwd: process.cwd(), stdio: 'ignore' });
+            selfHostedStarted = false;
+        }
     };
     if (config.runtime === 'self-hosted') {
         const docker = spawnSync('docker', ['version'], { stdio: 'ignore' });
         if (docker.status !== 0) {
             throw new Error('Self-hosted development requires Docker Desktop or Docker Engine. Install Docker, start it, and rerun npm run dev.');
         }
-        const containerName = `feltdb-${String(config.namespace || 'app').replace(/[^a-z0-9_.-]/gi, '-').toLowerCase()}`;
-        const image = process.env.FELTDB_IMAGE || `ghcr.io/rkendel1/feltdb:${RELEASE_VERSION}`;
-        const existing = spawnSync('docker', ['rm', '-f', containerName], { stdio: 'ignore' });
-        void existing;
-        console.log(`Starting self-hosted FeltDB server from ${image}...`);
-        selfHosted = spawn('docker', [
-            'run', '--rm', '--name', containerName,
-            '-p', '7700:8080',
-            '-v', `${containerName}-data:/data`,
-            image,
-            '--allow-origin', `http://127.0.0.1:${appPort}`,
-            '--allow-origin', `http://127.0.0.1:${studioPort}`,
-        ], { stdio: 'inherit' });
-        selfHosted.once('exit', code => {
-            if (code && code !== 0)
-                console.error(`Self-hosted FeltDB server exited with status ${code}`);
-        });
+        if (!fs.existsSync(path.join(process.cwd(), 'docker-compose.yml'))) {
+            throw new Error('Self-hosted project is missing docker-compose.yml. Regenerate the project with create-feltdb.');
+        }
+        console.log('Building and starting the generated self-hosted FeltDB service...');
+        const compose = spawnSync('docker', ['compose', 'up', '--build', '--detach', 'feltdb'], { cwd: process.cwd(), stdio: 'inherit' });
+        if (compose.status !== 0)
+            throw new Error(`docker compose failed with status ${compose.status ?? 'unknown'}`);
+        selfHostedStarted = true;
         (_c = process.env).VITE_FELTDB_URL || (_c.VITE_FELTDB_URL = 'http://127.0.0.1:7700');
     }
     console.log('FeltDB Dev Server');
@@ -426,7 +440,7 @@ async function handleDev(args) {
     const open = !args.includes('--no-open');
     console.log(`Application: http://127.0.0.1:${appPort}`);
     console.log(`Studio:      http://127.0.0.1:${studioPort}\n`);
-    const viteArgs = ['--host', '127.0.0.1', '--port', appPort, ...(open ? ['--open'] : [])];
+    const viteArgs = ['--host', '127.0.0.1', '--port', appPort, '--strictPort', ...(open ? ['--open'] : [])];
     const vite = runLocalVite(viteArgs, false);
     let shuttingDown = false;
     const stopVite = () => { if (!vite.killed)

package/dist/cli/index.js

@@ -23,7 +23,7 @@ import * as path from 'path';
 import * as readline from 'readline';
 import { getClient } from './api-client.js';
 import { loadFeltDBConfig, createDefaultConfig, validateModel, } from './config.js';
-const VERSION = '0.4.13';
+const VERSION = '0.4.15';
 function prompt(question) {
     const rl = readline.createInterface({
         input: process.stdin,

package/dist/collection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../src/collection.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../src/collection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAIxC,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,kBAAkB,CAAC;AAEhE,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;AAChD,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC;AAEjD;;;;;GAKG;AACH,qBAAa,UAAU,CAAC,CAAC;IACvB,OAAO,CAAC,EAAE,CAAO;IACjB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,oBAAoB,CAA8B;IAC1D,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,kBAAkB,CAA6B;IACvD,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,aAAa,CAAS;gBAElB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;IAmBpF;;OAEG;YACW,oBAAoB;IAalC;;;OAGG;IACG,GAAG,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IAKzB,0DAA0D;IACpD,IAAI,CAAC,KAAK,GAAE,OAAO,CAAC,CAAC,CAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAQhD;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAWtC;;OAEG;IACH,WAAW,IAAI,WAAW,EAAE;IAI5B;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAYrC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAazC;;OAEG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAajD;;;OAGG;IACH,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IAO7C;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA4BrE;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BrE;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BhD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAK9B;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKnD;;;OAGG;IACH,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI;IA6CxE,mEAAmE;IACnE,KAAK,IAAI,IAAI;IASb;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAgC/B;AAED;;GAEG;AACH,qBAAa,YAAY,CAAC,MAAM,EAAE,KAAK;IACrC,OAAO,CAAC,QAAQ,CAAO;IACvB,OAAO,CAAC,OAAO,CAAO;IACtB,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,UAAU,CAAoC;gBAGpD,QAAQ,EAAE,IAAI,EACd,OAAO,EAAE,IAAI,EACb,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,GAAG,MAAM;IAQ/C;;OAEG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;CAoBxD"}

package/dist/collection.js

@@ -258,10 +258,16 @@ export class Collection {
         }
         // Subscribe to changes via reactive dependency graph
         if (!this.graphUnsubscribe) {
-            const notify = async () => {
-                await this.refresh();
-                for (const sub of this.subscribers)
-                    sub([...this.cache]);
+            let refreshInFlight = null;
+            const notify = () => {
+                if (refreshInFlight)
+                    return refreshInFlight;
+                refreshInFlight = (async () => {
+                    await this.refresh();
+                    for (const sub of this.subscribers)
+                        sub([...this.cache]);
+                })().finally(() => { refreshInFlight = null; });
+                return refreshInFlight;
             };
             const graph = getReactiveDependencyGraph();
             this.graphUnsubscribe = graph.subscribe(this.name, notify);
@@ -269,7 +275,7 @@ export class Collection {
                 this.runtimeUnsubscribe = this.db.subscribe_changes(collection => {
                     if (collection === this.name)
                         void notify();
-                });
+                }, this.name);
             }
         }
         // Return unsubscribe function

package/dist/create/cli.js

@@ -73,6 +73,14 @@ async function prompt(message) {
     const interface_ = readline.createInterface({ input: process.stdin, output: process.stdout });
     return new Promise(resolve => interface_.question(message, value => { interface_.close(); resolve(value.trim()); }));
 }
+async function promptForProjectName(defaultName = 'feltdb-app') {
+    while (true) {
+        const value = (await prompt(`What should we name your FeltDB app? (${defaultName}): `)) || defaultName;
+        if (/^[a-z0-9][a-z0-9-]*$/.test(value))
+            return value;
+        console.log('Use lowercase letters, numbers, and dashes (for example: customer-portal).');
+    }
+}
 async function promptSecret(message) {
     if (!process.stdin.isTTY || !process.stdout.isTTY)
         return '';
@@ -207,7 +215,7 @@ Deployment Target (Explicit):
                           Requires production FeltDB instance or self-host
 
   --self-host             Dedicated FeltDB server with Docker Compose
-                          Best for: Production deployments, multi-user systems
+                          Best for: Staging first, then explicit production promotion
                           Generates Docker Compose with persistent /data volume
 
   --managed               Managed FeltDB runtime
@@ -245,10 +253,12 @@ Learn more: https://github.com/rkendel1/feltdb`);
     }
     // Find project name (first non-flag argument)
     let projectName = 'feltdb-app';
+    let projectNameProvided = false;
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
         if (!arg.startsWith('-')) {
             projectName = arg;
+            projectNameProvided = true;
             break;
         }
         // Skip next arg if current arg is a flag that takes a value
@@ -260,10 +270,16 @@ Learn more: https://github.com/rkendel1/feltdb`);
     const shouldInstall = !args.includes('--no-install');
     const shouldStart = !args.includes('--no-start');
     let options = parseArgs(args);
+    if (!projectNameProvided && !shouldAutoYes && process.stdin.isTTY && process.stdout.isTTY) {
+        projectName = await promptForProjectName(projectName);
+    }
+    if (!/^[a-z0-9][a-z0-9-]*$/.test(projectName)) {
+        throw new Error('Application names must use lowercase letters, numbers, and dashes.');
+    }
     const runtimeDescriptions = {
         'browser': 'Browser with IndexedDB (local-first, no server)',
         'node': 'Node.js server (server-side authority)',
-        'self-hosted': 'Self-hosted with Docker Compose (production)',
+        'self-hosted': 'Self-hosted with Docker Compose (staging)',
         'managed': 'Managed FeltDB service (hosted persistence, sync, and workloads)',
     };
     if (!runtimeDescriptions[options.runtime]) {
@@ -286,6 +302,7 @@ Learn more: https://github.com/rkendel1/feltdb`);
     console.log(`Capabilities:  ${options.capabilities}`);
     console.log('\n═══════════════════════════════════════════════\n');
     const projectDir = path.resolve(process.cwd(), projectName);
+    let projectCreated = false;
     try {
         await createProject({
             projectName,
@@ -298,6 +315,7 @@ Learn more: https://github.com/rkendel1/feltdb`);
             webllm: options.webllm,
             capabilities: options.capabilities,
         });
+        projectCreated = true;
         if (options.runtime === 'managed') {
             console.log('\n☁️  Setting up your managed FeltDB account...\n');
             const email = process.env.FELTDB_MANAGED_EMAIL || (shouldAutoYes ? '' : await prompt('Email: '));
@@ -341,7 +359,9 @@ Learn more: https://github.com/rkendel1/feltdb`);
         }
     }
     catch (error) {
-        console.error('❌ Failed to create project:', error);
+        console.error(projectCreated
+            ? `❌ The project was created at ${projectDir}, but setup or startup failed:`
+            : '❌ Failed to create project:', error);
         process.exit(1);
     }
 }

package/dist/create/create.js

@@ -3,7 +3,6 @@
  */
 import fs from 'fs';
 import path from 'path';
-import { fileURLToPath } from 'url';
 import { randomBytes } from 'crypto';
 import { feltdbPackageRange } from './package-versions.js';
 import { generateDockerCompose, generateDockerfile, generateDockerIgnore, generateDotEnvLocal, generateFeltDBDockerfile, generateStudioDockerfile, } from './docker-compose-generator.js';
@@ -1218,7 +1217,8 @@ VITE_FELTDB_MANAGED_NAMESPACE=
 VITE_FELTDB_MANAGED_ENVIRONMENT=production
 
 # Override the default self-hosted container image
-# Example: ghcr.io/rkendel1/feltdb:latest
+# By default the server image is built locally from the bundled source.
+# Example override: your-registry.example/feltdb:staging
 FELTDB_IMAGE=
 
 # Node environment
@@ -1239,11 +1239,8 @@ NODE_ENV=development
         fs.writeFileSync(path.join(projectDir, 'Dockerfile'), generateDockerfile(dockerConfig, framework));
         fs.writeFileSync(path.join(projectDir, 'Dockerfile.feltdb'), generateFeltDBDockerfile(dockerConfig));
         fs.writeFileSync(path.join(projectDir, 'Dockerfile.studio'), generateStudioDockerfile(dockerConfig));
-        const serverSource = fileURLToPath(new URL('./server-source', import.meta.url));
-        fs.cpSync(serverSource, path.join(projectDir, '.feltdb', 'server-source'), { recursive: true });
         fs.writeFileSync(path.join(projectDir, '.dockerignore'), generateDockerIgnore());
         const dockerEnvironment = generateDotEnvLocal(dockerConfig, randomBytes(32).toString('hex'));
-        fs.writeFileSync(path.join(projectDir, '.env.docker'), dockerEnvironment);
         // Docker Compose loads .env automatically; it is already excluded from git.
         fs.writeFileSync(path.join(projectDir, '.env'), dockerEnvironment);
     }
@@ -1497,7 +1494,8 @@ Verify vector database connection and that embeddings are enabled in capabilitie
 - Check out example projects in the templates
 - Join the community Discord for support
 `;
-    fs.writeFileSync(path.join(projectDir, 'RUNTIME_GUIDE.md'), runtimeGuide);
+    // Keep generated projects focused; the runtime guide lives in FeltDB's docs.
+    void runtimeGuide;
     // Create .gitignore
     const gitignore = `node_modules/
 dist/

package/dist/create/docker-compose-generator.js

@@ -14,16 +14,33 @@ export function generateDockerCompose(config) {
     build:
       context: .
       dockerfile: Dockerfile.feltdb
+      args:
+        FELTDB_VERSION: ${config.version}
     container_name: \${COMPOSE_PROJECT_NAME}-feltdb
     environment:
       FELTDB_APP_NAME: \${FELTDB_APP_NAME:-${config.appName}}
       FELTDB_APP_ID: \${FELTDB_APP_ID:-${config.appId}}
       FELTDB_VERSION: \${FELTDB_VERSION:-${config.version}}
+      FELTDB_ENVIRONMENT: \${FELTDB_ENVIRONMENT:-staging}
       FELTDB_PEERS: \${FELTDB_PEERS:-}
       FELTDB_MASTER_KEY: \${FELTDB_MASTER_KEY}
       NODE_ENV: \${NODE_ENV:-production}
     ports:
       - "\${FELTDB_API_PORT:-${config.port}}:7700"
+    command:
+      - feltdb-server
+      - --host
+      - 0.0.0.0
+      - --port
+      - "7700"
+      - --namespace
+      - \${FELTDB_APP_ID:-${config.appId}}
+      - --data
+      - /data/feltdb.log
+      - --allow-origin
+      - http://127.0.0.1:\${APP_PORT:-5173}
+      - --allow-origin
+      - http://127.0.0.1:\${STUDIO_PORT:-${config.studioPort}}
     volumes:
       - feltdb_data:/data
       - ./feltdb.flow:/app/feltdb.flow:ro
@@ -106,11 +123,13 @@ volumes:
 `;
 }
 export function generateFeltDBDockerfile(config) {
-    return `# FeltDB server source is bundled with create-feltdb for a reproducible build.
+    return `# Build the matching FeltDB server without adding engine source to the application.
 FROM rust:1.96-alpine AS builder
-RUN apk add --no-cache pkgconf openssl-dev musl-dev
+RUN apk add --no-cache nodejs npm pkgconf openssl-dev musl-dev
 WORKDIR /source
-COPY .feltdb/server-source/ ./
+ARG FELTDB_VERSION=${config.version}
+RUN npm install --global "create-feltdb@\${FELTDB_VERSION}" \
+ && cp -R "\$(npm root --global)/create-feltdb/dist/server-source/." /source/
 RUN cargo build -p feltdb-server --release --locked
 
 FROM alpine:3.22
@@ -191,6 +210,7 @@ COMPOSE_PROJECT_NAME=${config.appName.toLowerCase().replace(/[^a-z0-9]/g, '-')}
 FELTDB_APP_NAME=${config.appName}
 FELTDB_APP_ID=${config.appId}
 FELTDB_VERSION=${config.version}
+FELTDB_ENVIRONMENT=staging
 FELTDB_API_PORT=${config.port}
 FELTDB_REPLICATION_PORT=${config.replicationPort}
 FELTDB_PEERS=
@@ -203,8 +223,6 @@ FELTDB_API_URL=http://feltdb:7700
 # Studio Configuration
 STUDIO_PORT=${config.studioPort}
 
-# Runtime
-NODE_ENV=production
 `;
 }
 export function generateHealthCheckScript() {

package/dist/create/package-versions.js

@@ -1,4 +1,4 @@
 // One release train keeps generated applications installable. The repository
 // validation script checks these values against every workspace manifest.
-export const FELTDB_PACKAGE_VERSION = '0.4.13';
+export const FELTDB_PACKAGE_VERSION = '0.4.15';
 export const feltdbPackageRange = `^${FELTDB_PACKAGE_VERSION}`;

package/dist/feltdb.d.ts

@@ -52,7 +52,7 @@ export interface JsDb {
     /** Delete a record when supported by the runtime. */
     delete?(key: string): any | Promise<any>;
     /** Subscribe to runtime-originated changes, including remote mutations. */
-    subscribe_changes?(callback: (collection: string) => void): () => void;
+    subscribe_changes?(callback: (collection: string) => void, collection?: string): () => void;
     close?(): void | Promise<void>;
     /**
      * Get capability records

package/dist/feltdb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feltdb.d.ts","sourceRoot":"","sources":["../src/feltdb.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,GAAG,GAAG,GAAG,CAAC;IAEhC;;OAEG;IACH,SAAS,IAAI,GAAG,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC;IAE/B;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC;IAEpC;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC;IAEvC;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,GAAG,CAAC;IAEnE;;OAEG;IACH,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC;IAEpE;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAEzC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAErC;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAEvD,6DAA6D;IAC7D,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAExD,qDAAqD;IACrD,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAEzC,2EAA2E;IAC3E,iBAAiB,CAAC,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACvE,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B;;OAEG;IACH,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAAC;IAEhD;;OAEG;IACH,WAAW,IAAI,MAAM,CAAC;IAEtB;;OAEG;IACH,YAAY,IAAI,MAAM,CAAC;IAEvB,0EAA0E;IAC1E,YAAY,CAAC,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAEpC,6DAA6D;IAC7D,iBAAiB,CAAC,CAAC,cAAc,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/D,uBAAuB,CAAC,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB"}
+{"version":3,"file":"feltdb.d.ts","sourceRoot":"","sources":["../src/feltdb.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,GAAG,GAAG,GAAG,CAAC;IAEhC;;OAEG;IACH,SAAS,IAAI,GAAG,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC;IAE/B;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC;IAEpC;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC;IAEvC;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,GAAG,CAAC;IAEnE;;OAEG;IACH,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC;IAEpE;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAEzC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAErC;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAEvD,6DAA6D;IAC7D,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAExD,qDAAqD;IACrD,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAEzC,2EAA2E;IAC3E,iBAAiB,CAAC,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IAC5F,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B;;OAEG;IACH,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAAC;IAEhD;;OAEG;IACH,WAAW,IAAI,MAAM,CAAC;IAEtB;;OAEG;IACH,YAAY,IAAI,MAAM,CAAC;IAEvB,0EAA0E;IAC1E,YAAY,CAAC,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAEpC,6DAA6D;IAC7D,iBAAiB,CAAC,CAAC,cAAc,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/D,uBAAuB,CAAC,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB"}

package/dist/indexeddb-db.d.ts

@@ -14,6 +14,7 @@ interface ChangeRecord {
     origin: string;
     value?: unknown;
 }
+type ChangeListener = (collection: string) => void;
 /** Durable browser runtime. Every mutation resolves only after its IndexedDB transaction commits. */
 export declare class IndexedDbJsDb implements JsDb {
     private readonly database;
@@ -21,6 +22,15 @@ export declare class IndexedDbJsDb implements JsDb {
     private sequence;
     private readonly origin;
     private readonly peers;
+    private readonly changeListeners;
+    private changeCursor;
+    private changePollGeneration;
+    private changePollRunning;
+    private changePollTimer?;
+    private changeChannelListening;
+    private changeCoordinatorReady;
+    private pendingChangeAnnouncements;
+    private readonly announcedChangeSequences;
     constructor(namespace: string);
     private open;
     private splitKey;
@@ -31,7 +41,16 @@ export declare class IndexedDbJsDb implements JsDb {
     get(key: string): Promise<JsResult>;
     query(collection: string): Promise<JsResult>;
     private request;
-    subscribe_changes(callback: (collection: string) => void): () => void;
+    subscribe_changes(callback: ChangeListener, collection?: string): () => void;
+    private readonly receiveChangeMessage;
+    private deliverChangeAnnouncement;
+    private announceLocalChange;
+    private rememberAnnouncedSequence;
+    private notifyChangeListeners;
+    private startChangeCoordinator;
+    private latestChangeSequence;
+    private pollChanges;
+    private stopChangeCoordinator;
     close(): void;
     get_capability_records(capability: string): Promise<JsResult>;
     execute_op(): JsResult;

package/dist/indexeddb-db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"indexeddb-db.d.ts","sourceRoot":"","sources":["../src/indexeddb-db.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC,UAAU,QAAQ;IAAG,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;AACtE,UAAU,YAAY;IAAG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE;AAErK,qGAAqG;AACrG,qBAAa,aAAc,YAAW,IAAI;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;gBAE/B,SAAS,EAAE,MAAM;IAO7B,OAAO,CAAC,IAAI;IAcZ,OAAO,CAAC,QAAQ;YAMF,MAAM;IA2BpB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IACrD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IACrD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAEhC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKnC,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;YAapC,OAAO;IAKrB,iBAAiB,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAuBrE,KAAK,IAAI,IAAI;IACb,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC7D,UAAU,IAAI,QAAQ;IACtB,SAAS,IAAI,QAAQ;IACrB,QAAQ,IAAI,QAAQ;IACpB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IACvC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IAC1C,oBAAoB,IAAI,QAAQ;IAChC,2BAA2B,IAAI,QAAQ;IACvC,WAAW,IAAI,MAAM;IACrB,YAAY,IAAI,MAAM;IAChB,YAAY,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IACvC,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IACjE,uBAAuB,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAqBzG"}
+{"version":3,"file":"indexeddb-db.d.ts","sourceRoot":"","sources":["../src/indexeddb-db.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC,UAAU,QAAQ;IAAG,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;AACtE,UAAU,YAAY;IAAG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE;AACrK,KAAK,cAAc,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;AAEnD,qGAAqG;AACrG,qBAAa,aAAc,YAAW,IAAI;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsD;IACtF,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,eAAe,CAAC,CAAgC;IACxD,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,0BAA0B,CAAwD;IAC1F,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAqB;gBAElD,SAAS,EAAE,MAAM;IAO7B,OAAO,CAAC,IAAI;IAcZ,OAAO,CAAC,QAAQ;YAMF,MAAM;IA8BpB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IACrD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IACrD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAEhC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKnC,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;YAapC,OAAO;IAKrB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI;IAoB5E,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAQnC;IAEF,OAAO,CAAC,yBAAyB;IASjC,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,yBAAyB;IAUjC,OAAO,CAAC,qBAAqB;YAQf,sBAAsB;YAwBtB,oBAAoB;YASpB,WAAW;IAyBzB,OAAO,CAAC,qBAAqB;IAc7B,KAAK,IAAI,IAAI;IAMb,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC7D,UAAU,IAAI,QAAQ;IACtB,SAAS,IAAI,QAAQ;IACrB,QAAQ,IAAI,QAAQ;IACpB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IACvC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IAC1C,oBAAoB,IAAI,QAAQ;IAChC,2BAA2B,IAAI,QAAQ;IACvC,WAAW,IAAI,MAAM;IACrB,YAAY,IAAI,MAAM;IAChB,YAAY,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IACvC,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IACjE,uBAAuB,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAwBzG"}