@brightchain/brightchain-api-lib 0.0.1

package/src/lib/services/fecServiceFactory.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @file FecServiceFactory - Factory for selecting the best available FEC service
+ * @description Provides a factory method to select the optimal FEC service implementation
+ * based on the current environment and available hardware acceleration.
+ *
+ * @requirements 1.8
+ */
+import { IFecService } from '@brightchain/brightchain-lib';
+/**
+ * Factory for creating FEC service instances.
+ *
+ * This factory selects the best available FEC implementation based on:
+ * 1. Hardware availability (Apple Silicon for native acceleration)
+ * 2. Platform support (WASM for cross-platform)
+ *
+ * Priority order:
+ * 1. NativeRsFecService - Hardware-accelerated (Apple Silicon)
+ * 2. WasmFecService - Cross-platform WASM implementation
+ */
+export declare class FecServiceFactory {
+    private static cachedService;
+    private static cacheChecked;
+    /**
+     * Get the best available FEC service for the current environment.
+     *
+     * This method checks available implementations in priority order:
+     * 1. NativeRsFecService (Apple Silicon hardware acceleration)
+     * 2. WasmFecService (cross-platform WASM)
+     *
+     * The result is cached for subsequent calls.
+     *
+     * @returns Promise resolving to the best available IFecService implementation
+     * @throws Error if no FEC service is available
+     *
+     * @example
+     * ```typescript
+     * const fecService = await FecServiceFactory.getBestAvailable();
+     * const parity = await fecService.createParityData(blockData, 2);
+     * ```
+     */
+    static getBestAvailable(): Promise<IFecService>;
+    /**
+     * Get a specific FEC service implementation by type.
+     *
+     * @param type - The type of FEC service to get ('native' or 'wasm')
+     * @returns Promise resolving to the requested IFecService implementation
+     * @throws Error if the requested service is not available
+     *
+     * @example
+     * ```typescript
+     * // Force WASM implementation
+     * const wasmService = await FecServiceFactory.getByType('wasm');
+     * ```
+     */
+    static getByType(type: 'native' | 'wasm'): Promise<IFecService>;
+    /**
+     * Check which FEC services are available in the current environment.
+     *
+     * @returns Promise resolving to an object indicating availability of each service
+     *
+     * @example
+     * ```typescript
+     * const availability = await FecServiceFactory.checkAvailability();
+     * console.log('Native available:', availability.native);
+     * console.log('WASM available:', availability.wasm);
+     * ```
+     */
+    static checkAvailability(): Promise<{
+        native: boolean;
+        wasm: boolean;
+    }>;
+    /**
+     * Clear the cached FEC service instance.
+     *
+     * This is useful for testing or when the environment changes.
+     */
+    static clearCache(): void;
+    /**
+     * Create a new instance of the best available FEC service without caching.
+     *
+     * This is useful when you need a fresh instance or want to avoid
+     * sharing state between different parts of the application.
+     *
+     * @returns Promise resolving to a new IFecService instance
+     * @throws Error if no FEC service is available
+     */
+    static createNew(): Promise<IFecService>;
+}
+//# sourceMappingURL=fecServiceFactory.d.ts.map

package/src/lib/services/fecServiceFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fecServiceFactory.d.ts","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/services/fecServiceFactory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAI3D;;;;;;;;;;GAUG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,aAAa,CAA4B;IACxD,OAAO,CAAC,MAAM,CAAC,YAAY,CAAS;IAEpC;;;;;;;;;;;;;;;;;OAiBG;WACU,gBAAgB,IAAI,OAAO,CAAC,WAAW,CAAC;IA4BrD;;;;;;;;;;;;OAYG;WACU,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAoBrE;;;;;;;;;;;OAWG;WACU,iBAAiB,IAAI,OAAO,CAAC;QACxC,MAAM,EAAE,OAAO,CAAC;QAChB,IAAI,EAAE,OAAO,CAAC;KACf,CAAC;IAeF;;;;OAIG;IACH,MAAM,CAAC,UAAU,IAAI,IAAI;IAKzB;;;;;;;;OAQG;WACU,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC;CAiB/C"}

package/src/lib/services/fecServiceFactory.js

