@socketsecurity/lib 2.10.4 → 3.0.1

package/CHANGELOG.md

@@ -5,38 +5,64 @@ 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.4](https://github.com/SocketDev/socket-lib/releases/tag/v2.10.4) - 2025-10-31
+## [3.0.1](https://github.com/SocketDev/socket-lib/releases/tag/v3.0.1) - 2025-11-01
 
 ### Added
 
-- **Safe directory creation utilities**: Added `safeMkdir()` and `safeMkdirSync()` functions to the `fs` module that gracefully handle concurrent directory creation
-  - Automatically ignores `EEXIST` errors when directory already exists (prevents race conditions)
-  - Re-throws all other errors for proper error handling
-  - Uses TypeScript `unknown` type for proper type narrowing in error handling
-  - Exported from `@socketsecurity/lib/fs`
+- **Convenience exports from main index**: Added logger and spinner exports to ease v2→v3 migration
+  - Logger: `getDefaultLogger()`, `Logger`, `LOG_SYMBOLS` now available from `@socketsecurity/lib`
+  - Spinner: `getDefaultSpinner()`, `Spinner` now available from `@socketsecurity/lib`
+  - Both main index (`@socketsecurity/lib`) and subpath (`@socketsecurity/lib/logger`, `@socketsecurity/lib/spinner`) imports now work
+  - Both import paths return the same singleton instances
+
+### Fixed
+
+- **Critical: Spinner crashes when calling logger**: Fixed spinner internal calls to use `getDefaultLogger()` instead of removed `logger` export
+  - Spinner methods (`start()`, `stop()`, `success()`, `fail()`, etc.) no longer crash with "logger is not defined" errors
+  - All 5 internal logger access points updated to use the correct v3 API
+  - Resolves runtime errors when using spinners with hoisted variables
 
 ### Changed
 
-- **DLX modules now use lazy-loaded file system access**: Refactored `dlx.ts`, `dlx-package.ts`, and `dlx-binary.ts` to use `getFs()` pattern for better bundler compatibility
-  - Prevents Webpack bundling errors with Node.js built-in modules
-  - Lazy initialization of `fs` module only when needed
-  - Maintains consistent pattern across entire DLX subsystem
-- **Consistent bare imports for Node.js built-ins**: Replaced all `'node:'` prefixed imports with bare imports (e.g., `'node:fs'` → `'fs'`) across 17 source files
-  - Better compatibility with legacy bundlers and build tools
-  - Maintains functionality while improving tooling support
-- **All directory creation now uses safe utilities**: Updated all `fs.promises.mkdir()` and `fs.mkdirSync()` calls to use `safeMkdir()` and `safeMkdirSync()` throughout DLX modules
-  - Eliminates manual `EEXIST` error handling code duplication
-  - Cleaner, more maintainable codebase
+- **Migration path improvement**: Users can now import logger/spinner from either main index or subpaths, reducing breaking change impact from v3.0.0
 
-### Fixed
+## [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
 
-- **v1.x environment variable backward compatibility**: Restored complete environment variable fallback chains from CLI v1.1.25
-  - `SOCKET_CLI_API_BASE_URL` now falls back to `SOCKET_SECURITY_API_BASE_URL`
-  - `SOCKET_CLI_API_PROXY` has 6-level fallback chain (including HTTPS_PROXY, https_proxy, HTTP_PROXY, http_proxy)
-  - `SOCKET_CLI_API_TOKEN` has 4-level fallback chain (SOCKET_CLI_API_KEY, SOCKET_SECURITY_API_TOKEN, SOCKET_SECURITY_API_KEY)
-  - `SOCKET_CLI_ORG_SLUG` falls back to `SOCKET_ORG_SLUG`
-  - `SOCKET_CLI_GITHUB_TOKEN` has 3-level fallback chain (SOCKET_SECURITY_GITHUB_PAT, GITHUB_TOKEN)
-  - Ensures seamless migration from CLI v1.x to v2.x
+**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
 

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