firebase-mcp 0.1.0

package/dist/tools/firestore/list_collections.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listCollections = exports.listCollectionsDefinition = exports.LIST_COLLECTIONS = exports.FirestoreListCollectionsError = void 0;
+const effect_1 = require("effect");
+const access_1 = require("../../access");
+const firebase_1 = require("../../firebase");
+class FirestoreListCollectionsError extends effect_1.Data.TaggedError('FirestoreListCollectionsError') {
+}
+exports.FirestoreListCollectionsError = FirestoreListCollectionsError;
+exports.LIST_COLLECTIONS = 'list_collections';
+exports.listCollectionsDefinition = {
+    name: exports.LIST_COLLECTIONS,
+    description: 'List Firestore collections. Omit path to list all root-level collections, or provide a document path to list its subcollections.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: "Optional document path whose subcollections to list, e.g. 'users/123'. Omit to list root-level collections.",
+            },
+            includeCounts: {
+                type: 'boolean',
+                description: 'If true, includes the document count for each collection. Useful for quickly understanding the scale of each collection without separate count_documents calls.',
+            },
+        },
+    },
+};
+const listCollections = (input) => effect_1.Effect.gen(function* () {
+    const { firestore } = yield* firebase_1.FirebaseService;
+    if (input.path) {
+        const access = yield* access_1.AccessService;
+        yield* access.check(input.path);
+    }
+    const collections = yield* effect_1.Effect.tryPromise({
+        try: () => input.path
+            ? firestore().doc(input.path).listCollections()
+            : firestore().listCollections(),
+        catch: (cause) => new FirestoreListCollectionsError({
+            message: input.path
+                ? `Failed to list subcollections of: ${input.path}`
+                : 'Failed to list root collections',
+            cause,
+        }),
+    });
+    if (input.includeCounts) {
+        const results = yield* effect_1.Effect.tryPromise({
+            try: () => Promise.all(collections.map(async (col) => {
+                const snap = await col.count().get();
+                return { id: col.id, path: col.path, count: snap.data().count };
+            })),
+            catch: (cause) => new FirestoreListCollectionsError({
+                message: 'Failed to get counts for collections',
+                cause,
+            }),
+        });
+        return results;
+    }
+    return collections.map((col) => ({ id: col.id, path: col.path }));
+});
+exports.listCollections = listCollections;
+//# sourceMappingURL=list_collections.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list_collections.js","sourceRoot":"","sources":["../../../src/tools/firestore/list_collections.ts"],"names":[],"mappings":";;;AACA,mCAAsC;AAEtC,yCAA6C;AAC7C,6CAAiD;AAEjD,MAAa,6BAA8B,SAAQ,aAAI,CAAC,WAAW,CACjE,+BAA+B,CAI/B;CAAG;AALL,sEAKK;AAEQ,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;SACF;KACF;CACF,CAAC;AAEK,MAAM,eAAe,GAAG,CAAC,KAA0B,EAAE,EAAE,CAC5D,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,CAAC,0BAAe,CAAC;IAE7C,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,sBAAa,CAAC;QACpC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,eAAM,CAAC,UAAU,CAAC;QAC3C,GAAG,EAAE,GAAG,EAAE,CACR,KAAK,CAAC,IAAI;YACR,CAAC,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE;YAC/C,CAAC,CAAC,SAAS,EAAE,CAAC,eAAe,EAAE;QACnC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,IAAI,6BAA6B,CAAC;YAChC,OAAO,EAAE,KAAK,CAAC,IAAI;gBACjB,CAAC,CAAC,qCAAqC,KAAK,CAAC,IAAI,EAAE;gBACnD,CAAC,CAAC,iCAAiC;YACrC,KAAK;SACN,CAAC;KACL,CAAC,CAAC;IAEH,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,eAAM,CAAC,UAAU,CAAC;YACvC,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,CAAC;gBAChC,OAAO,EAAE,sCAAsC;gBAC/C,KAAK;aACN,CAAC;SACL,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;AA1CQ,QAAA,eAAe,mBA0CvB"}

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

