@danceroutine/tango-resources 1.11.3 → 1.11.5

package/dist/context-euBQvNRT.js

@@ -0,0 +1,65 @@
+import { t as __exportAll } from "./chunk-D7D4PA-g.js";
+import { TangoRequest } from "@danceroutine/tango-core";
+//#region src/context/RequestContext.ts
+/**
+* Normalized request context passed through the framework adapter into viewset methods.
+* Generic over the user type so consumers can plug in their own auth infrastructure.
+*/
+var RequestContext = class RequestContext {
+	request;
+	user;
+	params;
+	static BRAND = "tango.resources.request_context";
+	__tangoBrand = RequestContext.BRAND;
+	state = /* @__PURE__ */ new Map();
+	constructor(request, user = null, params = {}) {
+		this.request = request;
+		this.user = user;
+		this.params = params;
+	}
+	/**
+	* Narrow an unknown value to `RequestContext`.
+	*/
+	static isRequestContext(value) {
+		return typeof value === "object" && value !== null && value.__tangoBrand === RequestContext.BRAND;
+	}
+	/**
+	* Construct a context with optional user payload.
+	*/
+	static create(request, user) {
+		return new RequestContext(TangoRequest.isTangoRequest(request) ? request : new TangoRequest(request), user ?? null);
+	}
+	/**
+	* Store arbitrary per-request state for downstream middleware/handlers.
+	*/
+	setState(key, value) {
+		this.state.set(key, value);
+	}
+	/**
+	* Retrieve previously stored request state.
+	*/
+	getState(key) {
+		return this.state.get(key);
+	}
+	/**
+	* Check whether a state key has been set.
+	*/
+	hasState(key) {
+		return this.state.has(key);
+	}
+	/**
+	* Clone the context, including route params and request-local state.
+	*/
+	clone() {
+		const cloned = new RequestContext(this.request, this.user, { ...this.params });
+		cloned.state = new Map(this.state);
+		return cloned;
+	}
+};
+//#endregion
+//#region src/context/index.ts
+var context_exports = /* @__PURE__ */ __exportAll({ RequestContext: () => RequestContext });
+//#endregion
+export { RequestContext as n, context_exports as t };
+
+//# sourceMappingURL=context-euBQvNRT.js.map

