@danceroutine/tango-resources 1.11.1 → 1.11.2

package/dist/index.d.ts

@@ -1,23 +1,12 @@
-/**
- * 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 resource from './resource/index';
-export * as serializer from './serializer/index';
-export * as viewset from './viewset/index';
-export * as view from './view/index';
-export { RequestContext } from './context/index';
-export type { BaseUser } from './context/index';
-export { FilterSet, type AliasFilterDeclaration, type FieldFilterDeclaration, type FilterLookup, type FilterResolver, type FilterSetDefineConfig, type FilterValueParser, } from './filters/index';
-export type { FilterType, RangeOperator } from './filters/index';
-export { CursorPaginator, OffsetPaginator, CursorPaginationInput, OffsetPaginationInput, type Page, type BasePaginatedResponse, type CursorPaginatedResponse, type OffsetPaginatedResponse, type PaginatedResponse, type Paginator, } from './pagination/index';
-export { Serializer, ModelSerializer, relation, type SerializerClass, type AnySerializerClass, type SerializerCreateInput, type SerializerUpdateInput, type SerializerOutput, type SerializerSchema, type ModelSerializerClass, type AnyModelSerializer, type AnyModelSerializerClass, type ModelSerializerRelationFields, type ManyToManyManagerKeys, type ManyToManyRelationField, type ManyToManyReadStrategy, type ManyToManyWriteStrategy, } from './serializer/index';
-export { ModelViewSet } from './viewset/index';
-export type { ModelViewSetOpenAPIDescription, ModelViewSetConfig, ViewSetActionDescriptor, ViewSetActionMethod, ViewSetActionScope, ResolvedViewSetActionDescriptor, } from './viewset/index';
-export { APIView, GenericAPIView, ListModelMixin, CreateModelMixin, RetrieveModelMixin, UpdateModelMixin, DestroyModelMixin, ListAPIView, CreateAPIView, RetrieveAPIView, ListCreateAPIView, RetrieveUpdateAPIView, RetrieveDestroyAPIView, RetrieveUpdateDestroyAPIView, } from './view/index';
-export type { APIViewMethod, GenericAPIViewConfig, GenericAPIViewOpenAPIDescription } from './view/index';
-export type { ResourceModelFieldMetadata, ResourceModelLike, ResourceModelMetadata } from './resource/index';
+import { $ as Page, A as ManyToManyManagerKeys, B as SerializerOutput, C as ViewSetActionMethod, D as AnyModelSerializerClass, E as AnyModelSerializer, F as relation, G as ResourceModelFieldMetadata, H as SerializerUpdateInput, I as AnySerializerClass, J as index_d_exports$2, K as ResourceModelLike, L as Serializer, M as ManyToManyRelationField, N as ManyToManyWriteStrategy, O as ModelSerializer, P as ModelSerializerRelationFields, Q as OffsetPaginator, R as SerializerClass, S as ViewSetActionDescriptor, T as index_d_exports$5, U as APIView, V as SerializerSchema, W as APIViewMethod, X as OffsetPaginationInput, Y as CursorPaginationInput, Z as CursorPaginator, _ as GenericAPIViewOpenAPIDescription, _t as RequestContext, a as ListCreateAPIView, at as index_d_exports$1, b as ModelViewSetConfig, c as ListAPIView, ct as FilterLookup, d as RetrieveModelMixin, dt as FilterSetDefineConfig, et as Paginator, f as CreateModelMixin, ft as FilterValueParser, g as index_d_exports$4, gt as BaseUser, h as GenericAPIViewConfig, ht as index_d_exports, i as RetrieveUpdateAPIView, it as PaginatedResponse, j as ManyToManyReadStrategy, k as ModelSerializerClass, l as DestroyModelMixin, lt as FilterResolver, m as GenericAPIView, mt as FilterType, n as RetrieveUpdateDestroyAPIView, nt as CursorPaginatedResponse, o as RetrieveAPIView, ot as AliasFilterDeclaration, p as ListModelMixin, pt as RangeOperator, q as ResourceModelMetadata, r as RetrieveDestroyAPIView, rt as OffsetPaginatedResponse, s as CreateAPIView, st as FieldFilterDeclaration, t as index_d_exports$6, tt as BasePaginatedResponse, u as UpdateModelMixin, ut as FilterSet, v as ModelViewSetOpenAPIDescription, w as ViewSetActionScope, x as ResolvedViewSetActionDescriptor, y as ModelViewSet, z as SerializerCreateInput } from "./index-D6sfTSEj.js";
+
+//#region src/paginators/index.d.ts
+declare namespace index_d_exports$3 {
+  export { CursorPaginator, OffsetPaginator };
+}
+declare namespace index_d_exports$7 {
+  export { ModelViewSet, ModelViewSetConfig, ModelViewSetOpenAPIDescription, ResolvedViewSetActionDescriptor, ViewSetActionDescriptor, ViewSetActionMethod, ViewSetActionScope };
+}
+//#endregion
+export { APIView, type APIViewMethod, type AliasFilterDeclaration, type AnyModelSerializer, type AnyModelSerializerClass, type AnySerializerClass, type BasePaginatedResponse, type BaseUser, CreateAPIView, CreateModelMixin, type CursorPaginatedResponse, CursorPaginationInput, CursorPaginator, DestroyModelMixin, type FieldFilterDeclaration, type FilterLookup, type FilterResolver, FilterSet, type FilterSetDefineConfig, type FilterType, type FilterValueParser, GenericAPIView, type GenericAPIViewConfig, type GenericAPIViewOpenAPIDescription, ListAPIView, ListCreateAPIView, ListModelMixin, type ManyToManyManagerKeys, type ManyToManyReadStrategy, type ManyToManyRelationField, type ManyToManyWriteStrategy, ModelSerializer, type ModelSerializerClass, type ModelSerializerRelationFields, ModelViewSet, type ModelViewSetConfig, type ModelViewSetOpenAPIDescription, type OffsetPaginatedResponse, OffsetPaginationInput, OffsetPaginator, type Page, type PaginatedResponse, type Paginator, type RangeOperator, RequestContext, type ResolvedViewSetActionDescriptor, type ResourceModelFieldMetadata, type ResourceModelLike, type ResourceModelMetadata, RetrieveAPIView, RetrieveDestroyAPIView, RetrieveModelMixin, RetrieveUpdateAPIView, RetrieveUpdateDestroyAPIView, Serializer, type SerializerClass, type SerializerCreateInput, type SerializerOutput, type SerializerSchema, type SerializerUpdateInput, UpdateModelMixin, type ViewSetActionDescriptor, type ViewSetActionMethod, type ViewSetActionScope, index_d_exports as context, index_d_exports$1 as filters, index_d_exports$2 as pagination, index_d_exports$3 as paginators, relation, index_d_exports$4 as resource, index_d_exports$5 as serializer, index_d_exports$6 as view, index_d_exports$7 as viewset };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,64 +1,8 @@
-import { APIView, BasePaginator, CreateAPIView, CreateModelMixin, DestroyModelMixin, GenericAPIView, ListAPIView, ListCreateAPIView, ListModelMixin, OffsetPaginationInput, OffsetPaginator, RetrieveAPIView, RetrieveDestroyAPIView, RetrieveModelMixin, RetrieveUpdateAPIView, RetrieveUpdateDestroyAPIView, UpdateModelMixin, __export, inferModelFieldParsers, view_exports } from "./view-DUHg6AXl.js";
-import { HttpErrorFactory, NotFoundError, TangoRequest, TangoResponse, getLogger } from "@danceroutine/tango-core";
+import { t as __exportAll } from "./chunk-D7D4PA-g.js";
+import { _ as OffsetPaginator, a as ListCreateAPIView, b as context_exports, c as ListAPIView, d as RetrieveModelMixin, f as CreateModelMixin, g as inferModelFieldParsers, h as APIView, i as RetrieveUpdateAPIView, l as DestroyModelMixin, m as GenericAPIView, n as RetrieveUpdateDestroyAPIView, o as RetrieveAPIView, p as ListModelMixin, r as RetrieveDestroyAPIView, s as CreateAPIView, t as view_exports, u as UpdateModelMixin, v as OffsetPaginationInput, x as RequestContext, y as BasePaginator } from "./view-C9B5Lln3.js";
+import { HttpErrorFactory, NotFoundError, TangoResponse, getLogger } from "@danceroutine/tango-core";
 import { ManyToManyRelatedManager, Q } from "@danceroutine/tango-orm";
-import { z, z as z$1 } from "zod";
-
-//#region src/context/RequestContext.ts
-var RequestContext = class RequestContext {
-	static BRAND = "tango.resources.request_context";
-	__tangoBrand = RequestContext.BRAND;
-	state = 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 = {};
-__export(context_exports, { RequestContext: () => RequestContext });
-
-//#endregion
+import { z } from "zod";
 //#region src/filters/internal/InternalFilterType.ts
 const InternalFilterType = {
 	SCALAR: "scalar",
@@ -67,7 +11,6 @@ const InternalFilterType = {
 	IN: "in",
 	CUSTOM: "custom"
 };
-
 //#endregion
 //#region src/filters/internal/InternalFilterLookup.ts
 const InternalFilterLookup = {
@@ -85,14 +28,21 @@ const InternalFilterLookup = {
 	ENDSWITH: "endswith",
 	IENDSWITH: "iendswith"
 };
-
 //#endregion
 //#region src/filters/FilterSet.ts
 const FILTER_LOOKUPS = Object.values(InternalFilterLookup);
 function isFilterLookup(value) {
 	return FILTER_LOOKUPS.includes(value);
 }
+/**
+* Declarative query-param to filter translation.
+*
+* A `FilterSet` lets viewsets expose safe, explicit filtering behavior
+* without leaking raw ORM filter syntax to request handlers.
+*/
 var FilterSet = class FilterSet {
+	spec;
+	allowAllParams;
 	static BRAND = "tango.resources.filter_set";
 	__tangoBrand = FilterSet.BRAND;
 	/**
@@ -106,8 +56,7 @@ var FilterSet = class FilterSet {
 	* Build a filter set from Django-style field declarations.
 	*/
 	static define(config) {
-		const spec = FilterSet.normalizeDefineConfig(config);
-		return new FilterSet(spec, config.all === "__all__");
+		return new FilterSet(FilterSet.normalizeDefineConfig(config), config.all === "__all__");
 	}
 	/**
 	* Narrow an unknown value to `FilterSet`.
@@ -121,7 +70,7 @@ var FilterSet = class FilterSet {
 		const fieldParsers = config.parsers ?? {};
 		for (const rawField of Object.keys(fieldDeclarations)) {
 			const declaration = fieldDeclarations[rawField];
-			if (declaration === undefined) continue;
+			if (declaration === void 0) continue;
 			const parser = fieldParsers[rawField];
 			FilterSet.addFieldDeclaration(spec, rawField, declaration, parser);
 		}
@@ -171,7 +120,7 @@ var FilterSet = class FilterSet {
 		].includes(value.type);
 	}
 	static createMultiFieldResolver(fields, lookup, parser) {
-		if (lookup === InternalFilterLookup.ICONTAINS && parser === undefined) return {
+		if (lookup === InternalFilterLookup.ICONTAINS && parser === void 0) return {
 			type: InternalFilterType.ILIKE,
 			columns: [...fields]
 		};
@@ -179,23 +128,23 @@ var FilterSet = class FilterSet {
 			type: InternalFilterType.CUSTOM,
 			apply: (raw) => {
 				const parsed = FilterSet.resolveParserValue(raw, parser);
-				if (parsed === undefined) return undefined;
+				if (parsed === void 0) return void 0;
 				const composed = {};
 				for (const field of fields) {
 					const segment = FilterSet.resolveLookupFilter(field, lookup, parsed);
 					if (!segment) continue;
 					Object.assign(composed, segment);
 				}
-				return Object.keys(composed).length > 0 ? composed : undefined;
+				return Object.keys(composed).length > 0 ? composed : void 0;
 			}
 		};
 	}
 	static createLookupResolver(field, lookup, parser) {
-		if (parser !== undefined) return {
+		if (parser !== void 0) return {
 			type: InternalFilterType.CUSTOM,
 			apply: (raw) => {
 				const parsed = FilterSet.resolveParserValue(raw, parser);
-				if (parsed === undefined) return undefined;
+				if (parsed === void 0) return void 0;
 				return FilterSet.resolveLookupFilter(field, lookup, parsed);
 			}
 		};
@@ -227,27 +176,22 @@ var FilterSet = class FilterSet {
 		}
 	}
 	static resolveLookupFilter(field, lookup, value) {
-		if (value === undefined) return undefined;
+		if (value === void 0) return void 0;
 		if (lookup === "exact") return { [field]: value };
 		if (lookup === "in") {
 			const arr = Array.isArray(value) ? value : String(value).split(",");
-			const lookupKey$1 = `${String(field)}__in`;
-			return { [lookupKey$1]: arr };
+			return { [`${String(field)}__in`]: arr };
 		}
-		if (lookup === "icontains") {
-			const lookupKey$1 = `${String(field)}__icontains`;
-			return { [lookupKey$1]: `%${FilterSet.toScalarString(value)}%` };
-		}
-		const lookupKey = `${String(field)}__${lookup}`;
-		return { [lookupKey]: value };
+		if (lookup === "icontains") return { [`${String(field)}__icontains`]: `%${FilterSet.toScalarString(value)}%` };
+		return { [`${String(field)}__${lookup}`]: value };
 	}
 	static resolveLookupParam(baseParam, lookup) {
 		if (lookup === "exact") return baseParam;
 		return `${baseParam}__${lookup}`;
 	}
 	static resolveParserValue(value, parser) {
-		if (value === undefined) return undefined;
-		if (parser === undefined) return value;
+		if (value === void 0) return;
+		if (parser === void 0) return value;
 		return parser(value);
 	}
 	static toScalarString(value) {
@@ -272,14 +216,14 @@ var FilterSet = class FilterSet {
 	*/
 	apply(params) {
 		const filters = [];
-		const keys = new Set();
+		const keys = /* @__PURE__ */ new Set();
 		for (const [key] of params.entries()) keys.add(key);
 		for (const key of keys) {
-			const resolver = this.spec[key] ?? (this.allowAllParams ? this.buildAllResolver(key) : undefined);
+			const resolver = this.spec[key] ?? (this.allowAllParams ? this.buildAllResolver(key) : void 0);
 			if (!resolver) continue;
 			const rawValue = params.getAll(key);
 			const value = rawValue.length > 1 ? rawValue : rawValue[0];
-			if (value === undefined) continue;
+			if (value === void 0) continue;
 			const filter = this.resolveFilter(resolver, value);
 			if (filter) filters.push(filter);
 		}
@@ -287,11 +231,11 @@ var FilterSet = class FilterSet {
 	}
 	buildAllResolver(param) {
 		const segments = param.split("__").filter(Boolean);
-		if (segments.length === 0) return undefined;
+		if (segments.length === 0) return;
 		const lastSegment = segments.at(-1);
 		const lookup = isFilterLookup(lastSegment) ? lastSegment : "exact";
 		const field = (lookup === "exact" ? segments : segments.slice(0, -1)).join("__");
-		if (!field) return undefined;
+		if (!field) return;
 		if (lookup === "exact") return {
 			type: InternalFilterType.SCALAR,
 			column: field
@@ -299,7 +243,7 @@ var FilterSet = class FilterSet {
 		return FilterSet.createLookupResolver(field, lookup);
 	}
 	resolveFilter(resolver, value) {
-		if (value === undefined) return undefined;
+		if (value === void 0) return void 0;
 		switch (resolver.type) {
 			case InternalFilterType.SCALAR: return { [resolver.column]: value };
 			case InternalFilterType.ILIKE: {
@@ -310,17 +254,13 @@ var FilterSet = class FilterSet {
 				});
 				return filter;
 			}
-			case InternalFilterType.RANGE: {
-				const lookupKey = `${String(resolver.column)}__${resolver.op}`;
-				return { [lookupKey]: value };
-			}
+			case InternalFilterType.RANGE: return { [`${String(resolver.column)}__${resolver.op}`]: value };
 			case InternalFilterType.IN: {
 				const arr = Array.isArray(value) ? value : String(value).split(",");
-				const lookupKey = `${String(resolver.column)}__in`;
-				return { [lookupKey]: arr };
+				return { [`${String(resolver.column)}__in`]: arr };
 			}
 			case InternalFilterType.CUSTOM: return resolver.apply(value);
-			default: return undefined;
+			default: return;
 		}
 	}
 	applyFieldParserOverride(resolver, parsers) {
@@ -341,28 +281,31 @@ var FilterSet = class FilterSet {
 		}
 	}
 };
-
 //#endregion
 //#region src/filters/index.ts
-var filters_exports = {};
-__export(filters_exports, { FilterSet: () => FilterSet });
-
+var filters_exports = /* @__PURE__ */ __exportAll({ FilterSet: () => FilterSet });
 //#endregion
 //#region src/pagination/CursorPaginationInput.ts
-const CursorPaginationInput = z$1.object({
-	limit: z$1.preprocess((value) => {
-		if (value === undefined || value === null || value === "") return undefined;
+const CursorPaginationInput = z.object({
+	limit: z.preprocess((value) => {
+		if (value === void 0 || value === null || value === "") return;
 		const parsed = Number.parseInt(String(value), 10);
-		if (!Number.isFinite(parsed) || parsed <= 0) return undefined;
+		if (!Number.isFinite(parsed) || parsed <= 0) return;
 		return parsed;
-	}, z$1.number().int().min(1).transform((value) => Math.min(value, 100)).optional()),
-	cursor: z$1.string().nullable().default(null),
-	ordering: z$1.string().optional()
+	}, z.number().int().min(1).transform((value) => Math.min(value, 100)).optional()),
+	cursor: z.string().nullable().default(null),
+	ordering: z.string().optional()
 });
-
 //#endregion
 //#region src/paginators/CursorPaginator.ts
+/**
+* Represents a single cursor page of results.
+* Cursor pages do not expose numeric page navigation like offset pagination.
+*/
 var CursorPage = class CursorPage {
+	results;
+	nextCursor;
+	previousCursor;
 	static BRAND = "tango.resources.cursor_page";
 	__tangoBrand = CursorPage.BRAND;
 	constructor(results, nextCursor, previousCursor) {
@@ -394,7 +337,15 @@ var CursorPage = class CursorPage {
 		return this.results.length;
 	}
 };
+/**
+* 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.
+*/
 var CursorPaginator = class CursorPaginator extends BasePaginator {
+	queryset;
+	perPage;
+	cursorField;
 	static BRAND = "tango.resources.cursor_paginator";
 	__tangoBrand = CursorPaginator.BRAND;
 	limit;
@@ -420,9 +371,9 @@ var CursorPaginator = class CursorPaginator extends BasePaginator {
 	*/
 	parse(params) {
 		const parsed = CursorPaginationInput.parse({
-			limit: params.get("limit") ?? undefined,
+			limit: params.get("limit") ?? void 0,
 			cursor: params.get("cursor"),
-			ordering: params.get("ordering") ?? undefined
+			ordering: params.get("ordering") ?? void 0
 		});
 		this.limit = parsed.limit ?? this.perPage;
 		this.cursor = parsed.cursor;
@@ -470,8 +421,7 @@ var CursorPaginator = class CursorPaginator extends BasePaginator {
 			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 };
+			const filterInput = { [`${String(this.cursorField)}${lookup}`]: decoded.value };
 			qs = qs.filter(filterInput);
 		}
 		const orderToken = this.direction === "asc" ? String(this.cursorField) : `-${String(this.cursorField)}`;
@@ -523,39 +473,40 @@ var CursorPaginator = class CursorPaginator extends BasePaginator {
 		return parsed;
 	}
 };
-
 //#endregion
 //#region src/pagination/index.ts
-var pagination_exports = {};
-__export(pagination_exports, {
+var pagination_exports = /* @__PURE__ */ __exportAll({
 	BasePaginator: () => BasePaginator,
 	CursorPaginationInput: () => CursorPaginationInput,
 	CursorPaginator: () => CursorPaginator,
 	OffsetPaginationInput: () => OffsetPaginationInput,
 	OffsetPaginator: () => OffsetPaginator
 });
-
 //#endregion
 //#region src/paginators/index.ts
-var paginators_exports = {};
-__export(paginators_exports, {
+var paginators_exports = /* @__PURE__ */ __exportAll({
 	CursorPaginator: () => CursorPaginator,
 	OffsetPaginator: () => OffsetPaginator
 });
-
 //#endregion
 //#region src/resource/index.ts
-var resource_exports = {};
-
+var resource_exports = /* @__PURE__ */ __exportAll({});
 //#endregion
 //#region src/serializer/Serializer.ts
 const logger = getLogger("tango.resources.serializer");
 let hasWarnedAboutToRepresentationDeprecation = false;
+/**
+* DRF-inspired base serializer backed by Zod schemas.
+*
+* Tango serializers keep Zod as the source of truth for validation and type
+* inference while centralizing create, update, and representation workflows in
+* one class-owned contract.
+*/
 var Serializer = class {
 	static createSchema = z.unknown();
 	static updateSchema = z.unknown();
 	static outputSchema = z.unknown();
-	static outputResolvers = undefined;
+	static outputResolvers = void 0;
 	/**
 	* Return the serializer class for the current instance.
 	*/
@@ -636,7 +587,6 @@ var Serializer = class {
 		};
 	}
 };
-
 //#endregion
 //#region src/serializer/internal/InternalSerializerRelationKind.ts
 const InternalSerializerRelationKind = { MANY_TO_MANY: "manyToMany" };
@@ -648,12 +598,14 @@ const InternalManyToManyWriteStrategyKind = {
 	PK_LIST: "pkList",
 	SLUG_LIST: "slugList"
 };
-
 //#endregion
 //#region src/serializer/ModelSerializer.ts
+/**
+* Zod-backed serializer with default model-manager persistence behavior.
+*/
 var ModelSerializer = class extends Serializer {
 	static model;
-	static relationFields = undefined;
+	static relationFields = void 0;
 	/**
 	* Return the Tango model backing this serializer.
 	*/
@@ -680,9 +632,8 @@ var ModelSerializer = class extends Serializer {
 	getOutputResolvers() {
 		const baseResolvers = super.getOutputResolvers();
 		const relationFields = this.getRelationFields();
-		const relationResolvers = Object.fromEntries(Object.entries(relationFields).map(([fieldName, field]) => [fieldName, async (record) => this.serializeRelationField(record, fieldName, field)]));
 		return {
-			...relationResolvers,
+			...Object.fromEntries(Object.entries(relationFields).map(([fieldName, field]) => [fieldName, async (record) => this.serializeRelationField(record, fieldName, field)])),
 			...baseResolvers
 		};
 	}
@@ -743,14 +694,12 @@ var ModelSerializer = class extends Serializer {
 	async applyRelationWrites(record, writes) {
 		const relationFields = this.getRelationFields();
 		for (const [fieldName, value] of Object.entries(writes)) {
-			const field = relationFields[fieldName];
-			if (!field) continue;
+			if (!relationFields[fieldName]) continue;
 			await this.syncManyToManyRelation(record, fieldName, value);
 		}
 	}
 	async serializeRelationField(record, fieldName, field) {
-		const manager = this.getManyToManyManager(record, fieldName);
-		const rows = (await manager.all().fetch()).results;
+		const rows = (await this.getManyToManyManager(record, fieldName).all().fetch()).results;
 		const relationMeta = this.getManyToManyRelationMeta(fieldName);
 		switch (field.read.kind) {
 			case InternalManyToManyReadStrategyKind.PK_LIST: return rows.map((row) => row[relationMeta.targetPrimaryKey]);
@@ -758,7 +707,7 @@ var ModelSerializer = class extends Serializer {
 		}
 	}
 	async syncManyToManyRelation(record, fieldName, value) {
-		if (value === undefined) return;
+		if (value === void 0) return;
 		const manager = this.getManyToManyManager(record, fieldName);
 		const field = this.getRelationFields()[fieldName];
 		if (!field) return;
@@ -798,12 +747,11 @@ var ModelSerializer = class extends Serializer {
 		return manager;
 	}
 	getManyToManyRelationMeta(fieldName) {
-		const relation$1 = this.getManager().meta.relations?.[fieldName];
-		if (!relation$1 || relation$1.kind !== InternalSerializerRelationKind.MANY_TO_MANY) throw new Error(`Relation field '${fieldName}' is not a persisted many-to-many edge.`);
-		return relation$1;
+		const relation = this.getManager().meta.relations?.[fieldName];
+		if (!relation || relation.kind !== InternalSerializerRelationKind.MANY_TO_MANY) throw new Error(`Relation field '${fieldName}' is not a persisted many-to-many edge.`);
+		return relation;
 	}
 };
-
 //#endregion
 //#region src/serializer/relation.ts
 function pkList() {
@@ -834,18 +782,20 @@ const relation = {
 	nested,
 	slugList
 };
-
 //#endregion
 //#region src/serializer/index.ts
-var serializer_exports = {};
-__export(serializer_exports, {
+var serializer_exports = /* @__PURE__ */ __exportAll({
 	ModelSerializer: () => ModelSerializer,
 	Serializer: () => Serializer,
 	relation: () => relation
 });
-
 //#endregion
 //#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 = [];
@@ -869,8 +819,7 @@ var ModelViewSet = class ModelViewSet {
 	static getActions(viewsetOrConstructor) {
 		const viewset = ModelViewSet.isModelViewSet(viewsetOrConstructor) ? viewsetOrConstructor : null;
 		const constructorValue = viewset ? viewset.constructor : viewsetOrConstructor;
-		const actions = Array.isArray(constructorValue.actions) ? constructorValue.actions : [];
-		return actions.map((action) => ({
+		return (Array.isArray(constructorValue.actions) ? constructorValue.actions : []).map((action) => ({
 			...action,
 			path: viewset ? viewset.resolveActionPath(action) : ModelViewSet.resolvePathFromDescriptor(action.name, action.path)
 		}));
@@ -950,8 +899,7 @@ var ModelViewSet = class ModelViewSet {
 			const search = params.getSearch();
 			if (search && this.searchFields.length > 0) {
 				const searchFilters = this.searchFields.map((field) => {
-					const lookup = `${String(field)}__icontains`;
-					return { [lookup]: search };
+					return { [`${String(field)}__icontains`]: search };
 				});
 				qs = qs.filter(Q.or(...searchFilters));
 			}
@@ -963,12 +911,10 @@ var ModelViewSet = class ModelViewSet {
 				});
 				if (orderTokens.length > 0) qs = qs.orderBy(...orderTokens.map((token) => token));
 			}
-			const paginatedQueryset = paginator.apply(qs);
-			const resultPromise = paginatedQueryset.fetch();
-			const totalCountPromise = paginator.needsTotalCount() ? qs.count() : Promise.resolve(undefined);
+			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 serializer = this.getSerializer();
-			const rows = await serializer.serializeMany(result.items);
+			const rows = await this.getSerializer().serializeMany(result.items);
 			const response = paginator.toResponse(rows, { totalCount });
 			return TangoResponse.json(response, { status: 200 });
 		} catch (error) {
@@ -997,7 +943,7 @@ var ModelViewSet = class ModelViewSet {
 		try {
 			const body = await ctx.request.json();
 			const result = await this.getSerializer().create(body);
-			return TangoResponse.created(undefined, result);
+			return TangoResponse.created(void 0, result);
 		} catch (error) {
 			return this.handleError(error);
 		}
@@ -1059,12 +1005,10 @@ var ModelViewSet = class ModelViewSet {
 		return primaryKeyField.name;
 	}
 };
-
 //#endregion
 //#region src/viewset/index.ts
-var viewset_exports = {};
-__export(viewset_exports, { ModelViewSet: () => ModelViewSet });
-
+var viewset_exports = /* @__PURE__ */ __exportAll({ ModelViewSet: () => ModelViewSet });
 //#endregion
 export { APIView, CreateAPIView, CreateModelMixin, CursorPaginationInput, CursorPaginator, DestroyModelMixin, FilterSet, GenericAPIView, ListAPIView, ListCreateAPIView, ListModelMixin, ModelSerializer, ModelViewSet, OffsetPaginationInput, OffsetPaginator, RequestContext, RetrieveAPIView, RetrieveDestroyAPIView, RetrieveModelMixin, RetrieveUpdateAPIView, RetrieveUpdateDestroyAPIView, Serializer, UpdateModelMixin, context_exports as context, filters_exports as filters, pagination_exports as pagination, paginators_exports as paginators, relation, resource_exports as resource, serializer_exports as serializer, view_exports as view, viewset_exports as viewset };
+
 //# sourceMappingURL=index.js.map