firebase-admin-edge 1.1.0 → 2.0.0

package/dist/db/firestore.d.ts

@@ -0,0 +1,151 @@
+import { type FirestoreResult } from './firestore-results.js';
+export type { FirestoreResult } from './firestore-results.js';
+export { setLogFunction, GrpcStatus } from './firestore-logging.js';
+export type * from './firestore-types.js';
+import { PipelineSource, type PipelineResponse } from './pipeline.js';
+export * as Pipelines from './pipeline.js';
+export { FirestoreErrorInfo } from './firestore-error-codes.js';
+import { FirebaseEdgeError } from '../auth/errors.js';
+import type { CacheConfig } from '../auth/cache-types.js';
+import type { ServiceAccount } from '../auth/firebase-types.js';
+import { type QueryRow } from './firestore-endpoints.js';
+import { WriteBatch } from './write-batch.js';
+import { Transaction } from './transaction.js';
+import { BulkWriter, type BulkWriterOptions } from './bulk-writer.js';
+import { Timestamp } from './timestamp.js';
+import { CollectionGroup } from './collection-group.js';
+import { BundleBuilder } from './bundle-builder.js';
+export { CollectionGroup } from './collection-group.js';
+export { QueryPartition } from './query-partition.js';
+export { BundleBuilder } from './bundle-builder.js';
+export type { BulkWriterOptions } from './bulk-writer.js';
+import { DocumentSnapshot, QueryDocumentSnapshot } from './document-snapshot.js';
+import { type SnapshotDocument, type SnapshotTimestamp } from './firestore-document.js';
+export type { SnapshotDocument, SnapshotTimestamp } from './firestore-document.js';
+import { type QueryOptions } from './query-request.js';
+import { type Settings } from './firestore-settings.js';
+export type { Settings, FirestoreOpenTelemetryOptions } from './firestore-settings.js';
+import { FieldPath } from './field-path.js';
+import type { ExplainOptions } from './explain.js';
+export type { ExplainOptions, ExplainResults, ExplainMetrics, PlanSummary, ExecutionStats } from './explain.js';
+export type { DocumentChange } from './query.js';
+export type { SnapshotListenOptions } from './snapshot-listener.js';
+import type { FirestoreDocument } from './firestore-document.js';
+import type { DocumentData } from './firestore-document.js';
+import type { AggregateSpec, AggregateData } from './aggregate.js';
+import type { WriteOperation, WriteResult } from './write-request.js';
+import { CollectionReference } from './collection-reference.js';
+import { DocumentReference } from './document-reference.js';
+export { DocumentReference } from './document-reference.js';
+export { CollectionReference } from './collection-reference.js';
+export { Query, QuerySnapshot } from './query.js';
+export { DocumentSnapshot } from './document-snapshot.js';
+export { QueryDocumentSnapshot } from './query-document-snapshot.js';
+export type { WhereFilterOp } from './query.js';
+export type { DocumentData } from './firestore-document.js';
+export { WriteBatch } from './write-batch.js';
+export { WriteResult } from './write-request.js';
+export type { SetOptions, Precondition } from './write-batch.js';
+export { Transaction } from './transaction.js';
+export { BulkWriter, BulkWriterError } from './bulk-writer.js';
+export { Timestamp } from './timestamp.js';
+export { VectorValue } from './vector-value.js';
+export { VectorQuery, VectorQuerySnapshot } from './vector-query.js';
+export type { VectorQueryOptions } from './vector-query.js';
+export { GeoPoint } from './geo-point.js';
+export { Bytes } from './bytes.js';
+export { FieldPath } from './field-path.js';
+export { FieldValue } from './field-value.js';
+export { Filter } from './filter.js';
+export { AggregateField, AggregateQuery, AggregateQuerySnapshot } from './aggregate.js';
+export type { AggregateSpec, AggregateData, AggregateType, AggregateFieldType, AggregateSpecData } from './aggregate.js';
+export type { FirestoreDataConverter } from './firestore-converter.js';
+export interface ReadOptions {
+    fieldMask?: (string | FieldPath)[];
+}
+export interface ReadWriteTransactionOptions {
+    readOnly?: false;
+    maxAttempts?: number;
+}
+export interface ReadOnlyTransactionOptions {
+    readOnly: true;
+    readTime?: Timestamp;
+}
+/** Service-account Firestore operations for edge runtimes. */
+export declare class Firestore {
+    private serviceAccountKey;
+    private _databaseId;
+    private fetch?;
+    private cache?;
+    private cacheName;
+    private telemetry?;
+    /** @internal Share operation tracing across references, queries, and writes. */
+    _trace<T>(name: string, operation: () => Promise<T>): Promise<T>;
+    /** @internal Pipeline streams participate in termination and cancellation. */
+    _streamPipeline(request: object, signal: AbortSignal, readTime?: Timestamp): AsyncGenerator<Partial<FirestoreDocument>>;
+    pipeline(): PipelineSource;
+    /** @internal Coordinate authenticated pipeline execution. */
+    _executePipeline(request: object, transaction?: string, readTime?: Timestamp): Promise<PipelineResponse>;
+    snapshot_(documentName: string, readTime?: SnapshotTimestamp, encoding?: 'json' | 'protobufJS'): DocumentSnapshot;
+    snapshot_(document: SnapshotDocument, readTime: SnapshotTimestamp, encoding?: 'json' | 'protobufJS'): QueryDocumentSnapshot;
+    private readonly referenceDatabases;
+    get projectId(): string;
+    get databaseId(): string;
+    /** @internal Serialization option. */
+    _useBigInt: boolean;
+    /** @internal Decode fully qualified references, including other databases. */
+    _reference(name: string): DocumentReference;
+    private started;
+    private configured;
+    private terminated;
+    private readonly streams;
+    private readonly snapshotListeners;
+    /** @internal Register polling cleanup and return a deregistration function. */
+    _registerSnapshotListener(stop: () => void): () => void;
+    /** @internal Used by write serialization. */
+    _ignoreUndefinedProperties: boolean;
+    private implicitOrderBy;
+    get alwaysUseImplicitOrderBy(): boolean;
+    settings(settings: Settings): void;
+    toJSON(): {
+        projectId: string;
+    };
+    terminate(): Promise<FirestoreResult<void>>;
+    bundle(name?: string): BundleBuilder;
+    recursiveDelete(ref: DocumentReference<any> | CollectionReference<any>, bulkWriter?: BulkWriter): Promise<FirestoreResult<void>>;
+    collectionGroup(collectionId: string): CollectionGroup;
+    getAll<T = DocumentData, DbModelType extends DocumentData = DocumentData>(...referencesOrOptions: (DocumentReference<T, DbModelType> | ReadOptions)[]): Promise<FirestoreResult<DocumentSnapshot<T, DbModelType>[]>>;
+    /** @internal Shared bulk read validation for transactions. */
+    _getAll<T = DocumentData, DbModelType extends DocumentData = DocumentData>(referencesOrOptions: (DocumentReference<T, DbModelType> | ReadOptions)[], transaction?: string): Promise<DocumentSnapshot<T, DbModelType>[]>;
+    listCollections(): Promise<FirestoreResult<CollectionReference[]>>;
+    /** @internal */
+    _listCollections(path: string): Promise<CollectionReference[]>;
+    /** @internal */
+    _listDocuments(path: string): Promise<string[]>;
+    /** @internal */
+    _query(path: string, options: QueryOptions, transaction?: string): Promise<FirestoreDocument[]>;
+    /** @internal */
+    _streamQuery(path: string, options: QueryOptions, signal: AbortSignal): AsyncGenerator<FirestoreDocument>;
+    batch(): WriteBatch;
+    /** @internal Explain streams participate in termination and cancellation. */
+    _explainQuery(path: string, options: QueryOptions, explain: ExplainOptions, signal: AbortSignal): AsyncGenerator<QueryRow>;
+    bulkWriter(options?: BulkWriterOptions): BulkWriter;
+    runTransaction<T>(updateFunction: (transaction: Transaction) => Promise<T>, options?: ReadWriteTransactionOptions | ReadOnlyTransactionOptions): Promise<FirestoreResult<T>>;
+    /** @internal */
+    _documentName(path: string): string;
+    /** @internal */
+    _partitionQuery(collectionId: string, count: number): Promise<string[]>;
+    /** @internal */
+    _batchWrite(writes: WriteOperation[]): Promise<(WriteResult | FirebaseEdgeError)[]>;
+    /** @internal */
+    _commit(writes: WriteOperation[]): Promise<WriteResult[]>;
+    /** @internal */
+    _aggregate(path: string, options: QueryOptions, spec: AggregateSpec, transaction?: string, explain?: ExplainOptions): Promise<AggregateData>;
+    constructor(serviceAccountKey: ServiceAccount, _databaseId?: string, fetch?: typeof globalThis.fetch | undefined, cache?: CacheConfig | undefined, cacheName?: string);
+    collection(path: string): CollectionReference;
+    doc(path: string): DocumentReference;
+    private documentReference;
+    private getCachedToken;
+    private assertActive;
+}
+//# sourceMappingURL=firestore.d.ts.map