@@ -0,0 +1,24 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { Effect } from 'effect';
+import { AccessService } from '../../access';
+import { FirebaseService } from '../../firebase';
+declare const FirestoreListDocumentsError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "FirestoreListDocumentsError";
+} & Readonly<A>;
+export declare class FirestoreListDocumentsError extends FirestoreListDocumentsError_base<{
+    readonly message: string;
+    readonly cause?: unknown;
+}> {
+}
+export declare const LIST_DOCUMENTS: "list_documents";
+export interface ListDocumentsArgs {
+    collection: string;
+    includeCollections?: boolean;
+}
+export declare const listDocumentsDefinition: Tool;
+export declare const listDocuments: (input: ListDocumentsArgs) => Effect.Effect<{
+    id: string;
+    path: string;
+}[], import("../../access").AccessDeniedError | FirestoreListDocumentsError, AccessService | FirebaseService>;
+export {};
+//# sourceMappingURL=list_documents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list_documents.d.ts","sourceRoot":"","sources":["../../../src/tools/firestore/list_documents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAQ,MAAM,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;;;;AAEjD,qBAAa,2BAA4B,SAAQ,iCAE/C;IACA,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;CAAG;AAEL,eAAO,MAAM,cAAc,EAAG,gBAAyB,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,eAAO,MAAM,uBAAuB,EAAE,IAoBrC,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,OAAO,iBAAiB;;;6GAuClD,CAAC"}

package/dist/tools/firestore/list_documents.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listDocuments = exports.listDocumentsDefinition = exports.LIST_DOCUMENTS = exports.FirestoreListDocumentsError = void 0;
+const effect_1 = require("effect");
+const access_1 = require("../../access");
+const firebase_1 = require("../../firebase");
+class FirestoreListDocumentsError extends effect_1.Data.TaggedError('FirestoreListDocumentsError') {
+}
+exports.FirestoreListDocumentsError = FirestoreListDocumentsError;
+exports.LIST_DOCUMENTS = 'list_documents';
+exports.listDocumentsDefinition = {
+    name: exports.LIST_DOCUMENTS,
+    description: 'List all document IDs in a Firestore collection, including phantom documents (documents with no fields that exist only as parents of subcollections). Use this when read_collection returns empty but subcollections are known to exist.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            collection: {
+                type: 'string',
+                description: "Collection path, e.g. 'users' or 'shared/stores_data/ABC123'",
+            },
+            includeCollections: {
+                type: 'boolean',
+                description: 'If true, also lists the subcollections of each document alongside its ID. Useful when exploring unknown structure to avoid a follow-up list_collections call per document.',
+            },
+        },
+        required: ['collection'],
+    },
+};
+const listDocuments = (input) => effect_1.Effect.gen(function* () {
+    const access = yield* access_1.AccessService;
+    yield* access.check(input.collection);
+    const { firestore } = yield* firebase_1.FirebaseService;
+    const refs = yield* effect_1.Effect.tryPromise({
+        try: () => firestore().collection(input.collection).listDocuments(),
+        catch: (cause) => new FirestoreListDocumentsError({
+            message: `Failed to list documents in: ${input.collection}`,
+            cause,
+        }),
+    });
+    if (input.includeCollections) {
+        const results = yield* effect_1.Effect.tryPromise({
+            try: () => Promise.all(refs.map(async (ref) => {
+                const collections = await ref.listCollections();
+                return {
+                    id: ref.id,
+                    path: ref.path,
+                    collections: collections.map((c) => c.id),
+                };
+            })),
+            catch: (cause) => new FirestoreListDocumentsError({
+                message: `Failed to list subcollections in: ${input.collection}`,
+                cause,
+            }),
+        });
+        return results;
+    }
+    return refs.map((ref) => ({ id: ref.id, path: ref.path }));
+});
+exports.listDocuments = listDocuments;
+//# sourceMappingURL=list_documents.js.map

