@procedures/mongo 0.0.0-stage → 0.1.0

package/dist/procedures/documents.update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.update.d.ts","sourceRoot":"","sources":["../../src/procedures/documents.update.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAmB,KAAK,SAAS,EAAqC,MAAM,oBAAoB,CAAC;AAIxG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAA2C,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAGxF,oFAAoF;AACpF,UAAU,WAAY,SAAQ,WAAW;IACvC,wBAAwB;IACxB,MAAM,EAAE,cAAc,CAAC;IACvB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,YAAY;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;CACvB;AAsCD,eAAO,MAAM,eAAe,EAAE,SAAS,CACrC,WAAW,EACX,YAAY,EACZ;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAsBf,CAAC;AAEX,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC"}

package/dist/procedures/documents.update.js

@@ -0,0 +1,61 @@
+/**
+ * Procedure: mongo.documents.update
+ * Update documents matching a filter
+ */
+import { createProcedure, zodAdapter } from "@procedures/client";
+import { collectionFor } from "../scope.js";
+import { described, documentObject, scopeFields, targetFields } from "./input-schemas.js";
+import { z } from "zod";
+import { parseTarget, targetFilter, upsertFilter } from "./target.js";
+function parseUpdateInput(data) {
+    const procedure = "mongo.documents.update";
+    const { target, raw } = parseTarget(procedure, data, ["update", "upsert"]);
+    const update = raw["update"];
+    if (typeof update !== "object" || update === null) {
+        throw new Error(`${procedure}: update must be an object (or a pipeline array)`);
+    }
+    const result = { ...target, update: update };
+    const upsert = raw["upsert"];
+    if (upsert !== undefined) {
+        if (typeof upsert !== "boolean")
+            throw new Error(`${procedure}: upsert must be a boolean`);
+        result.upsert = upsert;
+    }
+    return result;
+}
+// Schemas
+const updateInputSchema = described(parseUpdateInput, z.object({
+    ...scopeFields(),
+    ...targetFields(),
+    update: documentObject().describe("The update operations, for example { $set: { status: \"done\" } }"),
+    upsert: z.boolean().optional().describe("Insert a document when none matches"),
+}));
+const updateOutputSchema = zodAdapter(z.looseObject({
+    acknowledged: z.boolean().describe("True when the server confirmed the write"),
+    matchedCount: z.number().describe("The number of documents that matched"),
+    modifiedCount: z.number().describe("The number of documents that changed"),
+    upsertedId: z.string().nullable().describe("The id of the new document of an upsert, as text, or null"),
+    upsertedCount: z.number().describe("The number of documents that an upsert made"),
+}));
+export const updateProcedure = createProcedure()
+    .path(["mongo", "documents", "update"])
+    .input(updateInputSchema)
+    .output(updateOutputSchema)
+    .meta({ description: "Update documents matching a filter" })
+    .handler(async (input, ctx) => {
+    const { collection } = await collectionFor(input, ctx);
+    const upsert = input.upsert ?? false;
+    const filter = upsert ? await upsertFilter(collection, input) : targetFilter(input);
+    const result = input.multi
+        ? await collection.updateMany(filter, input.update, { upsert })
+        : await collection.updateOne(filter, input.update, { upsert });
+    return {
+        acknowledged: result.acknowledged,
+        matchedCount: result.matchedCount,
+        modifiedCount: result.modifiedCount,
+        upsertedId: result.upsertedId ? String(result.upsertedId) : null,
+        upsertedCount: result.upsertedCount,
+    };
+})
+    .build();
+//# sourceMappingURL=documents.update.js.map

