@danceroutine/tango-adapters-express 0.1.0 → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Pedro Del Moral Lopez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,131 @@
+# @danceroutine/tango-adapters-express
+
+`@danceroutine/tango-adapters-express` runs Tango views and viewsets inside Express.
+
+Express still owns routing, middleware, request lifecycle, and application bootstrapping. This package connects those Express responsibilities to Tango's framework-agnostic resource layer, filtering, pagination, serializer-backed request and response contracts, and response conventions.
+
+## Install
+
+```bash
+pnpm add @danceroutine/tango-adapters-express express
+```
+
+In a real application you will usually install this alongside the Tango packages that define your models, serializers, and resource classes.
+
+## How it fits into an Express application
+
+A typical Tango + Express stack looks like this:
+
+1. define models with `@danceroutine/tango-schema`
+2. query and mutate data through `Model.objects` from `@danceroutine/tango-orm`
+3. define serializer-backed resource behavior with `@danceroutine/tango-resources`
+4. use `ExpressAdapter` to register those handlers with Express routes
+
+The adapter's responsibility is restricted to translating between Express request handlers and Tango's framework-agnostic view and viewset interfaces, then handing the resulting response back to Express.
+
+## Quick start
+
+```ts
+import express from 'express';
+import { z } from 'zod';
+import '@danceroutine/tango-orm/runtime';
+import { ExpressAdapter } from '@danceroutine/tango-adapters-express/adapter';
+import { Model, t } from '@danceroutine/tango-schema';
+import { ModelSerializer, ModelViewSet } from '@danceroutine/tango-resources';
+
+const TodoReadSchema = z.object({
+    id: z.number(),
+    title: z.string(),
+    completed: z.boolean(),
+});
+
+const TodoCreateSchema = TodoReadSchema.omit({ id: true });
+const TodoUpdateSchema = TodoCreateSchema.partial();
+
+type Todo = z.infer<typeof TodoReadSchema>;
+
+const TodoModel = Model({
+    namespace: 'app',
+    name: 'Todo',
+    schema: TodoReadSchema.extend({
+        id: t.primaryKey(z.number().int()),
+        title: z.string(),
+        completed: t.default(z.boolean(), 'false'),
+    }),
+});
+
+class TodoSerializer extends ModelSerializer<
+    Todo,
+    typeof TodoCreateSchema,
+    typeof TodoUpdateSchema,
+    typeof TodoReadSchema
+> {
+    static readonly model = TodoModel;
+    static readonly createSchema = TodoCreateSchema;
+    static readonly updateSchema = TodoUpdateSchema;
+    static readonly outputSchema = TodoReadSchema;
+}
+
+class TodoViewSet extends ModelViewSet<Todo, typeof TodoSerializer> {
+    constructor() {
+        super({
+            serializer: TodoSerializer,
+            orderingFields: ['id', 'title'],
+        });
+    }
+}
+
+async function main(): Promise<void> {
+    const app = express();
+    app.use(express.json());
+
+    const viewset = new TodoViewSet();
+    const adapter = new ExpressAdapter();
+
+    adapter.registerViewSet(app, '/api/todos', viewset);
+}
+```
+
+`registerViewSet(...)` is the application-facing CRUD helper. It registers collection routes at `/api/todos` and detail routes at `/api/todos/:id`, then calls `list`, `create`, `retrieve`, `update`, and `destroy` on the viewset instance as requests come in.
+
+`ExpressAdapter` also exposes `toQueryParams(req)` for application code that wants the same normalized query contract resources use internally. That helper returns `TangoQueryParams` from `@danceroutine/tango-core` and stays focused on Express-to-Tango normalization.
+
+## Public API
+
+The root export includes:
+
+- `ExpressAdapter`, the main integration class
+- `AdaptExpressOptions`, for adapter configuration
+- route-facing helper types such as `ExpressAPIView`, `ExpressCrudViewSet`, and `ExpressRouteRegistrar`
+
+You can import from the package root or from the `adapter` subpath:
+
+```ts
+import { ExpressAdapter } from '@danceroutine/tango-adapters-express';
+import { adapter } from '@danceroutine/tango-adapters-express';
+```
+
+## Documentation
+
+The official documentation walks through Tango from first principles and gives the clearest starting point when you are evaluating the framework or building with it.
+
+- Official documentation: <https://tangowebframework.dev>
+- Blog API tutorial: <https://tangowebframework.dev/tutorials/blog-api>
+- Resources topic: <https://tangowebframework.dev/topics/resources-and-viewsets>
+- Serializers topic: <https://tangowebframework.dev/topics/serializers>
+
+## Development
+
+```bash
+pnpm --filter @danceroutine/tango-adapters-express build
+pnpm --filter @danceroutine/tango-adapters-express typecheck
+pnpm --filter @danceroutine/tango-adapters-express test
+```
+
+For the wider contributor workflow, use:
+
+- <https://tangowebframework.dev/contributing>
+
+## License
+
+MIT

package/dist/adapter/ExpressAdapter.d.ts

@@ -1,13 +1,81 @@
 import type { Request as ExpressRequest, RequestHandler } from 'express';
+import { Router } from 'express';
 import { RequestContext } from '@danceroutine/tango-resources';
