@lovrabet/sdk 1.4.3 → 1.5.1-beta.0

package/README.md

@@ -551,11 +551,31 @@ interface ClientConfig {
   secretKey?: string; // 密钥（可选）
   token?: string; // 预生成 token（浏览器）
   timestamp?: number; // token 时间戳
-  env?: "online" | "daily"; // 环境
+  env?: "production" | "online" | "daily" | "development"; // 环境
+  region?: "cn" | "id"; // 官方节点，默认 cn
+  runtimeDomain?: string; // 企业独立部署覆盖，优先于 region
   models?: ModelsConfig; // 模型配置
 }
 ```
 
+官方印尼节点：
+
+```typescript
+const client = createClient({
+  appCode: "app-xxx",
+  region: "id",
+  env: "production"
+});
+```
+
+企业独立部署直接传入 `runtimeDomain`。解析优先级为：`runtimeDomain` →
+兼容字段 `serverUrl` → 页面注入的 `RUNTIME_API_DOMAIN` → `region + env`
+→ 默认 CN Production。
+
+SDK 会对显式 Runtime 地址去除首尾空白和尾斜杠，并拒绝非法 URL、凭证、
+query 或 fragment。未传 `region` 时默认 `cn`；显式传入 `cn` / `id` 以外的值
+会抛出 `INVALID_REGION`，不会静默请求其他区域。
+
 ### CRUD 操作
 
 ```typescript

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { createClient } from "./src/client/index";
 export { registerModels, getRegisteredModels, getRegisteredConfigNames, unregisterModels, clearAllRegistrations, } from "./src/config/model-registry";
-export { getApiEndpoint, getAvailableEnvironments, } from "./src/config/endpoints";
-export { CONFIG_NAMES, ENVIRONMENTS, DEFAULTS, HTTP_STATUS, ERROR_MESSAGES, API_PATHS, } from "./src/config/constants";
+export { getApiEndpoint, getAvailableEnvironments, getAvailableRegions, } from "./src/config/endpoints";
+export { CONFIG_NAMES, ENVIRONMENTS, REGIONS, DEFAULTS, HTTP_STATUS, ERROR_MESSAGES, API_PATHS, } from "./src/config/constants";
 export { LovrabetError } from "./src/utils/errors";
 export { safe } from "./src/utils/safe";
 export type { SafeResult } from "./src/utils/safe";
@@ -13,7 +13,7 @@ export { ServicesNamespace, FileClient, OcrClient, OcrType, OCR_TYPES, } from ".
 export type { LovrabetServices, FileQueryUrlRequest, FileService, FileUploadRequest, FileUploadResponse, FileUrlResponse, OcrRecognizeRequest, OcrRecognizeResponse, OcrService, ServiceRequestOptions, } from "./src/services/index";
 export { AuthManager, } from "./src/auth/index";
 export { generateOpenApiToken, TokenGenerator, isTokenExpiring, getTokenRemainingTime, type GenerateTokenParams, type TokenResult } from "./src/auth/index";
-export type { ClientConfig, LovrabetClient, ModelConfig, ModelsConfig, AuthMode, } from "./src/types/index";
+export type { ClientConfig, LovrabetClient, ModelConfig, ModelsConfig, AuthMode, Region, } from "./src/types/index";
 export type { ListParams, ListResponse, FilterParams, WhereCondition, FieldCondition, ConditionOperator, Environment, BaseModelMethods, SortList, SelectOption, SelectOptionsParams, AggregateParams, AggregateField, HavingCondition, } from "./src/types/index";
 export type { SqlExecuteRequest, SqlExecuteResult, } from "./src/api/types";
 export { SortOrder, } from "./src/types/index";