firebase-admin-edge 1.1.0 → 2.0.0

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

@@ -0,0 +1,41 @@
+import { type FirestoreResult } from './firestore-results.js';
+import type { WithFieldValue, PartialWithFieldValue, UpdateData } from './firestore-types.js';
+import type { Firestore } from './firestore.js';
+import { type SnapshotListenOptions, type SnapshotCallback, type SnapshotErrorCallback } from './snapshot-listener.js';
+import { DocumentSnapshot } from './document-snapshot.js';
+import { FieldPath } from './field-path.js';
+import type { CollectionReference } from './collection-reference.js';
+import type { FirestoreDocument } from './firestore-document.js';
+import type { DocumentData } from './firestore-document.js';
+import type { SetOptions, Precondition, WriteResult } from './write-request.js';
+import { type FirestoreDataConverter } from './firestore-converter.js';
+export type DocumentExecutor = (path: string) => Promise<FirestoreDocument | undefined>;
+/** A document location with read access and collection navigation. */
+export declare class DocumentReference<T = DocumentData, DbModelType extends DocumentData = DocumentData> {
+    readonly firestore: Firestore;
+    readonly path: string;
+    private readonly execute;
+    readonly converter: FirestoreDataConverter<T, DbModelType> | null;
+    onSnapshot(next: SnapshotCallback<DocumentSnapshot<T, DbModelType>>, error?: SnapshotErrorCallback, options?: SnapshotListenOptions): () => void;
+    onSnapshot(options: SnapshotListenOptions, next: SnapshotCallback<DocumentSnapshot<T, DbModelType>>, error?: SnapshotErrorCallback): () => void;
+    create(data: WithFieldValue<T>): Promise<FirestoreResult<WriteResult>>;
+    set(data: WithFieldValue<T>): Promise<FirestoreResult<WriteResult>>;
+    set(data: PartialWithFieldValue<T>, options: SetOptions): Promise<FirestoreResult<WriteResult>>;
+    update(data: UpdateData<DbModelType>, precondition?: Precondition): Promise<FirestoreResult<WriteResult>>;
+    update(field: string | FieldPath, value: unknown, ...moreFieldsOrPrecondition: unknown[]): Promise<FirestoreResult<WriteResult>>;
+    delete(precondition?: Precondition): Promise<FirestoreResult<WriteResult>>;
+    readonly id: string;
+    /** @internal Obtain references from firestore.doc() or collection.doc(). */
+    constructor(firestore: Firestore, path: string, execute: DocumentExecutor, converter?: FirestoreDataConverter<T, DbModelType> | null);
+    get parent(): CollectionReference<T, DbModelType>;
+    collection(collectionPath: string): CollectionReference;
+    get(): Promise<FirestoreResult<DocumentSnapshot<T, DbModelType>>>;
+    isEqual(other: DocumentReference<any>): boolean;
+    withConverter<U, NewDbModelType extends DocumentData = DocumentData>(converter: FirestoreDataConverter<U, NewDbModelType>): DocumentReference<U, NewDbModelType>;
+    withConverter(converter: null): DocumentReference;
+    withConverter<U, NewDbModelType extends DocumentData = DocumentData>(converter: FirestoreDataConverter<U, NewDbModelType> | null): DocumentReference<U, NewDbModelType>;
+    listCollections(): Promise<FirestoreResult<CollectionReference[]>>;
+    /** @internal Updates deliberately bypass converters, matching Admin Firestore. */
+    _toFirestore(data: PartialWithFieldValue<T>, options?: SetOptions): DocumentData;
+}
+//# sourceMappingURL=document-reference.d.ts.map

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

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

package/dist/db/document-reference.js

