@danceroutine/tango-adapters-next 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,88 @@
+# @danceroutine/tango-adapters-next
+
+`@danceroutine/tango-adapters-next` runs Tango views and viewsets inside Next.js App Router route handlers.
+
+Tango supplies the application-layer concepts such as serializers, API views, and model-backed viewsets. Next.js still owns routing, deployment model, and the route-handler contract. This package exists to connect those layers cleanly so that a Tango API can live inside a Next.js codebase without forcing the resource layer to become Next-specific.
+
+## Install
+
+```bash
+pnpm add @danceroutine/tango-adapters-next next react react-dom
+```
+
+In practice, you will pair this package with Tango schema, ORM, and resources packages.
+
+## How it fits into a Next.js application
+
+A typical workflow looks like this:
+
+1. define models with `@danceroutine/tango-schema`
+2. query and mutate data through `Model.objects` from `@danceroutine/tango-orm`
+3. expose that model-backed behavior through Tango views or viewsets
+4. adapt those handlers to App Router route files with `NextAdapter`
+
+This adapter is concerned solely with step 4 of the above workflow. It receives Next's request and route context, invokes the Tango handler, and returns a response in the shape Next expects.
+
+## Quick start
+
+```ts
+import { NextAdapter } from '@danceroutine/tango-adapters-next';
+import { TodoViewSet } from '@/viewsets/TodoViewSet';
+
+const adapter = new NextAdapter();
+const viewset = new TodoViewSet();
+
+export const { GET, POST, PATCH, PUT, DELETE } = adapter.adaptViewSet(viewset);
+```
+
+Place that code in `app/api/todos/[[...tango]]/route.ts`. The adapter will produce handlers for the collection route at `/api/todos` and the detail route at `/api/todos/:id`.
+
+Use `adaptViewSet(...)` when you already have a ready viewset instance in hand. Use `adaptViewSetFactory(...)` when constructing the viewset requires asynchronous setup. The factory result is memoized inside the adapter, and initialization failures clear that memoized promise so a later request can retry cleanly.
+
+For detail requests, the adapter resolves the identifier, passes it as the second argument to `retrieve`, `update`, and `destroy`, and also populates `ctx.params.id`.
+
+`NextAdapter` also exposes `toQueryParams(searchParams)` for route modules and server components that want the same normalized query contract resources use internally. That helper returns `TangoQueryParams` from `@danceroutine/tango-core`.
+
+## Public API
+
+The root export includes:
+
+- `NextAdapter`, the main integration class
+- `AdaptNextOptions` and `AdaptNextViewSetOptions`
+- route-facing helper types such as `NextAPIView`, `NextCrudViewSet`, `NextRouteHandler`, and `NextViewSetRouteHandlers`
+
+The main adapter entry points are:
+
+- `adaptViewSet(...)` for an already constructed viewset
+- `adaptViewSetFactory(...)` for lazy async viewset construction in App Router route modules
+- `adaptAPIView(...)` for `APIView`
+- `adaptGenericAPIView(...)` for `GenericAPIView`-style collection/detail dispatch
+
+You can import from the package root or from the `adapter` subpath:
+
+```ts
+import { NextAdapter } from '@danceroutine/tango-adapters-next';
+import { adapter } from '@danceroutine/tango-adapters-next';
+```
+
+## Documentation
+
+- Official documentation: <https://tangowebframework.dev>
+- Next.js blog tutorial: <https://tangowebframework.dev/tutorials/nextjs-blog>
+- Resources topic: <https://tangowebframework.dev/topics/resources-and-viewsets>
+
+## Development
+
+```bash
+pnpm --filter @danceroutine/tango-adapters-next build
+pnpm --filter @danceroutine/tango-adapters-next typecheck
+pnpm --filter @danceroutine/tango-adapters-next test
+```
+
+For the wider contributor workflow, use:
+
+- <https://tangowebframework.dev/contributing>
+
+## License
+
+MIT

package/dist/adapter/NextAdapter.d.ts

@@ -1,13 +1,100 @@
 import type { NextRequest } from 'next/server';
-import { NextResponse } from 'next/server';
 import { RequestContext } from '@danceroutine/tango-resources';
