firebase-admin-edge 1.1.0 → 2.0.0

package/dist/storage/storage-bucket.js

@@ -0,0 +1,544 @@
+import { FirebaseEdgeError } from '../auth/errors.js';
+import { File } from './storage-file.js';
+import { Acl } from './storage-acl.js';
+import { Iam } from './storage-iam.js';
+import { Notification } from './storage-notification.js';
+import { Channel } from './storage-channel.js';
+import { storageResult, storageData, storageUnsupported } from './storage-results.js';
+import { storagePreconditions, storageGeneration, storageLoggingPolicy } from './storage-reference-helpers.js';
+/** A bucket reference; object operations are accessed through file(name). */
+export class Bucket {
+    storage;
+    name;
+    engine;
+    options;
+    metadata;
+    acl;
+    iam;
+    constructor(storage, name, engine, options = {}) {
+        this.storage = storage;
+        this.name = name;
+        this.engine = engine;
+        this.options = options;
+        this.acl = Object.assign(new Acl(() => this.engine, { scope: 'bucket' }), { default: new Acl(() => this.engine, { scope: 'defaultObject' }) });
+        this.iam = new Iam(() => this.engine);
+    }
+    get cloudStorageURI() {
+        return new URL(`gs://${this.name}`);
+    }
+    getId() {
+        return this.name;
+    }
+    file(name, options = {}) {
+        return new File(this, name, {
+            crc32cGenerator: this.options.crc32cGenerator,
+            kmsKeyName: this.options.kmsKeyName,
+            preconditionOpts: this.options.preconditionOpts,
+            ...options
+        });
+    }
+    notification(id) {
+        return new Notification(this, id, this.engine);
+    }
+    getMetadata(options = {}) {
+        return storageResult(async () => {
+            const result = await this.engine.getBucketMetadata({
+                ...storagePreconditions(this.options.preconditionOpts),
+                ...storagePreconditions(options),
+                ...(this.options.generation !== undefined && {
+                    generation: storageGeneration(this.options.generation)
+                }),
+                ...(this.options.softDeleted !== undefined && {
+                    softDeleted: this.options.softDeleted
+                })
+            });
+            this.metadata = storageData(result);
+            return this.metadata;
+        });
+    }
+    get(options = {}) {
+        return storageResult(async () => {
+            const { error } = await this.getMetadata({
+                ...(options.userProject !== undefined && {
+                    userProject: options.userProject
+                })
+            });
+            if (error?.code === 'storage/bucket-not-found' &&
+                options.autoCreate) {
+                const { autoCreate, userProject, ...createOptions } = options;
+                const result = await this.create({
+                    ...createOptions,
+                    location: options.location ?? 'US'
+                });
+                return storageData(result);
+            }
+            if (error) {
+                throw error;
+            }
+            return this;
+        });
+    }
+    async exists(options = {}) {
+        const { error } = await this.getMetadata(options);
+        if (error?.code === 'storage/bucket-not-found') {
+            return { error: null, data: false };
+        }
+        if (error) {
+            return { error, data: null };
+        }
+        return { error: null, data: true };
+    }
+    create(options = { location: 'US' }) {
+        return storageResult(async () => {
+            const result = await this.engine.createBucket(options);
+            this.metadata = storageData(result);
+            return this;
+        });
+    }
+    setMetadata(metadata, options = {}) {
+        return storageResult(async () => {
+            const result = await this.engine.updateBucketMetadata(metadata, storagePreconditions(options));
+            this.metadata = storageData(result);
+            return this.metadata;
+        });
+    }
+    delete(options = {}) {
+        return storageResult(async () => {
+            const result = await this.engine.deleteBucket(storagePreconditions(options));
+            const { error } = result;
+            if (options.ignoreNotFound &&
+                error?.code === 'storage/bucket-not-found') {
+                return;
+            }
+            return storageData(result);
+        });
+    }
+    getFiles(options = {}) {
+        return storageResult(async () => {
+            const { autoPaginate = true, maxApiCalls = Infinity, ...query } = options;
+            if (typeof autoPaginate !== 'boolean' ||
+                !(maxApiCalls === Infinity ||
+                    (Number.isInteger(maxApiCalls) && maxApiCalls > 0))) {
+                throw new FirebaseEdgeError({
+                    code: 'storage/invalid-argument',
+                    message: 'Invalid pagination options.'
+                });
+            }
+            const files = [];
+            const prefixes = new Set();
+            let pageToken = query.pageToken;
+            const seen = new Set();
+            let calls = 0;
+            do {
+                if (pageToken && seen.has(pageToken)) {
+                    throw new FirebaseEdgeError({
+                        code: 'storage/internal-error',
+                        message: 'Storage returned a repeated page token.'
+                    });
+                }
+                if (pageToken) {
+                    seen.add(pageToken);
+                }
+                const result = await this.engine.listFiles({
+                    ...query,
+                    pageToken
+                });
+                const page = storageData(result);
+                for (const prefix of page.prefixes ?? []) {
+                    prefixes.add(prefix);
+                }
+                for (const metadata of page.files) {
+                    const file = this.file(metadata.name, query.versions || query.softDeleted
+                        ? {
+                            generation: metadata.generation,
+                            restoreToken: metadata.restoreToken
+                        }
+                        : {});
+                    file.metadata = metadata;
+                    files.push(file);
+                }
+                pageToken = page.nextPageToken;
+                calls++;
+            } while (pageToken && autoPaginate && calls < maxApiCalls);
+            return {
+                files,
+                prefixes: [...prefixes],
+                ...(pageToken && { nextQuery: { ...options, pageToken } })
+            };
+        });
+    }
+    getFilesStream(options = {}) {
+        let query = {
+            ...options,
+            autoPaginate: false
+        };
+        let pending = [];
+        const bucket = this;
+        const seen = new Set();
+        let calls = 0;
+        let cancelled = false;
+        return new ReadableStream({
+            async pull(controller) {
+                try {
+                    while (!pending.length && query) {
+                        if (query.pageToken && seen.has(query.pageToken)) {
+                            throw new FirebaseEdgeError({
+                                code: 'storage/internal-error',
+                                message: 'Repeated file page token.'
+                            });
+                        }
+                        if (query.pageToken) {
+                            seen.add(query.pageToken);
+                        }
+                        const result = await bucket.getFiles(query);
+                        if (cancelled) {
+                            return;
+                        }
+                        const { files, nextQuery } = storageData(result);
+                        pending = files;
+                        calls++;
+                        query =
+                            calls < (options.maxApiCalls ?? Infinity)
+                                ? nextQuery
+                                : undefined;
+                    }
+                    if (!pending.length) {
+                        controller.close();
+                        return;
+                    }
+                    controller.enqueue(pending.shift());
+                }
+                catch (cause) {
+                    if (cancelled) {
+                        return;
+                    }
+                    controller.error(cause);
+                }
+            },
+            cancel() {
+                cancelled = true;
+                query = undefined;
+                pending = [];
+            }
+        }, { highWaterMark: 0 });
+    }
+    upload(input, options = {}) {
+        return storageResult(async () => {
+            if (typeof input === 'string') {
+                storageUnsupported('Uploading from a filesystem path; use file.save(text) for strings');
+            }
+            const destination = options.destination ??
+                (typeof globalThis.File !== 'undefined' &&
+                    input instanceof globalThis.File
+                    ? input.name
+                    : undefined);
+            if (!destination) {
+                throw new FirebaseEdgeError({
+                    code: 'storage/invalid-argument',
+                    message: 'A destination is required for byte/stream uploads.'
+                });
+            }
+            const file = destination instanceof File
+                ? destination
+                : this.file(destination, {
+                    encryptionKey: options.encryptionKey,
+                    kmsKeyName: options.kmsKeyName
+                });
+            if (destination instanceof File &&
+                options.encryptionKey !== undefined) {
+                file.setEncryptionKey(options.encryptionKey);
+            }
+            const result = await file.save(input, options);
+            storageData(result);
+            return file;
+        });
+    }
+    deleteFiles(options = {}) {
+        return storageResult(async () => {
+            const { force = false, concurrency, ifGenerationMatch, ifGenerationNotMatch, ifMetagenerationMatch, ifMetagenerationNotMatch, ...query } = options;
+            const preconditions = storagePreconditions(options);
+            const result = await this.getFiles(query);
+            const { files } = storageData(result);
+            const deleted = await this.engine.deleteFiles(files.map((file) => ({
+                ...preconditions,
+                name: file.name,
+                generation: file.generation
+            })), { concurrency, ignoreNotFound: force });
+            const data = storageData(deleted);
+            const failures = data.results.flatMap(({ error }) => error ? [error] : []);
+            if (failures.length) {
+                throw new FirebaseEdgeError({
+                    code: 'storage/batch-incomplete',
+                    message: 'Some objects could not be deleted.'
+                }, { context: { failures: failures.length } });
+            }
+        });
+    }
+    combine(sources, destination, options = {}) {
+        return storageResult(async () => {
+            const target = destination instanceof File
+                ? destination
+                : this.file(destination);
+            if (target.bucket.name !== this.name ||
+                sources.some((source) => source instanceof File &&
+                    source.bucket.name !== this.name)) {
+                throw new FirebaseEdgeError({
+                    code: 'storage/invalid-argument',
+                    message: 'Composition requires one bucket.'
+                });
+            }
+            const result = await this.engine.compose(target.name, sources.map((source) => typeof source === 'string'
+                ? { name: source }
+                : { name: source.name, generation: source.generation }), {
+                ...options,
+                ...storagePreconditions(options)
+            });
+            target.metadata = storageData(result);
+            return target;
+        });
+    }
+    getLabels(options = {}) {
+        return storageResult(async () => {
+            const result = await this.getMetadata(options);
+            return storageData(result).labels ?? {};
+        });
+    }
+    setLabels(labels, options = {}) {
+        return this.setMetadata({ labels }, options);
+    }
+    deleteLabels(labels, options = {}) {
+        return storageResult(async () => {
+            const result = await this.getMetadata(options);
+            const metadata = storageData(result);
+            const keys = labels === undefined
+                ? Object.keys(metadata.labels ?? {})
+                : typeof labels === 'string'
+                    ? [labels]
+                    : labels;
+            const updated = await this.setLabels(Object.fromEntries(keys.map((key) => [key, null])), { ifMetagenerationMatch: metadata.metageneration, ...options });
+            return storageData(updated);
+        });
+    }
+    setCorsConfiguration(cors, options = {}) {
+        return this.setMetadata({ cors }, options);
+    }
+    setStorageClass(storageClass, options = {}) {
+        return this.setMetadata({ storageClass }, options);
+    }
+    setRetentionPeriod(seconds, options = {}) {
+        return storageResult(async () => {
+            const result = await this.setMetadata({
+                retentionPolicy: {
+                    retentionPeriod: storageGeneration(seconds)
+                }
+            }, options);
+            return storageData(result);
+        });
+    }
+    removeRetentionPeriod(options = {}) {
+        return this.setMetadata({ retentionPolicy: null }, options);
+    }
+    lock(metageneration) {
+        return storageResult(async () => {
+            const result = await this.engine.lockRetentionPolicy(storageGeneration(metageneration));
+            return storageData(result);
+        });
+    }
+    enableRequesterPays(options = {}) {
+        return this.setMetadata({ billing: { requesterPays: true } }, options);
+    }
+    disableRequesterPays(options = {}) {
+        return this.setMetadata({ billing: { requesterPays: false } }, options);
+    }
+    enableLogging(options) {
+        return storageResult(async () => {
+            if (!options || typeof options.prefix !== 'string') {
+                throw new FirebaseEdgeError({
+                    code: 'storage/invalid-argument',
+                    message: 'Logging requires an object-name prefix.'
+                });
+            }
+            const destination = options.bucket === undefined
+                ? this
+                : typeof options.bucket === 'string'
+                    ? this.storage.bucket(options.bucket)
+                    : options.bucket;
+            for (let attempt = 0; attempt < 3; attempt++) {
+                const current = await destination.iam.getPolicy();
+                const policy = storageLoggingPolicy(storageData(current));
+                if (!policy) {
+                    break;
+                }
+                const { error } = await destination.iam.setPolicy(policy);
+                if (!error) {
+                    break;
+                }
+                if (attempt === 2 ||
+                    ![
+                        'storage/conflict',
+                        'storage/precondition-failed'
+                    ].includes(error.code ?? '')) {
+                    throw error;
+                }
+            }
+            const result = await this.setMetadata({
+                logging: {
+                    logBucket: destination.name,
+                    logObjectPrefix: options.prefix
+                }
+            }, storagePreconditions(options));
+            return storageData(result);
+        });
+    }
+    restore(options) {
+        return storageResult(async () => {
+            const result = await this.engine.referenceAction({ kind: 'bucket' }, {
+                kind: 'restoreBucket',
+                ...(options.projection !== undefined && {
+                    projection: options.projection
+                }),
+                generation: storageGeneration(options.generation)
+            });
+            this.metadata = storageData(result);
+            return this;
+        });
+    }
+    createChannel(id, config, options = {}) {
+        return storageResult(async () => {
+            const engine = options.userProject === undefined
+                ? this.engine
+                : this.engine.scoped(options);
+            const result = await engine.referenceAction({ kind: 'bucket' }, { kind: 'watch', id, config });
+            const metadata = storageData(result);
+            if (typeof metadata.resourceId !== 'string') {
+                throw new FirebaseEdgeError({
+                    code: 'storage/internal-error',
+                    message: 'Missing channel resource ID.'
+                });
+            }
+            return new Channel(id, metadata.resourceId, engine);
+        });
+    }
+    addLifecycleRule(rules, options = {}) {
+        return storageResult(async () => {
+            const result = await this.getMetadata();
+            const metadata = storageData(result);
+            const previous = options.append === false
+                ? []
+                : (metadata.lifecycle?.rule ?? []);
+            const updated = await this.setMetadata({
+                lifecycle: {
+                    rule: [
+                        ...previous,
+                        ...(Array.isArray(rules) ? rules : [rules])
+                    ]
+                }
+            }, { ifMetagenerationMatch: metadata.metageneration });
+            return storageData(updated);
+        });
+    }
+    createNotification(topic, options = {}) {
+        return storageResult(async () => {
+            const engine = options.userProject === undefined
+                ? this.engine
+                : this.engine.scoped({ userProject: options.userProject });
+            const result = await engine.createNotification({
+                topic: topic.startsWith('//pubsub.googleapis.com/')
+                    ? topic
+                    : `//pubsub.googleapis.com/${topic}`,
+                payload_format: options.payloadFormat ?? 'JSON_API_V1',
+                event_types: options.eventTypes ?? options.event_types,
+                object_name_prefix: options.objectNamePrefix ?? options.object_name_prefix,
+                custom_attributes: options.customAttributes ?? options.custom_attributes
+            });
+            const metadata = storageData(result);
+            const notification = new Notification(this, metadata.id, engine);
+            notification.metadata = metadata;
+            return notification;
+        });
+    }
+    getNotifications(options = {}) {
+        return storageResult(async () => {
+            const engine = options.userProject === undefined
+                ? this.engine
+                : this.engine.scoped(options);
+            const result = await engine.listNotifications();
+            return storageData(result).items.map((metadata) => {
+                const notification = new Notification(this, metadata.id, engine);
+                notification.metadata = metadata;
+                return notification;
+            });
+        });
+    }
+    makePublic(options = {}) {
+        return storageResult(async () => {
+            const result = await this.acl.add({
+                entity: 'allUsers',
+                role: 'READER'
+            });
+            storageData(result);
+            const defaults = await this.acl.default.add({
+                entity: 'allUsers',
+                role: 'READER'
+            });
+            storageData(defaults);
+            return this.updateFileVisibility(true, options);
+        });
+    }
+    makePrivate(options = {}) {
+        return storageResult(async () => {
+            const result = await this.engine.referenceAction({ kind: 'bucket' }, {
+                kind: 'makePrivate',
+                ...(options.metadata && {
+                    metadata: options.metadata
+                }),
+                preconditions: storagePreconditions({
+                    ...options.preconditionOpts,
+                    ...(options.userProject !== undefined && {
+                        userProject: options.userProject
+                    })
+                })
+            });
+            storageData(result);
+            return this.updateFileVisibility(false, options);
+        });
+    }
+    async updateFileVisibility(isPublic, options) {
+        if (!options.includeFiles) {
+            return [];
+        }
+        const result = await this.getFiles();
+        const { files } = storageData(result);
+        const failures = [];
+        for (const file of files) {
+            const { error } = isPublic
+                ? await file.makePublic()
+                : await file.makePrivate();
+            if (!error) {
+                continue;
+            }
+            if (!options.force) {
+                throw error;
+            }
+            failures.push(error);
+        }
+        if (failures.length) {
+            throw new FirebaseEdgeError({
+                code: 'storage/batch-incomplete',
+                message: 'Some object ACL updates failed.'
+            }, { context: { failures: failures.length } });
+        }
+        return files;
+    }
+    getSignedUrl(options) {
+        return this.engine.referenceSignedUrl(undefined, options);
+    }
+    setUserProject(userProject) {
+        this.engine = this.engine.scoped({ userProject });
+        return this;
+    }
+    request(options) {
+        return this.engine.requestResource({ kind: 'bucket' }, options);
+    }
+}
+//# sourceMappingURL=storage-bucket.js.map