-import type { FrameworkAdapter, FrameworkAdapterOptions } from '@danceroutine/tango-adapters-core/adapter';
-export interface AdaptExpressOptions extends FrameworkAdapterOptions<ExpressRequest> {
+import { TangoQueryParams, TangoResponse } from '@danceroutine/tango-core';
+import { FRAMEWORK_ADAPTER_BRAND, type FrameworkAdapter, type FrameworkAdapterOptions } from '@danceroutine/tango-adapters-core/adapter';
+/**
+ * Adapter options for Express integration.
+ */
+export type AdaptExpressOptions = FrameworkAdapterOptions<ExpressRequest>;
+/**
+ * Minimal CRUD viewset contract used by adapter route registration helpers.
+ */
+export interface ExpressCrudViewSet {
+    list(ctx: RequestContext): Promise<TangoResponse>;
+    create(ctx: RequestContext): Promise<TangoResponse>;
+    retrieve(ctx: RequestContext, id: string): Promise<TangoResponse>;
+    update(ctx: RequestContext, id: string): Promise<TangoResponse>;
+    destroy(ctx: RequestContext, id: string): Promise<TangoResponse>;
 }
+export interface ExpressAPIView {
+    dispatch(ctx: RequestContext): Promise<TangoResponse>;
+}
+/**
+ * Minimal route registrar interface implemented by Express apps and routers.
+ */
+export interface ExpressRouteRegistrar {
+    get(path: string, handler: RequestHandler): unknown;
+    post(path: string, handler: RequestHandler): unknown;
+    patch(path: string, handler: RequestHandler): unknown;
+    put(path: string, handler: RequestHandler): unknown;
+    delete(path: string, handler: RequestHandler): unknown;
+}
+/**
+ * Express adapter that translates Express handlers to Tango `RequestContext`.
+ */
 export declare class ExpressAdapter implements FrameworkAdapter<Response, RequestHandler, ExpressRequest> {
-    adapt(handler: (ctx: RequestContext, ...args: unknown[]) => Promise<Response>, options?: AdaptExpressOptions): RequestHandler;
+    readonly __tangoBrand: typeof FRAMEWORK_ADAPTER_BRAND;
+    /**
+     * Normalize an Express request into Tango query params.
+     */
+    toQueryParams(req: ExpressRequest): TangoQueryParams;
+    /**
+     * Adapt a Tango-style handler into an Express request handler.
+     */
+    adapt(handler: (ctx: RequestContext, ...args: unknown[]) => Promise<TangoResponse>, options?: AdaptExpressOptions): RequestHandler;
+    /**
+     * Build an Express router that wires all CRUD routes for a viewset.
+     */
+    createViewSetRouter(viewset: ExpressCrudViewSet, options?: AdaptExpressOptions): Router;
+    /**
+     * Build an Express router for a single-path APIView.
+     */
+    createAPIViewRouter(apiView: ExpressAPIView, options?: AdaptExpressOptions): Router;
+    /**
+     * Register all CRUD routes for a viewset under a base path.
+     */
+    registerViewSet(registrar: ExpressRouteRegistrar, basePath: string, viewset: ExpressCrudViewSet, options?: AdaptExpressOptions): void;
+    /**
+     * Register one APIView on a single path and dispatch by HTTP method.
+     */
+    registerAPIView(registrar: ExpressRouteRegistrar, path: string, apiView: ExpressAPIView, options?: AdaptExpressOptions): void;
+    /**
+     * Register one GenericAPIView with collection and detail routes.
+     */
+    registerGenericAPIView(registrar: ExpressRouteRegistrar, collectionPath: string, detailPath: string | undefined, apiView: ExpressAPIView, options?: AdaptExpressOptions): void;
+    private invokeDetailAction;
+    private invokeCollectionAction;
     private createHandler;
+    private normalizeParams;
+    private callHandler;
     private toRequestFromExpress;
     private normalizeBody;
     private isJsonLike;
     private hasTag;
+    private registerMethod;
+    private normalizeBasePath;
+    private joinPath;
+    private registerActionMethods;
+    private registerAllMethods;
+    private getViewSetActions;
 }

package/dist/adapter/index.d.ts

@@ -1,4 +1,4 @@
 /**
  * Domain boundary barrel: centralizes this subdomain's public contract.
  */
-export { ExpressAdapter, type AdaptExpressOptions } from './ExpressAdapter';
+export { ExpressAdapter, type AdaptExpressOptions, type ExpressAPIView, type ExpressCrudViewSet, type ExpressRouteRegistrar, } from './ExpressAdapter';

package/dist/adapter/index.js

@@ -1,4 +1,3 @@
-/**
- * Domain boundary barrel: centralizes this subdomain's public contract.
- */
-export { ExpressAdapter } from './ExpressAdapter';
+import { ExpressAdapter } from "../adapter-C6JD05QW.js";
+
+export { ExpressAdapter };

package/dist/adapter-C6JD05QW.js

@@ -0,0 +1,209 @@
+import { Router } from "express";
+import { RequestContext } from "@danceroutine/tango-resources";
+import { TangoQueryParams } from "@danceroutine/tango-core";
+import { FRAMEWORK_ADAPTER_BRAND } from "@danceroutine/tango-adapters-core/adapter";
+
+//#region rolldown:runtime
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+};
+
+//#endregion
+//#region src/adapter/ExpressAdapter.ts
+var ExpressAdapter = class {
+	__tangoBrand = FRAMEWORK_ADAPTER_BRAND;
+	/**
+	* Normalize an Express request into Tango query params.
+	*/
+	toQueryParams(req) {
+		const request = this.toRequestFromExpress(req);
+		return TangoQueryParams.fromRequest(request);
+	}
+	/**
+	* Adapt a Tango-style handler into an Express request handler.
+	*/
+	adapt(handler, options = {}) {
+		return this.createHandler(handler, options);
+	}
+	/**
+	* Build an Express router that wires all CRUD routes for a viewset.
+	*/
+	createViewSetRouter(viewset, options = {}) {
+		const router = Router();
+		this.registerViewSet(router, "", viewset, options);
+		return router;
+	}
+	/**
+	* Build an Express router for a single-path APIView.
+	*/
+	createAPIViewRouter(apiView, options = {}) {
+		const router = Router();
+		this.registerAPIView(router, "", apiView, options);
+		return router;
+	}
+	/**
+	* Register all CRUD routes for a viewset under a base path.
+	*/
+	registerViewSet(registrar, basePath, viewset, options = {}) {
+		const collectionPath = this.normalizeBasePath(basePath);
+		const detailPath = collectionPath === "/" ? "/:id" : `${collectionPath}/:id`;
+		registrar.get(collectionPath, this.adapt((ctx) => viewset.list(ctx), options));
+		registrar.post(collectionPath, this.adapt((ctx) => viewset.create(ctx), options));
+		registrar.get(detailPath, this.adapt((ctx, id) => viewset.retrieve(ctx, String(id)), options));
+		registrar.patch(detailPath, this.adapt((ctx, id) => viewset.update(ctx, String(id)), options));
+		registrar.put(detailPath, this.adapt((ctx, id) => viewset.update(ctx, String(id)), options));
+		registrar.delete(detailPath, this.adapt((ctx, id) => viewset.destroy(ctx, String(id)), options));
+		const actions = this.getViewSetActions(viewset);
+		actions.forEach((action) => {
+			const actionPath = action.scope === "detail" ? this.joinPath(detailPath, action.path) : this.joinPath(collectionPath, action.path);
+			const handler = action.scope === "detail" ? this.adapt((ctx, id) => this.invokeDetailAction(viewset, action, ctx, String(id)), options) : this.adapt((ctx) => this.invokeCollectionAction(viewset, action, ctx), options);
+			this.registerActionMethods(registrar, action.methods, actionPath, handler);
+		});
+	}
+	/**
+	* Register one APIView on a single path and dispatch by HTTP method.
+	*/
+	registerAPIView(registrar, path, apiView, options = {}) {
+		const normalizedPath = this.normalizeBasePath(path);
+		this.registerAllMethods(registrar, normalizedPath, this.adapt((ctx) => apiView.dispatch(ctx), options));
+	}
+	/**
+	* Register one GenericAPIView with collection and detail routes.
+	*/
+	registerGenericAPIView(registrar, collectionPath, detailPath, apiView, options = {}) {
+		const normalizedCollectionPath = this.normalizeBasePath(collectionPath);
+		const normalizedDetailPath = detailPath?.trim().length ? this.normalizeBasePath(detailPath) : this.joinPath(normalizedCollectionPath, ":id");
+		registrar.get(normalizedCollectionPath, this.adapt((ctx) => apiView.dispatch(ctx), options));
+		registrar.post(normalizedCollectionPath, this.adapt((ctx) => apiView.dispatch(ctx), options));
+		registrar.get(normalizedDetailPath, this.adapt((ctx) => apiView.dispatch(ctx), options));
+		registrar.put(normalizedDetailPath, this.adapt((ctx) => apiView.dispatch(ctx), options));
+		registrar.patch(normalizedDetailPath, this.adapt((ctx) => apiView.dispatch(ctx), options));
+		registrar.delete(normalizedDetailPath, this.adapt((ctx) => apiView.dispatch(ctx), options));
+	}
+	invokeDetailAction(viewset, action, ctx, id) {
+		const candidate = viewset[action.name];
+		if (typeof candidate !== "function") throw new TypeError(`Missing detail action method '${action.name}' on viewset.`);
+		return candidate.call(viewset, ctx, id);
+	}
+	invokeCollectionAction(viewset, action, ctx) {
+		const candidate = viewset[action.name];
+		if (typeof candidate !== "function") throw new TypeError(`Missing collection action method '${action.name}' on viewset.`);
+		return candidate.call(viewset, ctx);
+	}
+	createHandler(handler, options) {
+		return async (req, res, next) => {
+			try {
+				const user = options.getUser ? await options.getUser(req) : null;
+				const request = this.toRequestFromExpress(req);
+				const ctx = RequestContext.create(request, user);
+				ctx.params = this.normalizeParams(req.params);
+				const rawId = req.params.id;
+				const id = Array.isArray(rawId) ? rawId[0] : rawId;
+				const response = (await this.callHandler(handler, ctx, id)).toWebResponse();
+				res.status(response.status);
+				response.headers.forEach((value, key) => {
+					res.setHeader(key, value);
+				});
+				if (!response.body) {
+					res.end();
+					return;
+				}
+				const text = await response.text();
+				res.send(text);
+			} catch (error) {
+				next(error);
+			}
+		};
+	}
+	normalizeParams(params) {
+		return Object.fromEntries(Object.entries(params).map(([key, value]) => [key, Array.isArray(value) ? value[0] ?? "" : value]));
+	}
+	async callHandler(handler, ctx, id) {
+		if (id && handler.length > 1) return handler(ctx, id);
+		return handler(ctx);
+	}
+	toRequestFromExpress(req) {
+		const protocol = req.protocol || "http";
+		const host = req.get("host") || "localhost";
+		const url = `${protocol}://${host}${req.originalUrl || req.url}`;
+		const headers = new Headers(req.headers);
+		const body = this.normalizeBody(req);
+		if (body !== undefined && !headers.has("content-type") && this.isJsonLike(req.body)) headers.set("content-type", "application/json; charset=utf-8");
+		return new Request(url, {
+			method: req.method,
+			headers,
+			body
+		});
+	}
+	normalizeBody(req) {
+		if (["GET", "HEAD"].includes(req.method)) return undefined;
+		if (req.body === null || req.body === undefined) return undefined;
+		if (typeof req.body === "string" || this.hasTag(req.body, "Uint8Array") || this.hasTag(req.body, "ArrayBuffer")) return req.body;
+		if (this.isJsonLike(req.body)) return JSON.stringify(req.body);
+		return undefined;
+	}
+	isJsonLike(value) {
+		if (value === null) return true;
+		if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return true;
+		if (Array.isArray(value)) return value.every((item) => this.isJsonLike(item));
+		if (typeof value === "object") return Object.values(value).every((item) => this.isJsonLike(item));
+		return false;
+	}
+	hasTag(value, tag) {
+		return value !== null && value !== undefined && Object.prototype.toString.call(value) === `[object ${tag}]`;
+	}
+	registerMethod(registrar, method, path, handler) {
+		switch (method) {
+			case "GET":
+				registrar.get(path, handler);
+				return;
+			case "POST":
+				registrar.post(path, handler);
+				return;
+			case "PATCH":
+				registrar.patch(path, handler);
+				return;
+			case "PUT":
+				registrar.put(path, handler);
+				return;
+			default: registrar.delete(path, handler);
+		}
+	}
+	normalizeBasePath(basePath) {
+		const trimmed = basePath.trim();
+		if (!trimmed || trimmed === "/") return "/";
+		return trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
+	}
+	joinPath(base, subPath) {
+		const normalizedSubPath = subPath.replace(/^\/+|\/+$/g, "");
+		return base === "/" ? `/${normalizedSubPath}` : `${base}/${normalizedSubPath}`;
+	}
+	registerActionMethods(registrar, methods, path, handler) {
+		for (const method of methods) this.registerMethod(registrar, method, path, handler);
+	}
+	registerAllMethods(registrar, path, handler) {
+		this.registerMethod(registrar, "GET", path, handler);
+		this.registerMethod(registrar, "POST", path, handler);
+		this.registerMethod(registrar, "PUT", path, handler);
+		this.registerMethod(registrar, "PATCH", path, handler);
+		this.registerMethod(registrar, "DELETE", path, handler);
+	}
+	getViewSetActions(viewset) {
+		const constructorValue = viewset.constructor;
+		if (typeof constructorValue.getActions !== "function") return [];
+		return constructorValue.getActions(viewset);
+	}
+};
+
+//#endregion
+//#region src/adapter/index.ts
+var adapter_exports = {};
+__export(adapter_exports, { ExpressAdapter: () => ExpressAdapter });
+
+//#endregion
+export { ExpressAdapter, adapter_exports };
+//# sourceMappingURL=adapter-C6JD05QW.js.map

