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

package/dist/mongodb.adapter.js

@@ -0,0 +1,320 @@
+import "mongodb";
+import { StorageAtomicityError, StorageConflictError, StorageDuplicateError, StorageValidationError, validateQuery } from "@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 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 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 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 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) {
+		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 = {}) {
+		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 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) {
+		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 StorageConflictError();
+			return null;
+		}
+		return toRecord(await target.findOne({ _id: id }));
+	}
+	async updateMany(collection, query, changes) {
+		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 StorageConflictError();
+		return false;
+	}
+	async deleteMany(collection, query) {
+		validateQuery(query);
+		return (await this.collection(collection).deleteMany(toMongoWhere(query.where))).deletedCount;
+	}
+	async exists(collection, query) {
+		validateQuery(query);
+		return await this.collection(collection).findOne(toMongoWhere(query.where), { projection: { _id: 1 } }) !== null;
+	}
+	async count(collection, query = {}) {
+		validateQuery(query);
+		return this.collection(collection).countDocuments(toMongoWhere(query.where));
+	}
+	async atomicBatch(operations) {
+		if (!this.capabilities.atomicBatch || !this.client) throw new 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 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 StorageConflictError();
+					results.push({
+						type: "delete",
+						deleted: result.deletedCount > 0
+					});
+				}
+			});
+			return { results };
+		} catch (error) {
+			if (error instanceof StorageConflictError || error instanceof StorageAtomicityError) throw error;
+			if (isDuplicateError(error)) throw new StorageDuplicateError("mongodb_unique_constraint");
+			throw error;
+		} finally {
+			await session.endSession();
+		}
+	}
+};
+export { MongoStorageAdapter };
+
+//# sourceMappingURL=mongodb.adapter.js.map

package/dist/mongodb.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongodb.adapter.js","names":[],"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":"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"}

package/dist/mongodb.migrations.cjs

