@procedures/mongo 0.0.0-stage → 0.2.0

package/dist/procedures/target.js

@@ -0,0 +1,98 @@
+/**
+ * The target of a write: one document by `id`, or the documents that match a `filter`.
+ *
+ * Before, a call without `id` and `filter` used the filter `{}`, and the field name of
+ * `find`/`count` (`query`) was ignored: `delete { query, multi: true }` emptied the
+ * collection (deep dive DATA-4). Now a write needs exactly one target, an unknown field is an
+ * error, and an empty filter needs `confirm: true`.
+ */
+import { ObjectId } from "mongodb";
+import { buildIdFilter } from "../types.js";
+import { SCOPE_FIELDS, copyScope } from "../scope.js";
+const TARGET_FIELDS = ["filter", "id", "idType", "multi", "confirm", ...SCOPE_FIELDS];
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function optionalBoolean(procedure, raw, field) {
+    const value = raw[field];
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "boolean")
+        throw new Error(`${procedure}: ${field} must be a boolean`);
+    return value;
+}
+/**
+ * This function reads and checks the target fields of a write input.
+ * `extraFields` are the other fields that the procedure accepts.
+ */
+export function parseTarget(procedure, data, extraFields = []) {
+    if (!isPlainObject(data)) {
+        throw new Error(`${procedure}: input must be an object`);
+    }
+    const raw = data;
+    const allowed = new Set([...TARGET_FIELDS, ...extraFields]);
+    for (const key of Object.keys(raw)) {
+        if (!allowed.has(key)) {
+            const hint = key === "query" ? ' Use "filter".' : "";
+            throw new Error(`${procedure}: unknown field "${key}".${hint} The fields are: ${[...allowed].join(", ")}`);
+        }
+    }
+    const hasId = raw["id"] !== undefined;
+    const hasFilter = raw["filter"] !== undefined;
+    if (hasId === hasFilter) {
+        throw new Error(`${procedure}: give exactly one of id or filter`);
+    }
+    const target = {};
+    copyScope(raw, target);
+    if (hasId) {
+        const id = raw["id"];
+        if (typeof id !== "string" || id.length === 0) {
+            throw new Error(`${procedure}: id must be a non-empty string`);
+        }
+        target.id = id;
+    }
+    else {
+        const filter = raw["filter"];
+        if (!isPlainObject(filter)) {
+            throw new Error(`${procedure}: filter must be an object`);
+        }
+        target.filter = filter;
+    }
+    const idType = raw["idType"];
+    if (idType !== undefined) {
+        if (idType !== "auto" && idType !== "objectId" && idType !== "string") {
+            throw new Error(`${procedure}: idType must be "auto", "objectId" or "string"`);
+        }
+        target.idType = idType;
+    }
+    const multi = optionalBoolean(procedure, raw, "multi");
+    const confirm = optionalBoolean(procedure, raw, "confirm");
+    if (multi !== undefined)
+        target.multi = multi;
+    if (confirm !== undefined)
+        target.confirm = confirm;
+    if (target.filter && Object.keys(target.filter).length === 0 && confirm !== true) {
+        throw new Error(`${procedure}: an empty filter matches every document. Set confirm: true to use it.`);
+    }
+    return { target, raw };
+}
+/** The filter of a target. */
+export function targetFilter(target) {
+    return target.id !== undefined ? buildIdFilter(target.id, target.idType) : target.filter;
+}
+/**
+ * The filter of an upsert by ID. It names one exact `_id`.
+ *
+ * In the "auto" mode the ID filter is `$or` of the ObjectId and the string form. MongoDB cannot
+ * take an `_id` from `$or`, so each upsert inserted a new document with a new ID (deep dive
+ * DATA-15). This function uses the `_id` of the existing document, or the ObjectId form when no
+ * document matches.
+ */
+export async function upsertFilter(collection, target) {
+    const filter = targetFilter(target);
+    if (target.id === undefined || !("$or" in filter))
+        return filter;
+    const existing = await collection.findOne(filter, { projection: { _id: 1 } });
+    return { _id: existing ? existing["_id"] : new ObjectId(target.id) };
+}
+//# sourceMappingURL=target.js.map

package/dist/procedures/target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.js","sourceRoot":"","sources":["../../src/procedures/target.ts"],"names":[],"mappings":"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"}

