@jack-kernel/sdk 1.0.0

package/dist/esm/execution.js

@@ -0,0 +1,381 @@
+/**
+ * Execution tracking for the JACK SDK
+ *
+ * This module provides the ExecutionTracker class for polling intent status
+ * and waiting for specific execution states.
+ *
+ * Requirements: 2.1, 2.5
+ */
+import { ExecutionStatus } from './types.js';
+import { TimeoutError } from './errors.js';
+/**
+ * Manager for execution tracking operations
+ *
+ * Provides methods to poll intent status, wait for specific statuses,
+ * and track execution progress with configurable timeouts.
+ *
+ * @example
+ * ```typescript
+ * const client = new JackClient({ baseUrl: 'https://api.jack.example' });
+ * const tracker = new ExecutionTracker(client);
+ *
+ * // Wait for intent to settle
+ * const intent = await tracker.waitForStatus(
+ *   'JK-ABC123456',
+ *   ExecutionStatus.SETTLED,
+ *   { timeout: 120000 }
+ * );
+ *
+ * console.log('Settlement tx:', intent.settlementTx);
+ * ```
+ */
+export class ExecutionTracker {
+    client;
+    /**
+     * Creates a new ExecutionTracker
+     *
+     * @param client - The JackClient instance to use for API requests
+     */
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get current status of an intent
+     *
+     * Queries the JACK API for the current intent status. This is a single
+     * request that returns the intent's current state without polling.
+     * This method delegates to the IntentManager's get() method.
+     *
+     * @param intentId - The intent ID to query (format: JK-[A-Z0-9]{9})
+     * @returns Promise resolving to the complete Intent object
+     * @throws APIError if the intent is not found (404) or other API error
+     * @throws NetworkError if the network request fails
+     *
+     * @example
+     * ```typescript
+     * const intent = await tracker.getStatus('JK-ABC123456');
+     * console.log('Current status:', intent.status);
+     * ```
+     *
+     * **Validates: Requirement 2.1**
+     */
+    async getStatus(intentId) {
+        return this.client.get(`/api/intents/${intentId}`);
+    }
+    /**
+     * Wait for intent to reach a specific status
+     *
+     * Polls the intent status at regular intervals until it reaches one of the
+     * target statuses or the timeout is exceeded. This is useful for waiting
+     * for intent completion or specific state transitions.
+     *
+     * The polling loop will stop when:
+     * - The intent reaches one of the target statuses
+     * - The timeout is exceeded (throws TimeoutError)
+     * - An API error occurs (throws APIError)
+     *
+     * @param intentId - The intent ID to poll
+     * @param targetStatus - Single status or array of statuses to wait for
+     * @param options - Polling configuration (interval, timeout, stopStatuses)
+     * @returns Promise resolving to the Intent when target status is reached
+     * @throws TimeoutError if timeout is exceeded before reaching target status
+     * @throws APIError if the API returns an error
+     * @throws NetworkError if the network request fails
+     *
+     * @example
+     * ```typescript
+     * // Wait for settlement with custom timeout
+     * const intent = await tracker.waitForStatus(
+     *   'JK-ABC123456',
+     *   ExecutionStatus.SETTLED,
+     *   { interval: 3000, timeout: 120000 }
+     * );
+     *
+     * // Wait for any terminal status
+     * const intent = await tracker.waitForStatus(
+     *   'JK-ABC123456',
+     *   [ExecutionStatus.SETTLED, ExecutionStatus.ABORTED, ExecutionStatus.EXPIRED]
+     * );
+     * ```
+     *
+     * **Validates: Requirement 2.5**
+     */
+    async waitForStatus(intentId, targetStatus, options) {
+        const interval = options?.interval ?? 2000;
+        const timeout = options?.timeout ?? 60000;
+        const targetStatuses = Array.isArray(targetStatus) ? targetStatus : [targetStatus];
+        const startTime = Date.now();
+        while (true) {
+            // Check if timeout exceeded
+            const elapsed = Date.now() - startTime;
+            if (elapsed >= timeout) {
+                throw new TimeoutError(`Timeout waiting for intent ${intentId} to reach status ${targetStatuses.join(' or ')}`, timeout, { intentId, targetStatuses, elapsed });
+            }
+            // Get current status
+            const intent = await this.getStatus(intentId);
+            // Check if we've reached target status
+            if (targetStatuses.includes(intent.status)) {
+                return intent;
+            }
+            // Check if we should stop polling based on stopStatuses
+            if (options?.stopStatuses && options.stopStatuses.includes(intent.status)) {
+                return intent;
+            }
+            // Wait before next poll
+            await this.sleep(interval);
+        }
+    }
+    /**
+     * Create a watcher for continuous intent status updates
+     *
+     * Returns an ExecutionWatcher that polls the intent status at regular
+     * intervals and emits events when the status changes. This is useful for
+     * real-time monitoring of intent execution.
+     *
+     * The watcher will continue polling until:
+     * - stop() is called
+     * - A terminal status is reached (SETTLED, ABORTED, EXPIRED)
+     * - An error occurs (emitted via onError callback)
+     *
+     * @param intentId - The intent ID to watch
+     * @param options - Polling configuration (interval, timeout)
+     * @returns ExecutionWatcher instance with event callbacks
+     *
+     * @example
+     * ```typescript
+     * const watcher = tracker.watch('JK-ABC123456', { interval: 3000 });
+     *
+     * watcher.onUpdate((intent) => {
+     *   console.log('Status updated:', intent.status);
+     * });
+     *
+     * watcher.onComplete((intent) => {
+     *   console.log('Intent completed:', intent.settlementTx);
+     *   watcher.stop();
+     * });
+     *
+     * watcher.onError((error) => {
+     *   console.error('Polling error:', error);
+     * });
+     * ```
+     *
+     * **Validates: Requirements 2.2, 8.3**
+     */
+    watch(intentId, options) {
+        return new ExecutionWatcherImpl(this, intentId, options);
+    }
+    /**
+     * Sleep for specified milliseconds
+     *
+     * @param ms - Milliseconds to sleep
+     * @returns Promise that resolves after the specified delay
+     */
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+/**
+ * Implementation of ExecutionWatcher for continuous intent monitoring
+ *
+ * This class implements the event emitter pattern for watching intent status
+ * changes. It polls the API at regular intervals and emits events when the
+ * status changes or when terminal states are reached.
+ *
+ * Requirements: 2.2, 8.3
+ */
+class ExecutionWatcherImpl {
+    intentId;
+    tracker;
+    interval;
+    timeout;
+    startTime;
+    updateCallbacks = [];
+    errorCallbacks = [];
+    completeCallbacks = [];
+    isRunning = false;
+    isStopped = false;
+    timeoutHandle = null;
+    lastStatus = null;
+    /**
+     * Creates a new ExecutionWatcher
+     *
+     * @param tracker - The ExecutionTracker instance to use for polling
+     * @param intentId - The intent ID to watch
+     * @param options - Polling configuration
+     */
+    constructor(tracker, intentId, options) {
+        this.tracker = tracker;
+        this.intentId = intentId;
+        this.interval = options?.interval ?? 2000;
+        this.timeout = options?.timeout ?? 60000;
+        this.startTime = Date.now();
+        // Start polling immediately
+        this.startPolling();
+    }
+    /**
+     * Register callback for status updates
+     *
+     * The callback is invoked whenever the intent status changes. Multiple
+     * callbacks can be registered and will all be invoked in order.
+     *
+     * @param callback - Function to call with updated intent
+     */
+    onUpdate(callback) {
+        this.updateCallbacks.push(callback);
+    }
+    /**
+     * Register callback for errors
+     *
+     * The callback is invoked when an error occurs during polling (e.g.,
+     * network error, API error, timeout). Multiple callbacks can be registered.
+     *
+     * @param callback - Function to call with error
+     */
+    onError(callback) {
+        this.errorCallbacks.push(callback);
+    }
+    /**
+     * Register callback for completion
+     *
+     * The callback is invoked when the intent reaches a terminal status
+     * (SETTLED, ABORTED, or EXPIRED). Multiple callbacks can be registered.
+     * After completion, polling stops automatically.
+     *
+     * @param callback - Function to call with final intent state
+     */
+    onComplete(callback) {
+        this.completeCallbacks.push(callback);
+    }
+    /**
+     * Stop watching and clean up resources
+     *
+     * Stops the polling loop and clears all callbacks. This method is
+     * idempotent and can be called multiple times safely.
+     */
+    stop() {
+        this.isStopped = true;
+        this.isRunning = false;
+        if (this.timeoutHandle) {
+            clearTimeout(this.timeoutHandle);
+            this.timeoutHandle = null;
+        }
+        // Clear all callbacks to prevent memory leaks
+        this.updateCallbacks = [];
+        this.errorCallbacks = [];
+        this.completeCallbacks = [];
+    }
+    /**
+     * Alias for stop() to implement Subscription interface
+     */
+    unsubscribe() {
+        this.stop();
+    }
+    /**
+     * Start the polling loop
+     */
+    startPolling() {
+        if (this.isStopped || this.isRunning) {
+            return;
+        }
+        this.isRunning = true;
+        this.poll();
+    }
+    /**
+     * Execute a single poll iteration
+     */
+    async poll() {
+        if (this.isStopped || !this.isRunning) {
+            return;
+        }
+        try {
+            // Check if timeout exceeded
+            const elapsed = Date.now() - this.startTime;
+            if (elapsed >= this.timeout) {
+                const error = new TimeoutError(`Timeout watching intent ${this.intentId}`, this.timeout, { intentId: this.intentId, elapsed });
+                this.emitError(error);
+                this.stop();
+                return;
+            }
+            // Get current status
+            const intent = await this.tracker.getStatus(this.intentId);
+            // Check if status changed
+            const statusChanged = this.lastStatus !== null && this.lastStatus !== intent.status;
+            this.lastStatus = intent.status;
+            // Emit update if status changed
+            if (statusChanged) {
+                this.emitUpdate(intent);
+            }
+            // Check if we've reached a terminal status
+            const terminalStatuses = [
+                ExecutionStatus.SETTLED,
+                ExecutionStatus.ABORTED,
+                ExecutionStatus.EXPIRED
+            ];
+            if (terminalStatuses.includes(intent.status)) {
+                this.emitComplete(intent);
+                this.stop();
+                return;
+            }
+            // Schedule next poll
+            this.scheduleNextPoll();
+        }
+        catch (error) {
+            this.emitError(error instanceof Error ? error : new Error(String(error)));
+            this.stop();
+        }
+    }
+    /**
+     * Schedule the next poll iteration
+     */
+    scheduleNextPoll() {
+        if (this.isStopped || !this.isRunning) {
+            return;
+        }
+        this.timeoutHandle = setTimeout(() => {
+            this.poll();
+        }, this.interval);
+    }
+    /**
+     * Emit update event to all registered callbacks
+     */
+    emitUpdate(intent) {
+        for (const callback of this.updateCallbacks) {
+            try {
+                callback(intent);
+            }
+            catch (error) {
+                // Catch errors in callbacks to prevent them from breaking the polling loop
+                console.error('Error in onUpdate callback:', error);
+            }
+        }
+    }
+    /**
+     * Emit error event to all registered callbacks
+     */
+    emitError(error) {
+        for (const callback of this.errorCallbacks) {
+            try {
+                callback(error);
+            }
+            catch (err) {
+                // Catch errors in callbacks
+                console.error('Error in onError callback:', err);
+            }
+        }
+    }
+    /**
+     * Emit complete event to all registered callbacks
+     */
+    emitComplete(intent) {
+        for (const callback of this.completeCallbacks) {
+            try {
+                callback(intent);
+            }
+            catch (error) {
+                // Catch errors in callbacks
+                console.error('Error in onComplete callback:', error);
+            }
+        }
+    }
+}
+//# sourceMappingURL=execution.js.map

package/dist/esm/execution.js.map

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

package/dist/esm/index.js

@@ -0,0 +1,236 @@
+// Re-export enums
+export { ExecutionStatus } from './types.js';
+// Re-export all error classes
+export { JackError, NetworkError, APIError, ValidationError, TimeoutError, RetryError } from './errors.js';
+// Re-export serialization functions
+export { getTypedData, serializeIntentParams, parseIntentParams } from './serialization.js';
+// Re-export validation functions
+export { validateIntentParams } from './validation.js';
+// Re-export IntentManager
+export { IntentManager } from './intents.js';
+// Re-export ExecutionTracker
+export { ExecutionTracker } from './execution.js';
+// Re-export CostTracker
+export { CostTracker } from './costs.js';
+// Re-export AgentUtils
+export { AgentUtils } from './agent.js';
+// Re-export JackClient
+export { JackClient } from './client.js';
+// Import manager classes
+import { JackClient } from './client.js';
+import { IntentManager } from './intents.js';
+import { ExecutionTracker } from './execution.js';
+import { CostTracker } from './costs.js';
+import { AgentUtils } from './agent.js';
+// Import types and enums for use in this file
+import { ExecutionStatus } from './types.js';
+/**
+ * Main SDK class for JACK cross-chain execution kernel
+ *
+ * Provides a comprehensive, type-safe interface for interacting with the JACK system.
+ * Initializes all managers (intents, execution, costs, agent) and exposes them as
+ * public readonly properties. Also provides convenience methods for common operations.
+ *
+ * @example
+ * ```typescript
+ * // Initialize SDK
+ * const sdk = new JACK_SDK({ baseUrl: 'https://api.jack.example' });
+ *
+ * // Create and submit intent
+ * const typedData = sdk.intents.getTypedData(params);
+ * const signature = await wallet.signTypedData(typedData);
+ * const intentId = await sdk.submitIntent(params, signature);
+ *
+ * // Track execution
+ * const intent = await sdk.waitForSettlement(intentId);
+ * console.log('Settlement tx:', intent.settlementTx);
+ *
+ * // Access managers directly
+ * const costs = await sdk.costs.getCosts();
+ * const results = await sdk.agent.batchSubmit([...]);
+ * ```
+ *
+ * **Validates: Requirements 1.1, 1.2, 1.3, 1.4, 2.5**
+ */
+export class JACK_SDK {
+    /**
+     * Intent management - create, submit, query intents
+     */
+    intents;
+    /**
+     * Execution tracking - poll status, wait for completion
+     */
+    execution;
+    /**
+     * Cost tracking - query costs and budgets
+     */
+    costs;
+    /**
+     * Agent utilities - batch operations, subscriptions
+     */
+    agent;
+    /**
+     * Internal HTTP client (exposed for advanced use cases)
+     */
+    client;
+    /**
+     * Creates a new JACK_SDK instance
+     *
+     * Initializes all managers with the provided configuration. The configuration
+     * includes the base URL for the API and optional settings for timeout, retries,
+     * caching, and custom headers.
+     *
+     * @param config - Client configuration (baseUrl required, other options optional)
+     * @throws ValidationError if configuration is invalid
+     *
+     * @example
+     * ```typescript
+     * // Basic initialization
+     * const sdk = new JACK_SDK({ baseUrl: 'https://api.jack.example' });
+     *
+     * // With custom configuration
+     * const sdk = new JACK_SDK({
+     *   baseUrl: 'https://api.jack.example',
+     *   timeout: 60000,
+     *   maxRetries: 5,
+     *   enableCache: true,
+     *   cacheTTL: 120000,
+     *   headers: { 'Authorization': 'Bearer token' }
+     * });
+     * ```
+     */
+    constructor(config) {
+        // Initialize core HTTP client
+        this.client = new JackClient(config);
+        // Initialize all managers
+        this.intents = new IntentManager(this.client);
+        this.execution = new ExecutionTracker(this.client);
+        this.costs = new CostTracker(this.client);
+        this.agent = new AgentUtils(this.client);
+    }
+    /**
+     * Convenience method: Submit a signed intent
+     *
+     * Delegates to IntentManager.submit(). This is a convenience method
+     * for the most common operation - submitting a signed intent.
+     *
+     * @param params - Intent parameters
+     * @param signature - EIP-712 signature from wallet
+     * @returns Promise resolving to the intent ID
+     * @throws ValidationError if parameters are invalid
+     * @throws APIError if the API returns an error
+     * @throws NetworkError if the network request fails
+     *
+     * @example
+     * ```typescript
+     * const intentId = await sdk.submitIntent(params, signature);
+     * console.log('Intent submitted:', intentId);
+     * ```
+     *
+     * **Validates: Requirement 1.2**
+     */
+    async submitIntent(params, signature) {
+        return this.intents.submit(params, signature);
+    }
+    /**
+     * Convenience method: Get a single intent by ID
+     *
+     * Delegates to IntentManager.get(). This is a convenience method
+     * for querying a single intent's current state.
+     *
+     * @param intentId - The intent ID to query
+     * @returns Promise resolving to the complete Intent object
+     * @throws APIError if the intent is not found or other API error
+     * @throws NetworkError if the network request fails
+     *
+     * @example
+     * ```typescript
+     * const intent = await sdk.getIntent('JK-ABC123456');
+     * console.log('Status:', intent.status);
+     * ```
+     *
+     * **Validates: Requirement 1.3**
+     */
+    async getIntent(intentId) {
+        return this.intents.get(intentId);
+    }
+    /**
+     * Convenience method: List all intents
+     *
+     * Delegates to IntentManager.list(). This is a convenience method
+     * for retrieving all intents.
+     *
+     * @returns Promise resolving to an array of Intent objects
+     * @throws APIError if the API returns an error
+     * @throws NetworkError if the network request fails
+     *
+     * @example
+     * ```typescript
+     * const intents = await sdk.listIntents();
+     * console.log(`Found ${intents.length} intents`);
+     * ```
+     *
+     * **Validates: Requirement 1.4**
+     */
+    async listIntents() {
+        return this.intents.list();
+    }
+    /**
+     * Convenience method: Wait for intent to settle
+     *
+     * Polls the intent status until it reaches SETTLED status or the timeout
+     * is exceeded. This is a convenience method that wraps ExecutionTracker.waitForStatus()
+     * with sensible defaults for waiting for settlement.
+     *
+     * @param intentId - The intent ID to wait for
+     * @param timeout - Maximum time to wait in milliseconds (default: 120000 = 2 minutes)
+     * @returns Promise resolving to the Intent when settled
+     * @throws TimeoutError if timeout is exceeded before settlement
+     * @throws APIError if the API returns an error
+     * @throws NetworkError if the network request fails
+     *
+     * @example
+     * ```typescript
+     * // Wait with default timeout (2 minutes)
+     * const intent = await sdk.waitForSettlement('JK-ABC123456');
+     * console.log('Settlement tx:', intent.settlementTx);
+     *
+     * // Wait with custom timeout (5 minutes)
+     * const intent = await sdk.waitForSettlement('JK-ABC123456', 300000);
+     * ```
+     *
+     * **Validates: Requirement 2.5**
+     */
+    async waitForSettlement(intentId, timeout = 120000) {
+        return this.execution.waitForStatus(intentId, ExecutionStatus.SETTLED, { timeout, interval: 2000 });
+    }
+    /**
+     * Legacy method: Get execution status
+     *
+     * @deprecated Use sdk.getIntent() or sdk.execution.getStatus() instead
+     *
+     * This method is kept for backward compatibility with existing dashboard code.
+     * It delegates to the execution tracker's getStatus method.
+     *
+     * @param intentId - The intent ID to query
+     * @returns Promise resolving to the Intent object
+     */
+    async getExecutionStatus(intentId) {
+        return this.execution.getStatus(intentId);
+    }
+    /**
+     * Legacy method: Get intent typed data
+     *
+     * @deprecated Use sdk.intents.getTypedData() instead
+     *
+     * This method is kept for backward compatibility with existing dashboard code.
+     * It delegates to the intent manager's getTypedData method.
+     *
+     * @param params - Intent parameters
+     * @returns EIP-712 TypedData object
+     */
+    getIntentTypedData(params) {
+        return this.intents.getTypedData(params);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AA+BA,kBAAkB;AAClB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,8BAA8B;AAC9B,OAAO,EACL,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,UAAU,EACX,MAAM,aAAa,CAAC;AAErB,oCAAoC;AACpC,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAE5B,iCAAiC;AACjC,OAAO,EACL,oBAAoB,EACrB,MAAM,iBAAiB,CAAC;AAEzB,0BAA0B;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,6BAA6B;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,uBAAuB;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,uBAAuB;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,yBAAyB;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,8CAA8C;AAC9C,OAAO,EAAE,eAAe,EAAqD,MAAM,YAAY,CAAC;AAEhG;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,OAAO,QAAQ;IACnB;;OAEG;IACa,OAAO,CAAgB;IAEvC;;OAEG;IACa,SAAS,CAAmB;IAE5C;;OAEG;IACa,KAAK,CAAc;IAEnC;;OAEG;IACa,KAAK,CAAa;IAElC;;OAEG;IACc,MAAM,CAAa;IAEpC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,YAAY,MAAoB;QAC9B,8BAA8B;QAC9B,IAAI,CAAC,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QAErC,0BAA0B;QAC1B,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,SAAS,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnD,IAAI,CAAC,KAAK,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,KAAK,CAAC,YAAY,CAAC,MAAoB,EAAE,SAAiB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,CAAC,SAAS,CAAC,QAAgB;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,KAAK,CAAC,iBAAiB,CAAC,QAAgB,EAAE,UAAkB,MAAM;QAChE,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa,CACjC,QAAQ,EACR,eAAe,CAAC,OAAO,EACvB,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAC5B,CAAC;IACJ,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,kBAAkB,CAAC,QAAgB;QACvC,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;;;;OAUG;IACH,kBAAkB,CAAC,MAAoB;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;CACF"}