package/dist/tools/firestore/list_documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_documents.js","sourceRoot":"","sources":["../../../src/tools/firestore/list_documents.ts"],"names":[],"mappings":";;;AACA,mCAAsC;AACtC,yCAA6C;AAC7C,6CAAiD;AAEjD,MAAa,2BAA4B,SAAQ,aAAI,CAAC,WAAW,CAC/D,6BAA6B,CAI7B;CAAG;AALL,kEAKK;AAEQ,QAAA,cAAc,GAAG,gBAAyB,CAAC;AAO3C,QAAA,uBAAuB,GAAS;IAC3C,IAAI,EAAE,sBAAc;IACpB,WAAW,EACT,0OAA0O;IAC5O,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,8DAA8D;aACjE;YACD,kBAAkB,EAAE;gBAClB,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,4KAA4K;aAC/K;SACF;QACD,QAAQ,EAAE,CAAC,YAAY,CAAC;KACzB;CACF,CAAC;AAEK,MAAM,aAAa,GAAG,CAAC,KAAwB,EAAE,EAAE,CACxD,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,sBAAa,CAAC;IACpC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAEtC,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,CAAC,0BAAe,CAAC;IAE7C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,eAAM,CAAC,UAAU,CAAC;QACpC,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,aAAa,EAAE;QACnE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,IAAI,2BAA2B,CAAC;YAC9B,OAAO,EAAE,gCAAgC,KAAK,CAAC,UAAU,EAAE;YAC3D,KAAK;SACN,CAAC;KACL,CAAC,CAAC;IAEH,IAAI,KAAK,CAAC,kBAAkB,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,eAAM,CAAC,UAAU,CAAC;YACvC,GAAG,EAAE,GAAG,EAAE,CACR,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBACrB,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,eAAe,EAAE,CAAC;gBAChD,OAAO;oBACL,EAAE,EAAE,GAAG,CAAC,EAAE;oBACV,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC1C,CAAC;YACJ,CAAC,CAAC,CACH;YACH,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,IAAI,2BAA2B,CAAC;gBAC9B,OAAO,EAAE,qCAAqC,KAAK,CAAC,UAAU,EAAE;gBAChE,KAAK;aACN,CAAC;SACL,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,IAAI,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;AAC7D,CAAC,CAAC,CAAC;AAvCQ,QAAA,aAAa,iBAuCrB"}

package/dist/tools/firestore/list_indexes.d.ts

@@ -0,0 +1,32 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { Effect } from 'effect';
+import { ConfigService } from '../../config';
+declare const FirestoreListIndexesError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "FirestoreListIndexesError";
+} & Readonly<A>;
+export declare class FirestoreListIndexesError extends FirestoreListIndexesError_base<{
+    readonly message: string;
+    readonly cause?: unknown;
+}> {
+}
+export declare const LIST_INDEXES: "list_indexes";
+export interface ListIndexesArgs {
+    collectionGroup?: string;
+    includeNotReady?: boolean;
+}
+export declare const listIndexesDefinition: Tool;
+export declare const listIndexes: (input: ListIndexesArgs) => Effect.Effect<{
+    total: number;
+    indexes: Record<string, {
+        collectionGroup: string;
+        queryScope: "COLLECTION" | "COLLECTION_GROUP";
+        fields: {
+            arrayConfig?: "CONTAINS" | undefined;
+            order?: "ASCENDING" | "DESCENDING" | undefined;
+            field: string;
+        }[];
+        state: "READY" | "CREATING" | "NEEDS_REPAIR";
+    }[]>;
+}, FirestoreListIndexesError, ConfigService>;
+export {};
+//# sourceMappingURL=list_indexes.d.ts.map

package/dist/tools/firestore/list_indexes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_indexes.d.ts","sourceRoot":"","sources":["../../../src/tools/firestore/list_indexes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAQ,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGtC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;;;;AAE7C,qBAAa,yBAA0B,SAAQ,+BAE7C;IACA,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;CAAG;AAEL,eAAO,MAAM,YAAY,EAAG,cAAuB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAoBD,eAAO,MAAM,qBAAqB,EAAE,IAmBnC,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,OAAO,eAAe;;;;;;;;;;;;4CAgF9C,CAAC"}

package/dist/tools/firestore/list_indexes.js

