firebase-mcp 0.3.0 → 0.3.3

package/dist/tools/firestore/operations/aggregate_collection.js.map

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

package/dist/tools/firestore/{count_documents.d.ts → operations/count_documents.d.ts}

@@ -1,7 +1,7 @@
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { ProjectContext } from '../../project';
-import { Task } from '../../task';
-import { QueryFilter } from './types';
+import type { ProjectContext } from '../../../project';
+import { Task } from '../../../task';
+import { QueryFilter } from '../utils/types';
 export declare class FirestoreCountError extends Error {
     readonly cause?: unknown | undefined;
     readonly _tag: "FirestoreCountError";
@@ -16,5 +16,5 @@ export declare const countDocumentsDefinition: Tool;
 export declare const countDocuments: (ctx: ProjectContext, input: CountDocumentsArgs) => Task<{
     collection: string;
     count: number;
-}, import("../../project").AccessDeniedError | FirestoreCountError>;
+}, import("../../../project").AccessDeniedError | FirestoreCountError>;
 //# sourceMappingURL=count_documents.d.ts.map

package/dist/tools/firestore/operations/count_documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"count_documents.d.ts","sourceRoot":"","sources":["../../../../src/tools/firestore/operations/count_documents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAErC,OAAO,EAAsB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEjE,qBAAa,mBAAoB,SAAQ,KAAK;IAEf,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;IADrD,QAAQ,CAAC,IAAI,EAAG,qBAAqB,CAAU;gBACnC,OAAO,EAAE,MAAM,EAAW,KAAK,CAAC,EAAE,OAAO,YAAA;CAItD;AAED,eAAO,MAAM,eAAe,EAAG,iBAA0B,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,eAAO,MAAM,wBAAwB,EAAE,IAuBtC,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,KAAK,cAAc,EAAE,OAAO,kBAAkB;;;sEA+BzE,CAAC"}

