@spfn/cli 0.0.8 → 0.1.0-alpha.1

package/dist/templates/server/routes/examples/index.ts

@@ -0,0 +1,112 @@
+/**
+ * Example Routes: CRUD Operations
+ *
+ * File naming patterns:
+ * - routes/index/index.ts -> / (root route)
+ * - routes/users/index.ts -> /users
+ * - routes/users/[id]/index.ts -> /users/:id (dynamic parameter)
+ *
+ * Contracts are co-located in the same directory
+ */
+
+import { createApp } from '@spfn/core/route';
+import {
+    getExamplesContract,
+    getExampleContract,
+    createExampleContract,
+    updateExampleContract,
+    deleteExampleContract
+} from './contract.js';
+
+const app = createApp();
+
+// GET /examples - List examples with pagination
+app.bind(getExamplesContract, async (c) => {
+    const { limit = 10, offset = 0 } = c.query;
+
+    // Mock data - replace with actual database queries
+    const examples = [
+        {
+            id: '1',
+            name: 'File-based Routing',
+            description: 'Next.js style automatic route registration'
+        },
+        {
+            id: '2',
+            name: 'Contract-based Validation',
+            description: 'TypeBox schemas for end-to-end type safety'
+        },
+        {
+            id: '3',
+            name: 'Auto-generated Types',
+            description: 'Client code generation from contracts'
+        }
+    ];
+
+    return c.json({
+        examples: examples.slice(offset, offset + limit),
+        total: examples.length,
+        limit,
+        offset
+    });
+});
+
+// GET /examples/:id - Get single example
+app.bind(getExampleContract, async (c) => {
+    const { id } = c.params;
+
+    // Mock data - replace with actual database query
+    const example = {
+        id,
+        name: 'Example ' + id,
+        description: 'This is an example',
+        createdAt: Date.now(),
+        updatedAt: Date.now()
+    };
+
+    return c.json(example);
+});
+
+// POST /examples - Create example
+app.bind(createExampleContract, async (c) => {
+    const body = await c.data();
+
+    // Mock data - replace with actual database insert
+    const example = {
+        id: Math.random().toString(36).substring(7),
+        name: body.name,
+        description: body.description,
+        createdAt: Date.now()
+    };
+
+    return c.json(example);
+});
+
+// PUT /examples/:id - Update example
+app.bind(updateExampleContract, async (c) => {
+    const { id } = c.params;
+    const body = await c.data();
+
+    // Mock data - replace with actual database update
+    const example = {
+        id,
+        name: body.name || 'Updated Example',
+        description: body.description || 'Updated description',
+        updatedAt: Date.now()
+    };
+
+    return c.json(example);
+});
+
+// DELETE /examples/:id - Delete example
+app.bind(deleteExampleContract, async (c) => {
+    const { id } = c.params;
+
+    // Mock data - replace with actual database delete
+    return c.json({
+        success: true,
+        id
+    });
+});
+
+export default app;

package/dist/templates/server/routes/health/contract.ts

@@ -0,0 +1,13 @@
+import { Type } from '@sinclair/typebox';
+
+/**
+ * Health Check Contract
+ */
+export const healthContract = {
+    method: 'GET' as const,
+    path: '/',
+    response: Type.Object({
+        status: Type.String(),
+        timestamp: Type.Number()
+    })
+};

package/dist/templates/server/routes/health/index.ts

@@ -0,0 +1,23 @@
+/**
+ * Health Check Route
+ *
+ * Minimal endpoint for monitoring systems, load balancers, and orchestrators.
+ * Used by Kubernetes probes, uptime monitors, etc.
+ *
+ * Example: Using createApp() with separate contracts
+ */
+
+import { createApp } from '@spfn/core/route';
+import { healthContract } from './contract.js';
+
+const app = createApp();
+
+app.bind(healthContract, async (c) => {
+    return c.json({
+        status: 'ok',
+        timestamp: Date.now(),
+        uptime: process.uptime()
+    });
+});
+
+export default app;

package/dist/templates/server/routes/index/contract.ts

@@ -0,0 +1,13 @@
+import { Type } from '@sinclair/typebox';
+
+/**
+ * Root Contract
+ */
+export const rootContract = {
+    method: 'GET' as const,
+    path: '/',
+    response: Type.Object({
+        message: Type.String(),
+        version: Type.String()
+    })
+};

