@hyperttp/core 2.0.0 → 2.0.2

package/transports/manager.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/transports/manager.ts"],
-  "sourcesContent": ["import type { HyperTransport, SenderProtocol } from \"@hyperttp/types\";\nimport { FetchTransport, type FetchTransportOptions } from \"./fetch.js\";\n\ndeclare const Bun: unknown;\ndeclare const Deno: unknown;\n\nexport type Runtime = \"bun\" | \"node\" | \"deno\" | \"browser\";\n\n/**\n * @ru Опции разрешения транспорта. `customTransport` имеет приоритет над автовыбором.\n * @en Transport resolution options. `customTransport` takes priority over auto-selection.\n */\nexport interface ResolveTransportOptions {\n  customTransport?: HyperTransport;\n  [key: string]: unknown;\n}\n\nexport const CURRENT_RUNTIME: Runtime = (() => {\n  if (typeof Bun !== \"undefined\") return \"bun\";\n  if (typeof Deno !== \"undefined\") return \"deno\";\n  if (typeof process !== \"undefined\" && process.versions?.node) return \"node\";\n  return \"browser\";\n})();\n\ntype TransportDef = {\n  readonly runtime: readonly Runtime[];\n  readonly pkg: string;\n  readonly export: string;\n  readonly priority: number;\n};\n\nconst TRANSPORT_DEFS: readonly TransportDef[] = [\n  { runtime: [\"bun\"], pkg: \"@hyperttp/transport-bun\", export: \"BunTransport\", priority: 100 },\n  { runtime: [\"node\"], pkg: \"@hyperttp/transport-undici\", export: \"UndiciTransport\", priority: 90 },\n  { runtime: [\"deno\"], pkg: \"@hyperttp/transport-deno\", export: \"DenoTransport\", priority: 85 },\n];\n\nconst CANDIDATES: readonly TransportDef[] = TRANSPORT_DEFS.filter((t) =>\n  t.runtime.includes(CURRENT_RUNTIME),\n).sort((a, b) => b.priority - a.priority);\n\nconst transportCache = new Map<string, HyperTransport>();\nconst transportResolutions = new Map<string, Promise<HyperTransport>>();\n\nfunction isModuleNotFoundError(err: unknown): boolean {\n  if (!err || typeof err !== \"object\") return false;\n  const e = err as Record<string, unknown>;\n  if (e.code === \"ERR_MODULE_NOT_FOUND\" || e.code === \"MODULE_NOT_FOUND\") return true;\n\n  const msg = err instanceof Error ? err.message : String(e.message ?? \"\");\n  return (\n    msg.includes(\"Cannot find module\") ||\n    msg.includes(\"Failed to resolve\") ||\n    msg.includes(\"Failed to load\")\n  );\n}\n\nasync function dynamicImport(pkg: string): Promise<Record<string, unknown>> {\n  /* @vite-ignore */\n  return import(/* webpackIgnore: true */ pkg);\n}\n\nfunction supportsProtocol(transport: HyperTransport, protocol: SenderProtocol): boolean {\n  return typeof transport.supports === \"function\"\n    ? transport.supports(protocol)\n    : (transport.protocols?.includes(protocol) ?? true);\n}\n\nasync function disposeUnusedTransport(transport: HyperTransport): Promise<void> {\n  if (typeof transport.destroy === \"function\") {\n    await transport.destroy();\n  } else if (typeof transport.close === \"function\") {\n    await transport.close();\n  }\n}\n\nasync function createTransport(\n  protocol: SenderProtocol,\n  config?: ResolveTransportOptions,\n): Promise<HyperTransport> {\n  for (let i = 0; i < CANDIDATES.length; i++) {\n    const t = CANDIDATES[i]!;\n    try {\n      const mod = await dynamicImport(t.pkg);\n      const candidate = (mod[t.export] ?? mod.default) as\n        | { new (opts?: unknown): HyperTransport }\n        | undefined;\n      if (typeof candidate !== \"function\") continue;\n\n      const instance = new candidate(config ?? {});\n      if (!supportsProtocol(instance, protocol)) {\n        await disposeUnusedTransport(instance);\n        continue;\n      }\n\n      return instance;\n    } catch (err) {\n      if (!isModuleNotFoundError(err)) throw err;\n    }\n  }\n\n  console.warn(\n    `[HyperCore] Fast transport (e.g. @hyperttp/transport-undici) unavailable for runtime \"${CURRENT_RUNTIME}\". Falling back to slow FetchTransport.`,\n  );\n\n  const fetchTransport = new FetchTransport(config as unknown as FetchTransportOptions);\n  if (supportsProtocol(fetchTransport, protocol)) return fetchTransport;\n\n  await disposeUnusedTransport(fetchTransport);\n  throw new Error(\n    `[HyperCore] No transport available for protocol \"${protocol}\" in runtime \"${CURRENT_RUNTIME}\".`,\n  );\n}\n\n/**\n * @ru Разрешает оптимальный транспорт для указанного протокола и текущей среды.\n * Кастомный транспорт из конфигурации имеет приоритет над автовыбором.\n * @en Resolves optimal transport for the given protocol and current runtime.\n * A custom transport from the config takes priority over auto-selection.\n */\nexport async function resolveTransport(\n  protocol: SenderProtocol = \"rest\",\n  config?: ResolveTransportOptions,\n): Promise<HyperTransport> {\n  if (config?.customTransport) {\n    if (!supportsProtocol(config.customTransport, protocol)) {\n      throw new Error(`[HyperCore] Custom transport does not support protocol \"${protocol}\".`);\n    }\n    return config.customTransport;\n  }\n\n  const cached = transportCache.get(protocol);\n  if (cached) return cached;\n\n  const pending = transportResolutions.get(protocol);\n  if (pending) return pending;\n\n  const resolution = createTransport(protocol, config)\n    .then((transport) => {\n      transportCache.set(protocol, transport);\n      return transport;\n    })\n    .finally(() => {\n      transportResolutions.delete(protocol);\n    });\n\n  transportResolutions.set(protocol, resolution);\n  return resolution;\n}\n\n/**\n * @ru Синхронно возвращает транспорт из кэша без обёртывания в Promise.\n * @en Synchronously returns a cached transport without Promise overhead.\n */\nexport function getCachedTransport(protocol: SenderProtocol = \"rest\"): HyperTransport | undefined {\n  return transportCache.get(protocol);\n}\n\nexport function evictCachedTransport(transport: HyperTransport): void {\n  for (const [protocol, cached] of transportCache) {\n    if (cached === transport) {\n      transportCache.delete(protocol);\n    }\n  }\n}\n\nexport function resetCachedTransport(): void {\n  transportCache.clear();\n  transportResolutions.clear();\n}\n"],
-  "mappings": "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",
-  "names": ["FetchTransport", "TRANSPORT_DEFS", "CANDIDATES", "a", "b", "transportCache", "transportResolutions", "isModuleNotFoundError", "err", "msg", "dynamicImport", "pkg", "supportsProtocol", "transport", "protocol", "disposeUnusedTransport", "createTransport", "config", "i", "t", "mod", "candidate", "instance", "fetchTransport", "cached", "pending", "resolution"]
+  "sourcesContent": ["import type { HyperTransport, LogLevel, SenderProtocol } from \"@hyperttp/types\";\nimport { FetchTransport, type FetchTransportOptions } from \"./fetch.js\";\nimport { dynamicImport, isModuleNotFoundError } from \"../utils/modules.js\";\n\ndeclare const Bun: unknown;\ndeclare const Deno: unknown;\n\nexport type Runtime = \"bun\" | \"node\" | \"deno\" | \"browser\";\n\n/**\n * @ru Опции разрешения транспорта. `customTransport` имеет приоритет над автовыбором.\n * @en Transport resolution options. `customTransport` takes priority over auto-selection.\n */\nexport interface ResolveTransportOptions {\n  customTransport?: HyperTransport;\n  logger?: (level: LogLevel, message: string, meta?: unknown) => void;\n  verbose?: boolean;\n  [key: string]: unknown;\n}\n\nexport const CURRENT_RUNTIME: Runtime = (() => {\n  if (typeof Bun !== \"undefined\") return \"bun\";\n  if (typeof Deno !== \"undefined\") return \"deno\";\n  if (typeof process !== \"undefined\" && process.versions?.node) return \"node\";\n  return \"browser\";\n})();\n\ntype TransportDef = {\n  readonly runtime: readonly Runtime[];\n  readonly pkg: string;\n  readonly export: string;\n};\n\nconst TRANSPORT_DEFS: readonly TransportDef[] = [\n  { runtime: [\"bun\"], pkg: \"@hyperttp/transport-bun\", export: \"BunTransport\" },\n  { runtime: [\"node\"], pkg: \"@hyperttp/transport-undici\", export: \"UndiciTransport\" },\n  { runtime: [\"deno\"], pkg: \"@hyperttp/transport-deno\", export: \"DenoTransport\" },\n];\n\nconst CANDIDATES = TRANSPORT_DEFS.filter((t) => t.runtime.includes(CURRENT_RUNTIME));\n\nconst transportCache = new Map<string, HyperTransport>();\nconst transportResolutions = new Map<string, Promise<HyperTransport>>();\n\nfunction supportsProtocol(transport: HyperTransport, protocol: SenderProtocol): boolean {\n  return typeof transport.supports === \"function\"\n    ? transport.supports(protocol)\n    : (transport.protocols?.includes(protocol) ?? true);\n}\n\nasync function disposeUnusedTransport(transport: HyperTransport): Promise<void> {\n  if (typeof transport.destroy === \"function\") {\n    await transport.destroy();\n  } else if (typeof transport.close === \"function\") {\n    await transport.close();\n  }\n}\n\nasync function createTransport(\n  protocol: SenderProtocol,\n  config?: ResolveTransportOptions,\n): Promise<HyperTransport> {\n  for (let i = 0; i < CANDIDATES.length; i++) {\n    const t = CANDIDATES[i]!;\n    try {\n      const mod = await dynamicImport(t.pkg);\n      const candidate = (mod[t.export] ?? mod.default) as\n        | { new (opts?: unknown): HyperTransport }\n        | undefined;\n      if (typeof candidate !== \"function\") continue;\n\n      const instance = new candidate(config ?? {});\n      if (!supportsProtocol(instance, protocol)) {\n        await disposeUnusedTransport(instance);\n        continue;\n      }\n\n      return instance;\n    } catch (err) {\n      if (!isModuleNotFoundError(err)) throw err;\n    }\n  }\n\n  const message = `[HyperCore] Fast transport (e.g. @hyperttp/transport-undici) unavailable for runtime \"${CURRENT_RUNTIME}\". Falling back to slow FetchTransport.`;\n  if (config?.logger) {\n    config.logger(\"warn\", message);\n  } else if (config?.verbose) {\n    console.warn(message);\n  }\n\n  const fetchTransport = new FetchTransport(config as unknown as FetchTransportOptions);\n  if (supportsProtocol(fetchTransport, protocol)) return fetchTransport;\n\n  await disposeUnusedTransport(fetchTransport);\n  throw new Error(\n    `[HyperCore] No transport available for protocol \"${protocol}\" in runtime \"${CURRENT_RUNTIME}\".`,\n  );\n}\n\n/**\n * @ru Разрешает оптимальный транспорт для указанного протокола и текущей среды.\n * Кастомный транспорт из конфигурации имеет приоритет над автовыбором.\n * @en Resolves optimal transport for the given protocol and current runtime.\n * A custom transport from the config takes priority over auto-selection.\n */\nexport async function resolveTransport(\n  protocol: SenderProtocol = \"rest\",\n  config?: ResolveTransportOptions,\n): Promise<HyperTransport> {\n  if (config?.customTransport) {\n    if (!supportsProtocol(config.customTransport, protocol)) {\n      throw new Error(`[HyperCore] Custom transport does not support protocol \"${protocol}\".`);\n    }\n    return config.customTransport;\n  }\n\n  const cached = transportCache.get(protocol);\n  if (cached) return cached;\n\n  const pending = transportResolutions.get(protocol);\n  if (pending) return pending;\n\n  const resolution = createTransport(protocol, config)\n    .then((transport) => {\n      transportCache.set(protocol, transport);\n      return transport;\n    })\n    .finally(() => {\n      transportResolutions.delete(protocol);\n    });\n\n  transportResolutions.set(protocol, resolution);\n  return resolution;\n}\n\n/**\n * @ru Синхронно возвращает транспорт из кэша без создания Promise.\n * @en Synchronously returns a cached transport without creating a Promise.\n * @param protocol - Протокол, для которого запрашивается транспорт. @en Protocol whose transport is requested.\n * @returns Кэшированный транспорт или `undefined`. @en Cached transport or `undefined`.\n */\nexport function getCachedTransport(protocol: SenderProtocol = \"rest\"): HyperTransport | undefined {\n  return transportCache.get(protocol);\n}\n\n/**\n * @ru Удаляет все записи кэша, ссылающиеся на указанный транспорт.\n * @en Removes every cache entry that references the given transport.\n * @param transport - Экземпляр транспорта для удаления из кэша. @en Transport instance to evict from the cache.\n */\nexport function evictCachedTransport(transport: HyperTransport): void {\n  for (const [protocol, cached] of transportCache) {\n    if (cached === transport) {\n      transportCache.delete(protocol);\n    }\n  }\n}\n\n/**\n * @ru Очищает кэш транспортов и ожидающих их разрешений. Не закрывает уже\n * созданные экземпляры транспорта.\n * @en Clears cached transports and pending resolutions. It does not close\n * already-created transport instances.\n */\nexport function resetCachedTransport(): void {\n  transportCache.clear();\n  transportResolutions.clear();\n}\n"],
+  "mappings": "aACA,OAAS,kBAAAA,MAAkD,aAC3D,OAAS,iBAAAC,EAAe,yBAAAC,MAA6B,sBAkB9C,aAAM,gBACP,OAAO,IAAQ,IAAoB,MACnC,OAAO,KAAS,IAAoB,OACpC,OAAO,QAAY,KAAe,QAAQ,UAAU,KAAa,OAC9D,UAST,MAAMC,EAA0C,CAC9C,CAAE,QAAS,CAAC,KAAK,EAAG,IAAK,0BAA2B,OAAQ,cAAc,EAC1E,CAAE,QAAS,CAAC,MAAM,EAAG,IAAK,6BAA8B,OAAQ,iBAAiB,EACjF,CAAE,QAAS,CAAC,MAAM,EAAG,IAAK,2BAA4B,OAAQ,eAAe,GAGzEC,EAAaD,EAAe,OAAQ,GAAM,EAAE,QAAQ,SAAS,eAAe,CAAC,EAE7EE,EAAiB,IAAI,IACrBC,EAAuB,IAAI,IAEjC,SAASC,EAAiBC,EAA2BC,EAAwB,CAC3E,OAAO,OAAOD,EAAU,UAAa,WACjCA,EAAU,SAASC,CAAQ,EAC1BD,EAAU,WAAW,SAASC,CAAQ,GAAK,EAClD,CAEA,eAAeC,EAAuBF,EAAyB,CACzD,OAAOA,EAAU,SAAY,WAC/B,MAAMA,EAAU,QAAO,EACd,OAAOA,EAAU,OAAU,YACpC,MAAMA,EAAU,MAAK,CAEzB,CAEA,eAAeG,EACbF,EACAG,EAAgC,CAEhC,QAASC,EAAI,EAAGA,EAAIT,EAAW,OAAQS,IAAK,CAC1C,MAAMC,EAAIV,EAAWS,CAAC,EACtB,GAAI,CACF,MAAME,EAAM,MAAMd,EAAca,EAAE,GAAG,EAC/BE,EAAaD,EAAID,EAAE,MAAM,GAAKC,EAAI,QAGxC,GAAI,OAAOC,GAAc,WAAY,SAErC,MAAMC,EAAW,IAAID,EAAUJ,GAAU,CAAA,CAAE,EAC3C,GAAI,CAACL,EAAiBU,EAAUR,CAAQ,EAAG,CACzC,MAAMC,EAAuBO,CAAQ,EACrC,QACF,CAEA,OAAOA,CACT,OAASC,EAAK,CACZ,GAAI,CAAChB,EAAsBgB,CAAG,EAAG,MAAMA,CACzC,CACF,CAEA,MAAMC,EAAU,yFAAyF,eAAe,0CACpHP,GAAQ,OACVA,EAAO,OAAO,OAAQO,CAAO,EACpBP,GAAQ,SACjB,QAAQ,KAAKO,CAAO,EAGtB,MAAMC,EAAiB,IAAIpB,EAAeY,CAA0C,EACpF,GAAIL,EAAiBa,EAAgBX,CAAQ,EAAG,OAAOW,EAEvD,YAAMV,EAAuBU,CAAc,EACrC,IAAI,MACR,oDAAoDX,CAAQ,iBAAiB,eAAe,IAAI,CAEpG,CAQA,sBAAsB,iBACpBA,EAA2B,OAC3BG,EAAgC,CAEhC,GAAIA,GAAQ,gBAAiB,CAC3B,GAAI,CAACL,EAAiBK,EAAO,gBAAiBH,CAAQ,EACpD,MAAM,IAAI,MAAM,2DAA2DA,CAAQ,IAAI,EAEzF,OAAOG,EAAO,eAChB,CAEA,MAAMS,EAAShB,EAAe,IAAII,CAAQ,EAC1C,GAAIY,EAAQ,OAAOA,EAEnB,MAAMC,EAAUhB,EAAqB,IAAIG,CAAQ,EACjD,GAAIa,EAAS,OAAOA,EAEpB,MAAMC,EAAaZ,EAAgBF,EAAUG,CAAM,EAChD,KAAMJ,IACLH,EAAe,IAAII,EAAUD,CAAS,EAC/BA,EACR,EACA,QAAQ,IAAK,CACZF,EAAqB,OAAOG,CAAQ,CACtC,CAAC,EAEH,OAAAH,EAAqB,IAAIG,EAAUc,CAAU,EACtCA,CACT,CAQM,gBAAU,mBAAmBd,EAA2B,OAAM,CAClE,OAAOJ,EAAe,IAAII,CAAQ,CACpC,CAOM,gBAAU,qBAAqBD,EAAyB,CAC5D,SAAW,CAACC,EAAUY,CAAM,IAAKhB,EAC3BgB,IAAWb,GACbH,EAAe,OAAOI,CAAQ,CAGpC,CAQM,gBAAU,sBAAoB,CAClCJ,EAAe,MAAK,EACpBC,EAAqB,MAAK,CAC5B",
+  "names": ["FetchTransport", "dynamicImport", "isModuleNotFoundError", "TRANSPORT_DEFS", "CANDIDATES", "transportCache", "transportResolutions", "supportsProtocol", "transport", "protocol", "disposeUnusedTransport", "createTransport", "config", "i", "t", "mod", "candidate", "instance", "err", "message", "fetchTransport", "cached", "pending", "resolution"]
 }