@@ -0,0 +1,159 @@
+require("@puzzle-ui/storage");
+let node_crypto = require("node:crypto");
+// src/mongodb.migrations.ts
+const sleep = (duration) => new Promise((resolve) => setTimeout(resolve, duration));
+const isDuplicate = (error) => typeof error === "object" && error !== null && "code" in error && error.code === 11e3;
+var MongoStorageMigrationAdapter = class {
+	database;
+	prefix;
+	lockDurationMs;
+	constructor(options) {
+		this.database = options.database;
+		this.prefix = options.collectionPrefix ?? "puzzle_";
+		this.lockDurationMs = options.lockDurationMs ?? 6e5;
+	}
+	get migrations() {
+		return this.database.collection(`${this.prefix}migrations`);
+	}
+	get locks() {
+		return this.database.collection(`${this.prefix}migration_locks`);
+	}
+	async ensureCollections() {
+		for (const name of [`${this.prefix}migrations`, `${this.prefix}migration_locks`]) try {
+			await this.database.createCollection(name);
+		} catch (error) {
+			if (!(typeof error === "object" && error !== null && "code" in error && error.code === 48)) throw error;
+		}
+		await this.locks.createIndexes([{
+			key: { expiresAt: 1 },
+			name: "expiresAt_ttl",
+			expireAfterSeconds: 0
+		}]);
+	}
+	async getMigrationStatus() {
+		await this.ensureCollections();
+		const migrations = (await this.migrations.find({ _id: { $ne: "__lock__" } }).sort({ version: 1 }).toArray()).map((record) => ({
+			id: record._id,
+			version: record.version,
+			description: record.description,
+			status: record.status,
+			...record.startedAt ? { startedAt: record.startedAt } : {},
+			...record.completedAt ? { completedAt: record.completedAt } : {},
+			...record.error ? { error: record.error } : {}
+		}));
+		return {
+			currentVersion: migrations.reduce((version, migration) => migration.status === "completed" ? Math.max(version, migration.version) : version, 0),
+			migrations
+		};
+	}
+	async acquireLock(owner) {
+		const deadline = Date.now() + this.lockDurationMs;
+		while (Date.now() < deadline) {
+			const now = /* @__PURE__ */ new Date();
+			const expiresAt = new Date(now.getTime() + this.lockDurationMs);
+			try {
+				await this.locks.updateOne({
+					_id: "global",
+					$or: [{ expiresAt: { $lt: now } }, { owner }]
+				}, { $set: {
+					owner,
+					expiresAt
+				} }, { upsert: true });
+				if ((await this.locks.findOne({ _id: "global" }))?.owner === owner) return;
+			} catch (error) {
+				if (!isDuplicate(error)) throw error;
+			}
+			await sleep(50);
+		}
+		throw new Error("Timed out while acquiring the migration lock.");
+	}
+	async execute(operation) {
+		switch (operation.type) {
+			case "createCollection":
+				try {
+					await this.database.createCollection(`${this.prefix}${operation.collection}`);
+				} catch (error) {
+					if (!(typeof error === "object" && error !== null && "code" in error && error.code === 48)) throw error;
+				}
+				return;
+			case "dropCollection":
+				await this.database.dropCollection(`${this.prefix}${operation.collection}`).catch(() => false);
+				return;
+			case "createIndex":
+				await this.database.collection(`${this.prefix}${operation.collection}`).createIndexes([{
+					key: Object.fromEntries(operation.fields.map((field) => [field, 1])),
+					name: operation.name,
+					unique: operation.unique ?? false,
+					...operation.expireAfterSeconds !== void 0 ? { expireAfterSeconds: operation.expireAfterSeconds } : {}
+				}]);
+				return;
+			case "dropIndex":
+				await this.database.collection(`${this.prefix}${operation.collection}`).dropIndex(operation.name);
+				return;
+		}
+	}
+	async runMigrations(migrations, options = {}) {
+		await this.ensureCollections();
+		const owner = (0, node_crypto.randomUUID)();
+		await this.acquireLock(owner);
+		const applied = [];
+		const skipped = [];
+		try {
+			const sorted = [...migrations].sort((a, b) => a.version - b.version);
+			for (const migration of sorted) {
+				if (options.targetVersion !== void 0 && migration.version > options.targetVersion) {
+					skipped.push(migration.version);
+					continue;
+				}
+				if ((await this.migrations.findOne({ _id: migration.id }))?.status === "completed") {
+					skipped.push(migration.version);
+					continue;
+				}
+				if (options.dryRun) {
+					applied.push(migration.version);
+					continue;
+				}
+				const startedAt = /* @__PURE__ */ new Date();
+				await this.migrations.updateOne({ _id: migration.id }, {
+					$set: {
+						version: migration.version,
+						description: migration.description,
+						status: "running",
+						startedAt
+					},
+					$unset: {
+						completedAt: "",
+						error: ""
+					}
+				}, { upsert: true });
+				try {
+					await migration.up({ execute: (operation) => this.execute(operation) });
+					await this.migrations.updateOne({ _id: migration.id }, { $set: {
+						status: "completed",
+						completedAt: /* @__PURE__ */ new Date()
+					} });
+					applied.push(migration.version);
+				} catch (error) {
+					await this.migrations.updateOne({ _id: migration.id }, { $set: {
+						status: "failed",
+						error: error instanceof Error ? error.message : String(error)
+					} });
+					throw error;
+				}
+			}
+		} finally {
+			await this.locks.deleteOne({
+				_id: "global",
+				owner
+			});
+		}
+		return {
+			applied,
+			skipped,
+			currentVersion: (await this.getMigrationStatus()).currentVersion
+		};
+	}
+};
+exports.MongoStorageMigrationAdapter = MongoStorageMigrationAdapter;
+
+//# sourceMappingURL=mongodb.migrations.cjs.map

