@feltdb/core 0.6.2 → 0.6.3

package/dist/cli/commands.js

@@ -525,6 +525,7 @@ async function handleDev(args) {
     if (workspace) {
         const token = generatePairingToken();
         token.workspaceId = workspace.workspaceId;
+        token.endpoint = process.env.VITE_FELTDB_URL;
         persistPairingToken(process.cwd(), token);
         pairingToken = token.token;
     }

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

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.3';
 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/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;
@@ -26,6 +27,7 @@ export interface PairingTokenData {
     token: string;
     workspaceId: string;
     expiresAt: number;
+    endpoint?: string;
 }
 export interface ClientInfo {
     clientId: string;
@@ -101,8 +103,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 +115,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 +122,7 @@ export declare class DevelopmentWorkspaceConnection {
     /**
      * List connected clients in workspace
      */
-    clients(): ClientInfo[];
+    clients(): Promise<ClientInfo[]>;
     /**
      * Subscribe to workspace entity changes
      *
@@ -157,18 +156,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

@@ -6,6 +6,7 @@
  */
 import fs from 'fs';
 import path from 'path';
+import { HttpJsDb } from '../http-db.js';
 /**
  * Discover workspace from .feltdb/workspace.json
  *
@@ -109,7 +110,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);
+    await connection.connect();
+    return connection;
 }
 /**
  * Generate a unique client ID based on type
@@ -130,7 +133,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 +144,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 +193,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 +226,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 +275,27 @@ 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 pairingPath = path.join(this.options.projectDir, '.feltdb', 'pairing.json');
+            const pairing = JSON.parse(fs.readFileSync(pairingPath, 'utf8'));
+            if (pairing.endpoint)
+                return pairing.endpoint;
+        }
+        throw new Error('Cannot connect: workspace authority endpoint is required');
+    }
 }
 /**
  * Generate unique entity ID
@@ -288,3 +309,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.3",
   "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": [