@danceroutine/tango-resources 1.11.2 → 1.11.4

package/dist/inferModelFieldParsers-2irv7j1T.js

@@ -0,0 +1,70 @@
+//#region src/filters/inferModelFieldParsers.ts
+function normalizeParserTokens(raw) {
+	const normalized = (Array.isArray(raw) ? raw : String(raw).split(",")).map((value) => value.trim());
+	return normalized.every((value) => value.length > 0) ? normalized : [];
+}
+function createBooleanParser() {
+	return (raw) => {
+		const values = normalizeParserTokens(raw);
+		if (values.length === 0) return;
+		const parsed = values.map((value) => {
+			const normalized = value.toLowerCase();
+			if (normalized === "true" || normalized === "1") return true;
+			if (normalized === "false" || normalized === "0") return false;
+			return null;
+		});
+		if (parsed.some((value) => value === null)) return;
+		return parsed.length === 1 ? parsed[0] : parsed;
+	};
+}
+function createIntegerParser() {
+	return (raw) => {
+		const values = normalizeParserTokens(raw);
+		if (values.length === 0) return;
+		const parsed = values.map(Number);
+		if (parsed.some((value) => !Number.isInteger(value))) return;
+		return parsed.length === 1 ? parsed[0] : parsed;
+	};
+}
+function createTimestampParser() {
+	return (raw) => {
+		const values = normalizeParserTokens(raw);
+		if (values.length === 0) return;
+		const parsed = values.map((value) => {
+			const date = new Date(value);
+			return Number.isNaN(date.getTime()) ? null : date;
+		});
+		if (parsed.some((value) => value === null)) return;
+		return parsed.length === 1 ? parsed[0] : parsed;
+	};
+}
+/**
+* Infer resource-level query-value parsers from Tango model metadata.
+*
+* Parsers are inferred conservatively from field metadata so HTTP query filters
+* can be coerced into typed ORM inputs without framework-specific glue.
+*/
+function inferModelFieldParsers(model) {
+	const metadata = model.metadata;
+	if (!metadata) return {};
+	const parsers = {};
+	for (const field of metadata.fields) switch (field.type) {
+		case "bool":
+			parsers[field.name] = createBooleanParser();
+			break;
+		case "serial":
+		case "int":
+		case "bigint":
+			parsers[field.name] = createIntegerParser();
+			break;
+		case "timestamptz":
+			parsers[field.name] = createTimestampParser();
+			break;
+		default: break;
+	}
+	return parsers;
+}
+//#endregion
+export { inferModelFieldParsers as t };
+
+//# sourceMappingURL=inferModelFieldParsers-2irv7j1T.js.map

package/dist/inferModelFieldParsers-2irv7j1T.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inferModelFieldParsers-2irv7j1T.js","names":[],"sources":["../src/filters/inferModelFieldParsers.ts"],"sourcesContent":["import type { ResourceModelLike } from '../resource/index';\nimport type { FilterValueParser } from './FilterSet';\n\nfunction normalizeParserTokens(raw: string | string[]): string[] {\n    const tokens = Array.isArray(raw) ? raw : String(raw).split(',');\n    const normalized = tokens.map((value) => value.trim());\n    return normalized.every((value) => value.length > 0) ? normalized : [];\n}\n\nfunction createBooleanParser(): FilterValueParser {\n    return (raw) => {\n        const values = normalizeParserTokens(raw);\n        if (values.length === 0) {\n            return undefined;\n        }\n\n        const parsed = values.map((value) => {\n            const normalized = value.toLowerCase();\n\n            if (normalized === 'true' || normalized === '1') {\n                return true;\n            }\n\n            if (normalized === 'false' || normalized === '0') {\n                return false;\n            }\n\n            return null;\n        });\n\n        if (parsed.some((value) => value === null)) {\n            return undefined;\n        }\n\n        return parsed.length === 1 ? parsed[0]! : (parsed as boolean[]);\n    };\n}\n\nfunction createIntegerParser(): FilterValueParser {\n    return (raw) => {\n        const values = normalizeParserTokens(raw);\n        if (values.length === 0) {\n            return undefined;\n        }\n\n        const parsed = values.map(Number);\n\n        if (parsed.some((value) => !Number.isInteger(value))) {\n            return undefined;\n        }\n\n        return parsed.length === 1 ? parsed[0] : parsed;\n    };\n}\n\nfunction createTimestampParser(): FilterValueParser {\n    return (raw) => {\n        const values = normalizeParserTokens(raw);\n        if (values.length === 0) {\n            return undefined;\n        }\n\n        const parsed = values.map((value) => {\n            const date = new Date(value);\n            return Number.isNaN(date.getTime()) ? null : date;\n        });\n\n        if (parsed.some((value) => value === null)) {\n            return undefined;\n        }\n\n        return parsed.length === 1 ? parsed[0]! : (parsed as Date[]);\n    };\n}\n\n/**\n * Infer resource-level query-value parsers from Tango model metadata.\n *\n * Parsers are inferred conservatively from field metadata so HTTP query filters\n * can be coerced into typed ORM inputs without framework-specific glue.\n */\nexport function inferModelFieldParsers<T extends Record<string, unknown>>(\n    model: ResourceModelLike<T>\n): Partial<Record<keyof T, FilterValueParser>> {\n    const metadata = model.metadata;\n    if (!metadata) {\n        return {};\n    }\n\n    const parsers: Partial<Record<keyof T, FilterValueParser>> = {};\n\n    for (const field of metadata.fields) {\n        switch (field.type) {\n            case 'bool':\n                parsers[field.name as keyof T] = createBooleanParser();\n                break;\n            case 'serial':\n            case 'int':\n            case 'bigint':\n                parsers[field.name as keyof T] = createIntegerParser();\n                break;\n            case 'timestamptz':\n                parsers[field.name as keyof T] = createTimestampParser();\n                break;\n            default:\n                break;\n        }\n    }\n\n    return parsers;\n}\n"],"mappings":";AAGA,SAAS,sBAAsB,KAAkC;CAE7D,MAAM,cADS,MAAM,QAAQ,GAAG,IAAI,MAAM,OAAO,GAAG,EAAE,MAAM,GAAG,GACrC,KAAK,UAAU,MAAM,KAAK,CAAC;CACrD,OAAO,WAAW,OAAO,UAAU,MAAM,SAAS,CAAC,IAAI,aAAa,CAAC;AACzE;AAEA,SAAS,sBAAyC;CAC9C,QAAQ,QAAQ;EACZ,MAAM,SAAS,sBAAsB,GAAG;EACxC,IAAI,OAAO,WAAW,GAClB;EAGJ,MAAM,SAAS,OAAO,KAAK,UAAU;GACjC,MAAM,aAAa,MAAM,YAAY;GAErC,IAAI,eAAe,UAAU,eAAe,KACxC,OAAO;GAGX,IAAI,eAAe,WAAW,eAAe,KACzC,OAAO;GAGX,OAAO;EACX,CAAC;EAED,IAAI,OAAO,MAAM,UAAU,UAAU,IAAI,GACrC;EAGJ,OAAO,OAAO,WAAW,IAAI,OAAO,KAAO;CAC/C;AACJ;AAEA,SAAS,sBAAyC;CAC9C,QAAQ,QAAQ;EACZ,MAAM,SAAS,sBAAsB,GAAG;EACxC,IAAI,OAAO,WAAW,GAClB;EAGJ,MAAM,SAAS,OAAO,IAAI,MAAM;EAEhC,IAAI,OAAO,MAAM,UAAU,CAAC,OAAO,UAAU,KAAK,CAAC,GAC/C;EAGJ,OAAO,OAAO,WAAW,IAAI,OAAO,KAAK;CAC7C;AACJ;AAEA,SAAS,wBAA2C;CAChD,QAAQ,QAAQ;EACZ,MAAM,SAAS,sBAAsB,GAAG;EACxC,IAAI,OAAO,WAAW,GAClB;EAGJ,MAAM,SAAS,OAAO,KAAK,UAAU;GACjC,MAAM,OAAO,IAAI,KAAK,KAAK;GAC3B,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,IAAI,OAAO;EACjD,CAAC;EAED,IAAI,OAAO,MAAM,UAAU,UAAU,IAAI,GACrC;EAGJ,OAAO,OAAO,WAAW,IAAI,OAAO,KAAO;CAC/C;AACJ;;;;;;;AAQA,SAAgB,uBACZ,OAC2C;CAC3C,MAAM,WAAW,MAAM;CACvB,IAAI,CAAC,UACD,OAAO,CAAC;CAGZ,MAAM,UAAuD,CAAC;CAE9D,KAAK,MAAM,SAAS,SAAS,QACzB,QAAQ,MAAM,MAAd;EACI,KAAK;GACD,QAAQ,MAAM,QAAmB,oBAAoB;GACrD;EACJ,KAAK;EACL,KAAK;EACL,KAAK;GACD,QAAQ,MAAM,QAAmB,oBAAoB;GACrD;EACJ,KAAK;GACD,QAAQ,MAAM,QAAmB,sBAAsB;GACvD;EACJ,SACI;CACR;CAGJ,OAAO;AACX"}