@@ -0,0 +1,99 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listIndexes = exports.listIndexesDefinition = exports.LIST_INDEXES = exports.FirestoreListIndexesError = void 0;
+const effect_1 = require("effect");
+const firebase_admin_1 = __importDefault(require("firebase-admin"));
+const config_1 = require("../../config");
+class FirestoreListIndexesError extends effect_1.Data.TaggedError('FirestoreListIndexesError') {
+}
+exports.FirestoreListIndexesError = FirestoreListIndexesError;
+exports.LIST_INDEXES = 'list_indexes';
+exports.listIndexesDefinition = {
+    name: exports.LIST_INDEXES,
+    description: 'List Firestore composite indexes. Use this before running complex queries or collection group queries to check whether the required indexes exist. Returns index fields, query scope (COLLECTION or COLLECTION_GROUP), and state.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            collectionGroup: {
+                type: 'string',
+                description: 'Filter to a specific collection group name, e.g. "stock" or "purchase_orders". Omit to return all indexes.',
+            },
+            includeNotReady: {
+                type: 'boolean',
+                description: 'If true, includes indexes that are still CREATING or NEEDS_REPAIR. Defaults to false (only READY indexes).',
+            },
+        },
+    },
+};
+const listIndexes = (input) => effect_1.Effect.gen(function* () {
+    const { config } = yield* config_1.ConfigService;
+    const projectId = config.firebase.projectId;
+    const token = yield* effect_1.Effect.tryPromise({
+        try: () => firebase_admin_1.default.app().options.credential.getAccessToken(),
+        catch: (cause) => new FirestoreListIndexesError({
+            message: 'Failed to get access token',
+            cause,
+        }),
+    });
+    // Fetch all pages of indexes
+    const allIndexes = [];
+    let pageToken;
+    do {
+        const url = new URL(`https://firestore.googleapis.com/v1/projects/${projectId}/databases/(default)/collectionGroups/-/indexes`);
+        if (pageToken)
+            url.searchParams.set('pageToken', pageToken);
+        const page = yield* effect_1.Effect.tryPromise({
+            try: () => fetch(url.toString(), {
+                headers: { Authorization: `Bearer ${token.access_token}` },
+            }).then((r) => r.json()),
+            catch: (cause) => new FirestoreListIndexesError({
+                message: 'Failed to fetch indexes from Firestore Management API',
+                cause,
+            }),
+        });
+        allIndexes.push(...(page.indexes ?? []));
+        pageToken = page.nextPageToken;
+    } while (pageToken);
+    // Extract collection group from index name:
+    // projects/{projectId}/databases/(default)/collectionGroups/{group}/indexes/{id}
+    const parsed = allIndexes
+        .map((idx) => {
+        const parts = idx.name.split('/');
+        const groupIdx = parts.indexOf('collectionGroups');
+        const collectionGroup = groupIdx !== -1 ? parts[groupIdx + 1] : 'unknown';
+        return {
+            collectionGroup,
+            queryScope: idx.queryScope,
+            fields: idx.fields.map((f) => ({
+                field: f.fieldPath,
+                ...(f.order ? { order: f.order } : {}),
+                ...(f.arrayConfig ? { arrayConfig: f.arrayConfig } : {}),
+            })),
+            state: idx.state,
+        };
+    })
+        .filter((idx) => {
+        if (!input.includeNotReady && idx.state !== 'READY')
+            return false;
+        if (input.collectionGroup &&
+            idx.collectionGroup !== input.collectionGroup)
+            return false;
+        return true;
+    });
+    // Group by collection group for easier reading
+    const grouped = {};
+    for (const idx of parsed) {
+        if (!grouped[idx.collectionGroup])
+            grouped[idx.collectionGroup] = [];
+        grouped[idx.collectionGroup].push(idx);
+    }
+    return {
+        total: parsed.length,
+        indexes: grouped,
+    };
+});
+exports.listIndexes = listIndexes;
+//# sourceMappingURL=list_indexes.js.map

package/dist/tools/firestore/list_indexes.js.map

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

package/dist/tools/firestore/normalize.d.ts

@@ -0,0 +1,8 @@
+import admin from 'firebase-admin';
+export declare const normalizeValue: (value: unknown) => unknown;
+export declare const normalizeDocument: (doc: admin.firestore.QueryDocumentSnapshot | admin.firestore.DocumentSnapshot) => {
+    id: string;
+    path: string;
+    data: unknown;
+};
+//# sourceMappingURL=normalize.d.ts.map

package/dist/tools/firestore/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/tools/firestore/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,gBAAgB,CAAC;AAEnC,eAAO,MAAM,cAAc,GAAI,OAAO,OAAO,KAAG,OAmB/C,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,KAAK,KAAK,CAAC,SAAS,CAAC,qBAAqB,GAAG,KAAK,CAAC,SAAS,CAAC,gBAAgB;;;;CAK7E,CAAC"}

