@raiyyan/brisk 0.0.0-stage → 0.2.0

package/dist/bin/brisk.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=brisk.d.ts.map

package/dist/bin/brisk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brisk.d.ts","sourceRoot":"","sources":["../../bin/brisk.ts"],"names":[],"mappings":""}

package/dist/bin/brisk.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { createInterface } from "node:readline/promises";
+import { runCli } from "../src/cli/cli.js";
+const interactive = process.stdin.isTTY && process.stdout.isTTY;
+const prompt = interactive ? createInterface({ input: process.stdin, output: process.stdout }) : undefined;
+const code = await runCli(process.argv.slice(2), process.cwd(), {
+    log: console.log,
+    error: console.error,
+    ...(prompt ? { ask: (question) => prompt.question(question) } : {}),
+});
+prompt?.close();
+process.exit(code);
+//# sourceMappingURL=brisk.js.map

package/dist/bin/brisk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brisk.js","sourceRoot":"","sources":["../../bin/brisk.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;AAChE,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAE3G,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE;IAC9D,GAAG,EAAE,OAAO,CAAC,GAAG;IAChB,KAAK,EAAE,OAAO,CAAC,KAAK;IACpB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,QAAgB,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;CAC5E,CAAC,CAAC;AACH,MAAM,EAAE,KAAK,EAAE,CAAC;AAChB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}

package/dist/src/cli/agents.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Coding agents read the project's own `AGENTS.md` (Claude Code reads `CLAUDE.md`), not files in node_modules.
+ * Writes a brisk section between markers into `AGENTS.md`, refreshed in place on later runs without touching
+ * the rest of the file, and makes `CLAUDE.md` import both it and the full guide shipped in the package.
+ */
+export declare function writeAgentGuides(root: string): string[];
+//# sourceMappingURL=agents.d.ts.map

package/dist/src/cli/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/cli/agents.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CA2BvD"}

package/dist/src/cli/agents.js

@@ -0,0 +1,55 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { PACKAGE } from "./system.js";
+const GUIDE = `node_modules/${PACKAGE}/AGENTS.md`;
+const START = "<!-- brisk:start -->";
+const END = "<!-- brisk:end -->";
+/**
+ * Coding agents read the project's own `AGENTS.md` (Claude Code reads `CLAUDE.md`), not files in node_modules.
+ * Writes a brisk section between markers into `AGENTS.md`, refreshed in place on later runs without touching
+ * the rest of the file, and makes `CLAUDE.md` import both it and the full guide shipped in the package.
+ */
+export function writeAgentGuides(root) {
+    const agentsPath = join(root, "AGENTS.md");
+    const block = `${START}\n${section}\n${END}`;
+    const existing = existsSync(agentsPath) ? readFileSync(agentsPath, "utf8") : "";
+    const start = existing.indexOf(START);
+    const end = existing.indexOf(END);
+    const agents = start !== -1 && end > start
+        ? existing.slice(0, start) + block + existing.slice(end + END.length)
+        : existing === ""
+            ? `# AGENTS.md\n\n${block}\n`
+            : `${existing.trimEnd()}\n\n${block}\n`;
+    writeFileSync(agentsPath, agents);
+    const claudePath = join(root, "CLAUDE.md");
+    const claude = existsSync(claudePath) ? readFileSync(claudePath, "utf8") : "";
+    const imports = ["@AGENTS.md", `@${GUIDE}`].filter((line) => !claude.split("\n").includes(line));
+    if (imports.length > 0) {
+        writeFileSync(claudePath, `${claude.trimEnd()}${claude === "" ? "" : "\n"}${imports.join("\n")}\n`);
+    }
+    return [
+        `${existing === "" ? "created" : "updated"} AGENTS.md`,
+        imports.length > 0
+            ? `${claude === "" ? "created" : "updated"} CLAUDE.md`
+            : "CLAUDE.md already imports the guide",
+    ];
+}
+const section = `## Building with brisk
+
+This app uses [brisk](https://www.npmjs.com/package/${PACKAGE}), a typed layer over Express 5 and Zod.
+Before writing or changing server code, read the full guide: \`${GUIDE}\`.
+
+Essentials:
+
+- The app is declared once in \`src/app.ts\` with \`defineApp\`; \`app.listen(port)\` runs it, \`createTestClient(app, { providers })\` tests it.
+- Routes are named: a controller's setup returns \`{ list: route.get(...), create: route.post(...) }\`. The names form the typed client (\`api.users.create({ body })\`).
+- Validate every input with a Zod schema on the route; set \`response\` to a DTO schema so internal fields never leak.
+- New code follows this project's own templates: \`npx brisk g feature <name>\` renders \`templates/feature/\`. Edit the templates when the project's conventions change.
+- Dependencies: \`readonly #repo = inject(Repository)\` in class fields. No decorators, no constructor wiring.
+- Errors: \`throw new NotFoundError("…")\` (or another error class) anywhere. Never try/catch to build responses; never call \`next()\`.
+- Shared request logic: \`defineMiddleware\` returning an object types \`ctx\`; declare \`params\` or \`query\` it reads to get them validated first. Express middleware such as multer goes in a route's \`use\` through \`fromExpress()\`.
+- App-wide middleware goes in \`defineApp({ use })\` (\`fromExpress(cors())\` included); handlers that are not brisk routes (static files, GraphQL, webhooks) go in \`defineApp({ mount })\`. Express settings go in \`http.settings\`.
+- Long-lived work (WebSockets, jobs, consumers, pools) is a provider class with \`onInit\`, \`onReady\`, \`onDrain\`, \`onShutdown\`; a feature lists its own in \`defineController({ providers })\`.
+- Test with \`createTestClient\` from \`${PACKAGE}/testing\`: \`api.call.<controller>.<route>(input)\` is typed; \`api.post(path)\` checks raw HTTP.
+`;
+//# sourceMappingURL=agents.js.map

