@lovrabet/sdk 1.4.2 → 1.4.3-beta.1

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

@@ -6,6 +6,7 @@ import { ClientAkSqlClient } from '../api/client-ak-sql-client';
 import { BffClient } from '../api/bff-client';
 import { ClientAkBffClient } from '../api/client-ak-bff-client';
 import { UserClient } from '../api/user-client';
+import { ServicesNamespace } from '../services';
 /**
  * Lovrabet SDK 核心客户端类
  *
@@ -45,6 +46,10 @@ export declare class LovrabetClient implements ILovrabetClient {
      * User 客户端 - 用户信息相关 API
      */
     readonly user: UserClient;
+    /**
+     * 平台服务命名空间 - OCR 等不绑定数据集或 BFF 的通用运行态能力
+     */
+    readonly services: ServicesNamespace;
     /**
      * API 命名空间 - 别名入口（向后兼容）
      *

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

@@ -26,6 +26,7 @@ export declare class HttpClient {
     private makeRequest;
     get<T = any>(url: string, params?: Record<string, any>, options?: RequestInit, datasetCode?: string): Promise<T>;
     post<T = any>(url: string, data?: any, options?: RequestInit, datasetCode?: string): Promise<T>;
+    postForm<T = any>(url: string, data: FormData, options?: RequestInit): Promise<T>;
     put<T = any>(url: string, data?: any, options?: RequestInit, datasetCode?: string): Promise<T>;
     delete<T = any>(url: string, options?: RequestInit, datasetCode?: string): Promise<T>;
     request<T = any>(method: 'GET' | 'POST' | 'PUT' | 'DELETE', url: string, data?: any, options?: RequestInit, datasetCode?: string): Promise<T>;

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

@@ -1 +1,2 @@
 export { HttpClient } from "./http-client";
+export { postForm } from "./post-form";

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

@@ -0,0 +1,2 @@
+/** Send multipart form data without overriding the browser-generated boundary. */
+export declare function postForm<ResponseData>(url: string, body: FormData, init?: RequestInit, debug?: boolean): Promise<ResponseData>;

package/dist/src/services/file-client.d.ts

@@ -0,0 +1,13 @@
+import type { HttpClient } from "../http/http-client";
+import type { AuthMode } from "../types";
+import type { FileQueryUrlRequest, FileService, FileUploadRequest, FileUploadResponse, FileUrlResponse } from "./types";
+/** Runtime file upload and URL service. */
+export declare class FileClient implements FileService {
+    private readonly httpClient;
+    private readonly appCode;
+    private readonly authMode;
+    constructor(httpClient: HttpClient, appCode: string, authMode: AuthMode);
+    upload(request: FileUploadRequest): Promise<FileUploadResponse>;
+    queryUrl(request: FileQueryUrlRequest): Promise<FileUrlResponse>;
+    private assertSupportedAuthMode;
+}

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

@@ -0,0 +1,15 @@
+import type { HttpClient } from "../http/http-client";
+import type { AuthMode } from "../types";
+import { OcrClient } from "./ocr-client";
+import { FileClient } from "./file-client";
+import type { LovrabetServices } from "./types";
+/** Namespace for runtime services. */
+export declare class ServicesNamespace implements LovrabetServices {
+    readonly ocr: OcrClient;
+    readonly file: FileClient;
+    constructor(httpClient: HttpClient, appCode: string, authMode: AuthMode);
+}
+export { OcrClient } from "./ocr-client";
+export { FileClient } from "./file-client";
+export { OCR_TYPES, OcrType } from "./types";
+export type { LovrabetServices, OcrRecognizeRequest, OcrRecognizeResponse, OcrService, FileQueryUrlRequest, FileService, FileUploadRequest, FileUploadResponse, FileUrlResponse, ServiceRequestOptions, } from "./types";

package/dist/src/services/ocr-client.d.ts

@@ -0,0 +1,17 @@
+import type { HttpClient } from "../http/http-client";
+import type { AuthMode } from "../types";
+import { type OcrRecognizeRequest, type OcrRecognizeResponse, type OcrService } from "./types";
+/**
+ * Runtime OCR service.
+ *
+ * The public method is stable while the transport follows the configured auth mode:
+ * - cookie: GET /api/ocr/recognize-text
+ * - client-ak: POST /client/ocr
+ */
+export declare class OcrClient implements OcrService {
+    private readonly httpClient;
+    private readonly appCode;
+    private readonly authMode;
+    constructor(httpClient: HttpClient, appCode: string, authMode: AuthMode);
+    recognize(request: OcrRecognizeRequest): Promise<OcrRecognizeResponse>;
+}

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

