firebase-admin-edge 1.1.0 → 2.0.0

package/dist/db/bulk-writer.js

@@ -0,0 +1,257 @@
+import { firestoreResult, firestoreData } from './firestore-results.js';
+import { FirestoreErrorInfo } from './firestore-error-codes.js';
+import { FirebaseEdgeError } from '../auth/errors.js';
+import { DocumentReference } from './document-reference.js';
+import { FieldPath } from './field-path.js';
+import { normalizeUpdateArguments } from './write-request.js';
+import { prepareWrite } from './write-request.js';
+const ERROR_CODES = {
+    'firestore/aborted': 10,
+    'firestore/unavailable': 14,
+    'firestore/permission-denied': 7,
+    'firestore/not-found': 5,
+    'firestore/already-exists': 6,
+    'firestore/failed-precondition': 9,
+    'firestore/resource-exhausted': 8,
+    'firestore/invalid-argument': 3,
+    'firestore/deadline-exceeded': 4,
+    'firestore/unauthenticated': 16,
+    'firestore/cancelled': 1,
+    'firestore/unknown': 2,
+    'firestore/out-of-range': 11,
+    'firestore/unimplemented': 12,
+    'firestore/internal': 13,
+    'firestore/data-loss': 15
+};
+export class BulkWriterError extends Error {
+    code;
+    documentRef;
+    operationType;
+    failedAttempts;
+    constructor(code, message, documentRef, operationType, failedAttempts) {
+        super(message);
+        this.code = code;
+        this.documentRef = documentRef;
+        this.operationType = operationType;
+        this.failedAttempts = failedAttempts;
+        this.name = 'BulkWriterError';
+    }
+}
+/** Independent writes run concurrently; writes to the same document stay ordered. */
+export class BulkWriter {
+    firestore;
+    initialRate;
+    maximumRate;
+    startedAt = Date.now();
+    nextSlot = 0;
+    closed = false;
+    ready = [];
+    activeRequests = 0;
+    scheduled = false;
+    pending = new Set();
+    tails = new Map();
+    errorHandler;
+    resultHandler;
+    /** @internal Use firestore.bulkWriter(). */
+    constructor(firestore, options = {}) {
+        this.firestore = firestore;
+        if (!options ||
+            typeof options !== 'object' ||
+            Array.isArray(options) ||
+            (options.throttling !== undefined &&
+                typeof options.throttling !== 'boolean' &&
+                (typeof options.throttling !== 'object' ||
+                    !options.throttling ||
+                    Array.isArray(options.throttling))))
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Invalid BulkWriter options.'
+            });
+        const config = typeof options.throttling === 'object' ? options.throttling : {};
+        for (const rate of [config.initialOpsPerSecond, config.maxOpsPerSecond])
+            if (rate !== undefined && (!Number.isFinite(rate) || rate <= 0))
+                throw new FirebaseEdgeError({
+                    ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                    message: 'BulkWriter rates must be positive finite numbers.'
+                });
+        if (config.initialOpsPerSecond !== undefined &&
+            config.maxOpsPerSecond !== undefined &&
+            config.initialOpsPerSecond > config.maxOpsPerSecond)
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Initial rate must not exceed maximum rate.'
+            });
+        this.maximumRate =
+            options.throttling === false
+                ? Infinity
+                : (config.maxOpsPerSecond ?? Infinity);
+        this.initialRate =
+            options.throttling === false
+                ? Infinity
+                : Math.min(config.initialOpsPerSecond ?? 500, this.maximumRate);
+    }
+    create(ref, data) {
+        return firestoreResult(async () => {
+            return this.enqueue(ref, 'create', data);
+        });
+    }
+    set(ref, data, options) {
+        return firestoreResult(async () => {
+            return this.enqueue(ref, 'set', data, options);
+        });
+    }
+    update(ref, data, ...args) {
+        return firestoreResult(async () => {
+            const update = normalizeUpdateArguments(data, args);
+            return this.enqueue(ref, 'update', update.data, undefined, update.precondition);
+        });
+    }
+    delete(ref, precondition) {
+        return firestoreResult(async () => {
+            return this.enqueue(ref, 'delete', undefined, undefined, precondition);
+        });
+    }
+    onWriteError(callback) {
+        if (typeof callback !== 'function')
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Expected an error callback.'
+            });
+        this.errorHandler = callback;
+    }
+    onWriteResult(callback) {
+        if (typeof callback !== 'function')
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Expected a result callback.'
+            });
+        this.resultHandler = callback;
+    }
+    async flush() {
+        return firestoreResult(async () => {
+            await Promise.allSettled([...this.pending]);
+        });
+    }
+    async close() {
+        return firestoreResult(async () => {
+            this.closed = true;
+            await this.flush().then(firestoreData);
+        });
+    }
+    enqueue(ref, kind, data, options, precondition) {
+        if (this.closed)
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.FAILED_PRECONDITION,
+                message: 'BulkWriter is closed.'
+            });
+        if (!(ref instanceof DocumentReference) ||
+            ref.firestore !== this.firestore)
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'DocumentReference must belong to this Firestore instance.'
+            });
+        const converted = kind === 'create' || kind === 'set'
+            ? ref._toFirestore(data, options)
+            : data;
+        const operation = prepareWrite(ref, kind, converted, options, precondition);
+        const previous = this.tails.get(ref.path) ?? Promise.resolve();
+        const result = previous.then(() => this.perform(ref, operation));
+        const settled = result.then(() => { }, () => { });
+        this.tails.set(ref.path, settled);
+        this.pending.add(settled);
+        void settled.then(() => {
+            this.pending.delete(settled);
+            if (this.tails.get(ref.path) === settled)
+                this.tails.delete(ref.path);
+        });
+        return result;
+    }
+    async perform(ref, operation) {
+        return this.firestore._trace('BulkWriter.perform', async () => {
+            let attempts = 0;
+            for (;;) {
+                let result;
+                try {
+                    result = await this.submit(operation);
+                }
+                catch (cause) {
+                    attempts++;
+                    const code = ERROR_CODES[cause?.code ?? ''] ??
+                        2;
+                    const error = new BulkWriterError(code, cause instanceof Error ? cause.message : String(cause), ref, operation.kind, attempts);
+                    const retry = this.errorHandler
+                        ? this.errorHandler(error)
+                        : ([10, 14].includes(code) ||
+                            (operation.kind === 'delete' && code === 13)) &&
+                            attempts < 10;
+                    if (!retry)
+                        throw error;
+                    await new Promise((resolve) => setTimeout(resolve, Math.min(10 * 2 ** (attempts - 1), 1000)));
+                    continue;
+                }
+                this.resultHandler?.(ref, result);
+                return result;
+            }
+        });
+    }
+    submit(operation) {
+        return new Promise((resolve, reject) => {
+            this.ready.push({ operation, resolve, reject });
+            if (this.scheduled)
+                return;
+            this.scheduled = true;
+            void Promise.resolve().then(() => {
+                this.scheduled = false;
+                this.drain();
+            });
+        });
+    }
+    drain() {
+        // Small configured rates retain individual pacing; normal rates pack 20 writes.
+        const batchSize = this.initialRate < 20 ? 1 : 20;
+        while (this.ready.length && this.activeRequests < 10) {
+            const batch = this.ready.splice(0, batchSize);
+            this.activeRequests++;
+            void this.dispatch(batch);
+        }
+    }
+    async dispatch(batch) {
+        try {
+            await this.throttle(batch.length);
+            const results = await this.firestore._batchWrite(batch.map((entry) => entry.operation));
+            if (results.length !== batch.length)
+                throw new FirebaseEdgeError({
+                    ...FirestoreErrorInfo.INVALID_RESPONSE,
+                    message: 'Incomplete bulk write results.'
+                });
+            for (const [index, entry] of batch.entries()) {
+                const result = results[index];
+                if (result instanceof Error)
+                    entry.reject(result);
+                else
+                    entry.resolve(result);
+            }
+        }
+        catch (error) {
+            for (const entry of batch)
+                entry.reject(error);
+        }
+        finally {
+            this.activeRequests--;
+            this.drain();
+        }
+    }
+    async throttle(count) {
+        if (this.maximumRate === Infinity && this.initialRate === Infinity)
+            return;
+        const now = Date.now();
+        const slot = Math.max(now, this.nextSlot);
+        const rate = Math.min(this.maximumRate, this.initialRate *
+            1.5 ** Math.floor((slot - this.startedAt) / 300000));
+        this.nextSlot = slot + (count * 1000) / rate;
+        if (slot <= now)
+            return;
+        await new Promise((resolve) => setTimeout(resolve, Math.ceil(slot - now)));
+    }
+}
+//# sourceMappingURL=bulk-writer.js.map