package/dist/tools/firestore/normalize.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeDocument = exports.normalizeValue = void 0;
+const firebase_admin_1 = __importDefault(require("firebase-admin"));
+const normalizeValue = (value) => {
+    if (value === null || value === undefined)
+        return value;
+    if (value instanceof firebase_admin_1.default.firestore.Timestamp) {
+        return value.toDate().toISOString();
+    }
+    if (value instanceof firebase_admin_1.default.firestore.GeoPoint) {
+        return { latitude: value.latitude, longitude: value.longitude };
+    }
+    if (value instanceof firebase_admin_1.default.firestore.DocumentReference)
+        return value.path;
+    if (Array.isArray(value))
+        return value.map(exports.normalizeValue);
+    if (typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value).map(([k, v]) => [
+            k,
+            (0, exports.normalizeValue)(v),
+        ]));
+    }
+    return value;
+};
+exports.normalizeValue = normalizeValue;
+const normalizeDocument = (doc) => ({
+    id: doc.id,
+    path: doc.ref.path,
+    data: (0, exports.normalizeValue)(doc.data()),
+});
+exports.normalizeDocument = normalizeDocument;
+//# sourceMappingURL=normalize.js.map

package/dist/tools/firestore/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../../src/tools/firestore/normalize.ts"],"names":[],"mappings":";;;;;;AAAA,oEAAmC;AAE5B,MAAM,cAAc,GAAG,CAAC,KAAc,EAAW,EAAE;IACxD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACxD,IAAI,KAAK,YAAY,wBAAK,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;QAC/C,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC;IACtC,CAAC;IACD,IAAI,KAAK,YAAY,wBAAK,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;QAC9C,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;IAClE,CAAC;IACD,IAAI,KAAK,YAAY,wBAAK,CAAC,SAAS,CAAC,iBAAiB;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC;IAC1E,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,sBAAc,CAAC,CAAC;IAC3D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAqB,EAAE,CAAC;YACvD,CAAC;YACD,IAAA,sBAAc,EAAC,CAAC,CAAC;SAClB,CAAC,CACH,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAnBW,QAAA,cAAc,kBAmBzB;AAEK,MAAM,iBAAiB,GAAG,CAC/B,GAA6E,EAC7E,EAAE,CAAC,CAAC;IACJ,EAAE,EAAE,GAAG,CAAC,EAAE;IACV,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI;IAClB,IAAI,EAAE,IAAA,sBAAc,EAAC,GAAG,CAAC,IAAI,EAAE,CAAC;CACjC,CAAC,CAAC;AANU,QAAA,iBAAiB,qBAM3B"}

package/dist/tools/firestore/query_collection.d.ts

@@ -0,0 +1,34 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { Effect } from 'effect';
+import { AccessService } from '../../access';
+import { ConfigService } from '../../config';
+import { FirebaseService } from '../../firebase';
+import { QueryFilter, QueryOrderBy } from './types';
+declare const FirestoreQueryError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "FirestoreQueryError";
+} & Readonly<A>;
+export declare class FirestoreQueryError extends FirestoreQueryError_base<{
+    readonly message: string;
+    readonly cause?: unknown;
+}> {
+}
+export declare const QUERY_COLLECTION: "query_collection";
+export interface QueryCollectionArgs {
+    collection: string;
+    filters?: QueryFilter[];
+    orderBy?: QueryOrderBy[];
+    limit?: number;
+    select?: string[];
+    startAfter?: string;
+}
+export declare const queryCollectionDefinition: Tool;
+export declare const queryCollection: (input: QueryCollectionArgs) => Effect.Effect<{
+    documents: {
+        id: string;
+        path: string;
+        data: unknown;
+    }[];
+    nextPageCursor: string | null;
+}, import("../../access").AccessDeniedError | FirestoreQueryError, ConfigService | AccessService | FirebaseService>;
+export {};
+//# sourceMappingURL=query_collection.d.ts.map

package/dist/tools/firestore/query_collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query_collection.d.ts","sourceRoot":"","sources":["../../../src/tools/firestore/query_collection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAQ,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAIL,WAAW,EACX,YAAY,EACb,MAAM,SAAS,CAAC;;;;AAEjB,qBAAa,mBAAoB,SAAQ,yBAEvC;IACA,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;CAAG;AAEL,eAAO,MAAM,gBAAgB,EAAG,kBAA2B,CAAC;AAE5D,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,yBAAyB,EAAE,IAuCvC,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,OAAO,mBAAmB;;;;;;;mHA8DtD,CAAC"}

