@flight-framework/cli 0.2.1 → 0.3.0

package/dist/bin.js

@@ -8,7 +8,7 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 
 // src/index.ts
 import { cac } from "cac";
-import pc6 from "picocolors";
+import pc7 from "picocolors";
 
 // src/version.ts
 var VERSION = "0.0.1";
@@ -1832,18 +1832,471 @@ ${pc5.cyan("Quick example:")}
   console.log(`${pc5.dim("Docs:")} https://flight.dev/docs/packages/${packageName}`);
 }
 
+// src/commands/adapter-create.ts
+import { existsSync as existsSync7, mkdirSync as mkdirSync4, writeFileSync as writeFileSync5 } from "fs";
+import { join as join6 } from "path";
+import pc6 from "picocolors";
+async function adapterCreateCommand(name, options = {}) {
+  const cwd = process.cwd();
+  const adapterName = name.toLowerCase().replace(/[^a-z0-9-]/g, "-");
+  const packageName = `@flight-framework/adapter-${adapterName}`;
+  const outputDir = options.outputDir || join6(cwd, "packages", `adapter-${adapterName}`);
+  const type = options.type || "node";
+  const includeValidation = options.validation || false;
+  console.log(pc6.cyan(`
+  Creating adapter: ${packageName}
+`));
+  if (existsSync7(outputDir)) {
+    console.error(pc6.red(`  Error: Directory already exists: ${outputDir}`));
+    process.exit(1);
+  }
+  mkdirSync4(join6(outputDir, "src"), { recursive: true });
+  mkdirSync4(join6(outputDir, "tests"), { recursive: true });
+  const files = generateAdapterFiles(adapterName, packageName, type, includeValidation);
+  for (const [filePath, content] of Object.entries(files)) {
+    const fullPath = join6(outputDir, filePath);
+    writeFileSync5(fullPath, content, "utf-8");
+    console.log(pc6.green(`  \u2713 Created ${filePath}`));
+  }
+  console.log(pc6.cyan(`
+  Adapter created successfully!
+
+  Next steps:
+    1. cd packages/adapter-${adapterName}
+    2. Implement your adapter logic in src/index.ts
+    3. Run: pnpm build
+    4. Test: pnpm test
+
+  Documentation:
+    https://flight.dev/docs/adapters/custom
+`));
+}
+function generateAdapterFiles(name, packageName, type, includeValidation) {
+  const pascalName = name.split("-").map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join("");
+  return {
+    "package.json": generatePackageJson(packageName, includeValidation),
+    "tsconfig.json": generateTsConfig(),
+    "tsup.config.ts": generateTsupConfig(),
+    "src/index.ts": generateAdapterSource(name, pascalName, type, includeValidation),
+    "tests/adapter.test.ts": generateAdapterTest(name, pascalName),
+    "README.md": generateReadme(name, packageName)
+  };
+}
+function generatePackageJson(packageName, includeValidation) {
+  const pkg = {
+    name: packageName,
+    version: "0.1.0",
+    description: `Flight adapter for custom platform`,
+    type: "module",
+    main: "./dist/index.js",
+    types: "./dist/index.d.ts",
+    exports: {
+      ".": {
+        types: "./dist/index.d.ts",
+        import: "./dist/index.js"
+      }
+    },
+    scripts: {
+      build: "tsup",
+      test: "vitest run",
+      "test:watch": "vitest"
+    },
+    dependencies: {
+      "@flight-framework/core": "^0.4.0"
+    },
+    devDependencies: {
+      tsup: "^8.0.0",
+      typescript: "^5.0.0",
+      vitest: "^2.0.0",
+      ...includeValidation ? { zod: "^3.23.0" } : {}
+    },
+    peerDependencies: includeValidation ? {
+      zod: "^3.0.0"
+    } : void 0,
+    peerDependenciesMeta: includeValidation ? {
+      zod: { optional: true }
+    } : void 0
+  };
+  return JSON.stringify(pkg, null, 2);
+}
+function generateTsConfig() {
+  return JSON.stringify({
+    extends: "../../tsconfig.base.json",
+    compilerOptions: {
+      outDir: "./dist",
+      rootDir: "./src"
+    },
+    include: ["src"]
+  }, null, 2);
+}
+function generateTsupConfig() {
+  return `import { defineConfig } from 'tsup';
+
+export default defineConfig({
+    entry: ['src/index.ts'],
+    format: ['esm'],
+    dts: true,
+    clean: true,
+    target: 'node20',
+});
+`;
+}
+function generateAdapterSource(name, pascalName, type, includeValidation) {
+  if (includeValidation) {
+    return `/**
+ * Flight Adapter - ${pascalName}
+ * 
+ * Custom deployment adapter with optional Zod validation.
+ */
+
+import { createValidatedAdapter, type AdapterBuilder } from '@flight-framework/core/adapters';
+import { z } from 'zod';
+
+// ============================================================================
+// Options Schema (Optional - Zod validation)
+// ============================================================================
+
+const optionsSchema = z.object({
+    /** Server port */
+    port: z.number().default(3000),
+    /** Enable health check endpoint */
+    healthCheck: z.boolean().default(true),
+    /** Custom environment variables */
+    env: z.record(z.string()).optional(),
+});
+
+export type ${pascalName}AdapterOptions = z.infer<typeof optionsSchema>;
+
+// ============================================================================
+// Adapter Implementation
+// ============================================================================
+
+export default createValidatedAdapter('${name}', optionsSchema, (options) => ({
+    async adapt(builder: AdapterBuilder) {
+        builder.log.info(\`Building for ${pascalName} platform...\`);
+        builder.log.info(\`Port: \${options.port}\`);
+
+        // Generate server entry
+        await generateServerEntry(builder, options);
+
+        // Generate platform-specific config
+        await generatePlatformConfig(builder, options);
+
+        builder.log.info('Build complete!');
+    },
+
+    supports: {
+        node: () => ${type === "node" || type === "container"},
+        edge: () => ${type === "edge" || type === "serverless"},
+        streaming: () => ${type === "node"},
+        websockets: () => ${type === "node"},
+    },
+
+    emulate: () => ({
+        env: {
+            ${name.toUpperCase().replace(/-/g, "_")}_PLATFORM: 'true',
+            PORT: String(options.port),
+        },
+    }),
+}));
+
+// ============================================================================
+// Generator Functions
+// ============================================================================
+
+async function generateServerEntry(builder: AdapterBuilder, options: ${pascalName}AdapterOptions): Promise<void> {
+    const serverCode = \`
+import { createUniversalHandler } from '@flight-framework/core/adapters';
+import manifest from './manifest.js';
+
+const handler = createUniversalHandler(manifest);
+
+const server = Bun.serve({
+    port: \${options.port},
+    fetch: handler,
+});
+
+console.log(\\\`Server running at http://localhost:\${options.port}\\\`);
+\`;
+
+    await builder.writeFile('server.ts', serverCode.trim());
+}
+
+async function generatePlatformConfig(builder: AdapterBuilder, options: ${pascalName}AdapterOptions): Promise<void> {
+    const config = {
+        name: '${name}-app',
+        port: options.port,
+        healthCheck: options.healthCheck ? '/health' : null,
+    };
+
+    await builder.writeFile('platform.json', JSON.stringify(config, null, 2));
+}
+`;
+  }
+  return `/**
+ * Flight Adapter - ${pascalName}
+ * 
+ * Custom deployment adapter for ${pascalName} platform.
+ * 
+ * @example
+ * \`\`\`typescript
+ * import ${name.replace(/-/g, "")} from '${name.includes("@") ? name : `@flight-framework/adapter-${name}`}';
+ * 
+ * export default defineConfig({
+ *     adapter: ${name.replace(/-/g, "")}({
+ *         port: 3000,
+ *     }),
+ * });
+ * \`\`\`
+ */
+
+import { createAdapter, type AdapterBuilder } from '@flight-framework/core/adapters';
+
+// ============================================================================
+// Options Interface
+// ============================================================================
+
+export interface ${pascalName}AdapterOptions {
+    /** Server port (default: 3000) */
+    port?: number;
+    /** Enable health check endpoint (default: true) */
+    healthCheck?: boolean;
+    /** Custom environment variables */
+    env?: Record<string, string>;
+}
+
+// ============================================================================
+// Adapter Implementation
+// ============================================================================
+
+export default function ${name.replace(/-/g, "")}Adapter(options: ${pascalName}AdapterOptions = {}) {
+    const {
+        port = 3000,
+        healthCheck = true,
+        env = {},
+    } = options;
+
+    return createAdapter({
+        name: '${name}',
+
+        async adapt(builder: AdapterBuilder) {
+            builder.log.info(\`Building for ${pascalName} platform...\`);
+            builder.log.info(\`Port: \${port}\`);
+
+            // Generate server entry
+            await generateServerEntry(builder, port, healthCheck);
+
+            // Generate platform-specific config
+            await generatePlatformConfig(builder, port, healthCheck);
+
+            builder.log.info('Build complete!');
+        },
+
+        supports: {
+            node: () => ${type === "node" || type === "container"},
+            edge: () => ${type === "edge" || type === "serverless"},
+            streaming: () => ${type === "node"},
+            websockets: () => ${type === "node"},
+        },
+
+        emulate: () => ({
+            env: {
+                ${name.toUpperCase().replace(/-/g, "_")}_PLATFORM: 'true',
+                PORT: String(port),
+                ...env,
+            },
+        }),
+    });
+}
+
+// ============================================================================
+// Generator Functions
+// ============================================================================
+
+async function generateServerEntry(
+    builder: AdapterBuilder,
+    port: number,
+    healthCheck: boolean
+): Promise<void> {
+    const serverCode = \`
+import { createServer } from 'node:http';
+import { createUniversalHandler } from '@flight-framework/core/adapters';
+import manifest from './manifest.js';
+
+const handler = createUniversalHandler(manifest);
+
+const server = createServer(async (req, res) => {
+    const url = req.url || '/';
+    
+    // Health check endpoint
+    if (url === '/health' && \${healthCheck}) {
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ status: 'ok' }));
+        return;
+    }
+
+    // Handle request with Flight
+    const webReq = new Request(\\\`http://localhost\${url}\\\`, {
+        method: req.method,
+        headers: Object.fromEntries(
+            Object.entries(req.headers).filter(([_, v]) => v != null).map(([k, v]) => [k, String(v)])
+        ),
+    });
+
+    const response = await handler(webReq);
+
+    res.writeHead(response.status, Object.fromEntries(response.headers));
+    res.end(await response.text());
+});
+
+server.listen(\${port}, () => {
+    console.log(\\\`Server running at http://localhost:\${port}\\\`);
+});
+\`;
+
+    await builder.writeFile('server.mjs', serverCode.trim());
+}
+
+async function generatePlatformConfig(
+    builder: AdapterBuilder,
+    port: number,
+    healthCheck: boolean
+): Promise<void> {
+    const config = {
+        name: '${name}-app',
+        port,
+        healthCheck: healthCheck ? '/health' : null,
+    };
+
+    await builder.writeFile('platform.json', JSON.stringify(config, null, 2));
+}
+`;
+}
+function generateAdapterTest(name, pascalName) {
+  return `/**
+ * ${pascalName} Adapter Tests
+ */
+
+import { describe, it, expect, vi } from 'vitest';
+import adapter from '../src/index.js';
+
+describe('adapter-${name}', () => {
+    const createMockBuilder = () => ({
+        manifest: {
+            entries: {},
+            files: [],
+            routes: [],
+        },
+        root: '/test',
+        outDir: '/test/dist',
+        readFile: vi.fn(),
+        writeFile: vi.fn(),
+        copy: vi.fn(),
+        glob: vi.fn(),
+        log: {
+            info: vi.fn(),
+            warn: vi.fn(),
+            error: vi.fn(),
+        },
+    });
+
+    it('should have correct name', () => {
+        const instance = adapter();
+        expect(instance.name).toBe('${name}');
+    });
+
+    it('should generate server entry', async () => {
+        const instance = adapter({ port: 4000 });
+        const builder = createMockBuilder();
+
+        await instance.adapt(builder);
+
+        expect(builder.writeFile).toHaveBeenCalledWith(
+            'server.mjs',
+            expect.stringContaining('4000')
+        );
+    });
+
+    it('should generate platform config', async () => {
+        const instance = adapter();
+        const builder = createMockBuilder();
+
+        await instance.adapt(builder);
+
+        expect(builder.writeFile).toHaveBeenCalledWith(
+            'platform.json',
+            expect.any(String)
+        );
+    });
+
+    it('should declare supported features', () => {
+        const instance = adapter();
+
+        expect(instance.supports?.node?.()).toBeDefined();
+        expect(instance.supports?.streaming?.()).toBeDefined();
+    });
+
+    it('should provide emulation environment', () => {
+        const instance = adapter({ port: 5000 });
+        const emulation = instance.emulate?.();
+
+        expect(emulation?.env?.PORT).toBe('5000');
+        expect(emulation?.env?.${name.toUpperCase().replace(/-/g, "_")}_PLATFORM).toBe('true');
+    });
+});
+`;
+}
+function generateReadme(name, packageName) {
+  return `# ${packageName}
+
+Flight adapter for ${name} platform.
+
+## Installation
+
+\`\`\`bash
+npm install ${packageName}
+\`\`\`
+
+## Usage
+
+\`\`\`typescript
+import { defineConfig } from '@flight-framework/core';
+import ${name.replace(/-/g, "")} from '${packageName}';
+
+export default defineConfig({
+    adapter: ${name.replace(/-/g, "")}({
+        port: 3000,
+        healthCheck: true,
+    }),
+});
+\`\`\`
+
+## Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| \`port\` | \`number\` | \`3000\` | Server port |
+| \`healthCheck\` | \`boolean\` | \`true\` | Enable health check endpoint |
+| \`env\` | \`Record<string, string>\` | \`{}\` | Custom environment variables |
+
+## License
+
+MIT
+`;
+}
+
 // src/index.ts
 var cli = cac("flight");
 var LOGO = `
-${pc6.cyan("  \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557     \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557  \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557")}
-${pc6.cyan("  \u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D \u2588\u2588\u2551  \u2588\u2588\u2551\u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D")}
-${pc6.cyan("  \u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551   \u2588\u2588\u2551   ")}
-${pc6.cyan("  \u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551   \u2588\u2588\u2551   ")}
-${pc6.cyan("  \u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551  \u2588\u2588\u2551   \u2588\u2588\u2551   ")}
-${pc6.cyan("  \u255A\u2550\u255D     \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u255D  \u255A\u2550\u255D   \u255A\u2550\u255D   ")}
+${pc7.cyan("  \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557     \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557  \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557")}
+${pc7.cyan("  \u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D \u2588\u2588\u2551  \u2588\u2588\u2551\u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D")}
+${pc7.cyan("  \u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551   \u2588\u2588\u2551   ")}
+${pc7.cyan("  \u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551   \u2588\u2588\u2551   ")}
+${pc7.cyan("  \u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551  \u2588\u2588\u2551   \u2588\u2588\u2551   ")}
+${pc7.cyan("  \u255A\u2550\u255D     \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u255D  \u255A\u2550\u255D   \u255A\u2550\u255D   ")}
   
-  ${pc6.dim("The Agnostic Full-Stack Framework")}
-  ${pc6.dim("Maximum Flexibility. Zero Lock-in.")}
+  ${pc7.dim("The Agnostic Full-Stack Framework")}
+  ${pc7.dim("Maximum Flexibility. Zero Lock-in.")}
 `;
 function printLogo() {
   console.log(LOGO);
@@ -1857,6 +2310,7 @@ cli.command("build", "Build for production").option("--outDir <dir>", "Output di
 cli.command("preview", "Preview production build").option("-p, --port <port>", "Port to listen on").option("-h, --host <host>", "Host to bind to").option("--open", "Open browser on start").action(previewCommand);
 cli.command("routes:generate", "Generate route manifest from routes directory").option("--routesDir <dir>", "Routes directory", { default: "src/routes" }).option("--outputDir <dir>", "Output directory", { default: "src/.flight" }).action(routesGenerateCommand);
 cli.command("types:generate", "Generate TypeScript types for routes and environment").option("--routesDir <dir>", "Routes directory", { default: "src/routes" }).option("--outputDir <dir>", "Output directory", { default: "src/.flight" }).option("--routes", "Generate route types", { default: true }).option("--env", "Generate environment variable types").option("--watch", "Watch for changes and regenerate").action(typesGenerateCommand);
+cli.command("adapter:create <name>", "Create a new adapter package").option("-t, --type <type>", "Platform type (node, edge, container, serverless)", { default: "node" }).option("--validation", "Include Zod validation example").option("--outputDir <dir>", "Output directory").action(adapterCreateCommand);
 function run() {
   try {
     cli.parse(process.argv, { run: false });
@@ -1865,7 +2319,7 @@ function run() {
     }
     cli.runMatchedCommand();
   } catch (error) {
-    console.error(pc6.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc7.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 }