package/dist/src/cli/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../../src/cli/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,MAAM,KAAK,GAAG,gBAAgB,OAAO,YAAY,CAAC;AAClD,MAAM,KAAK,GAAG,sBAAsB,CAAC;AACrC,MAAM,GAAG,GAAG,oBAAoB,CAAC;AAEjC;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,GAAG,KAAK,KAAK,OAAO,KAAK,GAAG,EAAE,CAAC;IAC7C,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChF,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,MAAM,GACV,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,GAAG,KAAK;QACzB,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC;QACrE,CAAC,CAAC,QAAQ,KAAK,EAAE;YACf,CAAC,CAAC,kBAAkB,KAAK,IAAI;YAC7B,CAAC,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9C,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAElC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,MAAM,OAAO,GAAG,CAAC,YAAY,EAAE,IAAI,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IACjG,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,aAAa,CAAC,UAAU,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtG,CAAC;IAED,OAAO;QACL,GAAG,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,YAAY;QACtD,OAAO,CAAC,MAAM,GAAG,CAAC;YAChB,CAAC,CAAC,GAAG,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,YAAY;YACtD,CAAC,CAAC,qCAAqC;KAC1C,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,GAAG;;sDAEsC,OAAO;iEACI,KAAK;;;;;;;;;;;;;0CAa5B,OAAO;CAChD,CAAC"}

package/dist/src/cli/cli.d.ts

@@ -0,0 +1,5 @@
+import { type CliIo } from "./system.ts";
+export type { CliIo } from "./system.ts";
+/** Entry point of the \`brisk\` binary; resolves with the exit code. */
+export declare function runCli(argv: readonly string[], root: string, io?: CliIo): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/src/cli/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/cli/cli.ts"],"names":[],"mappings":"AAQA,OAAO,EAAoB,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAE3D,YAAY,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAmBzC,wEAAwE;AACxE,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAE,KAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CA6DxG"}

package/dist/src/cli/cli.js