package/dist/tools/firestore/query_collection.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.queryCollection = exports.queryCollectionDefinition = exports.QUERY_COLLECTION = exports.FirestoreQueryError = void 0;
+const effect_1 = require("effect");
+const access_1 = require("../../access");
+const config_1 = require("../../config");
+const firebase_1 = require("../../firebase");
+const types_1 = require("./types");
+class FirestoreQueryError extends effect_1.Data.TaggedError('FirestoreQueryError') {
+}
+exports.FirestoreQueryError = FirestoreQueryError;
+exports.QUERY_COLLECTION = 'query_collection';
+exports.queryCollectionDefinition = {
+    name: exports.QUERY_COLLECTION,
+    description: 'Query a Firestore collection with filters, ordering, and a limit. Supports cursor-based pagination via startAfter.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            collection: {
+                type: 'string',
+                description: "Collection path, e.g. 'users' or 'users/123/posts'",
+            },
+            filters: {
+                type: 'array',
+                description: 'Optional list of where-clause filters',
+                items: types_1.FILTER_SCHEMA_ITEM,
+            },
+            orderBy: {
+                type: 'array',
+                description: 'Optional ordering of results',
+                items: types_1.ORDER_BY_SCHEMA_ITEM,
+            },
+            limit: {
+                type: 'number',
+                description: 'Max number of documents to return',
+            },
+            select: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Optional list of field paths to return. Omit to return all fields.',
+            },
+            startAfter: {
+                type: 'string',
+                description: 'Document ID to start after for pagination. Use the nextPageCursor value returned from a previous call.',
+            },
+        },
+        required: ['collection'],
+    },
+};
+const queryCollection = (input) => effect_1.Effect.gen(function* () {
+    const access = yield* access_1.AccessService;
+    yield* access.check(input.collection);
+    const { config } = yield* config_1.ConfigService;
+    const { firestore } = yield* firebase_1.FirebaseService;
+    const maxLimit = config.firestore.maxCollectionReadSize;
+    const limit = Math.min(input.limit ?? maxLimit, maxLimit);
+    const cursorSnap = input.startAfter
+        ? yield* effect_1.Effect.tryPromise({
+            try: () => firestore()
+                .collection(input.collection)
+                .doc(input.startAfter)
+                .get(),
+            catch: (cause) => new FirestoreQueryError({
+                message: `Failed to fetch cursor document: ${input.startAfter}`,
+                cause,
+            }),
+        })
+        : null;
+    const snapshot = yield* effect_1.Effect.tryPromise({
+        try: () => {
+            let query = firestore().collection(input.collection);
+            if (input.select?.length) {
+                query = query.select(...input.select);
+            }
+            for (const filter of input.filters ?? []) {
+                query = query.where(filter.field, filter.operator, filter.value);
+            }
+            for (const order of input.orderBy ?? []) {
+                query = query.orderBy(order.field, order.direction ?? 'asc');
+            }
+            if (cursorSnap) {
+                query = query.startAfter(cursorSnap);
+            }
+            return query.limit(limit).get();
+        },
+        catch: (cause) => new FirestoreQueryError({
+            message: `Failed to query collection: ${input.collection}`,
+            cause,
+        }),
+    });
+    const documents = snapshot.docs.map(types_1.normalizeDocument);
+    const nextPageCursor = documents.length === limit ? documents[documents.length - 1].id : null;
+    return { documents, nextPageCursor };
+});
+exports.queryCollection = queryCollection;
+//# sourceMappingURL=query_collection.js.map

