@danceroutine/tango-resources 0.1.0

package/dist/context/RequestContext.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Default user shape for RequestContext.
+ * Consumers can provide their own user type via the TUser generic parameter.
+ */
+export interface BaseUser {
+    id: string | number;
+    roles?: string[];
+}
+/**
+ * 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.
+ */
+export declare class RequestContext<TUser = BaseUser> {
+    readonly request: Request;
+    user: TUser | null;
+    params: Record<string, string>;
+    static readonly BRAND: "tango.resources.request_context";
+    private state;
+    readonly __tangoBrand: typeof RequestContext.BRAND;
+    constructor(request: Request, user?: TUser | null, params?: Record<string, string>);
+    static isRequestContext<TUser = BaseUser>(value: unknown): value is RequestContext<TUser>;
+    setState<T>(key: string | symbol, value: T): void;
+    getState<T>(key: string | symbol): T | undefined;
+    hasState(key: string | symbol): boolean;
+    static create<TUser = BaseUser>(request: Request, user?: TUser | null): RequestContext<TUser>;
+    clone(): RequestContext<TUser>;
+}

package/dist/context/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Domain boundary barrel: centralizes this subdomain's public contract.
+ */
+export type { BaseUser } from './RequestContext';
+export { RequestContext } from './RequestContext';

package/dist/domain/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Compatibility aggregate barrel. Canonical source-of-truth types now live in
+ * `filters`, `pagination`, and `viewset` subdomains.
+ */
+export type { FilterType, RangeOperator } from '../filters/index';
+export type { ModelViewSetConfig } from '../viewset/index';
+export type { PaginatedResponse, Paginator, Page } from '../pagination/index';
+export { PaginationInput } from '../pagination/index';

package/dist/filters/FilterSet.d.ts

@@ -0,0 +1,33 @@
+import type { FilterInput } from '@danceroutine/tango-orm';
+import { InternalFilterType } from './internal/InternalFilterType';
+import type { RangeOperator } from './RangeOperator';
+/**
+ * Configuration for how a query parameter should be resolved into a filter.
+ * Supports scalar equality, case-insensitive search, range comparisons, IN queries, and custom logic.
+ */
+export type FilterResolver<T> = {
+    type: typeof InternalFilterType.SCALAR;
+    column: keyof T;
+} | {
+    type: typeof InternalFilterType.ILIKE;
+    columns: (keyof T)[];
+} | {
+    type: typeof InternalFilterType.RANGE;
+    column: keyof T;
+    op: RangeOperator;
+} | {
+    type: typeof InternalFilterType.IN;
+    column: keyof T;
+} | {
+    type: typeof InternalFilterType.CUSTOM;
+    apply: (value: string | string[] | undefined) => FilterInput<T> | undefined;
+};
+export declare class FilterSet<T extends Record<string, unknown>> {
+    private spec;
+    static readonly BRAND: "tango.resources.filter_set";
+    readonly __tangoBrand: typeof FilterSet.BRAND;
+    static isFilterSet<T extends Record<string, unknown>>(value: unknown): value is FilterSet<T>;
+    constructor(spec: Record<string, FilterResolver<T>>);
+    apply(params: URLSearchParams): FilterInput<T>[];
+    private resolveFilter;
+}

package/dist/filters/FilterType.d.ts

@@ -0,0 +1,2 @@
+import type { InternalFilterType } from './internal/InternalFilterType';
+export type FilterType = (typeof InternalFilterType)[keyof typeof InternalFilterType];

package/dist/filters/RangeOperator.d.ts

@@ -0,0 +1,2 @@
+import type { InternalRangeOperator } from './internal/InternalRangeOperator';
+export type RangeOperator = (typeof InternalRangeOperator)[keyof typeof InternalRangeOperator];

package/dist/filters/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Domain boundary barrel: centralizes this subdomain's public contract.
+ */
+export type { FilterType } from './FilterType';
+export type { RangeOperator } from './RangeOperator';
+export type { FilterResolver } from './FilterSet';
+export { FilterSet } from './FilterSet';

package/dist/filters/internal/InternalFilterType.d.ts

@@ -0,0 +1,7 @@
+export declare const InternalFilterType: {
+    readonly SCALAR: "scalar";
+    readonly ILIKE: "ilike";
+    readonly RANGE: "range";
+    readonly IN: "in";
+    readonly CUSTOM: "custom";
+};

package/dist/filters/internal/InternalRangeOperator.d.ts

@@ -0,0 +1,6 @@
+export declare const InternalRangeOperator: {
+    readonly GTE: "gte";
+    readonly LTE: "lte";
+    readonly GT: "gt";
+    readonly LT: "lt";
+};

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Bundled exports for Django-style domain drill-down imports, plus curated
+ * top-level symbols for TS-native ergonomic imports.
+ */
+export * as context from './context/index';
+export * as filters from './filters/index';
+export * as pagination from './pagination/index';
+export * as paginators from './paginators/index';
+export * as viewset from './viewset/index';
+export * as domain from './domain/index';
+export { RequestContext } from './context/index';
+export type { BaseUser } from './context/index';
+export { FilterSet, type FilterResolver } from './filters/index';
+export type { FilterType, RangeOperator } from './filters/index';
+export { CursorPaginator, OffsetPaginator, PaginationInput, type Page, type PaginatedResponse, type Paginator, } from './pagination/index';
+export { ModelViewSet } from './viewset/index';
+export type { ModelViewSetConfig } from './viewset/index';

package/dist/index.js