@@ -0,0 +1,125 @@
+import { firestoreResult, firestoreData } from './firestore-results.js';
+import { listenByPolling } from './snapshot-listener.js';
+import { DocumentSnapshot } from './document-snapshot.js';
+import { Timestamp } from './timestamp.js';
+import { FieldPath } from './field-path.js';
+import { normalizeUpdateArguments } from './write-request.js';
+import { validatePath } from './firestore-path.js';
+import { validateConverter } from './firestore-converter.js';
+/** A document location with read access and collection navigation. */
+export class DocumentReference {
+    firestore;
+    path;
+    execute;
+    converter;
+    onSnapshot(first, second, third) {
+        return listenByPolling(this.firestore, () => this.get().then(firestoreData), (current, previous) => previous?.isEqual(current) ? undefined : current, first, second, third);
+    }
+    async create(data) {
+        return firestoreResult(async () => {
+            return this.firestore._trace('DocumentReference.create', async () => {
+                const results = await this.firestore
+                    .batch()
+                    .create(this, data)
+                    .commit()
+                    .then(firestoreData);
+                return results[0];
+            });
+        });
+    }
+    async set(data, options) {
+        return firestoreResult(async () => {
+            return this.firestore._trace('DocumentReference.set', async () => {
+                const batch = this.firestore.batch();
+                if (options === undefined) {
+                    batch.set(this, data);
+                }
+                else {
+                    batch.set(this, data, options);
+                }
+                const results = await batch.commit().then(firestoreData);
+                return results[0];
+            });
+        });
+    }
+    async update(data, ...args) {
+        return firestoreResult(async () => {
+            return this.firestore._trace('DocumentReference.update', async () => {
+                const update = normalizeUpdateArguments(data, args);
+                const results = await this.firestore
+                    .batch()
+                    .update(this, update.data, update.precondition)
+                    .commit()
+                    .then(firestoreData);
+                return results[0];
+            });
+        });
+    }
+    async delete(precondition) {
+        return firestoreResult(async () => {
+            return this.firestore._trace('DocumentReference.delete', async () => {
+                const results = await this.firestore
+                    .batch()
+                    .delete(this, precondition)
+                    .commit()
+                    .then(firestoreData);
+                return results[0];
+            });
+        });
+    }
+    id;
+    /** @internal Obtain references from firestore.doc() or collection.doc(). */
+    constructor(firestore, path, execute, converter = null) {
+        this.firestore = firestore;
+        this.path = path;
+        this.execute = execute;
+        this.converter = converter;
+        validatePath(path, true);
+        this.id = path.split('/').at(-1);
+    }
+    get parent() {
+        return this.firestore
+            .collection(this.path.slice(0, this.path.lastIndexOf('/')))
+            .withConverter(this.converter);
+    }
+    collection(collectionPath) {
+        validatePath(collectionPath, false);
+        return this.firestore.collection(`${this.path}/${collectionPath}`);
+    }
+    async get() {
+        return firestoreResult(async () => {
+            return this.firestore._trace('DocumentReference.get', async () => {
+                const readTime = Timestamp.now();
+                const document = await this.execute(this.path);
+                return new DocumentSnapshot(this, document, readTime);
+            });
+        });
+    }
+    isEqual(other) {
+        if (!(other instanceof DocumentReference))
+            return false;
+        return (this.firestore === other.firestore &&
+            this.path === other.path &&
+            this.converter === other.converter);
+    }
+    withConverter(converter) {
+        validateConverter(converter);
+        return new DocumentReference(this.firestore, this.path, this.execute, converter);
+    }
+    listCollections() {
+        return firestoreResult(async () => {
+            return this.firestore._trace('DocumentReference.listCollections', async () => {
+                return this.firestore._listCollections(this.path);
+            });
+        });
+    }
+    /** @internal Updates deliberately bypass converters, matching Admin Firestore. */
+    _toFirestore(data, options) {
+        if (!this.converter)
+            return data;
+        if (options === undefined)
+            return this.converter.toFirestore(data);
+        return this.converter.toFirestore(data, options);
+    }
+}
+//# sourceMappingURL=document-reference.js.map

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

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

package/dist/db/document-snapshot.d.ts

@@ -0,0 +1,31 @@
+import { Timestamp } from './timestamp.js';
+import type { DocumentReference } from './document-reference.js';
+import { FieldPath } from './field-path.js';
+import { type FirestoreValue } from './firestore-document.js';
+import { type DocumentData, type FirestoreDocument } from './firestore-document.js';
+/** A document read result, including a result for a missing document. */
+export declare class DocumentSnapshot<T = DocumentData, DbModelType extends DocumentData = DocumentData> {
+    readonly ref: DocumentReference<T, DbModelType>;
+    private readonly document;
+    readonly id: string;
+    readonly exists: boolean;
+    readonly readTime: Timestamp;
+    get createTime(): Timestamp | undefined;
+    get updateTime(): Timestamp | undefined;
+    isEqual(other: unknown): boolean;
+    /** @internal Obtain snapshots from DocumentReference.get(). */
+    constructor(ref: DocumentReference<T, DbModelType>, document: FirestoreDocument | undefined, readTime?: Timestamp);
+    /** @internal Preserve raw fields and nanosecond timestamps for bundles. */
+    _bundleDocument(): FirestoreDocument | undefined;
+    data(): T | undefined;
+    get(fieldPath: string | FieldPath): unknown;
+    /** @internal Snapshot cursors use stored values, not converted application data. */
+    _getValue(fieldPath: string | FieldPath): FirestoreValue | undefined;
+}
+/** A query result always represents an existing document. */
+export declare class QueryDocumentSnapshot<T = DocumentData, DbModelType extends DocumentData = DocumentData> extends DocumentSnapshot<T, DbModelType> {
+    readonly exists: true;
+    constructor(ref: DocumentReference<T, DbModelType>, document: FirestoreDocument);
+    data(): T;
+}
+//# sourceMappingURL=document-snapshot.d.ts.map