package/dist/adapter-C6JD05QW.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-C6JD05QW.js","names":["req: ExpressRequest","handler: (ctx: RequestContext, ...args: unknown[]) => Promise<TangoResponse>","options: AdaptExpressOptions","viewset: ExpressCrudViewSet","apiView: ExpressAPIView","registrar: ExpressRouteRegistrar","basePath: string","path: string","collectionPath: string","detailPath: string | undefined","action: ResolvedViewSetActionDescriptor","ctx: RequestContext","id: string","res: ExpressResponse","next: NextFunction","params: Record<string, string | string[]>","id?: string","value: unknown","tag: string","method: ViewSetActionMethod","handler: RequestHandler","base: string","subPath: string","methods: readonly ViewSetActionMethod[]"],"sources":["../src/adapter/ExpressAdapter.ts","../src/adapter/index.ts"],"sourcesContent":["import type { Request as ExpressRequest, Response as ExpressResponse, NextFunction, RequestHandler } from 'express';\nimport { Router } from 'express';\nimport { RequestContext } from '@danceroutine/tango-resources';\nimport { TangoQueryParams, TangoResponse } from '@danceroutine/tango-core';\nimport {\n    FRAMEWORK_ADAPTER_BRAND,\n    type FrameworkAdapter,\n    type FrameworkAdapterOptions,\n} from '@danceroutine/tango-adapters-core/adapter';\n\ntype ViewSetActionMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';\n\ntype ResolvedViewSetActionDescriptor = {\n    name: string;\n    scope: 'detail' | 'collection';\n    methods: readonly ViewSetActionMethod[];\n    path: string;\n};\n\n/**\n * Adapter options for Express integration.\n */\nexport type AdaptExpressOptions = FrameworkAdapterOptions<ExpressRequest>;\n\n/**\n * Minimal CRUD viewset contract used by adapter route registration helpers.\n */\nexport interface ExpressCrudViewSet {\n    list(ctx: RequestContext): Promise<TangoResponse>;\n    create(ctx: RequestContext): Promise<TangoResponse>;\n    retrieve(ctx: RequestContext, id: string): Promise<TangoResponse>;\n    update(ctx: RequestContext, id: string): Promise<TangoResponse>;\n    destroy(ctx: RequestContext, id: string): Promise<TangoResponse>;\n}\n\nexport interface ExpressAPIView {\n    dispatch(ctx: RequestContext): Promise<TangoResponse>;\n}\n\n/**\n * Minimal route registrar interface implemented by Express apps and routers.\n */\nexport interface ExpressRouteRegistrar {\n    get(path: string, handler: RequestHandler): unknown;\n    post(path: string, handler: RequestHandler): unknown;\n    patch(path: string, handler: RequestHandler): unknown;\n    put(path: string, handler: RequestHandler): unknown;\n    delete(path: string, handler: RequestHandler): unknown;\n}\n\n/**\n * Express adapter that translates Express handlers to Tango `RequestContext`.\n */\nexport class ExpressAdapter implements FrameworkAdapter<Response, RequestHandler, ExpressRequest> {\n    readonly __tangoBrand: typeof FRAMEWORK_ADAPTER_BRAND = FRAMEWORK_ADAPTER_BRAND;\n\n    /**\n     * Normalize an Express request into Tango query params.\n     */\n    toQueryParams(req: ExpressRequest): TangoQueryParams {\n        const request = this.toRequestFromExpress(req);\n        return TangoQueryParams.fromRequest(request);\n    }\n\n    /**\n     * Adapt a Tango-style handler into an Express request handler.\n     */\n    adapt(\n        handler: (ctx: RequestContext, ...args: unknown[]) => Promise<TangoResponse>,\n        options: AdaptExpressOptions = {}\n    ): RequestHandler {\n        return this.createHandler(handler, options);\n    }\n\n    /**\n     * Build an Express router that wires all CRUD routes for a viewset.\n     */\n    createViewSetRouter(viewset: ExpressCrudViewSet, options: AdaptExpressOptions = {}): Router {\n        const router = Router();\n        this.registerViewSet(router, '', viewset, options);\n        return router;\n    }\n\n    /**\n     * Build an Express router for a single-path APIView.\n     */\n    createAPIViewRouter(apiView: ExpressAPIView, options: AdaptExpressOptions = {}): Router {\n        const router = Router();\n        this.registerAPIView(router, '', apiView, options);\n        return router;\n    }\n\n    /**\n     * Register all CRUD routes for a viewset under a base path.\n     */\n    registerViewSet(\n        registrar: ExpressRouteRegistrar,\n        basePath: string,\n        viewset: ExpressCrudViewSet,\n        options: AdaptExpressOptions = {}\n    ): void {\n        const collectionPath = this.normalizeBasePath(basePath);\n        const detailPath = collectionPath === '/' ? '/:id' : `${collectionPath}/:id`;\n\n        registrar.get(\n            collectionPath,\n            this.adapt((ctx) => viewset.list(ctx), options)\n        );\n        registrar.post(\n            collectionPath,\n            this.adapt((ctx) => viewset.create(ctx), options)\n        );\n        registrar.get(\n            detailPath,\n            this.adapt((ctx, id) => viewset.retrieve(ctx, String(id)), options)\n        );\n        registrar.patch(\n            detailPath,\n            this.adapt((ctx, id) => viewset.update(ctx, String(id)), options)\n        );\n        registrar.put(\n            detailPath,\n            this.adapt((ctx, id) => viewset.update(ctx, String(id)), options)\n        );\n        registrar.delete(\n            detailPath,\n            this.adapt((ctx, id) => viewset.destroy(ctx, String(id)), options)\n        );\n\n        const actions = this.getViewSetActions(viewset);\n        actions.forEach((action) => {\n            const actionPath =\n                action.scope === 'detail'\n                    ? this.joinPath(detailPath, action.path)\n                    : this.joinPath(collectionPath, action.path);\n            const handler =\n                action.scope === 'detail'\n                    ? this.adapt((ctx, id) => this.invokeDetailAction(viewset, action, ctx, String(id)), options)\n                    : this.adapt((ctx) => this.invokeCollectionAction(viewset, action, ctx), options);\n\n            this.registerActionMethods(registrar, action.methods, actionPath, handler);\n        });\n    }\n\n    /**\n     * Register one APIView on a single path and dispatch by HTTP method.\n     */\n    registerAPIView(\n        registrar: ExpressRouteRegistrar,\n        path: string,\n        apiView: ExpressAPIView,\n        options: AdaptExpressOptions = {}\n    ): void {\n        const normalizedPath = this.normalizeBasePath(path);\n        this.registerAllMethods(\n            registrar,\n            normalizedPath,\n            this.adapt((ctx) => apiView.dispatch(ctx), options)\n        );\n    }\n\n    /**\n     * Register one GenericAPIView with collection and detail routes.\n     */\n    registerGenericAPIView(\n        registrar: ExpressRouteRegistrar,\n        collectionPath: string,\n        detailPath: string | undefined,\n        apiView: ExpressAPIView,\n        options: AdaptExpressOptions = {}\n    ): void {\n        const normalizedCollectionPath = this.normalizeBasePath(collectionPath);\n        const normalizedDetailPath = detailPath?.trim().length\n            ? this.normalizeBasePath(detailPath)\n            : this.joinPath(normalizedCollectionPath, ':id');\n\n        registrar.get(\n            normalizedCollectionPath,\n            this.adapt((ctx) => apiView.dispatch(ctx), options)\n        );\n        registrar.post(\n            normalizedCollectionPath,\n            this.adapt((ctx) => apiView.dispatch(ctx), options)\n        );\n        registrar.get(\n            normalizedDetailPath,\n            this.adapt((ctx) => apiView.dispatch(ctx), options)\n        );\n        registrar.put(\n            normalizedDetailPath,\n            this.adapt((ctx) => apiView.dispatch(ctx), options)\n        );\n        registrar.patch(\n            normalizedDetailPath,\n            this.adapt((ctx) => apiView.dispatch(ctx), options)\n        );\n        registrar.delete(\n            normalizedDetailPath,\n            this.adapt((ctx) => apiView.dispatch(ctx), options)\n        );\n    }\n\n    private invokeDetailAction(\n        viewset: ExpressCrudViewSet,\n        action: ResolvedViewSetActionDescriptor,\n        ctx: RequestContext,\n        id: string\n    ): Promise<TangoResponse> {\n        const candidate = (viewset as unknown as Record<string, unknown>)[action.name];\n        if (typeof candidate !== 'function') {\n            throw new TypeError(`Missing detail action method '${action.name}' on viewset.`);\n        }\n        return (\n            candidate as (this: ExpressCrudViewSet, ctx: RequestContext, id: string) => Promise<TangoResponse>\n        ).call(viewset, ctx, id);\n    }\n\n    private invokeCollectionAction(\n        viewset: ExpressCrudViewSet,\n        action: ResolvedViewSetActionDescriptor,\n        ctx: RequestContext\n    ): Promise<TangoResponse> {\n        const candidate = (viewset as unknown as Record<string, unknown>)[action.name];\n        if (typeof candidate !== 'function') {\n            throw new TypeError(`Missing collection action method '${action.name}' on viewset.`);\n        }\n        return (candidate as (this: ExpressCrudViewSet, ctx: RequestContext) => Promise<TangoResponse>).call(\n            viewset,\n            ctx\n        );\n    }\n\n    private createHandler(\n        handler: (ctx: RequestContext, ...args: unknown[]) => Promise<TangoResponse>,\n        options: AdaptExpressOptions\n    ): RequestHandler {\n        return async (req: ExpressRequest, res: ExpressResponse, next: NextFunction) => {\n            try {\n                const user = options.getUser ? await options.getUser(req) : null;\n\n                const request = this.toRequestFromExpress(req);\n                const ctx = RequestContext.create(request, user);\n                ctx.params = this.normalizeParams(req.params);\n\n                const rawId = req.params.id;\n                const id = Array.isArray(rawId) ? rawId[0] : rawId;\n                const response = (await this.callHandler(handler, ctx, id)).toWebResponse();\n\n                res.status(response.status);\n\n                response.headers.forEach((value, key) => {\n                    res.setHeader(key, value);\n                });\n\n                if (!response.body) {\n                    res.end();\n                    return;\n                }\n\n                const text = await response.text();\n                res.send(text);\n            } catch (error) {\n                next(error);\n            }\n        };\n    }\n\n    private normalizeParams(params: Record<string, string | string[]>): Record<string, string> {\n        return Object.fromEntries(\n            Object.entries(params).map(([key, value]) => [key, Array.isArray(value) ? (value[0] ?? '') : value])\n        );\n    }\n\n    private async callHandler(\n        handler: (ctx: RequestContext, ...args: unknown[]) => Promise<TangoResponse>,\n        ctx: RequestContext,\n        id?: string\n    ): Promise<TangoResponse> {\n        if (id && handler.length > 1) {\n            return handler(ctx, id);\n        }\n        return handler(ctx);\n    }\n\n    private toRequestFromExpress(req: ExpressRequest): Request {\n        const protocol = req.protocol || 'http';\n        const host = req.get('host') || 'localhost';\n        const url = `${protocol}://${host}${req.originalUrl || req.url}`;\n        const headers = new Headers(req.headers as HeadersInit);\n        const body = this.normalizeBody(req);\n\n        if (body !== undefined && !headers.has('content-type') && this.isJsonLike(req.body)) {\n            headers.set('content-type', 'application/json; charset=utf-8');\n        }\n\n        return new Request(url, {\n            method: req.method,\n            headers,\n            body,\n        });\n    }\n\n    private normalizeBody(req: ExpressRequest): BodyInit | null | undefined {\n        if (['GET', 'HEAD'].includes(req.method)) {\n            return undefined;\n        }\n\n        if (req.body === null || req.body === undefined) {\n            return undefined;\n        }\n\n        if (\n            typeof req.body === 'string' ||\n            this.hasTag(req.body, 'Uint8Array') ||\n            this.hasTag(req.body, 'ArrayBuffer')\n        ) {\n            return req.body;\n        }\n\n        if (this.isJsonLike(req.body)) {\n            return JSON.stringify(req.body);\n        }\n\n        return undefined;\n    }\n\n    private isJsonLike(value: unknown): boolean {\n        if (value === null) return true;\n        if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') return true;\n        if (Array.isArray(value)) return value.every((item) => this.isJsonLike(item));\n        if (typeof value === 'object') {\n            return Object.values(value as Record<string, unknown>).every((item) => this.isJsonLike(item));\n        }\n        return false;\n    }\n\n    private hasTag(value: unknown, tag: string): boolean {\n        return value !== null && value !== undefined && Object.prototype.toString.call(value) === `[object ${tag}]`;\n    }\n\n    private registerMethod(\n        registrar: ExpressRouteRegistrar,\n        method: ViewSetActionMethod,\n        path: string,\n        handler: RequestHandler\n    ): void {\n        switch (method) {\n            case 'GET':\n                registrar.get(path, handler);\n                return;\n            case 'POST':\n                registrar.post(path, handler);\n                return;\n            case 'PATCH':\n                registrar.patch(path, handler);\n                return;\n            case 'PUT':\n                registrar.put(path, handler);\n                return;\n            default:\n                registrar.delete(path, handler);\n        }\n    }\n\n    private normalizeBasePath(basePath: string): string {\n        const trimmed = basePath.trim();\n        if (!trimmed || trimmed === '/') {\n            return '/';\n        }\n        return trimmed.startsWith('/') ? trimmed : `/${trimmed}`;\n    }\n\n    private joinPath(base: string, subPath: string): string {\n        const normalizedSubPath = subPath.replace(/^\\/+|\\/+$/g, '');\n        return base === '/' ? `/${normalizedSubPath}` : `${base}/${normalizedSubPath}`;\n    }\n\n    private registerActionMethods(\n        registrar: ExpressRouteRegistrar,\n        methods: readonly ViewSetActionMethod[],\n        path: string,\n        handler: RequestHandler\n    ): void {\n        for (const method of methods) {\n            this.registerMethod(registrar, method, path, handler);\n        }\n    }\n\n    private registerAllMethods(registrar: ExpressRouteRegistrar, path: string, handler: RequestHandler): void {\n        this.registerMethod(registrar, 'GET', path, handler);\n        this.registerMethod(registrar, 'POST', path, handler);\n        this.registerMethod(registrar, 'PUT', path, handler);\n        this.registerMethod(registrar, 'PATCH', path, handler);\n        this.registerMethod(registrar, 'DELETE', path, handler);\n    }\n\n    private getViewSetActions(viewset: ExpressCrudViewSet): readonly ResolvedViewSetActionDescriptor[] {\n        const constructorValue = viewset.constructor as {\n            getActions?: (input: ExpressCrudViewSet) => readonly ResolvedViewSetActionDescriptor[];\n        };\n\n        if (typeof constructorValue.getActions !== 'function') {\n            return [];\n        }\n\n        return constructorValue.getActions(viewset);\n    }\n}\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport {\n    ExpressAdapter,\n    type AdaptExpressOptions,\n    type ExpressAPIView,\n    type ExpressCrudViewSet,\n    type ExpressRouteRegistrar,\n} from './ExpressAdapter';\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -3,4 +3,4 @@
  * top-level symbols for TS-native ergonomic imports.
  */
 export * as adapter from './adapter/index';
