@socketsecurity/lib 2.10.3 → 3.0.0

package/CHANGELOG.md

@@ -5,6 +5,44 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.0.0](https://github.com/SocketDev/socket-lib/releases/tag/v3.0.0) - 2025-11-01
+
+### Added
+
+- Theme system with 5 built-in themes: `socket`, `sunset`, `brick`, `lush`, `ultra`
+- `setTheme()`, `getTheme()`, `withTheme()`, `withThemeSync()` for theme management
+- `createTheme()`, `extendTheme()`, `resolveColor()` helper functions
+- `onThemeChange()` event listener for theme reactivity
+- `link()` function for themed terminal hyperlinks in `@socketsecurity/lib/links`
+- Logger and spinner now inherit theme colors automatically
+- Spinner methods: `enableShimmer()`, `disableShimmer()`, `setShimmer()`, `updateShimmer()`
+- DLX cross-platform binary resolution (`.cmd`, `.bat`, `.ps1` on Windows)
+- DLX programmatic options aligned with CLI conventions (`force`, `quiet`, `package`)
+
+### Changed
+
+- Theme context uses AsyncLocalStorage instead of manual stack management
+- Promise retry options renamed: `factor` → `backoffFactor`, `minTimeout` → `baseDelayMs`, `maxTimeout` → `maxDelayMs`
+
+### Removed
+
+**BREAKING CHANGES:**
+
+- `pushTheme()` and `popTheme()` - use `withTheme()` or `withThemeSync()` instead
+- `logger` export - use `getDefaultLogger()` instead
+- `spinner` export - use `getDefaultSpinner()` instead
+- `download-lock.ts` - use `process-lock.ts` instead
+- Promise option aliases: `factor`, `minTimeout`, `maxTimeout`
+
+---
+
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
 ## [2.10.3](https://github.com/SocketDev/socket-lib/releases/tag/v2.10.3) - 2025-10-31
 
 ### Fixed

package/README.md

@@ -1,87 +1,278 @@
 # @socketsecurity/lib
 
 [![Socket Badge](https://socket.dev/api/badge/npm/package/@socketsecurity/lib)](https://socket.dev/npm/package/@socketsecurity/lib)
-[![CI - SocketDev/socket-lib](https://github.com/SocketDev/socket-lib/actions/workflows/ci.yml/badge.svg)](https://github.com/SocketDev/socket-lib/actions/workflows/ci.yml)
-
+[![CI](https://github.com/SocketDev/socket-lib/actions/workflows/ci.yml/badge.svg)](https://github.com/SocketDev/socket-lib/actions/workflows/ci.yml)
 [![Follow @SocketSecurity](https://img.shields.io/twitter/follow/SocketSecurity?style=social)](https://twitter.com/SocketSecurity)
-[![Follow @socket.dev on Bluesky](https://img.shields.io/badge/Follow-@socket.dev-1DA1F2?style=social&logo=bluesky)](https://bsky.app/profile/socket.dev)
 
-> Core utilities, constants, and helper functions for Socket.dev security tools.
+**Core infrastructure library for Socket.dev security tools** — utilities, constants, and helpers with zero dependencies.
 
-## Installation
+## Quick Start
 
 ```bash
-pnpm install @socketsecurity/lib
+pnpm add @socketsecurity/lib
+```
+
+```typescript
+// Import what you need - tree-shakeable exports
+import { Spinner } from '@socketsecurity/lib/spinner'
+import { readJsonFile } from '@socketsecurity/lib/fs'
+import { NODE_MODULES } from '@socketsecurity/lib/constants/packages'
+
+const spinner = Spinner({ text: 'Loading...' })
+spinner.start()
+const pkg = await readJsonFile('./package.json')
+spinner.stop()
 ```
 
-## Features
+## 📦 What's Inside
 
-- **Constants** — Access Node.js, npm, and package manager constants
-- **Type Definitions** — Full TypeScript support with comprehensive type exports
-- **Helper Utilities** — File system, path, package, and process utilities
-- **Environment Variables** — Typed access to environment variables
-- **Effects** — Visual effects for CLI applications
+```
+@socketsecurity/lib
+├── Visual Effects       → Spinners, shimmer, themes, logger
+├── File System          → fs, paths, globs, temp files
+├── Package Management   → npm, pnpm, yarn utilities
+├── Process & Spawn      → Safe process spawning, IPC
+├── Environment          → 68 typed env getters (CI, paths, etc)
+├── Constants            → Node.js, npm, platform constants
+├── Utilities            → Arrays, objects, strings, promises
+└── Types                → Full TypeScript definitions
+```
+
+## 💡 Key Features
 
-## Usage
+### Visual Effects
+
+**Themed spinners and text effects:**
+
+```typescript
+import { Spinner, setTheme } from '@socketsecurity/lib'
+
+setTheme('ultra')  // 🌈 Rainbow mode!
+const spinner = Spinner({ text: 'Processing...' })
+spinner.enableShimmer()
+spinner.start()
+```
+
+**5 Built-in Themes:** `socket` (purple) · `coana` · `socket-firewall` · `socket-cli-python` · `ultra` (rainbow)
+
+👉 [**Theme System Docs**](./docs/themes.md)
+
+### File System
+
+**Safe, typed file operations:**
+
+```typescript
+import { readJsonFile, writeJsonFile } from '@socketsecurity/lib/fs'
+
+const pkg = await readJsonFile<PackageJson>('./package.json')
+await writeJsonFile('./output.json', { data: pkg })
+```
+
+### Package Management
+
+**Parse and validate package specs:**
+
+```typescript
+import { parsePackageSpec } from '@socketsecurity/lib/packages'
+
+const spec = parsePackageSpec('lodash@^4.17.0')
+// { name: 'lodash', version: '^4.17.0', type: 'range', ... }
+```
+
+### Environment Variables
+
+**68 typed environment getters:**
+
+```typescript
+import { getCI } from '@socketsecurity/lib/env/ci'
+import { getHome } from '@socketsecurity/lib/env/home'
+import { getNodeEnv } from '@socketsecurity/lib/env/node-env'
+
+if (getCI()) {
+  console.log('Running in CI')
+}
+```
 
 ### Constants
 
-Import Node.js and package manager constants:
+**Access platform and Node.js constants:**
 
 ```typescript
 import {
   NODE_MODULES,
   PACKAGE_JSON,
-  PNPM_LOCK_YAML,
   NPM_REGISTRY_URL,
 } from '@socketsecurity/lib/constants/packages'
+
+import { DARWIN, WIN32 } from '@socketsecurity/lib/constants/platform'
 ```
 
-### Environment Variables
+## Common Patterns
 
-Access typed environment variables:
+### Spinner with Progress
 
 ```typescript
-import { getEnv } from '@socketsecurity/lib/env/getters'
-import { NODE_ENV } from '@socketsecurity/lib/env/node-env'
+import { withSpinner, Spinner } from '@socketsecurity/lib/spinner'
 
-const env = getEnv('NODE_ENV')
-console.log(NODE_ENV) // 'production' | 'development' | 'test'
+await withSpinner({
+  message: 'Installing packages...',
+  spinner: Spinner({ color: [140, 82, 255] }),
+  operation: async () => {
+    await installPackages()
+  }
+})
 ```
 
-For a complete list of available modules, see the [package.json exports](./package.json).
+### Safe Process Spawning
 
-## Type Definitions
+```typescript
+import { spawn } from '@socketsecurity/lib/spawn'
 
-All types are exported for TypeScript projects:
+const result = await spawn('npm', ['install'], {
+  cwd: '/path/to/project',
+  timeout: 30000
+})
+```
+
+### JSON File Operations
 
 ```typescript
-import type {
-  PackageJson,
-  TsConfig,
-  LockFile,
-} from '@socketsecurity/lib/types'
-```
+import { readJsonFile, writeJsonFile } from '@socketsecurity/lib/fs'
 
-## Utilities
+const data = await readJsonFile('./config.json')
+data.version = '2.0.0'
+await writeJsonFile('./config.json', data)
+```
 
-Access utility modules for common operations:
+### Promise Utilities
 
 ```typescript
-// File system utilities
-import { readJsonFile, writeJsonFile } from '@socketsecurity/lib/fs'
+import { timeout, retry } from '@socketsecurity/lib/promises'
 
-// Package utilities
-import { parsePackageSpec } from '@socketsecurity/lib/packages'
+// Timeout after 5 seconds
+const result = await timeout(fetchData(), 5000)
+
+// Retry up to 3 times
+const data = await retry(() => fetchData(), { maxAttempts: 3 })
+```
+
+## Module Organization
+
+**120+ granular exports** organized by category:
+
+```
+/constants/        → Node.js, npm, platform constants
+  ├─ packages      → PACKAGE_JSON, NODE_MODULES, etc.
+  ├─ platform      → DARWIN, WIN32, S_IXUSR, etc.
+  ├─ node          → NODE_VERSION, NODE_PATH, etc.
+  ├─ time          → MILLISECONDS_PER_*, DLX_BINARY_CACHE_TTL
+  └─ encoding      → UTF8, CHAR_* codes
+
+/env/              → 68 typed environment getters
+  ├─ ci            → getCI() - Detect CI environment
+  ├─ home          → getHome() - User home directory
+  ├─ node-env      → getNodeEnv() - NODE_ENV value
+  └─ ...           → And 65 more!
+
+/packages/         → Package management utilities
+  ├─ validation    → Package name/version validation
+  ├─ operations    → Install, extract, manifest
+  ├─ registry      → npm registry utilities
+  └─ editable      → Editable installs detection
+
+/effects/          → Visual effects for CLI
+  ├─ text-shimmer  → Animated gradient text
+  ├─ pulse-frames  → Pulsing text effect
+  └─ ultra         → Rainbow gradients
 
-// Path utilities
-import { normalizePath } from '@socketsecurity/lib/paths'
+/stdio/            → Terminal I/O utilities
+  ├─ stdout        → Safe stdout operations
+  ├─ stderr        → Safe stderr operations
+  ├─ clear         → Clear terminal
+  └─ footer        → Terminal footers
 
-// And many more...
+/themes/           → Theme system for consistent branding
+  ├─ types         → Theme type definitions
+  ├─ themes        → 5 built-in themes
+  ├─ context       → Global theme management
+  └─ utils         → Color resolution, theme creation
 ```
 
-See the [exports map](./package.json) for all available utility modules.
+## Documentation
+
+| Doc | Description |
+|-----|-------------|
+| [**Getting Started**](./docs/getting-started.md) | Development workflow, commands, architecture |
+| [**Theme System**](./docs/themes.md) | Themed spinners, colors, and effects |
+| [**Build Architecture**](./docs/build.md) | Vendored dependencies, build system |
+| [**CLAUDE.md**](./CLAUDE.md) | Coding standards and patterns |
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────┐
+│  @socketsecurity/lib                                │
+│  Zero runtime dependencies                          │
+├─────────────────────────────────────────────────────┤
+│  src/                                               │
+│  ├── constants/        14 modules                   │
+│  ├── env/              68 getters                   │
+│  ├── packages/         12 utilities                 │
+│  ├── effects/           4 visual effects            │
+│  ├── stdio/             9 I/O utilities             │
+│  ├── themes/            Theme system                │
+│  ├── external/         40+ vendored deps            │
+│  └── ... 60+ more modules                           │
+├─────────────────────────────────────────────────────┤
+│  Build: esbuild → CommonJS (ES2022)                │
+│  Types: tsgo (TypeScript Native Preview)            │
+│  Tests: Vitest (4600+ tests, 100% coverage)        │
+└─────────────────────────────────────────────────────┘
+```
+
+## Development
+
+```bash
+# Setup
+git clone https://github.com/SocketDev/socket-lib.git
+cd socket-lib
+pnpm install
+
+# Build
+pnpm run build       # Production build
+pnpm run dev         # Watch mode
+
+# Test
+pnpm test            # Run all tests
+pnpm run cover       # With coverage
+
+# Quality
+pnpm run check       # Type check
+pnpm run lint        # Lint code
+pnpm run fix         # Auto-fix issues
+```
+
+## Stats
+
+- **183** TypeScript modules
+- **120+** granular exports
+- **68** typed environment getters
+- **14** constant modules
+- **4600+** tests passing
+- **Zero** runtime dependencies
+
+## Contributing
+
+See [CLAUDE.md](./CLAUDE.md) for:
+- Code style and patterns
+- Path alias usage
+- Testing guidelines
+- Build system details
 
 ## License
 
 MIT
+
+---
+
+**Built by Socket.dev** — [socket.dev](https://socket.dev) | [@SocketSecurity](https://twitter.com/SocketSecurity)

package/dist/constants/platform.js

@@ -1,3 +1,3 @@
 /* Socket Lib - Built with esbuild */
-var p=Object.defineProperty;var x=Object.getOwnPropertyDescriptor;var I=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var S=(t,o)=>{for(var n in o)p(t,n,{get:o[n],enumerable:!0})},_=(t,o,n,c)=>{if(o&&typeof o=="object"||typeof o=="function")for(let r of I(o))!m.call(t,r)&&r!==n&&p(t,r,{get:()=>o[r],enumerable:!(c=x(o,r))||c.enumerable});return t};var a=t=>_(p({},"__esModule",{value:!0}),t);var w={};S(w,{DARWIN:()=>f,S_IXGRP:()=>X,S_IXOTH:()=>l,S_IXUSR:()=>R,WIN32:()=>i});module.exports=a(w);var s=require("node:os");const e=(0,s.platform)(),f=e==="darwin",i=e==="win32",R=64,X=8,l=1;0&&(module.exports={DARWIN,S_IXGRP,S_IXOTH,S_IXUSR,WIN32});
+var p=Object.defineProperty;var x=Object.getOwnPropertyDescriptor;var I=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var S=(t,o)=>{for(var n in o)p(t,n,{get:o[n],enumerable:!0})},_=(t,o,n,c)=>{if(o&&typeof o=="object"||typeof o=="function")for(let r of I(o))!m.call(t,r)&&r!==n&&p(t,r,{get:()=>o[r],enumerable:!(c=x(o,r))||c.enumerable});return t};var a=t=>_(p({},"__esModule",{value:!0}),t);var w={};S(w,{DARWIN:()=>f,S_IXGRP:()=>X,S_IXOTH:()=>l,S_IXUSR:()=>R,WIN32:()=>i});module.exports=a(w);var s=require("os");const e=(0,s.platform)(),f=e==="darwin",i=e==="win32",R=64,X=8,l=1;0&&(module.exports={DARWIN,S_IXGRP,S_IXOTH,S_IXUSR,WIN32});
 //# sourceMappingURL=platform.js.map

package/dist/constants/platform.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/constants/platform.ts"],
-  "sourcesContent": ["/**\n * Platform detection and OS-specific constants.\n */\n\nimport { platform } from 'node:os'\n\n// Platform detection.\nconst _platform = platform()\nexport const DARWIN = _platform === 'darwin'\nexport const WIN32 = _platform === 'win32'\n\n// File permission modes.\nexport const S_IXUSR = 0o100\nexport const S_IXGRP = 0o010\nexport const S_IXOTH = 0o001\n"],
-  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,YAAAE,EAAA,YAAAC,EAAA,YAAAC,EAAA,YAAAC,EAAA,UAAAC,IAAA,eAAAC,EAAAP,GAIA,IAAAQ,EAAyB,mBAGzB,MAAMC,KAAY,YAAS,EACdP,EAASO,IAAc,SACvBH,EAAQG,IAAc,QAGtBJ,EAAU,GACVF,EAAU,EACVC,EAAU",
-  "names": ["platform_exports", "__export", "DARWIN", "S_IXGRP", "S_IXOTH", "S_IXUSR", "WIN32", "__toCommonJS", "import_node_os", "_platform"]
+  "sourcesContent": ["/**\n * Platform detection and OS-specific constants.\n */\n\nimport { platform } from 'os'\n\n// Platform detection.\nconst _platform = platform()\nexport const DARWIN = _platform === 'darwin'\nexport const WIN32 = _platform === 'win32'\n\n// File permission modes.\nexport const S_IXUSR = 0o100\nexport const S_IXGRP = 0o010\nexport const S_IXOTH = 0o001\n"],
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,YAAAE,EAAA,YAAAC,EAAA,YAAAC,EAAA,YAAAC,EAAA,UAAAC,IAAA,eAAAC,EAAAP,GAIA,IAAAQ,EAAyB,cAGzB,MAAMC,KAAY,YAAS,EACdP,EAASO,IAAc,SACvBH,EAAQG,IAAc,QAGtBJ,EAAU,GACVF,EAAU,EACVC,EAAU",
+  "names": ["platform_exports", "__export", "DARWIN", "S_IXGRP", "S_IXOTH", "S_IXUSR", "WIN32", "__toCommonJS", "import_os", "_platform"]
 }

package/dist/cover/code.js

@@ -1,3 +1,3 @@
 /* Socket Lib - Built with esbuild */
-var u=Object.defineProperty;var b=Object.getOwnPropertyDescriptor;var w=Object.getOwnPropertyNames;var y=Object.prototype.hasOwnProperty;var O=(e,o)=>{for(var c in o)u(e,c,{get:o[c],enumerable:!0})},j=(e,o,c,n)=>{if(o&&typeof o=="object"||typeof o=="function")for(let a of w(o))!y.call(e,a)&&a!==c&&u(e,a,{get:()=>o[a],enumerable:!(n=b(o,a))||n.enumerable});return e};var E=e=>j(u({},"__esModule",{value:!0}),e);var D={};O(D,{getCodeCoverage:()=>x});module.exports=E(D);var m=require("node:fs"),_=require("../fs"),i=require("../objects"),C=require("../spawn");let v;function M(){return v===void 0&&(v=require("node:path")),v}async function x(e){const c={__proto__:null,coveragePath:M().join(process.cwd(),"coverage/coverage-final.json"),generateIfMissing:!1,...e},{coveragePath:n,generateIfMissing:a}=c;if(!n)throw new Error("Coverage path is required");if(!await m.promises.access(n).then(()=>!0).catch(()=>!1))if(a)await(0,C.spawn)("vitest",["run","--coverage"],{cwd:process.cwd(),stdio:"inherit"});else throw new Error(`Coverage file not found at "${n}". Run tests with coverage first.`);const p=await(0,_.readJson)(n);if(!(0,i.isObjectObject)(p))throw new Error(`Invalid coverage data format in "${n}"`);const t={__proto__:null,branches:{__proto__:null,covered:0,total:0},functions:{__proto__:null,covered:0,total:0},lines:{__proto__:null,covered:0,total:0},statements:{__proto__:null,covered:0,total:0}},h=p;for(const d of Object.values(h)){if(!(0,i.isObjectObject)(d))continue;const r=d;if(r.s&&(0,i.isObjectObject)(r.s)){const f=Object.values(r.s);for(const s of f)typeof s=="number"&&(t.statements.total+=1,s>0&&(t.statements.covered+=1))}if(r.b&&(0,i.isObjectObject)(r.b)){const f=Object.values(r.b);for(const s of f)if(Array.isArray(s))for(const g of s)typeof g=="number"&&(t.branches.total+=1,g>0&&(t.branches.covered+=1))}if(r.f&&(0,i.isObjectObject)(r.f)){const f=Object.values(r.f);for(const s of f)typeof s=="number"&&(t.functions.total+=1,s>0&&(t.functions.covered+=1))}t.lines.covered=t.statements.covered,t.lines.total=t.statements.total}return{branches:l(t.branches),functions:l(t.functions),lines:l(t.lines),statements:l(t.statements)}}function l(e){const o=e.total===0?"0.00":(e.covered/e.total*100).toFixed(2);return{covered:e.covered,percent:o,total:e.total}}0&&(module.exports={getCodeCoverage});
+var u=Object.defineProperty;var b=Object.getOwnPropertyDescriptor;var w=Object.getOwnPropertyNames;var y=Object.prototype.hasOwnProperty;var O=(e,o)=>{for(var c in o)u(e,c,{get:o[c],enumerable:!0})},j=(e,o,c,n)=>{if(o&&typeof o=="object"||typeof o=="function")for(let a of w(o))!y.call(e,a)&&a!==c&&u(e,a,{get:()=>o[a],enumerable:!(n=b(o,a))||n.enumerable});return e};var E=e=>j(u({},"__esModule",{value:!0}),e);var D={};O(D,{getCodeCoverage:()=>x});module.exports=E(D);var m=require("fs"),_=require("../fs"),i=require("../objects"),C=require("../spawn");let v;function M(){return v===void 0&&(v=require("node:path")),v}async function x(e){const c={__proto__:null,coveragePath:M().join(process.cwd(),"coverage/coverage-final.json"),generateIfMissing:!1,...e},{coveragePath:n,generateIfMissing:a}=c;if(!n)throw new Error("Coverage path is required");if(!await m.promises.access(n).then(()=>!0).catch(()=>!1))if(a)await(0,C.spawn)("vitest",["run","--coverage"],{cwd:process.cwd(),stdio:"inherit"});else throw new Error(`Coverage file not found at "${n}". Run tests with coverage first.`);const p=await(0,_.readJson)(n);if(!(0,i.isObjectObject)(p))throw new Error(`Invalid coverage data format in "${n}"`);const t={__proto__:null,branches:{__proto__:null,covered:0,total:0},functions:{__proto__:null,covered:0,total:0},lines:{__proto__:null,covered:0,total:0},statements:{__proto__:null,covered:0,total:0}},h=p;for(const d of Object.values(h)){if(!(0,i.isObjectObject)(d))continue;const r=d;if(r.s&&(0,i.isObjectObject)(r.s)){const f=Object.values(r.s);for(const s of f)typeof s=="number"&&(t.statements.total+=1,s>0&&(t.statements.covered+=1))}if(r.b&&(0,i.isObjectObject)(r.b)){const f=Object.values(r.b);for(const s of f)if(Array.isArray(s))for(const g of s)typeof g=="number"&&(t.branches.total+=1,g>0&&(t.branches.covered+=1))}if(r.f&&(0,i.isObjectObject)(r.f)){const f=Object.values(r.f);for(const s of f)typeof s=="number"&&(t.functions.total+=1,s>0&&(t.functions.covered+=1))}t.lines.covered=t.statements.covered,t.lines.total=t.statements.total}return{branches:l(t.branches),functions:l(t.functions),lines:l(t.lines),statements:l(t.statements)}}function l(e){const o=e.total===0?"0.00":(e.covered/e.total*100).toFixed(2);return{covered:e.covered,percent:o,total:e.total}}0&&(module.exports={getCodeCoverage});
 //# sourceMappingURL=code.js.map

package/dist/cover/code.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/cover/code.ts"],
-  "sourcesContent": ["/**\n * @fileoverview Code coverage utilities for parsing v8 coverage data.\n */\n\nimport { promises as fs } from 'node:fs'\n\nimport { readJson } from '../fs'\nimport { isObjectObject } from '../objects'\nimport { spawn } from '../spawn'\n\nimport type {\n  CodeCoverageResult,\n  CoverageMetric,\n  GetCodeCoverageOptions,\n  V8CoverageData,\n  V8FileCoverage,\n} from './types'\n\nlet _path: typeof import('path') | undefined\n/**\n * Lazily load the path module to avoid Webpack errors.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getPath() {\n  if (_path === undefined) {\n    // Use non-'node:' prefixed require to avoid Webpack errors.\n\n    _path = /*@__PURE__*/ require('node:path')\n  }\n  return _path as typeof import('path')\n}\n\n/**\n * Get code coverage metrics from v8 coverage-final.json.\n *\n * @throws {Error} When coverage file doesn't exist and generateIfMissing is false.\n * @throws {Error} When coverage data format is invalid.\n */\nexport async function getCodeCoverage(\n  options?: GetCodeCoverageOptions | undefined,\n): Promise<CodeCoverageResult> {\n  const path = getPath()\n  const opts = {\n    __proto__: null,\n    coveragePath: path.join(process.cwd(), 'coverage/coverage-final.json'),\n    generateIfMissing: false,\n    ...options,\n  } as GetCodeCoverageOptions\n\n  const { coveragePath, generateIfMissing } = opts\n\n  if (!coveragePath) {\n    throw new Error('Coverage path is required')\n  }\n\n  // Check if coverage file exists.\n  const coverageExists = await fs\n    .access(coveragePath)\n    .then(() => true)\n    .catch(() => false)\n\n  if (!coverageExists) {\n    if (generateIfMissing) {\n      // Run vitest to generate coverage.\n      await spawn('vitest', ['run', '--coverage'], {\n        cwd: process.cwd(),\n        stdio: 'inherit',\n      })\n    } else {\n      throw new Error(\n        `Coverage file not found at \"${coveragePath}\". Run tests with coverage first.`,\n      )\n    }\n  }\n\n  // Read and parse coverage-final.json.\n  const coverageData = (await readJson(coveragePath)) as unknown\n\n  if (!isObjectObject(coverageData)) {\n    throw new Error(`Invalid coverage data format in \"${coveragePath}\"`)\n  }\n\n  // Aggregate metrics across all files.\n  const totals = {\n    __proto__: null,\n    branches: { __proto__: null, covered: 0, total: 0 },\n    functions: { __proto__: null, covered: 0, total: 0 },\n    lines: { __proto__: null, covered: 0, total: 0 },\n    statements: { __proto__: null, covered: 0, total: 0 },\n  }\n\n  const v8Data = coverageData as V8CoverageData\n\n  for (const fileCoverage of Object.values(v8Data)) {\n    if (!isObjectObject(fileCoverage)) {\n      continue\n    }\n\n    const fc = fileCoverage as V8FileCoverage\n\n    // Aggregate statements.\n    if (fc.s && isObjectObject(fc.s)) {\n      const statementCounts = Object.values(fc.s)\n      for (const count of statementCounts) {\n        if (typeof count === 'number') {\n          totals.statements.total += 1\n          if (count > 0) {\n            totals.statements.covered += 1\n          }\n        }\n      }\n    }\n\n    // Aggregate branches.\n    if (fc.b && isObjectObject(fc.b)) {\n      const branchCounts = Object.values(fc.b)\n      for (const branches of branchCounts) {\n        if (Array.isArray(branches)) {\n          for (const count of branches) {\n            if (typeof count === 'number') {\n              totals.branches.total += 1\n              if (count > 0) {\n                totals.branches.covered += 1\n              }\n            }\n          }\n        }\n      }\n    }\n\n    // Aggregate functions.\n    if (fc.f && isObjectObject(fc.f)) {\n      const functionCounts = Object.values(fc.f)\n      for (const count of functionCounts) {\n        if (typeof count === 'number') {\n          totals.functions.total += 1\n          if (count > 0) {\n            totals.functions.covered += 1\n          }\n        }\n      }\n    }\n\n    // Note: Lines are typically derived from statement map in v8.\n    // For simplicity, we use statements as a proxy for lines.\n    // In a production implementation, you'd parse statementMap to get actual line coverage.\n    totals.lines.covered = totals.statements.covered\n    totals.lines.total = totals.statements.total\n  }\n\n  // Calculate percentages.\n  return {\n    branches: calculateMetric(totals.branches),\n    functions: calculateMetric(totals.functions),\n    lines: calculateMetric(totals.lines),\n    statements: calculateMetric(totals.statements),\n  }\n}\n\n/**\n * Calculate coverage metric with percentage.\n */\nfunction calculateMetric(data: {\n  covered: number\n  total: number\n}): CoverageMetric {\n  const percent =\n    data.total === 0 ? '0.00' : ((data.covered / data.total) * 100).toFixed(2)\n\n  return {\n    covered: data.covered,\n    percent,\n    total: data.total,\n  }\n}\n"],
-  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,qBAAAE,IAAA,eAAAC,EAAAH,GAIA,IAAAI,EAA+B,mBAE/BC,EAAyB,iBACzBC,EAA+B,sBAC/BC,EAAsB,oBAUtB,IAAIC,EAMJ,SAASC,GAAU,CACjB,OAAID,IAAU,SAGZA,EAAsB,QAAQ,WAAW,GAEpCA,CACT,CAQA,eAAsBN,EACpBQ,EAC6B,CAE7B,MAAMC,EAAO,CACX,UAAW,KACX,aAHWF,EAAQ,EAGA,KAAK,QAAQ,IAAI,EAAG,8BAA8B,EACrE,kBAAmB,GACnB,GAAGC,CACL,EAEM,CAAE,aAAAE,EAAc,kBAAAC,CAAkB,EAAIF,EAE5C,GAAI,CAACC,EACH,MAAM,IAAI,MAAM,2BAA2B,EAS7C,GAAI,CALmB,MAAM,EAAAE,SAC1B,OAAOF,CAAY,EACnB,KAAK,IAAM,EAAI,EACf,MAAM,IAAM,EAAK,EAGlB,GAAIC,EAEF,QAAM,SAAM,SAAU,CAAC,MAAO,YAAY,EAAG,CAC3C,IAAK,QAAQ,IAAI,EACjB,MAAO,SACT,CAAC,MAED,OAAM,IAAI,MACR,+BAA+BD,CAAY,mCAC7C,EAKJ,MAAMG,EAAgB,QAAM,YAASH,CAAY,EAEjD,GAAI,IAAC,kBAAeG,CAAY,EAC9B,MAAM,IAAI,MAAM,oCAAoCH,CAAY,GAAG,EAIrE,MAAMI,EAAS,CACb,UAAW,KACX,SAAU,CAAE,UAAW,KAAM,QAAS,EAAG,MAAO,CAAE,EAClD,UAAW,CAAE,UAAW,KAAM,QAAS,EAAG,MAAO,CAAE,EACnD,MAAO,CAAE,UAAW,KAAM,QAAS,EAAG,MAAO,CAAE,EAC/C,WAAY,CAAE,UAAW,KAAM,QAAS,EAAG,MAAO,CAAE,CACtD,EAEMC,EAASF,EAEf,UAAWG,KAAgB,OAAO,OAAOD,CAAM,EAAG,CAChD,GAAI,IAAC,kBAAeC,CAAY,EAC9B,SAGF,MAAMC,EAAKD,EAGX,GAAIC,EAAG,MAAK,kBAAeA,EAAG,CAAC,EAAG,CAChC,MAAMC,EAAkB,OAAO,OAAOD,EAAG,CAAC,EAC1C,UAAWE,KAASD,EACd,OAAOC,GAAU,WACnBL,EAAO,WAAW,OAAS,EACvBK,EAAQ,IACVL,EAAO,WAAW,SAAW,GAIrC,CAGA,GAAIG,EAAG,MAAK,kBAAeA,EAAG,CAAC,EAAG,CAChC,MAAMG,EAAe,OAAO,OAAOH,EAAG,CAAC,EACvC,UAAWI,KAAYD,EACrB,GAAI,MAAM,QAAQC,CAAQ,EACxB,UAAWF,KAASE,EACd,OAAOF,GAAU,WACnBL,EAAO,SAAS,OAAS,EACrBK,EAAQ,IACVL,EAAO,SAAS,SAAW,GAMvC,CAGA,GAAIG,EAAG,MAAK,kBAAeA,EAAG,CAAC,EAAG,CAChC,MAAMK,EAAiB,OAAO,OAAOL,EAAG,CAAC,EACzC,UAAWE,KAASG,EACd,OAAOH,GAAU,WACnBL,EAAO,UAAU,OAAS,EACtBK,EAAQ,IACVL,EAAO,UAAU,SAAW,GAIpC,CAKAA,EAAO,MAAM,QAAUA,EAAO,WAAW,QACzCA,EAAO,MAAM,MAAQA,EAAO,WAAW,KACzC,CAGA,MAAO,CACL,SAAUS,EAAgBT,EAAO,QAAQ,EACzC,UAAWS,EAAgBT,EAAO,SAAS,EAC3C,MAAOS,EAAgBT,EAAO,KAAK,EACnC,WAAYS,EAAgBT,EAAO,UAAU,CAC/C,CACF,CAKA,SAASS,EAAgBC,EAGN,CACjB,MAAMC,EACJD,EAAK,QAAU,EAAI,QAAWA,EAAK,QAAUA,EAAK,MAAS,KAAK,QAAQ,CAAC,EAE3E,MAAO,CACL,QAASA,EAAK,QACd,QAAAC,EACA,MAAOD,EAAK,KACd,CACF",
-  "names": ["code_exports", "__export", "getCodeCoverage", "__toCommonJS", "import_node_fs", "import_fs", "import_objects", "import_spawn", "_path", "getPath", "options", "opts", "coveragePath", "generateIfMissing", "fs", "coverageData", "totals", "v8Data", "fileCoverage", "fc", "statementCounts", "count", "branchCounts", "branches", "functionCounts", "calculateMetric", "data", "percent"]
+  "sourcesContent": ["/**\n * @fileoverview Code coverage utilities for parsing v8 coverage data.\n */\n\nimport { promises as fs } from 'fs'\n\nimport { readJson } from '../fs'\nimport { isObjectObject } from '../objects'\nimport { spawn } from '../spawn'\n\nimport type {\n  CodeCoverageResult,\n  CoverageMetric,\n  GetCodeCoverageOptions,\n  V8CoverageData,\n  V8FileCoverage,\n} from './types'\n\nlet _path: typeof import('path') | undefined\n/**\n * Lazily load the path module to avoid Webpack errors.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getPath() {\n  if (_path === undefined) {\n    // Use non-'node:' prefixed require to avoid Webpack errors.\n\n    _path = /*@__PURE__*/ require('node:path')\n  }\n  return _path as typeof import('path')\n}\n\n/**\n * Get code coverage metrics from v8 coverage-final.json.\n *\n * @throws {Error} When coverage file doesn't exist and generateIfMissing is false.\n * @throws {Error} When coverage data format is invalid.\n */\nexport async function getCodeCoverage(\n  options?: GetCodeCoverageOptions | undefined,\n): Promise<CodeCoverageResult> {\n  const path = getPath()\n  const opts = {\n    __proto__: null,\n    coveragePath: path.join(process.cwd(), 'coverage/coverage-final.json'),\n    generateIfMissing: false,\n    ...options,\n  } as GetCodeCoverageOptions\n\n  const { coveragePath, generateIfMissing } = opts\n\n  if (!coveragePath) {\n    throw new Error('Coverage path is required')\n  }\n\n  // Check if coverage file exists.\n  const coverageExists = await fs\n    .access(coveragePath)\n    .then(() => true)\n    .catch(() => false)\n\n  if (!coverageExists) {\n    if (generateIfMissing) {\n      // Run vitest to generate coverage.\n      await spawn('vitest', ['run', '--coverage'], {\n        cwd: process.cwd(),\n        stdio: 'inherit',\n      })\n    } else {\n      throw new Error(\n        `Coverage file not found at \"${coveragePath}\". Run tests with coverage first.`,\n      )\n    }\n  }\n\n  // Read and parse coverage-final.json.\n  const coverageData = (await readJson(coveragePath)) as unknown\n\n  if (!isObjectObject(coverageData)) {\n    throw new Error(`Invalid coverage data format in \"${coveragePath}\"`)\n  }\n\n  // Aggregate metrics across all files.\n  const totals = {\n    __proto__: null,\n    branches: { __proto__: null, covered: 0, total: 0 },\n    functions: { __proto__: null, covered: 0, total: 0 },\n    lines: { __proto__: null, covered: 0, total: 0 },\n    statements: { __proto__: null, covered: 0, total: 0 },\n  }\n\n  const v8Data = coverageData as V8CoverageData\n\n  for (const fileCoverage of Object.values(v8Data)) {\n    if (!isObjectObject(fileCoverage)) {\n      continue\n    }\n\n    const fc = fileCoverage as V8FileCoverage\n\n    // Aggregate statements.\n    if (fc.s && isObjectObject(fc.s)) {\n      const statementCounts = Object.values(fc.s)\n      for (const count of statementCounts) {\n        if (typeof count === 'number') {\n          totals.statements.total += 1\n          if (count > 0) {\n            totals.statements.covered += 1\n          }\n        }\n      }\n    }\n\n    // Aggregate branches.\n    if (fc.b && isObjectObject(fc.b)) {\n      const branchCounts = Object.values(fc.b)\n      for (const branches of branchCounts) {\n        if (Array.isArray(branches)) {\n          for (const count of branches) {\n            if (typeof count === 'number') {\n              totals.branches.total += 1\n              if (count > 0) {\n                totals.branches.covered += 1\n              }\n            }\n          }\n        }\n      }\n    }\n\n    // Aggregate functions.\n    if (fc.f && isObjectObject(fc.f)) {\n      const functionCounts = Object.values(fc.f)\n      for (const count of functionCounts) {\n        if (typeof count === 'number') {\n          totals.functions.total += 1\n          if (count > 0) {\n            totals.functions.covered += 1\n          }\n        }\n      }\n    }\n\n    // Note: Lines are typically derived from statement map in v8.\n    // For simplicity, we use statements as a proxy for lines.\n    // In a production implementation, you'd parse statementMap to get actual line coverage.\n    totals.lines.covered = totals.statements.covered\n    totals.lines.total = totals.statements.total\n  }\n\n  // Calculate percentages.\n  return {\n    branches: calculateMetric(totals.branches),\n    functions: calculateMetric(totals.functions),\n    lines: calculateMetric(totals.lines),\n    statements: calculateMetric(totals.statements),\n  }\n}\n\n/**\n * Calculate coverage metric with percentage.\n */\nfunction calculateMetric(data: {\n  covered: number\n  total: number\n}): CoverageMetric {\n  const percent =\n    data.total === 0 ? '0.00' : ((data.covered / data.total) * 100).toFixed(2)\n\n  return {\n    covered: data.covered,\n    percent,\n    total: data.total,\n  }\n}\n"],
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,qBAAAE,IAAA,eAAAC,EAAAH,GAIA,IAAAI,EAA+B,cAE/BA,EAAyB,iBACzBC,EAA+B,sBAC/BC,EAAsB,oBAUtB,IAAIC,EAMJ,SAASC,GAAU,CACjB,OAAID,IAAU,SAGZA,EAAsB,QAAQ,WAAW,GAEpCA,CACT,CAQA,eAAsBL,EACpBO,EAC6B,CAE7B,MAAMC,EAAO,CACX,UAAW,KACX,aAHWF,EAAQ,EAGA,KAAK,QAAQ,IAAI,EAAG,8BAA8B,EACrE,kBAAmB,GACnB,GAAGC,CACL,EAEM,CAAE,aAAAE,EAAc,kBAAAC,CAAkB,EAAIF,EAE5C,GAAI,CAACC,EACH,MAAM,IAAI,MAAM,2BAA2B,EAS7C,GAAI,CALmB,MAAM,EAAAE,SAC1B,OAAOF,CAAY,EACnB,KAAK,IAAM,EAAI,EACf,MAAM,IAAM,EAAK,EAGlB,GAAIC,EAEF,QAAM,SAAM,SAAU,CAAC,MAAO,YAAY,EAAG,CAC3C,IAAK,QAAQ,IAAI,EACjB,MAAO,SACT,CAAC,MAED,OAAM,IAAI,MACR,+BAA+BD,CAAY,mCAC7C,EAKJ,MAAMG,EAAgB,QAAM,YAASH,CAAY,EAEjD,GAAI,IAAC,kBAAeG,CAAY,EAC9B,MAAM,IAAI,MAAM,oCAAoCH,CAAY,GAAG,EAIrE,MAAMI,EAAS,CACb,UAAW,KACX,SAAU,CAAE,UAAW,KAAM,QAAS,EAAG,MAAO,CAAE,EAClD,UAAW,CAAE,UAAW,KAAM,QAAS,EAAG,MAAO,CAAE,EACnD,MAAO,CAAE,UAAW,KAAM,QAAS,EAAG,MAAO,CAAE,EAC/C,WAAY,CAAE,UAAW,KAAM,QAAS,EAAG,MAAO,CAAE,CACtD,EAEMC,EAASF,EAEf,UAAWG,KAAgB,OAAO,OAAOD,CAAM,EAAG,CAChD,GAAI,IAAC,kBAAeC,CAAY,EAC9B,SAGF,MAAMC,EAAKD,EAGX,GAAIC,EAAG,MAAK,kBAAeA,EAAG,CAAC,EAAG,CAChC,MAAMC,EAAkB,OAAO,OAAOD,EAAG,CAAC,EAC1C,UAAWE,KAASD,EACd,OAAOC,GAAU,WACnBL,EAAO,WAAW,OAAS,EACvBK,EAAQ,IACVL,EAAO,WAAW,SAAW,GAIrC,CAGA,GAAIG,EAAG,MAAK,kBAAeA,EAAG,CAAC,EAAG,CAChC,MAAMG,EAAe,OAAO,OAAOH,EAAG,CAAC,EACvC,UAAWI,KAAYD,EACrB,GAAI,MAAM,QAAQC,CAAQ,EACxB,UAAWF,KAASE,EACd,OAAOF,GAAU,WACnBL,EAAO,SAAS,OAAS,EACrBK,EAAQ,IACVL,EAAO,SAAS,SAAW,GAMvC,CAGA,GAAIG,EAAG,MAAK,kBAAeA,EAAG,CAAC,EAAG,CAChC,MAAMK,EAAiB,OAAO,OAAOL,EAAG,CAAC,EACzC,UAAWE,KAASG,EACd,OAAOH,GAAU,WACnBL,EAAO,UAAU,OAAS,EACtBK,EAAQ,IACVL,EAAO,UAAU,SAAW,GAIpC,CAKAA,EAAO,MAAM,QAAUA,EAAO,WAAW,QACzCA,EAAO,MAAM,MAAQA,EAAO,WAAW,KACzC,CAGA,MAAO,CACL,SAAUS,EAAgBT,EAAO,QAAQ,EACzC,UAAWS,EAAgBT,EAAO,SAAS,EAC3C,MAAOS,EAAgBT,EAAO,KAAK,EACnC,WAAYS,EAAgBT,EAAO,UAAU,CAC/C,CACF,CAKA,SAASS,EAAgBC,EAGN,CACjB,MAAMC,EACJD,EAAK,QAAU,EAAI,QAAWA,EAAK,QAAUA,EAAK,MAAS,KAAK,QAAQ,CAAC,EAE3E,MAAO,CACL,QAASA,EAAK,QACd,QAAAC,EACA,MAAOD,EAAK,KACd,CACF",
+  "names": ["code_exports", "__export", "getCodeCoverage", "__toCommonJS", "import_fs", "import_objects", "import_spawn", "_path", "getPath", "options", "opts", "coveragePath", "generateIfMissing", "fs", "coverageData", "totals", "v8Data", "fileCoverage", "fc", "statementCounts", "count", "branchCounts", "branches", "functionCounts", "calculateMetric", "data", "percent"]
 }

package/dist/debug.js

@@ -1,4 +1,4 @@
 /* Socket Lib - Built with esbuild */
-var U=Object.create;var h=Object.defineProperty;var j=Object.getOwnPropertyDescriptor;var G=Object.getOwnPropertyNames;var L=Object.getPrototypeOf,T=Object.prototype.hasOwnProperty;var W=(n,t)=>{for(var e in t)h(n,e,{get:t[e],enumerable:!0})},S=(n,t,e,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of G(t))!T.call(n,o)&&o!==e&&h(n,o,{get:()=>t[o],enumerable:!(i=j(t,o))||i.enumerable});return n};var I=(n,t,e)=>(e=n!=null?U(L(n)):{},S(t||!n||!n.__esModule?h(e,"default",{value:n,enumerable:!0}):e,n)),J=n=>S(h({},"__esModule",{value:!0}),n);var Y={};W(Y,{debug:()=>z,debugCache:()=>M,debugCacheNs:()=>q,debugDir:()=>F,debugDirNs:()=>v,debugLog:()=>K,debugLogNs:()=>B,debugNs:()=>A,debuglog:()=>V,debugtime:()=>X,isDebug:()=>Q,isDebugNs:()=>P});module.exports=J(Y);var m=require("#constants/process"),E=require("#env/debug"),a=require("#env/socket"),g=I(require("./external/@socketregistry/is-unicode-supported")),f=I(require("./external/debug")),d=require("./logger"),H=require("./objects"),D=require("./strings");const $=Reflect.apply,_=new Map;function C(n){let t=_.get(n);return t||(!(0,E.getDebug)()&&(0,a.getSocketDebug)()&&(n==="error"||n==="notice")&&f.default.enable(n),t=(0,f.default)(n),t.log=R,_.set(n,t),t)}let x;function N(){return x===void 0&&(x=require("node:util")),x}function b(n=3){let t="";const e=Error.captureStackTrace;if(typeof e=="function"){const i={};e(i,b);const o=i.stack;if(typeof o=="string"){let u=0,c=0;for(let s=0,{length:l}=o;s<l;s+=1)if(o[s]===`
-`)if(u+=1,u<n)c=s+1;else{const r=o.slice(c,s).trimStart(),w=/(?<=^at\s+).*?(?=\s+\(|$)/.exec(r)?.[0];if(w&&(t=w.replace(/^(?:async|bound|get|new|set)\s+/,""),t.startsWith("Object."))){const k=t.slice(7);(0,H.hasOwn)(Object,k)||(t=k)}break}}}return t}function R(...n){const t=N(),e=f.default.inspectOpts?{...f.default.inspectOpts,showHidden:f.default.inspectOpts.showHidden===null?void 0:f.default.inspectOpts.showHidden,depth:f.default.inspectOpts.depth===null||typeof f.default.inspectOpts.depth=="boolean"?void 0:f.default.inspectOpts.depth}:{};$(d.logger.info,d.logger,[t.formatWithOptions(e,...n)])}function y(n){return n!==null&&typeof n=="object"?{__proto__:null,...n}:{__proto__:null,namespaces:n}}function O(n){if(!(0,a.getSocketDebug)())return!1;if(typeof n!="string"||!n||n==="*")return!0;const t=n.trim().replace(/\s+/g,",").split(",").filter(Boolean),e=[],i=[];for(const o of t)o.startsWith("-")?i.push(o.slice(1)):e.push(o);return e.length&&!e.some(o=>C(o).enabled)?!1:i.every(o=>!C(o).enabled)}function v(n,t,e){const i=y(n),{namespaces:o}=i;if(!O(o))return;const u=b(4)||"anonymous";p===void 0&&(p=(0,g.default)()?"\u25B8":">");let c=e;if(c===void 0){const r=f.default.inspectOpts;r&&(c={...r,showHidden:r.showHidden===null?void 0:r.showHidden,depth:r.depth===null||typeof r.depth=="boolean"?null:r.depth})}const s=i.spinner||(0,m.getSpinner)(),l=s?.isSpinning;s?.stop(),d.logger.info(`[DEBUG] ${u} ${p} object inspection:`),d.logger.dir(t,e),l&&s?.start()}let p;function A(n,...t){const e=y(n),{namespaces:i}=e;if(!O(i))return;const o=b(4)||"anonymous";p===void 0&&(p=(0,g.default)()?"\u25B8":">");const u=t.at(0),c=typeof u=="string"?[(0,D.applyLinePrefix)(`${o?`${o} ${p} `:""}${u}`,{prefix:"[DEBUG] "}),...t.slice(1)]:t,s=e.spinner||(0,m.getSpinner)(),l=s?.isSpinning;s?.stop(),$(d.logger.info,d.logger,c),l&&s?.start()}function B(n,...t){const e=y(n),{namespaces:i}=e;if(!O(i))return;const o=b(4)||"anonymous";p===void 0&&(p=(0,g.default)()?"\u25B8":">");const u=t.at(0),c=typeof u=="string"?[(0,D.applyLinePrefix)(`${o?`${o} ${p} `:""}${u}`,{prefix:"[DEBUG] "}),...t.slice(1)]:[`[DEBUG] ${o} ${p}`,...t],s=e.spinner||(0,m.getSpinner)(),l=s?.isSpinning;s?.stop(),$(d.logger.info,d.logger,c),l&&s?.start()}function q(n,t,e,i){const o=y(n),{namespaces:u}=o;if(!O(u))return;const c=b(4)||"cache";p===void 0&&(p=(0,g.default)()?"\u25B8":">");const s=`[CACHE] ${c} ${p} ${t}: ${e}`,l=i!==void 0?[s,i]:[s],r=o.spinner||(0,m.getSpinner)(),w=r?.isSpinning;r?.stop(),$(d.logger.info,d.logger,l),w&&r?.start()}function M(n,t,e){if(!(0,a.getSocketDebug)())return;const i=b(3)||"cache";p===void 0&&(p=(0,g.default)()?"\u25B8":">");const o=`[CACHE] ${i} ${p} ${n}: ${t}`;console.log(...e!==void 0?[o,e]:[o])}function P(n){return!!(0,a.getSocketDebug)()&&O(n)}function z(...n){A("*",...n)}function F(n,t){v("*",n,t)}function K(...n){B("*",...n)}function Q(){return!!(0,a.getSocketDebug)()}function V(n){return N().debuglog(n)}function X(n){const t=N();let e;const i=()=>{if(e===void 0)e=Date.now();else{const o=Date.now()-e;t.debuglog("time")(`${n}: ${o}ms`),e=void 0}};return i.start=()=>{e=Date.now()},i.end=()=>{if(e!==void 0){const o=Date.now()-e;t.debuglog("time")(`${n}: ${o}ms`),e=void 0}},i}0&&(module.exports={debug,debugCache,debugCacheNs,debugDir,debugDirNs,debugLog,debugLogNs,debugNs,debuglog,debugtime,isDebug,isDebugNs});
+var j=Object.create;var h=Object.defineProperty;var L=Object.getOwnPropertyDescriptor;var G=Object.getOwnPropertyNames;var T=Object.getPrototypeOf,W=Object.prototype.hasOwnProperty;var J=(n,t)=>{for(var e in t)h(n,e,{get:t[e],enumerable:!0})},S=(n,t,e,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of G(t))!W.call(n,o)&&o!==e&&h(n,o,{get:()=>t[o],enumerable:!(i=L(t,o))||i.enumerable});return n};var I=(n,t,e)=>(e=n!=null?j(T(n)):{},S(t||!n||!n.__esModule?h(e,"default",{value:n,enumerable:!0}):e,n)),R=n=>S(h({},"__esModule",{value:!0}),n);var Z={};J(Z,{debug:()=>F,debugCache:()=>P,debugCacheNs:()=>M,debugDir:()=>K,debugDirNs:()=>A,debugLog:()=>Q,debugLogNs:()=>U,debugNs:()=>B,debuglog:()=>X,debugtime:()=>Y,isDebug:()=>V,isDebugNs:()=>z});module.exports=R(Z);var m=require("#constants/process"),E=require("#env/debug"),a=require("#env/socket"),g=I(require("./external/@socketregistry/is-unicode-supported")),f=I(require("./external/debug")),H=require("./logger"),v=require("./objects"),x=require("./strings");const d=(0,H.getDefaultLogger)(),$=Reflect.apply,_=new Map;function C(n){let t=_.get(n);return t||(!(0,E.getDebug)()&&(0,a.getSocketDebug)()&&(n==="error"||n==="notice")&&f.default.enable(n),t=(0,f.default)(n),t.log=q,_.set(n,t),t)}let k;function N(){return k===void 0&&(k=require("node:util")),k}function b(n=3){let t="";const e=Error.captureStackTrace;if(typeof e=="function"){const i={};e(i,b);const o=i.stack;if(typeof o=="string"){let u=0,c=0;for(let s=0,{length:l}=o;s<l;s+=1)if(o[s]===`
+`)if(u+=1,u<n)c=s+1;else{const r=o.slice(c,s).trimStart(),w=/(?<=^at\s+).*?(?=\s+\(|$)/.exec(r)?.[0];if(w&&(t=w.replace(/^(?:async|bound|get|new|set)\s+/,""),t.startsWith("Object."))){const D=t.slice(7);(0,v.hasOwn)(Object,D)||(t=D)}break}}}return t}function q(...n){const t=N(),e=f.default.inspectOpts?{...f.default.inspectOpts,showHidden:f.default.inspectOpts.showHidden===null?void 0:f.default.inspectOpts.showHidden,depth:f.default.inspectOpts.depth===null||typeof f.default.inspectOpts.depth=="boolean"?void 0:f.default.inspectOpts.depth}:{};$(d.info,d,[t.formatWithOptions(e,...n)])}function y(n){return n!==null&&typeof n=="object"?{__proto__:null,...n}:{__proto__:null,namespaces:n}}function O(n){if(!(0,a.getSocketDebug)())return!1;if(typeof n!="string"||!n||n==="*")return!0;const t=n.trim().replace(/\s+/g,",").split(",").filter(Boolean),e=[],i=[];for(const o of t)o.startsWith("-")?i.push(o.slice(1)):e.push(o);return e.length&&!e.some(o=>C(o).enabled)?!1:i.every(o=>!C(o).enabled)}function A(n,t,e){const i=y(n),{namespaces:o}=i;if(!O(o))return;const u=b(4)||"anonymous";p===void 0&&(p=(0,g.default)()?"\u25B8":">");let c=e;if(c===void 0){const r=f.default.inspectOpts;r&&(c={...r,showHidden:r.showHidden===null?void 0:r.showHidden,depth:r.depth===null||typeof r.depth=="boolean"?null:r.depth})}const s=i.spinner||(0,m.getSpinner)(),l=s?.isSpinning;s?.stop(),d.info(`[DEBUG] ${u} ${p} object inspection:`),d.dir(t,e),l&&s?.start()}let p;function B(n,...t){const e=y(n),{namespaces:i}=e;if(!O(i))return;const o=b(4)||"anonymous";p===void 0&&(p=(0,g.default)()?"\u25B8":">");const u=t.at(0),c=typeof u=="string"?[(0,x.applyLinePrefix)(`${o?`${o} ${p} `:""}${u}`,{prefix:"[DEBUG] "}),...t.slice(1)]:t,s=e.spinner||(0,m.getSpinner)(),l=s?.isSpinning;s?.stop(),$(d.info,d,c),l&&s?.start()}function U(n,...t){const e=y(n),{namespaces:i}=e;if(!O(i))return;const o=b(4)||"anonymous";p===void 0&&(p=(0,g.default)()?"\u25B8":">");const u=t.at(0),c=typeof u=="string"?[(0,x.applyLinePrefix)(`${o?`${o} ${p} `:""}${u}`,{prefix:"[DEBUG] "}),...t.slice(1)]:[`[DEBUG] ${o} ${p}`,...t],s=e.spinner||(0,m.getSpinner)(),l=s?.isSpinning;s?.stop(),$(d.info,d,c),l&&s?.start()}function M(n,t,e,i){const o=y(n),{namespaces:u}=o;if(!O(u))return;const c=b(4)||"cache";p===void 0&&(p=(0,g.default)()?"\u25B8":">");const s=`[CACHE] ${c} ${p} ${t}: ${e}`,l=i!==void 0?[s,i]:[s],r=o.spinner||(0,m.getSpinner)(),w=r?.isSpinning;r?.stop(),$(d.info,d,l),w&&r?.start()}function P(n,t,e){if(!(0,a.getSocketDebug)())return;const i=b(3)||"cache";p===void 0&&(p=(0,g.default)()?"\u25B8":">");const o=`[CACHE] ${i} ${p} ${n}: ${t}`;console.log(...e!==void 0?[o,e]:[o])}function z(n){return!!(0,a.getSocketDebug)()&&O(n)}function F(...n){B("*",...n)}function K(n,t){A("*",n,t)}function Q(...n){U("*",...n)}function V(){return!!(0,a.getSocketDebug)()}function X(n){return N().debuglog(n)}function Y(n){const t=N();let e;const i=()=>{if(e===void 0)e=Date.now();else{const o=Date.now()-e;t.debuglog("time")(`${n}: ${o}ms`),e=void 0}};return i.start=()=>{e=Date.now()},i.end=()=>{if(e!==void 0){const o=Date.now()-e;t.debuglog("time")(`${n}: ${o}ms`),e=void 0}},i}0&&(module.exports={debug,debugCache,debugCacheNs,debugDir,debugDirNs,debugLog,debugLogNs,debugNs,debuglog,debugtime,isDebug,isDebugNs});
 //# sourceMappingURL=debug.js.map

package/dist/debug.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/debug.ts"],
-  "sourcesContent": ["/**\n * @fileoverview Debug logging utilities with lazy loading and environment-based control.\n * Provides Socket CLI specific debug functionality and logging formatters.\n */\n\nimport { getSpinner } from '#constants/process'\nimport { getDebug } from '#env/debug'\nimport { getSocketDebug } from '#env/socket'\nimport isUnicodeSupported from './external/@socketregistry/is-unicode-supported'\nimport debugJs from './external/debug'\n\nimport { logger } from './logger'\nimport { hasOwn } from './objects'\nimport { applyLinePrefix } from './strings'\n\n// IMPORTANT: Do not use destructuring here - use direct assignment instead.\n// tsgo has a bug that incorrectly transpiles destructured exports, resulting in\n// `exports.SomeName = void 0;` which causes runtime errors.\n// See: https://github.com/SocketDev/socket-packageurl-js/issues/3\nconst ReflectApply = Reflect.apply\n\n// Type definitions\ninterface DebugOptions {\n  namespaces?: string\n  spinner?: { isSpinning: boolean; stop(): void; start(): void }\n  [key: string]: unknown\n}\n\ntype NamespacesOrOptions = string | DebugOptions\n\ninterface InspectOptions {\n  depth?: number | null\n  colors?: boolean\n  [key: string]: unknown\n}\n\nexport type { DebugOptions, NamespacesOrOptions, InspectOptions }\n\nconst debugByNamespace = new Map()\n/**\n * Get or create a debug instance for a namespace.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getDebugJsInstance(namespace: string) {\n  let inst = debugByNamespace.get(namespace)\n  if (inst) {\n    return inst\n  }\n  if (\n    !getDebug() &&\n    getSocketDebug() &&\n    (namespace === 'error' || namespace === 'notice')\n  ) {\n    debugJs.enable(namespace)\n  }\n  inst = debugJs(namespace)\n  inst.log = customLog\n  debugByNamespace.set(namespace, inst)\n  return inst\n}\n\nlet _util: typeof import('util') | undefined\n/**\n * Lazily load the util module.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getUtil() {\n  if (_util === undefined) {\n    // Use non-'node:' prefixed require to avoid Webpack errors.\n\n    _util = /*@__PURE__*/ require('node:util')\n  }\n  return _util as typeof import('util')\n}\n\n/**\n * Extract caller information from the stack trace.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getCallerInfo(stackOffset: number = 3): string {\n  let name = ''\n  const captureStackTrace = Error.captureStackTrace\n  if (typeof captureStackTrace === 'function') {\n    const obj: { stack?: unknown } = {}\n    captureStackTrace(obj, getCallerInfo)\n    const stack = obj.stack\n    if (typeof stack === 'string') {\n      let lineCount = 0\n      let lineStart = 0\n      for (let i = 0, { length } = stack; i < length; i += 1) {\n        if (stack[i] === '\\n') {\n          lineCount += 1\n          if (lineCount < stackOffset) {\n            // Store the start index of the next line.\n            lineStart = i + 1\n          } else {\n            // Extract the full line and trim it.\n            const line = stack.slice(lineStart, i).trimStart()\n            // Match the function name portion (e.g., \"async runFix\").\n            const match = /(?<=^at\\s+).*?(?=\\s+\\(|$)/.exec(line)?.[0]\n            if (match) {\n              name = match\n                // Strip known V8 invocation prefixes to get the name.\n                .replace(/^(?:async|bound|get|new|set)\\s+/, '')\n              if (name.startsWith('Object.')) {\n                // Strip leading 'Object.' if not an own property of Object.\n                const afterDot = name.slice(7 /*'Object.'.length*/)\n                if (!hasOwn(Object, afterDot)) {\n                  name = afterDot\n                }\n              }\n            }\n            break\n          }\n        }\n      }\n    }\n  }\n  return name\n}\n\n/**\n * Custom log function for debug output.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction customLog(...args: unknown[]) {\n  const util = getUtil()\n  const inspectOpts = debugJs.inspectOpts\n    ? {\n        ...debugJs.inspectOpts,\n        showHidden:\n          debugJs.inspectOpts.showHidden === null\n            ? undefined\n            : debugJs.inspectOpts.showHidden,\n        depth:\n          debugJs.inspectOpts.depth === null ||\n          typeof debugJs.inspectOpts.depth === 'boolean'\n            ? undefined\n            : debugJs.inspectOpts.depth,\n      }\n    : {}\n  ReflectApply(logger.info, logger, [\n    util.formatWithOptions(inspectOpts, ...args),\n  ])\n}\n\n/**\n * Extract options from namespaces parameter.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction extractOptions(namespaces: NamespacesOrOptions): DebugOptions {\n  return namespaces !== null && typeof namespaces === 'object'\n    ? ({ __proto__: null, ...namespaces } as DebugOptions)\n    : ({ __proto__: null, namespaces } as DebugOptions)\n}\n\n/**\n * Check if debug is enabled for given namespaces.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction isEnabled(namespaces: string | undefined) {\n  // Check if debugging is enabled at all\n  if (!getSocketDebug()) {\n    return false\n  }\n  if (typeof namespaces !== 'string' || !namespaces || namespaces === '*') {\n    return true\n  }\n  // Namespace splitting logic is based the 'debug' package implementation:\n  // https://github.com/debug-js/debug/blob/4.4.1/src/common.js#L169-L173.\n  const split = namespaces\n    .trim()\n    .replace(/\\s+/g, ',')\n    .split(',')\n    .filter(Boolean)\n  const names = []\n  const skips = []\n  for (const ns of split) {\n    if (ns.startsWith('-')) {\n      skips.push(ns.slice(1))\n    } else {\n      names.push(ns)\n    }\n  }\n  if (names.length && !names.some(ns => getDebugJsInstance(ns).enabled)) {\n    return false\n  }\n  return skips.every(ns => !getDebugJsInstance(ns).enabled)\n}\n\n/**\n * Debug output for object inspection with caller info.\n */\nfunction debugDirNs(\n  namespacesOrOpts: NamespacesOrOptions,\n  obj: unknown,\n  inspectOpts?: InspectOptions | undefined,\n) {\n  const options = extractOptions(namespacesOrOpts)\n  const { namespaces } = options\n  if (!isEnabled(namespaces as string)) {\n    return\n  }\n  // Get caller info with stack offset of 4 (caller -> debugDirNs -> getCallerInfo).\n  const callerName = getCallerInfo(4) || 'anonymous'\n\n  if (pointingTriangle === undefined) {\n    const supported = isUnicodeSupported()\n    pointingTriangle = supported ? '\u25B8' : '>'\n  }\n\n  let opts: InspectOptions | undefined = inspectOpts\n  if (opts === undefined) {\n    const debugOpts = debugJs.inspectOpts\n    if (debugOpts) {\n      opts = {\n        ...debugOpts,\n        showHidden:\n          debugOpts.showHidden === null ? undefined : debugOpts.showHidden,\n        depth:\n          debugOpts.depth === null || typeof debugOpts.depth === 'boolean'\n            ? null\n            : debugOpts.depth,\n      } as InspectOptions\n    }\n  }\n  const spinnerInstance = options.spinner || getSpinner()\n  const wasSpinning = spinnerInstance?.isSpinning\n  spinnerInstance?.stop()\n  logger.info(`[DEBUG] ${callerName} ${pointingTriangle} object inspection:`)\n  logger.dir(obj, inspectOpts)\n  if (wasSpinning) {\n    spinnerInstance?.start()\n  }\n}\n\nlet pointingTriangle: string | undefined\n/**\n * Debug output with caller info.\n */\nfunction debugNs(namespacesOrOpts: NamespacesOrOptions, ...args: unknown[]) {\n  const options = extractOptions(namespacesOrOpts)\n  const { namespaces } = options\n  if (!isEnabled(namespaces as string)) {\n    return\n  }\n  // Get caller info with stack offset of 4 (caller -> debugNs -> getCallerInfo).\n  const name = getCallerInfo(4) || 'anonymous'\n  if (pointingTriangle === undefined) {\n    const supported = isUnicodeSupported()\n    pointingTriangle = supported ? '\u25B8' : '>'\n  }\n  const text = args.at(0)\n  const logArgs =\n    typeof text === 'string'\n      ? [\n          applyLinePrefix(\n            `${name ? `${name} ${pointingTriangle} ` : ''}${text}`,\n            { prefix: '[DEBUG] ' },\n          ),\n          ...args.slice(1),\n        ]\n      : args\n  const spinnerInstance = options.spinner || getSpinner()\n  const wasSpinning = spinnerInstance?.isSpinning\n  spinnerInstance?.stop()\n  ReflectApply(logger.info, logger, logArgs)\n  if (wasSpinning) {\n    spinnerInstance?.start()\n  }\n}\n\n/**\n * Debug logging function with caller info.\n */\nfunction debugLogNs(namespacesOrOpts: NamespacesOrOptions, ...args: unknown[]) {\n  const options = extractOptions(namespacesOrOpts)\n  const { namespaces } = options\n  if (!isEnabled(namespaces as string)) {\n    return\n  }\n  // Get caller info with stack offset of 4 (caller -> debugLogNs -> getCallerInfo).\n  const callerName = getCallerInfo(4) || 'anonymous'\n\n  if (pointingTriangle === undefined) {\n    const supported = isUnicodeSupported()\n    pointingTriangle = supported ? '\u25B8' : '>'\n  }\n\n  const text = args.at(0)\n  const logArgs =\n    typeof text === 'string'\n      ? [\n          applyLinePrefix(\n            `${callerName ? `${callerName} ${pointingTriangle} ` : ''}${text}`,\n            { prefix: '[DEBUG] ' },\n          ),\n          ...args.slice(1),\n        ]\n      : [`[DEBUG] ${callerName} ${pointingTriangle}`, ...args]\n\n  const spinnerInstance = options.spinner || getSpinner()\n  const wasSpinning = spinnerInstance?.isSpinning\n  spinnerInstance?.stop()\n  ReflectApply(logger.info, logger, logArgs)\n  if (wasSpinning) {\n    spinnerInstance?.start()\n  }\n}\n\n/**\n * Debug output for cache operations with caller info.\n * First argument is the operation type (hit/miss/set/clear).\n * Second argument is the cache key or message.\n * Optional third argument is metadata object.\n */\nfunction debugCacheNs(\n  namespacesOrOpts: NamespacesOrOptions,\n  operation: string,\n  key: string,\n  meta?: unknown | undefined,\n) {\n  const options = extractOptions(namespacesOrOpts)\n  const { namespaces } = options\n  if (!isEnabled(namespaces as string)) {\n    return\n  }\n  // Get caller info with stack offset of 4 (caller -> debugCacheNs -> getCallerInfo).\n  const callerName = getCallerInfo(4) || 'cache'\n\n  if (pointingTriangle === undefined) {\n    const supported = isUnicodeSupported()\n    pointingTriangle = supported ? '\u25B8' : '>'\n  }\n\n  const prefix = `[CACHE] ${callerName} ${pointingTriangle} ${operation}: ${key}`\n  const logArgs = meta !== undefined ? [prefix, meta] : [prefix]\n\n  const spinnerInstance = options.spinner || getSpinner()\n  const wasSpinning = spinnerInstance?.isSpinning\n  spinnerInstance?.stop()\n  ReflectApply(logger.info, logger, logArgs)\n  if (wasSpinning) {\n    spinnerInstance?.start()\n  }\n}\n\n/**\n * Cache debug function with caller info.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function debugCache(\n  operation: string,\n  key: string,\n  meta?: unknown | undefined,\n): void {\n  if (!getSocketDebug()) {\n    return\n  }\n  // Get caller info with stack offset of 3 (caller -> debugCache -> getCallerInfo).\n  const callerName = getCallerInfo(3) || 'cache'\n\n  if (pointingTriangle === undefined) {\n    const supported = isUnicodeSupported()\n    pointingTriangle = supported ? '\u25B8' : '>'\n  }\n\n  const prefix = `[CACHE] ${callerName} ${pointingTriangle} ${operation}: ${key}`\n  const args = meta !== undefined ? [prefix, meta] : [prefix]\n  console.log(...args)\n}\n\n/**\n * Check if debug mode is enabled.\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction isDebugNs(namespaces: string | undefined): boolean {\n  return !!getSocketDebug() && isEnabled(namespaces)\n}\n\n/**\n * Debug output with caller info (wrapper for debugNs with default namespace).\n */\nfunction debug(...args: unknown[]): void {\n  debugNs('*', ...args)\n}\n\n/**\n * Debug output for object inspection (wrapper for debugDirNs with default namespace).\n */\nfunction debugDir(\n  obj: unknown,\n  inspectOpts?: InspectOptions | undefined,\n): void {\n  debugDirNs('*', obj, inspectOpts)\n}\n\n/**\n * Debug logging function (wrapper for debugLogNs with default namespace).\n */\nfunction debugLog(...args: unknown[]): void {\n  debugLogNs('*', ...args)\n}\n\n/**\n * Check if debug mode is enabled.\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction isDebug(): boolean {\n  return !!getSocketDebug()\n}\n\n/**\n * Create a Node.js util.debuglog compatible function.\n * Returns a function that conditionally writes debug messages to stderr.\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction debuglog(section: string) {\n  const util = getUtil()\n  return util.debuglog(section)\n}\n\n/**\n * Create timing functions for measuring code execution time.\n * Returns an object with start() and end() methods, plus a callable function.\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction debugtime(label: string) {\n  const util = getUtil()\n  // Node.js util doesn't have debugtime - create a custom implementation\n  let startTime: number | undefined\n  const impl = () => {\n    if (startTime === undefined) {\n      startTime = Date.now()\n    } else {\n      const duration = Date.now() - startTime\n      util.debuglog('time')(`${label}: ${duration}ms`)\n      startTime = undefined\n    }\n  }\n  impl.start = () => {\n    startTime = Date.now()\n  }\n  impl.end = () => {\n    if (startTime !== undefined) {\n      const duration = Date.now() - startTime\n      util.debuglog('time')(`${label}: ${duration}ms`)\n      startTime = undefined\n    }\n  }\n  return impl\n}\n\n// Export main debug functions with caller info.\nexport { debug }\n// debugCache is already exported directly above\nexport { debugCacheNs }\nexport { debugDir }\nexport { debugDirNs }\nexport { debugLog }\nexport { debuglog }\nexport { debugLogNs }\nexport { debugNs }\nexport { debugtime }\nexport { isDebug }\nexport { isDebugNs }\n"],
-  "mappings": "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",
-  "names": ["debug_exports", "__export", "debug", "debugCache", "debugCacheNs", "debugDir", "debugDirNs", "debugLog", "debugLogNs", "debugNs", "debuglog", "debugtime", "isDebug", "isDebugNs", "__toCommonJS", "import_process", "import_debug", "import_socket", "import_is_unicode_supported", "import_logger", "import_objects", "import_strings", "ReflectApply", "debugByNamespace", "getDebugJsInstance", "namespace", "inst", "debugJs", "customLog", "_util", "getUtil", "getCallerInfo", "stackOffset", "name", "captureStackTrace", "obj", "stack", "lineCount", "lineStart", "i", "length", "line", "match", "afterDot", "args", "util", "inspectOpts", "extractOptions", "namespaces", "isEnabled", "split", "names", "skips", "ns", "namespacesOrOpts", "options", "callerName", "pointingTriangle", "isUnicodeSupported", "opts", "debugOpts", "spinnerInstance", "wasSpinning", "text", "logArgs", "operation", "key", "meta", "prefix", "section", "label", "startTime", "impl", "duration"]
+  "sourcesContent": ["/**\n * @fileoverview Debug logging utilities with lazy loading and environment-based control.\n * Provides Socket CLI specific debug functionality and logging formatters.\n */\n\nimport { getSpinner } from '#constants/process'\nimport { getDebug } from '#env/debug'\nimport { getSocketDebug } from '#env/socket'\nimport isUnicodeSupported from './external/@socketregistry/is-unicode-supported'\nimport debugJs from './external/debug'\n\nimport { getDefaultLogger } from './logger'\nimport { hasOwn } from './objects'\nimport { applyLinePrefix } from './strings'\n\nconst logger = getDefaultLogger()\n\n// IMPORTANT: Do not use destructuring here - use direct assignment instead.\n// tsgo has a bug that incorrectly transpiles destructured exports, resulting in\n// `exports.SomeName = void 0;` which causes runtime errors.\n// See: https://github.com/SocketDev/socket-packageurl-js/issues/3\nconst ReflectApply = Reflect.apply\n\n// Type definitions\ninterface DebugOptions {\n  namespaces?: string\n  spinner?: { isSpinning: boolean; stop(): void; start(): void }\n  [key: string]: unknown\n}\n\ntype NamespacesOrOptions = string | DebugOptions\n\ninterface InspectOptions {\n  depth?: number | null\n  colors?: boolean\n  [key: string]: unknown\n}\n\nexport type { DebugOptions, NamespacesOrOptions, InspectOptions }\n\nconst debugByNamespace = new Map()\n/**\n * Get or create a debug instance for a namespace.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getDebugJsInstance(namespace: string) {\n  let inst = debugByNamespace.get(namespace)\n  if (inst) {\n    return inst\n  }\n  if (\n    !getDebug() &&\n    getSocketDebug() &&\n    (namespace === 'error' || namespace === 'notice')\n  ) {\n    debugJs.enable(namespace)\n  }\n  inst = debugJs(namespace)\n  inst.log = customLog\n  debugByNamespace.set(namespace, inst)\n  return inst\n}\n\nlet _util: typeof import('util') | undefined\n/**\n * Lazily load the util module.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getUtil() {\n  if (_util === undefined) {\n    // Use non-'node:' prefixed require to avoid Webpack errors.\n\n    _util = /*@__PURE__*/ require('node:util')\n  }\n  return _util as typeof import('util')\n}\n\n/**\n * Extract caller information from the stack trace.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getCallerInfo(stackOffset: number = 3): string {\n  let name = ''\n  const captureStackTrace = Error.captureStackTrace\n  if (typeof captureStackTrace === 'function') {\n    const obj: { stack?: unknown } = {}\n    captureStackTrace(obj, getCallerInfo)\n    const stack = obj.stack\n    if (typeof stack === 'string') {\n      let lineCount = 0\n      let lineStart = 0\n      for (let i = 0, { length } = stack; i < length; i += 1) {\n        if (stack[i] === '\\n') {\n          lineCount += 1\n          if (lineCount < stackOffset) {\n            // Store the start index of the next line.\n            lineStart = i + 1\n          } else {\n            // Extract the full line and trim it.\n            const line = stack.slice(lineStart, i).trimStart()\n            // Match the function name portion (e.g., \"async runFix\").\n            const match = /(?<=^at\\s+).*?(?=\\s+\\(|$)/.exec(line)?.[0]\n            if (match) {\n              name = match\n                // Strip known V8 invocation prefixes to get the name.\n                .replace(/^(?:async|bound|get|new|set)\\s+/, '')\n              if (name.startsWith('Object.')) {\n                // Strip leading 'Object.' if not an own property of Object.\n                const afterDot = name.slice(7 /*'Object.'.length*/)\n                if (!hasOwn(Object, afterDot)) {\n                  name = afterDot\n                }\n              }\n            }\n            break\n          }\n        }\n      }\n    }\n  }\n  return name\n}\n\n/**\n * Custom log function for debug output.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction customLog(...args: unknown[]) {\n  const util = getUtil()\n  const inspectOpts = debugJs.inspectOpts\n    ? {\n        ...debugJs.inspectOpts,\n        showHidden:\n          debugJs.inspectOpts.showHidden === null\n            ? undefined\n            : debugJs.inspectOpts.showHidden,\n        depth:\n          debugJs.inspectOpts.depth === null ||\n          typeof debugJs.inspectOpts.depth === 'boolean'\n            ? undefined\n            : debugJs.inspectOpts.depth,\n      }\n    : {}\n  ReflectApply(logger.info, logger, [\n    util.formatWithOptions(inspectOpts, ...args),\n  ])\n}\n\n/**\n * Extract options from namespaces parameter.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction extractOptions(namespaces: NamespacesOrOptions): DebugOptions {\n  return namespaces !== null && typeof namespaces === 'object'\n    ? ({ __proto__: null, ...namespaces } as DebugOptions)\n    : ({ __proto__: null, namespaces } as DebugOptions)\n}\n\n/**\n * Check if debug is enabled for given namespaces.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction isEnabled(namespaces: string | undefined) {\n  // Check if debugging is enabled at all\n  if (!getSocketDebug()) {\n    return false\n  }\n  if (typeof namespaces !== 'string' || !namespaces || namespaces === '*') {\n    return true\n  }\n  // Namespace splitting logic is based the 'debug' package implementation:\n  // https://github.com/debug-js/debug/blob/4.4.1/src/common.js#L169-L173.\n  const split = namespaces\n    .trim()\n    .replace(/\\s+/g, ',')\n    .split(',')\n    .filter(Boolean)\n  const names = []\n  const skips = []\n  for (const ns of split) {\n    if (ns.startsWith('-')) {\n      skips.push(ns.slice(1))\n    } else {\n      names.push(ns)\n    }\n  }\n  if (names.length && !names.some(ns => getDebugJsInstance(ns).enabled)) {\n    return false\n  }\n  return skips.every(ns => !getDebugJsInstance(ns).enabled)\n}\n\n/**\n * Debug output for object inspection with caller info.\n */\nfunction debugDirNs(\n  namespacesOrOpts: NamespacesOrOptions,\n  obj: unknown,\n  inspectOpts?: InspectOptions | undefined,\n) {\n  const options = extractOptions(namespacesOrOpts)\n  const { namespaces } = options\n  if (!isEnabled(namespaces as string)) {\n    return\n  }\n  // Get caller info with stack offset of 4 (caller -> debugDirNs -> getCallerInfo).\n  const callerName = getCallerInfo(4) || 'anonymous'\n\n  if (pointingTriangle === undefined) {\n    const supported = isUnicodeSupported()\n    pointingTriangle = supported ? '\u25B8' : '>'\n  }\n\n  let opts: InspectOptions | undefined = inspectOpts\n  if (opts === undefined) {\n    const debugOpts = debugJs.inspectOpts\n    if (debugOpts) {\n      opts = {\n        ...debugOpts,\n        showHidden:\n          debugOpts.showHidden === null ? undefined : debugOpts.showHidden,\n        depth:\n          debugOpts.depth === null || typeof debugOpts.depth === 'boolean'\n            ? null\n            : debugOpts.depth,\n      } as InspectOptions\n    }\n  }\n  const spinnerInstance = options.spinner || getSpinner()\n  const wasSpinning = spinnerInstance?.isSpinning\n  spinnerInstance?.stop()\n  logger.info(`[DEBUG] ${callerName} ${pointingTriangle} object inspection:`)\n  logger.dir(obj, inspectOpts)\n  if (wasSpinning) {\n    spinnerInstance?.start()\n  }\n}\n\nlet pointingTriangle: string | undefined\n/**\n * Debug output with caller info.\n */\nfunction debugNs(namespacesOrOpts: NamespacesOrOptions, ...args: unknown[]) {\n  const options = extractOptions(namespacesOrOpts)\n  const { namespaces } = options\n  if (!isEnabled(namespaces as string)) {\n    return\n  }\n  // Get caller info with stack offset of 4 (caller -> debugNs -> getCallerInfo).\n  const name = getCallerInfo(4) || 'anonymous'\n  if (pointingTriangle === undefined) {\n    const supported = isUnicodeSupported()\n    pointingTriangle = supported ? '\u25B8' : '>'\n  }\n  const text = args.at(0)\n  const logArgs =\n    typeof text === 'string'\n      ? [\n          applyLinePrefix(\n            `${name ? `${name} ${pointingTriangle} ` : ''}${text}`,\n            { prefix: '[DEBUG] ' },\n          ),\n          ...args.slice(1),\n        ]\n      : args\n  const spinnerInstance = options.spinner || getSpinner()\n  const wasSpinning = spinnerInstance?.isSpinning\n  spinnerInstance?.stop()\n  ReflectApply(logger.info, logger, logArgs)\n  if (wasSpinning) {\n    spinnerInstance?.start()\n  }\n}\n\n/**\n * Debug logging function with caller info.\n */\nfunction debugLogNs(namespacesOrOpts: NamespacesOrOptions, ...args: unknown[]) {\n  const options = extractOptions(namespacesOrOpts)\n  const { namespaces } = options\n  if (!isEnabled(namespaces as string)) {\n    return\n  }\n  // Get caller info with stack offset of 4 (caller -> debugLogNs -> getCallerInfo).\n  const callerName = getCallerInfo(4) || 'anonymous'\n\n  if (pointingTriangle === undefined) {\n    const supported = isUnicodeSupported()\n    pointingTriangle = supported ? '\u25B8' : '>'\n  }\n\n  const text = args.at(0)\n  const logArgs =\n    typeof text === 'string'\n      ? [\n          applyLinePrefix(\n            `${callerName ? `${callerName} ${pointingTriangle} ` : ''}${text}`,\n            { prefix: '[DEBUG] ' },\n          ),\n          ...args.slice(1),\n        ]\n      : [`[DEBUG] ${callerName} ${pointingTriangle}`, ...args]\n\n  const spinnerInstance = options.spinner || getSpinner()\n  const wasSpinning = spinnerInstance?.isSpinning\n  spinnerInstance?.stop()\n  ReflectApply(logger.info, logger, logArgs)\n  if (wasSpinning) {\n    spinnerInstance?.start()\n  }\n}\n\n/**\n * Debug output for cache operations with caller info.\n * First argument is the operation type (hit/miss/set/clear).\n * Second argument is the cache key or message.\n * Optional third argument is metadata object.\n */\nfunction debugCacheNs(\n  namespacesOrOpts: NamespacesOrOptions,\n  operation: string,\n  key: string,\n  meta?: unknown | undefined,\n) {\n  const options = extractOptions(namespacesOrOpts)\n  const { namespaces } = options\n  if (!isEnabled(namespaces as string)) {\n    return\n  }\n  // Get caller info with stack offset of 4 (caller -> debugCacheNs -> getCallerInfo).\n  const callerName = getCallerInfo(4) || 'cache'\n\n  if (pointingTriangle === undefined) {\n    const supported = isUnicodeSupported()\n    pointingTriangle = supported ? '\u25B8' : '>'\n  }\n\n  const prefix = `[CACHE] ${callerName} ${pointingTriangle} ${operation}: ${key}`\n  const logArgs = meta !== undefined ? [prefix, meta] : [prefix]\n\n  const spinnerInstance = options.spinner || getSpinner()\n  const wasSpinning = spinnerInstance?.isSpinning\n  spinnerInstance?.stop()\n  ReflectApply(logger.info, logger, logArgs)\n  if (wasSpinning) {\n    spinnerInstance?.start()\n  }\n}\n\n/**\n * Cache debug function with caller info.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function debugCache(\n  operation: string,\n  key: string,\n  meta?: unknown | undefined,\n): void {\n  if (!getSocketDebug()) {\n    return\n  }\n  // Get caller info with stack offset of 3 (caller -> debugCache -> getCallerInfo).\n  const callerName = getCallerInfo(3) || 'cache'\n\n  if (pointingTriangle === undefined) {\n    const supported = isUnicodeSupported()\n    pointingTriangle = supported ? '\u25B8' : '>'\n  }\n\n  const prefix = `[CACHE] ${callerName} ${pointingTriangle} ${operation}: ${key}`\n  const args = meta !== undefined ? [prefix, meta] : [prefix]\n  console.log(...args)\n}\n\n/**\n * Check if debug mode is enabled.\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction isDebugNs(namespaces: string | undefined): boolean {\n  return !!getSocketDebug() && isEnabled(namespaces)\n}\n\n/**\n * Debug output with caller info (wrapper for debugNs with default namespace).\n */\nfunction debug(...args: unknown[]): void {\n  debugNs('*', ...args)\n}\n\n/**\n * Debug output for object inspection (wrapper for debugDirNs with default namespace).\n */\nfunction debugDir(\n  obj: unknown,\n  inspectOpts?: InspectOptions | undefined,\n): void {\n  debugDirNs('*', obj, inspectOpts)\n}\n\n/**\n * Debug logging function (wrapper for debugLogNs with default namespace).\n */\nfunction debugLog(...args: unknown[]): void {\n  debugLogNs('*', ...args)\n}\n\n/**\n * Check if debug mode is enabled.\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction isDebug(): boolean {\n  return !!getSocketDebug()\n}\n\n/**\n * Create a Node.js util.debuglog compatible function.\n * Returns a function that conditionally writes debug messages to stderr.\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction debuglog(section: string) {\n  const util = getUtil()\n  return util.debuglog(section)\n}\n\n/**\n * Create timing functions for measuring code execution time.\n * Returns an object with start() and end() methods, plus a callable function.\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction debugtime(label: string) {\n  const util = getUtil()\n  // Node.js util doesn't have debugtime - create a custom implementation\n  let startTime: number | undefined\n  const impl = () => {\n    if (startTime === undefined) {\n      startTime = Date.now()\n    } else {\n      const duration = Date.now() - startTime\n      util.debuglog('time')(`${label}: ${duration}ms`)\n      startTime = undefined\n    }\n  }\n  impl.start = () => {\n    startTime = Date.now()\n  }\n  impl.end = () => {\n    if (startTime !== undefined) {\n      const duration = Date.now() - startTime\n      util.debuglog('time')(`${label}: ${duration}ms`)\n      startTime = undefined\n    }\n  }\n  return impl\n}\n\n// Export main debug functions with caller info.\nexport { debug }\n// debugCache is already exported directly above\nexport { debugCacheNs }\nexport { debugDir }\nexport { debugDirNs }\nexport { debugLog }\nexport { debuglog }\nexport { debugLogNs }\nexport { debugNs }\nexport { debugtime }\nexport { isDebug }\nexport { isDebugNs }\n"],
+  "mappings": "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",
+  "names": ["debug_exports", "__export", "debug", "debugCache", "debugCacheNs", "debugDir", "debugDirNs", "debugLog", "debugLogNs", "debugNs", "debuglog", "debugtime", "isDebug", "isDebugNs", "__toCommonJS", "import_process", "import_debug", "import_socket", "import_is_unicode_supported", "import_logger", "import_objects", "import_strings", "logger", "ReflectApply", "debugByNamespace", "getDebugJsInstance", "namespace", "inst", "debugJs", "customLog", "_util", "getUtil", "getCallerInfo", "stackOffset", "name", "captureStackTrace", "obj", "stack", "lineCount", "lineStart", "i", "length", "line", "match", "afterDot", "args", "util", "inspectOpts", "extractOptions", "namespaces", "isEnabled", "split", "names", "skips", "ns", "namespacesOrOpts", "options", "callerName", "pointingTriangle", "isUnicodeSupported", "opts", "debugOpts", "spinnerInstance", "wasSpinning", "text", "logArgs", "operation", "key", "meta", "prefix", "section", "label", "startTime", "impl", "duration"]
 }