package/dist/tools/firestore/{count_documents.js → operations/count_documents.js}

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.countDocuments = exports.countDocumentsDefinition = exports.COUNT_DOCUMENTS = exports.FirestoreCountError = void 0;
-const task_1 = require("../../task");
-const types_1 = require("./types");
+const task_1 = require("../../../task");
+const paths_1 = require("../utils/paths");
+const types_1 = require("../utils/types");
 class FirestoreCountError extends Error {
     cause;
     _tag = 'FirestoreCountError';
@@ -38,6 +39,10 @@ exports.countDocumentsDefinition = {
     },
 };
 const countDocuments = (ctx, input) => task_1.Task.gen(function* () {
+    const err = (0, paths_1.collectionPathError)(input.collection);
+    if (err) {
+        return yield* task_1.Task.fail(new FirestoreCountError(err));
+    }
     yield* ctx.checkAccess(input.collection);
     const count = yield* task_1.Task.attempt({
         try: () => {

package/dist/tools/firestore/operations/count_documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"count_documents.js","sourceRoot":"","sources":["../../../../src/tools/firestore/operations/count_documents.ts"],"names":[],"mappings":";;;AAGA,wCAAqC;AACrC,0CAAqD;AACrD,0CAAiE;AAEjE,MAAa,mBAAoB,SAAQ,KAAK;IAEN;IAD7B,IAAI,GAAG,qBAA8B,CAAC;IAC/C,YAAY,OAAe,EAAW,KAAe;QACnD,KAAK,CAAC,OAAO,CAAC,CAAC;QADqB,UAAK,GAAL,KAAK,CAAU;QAEnD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAND,kDAMC;AAEY,QAAA,eAAe,GAAG,iBAA0B,CAAC;AAO7C,QAAA,wBAAwB,GAAS;IAC5C,IAAI,EAAE,uBAAe;IACrB,WAAW,EACT,6HAA6H;IAC/H,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oDAAoD;aAClE;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,mDAAmD;gBAChE,KAAK,EAAE,0BAAkB;aAC1B;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6CAA6C;aAC3D;SACF;QACD,QAAQ,EAAE,CAAC,YAAY,EAAE,WAAW,CAAC;KACtC;CACF,CAAC;AAEK,MAAM,cAAc,GAAG,CAAC,GAAmB,EAAE,KAAyB,EAAE,EAAE,CAC/E,WAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;IAChB,MAAM,GAAG,GAAG,IAAA,2BAAmB,EAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAClD,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,KAAK,CAAC,CAAC,WAAI,CAAC,IAAI,CAAC,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC;IACxD,CAAC;IACD,KAAK,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAEzC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,WAAI,CAAC,OAAO,CAAC;QAChC,GAAG,EAAE,GAAG,EAAE;YACR,IAAI,KAAK,GAA4B,GAAG;iBACrC,SAAS,EAAE;iBACX,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAEhC,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;gBACzC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YACnE,CAAC;YAED,OAAO,KAAK;iBACT,KAAK,EAAE;iBACP,GAAG,EAAE;iBACL,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC;QACD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,IAAI,mBAAmB,CACrB,iCAAiC,KAAK,CAAC,UAAU,EAAE,EACnD,KAAK,CACN;KACJ,CAAC,CAAC;IAEH,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC,CAAC,CAAC;AA/BQ,QAAA,cAAc,kBA+BtB"}

package/dist/tools/firestore/operations/distinct_values.d.ts

@@ -0,0 +1,59 @@
+import type { ProjectContext } from '../../../project';
+import { Task } from '../../../task';
+import { QueryFilter } from '../utils/types';
+export declare class FirestoreDistinctValuesError extends Error {
+    readonly cause?: unknown | undefined;
+    readonly _tag: "FirestoreDistinctValuesError";
+    constructor(message: string, cause?: unknown | undefined);
+}
+export declare const DISTINCT_VALUES: "distinct_values";
+export interface DistinctValuesArgs {
+    collection?: string;
+    collectionId?: string;
+    /** Single field shorthand. Use `fields` for multi-field grouping. */
+    field?: string;
+    /** Fields to fetch and group by. Use `groupByFields` to group on a subset while treating the rest as labels. */
+    fields?: string[];
+    /**
+     * Subset of `fields` to use as the grouping/identity key.
+     * Remaining fields are treated as labels: collected as arrays of unique values seen per group.
+     * Useful when a display name may vary slightly across collections but the ID field is stable.
+     */
+    groupByFields?: string[];
+    filters?: QueryFilter[];
+    groupByPathSegment?: number;
+    /**
+     * Only return values that appear in at least this many distinct collection buckets.
+     * Pass "all" to mean "present in every collection bucket found" without needing to
+     * know the total count upfront. Only applies when using collectionId. All values are
+     * annotated with collectionCount and collections[] regardless of whether this is set.
+     */
+    minCollections?: number | 'all';
+}
+type ScalarValue = string | null;
+export declare const distinctValues: (ctx: ProjectContext, input: DistinctValuesArgs) => Task<{
+    fields: string | string[];
+    totalDocsFetched: number;
+    values: {
+        value: ScalarValue | Record<string, string[] | ScalarValue>;
+        count: number;
+        collectionCount?: number;
+        collections?: string[];
+    }[];
+    byCollection: Record<string, {
+        value: ScalarValue | Record<string, ScalarValue>;
+        count: number;
+    }[]>;
+} | {
+    fields: string | string[];
+    totalDocsFetched: number;
+    values: {
+        value: ScalarValue | Record<string, string[] | ScalarValue>;
+        count: number;
+        collectionCount?: number;
+        collections?: string[];
+    }[];
+    byCollection?: undefined;
+}, import("../../../project").AccessDeniedError | FirestoreDistinctValuesError>;
+export {};
+//# sourceMappingURL=distinct_values.d.ts.map

package/dist/tools/firestore/operations/distinct_values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distinct_values.d.ts","sourceRoot":"","sources":["../../../../src/tools/firestore/operations/distinct_values.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,qBAAa,4BAA6B,SAAQ,KAAK;IAInD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;IAH1B,QAAQ,CAAC,IAAI,EAAG,8BAA8B,CAAU;gBAEtD,OAAO,EAAE,MAAM,EACN,KAAK,CAAC,EAAE,OAAO,YAAA;CAK3B;AAED,eAAO,MAAM,eAAe,EAAG,iBAA0B,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gHAAgH;IAChH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CACjC;AAED,KAAK,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC;AAgBjC,eAAO,MAAM,cAAc,GACzB,KAAK,cAAc,EACnB,OAAO,kBAAkB;;;;;eA6JV,MAAM;0BACK,MAAM;sBACV,MAAM,EAAE;;;eA0Bf,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC;eAAS,MAAM;;;;;;;eA5BxD,MAAM;0BACK,MAAM;sBACV,MAAM,EAAE;;;+EAsD5B,CAAC"}

package/dist/tools/firestore/operations/distinct_values.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.distinctValues = exports.DISTINCT_VALUES = exports.FirestoreDistinctValuesError = void 0;
+const task_1 = require("../../../task");
+const paths_1 = require("../utils/paths");
+class FirestoreDistinctValuesError extends Error {
+    cause;
+    _tag = 'FirestoreDistinctValuesError';
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'FirestoreDistinctValuesError';
+    }
+}
+exports.FirestoreDistinctValuesError = FirestoreDistinctValuesError;
+exports.DISTINCT_VALUES = 'distinct_values';
+const rawToScalar = (raw) => raw === undefined || raw === null ? null : String(raw);
+const makeCompositeKey = (values) => values.length === 1
+    ? (values[0] ?? '__null__')
+    : JSON.stringify(values.map((v) => v ?? '__null__'));
+const parseCompositeKey = (key, fieldCount) => {
+    if (fieldCount === 1)
+        return [key === '__null__' ? null : key];
+    const parts = JSON.parse(key);
+    return parts.map((p) => (p === '__null__' ? null : p));
+};
+const distinctValues = (ctx, input) => task_1.Task.gen(function* () {
+    const { collection, collectionId, filters, groupByPathSegment, minCollections, } = input;
+    const fieldList = input.fields?.length
+        ? input.fields
+        : input.field
+            ? [input.field]
+            : [];
+    if (fieldList.length === 0) {
+        return yield* task_1.Task.fail(new FirestoreDistinctValuesError('Either field or fields is required.'));
+    }
+    // Validate groupByFields is a non-empty subset of fieldList
+    const groupByFields = input.groupByFields ?? fieldList;
+    const invalidGroupBy = groupByFields.filter((f) => !fieldList.includes(f));
+    if (invalidGroupBy.length > 0) {
+        return yield* task_1.Task.fail(new FirestoreDistinctValuesError(`groupByFields contains fields not present in fields[]: ${invalidGroupBy.join(', ')}`));
+    }
+    const labelFields = fieldList.filter((f) => !groupByFields.includes(f));
+    if (!collection && !collectionId) {
+        return yield* task_1.Task.fail(new FirestoreDistinctValuesError('Either collection or collectionId is required.'));
+    }
+    if (collection && collectionId) {
+        return yield* task_1.Task.fail(new FirestoreDistinctValuesError('Provide either collection or collectionId, not both.'));
+    }
+    if (collection) {
+        const err = (0, paths_1.collectionPathError)(collection);
+        if (err)
+            return yield* task_1.Task.fail(new FirestoreDistinctValuesError(err));
+        yield* ctx.checkAccess(collection);
+    }
+    const db = ctx.firestore();
+    const fetchLimit = ctx.config.firestore.maxBatchFetchSize;
+    // groupKey -> count
+    const globalCounts = new Map();
+    // groupKey -> labelField -> Set of unique values seen
+    const labelMap = labelFields.length > 0
+        ? new Map()
+        : null;
+    // collKey -> groupKey -> count (only in collection group mode)
+    const byColl = collectionId ? new Map() : null;
+    let lastDoc = null;
+    let totalFetched = 0;
+    while (true) {
+        const snapshot = yield* task_1.Task.attempt({
+            try: () => {
+                let query = collection
+                    ? db.collection(collection).select(...fieldList)
+                    : db.collectionGroup(collectionId).select(...fieldList);
+                for (const filter of filters ?? []) {
+                    query = query.where(filter.field, filter.operator, filter.value);
+                }
+                if (lastDoc)
+                    query = query.startAfter(lastDoc);
+                return query.limit(fetchLimit).get();
+            },
+            catch: (cause) => new FirestoreDistinctValuesError(`Failed to fetch documents from: ${collection ?? collectionId}`, cause),
+        });
+        for (const doc of snapshot.docs) {
+            const groupKey = makeCompositeKey(groupByFields.map((f) => rawToScalar(doc.get(f))));
+            globalCounts.set(groupKey, (globalCounts.get(groupKey) ?? 0) + 1);
+            if (labelMap) {
+                if (!labelMap.has(groupKey))
+                    labelMap.set(groupKey, new Map());
+                const fieldSets = labelMap.get(groupKey);
+                for (const f of labelFields) {
+                    if (!fieldSets.has(f))
+                        fieldSets.set(f, new Set());
+                    const v = rawToScalar(doc.get(f));
+                    if (v !== null)
+                        fieldSets.get(f).add(v);
+                }
+            }
+            if (byColl) {
+                const collPath = doc.ref.parent.path;
+                const collKey = groupByPathSegment !== undefined
+                    ? (collPath.split('/')[groupByPathSegment] ?? collPath)
+                    : collPath;
+                if (!byColl.has(collKey))
+                    byColl.set(collKey, new Map());
+                const colCounts = byColl.get(collKey);
+                colCounts.set(groupKey, (colCounts.get(groupKey) ?? 0) + 1);
+            }
+        }
+        totalFetched += snapshot.docs.length;
+        if (snapshot.docs.length < fetchLimit)
+            break;
+        lastDoc = snapshot.docs[snapshot.docs.length - 1];
+    }
+    const resolvedMinCollections = minCollections === 'all' ? (byColl?.size ?? 0) : minCollections;
+    // Build the values array
+    const values = Array.from(globalCounts.entries())
+        .map(([groupKey, count]) => {
+        const groupScalars = parseCompositeKey(groupKey, groupByFields.length);
+        // Build the value object
+        let value;
+        if (labelFields.length === 0 && groupByFields.length === 1) {
+            // Simple single-field case: value is a plain scalar
+            value = groupScalars[0];
+        }
+        else {
+            const obj = Object.fromEntries(groupByFields.map((f, i) => [f, groupScalars[i]]));
+            if (labelMap) {
+                const fieldSets = labelMap.get(groupKey);
+                for (const f of labelFields) {
+                    obj[f] = fieldSets?.get(f) ? Array.from(fieldSets.get(f)) : [];
+                }
+            }
+            value = obj;
+        }
+        const entry = { value, count };
+        if (byColl) {
+            const collections = Array.from(byColl.entries())
+                .filter(([, colCounts]) => colCounts.has(groupKey))
+                .map(([collKey]) => collKey);
+            entry.collectionCount = collections.length;
+            entry.collections = collections;
+        }
+        return entry;
+    })
+        .filter((e) => resolvedMinCollections === undefined ||
+        (e.collectionCount ?? 0) >= resolvedMinCollections)
+        .sort((a, b) => b.count - a.count);
+    const resolvedFields = fieldList.length === 1 ? fieldList[0] : fieldList;
+    if (byColl) {
+        // byCollection uses the same groupKey → scalar value mapping (no labels needed per-bucket)
+        const byCollection = {};
+        for (const [collKey, colCounts] of byColl.entries()) {
+            byCollection[collKey] = Array.from(colCounts.entries())
+                .map(([groupKey, count]) => {
+                const groupScalars = parseCompositeKey(groupKey, groupByFields.length);
+                const value = groupByFields.length === 1
+                    ? groupScalars[0]
+                    : Object.fromEntries(groupByFields.map((f, i) => [f, groupScalars[i]]));
+                return { value, count };
+            })
+                .sort((a, b) => b.count - a.count);
+        }
+        return {
+            fields: resolvedFields,
+            totalDocsFetched: totalFetched,
+            values,
+            byCollection,
+        };
+    }
+    return { fields: resolvedFields, totalDocsFetched: totalFetched, values };
+});
+exports.distinctValues = distinctValues;
+//# sourceMappingURL=distinct_values.js.map

package/dist/tools/firestore/operations/distinct_values.js.map

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

package/dist/tools/firestore/{get_collection_schema.d.ts → operations/get_collection_schema.d.ts}

@@ -1,6 +1,6 @@
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { ProjectContext } from '../../project';
-import { Task } from '../../task';
+import type { ProjectContext } from '../../../project';
+import { Task } from '../../../task';
 export declare class FirestoreSchemaError extends Error {
     readonly cause?: unknown | undefined;
     readonly _tag: "FirestoreSchemaError";
@@ -21,5 +21,5 @@ export declare const getCollectionSchema: (ctx: ProjectContext, input: GetCollec
     totalSampled: number;
     sampleStrategy: string;
     fields: Record<string, FieldSchema>;
-}, import("../../project").AccessDeniedError | FirestoreSchemaError>;
+}, import("../../../project").AccessDeniedError | FirestoreSchemaError>;
 //# sourceMappingURL=get_collection_schema.d.ts.map

package/dist/tools/firestore/operations/get_collection_schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_collection_schema.d.ts","sourceRoot":"","sources":["../../../../src/tools/firestore/operations/get_collection_schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAG1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAGrC,qBAAa,oBAAqB,SAAQ,KAAK;IAI3C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;IAH1B,QAAQ,CAAC,IAAI,EAAG,sBAAsB,CAAU;gBAE9C,OAAO,EAAE,MAAM,EACN,KAAK,CAAC,EAAE,OAAO,YAAA;CAK3B;AAED,eAAO,MAAM,qBAAqB,EAAG,uBAAgC,CAAC;AAEtE,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAqBD,eAAO,MAAM,6BAA6B,EAAE,IAwB3C,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC9B,KAAK,cAAc,EACnB,OAAO,uBAAuB;;;;;uEAuF5B,CAAC"}

package/dist/tools/firestore/{get_collection_schema.js → operations/get_collection_schema.js}

@@ -5,7 +5,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCollectionSchema = exports.getCollectionSchemaDefinition = exports.GET_COLLECTION_SCHEMA = exports.FirestoreSchemaError = void 0;
 const firebase_admin_1 = __importDefault(require("firebase-admin"));
-const task_1 = require("../../task");
+const task_1 = require("../../../task");
+const paths_1 = require("../utils/paths");
 class FirestoreSchemaError extends Error {
     cause;
     _tag = 'FirestoreSchemaError';
@@ -66,6 +67,10 @@ exports.getCollectionSchemaDefinition = {
     },
 };
 const getCollectionSchema = (ctx, input) => task_1.Task.gen(function* () {
+    const err = (0, paths_1.collectionPathError)(input.collection);
+    if (err) {
+        return yield* task_1.Task.fail(new FirestoreSchemaError(err));
+    }
     yield* ctx.checkAccess(input.collection);
     const db = ctx.firestore();
     const total = input.sampleSize ?? 20;

package/dist/tools/firestore/operations/get_collection_schema.js.map

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

package/dist/tools/firestore/{get_document.d.ts → operations/get_document.d.ts}

@@ -1,6 +1,6 @@
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { ProjectContext } from '../../project';
-import { Task } from '../../task';
+import type { ProjectContext } from '../../../project';
+import { Task } from '../../../task';
 export declare class FirestoreGetError extends Error {
     readonly cause?: unknown | undefined;
     readonly _tag: "FirestoreGetError";
@@ -18,8 +18,9 @@ export interface GetDocumentArgs {
 }
 export declare const getDocumentDefinition: Tool;
 export declare const getDocument: (ctx: ProjectContext, input: GetDocumentArgs) => Task<{
+    collections: string[];
     id: string;
     path: string;
     data: unknown;
-}, import("../../project").AccessDeniedError | FirestoreGetError | DocumentNotFoundError>;
+}, import("../../../project").AccessDeniedError | FirestoreGetError | DocumentNotFoundError>;
 //# sourceMappingURL=get_document.d.ts.map

package/dist/tools/firestore/operations/get_document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_document.d.ts","sourceRoot":"","sources":["../../../../src/tools/firestore/operations/get_document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAIrC,qBAAa,iBAAkB,SAAQ,KAAK;IAIxC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;IAH1B,QAAQ,CAAC,IAAI,EAAG,mBAAmB,CAAU;gBAE3C,OAAO,EAAE,MAAM,EACN,KAAK,CAAC,EAAE,OAAO,YAAA;CAK3B;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAElC,QAAQ,CAAC,IAAI,EAAE,MAAM;IADjC,QAAQ,CAAC,IAAI,EAAG,uBAAuB,CAAU;gBAC5B,IAAI,EAAE,MAAM;CAIlC;AAED,eAAO,MAAM,YAAY,EAAG,cAAuB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,eAAO,MAAM,qBAAqB,EAAE,IAuBnC,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,KAAK,cAAc,EAAE,OAAO,eAAe;;;;;4FAsCnE,CAAC"}

package/dist/tools/firestore/{get_document.js → operations/get_document.js}

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getDocument = exports.getDocumentDefinition = exports.GET_DOCUMENT = exports.DocumentNotFoundError = exports.FirestoreGetError = void 0;
-const task_1 = require("../../task");
-const types_1 = require("./types");
+const task_1 = require("../../../task");
+const paths_1 = require("../utils/paths");
+const types_1 = require("../utils/types");
 class FirestoreGetError extends Error {
     cause;
     _tag = 'FirestoreGetError';
@@ -48,24 +49,34 @@ exports.getDocumentDefinition = {
     },
 };
 const getDocument = (ctx, input) => task_1.Task.gen(function* () {
+    const err = (0, paths_1.documentPathError)(input.path);
+    if (err) {
+        return yield* task_1.Task.fail(new FirestoreGetError(err));
+    }
     yield* ctx.checkAccess(input.path);
     const db = ctx.firestore();
     const docRef = yield* task_1.Task.attempt({
         try: () => db.doc(input.path),
         catch: (cause) => new FirestoreGetError(`Invalid document path: ${input.path}`, cause),
     });
-    const snap = yield* task_1.Task.attempt({
-        try: () => input.select?.length
-            ? db
-                .getAll(docRef, { fieldMask: input.select })
-                .then((snaps) => snaps[0])
-            : docRef.get(),
+    const [snap, subcollections] = yield* task_1.Task.attempt({
+        try: () => Promise.all([
+            input.select?.length
+                ? db
+                    .getAll(docRef, { fieldMask: input.select })
+                    .then((snaps) => snaps[0])
+                : docRef.get(),
+            docRef.listCollections(),
+        ]),
         catch: (cause) => new FirestoreGetError(`Failed to get document: ${input.path}`, cause),
     });
     if (!snap.exists) {
         return yield* task_1.Task.fail(new DocumentNotFoundError(input.path));
     }
-    return (0, types_1.normalizeDocument)(snap);
+    return {
+        ...(0, types_1.normalizeDocument)(snap),
+        collections: subcollections.map((c) => c.path),
+    };
 });
 exports.getDocument = getDocument;
 //# sourceMappingURL=get_document.js.map

package/dist/tools/firestore/operations/get_document.js.map

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

package/dist/tools/firestore/{get_many_documents.d.ts → operations/get_many_documents.d.ts}

@@ -1,6 +1,6 @@
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { ProjectContext } from '../../project';
-import { Task } from '../../task';
+import type { ProjectContext } from '../../../project';
+import { Task } from '../../../task';
 export declare class FirestoreGetManyError extends Error {
     readonly cause?: unknown | undefined;
     readonly _tag: "FirestoreGetManyError";
@@ -23,5 +23,5 @@ export declare const getManyDocuments: (ctx: ProjectContext, input: GetManyDocum
     found: boolean;
     id: string;
     path: string;
-})[], import("../../project").AccessDeniedError | FirestoreGetManyError>;
+})[], import("../../../project").AccessDeniedError | FirestoreGetManyError>;
 //# sourceMappingURL=get_many_documents.d.ts.map

package/dist/tools/firestore/operations/get_many_documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_many_documents.d.ts","sourceRoot":"","sources":["../../../../src/tools/firestore/operations/get_many_documents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAIrC,qBAAa,qBAAsB,SAAQ,KAAK;IAEjB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;IADrD,QAAQ,CAAC,IAAI,EAAG,uBAAuB,CAAU;gBACrC,OAAO,EAAE,MAAM,EAAW,KAAK,CAAC,EAAE,OAAO,YAAA;CAItD;AAED,eAAO,MAAM,kBAAkB,EAAG,oBAA6B,CAAC;AAEhE,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,eAAO,MAAM,0BAA0B,EAAE,IAqCxC,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,KAAK,cAAc,EACnB,OAAO,oBAAoB;;;;;;;;;2EA8DzB,CAAC"}

package/dist/tools/firestore/{get_many_documents.js → operations/get_many_documents.js}

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getManyDocuments = exports.getManyDocumentsDefinition = exports.GET_MANY_DOCUMENTS = exports.FirestoreGetManyError = void 0;
-const task_1 = require("../../task");
-const types_1 = require("./types");
+const task_1 = require("../../../task");
+const paths_1 = require("../utils/paths");
+const types_1 = require("../utils/types");
 class FirestoreGetManyError extends Error {
     cause;
     _tag = 'FirestoreGetManyError';
@@ -52,9 +53,19 @@ const getManyDocuments = (ctx, input) => task_1.Task.gen(function* () {
     const maxBatchSize = ctx.config.firestore.maxBatchFetchSize;
     let allPaths = [];
     if (input.paths?.length) {
+        for (const p of input.paths) {
+            const err = (0, paths_1.documentPathError)(p);
+            if (err) {
+                return yield* task_1.Task.fail(new FirestoreGetManyError(err));
+            }
+        }
         allPaths = input.paths;
     }
     else if (input.collection && input.ids?.length) {
+        const collErr = (0, paths_1.collectionPathError)(input.collection);
+        if (collErr) {
+            return yield* task_1.Task.fail(new FirestoreGetManyError(collErr));
+        }
         allPaths = input.ids.map((id) => `${input.collection}/${id}`);
     }
     else {

package/dist/tools/firestore/operations/get_many_documents.js.map

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

package/dist/tools/firestore/{list_collections.d.ts → operations/list_collections.d.ts}

@@ -1,6 +1,6 @@
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { ProjectContext } from '../../project';
-import { Task } from '../../task';
+import type { ProjectContext } from '../../../project';
+import { Task } from '../../../task';
 export declare class FirestoreListCollectionsError extends Error {
     readonly cause?: unknown | undefined;
     readonly _tag: "FirestoreListCollectionsError";
@@ -15,5 +15,5 @@ export declare const listCollectionsDefinition: Tool;
 export declare const listCollections: (ctx: ProjectContext, input: ListCollectionsArgs) => Task<{
     id: string;
     path: string;
-}[], import("../../project").AccessDeniedError | FirestoreListCollectionsError>;
+}[], import("../../../project").AccessDeniedError | FirestoreListCollectionsError>;
 //# sourceMappingURL=list_collections.d.ts.map

package/dist/tools/firestore/operations/list_collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_collections.d.ts","sourceRoot":"","sources":["../../../../src/tools/firestore/operations/list_collections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAGrC,qBAAa,6BAA8B,SAAQ,KAAK;IAEzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;IADrD,QAAQ,CAAC,IAAI,EAAG,+BAA+B,CAAU;gBAC7C,OAAO,EAAE,MAAM,EAAW,KAAK,CAAC,EAAE,OAAO,YAAA;CAItD;AAED,eAAO,MAAM,gBAAgB,EAAG,kBAA2B,CAAC;AAE5D,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,eAAO,MAAM,yBAAyB,EAAE,IAwBvC,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,KAAK,cAAc,EACnB,OAAO,mBAAmB;;;kFA8CxB,CAAC"}

package/dist/tools/firestore/{list_collections.js → operations/list_collections.js}

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.listCollections = exports.listCollectionsDefinition = exports.LIST_COLLECTIONS = exports.FirestoreListCollectionsError = void 0;
-const task_1 = require("../../task");
+const task_1 = require("../../../task");
+const paths_1 = require("../utils/paths");
 class FirestoreListCollectionsError extends Error {
     cause;
     _tag = 'FirestoreListCollectionsError';
@@ -38,6 +39,10 @@ exports.listCollectionsDefinition = {
 const listCollections = (ctx, input) => task_1.Task.gen(function* () {
     const db = ctx.firestore();
     if (input.path) {
+        const err = (0, paths_1.documentPathError)(input.path);
+        if (err) {
+            return yield* task_1.Task.fail(new FirestoreListCollectionsError(err));
+        }
         yield* ctx.checkAccess(input.path);
     }
     const collections = yield* task_1.Task.attempt({

package/dist/tools/firestore/operations/list_collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_collections.js","sourceRoot":"","sources":["../../../../src/tools/firestore/operations/list_collections.ts"],"names":[],"mappings":";;;AAGA,wCAAqC;AACrC,0CAAmD;AAEnD,MAAa,6BAA8B,SAAQ,KAAK;IAEhB;IAD7B,IAAI,GAAG,+BAAwC,CAAC;IACzD,YAAY,OAAe,EAAW,KAAe;QACnD,KAAK,CAAC,OAAO,CAAC,CAAC;QADqB,UAAK,GAAL,KAAK,CAAU;QAEnD,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC9C,CAAC;CACF;AAND,sEAMC;AAEY,QAAA,gBAAgB,GAAG,kBAA2B,CAAC;AAO/C,QAAA,yBAAyB,GAAS;IAC7C,IAAI,EAAE,wBAAgB;IACtB,WAAW,EACT,kIAAkI;IACpI,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,6GAA6G;aAChH;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,iKAAiK;aACpK;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6CAA6C;aAC3D;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;CACF,CAAC;AAEK,MAAM,eAAe,GAAG,CAC7B,GAAmB,EACnB,KAA0B,EAC1B,EAAE,CACF,WAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;IAChB,MAAM,EAAE,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC;IAE3B,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,IAAA,yBAAiB,EAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,GAAG,EAAE,CAAC;YACR,OAAO,KAAK,CAAC,CAAC,WAAI,CAAC,IAAI,CAAC,IAAI,6BAA6B,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,CAAC;QACD,KAAK,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,WAAI,CAAC,OAAO,CAAC;QACtC,GAAG,EAAE,GAAG,EAAE,CACR,KAAK,CAAC,IAAI;YACR,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE;YACtC,CAAC,CAAC,EAAE,CAAC,eAAe,EAAE;QAC1B,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,IAAI,6BAA6B,CAC/B,KAAK,CAAC,IAAI;YACR,CAAC,CAAC,qCAAqC,KAAK,CAAC,IAAI,EAAE;YACnD,CAAC,CAAC,iCAAiC,EACrC,KAAK,CACN;KACJ,CAAC,CAAC;IAEH,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,WAAI,CAAC,OAAO,CAAC;YAClC,GAAG,EAAE,GAAG,EAAE,CACR,OAAO,CAAC,GAAG,CACT,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC5B,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC;gBACrC,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;YAClE,CAAC,CAAC,CACH;YACH,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,IAAI,6BAA6B,CAC/B,sCAAsC,EACtC,KAAK,CACN;SACJ,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACpE,CAAC,CAAC,CAAC;AAhDQ,QAAA,eAAe,mBAgDvB"}

package/dist/tools/firestore/{list_documents.d.ts → operations/list_documents.d.ts}

@@ -1,6 +1,6 @@
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { ProjectContext } from '../../project';
-import { Task } from '../../task';
+import type { ProjectContext } from '../../../project';
+import { Task } from '../../../task';
 export declare class FirestoreListDocumentsError extends Error {
     readonly cause?: unknown | undefined;
     readonly _tag: "FirestoreListDocumentsError";
@@ -9,11 +9,11 @@ export declare class FirestoreListDocumentsError extends Error {
 export declare const LIST_DOCUMENTS: "list_documents";
 export interface ListDocumentsArgs {
     collection: string;
-    includeCollections?: boolean;
 }
 export declare const listDocumentsDefinition: Tool;
 export declare const listDocuments: (ctx: ProjectContext, input: ListDocumentsArgs) => Task<{
     id: string;
     path: string;
-}[], import("../../project").AccessDeniedError | FirestoreListDocumentsError>;
+    collections: string[];
+}[], import("../../../project").AccessDeniedError | FirestoreListDocumentsError>;
 //# sourceMappingURL=list_documents.d.ts.map

package/dist/tools/firestore/operations/list_documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_documents.d.ts","sourceRoot":"","sources":["../../../../src/tools/firestore/operations/list_documents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAGrC,qBAAa,2BAA4B,SAAQ,KAAK;IAEvB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;IADrD,QAAQ,CAAC,IAAI,EAAG,6BAA6B,CAAU;gBAC3C,OAAO,EAAE,MAAM,EAAW,KAAK,CAAC,EAAE,OAAO,YAAA;CAItD;AAED,eAAO,MAAM,cAAc,EAAG,gBAAyB,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,uBAAuB,EAAE,IAmBrC,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,KAAK,cAAc,EAAE,OAAO,iBAAiB;;;;gFAsCvE,CAAC"}