package/dist/db/bulk-writer.js.map

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

package/dist/db/bundle-builder.d.ts

@@ -0,0 +1,17 @@
+import { DocumentSnapshot } from './document-snapshot.js';
+import { QuerySnapshot } from './query.js';
+/** Builds the length-prefixed UTF-8 bundle format accepted by the Firebase Web SDK. */
+export declare class BundleBuilder {
+    private readonly name;
+    private readonly documents;
+    private readonly queries;
+    private built;
+    private readonly createTime;
+    constructor(name?: string);
+    get bundleId(): string;
+    add(snapshot: DocumentSnapshot<any>): this;
+    add(queryName: string, snapshot: QuerySnapshot<any>): this;
+    build(): Uint8Array<ArrayBuffer>;
+    private addDocument;
+}
+//# sourceMappingURL=bundle-builder.d.ts.map

package/dist/db/bundle-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-builder.d.ts","sourceRoot":"","sources":["../../src/db/bundle-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAO3C,uFAAuF;AACvF,qBAAa,aAAa;IAQV,OAAO,CAAC,QAAQ,CAAC,IAAI;IAPjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAGtB;IACJ,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;gBAC5B,IAAI,SAAW;IAO5C,IAAI,QAAQ,IAAI,MAAM,CAErB;IACD,GAAG,CAAC,QAAQ,EAAE,gBAAgB,CAAC,GAAG,CAAC,GAAG,IAAI;IAC1C,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,IAAI;IAuC1D,KAAK,IAAI,UAAU,CAAC,WAAW,CAAC;IAyChC,OAAO,CAAC,WAAW;CAatB"}

