firebase-admin-edge 1.1.0 → 2.0.0

package/dist/db/filter.js

@@ -0,0 +1,48 @@
+import { FirestoreErrorInfo } from './firestore-error-codes.js';
+import { FirebaseEdgeError } from '../auth/errors.js';
+import { FieldPath } from './field-path.js';
+import { encodeValue, OPERATORS, validateFieldPath } from './query-request.js';
+export class Filter {
+    node;
+    constructor(node) {
+        this.node = node;
+    }
+    static where(field, operator, value) {
+        const path = field instanceof FieldPath ? field.toString() : field;
+        if (!(field instanceof FieldPath))
+            validateFieldPath(path);
+        if (!Object.hasOwn(OPERATORS, operator))
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Invalid Firestore query operator.'
+            });
+        if (['in', 'not-in', 'array-contains-any'].includes(operator) &&
+            (!Array.isArray(value) ||
+                !value.length ||
+                value.length > (operator === 'not-in' ? 10 : 30)))
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Query operator requires a non-empty array within the Firestore value limit.'
+            });
+        return new Filter({ field: path, operator, value: encodeValue(value) });
+    }
+    static and(...filters) {
+        return Filter.combine('AND', filters);
+    }
+    static or(...filters) {
+        return Filter.combine('OR', filters);
+    }
+    static combine(op, filters) {
+        if (!filters.length ||
+            filters.some((filter) => !(filter instanceof Filter)))
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Composite filters require Filter instances.'
+            });
+        return new Filter({
+            op,
+            filters: filters.map((filter) => filter.node)
+        });
+    }
+}
+//# sourceMappingURL=filter.js.map

package/dist/db/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../src/db/filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EACH,WAAW,EACX,SAAS,EACT,iBAAiB,EAEpB,MAAM,oBAAoB,CAAC;AAM5B,MAAM,OAAO,MAAM;IACc;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IACjD,MAAM,CAAC,KAAK,CACR,KAAyB,EACzB,QAAuB,EACvB,KAAc;QAEd,MAAM,IAAI,GAAG,KAAK,YAAY,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QACnE,IAAI,CAAC,CAAC,KAAK,YAAY,SAAS,CAAC;YAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC3D,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC;YACnC,MAAM,IAAI,iBAAiB,CAAC;gBACxB,GAAG,kBAAkB,CAAC,gBAAgB;gBACtC,OAAO,EAAE,mCAAmC;aAC/C,CAAC,CAAC;QACP,IACI,CAAC,IAAI,EAAE,QAAQ,EAAE,oBAAoB,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACzD,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBAClB,CAAC,KAAK,CAAC,MAAM;gBACb,KAAK,CAAC,MAAM,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAErD,MAAM,IAAI,iBAAiB,CAAC;gBACxB,GAAG,kBAAkB,CAAC,gBAAgB;gBACtC,OAAO,EACH,6EAA6E;aACpF,CAAC,CAAC;QACP,OAAO,IAAI,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,MAAM,CAAC,GAAG,CAAC,GAAG,OAAiB;QAC3B,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IACD,MAAM,CAAC,EAAE,CAAC,GAAG,OAAiB;QAC1B,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IACO,MAAM,CAAC,OAAO,CAAC,EAAgB,EAAE,OAAiB;QACtD,IACI,CAAC,OAAO,CAAC,MAAM;YACf,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,YAAY,MAAM,CAAC,CAAC;YAErD,MAAM,IAAI,iBAAiB,CAAC;gBACxB,GAAG,kBAAkB,CAAC,gBAAgB;gBACtC,OAAO,EAAE,6CAA6C;aACzD,CAAC,CAAC;QACP,OAAO,IAAI,MAAM,CAAC;YACd,EAAE;YACF,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;SAChD,CAAC,CAAC;IACP,CAAC;CACJ"}

package/dist/db/firestore-converter.d.ts