package/utils/errors.d.ts

@@ -9,8 +9,14 @@ export declare class HyperClientError extends Error {
     url?: string | undefined;
     method?: string | undefined;
     /**
-     * @ru Создает новый экземпляр HttpClientError.
-     * @en Creates a new HttpClientError instance.
+     * @ru Создает ошибку Hyperttp с дополнительным сетевым контекстом.
+     * @en Creates a Hyperttp error with optional network context.
+     * @param message - Человекочитаемое описание ошибки. @en Human-readable error description.
+     * @param code - Машиночитаемый код ошибки. @en Machine-readable error code.
+     * @param statusCode - Связанный HTTP-статус, если есть. @en Associated HTTP status, when available.
+     * @param originalError - Исходная ошибка как `cause`. @en Original error exposed as `cause`.
+     * @param url - URL, связанный с ошибкой. @en URL associated with the error.
+     * @param method - HTTP-метод, связанный с ошибкой. @en HTTP method associated with the error.
      */
     constructor(message: string, code?: string, statusCode?: number | undefined, originalError?: Error | undefined, url?: string | undefined, method?: string | undefined);
     /**
@@ -25,8 +31,10 @@ export declare class HyperClientError extends Error {
  */
 export declare class TimeoutError extends HyperClientError {
     /**
-     * @ru Создает новый экземпляр TimeoutError.
-     * @en Creates a new TimeoutError instance.
+     * @ru Создает ошибку таймаута для указанного URL.
+     * @en Creates a timeout error for the given URL.
+     * @param url - URL запроса с истекшим таймаутом. @en URL of the timed-out request.
+     * @param timeout - Лимит времени в миллисекундах. @en Time limit in milliseconds.
      */
     constructor(url: string, timeout: number);
     /**

package/utils/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IAOhC,IAAI,EAAE,MAAM;IACZ,UAAU,CAAC,EAAE,MAAM;IACnB,aAAa,CAAC,EAAE,KAAK;IACrB,GAAG,CAAC,EAAE,MAAM;IACZ,MAAM,CAAC,EAAE,MAAM;IAVxB;;;OAGG;IACH,YACE,OAAO,EAAE,MAAM,EACR,IAAI,GAAE,MAAsB,EAC5B,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,aAAa,CAAC,EAAE,KAAK,YAAA,EACrB,GAAG,CAAC,EAAE,MAAM,YAAA,EACZ,MAAM,CAAC,EAAE,MAAM,YAAA,EAKvB;IAED;;;OAGG;IACH,OAAc,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,gBAAgB,CAKtE;CACF;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,gBAAgB;IAChD;;;OAGG;IACH,YAAY,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAIvC;IAED;;;OAGG;IACH,OAAc,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,YAAY,CAE9D;CACF"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IAahC,IAAI,EAAE,MAAM;IACZ,UAAU,CAAC,EAAE,MAAM;IACnB,aAAa,CAAC,EAAE,KAAK;IACrB,GAAG,CAAC,EAAE,MAAM;IACZ,MAAM,CAAC,EAAE,MAAM;IAhBxB;;;;;;;;;OASG;IACH,YACE,OAAO,EAAE,MAAM,EACR,IAAI,GAAE,MAAsB,EAC5B,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,aAAa,CAAC,EAAE,KAAK,YAAA,EACrB,GAAG,CAAC,EAAE,MAAM,YAAA,EACZ,MAAM,CAAC,EAAE,MAAM,YAAA,EAKvB;IAED;;;OAGG;IACH,OAAc,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,gBAAgB,CAKtE;CACF;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,gBAAgB;IAChD;;;;;OAKG;IACH,YAAY,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAIvC;IAED;;;OAGG;IACH,OAAc,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,YAAY,CAE9D;CACF"}

package/utils/errors.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/utils/errors.ts"],
-  "sourcesContent": ["/**\n * @ru Базовый класс ошибок клиента Hyperttp, агрегирующий контекст неудачного сетевого запроса.\n * @en Base error class for the Hyperttp client, providing explicit layout context for failed requests.\n */\nexport class HyperClientError extends Error {\n  /**\n   * @ru Создает новый экземпляр HttpClientError.\n   * @en Creates a new HttpClientError instance.\n   */\n  constructor(\n    message: string,\n    public code: string = \"HYPER_ERROR\",\n    public statusCode?: number,\n    public originalError?: Error,\n    public url?: string,\n    public method?: string,\n  ) {\n    super(message, originalError ? { cause: originalError } : undefined);\n    this.name = \"HyperClientError\";\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  /**\n   * @ru Проверяет, является ли ошибка экземпляром HttpClientError (безопасно для разрозненных бандлов).\n   * @en Checks if an error is an HttpClientError instance (bundle boundary safe).\n   */\n  public static isHyperClientError(err: unknown): err is HyperClientError {\n    return (\n      err instanceof HyperClientError ||\n      (err instanceof Error && (err as any).code === \"HYPER_ERROR\")\n    );\n  }\n}\n\n/**\n * @ru Ошибка, возникающая при превышении лимита времени ожидания ответа от сервера.\n * @en Error thrown when a network request exceeds its allocated execution timeout threshold.\n */\nexport class TimeoutError extends HyperClientError {\n  /**\n   * @ru Создает новый экземпляр TimeoutError.\n   * @en Creates a new TimeoutError instance.\n   */\n  constructor(url: string, timeout: number) {\n    super(`Timeout after ${timeout}ms`, \"TIMEOUT\", 408, undefined, url);\n    this.name = \"TimeoutError\";\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  /**\n   * @ru Проверяет, является ли ошибка экземпляром TimeoutError.\n   * @en Checks if an error is a TimeoutError instance.\n   */\n  public static isTimeoutError(err: unknown): err is TimeoutError {\n    return err instanceof TimeoutError || (err instanceof Error && (err as any).code === \"TIMEOUT\");\n  }\n}\n"],
-  "mappings": "aAIM,aAAO,yBAAyB,KAAK,CAOhC,KACA,WACA,cACA,IACA,OANT,YACEA,EACOC,EAAe,cACfC,EACAC,EACAC,EACAC,EAAe,CAEtB,MAAML,EAASG,EAAgB,CAAE,MAAOA,CAAa,EAAK,MAAS,YAN5DF,kBACAC,qBACAC,WACAC,cACAC,EAGP,KAAK,KAAO,mBACZ,OAAO,eAAe,KAAM,WAAW,SAAS,CAClD,CAMO,OAAO,mBAAmBC,EAAY,CAC3C,OACEA,aAAe,kBACdA,aAAe,OAAUA,EAAY,OAAS,aAEnD,EAOI,aAAO,qBAAqB,gBAAgB,CAKhD,YAAYF,EAAaG,EAAe,CACtC,MAAM,iBAAiBA,CAAO,KAAM,UAAW,IAAK,OAAWH,CAAG,EAClE,KAAK,KAAO,eACZ,OAAO,eAAe,KAAM,WAAW,SAAS,CAClD,CAMO,OAAO,eAAeE,EAAY,CACvC,OAAOA,aAAe,cAAiBA,aAAe,OAAUA,EAAY,OAAS,SACvF",
+  "sourcesContent": ["/**\n * @ru Базовый класс ошибок клиента Hyperttp, агрегирующий контекст неудачного сетевого запроса.\n * @en Base error class for the Hyperttp client, providing explicit layout context for failed requests.\n */\nexport class HyperClientError extends Error {\n  /**\n   * @ru Создает ошибку Hyperttp с дополнительным сетевым контекстом.\n   * @en Creates a Hyperttp error with optional network context.\n   * @param message - Человекочитаемое описание ошибки. @en Human-readable error description.\n   * @param code - Машиночитаемый код ошибки. @en Machine-readable error code.\n   * @param statusCode - Связанный HTTP-статус, если есть. @en Associated HTTP status, when available.\n   * @param originalError - Исходная ошибка как `cause`. @en Original error exposed as `cause`.\n   * @param url - URL, связанный с ошибкой. @en URL associated with the error.\n   * @param method - HTTP-метод, связанный с ошибкой. @en HTTP method associated with the error.\n   */\n  constructor(\n    message: string,\n    public code: string = \"HYPER_ERROR\",\n    public statusCode?: number,\n    public originalError?: Error,\n    public url?: string,\n    public method?: string,\n  ) {\n    super(message, originalError ? { cause: originalError } : undefined);\n    this.name = \"HyperClientError\";\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  /**\n   * @ru Проверяет, является ли ошибка экземпляром HttpClientError (безопасно для разрозненных бандлов).\n   * @en Checks if an error is an HttpClientError instance (bundle boundary safe).\n   */\n  public static isHyperClientError(err: unknown): err is HyperClientError {\n    return (\n      err instanceof HyperClientError ||\n      (err instanceof Error && (err as any).code === \"HYPER_ERROR\")\n    );\n  }\n}\n\n/**\n * @ru Ошибка, возникающая при превышении лимита времени ожидания ответа от сервера.\n * @en Error thrown when a network request exceeds its allocated execution timeout threshold.\n */\nexport class TimeoutError extends HyperClientError {\n  /**\n   * @ru Создает ошибку таймаута для указанного URL.\n   * @en Creates a timeout error for the given URL.\n   * @param url - URL запроса с истекшим таймаутом. @en URL of the timed-out request.\n   * @param timeout - Лимит времени в миллисекундах. @en Time limit in milliseconds.\n   */\n  constructor(url: string, timeout: number) {\n    super(`Timeout after ${timeout}ms`, \"TIMEOUT\", 408, undefined, url);\n    this.name = \"TimeoutError\";\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  /**\n   * @ru Проверяет, является ли ошибка экземпляром TimeoutError.\n   * @en Checks if an error is a TimeoutError instance.\n   */\n  public static isTimeoutError(err: unknown): err is TimeoutError {\n    return err instanceof TimeoutError || (err instanceof Error && (err as any).code === \"TIMEOUT\");\n  }\n}\n"],
+  "mappings": "aAIM,aAAO,yBAAyB,KAAK,CAahC,KACA,WACA,cACA,IACA,OANT,YACEA,EACOC,EAAe,cACfC,EACAC,EACAC,EACAC,EAAe,CAEtB,MAAML,EAASG,EAAgB,CAAE,MAAOA,CAAa,EAAK,MAAS,YAN5DF,kBACAC,qBACAC,WACAC,cACAC,EAGP,KAAK,KAAO,mBACZ,OAAO,eAAe,KAAM,WAAW,SAAS,CAClD,CAMO,OAAO,mBAAmBC,EAAY,CAC3C,OACEA,aAAe,kBACdA,aAAe,OAAUA,EAAY,OAAS,aAEnD,EAOI,aAAO,qBAAqB,gBAAgB,CAOhD,YAAYF,EAAaG,EAAe,CACtC,MAAM,iBAAiBA,CAAO,KAAM,UAAW,IAAK,OAAWH,CAAG,EAClE,KAAK,KAAO,eACZ,OAAO,eAAe,KAAM,WAAW,SAAS,CAClD,CAMO,OAAO,eAAeE,EAAY,CACvC,OAAOA,aAAe,cAAiBA,aAAe,OAAUA,EAAY,OAAS,SACvF",
   "names": ["message", "code", "statusCode", "originalError", "url", "method", "err", "timeout"]
 }

package/utils/modules.d.ts

@@ -0,0 +1,3 @@
+export declare function isModuleNotFoundError(err: unknown): boolean;
+export declare function dynamicImport(pkg: string): Promise<Record<string, unknown>>;
+//# sourceMappingURL=modules.d.ts.map

package/utils/modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules.d.ts","sourceRoot":"","sources":["../../src/utils/modules.ts"],"names":[],"mappings":"AAAA,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAW3D;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAGjF"}

package/utils/modules.js

@@ -0,0 +1,2 @@
+"use strict";export function isModuleNotFoundError(e){if(!e||typeof e!="object")return!1;const o=e;if(o.code==="ERR_MODULE_NOT_FOUND"||o.code==="MODULE_NOT_FOUND")return!0;const n=e instanceof Error?e.message:String(o.message??"");return n.includes("Cannot find module")||n.includes("Failed to resolve")||n.includes("Failed to load")}export async function dynamicImport(e){return import(e)}
+//# sourceMappingURL=modules.js.map

package/utils/modules.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/modules.ts"],
+  "sourcesContent": ["export function isModuleNotFoundError(err: unknown): boolean {\n  if (!err || typeof err !== \"object\") return false;\n  const e = err as Record<string, unknown>;\n  if (e.code === \"ERR_MODULE_NOT_FOUND\" || e.code === \"MODULE_NOT_FOUND\") return true;\n\n  const message = err instanceof Error ? err.message : String(e.message ?? \"\");\n  return (\n    message.includes(\"Cannot find module\") ||\n    message.includes(\"Failed to resolve\") ||\n    message.includes(\"Failed to load\")\n  );\n}\n\nexport async function dynamicImport(pkg: string): Promise<Record<string, unknown>> {\n  /* @vite-ignore */\n  return import(/* webpackIgnore: true */ pkg);\n}\n"],
+  "mappings": "aAAM,gBAAU,sBAAsBA,EAAY,CAChD,GAAI,CAACA,GAAO,OAAOA,GAAQ,SAAU,MAAO,GAC5C,MAAMC,EAAID,EACV,GAAIC,EAAE,OAAS,wBAA0BA,EAAE,OAAS,mBAAoB,MAAO,GAE/E,MAAMC,EAAUF,aAAe,MAAQA,EAAI,QAAU,OAAOC,EAAE,SAAW,EAAE,EAC3E,OACEC,EAAQ,SAAS,oBAAoB,GACrCA,EAAQ,SAAS,mBAAmB,GACpCA,EAAQ,SAAS,gBAAgB,CAErC,CAEA,sBAAsB,cAAcC,EAAW,CAE7C,OAAO,OAAiCA,EAC1C",
+  "names": ["err", "e", "message", "pkg"]
+}