@hulla/api-koa 0.0.0-stage → 2.0.0

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+import { AdapterErrorInput, AdapterResponse, AdapterRuntimeOptions } from "@hulla/api/adapters";
+import { Awaitable, ServerAdapter, ServerContextInput, ServerExecutableFor } from "@hulla/api/server";
+import { Contract } from "@hulla/api";
+import Koa from "koa";
+//#region src/index.d.ts
+type KoaAdapterContext<State extends object = Koa.DefaultState> = {
+  readonly ctx: Koa.ParameterizedContext<State>;
+  readonly state: State;
+};
+type KoaContextInput<C extends Contract = Contract, State extends object = Koa.DefaultState> = ServerContextInput<C> & KoaAdapterContext<State>;
+type KoaServerErrorInput<State extends object = Koa.DefaultState> = Omit<AdapterErrorInput, 'hostContext'> & KoaAdapterContext<State>;
+type KoaServerOptions<State extends object = Koa.DefaultState> = Omit<AdapterRuntimeOptions, 'onError'> & {
+  readonly maxBodyBytes?: number;
+  readonly onError?: ((input: KoaServerErrorInput<State>) => Awaitable<AdapterResponse | undefined | void>) | undefined;
+};
+type KoaAdapter<State extends object = Koa.DefaultState> = ServerAdapter<'koa', KoaAdapterContext<State>> & {
+  readonly mount: <const C extends Contract, const Context extends object>(implementation: ServerExecutableFor<C, Context, 'koa', KoaAdapterContext<State>>, options?: KoaServerOptions<State>) => Koa.Middleware<State>;
+};
+/** Mount as terminal middleware. Scope paths with the application's router when composing APIs. */
+declare function koaAdapter<State extends object = Koa.DefaultState>(defaults?: KoaServerOptions<State>): KoaAdapter<State>;
+//#endregion
+export { KoaAdapter, KoaAdapterContext, KoaContextInput, KoaServerErrorInput, KoaServerOptions, koaAdapter };

package/dist/index.js

@@ -0,0 +1,92 @@
+import { Readable } from "node:stream";
+import { createNodeBodyReader, nodeRequestHeader, nodeRequestHeaders, nodeRequestLifetime } from "@hulla/api-node";
+import { bodyLimit, createAdapterHandler, errorResponse, toFetchResponse } from "@hulla/api/adapters";
+import { assertAdapterContext, createServerAdapter, serverContextAdapterId } from "@hulla/api/server";
+
+//#region src/index.ts
+function readHeader(name) {
+	return nodeRequestHeader(this.request.headers, name);
+}
+/** Mount as terminal middleware. Scope paths with the application's router when composing APIs. */
+function koaAdapter(defaults = {}) {
+	const configuredDefaults = { ...defaults };
+	return createServerAdapter("koa", { mount: (implementation, overrides) => {
+		assertAdapterContext(implementation.context, "koa");
+		const options = {
+			...configuredDefaults,
+			...overrides
+		};
+		const limit = bodyLimit(options.maxBodyBytes);
+		const native = serverContextAdapterId(implementation.context) !== void 0;
+		const dispatch = createAdapterHandler(implementation, options.onError === void 0 ? {} : { onError: ({ hostContext, ...input }) => options.onError?.({
+			...input,
+			...hostContext
+		}) });
+		return async (ctx) => {
+			const lifetime = nodeRequestLifetime(ctx.req, ctx.res);
+			const host = {
+				ctx,
+				state: ctx.state
+			};
+			const observe = async (error) => {
+				const fallback = errorResponse(error, "transport");
+				try {
+					return await options.onError?.({
+						...host,
+						request: ctx.req,
+						error,
+						phase: "transport",
+						defaultResponse: fallback
+					}) ?? fallback;
+				} catch {
+					return fallback;
+				}
+			};
+			let response;
+			try {
+				const parsed = ctx.request.body;
+				const result = await dispatch({
+					request: ctx.req,
+					signal: lifetime.signal,
+					method: ctx.method === "HEAD" ? "GET" : ctx.method,
+					pathname: ctx.path,
+					query: new URLSearchParams(ctx.querystring),
+					readHeaders: () => nodeRequestHeaders(ctx.req.headers),
+					readHeader,
+					readBody: createNodeBodyReader(ctx.req, limit, "Koa"),
+					...parsed === void 0 ? {} : { body: { value: parsed } },
+					...native ? { contextInput: host } : {},
+					...options.onError === void 0 ? {} : { hostContext: host }
+				});
+				response = toFetchResponse(result, async (error) => {
+					await observe(error);
+				});
+			} catch (error) {
+				try {
+					response = toFetchResponse(await observe(error));
+				} catch (failure) {
+					lifetime.dispose();
+					throw failure;
+				}
+			}
+			try {
+				if (ctx.method === "HEAD" || response.body === null) {
+					await response.body?.cancel();
+					ctx.body = null;
+				} else ctx.body = Readable.fromWeb(response.body);
+				response.headers.forEach((value, name) => {
+					if (name !== "set-cookie") ctx.set(name, value);
+				});
+				const cookies = response.headers.getSetCookie();
+				if (cookies.length > 0) ctx.set("set-cookie", cookies);
+				ctx.status = response.status;
+			} catch (error) {
+				lifetime.dispose();
+				throw error;
+			}
+		};
+	} });
+}
+
+//#endregion
+export { koaAdapter };

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "@hulla/api-koa",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "2.0.0",
+  "description": "Koa middleware adapter for @hulla/api",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hulladev/api.git",
+    "directory": "packages/koa"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "clean": "rm -rf dist coverage",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@hulla/api-node": "^2.0.0"
+  },
+  "devDependencies": {
+    "@hulla/api": "2.0.0",
+    "@types/koa": "^3.0.0",
+    "@types/node": "^26.2.0",
+    "koa": "^3.0.0"
+  },
+  "peerDependencies": {
+    "@hulla/api": "^2.0.0",
+    "@types/koa": "^3.0.0",
+    "@types/node": ">=22.0.0",
+    "koa": "^3.0.0"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.