@prisma-next/mongo-query-builder 0.12.0 → 0.13.0-dev.1

package/dist/exports/contract-free.d.mts

@@ -0,0 +1,78 @@
+import { b as DocShape, c as UpdaterResult, n as FieldAccessor } from "../field-accessor-BmcQj0lD.mjs";
+import { AggregateCommand, FindOneAndUpdateCommand, InsertOneCommand, MongoFilterExpr, MongoPipelineStage } from "@prisma-next/mongo-query-ast/execution";
+import { MongoValue } from "@prisma-next/mongo-value";
+
+//#region src/contract-free/collection.d.ts
+/**
+ * Fluent aggregate chain. Accumulates `$match` / `$sort` / `$limit` stages and
+ * produces an `AggregateCommand` via `.build()`.
+ *
+ * Instances are immutable — each stage method returns a new chain.
+ */
+declare class AggregateChain<Shape extends DocShape> {
+  #private;
+  constructor(collection: string, stages: ReadonlyArray<MongoPipelineStage>);
+  match(filterFn: (fields: FieldAccessor<Shape>) => MongoFilterExpr): AggregateChain<Shape>;
+  sort(spec: Record<string, 1 | -1>): AggregateChain<Shape>;
+  limit(n: number): AggregateChain<Shape>;
+  build(): AggregateCommand;
+}
+/**
+ * Fluent find-and-modify chain. Holds an accumulated list of filter expressions
+ * (AND-folded into the wire command's `filter` slot) and exposes
+ * `.findOneAndUpdate(...)` as the only terminal.
+ *
+ * Multiple `.match()` calls AND-fold internally — `MongoAndExpr.of` never
+ * appears at the call site.
+ *
+ * Instances are immutable — `.match()` returns a new `FilteredBuilder`.
+ */
+declare class FilteredBuilder<Shape extends DocShape> {
+  #private;
+  constructor(collection: string, filters: ReadonlyArray<MongoFilterExpr>);
+  match(filterFn: (fields: FieldAccessor<Shape>) => MongoFilterExpr): FilteredBuilder<Shape>;
+  findOneAndUpdate(updaterFn: (fields: FieldAccessor<Shape>) => UpdaterResult, opts?: {
+    readonly upsert?: boolean;
+    readonly returnDocument?: 'before' | 'after';
+  }): FindOneAndUpdateCommand;
+}
+/**
+ * Contract-free fluent Mongo collection builder. Produces the canonical
+ * `AggregateCommand` / `InsertOneCommand` / `FindOneAndUpdateCommand` command
+ * nodes without any contract coupling — parameterised by an explicit `DocShape`
+ * instead of a `MongoContract`.
+ *
+ * Mirrors SQL's `table(source, schema)` → `TableHandle` in spirit: a top-level
+ * entry point that exposes fluent query chains from which call sites never write
+ * `new MongoMatchStage(...)`, `MongoAndExpr.of([...])`, or `new AggregateCommand(...)`.
+ *
+ * ```ts
+ * const markerLedger = collection<MarkerLedgerDocShape>('_prisma_migrations');
+ *
+ * // aggregate
+ * markerLedger.aggregate().match(f => f._id.eq(space)).limit(1).build();
+ *
+ * // insertOne
+ * markerLedger.insertOne({ _id: space, space, storageHash });
+ *
+ * // findOneAndUpdate (CAS)
+ * markerLedger.match(f => f._id.eq(space)).match(f => f.storageHash.eq(expectedFrom))
+ *   .findOneAndUpdate(f => [f.stage.set({ storageHash: newHash })], { upsert: false });
+ * ```
+ */
+interface CollectionBuilder<Shape extends DocShape> {
+  aggregate(): AggregateChain<Shape>;
+  insertOne(document: Record<string, MongoValue>): InsertOneCommand;
+  match(filterFn: (fields: FieldAccessor<Shape>) => MongoFilterExpr): FilteredBuilder<Shape>;
+}
+/**
+ * Declare a contract-free collection builder parameterised by a `DocShape`.
+ * The collection name is bound once; field access reuses `createFieldAccessor`
+ * so the shape is typed at every call site without a contract.
+ *
+ * @param name The MongoDB collection name (e.g. `'_prisma_migrations'`)
+ */
+declare function collection<Shape extends DocShape>(name: string): CollectionBuilder<Shape>;
+//#endregion
+export { AggregateChain, type CollectionBuilder, FilteredBuilder, collection };
+//# sourceMappingURL=contract-free.d.mts.map