package/dist/storage/storage-bucket.js.map

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

package/dist/storage/storage-channel.d.ts

@@ -0,0 +1,10 @@
+import type { Storage } from './storage.js';
+/** A legacy object-change notification channel. */
+export declare class Channel {
+    readonly id: string;
+    readonly resourceId: string;
+    private readonly storage;
+    constructor(id: string, resourceId: string, storage: Storage);
+    stop(): Promise<import("./storage-types.js").StorageResult<Record<string, unknown>>>;
+}
+//# sourceMappingURL=storage-channel.d.ts.map

package/dist/storage/storage-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-channel.d.ts","sourceRoot":"","sources":["../../src/storage/storage-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,mDAAmD;AACnD,qBAAa,OAAO;IAEZ,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,QAAQ,CAAC,UAAU,EAAE,MAAM;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAFf,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,MAAM,EACV,OAAO,EAAE,OAAO;IAErC,IAAI;CAMP"}

package/dist/storage/storage-channel.js

@@ -0,0 +1,15 @@
+/** A legacy object-change notification channel. */
+export class Channel {
+    id;
+    resourceId;
+    storage;
+    constructor(id, resourceId, storage) {
+        this.id = id;
+        this.resourceId = resourceId;
+        this.storage = storage;
+    }
+    stop() {
+        return this.storage.referenceAction({ kind: 'channel', id: this.id }, { kind: 'stopChannel', id: this.id, resourceId: this.resourceId });
+    }
+}
+//# sourceMappingURL=storage-channel.js.map

