@lovrabet/sdk 1.0.0

package/README.md

@@ -0,0 +1,213 @@
+# Lovrabet Node SDK
+
+一个现代化的 Lovrabet 数据平台 SDK，支持 TypeScript，提供优雅的 API 设计。
+
+## 特性
+
+- 🚀 **现代化 API** - 基于 `createClient()` 的简洁设计
+- 🔒 **多种鉴权** - 支持用户 token、OpenAPI 等多种认证方式
+- 🌍 **环境切换** - 支持生产环境和日常环境
+- 📦 **TypeScript** - 完整的类型支持
+- 🔧 **配置文件** - 支持配置文件管理
+- 🔄 **向后兼容** - 保持对旧版 API 的兼容
+- ⚡ **动态实体** - 通过 Proxy 实现动态实体访问
+
+## 快速开始
+
+### 安装
+
+```bash
+npm install @lovrabet/sdk
+```
+
+### 基础用法
+
+```typescript
+import { createClient } from "@lovrabet/sdk";
+
+// 创建客户端
+const client = createClient({
+  appCode: "your-app-code",
+  env: "online",
+
+  entities: {
+    Requirements: {
+      tableName: "requirements",
+      datasetId: "your-dataset-id",
+    },
+  },
+});
+
+// 使用实体
+const requirements = await client.entities.Requirements.list();
+const newReq = await client.entities.Requirements.create({
+  title: "New Requirement",
+});
+```
+
+### 配置文件支持
+
+创建 `lovrabet.config.js`：
+
+```javascript
+module.exports = {
+  appCode: "your-app-code",
+  env: "online",
+  entities: {
+    Requirements: {
+      tableName: "requirements",
+      datasetId: "your-dataset-id",
+    },
+  },
+};
+```
+
+使用配置文件：
+
+```typescript
+const client = createClient({
+  configFile: "./lovrabet.config.js",
+});
+```
+
+## API 文档
+
+### 创建客户端
+
+```typescript
+import { createClient, ClientConfig } from '@lovrabet/sdk';
+
+const config: ClientConfig = {
+  // 必需
+  appCode: string;
+
+  // 可选
+  serverUrl?: string;           // 自定义服务器地址
+  env?: 'online' | 'daily';     // 环境，默认 'online'
+
+  // 鉴权方式（选择其一或组合使用）
+  token?: string;               // 用户 token
+  accessKey?: string;           // OpenAPI access key
+  secretKey?: string;           // OpenAPI secret key
+  requiresAuth?: boolean;       // 是否必须鉴权
+
+  // 实体配置
+  entities?: Record<string, {
+    tableName: string;
+    datasetId: string;
+  }>;
+
+  // 其他选项
+  options?: {
+    timeout?: number;           // 请求超时时间
+    retryCount?: number;        // 重试次数
+    onError?: (error: any) => void;        // 错误回调
+    onRedirectToLogin?: () => void;        // 登录重定向回调
+  };
+};
+```
+
+### 实体操作
+
+每个实体支持标准的 CRUD 操作：
+
+```typescript
+// 查询列表
+await client.entities.EntityName.list({
+  currentPage?: number;
+  pageSize?: number;
+  [key: string]: any;
+});
+
+// 获取单条
+await client.entities.EntityName.get(id: string | number);
+
+// 创建
+await client.entities.EntityName.create(data: Record<string, any>);
+
+// 更新
+await client.entities.EntityName.update(id: string | number, data: Record<string, any>);
+
+// 删除
+await client.entities.EntityName.delete(id: string | number);
+
+// 批量创建
+await client.entities.EntityName.bulkCreate(data: Record<string, any>[]);
+```
+
+### 客户端方法
+
+```typescript
+// 设置新 token
+client.setToken(token: string);
+
+// 获取配置
+client.getConfig(): ClientConfig;
+
+// 测试连接
+await client.testConnection(): Promise<boolean>;
+
+// 设置环境
+client.setEnvironment(env: 'online' | 'daily');
+
+// 获取当前环境
+client.getEnvironment(): 'online' | 'daily';
+```
+
+## 向后兼容
+
+旧版代码无需修改：
+
+```typescript
+import { LovrabetTableApi, initEnv } from "@lovrabet/sdk";
+
+initEnv("online");
+
+const api = new LovrabetTableApi({
+  appCode: "your-app-code",
+  tableName: "requirements",
+  datasetId: "your-dataset-id",
+});
+
+const data = await api.getList();
+```
+
+## 错误处理
+
+```typescript
+import { createClient, LovrabetError } from "@lovrabet/sdk";
+
+try {
+  const data = await client.entities.Requirements.list();
+} catch (error) {
+  if (error instanceof LovrabetError) {
+    console.log("Status:", error.status);
+    console.log("Code:", error.code);
+    console.log("Data:", error.data);
+  }
+}
+```
+
+## 文档
+
+- [使用指南](./docs/usage-guide.md) - 详细的使用文档和最佳实践
+- [架构设计](./docs/new-sdk-design.md) - SDK 的架构设计说明
+- [迁移指南](./docs/usage-guide.md#迁移指南) - 从旧版本迁移的指南
+
+## 开发
+
+```bash
+# 构建
+bun run build
+
+# 发布
+bun run release
+```
+
+## 许可证
+
+MIT
+
+## 支持
+
+如有问题或建议，请提交 Issue。

package/dist/index.d.ts

@@ -0,0 +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 { LovrabetError } from "./src/utils/errors";
+export type { ClientConfig, LovrabetClient, ModelConfig, ModelsConfig, } from "./src/types/index";
+export type { ListParams, ListResponse, Environment, BaseModelMethods, } from "./src/types/index";

package/dist/index.js

@@ -0,0 +1 @@
+const a0_0x2a4f3a=a0_0x4033;(function(_0x3b6070,_0x2785da){const _0x3239b1=a0_0x4033,_0x3e1124=_0x3b6070();while(!![]){try{const _0x403962=parseInt(_0x3239b1(0x162))/0x1*(parseInt(_0x3239b1(0x12e))/0x2)+-parseInt(_0x3239b1(0x114))/0x3*(-parseInt(_0x3239b1(0x11a))/0x4)+-parseInt(_0x3239b1(0x153))/0x5*(parseInt(_0x3239b1(0xfc))/0x6)+parseInt(_0x3239b1(0x103))/0x7+parseInt(_0x3239b1(0x104))/0x8*(parseInt(_0x3239b1(0xdc))/0x9)+-parseInt(_0x3239b1(0x12d))/0xa*(parseInt(_0x3239b1(0x10a))/0xb)+-parseInt(_0x3239b1(0xfb))/0xc*(parseInt(_0x3239b1(0x129))/0xd);if(_0x403962===_0x2785da)break;else _0x3e1124['push'](_0x3e1124['shift']());}catch(_0x56dbb8){_0x3e1124['push'](_0x3e1124['shift']());}}}(a0_0x128b,0x75a28));class UserAuth{[a0_0x2a4f3a(0xdd)];constructor(_0x5080ba){const _0x2b2c3e=a0_0x2a4f3a;this[_0x2b2c3e(0xdd)]=_0x5080ba;}async['getAuthHeaders'](){const _0x1c99e5=a0_0x2a4f3a;return{'Authorization':_0x1c99e5(0xdf)+this[_0x1c99e5(0xdd)][_0x1c99e5(0xff)]};}[a0_0x2a4f3a(0x15a)](){const _0x3057d8=a0_0x2a4f3a;return this[_0x3057d8(0xdd)]['token'];}[a0_0x2a4f3a(0x14e)](_0x5b2d90){const _0x2832d3=a0_0x2a4f3a;this[_0x2832d3(0xdd)][_0x2832d3(0xff)]=_0x5b2d90;}}class OpenApiAuth{['config'];constructor(_0x583ed5){const _0x111e2b=a0_0x2a4f3a;this[_0x111e2b(0xdd)]=_0x583ed5;}async[a0_0x2a4f3a(0xea)](){const _0x3e2971=a0_0x2a4f3a,_0x47961f=Date[_0x3e2971(0x150)]()[_0x3e2971(0xe1)](),_0x196f0f=Math[_0x3e2971(0xf0)]()['toString'](0x24)[_0x3e2971(0xd6)](0x2),_0x4acbb8=await this['generateSignature'](_0x47961f,_0x196f0f);return{'X-Access-Key':this[_0x3e2971(0xdd)][_0x3e2971(0x142)],'X-Timestamp':_0x47961f,'X-Nonce':_0x196f0f,'X-Signature':_0x4acbb8};}async[a0_0x2a4f3a(0x136)](_0x291803,_0x3db088){const _0x3b817d=a0_0x2a4f3a,_0x169d40=''+this[_0x3b817d(0xdd)][_0x3b817d(0x142)]+_0x291803+_0x3db088;if(typeof crypto!==_0x3b817d(0x154)&&crypto[_0x3b817d(0x12b)]){const _0x28807a=new TextEncoder(),_0x8272ca=_0x28807a[_0x3b817d(0x15e)](this[_0x3b817d(0xdd)]['secretKey']),_0x4b63d2=_0x28807a[_0x3b817d(0x15e)](_0x169d40),_0x4d6f3d=await crypto[_0x3b817d(0x12b)][_0x3b817d(0x13e)](_0x3b817d(0xeb),_0x8272ca,{'name':_0x3b817d(0x160),'hash':'SHA-256'},![],[_0x3b817d(0x165)]),_0x3ff238=await crypto['subtle'][_0x3b817d(0x165)](_0x3b817d(0x160),_0x4d6f3d,_0x4b63d2),_0x4344a1=Array[_0x3b817d(0x174)](new Uint8Array(_0x3ff238));return _0x4344a1[_0x3b817d(0x161)](_0x2ffe74=>_0x2ffe74[_0x3b817d(0xe1)](0x10)[_0x3b817d(0x10b)](0x2,'0'))[_0x3b817d(0xee)]('');}if(typeof globalThis!=='undefined'&&globalThis[_0x3b817d(0x13b)]){const _0x58e7c8=globalThis[_0x3b817d(0x13b)];return _0x58e7c8[_0x3b817d(0x174)](_0x169d40+this[_0x3b817d(0xdd)][_0x3b817d(0x116)])[_0x3b817d(0xe1)](_0x3b817d(0xd8));}return btoa(_0x169d40+this[_0x3b817d(0xdd)][_0x3b817d(0x116)]);}}class CookieAuth{constructor(){}async[a0_0x2a4f3a(0xea)](){return{};}[a0_0x2a4f3a(0xe9)](){const _0x50c497=a0_0x2a4f3a;return typeof window!==_0x50c497(0x154)&&typeof document!==_0x50c497(0x154);}}class AuthManager{[a0_0x2a4f3a(0xdd)];[a0_0x2a4f3a(0xd9)];[a0_0x2a4f3a(0x11c)];['cookieAuth'];constructor(_0x3e5780){const _0x2ad820=a0_0x2a4f3a;this[_0x2ad820(0xdd)]=_0x3e5780,this[_0x2ad820(0x122)]();}[a0_0x2a4f3a(0x122)](){const _0x5a7941=a0_0x2a4f3a;this[_0x5a7941(0xdd)][_0x5a7941(0xff)]&&(this[_0x5a7941(0xd9)]=new UserAuth({'token':this[_0x5a7941(0xdd)][_0x5a7941(0xff)]})),this[_0x5a7941(0xdd)]['accessKey']&&this[_0x5a7941(0xdd)][_0x5a7941(0x116)]&&(this[_0x5a7941(0x11c)]=new OpenApiAuth({'accessKey':this[_0x5a7941(0xdd)][_0x5a7941(0x142)],'secretKey':this['config'][_0x5a7941(0x116)]})),!this['config'][_0x5a7941(0xff)]&&!this[_0x5a7941(0xdd)][_0x5a7941(0x142)]&&!this[_0x5a7941(0xdd)]['secretKey']&&(this[_0x5a7941(0x166)]=new CookieAuth());}async[a0_0x2a4f3a(0xea)](){const _0x3a9242=a0_0x2a4f3a,_0x526c82={};if(this[_0x3a9242(0xd9)]){const _0x50cac8=await this['userAuth']['getAuthHeaders']();Object['assign'](_0x526c82,_0x50cac8);}else{if(this[_0x3a9242(0x11c)]){const _0x15e029=await this[_0x3a9242(0x11c)][_0x3a9242(0xea)]();Object[_0x3a9242(0x139)](_0x526c82,_0x15e029);}else{if(this['cookieAuth']){const _0x397fee=await this['cookieAuth'][_0x3a9242(0xea)]();Object[_0x3a9242(0x139)](_0x526c82,_0x397fee);}}}return _0x526c82;}async['validateAuth'](){const _0x4f3ae9=a0_0x2a4f3a;try{if(this[_0x4f3ae9(0x166)]?.[_0x4f3ae9(0xe9)]())return!![];const _0x5e4db5=await this[_0x4f3ae9(0xea)]();return Object['keys'](_0x5e4db5)[_0x4f3ae9(0xed)]>0x0;}catch{return![];}}[a0_0x2a4f3a(0x145)](){const _0x168c0d=a0_0x2a4f3a;return!!this[_0x168c0d(0x166)];}[a0_0x2a4f3a(0x14e)](_0x2215cb){const _0x1e007a=a0_0x2a4f3a;this[_0x1e007a(0xdd)][_0x1e007a(0xff)]=_0x2215cb,this[_0x1e007a(0xd9)]=new UserAuth({'token':_0x2215cb}),this[_0x1e007a(0x166)]=undefined;}}class LovrabetError extends Error{['status'];[a0_0x2a4f3a(0xf2)];[a0_0x2a4f3a(0x14f)];['originalError'];constructor(_0x40e9c7,_0x59a568,_0x20f515,_0x283b72,_0x5a0873){const _0x3c06ac=a0_0x2a4f3a;super(_0x40e9c7),this[_0x3c06ac(0x13a)]=_0x3c06ac(0xef),this[_0x3c06ac(0x14d)]=_0x59a568,this[_0x3c06ac(0xf2)]=_0x20f515,this['data']=_0x283b72,this[_0x3c06ac(0x128)]=_0x5a0873;}['toJSON'](){const _0x5cc2ef=a0_0x2a4f3a;return{'name':this[_0x5cc2ef(0x13a)],'message':this[_0x5cc2ef(0xda)],'status':this[_0x5cc2ef(0x14d)],'code':this[_0x5cc2ef(0xf2)],'data':this[_0x5cc2ef(0x14f)]};}}function createErrorHandler(_0x50615f){return _0x447b91=>{const _0x1fc592=a0_0x4033,_0x717847=_0x447b91 instanceof LovrabetError?_0x447b91:new LovrabetError(_0x447b91['message']||_0x1fc592(0x15d),_0x447b91[_0x1fc592(0x14d)],_0x447b91[_0x1fc592(0xf2)],_0x447b91[_0x1fc592(0x14f)],_0x447b91);return typeof globalThis!==_0x1fc592(0x154)&&globalThis[_0x1fc592(0xf3)]?.[_0x1fc592(0x126)]?.['NODE_ENV']!==_0x1fc592(0x132)&&console[_0x1fc592(0x13d)](_0x1fc592(0x133),_0x717847),_0x50615f?.(_0x717847),Promise[_0x1fc592(0x144)](_0x717847);};}var CONFIG_NAMES={'DEFAULT':a0_0x2a4f3a(0x16a),'PROD':a0_0x2a4f3a(0x11e),'DEV':a0_0x2a4f3a(0x127),'TEST':a0_0x2a4f3a(0x157)},ENVIRONMENTS={'ONLINE':a0_0x2a4f3a(0x149),'DAILY':a0_0x2a4f3a(0x14b)},HTTP_STATUS={'OK':0xc8,'UNAUTHORIZED':0x191,'FORBIDDEN':0x193,'NOT_FOUND':0x194,'INTERNAL_ERROR':0x1f4},DEFAULTS={'ENV':ENVIRONMENTS[a0_0x2a4f3a(0x110)],'TIMEOUT':0x7530,'RETRY_COUNT':0x3,'PAGE_SIZE':0x14,'CURRENT_PAGE':0x1},ERROR_MESSAGES={'APP_CODE_REQUIRED':a0_0x2a4f3a(0x138),'CONFIG_NOT_FOUND':_0x4f363e=>a0_0x2a4f3a(0x11d)+_0x4f363e+a0_0x2a4f3a(0x13c),'INVALID_ENV':a0_0x2a4f3a(0x124),'NETWORK_ERROR':a0_0x2a4f3a(0x130),'UNAUTHORIZED':a0_0x2a4f3a(0x10d),'FORBIDDEN':a0_0x2a4f3a(0x125),'NOT_FOUND':a0_0x2a4f3a(0x16b),'SERVER_ERROR':'Internal\x20server\x20error'},API_PATHS={'BASE':'/api/{appCode}/{datasetId}','LIST':'','DETAIL':a0_0x2a4f3a(0xfd)},API_ENDPOINTS={[ENVIRONMENTS['ONLINE']]:a0_0x2a4f3a(0x111),[ENVIRONMENTS[a0_0x2a4f3a(0x131)]]:'https://daily-runtime.lovrabet.com'};function getApiEndpoint(_0x110162){return API_ENDPOINTS[_0x110162];}function getAvailableEnvironments(){return Object['keys'](API_ENDPOINTS);}var cacheCookie='';function getCookie(){return cacheCookie;}var processResponse=async _0x400e95=>{const _0x45456b=a0_0x2a4f3a,_0x4e7ba9=await _0x400e95[_0x45456b(0x119)]();if(!_0x4e7ba9['success']){const _0x580dcd=new Error(_0x4e7ba9[_0x45456b(0x163)]);_0x580dcd['response']=_0x4e7ba9;throw _0x580dcd;}return _0x4e7ba9[_0x45456b(0x14f)];};function getTraceparent(){const _0x393b05=a0_0x2a4f3a;try{return document[_0x393b05(0x172)](_0x393b05(0x10f))?.['getAttribute']('content')||undefined;}catch(_0x3e3ac0){return;}}function generateTraceparent(){const _0x52ee32=a0_0x2a4f3a,_0x503da3=getTraceparent(),_0x522b55=_0x503da3?_0x503da3[_0x52ee32(0x12a)]('-')[0x1]:Array[_0x52ee32(0x174)](crypto[_0x52ee32(0x12f)](new Uint8Array(0x10)))['map'](_0x4ee31e=>_0x4ee31e['toString'](0x10)[_0x52ee32(0x10b)](0x2,'0'))[_0x52ee32(0xee)](''),_0x5f0b7=Array['from'](crypto[_0x52ee32(0x12f)](new Uint8Array(0x8)))[_0x52ee32(0x161)](_0x354f74=>_0x354f74[_0x52ee32(0xe1)](0x10)[_0x52ee32(0x10b)](0x2,'0'))['join'](''),_0x33bd98='01';return _0x52ee32(0x123)+_0x522b55+'-'+_0x5f0b7+'-'+_0x33bd98;}var get=async(_0xaf11ff,_0x306f22,_0x19ef69={})=>{const _0x25da50=a0_0x2a4f3a,_0x14f0f7=new URL(_0xaf11ff);if(_0x306f22)for(const _0x559b03 of Object['keys'](_0x306f22)){_0x14f0f7[_0x25da50(0x135)][_0x25da50(0x121)](_0x559b03,String(_0x306f22[_0x559b03]));}const _0x1ef2fe={'Content-Type':_0x25da50(0x105),..._0x19ef69['headers'],'traceparent':generateTraceparent()};getCookie()&&(_0x1ef2fe['Cookie']=getCookie());const _0x590c0f=await fetch(_0x14f0f7[_0x25da50(0xe1)](),{..._0x19ef69,'headers':_0x1ef2fe,'credentials':_0x25da50(0xfa)});if(_0x590c0f[_0x25da50(0x15b)]){window[_0x25da50(0x169)][_0x25da50(0x12c)]=_0x590c0f[_0x25da50(0x146)];return;}return await processResponse(_0x590c0f);},post=async(_0x3060e7,_0x91ce93,_0x117f19={})=>{const _0xa4d02=a0_0x2a4f3a,_0x1d9d36={'Content-Type':'application/json',..._0x117f19[_0xa4d02(0x170)],'traceparent':generateTraceparent()};getCookie()&&(_0x1d9d36[_0xa4d02(0xfe)]=getCookie());const _0x9c50d6=await fetch(_0x3060e7,{..._0x117f19,'method':'POST','headers':_0x1d9d36,'body':_0x91ce93&&JSON[_0xa4d02(0x168)](_0x91ce93),'credentials':_0xa4d02(0xfa)});if(_0x9c50d6['redirected']){window[_0xa4d02(0x169)][_0xa4d02(0x12c)]=_0x9c50d6[_0xa4d02(0x146)];return;}return await processResponse(_0x9c50d6);};class HttpClient{['config'];[a0_0x2a4f3a(0x137)];['errorHandler'];constructor(_0x49e906,_0x4f6263){const _0xb1e618=a0_0x2a4f3a;this[_0xb1e618(0xdd)]=_0x49e906,this[_0xb1e618(0x137)]=_0x4f6263,this[_0xb1e618(0x151)]=createErrorHandler(_0x49e906[_0xb1e618(0x100)]?.[_0xb1e618(0x16f)]);}[a0_0x2a4f3a(0x152)](){const _0x347ef2=a0_0x2a4f3a;if(this['config'][_0x347ef2(0x107)])return this['config']['serverUrl'];const _0x333af6=this[_0x347ef2(0xdd)][_0x347ef2(0x126)]||_0x347ef2(0x149);return getApiEndpoint(_0x333af6);}[a0_0x2a4f3a(0xd5)](_0x5012e1){const _0x128241=a0_0x2a4f3a;return _0x5012e1[_0x128241(0x173)](_0x128241(0x16c))?_0x5012e1:''+this[_0x128241(0x152)]()+_0x5012e1;}async[a0_0x2a4f3a(0x108)](_0x4f737f){const _0x13d4a2=a0_0x2a4f3a,_0x2b7998=await this[_0x13d4a2(0x137)][_0x13d4a2(0xea)](),_0x4f58c7={..._0x4f737f,'headers':{..._0x2b7998,..._0x4f737f?.[_0x13d4a2(0x170)]}};return this[_0x13d4a2(0x137)][_0x13d4a2(0x145)]()&&(_0x4f58c7[_0x13d4a2(0xdb)]=_0x13d4a2(0xfa)),_0x4f58c7;}async[a0_0x2a4f3a(0x155)](_0x552d4c){const _0x465d18=a0_0x2a4f3a;try{return await _0x552d4c();}catch(_0x3dfc8c){return this[_0x465d18(0x151)](_0x3dfc8c);}}async[a0_0x2a4f3a(0x140)](_0x1842ce,_0x2af564,_0x14c06b,_0x2dbf5c){const _0x15dc67=a0_0x2a4f3a,_0x24c3f5=this['getFullUrl'](_0x2af564),_0x3af383=await this['prepareRequestInit']({..._0x2dbf5c,'method':_0x1842ce,'headers':{'Content-Type':_0x15dc67(0x105),..._0x2dbf5c?.[_0x15dc67(0x170)]}}),_0x3def8d=new AbortController(),_0x44eab0=setTimeout(()=>{const _0x208e30=_0x15dc67;_0x3def8d[_0x208e30(0x143)]();},this[_0x15dc67(0xdd)]['options']?.[_0x15dc67(0x158)]||0x7530);try{const _0x3ea46e=await fetch(_0x24c3f5,{..._0x3af383,'body':_0x14c06b?JSON['stringify'](_0x14c06b):undefined,'signal':_0x3def8d[_0x15dc67(0x115)]});clearTimeout(_0x44eab0);if(!_0x3ea46e['ok']){const _0x3403cb=await _0x3ea46e[_0x15dc67(0x119)]()['catch'](()=>({}));throw new LovrabetError(_0x3403cb[_0x15dc67(0xda)]||'HTTP\x20'+_0x3ea46e['status']+':\x20'+_0x3ea46e[_0x15dc67(0x148)],_0x3ea46e[_0x15dc67(0x14d)],_0x3403cb[_0x15dc67(0xf2)],_0x3403cb);}return await _0x3ea46e[_0x15dc67(0x119)]();}catch(_0x4d3d66){clearTimeout(_0x44eab0);if(_0x4d3d66[_0x15dc67(0x13a)]===_0x15dc67(0xf7))throw new LovrabetError('Request\x20timeout',0x198,_0x15dc67(0xf4));throw _0x4d3d66;}}async[a0_0x2a4f3a(0xe8)](_0x45536d,_0x4521f2,_0x42d854){const _0x1a6bca=a0_0x2a4f3a;return this[_0x1a6bca(0x155)](async()=>{const _0x1b7111=_0x1a6bca,_0x51b6cd=this[_0x1b7111(0xd5)](_0x45536d),_0x1dd10a=await this[_0x1b7111(0x108)](_0x42d854);return await get(_0x51b6cd,_0x4521f2,_0x1dd10a);});}async[a0_0x2a4f3a(0x101)](_0x12d271,_0x1e52f2,_0x136501){const _0x14335d=a0_0x2a4f3a;return this[_0x14335d(0x155)](async()=>{const _0x1dc944=_0x14335d,_0x8ec90f=this[_0x1dc944(0xd5)](_0x12d271),_0x5ee506=await this['prepareRequestInit'](_0x136501);return await post(_0x8ec90f,_0x1e52f2,_0x5ee506);});}async[a0_0x2a4f3a(0xf1)](_0x5a62df,_0x34386e,_0xdafcf9){const _0x5defd1=a0_0x2a4f3a;return this[_0x5defd1(0x155)](async()=>{const _0x3a962c=_0x5defd1;return this['makeRequest'](_0x3a962c(0xde),_0x5a62df,_0x34386e,_0xdafcf9);});}async[a0_0x2a4f3a(0x175)](_0x139312,_0x10fecf){return this['executeWithErrorHandling'](async()=>{const _0x55c24e=a0_0x4033;return this[_0x55c24e(0x140)](_0x55c24e(0x159),_0x139312,undefined,_0x10fecf);});}async[a0_0x2a4f3a(0xe0)](_0xf49b42,_0x24b1d6,_0x4802af,_0xa91e30){const _0x3c20df=a0_0x2a4f3a;switch(_0xf49b42){case _0x3c20df(0xe2):return this[_0x3c20df(0xe8)](_0x24b1d6,_0x4802af,_0xa91e30);case _0x3c20df(0x167):return this[_0x3c20df(0x101)](_0x24b1d6,_0x4802af,_0xa91e30);case _0x3c20df(0xde):return this['put'](_0x24b1d6,_0x4802af,_0xa91e30);case'DELETE':return this['delete'](_0x24b1d6,_0xa91e30);default:throw new LovrabetError(_0x3c20df(0xe3)+_0xf49b42,0x190,'INVALID_METHOD');}}}class BaseModel{[a0_0x2a4f3a(0x10e)];[a0_0x2a4f3a(0x109)];[a0_0x2a4f3a(0xdd)];[a0_0x2a4f3a(0x10c)];constructor(_0x342460,_0x4da876,_0x4b5614){const _0xb39a00=a0_0x2a4f3a;this[_0xb39a00(0x10e)]=_0x342460,this[_0xb39a00(0x109)]=_0x4da876,this[_0xb39a00(0x10c)]=_0x4b5614[_0xb39a00(0x10c)],this[_0xb39a00(0xdd)]=this[_0xb39a00(0xe7)](_0x342460,_0x4b5614);}[a0_0x2a4f3a(0xe7)](_0x287759,_0x215ae4){const _0x216dc0=a0_0x2a4f3a;if(_0x215ae4[_0x216dc0(0x106)]?.[_0x287759])return _0x215ae4[_0x216dc0(0x106)][_0x287759];throw new Error(_0x216dc0(0xe5)+_0x287759+_0x216dc0(0xe4));}[a0_0x2a4f3a(0x171)](){const _0x11955c=a0_0x2a4f3a;return _0x11955c(0x11f)+this[_0x11955c(0x10c)]+'/'+this[_0x11955c(0xdd)]['datasetId'];}async['getList'](_0x4b15e2){const _0x128bfa=a0_0x2a4f3a,_0x309f5d=this['getApiPath']()+_0x128bfa(0x14c),_0x5a16d9={'currentPage':0x1,'pageSize':0x14,..._0x4b15e2};return this[_0x128bfa(0x109)]['post'](_0x309f5d,_0x5a16d9);}async[a0_0x2a4f3a(0x112)](_0x4b4a60){const _0x413843=a0_0x2a4f3a,_0xc163fd=this['getApiPath']()+'/getOne';return this[_0x413843(0x109)]['post'](_0xc163fd,{'id':_0x4b4a60});}async['create'](_0x356cfe){const _0x12e34e=a0_0x2a4f3a,_0x4d7441=this['getApiPath']()+'/create';return this['httpClient'][_0x12e34e(0x101)](_0x4d7441,_0x356cfe);}async[a0_0x2a4f3a(0xec)](_0x1bc66f,_0x3f0a24){const _0xb23c7f=a0_0x2a4f3a,_0x1cd55a=this[_0xb23c7f(0x171)]()+'/update';return this[_0xb23c7f(0x109)][_0xb23c7f(0x101)](_0x1cd55a,{'id':_0x1bc66f,..._0x3f0a24});}async[a0_0x2a4f3a(0x175)](_0x1c0a1e){const _0x3576ad=a0_0x2a4f3a,_0xa091a0=this[_0x3576ad(0x171)]()+_0x3576ad(0xf8);await this[_0x3576ad(0x109)][_0x3576ad(0x101)](_0xa091a0,{'id':_0x1c0a1e});}[a0_0x2a4f3a(0x156)](){const _0x1a8bc7=a0_0x2a4f3a;return{...this[_0x1a8bc7(0xdd)]};}[a0_0x2a4f3a(0x141)](){const _0x447796=a0_0x2a4f3a;return this[_0x447796(0x10e)];}}class ModelManager{['httpClient'];[a0_0x2a4f3a(0xdd)];[a0_0x2a4f3a(0xf9)]=new Map();constructor(_0x2100d8,_0x2b24d0){const _0xb33fbc=a0_0x2a4f3a;return this['httpClient']=_0x2100d8,this[_0xb33fbc(0xdd)]=_0x2b24d0,new Proxy(this,{'get'(_0x282f30,_0x12f3c1){const _0x7a94eb=_0xb33fbc;if(typeof _0x12f3c1===_0x7a94eb(0x102)||_0x12f3c1 in _0x282f30)return Reflect[_0x7a94eb(0xe8)](_0x282f30,_0x12f3c1);if(_0x12f3c1==='then'||_0x12f3c1[_0x7a94eb(0x173)]('_')||_0x12f3c1===_0x7a94eb(0x117))return;return _0x282f30[_0x7a94eb(0x134)](_0x12f3c1);}});}[a0_0x2a4f3a(0x134)](_0xb3561b){const _0x5426d7=a0_0x2a4f3a;if(!this[_0x5426d7(0xf9)][_0x5426d7(0x120)](_0xb3561b)){const _0xac6fb8=new BaseModel(_0xb3561b,this['httpClient'],this[_0x5426d7(0xdd)]);this['modelCache']['set'](_0xb3561b,_0xac6fb8);}return this[_0x5426d7(0xf9)][_0x5426d7(0xe8)](_0xb3561b);}[a0_0x2a4f3a(0x164)](){const _0x506c4c=a0_0x2a4f3a;return Array[_0x506c4c(0x174)](this['modelCache'][_0x506c4c(0x118)]());}[a0_0x2a4f3a(0x16e)](){const _0x4104bf=a0_0x2a4f3a;this[_0x4104bf(0xf9)][_0x4104bf(0x14a)]();}['addModel'](_0x31a629,_0x2f5d92){const _0x3a4589=a0_0x2a4f3a;!this[_0x3a4589(0xdd)][_0x3a4589(0x106)]&&(this[_0x3a4589(0xdd)][_0x3a4589(0x106)]={}),this[_0x3a4589(0xdd)][_0x3a4589(0x106)][_0x31a629]=_0x2f5d92,this[_0x3a4589(0xf9)][_0x3a4589(0x120)](_0x31a629)&&this[_0x3a4589(0xf9)]['delete'](_0x31a629);}}class LovrabetClient{[a0_0x2a4f3a(0xdd)];[a0_0x2a4f3a(0x137)];[a0_0x2a4f3a(0x109)];[a0_0x2a4f3a(0x106)];constructor(_0xc272ce){const _0x8860de=a0_0x2a4f3a;this[_0x8860de(0x11b)](_0xc272ce),this[_0x8860de(0xdd)]={..._0xc272ce},this[_0x8860de(0x137)]=new AuthManager(this[_0x8860de(0xdd)]),this[_0x8860de(0x109)]=new HttpClient(this[_0x8860de(0xdd)],this['authManager']),this[_0x8860de(0x106)]=new ModelManager(this[_0x8860de(0x109)],this['config']);}[a0_0x2a4f3a(0x11b)](_0x4685ac){const _0xadcc2f=a0_0x2a4f3a;if(_0x4685ac['requiresAuth']){const _0x11df58=!!_0x4685ac[_0xadcc2f(0xff)],_0x31abc5=!!(_0x4685ac[_0xadcc2f(0x142)]&&_0x4685ac[_0xadcc2f(0x116)]);if(!_0x11df58&&!_0x31abc5)throw new Error(_0xadcc2f(0x16d));}}[a0_0x2a4f3a(0x14e)](_0x16bd20){const _0x53f58a=a0_0x2a4f3a;this[_0x53f58a(0xdd)][_0x53f58a(0xff)]=_0x16bd20,this['authManager'][_0x53f58a(0x14e)](_0x16bd20);}[a0_0x2a4f3a(0x156)](){const _0x2f4e75=a0_0x2a4f3a;return{...this[_0x2f4e75(0xdd)]};}[a0_0x2a4f3a(0x152)](){const _0x517ada=a0_0x2a4f3a;if(this[_0x517ada(0xdd)][_0x517ada(0x107)])return this[_0x517ada(0xdd)][_0x517ada(0x107)];const _0x1158e5=this[_0x517ada(0xdd)][_0x517ada(0x126)]||_0x517ada(0x149);return getApiEndpoint(_0x1158e5);}[a0_0x2a4f3a(0xe6)](_0x2ce0ec){const _0x520771=a0_0x2a4f3a;this['config'][_0x520771(0x126)]=_0x2ce0ec;}[a0_0x2a4f3a(0x15c)](){const _0x1ce01a=a0_0x2a4f3a;return this[_0x1ce01a(0xdd)]['env']||'online';}}var modelConfigRegistry=new Map();function registerModels(_0x57ad5e,_0x2fd0e3=CONFIG_NAMES[a0_0x2a4f3a(0x13f)]){const _0x1e2d8d=a0_0x2a4f3a;modelConfigRegistry[_0x1e2d8d(0xf6)](_0x2fd0e3,_0x57ad5e);}function getRegisteredModels(_0x131f5f){const _0x191bf1=a0_0x2a4f3a;return modelConfigRegistry[_0x191bf1(0xe8)](_0x131f5f);}function a0_0x128b(){const _0x39663d=['data','now','errorHandler','getBaseUrl','44905bSgqjm','undefined','executeWithErrorHandling','getConfig','test','timeout','DELETE','getToken','redirected','getEnvironment','Unknown\x20error','encode','string','HMAC','map','183663vYnxqe','errorMsg','getCachedModels','sign','cookieAuth','POST','stringify','location','default','Resource\x20not\x20found','http','Authentication\x20is\x20required\x20but\x20no\x20auth\x20method\x20provided.\x20Please\x20provide\x20either\x20\x22token\x22\x20or\x20\x22accessKey\x20+\x20secretKey\x22','clearCache','onError','headers','getApiPath','querySelector','startsWith','from','delete','getFullUrl','substring','CONFIG_NOT_FOUND','base64','userAuth','message','credentials','576MWZbLm','config','PUT','Bearer\x20','request','toString','GET','Unsupported\x20method:\x20','\x22\x20not\x20configured.\x20Please\x20provide\x20datasetId\x20in\x20config.models\x20or\x20use\x20registerModels()\x20to\x20configure\x20it.','Model\x20\x22','setEnvironment','resolveModelConfig','get','isValid','getAuthHeaders','raw','update','length','join','LovrabetError','random','put','code','process','TIMEOUT','apiConfigName','set','AbortError','/delete','modelCache','include','12RpNnzR','90WOlxsO','/{id}','Cookie','token','options','post','symbol','613123GSTznT','54584OunrtY','application/json','models','serverUrl','prepareRequestInit','httpClient','310497SxrqvF','padStart','appCode','Unauthorized\x20access','modelName','meta[name=\x22traceparent\x22]','ONLINE','https://runtime.lovrabet.com','getOne','ENV','69ZiLSIj','signal','secretKey','constructor','keys','json','154388yGqbAa','validateConfig','openApiAuth','Model\x20config\x20with\x20name\x20\x22','prod','/api/','has','append','initAuthMethods','00-','Invalid\x20environment.\x20Must\x20be\x20\x22online\x22\x20or\x20\x22daily\x22.','Access\x20forbidden','env','dev','originalError','5389384nHsoxh','split','subtle','href','200CImYec','2jTKQju','getRandomValues','Network\x20request\x20failed','DAILY','production','[Lovrabet\x20SDK\x20Error]','getModel','searchParams','generateSignature','authManager','appCode\x20is\x20required.\x20Please\x20provide\x20it\x20in\x20the\x20config\x20or\x20register\x20models\x20first.','assign','name','Buffer','\x22\x20not\x20found.\x20Please\x20register\x20it\x20first\x20using\x20registerModels().','error','importKey','DEFAULT','makeRequest','getModelName','accessKey','abort','reject','isCookieAuth','url','object','statusText','online','clear','daily','/getList','status','setToken'];a0_0x128b=function(){return _0x39663d;};return a0_0x128b();}function a0_0x4033(_0x126f5a,_0x315814){const _0x128ba8=a0_0x128b();return a0_0x4033=function(_0x4033d5,_0x2295e8){_0x4033d5=_0x4033d5-0xd5;let _0x5ac58b=_0x128ba8[_0x4033d5];return _0x5ac58b;},a0_0x4033(_0x126f5a,_0x315814);}function getRegisteredConfigNames(){const _0x565ccd=a0_0x2a4f3a;return Array[_0x565ccd(0x174)](modelConfigRegistry[_0x565ccd(0x118)]());}function unregisterModels(_0x1f6651){const _0x3198fb=a0_0x2a4f3a;return modelConfigRegistry[_0x3198fb(0x175)](_0x1f6651);}function clearAllRegistrations(){const _0x2c71e4=a0_0x2a4f3a;modelConfigRegistry[_0x2c71e4(0x14a)]();}function createClient(_0x27c13c=CONFIG_NAMES[a0_0x2a4f3a(0x13f)]){const _0x4c2f3=a0_0x2a4f3a;let _0x34b6a4;if(typeof _0x27c13c===_0x4c2f3(0x15f)){const _0x203b96=getRegisteredModels(_0x27c13c);if(!_0x203b96)throw new Error(ERROR_MESSAGES[_0x4c2f3(0xd7)](_0x27c13c));_0x34b6a4={'appCode':_0x203b96['appCode'],'env':DEFAULTS[_0x4c2f3(0x113)],'models':_0x203b96[_0x4c2f3(0x106)]};}else{if(typeof _0x27c13c===_0x4c2f3(0x147)&&_0x4c2f3(0x10c)in _0x27c13c&&_0x4c2f3(0x106)in _0x27c13c&&!('env'in _0x27c13c))_0x34b6a4={'appCode':_0x27c13c['appCode'],'env':DEFAULTS[_0x4c2f3(0x113)],'models':_0x27c13c[_0x4c2f3(0x106)]};else{if(typeof _0x27c13c==='object'&&_0x4c2f3(0xf5)in _0x27c13c){const {apiConfigName:_0x20b453,..._0x374343}=_0x27c13c,_0x5a53b1=getRegisteredModels(_0x20b453);if(!_0x5a53b1)throw new Error(ERROR_MESSAGES[_0x4c2f3(0xd7)](_0x20b453));_0x34b6a4={'appCode':_0x5a53b1['appCode'],'env':DEFAULTS['ENV'],'models':_0x5a53b1[_0x4c2f3(0x106)],..._0x374343};}else{const _0x2ae246={'env':DEFAULTS['ENV'],'models':{}};_0x34b6a4={..._0x2ae246,..._0x27c13c};}}}if(!_0x34b6a4[_0x4c2f3(0x10c)])throw new Error(ERROR_MESSAGES['APP_CODE_REQUIRED']);return new LovrabetClient(_0x34b6a4);}export{unregisterModels,registerModels,getRegisteredModels,getRegisteredConfigNames,getAvailableEnvironments,getApiEndpoint,createClient,clearAllRegistrations,LovrabetError,HTTP_STATUS,ERROR_MESSAGES,ENVIRONMENTS,DEFAULTS,CONFIG_NAMES,API_PATHS};

package/dist/src/auth/auth-manager.d.ts

@@ -0,0 +1,16 @@
+import type { ClientConfig, AuthHeaders, AuthManager as IAuthManager } from "../types";
+export declare class AuthManager implements IAuthManager {
+    private config;
+    private userAuth?;
+    private openApiAuth?;
+    private cookieAuth?;
+    constructor(config: ClientConfig);
+    private initAuthMethods;
+    getAuthHeaders(): Promise<AuthHeaders>;
+    validateAuth(): Promise<boolean>;
+    /**
+     * Check if we're using cookie-based authentication
+     */
+    isCookieAuth(): boolean;
+    setToken(token: string): void;
+}

package/dist/src/auth/cookie-auth.d.ts

@@ -0,0 +1,14 @@
+import type { AuthHeaders } from "../types";
+/**
+ * Cookie-based authentication for users logged into Lovrabet.com
+ * Uses browser cookies with credentials: 'include'
+ */
+export declare class CookieAuth {
+    constructor();
+    getAuthHeaders(): Promise<AuthHeaders>;
+    /**
+     * Cookie auth is always considered valid in browser environment
+     * The server will validate the actual cookie
+     */
+    isValid(): boolean;
+}

package/dist/src/auth/openapi-auth.d.ts

@@ -0,0 +1,7 @@
+import type { OpenApiAuthConfig, AuthHeaders } from "../types";
+export declare class OpenApiAuth {
+    private config;
+    constructor(config: OpenApiAuthConfig);
+    getAuthHeaders(): Promise<AuthHeaders>;
+    private generateSignature;
+}

package/dist/src/auth/user-auth.d.ts

@@ -0,0 +1,8 @@
+import type { UserAuthConfig, AuthHeaders } from "../types";
+export declare class UserAuth {
+    private config;
+    constructor(config: UserAuthConfig);
+    getAuthHeaders(): Promise<AuthHeaders>;
+    getToken(): string;
+    setToken(token: string): void;
+}

package/dist/src/client/client.d.ts

@@ -0,0 +1,58 @@
+import type { ClientConfig, LovrabetClient as ILovrabetClient, ModelManager, Environment } from "../types";
+/**
+ * Lovrabet SDK 核心客户端类
+ *
+ * 设计原则：
+ * 1. 实例化设计 - 避免全局状态，支持多项目并存
+ * 2. 依赖注入 - 通过构造函数注入依赖，便于测试和扩展
+ * 3. 配置不可变 - 创建后配置基本不可变，提高安全性
+ * 4. 职责分离 - 认证、HTTP、模型管理各司其职
+ */
+export declare class LovrabetClient implements ILovrabetClient {
+    private config;
+    private authManager;
+    private httpClient;
+    /**
+     * 模型管理器公开访问 - 这是用户主要的交互接口
+     * 为什么是公开的：用户需要通过 client.models.xxx 访问各种模型
+     */
+    models: ModelManager;
+    constructor(config: ClientConfig);
+    private validateConfig;
+    /**
+     * 运行时动态设置 token
+     * 为什么需要这个方法：
+     * 1. 用户登录后可能需要更新 token
+     * 2. token 可能会过期需要刷新
+     * 3. 支持动态认证切换（比如用户切换账号）
+     */
+    setToken(token: string): void;
+    /**
+     * 获取当前配置的副本
+     * 为什么返回副本而不是原始对象：
+     * 1. 防止外部代码意外修改内部配置
+     * 2. 遵循不可变性原则，保证配置稳定性
+     */
+    getConfig(): ClientConfig;
+    /**
+     * 获取当前环境的 API 基础地址
+     * 为什么需要这个方法：
+     * 1. 用户可能需要知道当前使用的 API 地址用于调试
+     * 2. 某些场景可能需要直接使用基础地址构造 URL
+     * 3. 支持自定义服务器地址的覆盖逻辑
+     */
+    getBaseUrl(): string;
+    /**
+     * 动态切换环境
+     * 为什么允许运行时切换环境：
+     * 1. 开发调试时可能需要在不同环境间切换
+     * 2. 某些应用场景需要动态环境选择
+     * 注意：这不会影响已缓存的模型实例
+     */
+    setEnvironment(env: Environment): void;
+    /**
+     * 获取当前环境
+     * 为什么提供这个方法：用户可能需要根据当前环境执行不同的逻辑
+     */
+    getEnvironment(): Environment;
+}

package/dist/src/client/index.d.ts

@@ -0,0 +1,21 @@
+import type { ClientConfig, ModelsConfig } from "../types";
+import { LovrabetClient } from "./client";
+/**
+ * 创建 Lovrabet 客户端实例 - SDK 的主要入口函数
+ *
+ * 设计理念：
+ * 1. 多重载设计 - 支持 4 种不同的调用方式，满足各种使用场景
+ * 2. 智能类型推断 - 根据参数类型自动选择不同的处理逻辑
+ * 3. 配置优先级 - 明确的配置合并和覆盖规则
+ * 4. 错误优先 - 在客户端创建阶段就发现配置问题
+ *
+ * @param config - 客户端配置，支持以下类型：
+ *   - string: 注册的配置名称（如 'default', 'prod'）
+ *   - ModelsConfig: 纯模型配置对象
+ *   - ClientConfig: 完整的客户端配置对象
+ *   - ClientConfig & {apiConfigName}: 引用注册配置 + 额外选项
+ * @returns Lovrabet client instance
+ */
+export declare function createClient(config?: Partial<ClientConfig> | ModelsConfig | string): LovrabetClient;
+export { LovrabetClient };
+export type { ClientConfig } from "../types";

package/dist/src/config/constants.d.ts

@@ -0,0 +1,75 @@
+/**
+ * SDK 配置常量定义
+ * 统一管理 SDK 中使用的各种常量值
+ */
+/**
+ * 默认配置名称常量
+ */
+export declare const CONFIG_NAMES: {
+    /** 默认配置名称 */
+    readonly DEFAULT: "default";
+    /** 生产环境配置 */
+    readonly PROD: "prod";
+    /** 开发环境配置 */
+    readonly DEV: "dev";
+    /** 测试环境配置 */
+    readonly TEST: "test";
+};
+/**
+ * 环境常量
+ */
+export declare const ENVIRONMENTS: {
+    /** 线上环境 */
+    readonly ONLINE: "online";
+    /** 日常环境 */
+    readonly DAILY: "daily";
+};
+/**
+ * HTTP 状态码常量
+ */
+export declare const HTTP_STATUS: {
+    readonly OK: 200;
+    readonly UNAUTHORIZED: 401;
+    readonly FORBIDDEN: 403;
+    readonly NOT_FOUND: 404;
+    readonly INTERNAL_ERROR: 500;
+};
+/**
+ * 默认配置值
+ */
+export declare const DEFAULTS: {
+    /** 默认环境 */
+    readonly ENV: "online";
+    /** 默认超时时间（毫秒） */
+    readonly TIMEOUT: 30000;
+    /** 默认重试次数 */
+    readonly RETRY_COUNT: 3;
+    /** 默认页大小 */
+    readonly PAGE_SIZE: 20;
+    /** 默认当前页 */
+    readonly CURRENT_PAGE: 1;
+};
+/**
+ * 错误消息常量
+ */
+export declare const ERROR_MESSAGES: {
+    readonly APP_CODE_REQUIRED: "appCode is required. Please provide it in the config or register models first.";
+    readonly CONFIG_NOT_FOUND: (name: string) => string;
+    readonly INVALID_ENV: "Invalid environment. Must be \"online\" or \"daily\".";
+    readonly NETWORK_ERROR: "Network request failed";
+    readonly UNAUTHORIZED: "Unauthorized access";
+    readonly FORBIDDEN: "Access forbidden";
+    readonly NOT_FOUND: "Resource not found";
+    readonly SERVER_ERROR: "Internal server error";
+};
+/**
+ * API 路径模板
+ */
+export declare const API_PATHS: {
+    /** 基础 API 路径模板 */
+    readonly BASE: "/api/{appCode}/{datasetId}";
+    /** 列表查询路径 */
+    readonly LIST: "";
+    /** 单条记录路径 */
+    readonly DETAIL: "/{id}";
+};

package/dist/src/config/endpoints.d.ts

@@ -0,0 +1,16 @@
+export declare const API_ENDPOINTS: {
+    readonly online: "https://runtime.lovrabet.com";
+    readonly daily: "https://daily-runtime.lovrabet.com";
+};
+export type Environment = keyof typeof API_ENDPOINTS;
+/**
+ * 获取指定环境的 API 端点
+ * @param env - 环境名称
+ * @returns API 端点 URL
+ */
+export declare function getApiEndpoint(env: Environment): string;
+/**
+ * 获取所有可用的环境
+ * @returns 环境列表
+ */
+export declare function getAvailableEnvironments(): Environment[];

package/dist/src/config/model-registry.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 模型配置注册器 - 全局配置管理中心
+ *
+ * 设计目的：
+ * 1. 配置复用 - 避免在多处重复定义相同的模型配置
+ * 2. 多项目支持 - 在同一应用中管理多个项目的配置
+ * 3. 简化 API - 让 createClient() 可以无参数调用
+ * 4. 类型安全 - 通过命名常量避免字符串拼写错误
+ */
+import type { ModelsConfig } from "../types";
+/**
+ * 注册模型配置
+ *
+ * 为什么需要这个函数：
+ * 1. CLI 自动生成 - CLI 工具会调用此函数自动注册配置
+ * 2. 手动配置场景 - 用户可以手动注册多个环境或项目的配置
+ * 3. 配置集中管理 - 统一的地方管理所有模型配置
+ *
+ * @param config 模型配置对象
+ * @param name 配置名称，默认为 'default'
+ */
+export declare function registerModels(config: ModelsConfig, name?: string): void;
+/**
+ * 获取已注册的模型配置
+ * @param name 配置名称
+ * @returns 模型配置对象
+ */
+export declare function getRegisteredModels(name: string): ModelsConfig | undefined;
+/**
+ * 获取所有已注册的配置名称
+ * @returns 配置名称数组
+ */
+export declare function getRegisteredConfigNames(): string[];
+/**
+ * 清除指定配置
+ * @param name 配置名称
+ */
+export declare function unregisterModels(name: string): boolean;
+/**
+ * 清除所有配置
+ */
+export declare function clearAllRegistrations(): void;

package/dist/src/http/cookie.d.ts

@@ -0,0 +1,2 @@
+export declare function initCookie(cookie: string): void;
+export declare function getCookie(): string;

package/dist/src/http/get.d.ts

@@ -0,0 +1 @@
+export declare const get: <ResponseData>(url: string, params?: Record<string, any>, init?: RequestInit) => Promise<ResponseData>;

package/dist/src/http/http-client.d.ts

@@ -0,0 +1,26 @@
+import type { ClientConfig, AuthManager } from "../types";
+export declare class HttpClient {
+    private config;
+    private authManager;
+    private errorHandler;
+    constructor(config: ClientConfig, authManager: AuthManager);
+    private getBaseUrl;
+    private getFullUrl;
+    /**
+     * 准备请求的通用逻辑：认证头、Cookie配置等
+     */
+    private prepareRequestInit;
+    /**
+     * 通用的错误处理包装器
+     */
+    private executeWithErrorHandling;
+    /**
+     * 通用的fetch请求方法（用于PUT/DELETE等没有专门优化函数的方法）
+     */
+    private makeRequest;
+    get<T = any>(url: string, params?: Record<string, any>, options?: RequestInit): Promise<T>;
+    post<T = any>(url: string, data?: any, options?: RequestInit): Promise<T>;
+    put<T = any>(url: string, data?: any, options?: RequestInit): Promise<T>;
+    delete<T = any>(url: string, options?: RequestInit): Promise<T>;
+    request<T = any>(method: "GET" | "POST" | "PUT" | "DELETE", url: string, data?: any, options?: RequestInit): Promise<T>;
+}

package/dist/src/http/post.d.ts

@@ -0,0 +1 @@
+export declare const post: <ResponseData>(url: string, body?: Record<string, any>, init?: RequestInit) => Promise<ResponseData>;

package/dist/src/http/process-response.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 处理请求
+ */
+export declare const processResponse: <ResponseData>(response: Response) => Promise<ResponseData>;

package/dist/src/http/traceparent.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 生成新的 traceparent
+ * @param parentTraceparent
+ */
+export declare function generateTraceparent(): string;

package/dist/src/models/base-model.d.ts

@@ -0,0 +1,18 @@
+import type { BaseModelMethods, ListParams, ListResponse, ClientConfig, ModelConfig } from "../types";
+import type { HttpClient } from "../http/http-client";
+export declare class BaseModel implements BaseModelMethods {
+    private modelName;
+    private httpClient;
+    private config;
+    private appCode;
+    constructor(modelName: string, httpClient: HttpClient, globalConfig: ClientConfig);
+    private resolveModelConfig;
+    private getApiPath;
+    getList<T = any>(params?: ListParams): Promise<ListResponse<T>>;
+    getOne<T = any>(id: string | number): Promise<T>;
+    create<T = any>(data: Record<string, any>): Promise<T>;
+    update<T = any>(id: string | number, data: Record<string, any>): Promise<T>;
+    delete(id: string | number): Promise<void>;
+    getConfig(): ModelConfig;
+    getModelName(): string;
+}

package/dist/src/models/model-manager.d.ts

@@ -0,0 +1,15 @@
+import type { ModelManager as IModelManager, ClientConfig } from "../types";
+import type { HttpClient } from "../http/http-client";
+export declare class ModelManager implements IModelManager {
+    private httpClient;
+    private config;
+    private modelCache;
+    constructor(httpClient: HttpClient, config: ClientConfig);
+    private getModel;
+    getCachedModels(): string[];
+    clearCache(): void;
+    addModel(modelName: string, config: {
+        tableName: string;
+        datasetId: string;
+    }): void;
+}

package/dist/src/types/index.d.ts

@@ -0,0 +1,321 @@
+/**
+ * Lovrabet SDK 核心类型定义
+ *
+ * 本文件包含 SDK 的所有核心类型定义，包括：
+ * - 环境配置类型
+ * - 请求和响应类型
+ * - 模型配置类型
+ * - 客户端配置类型
+ * - 认证相关类型
+ */
+/**
+ * 环境类型定义
+ * @description 支持的运行环境，用于区分不同的 API 端点
+ */
+export type Environment = "online" | "daily";
+/**
+ * 列表查询参数接口
+ * @description 用于分页查询的通用参数接口
+ */
+export interface ListParams {
+    /** 当前页码，从 1 开始 */
+    currentPage?: number;
+    /** 每页数量 */
+    pageSize?: number;
+    /** 其他查询参数，支持任意字段 */
+    [key: string]: any;
+}
+/**
+ * 列表响应数据接口
+ * @template T 数据项的类型
+ * @description 分页查询的标准响应格式
+ */
+export interface ListResponse<T> {
+    /** 数据列表 */
+    tableData: T[];
+    /** 总数量 */
+    total: number;
+    /** 当前页码 */
+    currentPage: number;
+    /** 每页数量 */
+    pageSize: number;
+}
+/**
+ * 单个模型配置接口
+ * @description 定义数据模型的基本配置信息
+ */
+export interface ModelConfig {
+    /** 数据表名称 */
+    tableName: string;
+    /** 数据集 ID */
+    datasetId: string;
+}
+/**
+ * 模型配置集合接口
+ * @description 包含应用代码和所有模型配置的集合
+ * @example
+ * ```typescript
+ * const config: ModelsConfig = {
+ *   appCode: 'my-app',
+ *   models: {
+ *     Users: { tableName: 'users', datasetId: 'user-dataset-id' },
+ *     Posts: { tableName: 'posts', datasetId: 'post-dataset-id' }
+ *   }
+ * };
+ * ```
+ */
+export interface ModelsConfig {
+    /** 应用代码，用于标识不同的应用 */
+    appCode: string;
+    /** 模型配置映射，键为模型名称，值为模型配置 */
+    models: Record<string, ModelConfig>;
+}
+/**
+ * 客户端配置接口
+ * @description Lovrabet 客户端的完整配置选项
+ * @example
+ * ```typescript
+ * // 基本配置
+ * const config: ClientConfig = {
+ *   appCode: 'my-app',
+ *   env: 'online',
+ *   token: 'your-token'
+ * };
+ *
+ * // 引用预注册配置
+ * const config: ClientConfig = {
+ *   apiConfigName: 'prod',
+ *   token: 'override-token'
+ * };
+ * ```
+ */
+export interface ClientConfig {
+    /** 应用代码，用于标识不同的应用 */
+    appCode?: string;
+    /** 自定义服务器 URL，可选 */
+    serverUrl?: string;
+    /** 运行环境，默认为 'online' */
+    env?: Environment;
+    /** 用户 Token，用于 Bearer 认证 */
+    token?: string;
+    /** API 访问密钥，用于签名认证 */
+    accessKey?: string;
+    /** API 密钥，用于签名认证 */
+    secretKey?: string;
+    /** 是否需要认证，默认为 true */
+    requiresAuth?: boolean;
+    /** 模型配置映射，直接传入的模型配置 */
+    models?: Record<string, ModelConfig>;
+    /**
+     * 引用已注册的 API 配置名称
+     * @description 当指定此字段时，会从配置注册表中获取对应的模型配置
+     * @example 'default', 'prod', 'dev'
+     */
+    apiConfigName?: string;
+    /** 额外配置选项 */
+    options?: {
+        /** 请求超时时间（毫秒） */
+        timeout?: number;
+        /** 重试次数 */
+        retryCount?: number;
+        /** 错误处理回调函数 */
+        onError?: (error: any) => void;
+        /** 需要重新登录时的回调函数 */
+        onRedirectToLogin?: () => void;
+    };
+}
+/**
+ * 基础模型方法接口
+ * @description 定义所有模型实例的标准 CRUD 操作方法
+ * @template T 数据类型，默认为 any
+ * @example
+ * ```typescript
+ * // 使用示例
+ * const users: BaseModelMethods = client.models.Users;
+ * const userList = await users.getList({ currentPage: 1, pageSize: 10 });
+ * const user = await users.getOne('123');
+ * const newUser = await users.create({ name: 'John', email: 'john@example.com' });
+ * ```
+ */
+export interface BaseModelMethods {
+    /**
+     * 获取数据列表
+     * @template T 返回数据的类型
+     * @param params 查询参数，包含分页等信息
+     * @returns 返回分页数据
+     */
+    getList<T = any>(params?: ListParams): Promise<ListResponse<T>>;
+    /**
+     * 获取单条数据
+     * @template T 返回数据的类型
+     * @param id 数据 ID，支持字符串或数字类型
+     * @returns 返回单条数据
+     */
+    getOne<T = any>(id: string | number): Promise<T>;
+    /**
+     * 创建新数据
+     * @template T 返回数据的类型
+     * @param data 要创建的数据对象
+     * @returns 返回创建后的数据
+     */
+    create<T = any>(data: Record<string, any>): Promise<T>;
+    /**
+     * 更新数据
+     * @template T 返回数据的类型
+     * @param id 要更新的数据 ID
+     * @param data 要更新的数据对象
+     * @returns 返回更新后的数据
+     */
+    update<T = any>(id: string | number, data: Record<string, any>): Promise<T>;
+    /**
+     * 删除数据
+     * @param id 要删除的数据 ID
+     * @returns Promise<void>
+     */
+    delete(id: string | number): Promise<void>;
+}
+/**
+ * 模型管理器接口
+ * @description 通过 Proxy 实现的动态模型访问管理器
+ * @example
+ * ```typescript
+ * // 动态访问模型
+ * client.models.Users.getList();  // 自动创建 Users 模型实例
+ * client.models.Posts.getOne(1);  // 自动创建 Posts 模型实例
+ *
+ * // 管理方法
+ * client.models.getCachedModels(); // 获取已缓存的模型列表
+ * client.models.clearCache();      // 清除所有模型缓存
+ * ```
+ */
+export interface ModelManager {
+    /** 动态模型访问，支持任意模型名称 */
+    [modelName: string]: BaseModelMethods | any;
+    /**
+     * 获取已缓存的模型列表
+     * @returns 返回已创建并缓存的模型名称数组
+     */
+    getCachedModels(): string[];
+    /**
+     * 清除所有模型缓存
+     * @description 清除后下次访问模型时会重新创建实例
+     */
+    clearCache(): void;
+    /**
+     * 动态添加模型配置
+     * @param modelName 模型名称
+     * @param config 模型配置信息
+     */
+    addModel(modelName: string, config: {
+        tableName: string;
+        datasetId: string;
+    }): void;
+}
+/**
+ * 认证请求头接口
+ * @description 包含认证信息的 HTTP 请求头
+ * @example
+ * ```typescript
+ * // Bearer Token 认证
+ * { "Authorization": "Bearer your-token" }
+ *
+ * // API 密钥认证
+ * { "X-Access-Key": "your-key", "X-Signature": "calculated-signature" }
+ * ```
+ */
+export interface AuthHeaders {
+    /** 请求头键值对 */
+    [key: string]: string;
+}
+/**
+ * 用户 Token 认证配置
+ * @description 用于 Bearer Token 认证方式
+ */
+export interface UserAuthConfig {
+    /** 用户认证 Token */
+    token: string;
+}
+/**
+ * OpenAPI 密钥认证配置
+ * @description 用于签名认证方式
+ */
+export interface OpenApiAuthConfig {
+    /** API 访问密钥 */
+    accessKey: string;
+    /** API 密钥，用于计算签名 */
+    secretKey: string;
+}
+/**
+ * 认证管理器接口
+ * @description 统一管理不同的认证方式，按优先级自动选择认证策略
+ * 认证优先级：Token > OpenAPI密钥 > Cookie
+ * @example
+ * ```typescript
+ * // 设置 Token 认证
+ * authManager.setToken('your-token');
+ *
+ * // 获取认证头
+ * const headers = await authManager.getAuthHeaders();
+ * // 返回: { "Authorization": "Bearer your-token" }
+ * ```
+ */
+export interface AuthManager {
+    /**
+     * 获取认证请求头
+     * @description 根据当前配置的认证方式生成对应的请求头
+     * @returns 包含认证信息的请求头对象
+     */
+    getAuthHeaders(): Promise<AuthHeaders>;
+    /**
+     * 验证当前认证是否有效
+     * @returns 认证是否有效
+     */
+    validateAuth(): Promise<boolean>;
+    /**
+     * 设置用户 Token
+     * @param token 用户认证 Token
+     */
+    setToken(token: string): void;
+    /**
+     * 检查是否使用 Cookie 认证
+     * @description 当没有 Token 和 API 密钥时，会降级到 Cookie 认证
+     * @returns 是否使用 Cookie 认证
+     */
+    isCookieAuth(): boolean;
+}
+/**
+ * Lovrabet 客户端接口
+ * @description SDK 的主要客户端接口，提供模型访问和配置管理功能
+ * @example
+ * ```typescript
+ * // 创建客户端
+ * const client = createClient();
+ *
+ * // 使用模型
+ * const users = await client.models.Users.getList();
+ *
+ * // 设置认证
+ * client.setToken('new-token');
+ *
+ * // 获取配置
+ * const config = client.getConfig();
+ * ```
+ */
+export interface LovrabetClient {
+    /**
+     * 模型管理器
+     * @description 通过此属性可以访问所有已配置的数据模型
+     */
+    models: ModelManager;
+    /**
+     * 设置用户认证 Token
+     * @param token 用户认证 Token
+     * @description 设置后所有 API 请求将使用此 Token 进行认证
+     */
+    setToken(token: string): void;
+    /**
+     * 获取客户端配置
+     * @returns 当前客户端的完整配置信息
+     */
+    getConfig(): ClientConfig;
+}

package/dist/src/utils/errors.d.ts

@@ -0,0 +1,15 @@
+export declare class LovrabetError extends Error {
+    readonly status?: number;
+    readonly code?: string;
+    readonly data?: any;
+    readonly originalError?: Error;
+    constructor(message: string, status?: number, code?: string, data?: any, originalError?: Error);
+    toJSON(): {
+        name: string;
+        message: string;
+        status: number;
+        code: string;
+        data: any;
+    };
+}
+export declare function createErrorHandler(onError?: (error: any) => void): (error: any) => Promise<never>;

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@lovrabet/sdk",
+  "version": "1.0.0",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "type": "module",
+  "scripts": {
+    "build": "rm -rf dist && bun build index.ts --outdir=dist --target=browser --format=esm && javascript-obfuscator dist --output dist && npm run types",
+    "types": "npx tsc --emitDeclarationOnly --declaration --outDir dist index.ts",
+    "release": "bun run build && bun pm version patch && git push && git push origin --tag && bun publish"
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@types/bun": "latest",
+    "javascript-obfuscator": "^4.1.1"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  }
+}