@@ -0,0 +1,516 @@
+import { z } from "zod";
+import { toHttpError } from "@danceroutine/tango-core";
+import { Q } from "@danceroutine/tango-orm";
+
+//#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/context/RequestContext.ts
+var RequestContext = class RequestContext {
+	static BRAND = "tango.resources.request_context";
+	state = new Map();
+	__tangoBrand = RequestContext.BRAND;
+	constructor(request, user = null, params = {}) {
+		this.request = request;
+		this.user = user;
+		this.params = params;
+	}
+	static isRequestContext(value) {
+		return typeof value === "object" && value !== null && value.__tangoBrand === RequestContext.BRAND;
+	}
+	setState(key, value) {
+		this.state.set(key, value);
+	}
+	getState(key) {
+		return this.state.get(key);
+	}
+	hasState(key) {
+		return this.state.has(key);
+	}
+	static create(request, user) {
+		return new RequestContext(request, user ?? null);
+	}
+	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 = {};
+__export(context_exports, { RequestContext: () => RequestContext });
+
+//#endregion
+//#region src/filters/internal/InternalFilterType.ts
+const InternalFilterType = {
+	SCALAR: "scalar",
+	ILIKE: "ilike",
+	RANGE: "range",
+	IN: "in",
+	CUSTOM: "custom"
+};
+
+//#endregion
+//#region src/filters/FilterSet.ts
+var FilterSet = class FilterSet {
+	static BRAND = "tango.resources.filter_set";
+	__tangoBrand = FilterSet.BRAND;
+	static isFilterSet(value) {
+		return typeof value === "object" && value !== null && value.__tangoBrand === FilterSet.BRAND;
+	}
+	constructor(spec) {
+		this.spec = spec;
+	}
+	apply(params) {
+		const filters = [];
+		for (const [key, resolver] of Object.entries(this.spec)) {
+			const rawValue = params.getAll(key);
+			const value = rawValue.length > 1 ? rawValue : params.get(key) ?? undefined;
+			if (value === undefined) continue;
+			const filter = this.resolveFilter(resolver, value);
+			if (filter) filters.push(filter);
+		}
+		return filters;
+	}
+	resolveFilter(resolver, value) {
+		if (value === undefined) return undefined;
+		switch (resolver.type) {
+			case InternalFilterType.SCALAR: return { [resolver.column]: value };
+			case InternalFilterType.ILIKE: {
+				const pattern = `%${value}%`;
+				const filter = {};
+				resolver.columns.forEach((col) => {
+					filter[`${String(col)}__icontains`] = pattern;
+				});
+				return filter;
+			}
+			case InternalFilterType.RANGE: {
+				const lookupKey = `${String(resolver.column)}__${resolver.op}`;
+				return { [lookupKey]: value };
+			}
+			case InternalFilterType.IN: {
+				const arr = Array.isArray(value) ? value : String(value).split(",");
+				const lookupKey = `${String(resolver.column)}__in`;
+				return { [lookupKey]: arr };
+			}
+			case InternalFilterType.CUSTOM: return resolver.apply(value);
+			default: return undefined;
+		}
+	}
+};
+
+//#endregion
+//#region src/filters/index.ts
+var filters_exports = {};
+__export(filters_exports, { FilterSet: () => FilterSet });
+
+//#endregion
+//#region src/pagination/PaginationInput.ts
+const PaginationInput = 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 {
+	static BRAND = "tango.resources.offset_page";
+	__tangoBrand = OffsetPage.BRAND;
+	static isOffsetPage(value) {
+		return typeof value === "object" && value !== null && value.__tangoBrand === OffsetPage.BRAND;
+	}
+	constructor(results, pageNumber, perPage, totalCount) {
+		this.results = results;
+		this.pageNumber = pageNumber;
+		this.perPage = perPage;
+		this.totalCount = totalCount;
+	}
+	hasNext() {
+		if (this.totalCount === undefined) return false;
+		return this.endIndex() < this.totalCount;
+	}
+	hasPrevious() {
+		return this.pageNumber > 1;
+	}
+	nextPageNumber() {
+		return this.hasNext() ? this.pageNumber + 1 : null;
+	}
+	previousPageNumber() {
+		return this.hasPrevious() ? this.pageNumber - 1 : null;
+	}
+	startIndex() {
+		return (this.pageNumber - 1) * this.perPage;
+	}
+	endIndex() {
+		return this.startIndex() + this.results.length;
+	}
+};
+var OffsetPaginator = class OffsetPaginator {
+	static BRAND = "tango.resources.offset_paginator";
+	__tangoBrand = OffsetPaginator.BRAND;
+	limit = 25;
+	offset = 0;
+	constructor(queryset, perPage = 25) {
+		this.queryset = queryset;
+		this.perPage = perPage;
+		this.limit = perPage;
+	}
+	static isOffsetPaginator(value) {
+		return typeof value === "object" && value !== null && value.__tangoBrand === OffsetPaginator.BRAND;
+	}
+	/**
+	* Parse limit, offset, and page from URL search 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") ?? undefined,
+			offset: params.get("offset") ?? undefined,
+			page: params.get("page") ?? undefined
+		};
+		const parsed = PaginationInput.parse(input);
+		if (parsed.page) parsed.offset = (parsed.page - 1) * parsed.limit;
+		this.limit = parsed.limit;
+		this.offset = parsed.offset;
+	}
+	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.
+	*/
+	toResponse(results, context) {
+		const totalCount = context?.totalCount;
+		const response = { results };
+		if (totalCount !== undefined) {
+			response.count = totalCount;
+			if (this.offset + this.limit < totalCount) response.next = `?limit=${this.limit}&offset=${this.offset + this.limit}`;
+			if (this.offset > 0) {
+				const prevOffset = Math.max(0, this.offset - this.limit);
+				response.previous = `?limit=${this.limit}&offset=${prevOffset}`;
+			}
+		}
+		return response;
+	}
+	getPaginatedResponse(results, totalCount) {
+		return this.toResponse(results, { totalCount });
+	}
+	apply(queryset) {
+		return queryset.limit(this.limit).offset(this.offset);
+	}
+	async paginate(page) {
+		return this.getPage(page);
+	}
+	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(results.results, page, this.perPage, totalCount);
+	}
+	async count() {
+		return this.queryset.count();
+	}
+};
+
+//#endregion
+//#region src/paginators/CursorPaginator.ts
+var CursorPage = class CursorPage {
+	static BRAND = "tango.resources.cursor_page";
+	__tangoBrand = CursorPage.BRAND;
+	static isCursorPage(value) {
+		return typeof value === "object" && value !== null && value.__tangoBrand === CursorPage.BRAND;
+	}
+	constructor(results, nextCursor, previousCursor) {
+		this.results = results;
+		this.nextCursor = nextCursor;
+		this.previousCursor = previousCursor;
+	}
+	hasNext() {
+		return this.nextCursor !== null;
+	}
+	hasPrevious() {
+		return this.previousCursor !== null;
+	}
+	nextPageNumber() {
+		return null;
+	}
+	previousPageNumber() {
+		return null;
+	}
+	startIndex() {
+		return 0;
+	}
+	endIndex() {
+		return this.results.length;
+	}
+};
+var CursorPaginator = class CursorPaginator {
+	static BRAND = "tango.resources.cursor_paginator";
+	__tangoBrand = CursorPaginator.BRAND;
+	limit;
+	cursor = null;
+	direction = "asc";
+	nextCursor = null;
+	previousCursor = null;
+	constructor(queryset, perPage = 25, cursorField = "id") {
+		this.queryset = queryset;
+		this.perPage = perPage;
+		this.cursorField = cursorField;
+		this.limit = perPage;
+	}
+	static isCursorPaginator(value) {
+		return typeof value === "object" && value !== null && value.__tangoBrand === CursorPaginator.BRAND;
+	}
+	parse(params) {
+		const rawLimit = Number.parseInt(params.get("limit") ?? "", 10);
+		if (Number.isFinite(rawLimit) && rawLimit > 0) this.limit = Math.min(rawLimit, 100);
+else this.limit = this.perPage;
+		this.cursor = params.get("cursor");
+		const ordering = params.get("ordering");
+		if (ordering) {
+			const parsedDirection = ordering.startsWith("-") ? "desc" : "asc";
+			const parsedField = ordering.startsWith("-") ? ordering.slice(1) : ordering;
+			this.direction = parsedField === String(this.cursorField) ? parsedDirection : "asc";
+		} else this.direction = "asc";
+	}
+	parseParams(params) {
+		this.parse(params);
+		return {
+			limit: this.limit,
+			offset: 0
+		};
+	}
+	toResponse(results) {
+		const response = { results };
+		if (this.nextCursor) response.next = this.buildPageLink(this.nextCursor);
+		if (this.previousCursor) response.previous = this.buildPageLink(this.previousCursor);
+		return response;
+	}
+	getPaginatedResponse(results, _totalCount) {
+		return this.toResponse(results);
+	}
+	apply(queryset) {
+		let qs = queryset.limit(this.limit + 1);
+		if (this.cursor) {
+			const decoded = this.decodeCursor(this.cursor);
+			if (decoded.field !== String(this.cursorField)) throw new Error("Invalid cursor: field mismatch");
+			const lookup = this.direction === "asc" ? "__gt" : "__lt";
+			const fieldLookup = `${String(this.cursorField)}${lookup}`;
+			const filterInput = { [fieldLookup]: decoded.value };
+			qs = qs.filter(filterInput);
+		}
+		const orderToken = this.direction === "asc" ? String(this.cursorField) : `-${String(this.cursorField)}`;
+		return qs.orderBy(orderToken);
+	}
+	async paginate(cursor) {
+		const appliedCursor = cursor ?? this.cursor;
+		this.cursor = appliedCursor;
+		const fetched = await this.apply(this.queryset).fetch();
+		const results = [...fetched.results];
+		const hasMore = results.length > this.limit;
+		if (hasMore) results.pop();
+		this.previousCursor = appliedCursor ?? null;
+		const last = results.at(-1);
+		this.nextCursor = hasMore && last ? this.encodeCursor(last) : null;
+		return new CursorPage(results, this.nextCursor, this.previousCursor);
+	}
+	async getPage(page) {
+		if (page !== 1) throw new Error("CursorPaginator only supports getPage(1). Use cursor pagination for subsequent pages.");
+		return this.paginate();
+	}
+	buildPageLink(cursor) {
+		const orderingToken = this.direction === "asc" ? String(this.cursorField) : `-${String(this.cursorField)}`;
+		return `?limit=${this.limit}&cursor=${encodeURIComponent(cursor)}&ordering=${encodeURIComponent(orderingToken)}`;
+	}
+	encodeCursor(item) {
+		const payload = {
+			v: 1,
+			field: String(this.cursorField),
+			dir: this.direction,
+			value: item[this.cursorField]
+		};
+		return Buffer.from(JSON.stringify(payload), "utf-8").toString("base64");
+	}
+	decodeCursor(cursor) {
+		let parsed;
+		try {
+			parsed = JSON.parse(Buffer.from(cursor, "base64").toString("utf-8"));
+		} catch {
+			throw new Error("Invalid cursor: malformed token");
+		}
+		if (!parsed || typeof parsed !== "object" || parsed.v !== 1 || typeof parsed.field !== "string" || parsed.dir !== "asc" && parsed.dir !== "desc" || !("value" in parsed)) throw new Error("Invalid cursor: unsupported payload");
+		return parsed;
+	}
+};
+
+//#endregion
+//#region src/pagination/index.ts
+var pagination_exports = {};
+__export(pagination_exports, {
+	CursorPaginator: () => CursorPaginator,
+	OffsetPaginator: () => OffsetPaginator,
+	PaginationInput: () => PaginationInput
+});
+
+//#endregion
+//#region src/paginators/index.ts
+var paginators_exports = {};
+__export(paginators_exports, {
+	CursorPaginator: () => CursorPaginator,
+	OffsetPaginator: () => OffsetPaginator
+});
+
+//#endregion
+//#region src/viewset/ModelViewSet.ts
+var ModelViewSet = class ModelViewSet {
+	static BRAND = "tango.resources.model_view_set";
+	repository;
+	readSchema;
+	writeSchema;
+	updateSchema;
+	filters;
+	orderingFields;
+	searchFields;
+	__tangoBrand = ModelViewSet.BRAND;
+	static isModelViewSet(value) {
+		return typeof value === "object" && value !== null && value.__tangoBrand === ModelViewSet.BRAND;
+	}
+	constructor(config) {
+		this.repository = config.repository;
+		this.readSchema = config.readSchema;
+		this.writeSchema = config.writeSchema;
+		this.updateSchema = config.updateSchema ?? config.writeSchema.partial();
+		this.filters = config.filters;
+		this.orderingFields = config.orderingFields ?? [];
+		this.searchFields = config.searchFields ?? [];
+	}
+	async list(ctx) {
+		try {
+			const params = new URL(ctx.request.url).searchParams;
+			const paginator = new OffsetPaginator(this.repository.query());
+			paginator.parse(params);
+			let qs = this.repository.query();
+			if (this.filters) {
+				const filterInputs = this.filters.apply(params);
+				if (filterInputs.length > 0) qs = qs.filter(Q.and(...filterInputs));
+			}
+			const search = params.get("search");
+			if (search && this.searchFields.length > 0) {
+				const searchFilters = this.searchFields.map((field) => {
+					const lookup = `${String(field)}__icontains`;
+					return { [lookup]: search };
+				});
+				qs = qs.filter(Q.or(...searchFilters));
+			}
+			const ordering = params.get("ordering");
+			if (ordering) {
+				const orderTokens = ordering.split(",").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));
+			}
+			qs = paginator.apply(qs);
+			const [result, totalCount] = await Promise.all([qs.fetch(this.readSchema), qs.count()]);
+			const response = paginator.toResponse(result.results, { totalCount });
+			return new Response(JSON.stringify(response), {
+				status: 200,
+				headers: { "Content-Type": "application/json" }
+			});
+		} catch (error) {
+			return this.handleError(error);
+		}
+	}
+	async retrieve(_ctx, id) {
+		try {
+			const pk = this.repository.meta.pk;
+			const filterById = { [pk]: id };
+			const result = await this.repository.query().filter(filterById).fetchOne(this.readSchema);
+			if (!result) return new Response(JSON.stringify({ error: "Not found" }), {
+				status: 404,
+				headers: { "Content-Type": "application/json" }
+			});
+			return new Response(JSON.stringify(result), {
+				status: 200,
+				headers: { "Content-Type": "application/json" }
+			});
+		} catch (error) {
+			return this.handleError(error);
+		}
+	}
+	async create(ctx) {
+		try {
+			const body = await ctx.request.json();
+			const validated = this.writeSchema.parse(body);
+			const created = await this.repository.create(validated);
+			const result = this.readSchema.parse(created);
+			return new Response(JSON.stringify(result), {
+				status: 201,
+				headers: { "Content-Type": "application/json" }
+			});
+		} catch (error) {
+			return this.handleError(error);
+		}
+	}
+	async update(ctx, id) {
+		try {
+			const body = await ctx.request.json();
+			const validated = this.updateSchema.parse(body);
+			const pkValue = id;
+			const updated = await this.repository.update(pkValue, validated);
+			const result = this.readSchema.parse(updated);
+			return new Response(JSON.stringify(result), {
+				status: 200,
+				headers: { "Content-Type": "application/json" }
+			});
+		} catch (error) {
+			return this.handleError(error);
+		}
+	}
+	async destroy(_ctx, id) {
+		try {
+			const pkValue = id;
+			await this.repository.delete(pkValue);
+			return new Response(null, { status: 204 });
+		} catch (error) {
+			return this.handleError(error);
+		}
+	}
+	handleError(error) {
+		const httpError = toHttpError(error);
+		return new Response(JSON.stringify(httpError.body), {
+			status: httpError.status,
+			headers: { "Content-Type": "application/json" }
+		});
+	}
+};
+
+//#endregion
+//#region src/viewset/index.ts
+var viewset_exports = {};
+__export(viewset_exports, { ModelViewSet: () => ModelViewSet });
+
+//#endregion
+//#region src/domain/index.ts
+var domain_exports = {};
+__export(domain_exports, { PaginationInput: () => PaginationInput });
+
+//#endregion
+export { CursorPaginator, FilterSet, ModelViewSet, OffsetPaginator, PaginationInput, RequestContext, context_exports as context, domain_exports as domain, filters_exports as filters, pagination_exports as pagination, paginators_exports as paginators, viewset_exports as viewset };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["request: Request","user: TUser | null","params: Record<string, string>","value: unknown","key: string | symbol","value: T","user?: TUser | null","value: unknown","spec: Record<string, FilterResolver<T>>","params: URLSearchParams","filters: FilterInput<T>[]","resolver: FilterResolver<T>","value: string | string[] | undefined","filter: Partial<Record<FilterKey<T>, FilterValue>>","PaginationInput: z.ZodType<PaginationInputValue>","value: unknown","results: T[]","pageNumber: number","perPage: number","totalCount?: number","queryset: QuerySet<T>","params: URLSearchParams","results: TResult[]","context?: { totalCount?: number }","response: PaginatedResponse<TResult>","page: number","value: unknown","results: T[]","nextCursor: string | null","previousCursor: string | null","queryset: QuerySet<T>","perPage: number","cursorField: keyof T","params: URLSearchParams","parsedDirection: CursorDirection","results: TResult[]","response: PaginatedResponse<TResult>","_totalCount?: number","cursor?: string","page: number","cursor: string","item: T","payload: CursorPayload","parsed: unknown","value: unknown","config: ModelViewSetConfig<TModel, TRead, TWrite>","ctx: RequestContext","searchFilters: FilterInput<TModel>[]","_ctx: RequestContext","id: string","error: unknown"],"sources":["../src/context/RequestContext.ts","../src/context/index.ts","../src/filters/internal/InternalFilterType.ts","../src/filters/FilterSet.ts","../src/filters/index.ts","../src/pagination/PaginationInput.ts","../src/paginators/OffsetPaginator.ts","../src/paginators/CursorPaginator.ts","../src/pagination/index.ts","../src/paginators/index.ts","../src/viewset/ModelViewSet.ts","../src/viewset/index.ts","../src/domain/index.ts"],"sourcesContent":["/**\n * Default user shape for RequestContext.\n * Consumers can provide their own user type via the TUser generic parameter.\n */\nexport interface BaseUser {\n    id: string | number;\n    roles?: string[];\n}\n\n/**\n * Normalized request context passed through the framework adapter into viewset methods.\n * Generic over the user type so consumers can plug in their own auth infrastructure.\n */\nexport class RequestContext<TUser = BaseUser> {\n    static readonly BRAND = 'tango.resources.request_context' as const;\n    private state: Map<string | symbol, unknown> = new Map();\n    readonly __tangoBrand: typeof RequestContext.BRAND = RequestContext.BRAND;\n\n    constructor(\n        public readonly request: Request,\n        public user: TUser | null = null,\n        public params: Record<string, string> = {}\n    ) {}\n\n    static isRequestContext<TUser = BaseUser>(value: unknown): value is RequestContext<TUser> {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === RequestContext.BRAND\n        );\n    }\n\n    setState<T>(key: string | symbol, value: T): void {\n        this.state.set(key, value);\n    }\n\n    getState<T>(key: string | symbol): T | undefined {\n        return this.state.get(key) as T | undefined;\n    }\n\n    hasState(key: string | symbol): boolean {\n        return this.state.has(key);\n    }\n\n    static create<TUser = BaseUser>(request: Request, user?: TUser | null): RequestContext<TUser> {\n        return new RequestContext<TUser>(request, user ?? null);\n    }\n\n    clone(): RequestContext<TUser> {\n        const cloned = new RequestContext<TUser>(this.request, this.user, { ...this.params });\n        cloned.state = new Map(this.state);\n        return cloned;\n    }\n}\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport type { BaseUser } from './RequestContext';\nexport { RequestContext } from './RequestContext';\n","export const InternalFilterType = {\n    SCALAR: 'scalar',\n    ILIKE: 'ilike',\n    RANGE: 'range',\n    IN: 'in',\n    CUSTOM: 'custom',\n} as const;\n","import type { FilterInput, FilterKey, FilterValue } from '@danceroutine/tango-orm';\nimport { InternalFilterType } from './internal/InternalFilterType';\nimport type { RangeOperator } from './RangeOperator';\n\n/**\n * Configuration for how a query parameter should be resolved into a filter.\n * Supports scalar equality, case-insensitive search, range comparisons, IN queries, and custom logic.\n */\nexport type FilterResolver<T> =\n    | { type: typeof InternalFilterType.SCALAR; column: keyof T }\n    | { type: typeof InternalFilterType.ILIKE; columns: (keyof T)[] }\n    | { type: typeof InternalFilterType.RANGE; column: keyof T; op: RangeOperator }\n    | { type: typeof InternalFilterType.IN; column: keyof T }\n    | {\n          type: typeof InternalFilterType.CUSTOM;\n          apply: (value: string | string[] | undefined) => FilterInput<T> | undefined;\n      };\n\nexport class FilterSet<T extends Record<string, unknown>> {\n    static readonly BRAND = 'tango.resources.filter_set' as const;\n    readonly __tangoBrand: typeof FilterSet.BRAND = FilterSet.BRAND;\n\n    static isFilterSet<T extends Record<string, unknown>>(value: unknown): value is FilterSet<T> {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === FilterSet.BRAND\n        );\n    }\n\n    constructor(private spec: Record<string, FilterResolver<T>>) {}\n\n    apply(params: URLSearchParams): FilterInput<T>[] {\n        const filters: FilterInput<T>[] = [];\n\n        for (const [key, resolver] of Object.entries(this.spec)) {\n            const rawValue = params.getAll(key);\n            const value = rawValue.length > 1 ? rawValue : (params.get(key) ?? undefined);\n\n            if (value === undefined) continue;\n\n            const filter = this.resolveFilter(resolver, value);\n            if (filter) {\n                filters.push(filter);\n            }\n        }\n\n        return filters;\n    }\n\n    private resolveFilter(\n        resolver: FilterResolver<T>,\n        value: string | string[] | undefined\n    ): FilterInput<T> | undefined {\n        if (value === undefined) return undefined;\n\n        switch (resolver.type) {\n            case InternalFilterType.SCALAR:\n                return { [resolver.column]: value } as FilterInput<T>;\n\n            case InternalFilterType.ILIKE: {\n                const pattern = `%${value}%`;\n                const filter: Partial<Record<FilterKey<T>, FilterValue>> = {};\n                resolver.columns.forEach((col) => {\n                    filter[`${String(col)}__icontains` as FilterKey<T>] = pattern;\n                });\n                return filter;\n            }\n\n            case InternalFilterType.RANGE: {\n                const lookupKey = `${String(resolver.column)}__${resolver.op}` as keyof FilterInput<T>;\n                return { [lookupKey]: value } as FilterInput<T>;\n            }\n\n            case InternalFilterType.IN: {\n                const arr = Array.isArray(value) ? value : String(value).split(',');\n                const lookupKey = `${String(resolver.column)}__in` as keyof FilterInput<T>;\n                return { [lookupKey]: arr } as FilterInput<T>;\n            }\n\n            case InternalFilterType.CUSTOM:\n                return resolver.apply(value);\n\n            default:\n                return undefined;\n        }\n    }\n}\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport type { FilterType } from './FilterType';\nexport type { RangeOperator } from './RangeOperator';\nexport type { FilterResolver } from './FilterSet';\nexport { FilterSet } from './FilterSet';\n","import { z } from 'zod';\n\nexport type PaginationInputValue = {\n    limit: number;\n    offset: number;\n    page?: number;\n};\n\nexport const PaginationInput: z.ZodType<PaginationInputValue> = z.object({\n    limit: z.coerce\n        .number()\n        .int()\n        .min(1)\n        .default(25)\n        .transform((value) => Math.min(value, 100)),\n    offset: z.coerce.number().int().min(0).default(0),\n    page: z.coerce.number().int().min(1).optional(),\n});\n","import type { QuerySet } from '@danceroutine/tango-orm';\nimport type { Paginator, Page } from '../pagination/Paginator';\nimport type { PaginatedResponse } from '../pagination/PaginatedResponse';\nimport { PaginationInput } from '../pagination/PaginationInput';\n\nclass OffsetPage<T> implements Page<T> {\n    static readonly BRAND = 'tango.resources.offset_page' as const;\n    readonly __tangoBrand: typeof OffsetPage.BRAND = OffsetPage.BRAND;\n\n    static isOffsetPage<T>(value: unknown): value is OffsetPage<T> {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === OffsetPage.BRAND\n        );\n    }\n\n    constructor(\n        public readonly results: T[],\n        private readonly pageNumber: number,\n        private readonly perPage: number,\n        private readonly totalCount?: number\n    ) {}\n\n    hasNext(): boolean {\n        if (this.totalCount === undefined) {\n            return false;\n        }\n        return this.endIndex() < this.totalCount;\n    }\n\n    hasPrevious(): boolean {\n        return this.pageNumber > 1;\n    }\n\n    nextPageNumber(): number | null {\n        return this.hasNext() ? this.pageNumber + 1 : null;\n    }\n\n    previousPageNumber(): number | null {\n        return this.hasPrevious() ? this.pageNumber - 1 : null;\n    }\n\n    startIndex(): number {\n        return (this.pageNumber - 1) * this.perPage;\n    }\n\n    endIndex(): number {\n        return this.startIndex() + this.results.length;\n    }\n}\n\n/**\n * Offset/limit paginator modelled after DRF's LimitOffsetPagination.\n * Handles parsing limit/offset/page from URL query params and building\n * the paginated response envelope with next/previous links.\n *\n * @example\n * ```typescript\n * const paginator = new OffsetPaginator(queryset);\n * const { limit, offset } = paginator.parseParams(searchParams);\n * const results = await queryset.limit(limit).offset(offset).fetchAll();\n * const response = paginator.getPaginatedResponse(results, totalCount);\n * ```\n */\nexport class OffsetPaginator<T extends Record<string, unknown>> implements Paginator<T> {\n    static readonly BRAND = 'tango.resources.offset_paginator' as const;\n    readonly __tangoBrand: typeof OffsetPaginator.BRAND = OffsetPaginator.BRAND;\n    private limit = 25;\n    private offset = 0;\n\n    constructor(\n        private queryset: QuerySet<T>,\n        private perPage: number = 25\n    ) {\n        this.limit = perPage;\n    }\n\n    static isOffsetPaginator<T extends Record<string, unknown>>(value: unknown): value is OffsetPaginator<T> {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === OffsetPaginator.BRAND\n        );\n    }\n\n    /**\n     * Parse limit, offset, and page from URL search params.\n     * If `page` is provided, it's converted to an offset.\n     * Stores parsed values for use by getPaginatedResponse.\n     */\n    parse(params: URLSearchParams): void {\n        const input = {\n            limit: params.get('limit') ?? undefined,\n            offset: params.get('offset') ?? undefined,\n            page: params.get('page') ?? undefined,\n        };\n\n        const parsed = PaginationInput.parse(input);\n\n        if (parsed.page) {\n            parsed.offset = (parsed.page - 1) * parsed.limit;\n        }\n\n        this.limit = parsed.limit;\n        this.offset = parsed.offset;\n    }\n\n    parseParams(params: URLSearchParams): { limit: number; offset: number } {\n        this.parse(params);\n        return { limit: this.limit, offset: this.offset };\n    }\n\n    /**\n     * Build a DRF-style paginated response with count, next, and previous links.\n     * Uses the limit/offset stored from the most recent parseParams call.\n     */\n    toResponse<TResult>(results: TResult[], context?: { totalCount?: number }): PaginatedResponse<TResult> {\n        const totalCount = context?.totalCount;\n        const response: PaginatedResponse<TResult> = { results };\n\n        if (totalCount !== undefined) {\n            response.count = totalCount;\n\n            if (this.offset + this.limit < totalCount) {\n                response.next = `?limit=${this.limit}&offset=${this.offset + this.limit}`;\n            }\n\n            if (this.offset > 0) {\n                const prevOffset = Math.max(0, this.offset - this.limit);\n                response.previous = `?limit=${this.limit}&offset=${prevOffset}`;\n            }\n        }\n\n        return response;\n    }\n\n    getPaginatedResponse<TResult>(results: TResult[], totalCount?: number): PaginatedResponse<TResult> {\n        return this.toResponse(results, { totalCount });\n    }\n\n    apply(queryset: QuerySet<T>): QuerySet<T> {\n        return queryset.limit(this.limit).offset(this.offset);\n    }\n\n    async paginate(page: number): Promise<Page<T>> {\n        return this.getPage(page);\n    }\n\n    async getPage(page: number): Promise<Page<T>> {\n        const offset = (page - 1) * this.perPage;\n        const results = await this.queryset.offset(offset).limit(this.perPage).fetch();\n\n        const totalCount = await this.count();\n\n        return new OffsetPage(results.results, page, this.perPage, totalCount);\n    }\n\n    async count(): Promise<number> {\n        return this.queryset.count();\n    }\n}\n","import type { FilterInput, QuerySet } from '@danceroutine/tango-orm';\nimport type { Paginator, Page } from '../pagination/Paginator';\nimport type { PaginatedResponse } from '../pagination/PaginatedResponse';\n\ntype CursorDirection = 'asc' | 'desc';\n\ntype CursorPayload = {\n    v: 1;\n    field: string;\n    dir: CursorDirection;\n    value: unknown;\n};\n\n/**\n * Represents a single cursor page of results.\n * Cursor pages do not expose numeric page navigation like offset pagination.\n */\nclass CursorPage<T> implements Page<T> {\n    static readonly BRAND = 'tango.resources.cursor_page' as const;\n    readonly __tangoBrand: typeof CursorPage.BRAND = CursorPage.BRAND;\n\n    static isCursorPage<T>(value: unknown): value is CursorPage<T> {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === CursorPage.BRAND\n        );\n    }\n\n    constructor(\n        public readonly results: T[],\n        public readonly nextCursor: string | null,\n        public readonly previousCursor: string | null\n    ) {}\n\n    hasNext(): boolean {\n        return this.nextCursor !== null;\n    }\n\n    hasPrevious(): boolean {\n        return this.previousCursor !== null;\n    }\n\n    nextPageNumber(): number | null {\n        return null;\n    }\n\n    previousPageNumber(): number | null {\n        return null;\n    }\n\n    startIndex(): number {\n        return 0;\n    }\n\n    endIndex(): number {\n        return this.results.length;\n    }\n}\n\n/**\n * Cursor-based paginator for stable forward navigation with opaque cursor tokens.\n * It supports `limit`, `cursor`, and `ordering` query params and returns DRF-style\n * paginated envelopes with cursor links.\n */\nexport class CursorPaginator<T extends Record<string, unknown>> implements Paginator<T> {\n    static readonly BRAND = 'tango.resources.cursor_paginator' as const;\n    readonly __tangoBrand: typeof CursorPaginator.BRAND = CursorPaginator.BRAND;\n    private limit: number;\n    private cursor: string | null = null;\n    private direction: CursorDirection = 'asc';\n    private nextCursor: string | null = null;\n    private previousCursor: string | null = null;\n\n    constructor(\n        private queryset: QuerySet<T>,\n        private perPage: number = 25,\n        private cursorField: keyof T = 'id' as keyof T\n    ) {\n        this.limit = perPage;\n    }\n\n    static isCursorPaginator<T extends Record<string, unknown>>(value: unknown): value is CursorPaginator<T> {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === CursorPaginator.BRAND\n        );\n    }\n\n    parse(params: URLSearchParams): void {\n        const rawLimit = Number.parseInt(params.get('limit') ?? '', 10);\n        if (Number.isFinite(rawLimit) && rawLimit > 0) {\n            this.limit = Math.min(rawLimit, 100);\n        } else {\n            this.limit = this.perPage;\n        }\n\n        this.cursor = params.get('cursor');\n\n        const ordering = params.get('ordering');\n        if (ordering) {\n            const parsedDirection: CursorDirection = ordering.startsWith('-') ? 'desc' : 'asc';\n            const parsedField = ordering.startsWith('-') ? ordering.slice(1) : ordering;\n            this.direction = parsedField === String(this.cursorField) ? parsedDirection : 'asc';\n        } else {\n            this.direction = 'asc';\n        }\n    }\n\n    parseParams(params: URLSearchParams): { limit: number; offset: number } {\n        this.parse(params);\n        return { limit: this.limit, offset: 0 };\n    }\n\n    toResponse<TResult>(results: TResult[]): PaginatedResponse<TResult> {\n        const response: PaginatedResponse<TResult> = { results };\n        if (this.nextCursor) {\n            response.next = this.buildPageLink(this.nextCursor);\n        }\n        if (this.previousCursor) {\n            response.previous = this.buildPageLink(this.previousCursor);\n        }\n        return response;\n    }\n\n    getPaginatedResponse<TResult>(results: TResult[], _totalCount?: number): PaginatedResponse<TResult> {\n        return this.toResponse(results);\n    }\n\n    apply(queryset: QuerySet<T>): QuerySet<T> {\n        let qs = queryset.limit(this.limit + 1);\n        if (this.cursor) {\n            const decoded = this.decodeCursor(this.cursor);\n            if (decoded.field !== String(this.cursorField)) {\n                throw new Error('Invalid cursor: field mismatch');\n            }\n            const lookup = this.direction === 'asc' ? '__gt' : '__lt';\n            const fieldLookup = `${String(this.cursorField)}${lookup}`;\n            const filterInput = { [fieldLookup]: decoded.value } as FilterInput<T>;\n            qs = qs.filter(filterInput);\n        }\n        const orderToken = this.direction === 'asc' ? String(this.cursorField) : `-${String(this.cursorField)}`;\n        return qs.orderBy(orderToken as keyof T | `-${string}`);\n    }\n\n    async paginate(cursor?: string): Promise<Page<T>> {\n        const appliedCursor = cursor ?? this.cursor;\n        this.cursor = appliedCursor;\n        const fetched = await this.apply(this.queryset).fetch();\n        const results = [...fetched.results];\n        const hasMore = results.length > this.limit;\n\n        if (hasMore) {\n            results.pop();\n        }\n\n        this.previousCursor = appliedCursor ?? null;\n        const last = results.at(-1);\n        this.nextCursor = hasMore && last ? this.encodeCursor(last) : null;\n\n        return new CursorPage(results, this.nextCursor, this.previousCursor);\n    }\n\n    async getPage(page: number): Promise<Page<T>> {\n        if (page !== 1) {\n            throw new Error('CursorPaginator only supports getPage(1). Use cursor pagination for subsequent pages.');\n        }\n        return this.paginate();\n    }\n\n    private buildPageLink(cursor: string): string {\n        const orderingToken = this.direction === 'asc' ? String(this.cursorField) : `-${String(this.cursorField)}`;\n        return `?limit=${this.limit}&cursor=${encodeURIComponent(cursor)}&ordering=${encodeURIComponent(orderingToken)}`;\n    }\n\n    private encodeCursor(item: T): string {\n        const payload: CursorPayload = {\n            v: 1,\n            field: String(this.cursorField),\n            dir: this.direction,\n            value: item[this.cursorField],\n        };\n        return Buffer.from(JSON.stringify(payload), 'utf-8').toString('base64');\n    }\n\n    private decodeCursor(cursor: string): CursorPayload {\n        let parsed: unknown;\n        try {\n            parsed = JSON.parse(Buffer.from(cursor, 'base64').toString('utf-8'));\n        } catch {\n            throw new Error('Invalid cursor: malformed token');\n        }\n\n        if (\n            !parsed ||\n            typeof parsed !== 'object' ||\n            (parsed as { v?: unknown }).v !== 1 ||\n            typeof (parsed as { field?: unknown }).field !== 'string' ||\n            ((parsed as { dir?: unknown }).dir !== 'asc' && (parsed as { dir?: unknown }).dir !== 'desc') ||\n            !('value' in parsed)\n        ) {\n            throw new Error('Invalid cursor: unsupported payload');\n        }\n\n        return parsed as CursorPayload;\n    }\n}\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { OffsetPaginator } from '../paginators/OffsetPaginator';\nexport { CursorPaginator } from '../paginators/CursorPaginator';\nexport { PaginationInput } from './PaginationInput';\nexport type { PaginationInputValue } from './PaginationInput';\nexport type { Paginator, Page } from './Paginator';\nexport type { PaginatedResponse } from './PaginatedResponse';\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { CursorPaginator } from './CursorPaginator';\nexport { OffsetPaginator } from './OffsetPaginator';\n","import type { FilterInput, Repository } from '@danceroutine/tango-orm';\nimport type { z } from 'zod';\nimport type { RequestContext } from '../context/index';\nimport type { FilterSet } from '../filters/index';\nimport { OffsetPaginator } from '../paginators/OffsetPaginator';\nimport { toHttpError } from '@danceroutine/tango-core';\nimport { Q } from '@danceroutine/tango-orm';\n\n/**\n * Configuration for a ModelViewSet, defining how a model is exposed as an API resource.\n *\n * @template TModel - The record type of the underlying database model\n * @template TRead - Zod schema used to validate and shape read (GET) responses\n * @template TWrite - Zod schema used to validate incoming write (POST/PUT) request bodies\n *\n * @example\n * ```typescript\n * const config: ModelViewSetConfig<Post, typeof PostReadSchema, typeof PostWriteSchema> = {\n *   repository: postRepository,\n *   readSchema: PostReadSchema,\n *   writeSchema: PostWriteSchema,\n *   updateSchema: PostPatchSchema,\n *   filters: postFilterSet,\n *   orderingFields: ['createdAt', 'title'],\n *   searchFields: ['title', 'body'],\n * };\n * ```\n */\nexport interface ModelViewSetConfig<\n    TModel extends Record<string, unknown>,\n    TRead extends z.ZodType,\n    TWrite extends z.ZodObject<z.ZodRawShape>,\n> {\n    /** The repository instance used to query and persist model data */\n    repository: Repository<TModel>;\n\n    /** Zod schema applied to outgoing data (list and detail responses) */\n    readSchema: TRead;\n\n    /** Zod schema applied to incoming data for create operations */\n    writeSchema: TWrite;\n\n    /** Optional Zod schema for partial updates (PATCH). Falls back to writeSchema if omitted */\n    updateSchema?: z.ZodType<Partial<TModel>>;\n\n    /** Optional filter set defining which query parameters can filter the list endpoint */\n    filters?: FilterSet<TModel>;\n\n    /** Fields that clients are allowed to sort by via query parameters */\n    orderingFields?: (keyof TModel)[];\n\n    /** Fields that are searched when a free-text search query parameter is provided */\n    searchFields?: (keyof TModel)[];\n}\n\n/**\n * Base class for creating RESTful API viewsets with built-in CRUD operations.\n * Provides list, retrieve, create, update, and delete methods with filtering,\n * search, pagination, and ordering support.\n */\nexport abstract class ModelViewSet<\n    TModel extends Record<string, unknown>,\n    TRead extends z.ZodType,\n    TWrite extends z.ZodObject<z.ZodRawShape>,\n> {\n    static readonly BRAND = 'tango.resources.model_view_set' as const;\n    protected repository: Repository<TModel>;\n    protected readSchema: TRead;\n    protected writeSchema: TWrite;\n    protected updateSchema: z.ZodType<Partial<TModel>>;\n    protected filters?: FilterSet<TModel>;\n    protected orderingFields: (keyof TModel)[];\n    protected searchFields: (keyof TModel)[];\n    readonly __tangoBrand: typeof ModelViewSet.BRAND = ModelViewSet.BRAND;\n\n    static isModelViewSet(\n        value: unknown\n    ): value is ModelViewSet<Record<string, unknown>, z.ZodType, z.ZodObject<z.ZodRawShape>> {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === ModelViewSet.BRAND\n        );\n    }\n\n    constructor(config: ModelViewSetConfig<TModel, TRead, TWrite>) {\n        this.repository = config.repository;\n        this.readSchema = config.readSchema;\n        this.writeSchema = config.writeSchema;\n        this.updateSchema = config.updateSchema ?? (config.writeSchema.partial() as z.ZodType<Partial<TModel>>);\n        this.filters = config.filters;\n        this.orderingFields = config.orderingFields ?? [];\n        this.searchFields = config.searchFields ?? [];\n    }\n\n    async list(ctx: RequestContext): Promise<Response> {\n        try {\n            const params = new URL(ctx.request.url).searchParams;\n            const paginator = new OffsetPaginator<TModel>(this.repository.query());\n            paginator.parse(params);\n\n            let qs = this.repository.query();\n\n            if (this.filters) {\n                const filterInputs = this.filters.apply(params);\n                if (filterInputs.length > 0) {\n                    qs = qs.filter(Q.and(...filterInputs));\n                }\n            }\n\n            const search = params.get('search');\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.get('ordering');\n            if (ordering) {\n                const orderTokens = ordering.split(',').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            qs = paginator.apply(qs);\n\n            const [result, totalCount] = await Promise.all([qs.fetch(this.readSchema), qs.count()]);\n            const response = paginator.toResponse<z.output<TRead>>(result.results, { totalCount });\n\n            return new Response(JSON.stringify(response), {\n                status: 200,\n                headers: { 'Content-Type': 'application/json' },\n            });\n        } catch (error) {\n            return this.handleError(error);\n        }\n    }\n\n    async retrieve(_ctx: RequestContext, id: string): Promise<Response> {\n        try {\n            const pk = this.repository.meta.pk;\n            const filterById = { [pk]: id } as FilterInput<TModel>;\n            const result = await this.repository\n                .query()\n                .filter(filterById)\n                .fetchOne(this.readSchema);\n\n            if (!result) {\n                return new Response(JSON.stringify({ error: 'Not found' }), {\n                    status: 404,\n                    headers: { 'Content-Type': 'application/json' },\n                });\n            }\n\n            return new Response(JSON.stringify(result), {\n                status: 200,\n                headers: { 'Content-Type': 'application/json' },\n            });\n        } catch (error) {\n            return this.handleError(error);\n        }\n    }\n\n    async create(ctx: RequestContext): Promise<Response> {\n        try {\n            const body = await ctx.request.json();\n            const validated = this.writeSchema.parse(body);\n\n            const created = await this.repository.create(validated as Partial<TModel>);\n            const result = this.readSchema.parse(created);\n\n            return new Response(JSON.stringify(result), {\n                status: 201,\n                headers: { 'Content-Type': 'application/json' },\n            });\n        } catch (error) {\n            return this.handleError(error);\n        }\n    }\n\n    async update(ctx: RequestContext, id: string): Promise<Response> {\n        try {\n            const body = await ctx.request.json();\n            const validated = this.updateSchema.parse(body);\n\n            const pkValue = id as TModel[keyof TModel];\n\n            const updated = await this.repository.update(pkValue, validated as Partial<TModel>);\n            const result = this.readSchema.parse(updated);\n\n            return new Response(JSON.stringify(result), {\n                status: 200,\n                headers: { 'Content-Type': 'application/json' },\n            });\n        } catch (error) {\n            return this.handleError(error);\n        }\n    }\n\n    async destroy(_ctx: RequestContext, id: string): Promise<Response> {\n        try {\n            const pkValue = id as TModel[keyof TModel];\n\n            await this.repository.delete(pkValue);\n\n            return new Response(null, { status: 204 });\n        } catch (error) {\n            return this.handleError(error);\n        }\n    }\n\n    protected handleError(error: unknown): Response {\n        const httpError = toHttpError(error);\n        return new Response(JSON.stringify(httpError.body), {\n            status: httpError.status,\n            headers: { 'Content-Type': 'application/json' },\n        });\n    }\n}\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { ModelViewSet, type ModelViewSetConfig } from './ModelViewSet';\n","/**\n * Compatibility aggregate barrel. Canonical source-of-truth types now live in\n * `filters`, `pagination`, and `viewset` subdomains.\n */\n\nexport type { FilterType, RangeOperator } from '../filters/index';\nexport type { ModelViewSetConfig } from '../viewset/index';\nexport type { PaginatedResponse, Paginator, Page } from '../pagination/index';\nexport { PaginationInput } from '../pagination/index';\n"],"mappings":"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"}

