@feltdb/core 0.6.2 → 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,10 +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');
@@ -538,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`);
         }
     }
@@ -550,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 => {
@@ -816,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';
@@ -918,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.2';
+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.2';
+export const FELTDB_PACKAGE_VERSION = '0.6.4';
 export const feltdbPackageRange = `^${FELTDB_PACKAGE_VERSION}`;

package/dist/create/server-source/crates/feltdb-server/src/main.rs

@@ -5856,10 +5856,6 @@ async fn main() -> Result<(), Box<dyn std::error::Error>> {
             axum::routing::patch(platform_update_application_member),
         )
         .route("/api/tenants/{tenant_id}", get(get_tenant))
-        .route(
-            "/api/certification/fixtures/{application_id}",
-            axum::routing::delete(delete_certification_fixture),
-        )
         .route("/api/keys", get(list_keys).post(create_key))
         .route("/api/keys/{id}", axum::routing::delete(revoke_key))
         .route(

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

@@ -5,6 +5,7 @@
  * to a FeltDB Development Workspace.
  */
 import type { ClientType } from './workspace-types.js';
+import type { WorkspaceEventPayload } from './workspace-types.js';
 export interface WorkspaceConnectionOptions {
     pairingCode?: string;
     workspaceId?: string;
@@ -12,6 +13,7 @@ export interface WorkspaceConnectionOptions {
     clientId?: string;
     clientType?: ClientType;
     endpoint?: string;
+    discoveryEndpoint?: string;
     auth?: {
         token: string;
         apiKey?: string;
@@ -26,6 +28,18 @@ export interface PairingTokenData {
     token: string;
     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;
@@ -54,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
  *
@@ -101,8 +116,9 @@ export declare class DevelopmentWorkspaceConnection {
     clientType: ClientType;
     private options;
     private subscriptions;
-    private connectedAt;
-    private connectedClients;
+    connectedAt: number;
+    private transport;
+    private unsubscribeEvents;
     constructor(workspaceId: string, clientId: string, clientType: ClientType, options: WorkspaceConnectionOptions);
     /**
      * Establish connection to workspace
@@ -112,10 +128,6 @@ export declare class DevelopmentWorkspaceConnection {
      * Close connection to workspace
      */
     disconnect(): Promise<void>;
-    /**
-     * Register this client as connected
-     */
-    private registerClient;
     /**
      * Get capabilities for this client type
      */
@@ -123,7 +135,7 @@ export declare class DevelopmentWorkspaceConnection {
     /**
      * List connected clients in workspace
      */
-    clients(): ClientInfo[];
+    clients(): Promise<ClientInfo[]>;
     /**
      * Subscribe to workspace entity changes
      *
@@ -157,18 +169,7 @@ export declare class DevelopmentWorkspaceConnection {
      * Notify subscribers of entity changes
      */
     private notifySubscribers;
-}
-/**
- * Event payload for workspace changes
- */
-export interface WorkspaceEventPayload<T = unknown> {
-    id: string;
-    workspaceId: string;
-    collection: string;
-    entityId: string;
-    type: 'created' | 'updated' | 'deleted';
-    value?: T;
-    timestamp: number;
-    originClientId: string;
+    private requireTransport;
+    private resolveEndpoint;
 }
 //# sourceMappingURL=workspace-connection.d.ts.map

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,8 +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
  *
@@ -17,6 +17,10 @@ import path from 'path';
  * ```
  */
 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.`);
@@ -30,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 {
@@ -58,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.`);
 }
 /**
@@ -95,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) {
@@ -109,7 +140,9 @@ export async function connectDevelopmentWorkspace(options) {
     }
     const clientId = options.clientId || generateClientId(options.clientType);
     const clientType = options.clientType || 'other';
-    return new DevelopmentWorkspaceConnection(workspaceId, clientId, clientType, options);
+    const connection = new DevelopmentWorkspaceConnection(workspaceId, clientId, clientType, { ...options, endpoint: authorityEndpoint });
+    await connection.connect();
+    return connection;
 }
 /**
  * Generate a unique client ID based on type
@@ -130,7 +163,8 @@ export class DevelopmentWorkspaceConnection {
     constructor(workspaceId, clientId, clientType, options) {
         this.subscriptions = new Map();
         this.connectedAt = 0;
-        this.connectedClients = new Map();
+        this.transport = null;
+        this.unsubscribeEvents = null;
         this.workspaceId = workspaceId;
         this.clientId = clientId;
         this.clientType = clientType;
@@ -140,26 +174,34 @@ export class DevelopmentWorkspaceConnection {
      * Establish connection to workspace
      */
     async connect() {
-        this.connectedAt = Date.now();
-        this.registerClient();
+        if (this.transport)
+            return;
+        const endpoint = await this.resolveEndpoint();
+        const transport = new HttpWorkspaceTransport(endpoint, this.options.auth?.token ?? '');
+        await transport.assertReachable();
+        const connectedAt = Date.now();
+        await transport.registerClient(this.workspaceId, {
+            clientId: this.clientId,
+            clientType: this.clientType,
+            connectedAt,
+            capabilities: this.getCapabilities(),
+        });
+        this.transport = transport;
+        this.unsubscribeEvents = transport.subscribe(this.workspaceId, event => this.notifySubscribers(event));
+        this.connectedAt = connectedAt;
     }
     /**
      * Close connection to workspace
      */
     async disconnect() {
+        this.unsubscribeEvents?.();
+        this.unsubscribeEvents = null;
+        if (this.transport) {
+            await this.transport.unregisterClient(this.workspaceId, this.clientId);
+        }
         this.subscriptions.clear();
-        this.connectedClients.delete(this.clientId);
-    }
-    /**
-     * Register this client as connected
-     */
-    registerClient() {
-        this.connectedClients.set(this.clientId, {
-            clientId: this.clientId,
-            clientType: this.clientType,
-            connectedAt: this.connectedAt,
-            capabilities: this.getCapabilities(),
-        });
+        this.transport = null;
+        this.connectedAt = 0;
     }
     /**
      * Get capabilities for this client type
@@ -181,8 +223,8 @@ export class DevelopmentWorkspaceConnection {
     /**
      * List connected clients in workspace
      */
