@puzzle-ui/storage-mongodb 0.0.0-stage → 0.5.1

package/README.md

@@ -1,3 +1,46 @@
-# Temporary Holding Version
+# @puzzle-ui/storage-mongodb
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A MongoDB implementation of the vendor-neutral contracts from `@puzzle-ui/storage`. It provides CRUD, shared query operators, conditional writes, cursor pagination, unique and TTL indexes, and versioned migrations. MongoDB's multi-document transactions and atomic batches are opt-in.
+
+**Documentation: [puzzle-ui.com/docs/storage](https://puzzle-ui.com/docs/storage#mongodb-adapter)**
+
+## Install
+
+```sh
+npm install @puzzle-ui/storage @puzzle-ui/storage-mongodb
+# or: bun add @puzzle-ui/storage @puzzle-ui/storage-mongodb
+```
+
+## Use
+
+```ts
+import { MongoClient } from "mongodb";
+import { MongoStorageAdapter } from "@puzzle-ui/storage-mongodb";
+
+const client = new MongoClient(process.env.MONGODB_URI!);
+await client.connect();
+const storage = new MongoStorageAdapter({
+  database: client.db("app"),
+  client,
+  transactionsEnabled: true,
+});
+
+await storage.registerCollection({
+  name: "sessions",
+  indexes: [{ name: "by-user", fields: ["userId"] }],
+});
+```
+
+Use a replica set or sharded deployment for multi-document transactions. Pass the client and set `transactionsEnabled: true` to opt in; otherwise `atomicBatch` is not available. The default collection prefix is `puzzle_`; set `collectionPrefix` to change it. A `StorageIndex` with `expireAfterSeconds` creates a MongoDB TTL index; TTL deletion is asynchronous, so enforce security-sensitive expiry in application logic as well. Close the client during application shutdown.
+
+`MongoStorageMigrationAdapter` stores versioned migration status and a shared migration lock in prefixed collections. See the [storage guide](https://puzzle-ui.com/docs/storage) for adapter guarantees, index behavior, migration options, and custom adapter testing.
+
+## Development
+
+```sh
+bun run build
+bun run typecheck
+bun run test
+```
+
+The test script requires Docker and Docker Compose; it starts a MongoDB replica set for adapter tests.

package/dist/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sjoerd van Den Berg
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,5 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_mongodb_adapter = require("./mongodb.adapter.cjs");
+const require_mongodb_migrations = require("./mongodb.migrations.cjs");
+exports.MongoStorageAdapter = require_mongodb_adapter.MongoStorageAdapter;
+exports.MongoStorageMigrationAdapter = require_mongodb_migrations.MongoStorageMigrationAdapter;

package/dist/index.d.cts

@@ -0,0 +1,4 @@
+import { MongoStorageAdapter } from "./mongodb.adapter.cjs";
+import { MongoStorageMigrationAdapter } from "./mongodb.migrations.cjs";
+import { MongoStorageAdapterOptions, MongoStorageMigrationOptions } from "./mongodb.types.cjs";
+export { MongoStorageAdapter, type MongoStorageAdapterOptions, MongoStorageMigrationAdapter, type MongoStorageMigrationOptions };

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import { MongoStorageAdapter } from "./mongodb.adapter.js";
+import { MongoStorageMigrationAdapter } from "./mongodb.migrations.js";
+import { MongoStorageAdapterOptions, MongoStorageMigrationOptions } from "./mongodb.types.js";
+export { MongoStorageAdapter, type MongoStorageAdapterOptions, MongoStorageMigrationAdapter, type MongoStorageMigrationOptions };

package/dist/index.js

@@ -0,0 +1,3 @@
+import { MongoStorageAdapter } from "./mongodb.adapter.js";
+import { MongoStorageMigrationAdapter } from "./mongodb.migrations.js";
+export { MongoStorageAdapter, MongoStorageMigrationAdapter };

package/dist/mongodb.adapter.cjs

@@ -0,0 +1,320 @@
+require("mongodb");
+let _puzzle_ui_storage = require("@puzzle-ui/storage");
+// src/mongodb.adapter.ts
+const isDuplicateError = (error) => typeof error === "object" && error !== null && "code" in error && error.code === 11e3;
+const mapMongoError = (error) => {
+	if (isDuplicateError(error)) throw new _puzzle_ui_storage.StorageDuplicateError("mongodb_unique_constraint");
+	throw error;
+};
+const toMongoField = (field) => field === "id" ? "_id" : field;
+const encodeCursor = (payload) => ({ value: Buffer.from(JSON.stringify(payload)).toString("base64url") });
+const decodeCursor = (cursor) => {
+	try {
+		return JSON.parse(Buffer.from(cursor.value, "base64url").toString("utf8"));
+	} catch {
+		throw new _puzzle_ui_storage.StorageValidationError("Invalid MongoDB cursor.");
+	}
+};
+const toRecord = (document) => {
+	if (!document) return null;
+	const { _id, ...data } = document;
+	return {
+		...data,
+		id: String(_id)
+	};
+};
+const toDocument = (record) => {
+	const { id, createdAt, updatedAt, revision, ...data } = record;
+	const now = /* @__PURE__ */ new Date();
+	return {
+		...data,
+		_id: id,
+		createdAt: createdAt ?? now,
+		updatedAt: updatedAt ?? now,
+		revision: revision ?? 1
+	};
+};
+const toMongoWhere = (where) => {
+	if (!where) return {};
+	const result = [];
+	for (const [field, comparison] of Object.entries(where)) {
+		if (field === "and" || field === "or") {
+			const nested = comparison.map((item) => toMongoWhere(item));
+			result.push({ [field === "and" ? "$and" : "$or"]: nested });
+			continue;
+		}
+		const value = comparison;
+		if (typeof value !== "object" || value === null || !("operator" in value) || typeof value.operator !== "string" || !("value" in value)) throw new _puzzle_ui_storage.StorageValidationError(`Invalid query comparison for field: ${field}`);
+		const mongoField = toMongoField(field);
+		const operator = {
+			eq: "$eq",
+			ne: "$ne",
+			in: "$in",
+			notIn: "$nin",
+			gt: "$gt",
+			gte: "$gte",
+			lt: "$lt",
+			lte: "$lte",
+			exists: "$exists"
+		}[value.operator];
+		if (!operator) throw new _puzzle_ui_storage.StorageValidationError(`Unsupported query operator: ${value.operator}`);
+		result.push({ [mongoField]: { [operator]: value.value } });
+	}
+	if (result.length === 0) return {};
+	if (result.length === 1) return result[0];
+	return { $and: result };
+};
+const toMongoSort = (orderBy) => {
+	const sort = {};
+	for (const item of orderBy ?? []) sort[toMongoField(String(item.field))] = item.direction === "asc" ? 1 : -1;
+	if (!("_id" in sort)) sort._id = 1;
+	return sort;
+};
+const toCursorFilter = (orderBy, values) => {
+	const fields = [...orderBy.map((item) => ({
+		field: toMongoField(String(item.field)),
+		direction: item.direction
+	}))];
+	if (!fields.some((item) => item.field === "_id")) fields.push({
+		field: "_id",
+		direction: "asc"
+	});
+	const branches = [];
+	for (let index = 0; index < fields.length; index++) {
+		const prefix = [];
+		for (let previous = 0; previous < index; previous++) prefix.push({ [fields[previous].field]: values[previous] });
+		const field = fields[index];
+		const operator = field.direction === "asc" ? "$gt" : "$lt";
+		branches.push({ $and: [...prefix, { [field.field]: { [operator]: values[index] } }] });
+	}
+	return { $or: branches };
+};
+const buildCondition = (condition) => {
+	if (!condition) return {};
+	const result = {};
+	if (condition.expectedRevision !== void 0) result.revision = condition.expectedRevision;
+	if (condition.expectedUpdatedAt !== void 0) result.updatedAt = condition.expectedUpdatedAt;
+	return result;
+};
+const cleanChanges = (changes) => {
+	const result = { ...changes };
+	delete result.id;
+	delete result.createdAt;
+	delete result.updatedAt;
+	delete result.revision;
+	return result;
+};
+var MongoStorageAdapter = class {
+	capabilities;
+	database;
+	client;
+	prefix;
+	constructor(options) {
+		this.database = options.database;
+		this.client = options.client;
+		this.prefix = options.collectionPrefix ?? "puzzle_";
+		const transactionsEnabled = options.transactionsEnabled === true && !!options.client;
+		this.capabilities = {
+			transactions: transactionsEnabled,
+			atomicBatch: transactionsEnabled,
+			conditionalWrites: true,
+			uniqueConstraints: true,
+			upsert: true,
+			cursorPagination: true,
+			migrations: true,
+			ttlIndexes: true
+		};
+	}
+	getCapabilities() {
+		const limitations = this.capabilities.transactions ? [] : ["Multi-document transactions are disabled. Configure a replica set or sharded deployment and set transactionsEnabled to true."];
+		return {
+			capabilities: this.capabilities,
+			limitations
+		};
+	}
+	collection(name) {
+		return this.database.collection(`${this.prefix}${name}`);
+	}
+	async registerCollection(definition) {
+		const collectionName = `${this.prefix}${definition.name}`;
+		try {
+			await this.database.createCollection(collectionName);
+		} catch (error) {
+			if (!(typeof error === "object" && error !== null && "code" in error && error.code === 48)) throw error;
+		}
+		const collection = this.database.collection(collectionName);
+		const indexes = (definition.indexes ?? []).map((index) => ({
+			key: Object.fromEntries(index.fields.map((field) => [toMongoField(String(field)), 1])),
+			name: index.name,
+			unique: index.unique ?? false,
+			...index.expireAfterSeconds !== void 0 ? { expireAfterSeconds: index.expireAfterSeconds } : {}
+		}));
+		if (indexes.length > 0) await collection.createIndexes(indexes);
+	}
+	async findById(collection, id) {
+		const document = await this.collection(collection).findOne({ _id: id });
+		return toRecord(document);
+	}
+	async findOne(collection, query) {
+		(0, _puzzle_ui_storage.validateQuery)(query);
+		const document = await this.collection(collection).findOne(toMongoWhere(query.where), {
+			sort: toMongoSort(query.orderBy),
+			...query.offset !== void 0 ? { skip: query.offset } : {}
+		});
+		return toRecord(document);
+	}
+	async findMany(collection, query = {}) {
+		(0, _puzzle_ui_storage.validateQuery)(query);
+		return (await this.collection(collection).find(toMongoWhere(query.where)).sort(toMongoSort(query.orderBy)).skip(query.offset ?? 0).limit(query.limit ?? 0).toArray()).map((document) => toRecord(document));
+	}
+	async findPage(collection, query) {
+		if (!Number.isInteger(query.first) || query.first < 1) throw new _puzzle_ui_storage.StorageValidationError("Cursor page size must be a positive integer.");
+		const orderBy = query.orderBy ?? [{
+			field: "id",
+			direction: "asc"
+		}];
+		let filter = toMongoWhere(query.where);
+		if (query.after) {
+			const payload = decodeCursor(query.after);
+			const cursorFilter = toCursorFilter(orderBy, payload.values);
+			filter = Object.keys(filter).length ? { $and: [filter, cursorFilter] } : cursorFilter;
+		}
+		const sort = toMongoSort(orderBy);
+		const documents = await this.collection(collection).find(filter).sort(sort).limit(query.first + 1).toArray();
+		const hasNextPage = documents.length > query.first;
+		const items = documents.slice(0, query.first);
+		const last = items.at(-1);
+		const cursorFields = [...orderBy.map((item) => toMongoField(String(item.field)))];
+		if (!cursorFields.includes("_id")) cursorFields.push("_id");
+		const nextCursor = hasNextPage && last ? encodeCursor({ values: cursorFields.map((field) => field === "_id" ? last._id : last[field]) }) : null;
+		return {
+			items: items.map((item) => toRecord(item)),
+			hasNextPage,
+			nextCursor
+		};
+	}
+	async insert(collection, record) {
+		const document = toDocument(record);
+		try {
+			await this.collection(collection).insertOne(document);
+			return toRecord(document);
+		} catch (error) {
+			return mapMongoError(error);
+		}
+	}
+	async upsert(collection, query, record) {
+		(0, _puzzle_ui_storage.validateQuery)(query);
+		const existing = await this.findOne(collection, query);
+		if (existing) return await this.update(collection, existing.id, record) ?? existing;
+		return this.insert(collection, record);
+	}
+	async update(collection, id, changes, condition) {
+		const target = this.collection(collection);
+		const filter = {
+			_id: id,
+			...buildCondition(condition)
+		};
+		const update = {
+			$set: {
+				...cleanChanges(changes),
+				updatedAt: /* @__PURE__ */ new Date()
+			},
+			$inc: { revision: 1 }
+		};
+		if ((await target.updateOne(filter, update)).matchedCount === 0) {
+			if (condition && await target.findOne({ _id: id })) throw new _puzzle_ui_storage.StorageConflictError();
+			return null;
+		}
+		return toRecord(await target.findOne({ _id: id }));
+	}
+	async updateMany(collection, query, changes) {
+		(0, _puzzle_ui_storage.validateQuery)(query);
+		return (await this.collection(collection).updateMany(toMongoWhere(query.where), {
+			$set: {
+				...cleanChanges(changes),
+				updatedAt: /* @__PURE__ */ new Date()
+			},
+			$inc: { revision: 1 }
+		})).modifiedCount;
+	}
+	async delete(collection, id, condition) {
+		const target = this.collection(collection);
+		if ((await target.deleteOne({
+			_id: id,
+			...buildCondition(condition)
+		})).deletedCount > 0) return true;
+		if (condition && await target.findOne({ _id: id })) throw new _puzzle_ui_storage.StorageConflictError();
+		return false;
+	}
+	async deleteMany(collection, query) {
+		(0, _puzzle_ui_storage.validateQuery)(query);
+		return (await this.collection(collection).deleteMany(toMongoWhere(query.where))).deletedCount;
+	}
+	async exists(collection, query) {
+		(0, _puzzle_ui_storage.validateQuery)(query);
+		return await this.collection(collection).findOne(toMongoWhere(query.where), { projection: { _id: 1 } }) !== null;
+	}
+	async count(collection, query = {}) {
+		(0, _puzzle_ui_storage.validateQuery)(query);
+		return this.collection(collection).countDocuments(toMongoWhere(query.where));
+	}
+	async atomicBatch(operations) {
+		if (!this.capabilities.atomicBatch || !this.client) throw new _puzzle_ui_storage.StorageAtomicityError("MongoDB atomicBatch requires an explicitly enabled transaction-capable deployment.");
+		const session = this.client.startSession();
+		const results = [];
+		try {
+			await session.withTransaction(async () => {
+				results.length = 0;
+				for (const operation of operations) {
+					const target = this.collection(operation.collection);
+					if (operation.type === "insert") {
+						const document = toDocument(operation.record);
+						await target.insertOne(document, { session });
+						results.push({
+							type: "insert",
+							record: toRecord(document)
+						});
+						continue;
+					}
+					if (operation.type === "update") {
+						if ((await target.updateOne({
+							_id: operation.id,
+							...buildCondition(operation.condition)
+						}, {
+							$set: {
+								...cleanChanges(operation.changes),
+								updatedAt: /* @__PURE__ */ new Date()
+							},
+							$inc: { revision: 1 }
+						}, { session })).matchedCount === 0 && operation.condition) throw new _puzzle_ui_storage.StorageConflictError();
+						const updated = await target.findOne({ _id: operation.id }, { session });
+						results.push({
+							type: "update",
+							record: toRecord(updated)
+						});
+						continue;
+					}
+					const result = await target.deleteOne({
+						_id: operation.id,
+						...buildCondition(operation.condition)
+					}, { session });
+					if (result.deletedCount === 0 && operation.condition && await target.findOne({ _id: operation.id }, { session })) throw new _puzzle_ui_storage.StorageConflictError();
+					results.push({
+						type: "delete",
+						deleted: result.deletedCount > 0
+					});
+				}
+			});
+			return { results };
+		} catch (error) {
+			if (error instanceof _puzzle_ui_storage.StorageConflictError || error instanceof _puzzle_ui_storage.StorageAtomicityError) throw error;
+			if (isDuplicateError(error)) throw new _puzzle_ui_storage.StorageDuplicateError("mongodb_unique_constraint");
+			throw error;
+		} finally {
+			await session.endSession();
+		}
+	}
+};
+exports.MongoStorageAdapter = MongoStorageAdapter;
+
+//# sourceMappingURL=mongodb.adapter.cjs.map

package/dist/mongodb.adapter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongodb.adapter.cjs","names":["StorageDuplicateError","StorageValidationError","StorageConflictError","StorageAtomicityError"],"sources":["../src/mongodb.adapter.ts"],"sourcesContent":["import {\n  type Document,\n  type Filter,\n  type MongoServerError,\n  type Sort,\n  type UpdateFilter,\n  type WithId,\n} from \"mongodb\";\n\nimport {\n  StorageAtomicityError,\n  StorageConflictError,\n  StorageDuplicateError,\n  StorageValidationError,\n  type StorageAdapter,\n  type StorageBatchOperation,\n  type StorageBatchResult,\n  type StorageCollection,\n  type StorageCollectionName,\n  type StorageCondition,\n  type StorageCursor,\n  type StorageCursorQuery,\n  type StoragePage,\n  type StorageQuery,\n  type StorageRecord,\n  type StorageUpdate,\n  type StorageWhere,\n  type StorageCapabilities,\n  type StorageCapabilityReport,\n  validateQuery,\n  type StorageInsert,\n} from \"@puzzle-ui/storage\";\n\nimport type { MongoStorageAdapterOptions } from \"./mongodb.types\";\n\ntype MongoRecord = Document & {\n  _id: string;\n  createdAt: Date;\n  updatedAt: Date;\n  revision: number;\n};\n\ntype CursorPayload = {\n  readonly values: readonly unknown[];\n};\n\nconst isDuplicateError = (error: unknown): error is MongoServerError =>\n  typeof error === \"object\" &&\n  error !== null &&\n  \"code\" in error &&\n  (error as MongoServerError).code === 11000;\n\nconst mapMongoError = (error: unknown): never => {\n  if (isDuplicateError(error)) {\n    throw new StorageDuplicateError(\"mongodb_unique_constraint\");\n  }\n\n  throw error;\n};\n\nconst toMongoField = (field: string) => (field === \"id\" ? \"_id\" : field);\n\nconst toMongoValue = (value: unknown) =>\n  value instanceof Date ? value : value;\n\nconst encodeCursor = (payload: CursorPayload): StorageCursor => ({\n  value: Buffer.from(JSON.stringify(payload)).toString(\"base64url\"),\n});\n\nconst decodeCursor = (cursor: StorageCursor): CursorPayload => {\n  try {\n    return JSON.parse(\n      Buffer.from(cursor.value, \"base64url\").toString(\"utf8\"),\n    ) as CursorPayload;\n  } catch {\n    throw new StorageValidationError(\"Invalid MongoDB cursor.\");\n  }\n};\n\nconst toRecord = <T extends StorageRecord>(\n  document: WithId<MongoRecord> | null,\n): T | null => {\n  if (!document) return null;\n\n  const { _id, ...data } = document;\n\n  return {\n    ...data,\n    id: String(_id),\n  } as T;\n};\n\nconst toDocument = <T extends StorageRecord>(\n  record: Partial<T> & { id: string },\n): MongoRecord => {\n  const { id, createdAt, updatedAt, revision, ...data } =\n    record as StorageRecord & Document;\n\n  const now = new Date();\n\n  return {\n    ...data,\n    _id: id,\n    createdAt: createdAt ?? now,\n    updatedAt: updatedAt ?? now,\n    revision: revision ?? 1,\n  };\n};\n\nconst toMongoWhere = <T extends object>(\n  where?: StorageWhere<T>,\n): Filter<MongoRecord> => {\n  if (!where) return {};\n\n  const result: Filter<MongoRecord>[] = [];\n\n  for (const [field, comparison] of Object.entries(where)) {\n    if (field === \"and\" || field === \"or\") {\n      const nested = (comparison as readonly StorageWhere<T>[]).map((item) =>\n        toMongoWhere(item),\n      );\n\n      result.push({\n        [field === \"and\" ? \"$and\" : \"$or\"]: nested,\n      });\n\n      continue;\n    }\n\n    const value: unknown = comparison;\n\n    if (\n      typeof value !== \"object\" ||\n      value === null ||\n      !(\"operator\" in value) ||\n      typeof value.operator !== \"string\" ||\n      !(\"value\" in value)\n    ) {\n      throw new StorageValidationError(\n        `Invalid query comparison for field: ${field}`,\n      );\n    }\n\n    const mongoField = toMongoField(field);\n\n    const operators: Record<string, string> = {\n      eq: \"$eq\",\n      ne: \"$ne\",\n      in: \"$in\",\n      notIn: \"$nin\",\n      gt: \"$gt\",\n      gte: \"$gte\",\n      lt: \"$lt\",\n      lte: \"$lte\",\n      exists: \"$exists\",\n    };\n\n    const operator = operators[value.operator];\n\n    if (!operator) {\n      throw new StorageValidationError(\n        `Unsupported query operator: ${value.operator}`,\n      );\n    }\n\n    result.push({\n      [mongoField]: {\n        [operator]: value.value,\n      },\n    });\n  }\n\n  if (result.length === 0) return {};\n  if (result.length === 1) return result[0]!;\n\n  return { $and: result };\n};\n\nconst toMongoSort = <T extends StorageRecord>(\n  orderBy?: StorageQuery<T>[\"orderBy\"],\n): Sort => {\n  const sort: Record<string, 1 | -1> = {};\n\n  for (const item of orderBy ?? []) {\n    sort[toMongoField(String(item.field))] = item.direction === \"asc\" ? 1 : -1;\n  }\n\n  if (!(\"_id\" in sort)) {\n    sort._id = 1;\n  }\n\n  return sort;\n};\n\nconst toCursorFilter = <T extends StorageRecord>(\n  orderBy: NonNullable<StorageQuery<T>[\"orderBy\"]>,\n  values: readonly unknown[],\n): Filter<MongoRecord> => {\n  const fields = [\n    ...orderBy.map((item) => ({\n      field: toMongoField(String(item.field)),\n      direction: item.direction,\n    })),\n  ];\n\n  if (!fields.some((item) => item.field === \"_id\")) {\n    fields.push({ field: \"_id\", direction: \"asc\" });\n  }\n\n  const branches: Filter<MongoRecord>[] = [];\n\n  for (let index = 0; index < fields.length; index++) {\n    const prefix: Filter<MongoRecord>[] = [];\n\n    for (let previous = 0; previous < index; previous++) {\n      prefix.push({\n        [fields[previous]!.field]: values[previous],\n      });\n    }\n\n    const field = fields[index]!;\n    const operator = field.direction === \"asc\" ? \"$gt\" : \"$lt\";\n\n    branches.push({\n      $and: [\n        ...prefix,\n        {\n          [field.field]: {\n            [operator]: values[index],\n          },\n        },\n      ],\n    });\n  }\n\n  return { $or: branches };\n};\n\nconst buildCondition = (condition?: StorageCondition): Document => {\n  if (!condition) return {};\n\n  const result: Document = {};\n\n  if (condition.expectedRevision !== undefined) {\n    result.revision = condition.expectedRevision;\n  }\n\n  if (condition.expectedUpdatedAt !== undefined) {\n    result.updatedAt = condition.expectedUpdatedAt;\n  }\n\n  return result;\n};\n\nconst cleanChanges = <T extends StorageRecord>(\n  changes: StorageUpdate<T>,\n): Document => {\n  const result = { ...changes } as Document;\n\n  delete result.id;\n  delete result.createdAt;\n  delete result.updatedAt;\n  delete result.revision;\n\n  return result;\n};\n\nexport class MongoStorageAdapter implements StorageAdapter {\n  readonly capabilities: StorageCapabilities;\n\n  private readonly database: MongoStorageAdapterOptions[\"database\"];\n  private readonly client: MongoStorageAdapterOptions[\"client\"];\n  private readonly prefix: string;\n\n  constructor(options: MongoStorageAdapterOptions) {\n    this.database = options.database;\n    this.client = options.client;\n    this.prefix = options.collectionPrefix ?? \"puzzle_\";\n\n    const transactionsEnabled =\n      options.transactionsEnabled === true && !!options.client;\n\n    this.capabilities = {\n      transactions: transactionsEnabled,\n      atomicBatch: transactionsEnabled,\n      conditionalWrites: true,\n      uniqueConstraints: true,\n      upsert: true,\n      cursorPagination: true,\n      migrations: true,\n      ttlIndexes: true,\n    };\n  }\n\n  getCapabilities(): StorageCapabilityReport {\n    const limitations = this.capabilities.transactions\n      ? []\n      : [\n          \"Multi-document transactions are disabled. Configure a replica set or sharded deployment and set transactionsEnabled to true.\",\n        ];\n\n    return {\n      capabilities: this.capabilities,\n      limitations,\n    };\n  }\n\n  private collection<T extends StorageRecord>(name: StorageCollectionName) {\n    return this.database.collection<MongoRecord>(`${this.prefix}${name}`);\n  }\n\n  async registerCollection<T extends StorageRecord>(\n    definition: StorageCollection<T>,\n  ): Promise<void> {\n    const collectionName = `${this.prefix}${definition.name}`;\n\n    try {\n      await this.database.createCollection(collectionName);\n    } catch (error) {\n      if (\n        !(\n          typeof error === \"object\" &&\n          error !== null &&\n          \"code\" in error &&\n          (error as { code: number }).code === 48\n        )\n      ) {\n        throw error;\n      }\n    }\n\n    const collection = this.database.collection(collectionName);\n\n    const indexes = (definition.indexes ?? []).map((index) => ({\n      key: Object.fromEntries(\n        index.fields.map((field) => [toMongoField(String(field)), 1]),\n      ),\n      name: index.name,\n      unique: index.unique ?? false,\n      ...(index.expireAfterSeconds !== undefined\n        ? { expireAfterSeconds: index.expireAfterSeconds }\n        : {}),\n    }));\n\n    if (indexes.length > 0) {\n      await collection.createIndexes(indexes);\n    }\n  }\n\n  async findById<T extends StorageRecord>(\n    collection: StorageCollectionName,\n    id: string,\n  ): Promise<T | null> {\n    const document = await this.collection(collection).findOne({\n      _id: id,\n    });\n\n    return toRecord<T>(document);\n  }\n\n  async findOne<T extends StorageRecord>(\n    collection: StorageCollectionName,\n    query: StorageQuery<T>,\n  ): Promise<T | null> {\n    validateQuery(query);\n\n    const document = await this.collection(collection).findOne(\n      toMongoWhere(query.where),\n      {\n        sort: toMongoSort(query.orderBy),\n        ...(query.offset !== undefined ? { skip: query.offset } : {}),\n      },\n    );\n\n    return toRecord<T>(document);\n  }\n\n  async findMany<T extends StorageRecord>(\n    collection: StorageCollectionName,\n    query: StorageQuery<T> = {},\n  ): Promise<readonly T[]> {\n    validateQuery(query);\n\n    const documents = await this.collection(collection)\n      .find(toMongoWhere(query.where))\n      .sort(toMongoSort(query.orderBy))\n      .skip(query.offset ?? 0)\n      .limit(query.limit ?? 0)\n      .toArray();\n\n    return documents.map((document) => toRecord<T>(document) as T);\n  }\n\n  async findPage<T extends StorageRecord>(\n    collection: StorageCollectionName,\n    query: StorageCursorQuery<T>,\n  ): Promise<StoragePage<T>> {\n    if (!Number.isInteger(query.first) || query.first < 1) {\n      throw new StorageValidationError(\n        \"Cursor page size must be a positive integer.\",\n      );\n    }\n\n    const orderBy = query.orderBy ?? [\n      { field: \"id\" as keyof T & string, direction: \"asc\" as const },\n    ];\n\n    let filter = toMongoWhere(query.where);\n\n    if (query.after) {\n      const payload = decodeCursor(query.after);\n\n      const cursorFilter = toCursorFilter(orderBy, payload.values);\n\n      filter = Object.keys(filter).length\n        ? { $and: [filter, cursorFilter] }\n        : cursorFilter;\n    }\n\n    const sort = toMongoSort(orderBy);\n\n    const documents = await this.collection(collection)\n      .find(filter)\n      .sort(sort)\n      .limit(query.first + 1)\n      .toArray();\n\n    const hasNextPage = documents.length > query.first;\n    const items = documents.slice(0, query.first);\n    const last = items.at(-1);\n\n    const cursorFields = [\n      ...orderBy.map((item) => toMongoField(String(item.field))),\n    ];\n\n    if (!cursorFields.includes(\"_id\")) cursorFields.push(\"_id\");\n\n    const nextCursor =\n      hasNextPage && last\n        ? encodeCursor({\n            values: cursorFields.map((field) =>\n              field === \"_id\" ? last._id : last[field],\n            ),\n          })\n        : null;\n\n    return {\n      items: items.map((item) => toRecord<T>(item) as T),\n      hasNextPage,\n      nextCursor,\n    };\n  }\n\n  async insert<T extends StorageRecord>(\n    collection: StorageCollectionName,\n    record: Parameters<StorageAdapter[\"insert\"]>[1],\n  ): Promise<T> {\n    const document = toDocument(record as StorageRecord & { id: string });\n\n    try {\n      await this.collection(collection).insertOne(document);\n      return toRecord<T>(document as WithId<MongoRecord>) as T;\n    } catch (error) {\n      return mapMongoError(error);\n    }\n  }\n\n  async upsert<T extends StorageRecord>(\n    collection: StorageCollectionName,\n    query: StorageQuery<T>,\n    record: StorageInsert<T>,\n  ): Promise<T> {\n    validateQuery(query);\n\n    const existing = await this.findOne<T>(collection, query);\n\n    if (existing) {\n      const updated = await this.update<T>(\n        collection,\n        existing.id,\n        record as StorageUpdate<T>,\n      );\n\n      return updated ?? existing;\n    }\n\n    return this.insert<T>(collection, record);\n  }\n\n  async update<T extends StorageRecord>(\n    collection: StorageCollectionName,\n    id: string,\n    changes: StorageUpdate<T>,\n    condition?: StorageCondition,\n  ): Promise<T | null> {\n    const target = this.collection(collection);\n\n    const filter = {\n      _id: id,\n      ...buildCondition(condition),\n    };\n\n    const update: UpdateFilter<MongoRecord> = {\n      $set: {\n        ...cleanChanges(changes),\n        updatedAt: new Date(),\n      },\n      $inc: { revision: 1 },\n    };\n\n    const result = await target.updateOne(filter, update);\n\n    if (result.matchedCount === 0) {\n      if (condition && (await target.findOne({ _id: id }))) {\n        throw new StorageConflictError();\n      }\n\n      return null;\n    }\n\n    return toRecord<T>(await target.findOne({ _id: id }));\n  }\n\n  async updateMany<T extends StorageRecord>(\n    collection: StorageCollectionName,\n    query: StorageQuery<T>,\n    changes: StorageUpdate<T>,\n  ): Promise<number> {\n    validateQuery(query);\n\n    const result = await this.collection(collection).updateMany(\n      toMongoWhere(query.where),\n      {\n        $set: {\n          ...cleanChanges(changes),\n          updatedAt: new Date(),\n        },\n        $inc: { revision: 1 },\n      },\n    );\n\n    return result.modifiedCount;\n  }\n\n  async delete<T extends StorageRecord>(\n    collection: StorageCollectionName,\n    id: string,\n    condition?: StorageCondition,\n  ): Promise<boolean> {\n    const target = this.collection(collection);\n\n    const result = await target.deleteOne({\n      _id: id,\n      ...buildCondition(condition),\n    });\n\n    if (result.deletedCount > 0) return true;\n\n    if (condition && (await target.findOne({ _id: id }))) {\n      throw new StorageConflictError();\n    }\n\n    return false;\n  }\n\n  async deleteMany<T extends StorageRecord>(\n    collection: StorageCollectionName,\n    query: StorageQuery<T>,\n  ): Promise<number> {\n    validateQuery(query);\n\n    const result = await this.collection(collection).deleteMany(\n      toMongoWhere(query.where),\n    );\n\n    return result.deletedCount;\n  }\n\n  async exists<T extends StorageRecord>(\n    collection: StorageCollectionName,\n    query: StorageQuery<T>,\n  ): Promise<boolean> {\n    validateQuery(query);\n\n    return (\n      (await this.collection(collection).findOne(toMongoWhere(query.where), {\n        projection: { _id: 1 },\n      })) !== null\n    );\n  }\n\n  async count<T extends StorageRecord>(\n    collection: StorageCollectionName,\n    query: StorageQuery<T> = {},\n  ): Promise<number> {\n    validateQuery(query);\n\n    return this.collection(collection).countDocuments(\n      toMongoWhere(query.where),\n    );\n  }\n\n  async atomicBatch<T extends StorageRecord>(\n    operations: readonly StorageBatchOperation<T>[],\n  ): Promise<StorageBatchResult<T>> {\n    if (!this.capabilities.atomicBatch || !this.client) {\n      throw new StorageAtomicityError(\n        \"MongoDB atomicBatch requires an explicitly enabled transaction-capable deployment.\",\n      );\n    }\n\n    const session = this.client.startSession();\n    const results: StorageBatchResult<T>[\"results\"][number][] = [];\n\n    try {\n      await session.withTransaction(async () => {\n        results.length = 0;\n\n        for (const operation of operations) {\n          const target = this.collection(operation.collection);\n\n          if (operation.type === \"insert\") {\n            const document = toDocument(\n              operation.record as StorageRecord & { id: string },\n            );\n\n            await target.insertOne(document, { session });\n\n            results.push({\n              type: \"insert\",\n              record: toRecord<T>(document as WithId<MongoRecord>) as T,\n            });\n\n            continue;\n          }\n\n          if (operation.type === \"update\") {\n            const result = await target.updateOne(\n              {\n                _id: operation.id,\n                ...buildCondition(operation.condition),\n              },\n              {\n                $set: {\n                  ...cleanChanges(operation.changes),\n                  updatedAt: new Date(),\n                },\n                $inc: { revision: 1 },\n              },\n              { session },\n            );\n\n            if (result.matchedCount === 0 && operation.condition) {\n              throw new StorageConflictError();\n            }\n\n            const updated = await target.findOne(\n              { _id: operation.id },\n              { session },\n            );\n\n            results.push({\n              type: \"update\",\n              record: toRecord<T>(updated),\n            });\n\n            continue;\n          }\n\n          const result = await target.deleteOne(\n            {\n              _id: operation.id,\n              ...buildCondition(operation.condition),\n            },\n            { session },\n          );\n\n          if (\n            result.deletedCount === 0 &&\n            operation.condition &&\n            (await target.findOne({ _id: operation.id }, { session }))\n          ) {\n            throw new StorageConflictError();\n          }\n\n          results.push({\n            type: \"delete\",\n            deleted: result.deletedCount > 0,\n          });\n        }\n      });\n\n      return { results };\n    } catch (error) {\n      if (\n        error instanceof StorageConflictError ||\n        error instanceof StorageAtomicityError\n      ) {\n        throw error;\n      }\n\n      if (isDuplicateError(error)) {\n        throw new StorageDuplicateError(\"mongodb_unique_constraint\");\n      }\n\n      throw error;\n    } finally {\n      await session.endSession();\n    }\n  }\n}\n"],"mappings":";;;AA8CA,MAAM,oBAAoB,UACxB,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACT,MAA2B,SAAS;AAEvC,MAAM,iBAAiB,UAA0B;CAC/C,IAAI,iBAAiB,KAAK,GACxB,MAAM,IAAIA,mBAAAA,sBAAsB,2BAA2B;CAG7D,MAAM;AACR;AAEA,MAAM,gBAAgB,UAAmB,UAAU,OAAO,QAAQ;AAKlE,MAAM,gBAAgB,aAA2C,EAC/D,OAAO,OAAO,KAAK,KAAK,UAAU,OAAO,CAAC,CAAC,CAAC,SAAS,WAAW,EAClE;AAEA,MAAM,gBAAgB,WAAyC;CAC7D,IAAI;EACF,OAAO,KAAK,MACV,OAAO,KAAK,OAAO,OAAO,WAAW,CAAC,CAAC,SAAS,MAAM,CACxD;CACF,QAAQ;EACN,MAAM,IAAIC,mBAAAA,uBAAuB,yBAAyB;CAC5D;AACF;AAEA,MAAM,YACJ,aACa;CACb,IAAI,CAAC,UAAU,OAAO;CAEtB,MAAM,EAAE,KAAK,GAAG,SAAS;CAEzB,OAAO;EACL,GAAG;EACH,IAAI,OAAO,GAAG;CAChB;AACF;AAEA,MAAM,cACJ,WACgB;CAChB,MAAM,EAAE,IAAI,WAAW,WAAW,UAAU,GAAG,SAC7C;CAEF,MAAM,sBAAM,IAAI,KAAK;CAErB,OAAO;EACL,GAAG;EACH,KAAK;EACL,WAAW,aAAa;EACxB,WAAW,aAAa;EACxB,UAAU,YAAY;CACxB;AACF;AAEA,MAAM,gBACJ,UACwB;CACxB,IAAI,CAAC,OAAO,OAAO,CAAC;CAEpB,MAAM,SAAgC,CAAC;CAEvC,KAAK,MAAM,CAAC,OAAO,eAAe,OAAO,QAAQ,KAAK,GAAG;EACvD,IAAI,UAAU,SAAS,UAAU,MAAM;GACrC,MAAM,SAAU,WAA0C,KAAK,SAC7D,aAAa,IAAI,CACnB;GAEA,OAAO,KAAK,GACT,UAAU,QAAQ,SAAS,QAAQ,OACtC,CAAC;GAED;EACF;EAEA,MAAM,QAAiB;EAEvB,IACE,OAAO,UAAU,YACjB,UAAU,QACV,EAAE,cAAc,UAChB,OAAO,MAAM,aAAa,YAC1B,EAAE,WAAW,QAEb,MAAM,IAAIA,mBAAAA,uBACR,uCAAuC,OACzC;EAGF,MAAM,aAAa,aAAa,KAAK;EAcrC,MAAM,WAAW;GAXf,IAAI;GACJ,IAAI;GACJ,IAAI;GACJ,OAAO;GACP,IAAI;GACJ,KAAK;GACL,IAAI;GACJ,KAAK;GACL,QAAQ;EAGe,EAAE,MAAM;EAEjC,IAAI,CAAC,UACH,MAAM,IAAIA,mBAAAA,uBACR,+BAA+B,MAAM,UACvC;EAGF,OAAO,KAAK,GACT,aAAa,GACX,WAAW,MAAM,MACpB,EACF,CAAC;CACH;CAEA,IAAI,OAAO,WAAW,GAAG,OAAO,CAAC;CACjC,IAAI,OAAO,WAAW,GAAG,OAAO,OAAO;CAEvC,OAAO,EAAE,MAAM,OAAO;AACxB;AAEA,MAAM,eACJ,YACS;CACT,MAAM,OAA+B,CAAC;CAEtC,KAAK,MAAM,QAAQ,WAAW,CAAC,GAC7B,KAAK,aAAa,OAAO,KAAK,KAAK,CAAC,KAAK,KAAK,cAAc,QAAQ,IAAI;CAG1E,IAAI,EAAE,SAAS,OACb,KAAK,MAAM;CAGb,OAAO;AACT;AAEA,MAAM,kBACJ,SACA,WACwB;CACxB,MAAM,SAAS,CACb,GAAG,QAAQ,KAAK,UAAU;EACxB,OAAO,aAAa,OAAO,KAAK,KAAK,CAAC;EACtC,WAAW,KAAK;CAClB,EAAE,CACJ;CAEA,IAAI,CAAC,OAAO,MAAM,SAAS,KAAK,UAAU,KAAK,GAC7C,OAAO,KAAK;EAAE,OAAO;EAAO,WAAW;CAAM,CAAC;CAGhD,MAAM,WAAkC,CAAC;CAEzC,KAAK,IAAI,QAAQ,GAAG,QAAQ,OAAO,QAAQ,SAAS;EAClD,MAAM,SAAgC,CAAC;EAEvC,KAAK,IAAI,WAAW,GAAG,WAAW,OAAO,YACvC,OAAO,KAAK,GACT,OAAO,SAAS,CAAE,QAAQ,OAAO,UACpC,CAAC;EAGH,MAAM,QAAQ,OAAO;EACrB,MAAM,WAAW,MAAM,cAAc,QAAQ,QAAQ;EAErD,SAAS,KAAK,EACZ,MAAM,CACJ,GAAG,QACH,GACG,MAAM,QAAQ,GACZ,WAAW,OAAO,OACrB,EACF,CACF,EACF,CAAC;CACH;CAEA,OAAO,EAAE,KAAK,SAAS;AACzB;AAEA,MAAM,kBAAkB,cAA2C;CACjE,IAAI,CAAC,WAAW,OAAO,CAAC;CAExB,MAAM,SAAmB,CAAC;CAE1B,IAAI,UAAU,qBAAqB,KAAA,GACjC,OAAO,WAAW,UAAU;CAG9B,IAAI,UAAU,sBAAsB,KAAA,GAClC,OAAO,YAAY,UAAU;CAG/B,OAAO;AACT;AAEA,MAAM,gBACJ,YACa;CACb,MAAM,SAAS,EAAE,GAAG,QAAQ;CAE5B,OAAO,OAAO;CACd,OAAO,OAAO;CACd,OAAO,OAAO;CACd,OAAO,OAAO;CAEd,OAAO;AACT;AAEA,IAAa,sBAAb,MAA2D;CACzD;CAEA;CACA;CACA;CAEA,YAAY,SAAqC;EAC/C,KAAK,WAAW,QAAQ;EACxB,KAAK,SAAS,QAAQ;EACtB,KAAK,SAAS,QAAQ,oBAAoB;EAE1C,MAAM,sBACJ,QAAQ,wBAAwB,QAAQ,CAAC,CAAC,QAAQ;EAEpD,KAAK,eAAe;GAClB,cAAc;GACd,aAAa;GACb,mBAAmB;GACnB,mBAAmB;GACnB,QAAQ;GACR,kBAAkB;GAClB,YAAY;GACZ,YAAY;EACd;CACF;CAEA,kBAA2C;EACzC,MAAM,cAAc,KAAK,aAAa,eAClC,CAAC,IACD,CACE,8HACF;EAEJ,OAAO;GACL,cAAc,KAAK;GACnB;EACF;CACF;CAEA,WAA4C,MAA6B;EACvE,OAAO,KAAK,SAAS,WAAwB,GAAG,KAAK,SAAS,MAAM;CACtE;CAEA,MAAM,mBACJ,YACe;EACf,MAAM,iBAAiB,GAAG,KAAK,SAAS,WAAW;EAEnD,IAAI;GACF,MAAM,KAAK,SAAS,iBAAiB,cAAc;EACrD,SAAS,OAAO;GACd,IACE,EACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACT,MAA2B,SAAS,KAGvC,MAAM;EAEV;EAEA,MAAM,aAAa,KAAK,SAAS,WAAW,cAAc;EAE1D,MAAM,WAAW,WAAW,WAAW,CAAC,EAAA,CAAG,KAAK,WAAW;GACzD,KAAK,OAAO,YACV,MAAM,OAAO,KAAK,UAAU,CAAC,aAAa,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAC9D;GACA,MAAM,MAAM;GACZ,QAAQ,MAAM,UAAU;GACxB,GAAI,MAAM,uBAAuB,KAAA,IAC7B,EAAE,oBAAoB,MAAM,mBAAmB,IAC/C,CAAC;EACP,EAAE;EAEF,IAAI,QAAQ,SAAS,GACnB,MAAM,WAAW,cAAc,OAAO;CAE1C;CAEA,MAAM,SACJ,YACA,IACmB;EACnB,MAAM,WAAW,MAAM,KAAK,WAAW,UAAU,CAAC,CAAC,QAAQ,EACzD,KAAK,GACP,CAAC;EAED,OAAO,SAAY,QAAQ;CAC7B;CAEA,MAAM,QACJ,YACA,OACmB;EACnB,CAAA,GAAA,mBAAA,cAAA,CAAc,KAAK;EAEnB,MAAM,WAAW,MAAM,KAAK,WAAW,UAAU,CAAC,CAAC,QACjD,aAAa,MAAM,KAAK,GACxB;GACE,MAAM,YAAY,MAAM,OAAO;GAC/B,GAAI,MAAM,WAAW,KAAA,IAAY,EAAE,MAAM,MAAM,OAAO,IAAI,CAAC;EAC7D,CACF;EAEA,OAAO,SAAY,QAAQ;CAC7B;CAEA,MAAM,SACJ,YACA,QAAyB,CAAC,GACH;EACvB,CAAA,GAAA,mBAAA,cAAA,CAAc,KAAK;EASnB,QAAO,MAPiB,KAAK,WAAW,UAAU,CAAC,CAChD,KAAK,aAAa,MAAM,KAAK,CAAC,CAAC,CAC/B,KAAK,YAAY,MAAM,OAAO,CAAC,CAAC,CAChC,KAAK,MAAM,UAAU,CAAC,CAAC,CACvB,MAAM,MAAM,SAAS,CAAC,CAAC,CACvB,QAAQ,EAAA,CAEM,KAAK,aAAa,SAAY,QAAQ,CAAM;CAC/D;CAEA,MAAM,SACJ,YACA,OACyB;EACzB,IAAI,CAAC,OAAO,UAAU,MAAM,KAAK,KAAK,MAAM,QAAQ,GAClD,MAAM,IAAIA,mBAAAA,uBACR,8CACF;EAGF,MAAM,UAAU,MAAM,WAAW,CAC/B;GAAE,OAAO;GAA0B,WAAW;EAAe,CAC/D;EAEA,IAAI,SAAS,aAAa,MAAM,KAAK;EAErC,IAAI,MAAM,OAAO;GACf,MAAM,UAAU,aAAa,MAAM,KAAK;GAExC,MAAM,eAAe,eAAe,SAAS,QAAQ,MAAM;GAE3D,SAAS,OAAO,KAAK,MAAM,CAAC,CAAC,SACzB,EAAE,MAAM,CAAC,QAAQ,YAAY,EAAE,IAC/B;EACN;EAEA,MAAM,OAAO,YAAY,OAAO;EAEhC,MAAM,YAAY,MAAM,KAAK,WAAW,UAAU,CAAC,CAChD,KAAK,MAAM,CAAC,CACZ,KAAK,IAAI,CAAC,CACV,MAAM,MAAM,QAAQ,CAAC,CAAC,CACtB,QAAQ;EAEX,MAAM,cAAc,UAAU,SAAS,MAAM;EAC7C,MAAM,QAAQ,UAAU,MAAM,GAAG,MAAM,KAAK;EAC5C,MAAM,OAAO,MAAM,GAAG,EAAE;EAExB,MAAM,eAAe,CACnB,GAAG,QAAQ,KAAK,SAAS,aAAa,OAAO,KAAK,KAAK,CAAC,CAAC,CAC3D;EAEA,IAAI,CAAC,aAAa,SAAS,KAAK,GAAG,aAAa,KAAK,KAAK;EAE1D,MAAM,aACJ,eAAe,OACX,aAAa,EACX,QAAQ,aAAa,KAAK,UACxB,UAAU,QAAQ,KAAK,MAAM,KAAK,MACpC,EACF,CAAC,IACD;EAEN,OAAO;GACL,OAAO,MAAM,KAAK,SAAS,SAAY,IAAI,CAAM;GACjD;GACA;EACF;CACF;CAEA,MAAM,OACJ,YACA,QACY;EACZ,MAAM,WAAW,WAAW,MAAwC;EAEpE,IAAI;GACF,MAAM,KAAK,WAAW,UAAU,CAAC,CAAC,UAAU,QAAQ;GACpD,OAAO,SAAY,QAA+B;EACpD,SAAS,OAAO;GACd,OAAO,cAAc,KAAK;EAC5B;CACF;CAEA,MAAM,OACJ,YACA,OACA,QACY;EACZ,CAAA,GAAA,mBAAA,cAAA,CAAc,KAAK;EAEnB,MAAM,WAAW,MAAM,KAAK,QAAW,YAAY,KAAK;EAExD,IAAI,UAOF,OAAO,MANe,KAAK,OACzB,YACA,SAAS,IACT,MACF,KAEkB;EAGpB,OAAO,KAAK,OAAU,YAAY,MAAM;CAC1C;CAEA,MAAM,OACJ,YACA,IACA,SACA,WACmB;EACnB,MAAM,SAAS,KAAK,WAAW,UAAU;EAEzC,MAAM,SAAS;GACb,KAAK;GACL,GAAG,eAAe,SAAS;EAC7B;EAEA,MAAM,SAAoC;GACxC,MAAM;IACJ,GAAG,aAAa,OAAO;IACvB,2BAAW,IAAI,KAAK;GACtB;GACA,MAAM,EAAE,UAAU,EAAE;EACtB;EAIA,KAAI,MAFiB,OAAO,UAAU,QAAQ,MAAM,EAAA,CAEzC,iBAAiB,GAAG;GAC7B,IAAI,aAAc,MAAM,OAAO,QAAQ,EAAE,KAAK,GAAG,CAAC,GAChD,MAAM,IAAIC,mBAAAA,qBAAqB;GAGjC,OAAO;EACT;EAEA,OAAO,SAAY,MAAM,OAAO,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC;CACtD;CAEA,MAAM,WACJ,YACA,OACA,SACiB;EACjB,CAAA,GAAA,mBAAA,cAAA,CAAc,KAAK;EAanB,QAAO,MAXc,KAAK,WAAW,UAAU,CAAC,CAAC,WAC/C,aAAa,MAAM,KAAK,GACxB;GACE,MAAM;IACJ,GAAG,aAAa,OAAO;IACvB,2BAAW,IAAI,KAAK;GACtB;GACA,MAAM,EAAE,UAAU,EAAE;EACtB,CACF,EAAA,CAEc;CAChB;CAEA,MAAM,OACJ,YACA,IACA,WACkB;EAClB,MAAM,SAAS,KAAK,WAAW,UAAU;EAOzC,KAAI,MALiB,OAAO,UAAU;GACpC,KAAK;GACL,GAAG,eAAe,SAAS;EAC7B,CAAC,EAAA,CAEU,eAAe,GAAG,OAAO;EAEpC,IAAI,aAAc,MAAM,OAAO,QAAQ,EAAE,KAAK,GAAG,CAAC,GAChD,MAAM,IAAIA,mBAAAA,qBAAqB;EAGjC,OAAO;CACT;CAEA,MAAM,WACJ,YACA,OACiB;EACjB,CAAA,GAAA,mBAAA,cAAA,CAAc,KAAK;EAMnB,QAAO,MAJc,KAAK,WAAW,UAAU,CAAC,CAAC,WAC/C,aAAa,MAAM,KAAK,CAC1B,EAAA,CAEc;CAChB;CAEA,MAAM,OACJ,YACA,OACkB;EAClB,CAAA,GAAA,mBAAA,cAAA,CAAc,KAAK;EAEnB,OACG,MAAM,KAAK,WAAW,UAAU,CAAC,CAAC,QAAQ,aAAa,MAAM,KAAK,GAAG,EACpE,YAAY,EAAE,KAAK,EAAE,EACvB,CAAC,MAAO;CAEZ;CAEA,MAAM,MACJ,YACA,QAAyB,CAAC,GACT;EACjB,CAAA,GAAA,mBAAA,cAAA,CAAc,KAAK;EAEnB,OAAO,KAAK,WAAW,UAAU,CAAC,CAAC,eACjC,aAAa,MAAM,KAAK,CAC1B;CACF;CAEA,MAAM,YACJ,YACgC;EAChC,IAAI,CAAC,KAAK,aAAa,eAAe,CAAC,KAAK,QAC1C,MAAM,IAAIC,mBAAAA,sBACR,oFACF;EAGF,MAAM,UAAU,KAAK,OAAO,aAAa;EACzC,MAAM,UAAsD,CAAC;EAE7D,IAAI;GACF,MAAM,QAAQ,gBAAgB,YAAY;IACxC,QAAQ,SAAS;IAEjB,KAAK,MAAM,aAAa,YAAY;KAClC,MAAM,SAAS,KAAK,WAAW,UAAU,UAAU;KAEnD,IAAI,UAAU,SAAS,UAAU;MAC/B,MAAM,WAAW,WACf,UAAU,MACZ;MAEA,MAAM,OAAO,UAAU,UAAU,EAAE,QAAQ,CAAC;MAE5C,QAAQ,KAAK;OACX,MAAM;OACN,QAAQ,SAAY,QAA+B;MACrD,CAAC;MAED;KACF;KAEA,IAAI,UAAU,SAAS,UAAU;MAgB/B,KAAI,MAfiB,OAAO,UAC1B;OACE,KAAK,UAAU;OACf,GAAG,eAAe,UAAU,SAAS;MACvC,GACA;OACE,MAAM;QACJ,GAAG,aAAa,UAAU,OAAO;QACjC,2BAAW,IAAI,KAAK;OACtB;OACA,MAAM,EAAE,UAAU,EAAE;MACtB,GACA,EAAE,QAAQ,CACZ,EAAA,CAEW,iBAAiB,KAAK,UAAU,WACzC,MAAM,IAAID,mBAAAA,qBAAqB;MAGjC,MAAM,UAAU,MAAM,OAAO,QAC3B,EAAE,KAAK,UAAU,GAAG,GACpB,EAAE,QAAQ,CACZ;MAEA,QAAQ,KAAK;OACX,MAAM;OACN,QAAQ,SAAY,OAAO;MAC7B,CAAC;MAED;KACF;KAEA,MAAM,SAAS,MAAM,OAAO,UAC1B;MACE,KAAK,UAAU;MACf,GAAG,eAAe,UAAU,SAAS;KACvC,GACA,EAAE,QAAQ,CACZ;KAEA,IACE,OAAO,iBAAiB,KACxB,UAAU,aACT,MAAM,OAAO,QAAQ,EAAE,KAAK,UAAU,GAAG,GAAG,EAAE,QAAQ,CAAC,GAExD,MAAM,IAAIA,mBAAAA,qBAAqB;KAGjC,QAAQ,KAAK;MACX,MAAM;MACN,SAAS,OAAO,eAAe;KACjC,CAAC;IACH;GACF,CAAC;GAED,OAAO,EAAE,QAAQ;EACnB,SAAS,OAAO;GACd,IACE,iBAAiBA,mBAAAA,wBACjB,iBAAiBC,mBAAAA,uBAEjB,MAAM;GAGR,IAAI,iBAAiB,KAAK,GACxB,MAAM,IAAIH,mBAAAA,sBAAsB,2BAA2B;GAG7D,MAAM;EACR,UAAU;GACR,MAAM,QAAQ,WAAW;EAC3B;CACF;AACF"}