package/dist/pagination/PaginatedResponse.d.ts

@@ -0,0 +1,6 @@
+export interface PaginatedResponse<T> {
+    results: T[];
+    count?: number;
+    next?: string | null;
+    previous?: string | null;
+}

package/dist/pagination/PaginationInput.d.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+export type PaginationInputValue = {
+    limit: number;
+    offset: number;
+    page?: number;
+};
+export declare const PaginationInput: z.ZodType<PaginationInputValue>;

package/dist/pagination/Paginator.d.ts

@@ -0,0 +1,18 @@
+import type { PaginatedResponse } from './PaginatedResponse';
+import type { QuerySet } from '@danceroutine/tango-orm';
+export interface Page<T> {
+    results: T[];
+    hasNext(): boolean;
+    hasPrevious(): boolean;
+    nextPageNumber(): number | null;
+    previousPageNumber(): number | null;
+    startIndex(): number;
+    endIndex(): number;
+}
+export interface Paginator<TModel extends Record<string, unknown>, TResult = TModel> {
+    parse(params: URLSearchParams): void;
+    apply(queryset: QuerySet<TModel>): QuerySet<TModel>;
+    toResponse(results: TResult[], context?: {
+        totalCount?: number;
+    }): PaginatedResponse<TResult>;
+}