package/dist/db/document-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-snapshot.d.ts","sourceRoot":"","sources":["../../src/db/document-snapshot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAe,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAEH,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACzB,MAAM,yBAAyB,CAAC;AAEjC,yEAAyE;AACzE,qBAAa,gBAAgB,CACzB,CAAC,GAAG,YAAY,EAChB,WAAW,SAAS,YAAY,GAAG,YAAY;IA6B3C,QAAQ,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC,EAAE,WAAW,CAAC;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IA5B7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,IAAI,UAAU,IAAI,SAAS,GAAG,SAAS,CAItC;IACD,IAAI,UAAU,IAAI,SAAS,GAAG,SAAS,CAItC;IACD,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAYhC,+DAA+D;gBAElD,GAAG,EAAE,iBAAiB,CAAC,CAAC,EAAE,WAAW,CAAC,EAC9B,QAAQ,EAAE,iBAAiB,GAAG,SAAS,EACxD,QAAQ,YAAkB;IAQ9B,2EAA2E;IAC3E,eAAe,IAAI,iBAAiB,GAAG,SAAS;IAShD,IAAI,IAAI,CAAC,GAAG,SAAS;IAWrB,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO;IAM3C,oFAAoF;IACpF,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS;CAiBvE;AAED,6DAA6D;AAC7D,qBAAa,qBAAqB,CAC9B,CAAC,GAAG,YAAY,EAChB,WAAW,SAAS,YAAY,GAAG,YAAY,CACjD,SAAQ,gBAAgB,CAAC,CAAC,EAAE,WAAW,CAAC;IACtC,SAAkB,MAAM,EAAG,IAAI,CAAU;gBAErC,GAAG,EAAE,iBAAiB,CAAC,CAAC,EAAE,WAAW,CAAC,EACtC,QAAQ,EAAE,iBAAiB;IAUtB,IAAI,IAAI,CAAC;CAGrB"}

package/dist/db/document-snapshot.js