@@ -0,0 +1,11 @@
+import type { WithFieldValue, PartialWithFieldValue } from './firestore-types.js';
+import type { DocumentData } from './firestore-document.js';
+import type { QueryDocumentSnapshot } from './query-document-snapshot.js';
+import type { SetOptions } from './write-request.js';
+export interface FirestoreDataConverter<T, DbModelType extends DocumentData = DocumentData> {
+    toFirestore(model: WithFieldValue<T>): WithFieldValue<DbModelType>;
+    toFirestore(model: PartialWithFieldValue<T>, options: SetOptions): PartialWithFieldValue<DbModelType>;
+    fromFirestore(snapshot: QueryDocumentSnapshot): T;
+}
+export declare function validateConverter<T, DbModelType extends DocumentData>(converter: FirestoreDataConverter<T, DbModelType> | null): void;
+//# sourceMappingURL=firestore-converter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"firestore-converter.d.ts","sourceRoot":"","sources":["../../src/db/firestore-converter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,cAAc,EACd,qBAAqB,EACxB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,sBAAsB,CACnC,CAAC,EACD,WAAW,SAAS,YAAY,GAAG,YAAY;IAE/C,WAAW,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IACnE,WAAW,CACP,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAC/B,OAAO,EAAE,UAAU,GACpB,qBAAqB,CAAC,WAAW,CAAC,CAAC;IACtC,aAAa,CAAC,QAAQ,EAAE,qBAAqB,GAAG,CAAC,CAAC;CACrD;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,WAAW,SAAS,YAAY,EACjE,SAAS,EAAE,sBAAsB,CAAC,CAAC,EAAE,WAAW,CAAC,GAAG,IAAI,GACzD,IAAI,CAYN"}

package/dist/db/firestore-converter.js

@@ -0,0 +1,14 @@
+import { FirestoreErrorInfo } from './firestore-error-codes.js';
+import { FirebaseEdgeError } from '../auth/errors.js';
+export function validateConverter(converter) {
+    if (converter === null)
+        return;
+    if (!converter ||
+        typeof converter.toFirestore !== 'function' ||
+        typeof converter.fromFirestore !== 'function')
+        throw new FirebaseEdgeError({
+            ...FirestoreErrorInfo.INVALID_ARGUMENT,
+            message: 'A converter requires toFirestore and fromFirestore methods.'
+        });
+}
+//# sourceMappingURL=firestore-converter.js.map

package/dist/db/firestore-converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firestore-converter.js","sourceRoot":"","sources":["../../src/db/firestore-converter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAiBtD,MAAM,UAAU,iBAAiB,CAC7B,SAAwD;IAExD,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO;IAC/B,IACI,CAAC,SAAS;QACV,OAAO,SAAS,CAAC,WAAW,KAAK,UAAU;QAC3C,OAAO,SAAS,CAAC,aAAa,KAAK,UAAU;QAE7C,MAAM,IAAI,iBAAiB,CAAC;YACxB,GAAG,kBAAkB,CAAC,gBAAgB;YACtC,OAAO,EACH,6DAA6D;SACpE,CAAC,CAAC;AACX,CAAC"}

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

