@ariestools/sdk 7.0.7 → 7.0.8

package/dist/neutral/fetch.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/modules/fetch/FetchError.ts", "../../src/modules/fetch/fetchCompress.ts", "../../src/modules/fetch/parseJson.ts", "../../src/modules/fetch/FetchClient.ts", "../../src/modules/fetch/fetchJson.ts", "../../src/modules/fetch/FetchJsonClient.ts", "../../src/modules/fetch/methods.ts"],
+  "sourcesContent": ["import type { FetchJsonResponse } from './types.ts'\n\n/**\n * Classification of why a fetch request failed.\n * - `dns` \u2014 host could not be resolved (ENOTFOUND, EAI_AGAIN)\n * - `connection-refused` \u2014 the host actively refused the connection (ECONNREFUSED)\n * - `connection-reset` \u2014 the connection was reset/broken mid-flight (ECONNRESET, EPIPE)\n * - `connection-timeout` \u2014 the connection could not be established in time (ETIMEDOUT)\n * - `timeout` \u2014 the request exceeded its time budget (AbortSignal.timeout, undici header/body timeouts)\n * - `aborted` \u2014 the request was aborted by an AbortController\n * - `tls` \u2014 a TLS/certificate problem (expired, self-signed, hostname mismatch, ...)\n * - `unreachable` \u2014 the host or network is unreachable (EHOSTUNREACH, ENETUNREACH)\n * - `http-status` \u2014 the response arrived but its status was rejected by validateStatus\n * - `parse` \u2014 a successful response had a non-empty body that could not be parsed as JSON\n * - `network` \u2014 a generic network failure with no recognizable cause (e.g. browser \"Failed to fetch\")\n * - `unknown` \u2014 the failure could not be classified\n */\nexport type FetchErrorType\n  = | 'dns'\n    | 'connection-refused'\n    | 'connection-reset'\n    | 'connection-timeout'\n    | 'timeout'\n    | 'aborted'\n    | 'tls'\n    | 'unreachable'\n    | 'http-status'\n    | 'parse'\n    | 'network'\n    | 'unknown'\n\n/** Brand value stamped on every FetchError, used by isFetchError for robust cross-realm detection. */\nconst fetchErrorMarker = '$$xylabs-fetch-error'\n\n/** Maps known Node/undici system error codes to a FetchErrorType. */\nconst codeTypes: Record<string, FetchErrorType> = {\n  ENOTFOUND: 'dns',\n  EAI_AGAIN: 'dns',\n  ECONNREFUSED: 'connection-refused',\n  ECONNRESET: 'connection-reset',\n  EPIPE: 'connection-reset',\n  ETIMEDOUT: 'connection-timeout',\n  UND_ERR_CONNECT_TIMEOUT: 'connection-timeout',\n  UND_ERR_HEADERS_TIMEOUT: 'timeout',\n  UND_ERR_BODY_TIMEOUT: 'timeout',\n  EHOSTUNREACH: 'unreachable',\n  ENETUNREACH: 'unreachable',\n  CERT_HAS_EXPIRED: 'tls',\n  DEPTH_ZERO_SELF_SIGNED_CERT: 'tls',\n  UNABLE_TO_VERIFY_LEAF_SIGNATURE: 'tls',\n  SELF_SIGNED_CERT_IN_CHAIN: 'tls',\n  ERR_TLS_CERT_ALTNAME_INVALID: 'tls',\n}\n\n/** Extracts a string `code` by walking the error and its `cause` chain. */\nfunction findErrorCode(error: unknown): string | undefined {\n  let current = error\n  for (let depth = 0; depth < 8 && current instanceof Error; depth++) {\n    const code = (current as { code?: unknown }).code\n    if (typeof code === 'string') return code\n    current = (current as { cause?: unknown }).cause\n  }\n  return undefined\n}\n\nfunction typeFromCode(code: string): FetchErrorType | undefined {\n  if (Object.hasOwn(codeTypes, code)) return codeTypes[code]\n  if (code.startsWith('CERT_') || code.startsWith('ERR_TLS_')) return 'tls'\n  return undefined\n}\n\n/**\n * Classifies a raw error thrown by native `fetch` (or its `cause` chain) into a FetchErrorType.\n * Recognizes DNS, connection, TLS, timeout and abort failures from Node/undici system codes\n * and DOMException names, falling back to `network` for generic failures and `unknown` otherwise.\n */\nexport function classifyFetchError(error: unknown): { code?: string; type: FetchErrorType } {\n  if (error instanceof Error) {\n    if (error.name === 'TimeoutError') return { type: 'timeout' }\n    if (error.name === 'AbortError') return { type: 'aborted' }\n  }\n\n  const code = findErrorCode(error)\n  if (code !== undefined) {\n    const type = typeFromCode(code)\n    if (type !== undefined) return { type, code }\n    return { type: 'unknown', code }\n  }\n\n  if (error instanceof TypeError && /fetch failed|failed to fetch|network/i.test(error.message)) {\n    return { type: 'network' }\n  }\n\n  return { type: 'unknown' }\n}\n\n/** Context attached to a FetchError describing the request and (when available) the response. */\nexport interface FetchErrorContext {\n  /** Raw response body text \u2014 set for `parse` errors so the unparseable payload can be inspected. */\n  body?: string\n  cause?: unknown\n  code?: string\n  method?: string\n  response?: FetchJsonResponse<unknown>\n  status?: number\n  statusText?: string\n  type?: FetchErrorType\n  url?: string\n}\n\n/** Plain serializable shape of a FetchError, safe for logging/telemetry (no circular refs). */\nexport interface FetchErrorJson {\n  code?: string\n  message: string\n  method?: string\n  name: string\n  status?: number\n  statusText?: string\n  type: FetchErrorType\n  url?: string\n}\n\n/**\n * Structured error for every failure mode of the #fetch stack.\n * Carries a classified `type`, the underlying system `code` (when known), request context\n * (`url`, `method`) and, for HTTP-status failures, the parsed `response`. The original error\n * is preserved on `cause`. Detect with {@link isFetchError}.\n */\nexport class FetchError extends Error {\n  readonly __fetchErrorMarker = fetchErrorMarker\n  readonly body?: string\n  readonly code?: string\n  readonly method?: string\n  readonly response?: FetchJsonResponse<unknown>\n  readonly status?: number\n  readonly statusText?: string\n  readonly type: FetchErrorType\n  readonly url?: string\n\n  constructor(message: string, context: FetchErrorContext = {}) {\n    super(message, { cause: context.cause })\n    this.name = 'FetchError'\n    this.type = context.type ?? 'unknown'\n    this.code = context.code\n    this.url = context.url\n    this.method = context.method\n    this.status = context.status\n    this.statusText = context.statusText\n    this.response = context.response\n    this.body = context.body\n  }\n\n  toJSON(): FetchErrorJson {\n    return {\n      name: this.name,\n      message: this.message,\n      type: this.type,\n      code: this.code,\n      url: this.url,\n      method: this.method,\n      status: this.status,\n      statusText: this.statusText,\n    }\n  }\n}\n\n/** Type guard: true for any FetchError we built, robust across bundle/realm copies via a brand marker. */\nexport function isFetchError(value: unknown): value is FetchError {\n  return (\n    value instanceof FetchError\n    || (typeof value === 'object'\n      && value !== null\n      && (value as { __fetchErrorMarker?: unknown }).__fetchErrorMarker === fetchErrorMarker)\n  )\n}\n\n/**\n * Wraps a raw thrown error into a structured FetchError, classifying network failures.\n * Idempotent: an existing FetchError is returned unchanged so wrapping at multiple layers is safe.\n */\nexport function toFetchError(error: unknown, context: { method?: string; url?: string } = {}): FetchError {\n  if (isFetchError(error)) return error\n  const { type, code } = classifyFetchError(error)\n  const message = error instanceof Error ? error.message : String(error)\n  return new FetchError(message, {\n    ...context, type, code, cause: error,\n  })\n}\n", "import { toFetchError } from './FetchError.ts'\n\nexport interface FetchCompressOptions extends RequestInit {\n  /** Gzip payloads larger than this byte count. */\n  compressMinLength?: number\n}\n\nasync function gzipString(body: string): Promise<ArrayBuffer> {\n  const blob = new Blob([body])\n  const stream = blob.stream().pipeThrough(new CompressionStream('gzip'))\n  const response = new Response(stream)\n  return response.arrayBuffer()\n}\n\n/**\n * Drop-in replacement for native `fetch` that optionally gzip-compresses the request body.\n * When `compressMinLength` is set and the body string exceeds that threshold, the body is\n * gzip-compressed using native compression and `Content-Encoding: gzip` is added to the headers.\n * Returns a standard `Response` \u2014 identical to what native `fetch` returns.\n */\nexport async function fetchCompress(url: string | URL, options: FetchCompressOptions = {}): Promise<Response> {\n  const { compressMinLength = 1024, ...init } = options\n\n  try {\n    if (init.body !== undefined && init.body !== null) {\n      const bodyStr = typeof init.body === 'string' ? init.body : JSON.stringify(init.body)\n      if (bodyStr.length > compressMinLength) {\n        const headers = new Headers(init.headers)\n        headers.set('Content-Encoding', 'gzip')\n        return await fetch(url, {\n          ...init,\n          body: await gzipString(bodyStr),\n          headers,\n        })\n      }\n    }\n\n    return await fetch(url, init)\n  } catch (error) {\n    throw toFetchError(error, { url: url.toString(), method: init.method })\n  }\n}\n", "import { FetchError, toFetchError } from './FetchError.ts'\n\n/**\n * Reads and JSON-parses a response body. An empty or whitespace-only body resolves to `null`\n * (so 204/304/HEAD and other empty responses are not treated as failures). A non-empty body that\n * cannot be parsed throws a FetchError of type `parse` carrying the raw body and status. A failure\n * while reading the body stream (e.g. a dropped connection) is classified as a network FetchError.\n */\nexport async function parseJsonResponse<T>(response: Response, context: { method?: string; url?: string } = {}): Promise<T | null> {\n  let text: string\n  try {\n    text = await response.text()\n  } catch (error) {\n    throw toFetchError(error, context)\n  }\n  if (text.trim() === '') return null\n  try {\n    return JSON.parse(text) as T\n  } catch (error) {\n    throw new FetchError('Failed to parse response body as JSON', {\n      type: 'parse',\n      url: context.url,\n      method: context.method,\n      status: response.status,\n      statusText: response.statusText,\n      body: text,\n      cause: error,\n    })\n  }\n}\n\n/**\n * Best-effort JSON parse for non-success responses: returns `null` on any failure\n * (empty body, malformed body, or read error) so the response can still be surfaced for inspection.\n */\nexport async function tryParseJson<T>(response: Response): Promise<T | null> {\n  try {\n    const text = await response.text()\n    if (text.trim() === '') return null\n    return JSON.parse(text) as T\n  } catch {\n    return null\n  }\n}\n", "import { fetchCompress } from './fetchCompress.ts'\nimport { FetchError } from './FetchError.ts'\nimport { parseJsonResponse, tryParseJson } from './parseJson.ts'\nimport type { FetchJsonOptions, FetchJsonResponse } from './types.ts'\n\n/** Configuration for a FetchClient instance. */\nexport interface FetchClientConfig extends Omit<FetchJsonOptions, 'method' | 'body'> {\n  baseURL?: string\n  params?: Record<string, string>\n  timeout?: number\n  /**\n   * Determines whether a given HTTP status code should resolve or throw.\n   * Returns true to resolve, false to throw a FetchClientError (a FetchError of type 'http-status').\n   * Default: status >= 200 && status < 300 (like Axios).\n   */\n  validateStatus?: ((status: number) => boolean) | null\n}\n\n/** Per-request config, extending the instance defaults. */\nexport interface FetchClientRequestConfig extends FetchClientConfig {\n  data?: unknown\n  method?: string\n  url?: string\n}\n\n/**\n * HTTP-status error thrown when validateStatus rejects the response status code.\n * Specialization of {@link FetchError} (type 'http-status') that also exposes the request `config`.\n * `isFetchError` and `instanceof FetchError` both return true for it.\n */\nexport class FetchClientError<T = unknown> extends FetchError {\n  readonly config: FetchClientRequestConfig\n  declare readonly response: FetchJsonResponse<T>\n\n  constructor(message: string, response: FetchJsonResponse<T>, config: FetchClientRequestConfig) {\n    super(message, {\n      type: 'http-status',\n      url: config.url,\n      method: config.method,\n      status: response.status,\n      statusText: response.statusText,\n      response,\n    })\n    this.name = 'FetchClientError'\n    this.config = config\n  }\n}\n\nfunction buildHeaders(custom?: RequestInit['headers'], includeContentType = false): Headers {\n  const headers = new Headers()\n  headers.set('Accept', 'application/json, text/plain, *.*')\n  if (includeContentType) {\n    headers.set('Content-Type', 'application/json')\n  }\n  if (custom) {\n    const merged = new Headers(custom)\n    for (const [key, value] of merged.entries()) headers.set(key, value)\n  }\n  return headers\n}\n\nfunction buildURL(config: FetchClientRequestConfig): string {\n  const base = config.baseURL ?? ''\n  const path = config.url ?? ''\n  const url = base === '' ? new URL(path) : new URL(path, base)\n  if (config.params) {\n    for (const [key, value] of Object.entries(config.params)) {\n      url.searchParams.set(key, value)\n    }\n  }\n  return url.href\n}\n\n/**\n * Stateful, instance-based HTTP client backed by native fetch with\n * JSON serialization and optional gzip compression via #fetch.\n */\nexport class FetchClient {\n  defaults: FetchClientConfig\n\n  constructor(defaults: FetchClientConfig = {}) {\n    this.defaults = defaults\n  }\n\n  static create(config?: FetchClientConfig): FetchClient {\n    return new FetchClient(config)\n  }\n\n  delete<T = unknown>(url: string, config?: FetchClientConfig): Promise<FetchJsonResponse<T>> {\n    return this.request<T>({\n      ...config, url, method: 'DELETE',\n    })\n  }\n\n  get<T = unknown>(url: string, config?: FetchClientConfig): Promise<FetchJsonResponse<T>> {\n    return this.request<T>({\n      ...config, url, method: 'GET',\n    })\n  }\n\n  patch<T = unknown>(url: string, data?: unknown, config?: FetchClientConfig): Promise<FetchJsonResponse<T>> {\n    return this.request<T>({\n      ...config, url, data, method: 'PATCH',\n    })\n  }\n\n  post<T = unknown>(url: string, data?: unknown, config?: FetchClientConfig): Promise<FetchJsonResponse<T>> {\n    return this.request<T>({\n      ...config, url, data, method: 'POST',\n    })\n  }\n\n  put<T = unknown>(url: string, data?: unknown, config?: FetchClientConfig): Promise<FetchJsonResponse<T>> {\n    return this.request<T>({\n      ...config, url, data, method: 'PUT',\n    })\n  }\n\n  async request<T = unknown>(config: FetchClientRequestConfig): Promise<FetchJsonResponse<T>> {\n    const merged: FetchClientRequestConfig = { ...this.defaults, ...config }\n    const url = buildURL(merged)\n\n    const init: FetchJsonOptions = {\n      method: merged.method ?? 'GET',\n      headers: buildHeaders(merged.headers, merged.data !== undefined),\n      compressMinLength: merged.compressMinLength,\n      signal: merged.timeout !== undefined && merged.timeout !== 0 ? AbortSignal.timeout(merged.timeout) : merged.signal,\n    }\n\n    if (merged.data !== undefined) {\n      init.body = JSON.stringify(merged.data)\n    }\n\n    const response = await fetchCompress(url, init)\n\n    const data = response.ok\n      ? await parseJsonResponse<T>(response, { url, method: merged.method })\n      : await tryParseJson<T>(response)\n\n    const result: FetchJsonResponse<T> = {\n      data,\n      headers: response.headers,\n      response,\n      status: response.status,\n      statusText: response.statusText,\n    }\n\n    const validateStatus = merged.validateStatus === undefined\n      ? (s: number) => s >= 200 && s < 300\n      : merged.validateStatus\n\n    if (validateStatus && !validateStatus(response.status)) {\n      throw new FetchClientError(\n        `Request failed with status ${response.status} ${response.statusText}`,\n        result,\n        { ...merged, url },\n      )\n    }\n\n    return result\n  }\n}\n", "import { fetchCompress } from './fetchCompress.ts'\nimport { parseJsonResponse, tryParseJson } from './parseJson.ts'\nimport type {\n  FetchJsonOptions,\n  FetchJsonResponse,\n} from './types.ts'\n\nfunction buildHeaders(custom?: RequestInit['headers'], includeContentType = false): Headers {\n  const headers = new Headers()\n  headers.set('Accept', 'application/json, text/plain, *.*')\n  if (includeContentType) {\n    headers.set('Content-Type', 'application/json')\n  }\n  if (custom) {\n    const merged = new Headers(custom)\n    for (const [key, value] of merged.entries()) headers.set(key, value)\n  }\n  return headers\n}\n\n/**\n * JSON-configured fetch with optional gzip compression on request bodies.\n * Request bodies exceeding `compressMinLength` bytes are gzip-compressed using native compression.\n */\nexport async function fetchJson<T>(url: string, options: FetchJsonOptions = {}): Promise<FetchJsonResponse<T>> {\n  const { headers: customHeaders, ...rest } = options\n\n  const response = await fetchCompress(url, {\n    ...rest,\n    headers: buildHeaders(customHeaders, rest.body !== undefined && rest.body !== null),\n  })\n\n  const data = response.ok\n    ? await parseJsonResponse<T>(response, { url, method: rest.method })\n    : await tryParseJson<T>(response)\n\n  return {\n    data,\n    headers: response.headers,\n    response,\n    status: response.status,\n    statusText: response.statusText,\n  }\n}\n", "import type { FetchClientConfig } from './FetchClient.ts'\nimport { FetchClient } from './FetchClient.ts'\n\n/**\n * Pre-configured FetchClient for JSON APIs with optional gzip compression.\n * Drop-in replacement for `@xylabs/axios`'s `axiosJson` / `AxiosJson`.\n *\n * Default behavior matches axiosJsonConfig():\n * - JSON Accept/Content-Type headers\n * - Request bodies > compressMinLength (default 1024) are gzip-compressed\n * - Responses are parsed as JSON\n * - Non-2xx status codes throw (like Axios default)\n */\nexport class FetchJsonClient extends FetchClient {\n  constructor(config?: FetchClientConfig) {\n    super(config)\n  }\n\n  static override create(config?: FetchClientConfig): FetchJsonClient {\n    return new FetchJsonClient(config)\n  }\n}\n\n/** Ready-to-use JSON fetch client, equivalent to `axiosJson` from `@xylabs/axios`. */\nexport const fetchJsonClient = new FetchJsonClient()\n", "import { fetchJson } from './fetchJson.ts'\nimport type {\n  FetchJsonOptions,\n  FetchJsonResponse,\n} from './types.ts'\n\n/** JSON GET request. */\nexport function fetchJsonGet<T>(url: string, options?: FetchJsonOptions): Promise<FetchJsonResponse<T>> {\n  return fetchJson<T>(url, { ...options, method: 'GET' })\n}\n\n/** JSON POST request with a body. */\nexport function fetchJsonPost<T>(url: string, data?: unknown, options?: FetchJsonOptions): Promise<FetchJsonResponse<T>> {\n  return fetchJson<T>(url, {\n    ...options,\n    body: JSON.stringify(data),\n    method: 'POST',\n  })\n}\n\n/** JSON PUT request with a body. */\nexport function fetchJsonPut<T>(url: string, data?: unknown, options?: FetchJsonOptions): Promise<FetchJsonResponse<T>> {\n  return fetchJson<T>(url, {\n    ...options,\n    body: JSON.stringify(data),\n    method: 'PUT',\n  })\n}\n\n/** JSON PATCH request with a body. */\nexport function fetchJsonPatch<T>(url: string, data?: unknown, options?: FetchJsonOptions): Promise<FetchJsonResponse<T>> {\n  return fetchJson<T>(url, {\n    ...options,\n    body: JSON.stringify(data),\n    method: 'PATCH',\n  })\n}\n\n/** JSON DELETE request. */\nexport function fetchJsonDelete<T>(url: string, options?: FetchJsonOptions): Promise<FetchJsonResponse<T>> {\n  return fetchJson<T>(url, { ...options, method: 'DELETE' })\n}\n"],
+  "mappings": "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",
+  "names": ["buildHeaders"]
+}

