@cmdoss/memwal-sdk 0.6.0

package/dist/client/namespaces/ContextNamespace.js

@@ -0,0 +1,250 @@
+/**
+ * Context Namespace - App Context Management & Cross-Context Data Transfer
+ *
+ * Higher-level abstraction over MemoryCap capabilities.
+ * Provides user-friendly API for managing app contexts and
+ * exporting/importing data between different dApp contexts.
+ *
+ * A "context" is simply a MemoryCap for a specific app ID.
+ * This namespace makes it easier to work with app-scoped data.
+ *
+ * Key features:
+ * - Create/manage app contexts (MemoryCaps)
+ * - Export private data from one context
+ * - Import data into another context (re-encrypted)
+ * - User must sign to authorize decryption
+ *
+ * @module client/namespaces
+ */
+import { CapabilityService } from '../../services/CapabilityService.js';
+/**
+ * Context Namespace
+ *
+ * Higher-level API for managing app contexts
+ */
+export class ContextNamespace {
+    constructor(services) {
+        this.services = services;
+        this.capService = null;
+        // Initialize CapabilityService if SuiClient and packageId available
+        const suiClient = this.services.config.sui?.client;
+        const packageId = this.services.config.sui?.packageId;
+        if (suiClient && packageId) {
+            this.capService = new CapabilityService({
+                suiClient,
+                packageId,
+            });
+        }
+    }
+    /**
+     * Ensure CapabilityService is initialized
+     */
+    ensureService() {
+        if (!this.capService) {
+            throw new Error('CapabilityService not initialized. Check Sui configuration.');
+        }
+        return this.capService;
+    }
+    /**
+     * Create a new context for an app
+     *
+     * @param appId - Application identifier (e.g., "MEMO", "HEALTH", "FINANCE")
+     * @returns Created context (MemoryCap)
+     *
+     * @example
+     * ```typescript
+     * const memoContext = await pdw.context.create('MEMO');
+     * const healthContext = await pdw.context.create('HEALTH');
+     * ```
+     */
+    async create(appId) {
+        const service = this.ensureService();
+        const signer = this.services.config.signer.getSigner();
+        return await service.create({ appId }, signer);
+    }
+    /**
+     * Get context by app ID
+     *
+     * @param appId - Application identifier
+     * @returns Context or null if not found
+     */
+    async get(appId) {
+        const service = this.ensureService();
+        return await service.get(this.services.config.userAddress, appId);
+    }
+    /**
+     * Get or create context for an app
+     *
+     * Convenience method - returns existing context if found,
+     * otherwise creates a new one.
+     *
+     * @param appId - Application identifier
+     * @returns Existing or newly created context
+     *
+     * @example
+     * ```typescript
+     * // Always get a context, create if needed
+     * const ctx = await pdw.context.getOrCreate('MEMO');
+     * ```
+     */
+    async getOrCreate(appId) {
+        const service = this.ensureService();
+        const signer = this.services.config.signer.getSigner();
+        return await service.getOrCreate({ appId, userAddress: this.services.config.userAddress }, signer);
+    }
+    /**
+     * List all contexts owned by the user
+     *
+     * @returns Array of contexts (MemoryCaps)
+     *
+     * @example
+     * ```typescript
+     * const contexts = await pdw.context.list();
+     * contexts.forEach(ctx => console.log(ctx.appId));
+     * ```
+     */
+    async list() {
+        const service = this.ensureService();
+        return await service.list({
+            userAddress: this.services.config.userAddress,
+        });
+    }
+    /**
+     * Delete a context (burns the capability)
+     *
+     * Warning: This permanently revokes access to all memories
+     * encrypted with this context's key.
+     *
+     * @param appId - Application identifier
+     *
+     * @example
+     * ```typescript
+     * await pdw.context.delete('OLD_APP');
+     * ```
+     */
+    async delete(appId) {
+        const service = this.ensureService();
+        const signer = this.services.config.signer.getSigner();
+        // Get the capability first
+        const cap = await service.get(this.services.config.userAddress, appId);
+        if (!cap) {
+            throw new Error(`Context not found for appId: ${appId}`);
+        }
+        // Burn the capability
+        await service.burn({ capId: cap.id }, signer);
+    }
+    /**
+     * Transfer context to another user
+     *
+     * After transfer:
+     * - New owner can decrypt memories for this context
+     * - Original owner loses access
+     *
+     * @param appId - Application identifier
+     * @param recipient - Recipient's Sui address
+     */
+    async transfer(appId, recipient) {
+        const service = this.ensureService();
+        const signer = this.services.config.signer.getSigner();
+        // Get the capability first
+        const cap = await service.get(this.services.config.userAddress, appId);
+        if (!cap) {
+            throw new Error(`Context not found for appId: ${appId}`);
+        }
+        // Transfer the capability
+        await service.transfer({ capId: cap.id, recipient }, signer);
+    }
+    /**
+     * Check if context exists for an app
+     *
+     * @param appId - Application identifier
+     * @returns True if context exists
+     */
+    async exists(appId) {
+        const service = this.ensureService();
+        return await service.hasCapability(this.services.config.userAddress, appId);
+    }
+    /**
+     * Get context with extended info (memory count, last activity)
+     *
+     * Queries actual memory count and last activity from:
+     * 1. ViewService (on-chain query) if available
+     * 2. MemoryIndexService (local index) as fallback
+     *
+     * @param appId - Application identifier
+     * @returns Context info or null
+     */
+    async getInfo(appId) {
+        const cap = await this.get(appId);
+        if (!cap) {
+            return null;
+        }
+        let memoryCount = 0;
+        let lastActivity = cap.createdAt;
+        try {
+            // Try ViewService first (on-chain query)
+            if (this.services.viewService) {
+                const result = await this.services.viewService.getUserMemories(this.services.config.userAddress, { category: appId, limit: 1000 });
+                memoryCount = result.data.length;
+                // Find most recent activity
+                if (result.data.length > 0) {
+                    const timestamps = result.data
+                        .map(m => m.updatedAt || m.createdAt || 0)
+                        .filter(t => t > 0);
+                    if (timestamps.length > 0) {
+                        lastActivity = Math.max(...timestamps);
+                    }
+                }
+            }
+            // Fallback to MemoryIndexService (local index)
+            else if (this.services.memoryIndex) {
+                const memories = await this.services.memoryIndex.getUserMemories(this.services.config.userAddress, { categories: [appId] });
+                memoryCount = memories.length;
+                // Find most recent activity
+                if (memories.length > 0) {
+                    const timestamps = memories
+                        .map(m => m.metadata?.createdTimestamp || m.metadata?.updatedTimestamp || 0)
+                        .filter(t => t > 0);
+                    if (timestamps.length > 0) {
+                        lastActivity = Math.max(...timestamps);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            // Log but don't fail - return basic info
+            console.warn(`Failed to query memory stats for context ${appId}:`, error);
+        }
+        return {
+            ...cap,
+            memoryCount,
+            lastActivity,
+        };
+    }
+    /**
+     * Get SEAL key ID for a context
+     *
+     * Used for encryption/decryption operations.
+     *
+     * @param appId - Application identifier
+     * @returns Key ID as hex string
+     */
+    async getKeyId(appId) {
+        const service = this.ensureService();
+        const cap = await service.get(this.services.config.userAddress, appId);
+        if (!cap) {
+            return null;
+        }
+        return service.computeKeyId(cap);
+    }
+    /**
+     * Get all app IDs for user's contexts
+     *
+     * @returns Array of app IDs
+     */
+    async getAppIds() {
+        const contexts = await this.list();
+        return contexts.map(ctx => ctx.appId);
+    }
+}
+//# sourceMappingURL=ContextNamespace.js.map

package/dist/client/namespaces/ContextNamespace.js.map

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

package/dist/client/namespaces/EmbeddingsNamespace.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Embeddings Namespace - Direct Embedding Operations
+ *
+ * Pure delegation to EmbeddingService for direct embedding access.
+ * Useful for custom RAG pipelines and advanced AI integrations.
+ *
+ * @module client/namespaces
+ */
+import type { ServiceContainer } from '../SimplePDWClient';
+/**
+ * Embeddings Namespace
+ *
+ * Handles direct embedding generation and operations
+ */
+export declare class EmbeddingsNamespace {
+    private services;
+    constructor(services: ServiceContainer);
+    /**
+     * Generate embedding for single text
+     *
+     * Delegates to: EmbeddingService.embedText()
+     *
+     * @param text - Text to embed
+     * @param options - Embedding options
+     * @returns Embedding vector (768 dimensions for Gemini)
+     */
+    generate(text: string, options?: {
+        type?: 'query' | 'document';
+    }): Promise<number[]>;
+    /**
+     * Generate embeddings for multiple texts
+     *
+     * Delegates to: EmbeddingService.embedBatch()
+     *
+     * @param texts - Array of texts
+     * @returns Array of embedding vectors
+     */
+    batch(texts: string[]): Promise<number[][]>;
+    /**
+     * Calculate cosine similarity between two vectors
+     *
+     * Delegates to: EmbeddingService.calculateCosineSimilarity()
+     *
+     * @param vector1 - First vector
+     * @param vector2 - Second vector
+     * @returns Similarity score (0-1, higher is more similar)
+     */
+    similarity(vector1: number[], vector2: number[]): number;
+    /**
+     * Find most similar vectors from candidates
+     *
+     * Delegates to: EmbeddingService.findMostSimilar()
+     *
+     * @param queryVector - Query vector
+     * @param candidateVectors - Candidate vectors to compare
+     * @param k - Number of results (default: 5)
+     * @returns Top k similar vectors with scores
+     */
+    findSimilar(queryVector: number[], candidateVectors: number[][], k?: number): Array<{
+        index: number;
+        score: number;
+    }>;
+}
+//# sourceMappingURL=EmbeddingsNamespace.d.ts.map

package/dist/client/namespaces/EmbeddingsNamespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmbeddingsNamespace.d.ts","sourceRoot":"","sources":["../../../src/client/namespaces/EmbeddingsNamespace.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;GAIG;AACH,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,gBAAgB;IAE9C;;;;;;;;OAQG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAS1F;;;;;;;OAOG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IASjD;;;;;;;;OAQG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM;IAQxD;;;;;;;;;OASG;IACH,WAAW,CACT,WAAW,EAAE,MAAM,EAAE,EACrB,gBAAgB,EAAE,MAAM,EAAE,EAAE,EAC5B,CAAC,GAAE,MAAU,GACZ,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAa3C"}

package/dist/client/namespaces/EmbeddingsNamespace.js

@@ -0,0 +1,86 @@
+/**
+ * Embeddings Namespace - Direct Embedding Operations
+ *
+ * Pure delegation to EmbeddingService for direct embedding access.
+ * Useful for custom RAG pipelines and advanced AI integrations.
+ *
+ * @module client/namespaces
+ */
+/**
+ * Embeddings Namespace
+ *
+ * Handles direct embedding generation and operations
+ */
+export class EmbeddingsNamespace {
+    constructor(services) {
+        this.services = services;
+    }
+    /**
+     * Generate embedding for single text
+     *
+     * Delegates to: EmbeddingService.embedText()
+     *
+     * @param text - Text to embed
+     * @param options - Embedding options
+     * @returns Embedding vector (768 dimensions for Gemini)
+     */
+    async generate(text, options) {
+        if (!this.services.embedding) {
+            throw new Error('Embedding service not configured. Please provide geminiApiKey.');
+        }
+        const result = await this.services.embedding.embedText({ text });
+        return result.vector;
+    }
+    /**
+     * Generate embeddings for multiple texts
+     *
+     * Delegates to: EmbeddingService.embedBatch()
+     *
+     * @param texts - Array of texts
+     * @returns Array of embedding vectors
+     */
+    async batch(texts) {
+        if (!this.services.embedding) {
+            throw new Error('Embedding service not configured.');
+        }
+        const result = await this.services.embedding.embedBatch(texts);
+        return result.vectors;
+    }
+    /**
+     * Calculate cosine similarity between two vectors
+     *
+     * Delegates to: EmbeddingService.calculateCosineSimilarity()
+     *
+     * @param vector1 - First vector
+     * @param vector2 - Second vector
+     * @returns Similarity score (0-1, higher is more similar)
+     */
+    similarity(vector1, vector2) {
+        if (!this.services.embedding) {
+            throw new Error('Embedding service not configured.');
+        }
+        return this.services.embedding.calculateCosineSimilarity(vector1, vector2);
+    }
+    /**
+     * Find most similar vectors from candidates
+     *
+     * Delegates to: EmbeddingService.findMostSimilar()
+     *
+     * @param queryVector - Query vector
+     * @param candidateVectors - Candidate vectors to compare
+     * @param k - Number of results (default: 5)
+     * @returns Top k similar vectors with scores
+     */
+    findSimilar(queryVector, candidateVectors, k = 5) {
+        if (!this.services.embedding) {
+            throw new Error('Embedding service not configured.');
+        }
+        const results = this.services.embedding.findMostSimilar(queryVector, candidateVectors, k);
+        // Adapt result format (similarity → score)
+        return results.map(r => ({
+            index: r.index,
+            score: r.similarity
+        }));
+    }
+}
+//# sourceMappingURL=EmbeddingsNamespace.js.map

package/dist/client/namespaces/EmbeddingsNamespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmbeddingsNamespace.js","sourceRoot":"","sources":["../../../src/client/namespaces/EmbeddingsNamespace.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;GAIG;AACH,MAAM,OAAO,mBAAmB;IAC9B,YAAoB,QAA0B;QAA1B,aAAQ,GAAR,QAAQ,CAAkB;IAAG,CAAC;IAElD;;;;;;;;OAQG;IACH,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,OAAyC;QACpE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;QACpF,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QACjE,OAAO,MAAM,CAAC,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,CAAC,KAAe;QACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAC/D,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAED;;;;;;;;OAQG;IACH,UAAU,CAAC,OAAiB,EAAE,OAAiB;QAC7C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QAED,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,yBAAyB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;;;;;OASG;IACH,WAAW,CACT,WAAqB,EACrB,gBAA4B,EAC5B,IAAY,CAAC;QAEb,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,eAAe,CAAC,WAAW,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC;QAE1F,2CAA2C;QAC3C,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACvB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,KAAK,EAAE,CAAC,CAAC,UAAU;SACpB,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}

package/dist/client/namespaces/EncryptionNamespace.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Encryption Namespace - SEAL-based Encryption Operations
+ *
+ * Pure delegation to EncryptionService for SEAL encryption.
+ * Provides identity-based encryption with decentralized key management.
+ *
+ * @module client/namespaces
+ */
+import type { ServiceContainer } from '../SimplePDWClient';
+import type { SessionKey } from '@mysten/seal';
+/**
+ * Encryption result
+ */
+export interface EncryptionResult {
+    encryptedData: Uint8Array;
+    backupKey: Uint8Array;
+}
+/**
+ * Decryption options
+ */
+export interface DecryptionOptions {
+    encryptedData: Uint8Array;
+    sessionKey?: SessionKey;
+    requestingWallet?: string;
+    /** MemoryCap object ID for capability-based access control */
+    memoryCapId?: string;
+    /** SEAL key ID bytes - required with memoryCapId */
+    keyId?: Uint8Array;
+}
+/**
+ * Encryption Namespace
+ *
+ * Handles SEAL-based encryption with identity-based access control
+ */
+export declare class EncryptionNamespace {
+    private services;
+    constructor(services: ServiceContainer);
+    /**
+     * Encrypt data using SEAL
+     *
+     * Delegates to: EncryptionService.encrypt()
+     *
+     * NOTE: This uses userAddress as identity. For capability pattern,
+     * use encryptWithKeyId() instead.
+     *
+     * @param data - Data to encrypt
+     * @param threshold - Min key servers required (default: 2)
+     * @returns Encrypted data and backup key
+     */
+    encrypt(data: Uint8Array, threshold?: number): Promise<EncryptionResult>;
+    /**
+     * Encrypt data using SEAL with capability-based key ID
+     *
+     * Use this for capability pattern where keyId = keccak256(owner || nonce)
+     * The keyId MUST match what's passed to seal_approve during decryption.
+     *
+     * @param data - Data to encrypt
+     * @param keyId - Key ID bytes (compute with computeKeyId())
+     * @param threshold - Min key servers required (default: 2)
+     * @returns Encrypted data and backup key
+     */
+    encryptWithKeyId(data: Uint8Array, keyId: Uint8Array, threshold?: number): Promise<EncryptionResult>;
+    /**
+     * Decrypt SEAL-encrypted data
+     *
+     * Delegates to: EncryptionService.decrypt()
+     *
+     * Supports two access control patterns:
+     * 1. Capability pattern (recommended): Pass memoryCapId and keyId
+     * 2. Legacy allowlist pattern: Only requestingWallet needed
+     *
+     * @param options - Decryption options
+     * @returns Decrypted data
+     */
+    decrypt(options: DecryptionOptions): Promise<Uint8Array>;
+    /**
+     * Compute SEAL key_id from owner and nonce
+     *
+     * Use this to compute the key_id needed for capability-based decryption.
+     * The nonce comes from the MemoryCap object on-chain.
+     *
+     * @param ownerAddress - Owner's Sui address
+     * @param nonce - Nonce from MemoryCap object (32 bytes)
+     * @returns key_id bytes for SEAL approval
+     */
+    computeKeyId(ownerAddress: string, nonce: Uint8Array): Uint8Array;
+    /**
+     * Create session key for SEAL operations
+     *
+     * Delegates to: EncryptionService.createSessionKey()
+     *
+     * @param signer - Optional signer (keypair or signPersonalMessage function)
+     * @returns Session key
+     */
+    createSessionKey(signer?: {
+        signPersonalMessageFn?: (message: string) => Promise<{
+            signature: string;
+        }>;
+        keypair?: any;
+    }): Promise<SessionKey>;
+    /**
+     * Get or create session key (cached)
+     *
+     * Delegates to: EncryptionService.getOrCreateSessionKey()
+     *
+     * @returns Cached or new session key
+     */
+    getSessionKey(): Promise<SessionKey>;
+    /**
+     * Export session key for persistence
+     *
+     * Delegates to: EncryptionService.exportSessionKey()
+     *
+     * @param sessionKey - Session key to export
+     * @returns Serialized session key
+     */
+    exportSessionKey(sessionKey: SessionKey): Promise<string>;
+    /**
+     * Import previously exported session key
+     *
+     * Delegates to: EncryptionService.importSessionKey()
+     *
+     * @param exportedKey - Serialized session key
+     * @returns Session key instance
+     */
+    importSessionKey(exportedKey: string): Promise<SessionKey>;
+}
+//# sourceMappingURL=EncryptionNamespace.d.ts.map

package/dist/client/namespaces/EncryptionNamespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EncryptionNamespace.d.ts","sourceRoot":"","sources":["../../../src/client/namespaces/EncryptionNamespace.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,UAAU,CAAC;IAC1B,SAAS,EAAE,UAAU,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,UAAU,CAAC;IAC1B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED;;;;GAIG;AACH,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,gBAAgB;IAE9C;;;;;;;;;;;OAWG;IACG,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,GAAE,MAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAiBjF;;;;;;;;;;OAUG;IACG,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,GAAE,MAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqB7G;;;;;;;;;;;OAWG;IACG,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IAe9D;;;;;;;;;OASG;IACH,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,UAAU;IAQjE;;;;;;;OAOG;IACG,gBAAgB,CAAC,MAAM,CAAC,EAAE;QAC9B,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;YAAE,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC5E,OAAO,CAAC,EAAE,GAAG,CAAC;KACf,GAAG,OAAO,CAAC,UAAU,CAAC;IAWvB;;;;;;OAMG;IACG,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;IAU1C;;;;;;;OAOG;IACG,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ/D;;;;;;;OAOG;IACG,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CAUjE"}