@agirails/sdk 2.0.1-beta → 2.0.2

package/dist/runtime/MockStateManager.js

@@ -0,0 +1,533 @@
+"use strict";
+/**
+ * MockStateManager - Persistent state management for Mock Mode
+ *
+ * Responsible for persisting mock blockchain state to disk, enabling
+ * state sharing across CLI commands, SDK library usage, and Dashboard.
+ *
+ * Features:
+ * - File-based JSON persistence in `.actp/mock-state.json`
+ * - Atomic file operations (write to temp file, then rename)
+ * - File locking to prevent concurrent access corruption
+ * - Error recovery for corrupted state files
+ *
+ * @module runtime/MockStateManager
+ * @see ADR-001 (Mock State Persistence Strategy)
+ * @see MOCK_STATE_MANAGER_SPEC.md
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockStateManager = exports.MockStateLockError = exports.MockStateVersionError = exports.MockStateCorruptedError = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const proper_lockfile_1 = __importDefault(require("proper-lockfile"));
+const MockState_1 = require("./types/MockState");
+const fsSafe_1 = require("../utils/fsSafe");
+/**
+ * Error thrown when mock state file is corrupted.
+ */
+class MockStateCorruptedError extends Error {
+    constructor(statePath, cause) {
+        super(`Mock state file corrupted: ${statePath}\n` +
+            `Delete it manually or run: actp mock reset\n` +
+            (cause ? `Cause: ${cause.message}` : ''));
+        this.name = 'MockStateCorruptedError';
+        this.statePath = statePath;
+    }
+}
+exports.MockStateCorruptedError = MockStateCorruptedError;
+/**
+ * Error thrown when state version is unsupported.
+ */
+class MockStateVersionError extends Error {
+    constructor(version, supportedVersion = MockState_1.MOCK_STATE_DEFAULTS.VERSION) {
+        super(`Unsupported state version: ${version}\n` +
+            `Supported version: ${supportedVersion}\n` +
+            `Run: actp mock reset to create new state file`);
+        this.name = 'MockStateVersionError';
+        this.version = version;
+        this.supportedVersion = supportedVersion;
+    }
+}
+exports.MockStateVersionError = MockStateVersionError;
+/**
+ * Error thrown when lock cannot be acquired.
+ */
+class MockStateLockError extends Error {
+    constructor(statePath, cause) {
+        super(`Could not acquire lock on mock state: ${statePath}\n` +
+            `Another ACTP process may be running.\n` +
+            `Please wait a moment and try again.` +
+            (cause ? `\nCause: ${cause.message}` : ''));
+        this.name = 'MockStateLockError';
+        this.statePath = statePath;
+        this.cause = cause;
+    }
+}
+exports.MockStateLockError = MockStateLockError;
+/**
+ * Lock options for proper-lockfile.
+ * - 5 retries with exponential backoff (100ms -> 1000ms)
+ * - 10 second stale lock detection (handles process crashes)
+ */
+const LOCK_OPTIONS = {
+    retries: {
+        retries: 5,
+        minTimeout: 100,
+        maxTimeout: 1000,
+    },
+    stale: 10000, // 10 seconds
+};
+/**
+ * Maximum allowed state file size (10 MB).
+ * Prevents disk exhaustion from runaway state growth.
+ *
+ * Note: For states approaching this limit, JSON.stringify/parse may
+ * temporarily use ~3x the file size in memory (~30 MB for 10 MB state).
+ * This is acceptable for a local development tool with <1000 transactions.
+ */
+const MAX_STATE_FILE_SIZE = 10 * 1024 * 1024;
+/**
+ * Maximum nesting depth for JSON parsing.
+ * Prevents DoS attacks via deeply nested JSON structures.
+ *
+ * SECURITY: Deeply nested JSON can cause:
+ * - Stack overflow during parsing
+ * - Excessive CPU usage during traversal
+ * - Memory exhaustion from recursion
+ */
+const MAX_NESTING_DEPTH = 100;
+// ============================================================================
+// Security: Path Sanitization and JSON Depth Check
+// ============================================================================
+/**
+ * Sanitize a file path for safe display in error messages.
+ *
+ * SECURITY: Replaces home directory with ~ to prevent information disclosure.
+ *
+ * @param fullPath - The full file path to sanitize
+ * @returns Sanitized path safe for display
+ */
+function sanitizePath(fullPath) {
+    // Import os dynamically to get home directory
+    const home = process.env.HOME || process.env.USERPROFILE || '/';
+    return fullPath.replace(home, '~');
+}
+/**
+ * Check the nesting depth of a parsed JSON object.
+ *
+ * SECURITY: Prevents DoS via deeply nested JSON structures that can cause:
+ * - Stack overflow
+ * - Excessive CPU usage
+ * - Memory exhaustion
+ *
+ * @param obj - The object to check
+ * @param maxDepth - Maximum allowed nesting depth
+ * @param currentDepth - Current depth (used for recursion)
+ * @throws Error if object exceeds maximum nesting depth
+ */
+function checkNestingDepth(obj, maxDepth = MAX_NESTING_DEPTH, currentDepth = 0) {
+    if (currentDepth > maxDepth) {
+        throw new Error(`State file exceeds maximum nesting depth of ${maxDepth}. ` +
+            'This may indicate a corrupted or malicious state file.');
+    }
+    if (obj !== null && typeof obj === 'object') {
+        // Check arrays and objects
+        const values = Array.isArray(obj) ? obj : Object.values(obj);
+        for (const value of values) {
+            checkNestingDepth(value, maxDepth, currentDepth + 1);
+        }
+    }
+}
+/**
+ * MockStateManager handles persistence of mock blockchain state.
+ *
+ * State is stored in `.actp/mock-state.json` within the project root.
+ * Uses file locking to prevent corruption from concurrent access.
+ *
+ * @example
+ * ```typescript
+ * const manager = new MockStateManager();
+ *
+ * // Read-only access (no lock)
+ * const state = manager.loadState();
+ * console.log('Transactions:', Object.keys(state.transactions).length);
+ *
+ * // Read-modify-write with lock
+ * const txId = await manager.withLock(async (state) => {
+ *   const txId = generateId();
+ *   state.transactions[txId] = { ... };
+ *   return txId;
+ * });
+ * ```
+ */
+class MockStateManager {
+    /**
+     * Creates a new MockStateManager instance.
+     *
+     * @param projectRoot - Root directory for `.actp/` folder.
+     *                      Defaults to current working directory.
+     *
+     * @example
+     * ```typescript
+     * // Use current directory
+     * const manager = new MockStateManager();
+     *
+     * // Use specific project root
+     * const manager = new MockStateManager('/path/to/project');
+     * ```
+     */
+    constructor(projectRoot = process.cwd()) {
+        this.actpDir = path.join(projectRoot, '.actp');
+        this.statePath = path.join(this.actpDir, 'mock-state.json');
+        // Ensure .actp directory exists
+        this.ensureDirectory();
+    }
+    /**
+     * Ensures the .actp directory exists.
+     * Creates it with secure permissions if missing.
+     */
+    ensureDirectory() {
+        (0, fsSafe_1.ensureSafeDir)(this.actpDir, 0o755);
+    }
+    /**
+     * Loads state from disk.
+     *
+     * Returns default state if file doesn't exist (first run).
+     * Validates version compatibility and file size limits.
+     *
+     * SECURITY: Validates nesting depth to prevent DoS attacks.
+     *
+     * @returns The current mock state
+     *
+     * @throws {MockStateCorruptedError} If state file contains invalid JSON
+     * @throws {MockStateVersionError} If state version is not supported
+     * @throws {Error} If file exceeds size limit or other I/O errors
+     *
+     * @example
+     * ```typescript
+     * const state = manager.loadState();
+     * console.log('Current time:', state.blockchain.currentTime);
+     * ```
+     */
+    loadState() {
+        // If file doesn't exist, return default state
+        if (!fs.existsSync(this.statePath)) {
+            return this.getDefaultState();
+        }
+        // SECURITY: Refuse to read from symlinked state files
+        (0, fsSafe_1.assertSafeFileForRead)(this.statePath);
+        // Check file size limit
+        const stats = fs.statSync(this.statePath);
+        if (stats.size > MAX_STATE_FILE_SIZE) {
+            throw new Error(`Mock state file exceeds ${MAX_STATE_FILE_SIZE / 1024 / 1024} MB limit.\n` +
+                `Run: actp mock compact or actp mock reset`);
+        }
+        // Read and parse file
+        let raw;
+        try {
+            raw = fs.readFileSync(this.statePath, 'utf-8');
+        }
+        catch (error) {
+            // SECURITY: Sanitize path in error message
+            throw new Error(`Failed to read mock state file: ${sanitizePath(this.statePath)}\n` +
+                `Error: ${error.message}`);
+        }
+        // Parse JSON
+        let state;
+        try {
+            state = JSON.parse(raw);
+        }
+        catch (error) {
+            // SECURITY: Sanitize path in error message
+            throw new MockStateCorruptedError(sanitizePath(this.statePath), error);
+        }
+        // SECURITY FIX: Check nesting depth to prevent DoS via deeply nested JSON
+        try {
+            checkNestingDepth(state);
+        }
+        catch (error) {
+            throw new MockStateCorruptedError(sanitizePath(this.statePath), error);
+        }
+        // Validate version
+        if (state.version !== MockState_1.MOCK_STATE_DEFAULTS.VERSION) {
+            throw new MockStateVersionError(state.version);
+        }
+        // Basic schema validation
+        if (typeof state.mode !== 'string' ||
+            typeof state.blockchain !== 'object' ||
+            typeof state.transactions !== 'object' ||
+            typeof state.escrows !== 'object' ||
+            typeof state.accounts !== 'object') {
+            throw new MockStateCorruptedError(sanitizePath(this.statePath));
+        }
+        return state;
+    }
+    /**
+     * Saves state to disk atomically.
+     *
+     * Uses write-to-temp-then-rename pattern to ensure atomicity:
+     * 1. Write state to `.tmp` file
+     * 2. Rename `.tmp` to final path (atomic on POSIX)
+     *
+     * This prevents corruption if process crashes during write.
+     *
+     * @param state - The state to save
+     *
+     * @throws {Error} If write fails (disk full, permissions, etc.)
+     *
+     * @example
+     * ```typescript
+     * const state = manager.loadState();
+     * state.blockchain.currentTime += 3600; // Advance 1 hour
+     * manager.saveState(state);
+     * ```
+     */
+    saveState(state) {
+        // Ensure directory exists (may have been deleted)
+        this.ensureDirectory();
+        const tempPath = `${this.statePath}.tmp`;
+        try {
+            // Prevent clobbering via pre-created temp symlink/file
+            if (fs.existsSync(tempPath)) {
+                fs.unlinkSync(tempPath);
+            }
+            // Write to temp file first (pretty-printed for human readability)
+            const json = JSON.stringify(state, null, 2);
+            fs.writeFileSync(tempPath, json, {
+                encoding: 'utf-8',
+                mode: 0o644,
+                flag: 'wx', // exclusive create: do not follow existing symlink
+            });
+            // Rename atomically (POSIX rename is atomic)
+            fs.renameSync(tempPath, this.statePath);
+        }
+        catch (error) {
+            // Clean up temp file if it exists
+            if (fs.existsSync(tempPath)) {
+                try {
+                    fs.unlinkSync(tempPath);
+                }
+                catch {
+                    // Ignore cleanup errors
+                }
+            }
+            throw new Error(`Failed to save mock state: ${error.message}\n` +
+                `Path: ${sanitizePath(this.statePath)}`);
+        }
+    }
+    /**
+     * Executes an operation with exclusive file lock.
+     *
+     * Provides read-modify-write semantics with concurrency protection:
+     * 1. Acquires exclusive lock on state file
+     * 2. Loads current state
+     * 3. Executes operation (may modify state)
+     * 4. Saves updated state
+     * 5. Releases lock
+     *
+     * Lock is always released, even if operation throws.
+     *
+     * @typeParam T - Return type of the operation
+     * @param operation - Function that receives state and returns result.
+     *                    Can be sync or async. May modify state object.
+     *
+     * @returns Promise resolving to operation's return value
+     *
+     * @throws {MockStateLockError} If lock cannot be acquired after retries
+     * @throws {Error} If operation throws or save fails
+     *
+     * @example
+     * ```typescript
+     * // Create transaction with lock
+     * const txId = await manager.withLock(async (state) => {
+     *   const txId = '0x' + crypto.randomBytes(32).toString('hex');
+     *   state.transactions[txId] = {
+     *     id: txId,
+     *     state: 'INITIATED',
+     *     // ...
+     *   };
+     *   return txId;
+     * });
+     * ```
+     */
+    async withLock(operation) {
+        // Ensure state file exists before locking
+        // (proper-lockfile requires the file to exist)
+        if (!fs.existsSync(this.statePath)) {
+            this.saveState(this.getDefaultState());
+        }
+        // SECURITY: Refuse to lock/use symlinked state files
+        (0, fsSafe_1.assertSafeFileForRead)(this.statePath);
+        let release = null;
+        try {
+            // Acquire exclusive lock
+            release = await proper_lockfile_1.default.lock(this.statePath, LOCK_OPTIONS);
+            // Load current state
+            const state = this.loadState();
+            // Execute operation (may be async)
+            const result = await operation(state);
+            // Save modified state
+            this.saveState(state);
+            return result;
+        }
+        catch (error) {
+            // Transform lock errors into friendlier messages
+            if (error instanceof Error &&
+                (error.message.includes('ELOCKED') || error.message.includes('lock'))) {
+                throw new MockStateLockError(this.statePath, error);
+            }
+            throw error;
+        }
+        finally {
+            // Always release lock
+            if (release) {
+                try {
+                    await release();
+                }
+                catch {
+                    // Ignore release errors (lock may have expired)
+                }
+            }
+        }
+    }
+    /**
+     * Resets state to default (fresh blockchain).
+     *
+     * Useful for starting fresh during testing or after corruption.
+     * Does not require lock (overwrites entire file).
+     *
+     * @example
+     * ```typescript
+     * // Reset to clean state
+     * manager.reset();
+     *
+     * // Verify reset
+     * const state = manager.loadState();
+     * console.log('Transactions:', Object.keys(state.transactions).length); // 0
+     * ```
+     */
+    reset() {
+        const defaultState = this.getDefaultState();
+        this.saveState(defaultState);
+    }
+    /**
+     * Checks if mock mode is initialized (state file exists).
+     *
+     * @returns true if state file exists, false otherwise
+     *
+     * @example
+     * ```typescript
+     * if (!manager.exists()) {
+     *   console.log('Run: actp init to initialize mock mode');
+     * }
+     * ```
+     */
+    exists() {
+        return fs.existsSync(this.statePath);
+    }
+    /**
+     * Gets the path to the state file.
+     *
+     * @returns Absolute path to mock-state.json
+     */
+    getStatePath() {
+        return this.statePath;
+    }
+    /**
+     * Gets the path to the .actp directory.
+     *
+     * @returns Absolute path to .actp directory
+     */
+    getActpDir() {
+        return this.actpDir;
+    }
+    /**
+     * Creates default/initial mock state.
+     *
+     * Used when state file doesn't exist or after reset.
+     * Initializes blockchain with current timestamp.
+     *
+     * @returns Fresh mock state with empty transactions/escrows/accounts
+     */
+    getDefaultState() {
+        return {
+            version: MockState_1.MOCK_STATE_DEFAULTS.VERSION,
+            mode: 'mock',
+            blockchain: {
+                currentTime: Math.floor(Date.now() / 1000),
+                blockNumber: MockState_1.MOCK_STATE_DEFAULTS.INITIAL_BLOCK_NUMBER,
+                chainId: MockState_1.MOCK_STATE_DEFAULTS.CHAIN_ID,
+                blockTime: MockState_1.MOCK_STATE_DEFAULTS.BLOCK_TIME,
+            },
+            transactions: {},
+            escrows: {},
+            accounts: {},
+            // SECURITY FIX (L-4): Initialize events array for persistence
+            events: [],
+        };
+    }
+    /**
+     * Deletes the state file and .actp directory if empty.
+     *
+     * Used for cleanup during tests or uninitialization.
+     *
+     * @param force - If true, delete .actp directory even if not empty
+     *
+     * @example
+     * ```typescript
+     * // Clean up after tests
+     * manager.destroy();
+     * ```
+     */
+    destroy(force = false) {
+        // Remove state file
+        if (fs.existsSync(this.statePath)) {
+            fs.unlinkSync(this.statePath);
+        }
+        // Remove temp file if exists
+        const tempPath = `${this.statePath}.tmp`;
+        if (fs.existsSync(tempPath)) {
+            fs.unlinkSync(tempPath);
+        }
+        // Remove lock file if exists (created by proper-lockfile)
+        const lockPath = `${this.statePath}.lock`;
+        if (fs.existsSync(lockPath)) {
+            fs.unlinkSync(lockPath);
+        }
+        // Remove .actp directory if empty or forced
+        if (fs.existsSync(this.actpDir)) {
+            const files = fs.readdirSync(this.actpDir);
+            if (files.length === 0 || force) {
+                fs.rmSync(this.actpDir, { recursive: true, force: true });
+            }
+        }
+    }
+}
+exports.MockStateManager = MockStateManager;
+//# sourceMappingURL=MockStateManager.js.map