package/dist/db/bundle-builder.js

@@ -0,0 +1,118 @@
+import { DocumentSnapshot } from './document-snapshot.js';
+import { QuerySnapshot } from './query.js';
+import { Timestamp } from './timestamp.js';
+import { autoId } from './firestore-path.js';
+import { FirebaseEdgeError } from '../auth/errors.js';
+import { FirestoreErrorInfo } from './firestore-error-codes.js';
+/** Builds the length-prefixed UTF-8 bundle format accepted by the Firebase Web SDK. */
+export class BundleBuilder {
+    name;
+    documents = new Map();
+    queries = new Map();
+    built = false;
+    createTime = Timestamp.now().toString();
+    constructor(name = autoId()) {
+        this.name = name;
+        if (typeof name !== 'string' || !name)
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Bundle name must be a non-empty string.'
+            });
+    }
+    get bundleId() {
+        return this.name;
+    }
+    add(value, snapshot) {
+        if (this.built)
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.FAILED_PRECONDITION,
+                message: 'Bundle has already been built.'
+            });
+        if (value instanceof DocumentSnapshot && snapshot === undefined) {
+            this.addDocument(value);
+            return this;
+        }
+        if (typeof value !== 'string' ||
+            !value ||
+            !(snapshot instanceof QuerySnapshot))
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Expected a document snapshot or a named query snapshot.'
+            });
+        if (this.queries.has(value))
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Bundle query names must be unique.'
+            });
+        this.queries.set(value, {
+            namedQuery: {
+                name: value,
+                bundledQuery: snapshot.query._bundledQuery(),
+                readTime: snapshot.readTime.toString()
+            }
+        });
+        for (const document of snapshot.docs)
+            this.addDocument(document, value);
+        return this;
+    }
+    build() {
+        if (this.built)
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.FAILED_PRECONDITION,
+                message: 'Bundle has already been built.'
+            });
+        this.built = true;
+        const chunks = [...this.queries.values()].map(encodeElement);
+        for (const [name, entry] of this.documents) {
+            chunks.push(encodeElement({
+                documentMetadata: {
+                    name,
+                    readTime: entry.readTime,
+                    exists: !!entry.document,
+                    queries: [...entry.queries]
+                }
+            }));
+            if (entry.document)
+                chunks.push(encodeElement({ document: entry.document }));
+        }
+        const totalBytes = chunks.reduce((sum, chunk) => sum + chunk.length, 0);
+        const metadata = encodeElement({
+            metadata: {
+                id: this.name,
+                createTime: this.createTime,
+                version: 1,
+                totalDocuments: this.documents.size,
+                totalBytes
+            }
+        });
+        const result = new Uint8Array(metadata.length + totalBytes);
+        result.set(metadata);
+        let offset = metadata.length;
+        for (const chunk of chunks) {
+            result.set(chunk, offset);
+            offset += chunk.length;
+        }
+        return result;
+    }
+    addDocument(snapshot, query) {
+        const name = snapshot.ref.firestore._documentName(snapshot.ref.path);
+        const existing = this.documents.get(name);
+        const queries = existing?.queries ?? new Set();
+        if (query)
+            queries.add(query);
+        if (existing && existing.readTime > snapshot.readTime.toString())
+            return;
+        this.documents.set(name, {
+            document: snapshot._bundleDocument(),
+            readTime: snapshot.readTime.toString(),
+            queries
+        });
+    }
+}
+function encodeElement(value) {
+    const encoder = new TextEncoder();
+    const json = JSON.stringify(value);
+    const bytes = encoder.encode(json);
+    return encoder.encode(`${bytes.length}${json}`);
+}
+//# sourceMappingURL=bundle-builder.js.map

