chore: release v3.0.1

- Add convenience exports (getDefaultLogger, Logger, LOG_SYMBOLS, getDefaultSpinner, Spinner) to main index
- Fix critical spinner crashes from removed logger export
- Remove empty SocketRegistry class and exports
- Update all spinner internal logger calls to use getDefaultLogger()

Author: jdalton

CHANGELOG.md

@@ -5,6 +5,27 @@ 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.1](https://github.com/SocketDev/socket-lib/releases/tag/v3.0.1) - 2025-11-01
+
+### Added
+
+- **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
+
+- **Migration path improvement**: Users can now import logger/spinner from either main index or subpaths, reducing breaking change impact from v3.0.0
+
 ## [3.0.0](https://github.com/SocketDev/socket-lib/releases/tag/v3.0.0) - 2025-11-01
 
 ### Added

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@socketsecurity/lib",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "license": "MIT",
   "description": "Core utilities and infrastructure for Socket.dev security tools",
   "keywords": [
@@ -356,10 +356,6 @@
       "types": "./dist/packages/provenance.d.ts",
       "default": "./dist/packages/provenance.js"
     },
-    "./packages/registry": {
-      "types": "./dist/packages/registry.d.ts",
-      "default": "./dist/packages/registry.js"
-    },
     "./packages/specs": {
       "types": "./dist/packages/specs.d.ts",
       "default": "./dist/packages/specs.js"

src/index.ts

@@ -1,14 +1,12 @@
 /**
- * @fileoverview Main entry point for Socket Registry v2.0.
+ * @fileoverview Main entry point for @socketsecurity/lib.
  * Clean, organized exports for better developer experience.
  */
 
-// Direct exports for commonly used items
-// Alias for backward compatibility with GitHub version
-export {
-  SocketRegistry,
-  SocketRegistry as SocketSecurityRegistry,
-} from './packages/registry'
+// Export logger utilities for convenience
+export { getDefaultLogger, Logger, LOG_SYMBOLS } from './logger'
+// Export spinner utilities for convenience
+export { getDefaultSpinner, Spinner } from './spinner'
 // Export types
 export * from './types'
 
@@ -47,4 +45,4 @@ export function getManifestData(ecosystem?: string, packageName?: string) {
 }
 
 // Version export
-export const version = '2.0.0'
+export const version = '3.0.1'

src/packages/registry.ts

@@ -641,10 +641,11 @@ export function Spinner(options?: SpinnerOptions | undefined): Spinner {
         const normalized = normalizeText(text)
         super[methodName](normalized)
         const {
+          getDefaultLogger,
           incLogCallCountSymbol,
           lastWasBlankSymbol,
-          logger,
         } = /*@__PURE__*/ require('./logger.js')
+        const logger = getDefaultLogger()
         if (methodName === 'stop') {
           if (wasSpinning && normalized) {
             logger[lastWasBlankSymbol](isBlankString(normalized))
@@ -719,8 +720,12 @@ export function Spinner(options?: SpinnerOptions | undefined): Spinner {
           text = ''
         }
 
-        const { LOG_SYMBOLS, logger } = /*@__PURE__*/ require('./logger.js')
+        const {
+          LOG_SYMBOLS,
+          getDefaultLogger,
+        } = /*@__PURE__*/ require('./logger.js')
         // Note: Status messages always go to stderr.
+        const logger = getDefaultLogger()
         logger.error(`${LOG_SYMBOLS[symbolType]} ${text}`, ...extras)
         return this
       }
@@ -909,7 +914,8 @@ export function Spinner(options?: SpinnerOptions | undefined): Spinner {
        * @returns This spinner for chaining
        */
       log(...args: unknown[]) {
-        const { logger } = /*@__PURE__*/ require('./logger.js')
+        const { getDefaultLogger } = /*@__PURE__*/ require('./logger.js')
+        const logger = getDefaultLogger()
         logger.log(...args)
         return this
       }
@@ -1037,8 +1043,9 @@ export function Spinner(options?: SpinnerOptions | undefined): Spinner {
        * ```
        */
       step(text?: string | undefined, ...extras: unknown[]) {
-        const { logger } = /*@__PURE__*/ require('./logger.js')
+        const { getDefaultLogger } = /*@__PURE__*/ require('./logger.js')
         if (typeof text === 'string') {
+          const logger = getDefaultLogger()
           // Add blank line before step for visual separation.
           logger.error('')
           // Use error (stderr) to align with logger.step() default stream.
@@ -1066,7 +1073,8 @@ export function Spinner(options?: SpinnerOptions | undefined): Spinner {
       substep(text?: string | undefined, ...extras: unknown[]) {
         if (typeof text === 'string') {
           // Add 2-space indent for substep.
-          const { logger } = /*@__PURE__*/ require('./logger.js')
+          const { getDefaultLogger } = /*@__PURE__*/ require('./logger.js')
+          const logger = getDefaultLogger()
           // Use error (stderr) to align with logger.substep() default stream.
           logger.error(`  ${text}`, ...extras)
         }