@hypen-space/core 0.4.37 → 0.4.38

package/dist/retry.js

@@ -0,0 +1,329 @@
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined")
+    return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/result.ts
+function Ok(value) {
+  return { ok: true, value };
+}
+function Err(error) {
+  return { ok: false, error };
+}
+function isOk(result) {
+  return result.ok;
+}
+function isErr(result) {
+  return !result.ok;
+}
+async function fromPromise(promise, mapError) {
+  try {
+    const value = await promise;
+    return Ok(value);
+  } catch (e) {
+    if (mapError) {
+      return Err(mapError(e));
+    }
+    return Err(e);
+  }
+}
+function fromTry(fn, mapError) {
+  try {
+    return Ok(fn());
+  } catch (e) {
+    if (mapError) {
+      return Err(mapError(e));
+    }
+    return Err(e);
+  }
+}
+function map(result, fn) {
+  if (result.ok) {
+    return Ok(fn(result.value));
+  }
+  return result;
+}
+function mapErr(result, fn) {
+  if (!result.ok) {
+    return Err(fn(result.error));
+  }
+  return result;
+}
+function flatMap(result, fn) {
+  if (result.ok) {
+    return fn(result.value);
+  }
+  return result;
+}
+function unwrap(result) {
+  if (result.ok) {
+    return result.value;
+  }
+  throw result.error;
+}
+function unwrapOr(result, defaultValue) {
+  if (result.ok) {
+    return result.value;
+  }
+  return defaultValue;
+}
+function unwrapOrElse(result, fn) {
+  if (result.ok) {
+    return result.value;
+  }
+  return fn(result.error);
+}
+function match(result, handlers) {
+  if (result.ok) {
+    return handlers.ok(result.value);
+  }
+  return handlers.err(result.error);
+}
+function all(results) {
+  const values = [];
+  for (const result of results) {
+    if (!result.ok) {
+      return result;
+    }
+    values.push(result.value);
+  }
+  return Ok(values);
+}
+
+class HypenError extends Error {
+  code;
+  context;
+  cause;
+  constructor(code, message, options) {
+    super(message);
+    this.name = "HypenError";
+    this.code = code;
+    this.context = options?.context;
+    this.cause = options?.cause;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+}
+
+class ActionError extends HypenError {
+  actionName;
+  constructor(actionName, cause) {
+    super("ACTION_ERROR", `Action handler "${actionName}" failed: ${cause instanceof Error ? cause.message : String(cause)}`, {
+      context: { actionName },
+      cause: cause instanceof Error ? cause : undefined
+    });
+    this.name = "ActionError";
+    this.actionName = actionName;
+  }
+}
+
+class ConnectionError extends HypenError {
+  url;
+  attempt;
+  constructor(url, cause, attempt) {
+    super("CONNECTION_ERROR", `Connection to "${url}" failed${attempt ? ` (attempt ${attempt})` : ""}: ${cause instanceof Error ? cause.message : String(cause)}`, {
+      context: { url, attempt },
+      cause: cause instanceof Error ? cause : undefined
+    });
+    this.name = "ConnectionError";
+    this.url = url;
+    this.attempt = attempt;
+  }
+}
+
+class StateError extends HypenError {
+  path;
+  constructor(message, path, cause) {
+    super("STATE_ERROR", message, {
+      context: { path },
+      cause: cause instanceof Error ? cause : undefined
+    });
+    this.name = "StateError";
+    this.path = path;
+  }
+}
+
+class ParseError extends HypenError {
+  source;
+  constructor(message, source, cause) {
+    super("PARSE_ERROR", message, {
+      context: { source },
+      cause: cause instanceof Error ? cause : undefined
+    });
+    this.name = "ParseError";
+    this.source = source;
+  }
+}
+
+class RenderError extends HypenError {
+  constructor(message, cause) {
+    super("RENDER_ERROR", message, {
+      cause: cause instanceof Error ? cause : undefined
+    });
+    this.name = "RenderError";
+  }
+}
+function classifyEngineError(err) {
+  const message = err instanceof Error ? err.message : String(err);
+  if (message.startsWith("Parse error:")) {
+    return new ParseError(message);
+  }
+  if (message.startsWith("Invalid state:") || message.startsWith("Invalid state patch:")) {
+    return new StateError(message);
+  }
+  if (message.startsWith("Parent node not found:")) {
+    return new RenderError(message);
+  }
+  return new RenderError(message);
+}
+
+// src/retry.ts
+var DEFAULT_OPTIONS = {
+  maxAttempts: 3,
+  delayMs: 1000,
+  backoff: "exponential",
+  maxDelayMs: 30000,
+  jitter: 0.1
+};
+function calculateDelay(attempt, options) {
+  let delay;
+  switch (options.backoff) {
+    case "exponential":
+      delay = options.delayMs * Math.pow(2, attempt - 1);
+      break;
+    case "linear":
+      delay = options.delayMs * attempt;
+      break;
+    case "none":
+      delay = options.delayMs;
+      break;
+  }
+  if (options.jitter > 0) {
+    const jitterRange = delay * options.jitter;
+    delay += (Math.random() * 2 - 1) * jitterRange;
+  }
+  return Math.min(delay, options.maxDelayMs);
+}
+function sleep(ms, signal) {
+  return new Promise((resolve, reject) => {
+    if (signal?.aborted) {
+      reject(new Error("Retry aborted"));
+      return;
+    }
+    const timeoutId = setTimeout(resolve, ms);
+    signal?.addEventListener("abort", () => {
+      clearTimeout(timeoutId);
+      reject(new Error("Retry aborted"));
+    });
+  });
+}
+async function retry(fn, options = {}) {
+  const opts = { ...DEFAULT_OPTIONS, ...options };
+  let lastError = new Error("No attempts made");
+  for (let attempt = 1;attempt <= opts.maxAttempts; attempt++) {
+    try {
+      if (opts.signal?.aborted) {
+        throw new Error("Retry aborted");
+      }
+      return await fn();
+    } catch (e) {
+      lastError = e instanceof Error ? e : new Error(String(e));
+      if (opts.shouldRetry && !opts.shouldRetry(lastError)) {
+        throw lastError;
+      }
+      if (attempt === opts.maxAttempts) {
+        break;
+      }
+      const delayMs = calculateDelay(attempt, opts);
+      opts.onRetry?.(attempt, lastError, delayMs);
+      await sleep(delayMs, opts.signal);
+    }
+  }
+  throw lastError;
+}
+async function retryResult(fn, options = {}) {
+  try {
+    const value = await retry(fn, options);
+    return Ok(value);
+  } catch (e) {
+    return Err(e instanceof Error ? e : new Error(String(e)));
+  }
+}
+function withRetry(fn, options = {}) {
+  return (...args) => retry(() => fn(...args), options);
+}
+var RetryConditions = {
+  networkErrors: (error) => {
+    const message = error.message.toLowerCase();
+    return message.includes("network") || message.includes("fetch") || message.includes("timeout") || message.includes("econnrefused") || message.includes("econnreset") || message.includes("socket");
+  },
+  httpRetryable: (error) => {
+    const status = error.status;
+    if (!status)
+      return false;
+    return [408, 429, 500, 502, 503, 504].includes(status);
+  },
+  websocketErrors: (error) => {
+    const message = error.message.toLowerCase();
+    return message.includes("websocket") || message.includes("connection") || message.includes("close");
+  },
+  any: (...conditions) => (error) => conditions.some((c) => c(error)),
+  all: (...conditions) => (error) => conditions.every((c) => c(error))
+};
+var RetryPresets = {
+  aggressive: {
+    maxAttempts: 10,
+    delayMs: 500,
+    backoff: "exponential",
+    maxDelayMs: 60000,
+    jitter: 0.2
+  },
+  conservative: {
+    maxAttempts: 3,
+    delayMs: 2000,
+    backoff: "linear",
+    maxDelayMs: 1e4,
+    jitter: 0.1
+  },
+  fast: {
+    maxAttempts: 5,
+    delayMs: 100,
+    backoff: "exponential",
+    maxDelayMs: 2000,
+    jitter: 0
+  },
+  websocket: {
+    maxAttempts: 10,
+    delayMs: 1000,
+    backoff: "exponential",
+    maxDelayMs: 30000,
+    jitter: 0.1,
+    shouldRetry: RetryConditions.websocketErrors
+  }
+};
+export {
+  withRetry,
+  retryResult,
+  retry,
+  RetryPresets,
+  RetryConditions
+};
+
+//# debugId=6E3ECD6C85AD305C64756E2164756E21

package/dist/retry.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/result.ts", "../src/retry.ts"],
+  "sourcesContent": [
+    "/**\n * Result Type for Error Handling\n *\n * A lightweight Result type for explicit error handling without exceptions.\n * Provides type-safe error propagation and composition.\n */\n\n/**\n * Represents either a successful value or an error\n */\nexport type Result<T, E = Error> =\n  | { readonly ok: true; readonly value: T }\n  | { readonly ok: false; readonly error: E };\n\n/**\n * Create a successful Result\n */\nexport function Ok<T>(value: T): Result<T, never> {\n  return { ok: true, value };\n}\n\n/**\n * Create a failed Result\n */\nexport function Err<E>(error: E): Result<never, E> {\n  return { ok: false, error };\n}\n\n/**\n * Check if a Result is Ok\n */\nexport function isOk<T, E>(result: Result<T, E>): result is { ok: true; value: T } {\n  return result.ok;\n}\n\n/**\n * Check if a Result is Err\n */\nexport function isErr<T, E>(result: Result<T, E>): result is { ok: false; error: E } {\n  return !result.ok;\n}\n\n/**\n * Wrap a Promise in a Result, catching any thrown errors\n */\nexport async function fromPromise<T, E = Error>(\n  promise: Promise<T>,\n  mapError?: (e: unknown) => E\n): Promise<Result<T, E>> {\n  try {\n    const value = await promise;\n    return Ok(value);\n  } catch (e) {\n    if (mapError) {\n      return Err(mapError(e));\n    }\n    return Err(e as E);\n  }\n}\n\n/**\n * Wrap a synchronous function in a Result, catching any thrown errors\n */\nexport function fromTry<T, E = Error>(\n  fn: () => T,\n  mapError?: (e: unknown) => E\n): Result<T, E> {\n  try {\n    return Ok(fn());\n  } catch (e) {\n    if (mapError) {\n      return Err(mapError(e));\n    }\n    return Err(e as E);\n  }\n}\n\n/**\n * Map over a successful Result value\n */\nexport function map<T, U, E>(\n  result: Result<T, E>,\n  fn: (value: T) => U\n): Result<U, E> {\n  if (result.ok) {\n    return Ok(fn(result.value));\n  }\n  return result;\n}\n\n/**\n * Map over a failed Result error\n */\nexport function mapErr<T, E, F>(\n  result: Result<T, E>,\n  fn: (error: E) => F\n): Result<T, F> {\n  if (!result.ok) {\n    return Err(fn(result.error));\n  }\n  return result;\n}\n\n/**\n * Chain Results together (flatMap)\n */\nexport function flatMap<T, U, E>(\n  result: Result<T, E>,\n  fn: (value: T) => Result<U, E>\n): Result<U, E> {\n  if (result.ok) {\n    return fn(result.value);\n  }\n  return result;\n}\n\n/**\n * Unwrap a Result, throwing if it's an error\n */\nexport function unwrap<T, E>(result: Result<T, E>): T {\n  if (result.ok) {\n    return result.value;\n  }\n  throw result.error;\n}\n\n/**\n * Unwrap a Result with a default value\n */\nexport function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T {\n  if (result.ok) {\n    return result.value;\n  }\n  return defaultValue;\n}\n\n/**\n * Unwrap a Result with a lazy default value\n */\nexport function unwrapOrElse<T, E>(result: Result<T, E>, fn: (error: E) => T): T {\n  if (result.ok) {\n    return result.value;\n  }\n  return fn(result.error);\n}\n\n/**\n * Match on a Result, providing handlers for both cases\n */\nexport function match<T, E, U>(\n  result: Result<T, E>,\n  handlers: {\n    ok: (value: T) => U;\n    err: (error: E) => U;\n  }\n): U {\n  if (result.ok) {\n    return handlers.ok(result.value);\n  }\n  return handlers.err(result.error);\n}\n\n/**\n * Combine multiple Results into a single Result containing an array\n * Returns the first error encountered, or Ok with all values\n */\nexport function all<T, E>(results: Result<T, E>[]): Result<T[], E> {\n  const values: T[] = [];\n  for (const result of results) {\n    if (!result.ok) {\n      return result;\n    }\n    values.push(result.value);\n  }\n  return Ok(values);\n}\n\n/**\n * Base class for typed errors with context\n */\nexport class HypenError extends Error {\n  readonly code: string;\n  readonly context?: Record<string, unknown>;\n  override readonly cause?: Error;\n\n  constructor(\n    code: string,\n    message: string,\n    options?: { context?: Record<string, unknown>; cause?: Error }\n  ) {\n    super(message);\n    this.name = 'HypenError';\n    this.code = code;\n    this.context = options?.context;\n    this.cause = options?.cause;\n\n    // Maintain proper prototype chain\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/**\n * Error thrown when an action handler fails\n */\nexport class ActionError extends HypenError {\n  readonly actionName: string;\n\n  constructor(actionName: string, cause?: unknown) {\n    super(\n      'ACTION_ERROR',\n      `Action handler \"${actionName}\" failed: ${cause instanceof Error ? cause.message : String(cause)}`,\n      {\n        context: { actionName },\n        cause: cause instanceof Error ? cause : undefined,\n      }\n    );\n    this.name = 'ActionError';\n    this.actionName = actionName;\n  }\n}\n\n/**\n * Error thrown when a connection fails\n */\nexport class ConnectionError extends HypenError {\n  readonly url: string;\n  readonly attempt?: number;\n\n  constructor(url: string, cause?: unknown, attempt?: number) {\n    super(\n      'CONNECTION_ERROR',\n      `Connection to \"${url}\" failed${attempt ? ` (attempt ${attempt})` : ''}: ${\n        cause instanceof Error ? cause.message : String(cause)\n      }`,\n      {\n        context: { url, attempt },\n        cause: cause instanceof Error ? cause : undefined,\n      }\n    );\n    this.name = 'ConnectionError';\n    this.url = url;\n    this.attempt = attempt;\n  }\n}\n\n/**\n * Error thrown when state operations fail\n */\nexport class StateError extends HypenError {\n  readonly path?: string;\n\n  constructor(message: string, path?: string, cause?: unknown) {\n    super('STATE_ERROR', message, {\n      context: { path },\n      cause: cause instanceof Error ? cause : undefined,\n    });\n    this.name = 'StateError';\n    this.path = path;\n  }\n}\n\n/**\n * Error thrown when parsing Hypen DSL source fails\n */\nexport class ParseError extends HypenError {\n  readonly source?: string;\n\n  constructor(message: string, source?: string, cause?: unknown) {\n    super('PARSE_ERROR', message, {\n      context: { source },\n      cause: cause instanceof Error ? cause : undefined,\n    });\n    this.name = 'ParseError';\n    this.source = source;\n  }\n}\n\n/**\n * Error thrown when rendering fails\n */\nexport class RenderError extends HypenError {\n  constructor(message: string, cause?: unknown) {\n    super('RENDER_ERROR', message, {\n      cause: cause instanceof Error ? cause : undefined,\n    });\n    this.name = 'RenderError';\n  }\n}\n\n/**\n * Classify a WASM engine error string into the appropriate HypenError subclass.\n * The engine returns JsValue error strings with known prefixes.\n */\nexport function classifyEngineError(err: unknown): HypenError {\n  const message = err instanceof Error ? err.message : String(err);\n\n  if (message.startsWith('Parse error:')) {\n    return new ParseError(message);\n  }\n  if (message.startsWith('Invalid state:') || message.startsWith('Invalid state patch:')) {\n    return new StateError(message);\n  }\n  if (message.startsWith('Parent node not found:')) {\n    return new RenderError(message);\n  }\n\n  return new RenderError(message);\n}\n",
+    "/**\n * Retry Utility for Network Operations\n *\n * Provides configurable retry logic with exponential/linear backoff\n * for handling transient failures in network operations.\n */\n\nimport { type Result, Ok, Err } from \"./result.js\";\n\n/**\n * Options for retry behavior\n */\nexport interface RetryOptions {\n  /** Maximum number of attempts (default: 3) */\n  maxAttempts?: number;\n  /** Initial delay in milliseconds (default: 1000) */\n  delayMs?: number;\n  /** Backoff strategy (default: 'exponential') */\n  backoff?: \"linear\" | \"exponential\" | \"none\";\n  /** Maximum delay cap in milliseconds (default: 30000) */\n  maxDelayMs?: number;\n  /** Jitter factor 0-1 to randomize delays (default: 0.1) */\n  jitter?: number;\n  /** Callback on each retry attempt */\n  onRetry?: (attempt: number, error: Error, nextDelayMs: number) => void;\n  /** Optional predicate to determine if error is retryable */\n  shouldRetry?: (error: Error) => boolean;\n  /** AbortSignal for cancellation */\n  signal?: AbortSignal;\n}\n\n/**\n * Default retry options\n */\nconst DEFAULT_OPTIONS: Required<Omit<RetryOptions, \"onRetry\" | \"shouldRetry\" | \"signal\">> = {\n  maxAttempts: 3,\n  delayMs: 1000,\n  backoff: \"exponential\",\n  maxDelayMs: 30000,\n  jitter: 0.1,\n};\n\n/**\n * Calculate delay for a given attempt\n */\nfunction calculateDelay(\n  attempt: number,\n  options: Required<Omit<RetryOptions, \"onRetry\" | \"shouldRetry\" | \"signal\">>\n): number {\n  let delay: number;\n\n  switch (options.backoff) {\n    case \"exponential\":\n      // 2^(attempt-1) * delayMs: 1x, 2x, 4x, 8x...\n      delay = options.delayMs * Math.pow(2, attempt - 1);\n      break;\n    case \"linear\":\n      // attempt * delayMs: 1x, 2x, 3x, 4x...\n      delay = options.delayMs * attempt;\n      break;\n    case \"none\":\n      delay = options.delayMs;\n      break;\n  }\n\n  // Apply jitter (randomize ±jitter%)\n  if (options.jitter > 0) {\n    const jitterRange = delay * options.jitter;\n    delay += (Math.random() * 2 - 1) * jitterRange;\n  }\n\n  // Cap at maxDelayMs\n  return Math.min(delay, options.maxDelayMs);\n}\n\n/**\n * Sleep for a given duration, respecting abort signal\n */\nfunction sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(new Error(\"Retry aborted\"));\n      return;\n    }\n\n    const timeoutId = setTimeout(resolve, ms);\n\n    signal?.addEventListener(\"abort\", () => {\n      clearTimeout(timeoutId);\n      reject(new Error(\"Retry aborted\"));\n    });\n  });\n}\n\n/**\n * Retry a function with configurable backoff\n *\n * @example\n * ```typescript\n * // Basic usage\n * const result = await retry(() => fetch('/api/data'));\n *\n * // With options\n * const result = await retry(\n *   () => fetch('/api/data'),\n *   {\n *     maxAttempts: 5,\n *     delayMs: 2000,\n *     backoff: 'exponential',\n *     onRetry: (n, err) => console.log(`Attempt ${n} failed: ${err.message}`)\n *   }\n * );\n * ```\n */\nexport async function retry<T>(\n  fn: () => T | Promise<T>,\n  options: RetryOptions = {}\n): Promise<T> {\n  const opts = { ...DEFAULT_OPTIONS, ...options };\n  let lastError: Error = new Error(\"No attempts made\");\n\n  for (let attempt = 1; attempt <= opts.maxAttempts; attempt++) {\n    try {\n      // Check for abort before each attempt\n      if (opts.signal?.aborted) {\n        throw new Error(\"Retry aborted\");\n      }\n\n      return await fn();\n    } catch (e) {\n      lastError = e instanceof Error ? e : new Error(String(e));\n\n      // Check if we should retry this error\n      if (opts.shouldRetry && !opts.shouldRetry(lastError)) {\n        throw lastError;\n      }\n\n      // If this was the last attempt, don't wait\n      if (attempt === opts.maxAttempts) {\n        break;\n      }\n\n      // Calculate delay and notify\n      const delayMs = calculateDelay(attempt, opts);\n      opts.onRetry?.(attempt, lastError, delayMs);\n\n      // Wait before next attempt\n      await sleep(delayMs, opts.signal);\n    }\n  }\n\n  throw lastError;\n}\n\n/**\n * Retry a function, returning a Result instead of throwing\n *\n * @example\n * ```typescript\n * const result = await retryResult(() => fetch('/api/data'));\n * if (result.ok) {\n *   console.log('Success:', result.value);\n * } else {\n *   console.error('All retries failed:', result.error);\n * }\n * ```\n */\nexport async function retryResult<T>(\n  fn: () => T | Promise<T>,\n  options: RetryOptions = {}\n): Promise<Result<T, Error>> {\n  try {\n    const value = await retry(fn, options);\n    return Ok(value);\n  } catch (e) {\n    return Err(e instanceof Error ? e : new Error(String(e)));\n  }\n}\n\n/**\n * Create a retryable version of a function\n *\n * @example\n * ```typescript\n * const fetchWithRetry = withRetry(\n *   (url: string) => fetch(url),\n *   { maxAttempts: 3 }\n * );\n *\n * const response = await fetchWithRetry('/api/data');\n * ```\n */\nexport function withRetry<TArgs extends unknown[], TReturn>(\n  fn: (...args: TArgs) => TReturn | Promise<TReturn>,\n  options: RetryOptions = {}\n): (...args: TArgs) => Promise<TReturn> {\n  return (...args: TArgs) => retry(() => fn(...args), options);\n}\n\n/**\n * Predefined retry conditions\n */\nexport const RetryConditions = {\n  /**\n   * Retry on network errors (fetch failures, timeouts)\n   */\n  networkErrors: (error: Error): boolean => {\n    const message = error.message.toLowerCase();\n    return (\n      message.includes(\"network\") ||\n      message.includes(\"fetch\") ||\n      message.includes(\"timeout\") ||\n      message.includes(\"econnrefused\") ||\n      message.includes(\"econnreset\") ||\n      message.includes(\"socket\")\n    );\n  },\n\n  /**\n   * Retry on specific HTTP status codes (from fetch Response)\n   */\n  httpRetryable: (error: Error & { status?: number }): boolean => {\n    const status = error.status;\n    if (!status) return false;\n    // Retry on 408, 429, 500, 502, 503, 504\n    return [408, 429, 500, 502, 503, 504].includes(status);\n  },\n\n  /**\n   * Retry on transient WebSocket errors\n   */\n  websocketErrors: (error: Error): boolean => {\n    const message = error.message.toLowerCase();\n    return (\n      message.includes(\"websocket\") ||\n      message.includes(\"connection\") ||\n      message.includes(\"close\")\n    );\n  },\n\n  /**\n   * Combine multiple conditions (retry if any match)\n   */\n  any:\n    (...conditions: Array<(error: Error) => boolean>) =>\n    (error: Error): boolean =>\n      conditions.some((c) => c(error)),\n\n  /**\n   * Combine multiple conditions (retry if all match)\n   */\n  all:\n    (...conditions: Array<(error: Error) => boolean>) =>\n    (error: Error): boolean =>\n      conditions.every((c) => c(error)),\n};\n\n/**\n * Preset configurations for common use cases\n */\nexport const RetryPresets = {\n  /**\n   * Aggressive retry for critical operations\n   */\n  aggressive: {\n    maxAttempts: 10,\n    delayMs: 500,\n    backoff: \"exponential\" as const,\n    maxDelayMs: 60000,\n    jitter: 0.2,\n  },\n\n  /**\n   * Conservative retry for non-critical operations\n   */\n  conservative: {\n    maxAttempts: 3,\n    delayMs: 2000,\n    backoff: \"linear\" as const,\n    maxDelayMs: 10000,\n    jitter: 0.1,\n  },\n\n  /**\n   * Fast retry for local operations (short delays)\n   */\n  fast: {\n    maxAttempts: 5,\n    delayMs: 100,\n    backoff: \"exponential\" as const,\n    maxDelayMs: 2000,\n    jitter: 0,\n  },\n\n  /**\n   * WebSocket reconnection preset\n   */\n  websocket: {\n    maxAttempts: 10,\n    delayMs: 1000,\n    backoff: \"exponential\" as const,\n    maxDelayMs: 30000,\n    jitter: 0.1,\n    shouldRetry: RetryConditions.websocketErrors,\n  },\n};\n"
+  ],
+  "mappings": "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",
+  "debugId": "6E3ECD6C85AD305C64756E2164756E21",
+  "names": []
+}