package/dist/tools/firestore/query_collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query_collection.js","sourceRoot":"","sources":["../../../src/tools/firestore/query_collection.ts"],"names":[],"mappings":";;;AACA,mCAAsC;AAEtC,yCAA6C;AAC7C,yCAA6C;AAC7C,6CAAiD;AACjD,mCAMiB;AAEjB,MAAa,mBAAoB,SAAQ,aAAI,CAAC,WAAW,CACvD,qBAAqB,CAIrB;CAAG;AALL,kDAKK;AAEQ,QAAA,gBAAgB,GAAG,kBAA2B,CAAC;AAW/C,QAAA,yBAAyB,GAAS;IAC7C,IAAI,EAAE,wBAAgB;IACtB,WAAW,EACT,oHAAoH;IACtH,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,uCAAuC;gBACpD,KAAK,EAAE,0BAAkB;aAC1B;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,8BAA8B;gBAC3C,KAAK,EAAE,4BAAoB;aAC5B;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mCAAmC;aACjD;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,oEAAoE;aACvE;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,wGAAwG;aAC3G;SACF;QACD,QAAQ,EAAE,CAAC,YAAY,CAAC;KACzB;CACF,CAAC;AAEK,MAAM,eAAe,GAAG,CAAC,KAA0B,EAAE,EAAE,CAC5D,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,sBAAa,CAAC;IACpC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAEtC,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,sBAAa,CAAC;IACxC,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,CAAC,0BAAe,CAAC;IAE7C,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,qBAAqB,CAAC;IACxD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAE1D,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU;QACjC,CAAC,CAAC,KAAK,CAAC,CAAC,eAAM,CAAC,UAAU,CAAC;YACvB,GAAG,EAAE,GAAG,EAAE,CACR,SAAS,EAAE;iBACR,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC;iBAC5B,GAAG,CAAC,KAAK,CAAC,UAAW,CAAC;iBACtB,GAAG,EAAE;YACV,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,IAAI,mBAAmB,CAAC;gBACtB,OAAO,EAAE,oCAAoC,KAAK,CAAC,UAAU,EAAE;gBAC/D,KAAK;aACN,CAAC;SACL,CAAC;QACJ,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,eAAM,CAAC,UAAU,CAAC;QACxC,GAAG,EAAE,GAAG,EAAE;YACR,IAAI,KAAK,GAA4B,SAAS,EAAE,CAAC,UAAU,CACzD,KAAK,CAAC,UAAU,CACjB,CAAC;YAEF,IAAI,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;gBACzB,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;YACxC,CAAC;YAED,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,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;gBACxC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,CAAC;YAC/D,CAAC;YAED,IAAI,UAAU,EAAE,CAAC;gBACf,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YACvC,CAAC;YAED,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC;QAClC,CAAC;QACD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,IAAI,mBAAmB,CAAC;YACtB,OAAO,EAAE,+BAA+B,KAAK,CAAC,UAAU,EAAE;YAC1D,KAAK;SACN,CAAC;KACL,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,yBAAiB,CAAC,CAAC;IACvD,MAAM,cAAc,GAClB,SAAS,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAEzE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC;AACvC,CAAC,CAAC,CAAC;AA9DQ,QAAA,eAAe,mBA8DvB"}

package/dist/tools/firestore/query_collection_group.d.ts

@@ -0,0 +1,34 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { Effect } from 'effect';
+import { AccessService } from '../../access';
+import { ConfigService } from '../../config';
+import { FirebaseService } from '../../firebase';
+import { QueryFilter, QueryOrderBy } from './types';
+declare const FirestoreCollectionGroupQueryError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "FirestoreCollectionGroupQueryError";
+} & Readonly<A>;
+export declare class FirestoreCollectionGroupQueryError extends FirestoreCollectionGroupQueryError_base<{
+    readonly message: string;
+    readonly cause?: unknown;
+}> {
+}
+export declare const QUERY_COLLECTION_GROUP: "query_collection_group";
+export interface QueryCollectionGroupArgs {
+    collectionId: string;
+    filters?: QueryFilter[];
+    orderBy?: QueryOrderBy[];
+    limit?: number;
+    select?: string[];
+    startAfter?: string;
+}
+export declare const queryCollectionGroupDefinition: Tool;
+export declare const queryCollectionGroup: (input: QueryCollectionGroupArgs) => Effect.Effect<{
+    documents: {
+        id: string;
+        path: string;
+        data: unknown;
+    }[];
+    nextPageCursor: string | null;
+}, import("../../access").AccessDeniedError | FirestoreCollectionGroupQueryError, ConfigService | AccessService | FirebaseService>;
+export {};
+//# sourceMappingURL=query_collection_group.d.ts.map

