knight-server 1.0.0

package/test/WSRouter.js

@@ -0,0 +1,33 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WSRouter = void 0;
+const base_1 = require("../base");
+const module_1 = require("../module");
+let WSRouter = class WSRouter extends module_1.WebSocketRouter {
+    constructor() {
+        super(...arguments);
+        this.path = "/ws";
+    }
+    async OnCheck(server, url) {
+        return true;
+    }
+    async OnConnect(server, client) {
+    }
+    async OnDisconnect(server, client) {
+    }
+    async OnMessage(server, client, data) {
+        console.log("==== 接收消息:", data);
+        client.OnUpdateHeartbeat();
+    }
+};
+exports.WSRouter = WSRouter;
+exports.WSRouter = WSRouter = __decorate([
+    (0, base_1.OnRegister)()
+], WSRouter);
+//# sourceMappingURL=WSRouter.js.map

package/test/WSRouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WSRouter.js","sourceRoot":"","sources":["../../src/test/WSRouter.ts"],"names":[],"mappings":";;;;;;;;;AAAA,kCAAqC;AACrC,sCAA6D;AAKtD,IAAM,QAAQ,GAAd,MAAM,QAAS,SAAQ,wBAAe;IAAtC;;QAEa,SAAI,GAAW,KAAK,CAAC;IAoBzC,CAAC;IAlBU,KAAK,CAAC,OAAO,CAAC,MAAc,EAAE,GAAQ;QAEzC,OAAO,IAAI,CAAC;IAChB,CAAC;IACM,KAAK,CAAC,SAAS,CAAC,MAAc,EAAE,MAAuB;IAG9D,CAAC;IACM,KAAK,CAAC,YAAY,CAAC,MAAc,EAAE,MAAuB;IAGjE,CAAC;IACM,KAAK,CAAC,SAAS,CAAC,MAAc,EAAE,MAAuB,EAAE,IAAY;QAExE,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QAChC,MAAM,CAAC,iBAAiB,EAAE,CAAC;IAC/B,CAAC;CAEJ,CAAA;AAtBY,4BAAQ;mBAAR,QAAQ;IADpB,IAAA,iBAAU,GAAE;GACA,QAAQ,CAsBpB"}

package/test/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./MyRouter";
+export * from "./WSRouter";
+//# sourceMappingURL=index.d.ts.map

package/test/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/test/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./MyRouter"), exports);
+__exportStar(require("./WSRouter"), exports);
+//# sourceMappingURL=index.js.map

package/test/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/test/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,6CAA2B"}

package/utility/DatabaseUtility.d.ts

@@ -0,0 +1,158 @@
+import * as MySQL from "mysql2/promise";
+/** 数据库工具 */
+export declare namespace DatabaseUtility {
+    /** 表结构信息接口 */
+    interface TableSchema {
+        name: string;
+        columns: ColumnSchema[];
+        indexes: IndexSchema[];
+        primaryKey: string | null;
+        engine: string;
+        charset: string;
+        comment: string;
+    }
+    /** 列结构信息接口 */
+    interface ColumnSchema {
+        name: string;
+        type: string;
+        nullable: boolean;
+        key: string;
+        default: any;
+        extra: string;
+        comment: string;
+    }
+    /** 索引信息接口 */
+    interface IndexSchema {
+        name: string;
+        columns: string[];
+        unique: boolean;
+        type: string;
+    }
+    /** 表差异接口 */
+    interface TableDiff {
+        addedColumns: ColumnSchema[];
+        removedColumns: ColumnSchema[];
+        modifiedColumns: {
+            name: string;
+            current: ColumnSchema;
+            target: ColumnSchema;
+        }[];
+        addedIndexes: IndexSchema[];
+        removedIndexes: IndexSchema[];
+        modifiedIndexes: {
+            name: string;
+            current: IndexSchema;
+            target: IndexSchema;
+        }[];
+        isEmpty: boolean;
+    }
+    /** 同步结果接口 */
+    interface QueryResult<T = any> {
+        success: boolean;
+        data?: T[];
+        item?: T;
+        affectedRows?: number;
+        insertId?: number;
+        error?: string;
+        message?: string;
+        action?: 'CREATE' | 'ALTER' | 'DROP' | 'NONE';
+        targetSchema?: TableSchema;
+        diff?: TableDiff;
+        statements?: string[];
+        details?: any;
+        raw?: any;
+    }
+    /** 同步选项接口 */
+    interface SyncOptions {
+        dropExtraColumns?: boolean;
+        backupData?: boolean;
+        execute?: boolean;
+    }
+    /** 智能表格 — 从 SQL 文件自动同步数据库表结构 */
+    class SmartTable {
+        private pool;
+        constructor(pool: MySQL.Pool);
+        /**
+         * 自动同步目录下的所有 SQL 文件
+         * @param relativePath SQL文件所在目录相对项目根目录的路径
+         * @param options 同步选项
+         * @param fileFilter 文件过滤函数（可选），返回 true 表示需要处理
+         */
+        syncAllFromDir(relativePath: string, options?: SyncOptions, fileFilter?: (fileName: string) => boolean): Promise<{
+            success: boolean;
+            results: Map<string, QueryResult>;
+            failed: string[];
+            message: string;
+        }>;
+        /**
+         * 根据依赖关系排序文件（拓扑排序，被引用的表先处理）
+         */
+        private sortFilesByDependency;
+        /**
+         * 从 SQL 文件同步数据库结构
+         */
+        private syncTableFromSql;
+        /**
+         * 执行原生SQL查询（用于DDL语句，比prepared statement更兼容）
+         */
+        private executeRawQuery;
+        /**
+         * 执行SQL查询（用于参数化查询）
+         */
+        private executeQuery;
+        /**
+         * 执行 SQL 脚本（支持多条语句，逐条执行）
+         */
+        private executeSqlScript;
+        /**
+         * 智能分割 SQL 语句（处理字符串和反引号中的分号）
+         */
+        private splitSqlStatements;
+        /**
+         * 解析 SQL 文件中的表结构（使用括号计数处理嵌套括号）
+         */
+        private parseSqlTableSchema;
+        /**
+         * 提取默认值（处理字符串、数字、CURRENT_TIMESTAMP 等）
+         */
+        private extractDefaultValue;
+        /**
+         * 提取注释
+         */
+        private extractComment;
+        /**
+         * 检查表是否存在
+         */
+        private tableExists;
+        /**
+         * 获取当前表结构
+         */
+        private getTableSchema;
+        /**
+         * 比较两个表结构的差异
+         */
+        private compareTableSchemas;
+        /**
+         * 生成 ALTER 语句（去重、合并）
+         */
+        private generateAlterStatements;
+        private normalizeType;
+        private isColumnEqual;
+        private normalizeDefaultValue;
+        private isIndexEqual;
+        private generateColumnDefinition;
+        /**
+         * 根据列类型确定安全的非 NULL 默认值（用于 nullable→NOT NULL 转换前回填空值）
+         */
+        private determineSafeDefault;
+        private disableForeignKeys;
+        private enableForeignKeys;
+        private getForeignKeys;
+        private getReferencingForeignKeys;
+        private hasPrimaryKeyChanges;
+        private extractForeignKeys;
+        private backupTableData;
+        private executeSqlFile;
+    }
+}
+//# sourceMappingURL=DatabaseUtility.d.ts.map

package/utility/DatabaseUtility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseUtility.d.ts","sourceRoot":"","sources":["../../src/utility/DatabaseUtility.ts"],"names":[],"mappings":"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"}