@danceroutine/tango-resources 1.11.2 → 1.11.4

package/dist/{view-C9B5Lln3.js → view-CYdJAO4t.js}

@@ -1,316 +1,9 @@
 import { t as __exportAll } from "./chunk-D7D4PA-g.js";
-import { HttpErrorFactory, NotFoundError, TangoRequest, TangoResponse } from "@danceroutine/tango-core";
-import { Q, QueryResult } from "@danceroutine/tango-orm";
-import { z } from "zod";
-//#region src/context/RequestContext.ts
-/**
-* Normalized request context passed through the framework adapter into viewset methods.
-* Generic over the user type so consumers can plug in their own auth infrastructure.
-*/
-var RequestContext = class RequestContext {
-	request;
-	user;
-	params;
-	static BRAND = "tango.resources.request_context";
-	__tangoBrand = RequestContext.BRAND;
-	state = /* @__PURE__ */ new Map();
-	constructor(request, user = null, params = {}) {
-		this.request = request;
-		this.user = user;
-		this.params = params;
-	}
-	/**
-	* Narrow an unknown value to `RequestContext`.
-	*/
-	static isRequestContext(value) {
-		return typeof value === "object" && value !== null && value.__tangoBrand === RequestContext.BRAND;
-	}
-	/**
-	* Construct a context with optional user payload.
-	*/
-	static create(request, user) {
-		return new RequestContext(TangoRequest.isTangoRequest(request) ? request : new TangoRequest(request), user ?? null);
-	}
-	/**
-	* Store arbitrary per-request state for downstream middleware/handlers.
-	*/
-	setState(key, value) {
-		this.state.set(key, value);
-	}
-	/**
-	* Retrieve previously stored request state.
-	*/
-	getState(key) {
-		return this.state.get(key);
-	}
-	/**
-	* Check whether a state key has been set.
-	*/
-	hasState(key) {
-		return this.state.has(key);
-	}
-	/**
-	* Clone the context, including route params and request-local state.
-	*/
-	clone() {
-		const cloned = new RequestContext(this.request, this.user, { ...this.params });
-		cloned.state = new Map(this.state);
-		return cloned;
-	}
-};
-//#endregion
-//#region src/context/index.ts
-var context_exports = /* @__PURE__ */ __exportAll({ RequestContext: () => RequestContext });
-//#endregion
-//#region src/pagination/BasePaginator.ts
-var BasePaginator = class {
-	resolveQueryResultRows(rows) {
-		if (QueryResult.isQueryResult(rows)) return rows.toArray();
-		return [...rows];
-	}
-};
-//#endregion
-//#region src/pagination/OffsetPaginationInput.ts
-const OffsetPaginationInput = z.object({
-	limit: z.coerce.number().int().min(1).default(25).transform((value) => Math.min(value, 100)),
-	offset: z.coerce.number().int().min(0).default(0),
-	page: z.coerce.number().int().min(1).optional()
-});
-//#endregion
-//#region src/paginators/OffsetPaginator.ts
-var OffsetPage = class OffsetPage {
-	results;
-	pageNumber;
-	perPage;
-	totalCount;
-	static BRAND = "tango.resources.offset_page";
-	__tangoBrand = OffsetPage.BRAND;
-	constructor(results, pageNumber, perPage, totalCount) {
-		this.results = results;
-		this.pageNumber = pageNumber;
-		this.perPage = perPage;
-		this.totalCount = totalCount;
-	}
-	static isOffsetPage(value) {
-		return typeof value === "object" && value !== null && value.__tangoBrand === OffsetPage.BRAND;
-	}
-	/** Whether a next page exists based on known total count. */
-	hasNext() {
-		if (this.totalCount === void 0) return false;
-		return this.endIndex() < this.totalCount;
-	}
-	/** Whether a previous page exists. */
-	hasPrevious() {
-		return this.pageNumber > 1;
-	}
-	/** The next page number, if available. */
-	nextPageNumber() {
-		return this.hasNext() ? this.pageNumber + 1 : null;
-	}
-	/** The previous page number, if available. */
-	previousPageNumber() {
-		return this.hasPrevious() ? this.pageNumber - 1 : null;
-	}
-	/** Zero-based start index of this page in the full result set. */
-	startIndex() {
-		return (this.pageNumber - 1) * this.perPage;
-	}
-	/** Exclusive end index of this page in the full result set. */
-	endIndex() {
-		return this.startIndex() + this.results.length;
-	}
-};
-/**
-* Offset/limit paginator modelled after DRF's LimitOffsetPagination.
-* Handles parsing limit/offset/page from URL query params and building
-* the paginated response envelope with next/previous links.
-*
-* @example
-* ```typescript
-* const paginator = new OffsetPaginator(queryset);
-* const { limit, offset } = paginator.parseParams(searchParams);
-* const results = await queryset.limit(limit).offset(offset).fetchAll();
-* const response = paginator.getPaginatedResponse(results, totalCount);
-* ```
-*/
-var OffsetPaginator = class OffsetPaginator extends BasePaginator {
-	queryset;
-	perPage;
-	static BRAND = "tango.resources.offset_paginator";
-	__tangoBrand = OffsetPaginator.BRAND;
-	limit = 25;
-	offset = 0;
-	constructor(queryset, perPage = 25) {
-		super();
-		this.queryset = queryset;
-		this.perPage = perPage;
-		this.limit = perPage;
-	}
-	/**
-	* Narrow an unknown value to `OffsetPaginator`.
-	*/
-	static isOffsetPaginator(value) {
-		return typeof value === "object" && value !== null && value.__tangoBrand === OffsetPaginator.BRAND;
-	}
-	/**
-	* Parse limit, offset, and page from Tango query params.
-	* If `page` is provided, it's converted to an offset.
-	* Stores parsed values for use by getPaginatedResponse.
-	*/
-	parse(params) {
-		const input = {
-			limit: params.get("limit") ?? void 0,
-			offset: params.get("offset") ?? void 0,
-			page: params.get("page") ?? void 0
-		};
-		const parsed = OffsetPaginationInput.parse(input);
-		if (parsed.page) parsed.offset = (parsed.page - 1) * parsed.limit;
-		this.limit = parsed.limit;
-		this.offset = parsed.offset;
-	}
-	/**
-	* Parse params and return `{ limit, offset }` for compatibility callers.
-	*/
-	parseParams(params) {
-		this.parse(params);
-		return {
-			limit: this.limit,
-			offset: this.offset
-		};
-	}
-	/**
-	* Build a DRF-style paginated response with count, next, and previous links.
-	* Uses the limit/offset stored from the most recent parseParams call.
-	*/
-	needsTotalCount() {
-		return true;
-	}
-	toResponse(results, context) {
-		const totalCount = context?.totalCount;
-		const response = { results: this.resolveQueryResultRows(results) };
-		if (totalCount !== void 0) {
-			response.count = totalCount;
-			if (this.offset + this.limit < totalCount) response.next = this.buildPageLink(this.offset + this.limit, context?.params);
-			if (this.offset > 0) {
-				const prevOffset = Math.max(0, this.offset - this.limit);
-				response.previous = this.buildPageLink(prevOffset, context?.params);
-			}
-		}
-		return response;
-	}
-	/**
-	* Backward-compatible alias for `toResponse`.
-	*/
-	getPaginatedResponse(results, totalCount, params) {
-		return this.toResponse(results, {
-			totalCount,
-			params
-		});
-	}
-	/**
-	* Apply current limit/offset to a queryset.
-	*/
-	apply(queryset) {
-		return queryset.limit(this.limit).offset(this.offset);
-	}
-	/**
-	* Fetch a 1-based page number from the bound queryset.
-	*/
-	async paginate(page) {
-		return this.getPage(page);
-	}
-	/**
-	* Fetch a 1-based page and return page metadata.
-	*/
-	async getPage(page) {
-		const offset = (page - 1) * this.perPage;
-		const results = await this.queryset.offset(offset).limit(this.perPage).fetch();
-		const totalCount = await this.count();
-		return new OffsetPage(this.resolveQueryResultRows(results), page, this.perPage, totalCount);
-	}
-	/**
-	* Count total rows for the current queryset state.
-	*/
-	async count() {
-		return this.queryset.count();
-	}
-	buildPageLink(offset, params) {
-		if (!params) return `?limit=${this.limit}&offset=${offset}`;
-		return params.withValues({
-			limit: this.limit,
-			offset,
-			page: null
-		}).toRelativeURL();
-	}
-};
-//#endregion
-//#region src/filters/inferModelFieldParsers.ts
-function normalizeParserTokens(raw) {
-	const normalized = (Array.isArray(raw) ? raw : String(raw).split(",")).map((value) => value.trim());
-	return normalized.every((value) => value.length > 0) ? normalized : [];
-}
-function createBooleanParser() {
-	return (raw) => {
-		const values = normalizeParserTokens(raw);
-		if (values.length === 0) return;
-		const parsed = values.map((value) => {
-			const normalized = value.toLowerCase();
-			if (normalized === "true" || normalized === "1") return true;
-			if (normalized === "false" || normalized === "0") return false;
-			return null;
-		});
-		if (parsed.some((value) => value === null)) return;
-		return parsed.length === 1 ? parsed[0] : parsed;
-	};
-}
-function createIntegerParser() {
-	return (raw) => {
-		const values = normalizeParserTokens(raw);
-		if (values.length === 0) return;
-		const parsed = values.map(Number);
-		if (parsed.some((value) => !Number.isInteger(value))) return;
-		return parsed.length === 1 ? parsed[0] : parsed;
-	};
-}
-function createTimestampParser() {
-	return (raw) => {
-		const values = normalizeParserTokens(raw);
-		if (values.length === 0) return;
-		const parsed = values.map((value) => {
-			const date = new Date(value);
-			return Number.isNaN(date.getTime()) ? null : date;
-		});
-		if (parsed.some((value) => value === null)) return;
-		return parsed.length === 1 ? parsed[0] : parsed;
-	};
-}
-/**
-* Infer resource-level query-value parsers from Tango model metadata.
-*
-* Parsers are inferred conservatively from field metadata so HTTP query filters
-* can be coerced into typed ORM inputs without framework-specific glue.
-*/
-function inferModelFieldParsers(model) {
-	const metadata = model.metadata;
-	if (!metadata) return {};
-	const parsers = {};
-	for (const field of metadata.fields) switch (field.type) {
-		case "bool":
-			parsers[field.name] = createBooleanParser();
-			break;
-		case "serial":
-		case "int":
-		case "bigint":
-			parsers[field.name] = createIntegerParser();
-			break;
-		case "timestamptz":
-			parsers[field.name] = createTimestampParser();
-			break;
-		default: break;
-	}
-	return parsers;
-}
-//#endregion
+import "./context-euBQvNRT.js";
+import { t as OffsetPaginator } from "./OffsetPaginator-CaycvxJU.js";
+import { t as inferModelFieldParsers } from "./inferModelFieldParsers-2irv7j1T.js";
+import { HttpErrorFactory, NotFoundError, TangoResponse } from "@danceroutine/tango-core";
+import { Q } from "@danceroutine/tango-orm";
 //#region src/view/APIView.ts
 /**
 * Lightweight class-based request dispatcher for non-model API endpoints.
@@ -725,6 +418,6 @@ var view_exports = /* @__PURE__ */ __exportAll({
 	UpdateModelMixin: () => UpdateModelMixin
 });
 //#endregion