package/dist/db/bundle-builder.js.map

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

package/dist/db/bytes.d.ts

@@ -0,0 +1,12 @@
+/** Edge-compatible byte values; no Node Buffer dependency. */
+export declare class Bytes {
+    private readonly value;
+    private constructor();
+    static fromBase64String(value: string): Bytes;
+    static fromUint8Array(value: Uint8Array): Bytes;
+    toBase64(): string;
+    toUint8Array(): Uint8Array;
+    isEqual(other: Bytes): boolean;
+    toString(): string;
+}
+//# sourceMappingURL=bytes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../../src/db/bytes.ts"],"names":[],"mappings":"AAEA,8DAA8D;AAC9D,qBAAa,KAAK;IACM,OAAO,CAAC,QAAQ,CAAC,KAAK;IAA1C,OAAO;IACP,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK;IAsB7C,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK;IAU/C,QAAQ,IAAI,MAAM;IAKlB,YAAY,IAAI,UAAU;IAG1B,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAO9B,QAAQ,IAAI,MAAM;CAGrB"}

package/dist/db/bytes.js

@@ -0,0 +1,49 @@
+import { FirestoreErrorInfo } from './firestore-error-codes.js';
+import { FirebaseEdgeError, ensureError } from '../auth/errors.js';
+/** Edge-compatible byte values; no Node Buffer dependency. */
+export class Bytes {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+    static fromBase64String(value) {
+        if (typeof value !== 'string')
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Expected base64 text.'
+            });
+        try {
+            return new Bytes(Uint8Array.from(atob(value), (character) => character.charCodeAt(0)));
+        }
+        catch (cause) {
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Expected base64 text.'
+            }, { cause: ensureError(cause) });
+        }
+    }
+    static fromUint8Array(value) {
+        if (!(value instanceof Uint8Array)) {
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Expected Uint8Array.'
+            });
+        }
+        return new Bytes(new Uint8Array(value));
+    }
+    toBase64() {
+        return btoa(Array.from(this.value, (byte) => String.fromCharCode(byte)).join(''));
+    }
+    toUint8Array() {
+        return this.value.slice();
+    }
+    isEqual(other) {
+        return (other instanceof Bytes &&
+            this.value.length === other.value.length &&
+            this.value.every((byte, index) => byte === other.value[index]));
+    }
+    toString() {
+        return `Bytes(base64: ${this.toBase64()})`;
+    }
+}
+//# sourceMappingURL=bytes.js.map