-export { ExpressAdapter, type AdaptExpressOptions } from './adapter/index';
+export { ExpressAdapter, type AdaptExpressOptions, type ExpressAPIView, type ExpressCrudViewSet, type ExpressRouteRegistrar, } from './adapter/index';

package/dist/index.js

@@ -1,3 +1,3 @@
-import { ExpressAdapter, adapter_exports } from "./adapter-BllmY5Er.js";
+import { ExpressAdapter, adapter_exports } from "./adapter-C6JD05QW.js";
 
 export { ExpressAdapter, adapter_exports as adapter };

package/package.json

@@ -1,55 +1,58 @@
 {
-    "name": "@danceroutine/tango-adapters-express",
-    "version": "0.1.0",
-    "description": "Express adapter for Tango",
-    "type": "module",
-    "main": "./dist/index.js",
-    "types": "./dist/index.d.ts",
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.js"
-        },
-        "./adapter": {
-            "types": "./dist/adapter/index.d.ts",
-            "import": "./dist/adapter/index.js"
-        }
+  "name": "@danceroutine/tango-adapters-express",
+  "version": "1.0.0",
+  "description": "Express adapter for Tango",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     },
-    "files": [
-        "dist"
-    ],
-    "scripts": {
-        "build": "tsdown",
-        "test": "vitest run --coverage",
-        "test:watch": "vitest",
-        "typecheck": "tsc --noEmit"
-    },
-    "keywords": [
-        "tango",
-        "express",
-        "adapter"
-    ],
-    "author": "Pedro Del Moral Lopez",
-    "license": "MIT",
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/danceroutine/tango.git",
-        "directory": "packages/adapters/express"
-    },
-    "dependencies": {
-        "@danceroutine/tango-resources": "workspace:*",
-        "@danceroutine/tango-adapters-core": "workspace:*",
-        "@danceroutine/tango-core": "workspace:*"
-    },
-    "peerDependencies": {
-        "express": "^4.21.1 || ^5.0.0"
-    },
-    "devDependencies": {
-        "@types/express": "^5.0.0",
-        "@types/node": "^22.9.0",
-        "express": "^4.21.1",
-        "tsdown": "^0.4.0",
-        "typescript": "^5.6.3",
-        "vitest": "^4.0.6"
+    "./adapter": {
+      "types": "./dist/adapter/index.d.ts",
+      "import": "./dist/adapter/index.js"
     }
-}
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "tango",
+    "express",
+    "adapter"
+  ],
+  "author": "Pedro Del Moral Lopez",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/danceroutine/tango.git",
+    "directory": "packages/adapters/express"
+  },
+  "dependencies": {
+    "@danceroutine/tango-core": "1.0.0",
+    "@danceroutine/tango-adapters-core": "1.0.0",
+    "@danceroutine/tango-resources": "1.0.0"
+  },
+  "peerDependencies": {
+    "express": "^4.21.1 || ^5.0.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.9.0",
+    "express": "^4.21.1",
+    "tsdown": "^0.4.0",
+    "typescript": "^5.6.3",
+    "vitest": "^4.0.6",
+    "@danceroutine/tango-testing": "1.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run --coverage",
+    "test:watch": "vitest",
+    "typecheck": "pnpm run typecheck:prod && pnpm run typecheck:test",
+    "typecheck:prod": "tsc --noEmit -p tsconfig.json",
+    "typecheck:test": "tsc --noEmit -p tsconfig.tests.json"
+  }
+}