-export { OffsetPaginator as _, ListCreateAPIView as a, context_exports as b, ListAPIView as c, RetrieveModelMixin as d, CreateModelMixin as f, inferModelFieldParsers as g, APIView as h, RetrieveUpdateAPIView as i, DestroyModelMixin as l, GenericAPIView as m, RetrieveUpdateDestroyAPIView as n, RetrieveAPIView as o, ListModelMixin as p, RetrieveDestroyAPIView as r, CreateAPIView as s, view_exports as t, UpdateModelMixin as u, OffsetPaginationInput as v, RequestContext as x, BasePaginator as y };
+export { ListCreateAPIView as a, ListAPIView as c, RetrieveModelMixin as d, CreateModelMixin as f, APIView as h, RetrieveUpdateAPIView as i, DestroyModelMixin as l, GenericAPIView as m, RetrieveUpdateDestroyAPIView as n, RetrieveAPIView as o, ListModelMixin as p, RetrieveDestroyAPIView as r, CreateAPIView as s, view_exports as t, UpdateModelMixin as u };
 
-//# sourceMappingURL=view-C9B5Lln3.js.map
+//# sourceMappingURL=view-CYdJAO4t.js.map

package/dist/view-CYdJAO4t.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-CYdJAO4t.js","names":[],"sources":["../src/view/APIView.ts","../src/view/GenericAPIView.ts","../src/view/mixins/ListModelMixin.ts","../src/view/mixins/CreateModelMixin.ts","../src/view/mixins/RetrieveModelMixin.ts","../src/view/mixins/UpdateModelMixin.ts","../src/view/mixins/DestroyModelMixin.ts","../src/view/generics/ListAPIView.ts","../src/view/generics/CreateAPIView.ts","../src/view/generics/RetrieveAPIView.ts","../src/view/generics/ListCreateAPIView.ts","../src/view/generics/RetrieveUpdateAPIView.ts","../src/view/generics/RetrieveDestroyAPIView.ts","../src/view/generics/RetrieveUpdateDestroyAPIView.ts","../src/view/index.ts"],"sourcesContent":["import { TangoResponse } from '@danceroutine/tango-core';\nimport { RequestContext } from '../context/index';\n\nexport type APIViewMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';\n\ntype APIViewMethodHandler = (ctx: RequestContext) => Promise<TangoResponse>;\n\n/**\n * Lightweight class-based request dispatcher for non-model API endpoints.\n */\nexport abstract class APIView {\n    static readonly BRAND = 'tango.resources.api_view' as const;\n    readonly __tangoBrand: typeof APIView.BRAND = APIView.BRAND;\n\n    /**\n     * Narrow an unknown value to `APIView`.\n     */\n    static isAPIView(value: unknown): value is APIView {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === APIView.BRAND\n        );\n    }\n\n    /**\n     * Dispatch the request to the handler for the current HTTP method.\n     */\n    async dispatch(ctx: RequestContext): Promise<TangoResponse> {\n        const method = normalizeMethod(ctx.request.method);\n        if (!method) {\n            return this.httpMethodNotAllowed();\n        }\n\n        const handler = this.getMethodHandler(method);\n        return handler(ctx);\n    }\n\n    getAllowedMethods(): readonly APIViewMethod[] {\n        const allowed: APIViewMethod[] = [];\n        if (this.get !== APIView.prototype.get) {\n            allowed.push('GET');\n        }\n        if (this.post !== APIView.prototype.post) {\n            allowed.push('POST');\n        }\n        if (this.put !== APIView.prototype.put) {\n            allowed.push('PUT');\n        }\n        if (this.patch !== APIView.prototype.patch) {\n            allowed.push('PATCH');\n        }\n        if (this.delete !== APIView.prototype.delete) {\n            allowed.push('DELETE');\n        }\n        return allowed;\n    }\n\n    protected get(_ctx: RequestContext): Promise<TangoResponse> {\n        return Promise.resolve(this.httpMethodNotAllowed());\n    }\n\n    protected post(_ctx: RequestContext): Promise<TangoResponse> {\n        return Promise.resolve(this.httpMethodNotAllowed());\n    }\n\n    protected put(_ctx: RequestContext): Promise<TangoResponse> {\n        return Promise.resolve(this.httpMethodNotAllowed());\n    }\n\n    protected patch(_ctx: RequestContext): Promise<TangoResponse> {\n        return Promise.resolve(this.httpMethodNotAllowed());\n    }\n\n    protected delete(_ctx: RequestContext): Promise<TangoResponse> {\n        return Promise.resolve(this.httpMethodNotAllowed());\n    }\n\n    protected httpMethodNotAllowed(): TangoResponse {\n        return TangoResponse.methodNotAllowed(this.getAllowedMethods());\n    }\n\n    private getMethodHandler(method: APIViewMethod): APIViewMethodHandler {\n        if (method === 'GET') {\n            return (ctx) => this.get(ctx);\n        }\n        if (method === 'POST') {\n            return (ctx) => this.post(ctx);\n        }\n        if (method === 'PUT') {\n            return (ctx) => this.put(ctx);\n        }\n        if (method === 'PATCH') {\n            return (ctx) => this.patch(ctx);\n        }\n        return (ctx) => this.delete(ctx);\n    }\n}\n\nfunction normalizeMethod(method: string): APIViewMethod | null {\n    const upper = method.toUpperCase();\n    if (upper === 'GET') {\n        return 'GET';\n    }\n    if (upper === 'POST') {\n        return 'POST';\n    }\n    if (upper === 'PUT') {\n        return 'PUT';\n    }\n    if (upper === 'PATCH') {\n        return 'PATCH';\n    }\n    if (upper === 'DELETE') {\n        return 'DELETE';\n    }\n    return null;\n}\n","import { HttpErrorFactory, TangoResponse, type JsonValue, NotFoundError } from '@danceroutine/tango-core';\nimport { Q, type FilterInput, type ManagerLike, type QuerySet } from '@danceroutine/tango-orm';\nimport type { OffsetPaginatedResponse, Paginator } from '../pagination/index';\nimport { OffsetPaginator } from '../paginators/OffsetPaginator';\nimport { APIView } from './APIView';\nimport { RequestContext } from '../context/index';\nimport type { FilterSet } from '../filters/index';\nimport { inferModelFieldParsers } from '../filters/inferModelFieldParsers';\nimport type { GenericAPIViewOpenAPIDescription } from '../resource/index';\nimport type { AnyModelSerializer, SerializerOutput } from '../serializer/index';\nimport type { ResourceModelLike } from '../resource/index';\n\ntype SearchFieldRef<TModel extends Record<string, unknown>> = Extract<keyof TModel, string> | string;\n\nexport interface GenericAPIViewConfig<\n    TModel extends Record<string, unknown>,\n    TSerializer extends AnyModelSerializer<TModel>,\n> {\n    serializer: TSerializer;\n    filters?: FilterSet<TModel>;\n    orderingFields?: (keyof TModel)[];\n    searchFields?: SearchFieldRef<TModel>[];\n    lookupField?: keyof TModel;\n    lookupParam?: string;\n    paginatorFactory?: (queryset: QuerySet<TModel>) => Paginator<TModel, SerializerOutput<TSerializer>>;\n}\n\n/**\n * Generic API base class that centralizes query/build/validation helpers.\n */\nexport abstract class GenericAPIView<\n    TModel extends Record<string, unknown>,\n    TSerializer extends AnyModelSerializer<TModel>,\n> extends APIView {\n    protected readonly serializerClass: TSerializer;\n    protected readonly filters?: FilterSet<TModel>;\n    protected readonly orderingFields: readonly (keyof TModel)[];\n    protected readonly searchFields: readonly SearchFieldRef<TModel>[];\n    protected readonly lookupField?: keyof TModel;\n    protected readonly lookupParam: string;\n    protected readonly paginatorFactory?: (\n        queryset: QuerySet<TModel>\n    ) => Paginator<TModel, SerializerOutput<TSerializer>>;\n    private serializer?: InstanceType<TSerializer>;\n\n    constructor(config: GenericAPIViewConfig<TModel, TSerializer>) {\n        super();\n        this.serializerClass = config.serializer;\n        this.filters = config.filters;\n        this.orderingFields = config.orderingFields ?? [];\n        this.searchFields = config.searchFields ?? [];\n        this.lookupField = config.lookupField;\n        this.lookupParam = config.lookupParam ?? 'id';\n        this.paginatorFactory = config.paginatorFactory;\n    }\n\n    /**\n     * Return the serializer class that owns this resource contract.\n     */\n    getSerializerClass(): TSerializer {\n        return this.serializerClass;\n    }\n\n    /**\n     * Return the serializer instance for the current resource.\n     */\n    getSerializer(): InstanceType<TSerializer> {\n        if (!this.serializer) {\n            this.serializer = new this.serializerClass() as InstanceType<TSerializer>;\n        }\n\n        return this.serializer;\n    }\n\n    /**\n     * Describe the public HTTP contract that this resource contributes to OpenAPI generation.\n     */\n    describeOpenAPI(): GenericAPIViewOpenAPIDescription<TModel, TSerializer> {\n        const model = this.requireModelMetadata();\n        return {\n            model,\n            outputSchema: this.getOutputSchema(),\n            createSchema: this.getCreateSchema(),\n            updateSchema: this.getUpdateSchema(),\n            searchFields: this.searchFields,\n            orderingFields: this.orderingFields,\n            lookupField: this.lookupField ?? this.getLookupFieldFromMetadata(model),\n            lookupParam: this.lookupParam,\n            allowedMethods: this.getAllowedMethods(),\n            usesDefaultOffsetPagination: !this.paginatorFactory,\n        };\n    }\n\n    protected getManager(): ManagerLike<TModel> {\n        return this.getSerializer().getManager();\n    }\n\n    protected getOutputSchema(): TSerializer['outputSchema'] {\n        return this.getSerializer().getOutputSchema() as TSerializer['outputSchema'];\n    }\n\n    protected getCreateSchema(): TSerializer['createSchema'] {\n        return this.getSerializer().getCreateSchema() as TSerializer['createSchema'];\n    }\n\n    protected getUpdateSchema(): TSerializer['updateSchema'] {\n        return this.getSerializer().getUpdateSchema() as TSerializer['updateSchema'];\n    }\n\n    protected getLookupField(): keyof TModel {\n        return this.lookupField ?? (this.getManager().meta.pk as keyof TModel);\n    }\n\n    protected getLookupValue(ctx: RequestContext): string | null {\n        const value = ctx.params[this.lookupParam]?.trim();\n        return value || null;\n    }\n\n    protected getPaginator(queryset: QuerySet<TModel>): Paginator<TModel, SerializerOutput<TSerializer>> {\n        if (this.paginatorFactory) {\n            return this.paginatorFactory(queryset);\n        }\n        return new OffsetPaginator<TModel>(queryset) as Paginator<TModel, SerializerOutput<TSerializer>>;\n    }\n\n    protected async performList(ctx: RequestContext): Promise<TangoResponse> {\n        try {\n            const params = ctx.request.queryParams;\n            const baseQueryset = this.getManager().query();\n            const paginator = this.getPaginator(baseQueryset);\n            paginator.parse(params);\n\n            let qs = baseQueryset;\n\n            if (this.filters) {\n                const filterInputs = this.filters\n                    .withFieldParsers(inferModelFieldParsers(this.getSerializer().getModel()))\n                    .apply(params);\n                if (filterInputs.length > 0) {\n                    qs = qs.filter(Q.and(...filterInputs));\n                }\n            }\n\n            const search = params.getSearch();\n            if (search && this.searchFields.length > 0) {\n                const searchFilters: FilterInput<TModel>[] = this.searchFields.map((field) => {\n                    const lookup = `${String(field)}__icontains`;\n                    return { [lookup]: search } as FilterInput<TModel>;\n                });\n                qs = qs.filter(Q.or(...searchFilters));\n            }\n\n            const ordering = params.getOrdering();\n            if (ordering.length > 0) {\n                const orderTokens = ordering.filter((field) => {\n                    const cleanField = field.startsWith('-') ? field.slice(1) : field;\n                    return this.orderingFields.includes(cleanField as keyof TModel);\n                });\n                if (orderTokens.length > 0) {\n                    qs = qs.orderBy(...orderTokens.map((token) => token as keyof TModel | `-${string & keyof TModel}`));\n                }\n            }\n\n            const paginatedQueryset = paginator.apply(qs);\n            const resultPromise = paginatedQueryset.fetch();\n            const totalCountPromise = paginator.needsTotalCount()\n                ? qs.count()\n                : Promise.resolve<number | undefined>(undefined);\n            const [result, totalCount] = await Promise.all([resultPromise, totalCountPromise]);\n            const serializer = this.getSerializer();\n            const rows = await serializer.serializeMany(result.items);\n            const response = paginator.toResponse(rows as SerializerOutput<TSerializer>[], {\n                totalCount,\n            }) as OffsetPaginatedResponse<SerializerOutput<TSerializer>>;\n\n            return TangoResponse.json(response as unknown as JsonValue, { status: 200 });\n        } catch (error) {\n            return this.handleError(error);\n        }\n    }\n\n    protected async performCreate(ctx: RequestContext): Promise<TangoResponse> {\n        try {\n            const body = await ctx.request.json();\n            const result = await this.getSerializer().create(body);\n\n            return TangoResponse.created(undefined, result as JsonValue);\n        } catch (error) {\n            return this.handleError(error);\n        }\n    }\n\n    protected async performRetrieve(ctx: RequestContext): Promise<TangoResponse> {\n        try {\n            const value = this.getLookupValue(ctx);\n            if (!value) {\n                throw new NotFoundError('Lookup parameter was not provided.');\n            }\n\n            const lookupField = this.getLookupField();\n            const filterByLookup = { [lookupField]: value } as FilterInput<TModel>;\n            const result = await this.getManager().query().filter(filterByLookup).fetchOne();\n            if (!result) {\n                throw new NotFoundError(\n                    `No ${this.getManager().meta.table} record found for ${String(lookupField)}=${value}.`\n                );\n            }\n\n            return TangoResponse.json((await this.getSerializer().serialize(result)) as JsonValue, { status: 200 });\n        } catch (error) {\n            return this.handleError(error);\n        }\n    }\n\n    protected async performUpdate(ctx: RequestContext): Promise<TangoResponse> {\n        try {\n            const value = this.getLookupValue(ctx);\n            if (!value) {\n                throw new NotFoundError('Lookup parameter was not provided.');\n            }\n\n            const body = await ctx.request.json();\n            const result = await this.getSerializer().update(value as TModel[keyof TModel], body);\n\n            return TangoResponse.json(result as JsonValue, { status: 200 });\n        } catch (error) {\n            return this.handleError(error);\n        }\n    }\n\n    protected async performDestroy(ctx: RequestContext): Promise<TangoResponse> {\n        try {\n            const value = this.getLookupValue(ctx);\n            if (!value) {\n                throw new NotFoundError('Lookup parameter was not provided.');\n            }\n\n            await this.getManager().delete(value as TModel[keyof TModel]);\n            return TangoResponse.noContent();\n        } catch (error) {\n            return this.handleError(error);\n        }\n    }\n\n    protected handleError(error: unknown): TangoResponse {\n        const httpError = HttpErrorFactory.toHttpError(error);\n        return TangoResponse.json(httpError.body as JsonValue, { status: httpError.status });\n    }\n\n    private requireModelMetadata(): ResourceModelLike<TModel> & {\n        metadata: NonNullable<ResourceModelLike<TModel>['metadata']>;\n    } {\n        const model = this.getSerializer().getModel();\n\n        if (!model.metadata) {\n            throw new Error('OpenAPI generation requires Tango model metadata on GenericAPIView models.');\n        }\n\n        return model as ResourceModelLike<TModel> & {\n            metadata: NonNullable<ResourceModelLike<TModel>['metadata']>;\n        };\n    }\n\n    private getLookupFieldFromMetadata(\n        model: ResourceModelLike<TModel> & {\n            metadata: NonNullable<ResourceModelLike<TModel>['metadata']>;\n        }\n    ): keyof TModel {\n        const primaryKeyField = model.metadata.fields.find((field) => field.primaryKey);\n\n        if (!primaryKeyField) {\n            throw new Error('OpenAPI generation requires a primary key field in Tango model metadata.');\n        }\n\n        return primaryKeyField.name as keyof TModel;\n    }\n}\n","import { GenericAPIView } from '../GenericAPIView';\nimport type { TangoResponse } from '@danceroutine/tango-core';\nimport { RequestContext } from '../../context/index';\nimport type { AnyModelSerializer } from '../../serializer/index';\n\n/**\n * Mixin that wires `GET` requests to the generic list implementation.\n */\nexport abstract class ListModelMixin<\n    TModel extends Record<string, unknown>,\n    TSerializer extends AnyModelSerializer<TModel>,\n> extends GenericAPIView<TModel, TSerializer> {\n    protected list(ctx: RequestContext): Promise<TangoResponse> {\n        return this.performList(ctx);\n    }\n\n    protected override get(ctx: RequestContext): Promise<TangoResponse> {\n        return this.list(ctx);\n    }\n}\n","import { GenericAPIView } from '../GenericAPIView';\nimport type { TangoResponse } from '@danceroutine/tango-core';\nimport { RequestContext } from '../../context/index';\nimport type { AnyModelSerializer } from '../../serializer/index';\n\n/**\n * Mixin that wires `POST` requests to the generic create implementation.\n */\nexport abstract class CreateModelMixin<\n    TModel extends Record<string, unknown>,\n    TSerializer extends AnyModelSerializer<TModel>,\n> extends GenericAPIView<TModel, TSerializer> {\n    protected create(ctx: RequestContext): Promise<TangoResponse> {\n        return this.performCreate(ctx);\n    }\n\n    protected override post(ctx: RequestContext): Promise<TangoResponse> {\n        return this.create(ctx);\n    }\n}\n","import { GenericAPIView } from '../GenericAPIView';\nimport type { TangoResponse } from '@danceroutine/tango-core';\nimport { RequestContext } from '../../context/index';\nimport type { AnyModelSerializer } from '../../serializer/index';\n\n/**\n * Mixin that wires `GET` requests to the generic retrieve implementation.\n */\nexport abstract class RetrieveModelMixin<\n    TModel extends Record<string, unknown>,\n    TSerializer extends AnyModelSerializer<TModel>,\n> extends GenericAPIView<TModel, TSerializer> {\n    protected retrieve(ctx: RequestContext): Promise<TangoResponse> {\n        return this.performRetrieve(ctx);\n    }\n\n    protected override get(ctx: RequestContext): Promise<TangoResponse> {\n        return this.retrieve(ctx);\n    }\n}\n","import { GenericAPIView } from '../GenericAPIView';\nimport type { TangoResponse } from '@danceroutine/tango-core';\nimport { RequestContext } from '../../context/index';\nimport type { AnyModelSerializer } from '../../serializer/index';\n\n/**\n * Mixin that wires `PUT` and `PATCH` requests to the generic update implementation.\n */\nexport abstract class UpdateModelMixin<\n    TModel extends Record<string, unknown>,\n    TSerializer extends AnyModelSerializer<TModel>,\n> extends GenericAPIView<TModel, TSerializer> {\n    protected update(ctx: RequestContext): Promise<TangoResponse> {\n        return this.performUpdate(ctx);\n    }\n\n    protected override put(ctx: RequestContext): Promise<TangoResponse> {\n        return this.update(ctx);\n    }\n\n    protected override patch(ctx: RequestContext): Promise<TangoResponse> {\n        return this.update(ctx);\n    }\n}\n","import { GenericAPIView } from '../GenericAPIView';\nimport type { TangoResponse } from '@danceroutine/tango-core';\nimport { RequestContext } from '../../context/index';\nimport type { AnyModelSerializer } from '../../serializer/index';\n\n/**\n * Mixin that wires `DELETE` requests to the generic destroy implementation.\n */\nexport abstract class DestroyModelMixin<\n    TModel extends Record<string, unknown>,\n    TSerializer extends AnyModelSerializer<TModel>,\n> extends GenericAPIView<TModel, TSerializer> {\n    protected destroy(ctx: RequestContext): Promise<TangoResponse> {\n        return this.performDestroy(ctx);\n    }\n\n    protected override delete(ctx: RequestContext): Promise<TangoResponse> {\n        return this.destroy(ctx);\n    }\n}\n","import { ListModelMixin } from '../mixins/ListModelMixin';\nimport type { TangoResponse } from '@danceroutine/tango-core';\nimport { RequestContext } from '../../context/index';\nimport type { AnyModelSerializer } from '../../serializer/index';\n\n/**\n * Generic API view for endpoints that only expose a list operation.\n */\nexport abstract class ListAPIView<\n    TModel extends Record<string, unknown>,\n    TSerializer extends AnyModelSerializer<TModel>,\n> extends ListModelMixin<TModel, TSerializer> {\n    protected override get(ctx: RequestContext): Promise<TangoResponse> {\n        return super.get(ctx);\n    }\n}\n","import { CreateModelMixin } from '../mixins/CreateModelMixin';\nimport type { TangoResponse } from '@danceroutine/tango-core';\nimport { RequestContext } from '../../context/index';\nimport type { AnyModelSerializer } from '../../serializer/index';\n\n/**\n * Generic API view for endpoints that only support resource creation.\n */\nexport abstract class CreateAPIView<\n    TModel extends Record<string, unknown>,\n    TSerializer extends AnyModelSerializer<TModel>,\n> extends CreateModelMixin<TModel, TSerializer> {\n    protected override post(ctx: RequestContext): Promise<TangoResponse> {\n        return super.post(ctx);\n    }\n}\n","import { RetrieveModelMixin } from '../mixins/RetrieveModelMixin';\nimport type { TangoResponse } from '@danceroutine/tango-core';\nimport { RequestContext } from '../../context/index';\nimport type { AnyModelSerializer } from '../../serializer/index';\n\n/**\n * Generic API view for endpoints that retrieve a single resource by lookup.\n */\nexport abstract class RetrieveAPIView<\n    TModel extends Record<string, unknown>,\n    TSerializer extends AnyModelSerializer<TModel>,\n> extends RetrieveModelMixin<TModel, TSerializer> {\n    protected override get(ctx: RequestContext): Promise<TangoResponse> {\n        return super.get(ctx);\n    }\n}\n","import { GenericAPIView } from '../GenericAPIView';\nimport type { TangoResponse } from '@danceroutine/tango-core';\nimport { RequestContext } from '../../context/index';\nimport type { AnyModelSerializer } from '../../serializer/index';\n\n/**\n * Generic API view for collection endpoints that list and create resources.\n */\nexport abstract class ListCreateAPIView<\n    TModel extends Record<string, unknown>,\n    TSerializer extends AnyModelSerializer<TModel>,\n> extends GenericAPIView<TModel, TSerializer> {\n    protected override get(ctx: RequestContext): Promise<TangoResponse> {\n        return this.performList(ctx);\n    }\n\n    protected override post(ctx: RequestContext): Promise<TangoResponse> {\n        return this.performCreate(ctx);\n    }\n}\n","import { GenericAPIView } from '../GenericAPIView';\nimport type { TangoResponse } from '@danceroutine/tango-core';\nimport { RequestContext } from '../../context/index';\nimport type { AnyModelSerializer } from '../../serializer/index';\n\n/**\n * Generic API view for endpoints that retrieve and update a single resource.\n */\nexport abstract class RetrieveUpdateAPIView<\n    TModel extends Record<string, unknown>,\n    TSerializer extends AnyModelSerializer<TModel>,\n> extends GenericAPIView<TModel, TSerializer> {\n    protected override get(ctx: RequestContext): Promise<TangoResponse> {\n        return this.performRetrieve(ctx);\n    }\n\n    protected override put(ctx: RequestContext): Promise<TangoResponse> {\n        return this.performUpdate(ctx);\n    }\n\n    protected override patch(ctx: RequestContext): Promise<TangoResponse> {\n        return this.performUpdate(ctx);\n    }\n}\n","import { GenericAPIView } from '../GenericAPIView';\nimport type { TangoResponse } from '@danceroutine/tango-core';\nimport { RequestContext } from '../../context/index';\nimport type { AnyModelSerializer } from '../../serializer/index';\n\n/**\n * Generic API view for endpoints that retrieve and delete a single resource.\n */\nexport abstract class RetrieveDestroyAPIView<\n    TModel extends Record<string, unknown>,\n    TSerializer extends AnyModelSerializer<TModel>,\n> extends GenericAPIView<TModel, TSerializer> {\n    protected override get(ctx: RequestContext): Promise<TangoResponse> {\n        return this.performRetrieve(ctx);\n    }\n\n    protected override delete(ctx: RequestContext): Promise<TangoResponse> {\n        return this.performDestroy(ctx);\n    }\n}\n","import { GenericAPIView } from '../GenericAPIView';\nimport type { TangoResponse } from '@danceroutine/tango-core';\nimport { RequestContext } from '../../context/index';\nimport type { AnyModelSerializer } from '../../serializer/index';\n\n/**\n * Generic API view for full detail endpoints that retrieve, update, and delete.\n */\nexport abstract class RetrieveUpdateDestroyAPIView<\n    TModel extends Record<string, unknown>,\n    TSerializer extends AnyModelSerializer<TModel>,\n> extends GenericAPIView<TModel, TSerializer> {\n    protected override get(ctx: RequestContext): Promise<TangoResponse> {\n        return this.performRetrieve(ctx);\n    }\n\n    protected override put(ctx: RequestContext): Promise<TangoResponse> {\n        return this.performUpdate(ctx);\n    }\n\n    protected override patch(ctx: RequestContext): Promise<TangoResponse> {\n        return this.performUpdate(ctx);\n    }\n\n    protected override delete(ctx: RequestContext): Promise<TangoResponse> {\n        return this.performDestroy(ctx);\n    }\n}\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { APIView, type APIViewMethod } from './APIView';\nexport { GenericAPIView, type GenericAPIViewConfig } from './GenericAPIView';\nexport type { GenericAPIViewOpenAPIDescription } from '../resource/index';\nexport {\n    ListModelMixin,\n    CreateModelMixin,\n    RetrieveModelMixin,\n    UpdateModelMixin,\n    DestroyModelMixin,\n} from './mixins/index';\nexport {\n    ListAPIView,\n    CreateAPIView,\n    RetrieveAPIView,\n    ListCreateAPIView,\n    RetrieveUpdateAPIView,\n    RetrieveDestroyAPIView,\n    RetrieveUpdateDestroyAPIView,\n} from './generics/index';\n"],"mappings":"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"}

