fexapi 0.1.0 → 0.1.2

package/dist/index.js

@@ -1,435 +1,98 @@
 #!/usr/bin/env node
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const node_fs_1 = require("node:fs");
-const node_path_1 = require("node:path");
-const schema_1 = require("./schema");
-const server_1 = require("./server");
+const args_1 = require("./cli/args");
+const dev_1 = require("./commands/dev");
+const help_1 = require("./cli/help");
+const generate_1 = require("./commands/generate");
+const init_1 = require("./commands/init");
+const serve_1 = require("./commands/serve");
 const args = process.argv.slice(2);
-const GENERATED_SPEC_RELATIVE_PATH = "fexapi/generated.api.json";
-const printHelp = () => {
-    console.log("fexapi-cli");
-    console.log("");
-    console.log("Usage:");
-    console.log("  fexapi init [--force]");
-    console.log("  fexapi generate");
-    console.log("  fexapi serve [--host <host>] [--port <number>]");
-    console.log("  fexapi [--host <host>] [--port <number>]");
-    console.log("  fexapi --help");
-    console.log("");
-    console.log("Examples:");
-    console.log("  fexapi init");
-    console.log("  fexapi init --force");
-    console.log("  fexapi generate");
-    console.log("  fexapi serve --host 127.0.0.1 --port 5000");
-    console.log("  fexapi --port 4000");
-    console.log("");
-    console.log("Package manager usage:");
-    console.log("  npx fexapi init");
-    console.log("  pnpm dlx fexapi init");
-    console.log("  yarn dlx fexapi init");
-    console.log("");
-    console.log("`fexapi init` creates:");
-    console.log("  fexapi.config.json");
-    console.log("  fexapi/schema.fexapi");
-    console.log("");
-    console.log("Then run:");
-    console.log("  fexapi generate");
-    console.log("  fexapi serve");
-};
-const findClosestPackageJson = (startDirectory) => {
-    let currentDirectory = startDirectory;
-    while (true) {
-        const candidate = (0, node_path_1.join)(currentDirectory, "package.json");
-        if ((0, node_fs_1.existsSync)(candidate)) {
-            return candidate;
+const [firstArg, ...restArgs] = args;
+const main = async () => {
+    if (firstArg === "init") {
+        if (restArgs.includes("--help") || restArgs.includes("-h")) {
+            console.log("Usage: fexapi init [--force]");
+            console.log("Runs an interactive setup wizard and creates fexapi config/schema files.");
+            console.log("Use --force to overwrite existing files.");
+            process.exit(0);
         }
-        const parentDirectory = (0, node_path_1.dirname)(currentDirectory);
-        if (parentDirectory === currentDirectory) {
-            return undefined;
+        const initOptions = (0, args_1.parseInitOptions)(restArgs);
+        if ("error" in initOptions) {
+            console.error(initOptions.error);
+            console.log("");
+            console.log("Usage: fexapi init [--force]");
+            process.exit(1);
         }
-        currentDirectory = parentDirectory;
+        process.exit(await (0, init_1.initializeProject)({ force: initOptions.force }));
     }
-};
-const readDependencyNames = (packageJsonPath) => {
-    const packageJsonText = (0, node_fs_1.readFileSync)(packageJsonPath, "utf-8");
-    const packageJson = JSON.parse(packageJsonText);
-    const dependencies = (packageJson.dependencies ?? {});
-    const devDependencies = (packageJson.devDependencies ?? {});
-    return new Set([
-        ...Object.keys(dependencies),
-        ...Object.keys(devDependencies),
-    ]);
-};
-const readWorkspaceDependencyNames = (projectRoot) => {
-    const result = new Set();
-    const rootsToScan = [
-        (0, node_path_1.join)(projectRoot, "apps"),
-        (0, node_path_1.join)(projectRoot, "packages"),
-    ];
-    for (const rootPath of rootsToScan) {
-        if (!(0, node_fs_1.existsSync)(rootPath)) {
-            continue;
+    else if (firstArg === "generate") {
+        if (restArgs.includes("--help") || restArgs.includes("-h")) {
+            console.log("Usage: fexapi generate");
+            console.log("Reads fexapi/schema.fexapi and updates generated API artifacts + migration.");
+            process.exit(0);
         }
-        for (const entry of (0, node_fs_1.readdirSync)(rootPath)) {
-            const entryPath = (0, node_path_1.join)(rootPath, entry);
-            if (!(0, node_fs_1.statSync)(entryPath).isDirectory()) {
-                continue;
-            }
-            const packageJsonPath = (0, node_path_1.join)(entryPath, "package.json");
-            if (!(0, node_fs_1.existsSync)(packageJsonPath)) {
-                continue;
-            }
-            const dependencyNames = readDependencyNames(packageJsonPath);
-            for (const dependencyName of dependencyNames) {
-                result.add(dependencyName);
-            }
+        const generateOptions = (0, args_1.parseGenerateOptions)(restArgs);
+        if (generateOptions.error) {
+            console.error(generateOptions.error);
+            console.log("");
+            console.log("Usage: fexapi generate");
+            process.exit(1);
         }
+        process.exit((0, generate_1.generateFromSchema)());
     }
-    return result;
-};
-const detectProject = (packageJsonPath, projectRoot) => {
-    const dependencyNames = readDependencyNames(packageJsonPath);
-    const frameworks = new Set();
-    const tooling = new Set();
-    if (dependencyNames.has("turbo") ||
-        (0, node_fs_1.existsSync)((0, node_path_1.join)(projectRoot, "turbo.json"))) {
-        tooling.add("turborepo");
-    }
-    if (dependencyNames.has("nx") || (0, node_fs_1.existsSync)((0, node_path_1.join)(projectRoot, "nx.json"))) {
-        tooling.add("nx");
-    }
-    if ((0, node_fs_1.existsSync)((0, node_path_1.join)(projectRoot, "pnpm-workspace.yaml"))) {
-        tooling.add("pnpm-workspace");
-    }
-    if (tooling.has("turborepo") || tooling.has("pnpm-workspace")) {
-        const workspaceDeps = readWorkspaceDependencyNames(projectRoot);
-        for (const dependencyName of workspaceDeps) {
-            dependencyNames.add(dependencyName);
-        }
-    }
-    if (dependencyNames.has("next")) {
-        frameworks.add("nextjs");
-    }
-    if (dependencyNames.has("react") || dependencyNames.has("react-dom")) {
-        frameworks.add("reactjs");
-    }
-    if (dependencyNames.has("vue")) {
-        frameworks.add("vue");
-    }
-    if (dependencyNames.has("nuxt")) {
-        frameworks.add("nuxt");
-    }
-    if (dependencyNames.has("svelte")) {
-        frameworks.add("svelte");
-    }
-    if (dependencyNames.has("@sveltejs/kit")) {
-        frameworks.add("sveltekit");
-    }
-    if (dependencyNames.has("@angular/core")) {
-        frameworks.add("angular");
-    }
-    if (dependencyNames.has("solid-js")) {
-        frameworks.add("solid");
-    }
-    if (dependencyNames.has("@remix-run/react") ||
-        dependencyNames.has("@remix-run/node")) {
-        frameworks.add("remix");
-    }
-    if (dependencyNames.has("astro")) {
-        frameworks.add("astro");
-    }
-    if (dependencyNames.has("vite")) {
-        tooling.add("vite");
-    }
-    const frameworkList = Array.from(frameworks);
-    const primaryFramework = frameworkList[0] ?? "unknown";
-    return {
-        primaryFramework,
-        frameworks: frameworkList.length > 0 ? frameworkList : ["unknown"],
-        tooling: Array.from(tooling),
-    };
-};
-const getSchemaTemplate = (framework) => {
-    const frameworkHint = framework === "nextjs"
-        ? "# Framework: Next.js"
-        : framework === "reactjs"
-            ? "# Framework: React"
-            : "# Framework: unknown";
-    return [
-        frameworkHint,
-        "# Server",
-        "port: 4000",
-        "",
-        "# Routes",
-        "# Format: METHOD /endpoint: field:type,field:type",
-        "GET /users: id:uuid,fullName:name,username:string,email:email,avatarUrl:url",
-        "GET /posts: id:uuid,title:string,body:string,createdAt:date",
-    ].join("\n");
-};
-const parseInitOptions = (initArgs) => {
-    const validFlags = new Set(["--force"]);
-    const invalidFlags = initArgs.filter((value) => value.startsWith("-") && !validFlags.has(value));
-    if (invalidFlags.length > 0) {
-        return { error: `Unknown option(s): ${invalidFlags.join(", ")}` };
-    }
-    return { force: initArgs.includes("--force") };
-};
-const parseGenerateOptions = (generateArgs) => {
-    const invalidFlags = generateArgs.filter((value) => value.startsWith("-"));
-    if (invalidFlags.length > 0) {
-        return { error: `Unknown option(s): ${invalidFlags.join(", ")}` };
-    }
-    return {};
-};
-const resolveProjectRoot = () => {
-    const packageJsonPath = findClosestPackageJson(process.cwd());
-    if (!packageJsonPath) {
-        return undefined;
-    }
-    return (0, node_path_1.dirname)(packageJsonPath);
-};
-const initializeProject = ({ force }) => {
-    const packageJsonPath = findClosestPackageJson(process.cwd());
-    if (!packageJsonPath) {
-        console.error("Could not find package.json in this directory or parent directories.");
-        return 1;
-    }
-    const projectRoot = (0, node_path_1.dirname)(packageJsonPath);
-    const detectedProject = detectProject(packageJsonPath, projectRoot);
-    const fexapiDirectoryPath = (0, node_path_1.join)(projectRoot, "fexapi");
-    const schemaPath = (0, node_path_1.join)(fexapiDirectoryPath, "schema.fexapi");
-    const configPath = (0, node_path_1.join)(projectRoot, "fexapi.config.json");
-    (0, node_fs_1.mkdirSync)(fexapiDirectoryPath, { recursive: true });
-    const configExists = (0, node_fs_1.existsSync)(configPath);
-    const schemaExists = (0, node_fs_1.existsSync)(schemaPath);
-    const config = {
-        framework: detectedProject.primaryFramework,
-        frameworks: detectedProject.frameworks,
-        tooling: detectedProject.tooling,
-        schemaPath: "fexapi/schema.fexapi",
-        generatedPath: GENERATED_SPEC_RELATIVE_PATH,
-        createdAt: new Date().toISOString(),
-    };
-    if (!configExists || force) {
-        (0, node_fs_1.writeFileSync)(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf-8");
-    }
-    if (!schemaExists || force) {
-        (0, node_fs_1.writeFileSync)(schemaPath, `${getSchemaTemplate(detectedProject.primaryFramework)}\n`, "utf-8");
-    }
-    console.log(`Initialized Fexapi in ${projectRoot}`);
-    console.log(`Detected framework: ${detectedProject.primaryFramework}`);
-    console.log(`Detected frameworks: ${detectedProject.frameworks.join(", ")}`);
-    if (detectedProject.tooling.length > 0) {
-        console.log(`Detected tooling: ${detectedProject.tooling.join(", ")}`);
-    }
-    if (configExists && !force) {
-        console.log(`Exists ${configPath}`);
-    }
-    else if (configExists && force) {
-        console.log(`Overwritten ${configPath}`);
-    }
-    else {
-        console.log(`Created ${configPath}`);
-    }
-    if (schemaExists && !force) {
-        console.log(`Exists ${schemaPath}`);
-    }
-    else if (schemaExists && force) {
-        console.log(`Overwritten ${schemaPath}`);
-    }
-    else {
-        console.log(`Created ${schemaPath}`);
-    }
-    if (detectedProject.primaryFramework === "unknown") {
-        console.log("No known framework dependency found. Update fexapi.config.json and schema.fexapi if needed.");
-    }
-    return 0;
-};
-const generateFromSchema = () => {
-    const projectRoot = resolveProjectRoot();
-    if (!projectRoot) {
-        console.error("Could not find package.json in this directory or parent directories.");
-        return 1;
-    }
-    const schemaPath = (0, node_path_1.join)(projectRoot, "fexapi", "schema.fexapi");
-    const generatedPath = (0, node_path_1.join)(projectRoot, "fexapi", "generated.api.json");
-    const configPath = (0, node_path_1.join)(projectRoot, "fexapi.config.json");
-    if (!(0, node_fs_1.existsSync)(schemaPath)) {
-        console.error(`Schema file not found: ${schemaPath}`);
-        console.error("Run `fexapi init` first.");
-        return 1;
-    }
-    const schemaText = (0, node_fs_1.readFileSync)(schemaPath, "utf-8");
-    const parsed = (0, schema_1.parseFexapiSchema)(schemaText);
-    if (parsed.errors.length > 0 || !parsed.schema) {
-        console.error("Failed to generate API from schema.fexapi");
-        for (const error of parsed.errors) {
-            console.error(`- ${error}`);
+    else if (firstArg === "dev") {
+        if (restArgs.includes("--help") || restArgs.includes("-h")) {
+            console.log("Usage: fexapi dev [--watch] [--host <host>] [--port <number>] [--log]");
+            console.log("Starts development server and optionally auto-reloads when config/schema files change.");
+            process.exit(0);
         }
-        return 1;
-    }
-    const generated = {
-        schemaVersion: 1,
-        generatedAt: new Date().toISOString(),
-        port: parsed.schema.port,
-        routes: parsed.schema.routes,
-    };
-    (0, node_fs_1.writeFileSync)(generatedPath, `${JSON.stringify(generated, null, 2)}\n`, "utf-8");
-    let existingConfig = {};
-    if ((0, node_fs_1.existsSync)(configPath)) {
-        try {
-            existingConfig = JSON.parse((0, node_fs_1.readFileSync)(configPath, "utf-8"));
+        const devOptions = (0, args_1.parseDevOptions)(restArgs);
+        if ("error" in devOptions) {
+            console.error(devOptions.error);
+            console.log("");
+            console.log("Usage: fexapi dev [--watch] [--host <host>] [--port <number>] [--log]");
+            process.exit(1);
         }
-        catch {
-            existingConfig = {};
+        const exitCode = (0, dev_1.runDevCommand)(devOptions);
+        if (exitCode !== 0) {
+            process.exit(exitCode);
         }
     }
-    const updatedConfig = {
-        ...existingConfig,
-        schemaPath: "fexapi/schema.fexapi",
-        generatedPath: GENERATED_SPEC_RELATIVE_PATH,
-        lastGeneratedAt: new Date().toISOString(),
-    };
-    (0, node_fs_1.writeFileSync)(configPath, `${JSON.stringify(updatedConfig, null, 2)}\n`, "utf-8");
-    console.log(`Generated API spec at ${generatedPath}`);
-    console.log(`Routes generated: ${parsed.schema.routes.length}`);
-    console.log(`Configured server port: ${parsed.schema.port}`);
-    return 0;
-};
-const parseServeOptions = (serveArgs) => {
-    const getFlagValue = (flagName) => {
-        const index = serveArgs.indexOf(flagName);
-        if (index === -1) {
-            return undefined;
+    else if (!firstArg ||
+        firstArg === "serve" ||
+        firstArg === "run" ||
+        firstArg.startsWith("-")) {
+        const serveArgs = firstArg === "serve" || firstArg === "run" ? restArgs : args;
+        if (serveArgs.includes("--help") || serveArgs.includes("-h")) {
+            (0, help_1.printHelp)();
+            process.exit(0);
         }
-        const value = serveArgs[index + 1];
-        if (!value || value.startsWith("-")) {
-            return { error: `Missing value for ${flagName}` };
+        const options = (0, args_1.parseServeOptions)(serveArgs);
+        if ("error" in options) {
+            console.error(options.error);
+            console.log("");
+            (0, help_1.printHelp)();
+            process.exit(1);
         }
-        return value;
-    };
-    const unknownFlags = serveArgs.filter((value) => value.startsWith("-") && value !== "--host" && value !== "--port");
-    if (unknownFlags.length > 0) {
-        return { error: `Unknown option(s): ${unknownFlags.join(", ")}` };
-    }
-    const hostValue = getFlagValue("--host");
-    if (hostValue && typeof hostValue !== "string") {
-        return hostValue;
-    }
-    const portValue = getFlagValue("--port");
-    if (portValue && typeof portValue !== "string") {
-        return portValue;
-    }
-    const host = hostValue ?? "127.0.0.1";
-    const port = portValue ? Number(portValue) : undefined;
-    if (port !== undefined &&
-        (!Number.isInteger(port) || port < 1 || port > 65535)) {
-        return { error: `Invalid port: ${portValue ?? ""}`.trim() };
-    }
-    return { host, port };
-};
-const loadGeneratedApiSpec = (projectRoot) => {
-    const generatedPath = (0, node_path_1.join)(projectRoot, GENERATED_SPEC_RELATIVE_PATH);
-    if (!(0, node_fs_1.existsSync)(generatedPath)) {
-        return undefined;
-    }
-    try {
-        const parsed = JSON.parse((0, node_fs_1.readFileSync)(generatedPath, "utf-8"));
-        if (typeof parsed.port !== "number" || !Array.isArray(parsed.routes)) {
-            return undefined;
+        const exitCode = (0, serve_1.serveProject)(options);
+        if (exitCode !== 0) {
+            process.exit(exitCode);
         }
-        return {
-            port: parsed.port,
-            routes: parsed.routes,
-        };
     }
-    catch {
-        return undefined;
-    }
-};
-const [firstArg, ...restArgs] = args;
-if (firstArg === "init") {
-    if (restArgs.includes("--help") || restArgs.includes("-h")) {
-        console.log("Usage: fexapi init [--force]");
-        console.log("Detects frameworks/tooling and creates fexapi.config.json + fexapi/schema.fexapi.");
-        console.log("Use --force to overwrite existing files.");
-        process.exit(0);
-    }
-    const initOptions = parseInitOptions(restArgs);
-    if ("error" in initOptions) {
-        console.error(initOptions.error);
-        console.log("");
-        console.log("Usage: fexapi init [--force]");
-        process.exit(1);
-    }
-    const exitCode = initializeProject({ force: initOptions.force });
-    process.exit(exitCode);
-}
-else if (firstArg === "generate") {
-    if (restArgs.includes("--help") || restArgs.includes("-h")) {
-        console.log("Usage: fexapi generate");
-        console.log("Reads fexapi/schema.fexapi and creates fexapi/generated.api.json.");
+    else if (firstArg === "help") {
+        (0, help_1.printHelp)();
         process.exit(0);
     }
-    const generateOptions = parseGenerateOptions(restArgs);
-    if (generateOptions.error) {
-        console.error(generateOptions.error);
-        console.log("");
-        console.log("Usage: fexapi generate");
-        process.exit(1);
-    }
-    const exitCode = generateFromSchema();
-    process.exit(exitCode);
-}
-else if (!firstArg || firstArg === "serve" || firstArg.startsWith("-")) {
-    const serveArgs = firstArg === "serve" ? restArgs : args;
-    if (serveArgs.includes("--help") || serveArgs.includes("-h")) {
-        printHelp();
-        process.exit(0);
-    }
-    const options = parseServeOptions(serveArgs);
-    if ("error" in options) {
-        console.error(options.error);
+    else {
+        console.error(`Unknown command: ${firstArg}`);
         console.log("");
-        printHelp();
+        (0, help_1.printHelp)();
         process.exit(1);
     }
-    const projectRoot = resolveProjectRoot();
-    const generatedSpec = projectRoot
-        ? loadGeneratedApiSpec(projectRoot)
-        : undefined;
-    const effectivePort = options.port ?? generatedSpec?.port ?? 4000;
-    if (generatedSpec) {
-        console.log(`Using generated schema routes (${generatedSpec.routes.length}) from ${GENERATED_SPEC_RELATIVE_PATH}`);
-    }
-    else {
-        console.log("No generated schema found. Run `fexapi generate` to serve schema-defined endpoints.");
-    }
-    const server = (0, server_1.startServer)({
-        host: options.host,
-        port: effectivePort,
-        apiSpec: generatedSpec,
-    });
-    const shutdown = () => {
-        server.close((error) => {
-            if (error) {
-                console.error("Error while shutting down server", error);
-                process.exit(1);
-            }
-            process.exit(0);
-        });
-    };
-    process.on("SIGINT", shutdown);
-    process.on("SIGTERM", shutdown);
-}
-else if (firstArg === "help") {
-    printHelp();
-    process.exit(0);
-}
-else {
-    console.error(`Unknown command: ${firstArg}`);
-    console.log("");
-    printHelp();
+};
+void main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`Unexpected error: ${message}`);
     process.exit(1);
-}
+});

package/dist/project/detect.d.ts

@@ -0,0 +1,4 @@
+import type { DetectedProject, SupportedFramework } from "../types/project";
+export declare const detectProject: (packageJsonPath: string, projectRoot: string) => DetectedProject;
+export declare const getSchemaTemplate: (framework: SupportedFramework, port?: number) => string;
+//# sourceMappingURL=detect.d.ts.map

package/dist/project/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/project/detect.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAyD5E,eAAO,MAAM,aAAa,GACxB,iBAAiB,MAAM,EACvB,aAAa,MAAM,KAClB,eAwDF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,WAAW,kBAAkB,EAC7B,aAAW,KACV,MAkBF,CAAC"}

package/dist/project/detect.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSchemaTemplate = exports.detectProject = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const readDependencyNames = (packageJsonPath) => {
+    const packageJsonText = (0, node_fs_1.readFileSync)(packageJsonPath, "utf-8");
+    const packageJson = JSON.parse(packageJsonText);
+    const dependencies = (packageJson.dependencies ?? {});
+    const devDependencies = (packageJson.devDependencies ?? {});
+    return new Set([
+        ...Object.keys(dependencies),
+        ...Object.keys(devDependencies),
+    ]);
+};
+const readWorkspaceDependencyNames = (projectRoot) => {
+    const result = new Set();
+    const rootsToScan = [
+        (0, node_path_1.join)(projectRoot, "apps"),
+        (0, node_path_1.join)(projectRoot, "packages"),
+    ];
+    for (const rootPath of rootsToScan) {
+        if (!(0, node_fs_1.existsSync)(rootPath)) {
+            continue;
+        }
+        for (const entry of (0, node_fs_1.readdirSync)(rootPath)) {
+            const entryPath = (0, node_path_1.join)(rootPath, entry);
+            if (!(0, node_fs_1.statSync)(entryPath).isDirectory()) {
+                continue;
+            }
+            const packageJsonPath = (0, node_path_1.join)(entryPath, "package.json");
+            if (!(0, node_fs_1.existsSync)(packageJsonPath)) {
+                continue;
+            }
+            const dependencyNames = readDependencyNames(packageJsonPath);
+            for (const dependencyName of dependencyNames) {
+                result.add(dependencyName);
+            }
+        }
+    }
+    return result;
+};
+const detectProject = (packageJsonPath, projectRoot) => {
+    const dependencyNames = readDependencyNames(packageJsonPath);
+    const frameworks = new Set();
+    const tooling = new Set();
+    if (dependencyNames.has("turbo") ||
+        (0, node_fs_1.existsSync)((0, node_path_1.join)(projectRoot, "turbo.json"))) {
+        tooling.add("turborepo");
+    }
+    if (dependencyNames.has("nx") || (0, node_fs_1.existsSync)((0, node_path_1.join)(projectRoot, "nx.json"))) {
+        tooling.add("nx");
+    }
+    if ((0, node_fs_1.existsSync)((0, node_path_1.join)(projectRoot, "pnpm-workspace.yaml"))) {
+        tooling.add("pnpm-workspace");
+    }
+    if (tooling.has("turborepo") || tooling.has("pnpm-workspace")) {
+        const workspaceDeps = readWorkspaceDependencyNames(projectRoot);
+        for (const dependencyName of workspaceDeps) {
+            dependencyNames.add(dependencyName);
+        }
+    }
+    if (dependencyNames.has("next"))
+        frameworks.add("nextjs");
+    if (dependencyNames.has("react") || dependencyNames.has("react-dom"))
+        frameworks.add("reactjs");
+    if (dependencyNames.has("vue"))
+        frameworks.add("vue");
+    if (dependencyNames.has("nuxt"))
+        frameworks.add("nuxt");
+    if (dependencyNames.has("svelte"))
+        frameworks.add("svelte");
+    if (dependencyNames.has("@sveltejs/kit"))
+        frameworks.add("sveltekit");
+    if (dependencyNames.has("@angular/core"))
+        frameworks.add("angular");
+    if (dependencyNames.has("solid-js"))
+        frameworks.add("solid");
+    if (dependencyNames.has("@remix-run/react") ||
+        dependencyNames.has("@remix-run/node"))
+        frameworks.add("remix");
+    if (dependencyNames.has("astro"))
+        frameworks.add("astro");
+    if (dependencyNames.has("vite")) {
+        tooling.add("vite");
+    }
+    const frameworkList = Array.from(frameworks);
+    const primaryFramework = frameworkList[0] ?? "unknown";
+    return {
+        primaryFramework,
+        frameworks: frameworkList.length > 0 ? frameworkList : ["unknown"],
+        tooling: Array.from(tooling),
+    };
+};
+exports.detectProject = detectProject;
+const getSchemaTemplate = (framework, port = 4000) => {
+    const frameworkHint = framework === "nextjs"
+        ? "# Framework: Next.js"
+        : framework === "reactjs"
+            ? "# Framework: React"
+            : "# Framework: unknown";
+    return [
+        frameworkHint,
+        "# Server",
+        `port: ${port}`,
+        "",
+        "# Routes",
+        "# Format: METHOD /endpoint: field:type,field:type",
+        "GET /users: id:uuid,fullName:name,username:string,email:email,avatarUrl:url",
+        "GET /posts: id:uuid,title:string,body:string,createdAt:date",
+    ].join("\n");
+};
+exports.getSchemaTemplate = getSchemaTemplate;

package/dist/project/paths.d.ts

@@ -0,0 +1,3 @@
+export declare const findClosestPackageJson: (startDirectory: string) => string | undefined;
+export declare const resolveProjectRoot: () => string | undefined;
+//# sourceMappingURL=paths.d.ts.map

package/dist/project/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/project/paths.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,sBAAsB,GACjC,gBAAgB,MAAM,KACrB,MAAM,GAAG,SAgBX,CAAC;AAEF,eAAO,MAAM,kBAAkB,QAAO,MAAM,GAAG,SAO9C,CAAC"}

package/dist/project/paths.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveProjectRoot = exports.findClosestPackageJson = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const findClosestPackageJson = (startDirectory) => {
+    let currentDirectory = startDirectory;
+    while (true) {
+        const candidate = (0, node_path_1.join)(currentDirectory, "package.json");
+        if ((0, node_fs_1.existsSync)(candidate)) {
+            return candidate;
+        }
+        const parentDirectory = (0, node_path_1.dirname)(currentDirectory);
+        if (parentDirectory === currentDirectory) {
+            return undefined;
+        }
+        currentDirectory = parentDirectory;
+    }
+};
+exports.findClosestPackageJson = findClosestPackageJson;
+const resolveProjectRoot = () => {
+    const packageJsonPath = (0, exports.findClosestPackageJson)(process.cwd());
+    if (!packageJsonPath) {
+        return undefined;
+    }
+    return (0, node_path_1.dirname)(packageJsonPath);
+};
+exports.resolveProjectRoot = resolveProjectRoot;