package/dist/templates/server/routes/index/index.ts

@@ -0,0 +1,28 @@
+/**
+ * Root Route: GET /
+ *
+ * Welcome page for SPFN API
+ */
+
+import { createApp } from '@spfn/core/route';
+import { rootContract } from './contract.js';
+
+const app = createApp();
+
+app.bind(rootContract, async (c) =>
+{
+    return c.json(
+    {
+        name: 'SPFN API',
+        version: '1.0.0',
+        status: 'running',
+        endpoints:
+        {
+            health: '/health',
+            examples: '/examples',
+        },
+        message: 'Welcome to SPFN! Visit /examples for usage examples.',
+    });
+});
+
+export default app;

package/package.json

@@ -1,49 +1,69 @@
 {
-    "name": "@spfn/cli",
-    "version": "0.0.8",
-    "description": "Superfunction CLI",
-    "scripts": {
-        "start": "node lib/index.js",
-        "start:dev": "NODE_ENV=development node lib/index.js",
-        "start:prod": "NODE_ENV=production node lib/index.js"
-    },
-    "keywords": [
-        "cli",
-        "superfunction",
-        "sf",
-        "devtools",
-        "automation"
-    ],
-    "homepage": "https://console.superfunctions.ai",
-    "repository": {
-        "type": "git",
-        "url": "https://git.superfunctions.ai/spfn/sf-cli.git"
-    },
-    "license": "MIT",
-    "author": "Superfunction Ray <rayim@superfunctions.ai>",
-    "type": "module",
-    "main": "lib/index.js",
-    "bin": {
-        "sf": "lib/index.js"
-    },
-    "directories": {
-        "lib": "lib"
-    },
-    "files": [
-        "lib/**/*"
-    ],
-    "dependencies": {
-        "commander": "^13.1.0",
-        "open": "^10.1.1"
-    },
-    "devDependencies": {
-        "@types/node": "^22.15.3",
-        "typescript": "^5.0.0"
-    },
-    "engines": {
-        "node": ">=18"
-    },
-    "publishConfig": {
-        "access": "public"
+  "name": "@spfn/cli",
+  "version": "0.1.0-alpha.1",
+  "description": "SPFN CLI - Add SPFN to your Next.js project",
+  "type": "module",
+  "bin": {
+    "spfn": "./bin/spfn.js"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "keywords": [
+    "spfn",
+    "nextjs",
+    "hono",
+    "cli",
+    "backend"
+  ],
+  "author": "Ray Im <rayim@inflike.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/spfn/spfn.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/spfn/spfn/issues"
+  },
+  "homepage": "https://github.com/spfn/spfn/tree/main/packages/cli#readme",
+  "engines": {
+    "node": ">=18.18.0"
+  },
+  "peerDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
     }
-}
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^11.1.0",
+    "concurrently": "^9.0.0",
+    "execa": "^8.0.1",
+    "fs-extra": "^11.2.0",
+    "ora": "^7.0.1",
+    "prompts": "^2.4.2",
+    "tsx": "^4.20.6",
+    "@spfn/core": "0.1.0-alpha.1"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^20.11.0",
+    "@types/prompts": "^2.4.9",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "alpha"
+  },
+  "scripts": {
+    "build": "tsup && node scripts/copy-templates.js",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit"
+  }
+}

package/lib/index.js

@@ -1,19 +0,0 @@
-#!/usr/bin/env node
-import { Command } from "commander";
-import { login } from "./login.js";
-
-const program = new Command();
-
-program
-    .name("sf")
-    .description("Superfunction CLI")
-    .version("0.1.0");
-
-program
-    .command("login")
-    .description("Authenticate via browser login")
-    .action(() => {
-        (async () => { await login(); })();
-    });
-
-program.parse();

package/lib/login.js