package/dist/procedures.types.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Typed Procedures Interface
+ *
+ * Provides compile-time autocomplete for client-mongo procedures.
+ * Import this type and use with a typed caller for full type safety.
+ *
+ * @example
+ * ```typescript
+ * import type { MongoProcedures } from "@procedures/mongo";
+ * import { createTypedCaller } from "@procedures/client";
+ *
+ * const call = createTypedCaller<MongoProcedures>(client.call);
+ *
+ * // Full autocomplete on path and input!
+ * const result = await call(
+ *   ["mongo", "documents", "find"],
+ *   { query: { status: "active" } },
+ *   { metadata: { collection: "users" } }
+ * );
+ * // result is typed as FindOutput
+ * ```
+ */
+import type { CollectionStats, DatabaseInfo } from "./types.js";
+import type { PingInput, PingOutput } from "./procedures/database.ping.js";
+import type { InfoInput } from "./procedures/database.info.js";
+import type { ListInput as ListCollectionsInput, ListOutput as ListCollectionsOutput } from "./procedures/collections.list.js";
+import type { CreateInput as CreateCollectionInput, CreateOutput as CreateCollectionOutput } from "./procedures/collections.create.js";
+import type { DropInput as DropCollectionInput, DropOutput as DropCollectionOutput } from "./procedures/collections.drop.js";
+import type { StatsInput } from "./procedures/collections.stats.js";
+import type { FindInput, FindOutput } from "./procedures/documents.find.js";
+import type { GetInput, GetOutput } from "./procedures/documents.get.js";
+import type { InsertInput, InsertOutput } from "./procedures/documents.insert.js";
+import type { UpdateInput, UpdateOutput } from "./procedures/documents.update.js";
+import type { DeleteInput, DeleteOutput } from "./procedures/documents.delete.js";
+import type { CountInput, CountOutput } from "./procedures/documents.count.js";
+import type { AggregateInput, AggregateOutput } from "./procedures/documents.aggregate.js";
+import type { ListIndexesInput, ListIndexesOutput } from "./procedures/indexes.list.js";
+import type { CreateIndexInput, CreateIndexOutput } from "./procedures/indexes.create.js";
+import type { DropIndexInput, DropIndexOutput } from "./procedures/indexes.drop.js";
+export type { PingInput, PingOutput, InfoInput, ListCollectionsInput, ListCollectionsOutput, CreateCollectionInput, CreateCollectionOutput, DropCollectionInput, DropCollectionOutput, StatsInput, FindInput, FindOutput, GetInput, GetOutput, InsertInput, InsertOutput, UpdateInput, UpdateOutput, DeleteInput, DeleteOutput, CountInput, CountOutput, AggregateInput, AggregateOutput, ListIndexesInput, ListIndexesOutput, CreateIndexInput, CreateIndexOutput, DropIndexInput, DropIndexOutput, };
+/**
+ * Typed interface for all MongoDB procedures.
+ * Use with createTypedCaller for compile-time autocomplete.
+ */
+export interface MongoProcedures {
+    mongo: {
+        database: {
+            ping: {
+                input: PingInput;
+                output: PingOutput;
+            };
+            info: {
+                input: InfoInput;
+                output: DatabaseInfo;
+            };
+        };
+        collections: {
+            list: {
+                input: ListCollectionsInput;
+                output: ListCollectionsOutput;
+            };
+            create: {
+                input: CreateCollectionInput;
+                output: CreateCollectionOutput;
+            };
+            drop: {
+                input: DropCollectionInput;
+                output: DropCollectionOutput;
+            };
+            stats: {
+                input: StatsInput;
+                output: CollectionStats;
+            };
+        };
+        documents: {
+            find: {
+                input: FindInput;
+                output: FindOutput;
+            };
+            get: {
+                input: GetInput;
+                output: GetOutput;
+            };
+            insert: {
+                input: InsertInput;
+                output: InsertOutput;
+            };
+            update: {
+                input: UpdateInput;
+                output: UpdateOutput;
+            };
+            delete: {
+                input: DeleteInput;
+                output: DeleteOutput;
+            };
+            count: {
+                input: CountInput;
+                output: CountOutput;
+            };
+            aggregate: {
+                input: AggregateInput;
+                output: AggregateOutput;
+            };
+        };
+        indexes: {
+            list: {
+                input: ListIndexesInput;
+                output: ListIndexesOutput;
+            };
+            create: {
+                input: CreateIndexInput;
+                output: CreateIndexOutput;
+            };
+            drop: {
+                input: DropIndexInput;
+                output: DropIndexOutput;
+            };
+        };
+    };
+}
+/**
+ * Helper type to extract input type from a procedure path
+ */
+export type ProcedureInput<P extends readonly string[]> = P extends ["mongo", "database", "ping"] ? PingInput : P extends ["mongo", "database", "info"] ? InfoInput : P extends ["mongo", "collections", "list"] ? ListCollectionsInput : P extends ["mongo", "collections", "create"] ? CreateCollectionInput : P extends ["mongo", "collections", "drop"] ? DropCollectionInput : P extends ["mongo", "collections", "stats"] ? StatsInput : P extends ["mongo", "documents", "find"] ? FindInput : P extends ["mongo", "documents", "get"] ? GetInput : P extends ["mongo", "documents", "insert"] ? InsertInput : P extends ["mongo", "documents", "update"] ? UpdateInput : P extends ["mongo", "documents", "delete"] ? DeleteInput : P extends ["mongo", "documents", "count"] ? CountInput : P extends ["mongo", "documents", "aggregate"] ? AggregateInput : P extends ["mongo", "indexes", "list"] ? ListIndexesInput : P extends ["mongo", "indexes", "create"] ? CreateIndexInput : P extends ["mongo", "indexes", "drop"] ? DropIndexInput : never;
+/**
+ * Helper type to extract output type from a procedure path
+ */
+export type ProcedureOutput<P extends readonly string[]> = P extends ["mongo", "database", "ping"] ? PingOutput : P extends ["mongo", "database", "info"] ? DatabaseInfo : P extends ["mongo", "collections", "list"] ? ListCollectionsOutput : P extends ["mongo", "collections", "create"] ? CreateCollectionOutput : P extends ["mongo", "collections", "drop"] ? DropCollectionOutput : P extends ["mongo", "collections", "stats"] ? CollectionStats : P extends ["mongo", "documents", "find"] ? FindOutput : P extends ["mongo", "documents", "get"] ? GetOutput : P extends ["mongo", "documents", "insert"] ? InsertOutput : P extends ["mongo", "documents", "update"] ? UpdateOutput : P extends ["mongo", "documents", "delete"] ? DeleteOutput : P extends ["mongo", "documents", "count"] ? CountOutput : P extends ["mongo", "documents", "aggregate"] ? AggregateOutput : P extends ["mongo", "indexes", "list"] ? ListIndexesOutput : P extends ["mongo", "indexes", "create"] ? CreateIndexOutput : P extends ["mongo", "indexes", "drop"] ? DropIndexOutput : never;
+//# sourceMappingURL=procedures.types.d.ts.map