package/dist/db/bytes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.js","sourceRoot":"","sources":["../../src/db/bytes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACnE,8DAA8D;AAC9D,MAAM,OAAO,KAAK;IACuB;IAArC,YAAqC,KAAiB;QAAjB,UAAK,GAAL,KAAK,CAAY;IAAG,CAAC;IAC1D,MAAM,CAAC,gBAAgB,CAAC,KAAa;QACjC,IAAI,OAAO,KAAK,KAAK,QAAQ;YACzB,MAAM,IAAI,iBAAiB,CAAC;gBACxB,GAAG,kBAAkB,CAAC,gBAAgB;gBACtC,OAAO,EAAE,uBAAuB;aACnC,CAAC,CAAC;QACP,IAAI,CAAC;YACD,OAAO,IAAI,KAAK,CACZ,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,CACvC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAC1B,CACJ,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,IAAI,iBAAiB,CACvB;gBACI,GAAG,kBAAkB,CAAC,gBAAgB;gBACtC,OAAO,EAAE,uBAAuB;aACnC,EACD,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAChC,CAAC;QACN,CAAC;IACL,CAAC;IACD,MAAM,CAAC,cAAc,CAAC,KAAiB;QACnC,IAAI,CAAC,CAAC,KAAK,YAAY,UAAU,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,iBAAiB,CAAC;gBACxB,GAAG,kBAAkB,CAAC,gBAAgB;gBACtC,OAAO,EAAE,sBAAsB;aAClC,CAAC,CAAC;QACP,CAAC;QAED,OAAO,IAAI,KAAK,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5C,CAAC;IACD,QAAQ;QACJ,OAAO,IAAI,CACP,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CACvE,CAAC;IACN,CAAC;IACD,YAAY;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO,CAAC,KAAY;QAChB,OAAO,CACH,KAAK,YAAY,KAAK;YACtB,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,KAAK,CAAC,MAAM;YACxC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CACjE,CAAC;IACN,CAAC;IACD,QAAQ;QACJ,OAAO,iBAAiB,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC;IAC/C,CAAC;CACJ"}

package/dist/db/collection-group.d.ts

@@ -0,0 +1,14 @@
+import { Query, type QueryExecutor } from './query.js';
+import type { Firestore } from './firestore.js';
+import type { DocumentData } from './firestore-document.js';
+import { type FirestoreDataConverter } from './firestore-converter.js';
+import { QueryPartition } from './query-partition.js';
+export declare class CollectionGroup<T = DocumentData, DbModelType extends DocumentData = DocumentData> extends Query<T, DbModelType> {
+    /** @internal Use firestore.collectionGroup(). */
+    constructor(firestore: Firestore, collectionId: string, execute: QueryExecutor, converter?: FirestoreDataConverter<T, DbModelType> | null);
+    getPartitions(desiredPartitionCount: number): AsyncGenerator<QueryPartition<T, DbModelType>>;
+    withConverter<U, NewDbModelType extends DocumentData = DocumentData>(converter: FirestoreDataConverter<U, NewDbModelType>): CollectionGroup<U, NewDbModelType>;
+    withConverter(converter: null): CollectionGroup;
+    withConverter<U, NewDbModelType extends DocumentData = DocumentData>(converter: FirestoreDataConverter<U, NewDbModelType> | null): CollectionGroup<U, NewDbModelType>;
+}
+//# sourceMappingURL=collection-group.d.ts.map