@@ -0,0 +1,103 @@
+import { FirestoreErrorInfo } from './firestore-error-codes.js';
+import { Timestamp } from './timestamp.js';
+import { valueEquals } from './value-equality.js';
+import { FirebaseEdgeError } from '../auth/errors.js';
+import { FieldPath } from './field-path.js';
+import { validateFieldPath } from './query-request.js';
+import { decodeValue } from './firestore-document.js';
+import { decodeFields } from './firestore-document.js';
+/** A document read result, including a result for a missing document. */
+export class DocumentSnapshot {
+    ref;
+    document;
+    id;
+    exists;
+    readTime;
+    get createTime() {
+        return this.document?.createTime
+            ? Timestamp.fromString(this.document.createTime)
+            : undefined;
+    }
+    get updateTime() {
+        return this.document?.updateTime
+            ? Timestamp.fromString(this.document.updateTime)
+            : undefined;
+    }
+    isEqual(other) {
+        return (other instanceof DocumentSnapshot &&
+            this.ref.isEqual(other.ref) &&
+            this.exists === other.exists &&
+            valueEquals(this.document?.fields ?? {}, other.document?.fields ?? {}));
+    }
+    /** @internal Obtain snapshots from DocumentReference.get(). */
+    constructor(ref, document, readTime = Timestamp.now()) {
+        this.ref = ref;
+        this.document = document;
+        this.id = ref.id;
+        this.exists = document !== undefined && !document.missing;
+        this.readTime = document?.readTime
+            ? Timestamp.fromString(document.readTime)
+            : readTime;
+    }
+    /** @internal Preserve raw fields and nanosecond timestamps for bundles. */
+    _bundleDocument() {
+        if (!this.exists || !this.document)
+            return undefined;
+        const { readTime: _, ...document } = this.document;
+        return structuredClone({
+            ...document,
+            name: this.ref.firestore._documentName(this.ref.path)
+        });
+    }
+    data() {
+        if (!this.exists || this.document === undefined)
+            return undefined;
+        if (!this.ref.converter)
+            return decodeFields(this.document.fields, this.ref.firestore);
+        const raw = new QueryDocumentSnapshot(this.ref.withConverter(null), this.document);
+        return this.ref.converter.fromFirestore(raw);
+    }
+    get(fieldPath) {
+        const value = this._getValue(fieldPath);
+        if (value === undefined)
+            return undefined;
+        return decodeValue(value, this.ref.firestore);
+    }
+    /** @internal Snapshot cursors use stored values, not converted application data. */
+    _getValue(fieldPath) {
+        if (!(fieldPath instanceof FieldPath))
+            validateFieldPath(fieldPath);
+        const segments = fieldPath instanceof FieldPath
+            ? fieldPath.segments
+            : fieldPath.split('.');
+        let fields = this.document?.fields;
+        for (let index = 0; index < segments.length; index++) {
+            const segment = segments[index];
+            if (!fields || !Object.hasOwn(fields, segment))
+                return undefined;
+            const value = fields[segment];
+            if (index === segments.length - 1)
+                return value;
+            if (!('mapValue' in value))
+                return undefined;
+            fields = value.mapValue.fields;
+        }
+        return undefined;
+    }
+}
+/** A query result always represents an existing document. */
+export class QueryDocumentSnapshot extends DocumentSnapshot {
+    exists = true;
+    constructor(ref, document) {
+        if (!document || document.missing)
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'A query document snapshot requires an existing document.'
+            });
+        super(ref, document);
+    }
+    data() {
+        return super.data();
+    }
+}
+//# sourceMappingURL=document-snapshot.js.map

package/dist/db/document-snapshot.js.map

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

package/dist/db/explain.d.ts

@@ -0,0 +1,28 @@
+export interface ExplainOptions {
+    analyze?: boolean;
+}
+export interface PlanSummary {
+    indexesUsed: Record<string, unknown>[];
+}
+export interface ExecutionStats {
+    resultsReturned: number;
+    executionDuration: {
+        seconds: number;
+        nanoseconds: number;
+    };
+    readOperations: number;
+    debugStats: Record<string, unknown>;
+}
+export interface ExplainMetrics {
+    planSummary: PlanSummary;
+    executionStats: ExecutionStats | null;
+}
+export interface ExplainResults<T> {
+    metrics: ExplainMetrics;
+    snapshot: T | null;
+}
+/** @internal Validate options before any request. */
+export declare function validateExplainOptions(options: ExplainOptions): void;
+/** @internal Convert protobuf JSON numbers and duration into SDK metric types. */
+export declare function parseExplainMetrics(input: unknown): ExplainMetrics;
+//# sourceMappingURL=explain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../src/db/explain.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AACD,MAAM,WAAW,WAAW;IACxB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CAC1C;AACD,MAAM,WAAW,cAAc;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AACD,MAAM,WAAW,cAAc;IAC3B,WAAW,EAAE,WAAW,CAAC;IACzB,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;CACzC;AACD,MAAM,WAAW,cAAc,CAAC,CAAC;IAC7B,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC;CACtB;AAED,qDAAqD;AACrD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAWpE;AACD,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CA0DlE"}

package/dist/db/explain.js