package/dist/storage/storage-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-channel.js","sourceRoot":"","sources":["../../src/storage/storage-channel.ts"],"names":[],"mappings":"AAEA,mDAAmD;AACnD,MAAM,OAAO,OAAO;IAEH;IACA;IACQ;IAHrB,YACa,EAAU,EACV,UAAkB,EACV,OAAgB;QAFxB,OAAE,GAAF,EAAE,CAAQ;QACV,eAAU,GAAV,UAAU,CAAQ;QACV,YAAO,GAAP,OAAO,CAAS;IAClC,CAAC;IACJ,IAAI;QACA,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAC/B,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,EAChC,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CACpE,CAAC;IACN,CAAC;CACJ"}

package/dist/storage/storage-checksum.d.ts

@@ -0,0 +1,35 @@
+import type { StorageUploadData, StorageFileMetadata } from './storage-types.js';
+export interface CRC32CValidator {
+    update(bytes: Uint8Array): void;
+    toString(): string;
+    validate(value: string): boolean;
+}
+export type CRC32CValidatorGenerator = () => CRC32CValidator;
+/** @internal Adapt SDK validators and combine a resumed prefix with the suffix CRC. */
+export declare function createStorageCrc32c(generator?: CRC32CValidatorGenerator, initial?: string | number): Pick<StorageCrc32c, 'update' | 'digest'>;
+/** @internal Incremental CRC32C shared by streamed downloads and uploads. */
+export declare class StorageCrc32c {
+    private crc;
+    constructor(initial?: string | number);
+    update(bytes: Uint8Array): void;
+    digest(): string;
+    toString(): string;
+    validate(value: string): boolean;
+}
+/** Compute a Cloud Storage CRC32C (base64, big-endian) using web-native input types. */
+export declare function calculateStorageCrc32c(input: StorageUploadData, generator?: CRC32CValidatorGenerator): Promise<string>;
+/** Compute the base64 MD5 used for Cloud Storage object integrity validation. */
+export declare function calculateStorageMd5(input: StorageUploadData): Promise<string>;
+/** @internal Centralize byte sizing and UTF-8 conversion for progress and checksums. */
+export declare function storageUploadBlob(input: StorageUploadData): Blob;
+/** @internal Detect checksum mismatches even when the service accepted the upload. */
+export declare function verifyStorageUpload(checksum: string | undefined, metadata: StorageFileMetadata, md5Hash?: string): void;
+/** @internal Require a canonical base64-encoded four-byte CRC32C. */
+export declare function validateStorageCrc32c(value: unknown): asserts value is string;
+/** @internal Require canonical base64 representing a 16-byte MD5 digest. */
+export declare function validateStorageMd5(value: unknown): asserts value is string;
+/** @internal Validate downloaded bytes against the whole-object response checksum. */
+export declare function verifyStorageDownload(bytes: Uint8Array<ArrayBuffer>, response: Response, algorithm?: 'crc32c' | 'md5', generator?: CRC32CValidatorGenerator): Promise<void>;
+/** @internal Preserve backpressure and report integrity errors when the stream reaches EOF. */
+export declare function verifyStorageStream(response: Response, algorithm?: 'crc32c' | 'md5', generator?: CRC32CValidatorGenerator): Response;
+//# sourceMappingURL=storage-checksum.d.ts.map