@@ -0,0 +1,154 @@
+"use strict";
+/**
+ * @file FecServiceFactory - Factory for selecting the best available FEC service
+ * @description Provides a factory method to select the optimal FEC service implementation
+ * based on the current environment and available hardware acceleration.
+ *
+ * @requirements 1.8
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FecServiceFactory = void 0;
+const fec_1 = require("./fec");
+const nativeRsFecService_1 = require("./nativeRsFecService");
+/**
+ * Factory for creating FEC service instances.
+ *
+ * This factory selects the best available FEC implementation based on:
+ * 1. Hardware availability (Apple Silicon for native acceleration)
+ * 2. Platform support (WASM for cross-platform)
+ *
+ * Priority order:
+ * 1. NativeRsFecService - Hardware-accelerated (Apple Silicon)
+ * 2. WasmFecService - Cross-platform WASM implementation
+ */
+class FecServiceFactory {
+    /**
+     * Get the best available FEC service for the current environment.
+     *
+     * This method checks available implementations in priority order:
+     * 1. NativeRsFecService (Apple Silicon hardware acceleration)
+     * 2. WasmFecService (cross-platform WASM)
+     *
+     * The result is cached for subsequent calls.
+     *
+     * @returns Promise resolving to the best available IFecService implementation
+     * @throws Error if no FEC service is available
+     *
+     * @example
+     * ```typescript
+     * const fecService = await FecServiceFactory.getBestAvailable();
+     * const parity = await fecService.createParityData(blockData, 2);
+     * ```
+     */
+    static async getBestAvailable() {
+        // Return cached service if available
+        if (this.cacheChecked && this.cachedService) {
+            return this.cachedService;
+        }
+        // Try native implementation first (highest priority)
+        const nativeService = new nativeRsFecService_1.NativeRsFecService();
+        if (await nativeService.isAvailable()) {
+            this.cachedService = nativeService;
+            this.cacheChecked = true;
+            return nativeService;
+        }
+        // Fall back to WASM implementation
+        const wasmService = new fec_1.WasmFecService();
+        if (await wasmService.isAvailable()) {
+            this.cachedService = wasmService;
+            this.cacheChecked = true;
+            return wasmService;
+        }
+        // If no service is available, throw an error
+        throw new Error('No FEC service available. Ensure either native bindings or WASM module is installed.');
+    }
+    /**
+     * Get a specific FEC service implementation by type.
+     *
+     * @param type - The type of FEC service to get ('native' or 'wasm')
+     * @returns Promise resolving to the requested IFecService implementation
+     * @throws Error if the requested service is not available
+     *
+     * @example
+     * ```typescript
+     * // Force WASM implementation
+     * const wasmService = await FecServiceFactory.getByType('wasm');
+     * ```
+     */
+    static async getByType(type) {
+        if (type === 'native') {
+            const nativeService = new nativeRsFecService_1.NativeRsFecService();
+            if (await nativeService.isAvailable()) {
+                return nativeService;
+            }
+            throw new Error('Native FEC service is not available on this platform.');
+        }
+        if (type === 'wasm') {
+            const wasmService = new fec_1.WasmFecService();
+            if (await wasmService.isAvailable()) {
+                return wasmService;
+            }
+            throw new Error('WASM FEC service is not available.');
+        }
+        throw new Error(`Unknown FEC service type: ${type}`);
+    }
+    /**
+     * Check which FEC services are available in the current environment.
+     *
+     * @returns Promise resolving to an object indicating availability of each service
+     *
+     * @example
+     * ```typescript
+     * const availability = await FecServiceFactory.checkAvailability();
+     * console.log('Native available:', availability.native);
+     * console.log('WASM available:', availability.wasm);
+     * ```
+     */
+    static async checkAvailability() {
+        const nativeService = new nativeRsFecService_1.NativeRsFecService();
+        const wasmService = new fec_1.WasmFecService();
+        const [nativeAvailable, wasmAvailable] = await Promise.all([
+            nativeService.isAvailable(),
+            wasmService.isAvailable(),
+        ]);
+        return {
+            native: nativeAvailable,
+            wasm: wasmAvailable,
+        };
+    }
+    /**
+     * Clear the cached FEC service instance.
+     *
+     * This is useful for testing or when the environment changes.
+     */
+    static clearCache() {
+        this.cachedService = null;
+        this.cacheChecked = false;
+    }
+    /**
+     * Create a new instance of the best available FEC service without caching.
+     *
+     * This is useful when you need a fresh instance or want to avoid
+     * sharing state between different parts of the application.
+     *
+     * @returns Promise resolving to a new IFecService instance
+     * @throws Error if no FEC service is available
+     */
+    static async createNew() {
+        // Try native implementation first
+        const nativeService = new nativeRsFecService_1.NativeRsFecService();
+        if (await nativeService.isAvailable()) {
+            return nativeService;
+        }
+        // Fall back to WASM implementation
+        const wasmService = new fec_1.WasmFecService();
+        if (await wasmService.isAvailable()) {
+            return wasmService;
+        }
+        throw new Error('No FEC service available. Ensure either native bindings or WASM module is installed.');
+    }
+}
+exports.FecServiceFactory = FecServiceFactory;
+FecServiceFactory.cachedService = null;
+FecServiceFactory.cacheChecked = false;
+//# sourceMappingURL=fecServiceFactory.js.map