package/dist/pagination/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Domain boundary barrel: centralizes this subdomain's public contract.
+ */
+export { OffsetPaginator } from '../paginators/OffsetPaginator';
+export { CursorPaginator } from '../paginators/CursorPaginator';
+export { PaginationInput } from './PaginationInput';
+export type { PaginationInputValue } from './PaginationInput';
+export type { Paginator, Page } from './Paginator';
+export type { PaginatedResponse } from './PaginatedResponse';

package/dist/paginators/CursorPaginator.d.ts

@@ -0,0 +1,35 @@
+import type { QuerySet } from '@danceroutine/tango-orm';
+import type { Paginator, Page } from '../pagination/Paginator';
+import type { PaginatedResponse } from '../pagination/PaginatedResponse';
+/**
+ * Cursor-based paginator for stable forward navigation with opaque cursor tokens.
+ * It supports `limit`, `cursor`, and `ordering` query params and returns DRF-style
+ * paginated envelopes with cursor links.
+ */
+export declare class CursorPaginator<T extends Record<string, unknown>> implements Paginator<T> {
+    private queryset;
+    private perPage;
+    private cursorField;
+    static readonly BRAND: "tango.resources.cursor_paginator";
+    readonly __tangoBrand: typeof CursorPaginator.BRAND;
+    private limit;
+    private cursor;
+    private direction;
+    private nextCursor;
+    private previousCursor;
+    constructor(queryset: QuerySet<T>, perPage?: number, cursorField?: keyof T);
+    static isCursorPaginator<T extends Record<string, unknown>>(value: unknown): value is CursorPaginator<T>;
+    parse(params: URLSearchParams): void;
+    parseParams(params: URLSearchParams): {
+        limit: number;
+        offset: number;
+    };
+    toResponse<TResult>(results: TResult[]): PaginatedResponse<TResult>;
+    getPaginatedResponse<TResult>(results: TResult[], _totalCount?: number): PaginatedResponse<TResult>;
+    apply(queryset: QuerySet<T>): QuerySet<T>;
+    paginate(cursor?: string): Promise<Page<T>>;
+    getPage(page: number): Promise<Page<T>>;
+    private buildPageLink;
+    private encodeCursor;
+    private decodeCursor;
+}