package/dist/router.js

@@ -22,6 +22,8 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 });
 
 // src/state.ts
+var IS_PROXY = Symbol.for("hypen.isProxy");
+var RAW_TARGET = Symbol.for("hypen.rawTarget");
 function deepClone(obj) {
   if (obj === null || typeof obj !== "object") {
     return obj;
@@ -266,19 +268,33 @@ function unwrapProxy(value) {
   }
   return value;
 }
-var IS_PROXY, RAW_TARGET;
-var init_state = __esm(() => {
-  IS_PROXY = Symbol.for("hypen.isProxy");
-  RAW_TARGET = Symbol.for("hypen.rawTarget");
-});
 
 // src/logger.ts
+var LOG_LEVEL_ORDER = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3,
+  none: 4
+};
+var LOG_LEVEL_COLORS = {
+  debug: "\x1B[36m",
+  info: "\x1B[32m",
+  warn: "\x1B[33m",
+  error: "\x1B[31m"
+};
+var RESET_COLOR = "\x1B[0m";
 function isProduction() {
   if (typeof process !== "undefined" && process.env) {
     return false;
   }
   return false;
 }
+var config = {
+  level: isProduction() ? "error" : "info",
+  colors: true,
+  timestamps: false
+};
 function setLogLevel(level) {
   config.level = level;
 }
