npm - @typokit/platform-node - Versions diffs - 0.1.4 - Mend

@typokit/platform-node 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,48 @@
+import type { IncomingMessage, ServerResponse, Server } from "node:http";
+import type { ServerHandle, TypoKitRequest, TypoKitResponse } from "@typokit/types";
+/** Runtime platform metadata for diagnostics and inspect commands */
+export interface PlatformInfo {
+    runtime: string;
+    version: string;
+}
+/** Returns Node.js platform info */
+export declare function getPlatformInfo(): PlatformInfo;
+/**
+ * Normalize a Node.js IncomingMessage into a TypoKitRequest.
+ * Body is collected asynchronously from the stream.
+ */
+export declare function normalizeRequest(req: IncomingMessage): Promise<TypoKitRequest>;
+/**
+ * Write a TypoKitResponse to a Node.js ServerResponse.
+ */
+export declare function writeResponse(res: ServerResponse, response: TypoKitResponse): void;
+/** Handler function that receives a normalized request and returns a response */
+export type NodeRequestHandler = (req: TypoKitRequest) => Promise<TypoKitResponse>;
+export interface NodeServerOptions {
+    /** Optional hostname to bind to (default: "0.0.0.0") */
+    hostname?: string;
+}
+/** Result of createServer — provides listen/close and access to the raw node:http server */
+export interface NodeServer {
+    /** Start listening on the given port. Returns a handle for graceful shutdown. */
+    listen(port: number): Promise<ServerHandle>;
+    /** The underlying node:http Server instance */
+    server: Server;
+}
+/**
+ * Create a Node.js HTTP server that dispatches to a TypoKit request handler.
+ *
+ * Usage:
+ * ```ts
+ * const srv = createServer(async (req) => ({
+ *   status: 200,
+ *   headers: {},
+ *   body: { ok: true },
+ * }));
+ * const handle = await srv.listen(3000);
+ * // ... later
+ * await handle.close();
+ * ```
+ */
+export declare function createServer(handler: NodeRequestHandler, options?: NodeServerOptions): NodeServer;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEzE,OAAO,KAAK,EAEV,YAAY,EACZ,cAAc,EACd,eAAe,EAChB,MAAM,gBAAgB,CAAC;AAIxB,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,oCAAoC;AACpC,wBAAgB,eAAe,IAAI,YAAY,CAK9C;AA2DD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,cAAc,CAAC,CAezB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,eAAe,GACxB,IAAI,CA0BN;AAID,iFAAiF;AACjF,MAAM,MAAM,kBAAkB,GAAG,CAC/B,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,eAAe,CAAC,CAAC;AAI9B,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,4FAA4F;AAC5F,MAAM,WAAW,UAAU;IACzB,iFAAiF;IACjF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC5C,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE,iBAAsB,GAC9B,UAAU,CAwCZ"}

package/dist/index.js ADDED Viewed

