firebase-admin-edge 1.1.1 → 2.0.0

package/dist/db/aggregate.js

@@ -0,0 +1,115 @@
+import { firestoreResult } from './firestore-results.js';
+import { FirestoreErrorInfo } from './firestore-error-codes.js';
+import { FirebaseEdgeError } from '../auth/errors.js';
+import { FieldPath } from './field-path.js';
+import { validateFieldPath } from './query-request.js';
+import { Timestamp } from './timestamp.js';
+import { valueEquals } from './value-equality.js';
+import { validateExplainOptions } from './explain.js';
+export const aggregateReadTime = Symbol('aggregateReadTime');
+export const aggregateMetrics = Symbol('aggregateMetrics');
+export class AggregateField {
+    aggregateType;
+    field;
+    type = 'AggregateField';
+    constructor(aggregateType, field) {
+        this.aggregateType = aggregateType;
+        this.field = field;
+    }
+    static count() {
+        return new AggregateField('count');
+    }
+    static sum(field) {
+        return AggregateField.forField('sum', field);
+    }
+    static average(field) {
+        return AggregateField.forField('avg', field);
+    }
+    static forField(type, field) {
+        if (!(field instanceof FieldPath))
+            validateFieldPath(field);
+        return new AggregateField(type, field.toString());
+    }
+    isEqual(other) {
+        return (other instanceof AggregateField &&
+            this.aggregateType === other.aggregateType &&
+            this.field === other.field);
+    }
+}
+export class AggregateQuery {
+    query;
+    execute;
+    async explain(options = {}) {
+        return firestoreResult(async () => {
+            return this.query.firestore._trace('AggregateQuery.explain', async () => {
+                validateExplainOptions(options);
+                const result = await this.execute(this.spec, undefined, options);
+                const metrics = result[aggregateMetrics];
+                if (!metrics) {
+                    throw new FirebaseEdgeError({
+                        ...FirestoreErrorInfo.INVALID_RESPONSE,
+                        message: 'No explain metrics returned.'
+                    });
+                }
+                return {
+                    metrics,
+                    snapshot: options.analyze
+                        ? new AggregateQuerySnapshot(this, result, result[aggregateReadTime])
+                        : null
+                };
+            });
+        });
+    }
+    isEqual(other) {
+        return (other instanceof AggregateQuery &&
+            this.query.isEqual(other.query) &&
+            valueEquals(this.spec, other.spec));
+    }
+    spec;
+    /** @internal Use query.aggregate() or query.count(). */
+    constructor(query, spec, execute) {
+        this.query = query;
+        this.execute = execute;
+        const fields = Object.values(spec ?? {});
+        if (!fields.length ||
+            fields.length > 5 ||
+            fields.some((field) => !(field instanceof AggregateField)))
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Aggregates require one to five AggregateField values.'
+            });
+        this.spec = { ...spec };
+    }
+    async get() {
+        return firestoreResult(async () => {
+            return this.query.firestore._trace('AggregateQuery.get', async () => {
+                return this._get();
+            });
+        });
+    }
+    /** @internal Transaction-bound aggregate reads. */
+    async _get(transaction) {
+        const result = await this.execute(this.spec, ...(transaction ? [transaction] : []));
+        return new AggregateQuerySnapshot(this, result, result[aggregateReadTime]);
+    }
+}
+export class AggregateQuerySnapshot {
+    query;
+    result;
+    readTime;
+    isEqual(other) {
+        return (other instanceof AggregateQuerySnapshot &&
+            this.query.isEqual(other.query) &&
+            valueEquals(this.result, other.result));
+    }
+    /** @internal Obtain from AggregateQuery.get(). */
+    constructor(query, result, readTime = Timestamp.now()) {
+        this.query = query;
+        this.result = result;
+        this.readTime = readTime;
+    }
+    data() {
+        return { ...this.result };
+    }
+}
+//# sourceMappingURL=aggregate.js.map

package/dist/db/aggregate.js.map

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

package/dist/db/bulk-writer.d.ts

@@ -0,0 +1,55 @@
+import { type FirestoreResult } from './firestore-results.js';
+import type { WithFieldValue, PartialWithFieldValue, UpdateData } from './firestore-types.js';
+import type { Firestore } from './firestore.js';
+import { DocumentReference } from './document-reference.js';
+import { FieldPath } from './field-path.js';
+import type { DocumentData } from './firestore-document.js';
+import { type WriteResult, type SetOptions, type Precondition } from './write-request.js';
+export interface BulkWriterOptions {
+    throttling?: boolean | {
+        initialOpsPerSecond?: number;
+        maxOpsPerSecond?: number;
+    };
+}
+export declare class BulkWriterError extends Error {
+    readonly code: number;
+    readonly documentRef: DocumentReference<any>;
+    readonly operationType: 'create' | 'set' | 'update' | 'delete';
+    readonly failedAttempts: number;
+    constructor(code: number, message: string, documentRef: DocumentReference<any>, operationType: 'create' | 'set' | 'update' | 'delete', failedAttempts: number);
+}
+/** Independent writes run concurrently; writes to the same document stay ordered. */
+export declare class BulkWriter {
+    readonly firestore: Firestore;
+    private readonly initialRate;
+    private readonly maximumRate;
+    private readonly startedAt;
+    private nextSlot;
+    private closed;
+    private ready;
+    private activeRequests;
+    private scheduled;
+    private pending;
+    private tails;
+    private errorHandler?;
+    private resultHandler?;
+    /** @internal Use firestore.bulkWriter(). */
+    constructor(firestore: Firestore, options?: BulkWriterOptions);
+    create<T, DbModelType extends DocumentData = DocumentData>(ref: DocumentReference<T, DbModelType>, data: WithFieldValue<T>): Promise<FirestoreResult<WriteResult>>;
+    set<T, DbModelType extends DocumentData = DocumentData>(ref: DocumentReference<T, DbModelType>, data: WithFieldValue<T>): Promise<FirestoreResult<WriteResult>>;
+    set<T, DbModelType extends DocumentData = DocumentData>(ref: DocumentReference<T, DbModelType>, data: PartialWithFieldValue<T>, options: SetOptions): Promise<FirestoreResult<WriteResult>>;
+    update<T, DbModelType extends DocumentData>(ref: DocumentReference<T, DbModelType>, data: UpdateData<DbModelType>, precondition?: Precondition): Promise<FirestoreResult<WriteResult>>;
+    update(ref: DocumentReference<any>, field: string | FieldPath, value: unknown, ...moreFieldsOrPrecondition: unknown[]): Promise<FirestoreResult<WriteResult>>;
+    delete(ref: DocumentReference<any>, precondition?: Precondition): Promise<FirestoreResult<WriteResult>>;
+    onWriteError(callback: (error: BulkWriterError) => boolean): void;
+    onWriteResult(callback: (ref: DocumentReference<any>, result: WriteResult) => void): void;
+    flush(): Promise<FirestoreResult<void>>;
+    close(): Promise<FirestoreResult<void>>;
+    private enqueue;
+    private perform;
+    private submit;
+    private drain;
+    private dispatch;
+    private throttle;
+}
+//# sourceMappingURL=bulk-writer.d.ts.map

package/dist/db/bulk-writer.d.ts.map

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

package/dist/db/bulk-writer.js

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

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

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

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

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

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

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

package/dist/db/bundle-builder.js

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

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

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

package/dist/db/bytes.d.ts

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

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

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