@plures/praxis 1.0.2 → 1.1.0

package/src/cli/commands/cloud.ts

@@ -1,17 +1,17 @@
 /**
  * Cloud CLI Commands
- * 
+ *
  * CLI commands for Praxis Cloud connectivity.
  */
 
-import * as fs from "fs";
-import * as path from "path";
-import { authenticateWithDeviceFlow } from "../../cloud/auth.js";
-import { connectRelay } from "../../cloud/client.js";
-import type { CloudRelayConfig } from "../../cloud/types.js";
+import * as fs from 'fs';
+import * as path from 'path';
+import { authenticateWithDeviceFlow } from '../../cloud/auth.js';
+import { connectRelay } from '../../cloud/client.js';
+import type { CloudRelayConfig } from '../../cloud/types.js';
 
-const CONFIG_FILE = ".praxis-cloud.json";
-const GITHUB_CLIENT_ID = "Ov23liQxF7P0BqUxVXHk"; // Demo client ID (replace in production)
+const CONFIG_FILE = '.praxis-cloud.json';
+const GITHUB_CLIENT_ID = 'Ov23liQxF7P0BqUxVXHk'; // Demo client ID (replace in production)
 
 interface StoredConfig {
   endpoint: string;
@@ -28,11 +28,11 @@ function loadConfig(): StoredConfig | null {
   try {
     const configPath = path.join(process.cwd(), CONFIG_FILE);
     if (fs.existsSync(configPath)) {
-      const data = fs.readFileSync(configPath, "utf-8");
+      const data = fs.readFileSync(configPath, 'utf-8');
       return JSON.parse(data);
     }
   } catch (error) {
-    console.warn("Failed to load cloud configuration:", error);
+    console.warn('Failed to load cloud configuration:', error);
   }
   return null;
 }
@@ -46,7 +46,7 @@ function saveConfig(config: StoredConfig): void {
     fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
     console.log(`\n✓ Configuration saved to ${CONFIG_FILE}`);
   } catch (error) {
-    console.error("Failed to save cloud configuration:", error);
+    console.error('Failed to save cloud configuration:', error);
     throw error;
   }
 }
