@danceroutine/tango-resources 1.11.2 → 1.11.4

package/dist/index-D6sfTSEj.d.ts

@@ -1,902 +0,0 @@
-import { TangoQueryParams, TangoRequest, TangoResponse } from "@danceroutine/tango-core";
-import { FilterInput, FilterValue, LookupType, ManagerLike, ManyToManyRelatedManager, QueryResult, QuerySet } from "@danceroutine/tango-orm";
-import { z } from "zod";
-
-//#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$5 {
-  export { BaseUser, RequestContext };
-}
-//#endregion
-//#region src/filters/internal/InternalFilterType.d.ts
-declare const InternalFilterType: {
-  readonly SCALAR: "scalar";
-  readonly ILIKE: "ilike";
-  readonly RANGE: "range";
-  readonly IN: "in";
-  readonly CUSTOM: "custom";
-};
-//#endregion
-//#region src/filters/FilterType.d.ts
-type FilterType = (typeof InternalFilterType)[keyof typeof InternalFilterType];
-//#endregion
-//#region src/filters/internal/InternalRangeOperator.d.ts
-declare const InternalRangeOperator: {
-  readonly GTE: "gte";
-  readonly LTE: "lte";
-  readonly GT: "gt";
-  readonly LT: "lt";
-};
-//#endregion
-//#region src/filters/RangeOperator.d.ts
-type RangeOperator = (typeof InternalRangeOperator)[keyof typeof InternalRangeOperator];
-//#endregion
-//#region src/filters/FilterSet.d.ts
-type FilterFieldRef<T extends Record<string, unknown>> = Extract<keyof T, string> | string;
-/**
- * Configuration for how a query parameter should be resolved into a filter.
- * Supports scalar equality, case-insensitive search, range comparisons, IN queries, and custom logic.
- */
-type FilterResolver<T extends Record<string, unknown>> = {
-  type: typeof InternalFilterType.SCALAR;
-  column: FilterFieldRef<T>;
-} | {
-  type: typeof InternalFilterType.ILIKE;
-  columns: FilterFieldRef<T>[];
-} | {
-  type: typeof InternalFilterType.RANGE;
-  column: FilterFieldRef<T>;
-  op: RangeOperator;
-} | {
-  type: typeof InternalFilterType.IN;
-  column: FilterFieldRef<T>;
-} | {
-  type: typeof InternalFilterType.CUSTOM;
-  apply: (value: string | string[] | undefined) => FilterInput<T> | undefined;
-};
-type FilterLookup = LookupType;
-type FilterValueParser = (raw: string | string[]) => FilterValue | FilterValue[] | undefined;
-type FieldFilterDeclaration = true | readonly FilterLookup[] | {
-  lookups?: readonly FilterLookup[];
-  param?: string;
-  parse?: FilterValueParser;
-};
-type AliasFilterDeclaration<T extends Record<string, unknown>> = FilterResolver<T> | {
-  field: FilterFieldRef<T>;
-  lookup?: FilterLookup;
-  parse?: FilterValueParser;
-} | {
-  fields: readonly FilterFieldRef<T>[];
-  lookup?: FilterLookup;
-  parse?: FilterValueParser;
-};
-interface FilterSetDefineConfig<T extends Record<string, unknown>> {
-  fields?: Partial<Record<string, FieldFilterDeclaration>>;
-  aliases?: Record<string, AliasFilterDeclaration<T>>;
-  parsers?: Partial<Record<string, FilterValueParser>>;
-  all?: '__all__';
-}
-/**
- * Declarative query-param to filter translation.
- *
- * A `FilterSet` lets viewsets expose safe, explicit filtering behavior
- * without leaking raw ORM filter syntax to request handlers.
- */
-declare class FilterSet<T extends Record<string, unknown>> {
-  private readonly spec;
-  private readonly allowAllParams;
-  static readonly BRAND: "tango.resources.filter_set";
-  readonly __tangoBrand: typeof FilterSet.BRAND;
-  /**
-   * Resolve matching query parameters into ORM filter inputs.
-   */
-  constructor(spec: Record<string, FilterResolver<T>>, allowAllParams?: boolean);
-  /**
-   * Build a filter set from Django-style field declarations.
-   */
-  static define<T extends Record<string, unknown>>(config: FilterSetDefineConfig<T>): FilterSet<T>;
-  /**
-   * Narrow an unknown value to `FilterSet`.
-   */
-  static isFilterSet<T extends Record<string, unknown>>(value: unknown): value is FilterSet<T>;
-  private static normalizeDefineConfig;
-  private static addFieldDeclaration;
-  private static isLookupArray;
-  private static normalizeAliasDeclaration;
-  private static isFilterResolverDeclaration;
-  private static createMultiFieldResolver;
-  private static createLookupResolver;
-  private static resolveLookupFilter;
-  private static resolveLookupParam;
-  private static resolveParserValue;
-  private static toScalarString;
-  /**
-   * Return a new filter set with parser-aware scalar/range/in resolvers for matching fields.
-   */
-  withFieldParsers(parsers: Partial<Record<string, FilterValueParser>>): FilterSet<T>;
-  /**
-   * Apply all configured resolvers against query params.
-   */
-  apply(params: TangoQueryParams): FilterInput<T>[];
-  private buildAllResolver;
-  private resolveFilter;
-  private applyFieldParserOverride;
-}
-declare namespace index_d_exports$4 {
-  export { AliasFilterDeclaration, FieldFilterDeclaration, FilterLookup, FilterResolver, FilterSet, FilterSetDefineConfig, FilterType, FilterValueParser, RangeOperator };
-}
-//#endregion
-//#region src/pagination/BasePaginator.d.ts
-declare abstract class BasePaginator {
-  protected resolveQueryResultRows<T>(rows: readonly T[] | QueryResult<T>): T[];
-}
-//#endregion
-//#region src/pagination/PaginatedResponse.d.ts
-interface BasePaginatedResponse<T> {
-  results: T[];
-  next?: string | null;
-  previous?: string | null;
-}
-interface OffsetPaginatedResponse<T> extends BasePaginatedResponse<T> {
-  count?: number;
-}
-interface CursorPaginatedResponse<T> extends BasePaginatedResponse<T> {
-  count?: never;
-}
-type PaginatedResponse<T> = OffsetPaginatedResponse<T> | CursorPaginatedResponse<T>;
-//#endregion
-//#region src/pagination/Paginator.d.ts
-interface Page<T> {
-  results: T[];
-  hasNext(): boolean;
-  hasPrevious(): boolean;
-  nextPageNumber(): number | null;
-  previousPageNumber(): number | null;
-  startIndex(): number;
-  endIndex(): number;
-}
-interface Paginator<TModel extends Record<string, unknown>, TResult = TModel, TResponse extends PaginatedResponse<TResult> = PaginatedResponse<TResult>> {
-  parse(params: TangoQueryParams): void;
-  apply<TBaseResult extends Record<string, unknown>, TSourceModel, THydrated extends Record<string, unknown>>(queryset: QuerySet<TModel, TBaseResult, TSourceModel, THydrated>): QuerySet<TModel, TBaseResult, TSourceModel, THydrated>;
-  needsTotalCount(): boolean;
-  toResponse(results: readonly TResult[] | QueryResult<TResult>, context?: {
-    totalCount?: number;
-    params?: TangoQueryParams;
-  }): TResponse;
-}
-//#endregion
-//#region src/paginators/OffsetPaginator.d.ts
-/**
- * Offset/limit paginator modelled after DRF's LimitOffsetPagination.
- * Handles parsing limit/offset/page from URL query params and building
- * the paginated response envelope with next/previous links.
- *
- * @example
- * ```typescript
- * const paginator = new OffsetPaginator(queryset);
- * const { limit, offset } = paginator.parseParams(searchParams);
- * const results = await queryset.limit(limit).offset(offset).fetchAll();
- * const response = paginator.getPaginatedResponse(results, totalCount);
- * ```
- */
-declare class OffsetPaginator<T extends Record<string, unknown>> extends BasePaginator implements Paginator<T, T, OffsetPaginatedResponse<T>> {
-  private queryset;
-  private perPage;
-  static readonly BRAND: "tango.resources.offset_paginator";
-  readonly __tangoBrand: typeof OffsetPaginator.BRAND;
-  private limit;
-  private offset;
-  constructor(queryset: QuerySet<T>, perPage?: number);
-  /**
-   * Narrow an unknown value to `OffsetPaginator`.
-   */
-  static isOffsetPaginator<T extends Record<string, unknown>>(value: unknown): value is OffsetPaginator<T>;
-  /**
-   * Parse limit, offset, and page from Tango query params.
-   * If `page` is provided, it's converted to an offset.
-   * Stores parsed values for use by getPaginatedResponse.
-   */
-  parse(params: TangoQueryParams): void;
-  /**
-   * Parse params and return `{ limit, offset }` for compatibility callers.
-   */
-  parseParams(params: TangoQueryParams): {
-    limit: number;
-    offset: number;
-  };
-  /**
-   * Build a DRF-style paginated response with count, next, and previous links.
-   * Uses the limit/offset stored from the most recent parseParams call.
-   */
-  needsTotalCount(): boolean;
-  toResponse<TResult>(results: readonly TResult[] | QueryResult<TResult>, context?: {
-    totalCount?: number;
-    params?: TangoQueryParams;
-  }): OffsetPaginatedResponse<TResult>;
-  /**
-   * Backward-compatible alias for `toResponse`.
-   */
-  getPaginatedResponse<TResult>(results: readonly TResult[] | QueryResult<TResult>, totalCount?: number, params?: TangoQueryParams): OffsetPaginatedResponse<TResult>;
-  /**
-   * Apply current limit/offset to a queryset.
-   */
-  apply<TBaseResult extends Record<string, unknown>, TSourceModel, THydrated extends Record<string, unknown>>(queryset: QuerySet<T, TBaseResult, TSourceModel, THydrated>): QuerySet<T, TBaseResult, TSourceModel, THydrated>;
-  /**
-   * Fetch a 1-based page number from the bound queryset.
-   */
-  paginate(page: number): Promise<Page<T>>;
-  /**
-   * Fetch a 1-based page and return page metadata.
-   */
-  getPage(page: number): Promise<Page<T>>;
-  /**
-   * Count total rows for the current queryset state.
-   */
-  count(): Promise<number>;
-  private buildPageLink;
-}
-//#endregion
-//#region src/paginators/CursorPaginator.d.ts
-/**
- * Cursor-based paginator for stable forward navigation with opaque cursor tokens.
- * It supports `limit`, `cursor`, and `ordering` query params and returns DRF-style
- * paginated envelopes with cursor links.
- */
-declare class CursorPaginator<T extends Record<string, unknown>> extends BasePaginator implements Paginator<T, T, CursorPaginatedResponse<T>> {
-  private queryset;
-  private perPage;
-  private cursorField;
-  static readonly BRAND: "tango.resources.cursor_paginator";
-  readonly __tangoBrand: typeof CursorPaginator.BRAND;
-  private limit;
-  private cursor;
-  private direction;
-  private nextCursor;
-  private previousCursor;
-  constructor(queryset: QuerySet<T>, perPage?: number, cursorField?: keyof T);
-  /**
-   * Narrow an unknown value to `CursorPaginator`.
-   */
-  static isCursorPaginator<T extends Record<string, unknown>>(value: unknown): value is CursorPaginator<T>;
-  /**
-   * Parse cursor pagination parameters from Tango query params.
-   */
-  parse(params: TangoQueryParams): void;
-  /**
-   * Parse params and return compatibility `{ limit, offset }` shape.
-   */
-  parseParams(params: TangoQueryParams): {
-    limit: number;
-    offset: number;
-  };
-  /**
-   * Build a paginated response payload with cursor links.
-   */
-  needsTotalCount(): boolean;
-  toResponse<TResult>(results: readonly TResult[] | QueryResult<TResult>, _context?: {
-    totalCount?: number;
-    params?: TangoQueryParams;
-  }): CursorPaginatedResponse<TResult>;
-  /**
-   * Backward-compatible alias for `toResponse`.
-   */
-  getPaginatedResponse<TResult>(results: readonly TResult[] | QueryResult<TResult>, _totalCount?: number): CursorPaginatedResponse<TResult>;
-  /**
-   * Apply cursor constraints and ordering to a queryset.
-   */
-  apply<TBaseResult extends Record<string, unknown>, TSourceModel, THydrated extends Record<string, unknown>>(queryset: QuerySet<T, TBaseResult, TSourceModel, THydrated>): QuerySet<T, TBaseResult, TSourceModel, THydrated>;
-  /**
-   * Fetch the next cursor page.
-   */
-  paginate(cursor?: string): Promise<Page<T>>;
-  /**
-   * Cursor paginators only support page `1` as an entry point.
-   */
-  getPage(page: number): Promise<Page<T>>;
-  private buildPageLink;
-  private encodeCursor;
-  private decodeCursor;
-}
-//#endregion
-//#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$3 {
-  export { BasePaginatedResponse, BasePaginator, CursorPaginatedResponse, CursorPaginationInput, CursorPaginationInputValue, CursorPaginator, OffsetPaginatedResponse, OffsetPaginationInput, OffsetPaginationInputValue, OffsetPaginator, Page, PaginatedResponse, Paginator };
-}
-//#endregion
-//#region src/resource/ResourceModelLike.d.ts
-type ResourceModelFieldMetadata = {
-  name: string;
-  type: string;
-  notNull?: boolean;
-  default?: unknown;
-  primaryKey?: boolean;
-};
-type ResourceModelMetadata = {
-  name: string;
-  fields: ResourceModelFieldMetadata[];
-};
-type ResourceModelLike<TModel extends Record<string, unknown>, TModelRecord extends Record<string, unknown> = TModel> = {
-  /**
-   * Resource-layer contracts own the outward representation. The underlying
-   * model may materialize a richer ORM record, so the manager record type is kept
-   * separate from the serializer-facing model shape.
-   */
-  readonly objects: ManagerLike<TModelRecord>;
-  readonly metadata?: ResourceModelMetadata;
-  readonly __tangoModelShape?: TModel;
-};
-//#endregion
-//#region src/view/APIView.d.ts
-type APIViewMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
-/**
- * Lightweight class-based request dispatcher for non-model API endpoints.
- */
-declare abstract class APIView {
-  static readonly BRAND: "tango.resources.api_view";
-  readonly __tangoBrand: typeof APIView.BRAND;
-  /**
-   * Narrow an unknown value to `APIView`.
-   */
-  static isAPIView(value: unknown): value is APIView;
-  /**
-   * Dispatch the request to the handler for the current HTTP method.
-   */
-  dispatch(ctx: RequestContext): Promise<TangoResponse>;
-  getAllowedMethods(): readonly APIViewMethod[];
-  protected get(_ctx: RequestContext): Promise<TangoResponse>;
-  protected post(_ctx: RequestContext): Promise<TangoResponse>;
-  protected put(_ctx: RequestContext): Promise<TangoResponse>;
-  protected patch(_ctx: RequestContext): Promise<TangoResponse>;
-  protected delete(_ctx: RequestContext): Promise<TangoResponse>;
-  protected httpMethodNotAllowed(): TangoResponse;
-  private getMethodHandler;
-}
-//#endregion
-//#region src/serializer/Serializer.d.ts
-type SerializerSchema = z.ZodTypeAny;
-type SerializerClass<TCreateSchema extends SerializerSchema = SerializerSchema, TUpdateSchema extends SerializerSchema = SerializerSchema, TOutputSchema extends SerializerSchema = SerializerSchema, TRecord = unknown> = {
-  new (): Serializer<TCreateSchema, TUpdateSchema, TOutputSchema, TRecord>;
-  readonly createSchema: TCreateSchema;
-  readonly updateSchema: TUpdateSchema;
-  readonly outputSchema: TOutputSchema;
-  readonly outputResolvers?: SerializerOutputResolvers<TRecord>;
-};
-type AnySerializerClass = SerializerClass<SerializerSchema, SerializerSchema, SerializerSchema, any>;
-type SerializerCreateInput<TSerializer extends AnySerializerClass> = z.output<TSerializer['createSchema']>;
-type SerializerUpdateInput<TSerializer extends AnySerializerClass> = z.output<TSerializer['updateSchema']>;
-type SerializerOutput<TSerializer extends AnySerializerClass> = z.output<TSerializer['outputSchema']>;
-type SerializerOutputResolver<TRecord = unknown> = (record: TRecord) => unknown | Promise<unknown>;
-type SerializerOutputResolvers<TRecord = unknown> = Record<string, SerializerOutputResolver<TRecord>>;
-/**
- * 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.
- */
-declare abstract class Serializer<TCreateSchema extends SerializerSchema, TUpdateSchema extends SerializerSchema, TOutputSchema extends SerializerSchema, TRecord = unknown> {
-  static readonly createSchema: SerializerSchema;
-  static readonly updateSchema: SerializerSchema;
-  static readonly outputSchema: SerializerSchema;
-  static readonly outputResolvers: SerializerOutputResolvers< // oxlint-disable-next-line typescript/no-explicit-any
-  any> | undefined;
-  /**
-   * Return the serializer class for the current instance.
-   */
-  getSerializerClass(): SerializerClass<TCreateSchema, TUpdateSchema, TOutputSchema, TRecord>;
-  /**
-   * Return the Zod schema used for create payloads.
-   */
-  getCreateSchema(): TCreateSchema;
-  /**
-   * Return the Zod schema used for update payloads.
-   */
-  getUpdateSchema(): TUpdateSchema;
-  /**
-   * Return the Zod schema used for serialized output.
-   */
-  getOutputSchema(): TOutputSchema;
-  /**
-   * Return the resolver map used to enrich serializer output fields before
-   * the outward Zod schema parses the final response shape.
-   */
-  getOutputResolvers(): SerializerOutputResolvers<TRecord>;
-  /**
-   * Validate unknown input for create workflows.
-   */
-  deserializeCreate(input: unknown): z.output<TCreateSchema>;
-  /**
-   * Validate unknown input for update workflows.
-   */
-  deserializeUpdate(input: unknown): z.output<TUpdateSchema>;
-  /**
-   * 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: TRecord): z.output<TOutputSchema>;
-  /**
-   * Resolve serializer-owned output fields and parse the outward response
-   * contract.
-   */
-  serialize(record: TRecord): Promise<z.output<TOutputSchema>>;
-  /**
-   * Serialize many records through the same outward response contract.
-   */
-  serializeMany(records: readonly TRecord[]): Promise<z.output<TOutputSchema>[]>;
-  private applyOutputResolvers;
-}
-//#endregion
-//#region src/serializer/internal/InternalSerializerRelationKind.d.ts
-declare const InternalSerializerRelationKind: {
-  readonly MANY_TO_MANY: "manyToMany";
-};
-declare const InternalManyToManyReadStrategyKind: {
-  readonly PK_LIST: "pkList";
-  readonly NESTED: "nested";
-};
-declare const InternalManyToManyWriteStrategyKind: {
-  readonly PK_LIST: "pkList";
-  readonly SLUG_LIST: "slugList";
-};
-//#endregion
-//#region src/serializer/relation.d.ts
-type AnyRecord = Record<string, unknown>;
-type ManyToManyManagerKeys<TRecord extends AnyRecord> = Extract<{ [K in keyof TRecord]: TRecord[K] extends ManyToManyRelatedManager<AnyRecord> ? K : never }[keyof TRecord], string>;
-type ManyToManyTargetRow<TRecord extends AnyRecord, TFieldName extends ManyToManyManagerKeys<TRecord>> = TRecord[TFieldName] extends ManyToManyRelatedManager<infer TTarget extends AnyRecord> ? TTarget : never;
-type ManyToManyPkListStrategy = {
-  kind: typeof InternalManyToManyReadStrategyKind.PK_LIST | typeof InternalManyToManyWriteStrategyKind.PK_LIST;
-};
-type ManyToManyNestedStrategy = {
-  kind: typeof InternalManyToManyReadStrategyKind.NESTED;
-  schema: z.ZodTypeAny;
-};
-type ManyToManySlugListStrategy<TTarget extends AnyRecord> = {
-  kind: typeof InternalManyToManyWriteStrategyKind.SLUG_LIST;
-  model: ResourceModelLike<any, any>;
-  lookupField: Extract<keyof TTarget, string>;
-  createIfMissing?: boolean;
-  buildCreateInput?: (value: string) => Partial<TTarget>;
-};
-type ManyToManyReadStrategy = ManyToManyPkListStrategy | ManyToManyNestedStrategy;
-type ManyToManyWriteStrategy<TTarget extends AnyRecord> = ManyToManyPkListStrategy | ManyToManySlugListStrategy<TTarget>;
-type ManyToManyRelationField<TRecord extends AnyRecord, TFieldName extends ManyToManyManagerKeys<TRecord>> = {
-  kind: typeof InternalSerializerRelationKind.MANY_TO_MANY;
-  read: ManyToManyReadStrategy;
-  write: ManyToManyWriteStrategy<ManyToManyTargetRow<TRecord, TFieldName>>;
-};
-type ModelSerializerRelationFields<TRecord extends AnyRecord> = Partial<{ [K in ManyToManyManagerKeys<TRecord>]: ManyToManyRelationField<TRecord, K> }>;
-declare function pkList(): ManyToManyPkListStrategy;
-declare function nested(schema: z.ZodTypeAny): ManyToManyNestedStrategy;
-declare function slugList<TTarget extends AnyRecord>(options: Omit<ManyToManySlugListStrategy<TTarget>, 'kind'>): ManyToManySlugListStrategy<TTarget>;
-declare function manyToMany(config?: Partial<Pick<ManyToManyRelationField<any, any>, 'read' | 'write'>>): ManyToManyRelationField<any, any>;
-type RelationHelpers = {
-  manyToMany: typeof manyToMany;
-  pkList: typeof pkList;
-  nested: typeof nested;
-  slugList: typeof slugList;
-};
-declare const relation: RelationHelpers;
-//#endregion
-//#region src/serializer/ModelSerializer.d.ts
-type ModelSerializerClass<TModel extends Record<string, unknown> = Record<string, unknown>, TCreateSchema extends SerializerSchema = SerializerSchema, TUpdateSchema extends SerializerSchema = SerializerSchema, TOutputSchema extends SerializerSchema = SerializerSchema, TModelRecord extends Record<string, unknown> = TModel> = SerializerClass<TCreateSchema, TUpdateSchema, TOutputSchema, TModelRecord> & {
-  new (): ModelSerializer<TModel, TCreateSchema, TUpdateSchema, TOutputSchema, TModelRecord>;
-  readonly model?: ResourceModelLike<TModel, TModelRecord>;
-  readonly relationFields?: ModelSerializerRelationFields<TModelRecord>;
-};
-type AnyModelSerializer<TModel extends Record<string, unknown> = Record<string, unknown>> = ModelSerializerClass<TModel, SerializerSchema, SerializerSchema, SerializerSchema, any>;
-type AnyModelSerializerClass = AnyModelSerializer;
-/**
- * Zod-backed serializer with default model-manager persistence behavior.
- */
-declare abstract class ModelSerializer<TModel extends Record<string, unknown>, TCreateSchema extends SerializerSchema, TUpdateSchema extends SerializerSchema, TOutputSchema extends SerializerSchema, TModelRecord extends Record<string, unknown> = TModel> extends Serializer<TCreateSchema, TUpdateSchema, TOutputSchema, TModelRecord> {
-  static readonly model?: unknown;
-  static readonly relationFields: ModelSerializerRelationFields<Record<string, unknown>> | undefined;
-  /**
-   * Return the Tango model backing this serializer.
-   */
-  getModel(): ResourceModelLike<TModel, TModelRecord>;
-  /**
-   * Return the manager used for create and update workflows.
-   */
-  getManager(): ManagerLike<TModelRecord>;
-  /**
-   * Return the declarative relation-field map for this serializer.
-   */
-  getRelationFields(): ModelSerializerRelationFields<TModelRecord>;
-  /**
-   * Merge relation-field read resolvers into the serializer output path.
-   */
-  getOutputResolvers(): SerializerOutputResolvers<TModelRecord>;
-  /**
-   * Validate, enrich, persist, and serialize a create workflow.
-   */
-  create(input: unknown): Promise<SerializerOutput<ModelSerializerClass<TModel, TCreateSchema, TUpdateSchema, TOutputSchema, TModelRecord>>>;
-  /**
-   * Validate, enrich, persist, and serialize an update workflow.
-   */
-  update(id: TModelRecord[keyof TModelRecord], input: unknown): Promise<SerializerOutput<ModelSerializerClass<TModel, TCreateSchema, TUpdateSchema, TOutputSchema, TModelRecord>>>;
-  /**
-   * 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.
-   */
-  protected beforeCreate(data: SerializerCreateInput<ModelSerializerClass<TModel, TCreateSchema, TUpdateSchema, TOutputSchema, TModelRecord>>): Promise<Partial<TModelRecord>>;
-  /**
-   * 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.
-   */
-  protected beforeUpdate(_id: TModelRecord[keyof TModelRecord], data: SerializerUpdateInput<ModelSerializerClass<TModel, TCreateSchema, TUpdateSchema, TOutputSchema, TModelRecord>>): Promise<Partial<TModelRecord>>;
-  private extractRelationWrites;
-  private stripRelationFields;
-  private applyRelationWrites;
-  private serializeRelationField;
-  private syncManyToManyRelation;
-  private resolveWriteTargets;
-  private getManyToManyManager;
-  private getManyToManyRelationMeta;
-}
-declare namespace index_d_exports$2 {
-  export { AnyModelSerializer, AnyModelSerializerClass, AnySerializerClass, ManyToManyManagerKeys, ManyToManyReadStrategy, ManyToManyRelationField, ManyToManyWriteStrategy, ModelSerializer, ModelSerializerClass, ModelSerializerRelationFields, Serializer, SerializerClass, SerializerCreateInput, SerializerOutput, SerializerOutputResolver, SerializerOutputResolvers, SerializerSchema, SerializerUpdateInput, relation };
-}
-//#endregion
-//#region src/viewset/ModelViewSet.d.ts
-type ViewSetActionScope = 'detail' | 'collection';
-type ViewSetActionMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
-interface ViewSetActionDescriptor {
-  name: string;
-  scope: ViewSetActionScope;
-  methods: readonly ViewSetActionMethod[];
-  path?: string;
-}
-interface ResolvedViewSetActionDescriptor extends ViewSetActionDescriptor {
-  path: string;
-}
-type AnyModelViewSet = ModelViewSet<Record<string, unknown>, AnyModelSerializerClass>;
-type SearchFieldRef$2<TModel extends Record<string, unknown>> = Extract<keyof TModel, string> | string;
-/**
- * Configuration for a ModelViewSet, defining how a serializer-backed model is exposed as an API resource.
- */
-interface ModelViewSetConfig<TModel extends Record<string, unknown>, TSerializer extends AnyModelSerializer<TModel>> {
-  /** Serializer class that owns validation, representation, and persistence hooks */
-  serializer: TSerializer;
-  /** Optional filter set defining which query parameters can filter the list endpoint */
-  filters?: FilterSet<TModel>;
-  /** Fields that clients are allowed to sort by via query parameters */
-  orderingFields?: (keyof TModel)[];
-  /** Fields that are searched when a free-text search query parameter is provided */
-  searchFields?: SearchFieldRef$2<TModel>[];
-  /** Optional paginator factory used by list endpoints. */
-  paginatorFactory?: (queryset: QuerySet<TModel>) => Paginator<TModel, SerializerOutput<TSerializer>>;
-}
-/**
- * Base class for creating RESTful API viewsets with built-in CRUD operations.
- * Provides list, retrieve, create, update, and delete methods with filtering,
- * search, pagination, and ordering support.
- */
-declare abstract class ModelViewSet<TModel extends Record<string, unknown>, TSerializer extends AnyModelSerializer<TModel>> {
-  static readonly BRAND: "tango.resources.model_view_set";
-  static readonly actions: readonly ViewSetActionDescriptor[];
-  readonly __tangoBrand: typeof ModelViewSet.BRAND;
-  protected readonly serializerClass: TSerializer;
-  protected readonly filters?: FilterSet<TModel>;
-  protected readonly orderingFields: (keyof TModel)[];
-  protected readonly searchFields: SearchFieldRef$2<TModel>[];
-  protected readonly paginatorFactory?: (queryset: QuerySet<TModel>) => Paginator<TModel, SerializerOutput<TSerializer>>;
-  private serializer?;
-  constructor(config: ModelViewSetConfig<TModel, TSerializer>);
-  /**
-   * Return the custom action descriptors declared by a viewset or constructor.
-   */
-  static getActions(viewsetOrConstructor: AnyModelViewSet | (new (...args: never[]) => AnyModelViewSet)): readonly ResolvedViewSetActionDescriptor[];
-  /**
-   * Narrow an unknown value to `ModelViewSet`.
-   */
-  static isModelViewSet(value: unknown): value is ModelViewSet<Record<string, unknown>, AnyModelSerializerClass>;
-  /**
-   * Preserve literal action inference while validating the descriptor shape.
-   */
-  static defineViewSetActions<const T extends readonly ViewSetActionDescriptor[]>(actions: T): T;
-  private static resolvePathFromDescriptor;
-  private static toKebabCase;
-  /**
-   * Return the serializer class that owns this resource contract.
-   */
-  getSerializerClass(): TSerializer;
-  /**
-   * Return the serializer instance for the current resource.
-   */
-  getSerializer(): InstanceType<TSerializer>;
-  /**
-   * Describe the public HTTP contract that this resource contributes to OpenAPI generation.
-   */
-  describeOpenAPI(): ModelViewSetOpenAPIDescription<TModel, TSerializer>;
-  /**
-   * List endpoint with filtering, search, ordering, and offset pagination.
-   */
-  list(ctx: RequestContext): Promise<TangoResponse>;
-  /**
-   * Retrieve endpoint for a single resource by id.
-   */
-  retrieve(_ctx: RequestContext, id: string): Promise<TangoResponse>;
-  /**
-   * Create endpoint: validate input, persist, and return serialized output.
-   */
-  create(ctx: RequestContext): Promise<TangoResponse>;
-  /**
-   * Update endpoint: validate partial payload and persist by id.
-   */
-  update(ctx: RequestContext, id: string): Promise<TangoResponse>;
-  /**
-   * Destroy endpoint: delete a resource by id.
-   */
-  destroy(_ctx: RequestContext, id: string): Promise<TangoResponse>;
-  protected getPaginator(queryset: QuerySet<TModel>): Paginator<TModel, SerializerOutput<TSerializer>>;
-  protected getManager(): ManagerLike<TModel>;
-  /**
-   * Convert thrown errors into normalized HTTP responses.
-   */
-  protected handleError(error: unknown): TangoResponse;
-  /**
-   * Resolve route path segment(s) for a custom action.
-   * Override this in subclasses to customize path derivation globally.
-   */
-  protected resolveActionPath(action: ViewSetActionDescriptor): string;
-  private requireModelMetadata;
-  private getLookupFieldFromMetadata;
-}
-//#endregion
-//#region src/resource/OpenAPIDescription.d.ts
-type SearchFieldRef$1<TModel extends Record<string, unknown>> = Extract<keyof TModel, string> | string;
-type GenericAPIViewOpenAPIDescription<TModel extends Record<string, unknown>, TSerializer extends AnyModelSerializer<TModel> = AnyModelSerializer<TModel>> = {
-  model: ResourceModelLike<TModel> & {
-    metadata: NonNullable<ResourceModelLike<TModel>['metadata']>;
-  };
-  outputSchema: TSerializer['outputSchema'];
-  createSchema: TSerializer['createSchema'];
-  updateSchema: TSerializer['updateSchema'];
-  searchFields: readonly SearchFieldRef$1<TModel>[];
-  orderingFields: readonly (keyof TModel)[];
-  lookupField: keyof TModel;
-  lookupParam: string;
-  allowedMethods: readonly APIViewMethod[];
-  usesDefaultOffsetPagination: boolean;
-};
-type ModelViewSetOpenAPIDescription<TModel extends Record<string, unknown>, TSerializer extends AnyModelSerializer<TModel> = AnyModelSerializer<TModel>> = GenericAPIViewOpenAPIDescription<TModel, TSerializer> & {
-  actions: readonly ResolvedViewSetActionDescriptor[];
-};
-declare namespace index_d_exports$1 {
-  export { GenericAPIViewOpenAPIDescription, ModelViewSetOpenAPIDescription, ResourceModelFieldMetadata, ResourceModelLike, ResourceModelMetadata };
-}
-//#endregion
-//#region src/view/GenericAPIView.d.ts
-type SearchFieldRef<TModel extends Record<string, unknown>> = Extract<keyof TModel, string> | string;
-interface GenericAPIViewConfig<TModel extends Record<string, unknown>, TSerializer extends AnyModelSerializer<TModel>> {
-  serializer: TSerializer;
-  filters?: FilterSet<TModel>;
-  orderingFields?: (keyof TModel)[];
-  searchFields?: SearchFieldRef<TModel>[];
-  lookupField?: keyof TModel;
-  lookupParam?: string;
-  paginatorFactory?: (queryset: QuerySet<TModel>) => Paginator<TModel, SerializerOutput<TSerializer>>;
-}
-/**
- * Generic API base class that centralizes query/build/validation helpers.
- */
-declare abstract class GenericAPIView<TModel extends Record<string, unknown>, TSerializer extends AnyModelSerializer<TModel>> extends APIView {
-  protected readonly serializerClass: TSerializer;
-  protected readonly filters?: FilterSet<TModel>;
-  protected readonly orderingFields: readonly (keyof TModel)[];
-  protected readonly searchFields: readonly SearchFieldRef<TModel>[];
-  protected readonly lookupField?: keyof TModel;
-  protected readonly lookupParam: string;
-  protected readonly paginatorFactory?: (queryset: QuerySet<TModel>) => Paginator<TModel, SerializerOutput<TSerializer>>;
-  private serializer?;
-  constructor(config: GenericAPIViewConfig<TModel, TSerializer>);
-  /**
-   * Return the serializer class that owns this resource contract.
-   */
-  getSerializerClass(): TSerializer;
-  /**
-   * Return the serializer instance for the current resource.
-   */
-  getSerializer(): InstanceType<TSerializer>;
-  /**
-   * Describe the public HTTP contract that this resource contributes to OpenAPI generation.
-   */
-  describeOpenAPI(): GenericAPIViewOpenAPIDescription<TModel, TSerializer>;
-  protected getManager(): ManagerLike<TModel>;
-  protected getOutputSchema(): TSerializer['outputSchema'];
-  protected getCreateSchema(): TSerializer['createSchema'];
-  protected getUpdateSchema(): TSerializer['updateSchema'];
-  protected getLookupField(): keyof TModel;
-  protected getLookupValue(ctx: RequestContext): string | null;
-  protected getPaginator(queryset: QuerySet<TModel>): Paginator<TModel, SerializerOutput<TSerializer>>;
-  protected performList(ctx: RequestContext): Promise<TangoResponse>;
-  protected performCreate(ctx: RequestContext): Promise<TangoResponse>;
-  protected performRetrieve(ctx: RequestContext): Promise<TangoResponse>;
-  protected performUpdate(ctx: RequestContext): Promise<TangoResponse>;
-  protected performDestroy(ctx: RequestContext): Promise<TangoResponse>;
-  protected handleError(error: unknown): TangoResponse;
-  private requireModelMetadata;
-  private getLookupFieldFromMetadata;
-}
-//#endregion
-//#region src/view/mixins/ListModelMixin.d.ts
-/**
- * Mixin that wires `GET` requests to the generic list implementation.
- */
-declare abstract class ListModelMixin<TModel extends Record<string, unknown>, TSerializer extends AnyModelSerializer<TModel>> extends GenericAPIView<TModel, TSerializer> {
-  protected list(ctx: RequestContext): Promise<TangoResponse>;
-  protected get(ctx: RequestContext): Promise<TangoResponse>;
-}
-//#endregion
-//#region src/view/mixins/CreateModelMixin.d.ts
-/**
- * Mixin that wires `POST` requests to the generic create implementation.
- */
-declare abstract class CreateModelMixin<TModel extends Record<string, unknown>, TSerializer extends AnyModelSerializer<TModel>> extends GenericAPIView<TModel, TSerializer> {
-  protected create(ctx: RequestContext): Promise<TangoResponse>;
-  protected post(ctx: RequestContext): Promise<TangoResponse>;
-}
-//#endregion
-//#region src/view/mixins/RetrieveModelMixin.d.ts
-/**
- * Mixin that wires `GET` requests to the generic retrieve implementation.
- */
-declare abstract class RetrieveModelMixin<TModel extends Record<string, unknown>, TSerializer extends AnyModelSerializer<TModel>> extends GenericAPIView<TModel, TSerializer> {
-  protected retrieve(ctx: RequestContext): Promise<TangoResponse>;
-  protected get(ctx: RequestContext): Promise<TangoResponse>;
-}
-//#endregion
-//#region src/view/mixins/UpdateModelMixin.d.ts
-/**
- * Mixin that wires `PUT` and `PATCH` requests to the generic update implementation.
- */
-declare abstract class UpdateModelMixin<TModel extends Record<string, unknown>, TSerializer extends AnyModelSerializer<TModel>> extends GenericAPIView<TModel, TSerializer> {
-  protected update(ctx: RequestContext): Promise<TangoResponse>;
-  protected put(ctx: RequestContext): Promise<TangoResponse>;
-  protected patch(ctx: RequestContext): Promise<TangoResponse>;
-}
-//#endregion
-//#region src/view/mixins/DestroyModelMixin.d.ts
-/**
- * Mixin that wires `DELETE` requests to the generic destroy implementation.
- */
-declare abstract class DestroyModelMixin<TModel extends Record<string, unknown>, TSerializer extends AnyModelSerializer<TModel>> extends GenericAPIView<TModel, TSerializer> {
-  protected destroy(ctx: RequestContext): Promise<TangoResponse>;
-  protected delete(ctx: RequestContext): Promise<TangoResponse>;
-}
-//#endregion
-//#region src/view/generics/ListAPIView.d.ts
-/**
- * Generic API view for endpoints that only expose a list operation.
- */
-declare abstract class ListAPIView<TModel extends Record<string, unknown>, TSerializer extends AnyModelSerializer<TModel>> extends ListModelMixin<TModel, TSerializer> {
-  protected get(ctx: RequestContext): Promise<TangoResponse>;
-}
-//#endregion
-//#region src/view/generics/CreateAPIView.d.ts
-/**
- * Generic API view for endpoints that only support resource creation.
- */
-declare abstract class CreateAPIView<TModel extends Record<string, unknown>, TSerializer extends AnyModelSerializer<TModel>> extends CreateModelMixin<TModel, TSerializer> {
-  protected post(ctx: RequestContext): Promise<TangoResponse>;
-}
-//#endregion
-//#region src/view/generics/RetrieveAPIView.d.ts
-/**
- * Generic API view for endpoints that retrieve a single resource by lookup.
- */
-declare abstract class RetrieveAPIView<TModel extends Record<string, unknown>, TSerializer extends AnyModelSerializer<TModel>> extends RetrieveModelMixin<TModel, TSerializer> {
-  protected get(ctx: RequestContext): Promise<TangoResponse>;
-}
-//#endregion
-//#region src/view/generics/ListCreateAPIView.d.ts
-/**
- * Generic API view for collection endpoints that list and create resources.
- */
-declare abstract class ListCreateAPIView<TModel extends Record<string, unknown>, TSerializer extends AnyModelSerializer<TModel>> extends GenericAPIView<TModel, TSerializer> {
-  protected get(ctx: RequestContext): Promise<TangoResponse>;
-  protected post(ctx: RequestContext): Promise<TangoResponse>;
-}
-//#endregion
-//#region src/view/generics/RetrieveUpdateAPIView.d.ts
-/**
- * Generic API view for endpoints that retrieve and update a single resource.
- */
-declare abstract class RetrieveUpdateAPIView<TModel extends Record<string, unknown>, TSerializer extends AnyModelSerializer<TModel>> extends GenericAPIView<TModel, TSerializer> {
-  protected get(ctx: RequestContext): Promise<TangoResponse>;
-  protected put(ctx: RequestContext): Promise<TangoResponse>;
-  protected patch(ctx: RequestContext): Promise<TangoResponse>;
-}
-//#endregion
-//#region src/view/generics/RetrieveDestroyAPIView.d.ts
-/**
- * Generic API view for endpoints that retrieve and delete a single resource.
- */
-declare abstract class RetrieveDestroyAPIView<TModel extends Record<string, unknown>, TSerializer extends AnyModelSerializer<TModel>> extends GenericAPIView<TModel, TSerializer> {
-  protected get(ctx: RequestContext): Promise<TangoResponse>;
-  protected delete(ctx: RequestContext): Promise<TangoResponse>;
-}
-//#endregion
-//#region src/view/generics/RetrieveUpdateDestroyAPIView.d.ts
-/**
- * Generic API view for full detail endpoints that retrieve, update, and delete.
- */
-declare abstract class RetrieveUpdateDestroyAPIView<TModel extends Record<string, unknown>, TSerializer extends AnyModelSerializer<TModel>> extends GenericAPIView<TModel, TSerializer> {
-  protected get(ctx: RequestContext): Promise<TangoResponse>;
-  protected put(ctx: RequestContext): Promise<TangoResponse>;
-  protected patch(ctx: RequestContext): Promise<TangoResponse>;
-  protected delete(ctx: RequestContext): Promise<TangoResponse>;
-}
-declare namespace index_d_exports {
-  export { APIView, APIViewMethod, CreateAPIView, CreateModelMixin, DestroyModelMixin, GenericAPIView, GenericAPIViewConfig, GenericAPIViewOpenAPIDescription, ListAPIView, ListCreateAPIView, ListModelMixin, RetrieveAPIView, RetrieveDestroyAPIView, RetrieveModelMixin, RetrieveUpdateAPIView, RetrieveUpdateDestroyAPIView, UpdateModelMixin };
-}
-//#endregion
-export { Page as $, ManyToManyManagerKeys as A, SerializerOutput as B, ViewSetActionMethod as C, AnyModelSerializerClass as D, AnyModelSerializer as E, relation as F, ResourceModelFieldMetadata as G, SerializerUpdateInput as H, AnySerializerClass as I, index_d_exports$3 as J, ResourceModelLike as K, Serializer as L, ManyToManyRelationField as M, ManyToManyWriteStrategy as N, ModelSerializer as O, ModelSerializerRelationFields as P, OffsetPaginator as Q, SerializerClass as R, ViewSetActionDescriptor as S, index_d_exports$2 as T, APIView as U, SerializerSchema as V, APIViewMethod as W, OffsetPaginationInput as X, CursorPaginationInput as Y, CursorPaginator as Z, GenericAPIViewOpenAPIDescription as _, RequestContext as _t, ListCreateAPIView as a, index_d_exports$4 as at, ModelViewSetConfig as b, ListAPIView as c, FilterLookup as ct, RetrieveModelMixin as d, FilterSetDefineConfig as dt, Paginator as et, CreateModelMixin as f, FilterValueParser as ft, index_d_exports$1 as g, BaseUser as gt, GenericAPIViewConfig as h, index_d_exports$5 as ht, RetrieveUpdateAPIView as i, PaginatedResponse as it, ManyToManyReadStrategy as j, ModelSerializerClass as k, DestroyModelMixin as l, FilterResolver as lt, GenericAPIView as m, FilterType as mt, RetrieveUpdateDestroyAPIView as n, CursorPaginatedResponse as nt, RetrieveAPIView as o, AliasFilterDeclaration as ot, ListModelMixin as p, RangeOperator as pt, ResourceModelMetadata as q, RetrieveDestroyAPIView as r, OffsetPaginatedResponse as rt, CreateAPIView as s, FieldFilterDeclaration as st, index_d_exports as t, BasePaginatedResponse as tt, UpdateModelMixin as u, FilterSet as ut, ModelViewSetOpenAPIDescription as v, ViewSetActionScope as w, ResolvedViewSetActionDescriptor as x, ModelViewSet as y, SerializerCreateInput as z };
-//# sourceMappingURL=index-D6sfTSEj.d.ts.map