package/dist/db/firestore.d.ts.map

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

package/dist/db/firestore.js

@@ -0,0 +1,505 @@
+import { firestoreResult, firestoreData } from './firestore-results.js';
+import { traceFirestoreOperation } from './firestore-telemetry.js';
+export { setLogFunction, GrpcStatus } from './firestore-logging.js';
+import { PipelineSource } from './pipeline.js';
+export * as Pipelines from './pipeline.js';
+import { FirestoreErrorInfo } from './firestore-error-codes.js';
+export { FirestoreErrorInfo } from './firestore-error-codes.js';
+import { FirebaseEdgeError } from '../auth/errors.js';
+import { getToken } from '../auth/google-oauth.js';
+import { getDocument, executePipeline, streamPipeline, runQuery, createDocumentName, commitWrites, batchWrite, beginTransaction, rollbackTransaction, runAggregate, batchGetDocuments, listCollectionIds, listDocumentPaths, streamQuery, partitionQuery, configureFirestoreFetch, streamQueryRows } from './firestore-endpoints.js';
+import { WriteBatch } from './write-batch.js';
+import { Transaction } from './transaction.js';
+import { BulkWriter } from './bulk-writer.js';
+import { Timestamp } from './timestamp.js';
+import { CollectionGroup } from './collection-group.js';
+import { BundleBuilder } from './bundle-builder.js';
+import { deleteRecursively } from './recursive-delete.js';
+export { CollectionGroup } from './collection-group.js';
+export { QueryPartition } from './query-partition.js';
+export { BundleBuilder } from './bundle-builder.js';
+import { DocumentSnapshot, QueryDocumentSnapshot } from './document-snapshot.js';
+import { normalizeSnapshotDocument, normalizeSnapshotTimestamp } from './firestore-document.js';
+import { validateFieldPath } from './query-request.js';
+import { validateSettings } from './firestore-settings.js';
+import { FieldPath } from './field-path.js';
+import { CollectionReference } from './collection-reference.js';
+import { DocumentReference } from './document-reference.js';
+export { DocumentReference } from './document-reference.js';
+export { CollectionReference } from './collection-reference.js';
+export { Query, QuerySnapshot } from './query.js';
+export { DocumentSnapshot } from './document-snapshot.js';
+export { QueryDocumentSnapshot } from './query-document-snapshot.js';
+export { WriteBatch } from './write-batch.js';
+export { WriteResult } from './write-request.js';
+export { Transaction } from './transaction.js';
+export { BulkWriter, BulkWriterError } from './bulk-writer.js';
+export { Timestamp } from './timestamp.js';
+export { VectorValue } from './vector-value.js';
+export { VectorQuery, VectorQuerySnapshot } from './vector-query.js';
+export { GeoPoint } from './geo-point.js';
+export { Bytes } from './bytes.js';
+export { FieldPath } from './field-path.js';
+export { FieldValue } from './field-value.js';
+export { Filter } from './filter.js';
+export { AggregateField, AggregateQuery, AggregateQuerySnapshot } from './aggregate.js';
+/** Service-account Firestore operations for edge runtimes. */
+export class Firestore {
+    serviceAccountKey;
+    _databaseId;
+    fetch;
+    cache;
+    cacheName;
+    telemetry;
+    /** @internal Share operation tracing across references, queries, and writes. */
+    _trace(name, operation) {
+        return traceFirestoreOperation(name, this.telemetry, operation);
+    }
+    /** @internal Pipeline streams participate in termination and cancellation. */
+    async *_streamPipeline(request, signal, readTime) {
+        this.assertActive();
+        const controller = new AbortController();
+        this.streams.add(controller);
+        const combined = AbortSignal.any([signal, controller.signal]);
+        try {
+            const token = await this.getCachedToken();
+            combined.throwIfAborted();
+            yield* streamPipeline(this.projectId, this.databaseId, request, token.access_token, this.fetch, combined, readTime);
+        }
+        finally {
+            this.streams.delete(controller);
+        }
+    }
+    pipeline() {
+        this.assertActive();
+        return new PipelineSource(this);
+    }
+    /** @internal Coordinate authenticated pipeline execution. */
+    async _executePipeline(request, transaction, readTime) {
+        const token = await this.getCachedToken();
+        return executePipeline(this.projectId, this.databaseId, request, token.access_token, this.fetch, transaction, readTime);
+    }
+    snapshot_(documentOrName, readTime, encoding = 'protobufJS') {
+        if (encoding !== 'json' && encoding !== 'protobufJS')
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Unsupported snapshot encoding. Expected json or protobufJS.'
+            });
+        this.assertActive();
+        const time = readTime === undefined
+            ? Timestamp.now()
+            : normalizeSnapshotTimestamp(readTime, encoding);
+        if (typeof documentOrName === 'string')
+            return new DocumentSnapshot(this._reference(documentOrName), undefined, time);
+        const document = normalizeSnapshotDocument(documentOrName, encoding);
+        document.readTime = time.toString();
+        return new QueryDocumentSnapshot(this._reference(document.name), document);
+    }
+    referenceDatabases = new Map();
+    get projectId() {
+        return this.serviceAccountKey.project_id;
+    }
+    get databaseId() {
+        return this._databaseId;
+    }
+    /** @internal Serialization option. */
+    _useBigInt = false;
+    /** @internal Decode fully qualified references, including other databases. */
+    _reference(name) {
+        const match = /^projects\/([^/]+)\/databases\/([^/]+)\/documents\/(.+)$/.exec(name);
+        if (!match)
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_RESPONSE,
+                message: 'Invalid document reference.'
+            });
+        const key = `${match[1]}/${match[2]}`;
+        const db = match[1] === this.projectId && match[2] === this.databaseId
+            ? this
+            : (this.referenceDatabases.get(key) ??
+                new Firestore({ ...this.serviceAccountKey, project_id: match[1] }, match[2], this.fetch, this.cache, this.cacheName));
+        if (db !== this)
+            this.referenceDatabases.set(key, db);
+        db.telemetry = this.telemetry;
+        db._useBigInt = this._useBigInt;
+        db._ignoreUndefinedProperties = this._ignoreUndefinedProperties;
+        return db.documentReference(match[3]);
+    }
+    started = false;
+    configured = false;
+    terminated = false;
+    streams = new Set();
+    snapshotListeners = new Set();
+    /** @internal Register polling cleanup and return a deregistration function. */
+    _registerSnapshotListener(stop) {
+        this.assertActive();
+        this.snapshotListeners.add(stop);
+        return () => {
+            this.snapshotListeners.delete(stop);
+        };
+    }
+    /** @internal Used by write serialization. */
+    _ignoreUndefinedProperties = false;
+    implicitOrderBy = false;
+    get alwaysUseImplicitOrderBy() {
+        return this.implicitOrderBy;
+    }
+    settings(settings) {
+        if (this.started || this.configured || this.terminated)
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.FAILED_PRECONDITION,
+                message: 'settings() must be called once, before using Firestore.'
+            });
+        validateSettings(settings);
+        const transport = settings.host !== undefined ||
+            settings.ssl !== undefined ||
+            settings.port !== undefined ||
+            settings.openTelemetry !== undefined
+            ? configureFirestoreFetch(this.fetch ?? globalThis.fetch, settings.host ?? 'firestore.googleapis.com', settings.ssl, settings.port, settings.openTelemetry)
+            : this.fetch;
+        this.serviceAccountKey = {
+            ...this.serviceAccountKey,
+            ...settings.credentials,
+            ...(settings.projectId ? { project_id: settings.projectId } : {})
+        };
+        this._databaseId = settings.databaseId ?? this._databaseId;
+        this.fetch = transport;
+        this.telemetry = settings.openTelemetry;
+        this._ignoreUndefinedProperties =
+            settings.ignoreUndefinedProperties ?? false;
+        this._useBigInt = settings.useBigInt ?? false;
+        this.implicitOrderBy = settings.alwaysUseImplicitOrderBy ?? false;
+        this.configured = true;
+    }
+    toJSON() {
+        return { projectId: this.serviceAccountKey.project_id };
+    }
+    async terminate() {
+        return firestoreResult(async () => {
+            this.terminated = true;
+            for (const stop of this.snapshotListeners) {
+                stop();
+            }
+            this.snapshotListeners.clear();
+            for (const controller of this.streams) {
+                controller.abort(new FirebaseEdgeError({
+                    ...FirestoreErrorInfo.FAILED_PRECONDITION,
+                    message: 'Firestore has been terminated.'
+                }));
+            }
+            this.streams.clear();
+        });
+    }
+    bundle(name) {
+        this.assertActive();
+        return new BundleBuilder(name);
+    }
+    async recursiveDelete(ref, bulkWriter) {
+        return firestoreResult(async () => {
+            return this._trace('Firestore.recursiveDelete', async () => {
+                this.assertActive();
+                if (!(ref instanceof DocumentReference ||
+                    ref instanceof CollectionReference) ||
+                    ref.firestore !== this ||
+                    (bulkWriter !== undefined &&
+                        (!(bulkWriter instanceof BulkWriter) ||
+                            bulkWriter.firestore !== this))) {
+                    throw new FirebaseEdgeError({
+                        ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                        message: 'Reference and BulkWriter must belong to this Firestore instance.'
+                    });
+                }
+                const writer = bulkWriter ?? this.bulkWriter();
+                try {
+                    await deleteRecursively(ref, writer);
+                }
+                finally {
+                    if (!bulkWriter) {
+                        await writer.close().then(firestoreData);
+                    }
+                }
+            });
+        });
+    }
+    collectionGroup(collectionId) {
+        this.assertActive();
+        return new CollectionGroup(this, collectionId, (path, options) => this._query(path, options));
+    }
+    async getAll(...referencesOrOptions) {
+        return firestoreResult(async () => {
+            return this._trace('Firestore.getAll', async () => {
+                return this._getAll(referencesOrOptions);
+            });
+        });
+    }
+    /** @internal Shared bulk read validation for transactions. */
+    async _getAll(referencesOrOptions, transaction) {
+        const args = [...referencesOrOptions];
+        const last = args.at(-1);
+        const options = last && !(last instanceof DocumentReference)
+            ? args.pop()
+            : undefined;
+        if (!args.length ||
+            args.some((ref) => !(ref instanceof DocumentReference) ||
+                ref.firestore !== this))
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'getAll requires document references belonging to this Firestore instance.'
+            });
+        if (options?.fieldMask !== undefined &&
+            !Array.isArray(options.fieldMask))
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'fieldMask must be an array.'
+            });
+        const fields = options?.fieldMask?.map((field) => {
+            if (!(field instanceof FieldPath))
+                validateFieldPath(field);
+            return field.toString();
+        });
+        const refs = args;
+        const token = await this.getCachedToken();
+        const readTime = Timestamp.now();
+        const documents = await batchGetDocuments(this.serviceAccountKey.project_id, this._databaseId, refs.map((ref) => ref.path), token.access_token, this.fetch, fields, ...(transaction ? [transaction] : []));
+        return refs.map((ref, index) => new DocumentSnapshot(ref, documents[index], documents.readTimes?.[index] ?? readTime));
+    }
+    listCollections() {
+        return firestoreResult(async () => {
+            return this._trace('Firestore.listCollections', async () => {
+                return this._listCollections('');
+            });
+        });
+    }
+    /** @internal */
+    async _listCollections(path) {
+        const token = await this.getCachedToken();
+        const ids = await listCollectionIds(this.serviceAccountKey.project_id, this._databaseId, path, token.access_token, this.fetch);
+        return ids.map((id) => this.collection(path ? `${path}/${id}` : id));
+    }
+    /** @internal */
+    async _listDocuments(path) {
+        const token = await this.getCachedToken();
+        return listDocumentPaths(this.serviceAccountKey.project_id, this._databaseId, path, token.access_token, this.fetch);
+    }
+    /** @internal */
+    async _query(path, options, transaction) {
+        const token = await this.getCachedToken();
+        return runQuery(this.serviceAccountKey.project_id, this._databaseId, path, options, token.access_token, this.fetch, ...(transaction ? [transaction] : []));
+    }
+    /** @internal */
+    async *_streamQuery(path, options, signal) {
+        this.assertActive();
+        const controller = new AbortController();
+        this.streams.add(controller);
+        const combined = AbortSignal.any([signal, controller.signal]);
+        try {
+            const token = await this.getCachedToken();
+            combined.throwIfAborted();
+            yield* streamQuery(this.serviceAccountKey.project_id, this._databaseId, path, options, token.access_token, this.fetch, combined);
+        }
+        finally {
+            this.streams.delete(controller);
+        }
+    }
+    batch() {
+        this.assertActive();
+        return new WriteBatch(this, (writes) => this._commit(writes));
+    }
+    /** @internal Explain streams participate in termination and cancellation. */
+    async *_explainQuery(path, options, explain, signal) {
+        this.assertActive();
+        const controller = new AbortController();
+        const combined = AbortSignal.any([signal, controller.signal]);
+        this.streams.add(controller);
+        try {
+            const token = await this.getCachedToken();
+            combined.throwIfAborted();
+            yield* streamQueryRows(this.projectId, this.databaseId, path, options, token.access_token, this.fetch, combined, explain);
+        }
+        finally {
+            this.streams.delete(controller);
+        }
+    }
+    bulkWriter(options) {
+        this.assertActive();
+        return new BulkWriter(this, options);
+    }
+    async runTransaction(updateFunction, options = {}) {
+        return firestoreResult(async () => {
+            return this._trace('Firestore.runTransaction', async () => {
+                if (!options ||
+                    typeof options !== 'object' ||
+                    Array.isArray(options) ||
+                    (options.readOnly !== undefined &&
+                        typeof options.readOnly !== 'boolean') ||
+                    ('readTime' in options &&
+                        options.readTime !== undefined &&
+                        (options.readOnly !== true ||
+                            !(options.readTime instanceof Timestamp))) ||
+                    (options.readOnly === true && 'maxAttempts' in options)) {
+                    throw new FirebaseEdgeError({
+                        ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                        message: 'Invalid transaction options.'
+                    });
+                }
+                const attempts = options.readOnly
+                    ? 1
+                    : (options.maxAttempts ?? 5);
+                if (typeof updateFunction !== 'function' ||
+                    !Number.isInteger(attempts) ||
+                    attempts < 1) {
+                    throw new FirebaseEdgeError({
+                        ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                        message: 'A transaction callback and positive maxAttempts are required.'
+                    });
+                }
+                const token = await this.getCachedToken();
+                for (let attempt = 1;; attempt++) {
+                    let id;
+                    let transaction;
+                    try {
+                        id = await beginTransaction(this.serviceAccountKey.project_id, this._databaseId, token.access_token, this.fetch, ...(options.readOnly ? [options] : []));
+                        const transactionId = id;
+                        transaction = new Transaction(this, async (ref) => {
+                            this.assertActive();
+                            const document = await getDocument(this.serviceAccountKey.project_id, this._databaseId, ref.path, token.access_token, this.fetch, transactionId);
+                            return new DocumentSnapshot(ref, document);
+                        }, async (writes) => {
+                            this.assertActive();
+                            if (options.readOnly) {
+                                await rollbackTransaction(this.serviceAccountKey.project_id, this._databaseId, transactionId, token.access_token, this.fetch);
+                                return [];
+                            }
+                            return commitWrites(this.serviceAccountKey.project_id, this._databaseId, writes, token.access_token, this.fetch, transactionId);
+                        }, options.readOnly, transactionId);
+                        const result = await updateFunction(transaction);
+                        await transaction._commit();
+                        return result;
+                    }
+                    catch (error) {
+                        transaction?._close();
+                        try {
+                            if (id) {
+                                await rollbackTransaction(this.serviceAccountKey.project_id, this._databaseId, id, token.access_token, this.fetch);
+                            }
+                        }
+                        catch {
+                            /* Preserve the original transaction failure. */
+                        }
+                        if (!([
+                            'firestore/aborted',
+                            'firestore/cancelled',
+                            'firestore/unknown',
+                            'firestore/deadline-exceeded',
+                            'firestore/internal',
+                            'firestore/unavailable',
+                            'firestore/unauthenticated',
+                            'firestore/resource-exhausted'
+                        ].includes(error?.code ?? '') ||
+                            (error?.code ===
+                                'firestore/invalid-argument' &&
+                                error instanceof Error &&
+                                /transaction has expired/.test(error.message))) ||
+                            attempt >= attempts) {
+                            throw error;
+                        }
+                        await new Promise((resolve) => setTimeout(resolve, Math.min(10 * 2 ** (attempt - 1), 1000)));
+                    }
+                }
+            });
+        });
+    }
+    /** @internal */
+    _documentName(path) {
+        return createDocumentName(this.serviceAccountKey.project_id, this._databaseId, path);
+    }
+    /** @internal */
+    async _partitionQuery(collectionId, count) {
+        const token = await this.getCachedToken();
+        return partitionQuery(this.serviceAccountKey.project_id, this._databaseId, collectionId, count, token.access_token, this.fetch);
+    }
+    /** @internal */
+    async _batchWrite(writes) {
+        const token = await this.getCachedToken();
+        return batchWrite(this.serviceAccountKey.project_id, this._databaseId, writes, token.access_token, this.fetch);
+    }
+    /** @internal */
+    async _commit(writes) {
+        const token = await this.getCachedToken();
+        return commitWrites(this.serviceAccountKey.project_id, this._databaseId, writes, token.access_token, this.fetch);
+    }
+    /** @internal */
+    async _aggregate(path, options, spec, transaction, explain) {
+        const token = await this.getCachedToken();
+        return runAggregate(this.serviceAccountKey.project_id, this._databaseId, path, options, spec, token.access_token, this.fetch, ...(explain
+            ? [transaction, explain]
+            : transaction
+                ? [transaction]
+                : []));
+    }
+    constructor(serviceAccountKey, _databaseId = '(default)', fetch, cache, cacheName = '__cache') {
+        this.serviceAccountKey = serviceAccountKey;
+        this._databaseId = _databaseId;
+        this.fetch = fetch;
+        this.cache = cache;
+        this.cacheName = cacheName;
+        if (!serviceAccountKey?.project_id)
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'A service account project_id is required.'
+            });
+        if (!_databaseId || _databaseId.includes('/'))
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'A valid Firestore database ID is required.'
+            });
+    }
+    collection(path) {
+        this.assertActive();
+        return new CollectionReference(this, path, (collectionPath, options) => this._query(collectionPath, options));
+    }
+    doc(path) {
+        this.assertActive();
+        return this.documentReference(path);
+    }
+    documentReference(path) {
+        return new DocumentReference(this, path, async (documentPath) => {
+            const token = await this.getCachedToken();
+            return getDocument(this.serviceAccountKey.project_id, this._databaseId, documentPath, token.access_token, this.fetch);
+        });
+    }
+    async getCachedToken() {
+        this.assertActive();
+        const cacheKey = `${this.cacheName}:firestore:${this.serviceAccountKey.client_email}`;
+        const cached = await this.cache?.getCache(cacheKey);
+        this.assertActive();
+        if (cached?.access_token) {
+            return cached;
+        }
+        const { data, error } = await getToken(this.serviceAccountKey, this.fetch);
+        this.assertActive();
+        if (error) {
+            throw error;
+        }
+        if (!data?.access_token) {
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.UNAUTHENTICATED,
+                message: 'No service account access token returned.'
+            });
+        }
+        const ttlMs = (data.expires_in - 60) * 1000;
+        if (Number.isFinite(ttlMs) && ttlMs > 0) {
+            await this.cache?.setCache(cacheKey, data, ttlMs);
+        }
+        this.assertActive();
+        return data;
+    }
+    assertActive() {
+        if (this.terminated)
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.FAILED_PRECONDITION,
+                message: 'Firestore has been terminated.'
+            });
+        this.started = true;
+    }
+}
+//# sourceMappingURL=firestore.js.map