package/dist/procedures.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedures.types.d.ts","sourceRoot":"","sources":["../src/procedures.types.ts"],"names":[],"mappings":"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"}

package/dist/procedures.types.js

@@ -0,0 +1,24 @@
+/**
+ * Typed Procedures Interface
+ *
+ * Provides compile-time autocomplete for client-mongo procedures.
+ * Import this type and use with a typed caller for full type safety.
+ *
+ * @example
+ * ```typescript
+ * import type { MongoProcedures } from "@procedures/mongo";
+ * import { createTypedCaller } from "@procedures/client";
+ *
+ * const call = createTypedCaller<MongoProcedures>(client.call);
+ *
+ * // Full autocomplete on path and input!
+ * const result = await call(
+ *   ["mongo", "documents", "find"],
+ *   { query: { status: "active" } },
+ *   { metadata: { collection: "users" } }
+ * );
+ * // result is typed as FindOutput
+ * ```
+ */
+export {};
+//# sourceMappingURL=procedures.types.js.map

package/dist/procedures.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedures.types.js","sourceRoot":"","sources":["../src/procedures.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG"}

package/dist/register.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Importing this file registers the procedures of @procedures/mongo, and of the modules that it
+ * requires, in the global registry: `import "@procedures/mongo/register"`. The package root and the
+ * `./module` entry register nothing (ARCHITECTURE-PROPOSALS-2026-10, P9).
+ */
+export * from "./module.js";
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,cAAc,aAAa,CAAC"}

package/dist/register.js

