@socketsecurity/lib 5.18.2 → 5.19.0

package/dist/themes/context.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @fileoverview Elegant theme context management.
+ * Async-aware theming with automatic context isolation via AsyncLocalStorage.
+ */
 import type { Theme } from './types';
 import { type ThemeName } from './themes';
 /**
@@ -5,28 +9,45 @@ import { type ThemeName } from './themes';
  */
 export type ThemeChangeListener = (theme: Theme) => void;
 /**
- * Set the global fallback theme.
+ * Get the active theme from context.
  *
- * @param theme - Theme name or object
+ * @returns Current theme
  *
  * @example
  * ```ts
- * setTheme('socket-firewall')
+ * const theme = getTheme()
+ * console.log(theme.displayName)
  * ```
  */
-export declare function setTheme(theme: Theme | ThemeName): void;
+export declare function getTheme(): Theme;
 /**
- * Get the active theme from context.
+ * Subscribe to theme change events.
  *
- * @returns Current theme
+ * @param listener - Change handler
+ * @returns Unsubscribe function
  *
  * @example
  * ```ts
- * const theme = getTheme()
- * console.log(theme.displayName)
+ * const unsubscribe = onThemeChange((theme) => {
+ *   console.log('Theme:', theme.displayName)
+ * })
+ *
+ * // Cleanup
+ * unsubscribe()
  * ```
  */
-export declare function getTheme(): Theme;
+export declare function onThemeChange(listener: ThemeChangeListener): () => void;
+/**
+ * Set the global fallback theme.
+ *
+ * @param theme - Theme name or object
+ *
+ * @example
+ * ```ts
+ * setTheme('socket-firewall')
+ * ```
+ */
+export declare function setTheme(theme: Theme | ThemeName): void;
 /**
  * Execute async operation with scoped theme.
  * Theme automatically restored on completion.
@@ -61,20 +82,3 @@ export declare function withTheme<T>(theme: Theme | ThemeName, fn: () => Promise
  * ```
  */
 export declare function withThemeSync<T>(theme: Theme | ThemeName, fn: () => T): T;
-/**
- * Subscribe to theme change events.
- *
- * @param listener - Change handler
- * @returns Unsubscribe function
- *
- * @example
- * ```ts
- * const unsubscribe = onThemeChange((theme) => {
- *   console.log('Theme:', theme.displayName)
- * })
- *
- * // Cleanup
- * unsubscribe()
- * ```
- */
-export declare function onThemeChange(listener: ThemeChangeListener): () => void;