package/dist/context-euBQvNRT.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-euBQvNRT.js","names":[],"sources":["../src/context/RequestContext.ts","../src/context/index.ts"],"sourcesContent":["import { TangoRequest } from '@danceroutine/tango-core';\n\n/**\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    readonly __tangoBrand: typeof RequestContext.BRAND = RequestContext.BRAND;\n    private state: Map<string | symbol, unknown> = new Map();\n\n    constructor(\n        public readonly request: TangoRequest,\n        public user: TUser | null = null,\n        public params: Record<string, string> = {}\n    ) {}\n\n    /**\n     * Narrow an unknown value to `RequestContext`.\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    /**\n     * Construct a context with optional user payload.\n     */\n    static create<TUser = BaseUser>(request: Request, user?: TUser | null): RequestContext<TUser> {\n        return new RequestContext<TUser>(\n            TangoRequest.isTangoRequest(request) ? request : new TangoRequest(request),\n            user ?? null\n        );\n    }\n\n    /**\n     * Store arbitrary per-request state for downstream middleware/handlers.\n     */\n    setState<T>(key: string | symbol, value: T): void {\n        this.state.set(key, value);\n    }\n\n    /**\n     * Retrieve previously stored request state.\n     */\n    getState<T>(key: string | symbol): T | undefined {\n        return this.state.get(key) as T | undefined;\n    }\n\n    /**\n     * Check whether a state key has been set.\n     */\n    hasState(key: string | symbol): boolean {\n        return this.state.has(key);\n    }\n\n    /**\n     * Clone the context, including route params and request-local state.\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"],"mappings":";;;;;;;AAeA,IAAa,iBAAb,MAAa,eAAiC;CAMtB;CACT;CACA;CAPX,OAAgB,QAAQ;CACxB,eAAqD,eAAe;CACpE,wBAA+C,IAAI,IAAI;CAEvD,YACI,SACA,OAA4B,MAC5B,SAAwC,CAAC,GAC3C;EAHkB,KAAA,UAAA;EACT,KAAA,OAAA;EACA,KAAA,SAAA;CACR;;;;CAKH,OAAO,iBAAmC,OAAgD;EACtF,OACI,OAAO,UAAU,YACjB,UAAU,QACT,MAAqC,iBAAiB,eAAe;CAE9E;;;;CAKA,OAAO,OAAyB,SAAkB,MAA4C;EAC1F,OAAO,IAAI,eACP,aAAa,eAAe,OAAO,IAAI,UAAU,IAAI,aAAa,OAAO,GACzE,QAAQ,IACZ;CACJ;;;;CAKA,SAAY,KAAsB,OAAgB;EAC9C,KAAK,MAAM,IAAI,KAAK,KAAK;CAC7B;;;;CAKA,SAAY,KAAqC;EAC7C,OAAO,KAAK,MAAM,IAAI,GAAG;CAC7B;;;;CAKA,SAAS,KAA+B;EACpC,OAAO,KAAK,MAAM,IAAI,GAAG;CAC7B;;;;CAKA,QAA+B;EAC3B,MAAM,SAAS,IAAI,eAAsB,KAAK,SAAS,KAAK,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC;EACpF,OAAO,QAAQ,IAAI,IAAI,KAAK,KAAK;EACjC,OAAO;CACX;AACJ"}

package/dist/filters/index.d.ts

@@ -0,0 +1,2 @@
+import { a as FilterResolver, c as FilterValueParser, i as FilterLookup, l as RangeOperator, n as AliasFilterDeclaration, o as FilterSet, r as FieldFilterDeclaration, s as FilterSetDefineConfig, u as FilterType } from "../index-CiIB-1Ac.js";
+export { type AliasFilterDeclaration, type FieldFilterDeclaration, type FilterLookup, type FilterResolver, FilterSet, type FilterSetDefineConfig, type FilterType, type FilterValueParser, type RangeOperator };

package/dist/filters/index.js

@@ -0,0 +1,2 @@
+import { n as FilterSet } from "../filters-46d2Nr5C.js";
+export { FilterSet };

package/dist/filters-46d2Nr5C.js

@@ -0,0 +1,287 @@
+import { t as __exportAll } from "./chunk-D7D4PA-g.js";
+import "@danceroutine/tango-core";
+//#region src/filters/internal/InternalFilterType.ts
+const InternalFilterType = {
+	SCALAR: "scalar",
+	ILIKE: "ilike",
+	RANGE: "range",
+	IN: "in",
+	CUSTOM: "custom"
+};
+//#endregion
+//#region src/filters/internal/InternalFilterLookup.ts
+const InternalFilterLookup = {
+	EXACT: "exact",
+	LT: "lt",
+	LTE: "lte",
+	GT: "gt",
+	GTE: "gte",
+	IN: "in",
+	ISNULL: "isnull",
+	CONTAINS: "contains",
+	ICONTAINS: "icontains",
+	STARTSWITH: "startswith",
+	ISTARTSWITH: "istartswith",
+	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;
+	/**
+	* Resolve matching query parameters into ORM filter inputs.
+	*/
+	constructor(spec, allowAllParams = false) {
+		this.spec = spec;
+		this.allowAllParams = allowAllParams;
+	}
+	/**
+	* Build a filter set from Django-style field declarations.
+	*/
+	static define(config) {
+		return new FilterSet(FilterSet.normalizeDefineConfig(config), config.all === "__all__");
+	}
+	/**
+	* Narrow an unknown value to `FilterSet`.
+	*/
+	static isFilterSet(value) {
+		return typeof value === "object" && value !== null && value.__tangoBrand === FilterSet.BRAND;
+	}
+	static normalizeDefineConfig(config) {
+		const spec = {};
+		const fieldDeclarations = config.fields ?? {};
+		const fieldParsers = config.parsers ?? {};
+		for (const rawField of Object.keys(fieldDeclarations)) {
+			const declaration = fieldDeclarations[rawField];
+			if (declaration === void 0) continue;
+			const parser = fieldParsers[rawField];
+			FilterSet.addFieldDeclaration(spec, rawField, declaration, parser);
+		}
+		const aliases = config.aliases ?? {};
+		for (const [param, declaration] of Object.entries(aliases)) spec[param] = FilterSet.normalizeAliasDeclaration(declaration);
+		return spec;
+	}
+	static addFieldDeclaration(spec, field, declaration, parser) {
+		if (declaration === true) {
+			spec[String(field)] = FilterSet.createLookupResolver(field, InternalFilterLookup.EXACT, parser);
+			return;
+		}
+		if (FilterSet.isLookupArray(declaration)) {
+			for (const lookup of declaration) {
+				const param = FilterSet.resolveLookupParam(String(field), lookup);
+				spec[param] = FilterSet.createLookupResolver(field, lookup, parser);
+			}
+			return;
+		}
+		const lookups = declaration.lookups ?? [InternalFilterLookup.EXACT];
+		const baseParam = declaration.param ?? String(field);
+		const effectiveParser = declaration.parse ?? parser;
+		for (const lookup of lookups) {
+			const param = FilterSet.resolveLookupParam(baseParam, lookup);
+			spec[param] = FilterSet.createLookupResolver(field, lookup, effectiveParser);
+		}
+	}
+	static isLookupArray(value) {
+		return Array.isArray(value);
+	}
+	static normalizeAliasDeclaration(declaration) {
+		if (FilterSet.isFilterResolverDeclaration(declaration)) return declaration;
+		if ("fields" in declaration) {
+			const lookup = declaration.lookup ?? InternalFilterLookup.ICONTAINS;
+			return FilterSet.createMultiFieldResolver(declaration.fields, lookup, declaration.parse);
+		}
+		return FilterSet.createLookupResolver(declaration.field, declaration.lookup ?? InternalFilterLookup.EXACT, declaration.parse);
+	}
+	static isFilterResolverDeclaration(value) {
+		if (typeof value !== "object" || value === null || !("type" in value)) return false;
+		return [
+			InternalFilterType.SCALAR,
+			InternalFilterType.ILIKE,
+			InternalFilterType.RANGE,
+			InternalFilterType.IN,
+			InternalFilterType.CUSTOM
+		].includes(value.type);
+	}
+	static createMultiFieldResolver(fields, lookup, parser) {
+		if (lookup === InternalFilterLookup.ICONTAINS && parser === void 0) return {
+			type: InternalFilterType.ILIKE,
+			columns: [...fields]
+		};
+		return {
+			type: InternalFilterType.CUSTOM,
+			apply: (raw) => {
+				const parsed = FilterSet.resolveParserValue(raw, parser);
+				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 : void 0;
+			}
+		};
+	}
+	static createLookupResolver(field, lookup, parser) {
+		if (parser !== void 0) return {
+			type: InternalFilterType.CUSTOM,
+			apply: (raw) => {
+				const parsed = FilterSet.resolveParserValue(raw, parser);
+				if (parsed === void 0) return void 0;
+				return FilterSet.resolveLookupFilter(field, lookup, parsed);
+			}
+		};
+		switch (lookup) {
+			case "exact": return {
+				type: InternalFilterType.SCALAR,
+				column: field
+			};
+			case "in": return {
+				type: InternalFilterType.IN,
+				column: field
+			};
+			case "lt":
+			case "lte":
+			case "gt":
+			case "gte": return {
+				type: InternalFilterType.RANGE,
+				column: field,
+				op: lookup
+			};
+			case "icontains": return {
+				type: InternalFilterType.ILIKE,
+				columns: [field]
+			};
+			default: return {
+				type: InternalFilterType.CUSTOM,
+				apply: (raw) => FilterSet.resolveLookupFilter(field, lookup, raw)
+			};
+		}
+	}
+	static resolveLookupFilter(field, lookup, value) {
+		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(",");
+			return { [`${String(field)}__in`]: arr };
+		}
+		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 === void 0) return;
+		if (parser === void 0) return value;
+		return parser(value);
+	}
+	static toScalarString(value) {
+		if (Array.isArray(value)) return value.join(",");
+		return String(value);
+	}
+	/**
+	* Return a new filter set with parser-aware scalar/range/in resolvers for matching fields.
+	*/
+	withFieldParsers(parsers) {
+		if (Object.keys(parsers).length === 0) return this;
+		let changed = false;
+		const nextSpec = Object.fromEntries(Object.entries(this.spec).map(([param, resolver]) => {
+			const nextResolver = this.applyFieldParserOverride(resolver, parsers);
+			if (nextResolver !== resolver) changed = true;
+			return [param, nextResolver];
+		}));
+		return changed ? new FilterSet(nextSpec, this.allowAllParams) : this;
+	}
+	/**
+	* Apply all configured resolvers against query params.
+	*/
+	apply(params) {
+		const filters = [];
+		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) : void 0);
+			if (!resolver) continue;
+			const rawValue = params.getAll(key);
+			const value = rawValue.length > 1 ? rawValue : rawValue[0];
+			if (value === void 0) continue;
+			const filter = this.resolveFilter(resolver, value);
+			if (filter) filters.push(filter);
+		}
+		return filters;
+	}
+	buildAllResolver(param) {
+		const segments = param.split("__").filter(Boolean);
+		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;
+		if (lookup === "exact") return {
+			type: InternalFilterType.SCALAR,
+			column: field
+		};
+		return FilterSet.createLookupResolver(field, lookup);
+	}
+	resolveFilter(resolver, value) {
+		if (value === void 0) return void 0;
+		switch (resolver.type) {
+			case InternalFilterType.SCALAR: return { [resolver.column]: value };
+			case InternalFilterType.ILIKE: {
+				const pattern = FilterSet.toScalarString(value);
+				const filter = {};
+				resolver.columns.forEach((col) => {
+					filter[`${String(col)}__icontains`] = pattern;
+				});
+				return filter;
+			}
+			case InternalFilterType.RANGE: return { [`${String(resolver.column)}__${resolver.op}`]: value };
+			case InternalFilterType.IN: {
+				const arr = Array.isArray(value) ? value : String(value).split(",");
+				return { [`${String(resolver.column)}__in`]: arr };
+			}
+			case InternalFilterType.CUSTOM: return resolver.apply(value);
+			default: return;
+		}
+	}
+	applyFieldParserOverride(resolver, parsers) {
+		switch (resolver.type) {
+			case InternalFilterType.SCALAR: {
+				const parser = parsers[resolver.column];
+				return parser ? FilterSet.createLookupResolver(resolver.column, "exact", parser) : resolver;
+			}
+			case InternalFilterType.RANGE: {
+				const parser = parsers[resolver.column];
+				return parser ? FilterSet.createLookupResolver(resolver.column, resolver.op, parser) : resolver;
+			}
+			case InternalFilterType.IN: {
+				const parser = parsers[resolver.column];
+				return parser ? FilterSet.createLookupResolver(resolver.column, "in", parser) : resolver;
+			}
+			default: return resolver;
+		}
+	}
+};
+//#endregion
+//#region src/filters/index.ts
+var filters_exports = /* @__PURE__ */ __exportAll({ FilterSet: () => FilterSet });
+//#endregion
+export { FilterSet as n, filters_exports as t };
+
+//# sourceMappingURL=filters-46d2Nr5C.js.map