@@ -0,0 +1,9 @@
+/**
+ * Importing this file registers the procedures of @procedures/mongo, and of the modules that it
+ * requires, in the global registry: `import "@procedures/mongo/register"`. The package root and the
+ * `./module` entry register nothing (ARCHITECTURE-PROPOSALS-2026-10, P9).
+ */
+import { registerMongoProcedures } from "./module.js";
+export * from "./module.js";
+registerMongoProcedures();
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEtD,cAAc,aAAa,CAAC;AAE5B,uBAAuB,EAAE,CAAC"}

package/dist/scope.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The database and the collection of a call.
+ *
+ * Each procedure reads `collection` and `database` from its input. The call metadata stays a
+ * fallback for the clients that set it. (Before, only the metadata gave them, and an MCP tool
+ * call cannot set metadata: deep dive DATA-5.)
+ */
+import type { Collection, Db, Document } from "mongodb";
+import type { ProcedureContext } from "@procedures/client";
+/** The input fields that select the database and the collection. */
+export interface ScopeInput {
+    /** The collection name. It takes the place of `metadata.collection`. */
+    collection?: string | undefined;
+    /** The database name. It takes the place of `metadata.database` and the connection default. */
+    database?: string | undefined;
+}
+/** The names of the scope fields, for the input parsers. */
+export declare const SCOPE_FIELDS: readonly ["collection", "database"];
+/** The database name of a call: the input, then the metadata. Undefined means the connection default. */
+export declare function databaseName(input: ScopeInput, ctx: Pick<ProcedureContext, "metadata">): string | undefined;
+/** The collection name of a call: the input, then the metadata. */
+export declare function collectionName(input: ScopeInput, ctx: Pick<ProcedureContext, "metadata">): string;
+/** The database of a call. This function connects first when there is no open connection. */
+export declare function databaseFor(input: ScopeInput, ctx: Pick<ProcedureContext, "metadata">): Promise<Db>;
+/** The collection of a call. This function connects first when there is no open connection. */
+export declare function collectionFor(input: ScopeInput, ctx: Pick<ProcedureContext, "metadata">): Promise<{
+    collection: Collection<Document>;
+    name: string;
+    db: Db;
+}>;
+/** This function copies the scope fields of a raw input into a parsed input. */
+export declare function copyScope(raw: Record<string, unknown>, parsed: ScopeInput): void;
+//# sourceMappingURL=scope.d.ts.map

package/dist/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../src/scope.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,oEAAoE;AACpE,MAAM,WAAW,UAAU;IACzB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,4DAA4D;AAC5D,eAAO,MAAM,YAAY,YAAI,YAAY,EAAE,UAAU,CAAU,CAAC;AAUhE,yGAAyG;AACzG,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,GAAG,MAAM,GAAG,SAAS,CAE3G;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,GAAG,MAAM,CAMjG;AAED,6FAA6F;AAC7F,wBAAsB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,CAIzG;AAED,+FAA+F;AAC/F,wBAAsB,aAAa,CACjC,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,GACtC,OAAO,CAAC;IAAE,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,EAAE,CAAA;CAAE,CAAC,CAIrE;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAKhF"}

package/dist/scope.js

@@ -0,0 +1,52 @@
+/**
+ * The database and the collection of a call.
+ *
+ * Each procedure reads `collection` and `database` from its input. The call metadata stays a
+ * fallback for the clients that set it. (Before, only the metadata gave them, and an MCP tool
+ * call cannot set metadata: deep dive DATA-5.)
+ */
+import { ensureConnection } from "./connection.js";
+/** The names of the scope fields, for the input parsers. */
+export const SCOPE_FIELDS = ["collection", "database"];
+function optionalName(value, field) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new Error(`${field} must be a non-empty string`);
+    }
+    return value;
+}
+/** The database name of a call: the input, then the metadata. Undefined means the connection default. */
+export function databaseName(input, ctx) {
+    return optionalName(input.database, "database") ?? optionalName(ctx.metadata["database"], "metadata.database");
+}
+/** The collection name of a call: the input, then the metadata. */
+export function collectionName(input, ctx) {
+    const name = optionalName(input.collection, "collection") ?? optionalName(ctx.metadata["collection"], "metadata.collection");
+    if (name === undefined) {
+        throw new Error("collection is required: give it in the input (or in the call metadata)");
+    }
+    return name;
+}
+/** The database of a call. This function connects first when there is no open connection. */
+export async function databaseFor(input, ctx) {
+    const name = databaseName(input, ctx);
+    const connection = await ensureConnection();
+    return name ? connection.getClient().db(name) : connection.getDb();
+}
+/** The collection of a call. This function connects first when there is no open connection. */
+export async function collectionFor(input, ctx) {
+    const name = collectionName(input, ctx);
+    const db = await databaseFor(input, ctx);
+    return { collection: db.collection(name), name, db };
+}
+/** This function copies the scope fields of a raw input into a parsed input. */
+export function copyScope(raw, parsed) {
+    const collection = optionalName(raw["collection"], "collection");
+    const database = optionalName(raw["database"], "database");
+    if (collection !== undefined)
+        parsed.collection = collection;
+    if (database !== undefined)
+        parsed.database = database;
+}
+//# sourceMappingURL=scope.js.map