package/dist/exports/contract-free.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-free.d.mts","names":[],"sources":["../../src/contract-free/collection.ts"],"mappings":";;;;;AAoCA;;;;;;AAAA,cAAa,cAAA,eAA6B,QAAA;EAAA;cAI5B,UAAA,UAAoB,MAAA,EAAQ,aAAA,CAAc,kBAAA;EAKtD,KAAA,CAAM,QAAA,GAAW,MAAA,EAAQ,aAAA,CAAc,KAAA,MAAW,eAAA,GAAkB,cAAA,CAAe,KAAA;EASnF,IAAA,CAAK,IAAA,EAAM,MAAA,mBAAyB,cAAA,CAAe,KAAA;EAInD,KAAA,CAAM,CAAA,WAAY,cAAA,CAAe,KAAA;EAIjC,KAAA,IAAS,gBAAA;AAAA;;;;;;;;;;;cAeE,eAAA,eAA8B,QAAA;EAAA;cAI7B,UAAA,UAAoB,OAAA,EAAS,aAAA,CAAc,eAAA;EAQvD,KAAA,CAAM,QAAA,GAAW,MAAA,EAAQ,aAAA,CAAc,KAAA,MAAW,eAAA,GAAkB,eAAA,CAAgB,KAAA;EAMpF,gBAAA,CACE,SAAA,GAAY,MAAA,EAAQ,aAAA,CAAc,KAAA,MAAW,aAAA,EAC7C,IAAA;IAAA,SAAiB,MAAA;IAAA,SAA2B,cAAA;EAAA,IAC3C,uBAAA;AAAA;;;;;;;;;;;;;;;AApCsB;AAe3B;;;;;;;;;UA6DiB,iBAAA,eAAgC,QAAA;EAC/C,SAAA,IAAa,cAAA,CAAe,KAAA;EAC5B,SAAA,CAAU,QAAA,EAAU,MAAA,SAAe,UAAA,IAAc,gBAAA;EACjD,KAAA,CAAM,QAAA,GAAW,MAAA,EAAQ,aAAA,CAAc,KAAA,MAAW,eAAA,GAAkB,eAAA,CAAgB,KAAA;AAAA;;;;;;;;iBAgCtE,UAAA,eAAyB,QAAA,EAAU,IAAA,WAAe,iBAAA,CAAkB,KAAA"}

package/dist/exports/contract-free.mjs