package/dist/procedures/documents.update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.update.js","sourceRoot":"","sources":["../../src/procedures/documents.update.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAyC,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACxG,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC1F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAoB,MAAM,aAAa,CAAC;AAmBxF,SAAS,gBAAgB,CAAC,IAAa;IACrC,MAAM,SAAS,GAAG,wBAAwB,CAAC;IAC3C,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,WAAW,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,kDAAkD,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,MAAM,GAAgB,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,MAAwB,EAAE,CAAC;IAC5E,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,IAAI,OAAO,MAAM,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,4BAA4B,CAAC,CAAC;QAC3F,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,UAAU;AACV,MAAM,iBAAiB,GAAG,SAAS,CACjC,gBAAgB,EAChB,CAAC,CAAC,MAAM,CAAC;IACP,GAAG,WAAW,EAAE;IAChB,GAAG,YAAY,EAAE;IACjB,MAAM,EAAE,cAAc,EAAE,CAAC,QAAQ,CAAC,mEAAmE,CAAC;IACtG,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;CAC/E,CAAC,CACH,CAAC;AACF,MAAM,kBAAkB,GAAG,UAAU,CACnC,CAAC,CAAC,WAAW,CAAC;IACZ,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IAC9E,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IACzE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IAC1E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;IACvG,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;CAClF,CAAC,CACH,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAIxB,eAAe,EAAE;KAClB,IAAI,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;KACtC,KAAK,CAAC,iBAAiB,CAAC;KACxB,MAAM,CAAC,kBAAkB,CAAC;KAC1B,IAAI,CAAC,EAAE,WAAW,EAAE,oCAAoC,EAAE,CAAC;KAC3D,OAAO,CAAC,KAAK,EAAE,KAAkB,EAAE,GAAqB,EAAE,EAAE;IAC3D,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC;IACrC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAEpF,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK;QACxB,CAAC,CAAC,MAAM,UAAU,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC;QAC/D,CAAC,CAAC,MAAM,UAAU,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACjE,OAAO;QACL,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI;QAChE,aAAa,EAAE,MAAM,CAAC,aAAa;KACpC,CAAC;AACJ,CAAC,CAAC;KACD,KAAK,EAAE,CAAC"}

package/dist/procedures/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Procedure Barrel Export
+ */
+export { pingProcedure } from "./database.ping.js";
+export { infoProcedure } from "./database.info.js";
+export { listProcedure } from "./collections.list.js";
+export { createCollectionProcedure } from "./collections.create.js";
+export { dropProcedure } from "./collections.drop.js";
+export { statsProcedure } from "./collections.stats.js";
+export { findProcedure } from "./documents.find.js";
+export { getProcedure } from "./documents.get.js";
+export { insertProcedure } from "./documents.insert.js";
+export { updateProcedure } from "./documents.update.js";
+export { deleteProcedure } from "./documents.delete.js";
+export { countProcedure } from "./documents.count.js";
+export { aggregateProcedure } from "./documents.aggregate.js";
+export { listIndexesProcedure } from "./indexes.list.js";
+export { createIndexProcedure } from "./indexes.create.js";
+export { dropIndexProcedure } from "./indexes.drop.js";
+export { schema } from "./schema.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/procedures/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAG9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/procedures/index.js

@@ -0,0 +1,26 @@
+/**
+ * Procedure Barrel Export
+ */
+// Database procedures
+export { pingProcedure } from "./database.ping.js";
+export { infoProcedure } from "./database.info.js";
+// Collection procedures
+export { listProcedure } from "./collections.list.js";
+export { createCollectionProcedure } from "./collections.create.js";
+export { dropProcedure } from "./collections.drop.js";
+export { statsProcedure } from "./collections.stats.js";
+// Document procedures
+export { findProcedure } from "./documents.find.js";
+export { getProcedure } from "./documents.get.js";
+export { insertProcedure } from "./documents.insert.js";
+export { updateProcedure } from "./documents.update.js";
+export { deleteProcedure } from "./documents.delete.js";
+export { countProcedure } from "./documents.count.js";
+export { aggregateProcedure } from "./documents.aggregate.js";
+// Index procedures
+export { listIndexesProcedure } from "./indexes.list.js";
+export { createIndexProcedure } from "./indexes.create.js";
+export { dropIndexProcedure } from "./indexes.drop.js";
+// Schema helper
+export { schema } from "./schema.js";
+//# sourceMappingURL=index.js.map

