uapi-browser-sdk 0.1.12 → 0.1.13

package/internal/src/apis/WebParseApi.ts

@@ -68,9 +68,10 @@ export interface PostWebTomarkdownAsyncRequest {
 export class WebParseApi extends runtime.BaseAPI {
 
     /**
-     * Creates request options for getWebTomarkdownAsyncStatus without sending the request
+     * 提交了网页转 Markdown 任务后，想知道处理进度和结果？用这个接口来查询。  ## 功能概述 通过任务 ID 查询转换任务的当前状态、处理进度和最终结果。任务结果缓存 30 分钟，期间可重复查询。  ## 任务状态  | 状态 | 说明 | |------|------| | `pending` | 等待处理 | | `processing` | 处理中 | | `completed` | 已完成，可获取结果 | | `failed` | 失败 | | `timeout` | 超时（超过 60 秒） |  > [!NOTE] > 建议每 2-5 秒轮询一次，当状态为 `completed`、`failed` 或 `timeout` 时停止轮询。
+     * 转换任务状态
      */
-    async getWebTomarkdownAsyncStatusRequestOpts(requestParameters: GetWebTomarkdownAsyncStatusRequest): Promise<runtime.RequestOpts> {
+    async getWebTomarkdownAsyncStatusRaw(requestParameters: GetWebTomarkdownAsyncStatusRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetWebTomarkdownAsyncStatus200Response>> {
         if (requestParameters['taskId'] == null) {
             throw new runtime.RequiredError(
                 'taskId',
@@ -86,21 +87,12 @@ export class WebParseApi extends runtime.BaseAPI {
         let urlPath = `/web/tomarkdown/async/{task_id}`;
         urlPath = urlPath.replace(`{${"task_id"}}`, encodeURIComponent(String(requestParameters['taskId'])));
 
-        return {
+        const response = await this.request({
             path: urlPath,
             method: 'GET',
             headers: headerParameters,
             query: queryParameters,
-        };
-    }
-
-    /**
-     * 提交了网页转 Markdown 任务后，想知道处理进度和结果？用这个接口来查询。  ## 功能概述 通过任务 ID 查询转换任务的当前状态、处理进度和最终结果。任务结果缓存 30 分钟，期间可重复查询。  ## 任务状态  | 状态 | 说明 | |------|------| | `pending` | 等待处理 | | `processing` | 处理中 | | `completed` | 已完成，可获取结果 | | `failed` | 失败 | | `timeout` | 超时（超过 60 秒） |  > [!NOTE] > 建议每 2-5 秒轮询一次，当状态为 `completed`、`failed` 或 `timeout` 时停止轮询。
-     * 转换任务状态
-     */
-    async getWebTomarkdownAsyncStatusRaw(requestParameters: GetWebTomarkdownAsyncStatusRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetWebTomarkdownAsyncStatus200Response>> {
-        const requestOptions = await this.getWebTomarkdownAsyncStatusRequestOpts(requestParameters);
-        const response = await this.request(requestOptions, initOverrides);
+        }, initOverrides);
 
         return new runtime.JSONApiResponse(response, (jsonValue) => GetWebTomarkdownAsyncStatus200ResponseFromJSON(jsonValue));
     }
@@ -115,9 +107,10 @@ export class WebParseApi extends runtime.BaseAPI {
     }
 
     /**
-     * Creates request options for getWebparseExtractimages without sending the request
+     * 想批量获取一个网页上的所有图片链接？这个接口帮你搞定。  ## 功能概述 提供一个网页 URL，返回该页面中所有图片的链接列表。适合用于图片采集、素材下载等场景。
+     * 提取网页图片
      */
-    async getWebparseExtractimagesRequestOpts(requestParameters: GetWebparseExtractimagesRequest): Promise<runtime.RequestOpts> {
+    async getWebparseExtractimagesRaw(requestParameters: GetWebparseExtractimagesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetWebparseExtractimages200Response>> {
         if (requestParameters['url'] == null) {
             throw new runtime.RequiredError(
                 'url',
@@ -136,21 +129,12 @@ export class WebParseApi extends runtime.BaseAPI {
 
         let urlPath = `/webparse/extractimages`;
 
-        return {
+        const response = await this.request({
             path: urlPath,
             method: 'GET',
             headers: headerParameters,
             query: queryParameters,
-        };
-    }
-
-    /**
-     * 想批量获取一个网页上的所有图片链接？这个接口帮你搞定。  ## 功能概述 提供一个网页 URL，返回该页面中所有图片的链接列表。适合用于图片采集、素材下载等场景。
-     * 提取网页图片
-     */
-    async getWebparseExtractimagesRaw(requestParameters: GetWebparseExtractimagesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetWebparseExtractimages200Response>> {
-        const requestOptions = await this.getWebparseExtractimagesRequestOpts(requestParameters);
-        const response = await this.request(requestOptions, initOverrides);
+        }, initOverrides);
 
         return new runtime.JSONApiResponse(response, (jsonValue) => GetWebparseExtractimages200ResponseFromJSON(jsonValue));
     }
@@ -165,9 +149,10 @@ export class WebParseApi extends runtime.BaseAPI {
     }
 
     /**
-     * Creates request options for getWebparseMetadata without sending the request
+     * 想在应用里做链接预览卡片？这个接口帮你一键获取网页的标题、描述、图标等信息。  ## 功能概述 提供一个网页 URL，返回该页面的元数据，包括标题、描述、关键词、Favicon、Open Graph 信息等。非常适合用于生成链接预览卡片或做 SEO 分析。
+     * 提取网页元数据
      */
-    async getWebparseMetadataRequestOpts(requestParameters: GetWebparseMetadataRequest): Promise<runtime.RequestOpts> {
+    async getWebparseMetadataRaw(requestParameters: GetWebparseMetadataRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetWebparseMetadata200Response>> {
         if (requestParameters['url'] == null) {
             throw new runtime.RequiredError(
                 'url',
@@ -186,21 +171,12 @@ export class WebParseApi extends runtime.BaseAPI {
 
         let urlPath = `/webparse/metadata`;
 
-        return {
+        const response = await this.request({
             path: urlPath,
             method: 'GET',
             headers: headerParameters,
             query: queryParameters,
-        };
-    }
-
-    /**
-     * 想在应用里做链接预览卡片？这个接口帮你一键获取网页的标题、描述、图标等信息。  ## 功能概述 提供一个网页 URL，返回该页面的元数据，包括标题、描述、关键词、Favicon、Open Graph 信息等。非常适合用于生成链接预览卡片或做 SEO 分析。
-     * 提取网页元数据
-     */
-    async getWebparseMetadataRaw(requestParameters: GetWebparseMetadataRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetWebparseMetadata200Response>> {
-        const requestOptions = await this.getWebparseMetadataRequestOpts(requestParameters);
-        const response = await this.request(requestOptions, initOverrides);
+        }, initOverrides);
 
         return new runtime.JSONApiResponse(response, (jsonValue) => GetWebparseMetadata200ResponseFromJSON(jsonValue));
     }
@@ -215,9 +191,10 @@ export class WebParseApi extends runtime.BaseAPI {
     }
 
     /**
-     * Creates request options for postWebTomarkdownAsync without sending the request
+     * 想把一个网页的内容转成干净的 Markdown 文本？这个异步接口可以帮你搞定，特别适合处理大型或复杂的网页。  ## 功能概述  提交一个网页 URL，我们会自动抓取主体内容，剔除广告、导航栏等干扰元素，并转换为 Markdown 格式。同时会提取标题、作者、发布日期等元数据，生成 YAML Front Matter。  任务提交后会立即返回任务 ID，你可以用它来查询处理进度和结果。单个任务最长处理 60 秒，结果缓存 30 分钟。
+     * 网页转 Markdown
      */
-    async postWebTomarkdownAsyncRequestOpts(requestParameters: PostWebTomarkdownAsyncRequest): Promise<runtime.RequestOpts> {
+    async postWebTomarkdownAsyncRaw(requestParameters: PostWebTomarkdownAsyncRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PostWebTomarkdownAsync202Response>> {
         if (requestParameters['url'] == null) {
             throw new runtime.RequiredError(
                 'url',
@@ -236,21 +213,12 @@ export class WebParseApi extends runtime.BaseAPI {
 
         let urlPath = `/web/tomarkdown/async`;
 
-        return {
+        const response = await this.request({
             path: urlPath,
             method: 'POST',
             headers: headerParameters,
             query: queryParameters,
-        };
-    }
-
-    /**
-     * 想把一个网页的内容转成干净的 Markdown 文本？这个异步接口可以帮你搞定，特别适合处理大型或复杂的网页。  ## 功能概述  提交一个网页 URL，我们会自动抓取主体内容，剔除广告、导航栏等干扰元素，并转换为 Markdown 格式。同时会提取标题、作者、发布日期等元数据，生成 YAML Front Matter。  任务提交后会立即返回任务 ID，你可以用它来查询处理进度和结果。单个任务最长处理 60 秒，结果缓存 30 分钟。
-     * 网页转 Markdown
-     */
-    async postWebTomarkdownAsyncRaw(requestParameters: PostWebTomarkdownAsyncRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PostWebTomarkdownAsync202Response>> {
-        const requestOptions = await this.postWebTomarkdownAsyncRequestOpts(requestParameters);
-        const response = await this.request(requestOptions, initOverrides);
+        }, initOverrides);
 
         return new runtime.JSONApiResponse(response, (jsonValue) => PostWebTomarkdownAsync202ResponseFromJSON(jsonValue));
     }

package/internal/src/models/GetMiscHolidayCalendar200ResponseHolidaysInner.ts

@@ -33,7 +33,7 @@ export interface GetMiscHolidayCalendar200ResponseHolidaysInner {
     name?: string;
     /**
      * 事件类型。
-     * @type {GetMiscHolidayCalendar200ResponseHolidaysInnerTypeEnum}
+     * @type {string}
      * @memberof GetMiscHolidayCalendar200ResponseHolidaysInner
      */
     type?: GetMiscHolidayCalendar200ResponseHolidaysInnerTypeEnum;

package/internal/src/models/GetMiscWeather200Response.ts

@@ -87,7 +87,7 @@ export interface GetMiscWeather200Response {
     weather?: string;
     /**
      * 天气图标代码。请从[天气图标代码表](#enum-list)中查看所有可能的值。
-     * @type {GetMiscWeather200ResponseWeatherIconEnum}
+     * @type {string}
      * @memberof GetMiscWeather200Response
      */
     weatherIcon?: GetMiscWeather200ResponseWeatherIconEnum;

package/internal/src/models/PostAiTranslateRequest.ts

@@ -33,13 +33,13 @@ export interface PostAiTranslateRequest {
     sourceLang?: string;
     /**
      * 翻译风格，可选。支持casual(随意口语化)、professional(专业商务，默认)、academic(学术正式)、literary(文学艺术)。
-     * @type {PostAiTranslateRequestStyleEnum}
+     * @type {string}
      * @memberof PostAiTranslateRequest
      */
     style?: PostAiTranslateRequestStyleEnum;
     /**
      * 翻译上下文场景，可选。支持general(通用，默认)、business(商务)、technical(技术)、medical(医疗)、legal(法律)、marketing(市场营销)、entertainment(娱乐)、education(教育)、news(新闻)。
-     * @type {PostAiTranslateRequestContextEnum}
+     * @type {string}
      * @memberof PostAiTranslateRequest
      */
     context?: PostAiTranslateRequestContextEnum;

package/internal/src/models/PostSearchAggregateRequest.ts

@@ -51,13 +51,13 @@ export interface PostSearchAggregateRequest {
     timeoutMs?: number;
     /**
      * 排序方式
-     * @type {PostSearchAggregateRequestSortEnum}
+     * @type {string}
      * @memberof PostSearchAggregateRequest
      */
     sort?: PostSearchAggregateRequestSortEnum;
     /**
      * 时间范围过滤
-     * @type {PostSearchAggregateRequestTimeRangeEnum}
+     * @type {string}
      * @memberof PostSearchAggregateRequest
      */
     timeRange?: PostSearchAggregateRequestTimeRangeEnum;

package/internal/src/models/PostSensitiveWordAnalyze200ResponseResultsInner.ts

@@ -27,13 +27,13 @@ export interface PostSensitiveWordAnalyze200ResponseResultsInner {
     k?: string;
     /**
      * 
-     * @type {PostSensitiveWordAnalyze200ResponseResultsInnerLabelEnum}
+     * @type {string}
      * @memberof PostSensitiveWordAnalyze200ResponseResultsInner
      */
     label?: PostSensitiveWordAnalyze200ResponseResultsInnerLabelEnum;
     /**
      * 
-     * @type {PostSensitiveWordAnalyze200ResponseResultsInnerCategoryEnum}
+     * @type {string}
      * @memberof PostSensitiveWordAnalyze200ResponseResultsInner
      */
     category?: PostSensitiveWordAnalyze200ResponseResultsInnerCategoryEnum;

package/internal/src/models/PostTextAesDecryptAdvancedRequest.ts

@@ -33,13 +33,13 @@ export interface PostTextAesDecryptAdvancedRequest {
     key: string;
     /**
      * 加密模式（必须与加密时相同）：GCM/CBC/ECB/CTR/OFB/CFB
-     * @type {PostTextAesDecryptAdvancedRequestModeEnum}
+     * @type {string}
      * @memberof PostTextAesDecryptAdvancedRequest
      */
     mode: PostTextAesDecryptAdvancedRequestModeEnum;
     /**
      * 填充方式（可选，必须与加密时相同）：PKCS7/ZERO/NONE。GCM模式默认为NONE
-     * @type {PostTextAesDecryptAdvancedRequestPaddingEnum}
+     * @type {string}
      * @memberof PostTextAesDecryptAdvancedRequest
      */
     padding?: PostTextAesDecryptAdvancedRequestPaddingEnum;

package/internal/src/models/PostTextAesEncryptAdvancedRequest.ts

@@ -33,13 +33,13 @@ export interface PostTextAesEncryptAdvancedRequest {
     key: string;
     /**
      * 加密模式：GCM/CBC/ECB/CTR/OFB/CFB（可选，默认GCM）
-     * @type {PostTextAesEncryptAdvancedRequestModeEnum}
+     * @type {string}
      * @memberof PostTextAesEncryptAdvancedRequest
      */
     mode?: PostTextAesEncryptAdvancedRequestModeEnum;
     /**
      * 填充方式：PKCS7/ZERO/NONE（可选，默认PKCS7）
-     * @type {PostTextAesEncryptAdvancedRequestPaddingEnum}
+     * @type {string}
      * @memberof PostTextAesEncryptAdvancedRequest
      */
     padding?: PostTextAesEncryptAdvancedRequestPaddingEnum;
@@ -51,7 +51,7 @@ export interface PostTextAesEncryptAdvancedRequest {
     iv?: string;
     /**
      * 输出格式：base64（默认）或hex
-     * @type {PostTextAesEncryptAdvancedRequestOutputFormatEnum}
+     * @type {string}
      * @memberof PostTextAesEncryptAdvancedRequest
      */
     outputFormat?: PostTextAesEncryptAdvancedRequestOutputFormatEnum;

package/internal/src/models/PostTextConvertRequest.ts

@@ -27,13 +27,13 @@ export interface PostTextConvertRequest {
     text: string;
     /**
      * 源格式类型
-     * @type {PostTextConvertRequestFromEnum}
+     * @type {string}
      * @memberof PostTextConvertRequest
      */
     from: PostTextConvertRequestFromEnum;
     /**
      * 目标格式类型
-     * @type {PostTextConvertRequestToEnum}
+     * @type {string}
      * @memberof PostTextConvertRequest
      */
     to: PostTextConvertRequestToEnum;

package/internal/src/models/PostTranslateStream400Response.ts

@@ -27,7 +27,7 @@ export interface PostTranslateStream400Response {
     error?: string;
     /**
      * 错误码
-     * @type {PostTranslateStream400ResponseCodeEnum}
+     * @type {string}
      * @memberof PostTranslateStream400Response
      */
     code?: PostTranslateStream400ResponseCodeEnum;

package/internal/src/runtime.ts

@@ -261,12 +261,6 @@ export class ResponseError extends Error {
     override name: "ResponseError" = "ResponseError";
     constructor(public response: Response, msg?: string) {
         super(msg);
-
-        // restore prototype chain
-        const actualProto = new.target.prototype;
-        if (Object.setPrototypeOf) {
-            Object.setPrototypeOf(this, actualProto);
-        }
     }
 }
 
@@ -274,12 +268,6 @@ export class FetchError extends Error {
     override name: "FetchError" = "FetchError";
     constructor(public cause: Error, msg?: string) {
         super(msg);
-
-        // restore prototype chain
-        const actualProto = new.target.prototype;
-        if (Object.setPrototypeOf) {
-            Object.setPrototypeOf(this, actualProto);
-        }
     }
 }
 
@@ -287,12 +275,6 @@ export class RequiredError extends Error {
     override name: "RequiredError" = "RequiredError";
     constructor(public field: string, msg?: string) {
         super(msg);
-
-        // restore prototype chain
-        const actualProto = new.target.prototype;
-        if (Object.setPrototypeOf) {
-            Object.setPrototypeOf(this, actualProto);
-        }
     }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uapi-browser-sdk",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "type": "module",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",

package/src/errors.ts

@@ -0,0 +1,282 @@
+export interface RateLimitPolicyEntry {
+  name: string
+  quota?: number
+  unit?: string
+  windowSeconds?: number
+}
+
+export interface RateLimitStateEntry {
+  name: string
+  remaining?: number
+  unit?: string
+  resetAfterSeconds?: number
+}
+
+export interface ResponseMeta {
+  requestId?: string
+  retryAfterSeconds?: number
+  debitStatus?: string
+  creditsRequested?: number
+  creditsCharged?: number
+  creditsPricing?: string
+  activeQuotaBuckets?: number
+  stopOnEmpty?: boolean
+  rateLimitPolicyRaw?: string
+  rateLimitRaw?: string
+  rateLimitPolicies: Record<string, RateLimitPolicyEntry>
+  rateLimits: Record<string, RateLimitStateEntry>
+  balanceLimitCents?: number
+  balanceRemainingCents?: number
+  quotaLimitCredits?: number
+  quotaRemainingCredits?: number
+  visitorQuotaLimitCredits?: number
+  visitorQuotaRemainingCredits?: number
+  rawHeaders: Record<string, string>
+}
+
+export class UapiError extends Error {
+  code: string
+  status: number
+  details?: unknown
+  payload?: unknown
+  meta?: ResponseMeta
+
+  constructor(code: string, status: number, message: string, details?: unknown, payload?: unknown, meta?: ResponseMeta) {
+    super(`[${status}] ${code}: ${message}`)
+    this.code = code
+    this.status = status
+    this.details = details
+    this.payload = payload
+    this.meta = meta
+  }
+}
+export class ApiErrorError extends UapiError {}
+export class AvatarNotFoundError extends UapiError {}
+export class ConversionFailedError extends UapiError {}
+export class FileOpenErrorError extends UapiError {}
+export class FileRequiredError extends UapiError {}
+export class InsufficientCreditsError extends UapiError {}
+export class InternalServerErrorError extends UapiError {}
+export class InvalidParameterError extends UapiError {}
+export class InvalidParamsError extends UapiError {}
+export class NotFoundError extends UapiError {}
+export class NoMatchError extends UapiError {}
+export class NoTrackingDataError extends UapiError {}
+export class PhoneInfoFailedError extends UapiError {}
+export class RecognitionFailedError extends UapiError {}
+export class RequestEntityTooLargeError extends UapiError {}
+export class ServiceBusyError extends UapiError {}
+export class TimezoneNotFoundError extends UapiError {}
+export class UnauthorizedError extends UapiError {}
+export class UnsupportedCarrierError extends UapiError {}
+export class UnsupportedFormatError extends UapiError {}
+export class VisitorMonthlyQuotaExhaustedError extends UapiError {}
+
+
+function defaultCode(status: number): string {
+  switch (status) {
+    case 400:
+      return 'INVALID_PARAMETER'
+    case 401:
+      return 'UNAUTHORIZED'
+    case 402:
+      return 'INSUFFICIENT_CREDITS'
+    case 404:
+      return 'NOT_FOUND'
+    case 413:
+      return 'REQUEST_ENTITY_TOO_LARGE'
+    case 429:
+      return 'SERVICE_BUSY'
+    case 500:
+      return 'INTERNAL_SERVER_ERROR'
+    default:
+      return 'API_ERROR'
+  }
+}
+
+function toHeaderMap(headers: Headers | Record<string, unknown> | undefined): Record<string, string> {
+  const out: Record<string, string> = {}
+  if (!headers) {
+    return out
+  }
+  if (typeof (headers as Headers).forEach === 'function') {
+    ;(headers as Headers).forEach((value, key) => {
+      out[String(key).toLowerCase()] = String(value)
+    })
+    return out
+  }
+  for (const [rawKey, rawValue] of Object.entries(headers)) {
+    if (rawValue === undefined || rawValue === null) {
+      continue
+    }
+    out[String(rawKey).toLowerCase()] = String(rawValue)
+  }
+  return out
+}
+
+function parseNumber(value?: string): number | undefined {
+  if (value === undefined) {
+    return undefined
+  }
+  const parsed = Number(value)
+  return Number.isFinite(parsed) ? parsed : undefined
+}
+
+function parseBoolean(value?: string): boolean | undefined {
+  if (value === undefined) {
+    return undefined
+  }
+  const normalized = value.trim().toLowerCase()
+  if (normalized === 'true') {
+    return true
+  }
+  if (normalized === 'false') {
+    return false
+  }
+  return undefined
+}
+
+function unquote(value: string): string {
+  const trimmed = value.trim()
+  if (trimmed.length >= 2 && trimmed.startsWith('"') && trimmed.endsWith('"')) {
+    return trimmed.slice(1, -1)
+  }
+  return trimmed
+}
+
+function parseStructuredItems(raw?: string): Array<{ name: string; params: Record<string, string> }> {
+  if (!raw) {
+    return []
+  }
+  return raw
+    .split(',')
+    .map((item) => item.trim())
+    .filter(Boolean)
+    .map((item) => {
+      const segments = item.split(';').map((segment) => segment.trim()).filter(Boolean)
+      const [head, ...rest] = segments
+      const params: Record<string, string> = {}
+      for (const segment of rest) {
+        const eq = segment.indexOf('=')
+        if (eq <= 0) {
+          continue
+        }
+        const key = segment.slice(0, eq).trim()
+        const value = unquote(segment.slice(eq + 1))
+        params[key] = value
+      }
+      return { name: unquote(head), params }
+    })
+}
+
+export function extractMetaFromHeaders(headers: Headers | Record<string, unknown> | undefined): ResponseMeta {
+  const rawHeaders = toHeaderMap(headers)
+  const rateLimitPolicies: Record<string, RateLimitPolicyEntry> = {}
+  const rateLimits: Record<string, RateLimitStateEntry> = {}
+
+  for (const item of parseStructuredItems(rawHeaders['ratelimit-policy'])) {
+    rateLimitPolicies[item.name] = {
+      name: item.name,
+      quota: parseNumber(item.params.q),
+      unit: item.params['uapi-unit'],
+      windowSeconds: parseNumber(item.params.w),
+    }
+  }
+
+  for (const item of parseStructuredItems(rawHeaders['ratelimit'])) {
+    rateLimits[item.name] = {
+      name: item.name,
+      remaining: parseNumber(item.params.r),
+      unit: item.params['uapi-unit'],
+      resetAfterSeconds: parseNumber(item.params.t),
+    }
+  }
+
+  return {
+    requestId: rawHeaders['x-request-id'],
+    retryAfterSeconds: parseNumber(rawHeaders['retry-after']),
+    debitStatus: rawHeaders['uapi-debit-status'],
+    creditsRequested: parseNumber(rawHeaders['uapi-credits-requested']),
+    creditsCharged: parseNumber(rawHeaders['uapi-credits-charged']),
+    creditsPricing: rawHeaders['uapi-credits-pricing'],
+    activeQuotaBuckets: parseNumber(rawHeaders['uapi-quota-active-buckets']),
+    stopOnEmpty: parseBoolean(rawHeaders['uapi-stop-on-empty']),
+    rateLimitPolicyRaw: rawHeaders['ratelimit-policy'],
+    rateLimitRaw: rawHeaders['ratelimit'],
+    rateLimitPolicies,
+    rateLimits,
+    balanceLimitCents: rateLimitPolicies['billing-balance']?.quota,
+    balanceRemainingCents: rateLimits['billing-balance']?.remaining,
+    quotaLimitCredits: rateLimitPolicies['billing-quota']?.quota,
+    quotaRemainingCredits: rateLimits['billing-quota']?.remaining,
+    visitorQuotaLimitCredits: rateLimitPolicies['visitor-quota']?.quota,
+    visitorQuotaRemainingCredits: rateLimits['visitor-quota']?.remaining,
+    rawHeaders,
+  }
+}
+
+function pickDetails(body: unknown): unknown {
+  if (!body || typeof body !== 'object') {
+    return undefined
+  }
+  const payload = body as Record<string, unknown>
+  if (payload.details !== undefined) {
+    return payload.details
+  }
+  if (payload.quota !== undefined) {
+    return payload.quota
+  }
+  if (payload.docs !== undefined) {
+    return payload.docs
+  }
+  return undefined
+}
+
+export function mapError(res: Response, body: unknown): UapiError {
+  const payload = body && typeof body === 'object' ? (body as Record<string, unknown>) : undefined
+  const code = String(payload?.code || payload?.error || defaultCode(res.status)).toUpperCase()
+  const message =
+    (payload?.message as string | undefined) ||
+    (payload?.errMsg as string | undefined) ||
+    (typeof body === 'string' ? body : '') ||
+    res.statusText ||
+    'Request failed'
+  const meta = extractMetaFromHeaders(res.headers)
+  const table: Record<string, new (...args: any[]) => UapiError> = {
+    "API_ERROR": ApiErrorError,
+    "AVATAR_NOT_FOUND": AvatarNotFoundError,
+    "CONVERSION_FAILED": ConversionFailedError,
+    "FILE_OPEN_ERROR": FileOpenErrorError,
+    "FILE_REQUIRED": FileRequiredError,
+    "INSUFFICIENT_CREDITS": InsufficientCreditsError,
+    "INTERNAL_SERVER_ERROR": InternalServerErrorError,
+    "INVALID_PARAMETER": InvalidParameterError,
+    "INVALID_PARAMS": InvalidParamsError,
+    "NOT_FOUND": NotFoundError,
+    "NO_MATCH": NoMatchError,
+    "NO_TRACKING_DATA": NoTrackingDataError,
+    "PHONE_INFO_FAILED": PhoneInfoFailedError,
+    "RECOGNITION_FAILED": RecognitionFailedError,
+    "REQUEST_ENTITY_TOO_LARGE": RequestEntityTooLargeError,
+    "SERVICE_BUSY": ServiceBusyError,
+    "TIMEZONE_NOT_FOUND": TimezoneNotFoundError,
+    "UNAUTHORIZED": UnauthorizedError,
+    "UNSUPPORTED_CARRIER": UnsupportedCarrierError,
+    "UNSUPPORTED_FORMAT": UnsupportedFormatError,
+    "VISITOR_MONTHLY_QUOTA_EXHAUSTED": VisitorMonthlyQuotaExhaustedError,
+  }
+  const fallback =
+    res.status === 401
+      ? UnauthorizedError
+      : res.status === 402
+        ? InsufficientCreditsError
+        : res.status === 404
+          ? NotFoundError
+          : res.status === 429
+            ? ServiceBusyError
+            : res.status >= 500
+              ? InternalServerErrorError
+              : UapiError
+  const Ctor = table[code] || fallback
+  return new Ctor(code, res.status, message, pickDetails(payload), payload ?? body, meta)
+}

package/src/index.ts

@@ -1,10 +1,7 @@
 import type * as Internal from '../internal/src/index.js'
-
-export class UapiError extends Error {
-  constructor(public code: string, public status: number, public details?: unknown) {
-    super(`${status} ${code}`)
-  }
-}
+import { UapiError, type ResponseMeta, extractMetaFromHeaders, mapError } from './errors.js'
+export { UapiError, mapError, extractMetaFromHeaders } from './errors.js'
+export type { RateLimitPolicyEntry, RateLimitStateEntry, ResponseMeta } from './errors.js'
 export type GetClipzyGetResponse =
   Internal.GetClipzyGet200Response
 export interface GetClipzyGetArgs {
@@ -798,6 +795,7 @@ export interface PostSearchAggregateArgs {
 export class UapiClient {
   private baseURL: string
   private token?: string
+  private _lastResponseMeta?: ResponseMeta
   readonly clipzyZaiXianJianTieBan: ClipzyZaiXianJianTieBanApi
   readonly "Clipzy 在线剪贴板": ClipzyZaiXianJianTieBanApi
   readonly convert: ConvertApi
@@ -884,6 +882,10 @@ export class UapiClient {
     this["智能搜索"] = zhiNengSouSuo
   }
 
+  get lastResponseMeta(): ResponseMeta | undefined {
+    return this._lastResponseMeta
+  }
+
   async _request(
     method: string,
     path: string,
@@ -914,9 +916,11 @@ export class UapiClient {
       try {
         data = await res.json()
       } catch {}
-      const code = typeof data === 'object' && data && 'code' in data ? String((data as { code?: unknown }).code ?? 'API_ERROR').toUpperCase() : 'API_ERROR'
-      throw new UapiError(code, res.status, data)
+      const mapped = mapError(res, data)
+      this._lastResponseMeta = mapped.meta
+      throw mapped
     }
+    this._lastResponseMeta = extractMetaFromHeaders(res.headers)
     if (responseKind === 'arrayBuffer') {
       return res.arrayBuffer()
     }