@@ -60,14 +60,14 @@ export async function cloudInit(options: {
   autoSync?: boolean;
   interval?: string;
 }): Promise<void> {
-  console.log("\n╔═══════════════════════════════════════════════════╗");
-  console.log("║   Welcome to Praxis Cloud Setup Wizard           ║");
-  console.log("╚═══════════════════════════════════════════════════╝\n");
+  console.log('\n╔═══════════════════════════════════════════════════╗');
+  console.log('║   Welcome to Praxis Cloud Setup Wizard           ║');
+  console.log('╚═══════════════════════════════════════════════════╝\n');
 
   // Check if already configured
   const existingConfig = loadConfig();
   if (existingConfig) {
-    console.log("⚠  Existing cloud configuration found.");
+    console.log('⚠  Existing cloud configuration found.');
     console.log(`   Endpoint: ${existingConfig.endpoint}`);
     console.log(`   App ID: ${existingConfig.appId}\n`);
     // In production, prompt user to confirm overwrite
@@ -77,7 +77,7 @@ export async function cloudInit(options: {
   let endpoint = options.endpoint;
   if (!endpoint) {
     // In production, prompt user for input
-    endpoint = "https://praxis-relay.azurewebsites.net";
+    endpoint = 'https://praxis-relay.azurewebsites.net';
     console.log(`Using default endpoint: ${endpoint}`);
   }
 
@@ -90,18 +90,18 @@ export async function cloudInit(options: {
   }
 
   // Authenticate with GitHub
-  console.log("\n🔐 Authenticating with GitHub...");
+  console.log('\n🔐 Authenticating with GitHub...');
   const authResult = await authenticateWithDeviceFlow(GITHUB_CLIENT_ID);
 
   if (!authResult.success || !authResult.token) {
-    console.error("\n✗ Authentication failed");
+    console.error('\n✗ Authentication failed');
     process.exit(1);
   }
 
-  console.log(`✓ Authenticated as ${authResult.user?.login || "unknown"}`);
+  console.log(`✓ Authenticated as ${authResult.user?.login || 'unknown'}`);
 
   // Test connection
-  console.log("\n🔗 Testing connection to Praxis Cloud...");
+  console.log('\n🔗 Testing connection to Praxis Cloud...');
 
   try {
     const config: CloudRelayConfig = {
@@ -115,8 +115,8 @@ export async function cloudInit(options: {
     const client = await connectRelay(endpoint, config);
     const health = await client.getHealth();
 
-    if (health.status === "healthy") {
-      console.log("✓ Connected successfully!");
+    if (health.status === 'healthy') {
+      console.log('✓ Connected successfully!');
       console.log(`  Status: ${health.status}`);
       console.log(`  Version: ${health.version}`);
     } else {
@@ -136,19 +136,19 @@ export async function cloudInit(options: {
 
     saveConfig(storedConfig);
 
-    console.log("\n✓ Praxis Cloud is now configured!");
-    console.log("\nNext steps:");
+    console.log('\n✓ Praxis Cloud is now configured!');
+    console.log('\nNext steps:');
     console.log("  • Use 'praxis cloud status' to check connection");
     console.log("  • Use 'praxis cloud sync' to manually sync");
     console.log("  • Use 'praxis cloud usage' to view metrics");
-    console.log("\nIn your code:");
+    console.log('\nIn your code:');
     console.log('  import { connectRelay } from "@plures/praxis/cloud";');
     console.log(`  const relay = await connectRelay("${endpoint}", {`);
     console.log(`    appId: "${appId}",`);
     console.log(`    authToken: "<your-token>"`);
-    console.log("  });\n");
+    console.log('  });\n');
   } catch (error) {
-    console.error("\n✗ Failed to connect to Praxis Cloud");
+    console.error('\n✗ Failed to connect to Praxis Cloud');
     console.error(`  Error: ${error instanceof Error ? error.message : String(error)}`);
     process.exit(1);
   }
@@ -161,18 +161,18 @@ export async function cloudStatus(): Promise<void> {
   const config = loadConfig();
 
   if (!config) {
-    console.log("\n✗ No cloud configuration found");
+    console.log('\n✗ No cloud configuration found');
     console.log("  Run 'praxis cloud init' to set up cloud connection\n");
     process.exit(1);
   }
 
-  console.log("\n╔═══════════════════════════════════════════════════╗");
-  console.log("║   Praxis Cloud Status                             ║");
-  console.log("╚═══════════════════════════════════════════════════╝\n");
+  console.log('\n╔═══════════════════════════════════════════════════╗');
+  console.log('║   Praxis Cloud Status                             ║');
+  console.log('╚═══════════════════════════════════════════════════╝\n');
 
   console.log(`Endpoint: ${config.endpoint}`);
   console.log(`App ID: ${config.appId}`);
-  console.log(`Auto Sync: ${config.autoSync ? "enabled" : "disabled"}`);
+  console.log(`Auto Sync: ${config.autoSync ? 'enabled' : 'disabled'}`);
 
   if (config.autoSync) {
     console.log(`Sync Interval: ${config.syncInterval}ms`);
@@ -185,11 +185,11 @@ export async function cloudStatus(): Promise<void> {
     console.log(`\nConnection: ✓ Connected`);
     console.log(`Status: ${health.status}`);
     console.log(`Version: ${health.version}`);
-    console.log("\nServices:");
-    console.log(`  Relay: ${health.services.relay ? "✓" : "✗"}`);
-    console.log(`  Event Grid: ${health.services.eventGrid ? "✓" : "✗"}`);
-    console.log(`  Storage: ${health.services.storage ? "✓" : "✗"}`);
-    console.log(`  Auth: ${health.services.auth ? "✓" : "✗"}`);
+    console.log('\nServices:');
+    console.log(`  Relay: ${health.services.relay ? '✓' : '✗'}`);
+    console.log(`  Event Grid: ${health.services.eventGrid ? '✓' : '✗'}`);
+    console.log(`  Storage: ${health.services.storage ? '✓' : '✗'}`);
+    console.log(`  Auth: ${health.services.auth ? '✓' : '✗'}`);
 
     await client.disconnect();
   } catch (error) {
@@ -207,19 +207,19 @@ export async function cloudSync(): Promise<void> {
   const config = loadConfig();
 
   if (!config) {
-    console.log("\n✗ No cloud configuration found");
+    console.log('\n✗ No cloud configuration found');
     console.log("  Run 'praxis cloud init' to set up cloud connection\n");
     process.exit(1);
   }
 
-  console.log("\n🔄 Syncing to Praxis Cloud...");
+  console.log('\n🔄 Syncing to Praxis Cloud...');
 
   try {
     const client = await connectRelay(config.endpoint, config);
 
     // In production, collect actual facts and events to sync
     await client.sync({
-      type: "delta",
+      type: 'delta',
       appId: config.appId,
       clock: {},
       facts: [],
@@ -227,11 +227,11 @@ export async function cloudSync(): Promise<void> {
       timestamp: Date.now(),
     });
 
-    console.log("✓ Sync completed successfully\n");
+    console.log('✓ Sync completed successfully\n');
 
     await client.disconnect();
   } catch (error) {
-    console.error("\n✗ Sync failed");
+    console.error('\n✗ Sync failed');
     console.error(`  Error: ${error instanceof Error ? error.message : String(error)}\n`);
     process.exit(1);
   }
@@ -244,14 +244,14 @@ export async function cloudUsage(): Promise<void> {
   const config = loadConfig();
 
   if (!config) {
-    console.log("\n✗ No cloud configuration found");
+    console.log('\n✗ No cloud configuration found');
     console.log("  Run 'praxis cloud init' to set up cloud connection\n");
     process.exit(1);
   }
 
-  console.log("\n╔═══════════════════════════════════════════════════╗");
-  console.log("║   Praxis Cloud Usage Metrics                      ║");
-  console.log("╚═══════════════════════════════════════════════════╝\n");
+  console.log('\n╔═══════════════════════════════════════════════════╗');
+  console.log('║   Praxis Cloud Usage Metrics                      ║');
+  console.log('╚═══════════════════════════════════════════════════╝\n');
 
   try {
     const client = await connectRelay(config.endpoint, config);
@@ -274,7 +274,7 @@ export async function cloudUsage(): Promise<void> {
 
     await client.disconnect();
   } catch (error) {
-    console.error("\n✗ Failed to retrieve usage metrics");
+    console.error('\n✗ Failed to retrieve usage metrics');
     console.error(`  Error: ${error instanceof Error ? error.message : String(error)}\n`);
     process.exit(1);
   }

package/src/cli/commands/create.ts

@@ -1,6 +1,6 @@
 /**
  * Praxis Create Command
- * 
+ *
  * Creates new Praxis applications and components from templates.
  */
 
@@ -26,30 +26,30 @@ export interface CreateOptions {
 function generatePackageJson(name: string): string {
   const pkg = {
     name: name,
-    version: "0.1.0",
+    version: '0.1.0',
     private: true,
-    type: "module",
+    type: 'module',
     scripts: {
-      dev: "vite",
-      build: "tsc && vite build",
-      preview: "vite preview",
-      generate: "praxis generate",
-      test: "vitest"
+      dev: 'vite',
+      build: 'tsc && vite build',
+      preview: 'vite preview',
+      generate: 'praxis generate',
+      test: 'vitest',
     },
     dependencies: {
-      "@plures/praxis": "^0.2.1"
+      '@plures/praxis': '^0.2.1',
     },
     devDependencies: {
-      "@sveltejs/vite-plugin-svelte": "^5.0.0",
-      "@tsconfig/svelte": "^5.0.4",
-      "svelte": "^5.0.0",
-      "svelte-check": "^4.0.0",
-      "typescript": "^5.6.0",
-      "vite": "^6.0.0",
-      "vitest": "^4.0.0"
-    }
+      '@sveltejs/vite-plugin-svelte': '^5.0.0',
+      '@tsconfig/svelte': '^5.0.4',
+      svelte: '^5.0.0',
+      'svelte-check': '^4.0.0',
+      typescript: '^5.6.0',
+      vite: '^6.0.0',
+      vitest: '^4.0.0',
+    },
   };
-  
+
   return JSON.stringify(pkg, null, 2);
 }
 
@@ -58,22 +58,22 @@ function generatePackageJson(name: string): string {
  */
 function generateTsConfig(): string {
   const config = {
-    extends: "@tsconfig/svelte/tsconfig.json",
+    extends: '@tsconfig/svelte/tsconfig.json',
     compilerOptions: {
-      target: "ESNext",
-      module: "ESNext",
-      moduleResolution: "bundler",
+      target: 'ESNext',
+      module: 'ESNext',
+      moduleResolution: 'bundler',
       strict: true,
       esModuleInterop: true,
       skipLibCheck: true,
       resolveJsonModule: true,
       isolatedModules: true,
-      noEmit: true
+      noEmit: true,
     },
-    include: ["src/**/*"],
-    exclude: ["node_modules"]
+    include: ['src/**/*'],
+    exclude: ['node_modules'],
   };
-  
+
   return JSON.stringify(config, null, 2);
 }
 
@@ -441,18 +441,18 @@ coverage/
 async function createApp(name: string, options: CreateOptions): Promise<void> {
   const template = options.template || 'basic';
   const appDir = resolve(process.cwd(), name);
-  
+
   // Check if directory already exists
   if (existsSync(appDir)) {
     console.error(`\n✗ Directory '${name}' already exists`);
     console.error('  Please choose a different name or remove the existing directory.\n');
     process.exit(1);
   }
-  
+
   console.log(`\n📦 Creating Praxis application: ${name}`);
   console.log(`   Template: ${template}`);
   console.log(`   Location: ${appDir}\n`);
-  
+
   // Create directory structure
   const dirs = [
     appDir,
@@ -461,14 +461,14 @@ async function createApp(name: string, options: CreateOptions): Promise<void> {
     join(appDir, 'src', 'components'),
     join(appDir, 'src', 'logic'),
     join(appDir, 'src', 'store'),
-    join(appDir, 'public')
+    join(appDir, 'public'),
   ];
-  
+
   for (const dir of dirs) {
     await mkdir(dir, { recursive: true });
   }
   console.log('✓ Created directory structure');
-  
+
   // Write configuration files
   await writeFile(join(appDir, 'package.json'), generatePackageJson(name));
   await writeFile(join(appDir, 'tsconfig.json'), generateTsConfig());
@@ -477,21 +477,24 @@ async function createApp(name: string, options: CreateOptions): Promise<void> {
   await writeFile(join(appDir, '.gitignore'), generateGitignore());
   await writeFile(join(appDir, 'README.md'), generateReadme(name, template));
   console.log('✓ Created configuration files');
-  
+
   // Write source files
   await writeFile(join(appDir, 'index.html'), generateIndexHtml(name));
   await writeFile(join(appDir, 'src', 'main.ts'), generateMainTs(name));
   await writeFile(join(appDir, 'src', 'App.svelte'), generateAppSvelte(name));
   await writeFile(join(appDir, 'src', 'schemas', 'app.schema.js'), generateAppSchema(name));
   console.log('✓ Created source files');
-  
+
   // Create placeholder files for generated directories
-  await writeFile(join(appDir, 'src', 'components', '.gitkeep'), '# Generated components will be placed here\n');
+  await writeFile(
+    join(appDir, 'src', 'components', '.gitkeep'),
+    '# Generated components will be placed here\n'
+  );
   await writeFile(join(appDir, 'src', 'logic', '.gitkeep'), '# Logic files will be placed here\n');
   await writeFile(join(appDir, 'src', 'store', '.gitkeep'), '# Store files will be placed here\n');
   await writeFile(join(appDir, 'public', '.gitkeep'), '# Static assets go here\n');
   console.log('✓ Created placeholder files');
-  
+
   console.log(`
 ✅ Application created successfully!
 
@@ -598,29 +601,32 @@ function generateComponentSvelte(name: string): string {
 async function createComponent(name: string, options: CreateOptions): Promise<void> {
   const outputDir = options.directory || join(process.cwd(), 'src', 'components');
   const componentDir = join(outputDir, name);
-  
+
   // Check if component directory already exists
   if (existsSync(componentDir)) {
     console.error(`\n✗ Component '${name}' already exists at ${componentDir}`);
     console.error('  Please choose a different name or remove the existing component.\n');
     process.exit(1);
   }
-  
+
   console.log(`\n🧩 Creating component: ${name}`);
   console.log(`   Location: ${componentDir}\n`);
-  
+
   // Create component directory
   await mkdir(componentDir, { recursive: true });
-  
+
   // Write component files
   await writeFile(join(componentDir, `${name}.svelte`), generateComponentSvelte(name));
   await writeFile(join(componentDir, `${name}.schema.js`), generateComponentSchema(name));
-  await writeFile(join(componentDir, 'index.ts'), `export { default as ${name} } from './${name}.svelte';\n`);
-  
+  await writeFile(
+    join(componentDir, 'index.ts'),
+    `export { default as ${name} } from './${name}.svelte';\n`
+  );
+
   console.log(`✓ Created ${name}.svelte`);
   console.log(`✓ Created ${name}.schema.js`);
   console.log(`✓ Created index.ts`);
-  
+
   console.log(`
 ✅ Component created successfully!
 
@@ -637,20 +643,26 @@ Or use the schema for generation:
 /**
  * Execute the create command
  */
-export async function create(type: string, name: string | undefined, options: CreateOptions): Promise<void> {
+export async function create(
+  type: string,
+  name: string | undefined,
+  options: CreateOptions
+): Promise<void> {
   if (!name) {
     console.error('\n✗ Please provide a name for the ' + type);
     console.error(`  Usage: praxis create ${type} <name>\n`);
     process.exit(1);
   }
-  
+
   // Validate name
   if (!/^[a-zA-Z][a-zA-Z0-9-_]*$/.test(name)) {
     console.error('\n✗ Invalid name format');
-    console.error('  Name must start with a letter and contain only letters, numbers, hyphens, and underscores.\n');
+    console.error(
+      '  Name must start with a letter and contain only letters, numbers, hyphens, and underscores.\n'
+    );
     process.exit(1);
   }
-  
+
   switch (type) {
     case 'app':
       await createApp(name, options);

package/src/cli/commands/dev.ts

@@ -1,6 +1,6 @@
 /**
  * Development Server Command
- * 
+ *
  * Starts the Praxis development server with Vite.
  */
 
@@ -26,16 +26,16 @@ export interface DevOptions {
 export async function dev(options: DevOptions): Promise<void> {
   const port = options.port || '5173';
   const host = options.host || 'localhost';
-  
+
   console.log('\n╔═══════════════════════════════════════════════════╗');
   console.log('║   Praxis Development Server                       ║');
   console.log('╚═══════════════════════════════════════════════════╝\n');
-  
+
   // Check if we're in a Praxis project
   const packageJsonPath = path.join(process.cwd(), 'package.json');
   const viteConfigPath = path.join(process.cwd(), 'vite.config.ts');
   void viteConfigPath; // Silence unused variable warning
-  
+
   if (!fs.existsSync(packageJsonPath)) {
     console.error('Error: No package.json found in current directory.');
     console.log('Make sure you are in a Praxis project directory.\n');
@@ -43,10 +43,10 @@ export async function dev(options: DevOptions): Promise<void> {
     console.log('  praxis create app my-app\n');
     process.exit(1);
   }
-  
+
   // Read package.json to check for dev script
   const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
-  
+
   if (!packageJson.scripts?.dev) {
     console.error('Error: No "dev" script found in package.json.');
     console.log('\nTo use the Praxis dev server, add a dev script to your package.json:');
@@ -55,15 +55,15 @@ export async function dev(options: DevOptions): Promise<void> {
     console.log('  }\n');
     process.exit(1);
   }
-  
+
   console.log(`Starting development server on http://${host}:${port}\n`);
-  
+
   // Spawn npm run dev with port configuration
   const args = ['run', 'dev', '--', '--port', port, '--host', host];
   if (options.open) {
     args.push('--open');
   }
-  
+
   const child = spawn('npm', args, {
     stdio: 'inherit',
     shell: true,
@@ -73,19 +73,19 @@ export async function dev(options: DevOptions): Promise<void> {
       FORCE_COLOR: '1',
     },
   });
-  
+
   child.on('error', (error) => {
     console.error('Failed to start development server:', error.message);
     process.exit(1);
   });
-  
+
   child.on('exit', (code) => {
     if (code !== 0 && code !== null) {
       console.error(`Development server exited with code ${code}`);
       process.exit(code);
     }
   });
-  
+
   // Handle Ctrl+C gracefully
   process.on('SIGINT', () => {
     console.log('\n\nStopping development server...');