@lovrabet/sdk 1.1.14 → 1.1.16

package/README.md

@@ -72,7 +72,7 @@ export async function GET() {
 import { createClient } from "@lovrabet/sdk";
 
 // 获取 token
-const { token, timestamp } = await fetch('/api/token').then(r => r.json());
+const { token, timestamp } = await fetch("/api/token").then((r) => r.json());
 
 // 创建客户端
 const client = createClient({
@@ -124,8 +124,8 @@ const result = await generateOpenApiToken({
   accessKey: process.env.LOVRABET_ACCESS_KEY!,
 });
 
-console.log(result.token);      // 生成的 token
-console.log(result.timestamp);  // 时间戳
+console.log(result.token); // 生成的 token
+console.log(result.timestamp); // 时间戳
 console.log(result.expiresAt); // 过期时间
 ```
 
@@ -195,15 +195,25 @@ const users = await client.models.users.getList();
 import { registerModels, createClient } from "@lovrabet/sdk";
 
 // 注册不同环境的配置
-registerModels({
-  appCode: "prod-app",
-  models: { /* ... */ },
-}, "prod");
-
-registerModels({
-  appCode: "dev-app",
-  models: { /* ... */ },
-}, "dev");
+registerModels(
+  {
+    appCode: "prod-app",
+    models: {
+      /* ... */
+    },
+  },
+  "prod"
+);
+
+registerModels(
+  {
+    appCode: "dev-app",
+    models: {
+      /* ... */
+    },
+  },
+  "dev"
+);
 
 // 创建不同环境的客户端
 const prodClient = createClient("prod");
@@ -216,7 +226,9 @@ const devClient = createClient("dev");
 // 创建客户端
 const client = createClient({
   appCode: "your-app-code",
-  models: { /* ... */ },
+  models: {
+    /* ... */
+  },
 });
 
 // 后续更新 token
@@ -260,6 +272,10 @@ import {
   type TokenResult,
   type ListResponse,
   type ListParams,
+  type SortList,
+
+  // 枚举
+  SortOrder,
 } from "@lovrabet/sdk";
 ```
 
@@ -267,13 +283,13 @@ import {
 
 ```typescript
 interface ClientConfig {
-  appCode?: string;           // 应用代码
-  accessKey?: string;         // OpenAPI 密钥（服务端）
-  secretKey?: string;         // 密钥（可选）
-  token?: string;             // 预生成 token（浏览器）
-  timestamp?: number;         // token 时间戳
-  env?: 'online' | 'daily';  // 环境
-  models?: ModelsConfig;      // 模型配置
+  appCode?: string; // 应用代码
+  accessKey?: string; // OpenAPI 密钥（服务端）
+  secretKey?: string; // 密钥（可选）
+  token?: string; // 预生成 token（浏览器）
+  timestamp?: number; // token 时间戳
+  env?: "online" | "daily"; // 环境
+  models?: ModelsConfig; // 模型配置
 }
 ```
 
@@ -287,6 +303,17 @@ const response = await client.models.users.getList({
   // 其他查询参数
 });
 
+// 查询列表（带排序）
+import { SortOrder } from "@lovrabet/sdk";
+
+const sortedUsers = await client.models.users.getList(
+  { currentPage: 1, pageSize: 20 },
+  [
+    { createTime: SortOrder.DESC }, // 按创建时间降序
+    { name: SortOrder.ASC }, // 再按名称升序
+  ]
+);
+
 // 获取单条记录
 const user = await client.models.users.getOne("user-id");
 
@@ -331,17 +358,17 @@ const client = createClient({
 
 ```typescript
 // 使用服务端生成的 token
-const { token } = await fetch('/api/token').then(r => r.json());
+const { token } = await fetch("/api/token").then((r) => r.json());
 const client = createClient({ token });
 ```
 
 ## 🎯 选择正确的认证模式
 
-| 环境 | 认证方式 | 使用场景 |
-|------|---------|---------|
-| **Node.js 服务端** | `accessKey` | SSR、API 路由、后端服务 |
-| **浏览器（未登录）** | `token` | 公开数据访问、匿名用户 |
-| **浏览器（已登录）** | Cookie | 已认证用户、私有数据 |
+| 环境                 | 认证方式    | 使用场景                |
+| -------------------- | ----------- | ----------------------- |
+| **Node.js 服务端**   | `accessKey` | SSR、API 路由、后端服务 |
+| **浏览器（未登录）** | `token`     | 公开数据访问、匿名用户  |
+| **浏览器（已登录）** | Cookie      | 已认证用户、私有数据    |
 
 ## 📚 文档
 
@@ -353,11 +380,46 @@ const client = createClient({ token });
 
 ## 📝 What's New
 
+### v1.1.16 (2025-10-15)
+
+**新增功能 (New Features):**
+
+- ✨ **列表排序支持** - `getList` 方法现在支持多字段排序功能
+
+  ```typescript
+  import { SortOrder } from "@lovrabet/sdk";
+
+  // 单字段排序
+  const users = await client.models.users.getList(
+    { currentPage: 1, pageSize: 20 },
+    [{ createTime: SortOrder.DESC }]
+  );
+
+  // 多字段排序
+  const products = await client.models.products.getList(
+    { currentPage: 1, pageSize: 20 },
+    [
+      { priority: SortOrder.DESC }, // 优先级降序
+      { createTime: SortOrder.DESC }, // 创建时间降序
+      { name: SortOrder.ASC }, // 名称升序
+    ]
+  );
+  ```
+
+  - 使用简洁的 key-value 格式：`{ "字段名": SortOrder.ASC/DESC }`
+  - 支持多字段组合排序
+  - 同时支持 OpenAPI 和 WebAPI 两种模式
+  - 向后兼容，sortList 参数可选
+  - 导出 `SortOrder` 枚举和 `SortList` 类型供开发者使用
+
+---
+
 ### v1.1.14 (2025-10-11)
 
 **新增功能 (New Features):**
 
 - ✨ **OpenAPI Create/Update 支持** - OpenAPI 模式现已支持完整的 CRUD 操作
+
   ```typescript
   // 创建记录
   const newUser = await client.models.users.create({
@@ -370,6 +432,7 @@ const client = createClient({ token });
     name: "Jane Doe",
   });
   ```
+
   - 认证信息自动添加到请求头（X-Token、X-Time-Stamp）
   - 请求体只包含业务数据（`appCode`、`datasetCode`、`paramMap`）
   - 与查询接口保持一致的架构设计
@@ -401,6 +464,7 @@ const client = createClient({ token });
 **新增功能 (New Features):**
 
 - ✨ **后端 Token 生成器** - 新增 `generateOpenApiToken()` 函数，支持服务端生成 Token
+
   ```typescript
   import { generateOpenApiToken } from "@lovrabet/sdk";
 
@@ -427,7 +491,6 @@ const client = createClient({ token });
 
 ---
 
-
 ### v1.1.5 (2025-09-27)
 
 **重大变更 (Breaking Changes):**
@@ -441,7 +504,6 @@ const client = createClient({ token });
 
 ---
 
-
 ## 🤝 反馈
 
 如遇到问题或有功能建议，欢迎提交 Issue！
@@ -451,6 +513,7 @@ const client = createClient({ token });
 **专有软件（Proprietary）** - 详见 [LICENSE](./LICENSE) 文件
 
 本 SDK 为 Lovrabet 开放平台的专有组件：
+
 - ✅ **允许使用** - 可以安装并在项目中集成本 SDK
 - ✅ **应用分发** - 可以分发包含本 SDK 的应用程序
 - ✅ **商业使用** - 可用于个人和商业项目
@@ -458,4 +521,4 @@ const client = createClient({ token });
 - ❌ **不得单独分发** - 不得单独复制或分发本 SDK
 - ❌ **源代码不公开** - 本 SDK 为闭源软件
 
-如需商业授权或有疑问，请访问 [lovrabet.com](https://www.lovrabet.com)
+如需商业授权或有疑问，请访问 [lovrabet.com](https://www.lovrabet.com)

package/dist/index.d.ts

@@ -7,4 +7,5 @@ export { AbstractBaseModel, OpenApiModel, WebApiModel, ModelFactory, } from "./s
 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, } from "./src/types/index";
-export type { ListParams, ListResponse, Environment, BaseModelMethods, } from "./src/types/index";
+export type { ListParams, ListResponse, Environment, BaseModelMethods, SortList, } from "./src/types/index";
+export { SortOrder, } from "./src/types/index";