@@ -1,167 +0,0 @@
-import http from "http";
-import open from "open";
-import { execSync } from "child_process";
-
-const isDev = process.env.NODE_ENV === "development" || process.env.SF_ENV === "local";
-const GIT_HOST = isDev ? "gitea:13000" : "git.superfunctions.ai";
-const GIT_PROTOCOL = isDev ? "http" : "https";
-
-/**
- * Git credential helper를 이용해 특정 레포에 대한 인증 정보를 저장합니다.
- * @param username Git 사용자명
- * @param token    Git 토큰
- * @param repoPath 호스트 이후의 경로 예: "my-org/my-repo"
- */
-function installGitCredentials(
-    username,
-    token,
-    {
-        protocol = "https",
-        host,
-        path // optional
-    }
-)
-{
-    // credential helper 설정 (글로벌, 1회면 충분)
-    if (process.platform === "win32")
-    {
-        execSync("git config --global credential.helper manager-core");
-    }
-    else
-    {
-        execSync("git config --global credential.helper store");
-    }
-
-    // git credential approve 입력 생성
-    const cred = [
-        `protocol=${protocol}`,
-        `host=${host}`,
-        path ? `path=${path}` : null,
-        `username=${username}`,
-        `password=${token}`,
-        ""
-    ].filter(Boolean).join("\n");
-
-    execSync("git credential approve", {
-        input: cred,
-        stdio: ["pipe", "ignore", "inherit"]
-    });
-
-    if (path)
-    {
-        console.log(`✔️ Stored credentials for ${protocol}://${host}/${path}`);
-    }
-    else
-    {
-        console.log(`✔️ Stored credentials for ${protocol}://${host}`);
-    }
-}
-
-export async function login()
-{
-    try
-    {
-        const server = http.createServer((req, res) =>
-        {
-            res.setHeader("Access-Control-Allow-Origin", "*");
-            res.setHeader("Access-Control-Allow-Methods", "POST, OPTIONS");
-            res.setHeader("Access-Control-Allow-Headers", "Content-Type");
-
-            if (req.method === "OPTIONS")
-            {
-                res.writeHead(200);
-                res.end();
-                return;
-            }
-
-            if (req.url === "/callback" && req.method === "POST")
-            {
-                let body = "";
-                req.on("data", (chunk) => (body += chunk));
-                req.on("end", () =>
-                {
-                    try
-                    {
-                        const { username, token } = JSON.parse(body);
-                        if (!username || !token)
-                        {
-                            res.writeHead(400).end("Missing username or token");
-                            return;
-                        }
-
-                        // npm registry 설정 (생략)
-                        try
-                        {
-                            execSync(
-                                `npm config set @sf:registry ${GIT_PROTOCOL}://${GIT_HOST}/api/packages/spfn/npm/`,
-                                { stdio: "inherit", env: process.env }
-                            );
-                            execSync(
-                                `npm config set //${GIT_HOST}/api/packages/spfn/npm/:_authToken \"${token}\"`,
-                                { stdio: "inherit", env: process.env }
-                            );
-                            console.log("✔️ npm registry and authToken set via npm config");
-                        }
-                        catch (e)
-                        {
-                            console.error("❌ npm config set failed:", e);
-                        }
-
-                        // 2개 레포에 대해 각각 자격증명 저장
-                        installGitCredentials(username, token, {
-                            protocol: GIT_PROTOCOL,
-                            host: GIT_HOST
-                        });
-
-                        res.writeHead(200, { "Content-Type": "text/plain" });
-                        res.end("✅ Login successful! You can now close this window.");
-
-                        server.close();
-                    }
-                    catch (err)
-                    {
-                        console.error(err);
-                        res.writeHead(500).end("Error during login callback");
-                        server.close();
-                    }
-                });
-            }
-            else
-            {
-                res.writeHead(404).end("Not Found");
-            }
-        });
-
-        const port = await getAvailablePort();
-
-        // 로그인 UI 주소도 분기
-        const isDev = process.env.NODE_ENV === "development" || process.env.SF_ENV === "local";
-        const LOGIN_UI_URL = isDev
-            ? `http://localhost:3000/cli-login?port=${port}`
-            : `https://console.superfunctions.ai/cli-login?port=${port}`;
-
-        server.listen(port, () =>
-        {
-            console.log("🌐 Opening browser for login...");
-            open(LOGIN_UI_URL);
-        });
-    }
-    catch (err)
-    {
-        console.error(err);
-    }
-}
-
-function getAvailablePort(defaultPort = 5678) {
-    return new Promise((resolve) => {
-        const srv = http.createServer();
-        srv.listen(defaultPort, () => {
-            srv.close(() => resolve(defaultPort));
-        });
-        srv.on("error", () => {
-            // 사용 중이면 10000~20000 사이 랜덤 포트
-            const randomPort = Math.floor(Math.random() * 10000) + 10000;
-            resolve(randomPort);
-        });
-    });
-}