@@ -0,0 +1,113 @@
+import { readFileSync } from "node:fs";
+import { relative } from "node:path";
+import { parseArgs } from "node:util";
+import { writeAgentGuides } from "./agents.js";
+import { generateClient, generateOpenApi } from "./client.js";
+import { initProject, listStarters } from "./init.js";
+import { toNames } from "./names.js";
+import { renderTemplates } from "./render.js";
+import { CliError, format } from "./system.js";
+const USAGE = `Usage: brisk <command> [options]
+
+Commands:
+  init                     Start a project here from a starter; never overwrites files
+    --starter <name>              Which starter (default: minimal); \`brisk init --starter list\` shows them
+    --pm <pnpm|npm|yarn>          Package manager (default: detected)
+    --no-install                  Print the install command instead of running it
+  g <kind> <name>          Render the project's templates/<kind>/ for <name>, such as \`g feature notes\`
+  client --out <file>      Write the route manifest for a frontend's typed client
+  openapi --out <file>     Write the OpenAPI 3.1 document built from the routes' schemas
+    --app <file>                  Module exporting the app, for client and openapi (default src/app.ts)
+  agents                   Add or refresh the brisk guide for AI coding agents (AGENTS.md, CLAUDE.md)
+  help, --version
+
+Run from the app's root. A starter brings its own choices (database, auth, tooling) and the templates that
+\`brisk g\` renders; the templates are files in your project, yours to edit.`;
+/** Entry point of the \`brisk\` binary; resolves with the exit code. */
+export async function runCli(argv, root, io = console) {
+    try {
+        const { values, positionals } = parseArgs({
+            args: [...argv],
+            allowPositionals: true,
+            allowNegative: true,
+            options: {
+                starter: { type: "string", default: "minimal" },
+                pm: { type: "string" },
+                install: { type: "boolean", default: true },
+                out: { type: "string" },
+                app: { type: "string", default: "src/app.ts" },
+                help: { type: "boolean", short: "h", default: false },
+                version: { type: "boolean", default: false },
+            },
+        });
+        const [command, kind, name] = positionals;
+        if (values.version) {
+            io.log(version());
+            return 0;
+        }
+        if (values.help || command === "help" || command === undefined) {
+            io.log(USAGE);
+            return command === undefined && !values.help ? 1 : 0;
+        }
+        if (command === "init") {
+            if (values.starter === "list") {
+                io.log(`Starters: ${listStarters().join(", ")}`);
+                return 0;
+            }
+            for (const line of initProject(root, values, io))
+                io.log(line);
+            return 0;
+        }
+        if (command === "agents") {
+            for (const line of writeAgentGuides(root))
+                io.log(line);
+            return 0;
+        }
+        if (command === "client" || command === "openapi") {
+            if (!values.out)
+                throw new CliError(`brisk ${command} needs --out <file>`);
+            const generate = command === "client" ? generateClient : generateOpenApi;
+            for (const line of await generate(root, { app: values.app, out: values.out }))
+                io.log(line);
+            return 0;
+        }
+        if ((command !== "g" && command !== "generate") || !kind || !name)
+            throw new CliError(USAGE);
+        const rendered = renderTemplates(root, kind, toNames(name));
+        for (const file of rendered.created)
+            io.log(`created ${relative(root, file)}`);
+        for (const file of rendered.updated)
+            io.log(`updated ${relative(root, file)}`);
+        const formatted = format(root, [...rendered.created, ...rendered.updated]);
+        if (formatted)
+            io.log(formatted);
+        return 0;
+    }
+    catch (error) {
+        if (error instanceof CliError) {
+            io.error(error.message);
+            return 1;
+        }
+        if (error instanceof TypeError && "code" in error && String(error.code).startsWith("ERR_PARSE_ARGS")) {
+            io.error(`${error.message}\n\n${USAGE}`);
+            return 1;
+        }
+        throw error;
+    }
+}
+/** The installed brisk version: the nearest `package.json` above this file, in sources and in `dist` alike. */
+function version() {
+    for (let dir = new URL(".", import.meta.url); dir.pathname !== "/"; dir = new URL("..", dir)) {
+        try {
+            const pkg = JSON.parse(readFileSync(new URL("package.json", dir), "utf8"));
+            const value = typeof pkg === "object" && pkg !== null ? Reflect.get(pkg, "version") : undefined;
+            if (typeof value === "string")
+                return value;
+        }
+        catch {
+            continue;
+        }
+    }
+    return "unknown";
+}
+//# sourceMappingURL=cli.js.map

package/dist/src/cli/cli.js.map

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

package/dist/src/cli/client.d.ts