package/dist/paginators/OffsetPaginator.d.ts

@@ -0,0 +1,48 @@
+import type { QuerySet } from '@danceroutine/tango-orm';
+import type { Paginator, Page } from '../pagination/Paginator';
+import type { PaginatedResponse } from '../pagination/PaginatedResponse';
+/**
+ * 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);
+ * ```
+ */
+export declare class OffsetPaginator<T extends Record<string, unknown>> implements Paginator<T> {
+    private queryset;
+    private perPage;
+    static readonly BRAND: "tango.resources.offset_paginator";
+    readonly __tangoBrand: typeof OffsetPaginator.BRAND;
+    private limit;
+    private offset;
+    constructor(queryset: QuerySet<T>, perPage?: number);
+    static isOffsetPaginator<T extends Record<string, unknown>>(value: unknown): value is OffsetPaginator<T>;
+    /**
+     * Parse limit, offset, and page from URL search params.
+     * If `page` is provided, it's converted to an offset.
+     * Stores parsed values for use by getPaginatedResponse.
+     */
+    parse(params: URLSearchParams): void;
+    parseParams(params: URLSearchParams): {
+        limit: number;
+        offset: number;
+    };
+    /**
+     * Build a DRF-style paginated response with count, next, and previous links.
+     * Uses the limit/offset stored from the most recent parseParams call.
+     */
+    toResponse<TResult>(results: TResult[], context?: {
+        totalCount?: number;
+    }): PaginatedResponse<TResult>;
+    getPaginatedResponse<TResult>(results: TResult[], totalCount?: number): PaginatedResponse<TResult>;
+    apply(queryset: QuerySet<T>): QuerySet<T>;
+    paginate(page: number): Promise<Page<T>>;
+    getPage(page: number): Promise<Page<T>>;
+    count(): Promise<number>;
+}

