ots-client 0.0.1

package/dist/init/index.d.ts

@@ -0,0 +1,3 @@
+import { SchemaMeta } from '../types';
+import * as TableStore from 'tablestore';
+export declare function initTables(client: TableStore.Client, schemaMeta: SchemaMeta): Promise<void>;

package/dist/types/client.d.ts

@@ -0,0 +1,35 @@
+export interface PageResult<T = any> {
+    data: T[];
+    total: number;
+    page: number;
+    pageCount: number;
+    limit: number;
+    hasPrev: boolean;
+    hasNext: boolean;
+}
+export interface FindManyOptions<WHERE = Record<string, any>, ORDER_BY = Record<string, 'asc' | 'desc'>> {
+    where?: WHERE;
+    orderBy?: ORDER_BY;
+    limit?: number;
+    offset?: number;
+    select?: Record<string, boolean>;
+}
+export interface FindPageOptions<WHERE = Record<string, any>, ORDER_BY = Record<string, 'asc' | 'desc'>> {
+    where?: WHERE;
+    orderBy?: ORDER_BY;
+    page: number;
+    limit: number;
+    select?: Record<string, boolean>;
+}
+export interface FindRealtimeOptions {
+    where?: Record<string, any>;
+    orderBy?: Record<string, 'asc' | 'desc'>;
+    limit?: number;
+    offset?: number;
+    select?: Record<string, boolean>;
+    bizId?: string;
+}
+export interface RealtimeResult {
+    data: Record<string, any>[];
+    total: number;
+}

package/dist/types/index.d.ts

@@ -0,0 +1,98 @@
+export interface StringOperators {
+    eq?: string;
+    in?: string[];
+    lt?: string;
+    lte?: string;
+    gt?: string;
+    gte?: string;
+    contains?: string;
+    startsWith?: string;
+    endsWith?: string;
+}
+export interface NumberOperators {
+    eq?: number;
+    in?: number[];
+    lt?: number;
+    lte?: number;
+    gt?: number;
+    gte?: number;
+}
+export interface BooleanOperators {
+    eq?: boolean;
+}
+export interface DateOperators {
+    eq?: Date | string;
+    in?: Date[] | string[];
+    lt?: Date | string;
+    lte?: Date | string;
+    gt?: Date | string;
+    gte?: Date | string;
+}
+export interface StringConditionType {
+    eq?: string;
+    not?: string;
+    lt?: string;
+    lte?: string;
+    gt?: string;
+    gte?: string;
+}
+export interface NumberConditionType {
+    eq?: number;
+    not?: number;
+    lt?: number;
+    lte?: number;
+    gt?: number;
+    gte?: number;
+}
+export interface BooleanConditionType {
+    eq?: number;
+    not?: number;
+}
+export interface DateConditionType {
+    eq?: Date | string;
+    not?: Date | string;
+    lt?: Date | string;
+    lte?: Date | string;
+    gt?: Date | string;
+    gte?: Date | string;
+}
+export type VectorOperators = number[];
+export type ColumnType = 'string' | 'number' | 'long' | 'boolean' | 'json' | 'date';
+export type SearchIndexType = 'keyword' | 'text' | 'number' | 'long' | 'boolean' | 'date' | 'geopoint' | 'vector';
+export interface ColumnMeta {
+    name: string;
+    type: ColumnType;
+    isPrimaryKey: boolean;
+    isPartitionKey: boolean;
+    default?: any | ((data: any, context?: any) => any);
+    auto?: (data: any, context?: any) => any;
+    createdAt?: boolean;
+    updatedAt?: boolean;
+    searchIndex?: {
+        type: SearchIndexType;
+        options?: object;
+    };
+}
+export interface TableMeta {
+    tableName: string;
+    primaryKeys: string[];
+    columnKeys: string[];
+    partitionKeyColumn: ColumnMeta;
+    updatedAtColumns: ColumnMeta[];
+    columns: ColumnMeta[];
+    searchIndexes?: Array<{
+        fieldName: string;
+        indexType: SearchIndexType;
+        options?: object;
+    }>;
+}
+export type SchemaMeta = Record<string, TableMeta>;
+export * from './client';
+export declare const VectorMetricType: {
+    /** 欧氏距离 */
+    VM_EUCLIDEAN: number;
+    /** 余弦相似度 */
+    VM_COSINE: number;
+    /** 点积 */
+    VM_DOT_PRODUCT: number;
+};

package/dist/utils/index.d.ts

@@ -0,0 +1,31 @@
+import { ColumnMeta, TableMeta } from '../types/index';
+
+/**
+ * 补充分区键
+ * 如果where/data中缺少分区键，但表元数据中存在分区键且有auto函数，则调用auto函数补全
+ * @param data - 输入数据对象
+ * @param partitionKeyColumn - 分区键元数据
+ * @param context - 运行时上下文
+ */
+export declare function fillPartitionKey(data: Record<string, any>, partitionKeyColumn: ColumnMeta, context?: any): Record<string, any>;
+/**
+ * 应用默认值
+ * 遍历columns，对缺失的字段应用默认值
+ * @param data - 输入数据对象
+ * @param tableMeta - 表元数据
+ * @param context - 运行时上下文
+ */
+export declare function applyDefaultValues(data: Record<string, any>, tableMeta: TableMeta, context?: any): Record<string, any>;
+export declare function applyUpdateValues(data: Record<string, any>[], tableMeta: TableMeta): Record<string, any>[];
+/**
+ * 验证分区键是否已填充
+ * @param data - 输入数据对象
+ * @param tableMeta - 表元数据
+ * @throws 如果分区键缺失且没有auto函数
+ */
+export declare function validatePartitionKey(data: Record<string, any>, partitionKeyColumn: ColumnMeta): void;
+/**
+ * 将 JavaScript 对象转换为源码字符串
+ * 支持：基本类型、对象、数组、函数、Map、Set、Date、RegExp、循环引用
+ */
+export declare function objectToSource(obj: any): any;

package/package.json

@@ -0,0 +1,47 @@
+{
+    "name": "ots-client",
+    "version": "0.0.1",
+    "description": "",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "type": "module",
+    "exports": {
+        ".": {
+            "import": "./dist/index.js",
+            "require": "./dist/index.cjs",
+            "types": "./dist/index.d.ts"
+        }
+    },
+    "scripts": {
+        "dev": "vite-node examples/index.ts",
+        "build": "vite build --ssr",
+        "publish-module": "npm run build && npm publish --registry=https://registry.npmjs.com",
+        "npm:adduser": "npm adduser --registry=https://registry.npmjs.com"
+    },
+    "publishConfig": {
+        "access": "public",
+        "registry": "https://registry.npmjs.com"
+    },
+    "keywords": [],
+    "author": "lanbomo",
+    "license": "ISC",
+    "dependencies": {
+        "es-toolkit": "^1.44.0",
+        "int64-buffer": "^1.1.0",
+        "tablestore": "^5.6.3"
+    },
+    "devDependencies": {
+        "@types/node": "^20.14.12",
+        "@types/tablestore": "^5.1.3",
+        "fast-glob": "^3.3.2",
+        "prettier": "^3.3.3",
+        "ts-morph": "^27.0.2",
+        "typescript": "^5.5.4",
+        "vite": "^5.3.5",
+        "vite-node": "^2.0.4",
+        "vite-plugin-dts": "4.0.0-beta.2"
+    },
+    "files": [
+        "dist"
+    ]
+}