@nwire/handler 0.7.0

package/dist/response.js

@@ -0,0 +1,69 @@
+/**
+ * `response(status, Resource)` — typed response builder.
+ *
+ *   const washCreated  = response(201, Wash);
+ *   const washAccepted = response(202);
+ *   const washList     = response.list(200, Wash);
+ *
+ *   // In a resolver handler:
+ *   return washCreated(wash);
+ *   return washAccepted();
+ *   return washList([wash1, wash2]);
+ *
+ * Each response spec is BOTH metadata (status + body resource — used by
+ * OpenAPI/GraphQL schema generation + response validation) AND a builder
+ * (callable to produce a typed response instance). When the spec carries
+ * a `ResourceDefinition` with declared `public` fields, the body is run
+ * through `resource.project(...)` so non-public fields never leak — the
+ * builder owns the shaping, handlers don't hand-map.
+ */
+function singleSpec(status, resource) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const builder = (data) => {
+        const body = resource && data !== undefined ? resource.project(data) : data;
+        return { $kind: "response-instance", status, body };
+    };
+    Object.assign(builder, {
+        $kind: "response",
+        status,
+        kind: resource ? "single" : "empty",
+        resource,
+    });
+    return builder;
+}
+function listSpec(status, resource) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const builder = (items) => {
+        const stripped = items.map((it) => resource.project(it));
+        return { $kind: "response-instance", status, body: stripped };
+    };
+    Object.assign(builder, {
+        $kind: "response",
+        status,
+        kind: "list",
+        resource,
+    });
+    return builder;
+}
+/**
+ * `response(status, Resource?)` — single-body response spec (or empty body).
+ * Has `.list(status, Resource)` for array responses.
+ */
+export const response = Object.assign(singleSpec, { list: listSpec });
+// ─── Semantic response factories ───────────────────────────────────
+// The app's vocabulary for outcomes. Handlers never type a raw status
+// code; they `return created(Station, state)` / `return accepted()` /
+// `return ok.list(Station, items)`. Transports translate the semantic
+// into wire-shape (HTTP status, GraphQL union resolution, CLI exit).
+export const ok = Object.assign((resource) => response(200, resource), {
+    list: (resource) => response.list(200, resource),
+});
+export const created = (resource) => response(201, resource);
+export const accepted = (resource) => response(202, resource);
+export const noContent = () => response(204);
+export const notModified = () => response(304);
+export const gone = () => response(410);
+/** Type narrows. */
+export const isResponseSpec = (x) => typeof x === "object" && x !== null && x.$kind === "response";
+export const isResponseInstance = (x) => typeof x === "object" && x !== null && x.$kind === "response-instance";
+//# sourceMappingURL=response.js.map

package/dist/response.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@nwire/handler",
+  "version": "0.7.0",
+  "description": "Nwire — the operation primitive. defineHandler / defineError / defineResource / defineMiddleware / pipe / response factories / typed framework errors. Standalone — depend on this without pulling forge. Every transport (HTTP, queue, MCP, …) speaks the same handler shape.",
+  "keywords": [
+    "execute",
+    "handler",
+    "nwire",
+    "operation"
+  ],
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "main": "./dist/handler-index.js",
+  "types": "./dist/handler-index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/handler-index.js",
+      "types": "./dist/handler-index.d.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "zod": "^4.0.0",
+    "@nwire/container": "0.7.0",
+    "@nwire/envelope": "0.7.0",
+    "@nwire/logger": "0.7.0",
+    "@nwire/messages": "0.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.9",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "build": "tsc && node ../../scripts/fix-dist-extensions.mjs dist",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}