package/dist/procedures/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/procedures/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,sBAAsB;AACtB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,wBAAwB;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,sBAAsB;AACtB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,mBAAmB;AACnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,gBAAgB;AAChB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/procedures/indexes.create.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Procedure: mongo.indexes.create
+ * Create an index on a collection
+ */
+import { type Procedure } from "@procedures/client";
+import { type ScopeInput } from "../scope.js";
+import { type IndexSpec, type IndexOptions } from "../types.js";
+interface CreateIndexInput extends ScopeInput {
+    keys: IndexSpec;
+    options?: IndexOptions | undefined;
+}
+interface CreateIndexOutput {
+    acknowledged: boolean;
+    indexName: string;
+}
+export declare const createIndexProcedure: Procedure<CreateIndexInput, CreateIndexOutput, {
+    description: string;
+}>;
+export type { CreateIndexInput, CreateIndexOutput };
+//# sourceMappingURL=indexes.create.d.ts.map

package/dist/procedures/indexes.create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexes.create.d.ts","sourceRoot":"","sources":["../../src/procedures/indexes.create.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAA+B,KAAK,SAAS,EAAyB,MAAM,oBAAoB,CAAC;AACxG,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAI7D,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhE,UAAU,gBAAiB,SAAQ,UAAU;IAC3C,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CACpC;AAED,UAAU,iBAAiB;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AA0BD,eAAO,MAAM,oBAAoB,EAAE,SAAS,CAC1C,gBAAgB,EAChB,iBAAiB,EACjB;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAiBf,CAAC;AAEX,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/procedures/indexes.create.js

@@ -0,0 +1,44 @@
+/**
+ * Procedure: mongo.indexes.create
+ * Create an index on a collection
+ */
+import { createProcedure, zodAdapter } from "@procedures/client";
+import { collectionFor } from "../scope.js";
+import { scopeFields } from "./input-schemas.js";
+import { z } from "zod";
+import {} from "../types.js";
+// Schemas
+const createIndexInputSchema = zodAdapter(z.object({
+    ...scopeFields(),
+    keys: z
+        .record(z.string(), z.union([z.literal(1), z.literal(-1), z.literal("text"), z.literal("2dsphere")]))
+        .describe('The fields of the index and their order: 1, -1, "text" or "2dsphere"'),
+    options: z
+        .looseObject({
+        name: z.string().optional().describe("The name of the index"),
+        unique: z.boolean().optional().describe("A unique index"),
+        sparse: z.boolean().optional().describe("A sparse index"),
+    })
+        .optional()
+        .describe("The options of the index"),
+}));
+const createIndexOutputSchema = zodAdapter(z.looseObject({
+    acknowledged: z.boolean().describe("True when the server confirmed the write"),
+    indexName: z.string().describe("The name of the new index"),
+}));
+export const createIndexProcedure = createProcedure()
+    .path(["mongo", "indexes", "create"])
+    .input(createIndexInputSchema)
+    .output(createIndexOutputSchema)
+    .meta({ description: "Create an index on a collection" })
+    .handler(async (input, ctx) => {
+    const { collection } = await collectionFor(input, ctx);
+    // The schema leaves out an option that the input does not give: no option is undefined at run time
+    const indexName = await collection.createIndex(input.keys, input.options);
+    return {
+        acknowledged: true,
+        indexName,
+    };
+})
+    .build();
+//# sourceMappingURL=indexes.create.js.map