package/dist/paginators/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Domain boundary barrel: centralizes this subdomain's public contract.
+ */
+export { CursorPaginator } from './CursorPaginator';
+export { OffsetPaginator } from './OffsetPaginator';

package/dist/viewset/ModelViewSet.d.ts

@@ -0,0 +1,64 @@
+import type { Repository } from '@danceroutine/tango-orm';
+import type { z } from 'zod';
+import type { RequestContext } from '../context/index';
+import type { FilterSet } from '../filters/index';
+/**
+ * Configuration for a ModelViewSet, defining how a model is exposed as an API resource.
+ *
+ * @template TModel - The record type of the underlying database model
+ * @template TRead - Zod schema used to validate and shape read (GET) responses
+ * @template TWrite - Zod schema used to validate incoming write (POST/PUT) request bodies
+ *
+ * @example
+ * ```typescript
+ * const config: ModelViewSetConfig<Post, typeof PostReadSchema, typeof PostWriteSchema> = {
+ *   repository: postRepository,
+ *   readSchema: PostReadSchema,
+ *   writeSchema: PostWriteSchema,
+ *   updateSchema: PostPatchSchema,
+ *   filters: postFilterSet,
+ *   orderingFields: ['createdAt', 'title'],
+ *   searchFields: ['title', 'body'],
+ * };
+ * ```
+ */
+export interface ModelViewSetConfig<TModel extends Record<string, unknown>, TRead extends z.ZodType, TWrite extends z.ZodObject<z.ZodRawShape>> {
+    /** The repository instance used to query and persist model data */
+    repository: Repository<TModel>;
+    /** Zod schema applied to outgoing data (list and detail responses) */
+    readSchema: TRead;
+    /** Zod schema applied to incoming data for create operations */
+    writeSchema: TWrite;
+    /** Optional Zod schema for partial updates (PATCH). Falls back to writeSchema if omitted */
+    updateSchema?: z.ZodType<Partial<TModel>>;
+    /** Optional filter set defining which query parameters can filter the list endpoint */
+    filters?: FilterSet<TModel>;
+    /** Fields that clients are allowed to sort by via query parameters */
+    orderingFields?: (keyof TModel)[];
+    /** Fields that are searched when a free-text search query parameter is provided */
+    searchFields?: (keyof TModel)[];
+}
+/**
+ * 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.
+ */
+export declare abstract class ModelViewSet<TModel extends Record<string, unknown>, TRead extends z.ZodType, TWrite extends z.ZodObject<z.ZodRawShape>> {
+    static readonly BRAND: "tango.resources.model_view_set";
+    protected repository: Repository<TModel>;
+    protected readSchema: TRead;
+    protected writeSchema: TWrite;
+    protected updateSchema: z.ZodType<Partial<TModel>>;
+    protected filters?: FilterSet<TModel>;
+    protected orderingFields: (keyof TModel)[];
+    protected searchFields: (keyof TModel)[];
+    readonly __tangoBrand: typeof ModelViewSet.BRAND;
+    static isModelViewSet(value: unknown): value is ModelViewSet<Record<string, unknown>, z.ZodType, z.ZodObject<z.ZodRawShape>>;
+    constructor(config: ModelViewSetConfig<TModel, TRead, TWrite>);
+    list(ctx: RequestContext): Promise<Response>;
+    retrieve(_ctx: RequestContext, id: string): Promise<Response>;
+    create(ctx: RequestContext): Promise<Response>;
+    update(ctx: RequestContext, id: string): Promise<Response>;
+    destroy(_ctx: RequestContext, id: string): Promise<Response>;
+    protected handleError(error: unknown): Response;
+}