package/dist/mongodb.adapter.d.cts

@@ -0,0 +1,25 @@
+import { MongoStorageAdapterOptions } from "./mongodb.types.cjs";
+import { StorageAdapter, StorageBatchOperation, StorageBatchResult, StorageCapabilities, StorageCapabilityReport, StorageCollection, StorageCollectionName, StorageCondition, StorageCursorQuery, StorageInsert, StoragePage, StorageQuery, StorageRecord, StorageUpdate } from "@puzzle-ui/storage";
+export declare class MongoStorageAdapter implements StorageAdapter {
+  readonly capabilities: StorageCapabilities;
+  private readonly database;
+  private readonly client;
+  private readonly prefix;
+  constructor(options: MongoStorageAdapterOptions);
+  getCapabilities(): StorageCapabilityReport;
+  private collection;
+  registerCollection<T extends StorageRecord>(definition: StorageCollection<T>): Promise<void>;
+  findById<T extends StorageRecord>(collection: StorageCollectionName, id: string): Promise<T | null>;
+  findOne<T extends StorageRecord>(collection: StorageCollectionName, query: StorageQuery<T>): Promise<T | null>;
+  findMany<T extends StorageRecord>(collection: StorageCollectionName, query?: StorageQuery<T>): Promise<readonly T[]>;
+  findPage<T extends StorageRecord>(collection: StorageCollectionName, query: StorageCursorQuery<T>): Promise<StoragePage<T>>;
+  insert<T extends StorageRecord>(collection: StorageCollectionName, record: Parameters<StorageAdapter["insert"]>[1]): Promise<T>;
+  upsert<T extends StorageRecord>(collection: StorageCollectionName, query: StorageQuery<T>, record: StorageInsert<T>): Promise<T>;
+  update<T extends StorageRecord>(collection: StorageCollectionName, id: string, changes: StorageUpdate<T>, condition?: StorageCondition): Promise<T | null>;
+  updateMany<T extends StorageRecord>(collection: StorageCollectionName, query: StorageQuery<T>, changes: StorageUpdate<T>): Promise<number>;
+  delete<T extends StorageRecord>(collection: StorageCollectionName, id: string, condition?: StorageCondition): Promise<boolean>;
+  deleteMany<T extends StorageRecord>(collection: StorageCollectionName, query: StorageQuery<T>): Promise<number>;
+  exists<T extends StorageRecord>(collection: StorageCollectionName, query: StorageQuery<T>): Promise<boolean>;
+  count<T extends StorageRecord>(collection: StorageCollectionName, query?: StorageQuery<T>): Promise<number>;
+  atomicBatch<T extends StorageRecord>(operations: readonly StorageBatchOperation<T>[]): Promise<StorageBatchResult<T>>;
+}