package/dist/procedures/indexes.create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexes.create.js","sourceRoot":"","sources":["../../src/procedures/indexes.create.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,UAAU,EAAyC,MAAM,oBAAoB,CAAC;AACxG,OAAO,EAAE,aAAa,EAAmB,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAqC,MAAM,aAAa,CAAC;AAahE,UAAU;AACV,MAAM,sBAAsB,GAAG,UAAU,CACvC,CAAC,CAAC,MAAM,CAAC;IACP,GAAG,WAAW,EAAE;IAChB,IAAI,EAAE,CAAC;SACJ,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;SACpG,QAAQ,CAAC,sEAAsE,CAAC;IACnF,OAAO,EAAE,CAAC;SACP,WAAW,CAAC;QACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QAC7D,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QACzD,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;KAC1D,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CAAC,0BAA0B,CAAC;CACxC,CAAC,CACH,CAAC;AACF,MAAM,uBAAuB,GAAG,UAAU,CACxC,CAAC,CAAC,WAAW,CAAC;IACZ,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IAC9E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;CAC5D,CAAC,CACH,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAI7B,eAAe,EAAE;KAClB,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;KACpC,KAAK,CAAC,sBAAsB,CAAC;KAC7B,MAAM,CAAC,uBAAuB,CAAC;KAC/B,IAAI,CAAC,EAAE,WAAW,EAAE,iCAAiC,EAAE,CAAC;KACxD,OAAO,CAAC,KAAK,EAAE,KAAuB,EAAE,GAAqB,EAAE,EAAE;IAChE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEvD,mGAAmG;IACnG,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAA2C,CAAC,CAAC;IAE9G,OAAO;QACL,YAAY,EAAE,IAAI;QAClB,SAAS;KACV,CAAC;AACJ,CAAC,CAAC;KACD,KAAK,EAAE,CAAC"}

package/dist/procedures/indexes.drop.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Procedure: mongo.indexes.drop
+ * Drop an index from a collection
+ */
+import { type Procedure } from "@procedures/client";
+import { type ScopeInput } from "../scope.js";
+interface DropIndexInput extends ScopeInput {
+    indexName: string;
+}
+interface DropIndexOutput {
+    acknowledged: boolean;
+}
+export declare const dropIndexProcedure: Procedure<DropIndexInput, DropIndexOutput, {
+    description: string;
+}>;
+export type { DropIndexInput, DropIndexOutput };
+//# sourceMappingURL=indexes.drop.d.ts.map

package/dist/procedures/indexes.drop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexes.drop.d.ts","sourceRoot":"","sources":["../../src/procedures/indexes.drop.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAA+B,KAAK,SAAS,EAAyB,MAAM,oBAAoB,CAAC;AACxG,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAK7D,UAAU,cAAe,SAAQ,UAAU;IACzC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,eAAe;IACvB,YAAY,EAAE,OAAO,CAAC;CACvB;AAeD,eAAO,MAAM,kBAAkB,EAAE,SAAS,CACxC,cAAc,EACd,eAAe,EACf;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAef,CAAC;AAEX,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,CAAC"}

package/dist/procedures/indexes.drop.js

@@ -0,0 +1,30 @@
+/**
+ * Procedure: mongo.indexes.drop
+ * Drop an index from a collection
+ */
+import { createProcedure, zodAdapter } from "@procedures/client";
+import { collectionFor } from "../scope.js";
+import { scopeFields } from "./input-schemas.js";
+import { z } from "zod";
+// Schemas
+const dropIndexInputSchema = zodAdapter(z.object({
+    ...scopeFields(),
+    indexName: z.string().min(1).describe("The name of the index to drop"),
+}));
+const dropIndexOutputSchema = zodAdapter(z.looseObject({
+    acknowledged: z.boolean().describe("True when the server confirmed the write"),
+}));
+export const dropIndexProcedure = createProcedure()
+    .path(["mongo", "indexes", "drop"])
+    .input(dropIndexInputSchema)
+    .output(dropIndexOutputSchema)
+    .meta({ description: "Drop an index from a collection" })
+    .handler(async (input, ctx) => {
+    const { collection } = await collectionFor(input, ctx);
+    await collection.dropIndex(input.indexName);
+    return {
+        acknowledged: true,
+    };
+})
+    .build();
+//# sourceMappingURL=indexes.drop.js.map