package/dist/themes/context.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -28,10 +29,15 @@ __export(context_exports, {
 module.exports = __toCommonJS(context_exports);
 var import_themes = require("./themes");
 let _async_hooks;
+function emitThemeChange(theme) {
+  for (const listener of listeners) {
+    listener(theme);
+  }
+}
 // @__NO_SIDE_EFFECTS__
 function getAsyncHooks() {
   if (_async_hooks === void 0) {
-    _async_hooks = require("async_hooks");
+    _async_hooks = require("node:async_hooks");
   }
   return _async_hooks;
 }
@@ -39,38 +45,33 @@ const { AsyncLocalStorage } = /* @__PURE__ */ getAsyncHooks();
 const themeStorage = new AsyncLocalStorage();
 let fallbackTheme = import_themes.SOCKET_THEME;
 const listeners = /* @__PURE__ */ new Set();
-function setTheme(theme) {
-  fallbackTheme = typeof theme === "string" ? import_themes.THEMES[theme] : theme;
-  emitThemeChange(fallbackTheme);
-}
 function getTheme() {
   return themeStorage.getStore() ?? fallbackTheme;
 }
+function onThemeChange(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+function setTheme(theme) {
+  fallbackTheme = typeof theme === "string" ? import_themes.THEMES[theme] ?? fallbackTheme : theme;
+  emitThemeChange(fallbackTheme);
+}
 async function withTheme(theme, fn) {
-  const resolvedTheme = typeof theme === "string" ? import_themes.THEMES[theme] : theme;
+  const resolvedTheme = typeof theme === "string" ? import_themes.THEMES[theme] ?? fallbackTheme : theme;
   return await themeStorage.run(resolvedTheme, async () => {
     emitThemeChange(resolvedTheme);
     return await fn();
   });
 }
 function withThemeSync(theme, fn) {
-  const resolvedTheme = typeof theme === "string" ? import_themes.THEMES[theme] : theme;
+  const resolvedTheme = typeof theme === "string" ? import_themes.THEMES[theme] ?? fallbackTheme : theme;
   return themeStorage.run(resolvedTheme, () => {
     emitThemeChange(resolvedTheme);
     return fn();
   });
 }
-function onThemeChange(listener) {
-  listeners.add(listener);
-  return () => {
-    listeners.delete(listener);
-  };
-}
-function emitThemeChange(theme) {
-  for (const listener of listeners) {
-    listener(theme);
-  }
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   getTheme,

package/dist/themes/index.d.ts

@@ -43,11 +43,7 @@
  * })
  * ```
  */
-// Type system
 export type { ColorReference, Theme, ThemeColors, ThemeEffects, ThemeMeta, } from './types';
-// Curated themes
 export { LUSH_THEME, SOCKET_THEME, SUNSET_THEME, TERRACOTTA_THEME, THEMES, ULTRA_THEME, type ThemeName, } from './themes';
-// Context management
 export { getTheme, onThemeChange, setTheme, withTheme, withThemeSync, type ThemeChangeListener, } from './context';
-// Composition utilities
 export { createTheme, extendTheme, resolveColor, resolveShimmerColor, } from './utils';

package/dist/themes/index.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;

package/dist/themes/themes.d.ts

@@ -36,7 +36,7 @@ export declare const ULTRA_THEME: Theme;
  * Theme registry — Curated palette collection.
  */
 export declare const THEMES: {
-    readonly __proto__: any;
+    readonly __proto__: null;
     readonly socket: Theme;
     readonly sunset: Theme;
     readonly terracotta: Theme;

package/dist/themes/themes.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;

package/dist/themes/types.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;

package/dist/themes/utils.d.ts

@@ -1,35 +1,36 @@
-import type { ColorValue } from '../colors';
-import type { ShimmerColorGradient } from '../effects/text-shimmer';
-import type { Theme, ThemeColors, ColorReference } from './types';
 /**
- * Resolve color reference to concrete value.
- * Handles semantic keywords: 'primary', 'secondary', 'rainbow', 'inherit'
- *
- * @param value - Color reference
- * @param colors - Theme palette
- * @returns Resolved color
- *
- * @example
- * ```ts
- * resolveColor('primary', theme.colors)
- * resolveColor([255, 0, 0], theme.colors)
- * ```
+ * @fileoverview Theme utilities — color resolution and composition.
  */
-export declare function resolveColor(value: ColorReference | ColorValue, colors: ThemeColors): ColorValue | 'inherit' | ShimmerColorGradient;
+import type { ColorValue } from '../colors';
+import type { ShimmerColorGradient } from '../effects/text-shimmer';
+import type { ColorReference, Theme, ThemeColors } from './types';
 /**
- * Resolve shimmer color with gradient support.
+ * Create new theme from complete specification.
  *
- * @param value - Shimmer color
- * @param theme - Theme context
- * @returns Resolved color
+ * @param config - Theme configuration
+ * @returns Theme object
  *
  * @example
  * ```ts
- * resolveShimmerColor('rainbow', theme)
- * resolveShimmerColor('primary', theme)
+ * const theme = createTheme({
+ *   name: 'custom',
+ *   displayName: 'Custom',
+ *   colors: {
+ *     primary: [255, 100, 200],
+ *     success: 'greenBright',
+ *     error: 'redBright',
+ *     warning: 'yellowBright',
+ *     info: 'blueBright',
+ *     step: 'cyanBright',
+ *     text: 'white',
+ *     textDim: 'gray',
+ *     link: 'cyanBright',
+ *     prompt: 'primary'
+ *   }
+ * })
  * ```
  */
-export declare function resolveShimmerColor(value: ColorReference | ColorValue[] | undefined, theme: Theme): ColorValue | ShimmerColorGradient | 'inherit';
+export declare function createTheme(config: Pick<Theme, 'name' | 'displayName' | 'colors'> & Partial<Omit<Theme, 'name' | 'displayName' | 'colors'>>): Theme;
 /**
  * Extend existing theme with custom overrides.
  * Deep merge of colors and effects.
@@ -50,29 +51,31 @@ export declare function extendTheme(base: Theme, overrides: Partial<Omit<Theme,
     colors?: Partial<ThemeColors> | undefined;
 }): Theme;
 /**
- * Create new theme from complete specification.
+ * Resolve color reference to concrete value.
+ * Handles semantic keywords: 'primary', 'secondary', 'rainbow', 'inherit'
  *
- * @param config - Theme configuration
- * @returns Theme object
+ * @param value - Color reference
+ * @param colors - Theme palette
+ * @returns Resolved color
  *
  * @example
  * ```ts
- * const theme = createTheme({
- *   name: 'custom',
- *   displayName: 'Custom',
- *   colors: {
- *     primary: [255, 100, 200],
- *     success: 'greenBright',
- *     error: 'redBright',
- *     warning: 'yellowBright',
- *     info: 'blueBright',
- *     step: 'cyanBright',
- *     text: 'white',
- *     textDim: 'gray',
- *     link: 'cyanBright',
- *     prompt: 'primary'
- *   }
- * })
+ * resolveColor('primary', theme.colors)
+ * resolveColor([255, 0, 0], theme.colors)
  * ```
  */
-export declare function createTheme(config: Pick<Theme, 'name' | 'displayName' | 'colors'> & Partial<Omit<Theme, 'name' | 'displayName' | 'colors'>>): Theme;
+export declare function resolveColor(value: ColorReference | ColorValue, colors: ThemeColors): ColorValue | 'inherit' | ShimmerColorGradient;
+/**
+ * Resolve shimmer color with gradient support.
+ *
+ * @param value - Shimmer color
+ * @param theme - Theme context
+ * @returns Resolved color
+ *
+ * @example
+ * ```ts
+ * resolveShimmerColor('rainbow', theme)
+ * resolveShimmerColor('primary', theme)
+ * ```
+ */
+export declare function resolveShimmerColor(value: ColorReference | ColorValue[] | undefined, theme: Theme): ColorValue | ShimmerColorGradient | 'inherit';

package/dist/themes/utils.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -26,41 +27,15 @@ __export(utils_exports, {
 });
 module.exports = __toCommonJS(utils_exports);
 var import_ultra = require("../effects/ultra");
-function resolveColor(value, colors) {
-  if (typeof value === "string") {
-    if (value === "primary") {
-      return colors.primary;
-    }
-    if (value === "secondary") {
-      return colors.secondary ?? colors.primary;
-    }
-    if (value === "inherit") {
-      return "inherit";
-    }
-    if (value === "rainbow") {
-      return import_ultra.RAINBOW_GRADIENT;
-    }
-    return value;
-  }
-  return value;
-}
-function resolveShimmerColor(value, theme) {
-  if (!value) {
-    return "inherit";
-  }
-  if (value === "rainbow") {
-    return import_ultra.RAINBOW_GRADIENT;
-  }
-  if (value === "inherit") {
-    return "inherit";
-  }
-  if (Array.isArray(value)) {
-    if (value.length > 0 && Array.isArray(value[0])) {
-      return value;
-    }
-    return value;
-  }
-  return resolveColor(value, theme.colors);
+function createTheme(config) {
+  return {
+    __proto__: null,
+    name: config.name,
+    displayName: config.displayName,
+    colors: { __proto__: null, ...config.colors },
+    effects: config.effects ? { __proto__: null, ...config.effects } : void 0,
+    meta: config.meta ? { __proto__: null, ...config.meta } : void 0
+  };
 }
 function extendTheme(base, overrides) {
   return {
@@ -99,15 +74,41 @@ function extendTheme(base, overrides) {
     } : base.meta
   };
 }
-function createTheme(config) {
-  return {
-    __proto__: null,
-    name: config.name,
-    displayName: config.displayName,
-    colors: { __proto__: null, ...config.colors },
-    effects: config.effects ? { __proto__: null, ...config.effects } : void 0,
-    meta: config.meta ? { __proto__: null, ...config.meta } : void 0
-  };
+function resolveColor(value, colors) {
+  if (typeof value === "string") {
+    if (value === "primary") {
+      return colors.primary;
+    }
+    if (value === "secondary") {
+      return colors.secondary ?? colors.primary;
+    }
+    if (value === "inherit") {
+      return "inherit";
+    }
+    if (value === "rainbow") {
+      return import_ultra.RAINBOW_GRADIENT;
+    }
+    return value;
+  }
+  return value;
+}
+function resolveShimmerColor(value, theme) {
+  if (!value) {
+    return "inherit";
+  }
+  if (value === "rainbow") {
+    return import_ultra.RAINBOW_GRADIENT;
+  }
+  if (value === "inherit") {
+    return "inherit";
+  }
+  if (Array.isArray(value)) {
+    if (value.length > 0 && Array.isArray(value[0])) {
+      return value;
+    }
+    return value;
+  }
+  return resolveColor(value, theme.colors);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/types.d.ts

@@ -1,59 +1,55 @@
 /**
  * @fileoverview Type definitions for Socket Registry.
  */
-// Type definitions
-declare enum Categories {
-    CLEANUP = "cleanup",
-    LEVELUP = "levelup",
-    SPEEDUP = "speedup",
-    TUNEUP = "tuneup"
-}
-export type CategoryString = `${Categories}`;
-declare enum Interop {
-    BROWSERIFY = "browserify",
-    CJS = "cjs",
-    ESM = "esm"
-}
-export type InteropString = `${Interop}`;
-// Based on SocketPURL_Type from socket-sdk-js
-export declare enum PURL_Type {
-    ALPM = "alpm",
-    APK = "apk",
-    BITBUCKET = "bitbucket",
-    COCOAPODS = "cocoapods",
-    CARGO = "cargo",
-    CHROME = "chrome",
-    COMPOSER = "composer",
-    CONAN = "conan",
-    CONDA = "conda",
-    CRAN = "cran",
-    DEB = "deb",
-    DOCKER = "docker",
-    GEM = "gem",
-    GENERIC = "generic",
-    GITHUB = "github",
-    GOLANG = "golang",
-    HACKAGE = "hackage",
-    HEX = "hex",
-    HUGGINGFACE = "huggingface",
-    MAVEN = "maven",
-    MLFLOW = "mlflow",
-    NPM = "npm",
-    NUGET = "nuget",
-    OCI = "oci",
-    PUB = "pub",
-    PYPI = "pypi",
-    QPKG = "qpkg",
-    RPM = "rpm",
-    SWID = "swid",
-    SWIFT = "swift",
-    VCS = "vcs",
-    VSCODE = "vscode"
-}
-export type PURLString = `${PURL_Type}`;
-// Alias for backward compatibility and semantic clarity
+declare const Categories: {
+    readonly CLEANUP: 'cleanup';
+    readonly LEVELUP: 'levelup';
+    readonly SPEEDUP: 'speedup';
+    readonly TUNEUP: 'tuneup';
+};
+export type CategoryString = (typeof Categories)[keyof typeof Categories];
+declare const Interop: {
+    readonly BROWSERIFY: 'browserify';
+    readonly CJS: 'cjs';
+    readonly ESM: 'esm';
+};
+export type InteropString = (typeof Interop)[keyof typeof Interop];
+export declare const PURL_Type: {
+    readonly ALPM: 'alpm';
+    readonly APK: 'apk';
+    readonly BITBUCKET: 'bitbucket';
+    readonly COCOAPODS: 'cocoapods';
+    readonly CARGO: 'cargo';
+    readonly CHROME: 'chrome';
+    readonly COMPOSER: 'composer';
+    readonly CONAN: 'conan';
+    readonly CONDA: 'conda';
+    readonly CRAN: 'cran';
+    readonly DEB: 'deb';
+    readonly DOCKER: 'docker';
+    readonly GEM: 'gem';
+    readonly GENERIC: 'generic';
+    readonly GITHUB: 'github';
+    readonly GOLANG: 'golang';
+    readonly HACKAGE: 'hackage';
+    readonly HEX: 'hex';
+    readonly HUGGINGFACE: 'huggingface';
+    readonly MAVEN: 'maven';
+    readonly MLFLOW: 'mlflow';
+    readonly NPM: 'npm';
+    readonly NUGET: 'nuget';
+    readonly OCI: 'oci';
+    readonly PUB: 'pub';
+    readonly PYPI: 'pypi';
+    readonly QPKG: 'qpkg';
+    readonly RPM: 'rpm';
+    readonly SWID: 'swid';
+    readonly SWIFT: 'swift';
+    readonly VCS: 'vcs';
+    readonly VSCODE: 'vscode';
+};
+export type PURLString = (typeof PURL_Type)[keyof typeof PURL_Type];
 export type EcosystemString = PURLString;
-// Manifest types for Socket Registry
 export type ManifestEntryData = {
     categories?: CategoryString[] | undefined;
     interop?: InteropString | undefined;

package/dist/types.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -22,41 +23,40 @@ __export(types_exports, {
   PURL_Type: () => PURL_Type
 });
 module.exports = __toCommonJS(types_exports);
-var PURL_Type = /* @__PURE__ */ ((PURL_Type2) => {
-  PURL_Type2["ALPM"] = "alpm";
-  PURL_Type2["APK"] = "apk";
-  PURL_Type2["BITBUCKET"] = "bitbucket";
-  PURL_Type2["COCOAPODS"] = "cocoapods";
-  PURL_Type2["CARGO"] = "cargo";
-  PURL_Type2["CHROME"] = "chrome";
-  PURL_Type2["COMPOSER"] = "composer";
-  PURL_Type2["CONAN"] = "conan";
-  PURL_Type2["CONDA"] = "conda";
-  PURL_Type2["CRAN"] = "cran";
-  PURL_Type2["DEB"] = "deb";
-  PURL_Type2["DOCKER"] = "docker";
-  PURL_Type2["GEM"] = "gem";
-  PURL_Type2["GENERIC"] = "generic";
-  PURL_Type2["GITHUB"] = "github";
-  PURL_Type2["GOLANG"] = "golang";
-  PURL_Type2["HACKAGE"] = "hackage";
-  PURL_Type2["HEX"] = "hex";
-  PURL_Type2["HUGGINGFACE"] = "huggingface";
-  PURL_Type2["MAVEN"] = "maven";
-  PURL_Type2["MLFLOW"] = "mlflow";
-  PURL_Type2["NPM"] = "npm";
-  PURL_Type2["NUGET"] = "nuget";
-  PURL_Type2["OCI"] = "oci";
-  PURL_Type2["PUB"] = "pub";
-  PURL_Type2["PYPI"] = "pypi";
-  PURL_Type2["QPKG"] = "qpkg";
-  PURL_Type2["RPM"] = "rpm";
-  PURL_Type2["SWID"] = "swid";
-  PURL_Type2["SWIFT"] = "swift";
-  PURL_Type2["VCS"] = "vcs";
-  PURL_Type2["VSCODE"] = "vscode";
-  return PURL_Type2;
-})(PURL_Type || {});
+const PURL_Type = {
+  ALPM: "alpm",
+  APK: "apk",
+  BITBUCKET: "bitbucket",
+  COCOAPODS: "cocoapods",
+  CARGO: "cargo",
+  CHROME: "chrome",
+  COMPOSER: "composer",
+  CONAN: "conan",
+  CONDA: "conda",
+  CRAN: "cran",
+  DEB: "deb",
+  DOCKER: "docker",
+  GEM: "gem",
+  GENERIC: "generic",
+  GITHUB: "github",
+  GOLANG: "golang",
+  HACKAGE: "hackage",
+  HEX: "hex",
+  HUGGINGFACE: "huggingface",
+  MAVEN: "maven",
+  MLFLOW: "mlflow",
+  NPM: "npm",
+  NUGET: "nuget",
+  OCI: "oci",
+  PUB: "pub",
+  PYPI: "pypi",
+  QPKG: "qpkg",
+  RPM: "rpm",
+  SWID: "swid",
+  SWIFT: "swift",
+  VCS: "vcs",
+  VSCODE: "vscode"
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   PURL_Type