@lovrabet/sdk 1.1.18 → 1.1.19

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

@@ -0,0 +1,51 @@
+import type { HttpClient } from '../http/http-client';
+import type { SqlExecuteResult } from './types';
+/**
+ * API 命名空间 - 管理通用 API 调用（SQL、Function 等）
+ *
+ * 设计原则：
+ * 1. 依赖注入 - 通过构造函数注入 HttpClient
+ * 2. 类型安全 - 支持泛型，提供 TypeScript 类型推断
+ * 3. 统一错误处理 - 成功返回数据，失败抛出 LovrabetError
+ * 4. 风格一致 - 与 Model 的 getList/getOne 保持一致
+ */
+export declare class ApiNamespace {
+    private httpClient;
+    constructor(httpClient: HttpClient);
+    /**
+     * 执行自定义 SQL 查询
+     *
+     * @param sqlCode SQL代码（字符串格式 "appCode-sqlId" 或数字ID）
+     * @param params SQL参数对象（可选）
+     * @returns SQL执行结果（包含 execSuccess 和 execResult）
+     *
+     * @example
+     * ```typescript
+     * // 无参数查询
+     * const data = await client.api.executeSql('fc8e7777-06e3847d');
+     * if (data.execSuccess) {
+     *   const results = data.execResult;
+     *   results.forEach(item => console.log(item));
+     * }
+     *
+     * // 参数化查询
+     * const data = await client.api.executeSql('fc8e7777-xxxxx', {
+     *   userId: '123',
+     *   startDate: '2025-01-01'
+     * });
+     *
+     * // 带类型提示
+     * interface PageStat {
+     *   creation_date: string;
+     *   page_count: number;
+     * }
+     * const data = await client.api.executeSql<PageStat>('fc8e7777-06e3847d');
+     * if (data.execSuccess && data.execResult) {
+     *   data.execResult.forEach(stat => {
+     *     console.log(stat.creation_date, stat.page_count);
+     *   });
+     * }
+     * ```
+     */
+    executeSql<T = Record<string, any>>(sqlCode: string | number, params?: Record<string, string | number>): Promise<SqlExecuteResult<T>>;
+}

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

@@ -0,0 +1,18 @@
+/**
+ * SQL 执行请求参数
+ */
+export interface SqlExecuteRequest {
+    /** SQL 代码（字符串格式 "appCode-sqlId" 或数字 ID） */
+    sqlCode: string | number;
+    /** SQL 参数对象（可选） */
+    params?: Record<string, string | number>;
+}
+/**
+ * SQL 执行结果数据
+ */
+export interface SqlExecuteResult<T = Record<string, any>> {
+    /** SQL 执行是否成功 */
+    execSuccess: boolean;
+    /** SQL 查询结果数组 */
+    execResult?: T[];
+}

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

@@ -1,4 +1,5 @@
 import type { ClientConfig, LovrabetClient as ILovrabetClient, Environment } from '../types';
+import { ApiNamespace } from '../api';
 /**
  * Lovrabet SDK 核心客户端类
  *
@@ -21,6 +22,10 @@ export declare class LovrabetClient implements ILovrabetClient {
      * 内部调用 client.getModel() 方法，避免命名冲突
      */
     models: any;
+    /**
+     * API 命名空间 - 提供通用 API 调用（SQL、Function 等）
+     */
+    readonly api: ApiNamespace;
     constructor(config: ClientConfig);
     private validateConfig;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lovrabet/sdk",
-  "version": "1.1.18",
+  "version": "1.1.19",
   "license": "SEE LICENSE IN LICENSE",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -20,14 +20,14 @@
     "start": "npm run watch",
     "watch": "npm run build:dev && npm run watch:files",
     "watch:files": "chokidar \"src/**/*.ts\" \"index.ts\" -c \"npm run build:dev\"",
-    "test": "vitest",
+    "test": "vitest run",
     "test:run": "vitest run",
     "test:ui": "vitest --ui",
     "test:coverage": "vitest run --coverage",
     "test:watch": "vitest watch",
     "types": "npx tsc --emitDeclarationOnly --declaration --outDir dist index.ts",
     "beta-release": "bun run build && sh scripts/update-beta-version.sh && git push && git push origin --tag && bun publish",
-    "release": "bun run build && bun pm version patch && git push && git push origin --tag && bun publish"
+    "release": "bun run build && sh scripts/update-latest-version.sh && git push && git push origin --tag && bun publish"
   },
   "files": [
     "dist"