@socketsecurity/lib 6.0.2 → 6.0.4

package/dist/temporal/system.js

@@ -1,42 +1,42 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var system_exports = {};
-__export(system_exports, {
-  systemUTCEpochNanoseconds: () => systemUTCEpochNanoseconds
-});
-module.exports = __toCommonJS(system_exports);
-var import_globals = require("../primordials/globals");
-var import_date = require("../primordials/date");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_primordials_date = require('../primordials/date.js');
+const require_primordials_globals = require('../primordials/globals.js');
+
+//#region src/temporal/system.ts
+/**
+* @file Spec clause 21.x host hook — wallclock reader. Implements
+*   `SystemUTCEpochNanoseconds()`, the spec's nanosecond- resolution wallclock
+*   read. Hosts may use any source they like provided the result is
+*   non-decreasing across calls. On Node we combine `Date.now()` (millisecond
+*   wallclock) with `process.hrtime.bigint()` (sub-millisecond monotonic
+*   counter) anchored at module load to deliver real nanosecond resolution.
+*   Fallback path (non-Node hosts without `process.hrtime.bigint`): we multiply
+*   `Date.now()` by 1_000_000n to fill the field with zeros. This trades
+*   sub-millisecond precision for portability and is the same compromise the
+*   polyfill makes for browser hosts. Spec:
+*   https://tc39.es/proposal-temporal/#sec-temporal-systemutcepochnanoseconds.
+*/
 const _hrtimeBigint = globalThis.process?.hrtime?.bigint;
-const _anchorWallMs = (0, import_globals.BigIntCtor)((0, import_date.DateNow)());
+const _anchorWallMs = require_primordials_globals.BigIntCtor(require_primordials_date.DateNow());
 const _anchorHrns = _hrtimeBigint ? _hrtimeBigint() : 0n;
 const _NS_PER_MS = 1000000n;
+/**
+* Returns the current UTC time as nanoseconds since 1970-01-01T00:00:00Z.
+*
+* Resolution is nanosecond on Node (via `process.hrtime.bigint` anchored at
+* module load), millisecond elsewhere.
+*/
 function systemUTCEpochNanoseconds() {
-  if (_hrtimeBigint) {
-    const elapsedNs = _hrtimeBigint() - _anchorHrns;
-    return _anchorWallMs * _NS_PER_MS + elapsedNs;
-  }
-  return (0, import_globals.BigIntCtor)((0, import_date.DateNow)()) * _NS_PER_MS;
+	if (_hrtimeBigint) {
+		const elapsedNs = _hrtimeBigint() - _anchorHrns;
+		return _anchorWallMs * _NS_PER_MS + elapsedNs;
+	}
+	/* c8 ignore next - Non-Node runtime fallback; tests always run under Node
+	where _hrtimeBigint is bound from process.hrtime.bigint. */
+	return require_primordials_globals.BigIntCtor(require_primordials_date.DateNow()) * _NS_PER_MS;
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  systemUTCEpochNanoseconds
-});
+
+//#endregion
+exports.systemUTCEpochNanoseconds = systemUTCEpochNanoseconds;

package/dist/temporal/temporal.js

@@ -1,43 +1,13 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_temporal_instant = require('./instant.js');
+const require_temporal_now = require('./now.js');
+
+exports.Instant = require_temporal_instant.Instant;
+Object.defineProperty(exports, 'Now', {
+  enumerable: true,
+  get: function () {
+    return require_temporal_now.now_exports;
   }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var temporal_exports = {};
-__export(temporal_exports, {
-  Instant: () => import_instant.Instant,
-  Now: () => Now
-});
-module.exports = __toCommonJS(temporal_exports);
-var Now = __toESM(require("./now"));
-var import_instant = require("./instant");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  Instant,
-  Now
-});
+});

package/dist/themes/context.js

@@ -1,87 +1,149 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var context_exports = {};
-__export(context_exports, {
-  emitThemeChange: () => emitThemeChange,
-  getAsyncHooks: () => getAsyncHooks,
-  getTheme: () => getTheme,
-  onThemeChange: () => onThemeChange,
-  setTheme: () => setTheme,
-  withTheme: () => withTheme,
-  withThemeSync: () => withThemeSync
-});
-module.exports = __toCommonJS(context_exports);
-var import_themes = require("./themes");
-var import_map_set = require("../primordials/map-set");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_primordials_map_set = require('../primordials/map-set.js');
+const require_themes_themes = require('./themes.js');
+
+//#region src/themes/context.ts
 let _async_hooks;