package/dist/mongodb.migrations.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongodb.migrations.cjs","names":["randomUUID"],"sources":["../src/mongodb.migrations.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport type { Db, Document } from \"mongodb\";\n\nimport {\n  type StorageMigration,\n  type StorageMigrationAdapter,\n  type StorageMigrationOperation,\n  type StorageMigrationOptions,\n  type StorageMigrationRecord,\n  type StorageMigrationResult,\n} from \"@puzzle-ui/storage\";\n\nimport type { MongoStorageMigrationOptions } from \"./mongodb.types\";\n\ntype MigrationDocument = Document & {\n  _id: string;\n  version: number;\n  description: string;\n  status: \"running\" | \"completed\" | \"failed\";\n  startedAt?: Date;\n  completedAt?: Date;\n  error?: string;\n};\n\ntype MigrationLockDocument = Document & {\n  _id: string;\n  owner: string;\n  expiresAt: Date;\n};\n\nconst sleep = (duration: number) =>\n  new Promise((resolve) => setTimeout(resolve, duration));\n\nconst isDuplicate = (error: unknown) =>\n  typeof error === \"object\" &&\n  error !== null &&\n  \"code\" in error &&\n  (error as { code: number }).code === 11000;\n\nexport class MongoStorageMigrationAdapter implements StorageMigrationAdapter {\n  private readonly database: Db;\n  private readonly prefix: string;\n  private readonly lockDurationMs: number;\n\n  constructor(options: MongoStorageMigrationOptions) {\n    this.database = options.database;\n    this.prefix = options.collectionPrefix ?? \"puzzle_\";\n    this.lockDurationMs = options.lockDurationMs ?? 600_000;\n  }\n\n  private get migrations() {\n    return this.database.collection<MigrationDocument>(\n      `${this.prefix}migrations`,\n    );\n  }\n\n  private get locks() {\n    return this.database.collection<MigrationLockDocument>(\n      `${this.prefix}migration_locks`,\n    );\n  }\n\n  private async ensureCollections() {\n    for (const name of [\n      `${this.prefix}migrations`,\n      `${this.prefix}migration_locks`,\n    ]) {\n      try {\n        await this.database.createCollection(name);\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\n    await this.locks.createIndexes([\n      {\n        key: { expiresAt: 1 },\n        name: \"expiresAt_ttl\",\n        expireAfterSeconds: 0,\n      },\n    ]);\n  }\n\n  async getMigrationStatus(): Promise<{\n    currentVersion: number;\n    migrations: readonly StorageMigrationRecord[];\n  }> {\n    await this.ensureCollections();\n\n    const records = await this.migrations\n      .find({ _id: { $ne: \"__lock__\" } })\n      .sort({ version: 1 })\n      .toArray();\n\n    const migrations = records.map((record) => ({\n      id: record._id,\n      version: record.version,\n      description: record.description,\n      status: record.status,\n      ...(record.startedAt ? { startedAt: record.startedAt } : {}),\n      ...(record.completedAt ? { completedAt: record.completedAt } : {}),\n      ...(record.error ? { error: record.error } : {}),\n    })) satisfies StorageMigrationRecord[];\n\n    return {\n      currentVersion: migrations.reduce(\n        (version, migration) =>\n          migration.status === \"completed\"\n            ? Math.max(version, migration.version)\n            : version,\n        0,\n      ),\n      migrations,\n    };\n  }\n\n  private async acquireLock(owner: string): Promise<void> {\n    const deadline = Date.now() + this.lockDurationMs;\n\n    while (Date.now() < deadline) {\n      const now = new Date();\n      const expiresAt = new Date(now.getTime() + this.lockDurationMs);\n\n      try {\n        await this.locks.updateOne(\n          {\n            _id: \"global\",\n            $or: [{ expiresAt: { $lt: now } }, { owner }],\n          },\n          {\n            $set: { owner, expiresAt },\n          },\n          { upsert: true },\n        );\n\n        const lock = await this.locks.findOne({ _id: \"global\" });\n\n        if (lock?.owner === owner) return;\n      } catch (error) {\n        if (!isDuplicate(error)) throw error;\n      }\n\n      await sleep(50);\n    }\n\n    throw new Error(\"Timed out while acquiring the migration lock.\");\n  }\n\n  private async execute(operation: StorageMigrationOperation): Promise<void> {\n    switch (operation.type) {\n      case \"createCollection\": {\n        try {\n          await this.database.createCollection(\n            `${this.prefix}${operation.collection}`,\n          );\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        return;\n      }\n\n      case \"dropCollection\":\n        await this.database\n          .dropCollection(`${this.prefix}${operation.collection}`)\n          .catch(() => false);\n        return;\n\n      case \"createIndex\": {\n        const collection = this.database.collection(\n          `${this.prefix}${operation.collection}`,\n        );\n\n        await collection.createIndexes([\n          {\n            key: Object.fromEntries(\n              operation.fields.map((field) => [field, 1]),\n            ),\n            name: operation.name,\n            unique: operation.unique ?? false,\n            ...(operation.expireAfterSeconds !== undefined\n              ? { expireAfterSeconds: operation.expireAfterSeconds }\n              : {}),\n          },\n        ]);\n\n        return;\n      }\n\n      case \"dropIndex\":\n        await this.database\n          .collection(`${this.prefix}${operation.collection}`)\n          .dropIndex(operation.name);\n        return;\n    }\n  }\n\n  async runMigrations(\n    migrations: readonly StorageMigration[],\n    options: StorageMigrationOptions = {},\n  ): Promise<StorageMigrationResult> {\n    await this.ensureCollections();\n\n    const owner = randomUUID();\n    await this.acquireLock(owner);\n\n    const applied: number[] = [];\n    const skipped: number[] = [];\n\n    try {\n      const sorted = [...migrations].sort((a, b) => a.version - b.version);\n\n      for (const migration of sorted) {\n        if (\n          options.targetVersion !== undefined &&\n          migration.version > options.targetVersion\n        ) {\n          skipped.push(migration.version);\n          continue;\n        }\n\n        const existing = await this.migrations.findOne({\n          _id: migration.id,\n        });\n\n        if (existing?.status === \"completed\") {\n          skipped.push(migration.version);\n          continue;\n        }\n\n        if (options.dryRun) {\n          applied.push(migration.version);\n          continue;\n        }\n\n        const startedAt = new Date();\n\n        await this.migrations.updateOne(\n          { _id: migration.id },\n          {\n            $set: {\n              version: migration.version,\n              description: migration.description,\n              status: \"running\",\n              startedAt,\n            },\n            $unset: {\n              completedAt: \"\",\n              error: \"\",\n            },\n          },\n          { upsert: true },\n        );\n\n        try {\n          await migration.up({\n            execute: (operation) => this.execute(operation),\n          });\n\n          await this.migrations.updateOne(\n            { _id: migration.id },\n            {\n              $set: {\n                status: \"completed\",\n                completedAt: new Date(),\n              },\n            },\n          );\n\n          applied.push(migration.version);\n        } catch (error) {\n          await this.migrations.updateOne(\n            { _id: migration.id },\n            {\n              $set: {\n                status: \"failed\",\n                error: error instanceof Error ? error.message : String(error),\n              },\n            },\n          );\n\n          throw error;\n        }\n      }\n    } finally {\n      await this.locks.deleteOne({\n        _id: \"global\",\n        owner,\n      });\n    }\n\n    const status = await this.getMigrationStatus();\n\n    return {\n      applied,\n      skipped,\n      currentVersion: status.currentVersion,\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/mongodb.migrations.d.cts