package/dist/pagination/index.d.ts

@@ -0,0 +1,3 @@
+import { a as BasePaginatedResponse, c as PaginatedResponse, i as Paginator, l as BasePaginator, n as OffsetPaginator, o as CursorPaginatedResponse, r as Page, s as OffsetPaginatedResponse, t as CursorPaginator } from "../CursorPaginator-CfeMQCdJ.js";
+import { a as OffsetPaginationInputValue, i as OffsetPaginationInput, n as CursorPaginationInput, r as CursorPaginationInputValue } from "../index-Ac94YL5S.js";
+export { type BasePaginatedResponse, BasePaginator, type CursorPaginatedResponse, CursorPaginationInput, type CursorPaginationInputValue, CursorPaginator, type OffsetPaginatedResponse, OffsetPaginationInput, type OffsetPaginationInputValue, OffsetPaginator, type Page, type PaginatedResponse, type Paginator };

package/dist/pagination/index.js

@@ -0,0 +1,15 @@
+import { t as __exportAll } from "../chunk-D7D4PA-g.js";
+import { n as OffsetPaginationInput, r as BasePaginator, t as OffsetPaginator } from "../OffsetPaginator-CaycvxJU.js";
+import { n as CursorPaginationInput, t as CursorPaginator } from "../CursorPaginator-B_8MhYZY.js";
+//#region src/pagination/index.ts
+var pagination_exports = /* @__PURE__ */ __exportAll({
+	BasePaginator: () => BasePaginator,
+	CursorPaginationInput: () => CursorPaginationInput,
+	CursorPaginator: () => CursorPaginator,
+	OffsetPaginationInput: () => OffsetPaginationInput,
+	OffsetPaginator: () => OffsetPaginator
+});
+//#endregion
+export { BasePaginator, CursorPaginationInput, CursorPaginator, OffsetPaginationInput, OffsetPaginator, pagination_exports as t };
+
+//# sourceMappingURL=index.js.map

package/dist/pagination/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/pagination/index.ts"],"sourcesContent":["/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { OffsetPaginator } from '../paginators/OffsetPaginator';\nexport { CursorPaginator } from '../paginators/CursorPaginator';\nexport { OffsetPaginationInput } from './OffsetPaginationInput';\nexport type { OffsetPaginationInputValue } from './OffsetPaginationInput';\nexport { CursorPaginationInput } from './CursorPaginationInput';\nexport type { CursorPaginationInputValue } from './CursorPaginationInput';\nexport type { Paginator, Page } from './Paginator';\nexport type {\n    BasePaginatedResponse,\n    CursorPaginatedResponse,\n    OffsetPaginatedResponse,\n    PaginatedResponse,\n} from './PaginatedResponse';\nexport { BasePaginator } from './BasePaginator';\n"],"mappings":""}

package/dist/paginators/index.d.ts

@@ -0,0 +1,9 @@
+import { n as OffsetPaginator, t as CursorPaginator } from "../CursorPaginator-CfeMQCdJ.js";
+
+//#region src/paginators/index.d.ts
+declare namespace index_d_exports {
+  export { CursorPaginator, OffsetPaginator };
+}
+//#endregion
+export { CursorPaginator, OffsetPaginator, index_d_exports as t };
+//# sourceMappingURL=index.d.ts.map

package/dist/paginators/index.js

@@ -0,0 +1,12 @@
+import { t as __exportAll } from "../chunk-D7D4PA-g.js";
+import { t as OffsetPaginator } from "../OffsetPaginator-CaycvxJU.js";
+import { t as CursorPaginator } from "../CursorPaginator-B_8MhYZY.js";
+//#region src/paginators/index.ts
+var paginators_exports = /* @__PURE__ */ __exportAll({
+	CursorPaginator: () => CursorPaginator,
+	OffsetPaginator: () => OffsetPaginator
+});
+//#endregion
+export { CursorPaginator, OffsetPaginator, paginators_exports as t };
+
+//# sourceMappingURL=index.js.map

package/dist/paginators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/paginators/index.ts"],"sourcesContent":["/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { CursorPaginator } from './CursorPaginator';\nexport { OffsetPaginator } from './OffsetPaginator';\n"],"mappings":""}

package/dist/resource/index.d.ts

@@ -0,0 +1,3 @@
+import { C as ResourceModelMetadata, S as ResourceModelLike, x as ResourceModelFieldMetadata } from "../index-C55GDIOn.js";
+import { n as GenericAPIViewOpenAPIDescription, r as ModelViewSetOpenAPIDescription } from "../index-DkJtxvKu.js";
+export type { GenericAPIViewOpenAPIDescription, ModelViewSetOpenAPIDescription, ResourceModelFieldMetadata, ResourceModelLike, ResourceModelMetadata };

package/dist/resource/index.js

@@ -0,0 +1,7 @@
+import { t as __exportAll } from "../chunk-D7D4PA-g.js";
+//#region src/resource/index.ts
+var resource_exports = /* @__PURE__ */ __exportAll({});
+//#endregion
+export { resource_exports as t };
+
+//# sourceMappingURL=index.js.map

package/dist/resource/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/resource/index.ts"],"sourcesContent":["/**\n * Domain boundary barrel: centralizes shared resource metadata contracts.\n */\n\nexport type { ResourceModelFieldMetadata, ResourceModelLike, ResourceModelMetadata } from './ResourceModelLike';\nexport type { GenericAPIViewOpenAPIDescription, ModelViewSetOpenAPIDescription } from './OpenAPIDescription';\n"],"mappings":""}

package/dist/serializer/index.d.ts

@@ -0,0 +1,2 @@
+import { _ as SerializerOutputResolver, a as ModelSerializerClass, b as SerializerUpdateInput, c as ManyToManyRelationField, d as relation, f as AnySerializerClass, g as SerializerOutput, h as SerializerCreateInput, i as ModelSerializer, l as ManyToManyWriteStrategy, m as SerializerClass, n as AnyModelSerializer, o as ManyToManyManagerKeys, p as Serializer, r as AnyModelSerializerClass, s as ManyToManyReadStrategy, u as ModelSerializerRelationFields, v as SerializerOutputResolvers, y as SerializerSchema } from "../index-C55GDIOn.js";
+export { type AnyModelSerializer, type AnyModelSerializerClass, type AnySerializerClass, type ManyToManyManagerKeys, type ManyToManyReadStrategy, type ManyToManyRelationField, type ManyToManyWriteStrategy, ModelSerializer, type ModelSerializerClass, type ModelSerializerRelationFields, Serializer, type SerializerClass, type SerializerCreateInput, type SerializerOutput, type SerializerOutputResolver, type SerializerOutputResolvers, type SerializerSchema, type SerializerUpdateInput, relation };

package/dist/serializer/index.js

@@ -0,0 +1,2 @@
+import { i as Serializer, n as relation, r as ModelSerializer } from "../serializer-RSwlXWls.js";
+export { ModelSerializer, Serializer, relation };

package/dist/serializer-RSwlXWls.js