+/**
+* Emit theme change event to listeners.
+*
+* @private
+*/
 function emitThemeChange(theme) {
-  for (const listener of listeners) {
-    listener(theme);
-  }
+	for (const listener of listeners) listener(theme);
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Lazily load the async_hooks module to avoid Webpack errors.
+*
+* @private
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getAsyncHooks() {
-  if (_async_hooks === void 0) {
-    _async_hooks = require("node:async_hooks");
-  }
-  return _async_hooks;
+	if (_async_hooks === void 0) _async_hooks = /* @__PURE__ */ require("node:async_hooks");
+	return _async_hooks;
 }
+/**
+* AsyncLocalStorage for theme context isolation.
+*/
 const { AsyncLocalStorage } = /* @__PURE__ */ getAsyncHooks();
 const themeStorage = new AsyncLocalStorage();
-let fallbackTheme = import_themes.SOCKET_THEME;
-const listeners = new import_map_set.SetCtor();
+/**
+* Fallback theme for global context.
+*/
+let fallbackTheme = require_themes_themes.SOCKET_THEME;
+/**
+* Registered theme change listeners.
+*/
+const listeners = new require_primordials_map_set.SetCtor();
+/**
+* Get the active theme from context.
+*
+* @example
+*   ;```ts
+*   const theme = getTheme()
+*   console.log(theme.displayName)
+*   ```
+*
+* @returns Current theme
+*/
 function getTheme() {
-  return themeStorage.getStore() ?? fallbackTheme;
+	return themeStorage.getStore() ?? fallbackTheme;
 }
+/**
+* Subscribe to theme change events.
+*
+* @example
+*   ;```ts
+*   const unsubscribe = onThemeChange(theme => {
+*     console.log('Theme:', theme.displayName)
+*   })
+*
+*   // Cleanup
+*   unsubscribe()
+*   ```
+*
+* @param listener - Change handler.
+*
+* @returns Unsubscribe function
+*/
 function onThemeChange(listener) {
-  listeners.add(listener);
-  return () => {
-    listeners.delete(listener);
-  };
+	listeners.add(listener);
+	return () => {
+		listeners.delete(listener);
+	};
 }
+/**
+* Set the global fallback theme.
+*
+* @example
+*   ;```ts
+*   setTheme('socket-firewall')
+*   ```
+*
+* @param theme - Theme name or object.
+*/
 function setTheme(theme) {
-  fallbackTheme = typeof theme === "string" ? import_themes.THEMES[theme] ?? fallbackTheme : theme;
-  emitThemeChange(fallbackTheme);
+	fallbackTheme = typeof theme === "string" ? require_themes_themes.THEMES[theme] ?? fallbackTheme : theme;
+	emitThemeChange(fallbackTheme);
 }
+/**
+* Execute async operation with scoped theme. Theme automatically restored on
+* completion.
+*
+* @example
+*   ;```ts
+*   await withTheme('ultra', async () => {
+*     // Operations use Ultra theme
+*   })
+*   ```
+*
+* @template T - Return type.
+*
+* @param theme - Scoped theme.
+* @param fn - Async operation.
+*
+* @returns Operation result
+*/
 async function withTheme(theme, fn) {
-  const resolvedTheme = typeof theme === "string" ? import_themes.THEMES[theme] ?? fallbackTheme : theme;
-  return await themeStorage.run(resolvedTheme, async () => {
-    emitThemeChange(resolvedTheme);
-    return await fn();
-  });
+	const resolvedTheme = typeof theme === "string" ? require_themes_themes.THEMES[theme] ?? fallbackTheme : theme;
+	return await themeStorage.run(resolvedTheme, async () => {
+		emitThemeChange(resolvedTheme);
+		return await fn();
+	});
 }
+/**
+* Execute sync operation with scoped theme. Theme automatically restored on
+* completion.
+*
+* @example
+*   ;```ts
+*   const result = withThemeSync('coana', () => {
+*     return processData()
+*   })
+*   ```
+*
+* @template T - Return type.
+*
+* @param theme - Scoped theme.
+* @param fn - Sync operation.
+*
+* @returns Operation result
+*/
 function withThemeSync(theme, fn) {
-  const resolvedTheme = typeof theme === "string" ? import_themes.THEMES[theme] ?? fallbackTheme : theme;
-  return themeStorage.run(resolvedTheme, () => {
-    emitThemeChange(resolvedTheme);
-    return fn();
-  });
+	const resolvedTheme = typeof theme === "string" ? require_themes_themes.THEMES[theme] ?? fallbackTheme : theme;
+	return themeStorage.run(resolvedTheme, () => {
+		emitThemeChange(resolvedTheme);
+		return fn();
+	});
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  emitThemeChange,
-  getAsyncHooks,
-  getTheme,
-  onThemeChange,
-  setTheme,
-  withTheme,
-  withThemeSync
-});
+
+//#endregion
+exports.emitThemeChange = emitThemeChange;
+exports.getAsyncHooks = getAsyncHooks;
+exports.getTheme = getTheme;
+exports.onThemeChange = onThemeChange;
+exports.setTheme = setTheme;
+exports.withTheme = withTheme;
+exports.withThemeSync = withThemeSync;