-import type { FrameworkAdapter, FrameworkAdapterOptions } from '@danceroutine/tango-adapters-core/adapter';
-export type NextRouteHandler = (request: NextRequest, context: {
-    params?: Promise<Record<string, string>>;
-}) => Promise<NextResponse>;
-export interface AdaptNextOptions extends FrameworkAdapterOptions<NextRequest> {
-}
-export declare class NextAdapter implements FrameworkAdapter<NextResponse, NextRouteHandler, NextRequest> {
-    adapt(handler: (ctx: RequestContext, ...args: unknown[]) => Promise<NextResponse>, options?: AdaptNextOptions): NextRouteHandler;
+import { TangoQueryParams, TangoResponse } from '@danceroutine/tango-core';
+import { FRAMEWORK_ADAPTER_BRAND, type FrameworkAdapter, type FrameworkAdapterOptions } from '@danceroutine/tango-adapters-core/adapter';
+/**
+ * Next.js route handler signature produced by the adapter.
+ */
+export type NextRouteHandler = (request: NextRequest, context?: {
+    params?: Promise<Record<string, string | string[]>>;
+}) => Promise<Response>;
+export type NextDynamicRouteContext = {
+    params: Promise<Record<string, string | string[]>>;
+};
+export type NextDynamicRouteHandler = (request: NextRequest, context: NextDynamicRouteContext) => Promise<Response>;
+/**
+ * Adapter options for Next.js integration.
+ */
+export type AdaptNextOptions = FrameworkAdapterOptions<NextRequest>;
+/**
+ * Minimal CRUD viewset contract used by the Next adapter route helpers.
+ */
+export interface NextCrudViewSet {
+    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 NextAPIView {
+    dispatch(ctx: RequestContext): Promise<TangoResponse>;
+}
+export type NextViewSetFactory = () => NextCrudViewSet | Promise<NextCrudViewSet>;
+export type NextAPIViewFactory = () => NextAPIView | Promise<NextAPIView>;
+/**
+ * Options for auto-generated viewset route handlers.
+ */
+export type AdaptNextViewSetOptions = AdaptNextOptions & {
+    paramKey?: string;
+};
+/**
+ * HTTP method handlers generated from a CRUD viewset.
+ */
+export interface NextViewSetRouteHandlers {
+    GET: NextDynamicRouteHandler;
+    POST: NextDynamicRouteHandler;
+    PATCH: NextDynamicRouteHandler;
+    PUT: NextDynamicRouteHandler;
+    DELETE: NextDynamicRouteHandler;
+}
+/**
+ * Next.js adapter that translates route handlers to Tango `RequestContext`.
+ */
+export declare class NextAdapter implements FrameworkAdapter<Response, NextRouteHandler, NextRequest> {
+    readonly __tangoBrand: typeof FRAMEWORK_ADAPTER_BRAND;
+    private readonly logger;
+    /**
+     * Normalize Next.js-style route search params into Tango query params.
+     */
+    toQueryParams(searchParams: Record<string, string | string[] | undefined>): TangoQueryParams;
+    /**
+     * Adapt a Tango-style handler into a Next.js route handler.
+     */
+    adapt(handler: (ctx: RequestContext, ...args: unknown[]) => Promise<TangoResponse>, options?: AdaptNextOptions): NextRouteHandler;
+    /**
+     * Build Next route handlers that map HTTP verbs to standard CRUD viewset actions.
+     */
+    adaptViewSet(viewset: NextCrudViewSet, options?: AdaptNextViewSetOptions): NextViewSetRouteHandlers;
+    /**
+     * Build Next route handlers from a lazy viewset factory and memoize initialization.
+     * Initialization failures clear the memoized promise so subsequent requests can retry.
+     */
+    adaptViewSetFactory(factory: NextViewSetFactory, options?: AdaptNextViewSetOptions): NextViewSetRouteHandlers;
+    /**
+     * Build Next route handlers from a lazy GenericAPIView factory and memoize initialization.
+     */
+    adaptGenericAPIViewFactory(factory: NextAPIViewFactory, options?: AdaptNextViewSetOptions): NextViewSetRouteHandlers;
+    /**
+     * Build Next route handlers that dispatch an APIView by HTTP method.
+     */
+    adaptAPIView(apiView: NextAPIView, options?: AdaptNextOptions): NextViewSetRouteHandlers;
+    /**
+     * Build handlers for GenericAPIView-style collection/detail splits in catch-all routes.
+     */
+    adaptGenericAPIView(apiView: NextAPIView, options?: AdaptNextViewSetOptions): NextViewSetRouteHandlers;
+    private toTangoRequest;
+    private dispatchViewSetAction;
+    private invokeDetailAction;
+    private invokeCollectionAction;
     private createHandler;
+    private internalServerError;
+    private adaptRouteHandlersFactory;
+    private resolveDetailId;
+    private normalizeRouteParams;
+    private extractDirectId;
+    private extractCatchAllSegments;
+    private methodNotAllowedResponse;
+    private notFoundResponse;
+    private resolveActionMatch;
+    private getViewSetActions;
 }

package/dist/adapter/index.d.ts

@@ -1,4 +1,4 @@
 /**
  * Domain boundary barrel: centralizes this subdomain's public contract.
  */
-export { NextAdapter, type AdaptNextOptions, type NextRouteHandler } from './NextAdapter';
+export { NextAdapter, type AdaptNextOptions, type AdaptNextViewSetOptions, type NextAPIView, type NextAPIViewFactory, type NextCrudViewSet, type NextDynamicRouteContext, type NextDynamicRouteHandler, type NextRouteHandler, type NextViewSetFactory, type NextViewSetRouteHandlers, } from './NextAdapter';

package/dist/adapter/index.js

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

package/dist/adapter-_WsZ0kE-.js

@@ -0,0 +1,268 @@
+import { RequestContext } from "@danceroutine/tango-resources";
+import { HttpErrorFactory, TangoQueryParams, TangoRequest, TangoResponse, getLogger } from "@danceroutine/tango-core";
+import { FRAMEWORK_ADAPTER_BRAND } from "@danceroutine/tango-adapters-core/adapter";
+import { InternalActionMatchKind, InternalActionScope, InternalHttpMethod } from "@danceroutine/tango-adapters-core";
+
+//#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/NextAdapter.ts
+var NextAdapter = class {
+	__tangoBrand = FRAMEWORK_ADAPTER_BRAND;
+	logger = getLogger("tango.adapter.next");
+	/**
+	* Normalize Next.js-style route search params into Tango query params.
+	*/
+	toQueryParams(searchParams) {
+		return TangoQueryParams.fromRecord(searchParams);
+	}
+	/**
+	* Adapt a Tango-style handler into a Next.js route handler.
+	*/
+	adapt(handler, options = {}) {
+		return this.createHandler(handler, options);
+	}
+	/**
+	* Build Next route handlers that map HTTP verbs to standard CRUD viewset actions.
+	*/
+	adaptViewSet(viewset, options = {}) {
+		const paramKey = options.paramKey ?? "tango";
+		return {
+			GET: this.adapt((ctx) => this.dispatchViewSetAction(viewset, InternalHttpMethod.GET, ctx, paramKey, (segments, directId) => {
+				if (directId) return viewset.retrieve(ctx, directId);
+				if (segments.length === 0) return viewset.list(ctx);
+				if (segments.length === 1) return viewset.retrieve(ctx, segments[0]);
+				return this.notFoundResponse();
+			}), options),
+			POST: this.adapt((ctx) => this.dispatchViewSetAction(viewset, InternalHttpMethod.POST, ctx, paramKey, (segments, directId) => {
+				if (segments.length === 0 && !directId) return viewset.create(ctx);
+				return this.methodNotAllowedResponse();
+			}), options),
+			PATCH: this.adapt((ctx) => this.dispatchViewSetAction(viewset, InternalHttpMethod.PATCH, ctx, paramKey, (segments, directId) => {
+				const id = directId ?? segments[0];
+				return id ? viewset.update(ctx, id) : this.methodNotAllowedResponse();
+			}), options),
+			PUT: this.adapt((ctx) => this.dispatchViewSetAction(viewset, InternalHttpMethod.PUT, ctx, paramKey, (segments, directId) => {
+				const id = directId ?? segments[0];
+				return id ? viewset.update(ctx, id) : this.methodNotAllowedResponse();
+			}), options),
+			DELETE: this.adapt((ctx) => this.dispatchViewSetAction(viewset, InternalHttpMethod.DELETE, ctx, paramKey, (segments, directId) => {
+				const id = directId ?? segments[0];
+				return id ? viewset.destroy(ctx, id) : this.methodNotAllowedResponse();
+			}), options)
+		};
+	}
+	/**
+	* Build Next route handlers from a lazy viewset factory and memoize initialization.
+	* Initialization failures clear the memoized promise so subsequent requests can retry.
+	*/
+	adaptViewSetFactory(factory, options = {}) {
+		return this.adaptRouteHandlersFactory(async () => {
+			const viewset = await factory();
+			return this.adaptViewSet(viewset, options);
+		});
+	}
+	/**
+	* Build Next route handlers from a lazy GenericAPIView factory and memoize initialization.
+	*/
+	adaptGenericAPIViewFactory(factory, options = {}) {
+		return this.adaptRouteHandlersFactory(async () => {
+			const apiView = await factory();
+			return this.adaptGenericAPIView(apiView, options);
+		});
+	}
+	/**
+	* Build Next route handlers that dispatch an APIView by HTTP method.
+	*/
+	adaptAPIView(apiView, options = {}) {
+		return {
+			GET: this.adapt((ctx) => apiView.dispatch(ctx), options),
+			POST: this.adapt((ctx) => apiView.dispatch(ctx), options),
+			PATCH: this.adapt((ctx) => apiView.dispatch(ctx), options),
+			PUT: this.adapt((ctx) => apiView.dispatch(ctx), options),
+			DELETE: this.adapt((ctx) => apiView.dispatch(ctx), options)
+		};
+	}
+	/**
+	* Build handlers for GenericAPIView-style collection/detail splits in catch-all routes.
+	*/
+	adaptGenericAPIView(apiView, options = {}) {
+		const paramKey = options.paramKey ?? "tango";
+		return {
+			GET: this.adapt(async (ctx) => {
+				const detailId = this.resolveDetailId(ctx.params, paramKey);
+				if (!detailId) return apiView.dispatch(ctx);
+				ctx.params.id = detailId;
+				return apiView.dispatch(ctx);
+			}, options),
+			POST: this.adapt(async (ctx) => {
+				const detailId = this.resolveDetailId(ctx.params, paramKey);
+				if (detailId) return this.methodNotAllowedResponse();
+				return apiView.dispatch(ctx);
+			}, options),
+			PATCH: this.adapt(async (ctx) => {
+				const detailId = this.resolveDetailId(ctx.params, paramKey);
+				if (!detailId) return this.methodNotAllowedResponse();
+				ctx.params.id = detailId;
+				return apiView.dispatch(ctx);
+			}, options),
+			PUT: this.adapt(async (ctx) => {
+				const detailId = this.resolveDetailId(ctx.params, paramKey);
+				if (!detailId) return this.methodNotAllowedResponse();
+				ctx.params.id = detailId;
+				return apiView.dispatch(ctx);
+			}, options),
+			DELETE: this.adapt(async (ctx) => {
+				const detailId = this.resolveDetailId(ctx.params, paramKey);
+				if (!detailId) return this.methodNotAllowedResponse();
+				ctx.params.id = detailId;
+				return apiView.dispatch(ctx);
+			}, options)
+		};
+	}
+	toTangoRequest(request) {
+		if (TangoRequest.isTangoRequest(request)) return request;
+		if (request instanceof Request) return new TangoRequest(request);
+		return new TangoRequest(String(request.url ?? "http://localhost"));
+	}
+	dispatchViewSetAction(viewset, method, ctx, paramKey, fallback) {
+		const segments = this.extractCatchAllSegments(ctx.params, paramKey);
+		const directId = this.extractDirectId(ctx.params);
+		const actionMatch = this.resolveActionMatch(viewset, method, segments);
+		if (actionMatch?.kind === InternalActionMatchKind.METHOD_NOT_ALLOWED) return Promise.resolve(this.methodNotAllowedResponse());
+		if (actionMatch?.kind === InternalActionMatchKind.DETAIL) return this.invokeDetailAction(viewset, actionMatch.action, ctx, actionMatch.id);
+		if (actionMatch?.kind === InternalActionMatchKind.COLLECTION) return this.invokeCollectionAction(viewset, actionMatch.action, ctx);
+		return Promise.resolve(fallback(segments, directId));
+	}
+	invokeDetailAction(viewset, action, ctx, id) {
+		const candidate = viewset[action.name];
+		if (typeof candidate !== "function") return Promise.resolve(this.notFoundResponse());
+		return candidate.call(viewset, ctx, id);
+	}
+	invokeCollectionAction(viewset, action, ctx) {
+		const candidate = viewset[action.name];
+		if (typeof candidate !== "function") return Promise.resolve(this.notFoundResponse());
+		return candidate.call(viewset, ctx);
+	}
+	createHandler(handler, options) {
+		return async (request, routeContext) => {
+			try {
+				const user = options.getUser ? await options.getUser(request) : null;
+				const rawParams = routeContext?.params ? await routeContext.params : {};
+				const params = this.normalizeRouteParams(rawParams);
+				const ctx = RequestContext.create(this.toTangoRequest(request), user);
+				if (Object.keys(params).length > 0) ctx.params = params;
+				const id = params?.id;
+				if (id && handler.length > 1) return (await handler(ctx, id)).toWebResponse();
+				return (await handler(ctx)).toWebResponse();
+			} catch (error) {
+				return this.internalServerError(error);
+			}
+		};
+	}
+	internalServerError(error) {
+		this.logger.error("Adapter error:", error);
+		const httpError = HttpErrorFactory.toHttpError(error);
+		return TangoResponse.json(httpError.body, { status: httpError.status }).toWebResponse();
+	}
+	adaptRouteHandlersFactory(factory) {
+		let handlersPromise = null;
+		const getHandlers = async () => {
+			if (!handlersPromise) {
+				const initializing = factory();
+				handlersPromise = initializing.catch((error) => {
+					handlersPromise = null;
+					throw error;
+				});
+			}
+			return handlersPromise;
+		};
+		const createLazyHandler = (method) => {
+			return async (request, context) => {
+				try {
+					const handlers = await getHandlers();
+					return handlers[method](request, context);
+				} catch (error) {
+					return this.internalServerError(error);
+				}
+			};
+		};
+		return {
+			GET: createLazyHandler("GET"),
+			POST: createLazyHandler("POST"),
+			PATCH: createLazyHandler("PATCH"),
+			PUT: createLazyHandler("PUT"),
+			DELETE: createLazyHandler("DELETE")
+		};
+	}
+	resolveDetailId(params, paramKey) {
+		const directId = this.extractDirectId(params);
+		if (directId) return directId;
+		const segments = this.extractCatchAllSegments(params, paramKey);
+		if (segments.length !== 1) return null;
+		return segments[0];
+	}
+	normalizeRouteParams(raw) {
+		const entries = Object.entries(raw).map(([key, value]) => {
+			return [key, Array.isArray(value) ? value.join("/") : value];
+		});
+		return Object.fromEntries(entries);
+	}
+	extractDirectId(params) {
+		const directId = params.id?.trim();
+		return directId || null;
+	}
+	extractCatchAllSegments(params, paramKey) {
+		const catchAll = params[paramKey]?.trim() ?? "";
+		if (!catchAll) return [];
+		return catchAll.split("/").filter(Boolean);
+	}
+	methodNotAllowedResponse() {
+		return TangoResponse.json({ error: "Method not allowed for this route." }, { status: 405 });
+	}
+	notFoundResponse() {
+		return TangoResponse.json({ error: "Not found." }, { status: 404 });
+	}
+	resolveActionMatch(viewset, method, segments) {
+		if (segments.length === 0) return null;
+		const actions = this.getViewSetActions(viewset);
+		if (segments.length >= 2) {
+			const detailPath = segments.slice(1).join("/");
+			const detailMatch = actions.find((action) => action.scope === InternalActionScope.DETAIL && action.path === detailPath);
+			if (detailMatch) return detailMatch.methods.includes(method) ? {
+				kind: InternalActionMatchKind.DETAIL,
+				action: detailMatch,
+				id: segments[0]
+			} : { kind: InternalActionMatchKind.METHOD_NOT_ALLOWED };
+		}
+		if (method === InternalHttpMethod.GET && segments.length === 1) return null;
+		const collectionPath = segments.join("/");
+		const collectionMatch = actions.find((action) => action.scope === InternalActionScope.COLLECTION && action.path === collectionPath);
+		if (!collectionMatch) return null;
+		return collectionMatch.methods.includes(method) ? {
+			kind: InternalActionMatchKind.COLLECTION,
+			action: collectionMatch
+		} : { kind: InternalActionMatchKind.METHOD_NOT_ALLOWED };
+	}
+	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, { NextAdapter: () => NextAdapter });
+
+//#endregion
+export { NextAdapter, adapter_exports };
+//# sourceMappingURL=adapter-_WsZ0kE-.js.map

package/dist/adapter-_WsZ0kE-.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-_WsZ0kE-.js","names":["searchParams: Record<string, string | string[] | undefined>","handler: (ctx: RequestContext, ...args: unknown[]) => Promise<TangoResponse>","options: AdaptNextOptions","viewset: NextCrudViewSet","options: AdaptNextViewSetOptions","factory: NextViewSetFactory","factory: NextAPIViewFactory","apiView: NextAPIView","request: NextRequest","method: HttpMethod","ctx: RequestContext","paramKey: string","fallback: (segments: string[], directId: string | null) => TangoResponse | Promise<TangoResponse>","action: ResolvedViewSetActionDescriptor","id: string","error: unknown","factory: () => Promise<NextViewSetRouteHandlers>","handlersPromise: Promise<NextViewSetRouteHandlers> | null","method: keyof NextViewSetRouteHandlers","params: Record<string, string>","raw: Record<string, string | string[]>","segments: string[]"],"sources":["../src/adapter/NextAdapter.ts","../src/adapter/index.ts"],"sourcesContent":["import type { NextRequest } from 'next/server';\nimport { RequestContext } from '@danceroutine/tango-resources';\nimport {\n    HttpErrorFactory,\n    TangoQueryParams,\n    TangoRequest,\n    TangoResponse,\n    getLogger,\n    type JsonValue,\n} from '@danceroutine/tango-core';\nimport {\n    FRAMEWORK_ADAPTER_BRAND,\n    type FrameworkAdapter,\n    type FrameworkAdapterOptions,\n} from '@danceroutine/tango-adapters-core/adapter';\nimport { InternalHttpMethod, InternalActionScope, InternalActionMatchKind } from '@danceroutine/tango-adapters-core';\n\ntype HttpMethod = (typeof InternalHttpMethod)[keyof typeof InternalHttpMethod];\ntype ActionScope = (typeof InternalActionScope)[keyof typeof InternalActionScope];\n\ntype ResolvedViewSetActionDescriptor = {\n    name: string;\n    scope: ActionScope;\n    methods: readonly HttpMethod[];\n    path: string;\n};\n\n/**\n * Next.js route handler signature produced by the adapter.\n */\nexport type NextRouteHandler = (\n    request: NextRequest,\n    context?: { params?: Promise<Record<string, string | string[]>> }\n) => Promise<Response>;\n\nexport type NextDynamicRouteContext = {\n    params: Promise<Record<string, string | string[]>>;\n};\n\nexport type NextDynamicRouteHandler = (request: NextRequest, context: NextDynamicRouteContext) => Promise<Response>;\n\n/**\n * Adapter options for Next.js integration.\n */\nexport type AdaptNextOptions = FrameworkAdapterOptions<NextRequest>;\n\n/**\n * Minimal CRUD viewset contract used by the Next adapter route helpers.\n */\nexport interface NextCrudViewSet {\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 NextAPIView {\n    dispatch(ctx: RequestContext): Promise<TangoResponse>;\n}\n\nexport type NextViewSetFactory = () => NextCrudViewSet | Promise<NextCrudViewSet>;\nexport type NextAPIViewFactory = () => NextAPIView | Promise<NextAPIView>;\n\n/**\n * Options for auto-generated viewset route handlers.\n */\nexport type AdaptNextViewSetOptions = AdaptNextOptions & {\n    paramKey?: string;\n};\n\n/**\n * HTTP method handlers generated from a CRUD viewset.\n */\nexport interface NextViewSetRouteHandlers {\n    GET: NextDynamicRouteHandler;\n    POST: NextDynamicRouteHandler;\n    PATCH: NextDynamicRouteHandler;\n    PUT: NextDynamicRouteHandler;\n    DELETE: NextDynamicRouteHandler;\n}\n\ntype ActionMatch =\n    | { kind: typeof InternalActionMatchKind.DETAIL; action: ResolvedViewSetActionDescriptor; id: string }\n    | { kind: typeof InternalActionMatchKind.COLLECTION; action: ResolvedViewSetActionDescriptor }\n    | { kind: typeof InternalActionMatchKind.METHOD_NOT_ALLOWED };\n\n/**\n * Next.js adapter that translates route handlers to Tango `RequestContext`.\n */\nexport class NextAdapter implements FrameworkAdapter<Response, NextRouteHandler, NextRequest> {\n    readonly __tangoBrand: typeof FRAMEWORK_ADAPTER_BRAND = FRAMEWORK_ADAPTER_BRAND;\n    private readonly logger = getLogger('tango.adapter.next');\n    /**\n     * Normalize Next.js-style route search params into Tango query params.\n     */\n    toQueryParams(searchParams: Record<string, string | string[] | undefined>): TangoQueryParams {\n        return TangoQueryParams.fromRecord(searchParams);\n    }\n\n    /**\n     * Adapt a Tango-style handler into a Next.js route handler.\n     */\n    adapt(\n        handler: (ctx: RequestContext, ...args: unknown[]) => Promise<TangoResponse>,\n        options: AdaptNextOptions = {}\n    ): NextRouteHandler {\n        return this.createHandler(handler, options);\n    }\n\n    /**\n     * Build Next route handlers that map HTTP verbs to standard CRUD viewset actions.\n     */\n    adaptViewSet(viewset: NextCrudViewSet, options: AdaptNextViewSetOptions = {}): NextViewSetRouteHandlers {\n        const paramKey = options.paramKey ?? 'tango';\n        return {\n            GET: this.adapt(\n                (ctx) =>\n                    this.dispatchViewSetAction(viewset, InternalHttpMethod.GET, ctx, paramKey, (segments, directId) => {\n                        if (directId) return viewset.retrieve(ctx, directId);\n                        if (segments.length === 0) return viewset.list(ctx);\n                        if (segments.length === 1) return viewset.retrieve(ctx, segments[0] as string);\n                        return this.notFoundResponse();\n                    }),\n                options\n            ),\n            POST: this.adapt(\n                (ctx) =>\n                    this.dispatchViewSetAction(\n                        viewset,\n                        InternalHttpMethod.POST,\n                        ctx,\n                        paramKey,\n                        (segments, directId) => {\n                            if (segments.length === 0 && !directId) return viewset.create(ctx);\n                            return this.methodNotAllowedResponse();\n                        }\n                    ),\n                options\n            ),\n            PATCH: this.adapt(\n                (ctx) =>\n                    this.dispatchViewSetAction(\n                        viewset,\n                        InternalHttpMethod.PATCH,\n                        ctx,\n                        paramKey,\n                        (segments, directId) => {\n                            const id = directId ?? segments[0];\n                            return id ? viewset.update(ctx, id) : this.methodNotAllowedResponse();\n                        }\n                    ),\n                options\n            ),\n            PUT: this.adapt(\n                (ctx) =>\n                    this.dispatchViewSetAction(viewset, InternalHttpMethod.PUT, ctx, paramKey, (segments, directId) => {\n                        const id = directId ?? segments[0];\n                        return id ? viewset.update(ctx, id) : this.methodNotAllowedResponse();\n                    }),\n                options\n            ),\n            DELETE: this.adapt(\n                (ctx) =>\n                    this.dispatchViewSetAction(\n                        viewset,\n                        InternalHttpMethod.DELETE,\n                        ctx,\n                        paramKey,\n                        (segments, directId) => {\n                            const id = directId ?? segments[0];\n                            return id ? viewset.destroy(ctx, id) : this.methodNotAllowedResponse();\n                        }\n                    ),\n                options\n            ),\n        };\n    }\n\n    /**\n     * Build Next route handlers from a lazy viewset factory and memoize initialization.\n     * Initialization failures clear the memoized promise so subsequent requests can retry.\n     */\n    adaptViewSetFactory(factory: NextViewSetFactory, options: AdaptNextViewSetOptions = {}): NextViewSetRouteHandlers {\n        return this.adaptRouteHandlersFactory(async () => {\n            const viewset = await factory();\n            return this.adaptViewSet(viewset, options);\n        });\n    }\n\n    /**\n     * Build Next route handlers from a lazy GenericAPIView factory and memoize initialization.\n     */\n    adaptGenericAPIViewFactory(\n        factory: NextAPIViewFactory,\n        options: AdaptNextViewSetOptions = {}\n    ): NextViewSetRouteHandlers {\n        return this.adaptRouteHandlersFactory(async () => {\n            const apiView = await factory();\n            return this.adaptGenericAPIView(apiView, options);\n        });\n    }\n\n    /**\n     * Build Next route handlers that dispatch an APIView by HTTP method.\n     */\n    adaptAPIView(apiView: NextAPIView, options: AdaptNextOptions = {}): NextViewSetRouteHandlers {\n        return {\n            GET: this.adapt((ctx) => apiView.dispatch(ctx), options),\n            POST: this.adapt((ctx) => apiView.dispatch(ctx), options),\n            PATCH: this.adapt((ctx) => apiView.dispatch(ctx), options),\n            PUT: this.adapt((ctx) => apiView.dispatch(ctx), options),\n            DELETE: this.adapt((ctx) => apiView.dispatch(ctx), options),\n        };\n    }\n\n    /**\n     * Build handlers for GenericAPIView-style collection/detail splits in catch-all routes.\n     */\n    adaptGenericAPIView(apiView: NextAPIView, options: AdaptNextViewSetOptions = {}): NextViewSetRouteHandlers {\n        // Default catch-all param matches the Next.js [[...tango]] route convention.\n        const paramKey = options.paramKey ?? 'tango';\n        return {\n            GET: this.adapt(async (ctx) => {\n                const detailId = this.resolveDetailId(ctx.params, paramKey);\n                if (!detailId) {\n                    return apiView.dispatch(ctx);\n                }\n                ctx.params.id = detailId;\n                return apiView.dispatch(ctx);\n            }, options),\n            POST: this.adapt(async (ctx) => {\n                const detailId = this.resolveDetailId(ctx.params, paramKey);\n                if (detailId) {\n                    return this.methodNotAllowedResponse();\n                }\n                return apiView.dispatch(ctx);\n            }, options),\n            PATCH: this.adapt(async (ctx) => {\n                const detailId = this.resolveDetailId(ctx.params, paramKey);\n                if (!detailId) {\n                    return this.methodNotAllowedResponse();\n                }\n                ctx.params.id = detailId;\n                return apiView.dispatch(ctx);\n            }, options),\n            PUT: this.adapt(async (ctx) => {\n                const detailId = this.resolveDetailId(ctx.params, paramKey);\n                if (!detailId) {\n                    return this.methodNotAllowedResponse();\n                }\n                ctx.params.id = detailId;\n                return apiView.dispatch(ctx);\n            }, options),\n            DELETE: this.adapt(async (ctx) => {\n                const detailId = this.resolveDetailId(ctx.params, paramKey);\n                if (!detailId) {\n                    return this.methodNotAllowedResponse();\n                }\n                ctx.params.id = detailId;\n                return apiView.dispatch(ctx);\n            }, options),\n        };\n    }\n\n    private toTangoRequest(request: NextRequest): TangoRequest {\n        if (TangoRequest.isTangoRequest(request)) {\n            return request;\n        }\n\n        // oxlint-disable-next-line eslint-js/no-restricted-syntax\n        if (request instanceof Request) {\n            return new TangoRequest(request);\n        }\n\n        return new TangoRequest(String((request as { url?: unknown }).url ?? 'http://localhost'));\n    }\n\n    private dispatchViewSetAction(\n        viewset: NextCrudViewSet,\n        method: HttpMethod,\n        ctx: RequestContext,\n        paramKey: string,\n        fallback: (segments: string[], directId: string | null) => TangoResponse | Promise<TangoResponse>\n    ): Promise<TangoResponse> {\n        const segments = this.extractCatchAllSegments(ctx.params, paramKey);\n        const directId = this.extractDirectId(ctx.params);\n        const actionMatch = this.resolveActionMatch(viewset, method, segments);\n\n        if (actionMatch?.kind === InternalActionMatchKind.METHOD_NOT_ALLOWED) {\n            return Promise.resolve(this.methodNotAllowedResponse());\n        }\n        if (actionMatch?.kind === InternalActionMatchKind.DETAIL) {\n            return this.invokeDetailAction(viewset, actionMatch.action, ctx, actionMatch.id);\n        }\n        if (actionMatch?.kind === InternalActionMatchKind.COLLECTION) {\n            return this.invokeCollectionAction(viewset, actionMatch.action, ctx);\n        }\n\n        return Promise.resolve(fallback(segments, directId));\n    }\n\n    private invokeDetailAction(\n        viewset: NextCrudViewSet,\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            return Promise.resolve(this.notFoundResponse());\n        }\n        return (candidate as (this: NextCrudViewSet, ctx: RequestContext, id: string) => Promise<TangoResponse>).call(\n            viewset,\n            ctx,\n            id\n        );\n    }\n\n    private invokeCollectionAction(\n        viewset: NextCrudViewSet,\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            return Promise.resolve(this.notFoundResponse());\n        }\n        return (candidate as (this: NextCrudViewSet, ctx: RequestContext) => Promise<TangoResponse>).call(viewset, ctx);\n    }\n\n    private createHandler(\n        handler: (ctx: RequestContext, ...args: unknown[]) => Promise<TangoResponse>,\n        options: AdaptNextOptions\n    ): NextRouteHandler {\n        return async (request: NextRequest, routeContext) => {\n            try {\n                const user = options.getUser ? await options.getUser(request) : null;\n                const rawParams = routeContext?.params ? await routeContext.params : {};\n                const params = this.normalizeRouteParams(rawParams);\n\n                const ctx = RequestContext.create(this.toTangoRequest(request), user);\n                if (Object.keys(params).length > 0) {\n                    ctx.params = params;\n                }\n\n                const id = params?.id;\n                if (id && handler.length > 1) {\n                    return (await handler(ctx, id)).toWebResponse();\n                }\n\n                return (await handler(ctx)).toWebResponse();\n            } catch (error) {\n                return this.internalServerError(error);\n            }\n        };\n    }\n\n    private internalServerError(error: unknown): Response {\n        this.logger.error('Adapter error:', error);\n        const httpError = HttpErrorFactory.toHttpError(error);\n        return TangoResponse.json(httpError.body as JsonValue, { status: httpError.status }).toWebResponse();\n    }\n\n    private adaptRouteHandlersFactory(factory: () => Promise<NextViewSetRouteHandlers>): NextViewSetRouteHandlers {\n        let handlersPromise: Promise<NextViewSetRouteHandlers> | null = null;\n\n        const getHandlers = async (): Promise<NextViewSetRouteHandlers> => {\n            if (!handlersPromise) {\n                const initializing = factory();\n                handlersPromise = initializing.catch((error) => {\n                    handlersPromise = null;\n                    throw error;\n                });\n            }\n            return handlersPromise;\n        };\n\n        const createLazyHandler = (method: keyof NextViewSetRouteHandlers): NextDynamicRouteHandler => {\n            return async (request, context) => {\n                try {\n                    const handlers = await getHandlers();\n                    return handlers[method](request, context);\n                } catch (error) {\n                    return this.internalServerError(error);\n                }\n            };\n        };\n\n        return {\n            GET: createLazyHandler('GET'),\n            POST: createLazyHandler('POST'),\n            PATCH: createLazyHandler('PATCH'),\n            PUT: createLazyHandler('PUT'),\n            DELETE: createLazyHandler('DELETE'),\n        };\n    }\n\n    private resolveDetailId(params: Record<string, string>, paramKey: string): string | null {\n        const directId = this.extractDirectId(params);\n        if (directId) {\n            return directId;\n        }\n        const segments = this.extractCatchAllSegments(params, paramKey);\n        if (segments.length !== 1) {\n            return null;\n        }\n        return segments[0] as string;\n    }\n\n    private normalizeRouteParams(raw: Record<string, string | string[]>): Record<string, string> {\n        const entries = Object.entries(raw).map(([key, value]) => {\n            return [key, Array.isArray(value) ? value.join('/') : value];\n        });\n\n        return Object.fromEntries(entries);\n    }\n\n    private extractDirectId(params: Record<string, string>): string | null {\n        const directId = params.id?.trim();\n        return directId || null;\n    }\n\n    private extractCatchAllSegments(params: Record<string, string>, paramKey: string): string[] {\n        const catchAll = params[paramKey]?.trim() ?? '';\n        if (!catchAll) {\n            return [];\n        }\n        return catchAll.split('/').filter(Boolean);\n    }\n\n    private methodNotAllowedResponse(): TangoResponse {\n        return TangoResponse.json(\n            {\n                error: 'Method not allowed for this route.',\n            },\n            { status: 405 }\n        );\n    }\n\n    private notFoundResponse(): TangoResponse {\n        return TangoResponse.json(\n            {\n                error: 'Not found.',\n            },\n            { status: 404 }\n        );\n    }\n\n    private resolveActionMatch(viewset: NextCrudViewSet, method: HttpMethod, segments: string[]): ActionMatch | null {\n        if (segments.length === 0) {\n            return null;\n        }\n\n        const actions = this.getViewSetActions(viewset);\n\n        if (segments.length >= 2) {\n            const detailPath = segments.slice(1).join('/');\n            const detailMatch = actions.find(\n                (action) => action.scope === InternalActionScope.DETAIL && action.path === detailPath\n            );\n            if (detailMatch) {\n                return detailMatch.methods.includes(method)\n                    ? { kind: InternalActionMatchKind.DETAIL, action: detailMatch, id: segments[0] as string }\n                    : { kind: InternalActionMatchKind.METHOD_NOT_ALLOWED };\n            }\n        }\n\n        if (method === InternalHttpMethod.GET && segments.length === 1) {\n            return null;\n        }\n\n        const collectionPath = segments.join('/');\n        const collectionMatch = actions.find(\n            (action) => action.scope === InternalActionScope.COLLECTION && action.path === collectionPath\n        );\n        if (!collectionMatch) {\n            return null;\n        }\n        return collectionMatch.methods.includes(method)\n            ? { kind: InternalActionMatchKind.COLLECTION, action: collectionMatch }\n            : { kind: InternalActionMatchKind.METHOD_NOT_ALLOWED };\n    }\n\n    private getViewSetActions(viewset: NextCrudViewSet): readonly ResolvedViewSetActionDescriptor[] {\n        const constructorValue = viewset.constructor as {\n            getActions?: (input: NextCrudViewSet) => 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    NextAdapter,\n    type AdaptNextOptions,\n    type AdaptNextViewSetOptions,\n    type NextAPIView,\n    type NextAPIViewFactory,\n    type NextCrudViewSet,\n    type NextDynamicRouteContext,\n    type NextDynamicRouteHandler,\n    type NextRouteHandler,\n    type NextViewSetFactory,\n    type NextViewSetRouteHandlers,\n} from './NextAdapter';\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 { NextAdapter, type AdaptNextOptions, type NextRouteHandler } from './adapter/index';
+export { NextAdapter, type AdaptNextOptions, type AdaptNextViewSetOptions, type NextAPIView, type NextAPIViewFactory, type NextCrudViewSet, type NextDynamicRouteContext, type NextDynamicRouteHandler, type NextRouteHandler, type NextViewSetFactory, type NextViewSetRouteHandlers, } from './adapter/index';

package/dist/index.js

@@ -1,3 +1,3 @@
-import { NextAdapter, adapter_exports } from "./adapter-BtnGpM5G.js";
+import { NextAdapter, adapter_exports } from "./adapter-_WsZ0kE-.js";
 
 export { NextAdapter, adapter_exports as adapter };

package/package.json

@@ -1,54 +1,57 @@
 {
-    "name": "@danceroutine/tango-adapters-next",
-    "version": "0.1.0",
-    "description": "Next.js App Router adapter for Tango viewsets",
-    "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-next",
+  "version": "1.0.0",
+  "description": "Next.js App Router adapter for Tango viewsets",
+  "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",
-        "next",
-        "nextjs",
-        "adapter"
-    ],
-    "author": "Pedro Del Moral Lopez",
-    "license": "MIT",
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/danceroutine/tango.git",
-        "directory": "packages/adapters/next"
-    },
-    "dependencies": {
-        "@danceroutine/tango-resources": "workspace:*",
-        "@danceroutine/tango-adapters-core": "workspace:*"
-    },
-    "peerDependencies": {
-        "next": "^15.0.0"
-    },
-    "devDependencies": {
-        "@types/node": "^22.9.0",
-        "next": "^15.0.3",
-        "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",
+    "next",
+    "nextjs",
+    "adapter"
+  ],
+  "author": "Pedro Del Moral Lopez",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/danceroutine/tango.git",
+    "directory": "packages/adapters/next"
+  },
+  "dependencies": {
+    "@danceroutine/tango-core": "1.0.0",
+    "@danceroutine/tango-resources": "1.0.0",
+    "@danceroutine/tango-adapters-core": "1.0.0"
+  },
+  "peerDependencies": {
+    "next": "^15.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.9.0",
+    "next": "^15.0.3",
+    "tsdown": "^0.4.0",
+    "typescript": "^5.6.3",
+    "vitest": "^4.0.6"
+  },
+  "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/NextAdapter.js

@@ -1,31 +0,0 @@
-import { NextResponse } from 'next/server';
-import { RequestContext } from '@danceroutine/tango-resources';
-export class NextAdapter {
-    adapt(handler, options = {}) {
-        return this.createHandler(handler, options);
-    }
-    createHandler(handler, options) {
-        return async (request, routeContext) => {
-            try {
-                const user = options.getUser ? await options.getUser(request) : null;
-                const params = routeContext?.params ? await routeContext.params : undefined;
-                const ctx = RequestContext.create(request, user);
-                if (params) {
-                    ctx.params = params;
-                }
-                const id = params?.id;
-                if (id && handler.length > 1) {
-                    return await handler(ctx, id);
-                }
-                return await handler(ctx);
-            }
-            catch (error) {
-                console.error('Adapter error:', error);
-                return new NextResponse(JSON.stringify({ error: 'Internal Server Error' }), {
-                    status: 500,
-                    headers: { 'Content-Type': 'application/json' },
-                });
-            }
-        };
-    }
-}

package/dist/adapter-BtnGpM5G.js

@@ -1,47 +0,0 @@
-import { NextResponse } from "next/server";
-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/NextAdapter.ts
-var NextAdapter = class {
-	adapt(handler, options = {}) {
-		return this.createHandler(handler, options);
-	}
-	createHandler(handler, options) {
-		return async (request, routeContext) => {
-			try {
-				const user = options.getUser ? await options.getUser(request) : null;
-				const params = routeContext?.params ? await routeContext.params : undefined;
-				const ctx = RequestContext.create(request, user);
-				if (params) ctx.params = params;
-				const id = params?.id;
-				if (id && handler.length > 1) return await handler(ctx, id);
-				return await handler(ctx);
-			} catch (error) {
-				console.error("Adapter error:", error);
-				return new NextResponse(JSON.stringify({ error: "Internal Server Error" }), {
-					status: 500,
-					headers: { "Content-Type": "application/json" }
-				});
-			}
-		};
-	}
-};
-
-//#endregion
-//#region src/adapter/index.ts
-var adapter_exports = {};
-__export(adapter_exports, { NextAdapter: () => NextAdapter });
-
-//#endregion
-export { NextAdapter, adapter_exports };
-//# sourceMappingURL=adapter-BtnGpM5G.js.map

package/dist/adapter-BtnGpM5G.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter-BtnGpM5G.js","names":["handler: (ctx: RequestContext, ...args: unknown[]) => Promise<NextResponse>","options: AdaptNextOptions","request: NextRequest"],"sources":["../src/adapter/NextAdapter.ts","../src/adapter/index.ts"],"sourcesContent":["import type { NextRequest } from 'next/server';\nimport { NextResponse } from 'next/server';\nimport { RequestContext } from '@danceroutine/tango-resources';\nimport type { FrameworkAdapter, FrameworkAdapterOptions } from '@danceroutine/tango-adapters-core/adapter';\n\nexport type NextRouteHandler = (\n    request: NextRequest,\n    context: { params?: Promise<Record<string, string>> }\n) => Promise<NextResponse>;\n\nexport interface AdaptNextOptions extends FrameworkAdapterOptions<NextRequest> {}\n\nexport class NextAdapter implements FrameworkAdapter<NextResponse, NextRouteHandler, NextRequest> {\n    adapt(\n        handler: (ctx: RequestContext, ...args: unknown[]) => Promise<NextResponse>,\n        options: AdaptNextOptions = {}\n    ): NextRouteHandler {\n        return this.createHandler(handler, options);\n    }\n\n    private createHandler(\n        handler: (ctx: RequestContext, ...args: unknown[]) => Promise<NextResponse>,\n        options: AdaptNextOptions\n    ): NextRouteHandler {\n        return async (request: NextRequest, routeContext) => {\n            try {\n                const user = options.getUser ? await options.getUser(request) : null;\n\n                const params = routeContext?.params ? await routeContext.params : undefined;\n\n                const ctx = RequestContext.create(request, user);\n                if (params) {\n                    ctx.params = params;\n                }\n\n                const id = params?.id;\n                if (id && handler.length > 1) {\n                    return await handler(ctx, id);\n                }\n\n                return await handler(ctx);\n            } catch (error) {\n                console.error('Adapter error:', error);\n                return new NextResponse(JSON.stringify({ error: 'Internal Server Error' }), {\n                    status: 500,\n                    headers: { 'Content-Type': 'application/json' },\n                });\n            }\n        };\n    }\n}\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { NextAdapter, type AdaptNextOptions, type NextRouteHandler } from './NextAdapter';\n"],"mappings":";;;;;;;;;;;;;;IAYa,cAAN,MAA2F;CAC9F,MACIA,SACAC,UAA4B,CAAE,GACd;AAChB,SAAO,KAAK,cAAc,SAAS,QAAQ;CAC9C;CAED,cACID,SACAC,SACgB;AAChB,SAAO,OAAOC,SAAsB,iBAAiB;AACjD,OAAI;IACA,MAAM,OAAO,QAAQ,UAAU,MAAM,QAAQ,QAAQ,QAAQ,GAAG;IAEhE,MAAM,SAAS,cAAc,SAAS,MAAM,aAAa,SAAS;IAElE,MAAM,MAAM,eAAe,OAAO,SAAS,KAAK;AAChD,QAAI,OACA,KAAI,SAAS;IAGjB,MAAM,KAAK,QAAQ;AACnB,QAAI,MAAM,QAAQ,SAAS,EACvB,QAAO,MAAM,QAAQ,KAAK,GAAG;AAGjC,WAAO,MAAM,QAAQ,IAAI;GAC5B,SAAQ,OAAO;AACZ,YAAQ,MAAM,kBAAkB,MAAM;AACtC,WAAO,IAAI,aAAa,KAAK,UAAU,EAAE,OAAO,wBAAyB,EAAC,EAAE;KACxE,QAAQ;KACR,SAAS,EAAE,gBAAgB,mBAAoB;IAClD;GACJ;EACJ;CACJ;AACJ"}