@@ -0,0 +1,61 @@
+import { FirebaseEdgeError } from '../auth/errors.js';
+import { FirestoreErrorInfo } from './firestore-error-codes.js';
+/** @internal Validate options before any request. */
+export function validateExplainOptions(options) {
+    if (!options ||
+        typeof options !== 'object' ||
+        Array.isArray(options) ||
+        (options.analyze !== undefined && typeof options.analyze !== 'boolean'))
+        throw new FirebaseEdgeError({
+            ...FirestoreErrorInfo.INVALID_ARGUMENT,
+            message: 'Invalid explain options.'
+        });
+}
+/** @internal Convert protobuf JSON numbers and duration into SDK metric types. */
+export function parseExplainMetrics(input) {
+    const value = input;
+    if (!value ||
+        typeof value !== 'object' ||
+        !value.planSummary ||
+        (value.planSummary.indexesUsed !== undefined &&
+            !Array.isArray(value.planSummary.indexesUsed)))
+        throw new FirebaseEdgeError({
+            ...FirestoreErrorInfo.INVALID_RESPONSE,
+            message: 'Invalid explain metrics.'
+        });
+    const result = {
+        planSummary: { indexesUsed: value.planSummary.indexesUsed ?? [] },
+        executionStats: null
+    };
+    if (!value.executionStats)
+        return result;
+    const stats = value.executionStats;
+    if (typeof stats !== 'object' || Array.isArray(stats))
+        throw new FirebaseEdgeError({
+            ...FirestoreErrorInfo.INVALID_RESPONSE,
+            message: 'Invalid execution statistics.'
+        });
+    const duration = /^(\d+)(?:\.(\d{1,9}))?s$/.exec(stats.executionDuration ?? '0s');
+    const resultsReturned = Number(stats.resultsReturned ?? 0);
+    const readOperations = Number(stats.readOperations ?? 0);
+    if (!duration ||
+        !Number.isSafeInteger(resultsReturned) ||
+        resultsReturned < 0 ||
+        !Number.isSafeInteger(readOperations) ||
+        readOperations < 0)
+        throw new FirebaseEdgeError({
+            ...FirestoreErrorInfo.INVALID_RESPONSE,
+            message: 'Invalid execution statistics.'
+        });
+    result.executionStats = {
+        resultsReturned,
+        readOperations,
+        executionDuration: {
+            seconds: Number(duration[1]),
+            nanoseconds: Number((duration[2] ?? '').padEnd(9, '0'))
+        },
+        debugStats: stats.debugStats ?? {}
+    };
+    return result;
+}
+//# sourceMappingURL=explain.js.map

package/dist/db/explain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.js","sourceRoot":"","sources":["../../src/db/explain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAuBhE,qDAAqD;AACrD,MAAM,UAAU,sBAAsB,CAAC,OAAuB;IAC1D,IACI,CAAC,OAAO;QACR,OAAO,OAAO,KAAK,QAAQ;QAC3B,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QACtB,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC;QAEvE,MAAM,IAAI,iBAAiB,CAAC;YACxB,GAAG,kBAAkB,CAAC,gBAAgB;YACtC,OAAO,EAAE,0BAA0B;SACtC,CAAC,CAAC;AACX,CAAC;AACD,kFAAkF;AAClF,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAC9C,MAAM,KAAK,GAAG,KAQb,CAAC;IACF,IACI,CAAC,KAAK;QACN,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,KAAK,CAAC,WAAW;QAClB,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,KAAK,SAAS;YACxC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAElD,MAAM,IAAI,iBAAiB,CAAC;YACxB,GAAG,kBAAkB,CAAC,gBAAgB;YACtC,OAAO,EAAE,0BAA0B;SACtC,CAAC,CAAC;IACP,MAAM,MAAM,GAAmB;QAC3B,WAAW,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,WAAW,IAAI,EAAE,EAAE;QACjE,cAAc,EAAE,IAAI;KACvB,CAAC;IACF,IAAI,CAAC,KAAK,CAAC,cAAc;QAAE,OAAO,MAAM,CAAC;IACzC,MAAM,KAAK,GAAG,KAAK,CAAC,cAAc,CAAC;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACjD,MAAM,IAAI,iBAAiB,CAAC;YACxB,GAAG,kBAAkB,CAAC,gBAAgB;YACtC,OAAO,EAAE,+BAA+B;SAC3C,CAAC,CAAC;IACP,MAAM,QAAQ,GAAG,0BAA0B,CAAC,IAAI,CAC5C,KAAK,CAAC,iBAAiB,IAAI,IAAI,CAClC,CAAC;IACF,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,eAAe,IAAI,CAAC,CAAC,CAAC;IAC3D,MAAM,cAAc,GAAG,MAAM,CAAC,KAAK,CAAC,cAAc,IAAI,CAAC,CAAC,CAAC;IACzD,IACI,CAAC,QAAQ;QACT,CAAC,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC;QACtC,eAAe,GAAG,CAAC;QACnB,CAAC,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC;QACrC,cAAc,GAAG,CAAC;QAElB,MAAM,IAAI,iBAAiB,CAAC;YACxB,GAAG,kBAAkB,CAAC,gBAAgB;YACtC,OAAO,EAAE,+BAA+B;SAC3C,CAAC,CAAC;IACP,MAAM,CAAC,cAAc,GAAG;QACpB,eAAe;QACf,cAAc;QACd,iBAAiB,EAAE;YACf,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC5B,WAAW,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SAC1D;QACD,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,EAAE;KACrC,CAAC;IACF,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/db/field-path.d.ts

