create-nwire 0.10.0 → 0.11.0

package/README.md

@@ -15,11 +15,11 @@ yarn create nwire my-app --template service
 
 ## Templates
 
-| Name         | What you get                                                                                                |
-| ------------ | ----------------------------------------------------------------------------------------------------------- |
-| `minimal`    | One POST route. `createApp` + `httpKoa`. No DI, no forge. ~40 LOC.                                          |
-| `service`    | Todo CRUD. Container plugin, structured errors, route middleware, in-memory store.                          |
-| `enterprise` | Moderation queue. Forge: actions + events + actors + stateful workflow + projection, multi-app composable.  |
+| Name         | What you get                                                                                               |
+| ------------ | ---------------------------------------------------------------------------------------------------------- |
+| `minimal`    | One POST route. `createApp` + `httpKoa`. No DI, no forge. ~40 LOC.                                         |
+| `service`    | Todo CRUD. Container plugin, structured errors, route middleware, in-memory store.                         |
+| `enterprise` | Moderation queue. Forge: actions + events + actors + stateful workflow + projection, multi-app composable. |
 
 Pick the smallest template that fits — graduating up is just re-scaffolding
 into a new folder and porting your code one file at a time.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-nwire",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Scaffolder for new Nwire projects. Run `pnpm create nwire <name>` or `npm create nwire <name>` to bootstrap.",
   "keywords": [
     "nwire",

package/templates/enterprise/app/app.ts

@@ -1,10 +1,9 @@
 /**
  * `buildApp` composes the posts bounded context into a runnable App.
  *
- * 0.10 shape — no modules. Each piece (events, actions, workflows,
- * projections, queries) is imported directly; createApp installs a
- * forge plugin with the workflows/projections/queries it needs, and
- * registers the handlers via the `handlers` array.
+ * Each piece (events, actions, workflows, projections, queries) is
+ * imported directly; `.with(createForgePlugin(...))` installs forge with
+ * the handlers, workflows, projections, and queries the BC needs.
  *
  * For multi-BC apps, build each as its own App and compose:
  *
@@ -28,17 +27,14 @@ import {
 import { postsByAuthor } from "../modules/posts/queries/posts-by-author";
 
 export function buildApp() {
-  return createApp({
-    appName: "{{PROJECT_NAME}}",
-    plugins: [
-      createForgePlugin({
-        workflows: [autoModerate],
-        projections: [queueDashboard],
-        queries: [listPending, queueTotals, getPost, postsByAuthor],
-      }),
-    ],
-    handlers: [submitPost.handler!, approvePost.handler!, rejectPost.handler!],
-  });
+  return createApp({ appName: "{{PROJECT_NAME}}" }).with(
+    createForgePlugin({
+      handlers: [submitPost.handler!, approvePost.handler!, rejectPost.handler!],
+      workflows: [autoModerate],
+      projections: [queueDashboard],
+      queries: [listPending, queueTotals, getPost, postsByAuthor],
+    }),
+  );
 }
 
 export const app = buildApp();

package/templates/enterprise/app/main.ts

@@ -1,8 +1,8 @@
 /**
  * Entry — boot the app under HTTP.
  *
- *   1. buildApp registers handlers + forge plugin (workflows, projections,
- *      queries) on the container.
+ *   1. buildApp composes the App with forge (handlers, workflows,
+ *      projections, queries) via `.with(createForgePlugin(...))`.
  *   2. app.wire(...) pairs every route binding with its handler.
  *   3. endpoint().use(httpKoa({prefix:"/api"})).mount(app).run() starts
  *      the HTTP listener + graceful drain + K8s probes.

package/templates/enterprise/modules/posts/routes/reject-post.ts

@@ -19,10 +19,7 @@ type Input = z.infer<typeof Params> & z.infer<typeof Body>;
 
 export const rejectPostRoute = post("/posts/:postId/reject", { params: Params, body: Body });
 
-export const rejectPostHandler = async (
-  input: Input,
-  ctx: { resolve: <T>(name: string) => T },
-) => {
+export const rejectPostHandler = async (input: Input, ctx: { resolve: <T>(name: string) => T }) => {
   const dispatcher = ctx.resolve<ForgeDispatcher>("forge.dispatcher");
   await dispatcher.dispatch(rejectPost, {
     postId: input.postId,

package/templates/enterprise/package.json

@@ -8,16 +8,16 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@nwire/app": "^0.10.0",
-    "@nwire/endpoint": "^0.10.0",
-    "@nwire/forge": "^0.10.0",
-    "@nwire/wires": "^0.10.0",
-    "@nwire/koa": "^0.10.0",
-    "@nwire/messages": "^0.10.0",
+    "@nwire/app": "^0.11.0",
+    "@nwire/endpoint": "^0.11.0",
+    "@nwire/forge": "^0.11.0",
+    "@nwire/koa": "^0.11.0",
+    "@nwire/messages": "^0.11.0",
+    "@nwire/wires": "^0.11.0",
     "zod": "^4.0.0"
   },
   "devDependencies": {
-    "@nwire/test-kit": "^0.10.0",
+    "@nwire/test-kit": "^0.11.0",
     "@types/node": "^22.19.9",
     "typescript": "^5.9.0",
     "vite-node": "^3.2.4",

package/templates/minimal/app/api.ts

@@ -15,6 +15,4 @@
 
 import { helloRoute, helloHandler } from "./routes/hello";
 
-export const wires = [
-  { binding: helloRoute, handler: helloHandler },
-] as const;
+export const wires = [{ binding: helloRoute, handler: helloHandler }] as const;

package/templates/minimal/app/main.ts

@@ -3,8 +3,8 @@
  *
  *   createApp(...)        — the bounded context (container + wires)
  *   app.wire(...)         — pair a binding with its handler
- *   endpoint().use(...)   — install a transport adopter (HTTP, queue, MCP, …)
- *   .mount(app).run()     — boot the app under the adopters; ready for traffic
+ *   endpoint().use(...)   — install a transport adapter (HTTP, queue, MCP, …)
+ *   .mount(app).run()     — boot the app under the adapters; ready for traffic
  *
  * The minimal shape: no DI, no forge, no domain primitives. Two packages
  * and three files. Graduate to `service` when you need a container, store,
@@ -31,8 +31,5 @@ export function buildApp() {
 
 if (import.meta.url === `file://${process.argv[1]}`) {
   const app = buildApp();
-  await endpoint("{{PROJECT_NAME}}", { port: 3000 })
-    .use(httpKoa())
-    .mount(app)
-    .run();
+  await endpoint("{{PROJECT_NAME}}", { port: 3000 }).use(httpKoa()).mount(app).run();
 }

package/templates/minimal/package.json

@@ -8,10 +8,10 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@nwire/app": "^0.10.0",
-    "@nwire/endpoint": "^0.10.0",
-    "@nwire/wires": "^0.10.0",
-    "@nwire/koa": "^0.10.0",
+    "@nwire/app": "^0.11.0",
+    "@nwire/endpoint": "^0.11.0",
+    "@nwire/koa": "^0.11.0",
+    "@nwire/wires": "^0.11.0",
     "zod": "^4.0.0"
   },
   "devDependencies": {

package/templates/service/README.md

@@ -63,7 +63,7 @@ curl -X POST http://localhost:3000/api/todos/<id>/complete \
 | A new error type  | `app/errors/<resource>-errors.ts` — `defineError({ code, status, summary })`                  |
 | A new middleware  | `app/middleware/<name>.ts` exports `HttpMiddleware`; `.use()` it from `api.ts`                |
 | A new resource    | `app/resources/<name>.ts` — `defineResource` schema + `public` field list                     |
-| Real persistence  | Swap `app/store/todo-store.ts` for `@nwire/drizzle` or `@nwire/mongo`              |
+| Real persistence  | Swap `app/store/todo-store.ts` for `@nwire/drizzle` or `@nwire/mongo`                         |
 
 ## Grow up
 

package/templates/service/app/main.ts

@@ -1,10 +1,11 @@
 /**
  * Entry — boot the app under HTTP.
  *
- *   1. createApp registers the TodoStore on the container via a plugin.
+ *   1. createApp constructs the bounded context; `.with(plugin)` installs
+ *      the TodoStore on the container.
  *   2. app.wire(...) pairs every route binding with its handler.
- *   3. endpoint().use(httpKoa({middleware:[requireUser]})).mount(app).run()
- *      runs the HTTP adopter under graceful drain + K8s probes.
+ *   3. endpoint().use(httpKoa({ middleware: [requireUser] })).mount(app).run()
+ *      runs the HTTP adapter under graceful drain + K8s probes.
  *
  * Run:    pnpm dev
  * Try:    curl -X POST http://localhost:3000/api/todos \
@@ -22,15 +23,12 @@ import { wires } from "./api";
 import { requireUser } from "./middleware/require-user";
 import { TodoStore } from "./store/todo-store";
 
+const todoStorePlugin = definePlugin("todo-store", ({ bind }) => {
+  bind("todos", new TodoStore());
+});
+
 export function buildApp() {
-  const app = createApp({
-    appName: "{{PROJECT_NAME}}",
-    plugins: [
-      definePlugin("todo-store", ({ bind }) => {
-        bind("todos", new TodoStore());
-      }),
-    ],
-  });
+  const app = createApp({ appName: "{{PROJECT_NAME}}" }).with(todoStorePlugin);
   for (const { binding, handler } of wires) {
     app.wire(binding, handler);
   }

package/templates/service/app/store/todo-store.ts

@@ -123,7 +123,7 @@ export const todoStorePlugin = definePlugin("todos", ({ provide }) => {
     },
     healthCheck: (store) => {
       // Trivial — proves the store is alive. A real adapter would
-      // SELECT 1 against the DB. Lightship calls this on every /readyz.
+      // SELECT 1 against the DB. Lightship calls this on every /ready.
       if (store.size() < 0) throw new Error("store corrupt");
     },
   });

package/templates/service/package.json

@@ -8,11 +8,11 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@nwire/app": "^0.10.0",
-    "@nwire/endpoint": "^0.10.0",
-    "@nwire/handler": "^0.10.0",
-    "@nwire/wires": "^0.10.0",
-    "@nwire/koa": "^0.10.0",
+    "@nwire/app": "^0.11.0",
+    "@nwire/endpoint": "^0.11.0",
+    "@nwire/handler": "^0.11.0",
+    "@nwire/koa": "^0.11.0",
+    "@nwire/wires": "^0.11.0",
     "koa": "^2.16.1",
     "zod": "^4.0.0"
   },