@@ -0,0 +1,12 @@
+interface Target {
+    /** The module exporting `app` (made with `defineApp`), relative to the project root. */
+    app: string;
+    /** The file to write, relative to the project root. */
+    out: string;
+}
+/** Writes the app's route manifest as a TypeScript module, for a frontend's typed client. */
+export declare function generateClient(root: string, { app, out }: Target): Promise<string[]>;
+/** Writes the app's OpenAPI 3.1 document as JSON. */
+export declare function generateOpenApi(root: string, { app, out }: Target): Promise<string[]>;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/src/cli/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/cli/client.ts"],"names":[],"mappings":"AAYA,UAAU,MAAM;IACd,wFAAwF;IACxF,GAAG,EAAE,MAAM,CAAC;IACZ,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAC;CACb;AAED,6FAA6F;AAC7F,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAW1F;AAED,qDAAqD;AACrD,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAI3F"}

package/dist/src/cli/client.js

@@ -0,0 +1,76 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { existsSync } from "node:fs";
+import { join, relative } from "node:path";
+import { pathToFileURL } from "node:url";
+import { CliError, write } from "./system.js";
+/** Writes the app's route manifest as a TypeScript module, for a frontend's typed client. */
+export async function generateClient(root, { app, out }) {
+    const { manifest } = await loadApp(root, app);
+    const target = write(join(root, out), `// Generated by \`brisk client\` from ${app}. Do not edit: run it again after changing routes.
+import type { Manifest } from "@raiyyan/brisk/client";
+
+export const manifest = ${serialize(manifest, "")} as const satisfies Manifest;
+`);
+    return [`wrote ${relative(root, target)}`, "use it: createClient<Api>(manifest, { baseUrl })"];
+}
+/** Writes the app's OpenAPI 3.1 document as JSON. */
+export async function generateOpenApi(root, { app, out }) {
+    const { openapi } = await loadApp(root, app);
+    const target = write(join(root, out), `${JSON.stringify(openapi(), null, 2)}\n`);
+    return [`wrote ${relative(root, target)}`];
+}
+/**
+ * Imports the app module and reads its `app` export. Nothing listens, but the module runs and the routes are
+ * built: the environment must be valid, as for starting the app.
+ */
+async function loadApp(root, app) {
+    const source = join(root, app);
+    if (!existsSync(source)) {
+        throw new CliError(`${app} not found: pass --app <path to the module exporting app>`);
+    }
+    const module = await import(__rewriteRelativeImportExtension(pathToFileURL(source).href));
+    const loaded = findApp(module);
+    if (!loaded)
+        throw new CliError(`${app} must export app, made with defineApp()`);
+    return loaded;
+}
+function findApp(module) {
+    if (typeof module !== "object" || module === null)
+        return undefined;
+    const app = Reflect.get(module, "app");
+    if (typeof app !== "object" || app === null)
+        return undefined;
+    const manifest = Reflect.get(app, "manifest");
+    const openapi = Reflect.get(app, "openapi");
+    if (!isManifest(manifest))
+        return undefined;
+    return {
+        manifest,
+        openapi: () => (typeof openapi === "function" ? Reflect.apply(openapi, app, []) : {}),
+    };
+}
+/** The manifest as source, one route per line: `"get": ["GET", "/api/users/:id"],`. */
+function serialize(manifest, indent) {
+    const inner = `${indent}  `;
+    const lines = Object.entries(manifest).map(([name, entry]) => {
+        const value = isEndpoint(entry)
+            ? `[${entry.map((part) => JSON.stringify(part)).join(", ")}]`
+            : serialize(entry, inner);
+        return `${inner}${JSON.stringify(name)}: ${value},`;
+    });
+    return `{\n${lines.join("\n")}\n${indent}}`;
+}
+function isEndpoint(entry) {
+    return Array.isArray(entry);
+}
+function isManifest(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=client.js.map

package/dist/src/cli/client.js.map

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

package/dist/src/cli/init.d.ts

@@ -0,0 +1,16 @@
+import { type CliIo } from "./system.ts";
+/** `brisk init` flags. */
+export interface InitFlags {
+    starter: string;
+    pm?: string | undefined;
+    install: boolean;
+}
+/**
+ * Starts a project from a starter: a complete, tested app that brings its own choices (database, auth,
+ * tooling) and the templates `brisk g` generates from. Files that already exist are kept; `package.json` gains
+ * what it lacks. Then the packages are installed and the agent guide is written.
+ */
+export declare function initProject(root: string, flags: InitFlags, io: CliIo): string[];
+/** The starters shipped with this version of brisk. */
+export declare function listStarters(): string[];
+//# sourceMappingURL=init.d.ts.map

package/dist/src/cli/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/init.ts"],"names":[],"mappings":"AAIA,OAAO,EAQL,KAAK,KAAK,EAEX,MAAM,aAAa,CAAC;AAErB,0BAA0B;AAC1B,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,GAAG,MAAM,EAAE,CAgC/E;AAED,uDAAuD;AACvD,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAKvC"}

package/dist/src/cli/init.js

@@ -0,0 +1,149 @@
+import { cpSync, existsSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { basename, dirname, join, relative } from "node:path";
+import { fileURLToPath } from "node:url";
+import { writeAgentGuides } from "./agents.js";
+import { CliError, detectPackageManager, format, PACKAGE, PackageJson, readPackageJson, run, } from "./system.js";
+/** Never copied out of a starter: installs, local data, secrets, and the guides `brisk agents` writes. */
+const SKIPPED = new Set(["node_modules", "dist", "coverage", ".env", "AGENTS.md", "CLAUDE.md"]);
+const SKIPPED_SUFFIXES = [".db", ".db-wal", ".db-shm", ".log"];
+/**
+ * Starts a project from a starter: a complete, tested app that brings its own choices (database, auth,
+ * tooling) and the templates `brisk g` generates from. Files that already exist are kept; `package.json` gains
+ * what it lacks. Then the packages are installed and the agent guide is written.
+ */
+export function initProject(root, flags, io) {
+    const starter = findStarter(flags.starter);
+    const pm = flags.pm ?? detectPackageManager(root);
+    if (!isPackageManager(pm))
+        throw new CliError(`Unknown package manager "${pm}": use pnpm, npm or yarn.`);
+    const lines = [];
+    for (const entry of readdirSync(starter)) {
+        if (!skipped(entry) && entry !== "package.json")
+            copy(join(starter, entry), join(root, published(entry)), root, lines);
+    }
+    lines.push(mergePackageJson(starter, root), ...writeAgentGuides(root));
+    for (const line of lines)
+        io.log(line);
+    const install = [pm, "install"];
+    if (!flags.install)
+        return [`install: ${install.join(" ")}`, "", ...nextSteps(pm)];
+    io.log(`$ ${install.join(" ")}`);
+    try {
+        run(install, root);
+        const formatted = format(root, ["package.json", "AGENTS.md", "CLAUDE.md"].map((file) => join(root, file)));
+        if (formatted)
+            io.log(formatted);
+    }
+    catch {
+        throw new CliError([
+            `The project files are in place, but \`${install.join(" ")}\` failed. Fix the cause above and run it again.`,
+            ...(pm === "pnpm" ? ["If pnpm blocked build scripts, review them with: pnpm approve-builds"] : []),
+        ].join("\n"));
+    }
+    return ["", ...nextSteps(pm)];
+}
+/** The starters shipped with this version of brisk. */
+export function listStarters() {
+    const dir = startersDir();
+    return readdirSync(dir)
+        .filter((name) => statSync(join(dir, name)).isDirectory())
+        .toSorted();
+}
+/** Finds `starters/` above this file: the repository root in development, the package root once published. */
+function startersDir() {
+    for (let dir = dirname(fileURLToPath(import.meta.url));; dir = dirname(dir)) {
+        if (existsSync(join(dir, "starters")))
+            return join(dir, "starters");
+        if (dirname(dir) === dir)
+            throw new CliError("No starters found next to this brisk installation.");
+    }
+}
+function findStarter(name) {
+    const path = join(startersDir(), name);
+    if (!/^[\w-]+$/.test(name) || !existsSync(path)) {
+        throw new CliError(`Unknown starter "${name}". Starters: ${listStarters().join(", ")}.`);
+    }
+    return path;
+}
+/**
+ * npm drops every `.gitignore` from a published package, so starters keep theirs as `_gitignore` and the
+ * project gets it back under its real name.
+ */
+function published(name) {
+    return name === "_gitignore" ? ".gitignore" : name;
+}
+function skipped(name) {
+    return SKIPPED.has(name) || SKIPPED_SUFFIXES.some((suffix) => name.endsWith(suffix));
+}
+/** Copies a starter's file or folder into the project, keeping every file that is already there. */
+function copy(source, target, root, lines) {
+    if (statSync(source).isDirectory()) {
+        for (const entry of readdirSync(source)) {
+            if (!skipped(entry))
+                copy(join(source, entry), join(target, entry), root, lines);
+        }
+        return;
+    }
+    const path = relative(root, target);
+    if (existsSync(target)) {
+        lines.push(`kept ${path}`);
+        return;
+    }
+    cpSync(source, target);
+    lines.push(`created ${path}`);
+}
+/**
+ * Gives the project's `package.json` what the starter's has and it lacks: `type`, `engines`, scripts and
+ * dependencies.
+ * The starter depends on brisk through the workspace; the project gets the version that is running.
+ */
+function mergePackageJson(starter, root) {
+    const template = PackageJson.parse(JSON.parse(readFileSync(join(starter, "package.json"), "utf8")));
+    const project = readPackageJson(root);
+    const running = version();
+    const brisk = running === undefined ? "latest" : `^${running}`;
+    const pin = (deps) => Object.fromEntries(Object.entries(deps ?? {}).map(([name, range]) => [name, name === PACKAGE ? brisk : range]));
+    const merged = {
+        ...project,
+        name: typeof project["name"] === "string" ? project["name"] : basename(root),
+        type: "module",
+        engines: project["engines"] ?? template["engines"],
+        scripts: { ...template.scripts, ...withoutNpmStub(project.scripts) },
+        dependencies: { ...pin(template.dependencies), ...project.dependencies },
+        devDependencies: { ...pin(template.devDependencies), ...project.devDependencies },
+    };
+    writeFileSync(join(root, "package.json"), `${JSON.stringify(merged, null, 2)}\n`);
+    return project.type !== undefined && project.type !== "module"
+        ? `updated package.json ("type" is now "module": brisk apps are ES modules)`
+        : "updated package.json";
+}
+/** `npm init` writes a `test` script that only fails; the starter's replaces it. */
+function withoutNpmStub(scripts) {
+    return Object.fromEntries(Object.entries(scripts ?? {}).filter(([, command]) => !command.includes("Error: no test specified")));
+}
+/** The running brisk's version: the nearest `package.json` named `@raiyyan/brisk` above this file. */
+function version() {
+    for (let dir = dirname(fileURLToPath(import.meta.url));; dir = dirname(dir)) {
+        const path = join(dir, "package.json");
+        if (existsSync(path)) {
+            const pkg = PackageJson.parse(JSON.parse(readFileSync(path, "utf8")));
+            if (pkg["name"] === PACKAGE && typeof pkg["version"] === "string")
+                return pkg["version"];
+        }
+        if (dirname(dir) === dir)
+            return undefined;
+    }
+}
+function isPackageManager(value) {
+    return value === "pnpm" || value === "npm" || value === "yarn";
+}
+function nextSteps(pm) {
+    const exec = pm === "npm" ? "npx" : pm;
+    return [
+        "Next:",
+        "  cp .env.example .env",
+        `  ${exec} brisk g feature tasks    # renders templates/feature, which you own and can edit`,
+        `  ${pm} run dev`,
+    ];
+}
+//# sourceMappingURL=init.js.map

package/dist/src/cli/init.js.map

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

package/dist/src/cli/names.d.ts

@@ -0,0 +1,14 @@
+/** The spellings of a name a generator needs. */
+export interface Names {
+    /** Folder, file and route name, as typed: `blog-posts`. */
+    kebab: string;
+    /** Controller and middleware variables, and the client's key: `blogPosts`. */
+    camel: string;
+    /** Service and repository classes: `BlogPosts`. */
+    pascal: string;
+    /** One record and its schemas: `BlogPost`, `CreateBlogPostBody`. */
+    entity: string;
+}
+/** `"BlogPosts"`, `"blog_posts"` and `"blog posts"` all give `blog-posts`, `blogPosts`, `BlogPosts`, `BlogPost`. */
+export declare function toNames(raw: string): Names;
+//# sourceMappingURL=names.d.ts.map

package/dist/src/cli/names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../../src/cli/names.ts"],"names":[],"mappings":"AAEA,iDAAiD;AACjD,MAAM,WAAW,KAAK;IACpB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,oHAAoH;AACpH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAW1C"}

package/dist/src/cli/names.js

@@ -0,0 +1,25 @@
+import { CliError } from "./system.js";
+/** `"BlogPosts"`, `"blog_posts"` and `"blog posts"` all give `blog-posts`, `blogPosts`, `BlogPosts`, `BlogPost`. */
+export function toNames(raw) {
+    const kebab = raw
+        .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
+        .replace(/[\s_]+/g, "-")
+        .toLowerCase();
+    if (!/^[a-z][a-z0-9]*(-[a-z0-9]+)*$/.test(kebab)) {
+        throw new CliError(`Invalid name "${raw}": use letters, digits and dashes, starting with a letter.`);
+    }
+    const camel = kebab.replace(/-([a-z0-9])/g, (_match, char) => char.toUpperCase());
+    const pascal = camel.charAt(0).toUpperCase() + camel.slice(1);
+    return { kebab, camel, pascal, entity: singular(pascal) };
+}
+/** `Products` gives `Product`, `Categories` gives `Category`, `Addresses` gives `Address`; `Status` stays. */
+function singular(word) {
+    if (/[^aeiou]ies$/.test(word))
+        return `${word.slice(0, -3)}y`;
+    if (/(ss|sh|ch|x|z|us)es$/.test(word))
+        return word.slice(0, -2);
+    if (/(ss|us|is)$/.test(word))
+        return word;
+    return word.endsWith("s") ? word.slice(0, -1) : word;
+}
+//# sourceMappingURL=names.js.map

package/dist/src/cli/names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.js","sourceRoot":"","sources":["../../../src/cli/names.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAcvC,oHAAoH;AACpH,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,MAAM,KAAK,GAAG,GAAG;SACd,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,WAAW,EAAE,CAAC;IACjB,IAAI,CAAC,+BAA+B,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,QAAQ,CAAC,iBAAiB,GAAG,4DAA4D,CAAC,CAAC;IACvG,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1F,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED,8GAA8G;AAC9G,SAAS,QAAQ,CAAC,IAAY;IAC5B,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IAC9D,IAAI,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAChE,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACvD,CAAC"}

package/dist/src/cli/render.d.ts

@@ -0,0 +1,30 @@
+import type { Names } from "./names.ts";
+/** What `brisk g` did: files it created, and existing files it added to. */
+export interface Rendered {
+    created: string[];
+    updated: string[];
+}
+/** What rendering a template folder produces, before anything is written. */
+export interface TemplatePlan {
+    /** New files, by path relative to the project root. */
+    files: Map<string, string>;
+    /** Text to add to existing files: target path relative to the root, the marker, and the text. */
+    inserts: {
+        target: string;
+        marker: string;
+        text: string;
+    }[];
+}
+/**
+ * Renders the project's own `templates/<kind>/` for `names`. Every file is copied with its path and contents
+ * rendered; `{{kebab}}`, `{{camel}}`, `{{pascal}}`, `{{snake}}`, `{{entity}}` and `{{entityCamel}}` are the
+ * tokens. A file named `<target>.<marker>.insert` is not copied: its text goes into the existing `<target>`,
+ * right before the line that holds `@brisk:<marker>`.
+ *
+ * Everything is checked before anything is written: an unknown token, a file that already exists, or a
+ * missing marker stops the run with nothing changed.
+ */
+export declare function renderTemplates(root: string, kind: string, names: Names): Rendered;
+/** Renders a template folder in memory: the files it creates and the text it adds, nothing written. */
+export declare function planTemplates(dir: string, names: Names, root: string): TemplatePlan;
+//# sourceMappingURL=render.d.ts.map

package/dist/src/cli/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/cli/render.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxC,4EAA4E;AAC5E,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAKD,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,iGAAiG;IACjG,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,QAAQ,CAoBlF;AAED,uGAAuG;AACvG,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAqBnF"}