package/dist/adapter/ExpressAdapter.js

@@ -1,88 +0,0 @@
-import { RequestContext } from '@danceroutine/tango-resources';
-export class ExpressAdapter {
-    adapt(handler, options = {}) {
-        return this.createHandler(handler, options);
-    }
-    createHandler(handler, options) {
-        return async (req, res, next) => {
-            try {
-                const user = options.getUser ? await options.getUser(req) : null;
-                const request = this.toRequestFromExpress(req);
-                const ctx = RequestContext.create(request, user);
-                ctx.params = Object.fromEntries(Object.entries(req.params).map(([key, value]) => [
-                    key,
-                    Array.isArray(value) ? (value[0] ?? '') : value,
-                ]));
-                const id = req.params.id;
-                let response;
-                if (id && handler.length > 1) {
-                    response = await handler(ctx, id);
-                }
-                else {
-                    response = await handler(ctx);
-                }
-                res.status(response.status);
-                response.headers.forEach((value, key) => {
-                    res.setHeader(key, value);
-                });
-                if (response.body) {
-                    const text = await response.text();
-                    res.send(text);
-                }
-                else {
-                    res.end();
-                }
-            }
-            catch (error) {
-                next(error);
-            }
-        };
-    }
-    toRequestFromExpress(req) {
-        const protocol = req.protocol || 'http';
-        const host = req.get('host') || 'localhost';
-        const url = `${protocol}://${host}${req.originalUrl || req.url}`;
-        const headers = new Headers(req.headers);
-        const body = this.normalizeBody(req);
-        if (body !== undefined && !headers.has('content-type') && this.isJsonLike(req.body)) {
-            headers.set('content-type', 'application/json; charset=utf-8');
-        }
-        return new Request(url, {
-            method: req.method,
-            headers,
-            body,
-        });
-    }
-    normalizeBody(req) {
-        if (['GET', 'HEAD'].includes(req.method)) {
-            return undefined;
-        }
-        if (req.body == null) {
-            return undefined;
-        }
-        if (typeof req.body === 'string' ||
-            this.hasTag(req.body, 'Uint8Array') ||
-            this.hasTag(req.body, 'ArrayBuffer')) {
-            return req.body;
-        }
-        if (this.isJsonLike(req.body)) {
-            return JSON.stringify(req.body);
-        }
-        return undefined;
-    }
-    isJsonLike(value) {
-        if (value === null)
-            return true;
-        if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean')
-            return true;
-        if (Array.isArray(value))
-            return value.every((item) => this.isJsonLike(item));
-        if (typeof value === 'object') {
-            return Object.values(value).every((item) => this.isJsonLike(item));
-        }
-        return false;
-    }
-    hasTag(value, tag) {
-        return value != null && Object.prototype.toString.call(value) === `[object ${tag}]`;
-    }
-}