package/src/lib/services/fecServiceFactory.js.map

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

package/src/lib/services/fecUsageExample.d.ts

@@ -0,0 +1,33 @@
+import { ParityData } from '@brightchain/brightchain-lib';
+/**
+ * Example usage of the adapted FEC service for filesystem/S3 objects
+ */
+export declare class FecUsageExample {
+    private fecService;
+    /**
+     * Example: Create parity data for a file and store it separately
+     */
+    createFileWithParity(fileData: Buffer, parityCount?: number): Promise<{
+        originalData: Buffer<ArrayBufferLike>;
+        parityData: ParityData[];
+        originalSize: number;
+    }>;
+    /**
+     * Example: Recover a corrupted file using parity data
+     */
+    recoverCorruptedFile(parityData: ParityData[], originalSize: number): Promise<Uint8Array<ArrayBufferLike> | Buffer<ArrayBufferLike>>;
+    /**
+     * Example: Verify file integrity using parity data
+     */
+    verifyFile(fileData: Buffer, parityData: ParityData[]): Promise<boolean>;
+    /**
+     * Complete example workflow
+     */
+    demonstrateWorkflow(): Promise<{
+        originalFile: Buffer<ArrayBuffer>;
+        recoveredFile: Uint8Array<ArrayBufferLike> | Buffer<ArrayBufferLike>;
+        parityData: ParityData[];
+        recoverySuccessful: boolean;
+    }>;
+}
+//# sourceMappingURL=fecUsageExample.d.ts.map

package/src/lib/services/fecUsageExample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fecUsageExample.d.ts","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/services/fecUsageExample.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAG1D;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAAwB;IAE1C;;OAEG;IACG,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAE,MAAU;;;;;IAmBpE;;OAEG;IACG,oBAAoB,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE,YAAY,EAAE,MAAM;IAgBzE;;OAEG;IACG,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,UAAU,EAAE,GACvB,OAAO,CAAC,OAAO,CAAC;IAInB;;OAEG;IACG,mBAAmB;;;;;;CAwC1B"}

