firebase-admin-edge 1.1.1 → 3.0.0

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"}

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"}