package/dist/procedures/indexes.drop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexes.drop.js","sourceRoot":"","sources":["../../src/procedures/indexes.drop.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,UAAU,EAAyC,MAAM,oBAAoB,CAAC;AACxG,OAAO,EAAE,aAAa,EAAmB,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,UAAU;AACV,MAAM,oBAAoB,GAAG,UAAU,CACrC,CAAC,CAAC,MAAM,CAAC;IACP,GAAG,WAAW,EAAE;IAChB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;CACvE,CAAC,CACH,CAAC;AACF,MAAM,qBAAqB,GAAG,UAAU,CACtC,CAAC,CAAC,WAAW,CAAC;IACZ,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;CAC/E,CAAC,CACH,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAI3B,eAAe,EAAE;KAClB,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;KAClC,KAAK,CAAC,oBAAoB,CAAC;KAC3B,MAAM,CAAC,qBAAqB,CAAC;KAC7B,IAAI,CAAC,EAAE,WAAW,EAAE,iCAAiC,EAAE,CAAC;KACxD,OAAO,CAAC,KAAK,EAAE,KAAqB,EAAE,GAAqB,EAAE,EAAE;IAC9D,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEvD,MAAM,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAE5C,OAAO;QACL,YAAY,EAAE,IAAI;KACnB,CAAC;AACJ,CAAC,CAAC;KACD,KAAK,EAAE,CAAC"}

package/dist/procedures/indexes.list.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Procedure: mongo.indexes.list
+ * List indexes on a collection
+ */
+import { type Procedure } from "@procedures/client";
+import { type ScopeInput } from "../scope.js";
+import { type IndexInfo } from "../types.js";
+/** The input: only the scope fields. */
+type ListIndexesInput = ScopeInput;
+interface ListIndexesOutput {
+    indexes: IndexInfo[];
+}
+export declare const listIndexesProcedure: Procedure<ListIndexesInput, ListIndexesOutput, {
+    description: string;
+}>;
+export type { ListIndexesInput, ListIndexesOutput };
+//# sourceMappingURL=indexes.list.d.ts.map

package/dist/procedures/indexes.list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexes.list.d.ts","sourceRoot":"","sources":["../../src/procedures/indexes.list.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAA+B,KAAK,SAAS,EAAyB,MAAM,oBAAoB,CAAC;AACxG,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAG7D,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,wCAAwC;AACxC,KAAK,gBAAgB,GAAG,UAAU,CAAC;AAEnC,UAAU,iBAAiB;IACzB,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAqBD,eAAO,MAAM,oBAAoB,EAAE,SAAS,CAC1C,gBAAgB,EAChB,iBAAiB,EACjB;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAoBf,CAAC;AAEX,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/procedures/indexes.list.js

@@ -0,0 +1,40 @@
+/**
+ * Procedure: mongo.indexes.list
+ * List indexes on a collection
+ */
+import { createProcedure, zodAdapter } from "@procedures/client";
+import { collectionFor } from "../scope.js";
+import { scopeFields } from "./input-schemas.js";
+import { z } from "zod";
+import {} from "../types.js";
+// Schemas
+const listIndexesInputSchema = zodAdapter(z.object({ ...scopeFields() }));
+const listIndexesOutputSchema = zodAdapter(z.looseObject({
+    indexes: z
+        .array(z.looseObject({
+        name: z.string().describe("The index name"),
+        key: z.record(z.string(), z.union([z.number(), z.string()])).describe("The fields of the index and their kind (1, -1, \"text\", \"hashed\")"),
+        unique: z.boolean().optional().describe("True for a unique index"),
+        sparse: z.boolean().optional().describe("True for a sparse index"),
+    }))
+        .describe("The indexes of the collection"),
+}));
+export const listIndexesProcedure = createProcedure()
+    .path(["mongo", "indexes", "list"])
+    .input(listIndexesInputSchema)
+    .output(listIndexesOutputSchema)
+    .meta({ description: "List indexes on a collection" })
+    .handler(async (input, ctx) => {
+    const { collection } = await collectionFor(input, ctx);
+    const indexes = await collection.listIndexes().toArray();
+    return {
+        indexes: indexes.map((idx) => ({
+            name: idx.name,
+            key: idx.key,
+            unique: idx.unique,
+            sparse: idx.sparse,
+        })),
+    };
+})
+    .build();
+//# sourceMappingURL=indexes.list.js.map

