create-feltdb 0.6.10 → 0.6.12

package/dist/cli.js

@@ -345,17 +345,19 @@ Learn more: https://github.com/rkendel1/feltdb`);
                     console.log('Build the production application image with: docker compose build app');
                 }
                 else {
-                    console.log('\n🚀 Starting the application and FeltDB Studio...\n');
+                    console.log('\n🚀 Starting the application...\n');
                     await run(npm, ['run', 'dev'], projectDir);
                 }
             }
         }
         else {
-            console.log('Project is ready. Start everything with:');
+            console.log('Project is ready. Start the application with:');
             console.log(`  cd ${projectName}`);
             if (!shouldInstall)
                 console.log('  npm install');
             console.log('  npm run dev');
+            console.log('Start FeltDB development tooling separately with:');
+            console.log('  npm run feltdb:dev');
         }
     }
     catch (error) {

package/dist/create.js

@@ -7,6 +7,7 @@ import { randomBytes } from 'crypto';
 import { feltdbPackageRange } from './package-versions.js';
 import { generateDockerCompose, generateDockerfile, generateDockerIgnore, generateDotEnvLocal, generateFeltDBDockerfile, generateStudioDockerfile, } from './docker-compose-generator.js';
 import { initializeWorkspace, appendWorkspaceGitignore, } from './workspace-initialization.js';
+import { frameworkScaffold } from './frameworks.js';
 export async function createProject(options) {
     const { projectName, templatesDir } = options;
     const projectDir = path.resolve(process.cwd(), projectName);
@@ -29,6 +30,7 @@ export async function createProject(options) {
     fs.mkdirSync(feltdbConfigDir, { recursive: true });
     const runtime = options.runtime || 'browser';
     const framework = options.framework || 'react';
+    const applicationFramework = frameworkScaffold(framework);
     const distributed = options.distributed !== false;
     const hasAgents = options.agents !== false;
     const hasWebLLM = options.webllm !== false;
@@ -41,7 +43,8 @@ export async function createProject(options) {
         main: 'src/index.ts',
         type: 'module',
         scripts: {
-            dev: 'feltdb dev',
+            dev: applicationFramework.applicationDevCommand,
+            'feltdb:dev': 'feltdb dev',
             build: 'feltdb build',
             test: 'node --test',
             feltdb: 'feltdb',
@@ -81,6 +84,10 @@ export async function createProject(options) {
         agents: {
             enabled: hasAgents,
         },
+        application: {
+            lifecycle: 'managed',
+        },
+        applicationUrl: 'http://127.0.0.1:5173',
         capabilities: {},
     };
     if (capabilities.includes('search')) {
@@ -185,13 +192,23 @@ ${hasAgents ? `  agent WorkspaceAssistant {
     fs.writeFileSync(path.join(projectDir, 'tsconfig.json'), JSON.stringify(tsconfig, null, 2));
     // Create main application files
     const runtimeOptions = runtime === 'browser'
-        ? "{ namespace: '" + applicationName + "', browser: true }"
+        ? "{ namespace: import.meta.env.VITE_FELTDB_NAMESPACE || '" + applicationName + "', browser: true }"
         : runtime === 'managed'
-            ? "{ namespace: import.meta.env.VITE_FELTDB_MANAGED_NAMESPACE || '" + applicationName + "', server: { url: import.meta.env.VITE_FELTDB_MANAGED_URL || import.meta.env.VITE_FELTDB_URL || '', token: import.meta.env.VITE_FELTDB_MANAGED_API_KEY || import.meta.env.VITE_FELTDB_API_KEY || '' } }"
+            ? "{ namespace: import.meta.env.VITE_FELTDB_MANAGED_NAMESPACE || import.meta.env.VITE_FELTDB_NAMESPACE || '" + applicationName + "', server: { url: import.meta.env.VITE_FELTDB_MANAGED_URL || import.meta.env.VITE_FELTDB_URL || '', token: import.meta.env.VITE_FELTDB_MANAGED_API_KEY || import.meta.env.VITE_FELTDB_API_KEY || '' } }"
             : runtime === 'self-hosted'
-                ? "{ namespace: '" + applicationName + "', server: { url: import.meta.env.VITE_FELTDB_URL || 'http://localhost:7700', token: import.meta.env.VITE_FELTDB_API_KEY || '' } }"
-                : "{ namespace: '" + applicationName + "', memory: true }";
-    const feltdbTs = `import { createFeltDB } from '@feltdb/core';
+                ? "{ namespace: import.meta.env.VITE_FELTDB_NAMESPACE || '" + applicationName + "', server: { url: import.meta.env.VITE_FELTDB_URL || 'http://localhost:7700', token: import.meta.env.VITE_FELTDB_API_KEY || '' } }"
+                : "{ namespace: import.meta.env.VITE_FELTDB_NAMESPACE || '" + applicationName + "', memory: true }";
+    const feltdbTs = `import { configureDevelopmentRuntimeBridge, createFeltDB } from '@feltdb/core';
+
+configureDevelopmentRuntimeBridge({
+  sessionId: import.meta.env.VITE_FELTDB_DEV_SESSION_ID,
+  workspaceId: import.meta.env.VITE_FELTDB_WORKSPACE_ID,
+  namespace: import.meta.env.VITE_FELTDB_NAMESPACE,
+  runtime: import.meta.env.VITE_FELTDB_RUNTIME,
+  authorityUrl: import.meta.env.VITE_FELTDB_AUTHORITY_URL,
+  bridgeUrl: import.meta.env.VITE_FELTDB_DEV_BRIDGE_URL,
+  applicationUrl: import.meta.env.VITE_FELTDB_APPLICATION_URL,
+});
 
 export const db = createFeltDB(${runtimeOptions});
 
@@ -1523,6 +1540,8 @@ A FeltDB Workspace application demonstrating local-first database capabilities.
 
 ## Quick Start
 
+Start the application:
+
 \`\`\`bash
 npm install
 npm run dev
@@ -1530,6 +1549,13 @@ npm run dev
 
 The application will be available at http://localhost:5173 (or your configured port).
 
+In a second terminal, start FeltDB authority, pairing, and Studio and attach it
+to the application explicitly:
+
+\`\`\`bash
+npm run feltdb:dev
+\`\`\`
+
 ## FeltDB Workspace Showcase
 
 This application demonstrates core FeltDB capabilities:
@@ -1628,6 +1654,10 @@ Configuration is in \`feltdb.config.json\`:
   "agents": {
     "enabled": ${hasAgents}
   },
+  "application": {
+    "lifecycle": "managed"
+  },
+  "applicationUrl": "http://127.0.0.1:5173",
   "capabilities": ["${capabilities}"]
 }
 \`\`\`
@@ -1653,6 +1683,12 @@ These are required when connecting to an authenticated self-hosted or managed Fe
 npm run dev
 \`\`\`
 
+### Start FeltDB Development Tooling
+
+\`\`\`bash
+npm run feltdb:dev
+\`\`\`
+
 ### Build for Production
 \`\`\`bash
 npm run build

package/dist/frameworks.js

@@ -0,0 +1,18 @@
+const FRAMEWORK_SCAFFOLDS = {
+    react: {
+        name: 'react',
+        applicationDevCommand: 'vite',
+    },
+    vanilla: {
+        name: 'vanilla',
+        applicationDevCommand: 'vite',
+    },
+};
+/** Resolve framework-owned application lifecycle metadata. */
+export function frameworkScaffold(framework) {
+    const scaffold = FRAMEWORK_SCAFFOLDS[framework];
+    if (!scaffold) {
+        throw new Error(`Unsupported framework "${framework}". Choose react or vanilla.`);
+    }
+    return scaffold;
+}

package/dist/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.10';
+export const FELTDB_PACKAGE_VERSION = '0.6.12';
 export const feltdbPackageRange = `^${FELTDB_PACKAGE_VERSION}`;

package/dist/workspace-initialization.js

@@ -7,14 +7,13 @@
  */
 import fs from 'fs';
 import path from 'path';
+import { randomBytes } from 'crypto';
 /**
  * Generate a unique workspace ID
- * Format: ws_<projectId>_<timestamp>_<random>
+ * Opaque format: ws_<random>. Project identity is stored separately.
  */
-export function generateWorkspaceId(projectId) {
-    const timestamp = Date.now();
-    const random = Math.random().toString(36).substring(2, 9);
-    return `ws_${projectId}_${timestamp}_${random}`;
+export function generateWorkspaceId(_projectId) {
+    return `ws_${randomBytes(16).toString('hex')}`;
 }
 /**
  * Initialize development workspace for a new project

package/package.json

@@ -2,7 +2,7 @@
   "name": "create-feltdb",
   "private": false,
   "description": "Create a new FeltDB application with one command",
-  "version": "0.6.10",
+  "version": "0.6.12",
   "license": "MIT",
   "bin": {
     "create-feltdb": "bin/create-feltdb.js"