@askrjs/node 0.0.2 → 0.0.4

package/README.md

@@ -0,0 +1,69 @@
+# @askrjs/node
+
+[![CI](https://github.com/askrjs/askr-node/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/askrjs/askr-node/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/%40askrjs%2Fnode.svg)](https://www.npmjs.com/package/@askrjs/node)
+
+Run an `@askrjs/server` application on Node.js. The adapter translates Node HTTP messages at the
+boundary while the application continues to use Web `Request` and `Response` objects.
+
+## Install
+
+```sh
+npm install @askrjs/server @askrjs/node
+```
+
+## Create a Node handler
+
+```ts
+import { createServer } from "node:http";
+import { createServerApp, json } from "@askrjs/server";
+import { createNodeHandler } from "@askrjs/node";
+
+const app = createServerApp({
+  routes: [{ path: "/health", handler: () => json({ status: "ok" }) }],
+});
+
+createServer(createNodeHandler(app)).listen(3000);
+```
+
+`createNodeHandler` also works as Connect middleware because it accepts an optional `next`
+callback. It preserves streaming bodies, repeated `Set-Cookie` headers, aborts, backpressure,
+status text, and HEAD responses.
+
+## Listen directly
+
+```ts
+import { listen } from "@askrjs/node";
+
+const server = await listen(app, { port: 3000 });
+server.close();
+```
+
+Pass an `AbortSignal` to integrate shutdown with your process lifecycle.
+
+## Serve a production application
+
+```ts
+import { serve } from "@askrjs/node";
+
+const running = await serve(app, {
+  port: 3000,
+  assets: { root: "./dist/client" },
+});
+
+await running.close();
+```
+
+`serve` handles static assets and closes both the HTTP server and the application during shutdown.
+
+## MCP over stdio
+
+```ts
+import { connectMcpStdio } from "@askrjs/node/mcp";
+
+const connection = connectMcpStdio(mcp, { dependencies });
+await connection.closed;
+```
+
+Protocol messages use stdin/stdout; diagnostics remain isolated on stderr. Authentication may be
+provided directly or resolved from the process environment for each message.

package/dist/index.d.ts

@@ -39,5 +39,4 @@ declare function serve(app: ServerApp & {
   close?: () => void | Promise<void>;
 }, options?: ServeOptions): Promise<ServedApplication>;
 //#endregion
-export { ConnectNext, ListenOptions, ListeningServer, NodeHandler, NodeHandlerOptions, ServeOptions, ServedApplication, createNodeHandler, listen, serve };
-//# sourceMappingURL=index.d.ts.map
+export { ConnectNext, ListenOptions, ListeningServer, NodeHandler, NodeHandlerOptions, ServeOptions, ServedApplication, createNodeHandler, listen, serve };

package/dist/index.js

@@ -267,5 +267,3 @@ async function serve(app, options = {}) {
 }
 //#endregion
 export { createNodeHandler, listen, serve };
-
-//# sourceMappingURL=index.js.map

package/dist/mcp.d.ts

@@ -17,5 +17,4 @@ interface McpStdioConnection {
 }
 declare function connectMcpStdio<Dependencies>(mcp: McpServer<Dependencies>, options: McpStdioOptions<Dependencies>): McpStdioConnection;
 //#endregion
-export { McpStdioConnection, McpStdioOptions, connectMcpStdio };
-//# sourceMappingURL=mcp.d.ts.map
+export { McpStdioConnection, McpStdioOptions, connectMcpStdio };

package/dist/mcp.js

@@ -93,5 +93,3 @@ function connectMcpStdio(mcp, options) {
 }
 //#endregion
 export { connectMcpStdio };
-
-//# sourceMappingURL=mcp.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askrjs/node",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Node http adapter for @askrjs/server",
   "keywords": [
     "askr",
@@ -49,7 +49,7 @@
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vp test run",
     "test:publint": "publint",
-    "pack:check": "npm pack --ignore-scripts --dry-run --json",
+    "pack:check": "node tests/package-artifacts.js",
     "check": "npm run lint && npm run typecheck && npm test && npm run build && npm run test:publint && npm run pack:check",
     "prepack": "npm run build",
     "prepublishOnly": "npm run check"