package/dist/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../src/scope.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAUnD,4DAA4D;AAC5D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,YAAY,EAAE,UAAU,CAAU,CAAC;AAEhE,SAAS,YAAY,CAAC,KAAc,EAAE,KAAa;IACjD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,6BAA6B,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,yGAAyG;AACzG,MAAM,UAAU,YAAY,CAAC,KAAiB,EAAE,GAAuC;IACrF,OAAO,YAAY,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,mBAAmB,CAAC,CAAC;AACjH,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,cAAc,CAAC,KAAiB,EAAE,GAAuC;IACvF,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,UAAU,EAAE,YAAY,CAAC,IAAI,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,qBAAqB,CAAC,CAAC;IAC7H,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAiB,EAAE,GAAuC;IAC1F,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,MAAM,gBAAgB,EAAE,CAAC;IAC5C,OAAO,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;AACrE,CAAC;AAED,+FAA+F;AAC/F,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAiB,EACjB,GAAuC;IAEvC,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACxC,MAAM,EAAE,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACzC,OAAO,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AACvD,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,SAAS,CAAC,GAA4B,EAAE,MAAkB;IACxE,MAAM,UAAU,GAAG,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,CAAC;IAC3D,IAAI,UAAU,KAAK,SAAS;QAAE,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC;IAC7D,IAAI,QAAQ,KAAK,SAAS;QAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;AACzD,CAAC"}

package/dist/storage/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MongoDB Storage Exports
+ */
+export { MongoStorage } from "./mongo-storage.js";
+export type { MongoStorageOptions } from "./mongo-storage.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/storage/index.js

@@ -0,0 +1,5 @@
+/**
+ * MongoDB Storage Exports
+ */
+export { MongoStorage } from "./mongo-storage.js";
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/storage/mongo-storage.d.ts

@@ -0,0 +1,50 @@
+/**
+ * MongoDB Storage Implementation
+ *
+ * Implements CollectionStorage<T> from client-collections, providing MongoDB
+ * as a storage backend for the collections framework.
+ */
+import type { CollectionStorage, StorageMetadata } from "@procedures/collections";
+/**
+ * Configuration options for MongoStorage.
+ */
+export interface MongoStorageOptions {
+    /** MongoDB collection name */
+    collection: string;
+}
+/**
+ * MongoDB implementation of CollectionStorage.
+ *
+ * Stores items as documents with the structure:
+ * { _id: string, data: T }
+ *
+ * @example
+ * ```typescript
+ * const storage = new MongoStorage<User>({ collection: "users" });
+ * await storage.set("user-1", { name: "Alice", email: "alice@example.com" });
+ * const user = await storage.get("user-1");
+ * ```
+ */
+export declare class MongoStorage<T> implements CollectionStorage<T> {
+    private readonly collectionName;
+    constructor(options: MongoStorageOptions);
+    /**
+     * The collection, from the current default connection. The storage does not keep it: after a
+     * reconnect the old collection belongs to a closed client (deep dive DATA-6).
+     */
+    private getCollection;
+    get(id: string): Promise<T | undefined>;
+    getAll(): Promise<T[]>;
+    find(predicate: (item: T) => boolean): Promise<T[]>;
+    has(id: string): Promise<boolean>;
+    size(): Promise<number>;
+    set(id: string, value: T): Promise<void>;
+    delete(id: string): Promise<boolean>;
+    clear(): Promise<void>;
+    setBatch(items: Array<[string, T]>): Promise<void>;
+    deleteBatch(ids: string[]): Promise<number>;
+    getBatch(ids: string[]): Promise<Map<string, T>>;
+    close(): Promise<void>;
+    getMetadata(): Promise<StorageMetadata>;
+}
+//# sourceMappingURL=mongo-storage.d.ts.map