package/dist/procedures/indexes.list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexes.list.js","sourceRoot":"","sources":["../../src/procedures/indexes.list.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,UAAU,EAAyC,MAAM,oBAAoB,CAAC;AACxG,OAAO,EAAE,aAAa,EAAmB,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkB,MAAM,aAAa,CAAC;AAU7C,UAAU;AACV,MAAM,sBAAsB,GAAG,UAAU,CACvC,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,WAAW,EAAE,EAAE,CAAC,CAC/B,CAAC;AACF,MAAM,uBAAuB,GAAG,UAAU,CACxC,CAAC,CAAC,WAAW,CAAC;IACZ,OAAO,EAAE,CAAC;SACP,KAAK,CACJ,CAAC,CAAC,WAAW,CAAC;QACZ,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAC3C,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sEAAsE,CAAC;QAC7I,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QAClE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;KACnE,CAAC,CACH;SACA,QAAQ,CAAC,+BAA+B,CAAC;CAC7C,CAAC,CACH,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAI7B,eAAe,EAAE;KAClB,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;KAClC,KAAK,CAAC,sBAAsB,CAAC;KAC7B,MAAM,CAAC,uBAAuB,CAAC;KAC/B,IAAI,CAAC,EAAE,WAAW,EAAE,8BAA8B,EAAE,CAAC;KACrD,OAAO,CAAC,KAAK,EAAE,KAAuB,EAAE,GAAqB,EAAE,EAAE;IAChE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEvD,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,CAAC;IAEzD,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAC7B,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,MAAM,EAAE,GAAG,CAAC,MAAM;SACnB,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC,CAAC;KACD,KAAK,EAAE,CAAC"}

package/dist/procedures/input-schemas.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The shared fields of the mongo input schemas (roadmap 2.1).
+ *
+ * Each `mongo.*` tool describes its fields, so Claude and `mark --help` know them. Before, most
+ * tools had a pass-through schema: the tool list showed no fields, and a field name with a
+ * typing error reached the handler.
+ *
+ * A write (`update`, `delete`) and `find`/`get` keep their own parse functions: they check the
+ * target rules of deep dive DATA-4 (exactly one of `id` or `filter`, an unknown field is an
+ * error, an empty filter needs `confirm`). `described()` gives such a function the JSON Schema of
+ * a zod object that names the same fields.
+ */
+import { z } from "zod";
+import { type ZodLikeSchema } from "@procedures/client";
+/** The fields that select the database and the collection. */
+export declare function scopeFields(): {
+    collection: z.ZodOptional<z.ZodString>;
+    database: z.ZodOptional<z.ZodString>;
+};
+/** A MongoDB document or a filter: an object with any fields. */
+export declare function documentObject(): z.ZodRecord<z.ZodString, z.ZodUnknown>;
+/** The fields that select the documents of a write: one `id`, or a `filter`. */
+export declare function targetFields(): {
+    filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    id: z.ZodOptional<z.ZodString>;
+    idType: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        objectId: "objectId";
+        string: "string";
+    }>>;
+    multi: z.ZodOptional<z.ZodBoolean>;
+    confirm: z.ZodOptional<z.ZodBoolean>;
+};
+/** How to read a string id. */
+export declare function idTypeField(): z.ZodOptional<z.ZodEnum<{
+    auto: "auto";
+    objectId: "objectId";
+    string: "string";
+}>>;
+/**
+ * A schema whose validation is a parse function, and whose JSON Schema is the one of a zod object
+ * that names the same fields.
+ */
+export declare function described<T>(parse: (data: unknown) => T, fields: z.ZodObject): ZodLikeSchema<T>;
+//# sourceMappingURL=input-schemas.d.ts.map