package/dist/db/collection-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-group.d.ts","sourceRoot":"","sources":["../../src/db/collection-group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAEH,KAAK,sBAAsB,EAC9B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAItD,qBAAa,eAAe,CACxB,CAAC,GAAG,YAAY,EAChB,WAAW,SAAS,YAAY,GAAG,YAAY,CACjD,SAAQ,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC;IAC3B,iDAAiD;gBAE7C,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,aAAa,EACtB,SAAS,GAAE,sBAAsB,CAAC,CAAC,EAAE,WAAW,CAAC,GAAG,IAAW;IAoB5D,aAAa,CAChB,qBAAqB,EAAE,MAAM,GAC9B,cAAc,CAAC,cAAc,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;IAwBxC,aAAa,CAClB,CAAC,EACD,cAAc,SAAS,YAAY,GAAG,YAAY,EAElD,SAAS,EAAE,sBAAsB,CAAC,CAAC,EAAE,cAAc,CAAC,GACrD,eAAe,CAAC,CAAC,EAAE,cAAc,CAAC;IAC5B,aAAa,CAAC,SAAS,EAAE,IAAI,GAAG,eAAe;IAC/C,aAAa,CAClB,CAAC,EACD,cAAc,SAAS,YAAY,GAAG,YAAY,EAElD,SAAS,EAAE,sBAAsB,CAAC,CAAC,EAAE,cAAc,CAAC,GAAG,IAAI,GAC5D,eAAe,CAAC,CAAC,EAAE,cAAc,CAAC;CAexC"}

package/dist/db/collection-group.js

@@ -0,0 +1,43 @@
+import { Query } from './query.js';
+import { validateConverter } from './firestore-converter.js';
+import { FieldPath } from './field-path.js';
+import { QueryPartition } from './query-partition.js';
+import { FirebaseEdgeError } from '../auth/errors.js';
+import { FirestoreErrorInfo } from './firestore-error-codes.js';
+export class CollectionGroup extends Query {
+    /** @internal Use firestore.collectionGroup(). */
+    constructor(firestore, collectionId, execute, converter = null) {
+        if (typeof collectionId !== 'string' ||
+            !collectionId ||
+            collectionId.includes('/') ||
+            ['.', '..'].includes(collectionId))
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'A collection group requires a single collection ID.'
+            });
+        super(firestore, collectionId, execute, { allDescendants: true }, converter);
+    }
+    async *getPartitions(desiredPartitionCount) {
+        if (!Number.isSafeInteger(desiredPartitionCount) ||
+            desiredPartitionCount < 1)
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Partition count must be a positive safe integer.'
+            });
+        const paths = desiredPartitionCount === 1
+            ? []
+            : await this.firestore._partitionQuery(this.collectionPath, desiredPartitionCount);
+        const query = this.orderBy(FieldPath.documentId());
+        let start;
+        for (const end of paths) {
+            yield new QueryPartition(query, start, end);
+            start = end;
+        }
+        yield new QueryPartition(query, start, undefined);
+    }
+    withConverter(converter) {
+        validateConverter(converter);
+        return new CollectionGroup(this.firestore, this.collectionPath, this.execute, converter);
+    }
+}
+//# sourceMappingURL=collection-group.js.map

package/dist/db/collection-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-group.js","sourceRoot":"","sources":["../../src/db/collection-group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAsB,MAAM,YAAY,CAAC;AAGvD,OAAO,EACH,iBAAiB,EAEpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,MAAM,OAAO,eAGX,SAAQ,KAAqB;IAC3B,iDAAiD;IACjD,YACI,SAAoB,EACpB,YAAoB,EACpB,OAAsB,EACtB,YAA2D,IAAI;QAE/D,IACI,OAAO,YAAY,KAAK,QAAQ;YAChC,CAAC,YAAY;YACb,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC;YAC1B,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC;YAElC,MAAM,IAAI,iBAAiB,CAAC;gBACxB,GAAG,kBAAkB,CAAC,gBAAgB;gBACtC,OAAO,EAAE,qDAAqD;aACjE,CAAC,CAAC;QACP,KAAK,CACD,SAAS,EACT,YAAY,EACZ,OAAO,EACP,EAAE,cAAc,EAAE,IAAI,EAAE,EACxB,SAAS,CACZ,CAAC;IACN,CAAC;IACD,KAAK,CAAC,CAAC,aAAa,CAChB,qBAA6B;QAE7B,IACI,CAAC,MAAM,CAAC,aAAa,CAAC,qBAAqB,CAAC;YAC5C,qBAAqB,GAAG,CAAC;YAEzB,MAAM,IAAI,iBAAiB,CAAC;gBACxB,GAAG,kBAAkB,CAAC,gBAAgB;gBACtC,OAAO,EAAE,kDAAkD;aAC9D,CAAC,CAAC;QACP,MAAM,KAAK,GACP,qBAAqB,KAAK,CAAC;YACvB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,eAAe,CAChC,IAAI,CAAC,cAAc,EACnB,qBAAqB,CACxB,CAAC;QACZ,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC;QACnD,IAAI,KAAyB,CAAC;QAC9B,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,IAAI,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;YAC5C,KAAK,GAAG,GAAG,CAAC;QAChB,CAAC;QACD,MAAM,IAAI,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IACtD,CAAC;IAcQ,aAAa,CAIlB,SAA2D;QAE3D,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAC7B,OAAO,IAAI,eAAe,CACtB,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,cAAc,EACnB,IAAI,CAAC,OAAO,EACZ,SAAS,CACZ,CAAC;IACN,CAAC;CACJ"}