package/dist/adapter-BllmY5Er.js

@@ -1,81 +0,0 @@
-import { RequestContext } from "@danceroutine/tango-resources";
-
-//#region rolldown:runtime
-var __defProp = Object.defineProperty;
-var __export = (target, all) => {
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-};
-
-//#endregion
-//#region src/adapter/ExpressAdapter.ts
-var ExpressAdapter = class {
-	adapt(handler, options = {}) {
-		return this.createHandler(handler, options);
-	}
-	createHandler(handler, options) {
-		return async (req, res, next) => {
-			try {
-				const user = options.getUser ? await options.getUser(req) : null;
-				const request = this.toRequestFromExpress(req);
-				const ctx = RequestContext.create(request, user);
-				ctx.params = Object.fromEntries(Object.entries(req.params).map(([key, value]) => [key, Array.isArray(value) ? value[0] ?? "" : value]));
-				const id = req.params.id;
-				let response;
-				if (id && handler.length > 1) response = await handler(ctx, id);
-else response = await handler(ctx);
-				res.status(response.status);
-				response.headers.forEach((value, key) => {
-					res.setHeader(key, value);
-				});
-				if (response.body) {
-					const text = await response.text();
-					res.send(text);
-				} else res.end();
-			} catch (error) {
-				next(error);
-			}
-		};
-	}
-	toRequestFromExpress(req) {
-		const protocol = req.protocol || "http";
-		const host = req.get("host") || "localhost";
-		const url = `${protocol}://${host}${req.originalUrl || req.url}`;
-		const headers = new Headers(req.headers);
-		const body = this.normalizeBody(req);
-		if (body !== undefined && !headers.has("content-type") && this.isJsonLike(req.body)) headers.set("content-type", "application/json; charset=utf-8");
-		return new Request(url, {
-			method: req.method,
-			headers,
-			body
-		});
-	}
-	normalizeBody(req) {
-		if (["GET", "HEAD"].includes(req.method)) return undefined;
-		if (req.body == null) return undefined;
-		if (typeof req.body === "string" || this.hasTag(req.body, "Uint8Array") || this.hasTag(req.body, "ArrayBuffer")) return req.body;
-		if (this.isJsonLike(req.body)) return JSON.stringify(req.body);
-		return undefined;
-	}
-	isJsonLike(value) {
-		if (value === null) return true;
-		if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return true;
-		if (Array.isArray(value)) return value.every((item) => this.isJsonLike(item));
-		if (typeof value === "object") return Object.values(value).every((item) => this.isJsonLike(item));
-		return false;
-	}
-	hasTag(value, tag) {
-		return value != null && Object.prototype.toString.call(value) === `[object ${tag}]`;
-	}
-};
-
-//#endregion
-//#region src/adapter/index.ts
-var adapter_exports = {};
-__export(adapter_exports, { ExpressAdapter: () => ExpressAdapter });
-
-//#endregion
-export { ExpressAdapter, adapter_exports };
-//# sourceMappingURL=adapter-BllmY5Er.js.map