package/dist/viewset/ModelViewSet.js

@@ -0,0 +1,143 @@
+import { OffsetPaginator } from '../paginators/OffsetPaginator';
+import { toHttpError } from '@danceroutine/tango-core';
+import { Q } from '@danceroutine/tango-orm';
+/**
+ * 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.
+ */
+export class ModelViewSet {
+    static BRAND = 'tango.resources.model_view_set';
+    repository;
+    readSchema;
+    writeSchema;
+    updateSchema;
+    filters;
+    orderingFields;
+    searchFields;
+    __tangoBrand = ModelViewSet.BRAND;
+    static isModelViewSet(value) {
+        return (typeof value === 'object' &&
+            value !== null &&
+            value.__tangoBrand === ModelViewSet.BRAND);
+    }
+    constructor(config) {
+        this.repository = config.repository;
+        this.readSchema = config.readSchema;
+        this.writeSchema = config.writeSchema;
+        this.updateSchema = config.updateSchema ?? config.writeSchema.partial();
+        this.filters = config.filters;
+        this.orderingFields = config.orderingFields ?? [];
+        this.searchFields = config.searchFields ?? [];
+    }
+    async list(ctx) {
+        try {
+            const params = new URL(ctx.request.url).searchParams;
+            const paginator = new OffsetPaginator(this.repository.query());
+            paginator.parse(params);
+            let qs = this.repository.query();
+            if (this.filters) {
+                const filterInputs = this.filters.apply(params);
+                if (filterInputs.length > 0) {
+                    qs = qs.filter(Q.and(...filterInputs));
+                }
+            }
+            const search = params.get('search');
+            if (search && this.searchFields.length > 0) {
+                const searchFilters = this.searchFields.map((field) => {
+                    const lookup = `${String(field)}__icontains`;
+                    return { [lookup]: search };
+                });
+                qs = qs.filter(Q.or(...searchFilters));
+            }
+            const ordering = params.get('ordering');
+            if (ordering) {
+                const orderTokens = ordering.split(',').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));
+                }
+            }
+            qs = paginator.apply(qs);
+            const [result, totalCount] = await Promise.all([qs.fetch(this.readSchema), qs.count()]);
+            const response = paginator.toResponse(result.results, { totalCount });
+            return new Response(JSON.stringify(response), {
+                status: 200,
+                headers: { 'Content-Type': 'application/json' },
+            });
+        }
+        catch (error) {
+            return this.handleError(error);
+        }
+    }
+    async retrieve(_ctx, id) {
+        try {
+            const pk = this.repository.meta.pk;
+            const filterById = { [pk]: id };
+            const result = await this.repository.query().filter(filterById).fetchOne(this.readSchema);
+            if (!result) {
+                return new Response(JSON.stringify({ error: 'Not found' }), {
+                    status: 404,
+                    headers: { 'Content-Type': 'application/json' },
+                });
+            }
+            return new Response(JSON.stringify(result), {
+                status: 200,
+                headers: { 'Content-Type': 'application/json' },
+            });
+        }
+        catch (error) {
+            return this.handleError(error);
+        }
+    }
+    async create(ctx) {
+        try {
+            const body = await ctx.request.json();
+            const validated = this.writeSchema.parse(body);
+            const created = await this.repository.create(validated);
+            const result = this.readSchema.parse(created);
+            return new Response(JSON.stringify(result), {
+                status: 201,
+                headers: { 'Content-Type': 'application/json' },
+            });
+        }
+        catch (error) {
+            return this.handleError(error);
+        }
+    }
+    async update(ctx, id) {
+        try {
+            const body = await ctx.request.json();
+            const validated = this.updateSchema.parse(body);
+            const pkValue = id;
+            const updated = await this.repository.update(pkValue, validated);
+            const result = this.readSchema.parse(updated);
+            return new Response(JSON.stringify(result), {
+                status: 200,
+                headers: { 'Content-Type': 'application/json' },
+            });
+        }
+        catch (error) {
+            return this.handleError(error);
+        }
+    }
+    async destroy(_ctx, id) {
+        try {
+            const pkValue = id;
+            await this.repository.delete(pkValue);
+            return new Response(null, { status: 204 });
+        }
+        catch (error) {
+            return this.handleError(error);
+        }
+    }
+    handleError(error) {
+        const httpError = toHttpError(error);
+        return new Response(JSON.stringify(httpError.body), {
+            status: httpError.status,
+            headers: { 'Content-Type': 'application/json' },
+        });
+    }
+}

