@zerolith/client 0.0.0-stage → 0.1.0-alpha.2

package/dist/port.js

@@ -0,0 +1,81 @@
+function listen(port, handler) {
+    if (typeof port.addEventListener === "function") {
+        port.addEventListener("message", (event) => handler(event.data));
+    }
+    else if (typeof port.on === "function") {
+        port.on("message", (event) => handler(event.data));
+    }
+    else {
+        throw new TypeError("zerolith/client: the port has neither addEventListener nor on");
+    }
+    port.start?.();
+}
+/**
+ * A `Transport` that sends each request over the port as a message and
+ * resolves with the response that comes back under the same id. Aborting
+ * the request's signal rejects the call; the message already sent is
+ * answered and ignored.
+ */
+export function portTransport(port) {
+    const pending = new Map();
+    let next = 1;
+    listen(port, (data) => {
+        const message = data;
+        if (message === null || typeof message !== "object" || message.kind !== "zerolith:response" || typeof message.id !== "number") {
+            return;
+        }
+        const waiting = pending.get(message.id);
+        if (waiting === undefined) {
+            return;
+        }
+        pending.delete(message.id);
+        waiting.resolve(new Response(message.body ?? null, { status: message.status ?? 200, statusText: message.statusText ?? "", headers: message.headers ?? [] }));
+    });
+    return async (request) => {
+        const id = next++;
+        const body = request.method === "GET" || request.method === "HEAD" ? null : await request.text();
+        const message = { kind: "zerolith:request", id, url: request.url, method: request.method, headers: [...request.headers], body: body === "" ? null : body };
+        return new Promise((resolve, reject) => {
+            if (request.signal.aborted) {
+                reject(request.signal.reason ?? new DOMException("The request was aborted", "AbortError"));
+                return;
+            }
+            pending.set(id, { resolve, reject });
+            request.signal.addEventListener("abort", () => {
+                if (pending.delete(id)) {
+                    reject(request.signal.reason ?? new DOMException("The request was aborted", "AbortError"));
+                }
+            });
+            port.postMessage(message);
+        });
+    };
+}
+/**
+ * Answers the requests `portTransport` sends by building a `Request`,
+ * calling `handler`, and posting the response back. A handler that throws
+ * answers with a 500 problem so the client sees a `ProblemError`.
+ */
+export function servePort(port, handler) {
+    listen(port, (data) => {
+        const message = data;
+        if (message === null || typeof message !== "object" || message.kind !== "zerolith:request" || typeof message.id !== "number" || typeof message.url !== "string") {
+            return;
+        }
+        const id = message.id;
+        const answer = async () => {
+            let response;
+            try {
+                response = await handler(new Request(message.url ?? "", { method: message.method ?? "GET", headers: message.headers ?? [], body: message.body ?? null }));
+            }
+            catch (error) {
+                const title = error instanceof Error ? error.message : String(error);
+                response = new Response(JSON.stringify({ title, status: 500 }), { status: 500, headers: { "content-type": "application/problem+json" } });
+            }
+            const text = await response.text();
+            const reply = { kind: "zerolith:response", id, status: response.status, statusText: response.statusText, headers: [...response.headers], body: text === "" ? null : text };
+            port.postMessage(reply);
+        };
+        void answer();
+    });
+}
+//# sourceMappingURL=port.js.map

package/dist/port.js.map

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

package/package.json

@@ -1,6 +1,60 @@
 {
-  "name": "@zerolith/client",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+    "name": "@zerolith/client",
+    "version": "0.1.0-alpha.2",
+    "description": "A typed HTTP client for zerolith over a neutral contract: generate the route table and types from an OpenAPI document, call operations with checked inputs, and read failures as RFC 9457 problems",
+    "license": "Apache-2.0",
+    "author": "molexxxx",
+    "homepage": "https://github.com/molexxxx/zerolith#readme",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/molexxxx/zerolith.git",
+        "directory": "packages/client"
+    },
+    "bugs": {
+        "url": "https://github.com/molexxxx/zerolith/issues"
+    },
+    "keywords": [
+        "zerolith",
+        "openapi",
+        "typed-client",
+        "problem-details"
+    ],
+    "type": "module",
+    "sideEffects": false,
+    "engines": {
+        "node": ">=24.0.0"
+    },
+    "bin": {
+        "zerolith-client": "dist/cli.js"
+    },
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        },
+        "./generate": {
+            "types": "./dist/generate.d.ts",
+            "default": "./dist/generate.js"
+        },
+        "./port": {
+            "types": "./dist/port.d.ts",
+            "default": "./dist/port.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "files": [
+        "dist",
+        "src",
+        "LICENSE",
+        "README.md"
+    ],
+    "scripts": {
+        "build": "tsc -p tsconfig.build.json"
+    },
+    "peerDependencies": {
+        "zerolith": "^0.1.0-alpha.2"
+    },
+    "devDependencies": {
+        "zerolith": "^0.1.0-alpha.2"
+    }
+}

package/src/cli.ts

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/**
+ * `zerolith-client <openapi.json> [--out <file.ts>]`: writes the contract
+ * module for an OpenAPI document to a file, or to standard output.
+ */
+import { readFile, writeFile } from "node:fs/promises";
+import process from "node:process";
+import { type OpenApiDocument, generateClient } from "./generate.js";
+
+const USAGE = "usage: zerolith-client <openapi.json> [--out <file.ts>] [--name <Api>]\n";
+
+interface Arguments
+{
+    input: string | undefined;
+    out: string | undefined;
+    name: string | undefined;
+}
+
+function parse(argv: readonly string[]): Arguments
+{
+    const parsed: Arguments = { input: undefined, out: undefined, name: undefined };
+    for (let index = 0; index < argv.length; index++)
+    {
+        const argument = argv[index] ?? "";
+        if (argument === "--out" || argument === "--name")
+        {
+            const value = argv[index + 1];
+            if (value === undefined)
+            {
+                throw new Error(`${argument} needs a value`);
+            }
+            parsed[argument === "--out" ? "out" : "name"] = value;
+            index++;
+        }
+        else if (argument.startsWith("--"))
+        {
+            throw new Error(`unknown option ${argument}`);
+        }
+        else if (parsed.input === undefined)
+        {
+            parsed.input = argument;
+        }
+        else
+        {
+            throw new Error(`unexpected argument ${argument}`);
+        }
+    }
+    return parsed;
+}
+
+/** Runs the command with the given arguments and returns the exit code. */
+export async function main(argv: readonly string[]): Promise<number>
+{
+    let parsed: Arguments;
+    try
+    {
+        parsed = parse(argv);
+    }
+    catch (error)
+    {
+        process.stderr.write(`zerolith-client: ${error instanceof Error ? error.message : String(error)}\n${USAGE}`);
+        return 2;
+    }
+    if (parsed.input === undefined)
+    {
+        process.stderr.write(USAGE);
+        return 2;
+    }
+    const document = JSON.parse(await readFile(parsed.input, "utf8")) as OpenApiDocument;
+    const code = generateClient(document, parsed.name === undefined ? {} : { apiName: parsed.name });
+    if (parsed.out === undefined)
+    {
+        process.stdout.write(code);
+    }
+    else
+    {
+        await writeFile(parsed.out, code);
+    }
+    return 0;
+}
+
+if (process.argv[1] !== undefined && /zerolith-client|[\\/]cli\.js$/.test(process.argv[1]))
+{
+    process.exitCode = await main(process.argv.slice(2));
+}