firebase-admin-edge 1.1.1 → 3.0.0

package/dist/db/pipeline.js

@@ -0,0 +1,396 @@
+import { firestoreResult } from './firestore-results.js';
+import { Query } from './query.js';
+import { DocumentReference } from './document-reference.js';
+import { FieldPath, parseFieldPath } from './field-path.js';
+import { decodeFields } from './firestore-document.js';
+import { VectorValue } from './vector-value.js';
+import { Timestamp } from './timestamp.js';
+import { valueEquals } from './value-equality.js';
+import { FirebaseEdgeError } from '../auth/errors.js';
+import { FirestoreErrorInfo } from './firestore-error-codes.js';
+import { Expression, Field, AliasedExpression, FunctionExpression, Ordering, field, selectionMap, encodePipelineValue } from './pipeline-expression.js';
+export * from './pipeline-expression.js';
+export class PipelineSource {
+    firestore;
+    constructor(firestore) {
+        this.firestore = firestore;
+    }
+    createFrom(query) {
+        if (!(query instanceof Query) || query.firestore !== this.firestore)
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Query must belong to this Firestore.'
+            });
+        return query._pipeline();
+    }
+    collection(collection) {
+        const ref = typeof collection === 'string'
+            ? this.firestore.collection(collection)
+            : collection;
+        if (!(ref instanceof Query) ||
+            typeof ref.path !== 'string' ||
+            ref.firestore !== this.firestore)
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Collection must belong to this Firestore.'
+            });
+        return new Pipeline(this.firestore).rawStage('collection', [
+            new Expression({ referenceValue: '/' + ref.path })
+        ]);
+    }
+    collectionGroup(collectionId) {
+        this.firestore.collectionGroup(collectionId);
+        return new Pipeline(this.firestore).rawStage('collection_group', [
+            new Expression({ referenceValue: '' }),
+            collectionId
+        ]);
+    }
+    database() {
+        return new Pipeline(this.firestore).rawStage('database', []);
+    }
+    documents(...documents) {
+        const refs = documents.map((document) => typeof document === 'string'
+            ? this.firestore.doc(document)
+            : document);
+        if (!refs.length ||
+            refs.some((ref) => !(ref instanceof DocumentReference) ||
+                ref.firestore !== this.firestore))
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Expected documents belonging to this Firestore.'
+            });
+        return new Pipeline(this.firestore).rawStage('documents', refs.map((ref) => new Expression({ referenceValue: '/' + ref.path })));
+    }
+}
+export class Pipeline {
+    firestore;
+    stages;
+    constructor(firestore, stages = []) {
+        this.firestore = firestore;
+        this.stages = structuredClone(stages);
+    }
+    rawStage(name, params, options = {}) {
+        if (typeof name !== 'string' ||
+            !name ||
+            !Array.isArray(params) ||
+            !options ||
+            typeof options !== 'object' ||
+            Array.isArray(options))
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Invalid pipeline stage.'
+            });
+        return new Pipeline(this.firestore, [
+            ...this.stages,
+            {
+                name,
+                args: params.map(encodePipelineValue),
+                options: Object.fromEntries(Object.entries(options).map(([key, value]) => [
+                    key,
+                    encodePipelineValue(value)
+                ]))
+            }
+        ]);
+    }
+    where(condition) {
+        if (!(condition instanceof Expression))
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Expected a pipeline expression.'
+            });
+        return this.rawStage('where', [condition]);
+    }
+    select(...fields) {
+        return this.rawStage('select', [selectionMap(fields)]);
+    }
+    addFields(...fields) {
+        return this.rawStage('add_fields', [selectionMap(fields)]);
+    }
+    define(...fields) {
+        return this.rawStage('let', [selectionMap(fields)]);
+    }
+    removeFields(...fields) {
+        return this.rawStage('remove_fields', fields.map((value) => typeof value === 'string' ? field(value) : value));
+    }
+    distinct(...fields) {
+        return this.rawStage('distinct', [selectionMap(fields)]);
+    }
+    aggregate(first, ...rest) {
+        const options = typeof first === 'object' &&
+            first !== null &&
+            'accumulators' in first
+            ? first
+            : { accumulators: [first, ...rest] };
+        return this.rawStage('aggregate', [
+            selectionMap(options.accumulators),
+            selectionMap(options.groups ?? [])
+        ]);
+    }
+    sort(...orderings) {
+        if (!orderings.length ||
+            orderings.some((ordering) => !(ordering instanceof Ordering)))
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Expected pipeline orderings.'
+            });
+        return this.rawStage('sort', orderings);
+    }
+    limit(count) {
+        return this.countStage('limit', count);
+    }
+    offset(count) {
+        return this.countStage('offset', count);
+    }
+    countStage(name, count) {
+        if (!Number.isSafeInteger(count) || count < 0)
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Expected a nonnegative integer.'
+            });
+        return this.rawStage(name, [count]);
+    }
+    replaceWith(map) {
+        return this.rawStage('replace_with', [map, 'full_replace']);
+    }
+    union(other) {
+        if (!(other instanceof Pipeline) || other.firestore !== this.firestore)
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Pipeline must belong to this Firestore.'
+            });
+        return this.rawStage('union', [
+            new Expression({ pipelineValue: other._request().pipeline })
+        ]);
+    }
+    unnest(selection, indexField) {
+        if (!(selection instanceof AliasedExpression))
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Unnest requires an aliased expression.'
+            });
+        return this.rawStage('unnest', [selection.expr, field(selection.alias)], indexField ? { index_field: field(indexField) } : {});
+    }
+    sample(value) {
+        const rate = typeof value === 'number'
+            ? value
+            : (value?.documents ?? value?.percentage);
+        const mode = typeof value === 'number' || value?.documents !== undefined
+            ? 'documents'
+            : 'percent';
+        if (typeof rate !== 'number' ||
+            !Number.isFinite(rate) ||
+            rate < 0 ||
+            (mode === 'percent' ? rate > 100 : !Number.isSafeInteger(rate)))
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'Invalid sample size.'
+            });
+        return this.rawStage('sample', [rate, mode]);
+    }
+    findNearest(options) {
+        const vector = Array.isArray(options.vectorValue)
+            ? new VectorValue(options.vectorValue)
+            : options.vectorValue;
+        return this.rawStage('find_nearest', [
+            typeof options.field === 'string'
+                ? field(options.field)
+                : options.field,
+            vector,
+            options.distanceMeasure
+        ], {
+            ...(options.limit !== undefined
+                ? { limit: options.limit }
+                : {}),
+            ...(options.distanceField
+                ? { distance_field: field(options.distanceField) }
+                : {})
+        });
+    }
+    search(options) {
+        const normalized = Object.fromEntries(Object.entries(options).map(([key, value]) => [
+            key.replace(/[A-Z]/g, (letter) => '_' + letter.toLowerCase()),
+            value
+        ]));
+        if (typeof options.query === 'string')
+            normalized.query = new FunctionExpression('document_matches', [
+                options.query
+            ]);
+        return this.rawStage('search', [], normalized);
+    }
+    delete() {
+        return this.rawStage('delete', []);
+    }
+    update(fields) {
+        return this.rawStage('update', [selectionMap(fields)]);
+    }
+    toArrayExpression() {
+        return new FunctionExpression('array', [
+            new Expression({ pipelineValue: this._request().pipeline })
+        ]);
+    }
+    toScalarExpression() {
+        return new FunctionExpression('scalar', [
+            new Expression({ pipelineValue: this._request().pipeline })
+        ]);
+    }
+    /** @internal Encoded state, defensively copied for endpoint use. */
+    _request(options = {}) {
+        if (!this.stages.length)
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_ARGUMENT,
+                message: 'A pipeline requires a source.'
+            });
+        return {
+            pipeline: { stages: structuredClone(this.stages) },
+            options: Object.fromEntries(Object.entries({
+                ...(options.indexMode
+                    ? { index_mode: options.indexMode }
+                    : {}),
+                ...(options.explainOptions
+                    ? {
+                        explain_options: {
+                            mode: options.explainOptions.mode,
+                            ...(options.explainOptions.outputFormat
+                                ? {
+                                    output_format: options.explainOptions
+                                        .outputFormat
+                                }
+                                : {})
+                        }
+                    }
+                    : {}),
+                ...options.rawOptions
+            }).map(([key, value]) => [key, encodePipelineValue(value)]))
+        };
+    }
+    /** @internal Classify known mutation stages for transaction guards. */
+    get _hasWrites() {
+        return this.stages.some((stage) => stage.name === 'update' || stage.name === 'delete');
+    }
+    execute(options = {}) {
+        return firestoreResult(async () => {
+            return this._execute(options);
+        });
+    }
+    /** @internal Execute in a server transaction. */
+    async _execute(options = {}, transaction) {
+        const result = await this.firestore._executePipeline(this._request(options), transaction, options.readTime);
+        return new PipelineSnapshot(this, result.results.map((document) => new PipelineResult(this.firestore, document)), Timestamp.fromString(result.executionTime), result.explainStats
+            ? new ExplainStats(result.explainStats.data)
+            : undefined);
+    }
+    stream(options = {}) {
+        const abort = new AbortController();
+        const source = this.firestore._streamPipeline(this._request(options), abort.signal, options.readTime);
+        let cancelled = false;
+        return new ReadableStream({
+            pull: async (controller) => {
+                try {
+                    const next = await source.next();
+                    if (cancelled)
+                        return;
+                    if (next.done) {
+                        controller.close();
+                        return;
+                    }
+                    controller.enqueue(new PipelineResult(this.firestore, next.value));
+                }
+                catch (error) {
+                    abort.abort();
+                    try {
+                        await source.return(undefined);
+                    }
+                    catch {
+                        /* Preserve the original failure. */
+                    }
+                    if (!cancelled)
+                        controller.error(error);
+                }
+            },
+            cancel: async () => {
+                cancelled = true;
+                abort.abort();
+                await source.return(undefined);
+            }
+        });
+    }
+}
+export class PipelineSnapshot {
+    pipeline;
+    results;
+    executionTime;
+    explainStats;
+    constructor(pipeline, results, executionTime, explainStats) {
+        this.pipeline = pipeline;
+        this.results = results;
+        this.executionTime = executionTime;
+        this.explainStats = explainStats;
+    }
+}
+export class PipelineResult {
+    firestore;
+    document;
+    ref;
+    createTime;
+    updateTime;
+    constructor(firestore, document) {
+        this.firestore = firestore;
+        this.document = structuredClone(document);
+        this.ref = document.name
+            ? firestore._reference(document.name)
+            : undefined;
+        this.createTime = document.createTime
+            ? Timestamp.fromString(document.createTime)
+            : undefined;
+        this.updateTime = document.updateTime
+            ? Timestamp.fromString(document.updateTime)
+            : undefined;
+    }
+    get id() {
+        return this.ref?.id;
+    }
+    data() {
+        return decodeFields(this.document.fields, this.firestore);
+    }
+    get(path) {
+        const segments = path instanceof FieldPath ? path.segments : parseFieldPath(path);
+        let value = this.data();
+        for (const segment of segments) {
+            if (!value ||
+                typeof value !== 'object' ||
+                !Object.prototype.hasOwnProperty.call(value, segment))
+                return undefined;
+            value = value[segment];
+        }
+        return value;
+    }
+    isEqual(other) {
+        return (other instanceof PipelineResult &&
+            this.firestore === other.firestore &&
+            this.document.name === other.document.name &&
+            valueEquals(this.document.fields, other.document.fields));
+    }
+}
+export class ExplainStats {
+    raw;
+    constructor(raw) {
+        this.raw = raw;
+    }
+    get rawMessage() {
+        return structuredClone(this.raw);
+    }
+    get text() {
+        if (!this.raw ||
+            typeof this.raw !== 'object' ||
+            typeof this.raw.value !== 'string')
+            throw new FirebaseEdgeError({
+                ...FirestoreErrorInfo.INVALID_RESPONSE,
+                message: 'Unsupported explain stats. Inspect rawMessage.'
+            });
+        return this.raw.value;
+    }
+    get json() {
+        return JSON.parse(this.text);
+    }
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/db/pipeline.js.map

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

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

@@ -0,0 +1,2 @@
+export { QueryDocumentSnapshot } from './document-snapshot.js';
+//# sourceMappingURL=query-document-snapshot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-document-snapshot.d.ts","sourceRoot":"","sources":["../../src/db/query-document-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC"}

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

@@ -0,0 +1,2 @@
+export { QueryDocumentSnapshot } from './document-snapshot.js';
+//# sourceMappingURL=query-document-snapshot.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-document-snapshot.js","sourceRoot":"","sources":["../../src/db/query-document-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/db/query-partition.d.ts

@@ -0,0 +1,14 @@
+import type { Query } from './query.js';
+import type { DocumentData } from './firestore-document.js';
+import type { DocumentReference } from './document-reference.js';
+export declare class QueryPartition<T = DocumentData, DbModelType extends DocumentData = DocumentData> {
+    private readonly query;
+    private readonly start?;
+    private readonly end?;
+    /** @internal Obtain partitions from CollectionGroup.getPartitions(). */
+    constructor(query: Query<T, DbModelType>, start?: string | undefined, end?: string | undefined);
+    get startAt(): DocumentReference[] | undefined;
+    get endBefore(): DocumentReference[] | undefined;
+    toQuery(): Query<T, DbModelType>;
+}
+//# sourceMappingURL=query-partition.d.ts.map

package/dist/db/query-partition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-partition.d.ts","sourceRoot":"","sources":["../../src/db/query-partition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,qBAAa,cAAc,CACvB,CAAC,GAAG,YAAY,EAChB,WAAW,SAAS,YAAY,GAAG,YAAY;IAI3C,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;IAJzB,wEAAwE;gBAEnD,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,EAC5B,KAAK,CAAC,EAAE,MAAM,YAAA,EACd,GAAG,CAAC,EAAE,MAAM,YAAA;IAEjC,IAAI,OAAO,IAAI,iBAAiB,EAAE,GAAG,SAAS,CAG7C;IACD,IAAI,SAAS,IAAI,iBAAiB,EAAE,GAAG,SAAS,CAG/C;IACD,OAAO,IAAI,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC;CAQnC"}

package/dist/db/query-partition.js

@@ -0,0 +1,32 @@
+export class QueryPartition {
+    query;
+    start;
+    end;
+    /** @internal Obtain partitions from CollectionGroup.getPartitions(). */
+    constructor(query, start, end) {
+        this.query = query;
+        this.start = start;
+        this.end = end;
+    }
+    get startAt() {
+        if (this.start === undefined)
+            return undefined;
+        return [this.query.firestore.doc(this.start)];
+    }
+    get endBefore() {
+        if (this.end === undefined)
+            return undefined;
+        return [this.query.firestore.doc(this.end)];
+    }
+    toQuery() {
+        let query = this.query;
+        const start = this.startAt;
+        const end = this.endBefore;
+        if (start)
+            query = query.startAt(...start);
+        if (end)
+            query = query.endBefore(...end);
+        return query;
+    }
+}
+//# sourceMappingURL=query-partition.js.map

package/dist/db/query-partition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-partition.js","sourceRoot":"","sources":["../../src/db/query-partition.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,cAAc;IAMF;IACA;IACA;IAJrB,wEAAwE;IACxE,YACqB,KAA4B,EAC5B,KAAc,EACd,GAAY;QAFZ,UAAK,GAAL,KAAK,CAAuB;QAC5B,UAAK,GAAL,KAAK,CAAS;QACd,QAAG,GAAH,GAAG,CAAS;IAC9B,CAAC;IACJ,IAAI,OAAO;QACP,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,SAAS;QACT,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,OAAO;QACH,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;QAC3B,IAAI,KAAK;YAAE,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;QAC3C,IAAI,GAAG;YAAE,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC,CAAC;QACzC,OAAO,KAAK,CAAC;IACjB,CAAC;CACJ"}

package/dist/db/query-request.d.ts

@@ -0,0 +1,96 @@
+import type { FirestoreValue } from './firestore-document.js';
+import type { FilterNode } from './filter.js';
+export declare const OPERATORS: {
+    readonly '<': "LESS_THAN";
+    readonly '<=': "LESS_THAN_OR_EQUAL";
+    readonly '==': "EQUAL";
+    readonly '!=': "NOT_EQUAL";
+    readonly '>=': "GREATER_THAN_OR_EQUAL";
+    readonly '>': "GREATER_THAN";
+    readonly 'array-contains': "ARRAY_CONTAINS";
+    readonly in: "IN";
+    readonly 'not-in': "NOT_IN";
+    readonly 'array-contains-any': "ARRAY_CONTAINS_ANY";
+};
+export type WhereFilterOp = keyof typeof OPERATORS;
+export interface QueryOptions {
+    alwaysUseImplicitOrderBy?: boolean;
+    nearest?: {
+        vectorField: {
+            fieldPath: string;
+        };
+        queryVector: FirestoreValue;
+        limit: number;
+        distanceMeasure: 'EUCLIDEAN' | 'COSINE' | 'DOT_PRODUCT';
+        distanceResultField?: string;
+        distanceThreshold?: number;
+    };
+    allDescendants?: boolean;
+    last?: boolean;
+    compositeFilters?: FilterNode[];
+    filters?: {
+        field: string;
+        operator: WhereFilterOp;
+        value: FirestoreValue;
+    }[];
+    orders?: {
+        field: string;
+        direction: 'asc' | 'desc';
+    }[];
+    limit?: number;
+    offset?: number;
+    fields?: string[];
+    start?: {
+        values: FirestoreValue[];
+        before: boolean;
+    };
+    end?: {
+        values: FirestoreValue[];
+        before: boolean;
+    };
+}
+/** String field paths support dot-separated simple identifiers. */
+export declare function validateFieldPath(field: string): void;
+export declare function encodeValue(value: unknown, ancestors?: Set<object>, ignoreUndefinedProperties?: boolean): FirestoreValue;
+/** Convert immutable query state to the Firestore REST structured query. */
+export declare function buildStructuredQuery(collectionId: string, options: QueryOptions, parentName?: string): {
+    endAt?: {
+        values: FirestoreValue[];
+        before: boolean;
+    } | undefined;
+    startAt?: {
+        values: FirestoreValue[];
+        before: boolean;
+    } | undefined;
+    select?: {
+        fields: {
+            fieldPath: string;
+        }[];
+    } | undefined;
+    offset?: number | undefined;
+    limit?: number | undefined;
+    orderBy?: {
+        field: {
+            fieldPath: string;
+        };
+        direction: string;
+    }[] | undefined;
+    where?: unknown;
+    from: {
+        allDescendants?: boolean | undefined;
+        collectionId: string;
+    }[];
+    findNearest?: {
+        vectorField: {
+            fieldPath: string;
+        };
+        queryVector: FirestoreValue;
+        limit: number;
+        distanceMeasure: "EUCLIDEAN" | "COSINE" | "DOT_PRODUCT";
+        distanceResultField?: string;
+        distanceThreshold?: number;
+    } | undefined;
+};
+/** @internal Match Firestore's implicit inequality and document-name ordering. */
+export declare function normalizedOrders(options: QueryOptions): NonNullable<QueryOptions['orders']>;
+//# sourceMappingURL=query-request.d.ts.map

package/dist/db/query-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-request.d.ts","sourceRoot":"","sources":["../../src/db/query-request.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAM9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,eAAO,MAAM,SAAS;;;;;;;;;;;CAWZ,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,SAAS,CAAC;AACnD,MAAM,WAAW,YAAY;IACzB,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,OAAO,CAAC,EAAE;QACN,WAAW,EAAE;YAAE,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;QACnC,WAAW,EAAE,cAAc,CAAC;QAC5B,KAAK,EAAE,MAAM,CAAC;QACd,eAAe,EAAE,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAC;QACxD,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gBAAgB,CAAC,EAAE,UAAU,EAAE,CAAC;IAChC,OAAO,CAAC,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,aAAa,CAAC;QACxB,KAAK,EAAE,cAAc,CAAC;KACzB,EAAE,CAAC;IACJ,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,EAAE,CAAC;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE;QAAE,MAAM,EAAE,cAAc,EAAE,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IACtD,GAAG,CAAC,EAAE;QAAE,MAAM,EAAE,cAAc,EAAE,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;CACvD;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CASrD;AAED,wBAAgB,WAAW,CACvB,KAAK,EAAE,OAAO,EACd,SAAS,cAAoB,EAC7B,yBAAyB,UAAQ,GAClC,cAAc,CA8FhB;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAChC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,YAAY,EACrB,UAAU,CAAC,EAAE,MAAM;;;gBAxHyB,OAAO;;;;gBAAP,OAAO;;;;;;;;;;;;;;;;;;;;;qBAnBlC;YAAE,SAAS,EAAE,MAAM,CAAA;SAAE;qBACrB,cAAc;eACpB,MAAM;yBACI,WAAW,GAAG,QAAQ,GAAG,aAAa;8BACjC,MAAM;4BACR,MAAM;;EAoNjC;AAuGD,kFAAkF;AAClF,wBAAgB,gBAAgB,CAC5B,OAAO,EAAE,YAAY,GACtB,WAAW,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAwBrC"}