package/dist/mongodb.adapter.d.ts

@@ -0,0 +1,25 @@
+import { MongoStorageAdapterOptions } from "./mongodb.types.js";
+import { StorageAdapter, StorageBatchOperation, StorageBatchResult, StorageCapabilities, StorageCapabilityReport, StorageCollection, StorageCollectionName, StorageCondition, StorageCursorQuery, StorageInsert, StoragePage, StorageQuery, StorageRecord, StorageUpdate } from "@puzzle-ui/storage";
+export declare class MongoStorageAdapter implements StorageAdapter {
+  readonly capabilities: StorageCapabilities;
+  private readonly database;
+  private readonly client;
+  private readonly prefix;
+  constructor(options: MongoStorageAdapterOptions);
+  getCapabilities(): StorageCapabilityReport;
+  private collection;
+  registerCollection<T extends StorageRecord>(definition: StorageCollection<T>): Promise<void>;
+  findById<T extends StorageRecord>(collection: StorageCollectionName, id: string): Promise<T | null>;
+  findOne<T extends StorageRecord>(collection: StorageCollectionName, query: StorageQuery<T>): Promise<T | null>;
+  findMany<T extends StorageRecord>(collection: StorageCollectionName, query?: StorageQuery<T>): Promise<readonly T[]>;
+  findPage<T extends StorageRecord>(collection: StorageCollectionName, query: StorageCursorQuery<T>): Promise<StoragePage<T>>;
+  insert<T extends StorageRecord>(collection: StorageCollectionName, record: Parameters<StorageAdapter["insert"]>[1]): Promise<T>;
+  upsert<T extends StorageRecord>(collection: StorageCollectionName, query: StorageQuery<T>, record: StorageInsert<T>): Promise<T>;
+  update<T extends StorageRecord>(collection: StorageCollectionName, id: string, changes: StorageUpdate<T>, condition?: StorageCondition): Promise<T | null>;
+  updateMany<T extends StorageRecord>(collection: StorageCollectionName, query: StorageQuery<T>, changes: StorageUpdate<T>): Promise<number>;
+  delete<T extends StorageRecord>(collection: StorageCollectionName, id: string, condition?: StorageCondition): Promise<boolean>;
+  deleteMany<T extends StorageRecord>(collection: StorageCollectionName, query: StorageQuery<T>): Promise<number>;
+  exists<T extends StorageRecord>(collection: StorageCollectionName, query: StorageQuery<T>): Promise<boolean>;
+  count<T extends StorageRecord>(collection: StorageCollectionName, query?: StorageQuery<T>): Promise<number>;
+  atomicBatch<T extends StorageRecord>(operations: readonly StorageBatchOperation<T>[]): Promise<StorageBatchResult<T>>;
+}