@@ -0,0 +1,162 @@
+// @typokit/platform-node — Node.js Platform Adapter
+import { createServer as nodeCreateServer } from "node:http";
+import { URL } from "node:url";
+/** Returns Node.js platform info */
+export function getPlatformInfo() {
+    return {
+        runtime: "node",
+        version: process.version,
+    };
+}
+// ─── Request / Response Helpers ──────────────────────────────
+/** Collect the body of an IncomingMessage into a buffer, then parse as JSON or return raw string */
+function collectBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on("data", (chunk) => chunks.push(chunk));
+        req.on("error", reject);
+        req.on("end", () => {
+            const raw = Buffer.concat(chunks).toString("utf-8");
+            if (!raw) {
+                resolve(undefined);
+                return;
+            }
+            const contentType = req.headers["content-type"] ?? "";
+            if (contentType.includes("application/json")) {
+                try {
+                    resolve(JSON.parse(raw));
+                }
+                catch {
+                    resolve(raw);
+                }
+            }
+            else {
+                resolve(raw);
+            }
+        });
+    });
+}
+/** Parse query string from a URL into a Record */
+function parseQuery(searchParams) {
+    const result = {};
+    for (const [key, value] of searchParams.entries()) {
+        const existing = result[key];
+        if (existing === undefined) {
+            result[key] = value;
+        }
+        else if (Array.isArray(existing)) {
+            existing.push(value);
+        }
+        else {
+            result[key] = [existing, value];
+        }
+    }
+    return result;
+}
+/** Normalize Node.js headers into a flat Record */
+function normalizeHeaders(raw) {
+    const result = {};
+    for (const [key, value] of Object.entries(raw)) {
+        result[key] = value;
+    }
+    return result;
+}
+/**
+ * Normalize a Node.js IncomingMessage into a TypoKitRequest.
+ * Body is collected asynchronously from the stream.
+ */
+export async function normalizeRequest(req) {
+    const url = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
+    const body = await collectBody(req);
+    return {
+        method: (req.method ?? "GET").toUpperCase(),
+        path: url.pathname,
+        headers: normalizeHeaders(req.headers),
+        body,
+        query: parseQuery(url.searchParams),
+        params: {},
+    };
+}
+/**
+ * Write a TypoKitResponse to a Node.js ServerResponse.
+ */
+export function writeResponse(res, response) {
+    // Set headers
+    for (const [key, value] of Object.entries(response.headers)) {
+        if (value !== undefined) {
+            res.setHeader(key, value);
+        }
+    }
+    // Determine body content before writing head
+    let bodyContent;
+    if (response.body === null || response.body === undefined) {
+        bodyContent = undefined;
+    }
+    else if (typeof response.body === "string") {
+        bodyContent = response.body;
+    }
+    else if (Buffer.isBuffer(response.body)) {
+        bodyContent = response.body;
+    }
+    else {
+        // JSON serialize objects — set content-type before writeHead
+        if (!res.getHeader("content-type")) {
+            res.setHeader("content-type", "application/json");
+        }
+        bodyContent = JSON.stringify(response.body);
+    }
+    res.writeHead(response.status);
+    res.end(bodyContent);
+}
+/**
+ * Create a Node.js HTTP server that dispatches to a TypoKit request handler.
+ *
+ * Usage:
+ * ```ts
+ * const srv = createServer(async (req) => ({
+ *   status: 200,
+ *   headers: {},
+ *   body: { ok: true },
+ * }));
+ * const handle = await srv.listen(3000);
+ * // ... later
+ * await handle.close();
+ * ```
+ */
+export function createServer(handler, options = {}) {
+    const hostname = options.hostname ?? "0.0.0.0";
+    const server = nodeCreateServer(async (req, res) => {
+        try {
+            const normalized = await normalizeRequest(req);
+            const response = await handler(normalized);
+            writeResponse(res, response);
+        }
+        catch (err) {
+            // Fallback error response
+            res.writeHead(500, { "content-type": "application/json" });
+            res.end(JSON.stringify({
+                error: "Internal Server Error",
+                message: err instanceof Error ? err.message : "Unknown error",
+            }));
+        }
+    });
+    return {
+        server,
+        listen(port) {
+            return new Promise((resolve, reject) => {
+                server.on("error", reject);
+                server.listen(port, hostname, () => {
+                    server.removeListener("error", reject);
+                    resolve({
+                        async close() {
+                            return new Promise((res, rej) => {
+                                server.close((err) => (err ? rej(err) : res()));
+                            });
+                        },
+                    });
+                });
+            });
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/package.json ADDED Viewed

@@ -0,0 +1,31 @@
+{
+  "name": "@typokit/platform-node",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "version": "0.1.4",
+  "type": "module",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "@typokit/types": "0.1.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/KyleBastien/typokit",
+    "directory": "packages/platform-node"
+  },
+  "scripts": {
+    "test": "rstest run --passWithNoTests"
+  }
+}

package/src/index.test.ts ADDED Viewed

@@ -0,0 +1,192 @@
+// @typokit/platform-node — Tests
+import { describe, it, expect } from "@rstest/core";
+import {
+  createServer,
+  normalizeRequest,
+  writeResponse,
+  getPlatformInfo,
+} from "./index.js";
+import type { TypoKitResponse } from "@typokit/types";
+import { createServer as nodeCreateServer } from "node:http";
+import type { IncomingMessage, ServerResponse } from "node:http";
+// ─── getPlatformInfo ─────────────────────────────────────────
+describe("getPlatformInfo", () => {
+  it("returns node runtime and version", () => {
+    const info = getPlatformInfo();
+    expect(info.runtime).toBe("node");
+    expect(info.version).toMatch(/^v\d+/);
+  });
+});
+// ─── normalizeRequest ────────────────────────────────────────
+describe("normalizeRequest", () => {
+  it("parses method, path, headers, and query from IncomingMessage", async () => {
+    const normalized = await new Promise<
+      Awaited<ReturnType<typeof normalizeRequest>>
+    >((resolve, reject) => {
+      const server = nodeCreateServer(async (req: IncomingMessage) => {
+        try {
+          resolve(await normalizeRequest(req));
+        } catch (e) {
+          reject(e);
+        }
+        server.close();
+      });
+      server.listen(0, "127.0.0.1", () => {
+        const addr = server.address();
+        if (!addr || typeof addr === "string") return;
+        const url = `http://127.0.0.1:${addr.port}/hello?foo=bar`;
+        fetch(url, { method: "GET", headers: { "x-test": "yes" } }).catch(
+          () => {},
+        );
+      });
+    });
+    expect(normalized.method).toBe("GET");
+    expect(normalized.path).toBe("/hello");
+    expect(normalized.query["foo"]).toBe("bar");
+    expect(normalized.headers["x-test"]).toBe("yes");
+    expect(normalized.params).toEqual({});
+  });
+  it("collects JSON body when content-type is application/json", async () => {
+    const normalized = await new Promise<
+      Awaited<ReturnType<typeof normalizeRequest>>
+    >((resolve, reject) => {
+      const server = nodeCreateServer(
+        async (req: IncomingMessage, res: ServerResponse) => {
+          try {
+            resolve(await normalizeRequest(req));
+          } catch (e) {
+            reject(e);
+          }
+          res.end();
+          server.close();
+        },
+      );
+      server.listen(0, "127.0.0.1", () => {
+        const addr = server.address();
+        if (!addr || typeof addr === "string") return;
+        fetch(`http://127.0.0.1:${addr.port}/data`, {
+          method: "POST",
+          headers: { "content-type": "application/json" },
+          body: JSON.stringify({ name: "test" }),
+        }).catch(() => {});
+      });
+    });
+    expect(normalized.method).toBe("POST");
+    expect(normalized.body).toEqual({ name: "test" });
+  });
+});
+// ─── writeResponse ───────────────────────────────────────────
+describe("writeResponse", () => {
+  it("writes status, headers, and JSON body to ServerResponse", async () => {
+    const result = await new Promise<{
+      status: number;
+      body: string;
+      headers: Record<string, string>;
+    }>((resolve, reject) => {
+      const server = nodeCreateServer(
+        (_req: IncomingMessage, res: ServerResponse) => {
+          const response: TypoKitResponse = {
+            status: 201,
+            headers: { "x-custom": "value" },
+            body: { created: true },
+          };
+          writeResponse(res, response);
+          server.close();
+        },
+      );
+      server.listen(0, "127.0.0.1", () => {
+        const addr = server.address();
+        if (!addr || typeof addr === "string") return;
+        fetch(`http://127.0.0.1:${addr.port}/`)
+          .then(async (resp) => {
+            resolve({
+              status: resp.status,
+              body: await resp.text(),
+              headers: Object.fromEntries(resp.headers.entries()),
+            });
+          })
+          .catch(reject);
+      });
+    });
+    expect(result.status).toBe(201);
+    expect(result.headers["x-custom"]).toBe("value");
+    expect(JSON.parse(result.body)).toEqual({ created: true });
+  });
+});
+// ─── createServer ────────────────────────────────────────────
+describe("createServer", () => {
+  it("starts a server, handles a request, and returns a response", async () => {
+    const srv = createServer(async (req) => ({
+      status: 200,
+      headers: { "content-type": "application/json" },
+      body: { echo: req.path },
+    }));
+    const handle = await srv.listen(0);
+    try {
+      const addr = srv.server.address();
+      if (!addr || typeof addr === "string") throw new Error("No address");
+      const resp = await fetch(`http://127.0.0.1:${addr.port}/test-path`);
+      expect(resp.status).toBe(200);
+      const body = await resp.json();
+      expect(body).toEqual({ echo: "/test-path" });
+    } finally {
+      await handle.close();
+    }
+  });
+  it("returns 500 when handler throws", async () => {
+    const srv = createServer(async () => {
+      throw new Error("boom");
+    });
+    const handle = await srv.listen(0);
+    try {
+      const addr = srv.server.address();
+      if (!addr || typeof addr === "string") throw new Error("No address");
+      const resp = await fetch(`http://127.0.0.1:${addr.port}/fail`);
+      expect(resp.status).toBe(500);
+      const body = (await resp.json()) as { error: string; message: string };
+      expect(body.error).toBe("Internal Server Error");
+      expect(body.message).toBe("boom");
+    } finally {
+      await handle.close();
+    }
+  });
+  it("close() gracefully shuts down the server", async () => {
+    const srv = createServer(async () => ({
+      status: 200,
+      headers: {},
+      body: null,
+    }));
+    const handle = await srv.listen(0);
+    const addr = srv.server.address();
+    expect(addr).not.toBeNull();
+    await handle.close();
+    // Server should no longer be listening
+    expect(srv.server.listening).toBe(false);
+  });
+});

package/src/index.ts ADDED Viewed

@@ -0,0 +1,225 @@
+// @typokit/platform-node — Node.js Platform Adapter
+import { createServer as nodeCreateServer } from "node:http";
+import type { IncomingMessage, ServerResponse, Server } from "node:http";
+import { URL } from "node:url";
+import type {
+  HttpMethod,
+  ServerHandle,
+  TypoKitRequest,
+  TypoKitResponse,
+} from "@typokit/types";
+// ─── Platform Info ───────────────────────────────────────────
+/** Runtime platform metadata for diagnostics and inspect commands */
+export interface PlatformInfo {
+  runtime: string;
+  version: string;
+}
+/** Returns Node.js platform info */
+export function getPlatformInfo(): PlatformInfo {
+  return {
+    runtime: "node",
+    version: process.version,
+  };
+}
+// ─── Request / Response Helpers ──────────────────────────────
+/** Collect the body of an IncomingMessage into a buffer, then parse as JSON or return raw string */
+function collectBody(req: IncomingMessage): Promise<unknown> {
+  return new Promise((resolve, reject) => {
+    const chunks: Buffer[] = [];
+    req.on("data", (chunk: Buffer) => chunks.push(chunk));
+    req.on("error", reject);
+    req.on("end", () => {
+      const raw = Buffer.concat(chunks).toString("utf-8");
+      if (!raw) {
+        resolve(undefined);
+        return;
+      }
+      const contentType = req.headers["content-type"] ?? "";
+      if (contentType.includes("application/json")) {
+        try {
+          resolve(JSON.parse(raw));
+        } catch {
+          resolve(raw);
+        }
+      } else {
+        resolve(raw);
+      }
+    });
+  });
+}
+/** Parse query string from a URL into a Record */
+function parseQuery(
+  searchParams: URLSearchParams,
+): Record<string, string | string[] | undefined> {
+  const result: Record<string, string | string[] | undefined> = {};
+  for (const [key, value] of searchParams.entries()) {
+    const existing = result[key];
+    if (existing === undefined) {
+      result[key] = value;
+    } else if (Array.isArray(existing)) {
+      existing.push(value);
+    } else {
+      result[key] = [existing, value];
+    }
+  }
+  return result;
+}
+/** Normalize Node.js headers into a flat Record */
+function normalizeHeaders(
+  raw: IncomingMessage["headers"],
+): Record<string, string | string[] | undefined> {
+  const result: Record<string, string | string[] | undefined> = {};
+  for (const [key, value] of Object.entries(raw)) {
+    result[key] = value;
+  }
+  return result;
+}
+/**
+ * Normalize a Node.js IncomingMessage into a TypoKitRequest.
+ * Body is collected asynchronously from the stream.
+ */
+export async function normalizeRequest(
+  req: IncomingMessage,
+): Promise<TypoKitRequest> {
+  const url = new URL(
+    req.url ?? "/",
+    `http://${req.headers.host ?? "localhost"}`,
+  );
+  const body = await collectBody(req);
+  return {
+    method: (req.method ?? "GET").toUpperCase() as HttpMethod,
+    path: url.pathname,
+    headers: normalizeHeaders(req.headers),
+    body,
+    query: parseQuery(url.searchParams),
+    params: {},
+  };
+}
+/**
+ * Write a TypoKitResponse to a Node.js ServerResponse.
+ */
+export function writeResponse(
+  res: ServerResponse,
+  response: TypoKitResponse,
+): void {
+  // Set headers
+  for (const [key, value] of Object.entries(response.headers)) {
+    if (value !== undefined) {
+      res.setHeader(key, value);
+    }
+  }
+  // Determine body content before writing head
+  let bodyContent: string | Buffer | undefined;
+  if (response.body === null || response.body === undefined) {
+    bodyContent = undefined;
+  } else if (typeof response.body === "string") {
+    bodyContent = response.body;
+  } else if (Buffer.isBuffer(response.body)) {
+    bodyContent = response.body;
+  } else {
+    // JSON serialize objects — set content-type before writeHead
+    if (!res.getHeader("content-type")) {
+      res.setHeader("content-type", "application/json");
+    }
+    bodyContent = JSON.stringify(response.body);
+  }
+  res.writeHead(response.status);
+  res.end(bodyContent);
+}
+// ─── Request Handler Type ────────────────────────────────────
+/** Handler function that receives a normalized request and returns a response */
+export type NodeRequestHandler = (
+  req: TypoKitRequest,
+) => Promise<TypoKitResponse>;
+// ─── Node Server Options ─────────────────────────────────────
+export interface NodeServerOptions {
+  /** Optional hostname to bind to (default: "0.0.0.0") */
+  hostname?: string;
+}
+// ─── Node Server ─────────────────────────────────────────────
+/** Result of createServer — provides listen/close and access to the raw node:http server */
+export interface NodeServer {
+  /** Start listening on the given port. Returns a handle for graceful shutdown. */
+  listen(port: number): Promise<ServerHandle>;
+  /** The underlying node:http Server instance */
+  server: Server;
+}
+/**
+ * Create a Node.js HTTP server that dispatches to a TypoKit request handler.
+ *
+ * Usage:
+ * ```ts
+ * const srv = createServer(async (req) => ({
+ *   status: 200,
+ *   headers: {},
+ *   body: { ok: true },
+ * }));
+ * const handle = await srv.listen(3000);
+ * // ... later
+ * await handle.close();
+ * ```
+ */
+export function createServer(
+  handler: NodeRequestHandler,
+  options: NodeServerOptions = {},
+): NodeServer {
+  const hostname = options.hostname ?? "0.0.0.0";
+  const server = nodeCreateServer(
+    async (req: IncomingMessage, res: ServerResponse) => {
+      try {
+        const normalized = await normalizeRequest(req);
+        const response = await handler(normalized);
+        writeResponse(res, response);
+      } catch (err: unknown) {
+        // Fallback error response
+        res.writeHead(500, { "content-type": "application/json" });
+        res.end(
+          JSON.stringify({
+            error: "Internal Server Error",
+            message: err instanceof Error ? err.message : "Unknown error",
+          }),
+        );
+      }
+    },
+  );
+  return {
+    server,
+    listen(port: number): Promise<ServerHandle> {
+      return new Promise((resolve, reject) => {
+        server.on("error", reject);
+        server.listen(port, hostname, () => {
+          server.removeListener("error", reject);
+          resolve({
+            async close(): Promise<void> {
+              return new Promise((res, rej) => {
+                server.close((err) => (err ? rej(err) : res()));
+              });
+            },
+          });
+        });
+      });
+    },
+  };
+}