package/src/lib/services/fecUsageExample.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FecUsageExample = void 0;
+const fec_1 = require("./fec");
+/**
+ * Example usage of the adapted FEC service for filesystem/S3 objects
+ */
+class FecUsageExample {
+    constructor() {
+        this.fecService = new fec_1.WasmFecService();
+    }
+    /**
+     * Example: Create parity data for a file and store it separately
+     */
+    async createFileWithParity(fileData, parityCount = 2) {
+        // Create parity data
+        const parityData = await this.fecService.createParityData(fileData, parityCount);
+        // In a real implementation, you would:
+        // 1. Store the original file (e.g., to S3 as "file.dat")
+        // 2. Store each parity data separately (e.g., "file.dat.parity.0", "file.dat.parity.1")
+        // 3. Store metadata about the original file size
+        return {
+            originalData: fileData,
+            parityData,
+            originalSize: fileData.length,
+        };
+    }
+    /**
+     * Example: Recover a corrupted file using parity data
+     */
+    async recoverCorruptedFile(parityData, originalSize) {
+        // Attempt recovery (pass null for corrupted data)
+        const result = await this.fecService.recoverFileData(null, // corrupted data
+        parityData, originalSize);
+        if (result.recovered) {
+            console.log('File successfully recovered!');
+            return result.data;
+        }
+        else {
+            throw new Error('File recovery failed');
+        }
+    }
+    /**
+     * Example: Verify file integrity using parity data
+     */
+    async verifyFile(fileData, parityData) {
+        return await this.fecService.verifyFileIntegrity(fileData, parityData);
+    }
+    /**
+     * Complete example workflow
+     */
+    async demonstrateWorkflow() {
+        // Original file data
+        const originalFile = Buffer.from('This is important file data that needs protection!');
+        // Step 1: Create parity data
+        console.log('Creating parity data...');
+        const { parityData, originalSize } = await this.createFileWithParity(originalFile, 2);
+        // Step 2: Verify integrity
+        console.log('Verifying file integrity...');
+        const isValid = await this.verifyFile(originalFile, parityData);
+        console.log('File integrity check:', isValid ? 'PASSED' : 'FAILED');
+        // Step 3: Simulate file corruption and recovery
+        console.log('Simulating file corruption and recovery...');
+        const recoveredFile = await this.recoverCorruptedFile(parityData, originalSize);
+        // Step 4: Verify recovery
+        const recoverySuccessful = originalFile.equals(Buffer.isBuffer(recoveredFile)
+            ? recoveredFile
+            : Buffer.from(recoveredFile));
+        console.log('Recovery successful:', recoverySuccessful ? 'YES' : 'NO');
+        return {
+            originalFile,
+            recoveredFile,
+            parityData,
+            recoverySuccessful,
+        };
+    }
+}
+exports.FecUsageExample = FecUsageExample;
+//# sourceMappingURL=fecUsageExample.js.map

package/src/lib/services/fecUsageExample.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fecUsageExample.js","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/services/fecUsageExample.ts"],"names":[],"mappings":";;;AACA,+BAAuC;AAEvC;;GAEG;AACH,MAAa,eAAe;IAA5B;QACU,eAAU,GAAG,IAAI,oBAAc,EAAE,CAAC;IAgG5C,CAAC;IA9FC;;OAEG;IACH,KAAK,CAAC,oBAAoB,CAAC,QAAgB,EAAE,cAAsB,CAAC;QAClE,qBAAqB;QACrB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,gBAAgB,CACvD,QAAQ,EACR,WAAW,CACZ,CAAC;QAEF,uCAAuC;QACvC,yDAAyD;QACzD,wFAAwF;QACxF,iDAAiD;QAEjD,OAAO;YACL,YAAY,EAAE,QAAQ;YACtB,UAAU;YACV,YAAY,EAAE,QAAQ,CAAC,MAAM;SAC9B,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,oBAAoB,CAAC,UAAwB,EAAE,YAAoB;QACvE,kDAAkD;QAClD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,eAAe,CAClD,IAAI,EAAE,iBAAiB;QACvB,UAAU,EACV,YAAY,CACb,CAAC;QAEF,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;YAC5C,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CACd,QAAgB,EAChB,UAAwB;QAExB,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACzE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,mBAAmB;QACvB,qBAAqB;QACrB,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAC9B,oDAAoD,CACrD,CAAC;QAEF,6BAA6B;QAC7B,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QACvC,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAClE,YAAY,EACZ,CAAC,CACF,CAAC;QAEF,2BAA2B;QAC3B,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAChE,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAEpE,gDAAgD;QAChD,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;QAC1D,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,oBAAoB,CACnD,UAAU,EACV,YAAY,CACb,CAAC;QAEF,0BAA0B;QAC1B,MAAM,kBAAkB,GAAG,YAAY,CAAC,MAAM,CAC5C,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC;YAC5B,CAAC,CAAC,aAAa;YACf,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAC/B,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAEvE,OAAO;YACL,YAAY;YACZ,aAAa;YACb,UAAU;YACV,kBAAkB;SACnB,CAAC;IACJ,CAAC;CACF;AAjGD,0CAiGC"}

package/src/lib/services/keyWrapping.d.ts

