create-nwire 0.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alex Gefter / 200apps Ltd.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,50 @@
+# create-nwire
+
+Scaffold a new Nwire project.
+
+```bash
+# pnpm
+pnpm create nwire my-app --template L2
+
+# npm
+npm create nwire my-app -- --template L2
+
+# yarn
+yarn create nwire my-app --template L2
+```
+
+## Templates
+
+| Level | Shape          | What you get                                                                                             |
+| ----- | -------------- | -------------------------------------------------------------------------------------------------------- |
+| `L1`  | **Minimal**    | One POST route. `httpInterface` + `endpoint`. No app, no DI. ~30 LOC.                                    |
+| `L2`  | **Service**    | Todo CRUD. Container, plugin lifecycle, structured errors, middleware, in-memory store.                  |
+| `L4`  | **Enterprise** | Moderation queue. `createApp`, modules, actors, events, stateful workflow (saga), projection, resolvers. |
+
+Pick the smallest level that fits — graduating up is just re-scaffolding
+into a new folder and porting your code one file at a time.
+
+## What ships with every level
+
+- **Zod-validated** route handlers, automatic OpenAPI at `/openapi.json`
+- **Graceful shutdown** via `@nwire/endpoint` (SIGTERM drain + lightship probes)
+- **K8s probes** on port 9000 (`/readyz`, `/healthz`)
+- **TypeScript strict** + Bundler module resolution for fast dev loops
+
+## After scaffold
+
+```bash
+cd my-app
+pnpm install
+pnpm dev
+```
+
+Then point `nwire studio` at the running app to get live traces +
+manual dispatch.
+
+## Flags
+
+| Flag         | Effect                                           |
+| ------------ | ------------------------------------------------ |
+| `--template` | `L1` \| `L2` \| `L4` (defaults to `L2`)          |
+| `--name`     | Override project name (defaults to dir basename) |

package/bin.mjs

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { runCli } from "./dist/index.js";
+await runCli();

package/dist/__tests__/scaffold.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Scaffold tests — verify each template materializes a coherent project
+ * directory with the project name substituted and the canonical files
+ * present. Does NOT install or boot the project (npm I in CI burns minutes
+ * and adds nothing — the templates themselves are exercised by the
+ * end-to-end examples that share their source).
+ */
+export {};
+//# sourceMappingURL=scaffold.test.d.ts.map

package/dist/__tests__/scaffold.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/scaffold.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/__tests__/scaffold.test.js