package/dist/viewset/index.d.ts

@@ -0,0 +1,9 @@
+import { a as ModelViewSetConfig, c as ViewSetActionMethod, i as ModelViewSet, l as ViewSetActionScope, o as ResolvedViewSetActionDescriptor, r as ModelViewSetOpenAPIDescription, s as ViewSetActionDescriptor } from "../index-DkJtxvKu.js";
+
+//#region src/viewset/index.d.ts
+declare namespace index_d_exports {
+  export { ModelViewSet, ModelViewSetConfig, ModelViewSetOpenAPIDescription, ResolvedViewSetActionDescriptor, ViewSetActionDescriptor, ViewSetActionMethod, ViewSetActionScope };
+}
+//#endregion
+export { ModelViewSet, type ModelViewSetConfig, type ModelViewSetOpenAPIDescription, type ResolvedViewSetActionDescriptor, type ViewSetActionDescriptor, type ViewSetActionMethod, type ViewSetActionScope, index_d_exports as t };
+//# sourceMappingURL=index.d.ts.map

package/dist/viewset/index.js

@@ -0,0 +1,2 @@
+import { n as ModelViewSet } from "../viewset-C9j-2U29.js";
+export { ModelViewSet };

package/dist/viewset-C9j-2U29.js

@@ -0,0 +1,227 @@
+import { t as __exportAll } from "./chunk-D7D4PA-g.js";
+import { t as OffsetPaginator } from "./OffsetPaginator-CaycvxJU.js";
+import { t as inferModelFieldParsers } from "./inferModelFieldParsers-2irv7j1T.js";
+import { HttpErrorFactory, NotFoundError, TangoResponse } from "@danceroutine/tango-core";
+import { Q } from "@danceroutine/tango-orm";
+//#region src/viewset/ModelViewSet.ts
+/**
+* Base class for creating RESTful API viewsets with built-in CRUD operations.
+* Provides list, retrieve, create, update, and delete methods with filtering,
+* search, pagination, and ordering support.
+*/
+var ModelViewSet = class ModelViewSet {
+	static BRAND = "tango.resources.model_view_set";
+	static actions = [];
+	__tangoBrand = ModelViewSet.BRAND;
+	serializerClass;
+	filters;
+	orderingFields;
+	searchFields;
+	paginatorFactory;
+	serializer;
+	constructor(config) {
+		this.serializerClass = config.serializer;
+		this.filters = config.filters;
+		this.orderingFields = config.orderingFields ?? [];
+		this.searchFields = config.searchFields ?? [];
+		this.paginatorFactory = config.paginatorFactory;
+	}
+	/**
+	* Return the custom action descriptors declared by a viewset or constructor.
+	*/
+	static getActions(viewsetOrConstructor) {
+		const viewset = ModelViewSet.isModelViewSet(viewsetOrConstructor) ? viewsetOrConstructor : null;
+		const constructorValue = viewset ? viewset.constructor : viewsetOrConstructor;
+		return (Array.isArray(constructorValue.actions) ? constructorValue.actions : []).map((action) => ({
+			...action,
+			path: viewset ? viewset.resolveActionPath(action) : ModelViewSet.resolvePathFromDescriptor(action.name, action.path)
+		}));
+	}
+	/**
+	* Narrow an unknown value to `ModelViewSet`.
+	*/
+	static isModelViewSet(value) {
+		return typeof value === "object" && value !== null && value.__tangoBrand === ModelViewSet.BRAND;
+	}
+	/**
+	* Preserve literal action inference while validating the descriptor shape.
+	*/
+	static defineViewSetActions(actions) {
+		return actions;
+	}
+	static resolvePathFromDescriptor(name, explicitPath) {
+		const normalized = (explicitPath?.trim() || ModelViewSet.toKebabCase(name)).replace(/^\/+|\/+$/g, "");
+		if (!normalized) throw new Error(`Invalid custom action path for '${name}'.`);
+		return normalized;
+	}
+	static toKebabCase(input) {
+		return input.replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/[_\s]+/g, "-").toLowerCase();
+	}
+	/**
+	* Return the serializer class that owns this resource contract.
+	*/
+	getSerializerClass() {
+		return this.serializerClass;
+	}
+	/**
+	* Return the serializer instance for the current resource.
+	*/
+	getSerializer() {
+		if (!this.serializer) this.serializer = new this.serializerClass();
+		return this.serializer;
+	}
+	/**
+	* Describe the public HTTP contract that this resource contributes to OpenAPI generation.
+	*/
+	describeOpenAPI() {
+		const model = this.requireModelMetadata();
+		return {
+			model,
+			outputSchema: this.getSerializer().getOutputSchema(),
+			createSchema: this.getSerializer().getCreateSchema(),
+			updateSchema: this.getSerializer().getUpdateSchema(),
+			searchFields: this.searchFields,
+			orderingFields: this.orderingFields,
+			lookupField: this.getLookupFieldFromMetadata(model),
+			lookupParam: "id",
+			allowedMethods: [
+				"GET",
+				"POST",
+				"PUT",
+				"PATCH",
+				"DELETE"
+			],
+			usesDefaultOffsetPagination: !this.paginatorFactory,
+			actions: ModelViewSet.getActions(this)
+		};
+	}
+	/**
+	* List endpoint with filtering, search, ordering, and offset pagination.
+	*/
+	async list(ctx) {
+		try {
+			const params = ctx.request.queryParams;
+			const baseQueryset = this.getManager().query();
+			const paginator = this.getPaginator(baseQueryset);
+			paginator.parse(params);
+			let qs = baseQueryset;
+			if (this.filters) {
+				const filterInputs = this.filters.withFieldParsers(inferModelFieldParsers(this.getSerializer().getModel())).apply(params);
+				if (filterInputs.length > 0) qs = qs.filter(Q.and(...filterInputs));
+			}
+			const search = params.getSearch();
+			if (search && this.searchFields.length > 0) {
+				const searchFilters = this.searchFields.map((field) => {
+					return { [`${String(field)}__icontains`]: search };
+				});
+				qs = qs.filter(Q.or(...searchFilters));
+			}
+			const ordering = params.getOrdering();
+			if (ordering.length > 0) {
+				const orderTokens = ordering.filter((field) => {
+					const cleanField = field.startsWith("-") ? field.slice(1) : field;
+					return this.orderingFields.includes(cleanField);
+				});
+				if (orderTokens.length > 0) qs = qs.orderBy(...orderTokens.map((token) => token));
+			}
+			const resultPromise = paginator.apply(qs).fetch();
+			const totalCountPromise = paginator.needsTotalCount() ? qs.count() : Promise.resolve(void 0);
+			const [result, totalCount] = await Promise.all([resultPromise, totalCountPromise]);
+			const rows = await this.getSerializer().serializeMany(result.items);
+			const response = paginator.toResponse(rows, { totalCount });
+			return TangoResponse.json(response, { status: 200 });
+		} catch (error) {
+			return this.handleError(error);
+		}
+	}
+	/**
+	* Retrieve endpoint for a single resource by id.
+	*/
+	async retrieve(_ctx, id) {
+		try {
+			const manager = this.getManager();
+			const pk = manager.meta.pk;
+			const filterById = { [pk]: id };
+			const result = await manager.query().filter(filterById).fetchOne();
+			if (!result) throw new NotFoundError(`No ${manager.meta.table} record found for ${String(pk)}=${id}.`);
+			return TangoResponse.json(await this.getSerializer().serialize(result), { status: 200 });
+		} catch (error) {
+			return this.handleError(error);
+		}
+	}
+	/**
+	* Create endpoint: validate input, persist, and return serialized output.
+	*/
+	async create(ctx) {
+		try {
+			const body = await ctx.request.json();
+			const result = await this.getSerializer().create(body);
+			return TangoResponse.created(void 0, result);
+		} catch (error) {
+			return this.handleError(error);
+		}
+	}
+	/**
+	* Update endpoint: validate partial payload and persist by id.
+	*/
+	async update(ctx, id) {
+		try {
+			const body = await ctx.request.json();
+			const pkValue = id;
+			const result = await this.getSerializer().update(pkValue, body);
+			return TangoResponse.json(result, { status: 200 });
+		} catch (error) {
+			return this.handleError(error);
+		}
+	}
+	/**
+	* Destroy endpoint: delete a resource by id.
+	*/
+	async destroy(_ctx, id) {
+		try {
+			const pkValue = id;
+			await this.getManager().delete(pkValue);
+			return TangoResponse.noContent();
+		} catch (error) {
+			return this.handleError(error);
+		}
+	}
+	getPaginator(queryset) {
+		if (this.paginatorFactory) return this.paginatorFactory(queryset);
+		return new OffsetPaginator(queryset);
+	}
+	getManager() {
+		return this.getSerializer().getManager();
+	}
+	/**
+	* Convert thrown errors into normalized HTTP responses.
+	*/
+	handleError(error) {
+		const httpError = HttpErrorFactory.toHttpError(error);
+		return TangoResponse.json(httpError.body, { status: httpError.status });
+	}
+	/**
+	* Resolve route path segment(s) for a custom action.
+	* Override this in subclasses to customize path derivation globally.
+	*/
+	resolveActionPath(action) {
+		return ModelViewSet.resolvePathFromDescriptor(action.name, action.path);
+	}
+	requireModelMetadata() {
+		const model = this.getSerializer().getModel();
+		if (!model.metadata) throw new Error("OpenAPI generation requires Tango model metadata on ModelViewSet models.");
+		return model;
+	}
+	getLookupFieldFromMetadata(model) {
+		const primaryKeyField = model.metadata.fields.find((field) => field.primaryKey);
+		if (!primaryKeyField) throw new Error("OpenAPI generation requires a primary key field in Tango model metadata.");
+		return primaryKeyField.name;
+	}
+};
+//#endregion
+//#region src/viewset/index.ts
+var viewset_exports = /* @__PURE__ */ __exportAll({ ModelViewSet: () => ModelViewSet });
+//#endregion
+export { ModelViewSet as n, viewset_exports as t };
+
+//# sourceMappingURL=viewset-C9j-2U29.js.map