@@ -0,0 +1,61 @@
+import { SecureString } from '@digitaldefiance/ecies-lib';
+import { SecureBuffer } from '@digitaldefiance/node-ecies-lib';
+export interface WrappedKey {
+    salt: string;
+    iv: string;
+    authTag: string;
+    encryptedMasterKey: string;
+    iterations: number;
+}
+export interface PasswordWrappedSecret {
+    salt: string;
+    iv: string;
+    authTag: string;
+    ciphertext: string;
+    iterations: number;
+}
+export declare class KeyWrappingService {
+    private static inFlightUnwraps;
+    /**
+     * Generates a new master key and wraps it with the user's password
+     */
+    wrapNewMasterKey(password: SecureString): {
+        masterKey: SecureBuffer;
+        wrappedKey: WrappedKey;
+    };
+    /**
+     * Wraps an existing master key with a password-derived key
+     */
+    wrapMasterKey(masterKey: SecureBuffer, password: SecureString): WrappedKey;
+    /**
+     * Unwraps a master key using the user's password
+     */
+    unwrapMasterKey(wrappedKey: WrappedKey, password: SecureString): SecureBuffer;
+    /**
+     * Async version of unwrapMasterKey that uses libuv threadpool via crypto.pbkdf2
+     * to avoid blocking the event loop during password verification.
+     */
+    unwrapMasterKeyAsync(wrappedKey: WrappedKey, password: SecureString | string): Promise<SecureBuffer>;
+    /**
+     * Deduplicated async unwrap that coalesces concurrent identical PBKDF2 operations.
+     * Keyed by salt + iterations + a short hash of the password. Entry is removed after resolve/reject.
+     */
+    unwrapMasterKeyAsyncDedup(wrappedKey: WrappedKey, password: string): Promise<SecureBuffer>;
+    /**
+     * Changes password by re-wrapping the master key
+     */
+    changePassword(wrappedKey: WrappedKey, oldPassword: SecureString, newPassword: SecureString): WrappedKey;
+    /**
+     * Wraps arbitrary secret bytes with a password-derived key (AES-256-GCM)
+     */
+    wrapSecret(secret: SecureBuffer, password: SecureString): PasswordWrappedSecret;
+    /**
+     * Unwraps a password-wrapped secret (sync)
+     */
+    unwrapSecret(wrapped: PasswordWrappedSecret, password: SecureString): SecureBuffer;
+    /**
+     * Unwraps a password-wrapped secret (async PBKDF2)
+     */
+    unwrapSecretAsync(wrapped: PasswordWrappedSecret, password: SecureString | string): Promise<SecureBuffer>;
+}
+//# sourceMappingURL=keyWrapping.d.ts.map

package/src/lib/services/keyWrapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyWrapping.d.ts","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/services/keyWrapping.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAY/D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAGD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,kBAAkB;IAG7B,OAAO,CAAC,MAAM,CAAC,eAAe,CAA2C;IAEzE;;OAEG;IACI,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG;QAC/C,SAAS,EAAE,YAAY,CAAC;QACxB,UAAU,EAAE,UAAU,CAAC;KACxB;IAQD;;OAEG;IACI,aAAa,CAClB,SAAS,EAAE,YAAY,EACvB,QAAQ,EAAE,YAAY,GACrB,UAAU;IA0Cb;;OAEG;IACI,eAAe,CACpB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,YAAY,GACrB,YAAY;IAwCf;;;OAGG;IACU,oBAAoB,CAC/B,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,YAAY,GAAG,MAAM,GAC9B,OAAO,CAAC,YAAY,CAAC;IA+DxB;;;OAGG;IACU,yBAAyB,CACpC,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC;IAmCxB;;OAEG;IACI,cAAc,CACnB,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,YAAY,EACzB,WAAW,EAAE,YAAY,GACxB,UAAU;IAYb;;OAEG;IACI,UAAU,CACf,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,YAAY,GACrB,qBAAqB;IAwCxB;;OAEG;IACI,YAAY,CACjB,OAAO,EAAE,qBAAqB,EAC9B,QAAQ,EAAE,YAAY,GACrB,YAAY;IAqCf;;OAEG;IACU,iBAAiB,CAC5B,OAAO,EAAE,qBAAqB,EAC9B,QAAQ,EAAE,YAAY,GAAG,MAAM,GAC9B,OAAO,CAAC,YAAY,CAAC;CA8DzB"}