package/dist/neutral/fetch.model.d.ts

@@ -1 +1,2 @@
-export type * from '../_pkg/fetch/neutral/model.ts'
+export type * from './modules/fetch/model.js';
+//# sourceMappingURL=fetch.model.d.ts.map

package/dist/neutral/fetch.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.model.d.ts","sourceRoot":"","sources":["../../src/fetch.model.ts"],"names":[],"mappings":"AAAA,mBAAmB,cAAc,CAAA"}

package/dist/neutral/fetch.model.mjs

@@ -1 +1 @@
-export * from '../_pkg/fetch/neutral/model.mjs'
+//# sourceMappingURL=fetch.model.mjs.map

package/dist/neutral/fetch.model.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/neutral/forget.d.ts

@@ -1 +1,2 @@
-export * from '../_pkg/forget/neutral/index.ts'
+export * from './modules/forget/index.js';
+//# sourceMappingURL=forget.d.ts.map

package/dist/neutral/forget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forget.d.ts","sourceRoot":"","sources":["../../src/forget.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA"}

package/dist/neutral/forget.mjs

@@ -1 +1,253 @@
-export * from '../_pkg/forget/neutral/index.mjs'
+// src/modules/forget/ForgetConfig.ts
+var defaultForgetConfig = { timeout: 3e4 };
+
+// src/modules/forget/ForgetNodeConfig.ts
+var defaultForgetNodeConfig = {
+  ...defaultForgetConfig,
+  terminateOnTimeout: false,
+  terminateOnException: false
+};
+
+// src/modules/assert/assertEx.ts
+function assertEx(expr, func) {
+  if (expr !== void 0 && expr !== null && expr !== false && expr !== 0 && expr !== "" && expr !== 0n) return expr;
+  if (typeof func === "function") {
+    const errorOrMessage = func(expr);
+    throw typeof errorOrMessage === "string" ? new Error(errorOrMessage) : errorOrMessage;
+  }
+  if (func !== void 0) {
+    throw new Error("Invalid assertEx usage: second argument must be a function or undefined");
+  }
+  throw new Error("Assertion failed");
+}
+
+// src/modules/timer/setTimeoutEx.ts
+var TimerScheduler = class {
+  currentTimeout;
+  interval = -1;
+  timeouts = [];
+  /**
+   * Cancels a timeout previously created with setTimeoutEx.
+   * @param id - The timeout ID returned by setTimeoutEx.
+   */
+  clearTimeoutEx(id) {
+    this.timeouts = this.timeouts.filter((timeout) => timeout.id !== id);
+    this.update(this.timeouts);
+  }
+  /** Clears all scheduled timeouts and resets internal state. */
+  reset() {
+    this.interval = -1;
+    clearTimeout(this.currentTimeout);
+    this.currentTimeout = void 0;
+    this.timeouts = [];
+  }
+  /**
+   * Sets a timeout using an optimized internal timer that coalesces multiple timeouts into a single native timer.
+   * @param func - The function to call after the delay.
+   * @param delay - The delay in milliseconds (must be >= 0).
+   * @returns A unique string ID that can be used with clearTimeoutEx to cancel the timeout.
+   */
+  setTimeoutEx(func, delay2) {
+    assertEx(delay2 >= 0, () => "delay must be >= 0");
+    const id = `${Date.now()}|${Math.random() * 9999999999}`;
+    this.timeouts.push({
+      delay: delay2,
+      func,
+      id
+    });
+    this.update();
+    return id;
+  }
+  timerFunc() {
+    const notFiring = this.timeouts.filter((timeout) => timeout.delay > this.interval);
+    const firing = this.timeouts.filter((timeout) => timeout.delay <= this.interval);
+    this.update(notFiring, this.interval);
+    for (const timeout of firing) {
+      timeout.func();
+    }
+  }
+  update(newTimeouts = this.timeouts, delayPassed = 0) {
+    if (newTimeouts.length === 0) {
+      this.reset();
+    } else {
+      const newInterval = Math.min(...newTimeouts.map((timeout) => timeout.delay));
+      if (newInterval === this.interval && this.currentTimeout !== void 0) {
+        return;
+      }
+      clearTimeout(this.currentTimeout);
+      this.timeouts = newTimeouts.map((timeout) => ({
+        delay: timeout.delay - delayPassed,
+        func: timeout.func,
+        id: timeout.id
+      }));
+      this.interval = newInterval;
+      this.currentTimeout = setTimeout(() => this.timerFunc(), this.interval);
+    }
+  }
+};
+var defaultTimerScheduler = new TimerScheduler();
+var setTimeoutEx = (func, delay2) => defaultTimerScheduler.setTimeoutEx(func, delay2);
+
+// src/modules/delay/delay.ts
+var delay = (ms) => {
+  return new Promise((resolve) => setTimeoutEx(() => resolve(), ms));
+};
+
+// src/modules/typeof/is.ts
+function isNumber(value) {
+  return typeof value === "number";
+}
+function isPromise(value) {
+  return value instanceof Promise;
+}
+
+// src/modules/forget/ForgetPromise.ts
+var ForgetPromise = class {
+  /**
+   * Number of forgotten promises still running (not yet settled).
+   * Decremented only when the underlying promise fulfills or rejects — not when a timeout fires.
+   */
+  static activeForgets = 0;
+  /** Number of forgotten promises that threw exceptions. */
+  static exceptedForgets = 0;
+  /** Logger instance used for error and warning output. */
+  static logger = console;
+  /** Whether any forgotten promises are still running, including any that have exceeded their timeout. */
+  static get active() {
+    return this.activeForgets > 0;
+  }
+  /**
+   * Waits until all forgotten promises have settled.
+   * @param interval - Polling interval in milliseconds.
+   * @param timeout - Optional maximum wait time in milliseconds.
+   * @returns `0` when every forgotten promise has settled; otherwise the number still running.
+   * A non-zero return after `timeout` elapses can include promises whose timeout callback already
+   * ran but whose work is still in flight.
+   */
+  static async awaitInactive(interval = 100, timeout) {
+    let timeoutRemaining = timeout;
+    while (this.active) {
+      await delay(interval);
+      if (timeoutRemaining !== void 0) {
+        timeoutRemaining -= interval;
+        if (timeoutRemaining <= 0) {
+          return this.activeForgets;
+        }
+      }
+    }
+    return 0;
+  }
+  /** Handles exceptions from forgotten promises by logging error details. */
+  static exceptionHandler(error, { name }, externalStackTrace) {
+    this.logger.error(`forget promise handler excepted [${name}]: ${error.message}`, error);
+    if (externalStackTrace !== void 0) {
+      this.logger.warn(`External Stack trace [${name}]:`, externalStackTrace);
+    }
+  }
+  /**
+   * Used to explicitly launch an async function (or Promise) with awaiting it
+   * @param promise The promise to forget
+   * @param config Configuration of forget settings
+   */
+  static forget(promise, config) {
+    const stackError = new Error("Stack");
+    const externalStackTrace = stackError.stack;
+    const resolvedConfig = {
+      ...defaultForgetConfig,
+      ...globalThis.xy?.forget?.config,
+      ...config
+    };
+    const resolvedPromise = typeof promise === "function" ? promise() : promise;
+    if (isPromise(resolvedPromise)) {
+      try {
+        let isCompleted = false;
+        this.activeForgets++;
+        const promiseWrapper = async () => {
+          try {
+            const result = await resolvedPromise;
+            this.activeForgets--;
+            isCompleted = true;
+            resolvedConfig?.onComplete?.([result, void 0]);
+          } catch (error) {
+            const caughtError = error instanceof Error ? error : new Error(String(error));
+            this.activeForgets--;
+            isCompleted = true;
+            this.logger.error(`forgotten promise excepted [${config?.name ?? "unknown"}]: ${caughtError.message}`, caughtError);
+            resolvedConfig?.onComplete?.([void 0, caughtError]);
+          }
+        };
+        const promises = [promiseWrapper()];
+        const timeout = resolvedConfig.timeout ?? defaultForgetConfig.timeout;
+        if (isNumber(timeout)) {
+          const timeoutFunc = async () => {
+            await delay(timeout);
+            if (!isCompleted) {
+              resolvedConfig.onCancel?.();
+              this.timeoutHandler(timeout, resolvedConfig, externalStackTrace);
+            }
+          };
+          promises.push(timeoutFunc());
+        }
+        const race = Promise.race(promises);
+        void race.catch(() => {
+        });
+      } catch (ex) {
+        this.exceptedForgets += 1;
+        resolvedConfig?.onException?.(ex);
+        this.exceptionHandler(ex, resolvedConfig, externalStackTrace);
+      }
+    } else {
+      return;
+    }
+  }
+  /**
+   * Handles timeout events for forgotten promises by logging timeout details.
+   * Does not terminate the underlying promise; it may continue running after this is called.
+   */
+  static timeoutHandler(time, { name = "unknown" }, externalStackTrace) {
+    this.logger.error(`forget promise timed out after ${time}ms [still running] [${name}]`);
+    if (externalStackTrace !== void 0) {
+      this.logger.warn(`External Stack trace [${name}]:`, externalStackTrace);
+    }
+  }
+};
+
+// src/modules/forget/ForgetPromiseNode.ts
+var ForgetPromiseNode = class extends ForgetPromise {
+  /** Handles exceptions, optionally terminating the process based on config. */
+  static exceptionHandler(error, config, externalStackTrace) {
+    super.exceptionHandler(error, config, externalStackTrace);
+    if (config?.terminateOnException === true) {
+      this.logger.error(`Attempting to terminate process [${config?.name ?? "unknown"}]...`);
+      process.exit(1);
+    }
+  }
+  /** Forgets a promise using Node.js-specific configuration with process termination support. */
+  static forget(promise, config) {
+    const resolvedConfig = {
+      ...defaultForgetNodeConfig,
+      ...globalThis.xy?.forget?.config,
+      ...config
+    };
+    super.forget(promise, resolvedConfig);
+  }
+  /** Handles timeouts, optionally terminating the process based on config. */
+  static timeoutHandler(time, config, externalStackTrace) {
+    super.timeoutHandler(time, config, externalStackTrace);
+    if (config?.terminateOnTimeout === true) {
+      this.logger.error(`Attempting to terminate process [${config?.name ?? "unknown"}]...`);
+      process.exit(2);
+    }
+  }
+};
+
+// src/modules/forget/forgetNode.ts
+var forgetNode = (promise, config) => {
+  ForgetPromiseNode.forget(promise, config);
+};
+export {
+  ForgetPromiseNode as ForgetPromise,
+  defaultForgetNodeConfig,
+  forgetNode as forget
+};
+//# sourceMappingURL=forget.mjs.map