package/dist/storage/mongo-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo-storage.d.ts","sourceRoot":"","sources":["../../src/storage/mongo-storage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAGlF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;CACpB;AAUD;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAY,CAAC,CAAC,CAAE,YAAW,iBAAiB,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC,YAAY,OAAO,EAAE,mBAAmB,EAEvC;IAED;;;OAGG;YACW,aAAa;IAKrB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAG5C;IAEK,MAAM,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAG3B;IAEK,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAGxD;IAEK,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGtC;IAEK,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAE5B;IAEK,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAM7C;IAEK,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGzC;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;IAEK,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAYvD;IAEK,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAQhD;IAEK,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAYrD;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;IAEK,WAAW,IAAI,OAAO,CAAC,eAAe,CAAC,CAU5C;CACF"}

package/dist/storage/mongo-storage.js

@@ -0,0 +1,109 @@
+/**
+ * MongoDB Storage Implementation
+ *
+ * Implements CollectionStorage<T> from client-collections, providing MongoDB
+ * as a storage backend for the collections framework.
+ */
+import { ensureConnection } from "../connection.js";
+/**
+ * MongoDB implementation of CollectionStorage.
+ *
+ * Stores items as documents with the structure:
+ * { _id: string, data: T }
+ *
+ * @example
+ * ```typescript
+ * const storage = new MongoStorage<User>({ collection: "users" });
+ * await storage.set("user-1", { name: "Alice", email: "alice@example.com" });
+ * const user = await storage.get("user-1");
+ * ```
+ */
+export class MongoStorage {
+    collectionName;
+    constructor(options) {
+        this.collectionName = options.collection;
+    }
+    /**
+     * The collection, from the current default connection. The storage does not keep it: after a
+     * reconnect the old collection belongs to a closed client (deep dive DATA-6).
+     */
+    async getCollection() {
+        const connection = await ensureConnection();
+        return connection.getDb().collection(this.collectionName);
+    }
+    async get(id) {
+        const doc = await (await this.getCollection()).findOne({ _id: id });
+        return doc?.data;
+    }
+    async getAll() {
+        const docs = await (await this.getCollection()).find({}).toArray();
+        return docs.map((doc) => doc.data);
+    }
+    async find(predicate) {
+        const all = await this.getAll();
+        return all.filter(predicate);
+    }
+    async has(id) {
+        const count = await (await this.getCollection()).countDocuments({ _id: id }, { limit: 1 });
+        return count > 0;
+    }
+    async size() {
+        return (await this.getCollection()).countDocuments({});
+    }
+    async set(id, value) {
+        await (await this.getCollection()).updateOne({ _id: id }, { $set: { _id: id, data: value } }, { upsert: true });
+    }
+    async delete(id) {
+        const result = await (await this.getCollection()).deleteOne({ _id: id });
+        return result.deletedCount > 0;
+    }
+    async clear() {
+        await (await this.getCollection()).deleteMany({});
+    }
+    async setBatch(items) {
+        if (items.length === 0)
+            return;
+        const operations = items.map(([id, value]) => ({
+            updateOne: {
+                filter: { _id: id },
+                update: { $set: { _id: id, data: value } },
+                upsert: true,
+            },
+        }));
+        await (await this.getCollection()).bulkWrite(operations);
+    }
+    async deleteBatch(ids) {
+        if (ids.length === 0)
+            return 0;
+        const result = await (await this.getCollection()).deleteMany({
+            _id: { $in: ids },
+        });
+        return result.deletedCount;
+    }
+    async getBatch(ids) {
+        if (ids.length === 0)
+            return new Map();
+        const docs = await (await this.getCollection())
+            .find({ _id: { $in: ids } })
+            .toArray();
+        const result = new Map();
+        for (const doc of docs) {
+            result.set(String(doc._id), doc.data);
+        }
+        return result;
+    }
+    async close() {
+        // The storage keeps no connection state: the connection belongs to the package
+    }
+    async getMetadata() {
+        const size = await this.size();
+        return {
+            type: "custom",
+            size,
+            stats: {
+                collectionName: this.collectionName,
+            },
+        };
+    }
+}
+//# sourceMappingURL=mongo-storage.js.map

package/dist/storage/mongo-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo-storage.js","sourceRoot":"","sources":["../../src/storage/mongo-storage.ts"],"names":[],"mappings":"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"}