package/dist/adapter-BllmY5Er.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter-BllmY5Er.js","names":["handler: (ctx: RequestContext, ...args: unknown[]) => Promise<Response>","options: AdaptExpressOptions","req: ExpressRequest","res: ExpressResponse","next: NextFunction","response: Response","value: unknown","tag: string"],"sources":["../src/adapter/ExpressAdapter.ts","../src/adapter/index.ts"],"sourcesContent":["import type { Request as ExpressRequest, Response as ExpressResponse, NextFunction, RequestHandler } from 'express';\nimport { RequestContext } from '@danceroutine/tango-resources';\nimport type { FrameworkAdapter, FrameworkAdapterOptions } from '@danceroutine/tango-adapters-core/adapter';\n\nexport interface AdaptExpressOptions extends FrameworkAdapterOptions<ExpressRequest> {}\n\nexport class ExpressAdapter implements FrameworkAdapter<Response, RequestHandler, ExpressRequest> {\n    adapt(\n        handler: (ctx: RequestContext, ...args: unknown[]) => Promise<Response>,\n        options: AdaptExpressOptions = {}\n    ): RequestHandler {\n        return this.createHandler(handler, options);\n    }\n\n    private createHandler(\n        handler: (ctx: RequestContext, ...args: unknown[]) => Promise<Response>,\n        options: AdaptExpressOptions\n    ): RequestHandler {\n        return async (req: ExpressRequest, res: ExpressResponse, next: NextFunction) => {\n            try {\n                const user = options.getUser ? await options.getUser(req) : null;\n\n                const request = this.toRequestFromExpress(req);\n                const ctx = RequestContext.create(request, user);\n                ctx.params = Object.fromEntries(\n                    Object.entries(req.params).map(([key, value]) => [\n                        key,\n                        Array.isArray(value) ? (value[0] ?? '') : value,\n                    ])\n                );\n\n                const id = req.params.id;\n                let response: Response;\n\n                if (id && handler.length > 1) {\n                    response = await handler(ctx, id);\n                } else {\n                    response = await handler(ctx);\n                }\n\n                res.status(response.status);\n\n                response.headers.forEach((value, key) => {\n                    res.setHeader(key, value);\n                });\n\n                if (response.body) {\n                    const text = await response.text();\n                    res.send(text);\n                } else {\n                    res.end();\n                }\n            } catch (error) {\n                next(error);\n            }\n        };\n    }\n\n    private toRequestFromExpress(req: ExpressRequest): Request {\n        const protocol = req.protocol || 'http';\n        const host = req.get('host') || 'localhost';\n        const url = `${protocol}://${host}${req.originalUrl || req.url}`;\n        const headers = new Headers(req.headers as HeadersInit);\n        const body = this.normalizeBody(req);\n\n        if (body !== undefined && !headers.has('content-type') && this.isJsonLike(req.body)) {\n            headers.set('content-type', 'application/json; charset=utf-8');\n        }\n\n        return new Request(url, {\n            method: req.method,\n            headers,\n            body,\n        });\n    }\n\n    private normalizeBody(req: ExpressRequest): BodyInit | null | undefined {\n        if (['GET', 'HEAD'].includes(req.method)) {\n            return undefined;\n        }\n\n        if (req.body == null) {\n            return undefined;\n        }\n\n        if (\n            typeof req.body === 'string' ||\n            this.hasTag(req.body, 'Uint8Array') ||\n            this.hasTag(req.body, 'ArrayBuffer')\n        ) {\n            return req.body;\n        }\n\n        if (this.isJsonLike(req.body)) {\n            return JSON.stringify(req.body);\n        }\n\n        return undefined;\n    }\n\n    private isJsonLike(value: unknown): boolean {\n        if (value === null) return true;\n        if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') return true;\n        if (Array.isArray(value)) return value.every((item) => this.isJsonLike(item));\n        if (typeof value === 'object') {\n            return Object.values(value as Record<string, unknown>).every((item) => this.isJsonLike(item));\n        }\n        return false;\n    }\n\n    private hasTag(value: unknown, tag: string): boolean {\n        return value != null && Object.prototype.toString.call(value) === `[object ${tag}]`;\n    }\n}\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { ExpressAdapter, type AdaptExpressOptions } from './ExpressAdapter';\n"],"mappings":";;;;;;;;;;;;;IAMa,iBAAN,MAA2F;CAC9F,MACIA,SACAC,UAA+B,CAAE,GACnB;AACd,SAAO,KAAK,cAAc,SAAS,QAAQ;CAC9C;CAED,cACID,SACAC,SACc;AACd,SAAO,OAAOC,KAAqBC,KAAsBC,SAAuB;AAC5E,OAAI;IACA,MAAM,OAAO,QAAQ,UAAU,MAAM,QAAQ,QAAQ,IAAI,GAAG;IAE5D,MAAM,UAAU,KAAK,qBAAqB,IAAI;IAC9C,MAAM,MAAM,eAAe,OAAO,SAAS,KAAK;AAChD,QAAI,SAAS,OAAO,YAChB,OAAO,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,MAAM,KAAK,CAC7C,KACA,MAAM,QAAQ,MAAM,GAAI,MAAM,MAAM,KAAM,KAC7C,EAAC,CACL;IAED,MAAM,KAAK,IAAI,OAAO;IACtB,IAAIC;AAEJ,QAAI,MAAM,QAAQ,SAAS,EACvB,YAAW,MAAM,QAAQ,KAAK,GAAG;IAEjC,YAAW,MAAM,QAAQ,IAAI;AAGjC,QAAI,OAAO,SAAS,OAAO;AAE3B,aAAS,QAAQ,QAAQ,CAAC,OAAO,QAAQ;AACrC,SAAI,UAAU,KAAK,MAAM;IAC5B,EAAC;AAEF,QAAI,SAAS,MAAM;KACf,MAAM,OAAO,MAAM,SAAS,MAAM;AAClC,SAAI,KAAK,KAAK;IACjB,MACG,KAAI,KAAK;GAEhB,SAAQ,OAAO;AACZ,SAAK,MAAM;GACd;EACJ;CACJ;CAED,qBAA6BH,KAA8B;EACvD,MAAM,WAAW,IAAI,YAAY;EACjC,MAAM,OAAO,IAAI,IAAI,OAAO,IAAI;EAChC,MAAM,OAAO,EAAE,SAAS,KAAK,KAAK,EAAE,IAAI,eAAe,IAAI,IAAI;EAC/D,MAAM,UAAU,IAAI,QAAQ,IAAI;EAChC,MAAM,OAAO,KAAK,cAAc,IAAI;AAEpC,MAAI,SAAS,cAAc,QAAQ,IAAI,eAAe,IAAI,KAAK,WAAW,IAAI,KAAK,CAC/E,SAAQ,IAAI,gBAAgB,kCAAkC;AAGlE,SAAO,IAAI,QAAQ,KAAK;GACpB,QAAQ,IAAI;GACZ;GACA;EACH;CACJ;CAED,cAAsBA,KAAkD;AACpE,MAAI,CAAC,OAAO,MAAO,EAAC,SAAS,IAAI,OAAO,CACpC,QAAO;AAGX,MAAI,IAAI,QAAQ,KACZ,QAAO;AAGX,aACW,IAAI,SAAS,YACpB,KAAK,OAAO,IAAI,MAAM,aAAa,IACnC,KAAK,OAAO,IAAI,MAAM,cAAc,CAEpC,QAAO,IAAI;AAGf,MAAI,KAAK,WAAW,IAAI,KAAK,CACzB,QAAO,KAAK,UAAU,IAAI,KAAK;AAGnC,SAAO;CACV;CAED,WAAmBI,OAAyB;AACxC,MAAI,UAAU,KAAM,QAAO;AAC3B,aAAW,UAAU,mBAAmB,UAAU,mBAAmB,UAAU,UAAW,QAAO;AACjG,MAAI,MAAM,QAAQ,MAAM,CAAE,QAAO,MAAM,MAAM,CAAC,SAAS,KAAK,WAAW,KAAK,CAAC;AAC7E,aAAW,UAAU,SACjB,QAAO,OAAO,OAAO,MAAiC,CAAC,MAAM,CAAC,SAAS,KAAK,WAAW,KAAK,CAAC;AAEjG,SAAO;CACV;CAED,OAAeA,OAAgBC,KAAsB;AACjD,SAAO,SAAS,QAAQ,OAAO,UAAU,SAAS,KAAK,MAAM,MAAM,UAAU,IAAI;CACpF;AACJ"}