@@ -0,0 +1,98 @@
+/** Per-request options supported by runtime service clients. */
+export type ServiceRequestOptions = Omit<RequestInit, "method" | "body">;
+/**
+ * OCR recognition types supported by the runtime service.
+ *
+ * This is a runtime value as well as the source of the `OcrType` type, so
+ * JavaScript and TypeScript callers can both avoid handwritten strings.
+ */
+export declare const OcrType: Readonly<{
+    readonly General: "General";
+    readonly Invoice: "Invoice";
+    readonly Advanced: "Advanced";
+    readonly AdvancedCoordinate: "AdvancedCoordinate";
+    readonly AdvancedGeneral: "AdvancedGeneral";
+    readonly IdCard: "IdCard";
+    readonly BankCard: "BankCard";
+    readonly BusinessLicense: "BusinessLicense";
+    readonly DrivingLicense: "DrivingLicense";
+    readonly CarNumber: "CarNumber";
+    readonly Table: "Table";
+}>;
+export type OcrType = (typeof OcrType)[keyof typeof OcrType];
+/** Read-only OCR type list for selects, discovery, and schema generation. */
+export declare const OCR_TYPES: readonly OcrType[];
+/** Input accepted by the public OCR service. */
+export interface OcrRecognizeRequest {
+    /** Publicly accessible image or file URL. */
+    url: string;
+    /** Runtime OCR recognition type. */
+    type: OcrType;
+    /** Optional fetch settings. The HTTP method and body are controlled by the SDK. */
+    options?: ServiceRequestOptions;
+}
+/** OCR result returned by both the WebAPI and Client API routes. */
+export interface OcrRecognizeResponse {
+    requestId?: string;
+    type?: OcrType;
+    text?: string;
+    lines?: string[];
+    kvData?: Record<string, string>;
+    width?: number;
+    height?: number;
+    pageNo?: number | null;
+    subImageCount?: number | null;
+    algoVersion?: string | null;
+    kvExcelUrl?: string | null;
+    xmlResult?: string | null;
+    rawData?: string | null;
+    [key: string]: unknown;
+}
+export interface OcrService {
+    recognize(request: OcrRecognizeRequest): Promise<OcrRecognizeResponse>;
+}
+/** Input accepted by the runtime file upload service. */
+export interface FileUploadRequest {
+    /** Browser File or a standards-compatible Blob. */
+    file: Blob;
+    /** Optional filename for Blob inputs. File.name is used when available. */
+    fileName?: string;
+    options?: ServiceRequestOptions;
+}
+export interface FileUploadResponse {
+    fileName?: string | null;
+    filePath?: string | null;
+    fileUrl?: string | null;
+    downloadFlag?: boolean;
+    fileType?: string | null;
+    size?: number | null;
+    sourceDir?: string | null;
+    [key: string]: unknown;
+}
+export interface FileQueryUrlRequest {
+    /** Durable filePath returned by upload. */
+    filePath: string;
+    /** Request a download URL instead of a preview URL. */
+    download?: boolean;
+    /** Request a long-term URL for URL-only content embedding. */
+    longTerm?: boolean;
+    options?: ServiceRequestOptions;
+}
+export interface FileUrlResponse {
+    fileName?: string | null;
+    filePath?: string | null;
+    fileUrl?: string | null;
+    downloadFlag?: boolean;
+    longTerm?: boolean;
+    expiresInDays?: number | null;
+    [key: string]: unknown;
+}
+export interface FileService {
+    upload(request: FileUploadRequest): Promise<FileUploadResponse>;
+    queryUrl(request: FileQueryUrlRequest): Promise<FileUrlResponse>;
+}
+/** Runtime services exposed under `client.services`. */
+export interface LovrabetServices {
+    readonly ocr: OcrService;
+    readonly file: FileService;
+}

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

@@ -830,6 +830,8 @@ export interface AuthManager {
  * ```
  */
 export interface LovrabetClient {
+    /** 运行态通用服务，如文件与 OCR。 */
+    readonly services: import("../services/types").LovrabetServices;
     /**
      * 模型访问接口 - 纯粹的语法糖，支持 client.models.ModelName 访问
      * @description 内部调用 client.getModel() 方法，提供更简洁的访问方式

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lovrabet/sdk",
-  "version": "1.4.2",
+  "version": "1.4.3-beta.1",
   "license": "SEE LICENSE IN LICENSE",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -29,6 +29,13 @@
     "test:cookie:quick": "bun run scripts/test-cookie-quick.ts",
     "test:cookie:full": "bun run scripts/test-cookie-full.ts",
     "types": "npx tsc --emitDeclarationOnly --declaration --outDir dist index.ts",
+    "test:unit": "vitest run test/unit",
+    "test:integration": "vitest run test/integration",
+    "test:e2e": "RUN_E2E_TESTS=true vitest run test/e2e",
+    "typecheck": "tsc --noEmit --skipLibCheck index.ts src/**/*.ts",
+    "typecheck:e2e": "tsc -p tsconfig.e2e.json",
+    "lint": "eslint . --ext .ts",
+    "ci": "npm run lint && npm run typecheck && npm run typecheck:e2e && npm run test:unit && npm run test:integration && npm run test:coverage && npm run build:dev",
     "beta-release": "bun run build && sh scripts/update-beta-version.sh && git push && git push origin --tag && bun publish --tag beta",
     "release": "bun run build && sh scripts/update-latest-version.sh && git push && git push origin --tag && bun publish"
   },
@@ -41,10 +48,13 @@
     "@vitest/ui": "^2.1.8",
     "c8": "^10.1.2",
     "chokidar-cli": "^3.0.0",
+    "eslint": "^9.0.0",
+    "@eslint/js": "^9.0.0",
+    "typescript-eslint": "^8.0.0",
     "javascript-obfuscator": "^4.1.1",
     "vitest": "^2.1.8"
   },
   "peerDependencies": {
     "typescript": "^5"
   }
-}
+}