-    clients() {
-        return Array.from(this.connectedClients.values());
+    async clients() {
+        return this.requireTransport().clients(this.workspaceId);
     }
     /**
      * Subscribe to workspace entity changes
@@ -214,56 +256,44 @@ export class DevelopmentWorkspaceConnection {
      */
     async publish(collection, entity) {
         const id = generateEntityId();
-        const event = {
-            id: generateEventId(),
+        await this.requireTransport().publish({
             workspaceId: this.workspaceId,
             collection,
             entityId: id,
-            type: 'created',
             value: entity,
-            timestamp: Date.now(),
             originClientId: this.clientId,
-        };
-        this.notifySubscribers(collection, event);
+        });
         return id;
     }
     /**
      * Get entity from workspace
      */
     async get(collection, entityId) {
-        // In full implementation, would query FeltDB backend
-        // For now, returns null (placeholder)
-        return null;
+        return this.requireTransport().get({ workspaceId: this.workspaceId, collection, entityId });
     }
     /**
      * Query entities in workspace collection
      */
     async query(collection) {
-        // In full implementation, would query FeltDB backend
-        // For now, returns empty array (placeholder)
-        return [];
+        return this.requireTransport().query({ workspaceId: this.workspaceId, collection });
     }
     /**
      * Update entity in workspace
      */
     async update(collection, entityId, updates) {
-        const event = {
-            id: generateEventId(),
+        await this.requireTransport().update({
             workspaceId: this.workspaceId,
             collection,
             entityId,
-            type: 'updated',
-            value: updates,
-            timestamp: Date.now(),
+            updates,
             originClientId: this.clientId,
-        };
-        this.notifySubscribers(collection, event);
+        });
     }
     /**
      * Notify subscribers of entity changes
      */
-    notifySubscribers(collection, event) {
-        const handlers = this.subscriptions.get(collection);
+    notifySubscribers(event) {
+        const handlers = this.subscriptions.get(event.collection);
         if (handlers) {
             for (const handler of handlers) {
                 try {
@@ -275,6 +305,31 @@ export class DevelopmentWorkspaceConnection {
             }
         }
     }
+    requireTransport() {
+        if (!this.transport)
+            throw new Error('Development Workspace is not connected');
+        return this.transport;
+    }
+    async resolveEndpoint() {
+        if (this.options.endpoint)
+            return this.options.endpoint;
+        const environmentEndpoint = typeof process !== 'undefined'
+            ? process.env.FELTDB_WORKSPACE_ENDPOINT || process.env.VITE_FELTDB_URL
+            : undefined;
+        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.authorityEndpoint || pairing.endpoint)
+                return pairing.authorityEndpoint || pairing.endpoint;
+        }
+        throw new Error('Cannot connect: workspace authority endpoint is required');
+    }
 }
 /**
  * Generate unique entity ID
@@ -288,3 +343,108 @@ function generateEntityId() {
 function generateEventId() {
     return `event_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
 }
+const ENTITY_COLLECTION = '_development_workspace_entities';
+const EVENT_COLLECTION = '_development_workspace_events';
+const CLIENT_COLLECTION = '_development_workspace_clients';
+class HttpWorkspaceTransport {
+    constructor(endpoint, token) {
+        this.seenEvents = new Set();
+        this.db = new HttpJsDb({ url: endpoint, token });
+    }
+    async assertReachable() {
+        const result = await this.db.query(ENTITY_COLLECTION);
+        if (!result.success)
+            throw new Error(`Workspace authority unavailable: ${result.error}`);
+    }
+    async registerClient(workspaceId, client) {
+        const result = await this.db.insert(`${CLIENT_COLLECTION}:${recordId(workspaceId, client.clientId)}`, JSON.stringify({ workspaceId, ...client }));
+        if (!result.success) {
+            const update = await this.db.update(`${CLIENT_COLLECTION}:${recordId(workspaceId, client.clientId)}`, JSON.stringify({ workspaceId, ...client }));
+            if (!update.success)
+                throw new Error(`Client registration failed: ${update.error}`);
+        }
+    }
+    async unregisterClient(workspaceId, clientId) {
+        const result = await this.db.delete(`${CLIENT_COLLECTION}:${recordId(workspaceId, clientId)}`);
+        if (!result.success && !String(result.error).includes('404'))
+            throw new Error(`Client cleanup failed: ${result.error}`);
+    }
+    async clients(workspaceId) {
+        return (await this.readCollection(CLIENT_COLLECTION))
+            .filter(client => client.workspaceId === workspaceId);
+    }
+    async publish(input) {
+        const envelope = { ...input, updatedAt: Date.now() };
+        const stored = await this.db.insert(`${ENTITY_COLLECTION}:${recordId(input.workspaceId, input.collection, input.entityId)}`, JSON.stringify(envelope));
+        if (!stored.success)
+            throw new Error(`Workspace publish failed: ${stored.error}`);
+        await this.appendEvent(input, 'created', input.value);
+    }
+    async get(input) {
+        const result = await this.db.get(`${ENTITY_COLLECTION}:${recordId(input.workspaceId, input.collection, input.entityId)}`);
+        if (!result.success)
+            throw new Error(`Workspace get failed: ${result.error}`);
+        if (!result.data)
+            return null;
+        const envelope = JSON.parse(result.data);
+        return envelope.workspaceId === input.workspaceId && envelope.collection === input.collection ? envelope.value : null;
+    }
+    async query(input) {
+        return (await this.readCollection(ENTITY_COLLECTION))
+            .filter(entity => entity.workspaceId === input.workspaceId && entity.collection === input.collection)
+            .map(entity => entity.value);
+    }
+    async update(input) {
+        const current = await this.get(input);
+        if (current === null)
+            throw new Error(`Workspace entity not found: ${input.entityId}`);
+        const value = { ...current, ...input.updates };
+        const envelope = { workspaceId: input.workspaceId, collection: input.collection, entityId: input.entityId, value, updatedAt: Date.now() };
+        const result = await this.db.update(`${ENTITY_COLLECTION}:${recordId(input.workspaceId, input.collection, input.entityId)}`, JSON.stringify(envelope));
+        if (!result.success)
+            throw new Error(`Workspace update failed: ${result.error}`);
+        await this.appendEvent(input, 'updated', value);
+    }
+    subscribe(workspaceId, handler) {
+        let stopped = false;
+        const subscribedAt = Date.now();
+        const unsubscribe = this.db.subscribe_changes(collection => {
+            if (collection !== EVENT_COLLECTION || stopped)
+                return;
+            void this.deliverEvents(workspaceId, subscribedAt, handler);
+        });
+        return () => { stopped = true; unsubscribe(); };
+    }
+    async appendEvent(input, type, value) {
+        const event = { id: generateEventId(), ...input, type, value, timestamp: Date.now() };
+        const result = await this.db.insert(`${EVENT_COLLECTION}:${event.id}`, JSON.stringify(event));
+        if (!result.success)
+            throw new Error(`Workspace event persistence failed: ${result.error}`);
+    }
+    async deliverEvents(workspaceId, subscribedAt, handler) {
+        for (const event of await this.readCollection(EVENT_COLLECTION)) {
+            if (event.workspaceId !== workspaceId || event.timestamp < subscribedAt || this.seenEvents.has(event.id))
+                continue;
+            this.seenEvents.add(event.id);
+            handler(event);
+        }
+    }
+    async readCollection(collection) {
+        const result = await this.db.query(collection);
+        if (!result.success)
+            throw new Error(`Workspace query failed: ${result.error}`);
+        return result.data ? JSON.parse(result.data) : [];
+    }
+}
+function recordId(...parts) {
+    const value = parts.join('\u0000');
+    const hash = (seed) => {
+        let current = seed;
+        for (const byte of new TextEncoder().encode(value)) {
+            current ^= BigInt(byte);
+            current = BigInt.asUintN(64, current * 0x100000001b3n);
+        }
+        return current.toString(16).padStart(16, '0');
+    };
+    return `workspace_${hash(0xcbf29ce484222325n)}${hash(0x84222325cbf29ce4n)}`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feltdb/core",
-  "version": "0.6.2",
+  "version": "0.6.4",
   "description": "FeltDB Core - Application-facing database with Browser, Local, and Server runtimes. Durable state, reactive APIs.",
   "license": "MIT",
   "type": "module",
@@ -56,6 +56,7 @@
   "scripts": {
     "build": "rm -rf dist && tsc && node ../../tools/stage-core-wasm.mjs && npm run build --workspace @feltdb/react && npm run build --workspace @feltdb/migration-sherpa && npm run build --workspace @feltdb/studio && npm run build --workspace @feltdb/cli && npm run build --workspace create-feltdb && node ../../tools/assemble-core-sdk.mjs",
     "test": "node ../../test-runner.ts",
+    "test:workspace-e2e": "node --test test/workspace-connection.e2e.test.mjs",
     "type-check": "tsc --noEmit"
   },
   "keywords": [