package/dist/neutral/forget.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/modules/forget/ForgetConfig.ts", "../../src/modules/forget/ForgetNodeConfig.ts", "../../src/modules/assert/assertEx.ts", "../../src/modules/timer/setTimeoutEx.ts", "../../src/modules/delay/delay.ts", "../../src/modules/typeof/is.ts", "../../src/modules/forget/ForgetPromise.ts", "../../src/modules/forget/ForgetPromiseNode.ts", "../../src/modules/forget/forgetNode.ts"],
+  "sourcesContent": ["/**\n * Configuration options for fire-and-forget promises.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport interface ForgetConfig<T = any> {\n  /** Optional name for identifying the forgotten promise in logs. */\n  name?: string\n  /** Called when the configured timeout elapses before the promise settles. The promise keeps running. */\n  onCancel?: () => void\n  /** Called when the promise completes, with a tuple of [result, error]. */\n  onComplete?: (result: [T | undefined, Error | undefined]) => void\n  /** Called when an exception occurs outside the promise itself. */\n  onException?: (error: Error) => void\n  /**\n   * Timeout in milliseconds after which `onCancel` and `timeoutHandler` run.\n   * This does not abort the promise; `activeForgets` stays elevated until it settles.\n   */\n  timeout?: number\n}\n\n/** Default forget configuration with a 30-second timeout. */\nexport const defaultForgetConfig: ForgetConfig<unknown> = { timeout: 30_000 }\n", "import { defaultForgetConfig, type ForgetConfig } from './ForgetConfig.ts'\n\n/**\n * Node.js-specific forget configuration that extends ForgetConfig with process termination options.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport interface ForgetNodeConfig<T = any> extends ForgetConfig<T> {\n  /** Terminate the process on an exception that happens outside of the promise being forgotten. */\n  terminateOnException?: boolean\n  /** Terminate the process if the promise times out. */\n  terminateOnTimeout?: boolean\n}\n\n/** Default Node.js forget configuration with termination disabled. */\nexport const defaultForgetNodeConfig: ForgetNodeConfig<unknown> = {\n  ...defaultForgetConfig,\n  terminateOnTimeout: false,\n  terminateOnException: false,\n}\n", "import type { AssertExErrorFunc, AssertExMessageFunc } from './types.ts'\n\n/**\n * Asserts that an expression is truthy and returns the value.\n * Throws an error if the expression is falsy.\n *\n * @template T - The type of value to check\n * @param expr - Expression to be evaluated for truthiness\n * @param messageFunc - Function that returns a message for the error if expression is falsy\n * @throws Error with the message returned by messageFunc\n * @returns The value of the expression (guaranteed to be truthy)\n * @example\n * ```typescript\n * // Simple usage with a message function\n * const value = assertEx(possiblyFalsy, () => 'Value must be truthy')\n *\n * // Using with type narrowing\n * const config: Config | null = loadConfig()\n * const safeConfig = assertEx(config, () => 'Config failed to load')\n * // safeConfig is now type Config (not Config | null)\n * ```\n */\nfunction assertEx<T>(expr: T | null | undefined, messageFunc?: AssertExMessageFunc<T>): T\n\n/**\n * Asserts that an expression is truthy and returns the value.\n * Throws a custom error if the expression is falsy.\n *\n * @template T - The type of value to check\n * @template R - The type of error to throw\n * @param expr - Expression to be evaluated for truthiness\n * @param errorFunc - Function that returns a custom error instance if expression is falsy\n * @throws Custom error returned by errorFunc\n * @returns The value of the expression (guaranteed to be truthy)\n * @example\n * ```typescript\n * // Using with a custom error\n * const user = assertEx(getUser(), () => new UserNotFoundError('User not found'))\n * ```\n */\nfunction assertEx<T, R extends Error>(expr: T | null | undefined, errorFunc?: AssertExErrorFunc<T, R>): T\n\n/**\n * Implementation of assertEx that handles all overloads.\n */\nfunction assertEx<T, R extends Error, P extends AssertExMessageFunc<T> | AssertExErrorFunc<T, R>>(\n  expr: T | null | undefined,\n  func?: P,\n): T {\n  if (expr !== undefined && expr !== null && expr !== false && expr !== 0 && expr !== '' && expr !== 0n) return expr\n  if (typeof func === 'function') {\n    const errorOrMessage = func(expr)\n    throw typeof errorOrMessage === 'string' ? new Error(errorOrMessage) : errorOrMessage\n  }\n  if (func !== undefined) {\n    throw new Error('Invalid assertEx usage: second argument must be a function or undefined')\n  }\n  throw new Error('Assertion failed')\n}\n\nexport { assertEx }\n", "import { assertEx } from '#assert'\n\ntype TimeoutHandle = object | number\n\ndeclare function setTimeout(handler: () => void, timeout?: number): TimeoutHandle\ndeclare function clearTimeout(timeoutId: TimeoutHandle | undefined): void\n\ninterface TimeoutInfo {\n  delay: number\n  func: () => void\n  id: string\n}\n\n/** Coalesces multiple logical timeouts into a single native timer. */\nexport class TimerScheduler {\n  private currentTimeout: TimeoutHandle | undefined\n  private interval = -1\n  private timeouts: TimeoutInfo[] = []\n\n  /**\n   * Cancels a timeout previously created with setTimeoutEx.\n   * @param id - The timeout ID returned by setTimeoutEx.\n   */\n  clearTimeoutEx(id: string) {\n    this.timeouts = this.timeouts.filter(timeout => timeout.id !== id)\n    this.update(this.timeouts)\n  }\n\n  /** Clears all scheduled timeouts and resets internal state. */\n  reset() {\n    this.interval = -1\n    clearTimeout(this.currentTimeout)\n    this.currentTimeout = undefined\n    this.timeouts = []\n  }\n\n  /**\n   * Sets a timeout using an optimized internal timer that coalesces multiple timeouts into a single native timer.\n   * @param func - The function to call after the delay.\n   * @param delay - The delay in milliseconds (must be >= 0).\n   * @returns A unique string ID that can be used with clearTimeoutEx to cancel the timeout.\n   */\n  setTimeoutEx(func: () => void, delay: number) {\n    assertEx(delay >= 0, () => 'delay must be >= 0')\n    const id = `${Date.now()}|${Math.random() * 9_999_999_999}`\n    this.timeouts.push({\n      delay, func, id,\n    })\n    this.update()\n    return id\n  }\n\n  private timerFunc() {\n    const notFiring = this.timeouts.filter(timeout => timeout.delay > this.interval)\n    const firing = this.timeouts.filter(timeout => timeout.delay <= this.interval)\n\n    this.update(notFiring, this.interval)\n\n    for (const timeout of firing) {\n      timeout.func()\n    }\n  }\n\n  private update(newTimeouts = this.timeouts, delayPassed = 0) {\n    if (newTimeouts.length === 0) {\n      this.reset()\n    } else {\n      const newInterval = Math.min(...newTimeouts.map(timeout => timeout.delay))\n\n      if (newInterval === this.interval && this.currentTimeout !== undefined) {\n        return\n      }\n      clearTimeout(this.currentTimeout)\n      this.timeouts = newTimeouts.map(timeout => ({\n        delay: timeout.delay - delayPassed, func: timeout.func, id: timeout.id,\n      }))\n      this.interval = newInterval\n      this.currentTimeout = setTimeout(() => this.timerFunc(), this.interval)\n    }\n  }\n}\n\n/** Default scheduler used by the module-level timeout helpers. */\nexport const defaultTimerScheduler = new TimerScheduler()\n\n/**\n * Sets a timeout using an optimized internal timer that coalesces multiple timeouts into a single native timer.\n * @param func - The function to call after the delay.\n * @param delay - The delay in milliseconds (must be >= 0).\n * @returns A unique string ID that can be used with clearTimeoutEx to cancel the timeout.\n */\nexport const setTimeoutEx = (func: () => void, delay: number) => defaultTimerScheduler.setTimeoutEx(func, delay)\n\n/**\n * Cancels a timeout previously created with setTimeoutEx.\n * @param id - The timeout ID returned by setTimeoutEx.\n */\nexport const clearTimeoutEx = (id: string) => defaultTimerScheduler.clearTimeoutEx(id)\n", "import { setTimeoutEx } from '#timer'\n\n/**\n * Returns a promise that resolves after the specified number of milliseconds.\n * @param ms - The number of milliseconds to delay.\n * @returns A promise that resolves after the delay.\n */\nexport const delay = (ms: number) => {\n  return new Promise<void>(resolve => setTimeoutEx(() => resolve(), ms))\n}\n", "/// <reference lib=\"dom\" />\n\n/** A function type that accepts any arguments and returns unknown. */\nexport type AnyFunction = (...args: unknown[]) => unknown\n\n/** A union of valid object key types. */\nexport type RecordKey = string | number | symbol\n\n/** Type guard that checks whether a value is undefined. */\nexport function isUndefined(value: unknown): value is undefined\nexport function isUndefined<T>(value: T): value is Extract<T, undefined>\nexport function isUndefined(value: unknown): value is undefined {\n  return value === undefined\n}\n\n/** Type guard that checks whether a value is not undefined. */\nexport function isDefined<T>(value: T): value is Exclude<T, undefined> {\n  return !isUndefined(value)\n}\n\n/** Type guard that checks whether a value is null. */\nexport function isNull(value: unknown): value is null\nexport function isNull<T>(value: T): value is Extract<T, null>\nexport function isNull(value: unknown): value is null {\n  return value === null\n}\n\n/** Type guard that checks whether a value is neither undefined nor null. */\nexport function isDefinedNotNull<T>(value: T): value is Exclude<T, undefined | null> {\n  return !isUndefined(value) && !isNull(value)\n}\n\n/** Type guard that checks whether a value is undefined or null. */\nexport function isUndefinedOrNull(value: unknown): value is undefined | null\nexport function isUndefinedOrNull<T>(value: T): value is Extract<T, undefined | null>\nexport function isUndefinedOrNull(value: unknown): value is undefined | null {\n  return isUndefined(value) || isNull(value)\n}\n\n/** Type guard that checks whether a value is a bigint. */\nexport function isBigInt(value: unknown): value is bigint\nexport function isBigInt<T extends bigint>(value: T): value is Extract<T, bigint>\nexport function isBigInt(value: unknown): value is bigint {\n  return typeof value === 'bigint'\n}\n\n/** Type guard that checks whether a value is a string. */\nexport function isString(value: unknown): value is string\nexport function isString<T extends string>(value: T): value is Extract<T, string>\nexport function isString(value: unknown): value is string {\n  return typeof value === 'string'\n}\n\n/** Type guard that checks whether a value is a number. */\nexport function isNumber(value: unknown): value is number\nexport function isNumber<T extends number>(value: T): value is Extract<T, number>\nexport function isNumber(value: unknown): value is number {\n  return typeof value === 'number'\n}\n\n/** Type guard that checks whether a value is a plain object (not null and not an array). */\nexport function isObject(value: unknown): value is object\nexport function isObject<T extends object>(value: T): value is Extract<T, object>\nexport function isObject(value: unknown): value is object {\n  return (typeof value === 'object') && (value !== null) && !Array.isArray(value)\n}\n\n/** Type guard that checks whether a value is an array. */\nexport function isArray(value: unknown): value is readonly unknown[]\nexport function isArray<T>(value: T): value is Extract<T, readonly unknown[]>\nexport function isArray(value: unknown): value is readonly unknown[] {\n  return Array.isArray(value)\n}\n\n/** Type guard that checks whether a value is a function. */\nexport function isFunction(value: unknown): value is AnyFunction\nexport function isFunction<T extends AnyFunction>(value: T): value is Extract<T, AnyFunction>\nexport function isFunction(value: unknown): value is AnyFunction {\n  return typeof value === 'function'\n}\n\n/** Type guard that checks whether a value is a symbol. */\nexport function isSymbol(value: unknown): value is symbol\nexport function isSymbol<T extends symbol>(value: T): value is Extract<T, symbol>\nexport function isSymbol(value: unknown): value is symbol {\n  return typeof value === 'symbol'\n}\n\n/** Type guard that checks whether a value is an object with no own keys. */\nexport function isEmptyObject(value: unknown): value is {}\nexport function isEmptyObject<K extends RecordKey, V, T extends Record<K, V>>(value: T): value is Extract<T, Record<K, never>>\nexport function isEmptyObject(value: unknown): value is {} {\n  return isObject(value) && Object.keys(value).length === 0\n}\n\n/** Type guard that checks whether a value is an empty string. */\nexport function isEmptyString(value: unknown): value is ''\nexport function isEmptyString<T extends string>(value: T): value is Extract<T, ''>\nexport function isEmptyString(value: unknown): value is '' {\n  return isString(value) && value.length === 0\n}\n\n/** Type guard that checks whether a value is an empty array. */\nexport function isEmptyArray(value: unknown): value is []\nexport function isEmptyArray<T extends unknown[]>(value: T): value is Extract<T, unknown[]>\nexport function isEmptyArray(value: unknown): value is [] {\n  return isArray(value) && value.length === 0\n}\n\n/** Type guard that checks whether a value is a non-empty array. */\nexport function isPopulatedArray(value: unknown): value is readonly unknown[]\nexport function isPopulatedArray<T extends unknown[]>(value: T): value is Extract<T, readonly unknown[]>\nexport function isPopulatedArray(value: unknown): value is readonly unknown[] {\n  return isArray(value) && value.length > 0\n}\n\n/** Type guard that checks whether a value is empty (empty string, empty array, or empty object). */\nexport function isEmpty<T>(value: unknown): value is T\nexport function isEmpty<K extends RecordKey, V, T extends Record<K, V>>(value: T): value is Extract<T, Record<K, never>>\nexport function isEmpty<T extends unknown[]>(value: T): value is Extract<T, never[]>\nexport function isEmpty<T>(value: unknown): value is T {\n  return isEmptyString(value) || isEmptyArray(value) || isEmptyObject(value)\n}\n\n/** Type guard that checks whether a value is falsy (0, null, undefined, false, '', or 0n). */\nexport function isFalsy<T>(value: T): value is Extract<T, 0 | null | undefined | false | '' | 0n>\nexport function isFalsy<T extends boolean>(value: T): value is Extract<T, false>\nexport function isFalsy<T extends number>(value: T): value is Extract<T, 0>\nexport function isFalsy<T extends bigint>(value: T): value is Extract<T, 0n>\nexport function isFalsy<T extends null>(value: T): value is Extract<T, null>\nexport function isFalsy<T extends undefined>(value: T): value is Extract<T, undefined>\nexport function isFalsy<T extends string>(value: T): value is Extract<T, ''>\nexport function isFalsy<T>(value: T): value is T {\n  // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions -- mirrors JavaScript falsy semantics (incl. NaN)\n  return !value\n}\n\n/** Type guard that checks whether a value is truthy (not 0, null, undefined, false, '', or 0n). */\nexport function isTruthy<T>(value: T): value is Exclude<T, 0 | null | undefined | false | '' | 0n>\nexport function isTruthy<T extends boolean>(value: T): value is Extract<T, true>\nexport function isTruthy<T extends number>(value: T): value is Extract<T, number>\nexport function isTruthy<T extends bigint>(value: T): value is Extract<T, bigint>\nexport function isTruthy<T extends null>(value: T): value is Extract<T, null>\nexport function isTruthy<T extends undefined>(value: T): value is Extract<T, undefined>\nexport function isTruthy<T extends string>(value: T): value is Extract<T, string>\nexport function isTruthy<T>(value: T): value is T {\n  // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions -- mirrors JavaScript truthy semantics\n  return !!value\n}\n\n/** Type guard that checks whether a value is a boolean. */\nexport function isBoolean(value: unknown): value is boolean\nexport function isBoolean<T extends boolean>(value: T): value is Extract<T, boolean>\nexport function isBoolean(value: unknown): value is boolean {\n  return typeof value === 'boolean'\n}\n\n/** Type guard that checks whether a value is a string that can be parsed as a valid date. */\nexport function isDateString(value: unknown): value is string\nexport function isDateString<T>(value: T): value is Extract<T, string>\nexport function isDateString(value: unknown): value is string {\n  return isString(value) && !Number.isNaN(Date.parse(value))\n}\n\n/** Type guard that checks whether a value is a Date instance. */\nexport function isDate(value: unknown): value is Date\nexport function isDate<T>(value: T): value is Extract<T, Date>\nexport function isDate(value: unknown): value is Date {\n  return value instanceof Date\n}\n\n/** Type guard that checks whether a value is a RegExp instance. */\nexport function isRegExp(value: unknown): value is RegExp\nexport function isRegExp<T extends RegExp>(value: T): value is Extract<T, RegExp>\nexport function isRegExp(value: unknown): value is RegExp {\n  return value instanceof RegExp\n}\n\n/** Type guard that checks whether a value is an Error instance. */\nexport function isError(value: unknown): value is Error\nexport function isError<T>(value: T): value is Extract<T, Error>\nexport function isError(value: unknown): value is Error {\n  return value instanceof Error\n}\n\n/** Type guard that checks whether a value is a Promise instance. */\nexport function isPromise(value: unknown): value is Promise<unknown>\nexport function isPromise<T>(value: T): value is Extract<T, Promise<unknown>>\nexport function isPromise(value: unknown): value is Promise<unknown> {\n  return value instanceof Promise\n}\n\n/** Type guard that checks whether a value is promise-like (has a `then` method). */\nexport function isPromiseLike(value: unknown): value is Promise<unknown>\nexport function isPromiseLike<T>(value: T): value is Extract<T, Promise<unknown>>\nexport function isPromiseLike(value: unknown): value is Promise<unknown> {\n  return (\n    typeof value === 'object'\n    && value !== null\n    && typeof (value as Record<string, unknown>).then === 'function'\n  )\n}\n\n/** Type guard that checks whether a value is a Map instance. */\nexport function isMap(value: unknown): value is Map<unknown, unknown>\nexport function isMap<K, V, T extends Map<K, V>>(value: T): value is Extract<T, Map<K, V>>\nexport function isMap(value: unknown): value is Map<unknown, unknown> {\n  return value instanceof Map\n}\n\n/** Type guard that checks whether a value is an ArrayBufferView (e.g., TypedArray or DataView). */\nexport function isArrayBufferView(value: unknown): value is ArrayBufferView\nexport function isArrayBufferView<T extends ArrayBufferView>(value: T): value is Extract<T, ArrayBufferView>\nexport function isArrayBufferView(value: unknown): value is ArrayBufferView {\n  return ArrayBuffer.isView(value)\n}\n\n/** Type guard that checks whether a value is a Set instance. */\nexport function isSet(value: unknown): value is Set<unknown>\nexport function isSet<T extends Set<unknown>>(value: T): value is Extract<T, Set<unknown>>\nexport function isSet(value: unknown): value is Set<unknown> {\n  return value instanceof Set\n}\n\n/** Type guard that checks whether a value is a WeakMap instance. */\nexport function isWeakMap(value: unknown): value is WeakMap<WeakKey, unknown>\nexport function isWeakMap<K extends WeakKey, V, T extends WeakMap<K, V>>(value: T): value is Extract<T, WeakMap<K, V>>\nexport function isWeakMap(value: unknown): value is WeakMap<WeakKey, unknown> {\n  return value instanceof WeakMap\n}\n\n/** Type guard that checks whether a value is a WeakSet instance. */\nexport function isWeakSet(value: unknown): value is WeakSet<WeakKey>\nexport function isWeakSet<K extends WeakKey, T extends WeakSet<K>>(value: T): value is Extract<T, WeakSet<K>>\nexport function isWeakSet(value: unknown): value is WeakSet<WeakKey> {\n  return value instanceof WeakSet\n}\n\n/** Type guard that checks whether a value is a DataView instance. */\nexport function isDataView(value: unknown): value is DataView\nexport function isDataView<T>(value: T): value is Extract<T, DataView>\nexport function isDataView(value: unknown): value is DataView {\n  return value instanceof DataView\n}\n\n/** Type guard that checks whether a value is a Blob instance. */\nexport function isBlob(value: unknown): value is Blob\nexport function isBlob<T extends Blob>(value: T): value is Extract<T, Blob>\nexport function isBlob(value: unknown): value is Blob {\n  return typeof Blob !== 'undefined' && value instanceof Blob\n}\n\n/** Type guard that checks whether a value is a File instance. */\nexport function isFile(value: unknown): value is File\nexport function isFile<T extends File>(value: T): value is Extract<T, File>\nexport function isFile(value: unknown): value is File {\n  return typeof File !== 'undefined' && value instanceof File\n}\n", "/// <reference path=\"./types/global-config.d.ts\" />\n\nimport { delay } from '#delay'\nimport type { Logger } from '#logger'\nimport type { Promisable, PromiseEx } from '#promise'\nimport { isNumber, isPromise } from '#typeof'\n\nimport { defaultForgetConfig, type ForgetConfig } from './ForgetConfig.ts'\n\n/** A function that returns a promisable value. */\ntype PromisableFunction<T> = () => Promisable<T>\n\n/**\n * Manages fire-and-forget promises with tracking, timeouts, and error handling.\n *\n * Timeouts are observability hooks only: they invoke `onCancel` and `timeoutHandler` but do not\n * abort or await-cleanup the underlying promise. `activeForgets` therefore counts promises that\n * are still running (unsettled), not promises still inside their configured timeout window.\n */\n// eslint-disable-next-line unicorn/no-static-only-class\nexport class ForgetPromise {\n  /**\n   * Number of forgotten promises still running (not yet settled).\n   * Decremented only when the underlying promise fulfills or rejects \u2014 not when a timeout fires.\n   */\n  static activeForgets = 0\n  /** Number of forgotten promises that threw exceptions. */\n  static exceptedForgets = 0\n  /** Logger instance used for error and warning output. */\n  static logger: Logger = console\n\n  /** Whether any forgotten promises are still running, including any that have exceeded their timeout. */\n  static get active() {\n    return this.activeForgets > 0\n  }\n\n  /**\n   * Waits until all forgotten promises have settled.\n   * @param interval - Polling interval in milliseconds.\n   * @param timeout - Optional maximum wait time in milliseconds.\n   * @returns `0` when every forgotten promise has settled; otherwise the number still running.\n   * A non-zero return after `timeout` elapses can include promises whose timeout callback already\n   * ran but whose work is still in flight.\n   */\n  static async awaitInactive(interval = 100, timeout?: number) {\n    let timeoutRemaining = timeout\n    while (this.active) {\n      await delay(interval)\n      if (timeoutRemaining !== undefined) {\n        timeoutRemaining -= interval\n        if (timeoutRemaining <= 0) {\n          return this.activeForgets\n        }\n      }\n    }\n    return 0\n  }\n\n  /** Handles exceptions from forgotten promises by logging error details. */\n  static exceptionHandler(error: Error, { name }: ForgetConfig, externalStackTrace?: string) {\n    this.logger.error(`forget promise handler excepted [${name}]: ${error.message}`, error)\n    if (externalStackTrace !== undefined) {\n      this.logger.warn(`External Stack trace [${name}]:`, externalStackTrace)\n    }\n  }\n\n  /**\n   * Used to explicitly launch an async function (or Promise) with awaiting it\n   * @param promise The promise to forget\n   * @param config Configuration of forget settings\n   */\n  static forget<T>(promise: Promise<T> | PromiseEx<T> | PromisableFunction<T> | T, config?: ForgetConfig<T>) {\n    const stackError = new Error('Stack')\n    const externalStackTrace = stackError.stack\n\n    // default | global | provided priorities for config (not deep merge)\n    const resolvedConfig = {\n      ...defaultForgetConfig, ...globalThis.xy?.forget?.config, ...config,\n    }\n    const resolvedPromise = typeof promise === 'function' ? (promise as PromisableFunction<T>)() : promise\n    if (isPromise(resolvedPromise)) {\n      try {\n        let isCompleted = false\n        this.activeForgets++\n\n        const promiseWrapper = async () => {\n          try {\n            const result = await resolvedPromise\n            this.activeForgets--\n            isCompleted = true\n            resolvedConfig?.onComplete?.([result, undefined])\n          } catch (error: unknown) {\n            const caughtError = error instanceof Error ? error : new Error(String(error))\n            this.activeForgets--\n            isCompleted = true\n            this.logger.error(`forgotten promise excepted [${config?.name ?? 'unknown'}]: ${caughtError.message}`, caughtError)\n            resolvedConfig?.onComplete?.([undefined, caughtError])\n          }\n        }\n\n        const promises = [promiseWrapper()]\n\n        // Timeout races for notification only; it does not stop the underlying promise or\n        // decrement activeForgets \u2014 callers use activeForgets to see how much work is still running.\n        const timeout = resolvedConfig.timeout ?? defaultForgetConfig.timeout\n        if (isNumber(timeout)) {\n          const timeoutFunc = async () => {\n            await delay(timeout)\n            if (!isCompleted) {\n              resolvedConfig.onCancel?.()\n              this.timeoutHandler(timeout, resolvedConfig, externalStackTrace)\n            }\n          }\n          promises.push(timeoutFunc())\n        }\n\n        const race = Promise.race(promises)\n\n        void race.catch(() => {\n          // Swallow race errors; forget is fire-and-forget.\n        })\n      } catch (ex) {\n        this.exceptedForgets += 1\n        resolvedConfig?.onException?.(ex as Error)\n        this.exceptionHandler(ex as Error, resolvedConfig, externalStackTrace)\n      }\n    } else {\n      // we do nothing here since if it was a non-promise, it already got invoked.\n      return\n    }\n  }\n\n  /**\n   * Handles timeout events for forgotten promises by logging timeout details.\n   * Does not terminate the underlying promise; it may continue running after this is called.\n   */\n  static timeoutHandler(time: number, { name = 'unknown' }: ForgetConfig, externalStackTrace?: string) {\n    this.logger.error(`forget promise timed out after ${time}ms [still running] [${name}]`)\n    if (externalStackTrace !== undefined) {\n      this.logger.warn(`External Stack trace [${name}]:`, externalStackTrace)\n    }\n  }\n}\n", "/// <reference types=\"node\" />\n/// <reference path=\"./types/global-config-node.d.ts\" />\n\nimport type { Promisable } from '#promise'\n\nimport { defaultForgetNodeConfig, type ForgetNodeConfig } from './ForgetNodeConfig.ts'\nimport { ForgetPromise } from './ForgetPromise.ts'\n\n/**\n * Node.js extension of ForgetPromise that can terminate the process on exceptions or timeouts.\n */\nexport class ForgetPromiseNode extends ForgetPromise {\n  /** Handles exceptions, optionally terminating the process based on config. */\n  static override exceptionHandler(error: Error, config: ForgetNodeConfig, externalStackTrace?: string) {\n    // default | global | provided priorities for config (not deep merge)\n    super.exceptionHandler(error, config, externalStackTrace)\n    if (config?.terminateOnException === true) {\n      this.logger.error(`Attempting to terminate process [${config?.name ?? 'unknown'}]...`)\n      // eslint-disable-next-line unicorn/no-process-exit\n      process.exit(1)\n    }\n  }\n\n  /** Forgets a promise using Node.js-specific configuration with process termination support. */\n  static override forget<T>(promise: Promisable<T>, config?: ForgetNodeConfig<T>) {\n    const resolvedConfig = {\n      ...defaultForgetNodeConfig, ...globalThis.xy?.forget?.config, ...config,\n    }\n    super.forget(promise, resolvedConfig)\n  }\n\n  /** Handles timeouts, optionally terminating the process based on config. */\n  static override timeoutHandler(time: number, config: ForgetNodeConfig, externalStackTrace?: string) {\n    super.timeoutHandler(time, config, externalStackTrace)\n    if (config?.terminateOnTimeout === true) {\n      this.logger.error(`Attempting to terminate process [${config?.name ?? 'unknown'}]...`)\n      // eslint-disable-next-line unicorn/no-process-exit\n      process.exit(2)\n    }\n  }\n}\n", "import { type Promisable } from '#promise'\n\nimport type { ForgetNodeConfig } from './ForgetNodeConfig.ts'\nimport { ForgetPromiseNode } from './ForgetPromiseNode.ts'\n\n/**\n * Node.js variant of forget that can optionally terminate the process on exceptions or timeouts.\n * @param promise - The promise or promisable value to forget.\n * @param config - Optional Node.js-specific configuration including process termination options.\n */\nexport const forgetNode = <T>(promise: Promisable<T>, config?: ForgetNodeConfig<T>) => {\n  ForgetPromiseNode.forget<T>(promise, config)\n}\n"],
+  "mappings": "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",
+  "names": ["delay"]
+}