package/dist/tools/firestore/query_collection_group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query_collection_group.d.ts","sourceRoot":"","sources":["../../../src/tools/firestore/query_collection_group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAQ,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAIL,WAAW,EACX,YAAY,EACb,MAAM,SAAS,CAAC;;;;AAEjB,qBAAa,kCAAmC,SAAQ,wCAEtD;IACA,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;CAAG;AAEL,eAAO,MAAM,sBAAsB,EAAG,wBAAiC,CAAC;AAExE,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,8BAA8B,EAAE,IAyC5C,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,OAAO,wBAAwB;;;;;;;kIA2DhE,CAAC"}

package/dist/tools/firestore/query_collection_group.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.queryCollectionGroup = exports.queryCollectionGroupDefinition = exports.QUERY_COLLECTION_GROUP = exports.FirestoreCollectionGroupQueryError = void 0;
+const effect_1 = require("effect");
+const access_1 = require("../../access");
+const config_1 = require("../../config");
+const firebase_1 = require("../../firebase");
+const types_1 = require("./types");
+class FirestoreCollectionGroupQueryError extends effect_1.Data.TaggedError('FirestoreCollectionGroupQueryError') {
+}
+exports.FirestoreCollectionGroupQueryError = FirestoreCollectionGroupQueryError;
+exports.QUERY_COLLECTION_GROUP = 'query_collection_group';
+exports.queryCollectionGroupDefinition = {
+    name: exports.QUERY_COLLECTION_GROUP,
+    description: 'Query across all Firestore collections with the same name, regardless of their parent path. Use this to query data across multiple stores or parent documents at once. Check list_indexes first to confirm a collection-group-scoped index exists for any filters or ordering you plan to use.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            collectionId: {
+                type: 'string',
+                description: "The collection name to query across all parents, e.g. 'purchase_orders' or 'stock'.",
+            },
+            filters: {
+                type: 'array',
+                description: 'Optional list of where-clause filters',
+                items: types_1.FILTER_SCHEMA_ITEM,
+            },
+            orderBy: {
+                type: 'array',
+                description: 'Optional ordering of results. Requires a collection-group index.',
+                items: types_1.ORDER_BY_SCHEMA_ITEM,
+            },
+            limit: {
+                type: 'number',
+                description: 'Max number of documents to return',
+            },
+            select: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Optional list of field paths to return. Omit to return all fields.',
+            },
+            startAfter: {
+                type: 'string',
+                description: 'Full document path to start after for pagination, e.g. "shared/stores_data/ABC/data/purchase_orders/51721". Use the path from the last document in the previous page.',
+            },
+        },
+        required: ['collectionId'],
+    },
+};
+const queryCollectionGroup = (input) => effect_1.Effect.gen(function* () {
+    const access = yield* access_1.AccessService;
+    yield* access.check(input.collectionId);
+    const { config } = yield* config_1.ConfigService;
+    const { firestore } = yield* firebase_1.FirebaseService;
+    const maxLimit = config.firestore.maxCollectionReadSize;
+    const limit = Math.min(input.limit ?? maxLimit, maxLimit);
+    // For collection group pagination, startAfter must be a full path
+    const cursorSnap = input.startAfter
+        ? yield* effect_1.Effect.tryPromise({
+            try: () => firestore().doc(input.startAfter).get(),
+            catch: (cause) => new FirestoreCollectionGroupQueryError({
+                message: `Failed to fetch cursor document: ${input.startAfter}`,
+                cause,
+            }),
+        })
+        : null;
+    const snapshot = yield* effect_1.Effect.tryPromise({
+        try: () => {
+            let query = firestore().collectionGroup(input.collectionId);
+            if (input.select?.length) {
+                query = query.select(...input.select);
+            }
+            for (const filter of input.filters ?? []) {
+                query = query.where(filter.field, filter.operator, filter.value);
+            }
+            for (const order of input.orderBy ?? []) {
+                query = query.orderBy(order.field, order.direction ?? 'asc');
+            }
+            if (cursorSnap) {
+                query = query.startAfter(cursorSnap);
+            }
+            return query.limit(limit).get();
+        },
+        catch: (cause) => new FirestoreCollectionGroupQueryError({
+            message: `Failed to query collection group: ${input.collectionId}`,
+            cause,
+        }),
+    });
+    const documents = snapshot.docs.map(types_1.normalizeDocument);
+    const nextPageCursor = documents.length === limit ? documents[documents.length - 1].path : null;
+    return { documents, nextPageCursor };
+});
+exports.queryCollectionGroup = queryCollectionGroup;
+//# sourceMappingURL=query_collection_group.js.map