@@ -0,0 +1,98 @@
+import { r as resolveUpdaterResult, t as createFieldAccessor } from "../field-accessor-Dh8GUEe7.mjs";
+import { AggregateCommand, FindOneAndUpdateCommand, InsertOneCommand, MongoAndExpr, MongoLimitStage, MongoMatchStage, MongoSortStage } from "@prisma-next/mongo-query-ast/execution";
+//#region src/contract-free/collection.ts
+/**
+* Fold an array of filter expressions into a single `MongoFilterExpr`. Length-1
+* short-circuits to avoid a redundant `$and` wrapper; the call site never writes
+* `MongoAndExpr.of([...])` directly.
+*/
+function foldFilters(filters) {
+	const first = filters[0];
+	if (first === void 0) throw new Error("foldFilters: invariant violated — empty filter list");
+	return filters.length === 1 ? first : MongoAndExpr.of(filters);
+}
+/**
+* Fluent aggregate chain. Accumulates `$match` / `$sort` / `$limit` stages and
+* produces an `AggregateCommand` via `.build()`.
+*
+* Instances are immutable — each stage method returns a new chain.
+*/
+var AggregateChain = class AggregateChain {
+	#collection;
+	#stages;
+	constructor(collection, stages) {
+		this.#collection = collection;
+		this.#stages = stages;
+	}
+	match(filterFn) {
+		const filter = filterFn(createFieldAccessor());
+		return new AggregateChain(this.#collection, [...this.#stages, new MongoMatchStage(filter)]);
+	}
+	sort(spec) {
+		return new AggregateChain(this.#collection, [...this.#stages, new MongoSortStage(spec)]);
+	}
+	limit(n) {
+		return new AggregateChain(this.#collection, [...this.#stages, new MongoLimitStage(n)]);
+	}
+	build() {
+		return new AggregateCommand(this.#collection, this.#stages);
+	}
+};
+/**
+* Fluent find-and-modify chain. Holds an accumulated list of filter expressions
+* (AND-folded into the wire command's `filter` slot) and exposes
+* `.findOneAndUpdate(...)` as the only terminal.
+*
+* Multiple `.match()` calls AND-fold internally — `MongoAndExpr.of` never
+* appears at the call site.
+*
+* Instances are immutable — `.match()` returns a new `FilteredBuilder`.
+*/
+var FilteredBuilder = class FilteredBuilder {
+	#collection;
+	#filters;
+	constructor(collection, filters) {
+		if (filters.length === 0) throw new Error("FilteredBuilder requires at least one filter");
+		this.#collection = collection;
+		this.#filters = filters;
+	}
+	match(filterFn) {
+		const filter = filterFn(createFieldAccessor());
+		return new FilteredBuilder(this.#collection, [...this.#filters, filter]);
+	}
+	findOneAndUpdate(updaterFn, opts = {}) {
+		const filter = foldFilters(this.#filters);
+		const update = resolveUpdaterResult(updaterFn(createFieldAccessor()));
+		return new FindOneAndUpdateCommand(this.#collection, filter, update, opts.upsert ?? false, void 0, opts.returnDocument ?? "after");
+	}
+};
+var CollectionBuilderImpl = class {
+	#name;
+	constructor(name) {
+		this.#name = name;
+	}
+	aggregate() {
+		return new AggregateChain(this.#name, []);
+	}
+	insertOne(document) {
+		return new InsertOneCommand(this.#name, document);
+	}
+	match(filterFn) {
+		const filter = filterFn(createFieldAccessor());
+		return new FilteredBuilder(this.#name, [filter]);
+	}
+};
+/**
+* Declare a contract-free collection builder parameterised by a `DocShape`.
+* The collection name is bound once; field access reuses `createFieldAccessor`
+* so the shape is typed at every call site without a contract.
+*
+* @param name The MongoDB collection name (e.g. `'_prisma_migrations'`)
+*/
+function collection(name) {
+	return new CollectionBuilderImpl(name);
+}
+//#endregion
+export { AggregateChain, FilteredBuilder, collection };
+
+//# sourceMappingURL=contract-free.mjs.map

package/dist/exports/contract-free.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-free.mjs","names":["#collection","#stages","#filters","#name"],"sources":["../../src/contract-free/collection.ts"],"sourcesContent":["import {\n  AggregateCommand,\n  FindOneAndUpdateCommand,\n  InsertOneCommand,\n  MongoAndExpr,\n  type MongoFilterExpr,\n  MongoLimitStage,\n  MongoMatchStage,\n  type MongoPipelineStage,\n  MongoSortStage,\n  type MongoUpdatePipelineStage,\n} from '@prisma-next/mongo-query-ast/execution';\nimport type { MongoValue } from '@prisma-next/mongo-value';\nimport { createFieldAccessor, type FieldAccessor } from '../field-accessor';\nimport type { DocShape } from '../types';\nimport { resolveUpdaterResult, type UpdaterResult } from '../update-ops';\n\n/**\n * Fold an array of filter expressions into a single `MongoFilterExpr`. Length-1\n * short-circuits to avoid a redundant `$and` wrapper; the call site never writes\n * `MongoAndExpr.of([...])` directly.\n */\nfunction foldFilters(filters: ReadonlyArray<MongoFilterExpr>): MongoFilterExpr {\n  const first = filters[0];\n  if (first === undefined) {\n    throw new Error('foldFilters: invariant violated — empty filter list');\n  }\n  return filters.length === 1 ? first : MongoAndExpr.of(filters);\n}\n\n/**\n * Fluent aggregate chain. Accumulates `$match` / `$sort` / `$limit` stages and\n * produces an `AggregateCommand` via `.build()`.\n *\n * Instances are immutable — each stage method returns a new chain.\n */\nexport class AggregateChain<Shape extends DocShape> {\n  readonly #collection: string;\n  readonly #stages: ReadonlyArray<MongoPipelineStage>;\n\n  constructor(collection: string, stages: ReadonlyArray<MongoPipelineStage>) {\n    this.#collection = collection;\n    this.#stages = stages;\n  }\n\n  match(filterFn: (fields: FieldAccessor<Shape>) => MongoFilterExpr): AggregateChain<Shape> {\n    const f = createFieldAccessor<Shape>();\n    const filter = filterFn(f);\n    return new AggregateChain<Shape>(this.#collection, [\n      ...this.#stages,\n      new MongoMatchStage(filter),\n    ]);\n  }\n\n  sort(spec: Record<string, 1 | -1>): AggregateChain<Shape> {\n    return new AggregateChain<Shape>(this.#collection, [...this.#stages, new MongoSortStage(spec)]);\n  }\n\n  limit(n: number): AggregateChain<Shape> {\n    return new AggregateChain<Shape>(this.#collection, [...this.#stages, new MongoLimitStage(n)]);\n  }\n\n  build(): AggregateCommand {\n    return new AggregateCommand(this.#collection, this.#stages);\n  }\n}\n\n/**\n * Fluent find-and-modify chain. Holds an accumulated list of filter expressions\n * (AND-folded into the wire command's `filter` slot) and exposes\n * `.findOneAndUpdate(...)` as the only terminal.\n *\n * Multiple `.match()` calls AND-fold internally — `MongoAndExpr.of` never\n * appears at the call site.\n *\n * Instances are immutable — `.match()` returns a new `FilteredBuilder`.\n */\nexport class FilteredBuilder<Shape extends DocShape> {\n  readonly #collection: string;\n  readonly #filters: ReadonlyArray<MongoFilterExpr>;\n\n  constructor(collection: string, filters: ReadonlyArray<MongoFilterExpr>) {\n    if (filters.length === 0) {\n      throw new Error('FilteredBuilder requires at least one filter');\n    }\n    this.#collection = collection;\n    this.#filters = filters;\n  }\n\n  match(filterFn: (fields: FieldAccessor<Shape>) => MongoFilterExpr): FilteredBuilder<Shape> {\n    const f = createFieldAccessor<Shape>();\n    const filter = filterFn(f);\n    return new FilteredBuilder<Shape>(this.#collection, [...this.#filters, filter]);\n  }\n\n  findOneAndUpdate(\n    updaterFn: (fields: FieldAccessor<Shape>) => UpdaterResult,\n    opts: { readonly upsert?: boolean; readonly returnDocument?: 'before' | 'after' } = {},\n  ): FindOneAndUpdateCommand {\n    const filter = foldFilters(this.#filters);\n    const f = createFieldAccessor<Shape>();\n    const items = updaterFn(f);\n    const update = resolveUpdaterResult(items);\n    return new FindOneAndUpdateCommand(\n      this.#collection,\n      filter,\n      update,\n      opts.upsert ?? false,\n      undefined,\n      opts.returnDocument ?? 'after',\n    );\n  }\n}\n\n/**\n * Contract-free fluent Mongo collection builder. Produces the canonical\n * `AggregateCommand` / `InsertOneCommand` / `FindOneAndUpdateCommand` command\n * nodes without any contract coupling — parameterised by an explicit `DocShape`\n * instead of a `MongoContract`.\n *\n * Mirrors SQL's `table(source, schema)` → `TableHandle` in spirit: a top-level\n * entry point that exposes fluent query chains from which call sites never write\n * `new MongoMatchStage(...)`, `MongoAndExpr.of([...])`, or `new AggregateCommand(...)`.\n *\n * ```ts\n * const markerLedger = collection<MarkerLedgerDocShape>('_prisma_migrations');\n *\n * // aggregate\n * markerLedger.aggregate().match(f => f._id.eq(space)).limit(1).build();\n *\n * // insertOne\n * markerLedger.insertOne({ _id: space, space, storageHash });\n *\n * // findOneAndUpdate (CAS)\n * markerLedger.match(f => f._id.eq(space)).match(f => f.storageHash.eq(expectedFrom))\n *   .findOneAndUpdate(f => [f.stage.set({ storageHash: newHash })], { upsert: false });\n * ```\n */\nexport interface CollectionBuilder<Shape extends DocShape> {\n  aggregate(): AggregateChain<Shape>;\n  insertOne(document: Record<string, MongoValue>): InsertOneCommand;\n  match(filterFn: (fields: FieldAccessor<Shape>) => MongoFilterExpr): FilteredBuilder<Shape>;\n}\n\nclass CollectionBuilderImpl<Shape extends DocShape> implements CollectionBuilder<Shape> {\n  readonly #name: string;\n\n  constructor(name: string) {\n    this.#name = name;\n  }\n\n  aggregate(): AggregateChain<Shape> {\n    return new AggregateChain<Shape>(this.#name, []);\n  }\n\n  insertOne(document: Record<string, MongoValue>): InsertOneCommand {\n    return new InsertOneCommand(this.#name, document);\n  }\n\n  match(filterFn: (fields: FieldAccessor<Shape>) => MongoFilterExpr): FilteredBuilder<Shape> {\n    const f = createFieldAccessor<Shape>();\n    const filter = filterFn(f);\n    return new FilteredBuilder<Shape>(this.#name, [filter]);\n  }\n}\n\n/**\n * Declare a contract-free collection builder parameterised by a `DocShape`.\n * The collection name is bound once; field access reuses `createFieldAccessor`\n * so the shape is typed at every call site without a contract.\n *\n * @param name The MongoDB collection name (e.g. `'_prisma_migrations'`)\n */\nexport function collection<Shape extends DocShape>(name: string): CollectionBuilder<Shape> {\n  return new CollectionBuilderImpl<Shape>(name);\n}\n\nexport type { MongoUpdatePipelineStage };\n"],"mappings":";;;;;;;;AAsBA,SAAS,YAAY,SAA0D;CAC7E,MAAM,QAAQ,QAAQ;CACtB,IAAI,UAAU,KAAA,GACZ,MAAM,IAAI,MAAM,qDAAqD;CAEvE,OAAO,QAAQ,WAAW,IAAI,QAAQ,aAAa,GAAG,OAAO;AAC/D;;;;;;;AAQA,IAAa,iBAAb,MAAa,eAAuC;CAClD;CACA;CAEA,YAAY,YAAoB,QAA2C;EACzE,KAAKA,cAAc;EACnB,KAAKC,UAAU;CACjB;CAEA,MAAM,UAAoF;EAExF,MAAM,SAAS,SADL,oBACc,CAAC;EACzB,OAAO,IAAI,eAAsB,KAAKD,aAAa,CACjD,GAAG,KAAKC,SACR,IAAI,gBAAgB,MAAM,CAC5B,CAAC;CACH;CAEA,KAAK,MAAqD;EACxD,OAAO,IAAI,eAAsB,KAAKD,aAAa,CAAC,GAAG,KAAKC,SAAS,IAAI,eAAe,IAAI,CAAC,CAAC;CAChG;CAEA,MAAM,GAAkC;EACtC,OAAO,IAAI,eAAsB,KAAKD,aAAa,CAAC,GAAG,KAAKC,SAAS,IAAI,gBAAgB,CAAC,CAAC,CAAC;CAC9F;CAEA,QAA0B;EACxB,OAAO,IAAI,iBAAiB,KAAKD,aAAa,KAAKC,OAAO;CAC5D;AACF;;;;;;;;;;;AAYA,IAAa,kBAAb,MAAa,gBAAwC;CACnD;CACA;CAEA,YAAY,YAAoB,SAAyC;EACvE,IAAI,QAAQ,WAAW,GACrB,MAAM,IAAI,MAAM,8CAA8C;EAEhE,KAAKD,cAAc;EACnB,KAAKE,WAAW;CAClB;CAEA,MAAM,UAAqF;EAEzF,MAAM,SAAS,SADL,oBACc,CAAC;EACzB,OAAO,IAAI,gBAAuB,KAAKF,aAAa,CAAC,GAAG,KAAKE,UAAU,MAAM,CAAC;CAChF;CAEA,iBACE,WACA,OAAoF,CAAC,GAC5D;EACzB,MAAM,SAAS,YAAY,KAAKA,QAAQ;EAGxC,MAAM,SAAS,qBADD,UADJ,oBACc,CACgB,CAAC;EACzC,OAAO,IAAI,wBACT,KAAKF,aACL,QACA,QACA,KAAK,UAAU,OACf,KAAA,GACA,KAAK,kBAAkB,OACzB;CACF;AACF;AAgCA,IAAM,wBAAN,MAAwF;CACtF;CAEA,YAAY,MAAc;EACxB,KAAKG,QAAQ;CACf;CAEA,YAAmC;EACjC,OAAO,IAAI,eAAsB,KAAKA,OAAO,CAAC,CAAC;CACjD;CAEA,UAAU,UAAwD;EAChE,OAAO,IAAI,iBAAiB,KAAKA,OAAO,QAAQ;CAClD;CAEA,MAAM,UAAqF;EAEzF,MAAM,SAAS,SADL,oBACc,CAAC;EACzB,OAAO,IAAI,gBAAuB,KAAKA,OAAO,CAAC,MAAM,CAAC;CACxD;AACF;;;;;;;;AASA,SAAgB,WAAmC,MAAwC;CACzF,OAAO,IAAI,sBAA6B,IAAI;AAC9C"}