@feltdb/core 0.6.3 → 0.6.5

package/dist/cli/commands.js

@@ -7,8 +7,8 @@ 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';
-import { discoverWorkspace, generatePairingToken, persistPairingToken, displayWorkspaceStatus, initializeWorkspace } from './workspace-integration.js';
+import { createFeltDB, diffFlowSpec, formatFlowSpec, parseFlowSpec, planFlowSpecMigration, startLocalDevelopmentAuthority, validateFlowSpec } from '@feltdb/core';
+import { discoverWorkspace, generatePairingToken, persistPairingToken, displayWorkspaceStatus, initializeWorkspace, startPairingDiscoveryServer } from './workspace-integration.js';
 function loadProjectEnvironment(file = path.resolve('.env.local')) {
     if (!fs.existsSync(file))
         return;
@@ -429,6 +429,10 @@ function runLocalVite(args, waitForExit) {
 }
 async function handleDev(args) {
     var _a, _b, _c;
+    if (args.includes('--help')) {
+        console.log('Usage: feltdb dev [--port 5173] [--studio-port 7701] [--authority-port 7700] [--discovery-port 7799] [--no-open]');
+        return;
+    }
     loadProjectEnvironment();
     console.log('🚀 Starting FeltDB development server...\n');
     const projectDir = process.cwd();
@@ -488,7 +492,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))
@@ -498,6 +502,7 @@ async function handleDev(args) {
     process.env.APP_PORT = appPort;
     process.env.STUDIO_PORT = studioPort;
     let selfHostedStarted = false;
+    let localAuthority = null;
     const stopSelfHosted = () => {
         if (selfHostedStarted) {
             spawnSync('docker', ['compose', 'stop', 'feltdb'], { cwd: process.cwd(), stdio: 'ignore' });
@@ -519,17 +524,34 @@ async function handleDev(args) {
         selfHostedStarted = true;
         (_c = process.env).VITE_FELTDB_URL || (_c.VITE_FELTDB_URL = 'http://127.0.0.1:7700');
     }
+    if (!process.env.VITE_FELTDB_URL) {
+        const authorityPort = Number(args.includes('--authority-port') ? args[args.indexOf('--authority-port') + 1] || '7700' : '7700');
+        localAuthority = await startLocalDevelopmentAuthority({
+            dataDir: path.join(projectDir, '.feltdb', 'authority'),
+            port: authorityPort,
+        });
+        process.env.VITE_FELTDB_URL = localAuthority.endpoint;
+    }
     // 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');
+    console.log(`  Authority: ${process.env.VITE_FELTDB_URL}`);
     console.log(`  Namespace: ${config.namespace}`);
     console.log(`  Runtime: ${config.runtime}`);
     console.log(`  Storage: ${config.storage}`);
@@ -539,6 +561,7 @@ async function handleDev(args) {
         console.log(`🔗 Development Workspace`);
         if (pairingToken) {
             console.log(`  Pairing Code: ${pairingToken}`);
+            console.log(`  Pairing discovery: http://127.0.0.1:${(pairingDiscoveryServer?.address()).port}`);
             console.log(`  Clients can use this code to auto-discover the workspace`);
         }
     }
@@ -551,7 +574,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(); void localAuthority?.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 +840,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 +942,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.5';
 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.5';
 export const feltdbPackageRange = `^${FELTDB_PACKAGE_VERSION}`;

package/dist/workspace/index.d.ts

@@ -12,9 +12,11 @@
  * 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';
 export type { DevelopmentNodeConfig } from './development-node.js';
+export { startLocalDevelopmentAuthority } from './local-development-authority.js';
+export type { LocalDevelopmentAuthority, LocalDevelopmentAuthorityOptions } from './local-development-authority.js';
 //# sourceMappingURL=index.d.ts.map

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;AAEnE,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAClF,YAAY,EAAE,yBAAyB,EAAE,gCAAgC,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/workspace/index.js

@@ -14,3 +14,4 @@
 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';
+export { startLocalDevelopmentAuthority } from './local-development-authority.js';

package/dist/workspace/local-development-authority.d.ts

@@ -0,0 +1,12 @@
+export interface LocalDevelopmentAuthority {
+    endpoint: string;
+    close(): Promise<void>;
+}
+export interface LocalDevelopmentAuthorityOptions {
+    dataDir: string;
+    host?: string;
+    port?: number;
+}
+/** Start the durable, unauthenticated loopback authority used by `feltdb dev`. */
+export declare function startLocalDevelopmentAuthority(options: LocalDevelopmentAuthorityOptions): Promise<LocalDevelopmentAuthority>;
+//# sourceMappingURL=local-development-authority.d.ts.map

package/dist/workspace/local-development-authority.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-development-authority.d.ts","sourceRoot":"","sources":["../../src/workspace/local-development-authority.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,gCAAgC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,kFAAkF;AAClF,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC,yBAAyB,CAAC,CAyFpC"}

package/dist/workspace/local-development-authority.js

@@ -0,0 +1,137 @@
+import http from 'node:http';
+import path from 'node:path';
+import { FileJsDb } from '../file-db.js';
+/** Start the durable, unauthenticated loopback authority used by `feltdb dev`. */
+export async function startLocalDevelopmentAuthority(options) {
+    const host = options.host || '127.0.0.1';
+    const port = options.port ?? 7700;
+    if (host !== '127.0.0.1' && host !== 'localhost' && host !== '::1') {
+        throw new Error('The development authority may only bind to a loopback address');
+    }
+    const db = new FileJsDb(path.resolve(options.dataDir));
+    const streams = new Set();
+    const server = http.createServer(async (request, response) => {
+        try {
+            response.setHeader('Access-Control-Allow-Origin', '*');
+            response.setHeader('Access-Control-Allow-Methods', 'GET, POST, PATCH, DELETE, OPTIONS');
+            response.setHeader('Access-Control-Allow-Headers', 'Authorization, Content-Type, FeltDB-Protocol');
+            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 === '/health' || pathname === '/ready')) {
+                json(response, 200, { status: 'ready', storage: 'writable', authority: 'local-development' });
+                return;
+            }
+            if (request.method === 'GET' && pathname === '/events') {
+                response.writeHead(200, {
+                    'Content-Type': 'text/event-stream',
+                    Connection: 'keep-alive',
+                    'Cache-Control': 'no-cache',
+                    'Access-Control-Allow-Origin': '*',
+                });
+                response.write(': connected\n\n');
+                streams.add(response);
+                request.once('close', () => streams.delete(response));
+                return;
+            }
+            const match = pathname.match(/^\/collections\/([^/]+)(?:\/([^/]+))?$/);
+            if (!match) {
+                json(response, 404, { error: 'NOT_FOUND' });
+                return;
+            }
+            const collection = decodeURIComponent(match[1]);
+            const id = match[2] ? decodeURIComponent(match[2]) : undefined;
+            const body = await readBody(request);
+            let result;
+            if (request.method === 'GET' && !id) {
+                result = db.query(collection);
+                json(response, result.success ? 200 : 500, result.success
+                    ? JSON.parse(result.data || '[]').map(value => ({ value }))
+                    : { error: result.error });
+                return;
+            }
+            if (request.method === 'GET' && id) {
+                result = db.get(`${collection}:${id}`);
+                if (!result.success) {
+                    json(response, 500, { error: result.error });
+                    return;
+                }
+                if (!result.data) {
+                    json(response, 404, { error: 'NOT_FOUND' });
+                    return;
+                }
+                json(response, 200, { value: JSON.parse(result.data) });
+                return;
+            }
+            if (request.method === 'POST' && !id) {
+                const value = parseObject(body);
+                const recordId = typeof value.id === 'string' ? value.id : '';
+                if (!recordId) {
+                    json(response, 400, { error: 'Record must have an id' });
+                    return;
+                }
+                result = db.insert(`${collection}:${recordId}`, JSON.stringify(value));
+            }
+            else if (request.method === 'PATCH' && id) {
+                result = db.update(`${collection}:${id}`, JSON.stringify(parseObject(body)));
+            }
+            else if (request.method === 'DELETE' && id) {
+                result = db.delete(`${collection}:${id}`);
+            }
+            else {
+                json(response, 404, { error: 'NOT_FOUND' });
+                return;
+            }
+            if (!result.success) {
+                json(response, 400, { error: result.error });
+                return;
+            }
+            json(response, request.method === 'POST' ? 201 : 200, { ok: true });
+            const frame = `data: ${JSON.stringify({ change: { capability: collection } })}\n\n`;
+            for (const stream of streams)
+                stream.write(frame);
+        }
+        catch (error) {
+            if (!response.headersSent)
+                json(response, 400, { error: error instanceof Error ? error.message : String(error) });
+            else
+                response.end();
+        }
+    });
+    await new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(port, host, resolve);
+    });
+    return {
+        endpoint: `http://${host}:${port}`,
+        close: () => new Promise((resolve, reject) => {
+            for (const stream of streams)
+                stream.end();
+            server.close(error => error ? reject(error) : resolve());
+        }),
+    };
+}
+function json(response, status, value) {
+    response.statusCode = status;
+    response.setHeader('Content-Type', 'application/json; charset=utf-8');
+    response.end(JSON.stringify(value));
+}
+function readBody(request) {
+    return new Promise((resolve, reject) => {
+        let body = '';
+        request.setEncoding('utf8');
+        request.on('data', chunk => { body += chunk; });
+        request.once('end', () => resolve(body));
+        request.once('error', reject);
+    });
+}
+function parseObject(body) {
+    const value = JSON.parse(body || '{}');
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new Error('Request body must be an object');
+    return value;
+}

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":"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"}

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.5",
   "description": "FeltDB Core - Application-facing database with Browser, Local, and Server runtimes. Durable state, reactive APIs.",
   "license": "MIT",
   "type": "module",