@@ -0,0 +1,10 @@
+export declare class FieldPath {
+    readonly segments: readonly string[];
+    constructor(...fieldNames: string[]);
+    static documentId(): FieldPath;
+    isEqual(other: FieldPath): boolean;
+    toString(): string;
+}
+/** @internal Parse REST field paths, including escaped literal segments. */
+export declare function parseFieldPath(path: string): string[];
+//# sourceMappingURL=field-path.d.ts.map

package/dist/db/field-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-path.d.ts","sourceRoot":"","sources":["../../src/db/field-path.ts"],"names":[],"mappings":"AAEA,qBAAa,SAAS;IAClB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;gBACzB,GAAG,UAAU,EAAE,MAAM,EAAE;IAWnC,MAAM,CAAC,UAAU,IAAI,SAAS;IAG9B,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;IAOlC,QAAQ,IAAI,MAAM;CASrB;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAiCrD"}

package/dist/db/field-path.js

@@ -0,0 +1,65 @@
+import { FirestoreErrorInfo } from './firestore-error-codes.js';
+import { FirebaseEdgeError } from '../auth/errors.js';
+export class FieldPath {
+    segments;
+    constructor(...fieldNames) {
+        if (!fieldNames.length ||
+            fieldNames.some((name) => typeof name !== 'string' || !name.length))
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'FieldPath requires non-empty field names.'
+            });
+        this.segments = Object.freeze([...fieldNames]);
+    }
+    static documentId() {
+        return new FieldPath('__name__');
+    }
+    isEqual(other) {
+        return (other instanceof FieldPath &&
+            this.segments.length === other.segments.length &&
+            this.segments.every((segment, i) => segment === other.segments[i]));
+    }
+    toString() {
+        return this.segments
+            .map((segment) => /^[A-Za-z_][A-Za-z_0-9]*$/.test(segment)
+            ? segment
+            : `\`${segment.replaceAll('\\', '\\\\').replaceAll('`', '\\`')}\``)
+            .join('.');
+    }
+}
+/** @internal Parse REST field paths, including escaped literal segments. */
+export function parseFieldPath(path) {
+    const segments = [];
+    let segment = '';
+    let quoted = false;
+    let escaped = false;
+    for (const character of path) {
+        if (escaped) {
+            segment += character;
+            escaped = false;
+            continue;
+        }
+        if (quoted && character === '\\') {
+            escaped = true;
+            continue;
+        }
+        if (character === '`') {
+            quoted = !quoted;
+            continue;
+        }
+        if (character === '.' && !quoted) {
+            segments.push(segment);
+            segment = '';
+            continue;
+        }
+        segment += character;
+    }
+    if (quoted || escaped || !segment || segments.some((value) => !value))
+        throw new FirebaseEdgeError({
+            ...FirestoreErrorInfo.INVALID_ARGUMENT,
+            message: 'Invalid field path.'
+        });
+    segments.push(segment);
+    return segments;
+}
+//# sourceMappingURL=field-path.js.map

