@xpert-ai/plugin-sdk 3.6.3 → 3.6.5

package/index.cjs.js

@@ -25,6 +25,7 @@ var documents = require('@langchain/core/documents');
 var chat_models = require('@langchain/core/language_models/chat_models');
 var messages = require('@langchain/core/messages');
 var env = require('@langchain/core/utils/env');
+var jsTiktoken = require('js-tiktoken');
 
 function _interopNamespaceDefault(e) {
 	var n = Object.create(null);
@@ -936,7 +937,25 @@ exports.DataSourceStrategyRegistry = __decorate([
  * Helper base class to wrap existing adapter query runner implementations
  * into datasource strategies consumable by the plugin SDK.
  */ class AdapterDataSourceStrategy {
-    async create(options) {
+    /**
+   * Get from cache or create new instance of DB adapter.
+   * 
+   * @param options 
+   * @param id 
+   * @returns 
+   */ async create(options, id) {
+        if (id) {
+            if (this.runners.has(id)) {
+                return this.runners.get(id);
+            }
+            const runner = this.instantiateRunner(options);
+            this.runners.set(id, runner);
+            // If the Runner supports initPool, then initialize the connection pool.
+            if (typeof runner.initPool === 'function') {
+                await runner.initPool(options);
+            }
+            return runner;
+        }
         return this.instantiateRunner(options);
     }
     async configurationSchema() {
@@ -962,6 +981,7 @@ exports.DataSourceStrategyRegistry = __decorate([
     constructor(runnerClass, extraArgs = []){
         this.runnerClass = runnerClass;
         this.extraArgs = extraArgs;
+        this.runners = new Map();
     }
 }
 
@@ -995,6 +1015,12 @@ class BaseQueryRunner {
     async dropTable(name, options) {
         this.runQuery(`DROP TABLE ${name}`, options);
     }
+    async tableOp(action, params, options) {
+        throw new Error(`Unimplemented method`);
+    }
+    async tableDataOp(action, params, options) {
+        throw new Error(`Unimplemented tableDataOp`);
+    }
     constructor(options){
         this.options = options;
     }
@@ -1060,6 +1086,39 @@ class BaseSQLQueryRunner extends BaseQueryRunner {
         this.protocol = "sql";
     }
 }
+exports.DBTableAction = void 0;
+(function(DBTableAction) {
+    DBTableAction["LIST_TABLES"] = "listTables";
+    DBTableAction["TABLE_EXISTS"] = "tableExists";
+    DBTableAction["CREATE_TABLE"] = "createTable";
+    DBTableAction["DROP_TABLE"] = "dropTable";
+    DBTableAction["RENAME_TABLE"] = "renameTable";
+    DBTableAction["TRUNCATE_TABLE"] = "truncateTable";
+    DBTableAction["ADD_COLUMN"] = "addColumn";
+    DBTableAction["DROP_COLUMN"] = "dropColumn";
+    DBTableAction["MODIFY_COLUMN"] = "modifyColumn";
+    DBTableAction["CREATE_INDEX"] = "createIndex";
+    DBTableAction["DROP_INDEX"] = "dropIndex";
+    DBTableAction["GET_TABLE_INFO"] = "getTableInfo";
+    DBTableAction["CLONE_TABLE_STRUCTURE"] = "cloneTableStructure";
+    DBTableAction["CLONE_TABLE"] = "cloneTable";
+    DBTableAction["OPTIMIZE_TABLE"] = "optimizeTable";
+})(exports.DBTableAction || (exports.DBTableAction = {}));
+exports.DBCreateTableMode = void 0;
+(function(DBCreateTableMode) {
+    DBCreateTableMode["ERROR"] = "error";
+    DBCreateTableMode["IGNORE"] = "ignore";
+    DBCreateTableMode["UPGRADE"] = "upgrade"; // 表已存在 → 自动升级表结构
+})(exports.DBCreateTableMode || (exports.DBCreateTableMode = {}));
+exports.DBTableDataAction = void 0;
+(function(DBTableDataAction) {
+    DBTableDataAction["INSERT"] = "insert";
+    DBTableDataAction["UPDATE"] = "update";
+    DBTableDataAction["UPSERT"] = "upsert";
+    DBTableDataAction["DELETE"] = "delete";
+    DBTableDataAction["SELECT"] = "select";
+    DBTableDataAction["BULK_INSERT"] = "bulkInsert";
+})(exports.DBTableDataAction || (exports.DBTableDataAction = {}));
 
 const AI_MODEL_PROVIDER = 'AI_MODEL_PROVIDER';
 function AIModelProviderStrategy(provider) {
@@ -1109,6 +1168,8 @@ class AiModelNotFoundException extends common.NotFoundException {
 }
 class CredentialsValidateFailedError extends common.ForbiddenException {
 }
+class AIModelProviderNotFoundException extends common.NotFoundException {
+}
 
 exports.ModelProvider = class ModelProvider {
     get name() {
@@ -1980,6 +2041,58 @@ class Speech2TextChatModel extends chat_models.BaseChatModel {
     }
 }
 
+/**
+ * Fallback token estimation method.
+ *
+ * 思路:
+ * - 英文：约 4 chars / token
+ * - 中文：约 1.5 chars / token
+ * - Mixed：按字符区分
+ */ function estimateTokens(text) {
+    if (!text) return 0;
+    let cn = 0;
+    let en = 0;
+    for (const ch of text){
+        if (/[\u4e00-\u9fa5]/.test(ch)) {
+            cn++;
+        } else {
+            en++;
+        }
+    }
+    // 中文 1 token ≈ 1.5 chars
+    const cnTokens = cn / 1.5;
+    // 英文 1 token ≈ 4 chars
+    const enTokens = en / 4;
+    return Math.ceil(cnTokens + enTokens);
+}
+/**
+ * Count tokens in text
+ * 1) Preferred: js-tiktoken precise encoding
+ * 2) Fallback: estimated token count
+ */ function countTokensSafe(text, opts) {
+    if (!text) return 0;
+    let resolvedEncoding;
+    // Decide encoding name
+    if (opts == null ? void 0 : opts.encodingName) {
+        resolvedEncoding = String(opts.encodingName);
+    } else if (opts == null ? void 0 : opts.model) {
+        var _getEncodingNameForModel;
+        resolvedEncoding = (_getEncodingNameForModel = jsTiktoken.getEncodingNameForModel(opts.model)) != null ? _getEncodingNameForModel : 'cl100k_base';
+    } else {
+        resolvedEncoding = 'cl100k_base';
+    }
+    try {
+        // Prefer exact token count via js-tiktoken
+        const enc = (opts == null ? void 0 : opts.model) ? jsTiktoken.encodingForModel(opts.model) : jsTiktoken.getEncoding(resolvedEncoding);
+        const tokens = enc.encode(text);
+        return tokens.length;
+    } catch (e) {
+        // Fallback
+        console.warn('[countTokensSafe] tiktoken failed, fallback estimate', e);
+        return estimateTokens(text);
+    }
+}
+
 Object.defineProperty(exports, "IColumnDef", {
 	enumerable: true,
 	get: function () { return contracts.IColumnDef; }
@@ -1996,6 +2109,7 @@ Object.defineProperty(exports, "TDocumentAsset", {
 	enumerable: true,
 	get: function () { return contracts.TDocumentAsset; }
 });
+exports.AIModelProviderNotFoundException = AIModelProviderNotFoundException;
 exports.AIModelProviderStrategy = AIModelProviderStrategy;
 exports.AI_MODEL_PROVIDER = AI_MODEL_PROVIDER;
 exports.AdapterDataSourceStrategy = AdapterDataSourceStrategy;
@@ -2053,6 +2167,7 @@ exports.XpFileSystem = XpFileSystem;
 exports.XpertServerPlugin = XpertServerPlugin;
 exports.als = als;
 exports.calcTokenUsage = calcTokenUsage;
+exports.countTokensSafe = countTokensSafe;
 exports.createI18nInstance = createI18nInstance;
 exports.createPluginLogger = createPluginLogger;
 exports.downloadRemoteFile = downloadRemoteFile;

package/index.esm.js

@@ -27,6 +27,7 @@ import { Document } from '@langchain/core/documents';
 import { BaseChatModel } from '@langchain/core/language_models/chat_models';
 import { AIMessage } from '@langchain/core/messages';
 import { getEnvironmentVariable } from '@langchain/core/utils/env';
+import { getEncodingNameForModel, encodingForModel, getEncoding } from 'js-tiktoken';
 
 /**
  * Metadata keys used in plugins for defining various aspects like entities, subscribers, and configurations.
@@ -916,7 +917,25 @@ DataSourceStrategyRegistry = __decorate([
  * Helper base class to wrap existing adapter query runner implementations
  * into datasource strategies consumable by the plugin SDK.
  */ class AdapterDataSourceStrategy {
-    async create(options) {
+    /**
+   * Get from cache or create new instance of DB adapter.
+   * 
+   * @param options 
+   * @param id 
+   * @returns 
+   */ async create(options, id) {
+        if (id) {
+            if (this.runners.has(id)) {
+                return this.runners.get(id);
+            }
+            const runner = this.instantiateRunner(options);
+            this.runners.set(id, runner);
+            // If the Runner supports initPool, then initialize the connection pool.
+            if (typeof runner.initPool === 'function') {
+                await runner.initPool(options);
+            }
+            return runner;
+        }
         return this.instantiateRunner(options);
     }
     async configurationSchema() {
@@ -942,6 +961,7 @@ DataSourceStrategyRegistry = __decorate([
     constructor(runnerClass, extraArgs = []){
         this.runnerClass = runnerClass;
         this.extraArgs = extraArgs;
+        this.runners = new Map();
     }
 }
 
@@ -975,6 +995,12 @@ class BaseQueryRunner {
     async dropTable(name, options) {
         this.runQuery(`DROP TABLE ${name}`, options);
     }
+    async tableOp(action, params, options) {
+        throw new Error(`Unimplemented method`);
+    }
+    async tableDataOp(action, params, options) {
+        throw new Error(`Unimplemented tableDataOp`);
+    }
     constructor(options){
         this.options = options;
     }
@@ -1040,6 +1066,39 @@ class BaseSQLQueryRunner extends BaseQueryRunner {
         this.protocol = "sql";
     }
 }
+var DBTableAction;
+(function(DBTableAction) {
+    DBTableAction["LIST_TABLES"] = "listTables";
+    DBTableAction["TABLE_EXISTS"] = "tableExists";
+    DBTableAction["CREATE_TABLE"] = "createTable";
+    DBTableAction["DROP_TABLE"] = "dropTable";
+    DBTableAction["RENAME_TABLE"] = "renameTable";
+    DBTableAction["TRUNCATE_TABLE"] = "truncateTable";
+    DBTableAction["ADD_COLUMN"] = "addColumn";
+    DBTableAction["DROP_COLUMN"] = "dropColumn";
+    DBTableAction["MODIFY_COLUMN"] = "modifyColumn";
+    DBTableAction["CREATE_INDEX"] = "createIndex";
+    DBTableAction["DROP_INDEX"] = "dropIndex";
+    DBTableAction["GET_TABLE_INFO"] = "getTableInfo";
+    DBTableAction["CLONE_TABLE_STRUCTURE"] = "cloneTableStructure";
+    DBTableAction["CLONE_TABLE"] = "cloneTable";
+    DBTableAction["OPTIMIZE_TABLE"] = "optimizeTable";
+})(DBTableAction || (DBTableAction = {}));
+var DBCreateTableMode;
+(function(DBCreateTableMode) {
+    DBCreateTableMode["ERROR"] = "error";
+    DBCreateTableMode["IGNORE"] = "ignore";
+    DBCreateTableMode["UPGRADE"] = "upgrade"; // 表已存在 → 自动升级表结构
+})(DBCreateTableMode || (DBCreateTableMode = {}));
+var DBTableDataAction;
+(function(DBTableDataAction) {
+    DBTableDataAction["INSERT"] = "insert";
+    DBTableDataAction["UPDATE"] = "update";
+    DBTableDataAction["UPSERT"] = "upsert";
+    DBTableDataAction["DELETE"] = "delete";
+    DBTableDataAction["SELECT"] = "select";
+    DBTableDataAction["BULK_INSERT"] = "bulkInsert";
+})(DBTableDataAction || (DBTableDataAction = {}));
 
 const AI_MODEL_PROVIDER = 'AI_MODEL_PROVIDER';
 function AIModelProviderStrategy(provider) {
@@ -1089,6 +1148,8 @@ class AiModelNotFoundException extends NotFoundException {
 }
 class CredentialsValidateFailedError extends ForbiddenException {
 }
+class AIModelProviderNotFoundException extends NotFoundException {
+}
 
 let ModelProvider = class ModelProvider {
     get name() {
@@ -1960,4 +2021,56 @@ class Speech2TextChatModel extends BaseChatModel {
     }
 }
 
-export { AIModelProviderRegistry, AIModelProviderStrategy, AI_MODEL_PROVIDER, AdapterDataSourceStrategy, AiModelNotFoundException, BaseHTTPQueryRunner, BaseQueryRunner, BaseSQLQueryRunner, BaseTool, BaseToolset, BuiltinToolset, ChatOAICompatReasoningModel, CommonParameterRules, CredentialsValidateFailedError, DATASOURCE_STRATEGY, DBProtocolEnum, DBSyntaxEnum, DOCUMENT_SOURCE_STRATEGY, DOCUMENT_TRANSFORMER_STRATEGY, DataSourceStrategy, DataSourceStrategyRegistry, DocumentSourceRegistry, DocumentSourceStrategy, DocumentTransformerRegistry, DocumentTransformerStrategy, IMAGE_UNDERSTANDING_STRATEGY, INTEGRATION_STRATEGY, ImageUnderstandingRegistry, ImageUnderstandingStrategy, IntegrationStrategyKey, IntegrationStrategyRegistry, KNOWLEDGE_STRATEGY, KnowledgeStrategyKey, KnowledgeStrategyRegistry, LLMUsage, LargeLanguageModel, ModelProvider, OpenAICompatibleReranker, PLUGIN_METADATA, PROVIDE_AI_MODEL_LLM, PROVIDE_AI_MODEL_MODERATION, PROVIDE_AI_MODEL_RERANK, PROVIDE_AI_MODEL_SPEECH2TEXT, PROVIDE_AI_MODEL_TEXT_EMBEDDING, PROVIDE_AI_MODEL_TTS, RETRIEVER_STRATEGY, RequestContext, RequestContextMiddleware, RerankModel, RetrieverRegistry, RetrieverStrategy, Speech2TextChatModel, SpeechToTextModel, TEXT_SPLITTER_STRATEGY, TOOLSET_STRATEGY, TextEmbeddingModelManager, TextSplitterRegistry, TextSplitterStrategy, TextToSpeechModel, ToolsetRegistry, ToolsetStrategy, VECTOR_STORE_STRATEGY, VectorStoreRegistry, VectorStoreStrategy, WORKFLOW_NODE_STRATEGY, WORKFLOW_TRIGGER_STRATEGY, WorkflowNodeRegistry, WorkflowNodeStrategy, WorkflowTriggerRegistry, WorkflowTriggerStrategy, XpFileSystem, XpertServerPlugin, als, calcTokenUsage, createI18nInstance, createPluginLogger, downloadRemoteFile, getErrorMessage, getPositionList, getPositionMap, getRequestContext, isRemoteFile, loadYamlFile, mergeCredentials, mergeParentChildChunks, runWithRequestContext, sumTokenUsage };
+/**
+ * Fallback token estimation method.
+ *
+ * 思路:
+ * - 英文：约 4 chars / token
+ * - 中文：约 1.5 chars / token
+ * - Mixed：按字符区分
+ */ function estimateTokens(text) {
+    if (!text) return 0;
+    let cn = 0;
+    let en = 0;
+    for (const ch of text){
+        if (/[\u4e00-\u9fa5]/.test(ch)) {
+            cn++;
+        } else {
+            en++;
+        }
+    }
+    // 中文 1 token ≈ 1.5 chars
+    const cnTokens = cn / 1.5;
+    // 英文 1 token ≈ 4 chars
+    const enTokens = en / 4;
+    return Math.ceil(cnTokens + enTokens);
+}
+/**
+ * Count tokens in text
+ * 1) Preferred: js-tiktoken precise encoding
+ * 2) Fallback: estimated token count
+ */ function countTokensSafe(text, opts) {
+    if (!text) return 0;
+    let resolvedEncoding;
+    // Decide encoding name
+    if (opts == null ? void 0 : opts.encodingName) {
+        resolvedEncoding = String(opts.encodingName);
+    } else if (opts == null ? void 0 : opts.model) {
+        var _getEncodingNameForModel;
+        resolvedEncoding = (_getEncodingNameForModel = getEncodingNameForModel(opts.model)) != null ? _getEncodingNameForModel : 'cl100k_base';
+    } else {
+        resolvedEncoding = 'cl100k_base';
+    }
+    try {
+        // Prefer exact token count via js-tiktoken
+        const enc = (opts == null ? void 0 : opts.model) ? encodingForModel(opts.model) : getEncoding(resolvedEncoding);
+        const tokens = enc.encode(text);
+        return tokens.length;
+    } catch (e) {
+        // Fallback
+        console.warn('[countTokensSafe] tiktoken failed, fallback estimate', e);
+        return estimateTokens(text);
+    }
+}
+
+export { AIModelProviderNotFoundException, AIModelProviderRegistry, AIModelProviderStrategy, AI_MODEL_PROVIDER, AdapterDataSourceStrategy, AiModelNotFoundException, BaseHTTPQueryRunner, BaseQueryRunner, BaseSQLQueryRunner, BaseTool, BaseToolset, BuiltinToolset, ChatOAICompatReasoningModel, CommonParameterRules, CredentialsValidateFailedError, DATASOURCE_STRATEGY, DBCreateTableMode, DBProtocolEnum, DBSyntaxEnum, DBTableAction, DBTableDataAction, DOCUMENT_SOURCE_STRATEGY, DOCUMENT_TRANSFORMER_STRATEGY, DataSourceStrategy, DataSourceStrategyRegistry, DocumentSourceRegistry, DocumentSourceStrategy, DocumentTransformerRegistry, DocumentTransformerStrategy, IMAGE_UNDERSTANDING_STRATEGY, INTEGRATION_STRATEGY, ImageUnderstandingRegistry, ImageUnderstandingStrategy, IntegrationStrategyKey, IntegrationStrategyRegistry, KNOWLEDGE_STRATEGY, KnowledgeStrategyKey, KnowledgeStrategyRegistry, LLMUsage, LargeLanguageModel, ModelProvider, OpenAICompatibleReranker, PLUGIN_METADATA, PROVIDE_AI_MODEL_LLM, PROVIDE_AI_MODEL_MODERATION, PROVIDE_AI_MODEL_RERANK, PROVIDE_AI_MODEL_SPEECH2TEXT, PROVIDE_AI_MODEL_TEXT_EMBEDDING, PROVIDE_AI_MODEL_TTS, RETRIEVER_STRATEGY, RequestContext, RequestContextMiddleware, RerankModel, RetrieverRegistry, RetrieverStrategy, Speech2TextChatModel, SpeechToTextModel, TEXT_SPLITTER_STRATEGY, TOOLSET_STRATEGY, TextEmbeddingModelManager, TextSplitterRegistry, TextSplitterStrategy, TextToSpeechModel, ToolsetRegistry, ToolsetStrategy, VECTOR_STORE_STRATEGY, VectorStoreRegistry, VectorStoreStrategy, WORKFLOW_NODE_STRATEGY, WORKFLOW_TRIGGER_STRATEGY, WorkflowNodeRegistry, WorkflowNodeStrategy, WorkflowTriggerRegistry, WorkflowTriggerStrategy, XpFileSystem, XpertServerPlugin, als, calcTokenUsage, countTokensSafe, createI18nInstance, createPluginLogger, downloadRemoteFile, getErrorMessage, getPositionList, getPositionMap, getRequestContext, isRemoteFile, loadYamlFile, mergeCredentials, mergeParentChildChunks, runWithRequestContext, sumTokenUsage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpert-ai/plugin-sdk",
-  "version": "3.6.3",
+  "version": "3.6.5",
   "license": "AGPL-3.0",
   "repository": {
     "type": "git",
@@ -9,12 +9,14 @@
   "bugs": {
     "url": "https://github.com/xpert-ai/xpert/issues"
   },
-  "dependencies": {},
   "main": "./index.cjs.js",
   "module": "./index.esm.js",
   "publishConfig": {
     "access": "public"
   },
+  "dependencies": {
+    "js-tiktoken": "^1.0.21"
+  },
   "peerDependencies": {
     "@langchain/core": "*",
     "@metad/contracts": "*",
@@ -28,6 +30,7 @@
     "path": "*",
     "passport-jwt": "*",
     "stream": "*",
+    "yaml": "*",
     "zod": "*"
   }
 }

package/src/lib/ai-model/errors.d.ts

@@ -3,3 +3,5 @@ export declare class AiModelNotFoundException extends NotFoundException {
 }
 export declare class CredentialsValidateFailedError extends ForbiddenException {
 }
+export declare class AIModelProviderNotFoundException extends NotFoundException {
+}

package/src/lib/ai-model/index.d.ts

@@ -6,3 +6,4 @@ export * from './types';
 export * from './llm';
 export * from './errors';
 export * from './openai-compatible';
+export * from './utils/index';

package/src/lib/ai-model/utils/index.d.ts

@@ -0,0 +1 @@
+export * from './tokenizer';

package/src/lib/ai-model/utils/tokenizer.d.ts

@@ -0,0 +1,10 @@
+import type { TiktokenEncoding } from 'js-tiktoken';
+/**
+ * Count tokens in text
+ * 1) Preferred: js-tiktoken precise encoding
+ * 2) Fallback: estimated token count
+ */
+export declare function countTokensSafe(text: string, opts?: {
+    model?: string;
+    encodingName?: TiktokenEncoding | string;
+}): number;

package/src/lib/core/context/request-context.middleware.d.ts

@@ -1,7 +1,10 @@
 /// <reference types="node" />
+import { IUser } from '@metad/contracts';
 import { NestMiddleware } from '@nestjs/common';
 import { IncomingMessage, ServerResponse } from 'node:http';
 export declare class RequestContextMiddleware implements NestMiddleware {
     use(req: IncomingMessage, _res: ServerResponse, next: () => void): void;
 }
-export declare function runWithRequestContext(req: IncomingMessage, res: ServerResponse, next: () => void): void;
+export declare function runWithRequestContext(req: Partial<IncomingMessage> & {
+    user?: IUser;
+}, res: Partial<ServerResponse>, next: () => void): void;

package/src/lib/data/datasource/adapter.strategy.d.ts

@@ -11,8 +11,16 @@ export declare abstract class AdapterDataSourceStrategy<TOptions extends Adapter
     abstract readonly name: string;
     readonly description?: string;
     private configurationSchemaCache;
+    private runners;
     protected constructor(runnerClass: DBQueryRunnerType, extraArgs?: unknown[]);
-    create(options: TOptions): Promise<DBQueryRunner>;
+    /**
+     * Get from cache or create new instance of DB adapter.
+     *
+     * @param options
+     * @param id
+     * @returns
+     */
+    create(options: TOptions, id?: string): Promise<DBQueryRunner>;
     configurationSchema(): Promise<Record<string, unknown>>;
     teardown(runner: DBQueryRunner): Promise<void>;
     protected instantiateRunner(options: TOptions | undefined): DBQueryRunner;

package/src/lib/data/datasource/strategy.interface.d.ts

@@ -6,7 +6,7 @@ export interface IDataSourceStrategy<TOptions extends AdapterBaseOptions = Adapt
     /**
      * Create a query runner for the given data source options.
      */
-    create(options: TOptions): Promise<DBQueryRunner> | DBQueryRunner;
+    create(options: TOptions, id?: string): Promise<DBQueryRunner> | DBQueryRunner;
     /**
      * Optional configuration schema description for UI generation.
      */

package/src/lib/data/datasource/types.d.ts

@@ -36,6 +36,7 @@ export declare enum DBProtocolEnum {
 export interface QueryOptions {
     catalog?: string;
     headers?: Record<string, string>;
+    params?: Record<string, any>[];
 }
 export interface QueryResult<T = unknown> {
     status: 'OK' | 'ERROR';
@@ -59,6 +60,7 @@ export interface DBQueryRunner {
     jdbcDriver: string;
     configurationSchema: Record<string, unknown>;
     jdbcUrl(schema?: string): string;
+    initPool?(options: AdapterBaseOptions): Promise<void>;
     /**
      * Execute a sql query
      *
@@ -116,6 +118,11 @@ export interface DBQueryRunner {
      * @param options
      */
     dropTable(name: string, options?: QueryOptions): Promise<void>;
+    /**
+     * Unified table operation executor
+     */
+    tableOp(action: DBTableAction, params: DBTableOperationParams, options?: QueryOptions): Promise<any>;
+    tableDataOp<T = any>(action: DBTableDataAction, params: DBTableDataParams, options?: QueryOptions): Promise<T[] | number | any>;
     /**
      * Teardown all resources:
      * - close connection
@@ -135,12 +142,22 @@ export interface ColumnDef {
     fieldName: string;
     /**
      * Object value type, convert to db type
+     * - string
+     * - number
+     * - boolean
+     * - date
+     * - datetime
+     * - object
      */
     type: string;
     /**
      * Is primary key column
      */
     isKey: boolean;
+    /**
+     * Is required column
+     */
+    required?: boolean;
     /**
      * length of type for column: varchar, decimal ...
      */
@@ -190,6 +207,8 @@ export declare abstract class BaseQueryRunner<T extends AdapterBaseOptions = Ada
         catalog?: string;
     }): Promise<void>;
     dropTable(name: string, options?: any): Promise<void>;
+    tableOp(action: DBTableAction, params: DBTableOperationParams, options?: QueryOptions): Promise<any>;
+    tableDataOp(action: DBTableDataAction, params: DBTableDataParams, options?: QueryOptions): Promise<any>;
     abstract teardown(): Promise<void>;
 }
 export interface HttpAdapterOptions extends AdapterBaseOptions {
@@ -253,3 +272,63 @@ export interface File {
     /** `MemoryStorage` only: A Buffer containing the entire file. */
     buffer: Buffer;
 }
+export declare enum DBTableAction {
+    LIST_TABLES = "listTables",
+    TABLE_EXISTS = "tableExists",
+    CREATE_TABLE = "createTable",
+    DROP_TABLE = "dropTable",
+    RENAME_TABLE = "renameTable",
+    TRUNCATE_TABLE = "truncateTable",
+    ADD_COLUMN = "addColumn",
+    DROP_COLUMN = "dropColumn",
+    MODIFY_COLUMN = "modifyColumn",
+    CREATE_INDEX = "createIndex",
+    DROP_INDEX = "dropIndex",
+    GET_TABLE_INFO = "getTableInfo",
+    CLONE_TABLE_STRUCTURE = "cloneTableStructure",
+    CLONE_TABLE = "cloneTable",
+    OPTIMIZE_TABLE = "optimizeTable"
+}
+export interface DBTableOperationParams {
+    schema?: string;
+    table?: string;
+    newTable?: string;
+    columns?: ColumnDef[];
+    column?: ColumnDef;
+    columnName?: string;
+    index?: DBIndexDefinition;
+    indexName?: string;
+    createMode?: DBCreateTableMode;
+}
+export interface DBIndexDefinition {
+    name: string;
+    columns: string[];
+    unique?: boolean;
+    type?: 'btree' | 'hash' | 'gin' | 'bitmap' | 'fulltext' | string;
+}
+export declare enum DBCreateTableMode {
+    ERROR = "error",// 表已存在 → 报错
+    IGNORE = "ignore",// 表已存在 → 什么也不做
+    UPGRADE = "upgrade"
+}
+export declare enum DBTableDataAction {
+    INSERT = "insert",
+    UPDATE = "update",
+    UPSERT = "upsert",
+    DELETE = "delete",
+    SELECT = "select",
+    BULK_INSERT = "bulkInsert"
+}
+export interface DBTableDataParams {
+    schema?: string;
+    table: string;
+    columns?: Partial<ColumnDef>[];
+    where?: Record<string, any> | string;
+    orderBy?: string;
+    limit?: number;
+    offset?: number;
+    values?: Record<string, any> | Array<Record<string, any>>;
+    set?: Record<string, any>;
+    deleteWhere?: Record<string, any> | string;
+    conflictKeys?: string[];
+}