package/dist/neutral/forget.model.d.ts

@@ -1 +1,2 @@
-export type * from '../_pkg/forget/neutral/model.ts'
+export type * from './modules/forget/model.js';
+//# sourceMappingURL=forget.model.d.ts.map

package/dist/neutral/forget.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forget.model.d.ts","sourceRoot":"","sources":["../../src/forget.model.ts"],"names":[],"mappings":"AAAA,mBAAmB,eAAe,CAAA"}

package/dist/neutral/forget.model.mjs

@@ -1 +1 @@
-export * from '../_pkg/forget/neutral/model.mjs'
+//# sourceMappingURL=forget.model.mjs.map

package/dist/neutral/forget.model.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/neutral/function-name.d.ts

@@ -1 +1,2 @@
-export * from '../_pkg/function-name/neutral/index.ts'
+export * from './modules/function-name/index.js';
+//# sourceMappingURL=function-name.d.ts.map

package/dist/neutral/function-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-name.d.ts","sourceRoot":"","sources":["../../src/function-name.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA"}

package/dist/neutral/function-name.mjs

@@ -1 +1,41 @@
-export * from '../_pkg/function-name/neutral/index.mjs'
+// src/modules/typeof/is.ts
+function isNumber(value) {
+  return typeof value === "number";
+}
+function isError(value) {
+  return value instanceof Error;
+}
+
+// src/modules/error/handleError.ts
+var handleError = (error, handler) => {
+  if (isError(error)) {
+    return handler(error);
+  }
+  throw error;
+};
+
+// src/modules/function-name/functionName.ts
+var functionName = (depth = 2) => {
+  try {
+    throw new Error("Getting function name");
+  } catch (ex) {
+    return handleError(ex, (error) => {
+      let newIndex;
+      const stackParts = error.stack?.split("\n")[depth].split(" ");
+      const funcName = stackParts?.find((item, index) => {
+        if (!(item.length > 0 && item !== "at")) {
+          return;
+        }
+        if (item === "new") {
+          newIndex = index;
+        }
+        return true;
+      }) ?? "<unknown>";
+      return isNumber(newIndex) ? `${funcName} ${stackParts?.[newIndex + 1]}` : funcName;
+    });
+  }
+};
+export {
+  functionName
+};
+//# sourceMappingURL=function-name.mjs.map

