@wild-framework/cli 0.1.1 → 0.2.0

package/dist/commands/resource.js

@@ -0,0 +1,291 @@
+import { createInterface } from "node:readline";
+import { join } from "node:path";
+import { findProjectSrc, toKebabCase, writeFiles } from "./make.js";
+import { pluralize } from "../client/codegen.js";
+import { renderResourceSlice, } from "../templates/resource-slice.js";
+/**
+ * Run `wild resource <Name>` — generate a full vertical slice.
+ *
+ * Non-interactive:
+ *   wild resource Product --field name:string --field price:number
+ *
+ * Interactive (no name): guided multi-step wizard asking for the name and
+ * fields.
+ */
+export async function runResource(args, deps) {
+    const print = deps?.print ?? console.log;
+    // Parse --field name:type[:rule=value…] flags and --with addons
+    const fields = [];
+    const addons = {};
+    const positional = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (!arg)
+            continue;
+        if (arg === "--field" || arg === "-f") {
+            const raw = args[i + 1];
+            if (raw) {
+                fields.push(parseField(raw));
+                i++;
+            }
+        }
+        else if (arg.startsWith("--field=")) {
+            fields.push(parseField(arg.slice("--field=".length)));
+        }
+        else if (arg === "--with") {
+            const value = args[i + 1];
+            if (value) {
+                markAddon(addons, value);
+                i++;
+            }
+        }
+        else if (arg.startsWith("--with=")) {
+            markAddon(addons, arg.slice("--with=".length));
+        }
+        else {
+            positional.push(arg);
+        }
+    }
+    let name = positional[0];
+    if (!name) {
+        if (deps?.ask) {
+            const result = await runResourceWizard({ ask: deps.ask, print });
+            if (!result)
+                return 0;
+            name = result.name;
+            fields.push(...result.fields);
+            Object.assign(addons, result.addons);
+        }
+        else {
+            print('wild: resource requires a name, e.g. "wild resource Product --field name:string"');
+            return 1;
+        }
+    }
+    else if (fields.length === 0) {
+        // A bare `wild resource Product` still produces a working slice.
+        fields.push({ name: "name", type: "string" });
+    }
+    if (!/^[A-Z][A-Za-z0-9]*$/.test(name)) {
+        print(`wild: "${name}" is not a valid resource name. Use PascalCase singular, e.g. "Product".`);
+        return 1;
+    }
+    const kebabSingular = toKebabCase(name);
+    const kebabPlural = pluralize(kebabSingular);
+    const spec = { name, kebabSingular, kebabPlural, fields, addons };
+    const srcRoot = findProjectSrc(process.cwd());
+    const prefix = timestamp();
+    const files = renderResourceSlice(spec, prefix).map((f) => ({
+        path: f.path.startsWith("migrations/")
+            ? join(process.cwd(), f.path)
+            : join(srcRoot, f.path),
+        content: f.content,
+    }));
+    print(`\nGenerating resource slice: ${name} (${kebabPlural})\n`);
+    const written = writeFiles(files);
+    if (written === 0) {
+        print("\nNothing to do — all files already exist.");
+    }
+    else {
+        print(`\nDone. ${written} file(s) created.`);
+        print(`Routes: GET/POST /${kebabPlural}, GET/PUT/DELETE /${kebabPlural}/:id`);
+        print(`Register the provider: app.register(${name}Provider);`);
+        print(`Wire migrations: DatabaseProvider.migrations = loadMigrations("./migrations");`);
+        print("ℹ️  New migration(s) detected — run `wild db:migrate` to apply them.");
+    }
+    return 0;
+}
+/** Interactive wizard for the resource command (ACF-style: fields + rules + add-ons). */
+export async function runResourceWizard(deps) {
+    const { ask, print } = deps;
+    if (!ask)
+        return null; // non-interactive, caller handles missing name
+    print("\n🐺 Wild Framework — resource wizard\n");
+    const name = (await ask("Resource name (PascalCase singular, e.g. Product): ")).trim();
+    if (!name) {
+        print("No name given — aborting.");
+        return null;
+    }
+    if (!/^[A-Z][A-Za-z0-9]*$/.test(name)) {
+        print(`"${name}" is not a valid resource name. Use PascalCase singular, e.g. "Product".`);
+        return null;
+    }
+    print("\nFields — enter `name:type` (type = string | text | email | url | uuid | date |");
+    print("datetime | time | int | float | boolean | enum | json).");
+    print("Append rules with `:key=value`, e.g. `price:float:min=0` or `status:enum:options=draft|published`.");
+    print("Leave blank when done.  e.g. name:string, then price:float:min=0, then <blank>\n");
+    const fields = [];
+    while (true) {
+        const raw = (await ask(`Field ${fields.length + 1}: `)).trim();
+        if (!raw)
+            break;
+        try {
+            fields.push(parseField(raw));
+        }
+        catch (error) {
+            print(`  ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    if (fields.length === 0) {
+        print("No fields given — generating with a single `name` field.");
+        fields.push({ name: "name", type: "string" });
+    }
+    // Optional add-ons → more bindings
+    const addons = {};
+    if (await askYesNo(ask, "Add an event class?"))
+        addons.event = true;
+    if (await askYesNo(ask, "Add a listener (bound in the provider)?"))
+        addons.listener = true;
+    if (await askYesNo(ask, "Add a queued job (bound in the provider)?"))
+        addons.job = true;
+    if (await askYesNo(ask, "Add a policy (auth guard)?"))
+        addons.policy = true;
+    print(`\nCreating resource ${name} with fields: ${fields.map((f) => `${f.name}:${f.type}`).join(", ")}\n`);
+    return { name, fields, addons };
+}
+async function askYesNo(ask, question) {
+    const answer = (await ask(`${question} (y/N): `)).trim().toLowerCase();
+    return answer === "y" || answer === "yes";
+}
+/**
+ * Parse `name:type[:rule=value…]` into a field.
+ *
+ * Examples:
+ *   name:string
+ *   price:float:min=0:max=100
+ *   email:string:required=false
+ *   status:enum:options=draft|published
+ */
+function parseField(raw) {
+    const parts = raw.trim().split(":");
+    const name = (parts[0] ?? "").trim();
+    if (!/^[a-zA-Z][a-zA-Z0-9]*$/.test(name)) {
+        throw new Error(`"${raw}" is not a valid field (expected name:type[:rule=value…]).`);
+    }
+    const type = normalizeType(parts[1]);
+    const rules = parseRules(parts.slice(2));
+    return { name, type, ...(rules ? { rules } : {}) };
+}
+function normalizeType(type) {
+    const t = (type ?? "string").trim().toLowerCase();
+    switch (t) {
+        case "text":
+            return "text";
+        case "email":
+            return "email";
+        case "url":
+            return "url";
+        case "uuid":
+            return "uuid";
+        case "date":
+            return "date";
+        case "datetime":
+            return "datetime";
+        case "time":
+            return "time";
+        case "int":
+        case "integer":
+            return "int";
+        case "number":
+        case "float":
+            return "float";
+        case "boolean":
+        case "bool":
+            return "boolean";
+        case "enum":
+            return "enum";
+        case "json":
+            return "json";
+        default:
+            return "string";
+    }
+}
+/** Parse `key=value` rule segments into a FieldRules object. */
+function parseRules(parts) {
+    const rules = {};
+    for (const part of parts) {
+        if (!part)
+            continue;
+        const eq = part.indexOf("=");
+        const key = (eq === -1 ? part : part.slice(0, eq)).trim();
+        const value = eq === -1 ? "" : part.slice(eq + 1);
+        switch (key) {
+            case "required":
+                rules.required = value.toLowerCase() !== "false";
+                break;
+            case "min":
+                rules.min = Number(value);
+                break;
+            case "max":
+                rules.max = Number(value);
+                break;
+            case "minLength":
+            case "minlength":
+                rules.minLength = Number(value);
+                break;
+            case "maxLength":
+            case "maxlength":
+                rules.maxLength = Number(value);
+                break;
+            case "pattern":
+            case "regex":
+                rules.pattern = value;
+                break;
+            case "options":
+                rules.options = value.split("|").filter(Boolean);
+                break;
+            case "default":
+                rules.default = coerceDefault(value);
+                break;
+            case "array":
+                rules.array = value.toLowerCase() !== "false";
+                break;
+        }
+    }
+    return Object.keys(rules).length > 0 ? rules : undefined;
+}
+/** Coerce a `default=` string into a number/boolean/string. */
+function coerceDefault(value) {
+    if (value === "true")
+        return true;
+    if (value === "false")
+        return false;
+    if (value !== "" && !Number.isNaN(Number(value)))
+        return Number(value);
+    return value;
+}
+/** Mark an add-on by name (aliases allowed). */
+function markAddon(addons, value) {
+    const v = value.trim().toLowerCase();
+    if (v === "event" || v === "events")
+        addons.event = true;
+    else if (v === "listener" || v === "listeners")
+        addons.listener = true;
+    else if (v === "job" || v === "jobs" || v === "queue")
+        addons.job = true;
+    else if (v === "policy" || v === "policies")
+        addons.policy = true;
+}
+/** `YYYYMMDDHHMMSS` — sorts migrations by creation time. */
+function timestamp() {
+    const d = new Date();
+    const p = (n) => String(n).padStart(2, "0");
+    return `${d.getFullYear()}${p(d.getMonth() + 1)}${p(d.getDate())}${p(d.getHours())}${p(d.getMinutes())}${p(d.getSeconds())}`;
+}
+/**
+ * Run `wild resource` with real stdin/stdout.
+ */
+export async function runResourceCli(args) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const ask = (q) => new Promise((resolve) => rl.question(q, resolve));
+    try {
+        const code = await runResource(args, { ask, print: console.log });
+        rl.close();
+        return code;
+    }
+    catch (error) {
+        rl.close();
+        console.error(`wild: ${error instanceof Error ? error.message : String(error)}`);
+        return 1;
+    }
+}
+//# sourceMappingURL=resource.js.map

package/dist/commands/resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../src/commands/resource.ts"],"names":[],"mappings":"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"}

package/dist/frontend/codegen.d.ts

@@ -0,0 +1,27 @@
+import type { SpecOperation } from "./spec.js";
+/**
+ * Convert an OpenAPI path param to a TS string interpolation key.
+ *   "/users/{id}" with param "id" → "id" (used as `encodeURIComponent(String(id))`)
+ */
+export declare function pathParamKeys(path: string): string[];
+/** Convert a schema name to a TypeScript type name. */
+export declare function schemaToTsType(name: string | undefined, fallback?: string): string;
+/** PascalCase → camelCase ("CreateUserRequest" → "createUserRequest"). */
+export declare function camelCase(name: string): string;
+/** Uppercase the first character. */
+export declare function capitalize(name: string): string;
+/**
+ * Derive a function name from an operation.
+ *
+ * Prefers method+path (deterministic, descriptive: `getProducts`,
+ * `postOrders`). Uses a custom operationId only when it's a clean
+ * identifier (no dot — e.g. "listProducts" from a hand-written spec).
+ * Auto-generated operationIds look like "ProductController.index",
+ * which we ignore in favour of the method+path name.
+ */
+export declare function functionName(op: SpecOperation): string;
+/** Derive a hook name from a function name. */
+export declare function hookName(fn: string): string;
+/** Convert a JSON Schema object to a TS type string. */
+export declare function jsonSchemaToTs(schema: Record<string, unknown> | undefined, schemas: Record<string, Record<string, unknown>>, depth?: number): string;
+//# sourceMappingURL=codegen.d.ts.map

package/dist/frontend/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../src/frontend/codegen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,aAAa,EAAE,MAAM,WAAW,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAQpD;AAED,uDAAuD;AACvD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,SAAY,GAAG,MAAM,CAGrF;AAED,0EAA0E;AAC1E,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,qCAAqC;AACrC,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,aAAa,GAAG,MAAM,CActD;AAED,+CAA+C;AAC/C,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,wDAAwD;AACxD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,SAAI,GAAG,MAAM,CAuC/I"}

package/dist/frontend/codegen.js

@@ -0,0 +1,97 @@
+/**
+ * Convert an OpenAPI path param to a TS string interpolation key.
+ *   "/users/{id}" with param "id" → "id" (used as `encodeURIComponent(String(id))`)
+ */
+export function pathParamKeys(path) {
+    const keys = [];
+    const re = /\{([^}]+)\}/g;
+    let m;
+    while ((m = re.exec(path)) !== null) {
+        keys.push(m[1]);
+    }
+    return keys;
+}
+/** Convert a schema name to a TypeScript type name. */
+export function schemaToTsType(name, fallback = "unknown") {
+    if (!name)
+        return fallback;
+    return name;
+}
+/** PascalCase → camelCase ("CreateUserRequest" → "createUserRequest"). */
+export function camelCase(name) {
+    return name.charAt(0).toLowerCase() + name.slice(1);
+}
+/** Uppercase the first character. */
+export function capitalize(name) {
+    return name.charAt(0).toUpperCase() + name.slice(1);
+}
+/**
+ * Derive a function name from an operation.
+ *
+ * Prefers method+path (deterministic, descriptive: `getProducts`,
+ * `postOrders`). Uses a custom operationId only when it's a clean
+ * identifier (no dot — e.g. "listProducts" from a hand-written spec).
+ * Auto-generated operationIds look like "ProductController.index",
+ * which we ignore in favour of the method+path name.
+ */
+export function functionName(op) {
+    if (op.operationId && !op.operationId.includes(".")) {
+        return camelCase(op.operationId);
+    }
+    const method = op.method;
+    const segments = op.path.split("/").filter(Boolean);
+    let last = segments.pop() ?? "resource";
+    // If the last segment is a param, use the resource name before it
+    if (/\{[^}]+\}/.test(last)) {
+        const base = segments.pop() ?? "resource";
+        last = `${base}ById`;
+    }
+    const plural = last.replace(/\{[^}]+\}/g, "ById");
+    return `${method}${capitalize(plural)}`;
+}
+/** Derive a hook name from a function name. */
+export function hookName(fn) {
+    return `use${capitalize(fn)}`;
+}
+/** Convert a JSON Schema object to a TS type string. */
+export function jsonSchemaToTs(schema, schemas, depth = 0) {
+    if (!schema)
+        return "unknown";
+    if (depth > 6)
+        return "unknown";
+    if (schema.$ref) {
+        return String(schema.$ref).replace("#/components/schemas/", "");
+    }
+    if (schema.allOf && Array.isArray(schema.allOf)) {
+        return schema.allOf.map((s) => jsonSchemaToTs(s, schemas, depth + 1)).join(" & ");
+    }
+    if (schema.oneOf && Array.isArray(schema.oneOf)) {
+        return schema.oneOf.map((s) => jsonSchemaToTs(s, schemas, depth + 1)).join(" | ");
+    }
+    const type = schema.type;
+    if (type === "string")
+        return "string";
+    if (type === "number" || type === "integer")
+        return "number";
+    if (type === "boolean")
+        return "boolean";
+    if (type === "null")
+        return "null";
+    if (type === "array" || Array.isArray(schema.items)) {
+        const items = schema.items;
+        return `${jsonSchemaToTs(items, schemas, depth + 1)}[]`;
+    }
+    if (type === "object" || schema.properties) {
+        const props = (schema.properties ?? {});
+        const required = (schema.required ?? []);
+        const lines = Object.entries(props).map(([key, propSchema]) => {
+            const isRequired = required.includes(key) || !schema.required;
+            const propType = jsonSchemaToTs(propSchema, schemas, depth + 1);
+            const optional = isRequired ? "" : "?";
+            return `  ${key}${optional}: ${propType};`;
+        });
+        return `{\n${lines.join("\n")}\n}`;
+    }
+    return "unknown";
+}
+//# sourceMappingURL=codegen.js.map

package/dist/frontend/codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.js","sourceRoot":"","sources":["../../src/frontend/codegen.ts"],"names":[],"mappings":"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"}

package/dist/frontend/command.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Options for the `wild frontend` command.
+ */
+export interface FrontendOptions {
+    /** OpenAPI spec source: URL or file path. Default "./openapi.json". */
+    spec?: string;
+    /** Where to generate the frontend. Default "./frontend". */
+    path?: string;
+    /** Frontend target. Only "react" is supported for now. */
+    target?: string;
+    /** Base URL the generated client calls. */
+    baseUrl?: string;
+    /** Print what would be generated, write nothing. */
+    dryRun?: boolean;
+}
+/**
+ * Run the `wild frontend` generator.
+ *
+ * @returns true on success, false on error (error already printed)
+ */
+export declare function runFrontend(options: FrontendOptions): Promise<boolean>;
+//# sourceMappingURL=command.d.ts.map

package/dist/frontend/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/frontend/command.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAiD5E"}

package/dist/frontend/command.js

@@ -0,0 +1,57 @@
+import { resolve, relative } from "node:path";
+import { loadSpec, parseSpec } from "./spec.js";
+import { buildReactFrontend, writeFrontend } from "./scaffold.js";
+/**
+ * Run the `wild frontend` generator.
+ *
+ * @returns true on success, false on error (error already printed)
+ */
+export async function runFrontend(options) {
+    const specSource = options.spec ?? "./openapi.json";
+    const target = options.target ?? "react";
+    if (target !== "react") {
+        console.error(`wild: frontend target "${target}" is not supported yet. Available: react`);
+        return false;
+    }
+    console.log(`\nLoading OpenAPI spec from ${specSource}...`);
+    let raw;
+    try {
+        raw = await loadSpec(specSource);
+    }
+    catch (error) {
+        console.error(`wild: ${error instanceof Error ? error.message : String(error)}`);
+        console.error("\nHint: start your app (so /openapi.json is served) or pass --spec <file>.");
+        return false;
+    }
+    const spec = parseSpec(raw);
+    console.log(`  ${spec.title} v${spec.version} — ${spec.operations.length} operation(s)`);
+    // Default base URL: derive from spec URL host, or from --baseUrl.
+    const baseUrl = options.baseUrl ?? deriveBaseUrl(specSource);
+    const outRoot = resolve(options.path ?? "./frontend");
+    const files = buildReactFrontend(spec, { baseUrl, title: spec.title });
+    if (options.dryRun) {
+        console.log(`\nDry-run — would generate ${files.length} file(s) under ${relative(process.cwd(), outRoot)}:\n`);
+        for (const f of files) {
+            console.log(`  ${f.path}`);
+        }
+        return true;
+    }
+    console.log(`\nGenerating frontend under ${relative(process.cwd(), outRoot)}...\n`);
+    const written = writeFrontend(files, outRoot);
+    if (written === 0) {
+        console.log("\nNothing to do — all files already exist.");
+    }
+    else {
+        console.log(`\nDone. ${written} file(s) generated.`);
+        console.log("\nNext steps:");
+        console.log(`  cd ${relative(process.cwd(), outRoot)}`);
+        console.log("  npm install");
+        console.log("  npm run dev");
+    }
+    return true;
+}
+function deriveBaseUrl(specSource) {
+    const m = specSource.match(/^https?:\/\/([^/]+)/);
+    return m ? `${m[0]}/` : "http://localhost:3000";
+}
+//# sourceMappingURL=command.js.map

package/dist/frontend/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/frontend/command.ts"],"names":[],"mappings":"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"}

package/dist/frontend/react.d.ts

@@ -0,0 +1,14 @@
+import type { ParsedSpec } from "./spec.js";
+/**
+ * Generate the TypeScript types file from the spec's component schemas.
+ */
+export declare function generateTypes(spec: ParsedSpec): string;
+/**
+ * Generate the typed fetch client (api.ts).
+ */
+export declare function generateApiClient(spec: ParsedSpec, baseUrl: string): string;
+/**
+ * Generate TanStack Query hooks (hooks.ts).
+ */
+export declare function generateHooks(spec: ParsedSpec): string;
+//# sourceMappingURL=react.d.ts.map

package/dist/frontend/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/frontend/react.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,WAAW,CAAC;AAG3D;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAwBtD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CA0B3E;AAqCD;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAmEtD"}