package/dist/db/field-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-path.js","sourceRoot":"","sources":["../../src/db/field-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,MAAM,OAAO,SAAS;IACT,QAAQ,CAAoB;IACrC,YAAY,GAAG,UAAoB;QAC/B,IACI,CAAC,UAAU,CAAC,MAAM;YAClB,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;YAEnE,MAAM,IAAI,iBAAiB,CAAC;gBACxB,GAAG,kBAAkB,CAAC,gBAAgB;gBACtC,OAAO,EAAE,2CAA2C;aACvD,CAAC,CAAC;QACP,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IACnD,CAAC;IACD,MAAM,CAAC,UAAU;QACb,OAAO,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,CAAC,KAAgB;QACpB,OAAO,CACH,KAAK,YAAY,SAAS;YAC1B,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,KAAK,CAAC,QAAQ,CAAC,MAAM;YAC9C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CACrE,CAAC;IACN,CAAC;IACD,QAAQ;QACJ,OAAO,IAAI,CAAC,QAAQ;aACf,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACb,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC;YACpC,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CACzE;aACA,IAAI,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;CACJ;AAED,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAAC,IAAY;IACvC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,MAAM,SAAS,IAAI,IAAI,EAAE,CAAC;QAC3B,IAAI,OAAO,EAAE,CAAC;YACV,OAAO,IAAI,SAAS,CAAC;YACrB,OAAO,GAAG,KAAK,CAAC;YAChB,SAAS;QACb,CAAC;QACD,IAAI,MAAM,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YAC/B,OAAO,GAAG,IAAI,CAAC;YACf,SAAS;QACb,CAAC;QACD,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YACpB,MAAM,GAAG,CAAC,MAAM,CAAC;YACjB,SAAS;QACb,CAAC;QACD,IAAI,SAAS,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,OAAO,GAAG,EAAE,CAAC;YACb,SAAS;QACb,CAAC;QACD,OAAO,IAAI,SAAS,CAAC;IACzB,CAAC;IACD,IAAI,MAAM,IAAI,OAAO,IAAI,CAAC,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC;QACjE,MAAM,IAAI,iBAAiB,CAAC;YACxB,GAAG,kBAAkB,CAAC,gBAAgB;YACtC,OAAO,EAAE,qBAAqB;SACjC,CAAC,CAAC;IACP,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvB,OAAO,QAAQ,CAAC;AACpB,CAAC"}

package/dist/db/field-value.d.ts

@@ -0,0 +1,17 @@
+import { VectorValue } from './vector-value.js';
+export type TransformKind = 'serverTimestamp' | 'delete' | 'increment' | 'minimum' | 'maximum' | 'arrayUnion' | 'arrayRemove';
+export declare class FieldValue {
+    readonly kind: TransformKind;
+    readonly operands: readonly unknown[];
+    static vector(values?: number[]): VectorValue;
+    isEqual(other: unknown): boolean;
+    private constructor();
+    static serverTimestamp(): FieldValue;
+    static delete(): FieldValue;
+    static increment(value: number): FieldValue;
+    static minimum(value: number): FieldValue;
+    static maximum(value: number): FieldValue;
+    static arrayUnion(...elements: unknown[]): FieldValue;
+    static arrayRemove(...elements: unknown[]): FieldValue;
+}
+//# sourceMappingURL=field-value.d.ts.map

package/dist/db/field-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-value.d.ts","sourceRoot":"","sources":["../../src/db/field-value.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,MAAM,aAAa,GACnB,iBAAiB,GACjB,QAAQ,GACR,WAAW,GACX,SAAS,GACT,SAAS,GACT,YAAY,GACZ,aAAa,CAAC;AACpB,qBAAa,UAAU;IAYf,QAAQ,CAAC,IAAI,EAAE,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE;IAZzC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAE,MAAM,EAAO,GAAG,WAAW;IAGjD,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAOhC,OAAO;IAIP,MAAM,CAAC,eAAe,IAAI,UAAU;IAGpC,MAAM,CAAC,MAAM,IAAI,UAAU;IAG3B,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IAQ3C,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IAQzC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IAQzC,MAAM,CAAC,UAAU,CAAC,GAAG,QAAQ,EAAE,OAAO,EAAE,GAAG,UAAU;IAGrD,MAAM,CAAC,WAAW,CAAC,GAAG,QAAQ,EAAE,OAAO,EAAE,GAAG,UAAU;CAGzD"}

package/dist/db/field-value.js

@@ -0,0 +1,57 @@
+import { FirestoreErrorInfo } from './firestore-error-codes.js';
+import { FirebaseEdgeError } from '../auth/errors.js';
+import { VectorValue } from './vector-value.js';
+import { valueEquals } from './value-equality.js';
+export class FieldValue {
+    kind;
+    operands;
+    static vector(values = []) {
+        return new VectorValue(values);
+    }
+    isEqual(other) {
+        return (other instanceof FieldValue &&
+            this.kind === other.kind &&
+            valueEquals(this.operands, other.operands));
+    }
+    constructor(kind, operands = []) {
+        this.kind = kind;
+        this.operands = operands;
+    }
+    static serverTimestamp() {
+        return new FieldValue('serverTimestamp');
+    }
+    static delete() {
+        return new FieldValue('delete');
+    }
+    static increment(value) {
+        if (typeof value !== 'number' || !Number.isFinite(value))
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Increment requires a finite number.'
+            });
+        return new FieldValue('increment', [value]);
+    }
+    static minimum(value) {
+        if (typeof value !== 'number')
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Expected a numeric transform operand.'
+            });
+        return new FieldValue('minimum', [value]);
+    }
+    static maximum(value) {
+        if (typeof value !== 'number')
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Expected a numeric transform operand.'
+            });
+        return new FieldValue('maximum', [value]);
+    }
+    static arrayUnion(...elements) {
+        return new FieldValue('arrayUnion', elements);
+    }
+    static arrayRemove(...elements) {
+        return new FieldValue('arrayRemove', elements);
+    }
+}
+//# sourceMappingURL=field-value.js.map