@@ -0,0 +1,62 @@
+import { Timestamp } from './timestamp.js';
+import type { Firestore } from './firestore.js';
+export type DocumentData = Record<string, unknown>;
+export type FirestoreValue = {
+    nullValue: null;
+} | {
+    booleanValue: boolean;
+} | {
+    integerValue: string;
+} | {
+    doubleValue: number | string;
+} | {
+    timestampValue: string;
+} | {
+    stringValue: string;
+} | {
+    bytesValue: string;
+} | {
+    referenceValue: string;
+} | {
+    geoPointValue: {
+        latitude: number;
+        longitude: number;
+    };
+} | {
+    arrayValue: {
+        values?: FirestoreValue[];
+    };
+} | {
+    mapValue: {
+        fields?: Record<string, FirestoreValue>;
+    };
+};
+export interface FirestoreDocument {
+    name: string;
+    fields?: Record<string, FirestoreValue>;
+    createTime?: string;
+    updateTime?: string;
+    readTime?: string;
+    /** @internal A missing document returned by batchGet, with server read time. */
+    missing?: boolean;
+}
+export type SnapshotTimestamp = string | {
+    seconds?: number | string | {
+        toString(): string;
+    } | null;
+    nanos?: number | null;
+};
+export interface SnapshotDocument {
+    name?: string | null;
+    fields?: Record<string, unknown> | null;
+    createTime?: SnapshotTimestamp | null;
+    updateTime?: SnapshotTimestamp | null;
+}
+/** @internal Normalize raw snapshot metadata without losing nanoseconds. */
+export declare function normalizeSnapshotTimestamp(value: unknown, encoding: 'json' | 'protobufJS'): Timestamp;
+/** @internal Capture JSON/protobuf documents in the existing REST representation. */
+export declare function normalizeSnapshotDocument(document: SnapshotDocument, encoding: 'json' | 'protobufJS'): FirestoreDocument;
+/** Decode REST fields without invoking setters for user-controlled field names. */
+export declare function decodeFields(fields?: Record<string, FirestoreValue>, firestore?: Firestore): DocumentData;
+export declare function decodeValue(value: FirestoreValue, firestore?: Firestore): unknown;
+//# sourceMappingURL=firestore-document.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"firestore-document.d.ts","sourceRoot":"","sources":["../../src/db/firestore-document.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAI3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnD,MAAM,MAAM,cAAc,GACpB;IAAE,SAAS,EAAE,IAAI,CAAA;CAAE,GACnB;IAAE,YAAY,EAAE,OAAO,CAAA;CAAE,GACzB;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,GACxB;IAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAChC;IAAE,cAAc,EAAE,MAAM,CAAA;CAAE,GAC1B;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GACvB;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GACtB;IAAE,cAAc,EAAE,MAAM,CAAA;CAAE,GAC1B;IAAE,aAAa,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC1D;IAAE,UAAU,EAAE;QAAE,MAAM,CAAC,EAAE,cAAc,EAAE,CAAA;KAAE,CAAA;CAAE,GAC7C;IAAE,QAAQ,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;KAAE,CAAA;CAAE,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,iBAAiB,GACvB,MAAM,GACN;IACI,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG;QAAE,QAAQ,IAAI,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1D,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AACR,MAAM,WAAW,gBAAgB;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACtC,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACzC;AAED,4EAA4E;AAC5E,wBAAgB,0BAA0B,CACtC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,GAAG,YAAY,GAChC,SAAS,CAWX;AAED,qFAAqF;AACrF,wBAAgB,yBAAyB,CACrC,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,MAAM,GAAG,YAAY,GAChC,iBAAiB,CA2BnB;AA4LD,mFAAmF;AACnF,wBAAgB,YAAY,CACxB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAM,EAC3C,SAAS,CAAC,EAAE,SAAS,GACtB,YAAY,CAOd;AAED,wBAAgB,WAAW,CACvB,KAAK,EAAE,cAAc,EACrB,SAAS,CAAC,EAAE,SAAS,GACtB,OAAO,CAuDT"}

package/dist/db/firestore-document.js