package/dist/runtime/MockStateManager.js.map

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

package/dist/runtime/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Runtime module exports.
+ *
+ * Provides both the runtime interface and concrete implementations.
+ *
+ * @module runtime
+ */
+export { IACTPRuntime, IMockRuntime, CreateTransactionParams } from './IACTPRuntime';
+export { MockRuntime } from './MockRuntime';
+export { MockStateManager } from './MockStateManager';
+export { BlockchainRuntime, BlockchainRuntimeConfig } from './BlockchainRuntime';
+export * from './types/MockState';
+export { TransactionNotFoundError, InvalidStateTransitionError, InsufficientBalanceError, EscrowNotFoundError, DeadlinePassedError, ContractPausedError, InvalidAmountError, DisputeWindowActiveError, } from './MockRuntime';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACjF,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,eAAe,CAAC"}

package/dist/runtime/index.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * Runtime module exports.
+ *
+ * Provides both the runtime interface and concrete implementations.
+ *
+ * @module runtime
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DisputeWindowActiveError = exports.InvalidAmountError = exports.ContractPausedError = exports.DeadlinePassedError = exports.EscrowNotFoundError = exports.InsufficientBalanceError = exports.InvalidStateTransitionError = exports.TransactionNotFoundError = exports.BlockchainRuntime = exports.MockStateManager = exports.MockRuntime = void 0;
+var MockRuntime_1 = require("./MockRuntime");
+Object.defineProperty(exports, "MockRuntime", { enumerable: true, get: function () { return MockRuntime_1.MockRuntime; } });
+var MockStateManager_1 = require("./MockStateManager");
+Object.defineProperty(exports, "MockStateManager", { enumerable: true, get: function () { return MockStateManager_1.MockStateManager; } });
+var BlockchainRuntime_1 = require("./BlockchainRuntime");
+Object.defineProperty(exports, "BlockchainRuntime", { enumerable: true, get: function () { return BlockchainRuntime_1.BlockchainRuntime; } });
+__exportStar(require("./types/MockState"), exports);
+// Re-export all custom errors from MockRuntime
+var MockRuntime_2 = require("./MockRuntime");
+Object.defineProperty(exports, "TransactionNotFoundError", { enumerable: true, get: function () { return MockRuntime_2.TransactionNotFoundError; } });
+Object.defineProperty(exports, "InvalidStateTransitionError", { enumerable: true, get: function () { return MockRuntime_2.InvalidStateTransitionError; } });
+Object.defineProperty(exports, "InsufficientBalanceError", { enumerable: true, get: function () { return MockRuntime_2.InsufficientBalanceError; } });
+Object.defineProperty(exports, "EscrowNotFoundError", { enumerable: true, get: function () { return MockRuntime_2.EscrowNotFoundError; } });
+Object.defineProperty(exports, "DeadlinePassedError", { enumerable: true, get: function () { return MockRuntime_2.DeadlinePassedError; } });
+Object.defineProperty(exports, "ContractPausedError", { enumerable: true, get: function () { return MockRuntime_2.ContractPausedError; } });
+Object.defineProperty(exports, "InvalidAmountError", { enumerable: true, get: function () { return MockRuntime_2.InvalidAmountError; } });
+Object.defineProperty(exports, "DisputeWindowActiveError", { enumerable: true, get: function () { return MockRuntime_2.DisputeWindowActiveError; } });
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;AAGH,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,yDAAiF;AAAxE,sHAAA,iBAAiB,OAAA;AAC1B,oDAAkC;AAElC,+CAA+C;AAC/C,6CASuB;AARrB,uHAAA,wBAAwB,OAAA;AACxB,0HAAA,2BAA2B,OAAA;AAC3B,uHAAA,wBAAwB,OAAA;AACxB,kHAAA,mBAAmB,OAAA;AACnB,kHAAA,mBAAmB,OAAA;AACnB,kHAAA,mBAAmB,OAAA;AACnB,iHAAA,kBAAkB,OAAA;AAClB,uHAAA,wBAAwB,OAAA"}