package/dist/db/field-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-value.js","sourceRoot":"","sources":["../../src/db/field-value.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AASlD,MAAM,OAAO,UAAU;IAYN;IACA;IAZb,MAAM,CAAC,MAAM,CAAC,SAAmB,EAAE;QAC/B,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,CAAC,KAAc;QAClB,OAAO,CACH,KAAK,YAAY,UAAU;YAC3B,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI;YACxB,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAC7C,CAAC;IACN,CAAC;IACD,YACa,IAAmB,EACnB,WAA+B,EAAE;QADjC,SAAI,GAAJ,IAAI,CAAe;QACnB,aAAQ,GAAR,QAAQ,CAAyB;IAC3C,CAAC;IACJ,MAAM,CAAC,eAAe;QAClB,OAAO,IAAI,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAC7C,CAAC;IACD,MAAM,CAAC,MAAM;QACT,OAAO,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IACD,MAAM,CAAC,SAAS,CAAC,KAAa;QAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YACpD,MAAM,IAAI,iBAAiB,CAAC;gBACxB,GAAG,kBAAkB,CAAC,gBAAgB;gBACtC,OAAO,EAAE,qCAAqC;aACjD,CAAC,CAAC;QACP,OAAO,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,MAAM,CAAC,OAAO,CAAC,KAAa;QACxB,IAAI,OAAO,KAAK,KAAK,QAAQ;YACzB,MAAM,IAAI,iBAAiB,CAAC;gBACxB,GAAG,kBAAkB,CAAC,gBAAgB;gBACtC,OAAO,EAAE,uCAAuC;aACnD,CAAC,CAAC;QACP,OAAO,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,MAAM,CAAC,OAAO,CAAC,KAAa;QACxB,IAAI,OAAO,KAAK,KAAK,QAAQ;YACzB,MAAM,IAAI,iBAAiB,CAAC;gBACxB,GAAG,kBAAkB,CAAC,gBAAgB;gBACtC,OAAO,EAAE,uCAAuC;aACnD,CAAC,CAAC;QACP,OAAO,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,MAAM,CAAC,UAAU,CAAC,GAAG,QAAmB;QACpC,OAAO,IAAI,UAAU,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,CAAC,WAAW,CAAC,GAAG,QAAmB;QACrC,OAAO,IAAI,UAAU,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;CACJ"}

package/dist/db/filter.d.ts

@@ -0,0 +1,20 @@
+import { FieldPath } from './field-path.js';
+import { type WhereFilterOp } from './query-request.js';
+import type { FirestoreValue } from './firestore-document.js';
+export type FilterNode = {
+    field: string;
+    operator: WhereFilterOp;
+    value: FirestoreValue;
+} | {
+    op: 'AND' | 'OR';
+    filters: FilterNode[];
+};
+export declare class Filter {
+    readonly node: FilterNode;
+    private constructor();
+    static where(field: string | FieldPath, operator: WhereFilterOp, value: unknown): Filter;
+    static and(...filters: Filter[]): Filter;
+    static or(...filters: Filter[]): Filter;
+    private static combine;
+}
+//# sourceMappingURL=filter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../src/db/filter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAIH,KAAK,aAAa,EACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,MAAM,UAAU,GAChB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,GACjE;IAAE,EAAE,EAAE,KAAK,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC;AAClD,qBAAa,MAAM;IACK,QAAQ,CAAC,IAAI,EAAE,UAAU;IAA7C,OAAO;IACP,MAAM,CAAC,KAAK,CACR,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,OAAO,GACf,MAAM;IAqBT,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM;IAGxC,MAAM,CAAC,EAAE,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM;IAGvC,OAAO,CAAC,MAAM,CAAC,OAAO;CAczB"}