@snack-kit/lib 0.3.0 → 0.5.0

package/dist/es/chunk-YV6SGXUJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/http/context.ts","../../src/http/cancel.ts","../../src/http/client.ts"],"names":["axios"],"mappings":"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","file":"chunk-YV6SGXUJ.js","sourcesContent":["import axios from 'axios'\nimport type { ContextInfo } from './types'\n\n/**\n * globalThis 上的标志位 key，由 `Debugger.init()` 写入。\n * `Context.load()` 无参数调用时，若检测到此标志则跳过自动加载，\n * 由 Debugger 负责在用户选择服务后调用 `Context.load(origin)`。\n */\nexport const DEBUGGER_ACTIVE_KEY = '__snackkit_debugger__active'\n\n/** 网关 `/ngw/context` 原始响应格式（包含路由映射和 `$info` 元数据） */\ninterface ContextResponse {\n  $info?: ContextInfo\n  [key: string]: string | ContextInfo | undefined\n}\n\n/**\n * 管理服务地址映射的上下文单例\n *\n * 支持三种加载方式：\n * - **不传参数**：生产环境自动以当前页面 Origin 为网关，开发环境由 `Debugger` 接管\n * - **远程加载**：传入网关 URL，自动请求 `GET /ngw/context` 获取映射表\n * - **本地注入**：直接传入键值对象，不发起网络请求\n *\n * @example 生产环境不传参（推荐）\n * ```ts\n * import { Context } from '@snack-kit/lib/http'\n *\n * await Context.load()\n * Context.get('ngw') // 'https://app.example.com/ngw'\n * ```\n *\n * @example 远程加载（指定网关）\n * ```ts\n * await Context.load('http://172.16.32.155:20000')\n * Context.get('ngw')   // 'http://172.16.32.155:20000/ngw'\n * Context.info         // { version: '4.6.2-r10', domain: '...', ... }\n * ```\n *\n * @example 本地注入\n * ```ts\n * await Context.load({\n *   'user-svc': 'http://user.api.com',\n *   'order-svc': 'http://order.api.com',\n * })\n * ```\n */\nexport class HttpContext {\n  private _store = new Map<string, string>()\n  private _loaded = false\n  private _info: ContextInfo | undefined\n\n  /**\n   * 加载服务地址映射\n   *\n   * 支持三种调用方式：\n   * - **传入字符串**：作为网关地址，自动请求 `GET /ngw/context` 获取映射表\n   * - **传入对象**：直接注入键值映射，不发起网络请求\n   * - **不传参数**：\n   *   - 生产环境（`NODE_ENV === 'production'`）：以当前页面 `Origin` 为网关地址自动加载\n   *   - 开发环境：立即返回，不做任何操作（应由 `Debugger.init()` 接管加载流程）\n   *\n   * 远程加载时，响应中的 `$info` 元数据字段会被单独存储，不计入路由映射表。\n   *\n   * @param source 网关 URL / 键值对象 / 省略\n   * @param timeout 远程加载超时（ms），默认 5000\n   *\n   * @example 不传参——生产环境自动使用当前页面 Origin\n   * ```ts\n   * await Context.load()\n   * ```\n   *\n   * @example 传入网关地址\n   * ```ts\n   * await Context.load('http://172.16.32.155:20000', 3000)\n   * ```\n   *\n   * @example 本地注入\n   * ```ts\n   * await Context.load({ 'user-svc': 'http://user.api.com' })\n   * ```\n   */\n  async load(source?: string | Record<string, string>, timeout = 5000): Promise<void> {\n    if (source === undefined) {\n      // Debugger 已激活时，由其负责加载，此处跳过\n      if ((globalThis as Record<string, unknown>)[DEBUGGER_ACTIVE_KEY]) return\n      // 生产环境：以当前页面 Origin 为网关地址\n      if (!Origin) return\n      source = Origin\n    }\n    if (typeof source === 'string') {\n      const url = `${source}/ngw/context`\n      const res = await axios.get<ContextResponse>(url, { timeout })\n      const data = res.data\n      if (data && typeof data === 'object') {\n        this._store.clear()\n        for (const [k, v] of Object.entries(data)) {\n          if (k === '$info') {\n            // 保存元数据，不计入路由映射\n            this._info = v as ContextInfo\n          } else if (typeof v === 'string') {\n            this._store.set(k, v)\n          }\n        }\n      }\n    } else {\n      this._store.clear()\n      for (const [k, v] of Object.entries(source)) {\n        this._store.set(k, v)\n      }\n    }\n    this._loaded = true\n  }\n\n  /**\n   * 获取指定 ctx key 对应的服务地址\n   * @param key ctx key，例如 `'ngw'`、`'osc'`\n   * @returns 服务地址，未找到时返回空字符串\n   *\n   * @example\n   * ```ts\n   * await Context.load('http://172.16.32.155:20000')\n   * Context.get('osc')  // 'http://172.16.32.155:20000/osc'\n   * Context.get('none') // ''\n   * ```\n   */\n  get(key: string): string {\n    return this._store.get(key) ?? ''\n  }\n\n  /**\n   * 网关元数据（仅远程加载后可用）\n   *\n   * @example\n   * ```ts\n   * await Context.load('http://172.16.32.155:20000')\n   * Context.info?.version // '4.6.2-r10'\n   * Context.info?.domain  // 'http://172.16.32.155:20000'\n   * ```\n   */\n  get info(): ContextInfo | undefined {\n    return this._info\n  }\n\n  /**\n   * Context 是否已加载\n   *\n   * @example\n   * ```ts\n   * Context.loaded // false\n   * await Context.load({ 'user-svc': 'http://user.api.com' })\n   * Context.loaded // true\n   * ```\n   */\n  get loaded(): boolean {\n    return this._loaded\n  }\n\n  /**\n   * 清空所有映射并重置加载状态\n   *\n   * @example\n   * ```ts\n   * Context.clear()\n   * Context.loaded // false\n   * ```\n   */\n  clear(): void {\n    this._store.clear()\n    this._loaded = false\n    this._info = undefined\n  }\n}\n\n/** 模块级单例，避免全局 window 污染 */\nconst _instance = new HttpContext()\n\n/**\n * HttpContext 全局单例\n *\n * @example\n * ```ts\n * import { Context } from '@snack-kit/lib/http'\n *\n * await Context.load('http://172.16.32.155:20000')\n * Context.get('osc') // 'http://172.16.32.155:20000/osc'\n * ```\n */\nexport const Context: HttpContext = _instance\n\n/** 浏览器 location 对象（兼容 Node/SSR 环境） */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst _loc: { protocol?: string; host?: string; pathname?: string } | undefined =\n  typeof globalThis !== 'undefined'\n    ? ((globalThis as Record<string, unknown>)['location'] as typeof _loc)\n    : undefined\n\n/**\n * 当前页面的 origin（`protocol + host`）\n *\n * 在非浏览器环境（如 SSR/Node）返回空字符串。\n *\n * @example\n * ```ts\n * import { Origin } from '@snack-kit/lib/http'\n * // 浏览器中：'https://app.example.com'\n * // Node 环境：''\n * ```\n */\nexport const Origin: string =\n  _loc?.protocol && _loc?.host ? `${_loc.protocol}//${_loc.host}` : ''\n\n/**\n * 当前页面路径的首段，可直接用作 `ctx` 参数\n *\n * 例如 `/osc/employee` → `'osc'`，在非浏览器环境返回空字符串。\n *\n * @example\n * ```ts\n * import { Ctx, Get } from '@snack-kit/lib/http'\n *\n * // 当前路径为 /osc/... 时，Ctx === 'osc'\n * const result = await Get('/employee', { ctx: Ctx })\n * ```\n */\nexport const Ctx: string = _loc?.pathname ? (_loc.pathname.split('/')[1] ?? '') : ''\n","/** 模块私有注册表，避免全局 window 污染 */\nconst registry = new Map<string, AbortController>()\n\n/**\n * 注册一个请求取消控制器\n *\n * 若已存在相同 id 的控制器，先取消旧请求再注册新的。\n *\n * @param id 请求唯一标识\n * @returns 新创建的 AbortController\n *\n * @example\n * ```ts\n * import { Register, Cancel } from '@snack-kit/lib/http'\n *\n * const ctrl = Register('my-req')\n * // 请求进行中时手动取消\n * Cancel('my-req')\n * ```\n */\nexport function Register(id: string): AbortController {\n  if (registry.has(id)) {\n    registry.get(id)!.abort()\n  }\n  const controller = new AbortController()\n  registry.set(id, controller)\n  return controller\n}\n\n/**\n * 取消指定 id 的请求并从注册表移除\n *\n * @param id 请求唯一标识\n * @returns 是否找到并取消了请求\n *\n * @example\n * ```ts\n * import { Get, Cancel } from '@snack-kit/lib/http'\n *\n * let cancelId = ''\n * Get('/api/data', { onCancelId: (id) => { cancelId = id } })\n *\n * // 需要时取消\n * Cancel(cancelId)\n * ```\n */\nexport function Cancel(id: string): boolean {\n  const controller = registry.get(id)\n  if (!controller) return false\n  controller.abort()\n  registry.delete(id)\n  return true\n}\n\n/**\n * 取消所有已注册的请求并清空注册表\n *\n * @example\n * ```ts\n * import { CancelAll } from '@snack-kit/lib/http'\n *\n * // 页面卸载时取消所有进行中的请求\n * window.addEventListener('beforeunload', () => CancelAll())\n * ```\n */\nexport function CancelAll(): void {\n  for (const controller of registry.values()) {\n    controller.abort()\n  }\n  registry.clear()\n}\n\n/**\n * 从注册表中移除指定 id（不触发取消，用于请求完成后内部清理）\n *\n * @param id 请求唯一标识\n */\nexport function Unregister(id: string): void {\n  registry.delete(id)\n}\n","import axios, { isAxiosError } from 'axios'\nimport { Context } from './context'\nimport { Register, Unregister } from './cancel'\nimport type { HttpRequestConfig, HttpMethodConfig, HttpResult } from './types'\n\n/** 生成请求唯一 ID */\nfunction generateId(): string {\n  if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\n    return crypto.randomUUID()\n  }\n  return `${Date.now()}-${Math.random().toString(36).slice(2)}`\n}\n\n/**\n * 核心请求函数，所有快捷方法基于此实现\n *\n * 自动处理：\n * - `ctx` → 从 HttpContext 查询 baseURL 并注入\n * - `cache: false`（默认）→ URL 附加 `?_=timestamp` 防缓存\n * - 请求取消 → 自动注册 AbortController，完成后自动清理\n * - 错误捕获 → 统一返回 `{ error }` 而非 throw\n *\n * @param config 请求配置\n * @returns 请求结果\n *\n * @example 基础用法\n * ```ts\n * import { Request } from '@snack-kit/lib/http'\n *\n * const result = await Request<{ id: number }>({ url: '/api/user', method: 'GET' })\n * if (result.error) {\n *   console.error(result.error.message)\n * } else {\n *   console.log(result.data)\n * }\n * ```\n *\n * @example 使用 ctx 自动注入 baseURL\n * ```ts\n * import { context, Request } from '@snack-kit/lib/http'\n *\n * await context.load({ 'user-svc': 'http://user.api.com' })\n * const result = await Request({ url: '/profile', method: 'GET', ctx: 'user-svc' })\n * // 实际请求：GET http://user.api.com/profile\n * ```\n */\nexport async function Request<T>(config: HttpRequestConfig): Promise<HttpResult<T>> {\n  const { ctx, cancelId: customCancelId, onCancelId, cache = false, ...axiosConfig } = config\n\n  // ctx 自动注入 baseURL\n  if (ctx && Context.loaded) {\n    const base = Context.get(ctx)\n    if (base) {\n      axiosConfig.baseURL = base\n    }\n  }\n\n  // 防缓存：默认添加时间戳参数\n  if (!cache) {\n    const sep = (axiosConfig.url ?? '').includes('?') ? '&' : '?'\n    axiosConfig.url = `${axiosConfig.url ?? ''}${sep}_=${Date.now()}`\n  }\n\n  // 注册取消控制器\n  const cancelId = customCancelId ?? generateId()\n  const controller = Register(cancelId)\n  axiosConfig.signal = controller.signal\n  onCancelId?.(cancelId)\n\n  try {\n    const response = await axios.request<T>({ ...axiosConfig })\n    return response\n  } catch (err) {\n    if (isAxiosError(err)) {\n      return {\n        error: {\n          status: err.response?.status,\n          message: err.message,\n          data: err.response?.data,\n        },\n      }\n    }\n    // AbortError 或其他非 axios 错误\n    const message = err instanceof Error ? err.message : String(err)\n    return { error: { message } }\n  } finally {\n    Unregister(cancelId)\n  }\n}\n\n/**\n * 发起 GET 请求\n *\n * 支持两种调用方式：\n * - `Get(url, config?)` — 位置参数形式\n * - `Get(config)` — 纯配置对象形式（`method` 已预置，无需传入）\n *\n * @example 位置参数\n * ```ts\n * const { data, error } = await Get<{ name: string }>('/api/user/1')\n * ```\n *\n * @example 配置对象\n * ```ts\n * const { data } = await Get({ url: '/api/user/1', ctx: 'user-svc' })\n * ```\n *\n * @example 获取 cancelId 以便主动取消\n * ```ts\n * let cancelId = ''\n * Get('/api/list', { onCancelId: (id) => { cancelId = id } })\n * Cancel(cancelId)\n * ```\n */\nexport function Get<T>(url: string, config?: HttpMethodConfig): Promise<HttpResult<T>>\nexport function Get<T>(config: HttpMethodConfig): Promise<HttpResult<T>>\nexport function Get<T>(\n  urlOrConfig: string | HttpMethodConfig,\n  config?: HttpMethodConfig,\n): Promise<HttpResult<T>> {\n  if (typeof urlOrConfig === 'string') {\n    return Request<T>({ ...config, method: 'GET', url: urlOrConfig })\n  }\n  return Request<T>({ ...urlOrConfig, method: 'GET' })\n}\n\n/**\n * 发起 POST 请求\n *\n * 支持两种调用方式：\n * - `Post(url, data?, config?)` — 位置参数形式\n * - `Post(config)` — 纯配置对象形式（`data` 通过 `config.data` 传入，`method` 已预置）\n *\n * @example 位置参数\n * ```ts\n * const { data, error } = await Post<{ token: string }>('/api/login', {\n *   username: 'admin',\n *   password: '123456',\n * })\n * ```\n *\n * @example 配置对象\n * ```ts\n * const { data } = await Post({\n *   url: '/api/login',\n *   data: { username: 'admin', password: '123456' },\n *   ctx: 'user-svc',\n * })\n * ```\n */\nexport function Post<T>(url: string, data?: unknown, config?: HttpMethodConfig): Promise<HttpResult<T>>\nexport function Post<T>(config: HttpMethodConfig): Promise<HttpResult<T>>\nexport function Post<T>(\n  urlOrConfig: string | HttpMethodConfig,\n  data?: unknown,\n  config?: HttpMethodConfig,\n): Promise<HttpResult<T>> {\n  if (typeof urlOrConfig === 'string') {\n    return Request<T>({ ...config, method: 'POST', url: urlOrConfig, data })\n  }\n  return Request<T>({ ...urlOrConfig, method: 'POST' })\n}\n\n/**\n * 发起 PUT 请求\n *\n * 支持两种调用方式：\n * - `Put(url, data?, config?)` — 位置参数形式\n * - `Put(config)` — 纯配置对象形式（`data` 通过 `config.data` 传入，`method` 已预置）\n *\n * @example 位置参数\n * ```ts\n * await Put('/api/user/1', { name: 'Alice' })\n * ```\n *\n * @example 配置对象\n * ```ts\n * await Put({ url: '/api/user/1', data: { name: 'Alice' }, ctx: 'user-svc' })\n * ```\n */\nexport function Put<T>(url: string, data?: unknown, config?: HttpMethodConfig): Promise<HttpResult<T>>\nexport function Put<T>(config: HttpMethodConfig): Promise<HttpResult<T>>\nexport function Put<T>(\n  urlOrConfig: string | HttpMethodConfig,\n  data?: unknown,\n  config?: HttpMethodConfig,\n): Promise<HttpResult<T>> {\n  if (typeof urlOrConfig === 'string') {\n    return Request<T>({ ...config, method: 'PUT', url: urlOrConfig, data })\n  }\n  return Request<T>({ ...urlOrConfig, method: 'PUT' })\n}\n\n/**\n * 发起 PATCH 请求\n *\n * 支持两种调用方式：\n * - `Patch(url, data?, config?)` — 位置参数形式\n * - `Patch(config)` — 纯配置对象形式（`data` 通过 `config.data` 传入，`method` 已预置）\n *\n * @example 位置参数\n * ```ts\n * await Patch('/api/user/1', { avatar: 'https://...' })\n * ```\n *\n * @example 配置对象\n * ```ts\n * await Patch({ url: '/api/user/1', data: { avatar: 'https://...' }, ctx: 'user-svc' })\n * ```\n */\nexport function Patch<T>(url: string, data?: unknown, config?: HttpMethodConfig): Promise<HttpResult<T>>\nexport function Patch<T>(config: HttpMethodConfig): Promise<HttpResult<T>>\nexport function Patch<T>(\n  urlOrConfig: string | HttpMethodConfig,\n  data?: unknown,\n  config?: HttpMethodConfig,\n): Promise<HttpResult<T>> {\n  if (typeof urlOrConfig === 'string') {\n    return Request<T>({ ...config, method: 'PATCH', url: urlOrConfig, data })\n  }\n  return Request<T>({ ...urlOrConfig, method: 'PATCH' })\n}\n\n/**\n * 发起 DELETE 请求\n *\n * 支持两种调用方式：\n * - `Del(url, config?)` — 位置参数形式\n * - `Del(config)` — 纯配置对象形式（`method` 已预置）\n *\n * @example 位置参数\n * ```ts\n * await Del('/api/user/1')\n * ```\n *\n * @example 配置对象\n * ```ts\n * await Del({ url: '/api/user/1', ctx: 'user-svc' })\n * ```\n */\nexport function Del<T>(url: string, config?: HttpMethodConfig): Promise<HttpResult<T>>\nexport function Del<T>(config: HttpMethodConfig): Promise<HttpResult<T>>\nexport function Del<T>(\n  urlOrConfig: string | HttpMethodConfig,\n  config?: HttpMethodConfig,\n): Promise<HttpResult<T>> {\n  if (typeof urlOrConfig === 'string') {\n    return Request<T>({ ...config, method: 'DELETE', url: urlOrConfig })\n  }\n  return Request<T>({ ...urlOrConfig, method: 'DELETE' })\n}\n"]}

package/dist/es/debugger.js

@@ -1,4 +1,4 @@
-export { Debugger } from './chunk-4DLFIN3C.js';
-import './chunk-JQYH5FWE.js';
+export { Debugger } from './chunk-4SGFAIRT.js';
+export { DEBUGGER_ACTIVE_KEY } from './chunk-YV6SGXUJ.js';
 //# sourceMappingURL=debugger.js.map
 //# sourceMappingURL=debugger.js.map

package/dist/es/http.js

@@ -1,4 +1,4 @@
-import './chunk-BEL6AFK4.js';
-export { Cancel, CancelAll, Context, Ctx, Del, Get, HttpContext, Origin, Patch, Post, Put, Request } from './chunk-JQYH5FWE.js';
+export { default as axios } from './chunk-MHCY2PIP.js';
+export { Cancel, CancelAll, Context, Ctx, Del, Get, HttpContext, Origin, Patch, Post, Put, Request } from './chunk-YV6SGXUJ.js';
 //# sourceMappingURL=http.js.map
 //# sourceMappingURL=http.js.map

package/dist/es/index.js

@@ -1,10 +1,10 @@
-import './chunk-BEL6AFK4.js';
-export { Debugger } from './chunk-4DLFIN3C.js';
-export { Cancel, CancelAll, Context, Ctx, Del, Get, HttpContext, Origin, Patch, Post, Put, Request } from './chunk-JQYH5FWE.js';
+export { default as axios } from './chunk-MHCY2PIP.js';
+export { Debugger } from './chunk-4SGFAIRT.js';
+export { Cancel, CancelAll, Context, Ctx, DEBUGGER_ACTIVE_KEY, Del, Get, HttpContext, Origin, Patch, Post, Put, Request } from './chunk-YV6SGXUJ.js';
 export { CleanObject, Debounce, DeepClone, Delay, FormatDate, GetDateOffset, GetDayRange, GetURLParam, GetURLParams, IsArray, IsBoolean, IsEmail, IsEqual, IsFunction, IsInteger, IsIpv4, IsNull, IsNumber, IsObject, IsPhone, IsPositiveInteger, IsRealNumber, IsString, IsUrl, Minus, ObjectToQuery, Omit, Pick, QueryToObject, REGEX, Throttle, UUID, Unique, UniqueByKey } from './chunk-WJX5Q3WL.js';
 
 // package.json
-var version = "0.3.0";
+var version = "0.5.0";
 
 export { version as VERSION };
 //# sourceMappingURL=index.js.map

package/dist/es/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../package.json"],"names":[],"mappings":";;;;;;AAEE,IAAA,OAAA,GAAW","file":"index.js","sourcesContent":["{\n  \"name\": \"@snack-kit/lib\",\n  \"version\": \"0.3.0\",\n  \"description\": \"Enterprise-grade utility library\",\n  \"keywords\": [],\n  \"license\": \"MIT\",\n  \"type\": \"module\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/types/index.d.ts\",\n      \"import\": \"./dist/es/index.js\",\n      \"require\": \"./dist/cjs/index.cjs\"\n    },\n    \"./http\": {\n      \"types\": \"./dist/types/http.d.ts\",\n      \"import\": \"./dist/es/http.js\",\n      \"require\": \"./dist/cjs/http.cjs\"\n    },\n    \"./debugger\": {\n      \"types\": \"./dist/types/debugger.d.ts\",\n      \"import\": \"./dist/es/debugger.js\",\n      \"require\": \"./dist/cjs/debugger.cjs\"\n    },\n    \"./utils\": {\n      \"types\": \"./dist/types/utils.d.ts\",\n      \"import\": \"./dist/es/utils.js\",\n      \"require\": \"./dist/cjs/utils.cjs\"\n    }\n  },\n  \"main\": \"./dist/cjs/index.cjs\",\n  \"module\": \"./dist/es/index.js\",\n  \"types\": \"./dist/types/index.d.ts\",\n  \"files\": [\n    \"dist\"\n  ],\n  \"scripts\": {\n    \"build\": \"tsup\",\n    \"build:watch\": \"tsup --watch\",\n    \"test\": \"vitest run\",\n    \"test:watch\": \"vitest\",\n    \"test:coverage\": \"vitest run --coverage\",\n    \"docs\": \"typedoc && cp -r docs/demo docs/api/demo\",\n    \"docs:watch\": \"typedoc --watch\",\n    \"lint\": \"tsc --noEmit\",\n    \"prepublishOnly\": \"npm run build\",\n    \"release\": \"npm run build && npm publish --access public\"\n  },\n  \"devDependencies\": {\n    \"@vitest/coverage-v8\": \"^2.0.0\",\n    \"tsup\": \"^8.0.0\",\n    \"typedoc\": \"^0.26.0\",\n    \"typescript\": \"^5.5.3\",\n    \"vitest\": \"^2.0.0\"\n  },\n  \"dependencies\": {\n    \"axios\": \"^1.13.6\"\n  }\n}\n"]}
+{"version":3,"sources":["../../package.json"],"names":[],"mappings":";;;;;;AAEE,IAAA,OAAA,GAAW","file":"index.js","sourcesContent":["{\n  \"name\": \"@snack-kit/lib\",\n  \"version\": \"0.5.0\",\n  \"description\": \"Enterprise-grade utility library\",\n  \"keywords\": [],\n  \"license\": \"MIT\",\n  \"type\": \"module\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/types/index.d.ts\",\n      \"import\": \"./dist/es/index.js\",\n      \"require\": \"./dist/cjs/index.cjs\"\n    },\n    \"./http\": {\n      \"types\": \"./dist/types/http.d.ts\",\n      \"import\": \"./dist/es/http.js\",\n      \"require\": \"./dist/cjs/http.cjs\"\n    },\n    \"./debugger\": {\n      \"types\": \"./dist/types/debugger.d.ts\",\n      \"import\": \"./dist/es/debugger.js\",\n      \"require\": \"./dist/cjs/debugger.cjs\"\n    },\n    \"./utils\": {\n      \"types\": \"./dist/types/utils.d.ts\",\n      \"import\": \"./dist/es/utils.js\",\n      \"require\": \"./dist/cjs/utils.cjs\"\n    }\n  },\n  \"main\": \"./dist/cjs/index.cjs\",\n  \"module\": \"./dist/es/index.js\",\n  \"types\": \"./dist/types/index.d.ts\",\n  \"files\": [\n    \"dist\"\n  ],\n  \"scripts\": {\n    \"build\": \"tsup\",\n    \"build:watch\": \"tsup --watch\",\n    \"test\": \"vitest run\",\n    \"test:watch\": \"vitest\",\n    \"test:coverage\": \"vitest run --coverage\",\n    \"docs\": \"typedoc && cp -r docs/demo docs/api/demo\",\n    \"docs:watch\": \"typedoc --watch\",\n    \"lint\": \"tsc --noEmit\",\n    \"prepublishOnly\": \"npm run build\",\n    \"release\": \"npm run build && npm publish --access public\"\n  },\n  \"devDependencies\": {\n    \"@vitest/coverage-v8\": \"^2.0.0\",\n    \"tsup\": \"^8.0.0\",\n    \"typedoc\": \"^0.26.0\",\n    \"typescript\": \"^5.5.3\",\n    \"vitest\": \"^2.0.0\"\n  },\n  \"dependencies\": {\n    \"axios\": \"^1.13.6\"\n  }\n}\n"]}

package/dist/types/context-C4dFUDbw.d.ts

@@ -0,0 +1,237 @@
+import { AxiosRequestConfig, AxiosResponse } from 'axios';
+
+/**
+ * HTTP 请求配置，扩展自 AxiosRequestConfig
+ */
+interface HttpRequestConfig<D = unknown> extends AxiosRequestConfig<D> {
+    /** Context key，自动从 HttpContext 获取 baseURL */
+    ctx?: string;
+    /** 自定义请求 ID，用于主动取消 */
+    cancelId?: string;
+    /** 回调接收生成的 cancelId */
+    onCancelId?: (id: string) => void;
+    /**
+     * 是否添加时间戳防缓存，默认 false（添加防缓存时间戳）
+     * 设为 true 时不添加时间戳
+     */
+    cache?: boolean;
+}
+/**
+ * 快捷请求方法（Get / Post 等）的 config 入参类型。
+ *
+ * 与 `HttpRequestConfig` 相同，但不含 `method`（由快捷方法预置）。
+ * 适用于以纯配置对象方式调用时，避免重复指定已知的 method。
+ *
+ * @example
+ * ```ts
+ * const config: HttpMethodConfig = { url: '/api/user', ctx: 'user-svc' }
+ * const { data } = await Get(config)
+ * ```
+ */
+type HttpMethodConfig<D = unknown> = Omit<HttpRequestConfig<D>, 'method'>;
+/**
+ * HTTP 请求结果，扩展自 AxiosResponse
+ */
+interface HttpResult<T = unknown> extends Partial<AxiosResponse<T>> {
+    /** 有 error 则请求失败，无 error 则成功 */
+    error?: HttpError;
+}
+/**
+ * HTTP 错误信息
+ */
+interface HttpError {
+    /** HTTP 状态码 */
+    status?: number;
+    /** 错误描述 */
+    message: string;
+    /** 服务端返回的原始错误体 */
+    data?: unknown;
+}
+/**
+ * 网关 `/ngw/context` 接口返回的元数据（`$info` 字段）
+ */
+interface ContextInfo {
+    /** 网关版本号，例如 `"4.6.2-r10"` */
+    version: string;
+    /** 网关域名，例如 `"http://172.16.32.155:20000"` */
+    domain: string;
+    /** 客户端标识 */
+    client: string;
+    /** 当前语言 */
+    lang: string;
+}
+/**
+ * 网关 `/web-debug/host/list` 接口返回的服务列表项
+ */
+interface ServerItem {
+    /** 服务唯一标识 */
+    key: string;
+    /** 服务名称 */
+    name: string;
+    /** 服务类型分组，可为空字符串 */
+    type: string;
+    /** 服务地址，用于 `context.load()` 切换路由映射 */
+    origin: string;
+    /** 代理配置（由网关管理，前端只读） */
+    proxyInfo: Record<string, unknown>;
+}
+
+/**
+ * globalThis 上的标志位 key，由 `Debugger.init()` 写入。
+ * `Context.load()` 无参数调用时，若检测到此标志则跳过自动加载，
+ * 由 Debugger 负责在用户选择服务后调用 `Context.load(origin)`。
+ */
+declare const DEBUGGER_ACTIVE_KEY = "__snackkit_debugger__active";
+/**
+ * 管理服务地址映射的上下文单例
+ *
+ * 支持三种加载方式：
+ * - **不传参数**：生产环境自动以当前页面 Origin 为网关，开发环境由 `Debugger` 接管
+ * - **远程加载**：传入网关 URL，自动请求 `GET /ngw/context` 获取映射表
+ * - **本地注入**：直接传入键值对象，不发起网络请求
+ *
+ * @example 生产环境不传参（推荐）
+ * ```ts
+ * import { Context } from '@snack-kit/lib/http'
+ *
+ * await Context.load()
+ * Context.get('ngw') // 'https://app.example.com/ngw'
+ * ```
+ *
+ * @example 远程加载（指定网关）
+ * ```ts
+ * await Context.load('http://172.16.32.155:20000')
+ * Context.get('ngw')   // 'http://172.16.32.155:20000/ngw'
+ * Context.info         // { version: '4.6.2-r10', domain: '...', ... }
+ * ```
+ *
+ * @example 本地注入
+ * ```ts
+ * await Context.load({
+ *   'user-svc': 'http://user.api.com',
+ *   'order-svc': 'http://order.api.com',
+ * })
+ * ```
+ */
+declare class HttpContext {
+    private _store;
+    private _loaded;
+    private _info;
+    /**
+     * 加载服务地址映射
+     *
+     * 支持三种调用方式：
+     * - **传入字符串**：作为网关地址，自动请求 `GET /ngw/context` 获取映射表
+     * - **传入对象**：直接注入键值映射，不发起网络请求
+     * - **不传参数**：
+     *   - 生产环境（`NODE_ENV === 'production'`）：以当前页面 `Origin` 为网关地址自动加载
+     *   - 开发环境：立即返回，不做任何操作（应由 `Debugger.init()` 接管加载流程）
+     *
+     * 远程加载时，响应中的 `$info` 元数据字段会被单独存储，不计入路由映射表。
+     *
+     * @param source 网关 URL / 键值对象 / 省略
+     * @param timeout 远程加载超时（ms），默认 5000
+     *
+     * @example 不传参——生产环境自动使用当前页面 Origin
+     * ```ts
+     * await Context.load()
+     * ```
+     *
+     * @example 传入网关地址
+     * ```ts
+     * await Context.load('http://172.16.32.155:20000', 3000)
+     * ```
+     *
+     * @example 本地注入
+     * ```ts
+     * await Context.load({ 'user-svc': 'http://user.api.com' })
+     * ```
+     */
+    load(source?: string | Record<string, string>, timeout?: number): Promise<void>;
+    /**
+     * 获取指定 ctx key 对应的服务地址
+     * @param key ctx key，例如 `'ngw'`、`'osc'`
+     * @returns 服务地址，未找到时返回空字符串
+     *
+     * @example
+     * ```ts
+     * await Context.load('http://172.16.32.155:20000')
+     * Context.get('osc')  // 'http://172.16.32.155:20000/osc'
+     * Context.get('none') // ''
+     * ```
+     */
+    get(key: string): string;
+    /**
+     * 网关元数据（仅远程加载后可用）
+     *
+     * @example
+     * ```ts
+     * await Context.load('http://172.16.32.155:20000')
+     * Context.info?.version // '4.6.2-r10'
+     * Context.info?.domain  // 'http://172.16.32.155:20000'
+     * ```
+     */
+    get info(): ContextInfo | undefined;
+    /**
+     * Context 是否已加载
+     *
+     * @example
+     * ```ts
+     * Context.loaded // false
+     * await Context.load({ 'user-svc': 'http://user.api.com' })
+     * Context.loaded // true
+     * ```
+     */
+    get loaded(): boolean;
+    /**
+     * 清空所有映射并重置加载状态
+     *
+     * @example
+     * ```ts
+     * Context.clear()
+     * Context.loaded // false
+     * ```
+     */
+    clear(): void;
+}
+/**
+ * HttpContext 全局单例
+ *
+ * @example
+ * ```ts
+ * import { Context } from '@snack-kit/lib/http'
+ *
+ * await Context.load('http://172.16.32.155:20000')
+ * Context.get('osc') // 'http://172.16.32.155:20000/osc'
+ * ```
+ */
+declare const Context: HttpContext;
+/**
+ * 当前页面的 origin（`protocol + host`）
+ *
+ * 在非浏览器环境（如 SSR/Node）返回空字符串。
+ *
+ * @example
+ * ```ts
+ * import { Origin } from '@snack-kit/lib/http'
+ * // 浏览器中：'https://app.example.com'
+ * // Node 环境：''
+ * ```
+ */
+declare const Origin: string;
+/**
+ * 当前页面路径的首段，可直接用作 `ctx` 参数
+ *
+ * 例如 `/osc/employee` → `'osc'`，在非浏览器环境返回空字符串。
+ *
+ * @example
+ * ```ts
+ * import { Ctx, Get } from '@snack-kit/lib/http'
+ *
+ * // 当前路径为 /osc/... 时，Ctx === 'osc'
+ * const result = await Get('/employee', { ctx: Ctx })
+ * ```
+ */
+declare const Ctx: string;
+
+export { Context as C, DEBUGGER_ACTIVE_KEY as D, HttpContext as H, Origin as O, type ServerItem as S, type ContextInfo as a, Ctx as b, type HttpError as c, type HttpMethodConfig as d, type HttpRequestConfig as e, type HttpResult as f };

package/dist/types/debugger.d.ts

@@ -1,3 +1,6 @@
+export { D as DEBUGGER_ACTIVE_KEY } from './context-C4dFUDbw.js';
+import 'axios';
+
 /**
  * Debugger 初始化选项
  */