package/dist/db/collection-reference.d.ts

@@ -0,0 +1,21 @@
+import { type FirestoreResult } from './firestore-results.js';
+import type { WithFieldValue } from './firestore-types.js';
+import { Query, type QueryExecutor } from './query.js';
+import type { Firestore, DocumentReference } from './firestore.js';
+import type { DocumentData } from './firestore-document.js';
+import { type FirestoreDataConverter } from './firestore-converter.js';
+/** A collection reference is also an unfiltered query. */
+export declare class CollectionReference<T = DocumentData, DbModelType extends DocumentData = DocumentData> extends Query<T, DbModelType> {
+    readonly path: string;
+    readonly id: string;
+    readonly parent: DocumentReference | null;
+    /** @internal Obtain collection references from firestore.collection(). */
+    constructor(firestore: Firestore, path: string, execute: QueryExecutor, converter?: FirestoreDataConverter<T, DbModelType> | null);
+    doc(documentPath?: string): DocumentReference<T, DbModelType>;
+    add(data: WithFieldValue<T>): Promise<FirestoreResult<DocumentReference<T, DbModelType>>>;
+    listDocuments(): Promise<FirestoreResult<DocumentReference<T, DbModelType>[]>>;
+    withConverter<U, NewDbModelType extends DocumentData = DocumentData>(converter: FirestoreDataConverter<U, NewDbModelType>): CollectionReference<U, NewDbModelType>;
+    withConverter(converter: null): CollectionReference;
+    withConverter<U, NewDbModelType extends DocumentData = DocumentData>(converter: FirestoreDataConverter<U, NewDbModelType> | null): CollectionReference<U, NewDbModelType>;
+}
+//# sourceMappingURL=collection-reference.d.ts.map

package/dist/db/collection-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-reference.d.ts","sourceRoot":"","sources":["../../src/db/collection-reference.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,eAAe,EAGvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EACR,cAAc,EAGjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,KAAK,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAEvD,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAEH,KAAK,sBAAsB,EAC9B,MAAM,0BAA0B,CAAC;AAGlC,0DAA0D;AAC1D,qBAAa,mBAAmB,CAC5B,CAAC,GAAG,YAAY,EAChB,WAAW,SAAS,YAAY,GAAG,YAAY,CACjD,SAAQ,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC;IAMvB,QAAQ,CAAC,IAAI,EAAE,MAAM;IALzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC1C,0EAA0E;gBAEtE,SAAS,EAAE,SAAS,EACX,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,aAAa,EACtB,SAAS,GAAE,sBAAsB,CAAC,CAAC,EAAE,WAAW,CAAC,GAAG,IAAW;IAWnE,GAAG,CAAC,YAAY,GAAE,MAAiB,GAAG,iBAAiB,CAAC,CAAC,EAAE,WAAW,CAAC;IAMjE,GAAG,CACL,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;IAOxD,aAAa,IAAI,OAAO,CAC1B,eAAe,CAAC,iBAAiB,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,CAAC,CACvD;IAQQ,aAAa,CAClB,CAAC,EACD,cAAc,SAAS,YAAY,GAAG,YAAY,EAElD,SAAS,EAAE,sBAAsB,CAAC,CAAC,EAAE,cAAc,CAAC,GACrD,mBAAmB,CAAC,CAAC,EAAE,cAAc,CAAC;IAChC,aAAa,CAAC,SAAS,EAAE,IAAI,GAAG,mBAAmB;IACnD,aAAa,CAClB,CAAC,EACD,cAAc,SAAS,YAAY,GAAG,YAAY,EAElD,SAAS,EAAE,sBAAsB,CAAC,CAAC,EAAE,cAAc,CAAC,GAAG,IAAI,GAC5D,mBAAmB,CAAC,CAAC,EAAE,cAAc,CAAC;CAe5C"}