package/dist/storage/storage-checksum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-checksum.d.ts","sourceRoot":"","sources":["../../src/storage/storage-checksum.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACR,iBAAiB,EACjB,mBAAmB,EACtB,MAAM,oBAAoB,CAAC;AAU5B,MAAM,WAAW,eAAe;IAC5B,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAChC,QAAQ,IAAI,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACpC;AAED,MAAM,MAAM,wBAAwB,GAAG,MAAM,eAAe,CAAC;AAE7D,uFAAuF;AACvF,wBAAgB,mBAAmB,CAC/B,SAAS,CAAC,EAAE,wBAAwB,EACpC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAC1B,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,QAAQ,CAAC,CA4C1C;AAiDD,6EAA6E;AAC7E,qBAAa,aAAa;IACtB,OAAO,CAAC,GAAG,CAAc;gBAEb,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IA0BrC,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAM/B,MAAM,IAAI,MAAM;IAYhB,QAAQ,IAAI,MAAM;IAIlB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGnC;AAED,wFAAwF;AACxF,wBAAsB,sBAAsB,CACxC,KAAK,EAAE,iBAAiB,EACxB,SAAS,CAAC,EAAE,wBAAwB,GACrC,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED,iFAAiF;AACjF,wBAAsB,mBAAmB,CACrC,KAAK,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,CAEjB;AAyBD,wFAAwF;AACxF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAahE;AAED,sFAAsF;AACtF,wBAAgB,mBAAmB,CAC/B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,CAAC,EAAE,MAAM,QA2CnB;AAED,qEAAqE;AACrE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAU7E;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAU1E;AAED,sFAAsF;AACtF,wBAAsB,qBAAqB,CACvC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,EAC9B,QAAQ,EAAE,QAAQ,EAClB,SAAS,GAAE,QAAQ,GAAG,KAAgB,EACtC,SAAS,CAAC,EAAE,wBAAwB,iBAUvC;AA0BD,+FAA+F;AAC/F,wBAAgB,mBAAmB,CAC/B,QAAQ,EAAE,QAAQ,EAClB,SAAS,GAAE,QAAQ,GAAG,KAAgB,EACtC,SAAS,CAAC,EAAE,wBAAwB,GACrC,QAAQ,CA8DV"}