@@ -0,0 +1,83 @@
+/**
+ * Scaffold tests — verify each template materializes a coherent project
+ * directory with the project name substituted and the canonical files
+ * present. Does NOT install or boot the project (npm I in CI burns minutes
+ * and adds nothing — the templates themselves are exercised by the
+ * end-to-end examples that share their source).
+ */
+import { mkdtempSync, readFileSync, existsSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { scaffold } from "../index.js";
+describe("create-nwire scaffold", () => {
+    let target;
+    beforeEach(() => {
+        target = mkdtempSync(join(tmpdir(), "create-nwire-test-"));
+        rmSync(target, { recursive: true, force: true });
+    });
+    afterEach(() => {
+        if (existsSync(target))
+            rmSync(target, { recursive: true, force: true });
+    });
+    it("L1 — writes minimal http+endpoint shape with project name swapped", () => {
+        const { written } = scaffold({ target, template: "L1", name: "alpha" });
+        expect(written.length).toBeGreaterThan(0);
+        const pkg = JSON.parse(readFileSync(join(target, "package.json"), "utf8"));
+        expect(pkg.name).toBe("alpha");
+        expect(pkg.dependencies["@nwire/endpoint"]).toBeDefined();
+        expect(pkg.dependencies["@nwire/http"]).toBeDefined();
+        expect(existsSync(join(target, "src/main.ts"))).toBe(true);
+        expect(existsSync(join(target, "src/api.ts"))).toBe(true);
+        expect(existsSync(join(target, "tsconfig.json"))).toBe(true);
+        expect(existsSync(join(target, ".gitignore"))).toBe(true);
+        expect(readFileSync(join(target, "src/main.ts"), "utf8")).toContain('"alpha"');
+    });
+    it("L2 — writes the full service shape (model + errors + middleware + store)", () => {
+        const { written } = scaffold({ target, template: "L2", name: "beta-svc" });
+        expect(written.length).toBeGreaterThan(0);
+        const pkg = JSON.parse(readFileSync(join(target, "package.json"), "utf8"));
+        expect(pkg.name).toBe("beta-svc");
+        expect(pkg.dependencies["@nwire/forge"]).toBeDefined();
+        for (const f of ["main.ts", "api.ts", "model.ts", "errors.ts", "middleware.ts", "store.ts"]) {
+            expect(existsSync(join(target, "src", f))).toBe(true);
+        }
+    });
+    it("L4 — writes the enterprise shape (modules + workflow + projection)", () => {
+        const { written } = scaffold({ target, template: "L4", name: "gamma-app" });
+        expect(written.length).toBeGreaterThan(0);
+        const pkg = JSON.parse(readFileSync(join(target, "package.json"), "utf8"));
+        expect(pkg.name).toBe("gamma-app");
+        expect(pkg.dependencies["@nwire/app"]).toBeDefined();
+        expect(pkg.dependencies["@nwire/forge"]).toBeDefined();
+        for (const f of [
+            "main.ts",
+            "app.ts",
+            "api.ts",
+            "events.ts",
+            "actions.ts",
+            "moderation.module.ts",
+            "auto-moderate.workflow.ts",
+            "queue.projection.ts",
+        ]) {
+            expect(existsSync(join(target, "src", f))).toBe(true);
+        }
+    });
+    it("refuses to scaffold into a non-empty target", () => {
+        const { written } = scaffold({ target, template: "L1", name: "first" });
+        expect(written.length).toBeGreaterThan(0);
+        expect(() => scaffold({ target, template: "L1", name: "second" })).toThrowError(/not empty/);
+    });
+    it("derives project name from target dir basename when --name omitted", () => {
+        const t = join(tmpdir(), "create-nwire-derived-" + Date.now());
+        try {
+            scaffold({ target: t, template: "L1" });
+            const pkg = JSON.parse(readFileSync(join(t, "package.json"), "utf8"));
+            expect(pkg.name).toMatch(/^create-nwire-derived-/);
+        }
+        finally {
+            rmSync(t, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=scaffold.test.js.map

package/dist/__tests__/scaffold.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * create-nwire — scaffold a new Nwire project from one of three templates.
+ *
+ *   L1 → smallest possible (httpInterface + endpoint only, no domain)
+ *   L2 → in-memory app with one bounded context + middleware + structured errors
+ *   L4 → full enterprise shape (modules + actors + workflows + projections + resolvers)
+ *
+ * Usage:
+ *   pnpm create nwire <target-dir> [--template L1|L2|L4] [--no-install]
+ *
+ * The CLI is deliberately tiny — no interactive wizard, no plugin registry,
+ * no template fetching from GitHub. Picking a level is the only decision;
+ * everything else is whatever the user does once their starter is live.
+ */
+export type TemplateLevel = "L1" | "L2" | "L4";
+interface ScaffoldOptions {
+    target: string;
+    template: TemplateLevel;
+    name?: string;
+}
+/**
+ * Copy the template tree into target, swapping `{{PROJECT_NAME}}` in
+ * package.json and README.md so the scaffolded project reads coherent.
+ */
+export declare function scaffold(opts: ScaffoldOptions): {
+    written: string[];
+};
+export declare function runCli(): Promise<void>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAUH,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAiB/C,UAAU,eAAe;IACvB,MAAM,EAAI,MAAM,CAAC;IACjB,QAAQ,EAAE,aAAa,CAAC;IACxB,IAAI,CAAC,EAAK,MAAM,CAAC;CAClB;AAeD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAiBrE;AAqGD,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAE5C"}

package/dist/index.js

@@ -0,0 +1,168 @@
+/**
+ * create-nwire — scaffold a new Nwire project from one of three templates.
+ *
+ *   L1 → smallest possible (httpInterface + endpoint only, no domain)
+ *   L2 → in-memory app with one bounded context + middleware + structured errors
+ *   L4 → full enterprise shape (modules + actors + workflows + projections + resolvers)
+ *
+ * Usage:
+ *   pnpm create nwire <target-dir> [--template L1|L2|L4] [--no-install]
+ *
+ * The CLI is deliberately tiny — no interactive wizard, no plugin registry,
+ * no template fetching from GitHub. Picking a level is the only decision;
+ * everything else is whatever the user does once their starter is live.
+ */
+import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { defineCommand, runMain } from "citty";
+import pc from "picocolors";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const TEMPLATES = {
+    L1: {
+        title: "Minimal (L1)",
+        blurb: "httpInterface + endpoint only. ~30 LOC. No app, no DI, no domain.",
+    },
+    L2: {
+        title: "Service (L2)",
+        blurb: "Standalone http app with structured errors, middleware, in-memory store.",
+    },
+    L4: {
+        title: "Enterprise (L4)",
+        blurb: "Modules, actors, workflows, projections, resolvers — full forge shape.",
+    },
+};
+/**
+ * Locate the templates/ folder. In dev it's a sibling of dist/; in a
+ * published package it's a sibling of the bin entry. Resolve relative to
+ * this module file so both shapes work.
+ */
+function templatesRoot() {
+    // dist/index.js → ../templates ; src/index.ts (dev) → ../templates
+    const candidate = resolve(__dirname, "..", "templates");
+    if (existsSync(candidate))
+        return candidate;
+    // Fallback: src layout — go up one more
+    return resolve(__dirname, "..", "..", "templates");
+}
+/**
+ * Copy the template tree into target, swapping `{{PROJECT_NAME}}` in
+ * package.json and README.md so the scaffolded project reads coherent.
+ */
+export function scaffold(opts) {
+    const src = join(templatesRoot(), opts.template);
+    if (!existsSync(src)) {
+        throw new Error(`Template "${opts.template}" not found at ${src}`);
+    }
+    if (existsSync(opts.target) && readdirSync(opts.target).length > 0) {
+        throw new Error(`Target directory "${opts.target}" exists and is not empty.`);
+    }
+    mkdirSync(opts.target, { recursive: true });
+    const written = [];
+    copyTree(src, opts.target, written);
+    const projectName = opts.name ?? basename(opts.target);
+    applyVariables(opts.target, { PROJECT_NAME: projectName });
+    return { written };
+}
+function copyTree(src, dest, log) {
+    for (const entry of readdirSync(src)) {
+        const s = join(src, entry);
+        // npm strips dotfiles from published tarballs, so templates ship them
+        // as `_gitignore` / `_npmrc`; rename back on copy. Same trick that
+        // create-vite uses.
+        const renamed = entry.startsWith("_") ? "." + entry.slice(1) : entry;
+        const d = join(dest, renamed);
+        if (statSync(s).isDirectory()) {
+            mkdirSync(d, { recursive: true });
+            copyTree(s, d, log);
+        }
+        else {
+            cpSync(s, d);
+            log.push(d);
+        }
+    }
+}
+function applyVariables(root, vars) {
+    // Walk dest tree; for *.json, *.md, *.ts, *.mjs apply token substitution.
+    for (const entry of readdirSync(root)) {
+        const p = join(root, entry);
+        const st = statSync(p);
+        if (st.isDirectory()) {
+            applyVariables(p, vars);
+            continue;
+        }
+        if (!/\.(json|md|ts|mjs|js|cjs|yaml|yml)$/.test(entry))
+            continue;
+        const text = readFileSync(p, "utf8");
+        let out = text;
+        for (const [k, v] of Object.entries(vars)) {
+            out = out.split(`{{${k}}}`).join(v);
+        }
+        if (out !== text)
+            writeFileSync(p, out);
+    }
+}
+function basename(p) {
+    const parts = p.split(/[\\/]/).filter(Boolean);
+    return parts[parts.length - 1] ?? "nwire-app";
+}
+const main = defineCommand({
+    meta: {
+        name: "create-nwire",
+        description: "Scaffold a new Nwire project.",
+    },
+    args: {
+        target: {
+            type: "positional",
+            description: "Target directory (will be created if missing).",
+            required: false,
+        },
+        template: {
+            type: "string",
+            description: "Template level: L1 | L2 | L4",
+            default: "L2",
+        },
+        name: {
+            type: "string",
+            description: "Project name (defaults to target dir basename).",
+        },
+    },
+    async run(ctx) {
+        const targetArg = ctx.args.target;
+        if (!targetArg) {
+            console.error(pc.red("missing target directory."));
+            console.error(`  ${pc.dim("e.g.")} ${pc.cyan("pnpm create nwire my-app --template L2")}`);
+            console.error("");
+            console.error("templates:");
+            for (const [k, v] of Object.entries(TEMPLATES)) {
+                console.error(`  ${pc.yellow(k)}  ${pc.bold(v.title)}  ${pc.dim("— " + v.blurb)}`);
+            }
+            process.exit(1);
+        }
+        const tplRaw = String(ctx.args.template).toUpperCase();
+        if (tplRaw !== "L1" && tplRaw !== "L2" && tplRaw !== "L4") {
+            console.error(pc.red(`unknown template "${ctx.args.template}". Use L1, L2, or L4.`));
+            process.exit(1);
+        }
+        const template = tplRaw;
+        const target = resolve(process.cwd(), targetArg);
+        console.log(pc.cyan(`\n  scaffolding ${pc.bold(template)} into ${pc.bold(target)}`));
+        try {
+            const { written } = scaffold({ target, template, name: ctx.args.name });
+            console.log(pc.green(`  ✓ wrote ${written.length} files\n`));
+            console.log(`  next:`);
+            console.log(`    ${pc.dim("$")} ${pc.cyan(`cd ${targetArg}`)}`);
+            console.log(`    ${pc.dim("$")} ${pc.cyan("pnpm install")}`);
+            console.log(`    ${pc.dim("$")} ${pc.cyan("pnpm dev")}`);
+            console.log("");
+        }
+        catch (err) {
+            console.error(pc.red(`  ✗ ${err.message}`));
+            process.exit(1);
+        }
+    },
+});
+export async function runCli() {
+    await runMain(main);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC5G,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAI1D,MAAM,SAAS,GAA4D;IACzE,EAAE,EAAE;QACF,KAAK,EAAE,cAAc;QACrB,KAAK,EAAE,mEAAmE;KAC3E;IACD,EAAE,EAAE;QACF,KAAK,EAAE,cAAc;QACrB,KAAK,EAAE,0EAA0E;KAClF;IACD,EAAE,EAAE;QACF,KAAK,EAAE,iBAAiB;QACxB,KAAK,EAAE,wEAAwE;KAChF;CACF,CAAC;AAQF;;;;GAIG;AACH,SAAS,aAAa;IACpB,mEAAmE;IACnE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IACxD,IAAI,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,wCAAwC;IACxC,OAAO,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAqB;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,CAAC,QAAQ,kBAAkB,GAAG,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,CAAC,MAAM,4BAA4B,CAAC,CAAC;IAChF,CAAC;IACD,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEpC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvD,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC;IAE3D,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW,EAAE,IAAY,EAAE,GAAa;IACxD,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3B,sEAAsE;QACtE,mEAAmE;QACnE,oBAAoB;QACpB,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACrE,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9B,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YAC9B,SAAS,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAClC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACb,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,IAA4B;IAChE,0EAA0E;IAC1E,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC5B,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;YACrB,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YACxB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,qCAAqC,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,SAAS;QACjE,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACrC,IAAI,GAAG,GAAG,IAAI,CAAC;QACf,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1C,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,GAAG,KAAK,IAAI;YAAE,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS;IACzB,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/C,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,WAAW,CAAC;AAChD,CAAC;AAED,MAAM,IAAI,GAAG,aAAa,CAAC;IACzB,IAAI,EAAE;QACJ,IAAI,EAAS,cAAc;QAC3B,WAAW,EAAE,+BAA+B;KAC7C;IACD,IAAI,EAAE;QACJ,MAAM,EAAE;YACN,IAAI,EAAS,YAAY;YACzB,WAAW,EAAE,gDAAgD;YAC7D,QAAQ,EAAK,KAAK;SACnB;QACD,QAAQ,EAAE;YACR,IAAI,EAAS,QAAQ;YACrB,WAAW,EAAE,8BAA8B;YAC3C,OAAO,EAAM,IAAI;SAClB;QACD,IAAI,EAAE;YACJ,IAAI,EAAS,QAAQ;YACrB,WAAW,EAAE,iDAAiD;SAC/D;KACF;IACD,KAAK,CAAC,GAAG,CAAC,GAAG;QACX,MAAM,SAAS,GAAI,GAAG,CAAC,IAA4B,CAAC,MAAM,CAAC;QAC3D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC,CAAC;YACnD,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,wCAAwC,CAAC,EAAE,CAAC,CAAC;YAC1F,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAClB,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YAC5B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC/C,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACrF,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QACvD,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAC1D,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,qBAAqB,GAAG,CAAC,IAAI,CAAC,QAAQ,uBAAuB,CAAC,CAAC,CAAC;YACrF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,QAAQ,GAAG,MAAuB,CAAC;QACzC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;QAEjD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACrF,IAAI,CAAC;YACH,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACxE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,aAAa,OAAO,CAAC,MAAM,UAAU,CAAC,CAAC,CAAC;YAC7D,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;YAChE,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;YAC7D,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YACzD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,OAAQ,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,MAAM;IAC1B,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "create-nwire",
+  "version": "0.7.0",
+  "description": "Scaffolder for new Nwire projects. Run `pnpm create nwire <name>` or `npm create nwire <name>` to bootstrap.",
+  "keywords": [
+    "nwire",
+    "scaffolder",
+    "starter",
+    "template"
+  ],
+  "bin": {
+    "create-nwire": "./bin.mjs"
+  },
+  "files": [
+    "bin.mjs",
+    "dist",
+    "templates",
+    "README.md"
+  ],
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "citty": "^0.1.6",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.9",
+    "typescript": "^5.9.0",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "build": "tsc && node ../../scripts/fix-dist-extensions.mjs dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}

package/templates/L1/README.md

@@ -0,0 +1,34 @@
+# {{PROJECT_NAME}}
+
+The smallest possible Nwire shape — one POST route, one inline handler,
+no app, no DI, no domain primitives.
+
+## Run
+
+```bash
+pnpm install
+pnpm dev
+```
+
+## Try
+
+```bash
+curl -X POST http://localhost:3000/hello \
+  -H "content-type: application/json" \
+  -d '{"name":"Alice"}'
+```
+
+## What you get free
+
+| Feature                                | Comes from        |
+| -------------------------------------- | ----------------- |
+| Zod request validation                 | `@nwire/http`     |
+| OpenAPI schema (visit `/openapi.json`) | `@nwire/http`     |
+| Graceful SIGTERM drain                 | `@nwire/endpoint` |
+| K8s probes on port 9400                | `@nwire/endpoint` |
+
+## Grow up
+
+When you outgrow inline handlers (multiple routes, persistence, events)
+re-scaffold with `pnpm create nwire <name> --template L2` for the
+service shape or `--template L4` for the full enterprise shape.

package/templates/L1/_gitignore

@@ -0,0 +1,5 @@
+node_modules/
+dist/
+.nwire/
+*.log
+.DS_Store

package/templates/L1/app/api.ts

@@ -0,0 +1,18 @@
+/**
+ * Single route — Zod-validated body, typed handler return.
+ *
+ * This is the smallest possible Nwire shape. Once you outgrow inline
+ * handlers (multiple bounded contexts, persistence, events) graduate
+ * to the L2 or L4 templates.
+ */
+
+import { httpInterface, post } from "@nwire/http";
+import { z } from "zod";
+
+export const api = httpInterface().wire(
+  post("/hello", { body: z.object({ name: z.string().min(1) }) }),
+  async ({ input }) => {
+    const { name } = input as { name: string };
+    return { message: `Hello, ${name}!` };
+  },
+);

package/templates/L1/app/main.ts

@@ -0,0 +1,17 @@
+/**
+ * Entry — boots the http interface inside an endpoint.
+ *
+ * Run:    pnpm dev
+ * Try:    curl -X POST http://localhost:3000/hello \
+ *               -H "content-type: application/json" \
+ *               -d '{"name":"Alice"}'
+ *
+ * Probes (K8s readiness/liveness):
+ *   curl http://localhost:9400/ready
+ *   curl http://localhost:9400/live
+ */
+
+import { endpoint } from "@nwire/endpoint";
+import { api } from "./api";
+
+await endpoint("{{PROJECT_NAME}}", { port: 3000 }).serve(api).run();

package/templates/L1/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite-node app/main.ts",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@nwire/endpoint": "^0.7.0",
+    "@nwire/http": "^0.7.0",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.9",
+    "typescript": "^5.9.0",
+    "vite-node": "^3.2.4",
+    "vitest": "^4.0.18"
+  }
+}

package/templates/L1/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": ["ES2022"],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "noEmit": true,
+    "types": ["node", "vite/client"]
+  },
+  "include": ["app/**/*"]
+}

package/templates/L2/README.md

@@ -0,0 +1,50 @@
+# {{PROJECT_NAME}}
+
+A Level 2 Nwire service — todo CRUD with structured errors, middleware
+chain, public-shape projection, and an in-memory store wired via a
+container binding.
+
+No actors, no events, no workflows yet — see Level 4 for those.
+
+## Run
+
+```bash
+pnpm install
+pnpm dev
+```
+
+## Try
+
+```bash
+# create a todo
+curl -X POST http://localhost:3000/api/todos \
+  -H "content-type: application/json" \
+  -H "x-user-id: alice" \
+  -d '{"text":"buy milk"}'
+
+# list this user's todos
+curl -H "x-user-id: alice" http://localhost:3000/api/todos
+
+# complete one
+curl -X POST http://localhost:3000/api/todos/<id>/complete \
+  -H "x-user-id: alice"
+```
+
+## Source map
+
+| File            | What it does                                                |
+| --------------- | ----------------------------------------------------------- |
+| `main.ts`       | Boots `endpoint().serve(api).run()`                         |
+| `api.ts`        | The 4 routes + inline handlers                              |
+| `model.ts`      | `defineResource("Todo", ...)` — public field list           |
+| `errors.ts`     | `defineError(...)` — `TodoNotFound`, `TodoAlreadyCompleted` |
+| `middleware.ts` | `requireUser` — checks `x-user-id` header                   |
+| `store.ts`      | In-memory `TodoStore` + plugin shape                        |
+
+Swap `store.ts` for `@nwire/data-drizzle` (Postgres) or
+`@nwire/store-mongo` once you need durability.
+
+## Grow up
+
+When you need bounded contexts, actors, events, workflows, projections,
+re-scaffold with `pnpm create nwire <name> --template L4`.

package/templates/L2/_gitignore

@@ -0,0 +1,5 @@
+node_modules/
+dist/
+.nwire/
+*.log
+.DS_Store