package/dist/procedures/input-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-schemas.d.ts","sourceRoot":"","sources":["../../src/procedures/input-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAA4B,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAElF,8DAA8D;AAC9D,wBAAgB,WAAW,IAAI;IAAE,UAAU,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAAC,QAAQ,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;CAAE,CAK9G;AAED,iEAAiE;AACjE,wBAAgB,cAAc,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,CAEvE;AAED,gFAAgF;AAChF,wBAAgB,YAAY,IAAI;IAC9B,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IAC9D,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC/B,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,QAAQ,CAAA;KAAE,CAAC,CAAC,CAAC;IAC3F,KAAK,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IACnC,OAAO,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;CACtC,CAUA;AAED,+BAA+B;AAC/B,wBAAgB,WAAW,IAAI,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAC,CAKhH;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS,GAAG,aAAa,CAAC,CAAC,CAAC,CAE/F"}

package/dist/procedures/input-schemas.js

@@ -0,0 +1,52 @@
+/**
+ * The shared fields of the mongo input schemas (roadmap 2.1).
+ *
+ * Each `mongo.*` tool describes its fields, so Claude and `mark --help` know them. Before, most
+ * tools had a pass-through schema: the tool list showed no fields, and a field name with a
+ * typing error reached the handler.
+ *
+ * A write (`update`, `delete`) and `find`/`get` keep their own parse functions: they check the
+ * target rules of deep dive DATA-4 (exactly one of `id` or `filter`, an unknown field is an
+ * error, an empty filter needs `confirm`). `described()` gives such a function the JSON Schema of
+ * a zod object that names the same fields.
+ */
+import { z } from "zod";
+import { jsonSchemaOf, zodAdapter } from "@procedures/client";
+/** The fields that select the database and the collection. */
+export function scopeFields() {
+    return {
+        collection: z.string().min(1).optional().describe("The collection name. It takes the place of metadata.collection."),
+        database: z.string().min(1).optional().describe("The database name (default: the database of the connection)"),
+    };
+}
+/** A MongoDB document or a filter: an object with any fields. */
+export function documentObject() {
+    return z.record(z.string(), z.unknown());
+}
+/** The fields that select the documents of a write: one `id`, or a `filter`. */
+export function targetFields() {
+    return {
+        filter: documentObject()
+            .optional()
+            .describe("The filter of the documents (give exactly one of id or filter). An empty filter needs confirm: true."),
+        id: z.string().min(1).optional().describe("The id of one document (the alternative to filter)"),
+        idType: idTypeField(),
+        multi: z.boolean().optional().describe("Change every matching document, not only the first one"),
+        confirm: z.boolean().optional().describe("Set to true to use an empty filter, which matches every document"),
+    };
+}
+/** How to read a string id. */
+export function idTypeField() {
+    return z
+        .enum(["auto", "objectId", "string"])
+        .optional()
+        .describe('How to read the id: "auto" (the default: an ObjectId or a string), "objectId" or "string"');
+}
+/**
+ * A schema whose validation is a parse function, and whose JSON Schema is the one of a zod object
+ * that names the same fields.
+ */
+export function described(parse, fields) {
+    return Object.assign(zodAdapter({ parse }), { "~jsonSchema": jsonSchemaOf(fields) });
+}
+//# sourceMappingURL=input-schemas.js.map

package/dist/procedures/input-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-schemas.js","sourceRoot":"","sources":["../../src/procedures/input-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAsB,MAAM,oBAAoB,CAAC;AAElF,8DAA8D;AAC9D,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iEAAiE,CAAC;QACpH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;KAC/G,CAAC;AACJ,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,YAAY;IAO1B,OAAO;QACL,MAAM,EAAE,cAAc,EAAE;aACrB,QAAQ,EAAE;aACV,QAAQ,CAAC,sGAAsG,CAAC;QACnH,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;QAC/F,MAAM,EAAE,WAAW,EAAE;QACrB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;QAChG,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kEAAkE,CAAC;KAC7G,CAAC;AACJ,CAAC;AAED,+BAA+B;AAC/B,MAAM,UAAU,WAAW;IACzB,OAAO,CAAC;SACL,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;SACpC,QAAQ,EAAE;SACV,QAAQ,CAAC,2FAA2F,CAAC,CAAC;AAC3G,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAI,KAA2B,EAAE,MAAmB;IAC3E,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAI,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,aAAa,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAC1F,CAAC"}