@@ -0,0 +1,18 @@
+import { MongoStorageMigrationOptions } from "./mongodb.types.cjs";
+import { StorageMigration, StorageMigrationAdapter, StorageMigrationOptions, StorageMigrationRecord, StorageMigrationResult } from "@puzzle-ui/storage";
+export declare class MongoStorageMigrationAdapter implements StorageMigrationAdapter {
+  private readonly database;
+  private readonly prefix;
+  private readonly lockDurationMs;
+  constructor(options: MongoStorageMigrationOptions);
+  private get migrations();
+  private get locks();
+  private ensureCollections;
+  getMigrationStatus(): Promise<{
+    currentVersion: number;
+    migrations: readonly StorageMigrationRecord[];
+  }>;
+  private acquireLock;
+  private execute;
+  runMigrations(migrations: readonly StorageMigration[], options?: StorageMigrationOptions): Promise<StorageMigrationResult>;
+}

package/dist/mongodb.migrations.d.ts

@@ -0,0 +1,18 @@
+import { MongoStorageMigrationOptions } from "./mongodb.types.js";
+import { StorageMigration, StorageMigrationAdapter, StorageMigrationOptions, StorageMigrationRecord, StorageMigrationResult } from "@puzzle-ui/storage";
+export declare class MongoStorageMigrationAdapter implements StorageMigrationAdapter {
+  private readonly database;
+  private readonly prefix;
+  private readonly lockDurationMs;
+  constructor(options: MongoStorageMigrationOptions);
+  private get migrations();
+  private get locks();
+  private ensureCollections;
+  getMigrationStatus(): Promise<{
+    currentVersion: number;
+    migrations: readonly StorageMigrationRecord[];
+  }>;
+  private acquireLock;
+  private execute;
+  runMigrations(migrations: readonly StorageMigration[], options?: StorageMigrationOptions): Promise<StorageMigrationResult>;
+}