package/dist/filters-46d2Nr5C.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters-46d2Nr5C.js","names":[],"sources":["../src/filters/internal/InternalFilterType.ts","../src/filters/internal/InternalFilterLookup.ts","../src/filters/FilterSet.ts","../src/filters/index.ts"],"sourcesContent":["export const InternalFilterType = {\n    SCALAR: 'scalar',\n    ILIKE: 'ilike',\n    RANGE: 'range',\n    IN: 'in',\n    CUSTOM: 'custom',\n} as const;\n","export const InternalFilterLookup = {\n    EXACT: 'exact',\n    LT: 'lt',\n    LTE: 'lte',\n    GT: 'gt',\n    GTE: 'gte',\n    IN: 'in',\n    ISNULL: 'isnull',\n    CONTAINS: 'contains',\n    ICONTAINS: 'icontains',\n    STARTSWITH: 'startswith',\n    ISTARTSWITH: 'istartswith',\n    ENDSWITH: 'endswith',\n    IENDSWITH: 'iendswith',\n} as const;\n","import { TangoQueryParams } from '@danceroutine/tango-core';\nimport type { FilterInput, FilterKey, FilterValue, LookupType } from '@danceroutine/tango-orm';\nimport { InternalFilterType } from './internal/InternalFilterType';\nimport { InternalFilterLookup } from './internal/InternalFilterLookup';\nimport type { RangeOperator } from './RangeOperator';\n\nconst FILTER_LOOKUPS = Object.values(InternalFilterLookup) as readonly LookupType[];\n\ntype FilterFieldRef<T extends Record<string, unknown>> = Extract<keyof T, string> | string;\n\nfunction isFilterLookup(value: string): value is LookupType {\n    return (FILTER_LOOKUPS as readonly string[]).includes(value);\n}\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 extends Record<string, unknown>> =\n    | { type: typeof InternalFilterType.SCALAR; column: FilterFieldRef<T> }\n    | { type: typeof InternalFilterType.ILIKE; columns: FilterFieldRef<T>[] }\n    | { type: typeof InternalFilterType.RANGE; column: FilterFieldRef<T>; op: RangeOperator }\n    | { type: typeof InternalFilterType.IN; column: FilterFieldRef<T> }\n    | {\n          type: typeof InternalFilterType.CUSTOM;\n          apply: (value: string | string[] | undefined) => FilterInput<T> | undefined;\n      };\n\nexport type FilterLookup = LookupType;\n\nexport type FilterValueParser = (raw: string | string[]) => FilterValue | FilterValue[] | undefined;\n\nexport type FieldFilterDeclaration =\n    | true\n    | readonly FilterLookup[]\n    | {\n          lookups?: readonly FilterLookup[];\n          param?: string;\n          parse?: FilterValueParser;\n      };\n\nexport type AliasFilterDeclaration<T extends Record<string, unknown>> =\n    | FilterResolver<T>\n    | {\n          field: FilterFieldRef<T>;\n          lookup?: FilterLookup;\n          parse?: FilterValueParser;\n      }\n    | {\n          fields: readonly FilterFieldRef<T>[];\n          lookup?: FilterLookup;\n          parse?: FilterValueParser;\n      };\n\nexport interface FilterSetDefineConfig<T extends Record<string, unknown>> {\n    fields?: Partial<Record<string, FieldFilterDeclaration>>;\n    aliases?: Record<string, AliasFilterDeclaration<T>>;\n    parsers?: Partial<Record<string, FilterValueParser>>;\n    all?: '__all__';\n}\n\ntype ResolvedFilterValue = string | string[] | FilterValue | FilterValue[];\n\n/**\n * Declarative query-param to filter translation.\n *\n * A `FilterSet` lets viewsets expose safe, explicit filtering behavior\n * without leaking raw ORM filter syntax to request handlers.\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    /**\n     * Resolve matching query parameters into ORM filter inputs.\n     */\n    constructor(\n        private readonly spec: Record<string, FilterResolver<T>>,\n        private readonly allowAllParams: boolean = false\n    ) {}\n\n    /**\n     * Build a filter set from Django-style field declarations.\n     */\n    static define<T extends Record<string, unknown>>(config: FilterSetDefineConfig<T>): FilterSet<T> {\n        const spec = FilterSet.normalizeDefineConfig(config);\n        return new FilterSet(spec, config.all === '__all__');\n    }\n\n    /**\n     * Narrow an unknown value to `FilterSet`.\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    private static normalizeDefineConfig<T extends Record<string, unknown>>(\n        config: FilterSetDefineConfig<T>\n    ): Record<string, FilterResolver<T>> {\n        const spec: Record<string, FilterResolver<T>> = {};\n        const fieldDeclarations: Partial<Record<string, FieldFilterDeclaration>> = config.fields ?? {};\n        const fieldParsers: Partial<Record<string, FilterValueParser>> = config.parsers ?? {};\n\n        for (const rawField of Object.keys(fieldDeclarations) as Array<FilterFieldRef<T>>) {\n            const declaration = fieldDeclarations[rawField];\n            if (declaration === undefined) continue;\n            const parser = fieldParsers[rawField];\n            FilterSet.addFieldDeclaration(spec, rawField, declaration, parser);\n        }\n\n        const aliases = config.aliases ?? {};\n        for (const [param, declaration] of Object.entries(aliases)) {\n            spec[param] = FilterSet.normalizeAliasDeclaration(declaration);\n        }\n\n        return spec;\n    }\n\n    private static addFieldDeclaration<T extends Record<string, unknown>>(\n        spec: Record<string, FilterResolver<T>>,\n        field: FilterFieldRef<T>,\n        declaration: FieldFilterDeclaration,\n        parser: FilterValueParser | undefined\n    ): void {\n        if (declaration === true) {\n            spec[String(field)] = FilterSet.createLookupResolver(field, InternalFilterLookup.EXACT, parser);\n            return;\n        }\n\n        if (FilterSet.isLookupArray(declaration)) {\n            for (const lookup of declaration) {\n                const param = FilterSet.resolveLookupParam(String(field), lookup);\n                spec[param] = FilterSet.createLookupResolver(field, lookup, parser);\n            }\n            return;\n        }\n\n        const lookups = declaration.lookups ?? [InternalFilterLookup.EXACT];\n        const baseParam = declaration.param ?? String(field);\n        const effectiveParser = declaration.parse ?? parser;\n\n        for (const lookup of lookups) {\n            const param = FilterSet.resolveLookupParam(baseParam, lookup);\n            spec[param] = FilterSet.createLookupResolver(field, lookup, effectiveParser);\n        }\n    }\n\n    private static isLookupArray(value: FieldFilterDeclaration): value is readonly FilterLookup[] {\n        return Array.isArray(value);\n    }\n\n    private static normalizeAliasDeclaration<T extends Record<string, unknown>>(\n        declaration: AliasFilterDeclaration<T>\n    ): FilterResolver<T> {\n        if (FilterSet.isFilterResolverDeclaration(declaration)) {\n            return declaration;\n        }\n\n        if ('fields' in declaration) {\n            const lookup = declaration.lookup ?? InternalFilterLookup.ICONTAINS;\n            return FilterSet.createMultiFieldResolver(declaration.fields, lookup, declaration.parse);\n        }\n\n        return FilterSet.createLookupResolver(\n            declaration.field,\n            declaration.lookup ?? InternalFilterLookup.EXACT,\n            declaration.parse\n        );\n    }\n\n    private static isFilterResolverDeclaration<T extends Record<string, unknown>>(\n        value: AliasFilterDeclaration<T>\n    ): value is FilterResolver<T> {\n        if (typeof value !== 'object' || value === null || !('type' in value)) {\n            return false;\n        }\n\n        return [\n            InternalFilterType.SCALAR,\n            InternalFilterType.ILIKE,\n            InternalFilterType.RANGE,\n            InternalFilterType.IN,\n            InternalFilterType.CUSTOM,\n        ].includes(value.type);\n    }\n\n    private static createMultiFieldResolver<T extends Record<string, unknown>>(\n        fields: readonly FilterFieldRef<T>[],\n        lookup: FilterLookup,\n        parser?: FilterValueParser\n    ): FilterResolver<T> {\n        if (lookup === InternalFilterLookup.ICONTAINS && parser === undefined) {\n            return { type: InternalFilterType.ILIKE, columns: [...fields] };\n        }\n\n        return {\n            type: InternalFilterType.CUSTOM,\n            apply: (raw) => {\n                const parsed = FilterSet.resolveParserValue(raw, parser);\n                if (parsed === undefined) return undefined;\n\n                const composed: Partial<Record<FilterKey<T>, FilterValue>> = {};\n                for (const field of fields) {\n                    const segment = FilterSet.resolveLookupFilter(field, lookup, parsed);\n                    if (!segment) continue;\n                    Object.assign(composed, segment);\n                }\n\n                return Object.keys(composed).length > 0 ? (composed as FilterInput<T>) : undefined;\n            },\n        };\n    }\n\n    private static createLookupResolver<T extends Record<string, unknown>>(\n        field: FilterFieldRef<T>,\n        lookup: FilterLookup,\n        parser?: FilterValueParser\n    ): FilterResolver<T> {\n        if (parser !== undefined) {\n            return {\n                type: InternalFilterType.CUSTOM,\n                apply: (raw) => {\n                    const parsed = FilterSet.resolveParserValue(raw, parser);\n                    if (parsed === undefined) return undefined;\n                    return FilterSet.resolveLookupFilter(field, lookup, parsed);\n                },\n            };\n        }\n\n        switch (lookup) {\n            case 'exact':\n                return { type: InternalFilterType.SCALAR, column: field };\n            case 'in':\n                return { type: InternalFilterType.IN, column: field };\n            case 'lt':\n            case 'lte':\n            case 'gt':\n            case 'gte':\n                return { type: InternalFilterType.RANGE, column: field, op: lookup };\n            case 'icontains':\n                return { type: InternalFilterType.ILIKE, columns: [field] };\n            default:\n                return {\n                    type: InternalFilterType.CUSTOM,\n                    apply: (raw) => FilterSet.resolveLookupFilter(field, lookup, raw),\n                };\n        }\n    }\n\n    private static resolveLookupFilter<T extends Record<string, unknown>>(\n        field: FilterFieldRef<T>,\n        lookup: FilterLookup,\n        value: ResolvedFilterValue | undefined\n    ): FilterInput<T> | undefined {\n        if (value === undefined) return undefined;\n\n        if (lookup === 'exact') {\n            return { [field]: value } as FilterInput<T>;\n        }\n\n        if (lookup === 'in') {\n            const arr = Array.isArray(value) ? value : String(value).split(',');\n            const lookupKey = `${String(field)}__in` as FilterKey<T>;\n            return { [lookupKey]: arr } as FilterInput<T>;\n        }\n\n        if (lookup === 'icontains') {\n            const lookupKey = `${String(field)}__icontains` as FilterKey<T>;\n            return { [lookupKey]: FilterSet.toScalarString(value) } as FilterInput<T>;\n        }\n\n        const lookupKey = `${String(field)}__${lookup}` as FilterKey<T>;\n        return { [lookupKey]: value as FilterValue } as FilterInput<T>;\n    }\n\n    private static resolveLookupParam(baseParam: string, lookup: FilterLookup): string {\n        if (lookup === 'exact') {\n            return baseParam;\n        }\n        return `${baseParam}__${lookup}`;\n    }\n\n    private static resolveParserValue(\n        value: string | string[] | undefined,\n        parser?: FilterValueParser\n    ): ResolvedFilterValue | undefined {\n        if (value === undefined) {\n            return undefined;\n        }\n\n        if (parser === undefined) {\n            return value;\n        }\n\n        return parser(value);\n    }\n\n    private static toScalarString(value: ResolvedFilterValue): string {\n        if (Array.isArray(value)) {\n            return value.join(',');\n        }\n        return String(value);\n    }\n\n    /**\n     * Return a new filter set with parser-aware scalar/range/in resolvers for matching fields.\n     */\n    withFieldParsers(parsers: Partial<Record<string, FilterValueParser>>): FilterSet<T> {\n        if (Object.keys(parsers).length === 0) {\n            return this;\n        }\n\n        let changed = false;\n        const nextSpec = Object.fromEntries(\n            Object.entries(this.spec).map(([param, resolver]) => {\n                const nextResolver = this.applyFieldParserOverride(resolver, parsers);\n                if (nextResolver !== resolver) {\n                    changed = true;\n                }\n                return [param, nextResolver];\n            })\n        ) as Record<string, FilterResolver<T>>;\n\n        return changed ? new FilterSet(nextSpec, this.allowAllParams) : this;\n    }\n\n    /**\n     * Apply all configured resolvers against query params.\n     */\n    apply(params: TangoQueryParams): FilterInput<T>[] {\n        const filters: FilterInput<T>[] = [];\n        const keys = new Set<string>();\n\n        for (const [key] of params.entries()) {\n            keys.add(key);\n        }\n\n        for (const key of keys) {\n            const resolver = this.spec[key] ?? (this.allowAllParams ? this.buildAllResolver(key) : undefined);\n            if (!resolver) continue;\n\n            const rawValue = params.getAll(key);\n            const value = rawValue.length > 1 ? rawValue : rawValue[0];\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 buildAllResolver(param: string): FilterResolver<T> | undefined {\n        const segments = param.split('__').filter(Boolean);\n        if (segments.length === 0) {\n            return undefined;\n        }\n\n        const lastSegment = segments.at(-1)!;\n        const lookup = isFilterLookup(lastSegment) ? lastSegment : 'exact';\n        const field = (lookup === 'exact' ? segments : segments.slice(0, -1)).join('__') as FilterFieldRef<T>;\n\n        if (!field) {\n            return undefined;\n        }\n\n        if (lookup === 'exact') {\n            return { type: InternalFilterType.SCALAR, column: field };\n        }\n\n        return FilterSet.createLookupResolver(field, lookup);\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 = FilterSet.toScalarString(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    private applyFieldParserOverride(\n        resolver: FilterResolver<T>,\n        parsers: Partial<Record<string, FilterValueParser>>\n    ): FilterResolver<T> {\n        switch (resolver.type) {\n            case InternalFilterType.SCALAR: {\n                const parser = parsers[resolver.column];\n                return parser ? FilterSet.createLookupResolver(resolver.column, 'exact', parser) : resolver;\n            }\n\n            case InternalFilterType.RANGE: {\n                const parser = parsers[resolver.column];\n                return parser ? FilterSet.createLookupResolver(resolver.column, resolver.op, parser) : resolver;\n            }\n\n            case InternalFilterType.IN: {\n                const parser = parsers[resolver.column];\n                return parser ? FilterSet.createLookupResolver(resolver.column, 'in', parser) : resolver;\n            }\n\n            default:\n                return resolver;\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 {\n    AliasFilterDeclaration,\n    FieldFilterDeclaration,\n    FilterLookup,\n    FilterResolver,\n    FilterSetDefineConfig,\n    FilterValueParser,\n} from './FilterSet';\nexport { FilterSet } from './FilterSet';\n"],"mappings":";;;AAAA,MAAa,qBAAqB;CAC9B,QAAQ;CACR,OAAO;CACP,OAAO;CACP,IAAI;CACJ,QAAQ;AACZ;;;ACNA,MAAa,uBAAuB;CAChC,OAAO;CACP,IAAI;CACJ,KAAK;CACL,IAAI;CACJ,KAAK;CACL,IAAI;CACJ,QAAQ;CACR,UAAU;CACV,WAAW;CACX,YAAY;CACZ,aAAa;CACb,UAAU;CACV,WAAW;AACf;;;ACRA,MAAM,iBAAiB,OAAO,OAAO,oBAAoB;AAIzD,SAAS,eAAe,OAAoC;CACxD,OAAQ,eAAqC,SAAS,KAAK;AAC/D;;;;;;;AAyDA,IAAa,YAAb,MAAa,UAA6C;CAQjC;CACA;CARrB,OAAgB,QAAQ;CACxB,eAAgD,UAAU;;;;CAK1D,YACI,MACA,iBAA2C,OAC7C;EAFmB,KAAA,OAAA;EACA,KAAA,iBAAA;CAClB;;;;CAKH,OAAO,OAA0C,QAAgD;EAE7F,OAAO,IAAI,UADE,UAAU,sBAAsB,MACrB,GAAG,OAAO,QAAQ,SAAS;CACvD;;;;CAKA,OAAO,YAA+C,OAAuC;EACzF,OACI,OAAO,UAAU,YACjB,UAAU,QACT,MAAqC,iBAAiB,UAAU;CAEzE;CAEA,OAAe,sBACX,QACiC;EACjC,MAAM,OAA0C,CAAC;EACjD,MAAM,oBAAqE,OAAO,UAAU,CAAC;EAC7F,MAAM,eAA2D,OAAO,WAAW,CAAC;EAEpF,KAAK,MAAM,YAAY,OAAO,KAAK,iBAAiB,GAA+B;GAC/E,MAAM,cAAc,kBAAkB;GACtC,IAAI,gBAAgB,KAAA,GAAW;GAC/B,MAAM,SAAS,aAAa;GAC5B,UAAU,oBAAoB,MAAM,UAAU,aAAa,MAAM;EACrE;EAEA,MAAM,UAAU,OAAO,WAAW,CAAC;EACnC,KAAK,MAAM,CAAC,OAAO,gBAAgB,OAAO,QAAQ,OAAO,GACrD,KAAK,SAAS,UAAU,0BAA0B,WAAW;EAGjE,OAAO;CACX;CAEA,OAAe,oBACX,MACA,OACA,aACA,QACI;EACJ,IAAI,gBAAgB,MAAM;GACtB,KAAK,OAAO,KAAK,KAAK,UAAU,qBAAqB,OAAO,qBAAqB,OAAO,MAAM;GAC9F;EACJ;EAEA,IAAI,UAAU,cAAc,WAAW,GAAG;GACtC,KAAK,MAAM,UAAU,aAAa;IAC9B,MAAM,QAAQ,UAAU,mBAAmB,OAAO,KAAK,GAAG,MAAM;IAChE,KAAK,SAAS,UAAU,qBAAqB,OAAO,QAAQ,MAAM;GACtE;GACA;EACJ;EAEA,MAAM,UAAU,YAAY,WAAW,CAAC,qBAAqB,KAAK;EAClE,MAAM,YAAY,YAAY,SAAS,OAAO,KAAK;EACnD,MAAM,kBAAkB,YAAY,SAAS;EAE7C,KAAK,MAAM,UAAU,SAAS;GAC1B,MAAM,QAAQ,UAAU,mBAAmB,WAAW,MAAM;GAC5D,KAAK,SAAS,UAAU,qBAAqB,OAAO,QAAQ,eAAe;EAC/E;CACJ;CAEA,OAAe,cAAc,OAAiE;EAC1F,OAAO,MAAM,QAAQ,KAAK;CAC9B;CAEA,OAAe,0BACX,aACiB;EACjB,IAAI,UAAU,4BAA4B,WAAW,GACjD,OAAO;EAGX,IAAI,YAAY,aAAa;GACzB,MAAM,SAAS,YAAY,UAAU,qBAAqB;GAC1D,OAAO,UAAU,yBAAyB,YAAY,QAAQ,QAAQ,YAAY,KAAK;EAC3F;EAEA,OAAO,UAAU,qBACb,YAAY,OACZ,YAAY,UAAU,qBAAqB,OAC3C,YAAY,KAChB;CACJ;CAEA,OAAe,4BACX,OAC0B;EAC1B,IAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,EAAE,UAAU,QAC3D,OAAO;EAGX,OAAO;GACH,mBAAmB;GACnB,mBAAmB;GACnB,mBAAmB;GACnB,mBAAmB;GACnB,mBAAmB;EACvB,EAAE,SAAS,MAAM,IAAI;CACzB;CAEA,OAAe,yBACX,QACA,QACA,QACiB;EACjB,IAAI,WAAW,qBAAqB,aAAa,WAAW,KAAA,GACxD,OAAO;GAAE,MAAM,mBAAmB;GAAO,SAAS,CAAC,GAAG,MAAM;EAAE;EAGlE,OAAO;GACH,MAAM,mBAAmB;GACzB,QAAQ,QAAQ;IACZ,MAAM,SAAS,UAAU,mBAAmB,KAAK,MAAM;IACvD,IAAI,WAAW,KAAA,GAAW,OAAO,KAAA;IAEjC,MAAM,WAAuD,CAAC;IAC9D,KAAK,MAAM,SAAS,QAAQ;KACxB,MAAM,UAAU,UAAU,oBAAoB,OAAO,QAAQ,MAAM;KACnE,IAAI,CAAC,SAAS;KACd,OAAO,OAAO,UAAU,OAAO;IACnC;IAEA,OAAO,OAAO,KAAK,QAAQ,EAAE,SAAS,IAAK,WAA8B,KAAA;GAC7E;EACJ;CACJ;CAEA,OAAe,qBACX,OACA,QACA,QACiB;EACjB,IAAI,WAAW,KAAA,GACX,OAAO;GACH,MAAM,mBAAmB;GACzB,QAAQ,QAAQ;IACZ,MAAM,SAAS,UAAU,mBAAmB,KAAK,MAAM;IACvD,IAAI,WAAW,KAAA,GAAW,OAAO,KAAA;IACjC,OAAO,UAAU,oBAAoB,OAAO,QAAQ,MAAM;GAC9D;EACJ;EAGJ,QAAQ,QAAR;GACI,KAAK,SACD,OAAO;IAAE,MAAM,mBAAmB;IAAQ,QAAQ;GAAM;GAC5D,KAAK,MACD,OAAO;IAAE,MAAM,mBAAmB;IAAI,QAAQ;GAAM;GACxD,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK,OACD,OAAO;IAAE,MAAM,mBAAmB;IAAO,QAAQ;IAAO,IAAI;GAAO;GACvE,KAAK,aACD,OAAO;IAAE,MAAM,mBAAmB;IAAO,SAAS,CAAC,KAAK;GAAE;GAC9D,SACI,OAAO;IACH,MAAM,mBAAmB;IACzB,QAAQ,QAAQ,UAAU,oBAAoB,OAAO,QAAQ,GAAG;GACpE;EACR;CACJ;CAEA,OAAe,oBACX,OACA,QACA,OAC0B;EAC1B,IAAI,UAAU,KAAA,GAAW,OAAO,KAAA;EAEhC,IAAI,WAAW,SACX,OAAO,GAAG,QAAQ,MAAM;EAG5B,IAAI,WAAW,MAAM;GACjB,MAAM,MAAM,MAAM,QAAQ,KAAK,IAAI,QAAQ,OAAO,KAAK,EAAE,MAAM,GAAG;GAElE,OAAO,GAAG,GADW,OAAO,KAAK,EAAE,QACb,IAAI;EAC9B;EAEA,IAAI,WAAW,aAEX,OAAO,GAAG,GADW,OAAO,KAAK,EAAE,eACb,UAAU,eAAe,KAAK,EAAE;EAI1D,OAAO,GAAG,GADW,OAAO,KAAK,EAAE,IAAI,WACjB,MAAqB;CAC/C;CAEA,OAAe,mBAAmB,WAAmB,QAA8B;EAC/E,IAAI,WAAW,SACX,OAAO;EAEX,OAAO,GAAG,UAAU,IAAI;CAC5B;CAEA,OAAe,mBACX,OACA,QAC+B;EAC/B,IAAI,UAAU,KAAA,GACV;EAGJ,IAAI,WAAW,KAAA,GACX,OAAO;EAGX,OAAO,OAAO,KAAK;CACvB;CAEA,OAAe,eAAe,OAAoC;EAC9D,IAAI,MAAM,QAAQ,KAAK,GACnB,OAAO,MAAM,KAAK,GAAG;EAEzB,OAAO,OAAO,KAAK;CACvB;;;;CAKA,iBAAiB,SAAmE;EAChF,IAAI,OAAO,KAAK,OAAO,EAAE,WAAW,GAChC,OAAO;EAGX,IAAI,UAAU;EACd,MAAM,WAAW,OAAO,YACpB,OAAO,QAAQ,KAAK,IAAI,EAAE,KAAK,CAAC,OAAO,cAAc;GACjD,MAAM,eAAe,KAAK,yBAAyB,UAAU,OAAO;GACpE,IAAI,iBAAiB,UACjB,UAAU;GAEd,OAAO,CAAC,OAAO,YAAY;EAC/B,CAAC,CACL;EAEA,OAAO,UAAU,IAAI,UAAU,UAAU,KAAK,cAAc,IAAI;CACpE;;;;CAKA,MAAM,QAA4C;EAC9C,MAAM,UAA4B,CAAC;EACnC,MAAM,uBAAO,IAAI,IAAY;EAE7B,KAAK,MAAM,CAAC,QAAQ,OAAO,QAAQ,GAC/B,KAAK,IAAI,GAAG;EAGhB,KAAK,MAAM,OAAO,MAAM;GACpB,MAAM,WAAW,KAAK,KAAK,SAAS,KAAK,iBAAiB,KAAK,iBAAiB,GAAG,IAAI,KAAA;GACvF,IAAI,CAAC,UAAU;GAEf,MAAM,WAAW,OAAO,OAAO,GAAG;GAClC,MAAM,QAAQ,SAAS,SAAS,IAAI,WAAW,SAAS;GAExD,IAAI,UAAU,KAAA,GAAW;GAEzB,MAAM,SAAS,KAAK,cAAc,UAAU,KAAK;GACjD,IAAI,QACA,QAAQ,KAAK,MAAM;EAE3B;EAEA,OAAO;CACX;CAEA,iBAAyB,OAA8C;EACnE,MAAM,WAAW,MAAM,MAAM,IAAI,EAAE,OAAO,OAAO;EACjD,IAAI,SAAS,WAAW,GACpB;EAGJ,MAAM,cAAc,SAAS,GAAG,EAAE;EAClC,MAAM,SAAS,eAAe,WAAW,IAAI,cAAc;EAC3D,MAAM,SAAS,WAAW,UAAU,WAAW,SAAS,MAAM,GAAG,EAAE,GAAG,KAAK,IAAI;EAE/E,IAAI,CAAC,OACD;EAGJ,IAAI,WAAW,SACX,OAAO;GAAE,MAAM,mBAAmB;GAAQ,QAAQ;EAAM;EAG5D,OAAO,UAAU,qBAAqB,OAAO,MAAM;CACvD;CAEA,cACI,UACA,OAC0B;EAC1B,IAAI,UAAU,KAAA,GAAW,OAAO,KAAA;EAEhC,QAAQ,SAAS,MAAjB;GACI,KAAK,mBAAmB,QACpB,OAAO,GAAG,SAAS,SAAS,MAAM;GAEtC,KAAK,mBAAmB,OAAO;IAC3B,MAAM,UAAU,UAAU,eAAe,KAAK;IAC9C,MAAM,SAAqD,CAAC;IAC5D,SAAS,QAAQ,SAAS,QAAQ;KAC9B,OAAO,GAAG,OAAO,GAAG,EAAE,gBAAgC;IAC1D,CAAC;IACD,OAAO;GACX;GAEA,KAAK,mBAAmB,OAEpB,OAAO,GAAG,GADW,OAAO,SAAS,MAAM,EAAE,IAAI,SAAS,OACpC,MAAM;GAGhC,KAAK,mBAAmB,IAAI;IACxB,MAAM,MAAM,MAAM,QAAQ,KAAK,IAAI,QAAQ,OAAO,KAAK,EAAE,MAAM,GAAG;IAElE,OAAO,GAAG,GADW,OAAO,SAAS,MAAM,EAAE,QACvB,IAAI;GAC9B;GAEA,KAAK,mBAAmB,QACpB,OAAO,SAAS,MAAM,KAAK;GAE/B,SACI;EACR;CACJ;CAEA,yBACI,UACA,SACiB;EACjB,QAAQ,SAAS,MAAjB;GACI,KAAK,mBAAmB,QAAQ;IAC5B,MAAM,SAAS,QAAQ,SAAS;IAChC,OAAO,SAAS,UAAU,qBAAqB,SAAS,QAAQ,SAAS,MAAM,IAAI;GACvF;GAEA,KAAK,mBAAmB,OAAO;IAC3B,MAAM,SAAS,QAAQ,SAAS;IAChC,OAAO,SAAS,UAAU,qBAAqB,SAAS,QAAQ,SAAS,IAAI,MAAM,IAAI;GAC3F;GAEA,KAAK,mBAAmB,IAAI;IACxB,MAAM,SAAS,QAAQ,SAAS;IAChC,OAAO,SAAS,UAAU,qBAAqB,SAAS,QAAQ,MAAM,MAAM,IAAI;GACpF;GAEA,SACI,OAAO;EACf;CACJ;AACJ"}

package/dist/index-Ac94YL5S.d.ts

@@ -0,0 +1,24 @@
+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 { z } from "zod";
+
+//#region src/pagination/OffsetPaginationInput.d.ts
+type OffsetPaginationInputValue = {
+  limit: number;
+  offset: number;
+  page?: number;
+};
+declare const OffsetPaginationInput: z.ZodType<OffsetPaginationInputValue>;
+//#endregion
+//#region src/pagination/CursorPaginationInput.d.ts
+type CursorPaginationInputValue = {
+  limit?: number;
+  cursor: string | null;
+  ordering?: string;
+};
+declare const CursorPaginationInput: z.ZodType<CursorPaginationInputValue>;
+declare namespace index_d_exports {
+  export { BasePaginatedResponse, BasePaginator, CursorPaginatedResponse, CursorPaginationInput, CursorPaginationInputValue, CursorPaginator, OffsetPaginatedResponse, OffsetPaginationInput, OffsetPaginationInputValue, OffsetPaginator, Page, PaginatedResponse, Paginator };
+}
+//#endregion
+export { OffsetPaginationInputValue as a, OffsetPaginationInput as i, CursorPaginationInput as n, CursorPaginationInputValue as r, index_d_exports as t };
+//# sourceMappingURL=index-Ac94YL5S.d.ts.map

package/dist/index-BJJalUDB.d.ts

@@ -0,0 +1,54 @@
+import { TangoRequest } from "@danceroutine/tango-core";
+
+//#region src/context/RequestContext.d.ts
+/**
+ * Default user shape for RequestContext.
+ * Consumers can provide their own user type via the TUser generic parameter.
+ */
+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.
+ */
+declare class RequestContext<TUser = BaseUser> {
+  readonly request: TangoRequest;
+  user: TUser | null;
+  params: Record<string, string>;
+  static readonly BRAND: "tango.resources.request_context";
+  readonly __tangoBrand: typeof RequestContext.BRAND;
+  private state;
+  constructor(request: TangoRequest, user?: TUser | null, params?: Record<string, string>);
+  /**
+   * Narrow an unknown value to `RequestContext`.
+   */
+  static isRequestContext<TUser = BaseUser>(value: unknown): value is RequestContext<TUser>;
+  /**
+   * Construct a context with optional user payload.
+   */
+  static create<TUser = BaseUser>(request: Request, user?: TUser | null): RequestContext<TUser>;
+  /**
+   * Store arbitrary per-request state for downstream middleware/handlers.
+   */
+  setState<T>(key: string | symbol, value: T): void;
+  /**
+   * Retrieve previously stored request state.
+   */
+  getState<T>(key: string | symbol): T | undefined;
+  /**
+   * Check whether a state key has been set.
+   */
+  hasState(key: string | symbol): boolean;
+  /**
+   * Clone the context, including route params and request-local state.
+   */
+  clone(): RequestContext<TUser>;
+}
+declare namespace index_d_exports {
+  export { BaseUser, RequestContext };
+}
+//#endregion
+export { BaseUser as n, RequestContext as r, index_d_exports as t };
+//# sourceMappingURL=index-BJJalUDB.d.ts.map