@feltdb/core 0.6.3 → 0.6.4

package/dist/cli/commands.js

@@ -8,7 +8,7 @@ import net from 'net';
 import { createRequire } from 'module';
 import { spawn, spawnSync } from 'child_process';
 import { createFeltDB, diffFlowSpec, formatFlowSpec, parseFlowSpec, planFlowSpecMigration, validateFlowSpec } from '@feltdb/core';
-import { discoverWorkspace, generatePairingToken, persistPairingToken, displayWorkspaceStatus, initializeWorkspace } from './workspace-integration.js';
+import { discoverWorkspace, generatePairingToken, persistPairingToken, displayWorkspaceStatus, initializeWorkspace, startPairingDiscoveryServer } from './workspace-integration.js';
 function loadProjectEnvironment(file = path.resolve('.env.local')) {
     if (!fs.existsSync(file))
         return;
@@ -488,7 +488,7 @@ async function handleDev(args) {
         ? process.env.VITE_FELTDB_MANAGED_NAMESPACE || config.namespace
         : config.namespace;
     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 requestedStudioPort = Number(args.includes('--studio-port') ? args[args.indexOf('--studio-port') + 1] || '7701' : '7701');
     const appPort = String(await availablePort(requestedAppPort));
     const studioPort = String(await availablePort(requestedStudioPort));
     if (appPort !== String(requestedAppPort))
@@ -522,11 +522,19 @@ async function handleDev(args) {
     // Generate pairing token for the workspace
     // This enables browsers and IDEs to discover and connect to the workspace
     let pairingToken = null;
+    let pairingDiscoveryServer = null;
     if (workspace) {
         const token = generatePairingToken();
         token.workspaceId = workspace.workspaceId;
         token.endpoint = process.env.VITE_FELTDB_URL;
+        token.authorityEndpoint = token.endpoint;
+        token.namespace = runtimeNamespace || config.namespace;
+        if (!token.endpoint) {
+            throw new Error('Development Workspace pairing requires a FeltDB authority endpoint');
+        }
         persistPairingToken(process.cwd(), token);
+        const discoveryPort = Number(args.includes('--discovery-port') ? args[args.indexOf('--discovery-port') + 1] || '7799' : '7799');
+        pairingDiscoveryServer = await startPairingDiscoveryServer(token, discoveryPort);
         pairingToken = token.token;
     }
     console.log('FeltDB Dev Server');
@@ -539,6 +547,7 @@ async function handleDev(args) {
         console.log(`🔗 Development Workspace`);
         if (pairingToken) {
             console.log(`  Pairing Code: ${pairingToken}`);
+            console.log(`  Discovery: http://127.0.0.1:${(pairingDiscoveryServer?.address()).port}`);
             console.log(`  Clients can use this code to auto-discover the workspace`);
         }
     }
@@ -551,7 +560,7 @@ async function handleDev(args) {
     let shuttingDown = false;
     const stopVite = () => { if (!vite.killed)
         vite.kill('SIGTERM'); };
-    const stopAll = () => { shuttingDown = true; stopVite(); stopSelfHosted(); };
+    const stopAll = () => { shuttingDown = true; stopVite(); pairingDiscoveryServer?.close(); stopSelfHosted(); };
     // In an inherited terminal Ctrl-C can reach Vite before this parent process.
     // Never leave Studio (or its port) running after the application exits.
     vite.once('exit', code => {
@@ -817,8 +826,8 @@ async function handleStudio(args) {
         ? args[args.indexOf('--connect') + 1]
         : undefined;
     const port = args.includes('--port')
-        ? args[args.indexOf('--port') + 1] || '3000'
-        : '3000';
+        ? args[args.indexOf('--port') + 1] || '7701'
+        : '7701';
     const host = args.includes('--host')
         ? args[args.indexOf('--host') + 1] || '127.0.0.1'
         : '127.0.0.1';
@@ -919,7 +928,7 @@ Commands:
 Studio:
   feltdb studio                              Launch local Studio
   feltdb studio --connect <url>              Connect to remote instance
-  feltdb studio --port 3000 --no-open        Start on port 3000 without opening browser
+  feltdb studio --port 7701 --no-open        Start on port 7701 without opening browser
 
 Server Options:
   feltdb server [--port 7700] [--data ./data] [--auth]

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.6.3';
+const VERSION = '0.6.4';
 function prompt(question) {
     const rl = readline.createInterface({
         input: process.stdin,

package/dist/cli/workspace-integration.js

@@ -10,6 +10,43 @@
 import fs from 'fs';
 import path from 'path';
 import { randomBytes } from 'crypto';
+import http from 'http';
+export function startPairingDiscoveryServer(token, port = 7799, host = '127.0.0.1') {
+    const authorityEndpoint = token.authorityEndpoint || token.endpoint;
+    if (!token.workspaceId || !authorityEndpoint || !token.namespace) {
+        throw new Error('Pairing discovery requires workspaceId, endpoint, and namespace');
+    }
+    const route = `/api/v1/development/pairing/${encodeURIComponent(token.token)}`;
+    const server = http.createServer((request, response) => {
+        response.setHeader('Access-Control-Allow-Origin', '*');
+        response.setHeader('Access-Control-Allow-Methods', 'GET, OPTIONS');
+        response.setHeader('Access-Control-Allow-Headers', 'Accept, Content-Type');
+        response.setHeader('Cache-Control', 'no-store');
+        if (request.method === 'OPTIONS') {
+            response.statusCode = 204;
+            response.end();
+            return;
+        }
+        const pathname = new URL(request.url || '/', `http://${host}`).pathname;
+        if (request.method !== 'GET' || pathname !== route || Date.now() >= token.expiresAt) {
+            response.statusCode = 404;
+            response.setHeader('Content-Type', 'application/json; charset=utf-8');
+            response.end(JSON.stringify({ error: 'PAIRING_CODE_NOT_FOUND' }));
+            return;
+        }
+        response.setHeader('Content-Type', 'application/json; charset=utf-8');
+        response.end(JSON.stringify({
+            workspaceId: token.workspaceId,
+            endpoint: authorityEndpoint,
+            expiresAt: token.expiresAt,
+            namespace: token.namespace,
+        }));
+    });
+    return new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(port, host, () => resolve(server));
+    });
+}
 /**
  * Discover workspace identity from .feltdb/workspace.json
  * Returns null if workspace is not initialized

package/dist/create/create.js

@@ -1234,7 +1234,7 @@ NODE_ENV=development
             framework,
             port: 7700,
             replicationPort: 7701,
-            studioPort: 3000,
+            studioPort: 7701,
         };
         fs.writeFileSync(path.join(projectDir, 'docker-compose.yml'), generateDockerCompose(dockerConfig));
         fs.writeFileSync(path.join(projectDir, 'Dockerfile'), generateDockerfile(dockerConfig, framework));

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.6.3';
+export const FELTDB_PACKAGE_VERSION = '0.6.4';
 export const feltdbPackageRange = `^${FELTDB_PACKAGE_VERSION}`;

package/dist/workspace/index.d.ts

@@ -12,7 +12,7 @@
  * to the same shared development workspace.
  */
 export type { DevelopmentWorkspace, ClientType, WorkspaceEventPayload, DevelopmentTask, CodeChange, VerificationResult, SourceLocation, WorkspaceClient, WorkspaceDiscovery, } from './workspace-types.js';
-export type { WorkspaceConnectionOptions, WorkspaceMetadata, PairingTokenData, ClientInfo, } from './workspace-connection.js';
+export type { WorkspaceConnectionOptions, WorkspaceMetadata, PairingTokenData, BrowserPairingResolution, PairingDiscoveryOptions, ClientInfo, } from './workspace-connection.js';
 export { connectDevelopmentWorkspace, discoverDevelopmentWorkspace, resolvePairingCode, DevelopmentWorkspaceConnection, } from './workspace-connection.js';
 export { createWorkspaceId, isValidWorkspaceId, createDevelopmentWorkspace, updateWorkspaceTimestamp, discoverWorkspace, persistWorkspaceDiscovery, } from './workspace-identity.js';
 export { DevelopmentNode, getDevelopmentNode, shutdownDevelopmentNode, } from './development-node.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,YAAY,EACV,oBAAoB,EACpB,UAAU,EACV,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,0BAA0B,EAC1B,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,GACX,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,kBAAkB,EAClB,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,0BAA0B,EAC1B,wBAAwB,EACxB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,YAAY,EACV,oBAAoB,EACpB,UAAU,EACV,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,0BAA0B,EAC1B,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,UAAU,GACX,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,kBAAkB,EAClB,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,0BAA0B,EAC1B,wBAAwB,EACxB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/workspace/workspace-connection.d.ts

@@ -13,6 +13,7 @@ export interface WorkspaceConnectionOptions {
     clientId?: string;
     clientType?: ClientType;
     endpoint?: string;
+    discoveryEndpoint?: string;
     auth?: {
         token: string;
         apiKey?: string;
@@ -28,6 +29,17 @@ export interface PairingTokenData {
     workspaceId: string;
     expiresAt: number;
     endpoint?: string;
+    authorityEndpoint?: string;
+    namespace?: string;
+}
+export interface BrowserPairingResolution {
+    workspaceId: string;
+    endpoint: string;
+    expiresAt: number;
+    namespace: string;
+}
+export interface PairingDiscoveryOptions {
+    endpoint?: string;
 }
 export interface ClientInfo {
     clientId: string;
@@ -56,7 +68,8 @@ export declare function discoverDevelopmentWorkspace(options: {
  *
  * Used by clients to auto-discover workspace without manual entry.
  */
-export declare function resolvePairingCode(pairingCode: string, projectDir?: string): Promise<string>;
+export declare function resolvePairingCode(pairingCode: string, projectDir: string): Promise<string>;
+export declare function resolvePairingCode(pairingCode: string, options?: PairingDiscoveryOptions): Promise<BrowserPairingResolution>;
 /**
  * Connect to a Development Workspace
  *

package/dist/workspace/workspace-connection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-connection.d.ts","sourceRoot":"","sources":["../../src/workspace/workspace-connection.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"workspace-connection.d.ts","sourceRoot":"","sources":["../../src/workspace/workspace-connection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAGlE,MAAM,WAAW,0BAA0B;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,IAAI,CAAC,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAC9B,OAAO,CAAC,iBAAiB,CAAC,CAoB5B;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAC7F,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;AAsD9H;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,8BAA8B,CAAC,CAwCzC;AAYD;;;;;GAKG;AACH,qBAAa,8BAA8B;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,aAAa,CAA4E;IACjG,WAAW,EAAE,MAAM,CAAK;IACxB,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,iBAAiB,CAA6B;gBAGpD,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,0BAA0B;IAQrC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAWjC;;OAEG;IACH,OAAO,CAAC,eAAe;IAevB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAItC;;;;;;;;;OASG;IACH,SAAS,CAAC,CAAC,GAAG,OAAO,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,CAAC,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAAK,IAAI,GACjD,MAAM,IAAI;IAgBb;;;;OAIG;IACG,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAY/E;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAIrE;;OAEG;IACG,KAAK,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAIhD;;OAEG;IACG,MAAM,CAAC,CAAC,SAAS,MAAM,EAC3B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAClB,OAAO,CAAC,IAAI,CAAC;IAUhB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,gBAAgB;YAKV,eAAe;CAiB9B"}

package/dist/workspace/workspace-connection.js

@@ -4,9 +4,8 @@
  * Public API for clients (browser, IDE, agent) to discover and connect
  * to a FeltDB Development Workspace.
  */
-import fs from 'fs';
-import path from 'path';
 import { HttpJsDb } from '../http-db.js';
+const DEFAULT_PAIRING_DISCOVERY_ENDPOINT = 'http://127.0.0.1:7799';
 /**
  * Discover workspace from .feltdb/workspace.json
  *
@@ -18,6 +17,10 @@ import { HttpJsDb } from '../http-db.js';
  * ```
  */
 export async function discoverDevelopmentWorkspace(options) {
+    const [{ default: fs }, { default: path }] = await Promise.all([
+        import('node:fs'),
+        import('node:path'),
+    ]);
     const workspacePath = path.join(options.projectDir, '.feltdb', 'workspace.json');
     if (!fs.existsSync(workspacePath)) {
         throw new Error(`Development Workspace not found at ${workspacePath}. Run "feltdb dev" or create-feltdb to initialize.`);
@@ -31,20 +34,17 @@ export async function discoverDevelopmentWorkspace(options) {
         throw new Error(`Failed to read workspace metadata: ${error instanceof Error ? error.message : String(error)}`);
     }
 }
-/**
- * Resolve pairing code to workspace ID
- *
- * Pairing codes are short-lived tokens (FELT-XXXX) that resolve to
- * workspace IDs. They expire after 15 minutes.
- *
- * Used by clients to auto-discover workspace without manual entry.
- */
-export async function resolvePairingCode(pairingCode, projectDir) {
+export async function resolvePairingCode(pairingCode, source = {}) {
     if (!pairingCode.startsWith('FELT-')) {
         throw new Error('Invalid pairing code format');
     }
-    // When projectDir is provided, try local resolution first
-    if (projectDir) {
+    // Keep filesystem resolution for CLI and IDE callers that explicitly pass a project directory.
+    if (typeof source === 'string') {
+        const [{ default: fs }, { default: path }] = await Promise.all([
+            import('node:fs'),
+            import('node:path'),
+        ]);
+        const projectDir = source;
         const pairingPath = path.join(projectDir, '.feltdb', 'pairing.json');
         if (fs.existsSync(pairingPath)) {
             try {
@@ -59,6 +59,26 @@ export async function resolvePairingCode(pairingCode, projectDir) {
             }
         }
     }
+    else {
+        const discoveryEndpoint = (source.endpoint || DEFAULT_PAIRING_DISCOVERY_ENDPOINT).replace(/\/$/, '');
+        let response;
+        try {
+            response = await fetch(`${discoveryEndpoint}/api/v1/development/pairing/${encodeURIComponent(pairingCode)}`, {
+                headers: { Accept: 'application/json' },
+            });
+        }
+        catch (error) {
+            throw new Error(`Pairing discovery unavailable at ${discoveryEndpoint}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        if (!response.ok) {
+            throw new Error(`Pairing code ${pairingCode} not found or expired (discovery returned ${response.status})`);
+        }
+        const resolution = await response.json();
+        if (!resolution.workspaceId || !resolution.endpoint || !resolution.expiresAt || !resolution.namespace) {
+            throw new Error('Pairing discovery returned an invalid response');
+        }
+        return resolution;
+    }
     throw new Error(`Pairing code ${pairingCode} not found or expired. Ensure "feltdb dev" is running and the code is correct.`);
 }
 /**
@@ -96,9 +116,19 @@ export async function resolvePairingCode(pairingCode, projectDir) {
  */
 export async function connectDevelopmentWorkspace(options) {
     let workspaceId = options.workspaceId;
+    let authorityEndpoint = options.endpoint;
     // Resolve pairing code to workspace ID if provided
     if (options.pairingCode && !workspaceId) {
-        workspaceId = await resolvePairingCode(options.pairingCode, options.projectDir);
+        if (options.projectDir) {
+            workspaceId = await resolvePairingCode(options.pairingCode, options.projectDir);
+        }
+        else {
+            const resolution = await resolvePairingCode(options.pairingCode, {
+                endpoint: options.discoveryEndpoint || options.endpoint,
+            });
+            workspaceId = resolution.workspaceId;
+            authorityEndpoint = resolution.endpoint;
+        }
     }
     // Discover workspace if no ID provided
     if (!workspaceId && options.projectDir) {
@@ -110,7 +140,7 @@ export async function connectDevelopmentWorkspace(options) {
     }
     const clientId = options.clientId || generateClientId(options.clientType);
     const clientType = options.clientType || 'other';
-    const connection = new DevelopmentWorkspaceConnection(workspaceId, clientId, clientType, options);
+    const connection = new DevelopmentWorkspaceConnection(workspaceId, clientId, clientType, { ...options, endpoint: authorityEndpoint });
     await connection.connect();
     return connection;
 }
@@ -289,10 +319,14 @@ export class DevelopmentWorkspaceConnection {
         if (environmentEndpoint)
             return environmentEndpoint;
         if (this.options.pairingCode && this.options.projectDir) {
+            const [{ default: fs }, { default: path }] = await Promise.all([
+                import('node:fs'),
+                import('node:path'),
+            ]);
             const pairingPath = path.join(this.options.projectDir, '.feltdb', 'pairing.json');
             const pairing = JSON.parse(fs.readFileSync(pairingPath, 'utf8'));
-            if (pairing.endpoint)
-                return pairing.endpoint;
+            if (pairing.authorityEndpoint || pairing.endpoint)
+                return pairing.authorityEndpoint || pairing.endpoint;
         }
         throw new Error('Cannot connect: workspace authority endpoint is required');
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feltdb/core",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "description": "FeltDB Core - Application-facing database with Browser, Local, and Server runtimes. Durable state, reactive APIs.",
   "license": "MIT",
   "type": "module",