package/dist/db/collection-reference.js

@@ -0,0 +1,46 @@
+import { firestoreResult, firestoreData } from './firestore-results.js';
+import { Query } from './query.js';
+import { validatePath } from './firestore-path.js';
+import { validateConverter } from './firestore-converter.js';
+import { autoId } from './firestore-path.js';
+/** A collection reference is also an unfiltered query. */
+export class CollectionReference extends Query {
+    path;
+    id;
+    parent;
+    /** @internal Obtain collection references from firestore.collection(). */
+    constructor(firestore, path, execute, converter = null) {
+        validatePath(path, false);
+        super(firestore, path, execute, {}, converter);
+        this.path = path;
+        const segments = path.split('/');
+        this.id = segments.pop();
+        this.parent = segments.length
+            ? firestore.doc(segments.join('/'))
+            : null;
+    }
+    doc(documentPath = autoId()) {
+        validatePath(documentPath, false);
+        return this.firestore
+            .doc(`${this.path}/${documentPath}`)
+            .withConverter(this.converter);
+    }
+    async add(data) {
+        return firestoreResult(async () => {
+            const ref = this.doc();
+            await ref.create(data).then(firestoreData);
+            return ref;
+        });
+    }
+    async listDocuments() {
+        return firestoreResult(async () => {
+            const paths = await this.firestore._listDocuments(this.path);
+            return paths.map((path) => this.firestore.doc(path).withConverter(this.converter));
+        });
+    }
+    withConverter(converter) {
+        validateConverter(converter);
+        return new CollectionReference(this.firestore, this.path, this.execute, converter);
+    }
+}
+//# sourceMappingURL=collection-reference.js.map

package/dist/db/collection-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-reference.js","sourceRoot":"","sources":["../../src/db/collection-reference.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,eAAe,EACf,aAAa,EAChB,MAAM,wBAAwB,CAAC;AAMhC,OAAO,EAAE,KAAK,EAAsB,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EACH,iBAAiB,EAEpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,0DAA0D;AAC1D,MAAM,OAAO,mBAGX,SAAQ,KAAqB;IAMd;IALJ,EAAE,CAAS;IACX,MAAM,CAA2B;IAC1C,0EAA0E;IAC1E,YACI,SAAoB,EACX,IAAY,EACrB,OAAsB,EACtB,YAA2D,IAAI;QAE/D,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC1B,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;QALtC,SAAI,GAAJ,IAAI,CAAQ;QAMrB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,EAAE,GAAG,QAAQ,CAAC,GAAG,EAAG,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM;YACzB,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACnC,CAAC,CAAC,IAAI,CAAC;IACf,CAAC;IAED,GAAG,CAAC,eAAuB,MAAM,EAAE;QAC/B,YAAY,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC,SAAS;aAChB,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,YAAY,EAAE,CAAC;aACnC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IACD,KAAK,CAAC,GAAG,CACL,IAAuB;QAEvB,OAAO,eAAe,CAAC,KAAK,IAAI,EAAE;YAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC3C,OAAO,GAAG,CAAC;QACf,CAAC,CAAC,CAAC;IACP,CAAC;IACD,KAAK,CAAC,aAAa;QAGf,OAAO,eAAe,CAAC,KAAK,IAAI,EAAE;YAC9B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7D,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACtB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CACzD,CAAC;QACN,CAAC,CAAC,CAAC;IACP,CAAC;IAcQ,aAAa,CAIlB,SAA2D;QAE3D,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAC7B,OAAO,IAAI,mBAAmB,CAC1B,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,OAAO,EACZ,SAAS,CACZ,CAAC;IACN,CAAC;CACJ"}