@@ -409,70 +425,48 @@ class Logger {
 function createLogger(tag) {
   return new Logger(tag);
 }
-var LOG_LEVEL_ORDER, LOG_LEVEL_COLORS, RESET_COLOR = "\x1B[0m", config, logger, log, frameworkLoggers;
-var init_logger = __esm(() => {
-  LOG_LEVEL_ORDER = {
-    debug: 0,
-    info: 1,
-    warn: 2,
-    error: 3,
-    none: 4
-  };
-  LOG_LEVEL_COLORS = {
-    debug: "\x1B[36m",
-    info: "\x1B[32m",
-    warn: "\x1B[33m",
-    error: "\x1B[31m"
-  };
-  config = {
-    level: isProduction() ? "error" : "info",
-    colors: true,
-    timestamps: false
-  };
-  logger = createLogger("Hypen");
-  log = {
-    debug: (tag, ...args) => {
-      if (!shouldLog("debug"))
-        return;
-      console.log(formatTag(tag, "debug"), ...args);
-    },
-    info: (tag, ...args) => {
-      if (!shouldLog("info"))
-        return;
-      console.info(formatTag(tag, "info"), ...args);
-    },
-    warn: (tag, ...args) => {
-      if (!shouldLog("warn"))
-        return;
-      console.warn(formatTag(tag, "warn"), ...args);
-    },
-    error: (tag, ...args) => {
-      if (!shouldLog("error"))
-        return;
-      console.error(formatTag(tag, "error"), ...args);
-    }
-  };
-  frameworkLoggers = {
-    hypen: createLogger("Hypen"),
-    engine: createLogger("Engine"),
-    router: createLogger("Router"),
-    state: createLogger("State"),
-    events: createLogger("Events"),
-    remote: createLogger("Remote"),
-    renderer: createLogger("Renderer"),
-    module: createLogger("Module"),
-    lifecycle: createLogger("Lifecycle"),
-    loader: createLogger("Loader"),
-    context: createLogger("Context"),
-    discovery: createLogger("Discovery"),
-    plugin: createLogger("Plugin"),
-    canvas: createLogger("Canvas"),
-    debug: createLogger("Debug")
-  };
-});
+var logger = createLogger("Hypen");
+var log = {
+  debug: (tag, ...args) => {
+    if (!shouldLog("debug"))
+      return;
+    console.log(formatTag(tag, "debug"), ...args);
+  },
+  info: (tag, ...args) => {
+    if (!shouldLog("info"))
+      return;
+    console.info(formatTag(tag, "info"), ...args);
+  },
+  warn: (tag, ...args) => {
+    if (!shouldLog("warn"))
+      return;
+    console.warn(formatTag(tag, "warn"), ...args);
+  },
+  error: (tag, ...args) => {
+    if (!shouldLog("error"))
+      return;
+    console.error(formatTag(tag, "error"), ...args);
+  }
+};
+var frameworkLoggers = {
+  hypen: createLogger("Hypen"),
+  engine: createLogger("Engine"),
+  router: createLogger("Router"),
+  state: createLogger("State"),
+  events: createLogger("Events"),
+  remote: createLogger("Remote"),
+  renderer: createLogger("Renderer"),
+  module: createLogger("Module"),
+  lifecycle: createLogger("Lifecycle"),
+  loader: createLogger("Loader"),
+  context: createLogger("Context"),
+  discovery: createLogger("Discovery"),
+  plugin: createLogger("Plugin"),
+  canvas: createLogger("Canvas"),
+  debug: createLogger("Debug")
+};
 
 // src/disposable.ts
-init_logger();
 var log2 = frameworkLoggers.lifecycle;
 function isDisposable(obj) {
   return obj !== null && typeof obj === "object" && "dispose" in obj && typeof obj.dispose === "function";
@@ -620,8 +614,6 @@ function usingSync(resource, fn) {
 }
 
 // src/router.ts
-init_state();
-init_logger();
 var log3 = frameworkLoggers.router;
 
 class HypenRouter {
@@ -835,4 +827,4 @@ export {
   HypenRouter
 };
 
-//# debugId=629142C841C9E81A64756E2164756E21
+//# debugId=C084635AB532FF7664756E2164756E21