@@ -0,0 +1,238 @@
+import { FirestoreErrorInfo } from './firestore-error-codes.js';
+import { FirebaseEdgeError } from '../auth/errors.js';
+import { Timestamp } from './timestamp.js';
+import { GeoPoint } from './geo-point.js';
+import { Bytes } from './bytes.js';
+import { VectorValue } from './vector-value.js';
+/** @internal Normalize raw snapshot metadata without losing nanoseconds. */
+export function normalizeSnapshotTimestamp(value, encoding) {
+    if (typeof value === 'string' && encoding === 'json')
+        return Timestamp.fromString(value);
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new FirebaseEdgeError({
+            ...FirestoreErrorInfo.INVALID_ARGUMENT,
+            message: 'Invalid snapshot timestamp.'
+        });
+    const proto = value;
+    const seconds = snapshotInteger(proto.seconds ?? 0);
+    return new Timestamp(Number(seconds), (proto.nanos ?? 0));
+}
+/** @internal Capture JSON/protobuf documents in the existing REST representation. */
+export function normalizeSnapshotDocument(document, encoding) {
+    if (!document ||
+        typeof document !== 'object' ||
+        Array.isArray(document) ||
+        typeof document.name !== 'string')
+        throw new FirebaseEdgeError({
+            ...FirestoreErrorInfo.INVALID_ARGUMENT,
+            message: 'Expected a snapshot document with a resource name.'
+        });
+    return {
+        name: document.name,
+        fields: normalizeSnapshotFields(document.fields ?? {}, encoding, new Set()),
+        createTime: normalizeSnapshotTimestamp(document.createTime, encoding).toString(),
+        updateTime: normalizeSnapshotTimestamp(document.updateTime, encoding).toString()
+    };
+}
+function snapshotInteger(value) {
+    if ((typeof value !== 'number' &&
+        typeof value !== 'string' &&
+        (!value || typeof value !== 'object')) ||
+        (typeof value === 'number' && !Number.isSafeInteger(value)))
+        throw new FirebaseEdgeError({
+            ...FirestoreErrorInfo.INVALID_ARGUMENT,
+            message: 'Invalid snapshot integer; use text for integers beyond safe number precision.'
+        });
+    const text = String(value);
+    if (!/^-?\d+$/.test(text) ||
+        BigInt(text) < -(1n << 63n) ||
+        BigInt(text) >= 1n << 63n)
+        throw new FirebaseEdgeError({
+            ...FirestoreErrorInfo.INVALID_ARGUMENT,
+            message: 'Snapshot integer is outside the signed 64-bit range.'
+        });
+    return text;
+}
+function normalizeSnapshotFields(fields, encoding, ancestors) {
+    if (!fields ||
+        typeof fields !== 'object' ||
+        Array.isArray(fields) ||
+        ancestors.has(fields))
+        throw new FirebaseEdgeError({
+            ...FirestoreErrorInfo.INVALID_ARGUMENT,
+            message: 'Invalid or circular snapshot fields.'
+        });
+    const next = new Set(ancestors).add(fields);
+    return Object.fromEntries(Object.entries(fields).map(([key, value]) => [
+        key,
+        normalizeSnapshotValue(value, encoding, next)
+    ]));
+}
+function normalizeSnapshotValue(input, encoding, ancestors) {
+    if (!input ||
+        typeof input !== 'object' ||
+        Array.isArray(input) ||
+        ancestors.has(input))
+        throw new FirebaseEdgeError({
+            ...FirestoreErrorInfo.INVALID_ARGUMENT,
+            message: 'Invalid or circular snapshot value.'
+        });
+    const value = input;
+    const keys = [
+        'nullValue',
+        'booleanValue',
+        'integerValue',
+        'doubleValue',
+        'timestampValue',
+        'stringValue',
+        'bytesValue',
+        'referenceValue',
+        'geoPointValue',
+        'arrayValue',
+        'mapValue'
+    ].filter((key) => Object.hasOwn(value, key) &&
+        (key === 'nullValue' || value[key] != null));
+    if (keys.length !== 1 ||
+        (value.valueType !== undefined && value.valueType !== keys[0]))
+        throw new FirebaseEdgeError({
+            ...FirestoreErrorInfo.INVALID_ARGUMENT,
+            message: 'Expected exactly one Firestore value type.'
+        });
+    const key = keys[0];
+    const raw = value[key];
+    const next = new Set(ancestors).add(input);
+    if (key === 'integerValue')
+        return { integerValue: snapshotInteger(raw) };
+    if (key === 'timestampValue')
+        return {
+            timestampValue: normalizeSnapshotTimestamp(raw, encoding).toString()
+        };
+    if (key === 'bytesValue') {
+        const bytes = raw instanceof Uint8Array
+            ? Bytes.fromUint8Array(raw)
+            : Bytes.fromBase64String(raw);
+        return { bytesValue: bytes.toBase64() };
+    }
+    if (key === 'arrayValue' || key === 'mapValue') {
+        if (!raw ||
+            typeof raw !== 'object' ||
+            Array.isArray(raw) ||
+            next.has(raw))
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Invalid snapshot container.'
+            });
+        next.add(raw);
+        if (key === 'mapValue')
+            return {
+                mapValue: {
+                    fields: normalizeSnapshotFields(raw.fields ?? {}, encoding, next)
+                }
+            };
+        const values = raw.values ?? [];
+        if (!Array.isArray(values))
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Expected snapshot array values.'
+            });
+        return {
+            arrayValue: {
+                values: values.map((item) => normalizeSnapshotValue(item, encoding, next))
+            }
+        };
+    }
+    if (key === 'geoPointValue') {
+        if (!raw || typeof raw !== 'object')
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Invalid snapshot geopoint.'
+            });
+        const point = raw;
+        const validated = new GeoPoint(point.latitude ?? 0, point.longitude ?? 0);
+        return {
+            geoPointValue: {
+                latitude: validated.latitude,
+                longitude: validated.longitude
+            }
+        };
+    }
+    if (key === 'nullValue' &&
+        (raw === null || raw === 0 || raw === 'NULL_VALUE'))
+        return { nullValue: null };
+    if (key === 'booleanValue' && typeof raw === 'boolean')
+        return { booleanValue: raw };
+    if (key === 'stringValue' && typeof raw === 'string')
+        return { stringValue: raw };
+    if (key === 'referenceValue' &&
+        typeof raw === 'string' &&
+        /^projects\/[^/]+\/databases\/[^/]+\/documents\/.+/.test(raw))
+        return { referenceValue: raw };
+    if (key === 'doubleValue' &&
+        (typeof raw === 'number' ||
+            ['NaN', 'Infinity', '-Infinity'].includes(raw)))
+        return { doubleValue: raw };
+    throw new FirebaseEdgeError({
+        ...FirestoreErrorInfo.INVALID_ARGUMENT,
+        message: 'Invalid snapshot field value.'
+    });
+}
+/** Decode REST fields without invoking setters for user-controlled field names. */
+export function decodeFields(fields = {}, firestore) {
+    return Object.fromEntries(Object.entries(fields).map(([key, value]) => [
+        key,
+        decodeValue(value, firestore)
+    ]));
+}
+export function decodeValue(value, firestore) {
+    if ('nullValue' in value)
+        return null;
+    if ('booleanValue' in value)
+        return value.booleanValue;
+    if ('integerValue' in value)
+        return firestore?._useBigInt
+            ? BigInt(value.integerValue)
+            : Number(value.integerValue);
+    if ('doubleValue' in value)
+        return Number(value.doubleValue);
+    if ('timestampValue' in value)
+        return Timestamp.fromString(value.timestampValue);
+    if ('stringValue' in value)
+        return value.stringValue;
+    if ('bytesValue' in value)
+        return Bytes.fromBase64String(value.bytesValue);
+    if ('referenceValue' in value)
+        return firestore
+            ? firestore._reference(value.referenceValue)
+            : value.referenceValue;
+    if ('geoPointValue' in value)
+        return new GeoPoint(value.geoPointValue.latitude, value.geoPointValue.longitude);
+    if ('arrayValue' in value)
+        return (value.arrayValue.values ?? []).map((item) => decodeValue(item, firestore));
+    if ('mapValue' in value) {
+        const fields = value.mapValue.fields;
+        if (fields?.__type__ &&
+            'stringValue' in fields.__type__ &&
+            fields.__type__.stringValue === '__vector__') {
+            const vector = fields.value;
+            if (!vector || !('arrayValue' in vector))
+                throw new FirebaseEdgeError({
+                    ...FirestoreErrorInfo.INVALID_RESPONSE,
+                    message: 'Invalid vector value.'
+                });
+            return new VectorValue((vector.arrayValue.values ?? []).map((item) => {
+                if (!('doubleValue' in item) && !('integerValue' in item))
+                    throw new FirebaseEdgeError({
+                        ...FirestoreErrorInfo.INVALID_RESPONSE,
+                        message: 'Invalid vector component.'
+                    });
+                return Number(decodeValue(item));
+            }));
+        }
+        return decodeFields(fields, firestore);
+    }
+    throw new FirebaseEdgeError({
+        ...FirestoreErrorInfo.INVALID_RESPONSE,
+        message: 'Unsupported Firestore value.'
+    });
+}
+//# sourceMappingURL=firestore-document.js.map

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

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