package/dist/neutral/function-name.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/modules/typeof/is.ts", "../../src/modules/error/handleError.ts", "../../src/modules/function-name/functionName.ts"],
+  "sourcesContent": ["/// <reference lib=\"dom\" />\n\n/** A function type that accepts any arguments and returns unknown. */\nexport type AnyFunction = (...args: unknown[]) => unknown\n\n/** A union of valid object key types. */\nexport type RecordKey = string | number | symbol\n\n/** Type guard that checks whether a value is undefined. */\nexport function isUndefined(value: unknown): value is undefined\nexport function isUndefined<T>(value: T): value is Extract<T, undefined>\nexport function isUndefined(value: unknown): value is undefined {\n  return value === undefined\n}\n\n/** Type guard that checks whether a value is not undefined. */\nexport function isDefined<T>(value: T): value is Exclude<T, undefined> {\n  return !isUndefined(value)\n}\n\n/** Type guard that checks whether a value is null. */\nexport function isNull(value: unknown): value is null\nexport function isNull<T>(value: T): value is Extract<T, null>\nexport function isNull(value: unknown): value is null {\n  return value === null\n}\n\n/** Type guard that checks whether a value is neither undefined nor null. */\nexport function isDefinedNotNull<T>(value: T): value is Exclude<T, undefined | null> {\n  return !isUndefined(value) && !isNull(value)\n}\n\n/** Type guard that checks whether a value is undefined or null. */\nexport function isUndefinedOrNull(value: unknown): value is undefined | null\nexport function isUndefinedOrNull<T>(value: T): value is Extract<T, undefined | null>\nexport function isUndefinedOrNull(value: unknown): value is undefined | null {\n  return isUndefined(value) || isNull(value)\n}\n\n/** Type guard that checks whether a value is a bigint. */\nexport function isBigInt(value: unknown): value is bigint\nexport function isBigInt<T extends bigint>(value: T): value is Extract<T, bigint>\nexport function isBigInt(value: unknown): value is bigint {\n  return typeof value === 'bigint'\n}\n\n/** Type guard that checks whether a value is a string. */\nexport function isString(value: unknown): value is string\nexport function isString<T extends string>(value: T): value is Extract<T, string>\nexport function isString(value: unknown): value is string {\n  return typeof value === 'string'\n}\n\n/** Type guard that checks whether a value is a number. */\nexport function isNumber(value: unknown): value is number\nexport function isNumber<T extends number>(value: T): value is Extract<T, number>\nexport function isNumber(value: unknown): value is number {\n  return typeof value === 'number'\n}\n\n/** Type guard that checks whether a value is a plain object (not null and not an array). */\nexport function isObject(value: unknown): value is object\nexport function isObject<T extends object>(value: T): value is Extract<T, object>\nexport function isObject(value: unknown): value is object {\n  return (typeof value === 'object') && (value !== null) && !Array.isArray(value)\n}\n\n/** Type guard that checks whether a value is an array. */\nexport function isArray(value: unknown): value is readonly unknown[]\nexport function isArray<T>(value: T): value is Extract<T, readonly unknown[]>\nexport function isArray(value: unknown): value is readonly unknown[] {\n  return Array.isArray(value)\n}\n\n/** Type guard that checks whether a value is a function. */\nexport function isFunction(value: unknown): value is AnyFunction\nexport function isFunction<T extends AnyFunction>(value: T): value is Extract<T, AnyFunction>\nexport function isFunction(value: unknown): value is AnyFunction {\n  return typeof value === 'function'\n}\n\n/** Type guard that checks whether a value is a symbol. */\nexport function isSymbol(value: unknown): value is symbol\nexport function isSymbol<T extends symbol>(value: T): value is Extract<T, symbol>\nexport function isSymbol(value: unknown): value is symbol {\n  return typeof value === 'symbol'\n}\n\n/** Type guard that checks whether a value is an object with no own keys. */\nexport function isEmptyObject(value: unknown): value is {}\nexport function isEmptyObject<K extends RecordKey, V, T extends Record<K, V>>(value: T): value is Extract<T, Record<K, never>>\nexport function isEmptyObject(value: unknown): value is {} {\n  return isObject(value) && Object.keys(value).length === 0\n}\n\n/** Type guard that checks whether a value is an empty string. */\nexport function isEmptyString(value: unknown): value is ''\nexport function isEmptyString<T extends string>(value: T): value is Extract<T, ''>\nexport function isEmptyString(value: unknown): value is '' {\n  return isString(value) && value.length === 0\n}\n\n/** Type guard that checks whether a value is an empty array. */\nexport function isEmptyArray(value: unknown): value is []\nexport function isEmptyArray<T extends unknown[]>(value: T): value is Extract<T, unknown[]>\nexport function isEmptyArray(value: unknown): value is [] {\n  return isArray(value) && value.length === 0\n}\n\n/** Type guard that checks whether a value is a non-empty array. */\nexport function isPopulatedArray(value: unknown): value is readonly unknown[]\nexport function isPopulatedArray<T extends unknown[]>(value: T): value is Extract<T, readonly unknown[]>\nexport function isPopulatedArray(value: unknown): value is readonly unknown[] {\n  return isArray(value) && value.length > 0\n}\n\n/** Type guard that checks whether a value is empty (empty string, empty array, or empty object). */\nexport function isEmpty<T>(value: unknown): value is T\nexport function isEmpty<K extends RecordKey, V, T extends Record<K, V>>(value: T): value is Extract<T, Record<K, never>>\nexport function isEmpty<T extends unknown[]>(value: T): value is Extract<T, never[]>\nexport function isEmpty<T>(value: unknown): value is T {\n  return isEmptyString(value) || isEmptyArray(value) || isEmptyObject(value)\n}\n\n/** Type guard that checks whether a value is falsy (0, null, undefined, false, '', or 0n). */\nexport function isFalsy<T>(value: T): value is Extract<T, 0 | null | undefined | false | '' | 0n>\nexport function isFalsy<T extends boolean>(value: T): value is Extract<T, false>\nexport function isFalsy<T extends number>(value: T): value is Extract<T, 0>\nexport function isFalsy<T extends bigint>(value: T): value is Extract<T, 0n>\nexport function isFalsy<T extends null>(value: T): value is Extract<T, null>\nexport function isFalsy<T extends undefined>(value: T): value is Extract<T, undefined>\nexport function isFalsy<T extends string>(value: T): value is Extract<T, ''>\nexport function isFalsy<T>(value: T): value is T {\n  // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions -- mirrors JavaScript falsy semantics (incl. NaN)\n  return !value\n}\n\n/** Type guard that checks whether a value is truthy (not 0, null, undefined, false, '', or 0n). */\nexport function isTruthy<T>(value: T): value is Exclude<T, 0 | null | undefined | false | '' | 0n>\nexport function isTruthy<T extends boolean>(value: T): value is Extract<T, true>\nexport function isTruthy<T extends number>(value: T): value is Extract<T, number>\nexport function isTruthy<T extends bigint>(value: T): value is Extract<T, bigint>\nexport function isTruthy<T extends null>(value: T): value is Extract<T, null>\nexport function isTruthy<T extends undefined>(value: T): value is Extract<T, undefined>\nexport function isTruthy<T extends string>(value: T): value is Extract<T, string>\nexport function isTruthy<T>(value: T): value is T {\n  // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions -- mirrors JavaScript truthy semantics\n  return !!value\n}\n\n/** Type guard that checks whether a value is a boolean. */\nexport function isBoolean(value: unknown): value is boolean\nexport function isBoolean<T extends boolean>(value: T): value is Extract<T, boolean>\nexport function isBoolean(value: unknown): value is boolean {\n  return typeof value === 'boolean'\n}\n\n/** Type guard that checks whether a value is a string that can be parsed as a valid date. */\nexport function isDateString(value: unknown): value is string\nexport function isDateString<T>(value: T): value is Extract<T, string>\nexport function isDateString(value: unknown): value is string {\n  return isString(value) && !Number.isNaN(Date.parse(value))\n}\n\n/** Type guard that checks whether a value is a Date instance. */\nexport function isDate(value: unknown): value is Date\nexport function isDate<T>(value: T): value is Extract<T, Date>\nexport function isDate(value: unknown): value is Date {\n  return value instanceof Date\n}\n\n/** Type guard that checks whether a value is a RegExp instance. */\nexport function isRegExp(value: unknown): value is RegExp\nexport function isRegExp<T extends RegExp>(value: T): value is Extract<T, RegExp>\nexport function isRegExp(value: unknown): value is RegExp {\n  return value instanceof RegExp\n}\n\n/** Type guard that checks whether a value is an Error instance. */\nexport function isError(value: unknown): value is Error\nexport function isError<T>(value: T): value is Extract<T, Error>\nexport function isError(value: unknown): value is Error {\n  return value instanceof Error\n}\n\n/** Type guard that checks whether a value is a Promise instance. */\nexport function isPromise(value: unknown): value is Promise<unknown>\nexport function isPromise<T>(value: T): value is Extract<T, Promise<unknown>>\nexport function isPromise(value: unknown): value is Promise<unknown> {\n  return value instanceof Promise\n}\n\n/** Type guard that checks whether a value is promise-like (has a `then` method). */\nexport function isPromiseLike(value: unknown): value is Promise<unknown>\nexport function isPromiseLike<T>(value: T): value is Extract<T, Promise<unknown>>\nexport function isPromiseLike(value: unknown): value is Promise<unknown> {\n  return (\n    typeof value === 'object'\n    && value !== null\n    && typeof (value as Record<string, unknown>).then === 'function'\n  )\n}\n\n/** Type guard that checks whether a value is a Map instance. */\nexport function isMap(value: unknown): value is Map<unknown, unknown>\nexport function isMap<K, V, T extends Map<K, V>>(value: T): value is Extract<T, Map<K, V>>\nexport function isMap(value: unknown): value is Map<unknown, unknown> {\n  return value instanceof Map\n}\n\n/** Type guard that checks whether a value is an ArrayBufferView (e.g., TypedArray or DataView). */\nexport function isArrayBufferView(value: unknown): value is ArrayBufferView\nexport function isArrayBufferView<T extends ArrayBufferView>(value: T): value is Extract<T, ArrayBufferView>\nexport function isArrayBufferView(value: unknown): value is ArrayBufferView {\n  return ArrayBuffer.isView(value)\n}\n\n/** Type guard that checks whether a value is a Set instance. */\nexport function isSet(value: unknown): value is Set<unknown>\nexport function isSet<T extends Set<unknown>>(value: T): value is Extract<T, Set<unknown>>\nexport function isSet(value: unknown): value is Set<unknown> {\n  return value instanceof Set\n}\n\n/** Type guard that checks whether a value is a WeakMap instance. */\nexport function isWeakMap(value: unknown): value is WeakMap<WeakKey, unknown>\nexport function isWeakMap<K extends WeakKey, V, T extends WeakMap<K, V>>(value: T): value is Extract<T, WeakMap<K, V>>\nexport function isWeakMap(value: unknown): value is WeakMap<WeakKey, unknown> {\n  return value instanceof WeakMap\n}\n\n/** Type guard that checks whether a value is a WeakSet instance. */\nexport function isWeakSet(value: unknown): value is WeakSet<WeakKey>\nexport function isWeakSet<K extends WeakKey, T extends WeakSet<K>>(value: T): value is Extract<T, WeakSet<K>>\nexport function isWeakSet(value: unknown): value is WeakSet<WeakKey> {\n  return value instanceof WeakSet\n}\n\n/** Type guard that checks whether a value is a DataView instance. */\nexport function isDataView(value: unknown): value is DataView\nexport function isDataView<T>(value: T): value is Extract<T, DataView>\nexport function isDataView(value: unknown): value is DataView {\n  return value instanceof DataView\n}\n\n/** Type guard that checks whether a value is a Blob instance. */\nexport function isBlob(value: unknown): value is Blob\nexport function isBlob<T extends Blob>(value: T): value is Extract<T, Blob>\nexport function isBlob(value: unknown): value is Blob {\n  return typeof Blob !== 'undefined' && value instanceof Blob\n}\n\n/** Type guard that checks whether a value is a File instance. */\nexport function isFile(value: unknown): value is File\nexport function isFile<T extends File>(value: T): value is Extract<T, File>\nexport function isFile(value: unknown): value is File {\n  return typeof File !== 'undefined' && value instanceof File\n}\n", "import { isError } from '#typeof'\n\n/**\n * Invokes the handler if the value is an Error, otherwise re-throws it.\n * @param error - The caught value to inspect\n * @param handler - Callback invoked with the Error if it is one\n * @returns The handler's return value\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const handleError = <T>(error: any, handler: (error: Error) => T) => {\n  if (isError(error)) {\n    return handler(error)\n  }\n  throw error\n}\n\n/**\n * Async version of handleError. Invokes the async handler if the value is an Error, otherwise re-throws it.\n * @param error - The caught value to inspect\n * @param handler - Async callback invoked with the Error if it is one\n * @returns The handler's resolved return value\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const handleErrorAsync = async <T>(error: any, handler: (error: Error) => Promise<T>) => {\n  if (isError(error)) {\n    return await handler(error)\n  }\n  throw error\n}\n", "import { handleError } from '#error'\nimport { isNumber } from '#typeof'\n\n/**\n * Returns the name of the calling function by inspecting the stack trace.\n * @param depth - The stack frame depth to read the function name from (default: 2).\n * @returns The function name, or '<unknown>' if it cannot be determined.\n */\nexport const functionName = (depth = 2) => {\n  try {\n    throw new Error('Getting function name')\n  } catch (ex) {\n    return handleError(ex, (error) => {\n      let newIndex: number | undefined\n      const stackParts = error.stack?.split('\\n')[depth].split(' ')\n      const funcName\n        = stackParts?.find((item, index) => {\n          if (!(item.length > 0 && item !== 'at')) {\n            return\n          }\n\n          // check if constructor\n          if (item === 'new') {\n            newIndex = index\n          }\n          return true\n        }) ?? '<unknown>'\n      return isNumber(newIndex) ? `${funcName} ${stackParts?.[newIndex + 1]}` : funcName\n    })\n  }\n}\n"],
+  "mappings": ";AAwDO,SAAS,SAAS,OAAiC;AACxD,SAAO,OAAO,UAAU;AAC1B;AA2HO,SAAS,QAAQ,OAAgC;AACtD,SAAO,iBAAiB;AAC1B;;;AC9KO,IAAM,cAAc,CAAI,OAAY,YAAiC;AAC1E,MAAI,QAAQ,KAAK,GAAG;AAClB,WAAO,QAAQ,KAAK;AAAA,EACtB;AACA,QAAM;AACR;;;ACNO,IAAM,eAAe,CAAC,QAAQ,MAAM;AACzC,MAAI;AACF,UAAM,IAAI,MAAM,uBAAuB;AAAA,EACzC,SAAS,IAAI;AACX,WAAO,YAAY,IAAI,CAAC,UAAU;AAChC,UAAI;AACJ,YAAM,aAAa,MAAM,OAAO,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG;AAC5D,YAAM,WACF,YAAY,KAAK,CAAC,MAAM,UAAU;AAClC,YAAI,EAAE,KAAK,SAAS,KAAK,SAAS,OAAO;AACvC;AAAA,QACF;AAGA,YAAI,SAAS,OAAO;AAClB,qBAAW;AAAA,QACb;AACA,eAAO;AAAA,MACT,CAAC,KAAK;AACR,aAAO,SAAS,QAAQ,IAAI,GAAG,QAAQ,IAAI,aAAa,WAAW,CAAC,CAAC,KAAK;AAAA,IAC5E,CAAC;AAAA,EACH;AACF;",
+  "names": []
+}

package/dist/neutral/hex.d.ts

@@ -1 +1,2 @@
-export * from '../_pkg/hex/neutral/index.ts'
+export * from './modules/hex/index.js';
+//# sourceMappingURL=hex.d.ts.map

package/dist/neutral/hex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex.d.ts","sourceRoot":"","sources":["../../src/hex.ts"],"names":[],"mappings":"AAAA,cAAc,MAAM,CAAA"}