package/dist/viewset/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Domain boundary barrel: centralizes this subdomain's public contract.
+ */
+export { ModelViewSet, type ModelViewSetConfig } from './ModelViewSet';

package/package.json

@@ -0,0 +1,75 @@
+{
+    "name": "@danceroutine/tango-resources",
+    "version": "0.1.0",
+    "description": "ModelViewSet, mixins, filters, and pagination for Tango",
+    "type": "module",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        },
+        "./context": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        },
+        "./filters": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        },
+        "./pagination": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        },
+        "./paginators": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        },
+        "./viewset": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        },
+        "./domain": {
+            "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",
+        "resources",
+        "viewset",
+        "crud",
+        "rest"
+    ],
+    "author": "Pedro Del Moral Lopez",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/danceroutine/tango.git",
+        "directory": "packages/resources"
+    },
+    "dependencies": {
+        "@danceroutine/tango-core": "workspace:*",
+        "@danceroutine/tango-orm": "workspace:*",
+        "zod": "^4.0.0"
+    },
+    "devDependencies": {
+        "@danceroutine/tango-schema": "workspace:*",
+        "@danceroutine/tango-testing": "workspace:*",
+        "@types/node": "^22.9.0",
+        "tsdown": "^0.4.0",
+        "typescript": "^5.6.3",
+        "vitest": "^4.0.6",
+        "zod": "^4.0.0"
+    }
+}