package/dist/procedures/schema.d.ts

@@ -0,0 +1,2 @@
+export { outputSchema as schema } from "@procedures/client";
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/procedures/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,IAAI,MAAM,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/procedures/schema.js

@@ -0,0 +1,2 @@
+export { outputSchema as schema } from "@procedures/client";
+//# sourceMappingURL=schema.js.map

package/dist/procedures/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/procedures/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,IAAI,MAAM,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/procedures/target.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 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 { type Collection, type Document } from "mongodb";
+import { type DocumentQuery, type IdType } from "../types.js";
+import { type ScopeInput } from "../scope.js";
+/** The fields of a write target. */
+export interface TargetInput extends ScopeInput {
+    /** The filter of the documents to change. An empty filter needs `confirm: true`. */
+    filter?: DocumentQuery;
+    /** The ID of one document (the alternative to `filter`). */
+    id?: string;
+    /** How to read the ID (default: "auto", which matches an ObjectId or a string). */
+    idType?: IdType;
+    /** Change all matching documents, not only the first one. */
+    multi?: boolean;
+    /** Set to true to use an empty filter (it matches every document). */
+    confirm?: boolean;
+}
+/**
+ * This function reads and checks the target fields of a write input.
+ * `extraFields` are the other fields that the procedure accepts.
+ */
+export declare function parseTarget(procedure: string, data: unknown, extraFields?: readonly string[]): {
+    target: TargetInput;
+    raw: Record<string, unknown>;
+};
+/** The filter of a target. */
+export declare function targetFilter(target: TargetInput): Document;
+/**
+ * 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 declare function upsertFilter(collection: Collection<Document>, target: TargetInput): Promise<Document>;
+//# sourceMappingURL=target.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../src/procedures/target.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAY,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,EAAiB,KAAK,aAAa,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,EAA2B,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEvE,oCAAoC;AACpC,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,oFAAoF;IACpF,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sEAAsE;IACtE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAeD;;;GAGG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,OAAO,EACb,WAAW,GAAE,SAAS,MAAM,EAAO,GAClC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAsDvD;AAED,8BAA8B;AAC9B,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,CAE1D;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAK3G"}

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":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAkC,MAAM,SAAS,CAAC;AACnE,OAAO,EAAE,aAAa,EAAmC,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,SAAS,EAAmB,MAAM,aAAa,CAAC;AAgBvE,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,YAAY,CAAU,CAAC;AAE/F,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,eAAe,CAAC,SAAiB,EAAE,GAA4B,EAAE,KAAa;IACrF,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;IACzB,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,KAAK,KAAK,oBAAoB,CAAC,CAAC;IAC5F,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,SAAiB,EACjB,IAAa,EACb,WAAW,GAAsB,EAAE;IAEnC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,2BAA2B,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC;IACjB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,CAAC,GAAG,aAAa,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC;IACpE,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,oBAAoB,GAAG,KAAK,IAAI,oBAAoB,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC7G,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC;IACtC,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,SAAS,CAAC;IAC9C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,oCAAoC,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAEvB,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QACrB,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,iCAAiC,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;IACjB,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,4BAA4B,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,CAAC,MAAM,GAAG,MAAuB,CAAC;IAC1C,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YACtE,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,iDAAiD,CAAC,CAAC;QACjF,CAAC;QACD,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED,MAAM,KAAK,GAAG,eAAe,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,eAAe,CAAC,SAAS,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;IAC3D,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;IAC9C,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;IAEpD,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACjF,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,wEAAwE,CAAC,CAAC;IACxG,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;AACzB,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,YAAY,CAAC,MAAmB;IAC9C,OAAO,MAAM,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,MAAM,CAAC,MAAmB,CAAC;AACzG,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAAgC,EAAE,MAAmB;IACtF,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,MAAM,CAAC,EAAE,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,IAAI,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IACjE,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9E,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;AACvE,CAAC"}