package/dist/db/firestore-endpoints.d.ts

@@ -0,0 +1,41 @@
+import type { FirestoreOpenTelemetryOptions } from './firestore-settings.js';
+import { FirebaseEdgeError } from '../auth/errors.js';
+import type { FirestoreDocument } from './firestore-document.js';
+import { type QueryOptions } from './query-request.js';
+import { type WriteOperation, WriteResult } from './write-request.js';
+import type { AggregateSpec, AggregateData } from './aggregate.js';
+import { Timestamp } from './timestamp.js';
+import { type ExplainOptions, type ExplainMetrics } from './explain.js';
+export declare function batchGetDocuments(projectId: string, databaseId: string, paths: string[], token: string, fetchFn?: typeof globalThis.fetch, fieldMask?: string[], transaction?: string): Promise<(FirestoreDocument | undefined)[]>;
+export declare function listCollectionIds(projectId: string, databaseId: string, parent: string, token: string, fetchFn?: typeof globalThis.fetch): Promise<string[]>;
+export declare function listDocumentPaths(projectId: string, databaseId: string, path: string, token: string, fetchFn?: typeof globalThis.fetch): Promise<string[]>;
+export declare function streamQuery(projectId: string, databaseId: string, collectionPath: string, options: QueryOptions, token: string, fetchFn?: typeof globalThis.fetch, signal?: AbortSignal): AsyncGenerator<FirestoreDocument>;
+export interface QueryRow {
+    document?: FirestoreDocument;
+    metrics?: ExplainMetrics;
+    readTime?: string;
+}
+/** @internal Streaming transport shared by ordinary queries and query explain. */
+export declare function streamQueryRows(projectId: string, databaseId: string, collectionPath: string, options: QueryOptions, token: string, fetchFn?: typeof globalThis.fetch, signal?: AbortSignal, explainOptions?: ExplainOptions): AsyncGenerator<QueryRow>;
+export declare function createDocumentName(projectId: string, databaseId: string, path: string): string;
+/** @internal Independent REST writes, with one result or error per operation. */
+export declare function batchWrite(projectId: string, databaseId: string, operations: WriteOperation[], token: string, fetchFn?: typeof globalThis.fetch): Promise<(WriteResult | FirebaseEdgeError)[]>;
+export declare function commitWrites(projectId: string, databaseId: string, operations: WriteOperation[], token: string, fetchFn?: typeof globalThis.fetch, transaction?: string): Promise<WriteResult[]>;
+export declare function beginTransaction(projectId: string, databaseId: string, token: string, fetchFn?: typeof globalThis.fetch, options?: {
+    readOnly: true;
+    readTime?: Timestamp;
+}): Promise<string>;
+export declare function rollbackTransaction(projectId: string, databaseId: string, transaction: string, token: string, fetchFn?: typeof globalThis.fetch): Promise<void>;
+export declare function runAggregate(projectId: string, databaseId: string, collectionPath: string, options: QueryOptions, spec: AggregateSpec, token: string, fetchFn?: typeof globalThis.fetch, transaction?: string, explainOptions?: ExplainOptions): Promise<AggregateData>;
+/** @internal Fetch and sort all split points; REST pages are not globally ordered. */
+export declare function partitionQuery(projectId: string, databaseId: string, collectionId: string, count: number, token: string, fetchFn?: typeof globalThis.fetch): Promise<string[]>;
+/** @internal Configure the REST destination. */
+export declare function configureFirestoreFetch(fetchFn: typeof globalThis.fetch, host: string, ssl?: boolean, port?: number, telemetry?: FirestoreOpenTelemetryOptions): typeof globalThis.fetch;
+export declare function runQuery(projectId: string, databaseId: string, collectionPath: string, options: QueryOptions, token: string, fetchFn?: typeof globalThis.fetch, transaction?: string): Promise<FirestoreDocument[]>;
+/** Read via batchGet so found and missing documents both retain server read times. */
+export declare function getDocument(projectId: string, databaseId: string, path: string, token: string, fetchFn?: typeof globalThis.fetch, transaction?: string): Promise<FirestoreDocument | undefined>;
+/** Execute REST pipeline stages, preserving errors from streamed response rows. */
+export declare function executePipeline(projectId: string, databaseId: string, structuredPipeline: object, token: string, fetchFn?: typeof globalThis.fetch, transaction?: string, readTime?: Timestamp): Promise<import('./pipeline.js').PipelineResponse>;
+/** @internal Stream pipeline document batches with fetch cancellation and bounded buffering. */
+export declare function streamPipeline(projectId: string, databaseId: string, structuredPipeline: object, token: string, fetchFn?: typeof globalThis.fetch, signal?: AbortSignal, readTime?: Timestamp): AsyncGenerator<Partial<FirestoreDocument>>;
+//# sourceMappingURL=firestore-endpoints.d.ts.map

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

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