@prisma/orm-family-mongo 0.16.0-dev.36

package/dist/orm.d.mts

@@ -0,0 +1,311 @@
+import { C as MongoContract, V as MongoModelsMap, X as MongoUnboundFieldInputTypes, Z as MongoUnboundFieldOutputTypes, at as RootModelName, n as ExtractMongoCodecTypes, o as InferModelRow, t as AnyMongoTypeMaps, w as MongoContractWithTypeMaps, z as MongoModelDefinition } from "./mongo-value-set-tNn9-pun-dJYx_rVD.mjs";
+import "./index-Cd2zLiU6.mjs";
+import { c as MongoValue, t as Document } from "./index-wKMm41HC.mjs";
+import { B as MongoFilterExpr, rt as MongoQueryPlan } from "./query-plan-C0-Yu8hf-DdilEdW6.mjs";
+import "./execution-CKnUiOfm.mjs";
+import { ContractField, ContractReferenceRelation, ContractValueObject, ContractValueObjectDefinitions } from "@prisma/orm-framework/contract/types";
+import { AsyncIterableResult } from "@prisma/orm-framework/components/runtime";
+import { SimplifyDeep } from "@prisma/orm-framework/utils/simplify-deep";
+//#region ../../../2-mongo-family/5-query-builders/orm/dist/index.d.mts
+//#region src/executor.d.ts
+interface MongoQueryExecutor {
+  execute<Row>(plan: MongoQueryPlan<Row>): AsyncIterableResult<Row>;
+}
+//#endregion
+//#region src/field-accessor.d.ts
+type UpdateOperator = '$set' | '$unset' | '$inc' | '$mul' | '$push' | '$pull' | '$addToSet' | '$pop';
+interface FieldOperation {
+  readonly operator: UpdateOperator;
+  readonly field: string;
+  readonly value: MongoValue;
+}
+type ScalarFieldKeys<TContract extends MongoContract, ModelName extends string & keyof MongoModelsMap<TContract>> = { [K in keyof MongoModelsMap<TContract>[ModelName]['fields'] & string]: MongoModelsMap<TContract>[ModelName]['fields'][K] extends {
+  readonly type: {
+    readonly kind: 'scalar';
+  };
+} ? K : never; }[keyof MongoModelsMap<TContract>[ModelName]['fields'] & string];
+type ValueObjectFieldKeys<TContract extends MongoContract, ModelName extends string & keyof MongoModelsMap<TContract>> = { [K in keyof MongoModelsMap<TContract>[ModelName]['fields'] & string]: MongoModelsMap<TContract>[ModelName]['fields'][K] extends {
+  readonly type: {
+    readonly kind: 'valueObject';
+    readonly name: string;
+  };
+} ? K : never; }[keyof MongoModelsMap<TContract>[ModelName]['fields'] & string];
+type ResolvedModelRow<TContract extends MongoContractWithTypeMaps<MongoContract, AnyMongoTypeMaps>, ModelName extends string & keyof MongoModelsMap<TContract>> = InferModelRow<TContract, ModelName>;
+type ResolveFieldType<TContract extends MongoContractWithTypeMaps<MongoContract, AnyMongoTypeMaps>, ModelName extends string & keyof MongoModelsMap<TContract>, K extends keyof MongoModelsMap<TContract>[ModelName]['fields'] & string, TCodecTypes extends Record<string, {
+  output: unknown;
+}> = ExtractMongoCodecTypes<TContract>> = MongoModelsMap<TContract>[ModelName]['fields'][K] extends {
+  readonly type: {
+    readonly kind: 'scalar';
+    readonly codecId: infer CId extends string & keyof TCodecTypes;
+  };
+  readonly many: true;
+  readonly nullable: true;
+} ? readonly TCodecTypes[CId]['output'][] | null : MongoModelsMap<TContract>[ModelName]['fields'][K] extends {
+  readonly type: {
+    readonly kind: 'scalar';
+    readonly codecId: infer CId extends string & keyof TCodecTypes;
+  };
+  readonly many: true;
+} ? readonly TCodecTypes[CId]['output'][] : MongoModelsMap<TContract>[ModelName]['fields'][K] extends {
+  readonly type: {
+    readonly kind: 'scalar';
+    readonly codecId: infer CId extends string & keyof TCodecTypes;
+  };
+  readonly nullable: true;
+} ? TCodecTypes[CId]['output'] | null : MongoModelsMap<TContract>[ModelName]['fields'][K] extends {
+  readonly type: {
+    readonly kind: 'scalar';
+    readonly codecId: infer CId extends string & keyof TCodecTypes;
+  };
+} ? TCodecTypes[CId]['output'] : K extends keyof ResolvedModelRow<TContract, ModelName> ? ResolvedModelRow<TContract, ModelName>[K] : unknown;
+type NumericOps = {
+  inc(value: number): FieldOperation;
+  mul(value: number): FieldOperation;
+};
+type FieldExpression<T = unknown> = {
+  set(value: T): FieldOperation;
+  unset(): FieldOperation;
+  push(value: T extends readonly (infer E)[] ? E : unknown): FieldOperation;
+  pull(match: T extends readonly (infer E)[] ? E | Partial<E> : unknown): FieldOperation;
+  addToSet(value: T extends readonly (infer E)[] ? E : unknown): FieldOperation;
+  pop(end: 1 | -1): FieldOperation;
+} & (T extends number ? NumericOps : unknown);
+type HasValueObjects = MongoContract;
+type MergedContractValueObjects<TContract extends HasValueObjects> = ContractValueObjectDefinitions<TContract> & (TContract extends {
+  readonly valueObjects?: infer VOs;
+} ? VOs extends Record<string, ContractValueObject> ? VOs : Record<string, never> : Record<string, never>);
+type VOFields<TContract extends HasValueObjects, VOName extends string> = VOName extends keyof MergedContractValueObjects<TContract> ? MergedContractValueObjects<TContract>[VOName] extends {
+  readonly fields: infer F extends Record<string, ContractField>;
+} ? F : never : never;
+type VOScalarFieldKeys<Fields extends Record<string, ContractField>> = { [K in keyof Fields & string]: Fields[K] extends {
+  readonly type: {
+    readonly kind: 'scalar';
+  };
+} ? K : never; }[keyof Fields & string];
+type VOValueObjectFieldKeys<Fields extends Record<string, ContractField>> = { [K in keyof Fields & string]: Fields[K] extends {
+  readonly type: {
+    readonly kind: 'valueObject';
+    readonly name: string;
+  };
+} ? K : never; }[keyof Fields & string];
+type VODotPaths<TContract extends HasValueObjects, Fields extends Record<string, ContractField>, Prefix extends string> = { [K in VOScalarFieldKeys<Fields>]: `${Prefix}${K}`; }[VOScalarFieldKeys<Fields>] | { [K in VOValueObjectFieldKeys<Fields>]: Fields[K] extends {
+  readonly type: {
+    readonly kind: 'valueObject';
+    readonly name: infer N extends string;
+  };
+} ? VODotPaths<TContract, VOFields<TContract, N>, `${Prefix}${K}.`> : never; }[VOValueObjectFieldKeys<Fields>];
+type DotPath<TContract extends MongoContractWithTypeMaps<MongoContract, AnyMongoTypeMaps>, ModelName extends string & keyof MongoModelsMap<TContract>> = { [K in ValueObjectFieldKeys<TContract, ModelName>]: MongoModelsMap<TContract>[ModelName]['fields'][K] extends {
+  readonly type: {
+    readonly kind: 'valueObject';
+    readonly name: infer N extends string;
+  };
+} ? VODotPaths<TContract, VOFields<TContract, N>, `${K}.`> : never; }[ValueObjectFieldKeys<TContract, ModelName>];
+type ResolveDotPathInFields<TContract extends HasValueObjects, Fields extends Record<string, ContractField>, Path extends string, TCodecTypes extends Record<string, {
+  output: unknown;
+}>> = Path extends `${infer Head}.${infer Rest}` ? Head extends keyof Fields & string ? Fields[Head] extends {
+  readonly type: {
+    readonly kind: 'valueObject';
+    readonly name: infer N extends string;
+  };
+} ? ResolveDotPathInFields<TContract, VOFields<TContract, N>, Rest, TCodecTypes> : never : never : Path extends keyof Fields & string ? Fields[Path] extends {
+  readonly type: {
+    readonly kind: 'scalar';
+    readonly codecId: infer CId extends string & keyof TCodecTypes;
+  };
+} ? TCodecTypes[CId]['output'] : unknown : never;
+type ResolveDotPathType<TContract extends MongoContractWithTypeMaps<MongoContract, AnyMongoTypeMaps>, ModelName extends string & keyof MongoModelsMap<TContract>, Path extends string, TCodecTypes extends Record<string, {
+  output: unknown;
+}> = ExtractMongoCodecTypes<TContract>> = Path extends `${infer Head}.${infer Rest}` ? Head extends keyof MongoModelsMap<TContract>[ModelName]['fields'] & string ? MongoModelsMap<TContract>[ModelName]['fields'][Head] extends {
+  readonly type: {
+    readonly kind: 'valueObject';
+    readonly name: infer N extends string;
+  };
+} ? ResolveDotPathInFields<TContract, VOFields<TContract, N>, Rest, TCodecTypes> : never : never : never;
+type FieldAccessor<TContract extends MongoContractWithTypeMaps<MongoContract, AnyMongoTypeMaps>, ModelName extends string & keyof MongoModelsMap<TContract>, TCodecTypes extends Record<string, {
+  output: unknown;
+}> = ExtractMongoCodecTypes<TContract>> = { readonly [K in ScalarFieldKeys<TContract, ModelName>]: FieldExpression<ResolveFieldType<TContract, ModelName, K, TCodecTypes>>; } & { readonly [K in ValueObjectFieldKeys<TContract, ModelName>]: FieldExpression<ResolveFieldType<TContract, ModelName, K, TCodecTypes>>; } & (<P extends DotPath<TContract, ModelName>>(path: P) => FieldExpression<ResolveDotPathType<TContract, ModelName, P, TCodecTypes>>);
+declare function createFieldAccessor<TContract extends MongoContractWithTypeMaps<MongoContract, AnyMongoTypeMaps>, ModelName extends string & keyof MongoModelsMap<TContract>, TCodecTypes extends Record<string, {
+  output: unknown;
+}> = ExtractMongoCodecTypes<TContract>>(): FieldAccessor<TContract, ModelName, TCodecTypes>;
+//#endregion
+//#region src/types.d.ts
+type Simplify<T> = T extends unknown ? { [K in keyof T]: T[K]; } : never;
+type ModelRelations<TContract extends MongoContract, ModelName extends string & keyof MongoModelsMap<TContract>> = NonNullable<MongoModelsMap<TContract>[ModelName]['relations']>;
+type ReferenceRelationKeys<TContract extends MongoContract, ModelName extends string & keyof MongoModelsMap<TContract>> = { [K in keyof ModelRelations<TContract, ModelName>]: ModelRelations<TContract, ModelName>[K] extends ContractReferenceRelation ? K : never; }[keyof ModelRelations<TContract, ModelName>];
+type EmbedRelationKeys<TContract extends MongoContract, ModelName extends string & keyof MongoModelsMap<TContract>> = { [K in keyof ModelRelations<TContract, ModelName>]: ModelRelations<TContract, ModelName>[K] extends ContractReferenceRelation ? never : K; }[keyof ModelRelations<TContract, ModelName>];
+type ResolvedOutputRow<TContract extends MongoContractWithTypeMaps<MongoContract, AnyMongoTypeMaps>, ModelName extends string & keyof MongoModelsMap<TContract>> = string extends keyof MongoUnboundFieldOutputTypes<TContract> ? InferModelRow<TContract, ModelName> : ModelName extends keyof MongoUnboundFieldOutputTypes<TContract> ? { -readonly [K in keyof MongoUnboundFieldOutputTypes<TContract>[ModelName]]: MongoUnboundFieldOutputTypes<TContract>[ModelName][K]; } : InferModelRow<TContract, ModelName>;
+type ResolvedInputRow<TContract extends MongoContractWithTypeMaps<MongoContract, AnyMongoTypeMaps>, ModelName extends string & keyof MongoModelsMap<TContract>> = string extends keyof MongoUnboundFieldInputTypes<TContract> ? InferModelRow<TContract, ModelName> : ModelName extends keyof MongoUnboundFieldInputTypes<TContract> ? { -readonly [K in keyof MongoUnboundFieldInputTypes<TContract>[ModelName]]: MongoUnboundFieldInputTypes<TContract>[ModelName][K]; } : InferModelRow<TContract, ModelName>;
+type RelationTargetModel<TContract extends MongoContract, R> = R extends {
+  readonly to: {
+    readonly model: infer M extends string & keyof MongoModelsMap<TContract>;
+  };
+} ? M : never;
+type EmbedRelationRowType<TContract extends MongoContractWithTypeMaps<MongoContract, AnyMongoTypeMaps>, ModelName extends string & keyof MongoModelsMap<TContract>, RelKey extends keyof ModelRelations<TContract, ModelName>> = ModelRelations<TContract, ModelName>[RelKey] extends (infer R) ? R extends {
+  readonly cardinality: infer C;
+} ? ModelRelations<TContract, ModelName>[RelKey] extends ContractReferenceRelation ? never : RelationTargetModel<TContract, R> extends (infer To extends string & keyof MongoModelsMap<TContract>) ? C extends '1:N' ? ResolvedOutputRow<TContract, To>[] : ResolvedOutputRow<TContract, To> : never : never : never;
+type InferFullRow<TContract extends MongoContractWithTypeMaps<MongoContract, AnyMongoTypeMaps>, ModelName extends string & keyof MongoModelsMap<TContract>> = EmbedRelationKeys<TContract, ModelName> extends never ? ResolvedOutputRow<TContract, ModelName> : ResolvedOutputRow<TContract, ModelName> & { -readonly [K in EmbedRelationKeys<TContract, ModelName> & keyof ModelRelations<TContract, ModelName>]: EmbedRelationRowType<TContract, ModelName, K>; };
+type VariantRow<TContract extends MongoContractWithTypeMaps<MongoContract, AnyMongoTypeMaps>, ModelName extends string & keyof MongoModelsMap<TContract>> = MongoModelsMap<TContract>[ModelName] extends {
+  readonly discriminator: {
+    readonly field: infer DiscField extends string;
+  };
+  readonly variants: infer V;
+} ? V extends Record<string, {
+  readonly value: string;
+}> ? { [VK in keyof V]: VK extends string & keyof MongoModelsMap<TContract> ? Simplify<Omit<InferFullRow<TContract, ModelName>, DiscField> & InferFullRow<TContract, VK> & Record<DiscField, V[VK]['value']>> : never; }[keyof V] : InferFullRow<TContract, ModelName> : InferFullRow<TContract, ModelName>;
+type InferRootRow<TContract extends MongoContractWithTypeMaps<MongoContract, AnyMongoTypeMaps>, ModelName extends string & keyof MongoModelsMap<TContract>> = VariantRow<TContract, ModelName>;
+type VariantNames<TContract extends MongoContract, ModelName extends string & keyof MongoModelsMap<TContract>> = MongoModelsMap<TContract>[ModelName] extends {
+  readonly variants: infer V extends Record<string, unknown>;
+} ? keyof V & string : never;
+type VariantModelRow<TContract extends MongoContractWithTypeMaps<MongoContract, AnyMongoTypeMaps>, ModelName extends string & keyof MongoModelsMap<TContract>, VariantName extends string> = MongoModelsMap<TContract>[ModelName] extends {
+  readonly discriminator: {
+    readonly field: infer DiscField extends string;
+  };
+  readonly variants: infer V;
+} ? V extends Record<string, {
+  readonly value: string;
+}> ? VariantName extends keyof V & string & keyof MongoModelsMap<TContract> ? Simplify<Omit<InferFullRow<TContract, ModelName>, DiscField> & InferFullRow<TContract, VariantName> & Record<DiscField, V[VariantName]['value']>> : InferFullRow<TContract, ModelName> : InferFullRow<TContract, ModelName> : InferFullRow<TContract, ModelName>;
+type IncludeRelationRowType<TContract extends MongoContractWithTypeMaps<MongoContract, AnyMongoTypeMaps>, ModelName extends string & keyof MongoModelsMap<TContract>, RelKey extends keyof ModelRelations<TContract, ModelName>> = ModelRelations<TContract, ModelName>[RelKey] extends ContractReferenceRelation ? ModelRelations<TContract, ModelName>[RelKey] extends (infer R) ? R extends {
+  readonly cardinality: infer C;
+} ? RelationTargetModel<TContract, R> extends (infer To extends string & keyof MongoModelsMap<TContract>) ? C extends 'N:1' | '1:1' ? InferFullRow<TContract, To> | null : InferFullRow<TContract, To>[] : never : never : never : never;
+type IncludeResultFields<TContract extends MongoContractWithTypeMaps<MongoContract, AnyMongoTypeMaps>, ModelName extends string & keyof MongoModelsMap<TContract>, TInclude extends MongoIncludeSpec<TContract, ModelName>> = { -readonly [K in keyof TInclude & string as TInclude[K] extends true ? K : never]: K extends keyof ModelRelations<TContract, ModelName> ? IncludeRelationRowType<TContract, ModelName, K> : never; };
+type MongoWhereFilter<TContract extends MongoContractWithTypeMaps<MongoContract, AnyMongoTypeMaps>, ModelName extends string & keyof MongoModelsMap<TContract>, TCodecTypes extends Record<string, {
+  output: unknown;
+}> = ExtractMongoCodecTypes<TContract>> = { readonly [K in keyof MongoModelsMap<TContract>[ModelName]['fields']]?: MongoModelsMap<TContract>[ModelName]['fields'][K] extends {
+  readonly type: {
+    readonly kind: 'scalar';
+    readonly codecId: infer CId extends string & keyof TCodecTypes;
+  };
+} ? TCodecTypes[CId]['output'] : unknown; };
+type MongoIncludeSpec<TContract extends MongoContract, ModelName extends string & keyof MongoModelsMap<TContract>> = { readonly [K in ReferenceRelationKeys<TContract, ModelName>]?: true; };
+type NoIncludes = Pick<Record<string, boolean>, never>;
+type IncludedRow<TContract extends MongoContractWithTypeMaps<MongoContract, AnyMongoTypeMaps>, ModelName extends string & keyof MongoModelsMap<TContract>, TIncludes extends MongoIncludeSpec<TContract, ModelName> = NoIncludes> = InferRootRow<TContract, ModelName> & IncludeResultFields<TContract, ModelName, TIncludes>;
+type DefaultModelRow<TContract extends MongoContractWithTypeMaps<MongoContract, AnyMongoTypeMaps>, ModelName extends string & keyof MongoModelsMap<TContract>> = ResolvedOutputRow<TContract, ModelName>;
+type CreateInput<TContract extends MongoContractWithTypeMaps<MongoContract, AnyMongoTypeMaps>, ModelName extends string & keyof MongoModelsMap<TContract>> = Omit<ResolvedInputRow<TContract, ModelName>, '_id'> & Partial<Pick<ResolvedInputRow<TContract, ModelName>, '_id' & keyof ResolvedInputRow<TContract, ModelName>>>;
+type DiscriminatorField<TContract extends MongoContract, ModelName extends string & keyof MongoModelsMap<TContract>> = MongoModelsMap<TContract>[ModelName] extends {
+  readonly discriminator: {
+    readonly field: infer F extends string;
+  };
+} ? F : never;
+type VariantCreateInput<TContract extends MongoContractWithTypeMaps<MongoContract, AnyMongoTypeMaps>, ModelName extends string & keyof MongoModelsMap<TContract>, VariantName extends string> = Omit<VariantModelRow<TContract, ModelName, VariantName>, '_id' | DiscriminatorField<TContract, ModelName>> & Partial<Pick<ResolvedInputRow<TContract, ModelName>, '_id' & keyof ResolvedInputRow<TContract, ModelName>>>;
+type ResolvedCreateInput<TContract extends MongoContractWithTypeMaps<MongoContract, AnyMongoTypeMaps>, ModelName extends string & keyof MongoModelsMap<TContract>, TVariant extends string> = [TVariant] extends [never] ? CreateInput<TContract, ModelName> : VariantCreateInput<TContract, ModelName, TVariant>;
+//#endregion
+//#region src/collection.d.ts
+type ModelFieldKeys<TContract extends MongoContract, ModelName extends string & keyof MongoModelsMap<TContract>> = keyof MongoModelsMap<TContract>[ModelName]['fields'] & string;
+interface MongoCollection<TContract extends MongoContractWithTypeMaps<MongoContract, AnyMongoTypeMaps>, ModelName extends string & keyof MongoModelsMap<TContract>, TIncludes extends MongoIncludeSpec<TContract, ModelName> = NoIncludes, TVariant extends string = never> {
+  /** Narrows to a specific variant, injecting a discriminator filter. */
+  variant<V extends VariantNames<TContract, ModelName>>(variantName: V): MongoCollection<TContract, ModelName, TIncludes, V>;
+  /** Appends equality filters from a plain object. Values are encoded through codecs. */
+  where(filter: MongoWhereFilter<TContract, ModelName>): MongoCollection<TContract, ModelName, TIncludes, TVariant>;
+  /** Appends a filter condition from a raw filter expression. */
+  where(filter: MongoFilterExpr): MongoCollection<TContract, ModelName, TIncludes, TVariant>;
+  /** Restricts returned fields to the given subset. Returns a new immutable collection. */
+  select(...fields: ModelFieldKeys<TContract, ModelName>[]): MongoCollection<TContract, ModelName, TIncludes, TVariant>;
+  /** Adds a `$lookup` for a reference relation. Returns a new immutable collection. */
+  include<K extends ReferenceRelationKeys<TContract, ModelName> & string>(relationName: K): MongoCollection<TContract, ModelName, TIncludes & Record<K, true>, TVariant>;
+  /** Sets sort order. Returns a new immutable collection. */
+  orderBy(spec: Partial<Record<ModelFieldKeys<TContract, ModelName>, 1 | -1>>): MongoCollection<TContract, ModelName, TIncludes, TVariant>;
+  /** Limits the number of results. Returns a new immutable collection. */
+  take(n: number): MongoCollection<TContract, ModelName, TIncludes, TVariant>;
+  /** Skips the first `n` results. Returns a new immutable collection. */
+  skip(n: number): MongoCollection<TContract, ModelName, TIncludes, TVariant>;
+  /** Executes the query and returns all matching rows as an async iterable. */
+  all(): AsyncIterableResult<IncludedRow<TContract, ModelName, TIncludes>>;
+  /** Executes the query with limit 1. Returns the first matching row or `null`. */
+  first(): Promise<IncludedRow<TContract, ModelName, TIncludes> | null>;
+  /** Returns the input data with the server-assigned `_id`. Does not re-read the stored document. */
+  create(data: ResolvedCreateInput<TContract, ModelName, TVariant>): Promise<IncludedRow<TContract, ModelName, TIncludes>>;
+  /** Returns input rows with server-assigned `_id`s. Does not re-read stored documents. */
+  createAll(data: ReadonlyArray<ResolvedCreateInput<TContract, ModelName, TVariant>>): AsyncIterableResult<IncludedRow<TContract, ModelName, TIncludes>>;
+  /** Inserts multiple documents and returns the number inserted. */
+  createAndCount(data: ReadonlyArray<ResolvedCreateInput<TContract, ModelName, TVariant>>): Promise<number>;
+  /** Updates one matching document via `findOneAndUpdate`. Returns the updated document or `null`. Requires `.where()`. */
+  update(data: Partial<DefaultModelRow<TContract, ModelName>>): Promise<IncludedRow<TContract, ModelName, TIncludes> | null>;
+  /** Updates one matching document using field operations from a callback. Requires `.where()`. */
+  update(callback: (u: FieldAccessor<TContract, ModelName>) => FieldOperation[]): Promise<IncludedRow<TContract, ModelName, TIncludes> | null>;
+  /** Non-atomic: captures matching `_id`s, updates, then re-reads by `_id`. Requires `.where()`. */
+  updateAll(data: Partial<DefaultModelRow<TContract, ModelName>>): AsyncIterableResult<IncludedRow<TContract, ModelName, TIncludes>>;
+  /** Updates all matching documents using field operations from a callback. Requires `.where()`. */
+  updateAll(callback: (u: FieldAccessor<TContract, ModelName>) => FieldOperation[]): AsyncIterableResult<IncludedRow<TContract, ModelName, TIncludes>>;
+  /** Updates all matching documents and returns the number modified. Requires `.where()`. */
+  updateAndCount(data: Partial<DefaultModelRow<TContract, ModelName>>): Promise<number>;
+  /** Updates all matching documents using field operations and returns the number modified. Requires `.where()`. */
+  updateAndCount(callback: (u: FieldAccessor<TContract, ModelName>) => FieldOperation[]): Promise<number>;
+  /** Deletes one matching document via `findOneAndDelete`. Returns the deleted document or `null`. Requires `.where()`. */
+  delete(): Promise<IncludedRow<TContract, ModelName, TIncludes> | null>;
+  /** Non-atomic: reads matching docs then deletes them. Concurrent writes may cause stale results. Requires `.where()`. */
+  deleteAll(): AsyncIterableResult<IncludedRow<TContract, ModelName, TIncludes>>;
+  /** Deletes all matching documents and returns the number deleted. Requires `.where()`. */
+  deleteAndCount(): Promise<number>;
+  /**
+   * On insert: `update` fields are applied via `$set`, remaining `create` fields via `$setOnInsert`.
+   * This means `update` values take precedence over `create` for overlapping fields on insert.
+   * Requires `.where()`.
+   */
+  upsert(input: {
+    create: ResolvedCreateInput<TContract, ModelName, TVariant>;
+    update: Partial<DefaultModelRow<TContract, ModelName>>;
+  }): Promise<IncludedRow<TContract, ModelName, TIncludes>>;
+  /** Upsert using field operations callback for the update part. Requires `.where()`. */
+  upsert(input: {
+    create: ResolvedCreateInput<TContract, ModelName, TVariant>;
+    update: (u: FieldAccessor<TContract, ModelName>) => FieldOperation[];
+  }): Promise<IncludedRow<TContract, ModelName, TIncludes>>;
+}
+declare function createMongoCollection<TContract extends MongoContractWithTypeMaps<MongoContract, AnyMongoTypeMaps>, ModelName extends string & keyof MongoModelsMap<TContract>>(contract: TContract, modelName: ModelName, executor: MongoQueryExecutor): MongoCollection<TContract, ModelName>;
+//#endregion
+//#region src/collection-state.d.ts
+interface MongoIncludeExpr {
+  readonly relationName: string;
+  readonly from: string;
+  readonly localField: string;
+  readonly foreignField: string;
+  readonly cardinality: '1:1' | 'N:1' | '1:N' | 'N:M';
+}
+interface MongoCollectionState {
+  readonly filters: readonly MongoFilterExpr[];
+  readonly includes: readonly MongoIncludeExpr[];
+  readonly orderBy: Readonly<Record<string, 1 | -1>> | undefined;
+  readonly selectedFields: readonly string[] | undefined;
+  readonly limit: number | undefined;
+  readonly offset: number | undefined;
+}
+//#endregion
+//#region src/compile.d.ts
+declare function compileMongoQuery<Row = unknown>(collection: string, state: MongoCollectionState, storageHash: string, model: MongoModelDefinition): MongoQueryPlan<Row>;
+//#endregion
+//#region src/mongo-orm.d.ts
+interface MongoOrmOptions<TContract extends MongoContract> {
+  readonly contract: TContract;
+  readonly executor: MongoQueryExecutor;
+}
+type MongoOrmClient<TContract extends MongoContractWithTypeMaps<MongoContract, AnyMongoTypeMaps>> = { readonly [K in keyof TContract['roots'] & string]: MongoCollection<TContract, RootModelName<TContract, K>>; };
+declare function mongoOrm<TContract extends MongoContractWithTypeMaps<MongoContract, AnyMongoTypeMaps>>(options: MongoOrmOptions<TContract>): MongoOrmClient<TContract>;
+//#endregion
+//#region src/raw-collection.d.ts
+interface Buildable<Row = unknown> {
+  build(): MongoQueryPlan<Row>;
+}
+interface RawMongoCollection {
+  aggregate<Row = Record<string, unknown>>(pipeline: ReadonlyArray<Document>): Buildable<Row>;
+  insertOne(document: Document): Buildable;
+  insertMany(documents: ReadonlyArray<Document>): Buildable;
+  updateOne(filter: Document, update: Document | ReadonlyArray<Document>): Buildable;
+  updateMany(filter: Document, update: Document | ReadonlyArray<Document>): Buildable;
+  deleteOne(filter: Document): Buildable;
+  deleteMany(filter: Document): Buildable;
+  findOneAndUpdate(filter: Document, update: Document | ReadonlyArray<Document>, options?: {
+    upsert?: boolean;
+  }): Buildable;
+  findOneAndDelete(filter: Document): Buildable;
+}
+//#endregion
+//#region src/mongo-raw.d.ts
+interface MongoRawClient<TContract extends MongoContract> {
+  collection<K extends keyof TContract['roots'] & string>(rootName: K): RawMongoCollection;
+}
+declare function mongoRaw<TContract extends MongoContract>(options: {
+  contract: TContract;
+}): MongoRawClient<TContract>;
+//#endregion
+export { type CreateInput, type DefaultModelRow, type DotPath, type FieldAccessor, type FieldExpression, type FieldOperation, type IncludeResultFields, type IncludedRow, type InferFullRow, type InferRootRow, type MongoCollection, type MongoIncludeSpec, type MongoOrmClient, type MongoOrmOptions, type MongoQueryExecutor, type MongoQueryPlan, type MongoRawClient, type MongoWhereFilter, type NoIncludes, type RawMongoCollection, type ResolveDotPathType, type ResolvedCreateInput, type SimplifyDeep, type UpdateOperator, type VariantCreateInput, type VariantModelRow, type VariantNames, compileMongoQuery, createFieldAccessor, createMongoCollection, mongoOrm, mongoRaw };
+//# sourceMappingURL=orm.d.mts.map

package/dist/orm.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orm.d.mts","names":[],"sources":["../../../../2-mongo-family/5-query-builders/orm/dist/index.d.mts"],"mappings":"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"}