@@ -0,0 +1,305 @@
+import { t as __exportAll } from "./chunk-D7D4PA-g.js";
+import { getLogger } from "@danceroutine/tango-core";
+import { ManyToManyRelatedManager } from "@danceroutine/tango-orm";
+import { z } from "zod";
+//#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 = void 0;
+	/**
+	* Return the serializer class for the current instance.
+	*/
+	getSerializerClass() {
+		return this.constructor;
+	}
+	/**
+	* Return the Zod schema used for create payloads.
+	*/
+	getCreateSchema() {
+		return this.getSerializerClass().createSchema;
+	}
+	/**
+	* Return the Zod schema used for update payloads.
+	*/
+	getUpdateSchema() {
+		return this.getSerializerClass().updateSchema;
+	}
+	/**
+	* Return the Zod schema used for serialized output.
+	*/
+	getOutputSchema() {
+		return this.getSerializerClass().outputSchema;
+	}
+	/**
+	* Return the resolver map used to enrich serializer output fields before
+	* the outward Zod schema parses the final response shape.
+	*/
+	getOutputResolvers() {
+		return this.getSerializerClass().outputResolvers ?? {};
+	}
+	/**
+	* Validate unknown input for create workflows.
+	*/
+	deserializeCreate(input) {
+		return this.getCreateSchema().parse(input);
+	}
+	/**
+	* Validate unknown input for update workflows.
+	*/
+	deserializeUpdate(input) {
+		return this.getUpdateSchema().parse(input);
+	}
+	/**
+	* Convert a persisted record into its outward-facing representation.
+	*
+	* @deprecated Use `serialize(...)` instead so serializer-owned output
+	* resolvers run before the outward Zod schema parses the response shape.
+	*/
+	toRepresentation(record) {
+		if (!hasWarnedAboutToRepresentationDeprecation) {
+			hasWarnedAboutToRepresentationDeprecation = true;
+			logger.warn("`Serializer.toRepresentation(...)` is deprecated. Use `serialize(...)` instead so output resolvers run before outward parsing.");
+		}
+		return this.getOutputSchema().parse(record);
+	}
+	/**
+	* Resolve serializer-owned output fields and parse the outward response
+	* contract.
+	*/
+	async serialize(record) {
+		return this.getOutputSchema().parse(await this.applyOutputResolvers(record));
+	}
+	/**
+	* Serialize many records through the same outward response contract.
+	*/
+	async serializeMany(records) {
+		return Promise.all(records.map((record) => this.serialize(record)));
+	}
+	async applyOutputResolvers(record) {
+		const resolvers = this.getOutputResolvers();
+		const resolverEntries = Object.entries(resolvers);
+		if (resolverEntries.length === 0 || typeof record !== "object" || record === null) return record;
+		const resolved = await Promise.all(resolverEntries.map(async ([key, resolver]) => [key, await resolver(record)]));
+		return {
+			...record,
+			...Object.fromEntries(resolved)
+		};
+	}
+};
+//#endregion
+//#region src/serializer/internal/InternalSerializerRelationKind.ts
+const InternalSerializerRelationKind = { MANY_TO_MANY: "manyToMany" };
+const InternalManyToManyReadStrategyKind = {
+	PK_LIST: "pkList",
+	NESTED: "nested"
+};
+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 = void 0;
+	/**
+	* Return the Tango model backing this serializer.
+	*/
+	getModel() {
+		const model = this.constructor.model;
+		if (!model) throw new Error(`${this.constructor.name} must define a static model or override getModel().`);
+		return model;
+	}
+	/**
+	* Return the manager used for create and update workflows.
+	*/
+	getManager() {
+		return this.getModel().objects;
+	}
+	/**
+	* Return the declarative relation-field map for this serializer.
+	*/
+	getRelationFields() {
+		return this.constructor.relationFields ?? {};
+	}
+	/**
+	* Merge relation-field read resolvers into the serializer output path.
+	*/
+	getOutputResolvers() {
+		const baseResolvers = super.getOutputResolvers();
+		const relationFields = this.getRelationFields();
+		return {
+			...Object.fromEntries(Object.entries(relationFields).map(([fieldName, field]) => [fieldName, async (record) => this.serializeRelationField(record, fieldName, field)])),
+			...baseResolvers
+		};
+	}
+	/**
+	* Validate, enrich, persist, and serialize a create workflow.
+	*/
+	async create(input) {
+		const validated = this.deserializeCreate(input);
+		const relationWrites = this.extractRelationWrites(validated, input);
+		const prepared = await this.beforeCreate(validated);
+		const created = await this.getManager().create(this.stripRelationFields(prepared));
+		await this.applyRelationWrites(created, relationWrites);
+		return this.serialize(created);
+	}
+	/**
+	* Validate, enrich, persist, and serialize an update workflow.
+	*/
+	async update(id, input) {
+		const validated = this.deserializeUpdate(input);
+		const relationWrites = this.extractRelationWrites(validated, input);
+		const prepared = await this.beforeUpdate(id, validated);
+		const updated = await this.getManager().update(id, this.stripRelationFields(prepared));
+		await this.applyRelationWrites(updated, relationWrites);
+		return this.serialize(updated);
+	}
+	/**
+	* Override to normalize create input for this resource workflow before the
+	* manager call.
+	*
+	* Model-owned persistence rules belong in model hooks so they also run for
+	* scripts and direct manager usage.
+	*/
+	async beforeCreate(data) {
+		return data;
+	}
+	/**
+	* Override to normalize update input for this resource workflow before the
+	* manager call.
+	*
+	* Model-owned persistence rules belong in model hooks so they also run for
+	* scripts and direct manager usage.
+	*/
+	async beforeUpdate(_id, data) {
+		return data;
+	}
+	extractRelationWrites(data, rawInput) {
+		if (typeof data !== "object" || data === null || typeof rawInput !== "object" || rawInput === null) return {};
+		const relationFields = this.getRelationFields();
+		const writes = {};
+		for (const fieldName of Object.keys(relationFields)) if (fieldName in rawInput) writes[fieldName] = data[fieldName];
+		return writes;
+	}
+	stripRelationFields(data) {
+		const relationFieldNames = new Set(Object.keys(this.getRelationFields()));
+		if (relationFieldNames.size === 0) return data;
+		return Object.fromEntries(Object.entries(data).filter(([fieldName]) => !relationFieldNames.has(fieldName)));
+	}
+	async applyRelationWrites(record, writes) {
+		const relationFields = this.getRelationFields();
+		for (const [fieldName, value] of Object.entries(writes)) {
+			if (!relationFields[fieldName]) continue;
+			await this.syncManyToManyRelation(record, fieldName, value);
+		}
+	}
+	async serializeRelationField(record, fieldName, field) {
+		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]);
+			case InternalManyToManyReadStrategyKind.NESTED: return rows.map((row) => field.read.schema.parse(row));
+		}
+	}
+	async syncManyToManyRelation(record, fieldName, value) {
+		if (value === void 0) return;
+		const manager = this.getManyToManyManager(record, fieldName);
+		const field = this.getRelationFields()[fieldName];
+		if (!field) return;
+		const nextTargets = await this.resolveWriteTargets(fieldName, field.write, value);
+		await manager.set(...nextTargets);
+	}
+	async resolveWriteTargets(fieldName, strategy, value) {
+		switch (strategy.kind) {
+			case InternalManyToManyWriteStrategyKind.PK_LIST:
+				if (!Array.isArray(value)) throw new TypeError(`Relation field '${String(fieldName)}' expects an array of primary-key values.`);
+				return value;
+			case InternalManyToManyWriteStrategyKind.SLUG_LIST: {
+				if (!Array.isArray(value)) throw new TypeError(`Relation field '${String(fieldName)}' expects an array of lookup values.`);
+				const lookupValues = [...new Set(value.map((entry) => String(entry).trim()).filter(Boolean))];
+				if (lookupValues.length === 0) return [];
+				const filter = { [`${strategy.lookupField}__in`]: lookupValues };
+				const existing = await strategy.model.objects.query().filter(filter).fetch();
+				const byLookup = new Map(existing.results.map((row) => [String(row[strategy.lookupField]), row]));
+				const resolved = [];
+				for (const lookupValue of lookupValues) {
+					const found = byLookup.get(lookupValue);
+					if (found) {
+						resolved.push(found);
+						continue;
+					}
+					if (!strategy.createIfMissing) throw new Error(`Relation field '${String(fieldName)}' could not resolve '${lookupValue}' via '${strategy.lookupField}'.`);
+					const created = await strategy.model.objects.create(strategy.buildCreateInput?.(lookupValue) ?? { [strategy.lookupField]: lookupValue });
+					resolved.push(created);
+				}
+				return resolved;
+			}
+		}
+	}
+	getManyToManyManager(record, fieldName) {
+		const manager = record[fieldName];
+		if (!ManyToManyRelatedManager.isManyToManyRelatedManager(manager)) throw new Error(`Relation field '${fieldName}' is not backed by a many-to-many related manager.`);
+		return manager;
+	}
+	getManyToManyRelationMeta(fieldName) {
+		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() {
+	return { kind: InternalManyToManyReadStrategyKind.PK_LIST };
+}
+function nested(schema) {
+	return {
+		kind: InternalManyToManyReadStrategyKind.NESTED,
+		schema
+	};
+}
+function slugList(options) {
+	return {
+		kind: InternalManyToManyWriteStrategyKind.SLUG_LIST,
+		...options
+	};
+}
+function manyToMany(config = {}) {
+	return {
+		kind: InternalSerializerRelationKind.MANY_TO_MANY,
+		read: config.read ?? pkList(),
+		write: config.write ?? pkList()
+	};
+}
+const relation = {
+	manyToMany,
+	pkList,
+	nested,
+	slugList
+};
+//#endregion
+//#region src/serializer/index.ts
+var serializer_exports = /* @__PURE__ */ __exportAll({
+	ModelSerializer: () => ModelSerializer,
+	Serializer: () => Serializer,
+	relation: () => relation
+});
+//#endregion
+export { Serializer as i, relation as n, ModelSerializer as r, serializer_exports as t };
+
+//# sourceMappingURL=serializer-RSwlXWls.js.map

package/dist/serializer-RSwlXWls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer-RSwlXWls.js","names":[],"sources":["../src/serializer/Serializer.ts","../src/serializer/internal/InternalSerializerRelationKind.ts","../src/serializer/ModelSerializer.ts","../src/serializer/relation.ts","../src/serializer/index.ts"],"sourcesContent":["import { getLogger } from '@danceroutine/tango-core';\nimport { z } from 'zod';\n\nexport type SerializerSchema = z.ZodTypeAny;\n\nexport type SerializerClass<\n    TCreateSchema extends SerializerSchema = SerializerSchema,\n    TUpdateSchema extends SerializerSchema = SerializerSchema,\n    TOutputSchema extends SerializerSchema = SerializerSchema,\n    TRecord = unknown,\n> = {\n    new (): Serializer<TCreateSchema, TUpdateSchema, TOutputSchema, TRecord>;\n    readonly createSchema: TCreateSchema;\n    readonly updateSchema: TUpdateSchema;\n    readonly outputSchema: TOutputSchema;\n    readonly outputResolvers?: SerializerOutputResolvers<TRecord>;\n};\n\nexport type AnySerializerClass = SerializerClass<\n    SerializerSchema,\n    SerializerSchema,\n    SerializerSchema,\n    // oxlint-disable-next-line typescript/no-explicit-any\n    any\n>;\n\nexport type SerializerCreateInput<TSerializer extends AnySerializerClass> = z.output<TSerializer['createSchema']>;\nexport type SerializerUpdateInput<TSerializer extends AnySerializerClass> = z.output<TSerializer['updateSchema']>;\nexport type SerializerOutput<TSerializer extends AnySerializerClass> = z.output<TSerializer['outputSchema']>;\nexport type SerializerOutputResolver<TRecord = unknown> = (record: TRecord) => unknown | Promise<unknown>;\nexport type SerializerOutputResolvers<TRecord = unknown> = Record<string, SerializerOutputResolver<TRecord>>;\n\nconst logger = getLogger('tango.resources.serializer');\nlet hasWarnedAboutToRepresentationDeprecation = false;\n\n/**\n * DRF-inspired base serializer backed by Zod schemas.\n *\n * Tango serializers keep Zod as the source of truth for validation and type\n * inference while centralizing create, update, and representation workflows in\n * one class-owned contract.\n */\nexport abstract class Serializer<\n    TCreateSchema extends SerializerSchema,\n    TUpdateSchema extends SerializerSchema,\n    TOutputSchema extends SerializerSchema,\n    TRecord = unknown,\n> {\n    static readonly createSchema: SerializerSchema = z.unknown();\n    static readonly updateSchema: SerializerSchema = z.unknown();\n    static readonly outputSchema: SerializerSchema = z.unknown();\n    static readonly outputResolvers:\n        | SerializerOutputResolvers<// oxlint-disable-next-line typescript/no-explicit-any\n          any>\n        | undefined = undefined;\n\n    /**\n     * Return the serializer class for the current instance.\n     */\n    getSerializerClass(): SerializerClass<TCreateSchema, TUpdateSchema, TOutputSchema, TRecord> {\n        return this.constructor as SerializerClass<TCreateSchema, TUpdateSchema, TOutputSchema, TRecord>;\n    }\n\n    /**\n     * Return the Zod schema used for create payloads.\n     */\n    getCreateSchema(): TCreateSchema {\n        return this.getSerializerClass().createSchema;\n    }\n\n    /**\n     * Return the Zod schema used for update payloads.\n     */\n    getUpdateSchema(): TUpdateSchema {\n        return this.getSerializerClass().updateSchema;\n    }\n\n    /**\n     * Return the Zod schema used for serialized output.\n     */\n    getOutputSchema(): TOutputSchema {\n        return this.getSerializerClass().outputSchema;\n    }\n\n    /**\n     * Return the resolver map used to enrich serializer output fields before\n     * the outward Zod schema parses the final response shape.\n     */\n    getOutputResolvers(): SerializerOutputResolvers<TRecord> {\n        return this.getSerializerClass().outputResolvers ?? {};\n    }\n\n    /**\n     * Validate unknown input for create workflows.\n     */\n    deserializeCreate(input: unknown): z.output<TCreateSchema> {\n        return this.getCreateSchema().parse(input);\n    }\n\n    /**\n     * Validate unknown input for update workflows.\n     */\n    deserializeUpdate(input: unknown): z.output<TUpdateSchema> {\n        return this.getUpdateSchema().parse(input);\n    }\n\n    /**\n     * Convert a persisted record into its outward-facing representation.\n     *\n     * @deprecated Use `serialize(...)` instead so serializer-owned output\n     * resolvers run before the outward Zod schema parses the response shape.\n     */\n    toRepresentation(record: TRecord): z.output<TOutputSchema> {\n        if (!hasWarnedAboutToRepresentationDeprecation) {\n            hasWarnedAboutToRepresentationDeprecation = true;\n            logger.warn(\n                '`Serializer.toRepresentation(...)` is deprecated. Use `serialize(...)` instead so output resolvers run before outward parsing.'\n            );\n        }\n        return this.getOutputSchema().parse(record);\n    }\n\n    /**\n     * Resolve serializer-owned output fields and parse the outward response\n     * contract.\n     */\n    async serialize(record: TRecord): Promise<z.output<TOutputSchema>> {\n        return this.getOutputSchema().parse(await this.applyOutputResolvers(record));\n    }\n\n    /**\n     * Serialize many records through the same outward response contract.\n     */\n    async serializeMany(records: readonly TRecord[]): Promise<z.output<TOutputSchema>[]> {\n        return Promise.all(records.map((record) => this.serialize(record)));\n    }\n\n    private async applyOutputResolvers(record: TRecord): Promise<unknown> {\n        const resolvers = this.getOutputResolvers();\n        const resolverEntries = Object.entries(resolvers);\n\n        if (resolverEntries.length === 0 || typeof record !== 'object' || record === null) {\n            return record;\n        }\n\n        const resolved = await Promise.all(\n            resolverEntries.map(async ([key, resolver]) => [key, await resolver(record)] as const)\n        );\n\n        return {\n            ...(record as Record<string, unknown>),\n            ...Object.fromEntries(resolved),\n        };\n    }\n}\n","export const InternalSerializerRelationKind = {\n    MANY_TO_MANY: 'manyToMany',\n} as const;\n\nexport const InternalManyToManyReadStrategyKind = {\n    PK_LIST: 'pkList',\n    NESTED: 'nested',\n} as const;\n\nexport const InternalManyToManyWriteStrategyKind = {\n    PK_LIST: 'pkList',\n    SLUG_LIST: 'slugList',\n} as const;\n","import type { FilterInput, ManagerLike, ManyToManyTargetRef } from '@danceroutine/tango-orm';\nimport { ManyToManyRelatedManager } from '@danceroutine/tango-orm';\nimport type { ResourceModelLike } from '../resource/ResourceModelLike';\nimport {\n    Serializer,\n    type AnySerializerClass,\n    type SerializerClass,\n    type SerializerCreateInput,\n    type SerializerOutput,\n    type SerializerOutputResolvers,\n    type SerializerSchema,\n    type SerializerUpdateInput,\n} from './Serializer';\nimport type { ManyToManyManagerKeys, ManyToManyRelationField, ModelSerializerRelationFields } from './relation';\nimport {\n    InternalManyToManyReadStrategyKind,\n    InternalManyToManyWriteStrategyKind,\n    InternalSerializerRelationKind,\n} from './internal/InternalSerializerRelationKind';\n\n// oxlint-disable-next-line typescript/no-explicit-any\ntype AnyRelationField = ManyToManyRelationField<any, any>;\n\nexport type ModelSerializerClass<\n    TModel extends Record<string, unknown> = Record<string, unknown>,\n    TCreateSchema extends SerializerSchema = SerializerSchema,\n    TUpdateSchema extends SerializerSchema = SerializerSchema,\n    TOutputSchema extends SerializerSchema = SerializerSchema,\n    TModelRecord extends Record<string, unknown> = TModel,\n> = SerializerClass<TCreateSchema, TUpdateSchema, TOutputSchema, TModelRecord> & {\n    new (): ModelSerializer<TModel, TCreateSchema, TUpdateSchema, TOutputSchema, TModelRecord>;\n    readonly model?: ResourceModelLike<TModel, TModelRecord>;\n    readonly relationFields?: ModelSerializerRelationFields<TModelRecord>;\n};\n\n//\nexport type AnyModelSerializer<TModel extends Record<string, unknown> = Record<string, unknown>> = ModelSerializerClass<\n    TModel,\n    SerializerSchema,\n    SerializerSchema,\n    SerializerSchema,\n    // oxlint-disable-next-line typescript/no-explicit-any\n    any\n>;\n\nexport type AnyModelSerializerClass = AnyModelSerializer;\n\n/**\n * Zod-backed serializer with default model-manager persistence behavior.\n */\nexport abstract class ModelSerializer<\n    TModel extends Record<string, unknown>,\n    TCreateSchema extends SerializerSchema,\n    TUpdateSchema extends SerializerSchema,\n    TOutputSchema extends SerializerSchema,\n    TModelRecord extends Record<string, unknown> = TModel,\n> extends Serializer<TCreateSchema, TUpdateSchema, TOutputSchema, TModelRecord> {\n    static readonly model?: unknown;\n    static readonly relationFields: ModelSerializerRelationFields<Record<string, unknown>> | undefined = undefined;\n\n    /**\n     * Return the Tango model backing this serializer.\n     */\n    getModel(): ResourceModelLike<TModel, TModelRecord> {\n        const model = (\n            this.constructor as Partial<\n                ModelSerializerClass<TModel, TCreateSchema, TUpdateSchema, TOutputSchema, TModelRecord>\n            >\n        ).model;\n\n        if (!model) {\n            throw new Error(`${this.constructor.name} must define a static model or override getModel().`);\n        }\n\n        return model;\n    }\n\n    /**\n     * Return the manager used for create and update workflows.\n     */\n    getManager(): ManagerLike<TModelRecord> {\n        return this.getModel().objects as ManagerLike<TModelRecord>;\n    }\n\n    /**\n     * Return the declarative relation-field map for this serializer.\n     */\n    getRelationFields(): ModelSerializerRelationFields<TModelRecord> {\n        return (\n            (\n                this.constructor as Partial<\n                    ModelSerializerClass<TModel, TCreateSchema, TUpdateSchema, TOutputSchema, TModelRecord>\n                >\n            ).relationFields ?? {}\n        );\n    }\n\n    /**\n     * Merge relation-field read resolvers into the serializer output path.\n     */\n    override getOutputResolvers(): SerializerOutputResolvers<TModelRecord> {\n        const baseResolvers = super.getOutputResolvers();\n        const relationFields = this.getRelationFields() as Record<string, AnyRelationField>;\n        const relationResolvers = Object.fromEntries(\n            Object.entries(relationFields).map(([fieldName, field]) => [\n                fieldName,\n                async (record: TModelRecord) => this.serializeRelationField(record, fieldName, field),\n            ])\n        ) as SerializerOutputResolvers<TModelRecord>;\n\n        return {\n            ...relationResolvers,\n            ...baseResolvers,\n        };\n    }\n\n    /**\n     * Validate, enrich, persist, and serialize a create workflow.\n     */\n    async create(\n        input: unknown\n    ): Promise<\n        SerializerOutput<ModelSerializerClass<TModel, TCreateSchema, TUpdateSchema, TOutputSchema, TModelRecord>>\n    > {\n        const validated = this.deserializeCreate(input);\n        const relationWrites = this.extractRelationWrites(validated, input);\n        const prepared = await this.beforeCreate(validated);\n        const created = await this.getManager().create(this.stripRelationFields(prepared));\n        await this.applyRelationWrites(created, relationWrites);\n        return this.serialize(created);\n    }\n\n    /**\n     * Validate, enrich, persist, and serialize an update workflow.\n     */\n    async update(\n        id: TModelRecord[keyof TModelRecord],\n        input: unknown\n    ): Promise<\n        SerializerOutput<ModelSerializerClass<TModel, TCreateSchema, TUpdateSchema, TOutputSchema, TModelRecord>>\n    > {\n        const validated = this.deserializeUpdate(input);\n        const relationWrites = this.extractRelationWrites(validated, input);\n        const prepared = await this.beforeUpdate(id, validated);\n        const updated = await this.getManager().update(id, this.stripRelationFields(prepared));\n        await this.applyRelationWrites(updated, relationWrites);\n        return this.serialize(updated);\n    }\n\n    /**\n     * Override to normalize create input for this resource workflow before the\n     * manager call.\n     *\n     * Model-owned persistence rules belong in model hooks so they also run for\n     * scripts and direct manager usage.\n     */\n    protected async beforeCreate(\n        data: SerializerCreateInput<\n            ModelSerializerClass<TModel, TCreateSchema, TUpdateSchema, TOutputSchema, TModelRecord>\n        >\n    ): Promise<Partial<TModelRecord>> {\n        return data as Partial<TModelRecord>;\n    }\n\n    /**\n     * Override to normalize update input for this resource workflow before the\n     * manager call.\n     *\n     * Model-owned persistence rules belong in model hooks so they also run for\n     * scripts and direct manager usage.\n     */\n    protected async beforeUpdate(\n        _id: TModelRecord[keyof TModelRecord],\n        data: SerializerUpdateInput<\n            ModelSerializerClass<TModel, TCreateSchema, TUpdateSchema, TOutputSchema, TModelRecord>\n        >\n    ): Promise<Partial<TModelRecord>> {\n        return data as Partial<TModelRecord>;\n    }\n\n    private extractRelationWrites(\n        data: unknown,\n        rawInput: unknown\n    ): Partial<Record<ManyToManyManagerKeys<TModelRecord>, unknown>> {\n        if (typeof data !== 'object' || data === null || typeof rawInput !== 'object' || rawInput === null) {\n            return {};\n        }\n\n        const relationFields = this.getRelationFields() as Record<string, AnyRelationField>;\n        const writes: Partial<Record<ManyToManyManagerKeys<TModelRecord>, unknown>> = {};\n\n        for (const fieldName of Object.keys(relationFields) as ManyToManyManagerKeys<TModelRecord>[]) {\n            if (fieldName in rawInput) {\n                writes[fieldName] = (data as Record<string, unknown>)[fieldName];\n            }\n        }\n\n        return writes;\n    }\n\n    private stripRelationFields(data: Partial<TModelRecord>): Partial<TModelRecord> {\n        const relationFieldNames = new Set(Object.keys(this.getRelationFields()));\n        if (relationFieldNames.size === 0) {\n            return data;\n        }\n\n        return Object.fromEntries(\n            Object.entries(data as Record<string, unknown>).filter(([fieldName]) => !relationFieldNames.has(fieldName))\n        ) as Partial<TModelRecord>;\n    }\n\n    private async applyRelationWrites(\n        record: TModelRecord,\n        writes: Partial<Record<ManyToManyManagerKeys<TModelRecord>, unknown>>\n    ): Promise<void> {\n        const relationFields = this.getRelationFields() as Record<string, AnyRelationField>;\n\n        for (const [fieldName, value] of Object.entries(writes) as Array<\n            [ManyToManyManagerKeys<TModelRecord>, unknown]\n        >) {\n            const field = relationFields[fieldName];\n            if (!field) {\n                continue;\n            }\n            await this.syncManyToManyRelation(record, fieldName, value);\n        }\n    }\n\n    private async serializeRelationField(\n        record: TModelRecord,\n        fieldName: string,\n        field: AnyRelationField\n    ): Promise<unknown> {\n        const manager = this.getManyToManyManager(record, fieldName);\n        const rows = (await manager.all().fetch()).results;\n        const relationMeta = this.getManyToManyRelationMeta(fieldName);\n\n        switch (field.read.kind) {\n            case InternalManyToManyReadStrategyKind.PK_LIST:\n                return rows.map((row) => row[relationMeta.targetPrimaryKey]);\n            case InternalManyToManyReadStrategyKind.NESTED:\n                return rows.map((row) =>\n                    (field.read as { schema: { parse: (input: unknown) => unknown } }).schema.parse(row)\n                );\n        }\n    }\n\n    private async syncManyToManyRelation(\n        record: TModelRecord,\n        fieldName: ManyToManyManagerKeys<TModelRecord>,\n        value: unknown\n    ): Promise<void> {\n        if (value === undefined) {\n            return;\n        }\n\n        const manager = this.getManyToManyManager(record, fieldName);\n        const field = (this.getRelationFields() as Record<string, AnyRelationField>)[fieldName];\n        if (!field) {\n            return;\n        }\n\n        const nextTargets = await this.resolveWriteTargets(fieldName, field.write, value);\n        await manager.set(...nextTargets);\n    }\n\n    private async resolveWriteTargets(\n        fieldName: ManyToManyManagerKeys<TModelRecord>,\n        strategy: AnyRelationField['write'],\n        value: unknown\n    ): Promise<readonly ManyToManyTargetRef<Record<string, unknown>>[]> {\n        switch (strategy.kind) {\n            case InternalManyToManyWriteStrategyKind.PK_LIST:\n                if (!Array.isArray(value)) {\n                    throw new TypeError(\n                        `Relation field '${String(fieldName)}' expects an array of primary-key values.`\n                    );\n                }\n                return value as readonly ManyToManyTargetRef<Record<string, unknown>>[];\n            case InternalManyToManyWriteStrategyKind.SLUG_LIST: {\n                if (!Array.isArray(value)) {\n                    throw new TypeError(`Relation field '${String(fieldName)}' expects an array of lookup values.`);\n                }\n\n                const lookupValues = [...new Set(value.map((entry) => String(entry).trim()).filter(Boolean))];\n                if (lookupValues.length === 0) {\n                    return [];\n                }\n\n                const filter = {\n                    [`${strategy.lookupField}__in`]: lookupValues,\n                } as FilterInput<Record<string, unknown>>;\n                const existing = await strategy.model.objects.query().filter(filter).fetch();\n                const byLookup = new Map(\n                    existing.results.map((row) => [String((row as Record<string, unknown>)[strategy.lookupField]), row])\n                );\n                const resolved: Record<string, unknown>[] = [];\n\n                for (const lookupValue of lookupValues) {\n                    const found = byLookup.get(lookupValue);\n                    if (found) {\n                        resolved.push(found);\n                        continue;\n                    }\n\n                    if (!strategy.createIfMissing) {\n                        throw new Error(\n                            `Relation field '${String(fieldName)}' could not resolve '${lookupValue}' via '${strategy.lookupField}'.`\n                        );\n                    }\n\n                    const created = await strategy.model.objects.create(\n                        strategy.buildCreateInput?.(lookupValue) ??\n                            ({ [strategy.lookupField]: lookupValue } as Record<string, unknown>)\n                    );\n                    resolved.push(created as Record<string, unknown>);\n                }\n\n                return resolved;\n            }\n        }\n    }\n\n    private getManyToManyManager(\n        record: TModelRecord,\n        fieldName: string\n    ): ManyToManyRelatedManager<Record<string, unknown>> {\n        const manager = (record as Record<string, unknown>)[fieldName];\n        if (!ManyToManyRelatedManager.isManyToManyRelatedManager(manager)) {\n            throw new Error(`Relation field '${fieldName}' is not backed by a many-to-many related manager.`);\n        }\n        return manager as ManyToManyRelatedManager<Record<string, unknown>>;\n    }\n\n    private getManyToManyRelationMeta(\n        fieldName: string\n    ): NonNullable<NonNullable<ManagerLike<TModelRecord>['meta']['relations']>[string]> {\n        const relation = this.getManager().meta.relations?.[fieldName];\n        if (!relation || relation.kind !== InternalSerializerRelationKind.MANY_TO_MANY) {\n            throw new Error(`Relation field '${fieldName}' is not a persisted many-to-many edge.`);\n        }\n        return relation;\n    }\n}\n\nexport type { AnySerializerClass };\n","import { z } from 'zod';\nimport type { ManyToManyRelatedManager } from '@danceroutine/tango-orm';\nimport type { ResourceModelLike } from '../resource/ResourceModelLike';\nimport {\n    InternalManyToManyReadStrategyKind,\n    InternalManyToManyWriteStrategyKind,\n    InternalSerializerRelationKind,\n} from './internal/InternalSerializerRelationKind';\n\ntype AnyRecord = Record<string, unknown>;\n\nexport type ManyToManyManagerKeys<TRecord extends AnyRecord> = Extract<\n    {\n        [K in keyof TRecord]: TRecord[K] extends ManyToManyRelatedManager<AnyRecord> ? K : never;\n    }[keyof TRecord],\n    string\n>;\n\nexport type ManyToManyTargetRow<TRecord extends AnyRecord, TFieldName extends ManyToManyManagerKeys<TRecord>> =\n    TRecord[TFieldName] extends ManyToManyRelatedManager<infer TTarget extends AnyRecord> ? TTarget : never;\n\nexport type ManyToManyPkListStrategy = {\n    kind: typeof InternalManyToManyReadStrategyKind.PK_LIST | typeof InternalManyToManyWriteStrategyKind.PK_LIST;\n};\n\nexport type ManyToManyNestedStrategy = {\n    kind: typeof InternalManyToManyReadStrategyKind.NESTED;\n    schema: z.ZodTypeAny;\n};\n\nexport type ManyToManySlugListStrategy<TTarget extends AnyRecord> = {\n    kind: typeof InternalManyToManyWriteStrategyKind.SLUG_LIST;\n    // oxlint-disable-next-line typescript/no-explicit-any\n    model: ResourceModelLike<any, any>;\n    lookupField: Extract<keyof TTarget, string>;\n    createIfMissing?: boolean;\n    buildCreateInput?: (value: string) => Partial<TTarget>;\n};\n\nexport type ManyToManyReadStrategy = ManyToManyPkListStrategy | ManyToManyNestedStrategy;\nexport type ManyToManyWriteStrategy<TTarget extends AnyRecord> =\n    | ManyToManyPkListStrategy\n    | ManyToManySlugListStrategy<TTarget>;\n\nexport type ManyToManyRelationField<TRecord extends AnyRecord, TFieldName extends ManyToManyManagerKeys<TRecord>> = {\n    kind: typeof InternalSerializerRelationKind.MANY_TO_MANY;\n    read: ManyToManyReadStrategy;\n    write: ManyToManyWriteStrategy<ManyToManyTargetRow<TRecord, TFieldName>>;\n};\n\nexport type ModelSerializerRelationFields<TRecord extends AnyRecord> = Partial<{\n    [K in ManyToManyManagerKeys<TRecord>]: ManyToManyRelationField<TRecord, K>;\n}>;\n\nfunction pkList(): ManyToManyPkListStrategy {\n    return { kind: InternalManyToManyReadStrategyKind.PK_LIST };\n}\n\nfunction nested(schema: z.ZodTypeAny): ManyToManyNestedStrategy {\n    return { kind: InternalManyToManyReadStrategyKind.NESTED, schema };\n}\n\nfunction slugList<TTarget extends AnyRecord>(\n    options: Omit<ManyToManySlugListStrategy<TTarget>, 'kind'>\n): ManyToManySlugListStrategy<TTarget> {\n    return {\n        kind: InternalManyToManyWriteStrategyKind.SLUG_LIST,\n        ...options,\n    };\n}\n\nfunction manyToMany(\n    // oxlint-disable-next-line typescript/no-explicit-any\n    config: Partial<Pick<ManyToManyRelationField<any, any>, 'read' | 'write'>> = {}\n    // oxlint-disable-next-line typescript/no-explicit-any\n): ManyToManyRelationField<any, any> {\n    return {\n        kind: InternalSerializerRelationKind.MANY_TO_MANY,\n        read: config.read ?? pkList(),\n        write: config.write ?? pkList(),\n    };\n}\n\nexport type RelationHelpers = {\n    manyToMany: typeof manyToMany;\n    pkList: typeof pkList;\n    nested: typeof nested;\n    slugList: typeof slugList;\n};\n\nexport const relation: RelationHelpers = {\n    manyToMany: manyToMany,\n    pkList: pkList,\n    nested: nested,\n    slugList: slugList,\n};\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport {\n    Serializer,\n    type SerializerClass,\n    type AnySerializerClass,\n    type SerializerCreateInput,\n    type SerializerOutputResolver,\n    type SerializerOutputResolvers,\n    type SerializerUpdateInput,\n    type SerializerOutput,\n    type SerializerSchema,\n} from './Serializer';\nexport {\n    ModelSerializer,\n    type ModelSerializerClass,\n    type AnyModelSerializer,\n    type AnyModelSerializerClass,\n} from './ModelSerializer';\nexport {\n    relation,\n    type ModelSerializerRelationFields,\n    type ManyToManyManagerKeys,\n    type ManyToManyRelationField,\n    type ManyToManyReadStrategy,\n    type ManyToManyWriteStrategy,\n} from './relation';\n"],"mappings":";;;;;AAgCA,MAAM,SAAS,UAAU,4BAA4B;AACrD,IAAI,4CAA4C;;;;;;;;AAShD,IAAsB,aAAtB,MAKE;CACE,OAAgB,eAAiC,EAAE,QAAQ;CAC3D,OAAgB,eAAiC,EAAE,QAAQ;CAC3D,OAAgB,eAAiC,EAAE,QAAQ;CAC3D,OAAgB,kBAGE,KAAA;;;;CAKlB,qBAA4F;EACxF,OAAO,KAAK;CAChB;;;;CAKA,kBAAiC;EAC7B,OAAO,KAAK,mBAAmB,EAAE;CACrC;;;;CAKA,kBAAiC;EAC7B,OAAO,KAAK,mBAAmB,EAAE;CACrC;;;;CAKA,kBAAiC;EAC7B,OAAO,KAAK,mBAAmB,EAAE;CACrC;;;;;CAMA,qBAAyD;EACrD,OAAO,KAAK,mBAAmB,EAAE,mBAAmB,CAAC;CACzD;;;;CAKA,kBAAkB,OAAyC;EACvD,OAAO,KAAK,gBAAgB,EAAE,MAAM,KAAK;CAC7C;;;;CAKA,kBAAkB,OAAyC;EACvD,OAAO,KAAK,gBAAgB,EAAE,MAAM,KAAK;CAC7C;;;;;;;CAQA,iBAAiB,QAA0C;EACvD,IAAI,CAAC,2CAA2C;GAC5C,4CAA4C;GAC5C,OAAO,KACH,gIACJ;EACJ;EACA,OAAO,KAAK,gBAAgB,EAAE,MAAM,MAAM;CAC9C;;;;;CAMA,MAAM,UAAU,QAAmD;EAC/D,OAAO,KAAK,gBAAgB,EAAE,MAAM,MAAM,KAAK,qBAAqB,MAAM,CAAC;CAC/E;;;;CAKA,MAAM,cAAc,SAAiE;EACjF,OAAO,QAAQ,IAAI,QAAQ,KAAK,WAAW,KAAK,UAAU,MAAM,CAAC,CAAC;CACtE;CAEA,MAAc,qBAAqB,QAAmC;EAClE,MAAM,YAAY,KAAK,mBAAmB;EAC1C,MAAM,kBAAkB,OAAO,QAAQ,SAAS;EAEhD,IAAI,gBAAgB,WAAW,KAAK,OAAO,WAAW,YAAY,WAAW,MACzE,OAAO;EAGX,MAAM,WAAW,MAAM,QAAQ,IAC3B,gBAAgB,IAAI,OAAO,CAAC,KAAK,cAAc,CAAC,KAAK,MAAM,SAAS,MAAM,CAAC,CAAU,CACzF;EAEA,OAAO;GACH,GAAI;GACJ,GAAG,OAAO,YAAY,QAAQ;EAClC;CACJ;AACJ;;;AC1JA,MAAa,iCAAiC,EAC1C,cAAc,aAClB;AAEA,MAAa,qCAAqC;CAC9C,SAAS;CACT,QAAQ;AACZ;AAEA,MAAa,sCAAsC;CAC/C,SAAS;CACT,WAAW;AACf;;;;;;ACsCA,IAAsB,kBAAtB,cAMU,WAAsE;CAC5E,OAAgB;CAChB,OAAgB,iBAAqF,KAAA;;;;CAKrG,WAAoD;EAChD,MAAM,QACF,KAAK,YAGP;EAEF,IAAI,CAAC,OACD,MAAM,IAAI,MAAM,GAAG,KAAK,YAAY,KAAK,oDAAoD;EAGjG,OAAO;CACX;;;;CAKA,aAAwC;EACpC,OAAO,KAAK,SAAS,EAAE;CAC3B;;;;CAKA,oBAAiE;EAC7D,OAEQ,KAAK,YAGP,kBAAkB,CAAC;CAE7B;;;;CAKA,qBAAuE;EACnE,MAAM,gBAAgB,MAAM,mBAAmB;EAC/C,MAAM,iBAAiB,KAAK,kBAAkB;EAQ9C,OAAO;GACH,GARsB,OAAO,YAC7B,OAAO,QAAQ,cAAc,EAAE,KAAK,CAAC,WAAW,WAAW,CACvD,WACA,OAAO,WAAyB,KAAK,uBAAuB,QAAQ,WAAW,KAAK,CACxF,CAAC,CAIkB;GACnB,GAAG;EACP;CACJ;;;;CAKA,MAAM,OACF,OAGF;EACE,MAAM,YAAY,KAAK,kBAAkB,KAAK;EAC9C,MAAM,iBAAiB,KAAK,sBAAsB,WAAW,KAAK;EAClE,MAAM,WAAW,MAAM,KAAK,aAAa,SAAS;EAClD,MAAM,UAAU,MAAM,KAAK,WAAW,EAAE,OAAO,KAAK,oBAAoB,QAAQ,CAAC;EACjF,MAAM,KAAK,oBAAoB,SAAS,cAAc;EACtD,OAAO,KAAK,UAAU,OAAO;CACjC;;;;CAKA,MAAM,OACF,IACA,OAGF;EACE,MAAM,YAAY,KAAK,kBAAkB,KAAK;EAC9C,MAAM,iBAAiB,KAAK,sBAAsB,WAAW,KAAK;EAClE,MAAM,WAAW,MAAM,KAAK,aAAa,IAAI,SAAS;EACtD,MAAM,UAAU,MAAM,KAAK,WAAW,EAAE,OAAO,IAAI,KAAK,oBAAoB,QAAQ,CAAC;EACrF,MAAM,KAAK,oBAAoB,SAAS,cAAc;EACtD,OAAO,KAAK,UAAU,OAAO;CACjC;;;;;;;;CASA,MAAgB,aACZ,MAG8B;EAC9B,OAAO;CACX;;;;;;;;CASA,MAAgB,aACZ,KACA,MAG8B;EAC9B,OAAO;CACX;CAEA,sBACI,MACA,UAC6D;EAC7D,IAAI,OAAO,SAAS,YAAY,SAAS,QAAQ,OAAO,aAAa,YAAY,aAAa,MAC1F,OAAO,CAAC;EAGZ,MAAM,iBAAiB,KAAK,kBAAkB;EAC9C,MAAM,SAAwE,CAAC;EAE/E,KAAK,MAAM,aAAa,OAAO,KAAK,cAAc,GAC9C,IAAI,aAAa,UACb,OAAO,aAAc,KAAiC;EAI9D,OAAO;CACX;CAEA,oBAA4B,MAAoD;EAC5E,MAAM,qBAAqB,IAAI,IAAI,OAAO,KAAK,KAAK,kBAAkB,CAAC,CAAC;EACxE,IAAI,mBAAmB,SAAS,GAC5B,OAAO;EAGX,OAAO,OAAO,YACV,OAAO,QAAQ,IAA+B,EAAE,QAAQ,CAAC,eAAe,CAAC,mBAAmB,IAAI,SAAS,CAAC,CAC9G;CACJ;CAEA,MAAc,oBACV,QACA,QACa;EACb,MAAM,iBAAiB,KAAK,kBAAkB;EAE9C,KAAK,MAAM,CAAC,WAAW,UAAU,OAAO,QAAQ,MAAM,GAEnD;GAEC,IAAI,CADU,eAAe,YAEzB;GAEJ,MAAM,KAAK,uBAAuB,QAAQ,WAAW,KAAK;EAC9D;CACJ;CAEA,MAAc,uBACV,QACA,WACA,OACgB;EAEhB,MAAM,QAAQ,MADE,KAAK,qBAAqB,QAAQ,SACxB,EAAE,IAAI,EAAE,MAAM,GAAG;EAC3C,MAAM,eAAe,KAAK,0BAA0B,SAAS;EAE7D,QAAQ,MAAM,KAAK,MAAnB;GACI,KAAK,mCAAmC,SACpC,OAAO,KAAK,KAAK,QAAQ,IAAI,aAAa,iBAAiB;GAC/D,KAAK,mCAAmC,QACpC,OAAO,KAAK,KAAK,QACZ,MAAM,KAA4D,OAAO,MAAM,GAAG,CACvF;EACR;CACJ;CAEA,MAAc,uBACV,QACA,WACA,OACa;EACb,IAAI,UAAU,KAAA,GACV;EAGJ,MAAM,UAAU,KAAK,qBAAqB,QAAQ,SAAS;EAC3D,MAAM,QAAS,KAAK,kBAAkB,EAAuC;EAC7E,IAAI,CAAC,OACD;EAGJ,MAAM,cAAc,MAAM,KAAK,oBAAoB,WAAW,MAAM,OAAO,KAAK;EAChF,MAAM,QAAQ,IAAI,GAAG,WAAW;CACpC;CAEA,MAAc,oBACV,WACA,UACA,OACgE;EAChE,QAAQ,SAAS,MAAjB;GACI,KAAK,oCAAoC;IACrC,IAAI,CAAC,MAAM,QAAQ,KAAK,GACpB,MAAM,IAAI,UACN,mBAAmB,OAAO,SAAS,EAAE,0CACzC;IAEJ,OAAO;GACX,KAAK,oCAAoC,WAAW;IAChD,IAAI,CAAC,MAAM,QAAQ,KAAK,GACpB,MAAM,IAAI,UAAU,mBAAmB,OAAO,SAAS,EAAE,qCAAqC;IAGlG,MAAM,eAAe,CAAC,GAAG,IAAI,IAAI,MAAM,KAAK,UAAU,OAAO,KAAK,EAAE,KAAK,CAAC,EAAE,OAAO,OAAO,CAAC,CAAC;IAC5F,IAAI,aAAa,WAAW,GACxB,OAAO,CAAC;IAGZ,MAAM,SAAS,GACV,GAAG,SAAS,YAAY,QAAQ,aACrC;IACA,MAAM,WAAW,MAAM,SAAS,MAAM,QAAQ,MAAM,EAAE,OAAO,MAAM,EAAE,MAAM;IAC3E,MAAM,WAAW,IAAI,IACjB,SAAS,QAAQ,KAAK,QAAQ,CAAC,OAAQ,IAAgC,SAAS,YAAY,GAAG,GAAG,CAAC,CACvG;IACA,MAAM,WAAsC,CAAC;IAE7C,KAAK,MAAM,eAAe,cAAc;KACpC,MAAM,QAAQ,SAAS,IAAI,WAAW;KACtC,IAAI,OAAO;MACP,SAAS,KAAK,KAAK;MACnB;KACJ;KAEA,IAAI,CAAC,SAAS,iBACV,MAAM,IAAI,MACN,mBAAmB,OAAO,SAAS,EAAE,uBAAuB,YAAY,SAAS,SAAS,YAAY,GAC1G;KAGJ,MAAM,UAAU,MAAM,SAAS,MAAM,QAAQ,OACzC,SAAS,mBAAmB,WAAW,KAClC,GAAG,SAAS,cAAc,YAAY,CAC/C;KACA,SAAS,KAAK,OAAkC;IACpD;IAEA,OAAO;GACX;EACJ;CACJ;CAEA,qBACI,QACA,WACiD;EACjD,MAAM,UAAW,OAAmC;EACpD,IAAI,CAAC,yBAAyB,2BAA2B,OAAO,GAC5D,MAAM,IAAI,MAAM,mBAAmB,UAAU,mDAAmD;EAEpG,OAAO;CACX;CAEA,0BACI,WACgF;EAChF,MAAM,WAAW,KAAK,WAAW,EAAE,KAAK,YAAY;EACpD,IAAI,CAAC,YAAY,SAAS,SAAS,+BAA+B,cAC9D,MAAM,IAAI,MAAM,mBAAmB,UAAU,wCAAwC;EAEzF,OAAO;CACX;AACJ;;;ACjSA,SAAS,SAAmC;CACxC,OAAO,EAAE,MAAM,mCAAmC,QAAQ;AAC9D;AAEA,SAAS,OAAO,QAAgD;CAC5D,OAAO;EAAE,MAAM,mCAAmC;EAAQ;CAAO;AACrE;AAEA,SAAS,SACL,SACmC;CACnC,OAAO;EACH,MAAM,oCAAoC;EAC1C,GAAG;CACP;AACJ;AAEA,SAAS,WAEL,SAA6E,CAAC,GAE7C;CACjC,OAAO;EACH,MAAM,+BAA+B;EACrC,MAAM,OAAO,QAAQ,OAAO;EAC5B,OAAO,OAAO,SAAS,OAAO;CAClC;AACJ;AASA,MAAa,WAA4B;CACzB;CACJ;CACA;CACE;AACd"}

package/dist/view/index.d.ts

@@ -1,2 +1,3 @@
-import { U as APIView, W as APIViewMethod, _ as GenericAPIViewOpenAPIDescription, a as ListCreateAPIView, c as ListAPIView, d as RetrieveModelMixin, f as CreateModelMixin, h as GenericAPIViewConfig, i as RetrieveUpdateAPIView, l as DestroyModelMixin, m as GenericAPIView, n as RetrieveUpdateDestroyAPIView, o as RetrieveAPIView, p as ListModelMixin, r as RetrieveDestroyAPIView, s as CreateAPIView, u as UpdateModelMixin } from "../index-D6sfTSEj.js";
+import { d as APIViewMethod, n as GenericAPIViewOpenAPIDescription, u as APIView } from "../index-DkJtxvKu.js";
+import { a as ListCreateAPIView, c as ListAPIView, d as RetrieveModelMixin, f as CreateModelMixin, h as GenericAPIViewConfig, i as RetrieveUpdateAPIView, l as DestroyModelMixin, m as GenericAPIView, n as RetrieveUpdateDestroyAPIView, o as RetrieveAPIView, p as ListModelMixin, r as RetrieveDestroyAPIView, s as CreateAPIView, u as UpdateModelMixin } from "../index-Bg6TtnmQ.js";
 export { APIView, type APIViewMethod, CreateAPIView, CreateModelMixin, DestroyModelMixin, GenericAPIView, type GenericAPIViewConfig, type GenericAPIViewOpenAPIDescription, ListAPIView, ListCreateAPIView, ListModelMixin, RetrieveAPIView, RetrieveDestroyAPIView, RetrieveModelMixin, RetrieveUpdateAPIView, RetrieveUpdateDestroyAPIView, UpdateModelMixin };

package/dist/view/index.js

@@ -1,2 +1,2 @@
-import { a as ListCreateAPIView, c as ListAPIView, d as RetrieveModelMixin, f as CreateModelMixin, 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, u as UpdateModelMixin } from "../view-C9B5Lln3.js";
+import { a as ListCreateAPIView, c as ListAPIView, d as RetrieveModelMixin, f as CreateModelMixin, 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, u as UpdateModelMixin } from "../view-CYdJAO4t.js";
 export { APIView, CreateAPIView, CreateModelMixin, DestroyModelMixin, GenericAPIView, ListAPIView, ListCreateAPIView, ListModelMixin, RetrieveAPIView, RetrieveDestroyAPIView, RetrieveModelMixin, RetrieveUpdateAPIView, RetrieveUpdateDestroyAPIView, UpdateModelMixin };