browser-debugger-cli 0.6.0 → 0.6.2

package/dist/utils/url.js

@@ -1,14 +1,14 @@
 /**
  * URL normalization, validation, and parsing utilities.
  */
-// ============================================================================
-// Constants
-// ============================================================================
 /**
  * Valid URL protocols for Chrome navigation.
  *
  * Excludes legacy protocols (vbscript) and limits to protocols
  * actually useful for modern web debugging scenarios.
+ *
+ * Includes javascript: for browser automation compatibility, though
+ * it's generally not recommended for direct navigation.
  */
 const VALID_PROTOCOLS = [
     'http:',
@@ -17,6 +17,7 @@ const VALID_PROTOCOLS = [
     'about:',
     'chrome:',
     'data:',
+    'javascript:',
     'blob:',
 ];
 /**
@@ -32,22 +33,22 @@ const PRESERVED_PROTOCOL_PREFIXES = [
     'javascript:',
     'blob:',
 ];
-// ============================================================================
-// URL Normalization
-// ============================================================================
 /**
  * Normalize a URL by adding http:// protocol if missing.
  *
  * Supports: localhost:3000, example.com, http://localhost, file:// URLs
  * Preserves special browser protocols: about:, chrome:, data:, javascript:, blob:
  *
+ * Case-insensitive protocol detection supports HTTPS://, HTTP://, etc.
+ *
  * @param url - URL string to normalize
- * @returns Normalized URL with protocol
+ * @returns Normalized URL with lowercase protocol
  *
  * @example
  * ```typescript
  * normalizeUrl('localhost:3000')      // → 'http://localhost:3000'
  * normalizeUrl('https://example.com') // → 'https://example.com'
+ * normalizeUrl('HTTPS://example.com') // → 'https://example.com'
  * normalizeUrl('example.com/path')    // → 'http://example.com/path'
  * normalizeUrl('about:blank')         // → 'about:blank' (unchanged)
  * normalizeUrl('chrome://settings')   // → 'chrome://settings' (unchanged)
@@ -58,15 +59,19 @@ const PRESERVED_PROTOCOL_PREFIXES = [
  * though it's generally not recommended for direct navigation.
  */
 export function normalizeUrl(url) {
-    // Check for protocols that should not be modified
-    if (PRESERVED_PROTOCOL_PREFIXES.some((prefix) => url.startsWith(prefix))) {
+    const urlLower = url.toLowerCase();
+    const hasPreservedPrefix = PRESERVED_PROTOCOL_PREFIXES.some((prefix) => urlLower.startsWith(prefix));
+    if (hasPreservedPrefix) {
+        const protocolMatch = url.match(/^([a-z]+:\/?\/?)/i);
+        if (protocolMatch?.[1]) {
+            const protocol = protocolMatch[1].toLowerCase();
+            const rest = url.slice(protocolMatch[1].length);
+            return protocol + rest;
+        }
         return url;
     }
     return `http://${url}`;
 }
-// ============================================================================
-// URL Validation
-// ============================================================================
 /**
  * Validate that a URL is valid and usable for Chrome navigation.
  *
@@ -90,7 +95,6 @@ export function normalizeUrl(url) {
  * 'localhost:3000' or 'example.com'.
  */
 export function validateUrl(url) {
-    // Empty URL
     if (!url || url.trim().length === 0) {
         return {
             valid: false,
@@ -98,7 +102,6 @@ export function validateUrl(url) {
             suggestion: 'Provide a valid URL, e.g.: http://localhost:3000',
         };
     }
-    // Check for spaces (common error)
     if (url.includes(' ')) {
         return {
             valid: false,
@@ -106,17 +109,28 @@ export function validateUrl(url) {
             suggestion: 'URLs cannot contain spaces',
         };
     }
-    // Check for invalid characters in hostname/protocol (before normalization)
-    // This prevents malformed URLs like "ht!tp://example" from being normalized to "http://ht!tp://example"
-    const beforePath = url.split('/')[0] ?? '';
-    if (/[!@#$%^&*()=+[\]{}\\|;'",<>?]/.test(beforePath)) {
+    const normalized = normalizeUrl(url);
+    const urlLower = url.toLowerCase();
+    if (urlLower.startsWith('vbscript:')) {
         return {
             valid: false,
-            error: `Invalid URL format: '${url}' (contains invalid characters)`,
-            suggestion: 'URLs cannot contain special characters like !, @, #, etc. in hostname or protocol',
+            error: `Dangerous protocol: 'vbscript:' is not allowed`,
+            suggestion: 'Use http://, https://, or other safe protocols',
         };
     }
-    const normalized = normalizeUrl(url);
+    const isSpecialProtocol = urlLower.startsWith('javascript:') ||
+        urlLower.startsWith('data:') ||
+        urlLower.startsWith('blob:');
+    if (!isSpecialProtocol) {
+        const beforePath = url.split('/')[0] ?? '';
+        if (/[!@#$%^&*()=+[\]{}\\|;'",<>?]/.test(beforePath)) {
+            return {
+                valid: false,
+                error: `Invalid URL format: '${url}' (contains invalid characters)`,
+                suggestion: 'URLs cannot contain special characters like !, @, #, etc. in hostname or protocol',
+            };
+        }
+    }
     try {
         const parsed = new URL(normalized);
         if (!VALID_PROTOCOLS.includes(parsed.protocol)) {
@@ -143,9 +157,6 @@ export function validateUrl(url) {
         };
     }
 }
-// ============================================================================
-// Safe URL Parsing
-// ============================================================================
 /**
  * Safely parse a URL string with automatic protocol detection.
  *
@@ -167,12 +178,10 @@ export function safeParseUrl(input) {
         return new URL(input);
     }
     catch {
-        // Second attempt: add http:// prefix for protocol-less URLs
         try {
             return new URL(`http://${input}`);
         }
         catch {
-            // Both attempts failed - invalid URL
             return null;
         }
     }
@@ -198,20 +207,24 @@ export function extractHostname(input) {
  * Extract hostname with pathname from a URL string safely.
  *
  * Useful for pattern matching that needs both hostname and path segments.
+ * Includes port number when present to enable differentiation between
+ * localhost:9222/api and localhost:3000/api.
  *
  * @param input - URL string to extract hostname+pathname from
- * @returns Hostname with pathname (e.g., 'example.com/api/users'), or original input if parsing fails
+ * @returns Hostname (with port if present) and pathname (e.g., 'example.com/api/users'), or original input if parsing fails
  *
  * @example
  * ```typescript
  * extractHostnameWithPath('https://api.example.com/v1/users?id=123')
  *   // → 'api.example.com/v1/users'
  * extractHostnameWithPath('localhost:3000/dashboard')
- *   // → 'localhost/dashboard'
+ *   // → 'localhost:3000/dashboard'
+ * extractHostnameWithPath('http://localhost:9222/api/test')
+ *   // → 'localhost:9222/api/test'
  * ```
  */
 export function extractHostnameWithPath(input) {
     const parsed = safeParseUrl(input);
-    return parsed ? parsed.hostname + parsed.pathname : input;
+    return parsed ? parsed.host + parsed.pathname : input;
 }
 //# sourceMappingURL=url.js.map

package/dist/utils/url.js.map

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

package/dist/utils/validation.d.ts

@@ -0,0 +1,101 @@
+/**
+ * @deprecated This validation module is deprecated. Use `@/commands/shared/validation.ts` instead.
+ *
+ * Migration guide:
+ * - `parseOptionalIntOption()` → `optionalIntRule()` with `validateOptions()`
+ * - `parsePositiveIntOption()` → `positiveIntRule()` with `validateOptions()`
+ * - `parseIntOption()` → `positiveIntRule()` with custom options
+ *
+ * The new validation layer provides:
+ * - Structured CommandError instances with proper exit codes
+ * - Type-safe validation rules
+ * - Consistent error formatting
+ * - Composable validation patterns
+ *
+ * @see commands/shared/validation.ts
+ */
+/**
+ * Parse and validate an integer option with range constraints.
+ *
+ * @deprecated Use `positiveIntRule()` from `@/commands/shared/validation.ts` instead
+ *
+ * @param name - The option name for error messages
+ * @param value - The string value to parse (or undefined)
+ * @param options - Validation configuration
+ * @returns Parsed integer value or undefined if not required and not provided
+ * @throws Error if validation fails
+ *
+ * @example
+ * ```typescript
+ * // Required with default
+ * const lastN = parseIntOption('last', options.last, {
+ *   defaultValue: 10,
+ *   min: 1,
+ *   max: 1000
+ * });
+ *
+ * // Optional
+ * const timeout = parseIntOption('timeout', options.timeout, {
+ *   required: false,
+ *   min: 1,
+ *   max: 3600
+ * });
+ * ```
+ */
+export declare function parseIntOption(name: string, value: string | undefined, options?: {
+    required?: boolean;
+    defaultValue?: number;
+    min?: number;
+    max?: number;
+    errorFormatter?: (value: string | undefined) => string;
+}): number | undefined;
+/**
+ * Parse and validate a positive integer option with range constraints.
+ *
+ * @deprecated Use `positiveIntRule()` from `@/commands/shared/validation.ts` instead
+ *
+ * @param name - The option name for error messages
+ * @param value - The string value to parse (or undefined)
+ * @param options - Validation configuration
+ * @returns Parsed integer value
+ * @throws Error if validation fails
+ *
+ * @example
+ * ```typescript
+ * const lastN = parsePositiveIntOption('last', options.last, {
+ *   defaultValue: 10,
+ *   min: 1,
+ *   max: 1000
+ * });
+ * ```
+ */
+export declare function parsePositiveIntOption(name: string, value: string | undefined, options?: {
+    defaultValue?: number;
+    min?: number;
+    max?: number;
+    errorFormatter?: (value: string | undefined) => string;
+}): number;
+/**
+ * Parse an optional integer option (returns undefined if not provided).
+ *
+ * @deprecated Use `optionalIntRule()` from `@/commands/shared/validation.ts` instead
+ *
+ * @param name - The option name for error messages
+ * @param value - The string value to parse (or undefined)
+ * @param options - Validation configuration
+ * @returns Parsed integer or undefined
+ * @throws Error if value is provided but invalid
+ *
+ * @example
+ * ```typescript
+ * const timeout = parseOptionalIntOption('timeout', options.timeout, {
+ *   min: 1,
+ *   max: 3600
+ * });
+ * ```
+ */
+export declare function parseOptionalIntOption(name: string, value: string | undefined, options?: {
+    min?: number;
+    max?: number;
+}): number | undefined;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAoBH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,CAAC;CACnD,GACL,MAAM,GAAG,SAAS,CA4BpB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,CAAC;CACnD,GACL,MAAM,CASR;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,OAAO,GAAE;IACP,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACT,GACL,MAAM,GAAG,SAAS,CAEpB"}

package/dist/utils/validation.js

@@ -0,0 +1,131 @@
+/**
+ * @deprecated This validation module is deprecated. Use `@/commands/shared/validation.ts` instead.
+ *
+ * Migration guide:
+ * - `parseOptionalIntOption()` → `optionalIntRule()` with `validateOptions()`
+ * - `parsePositiveIntOption()` → `positiveIntRule()` with `validateOptions()`
+ * - `parseIntOption()` → `positiveIntRule()` with custom options
+ *
+ * The new validation layer provides:
+ * - Structured CommandError instances with proper exit codes
+ * - Type-safe validation rules
+ * - Consistent error formatting
+ * - Composable validation patterns
+ *
+ * @see commands/shared/validation.ts
+ */
+import { invalidIntegerError } from '../ui/messages/validation.js';
+/**
+ * Build range options object for error messages.
+ *
+ * @deprecated Use the new validation layer in `@/commands/shared/validation.ts`
+ *
+ * @param min - Minimum value
+ * @param max - Maximum value
+ * @returns Range options object or undefined if no range constraints
+ */
+function buildRangeOptions(min, max) {
+    return min !== undefined && max !== undefined ? { min, max } : undefined;
+}
+/**
+ * Parse and validate an integer option with range constraints.
+ *
+ * @deprecated Use `positiveIntRule()` from `@/commands/shared/validation.ts` instead
+ *
+ * @param name - The option name for error messages
+ * @param value - The string value to parse (or undefined)
+ * @param options - Validation configuration
+ * @returns Parsed integer value or undefined if not required and not provided
+ * @throws Error if validation fails
+ *
+ * @example
+ * ```typescript
+ * // Required with default
+ * const lastN = parseIntOption('last', options.last, {
+ *   defaultValue: 10,
+ *   min: 1,
+ *   max: 1000
+ * });
+ *
+ * // Optional
+ * const timeout = parseIntOption('timeout', options.timeout, {
+ *   required: false,
+ *   min: 1,
+ *   max: 3600
+ * });
+ * ```
+ */
+export function parseIntOption(name, value, options = {}) {
+    const { required = true, defaultValue, min, max, errorFormatter } = options;
+    const strValue = value ?? (defaultValue !== undefined ? defaultValue.toString() : undefined);
+    if (strValue === undefined) {
+        if (required) {
+            throw new Error(`Option --${name} is required`);
+        }
+        return undefined;
+    }
+    const trimmed = strValue.trim();
+    const parsed = parseInt(trimmed, 10);
+    if (isNaN(parsed)) {
+        const errorMessage = errorFormatter?.(value) ?? invalidIntegerError(name, trimmed, buildRangeOptions(min, max));
+        throw new Error(errorMessage);
+    }
+    if ((min !== undefined && parsed < min) || (max !== undefined && parsed > max)) {
+        const errorMessage = errorFormatter?.(value) ?? invalidIntegerError(name, trimmed, buildRangeOptions(min, max));
+        throw new Error(errorMessage);
+    }
+    return parsed;
+}
+/**
+ * Parse and validate a positive integer option with range constraints.
+ *
+ * @deprecated Use `positiveIntRule()` from `@/commands/shared/validation.ts` instead
+ *
+ * @param name - The option name for error messages
+ * @param value - The string value to parse (or undefined)
+ * @param options - Validation configuration
+ * @returns Parsed integer value
+ * @throws Error if validation fails
+ *
+ * @example
+ * ```typescript
+ * const lastN = parsePositiveIntOption('last', options.last, {
+ *   defaultValue: 10,
+ *   min: 1,
+ *   max: 1000
+ * });
+ * ```
+ */
+export function parsePositiveIntOption(name, value, options = {}) {
+    const result = parseIntOption(name, value, { ...options, required: true });
+    // With required: true, parseIntOption will either return a number or throw.
+    // This extra check keeps TypeScript and lint rules satisfied without
+    // relying on a non-null assertion.
+    if (result === undefined) {
+        throw new Error(`Option --${name} is required`);
+    }
+    return result;
+}
+/**
+ * Parse an optional integer option (returns undefined if not provided).
+ *
+ * @deprecated Use `optionalIntRule()` from `@/commands/shared/validation.ts` instead
+ *
+ * @param name - The option name for error messages
+ * @param value - The string value to parse (or undefined)
+ * @param options - Validation configuration
+ * @returns Parsed integer or undefined
+ * @throws Error if value is provided but invalid
+ *
+ * @example
+ * ```typescript
+ * const timeout = parseOptionalIntOption('timeout', options.timeout, {
+ *   min: 1,
+ *   max: 3600
+ * });
+ * ```
+ */
+export function parseOptionalIntOption(name, value, options = {}) {
+    return parseIntOption(name, value, { ...options, required: false });
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE;;;;;;;;GAQG;AACH,SAAS,iBAAiB,CACxB,GAAuB,EACvB,GAAuB;IAEvB,OAAO,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,KAAyB,EACzB,UAMI,EAAE;IAEN,MAAM,EAAE,QAAQ,GAAG,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;IAE5E,MAAM,QAAQ,GAAG,KAAK,IAAI,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAE7F,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,cAAc,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAErC,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAClB,MAAM,YAAY,GAChB,cAAc,EAAE,CAAC,KAAK,CAAC,IAAI,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QAC7F,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,MAAM,GAAG,GAAG,CAAC,EAAE,CAAC;QAC/E,MAAM,YAAY,GAChB,cAAc,EAAE,CAAC,KAAK,CAAC,IAAI,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QAC7F,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAY,EACZ,KAAyB,EACzB,UAKI,EAAE;IAEN,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3E,4EAA4E;IAC5E,qEAAqE;IACrE,mCAAmC;IACnC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,cAAc,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAY,EACZ,KAAyB,EACzB,UAGI,EAAE;IAEN,OAAO,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;AACtE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browser-debugger-cli",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "DevTools telemetry in your terminal. For humans and agents. Direct WebSocket to Chrome's debugging port.",
   "type": "module",
   "bin": {
@@ -29,6 +29,7 @@
     "check:enhanced": "npm run format:check && npm run type-check && npm run lint && npm run validate:module-type && npm run validate:ts-version",
     "test": "tsx --test src/**/__tests__/*.test.ts src/**/__tests__/*.contract.test.ts src/__tests__/integration/*.test.ts",
     "test:watch": "tsx --test --watch src/**/__tests__/*.test.ts src/**/__tests__/*.contract.test.ts src/__tests__/integration/*.test.ts",
+    "test:coverage": "c8 npm test",
     "test:smoke": "tsx --test --test-concurrency=1 src/__tests__/smoke/*.test.ts",
     "prepublishOnly": "npm run build",
     "prepare": "husky"
@@ -54,6 +55,7 @@
     "@types/ws": "^8.5.10",
     "@typescript-eslint/eslint-plugin": "^8.46.2",
     "@typescript-eslint/parser": "^8.46.2",
+    "c8": "^10.1.3",
     "concurrently": "^9.2.1",
     "eslint": "^9.39.0",
     "eslint-config-prettier": "^10.1.8",
@@ -98,5 +100,24 @@
     "*.{js,json}": [
       "prettier --write"
     ]
+  },
+  "c8": {
+    "reporter": [
+      "text",
+      "lcov",
+      "html"
+    ],
+    "exclude": [
+      "**/*.test.ts",
+      "**/*.contract.test.ts",
+      "tests/**",
+      "**/mocks/**",
+      "**/fixtures/**",
+      "**/__tests__/**",
+      "**/__testfixtures__/**",
+      "**/__testutils__/**"
+    ],
+    "all": true,
+    "check-coverage": false
   }
 }

package/dist/commands/dom.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../src/commands/dom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoSzC;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgE1D"}