schema-dsl 1.2.4 → 2.0.0

package/lib/exporters/MySQLExporter.js

@@ -1,212 +0,0 @@
-/**
- * MySQL DDL导出器
- *
- * 将JSON Schema转换为MySQL CREATE TABLE语句
- *
- * @module lib/exporters/MySQLExporter
- * @version 1.0.0
- */
-
-const TypeConverter = require('../utils/TypeConverter');
-const SchemaHelper = require('../utils/SchemaHelper');
-
-/**
- * MySQL导出器类
- * @class MySQLExporter
- */
-class MySQLExporter {
-  /**
-   * 构造函数
-   * @param {Object} options - 配置选项
-   * @param {string} options.engine - 存储引擎（默认InnoDB）
-   * @param {string} options.charset - 字符集（默认utf8mb4）
-   * @param {string} options.collate - 排序规则（默认utf8mb4_unicode_ci）
-   */
-  constructor(options = {}) {
-    this.options = {
-      engine: options.engine || 'InnoDB',
-      charset: options.charset || 'utf8mb4',
-      collate: options.collate || 'utf8mb4_unicode_ci',
-      ...options
-    };
-  }
-
-  /**
-   * 导出为MySQL CREATE TABLE语句
-   * @param {string} tableName - 表名
-   * @param {Object} jsonSchema - JSON Schema对象
-   * @returns {string} MySQL DDL语句
-   */
-  export(tableName, jsonSchema) {
-    if (!tableName || typeof tableName !== 'string') {
-      throw new Error('Table name is required');
-    }
-    if (!jsonSchema || jsonSchema.type !== 'object') {
-      throw new Error('JSON Schema must be an object type');
-    }
-
-    const columns = this._convertProperties(jsonSchema);
-    const primaryKey = this._detectPrimaryKey(jsonSchema);
-
-    let ddl = `CREATE TABLE \`${tableName}\` (\n`;
-
-    // 添加列定义
-    const columnDefs = columns.map(col => `  ${col}`).join(',\n');
-    ddl += columnDefs;
-
-    // 添加主键
-    if (primaryKey) {
-      ddl += `,\n  PRIMARY KEY (\`${primaryKey}\`)`;
-    }
-
-    ddl += `\n)`;
-
-    // 添加表选项
-    ddl += ` ENGINE=${this.options.engine}`;
-    ddl += ` DEFAULT CHARSET=${this.options.charset}`;
-    ddl += ` COLLATE=${this.options.collate};`;
-
-    return ddl;
-  }
-
-  /**
-   * 转换properties为列定义
-   * @private
-   * @param {Object} schema - JSON Schema对象
-   * @returns {Array<string>} 列定义数组
-   */
-  _convertProperties(schema) {
-    if (!schema.properties) {
-      return [];
-    }
-
-    const columns = [];
-    const required = schema.required || [];
-
-    for (const [name, propSchema] of Object.entries(schema.properties)) {
-      const columnDef = this._convertColumn(name, propSchema, required.includes(name));
-      columns.push(columnDef);
-    }
-
-    return columns;
-  }
-
-  /**
-   * 转换单个列
-   * @private
-   * @param {string} name - 列名
-   * @param {Object} schema - 属性Schema
-   * @param {boolean} isRequired - 是否必填
-   * @returns {string} 列定义字符串
-   */
-  _convertColumn(name, schema, isRequired) {
-    const constraints = TypeConverter.extractConstraints(schema);
-    const mysqlType = TypeConverter.toMySQLType(schema.type, constraints);
-
-    let def = `\`${name}\` ${mysqlType}`;
-
-    // NULL约束
-    if (isRequired) {
-      def += ' NOT NULL';
-    } else {
-      def += ' NULL';
-    }
-
-    // 默认值
-    if (schema.default !== undefined) {
-      const defaultValue = this._formatDefaultValue(schema.default, schema.type);
-      def += ` DEFAULT ${defaultValue}`;
-    }
-
-    // 注释
-    if (schema.description) {
-      def += ` COMMENT '${this._escapeString(schema.description)}'`;
-    }
-
-    return def;
-  }
-
-  /**
-   * 格式化默认值
-   * @private
-   * @param {*} value - 默认值
-   * @param {string} type - 类型
-   * @returns {string} 格式化后的默认值
-   */
-  _formatDefaultValue(value, type) {
-    if (value === null) {
-      return 'NULL';
-    }
-
-    if (type === 'string') {
-      return `'${this._escapeString(value)}'`;
-    }
-
-    if (type === 'boolean') {
-      return value ? '1' : '0';
-    }
-
-    return value.toString();
-  }
-
-  /**
-   * 转义字符串
-   * @private
-   * @param {string} str - 字符串
-   * @returns {string} 转义后的字符串
-   */
-  _escapeString(str) {
-    return str.replace(/'/g, "''");
-  }
-
-  /**
-   * 检测主键
-   * @private
-   * @param {Object} schema - JSON Schema对象
-   * @returns {string|null} 主键列名
-   */
-  _detectPrimaryKey(schema) {
-    if (!schema.properties) {
-      return null;
-    }
-
-    // 查找名为id或_id的字段
-    if (schema.properties.id) {
-      return 'id';
-    }
-    if (schema.properties._id) {
-      return '_id';
-    }
-
-    return null;
-  }
-
-  /**
-   * 生成索引DDL
-   * @param {string} tableName - 表名
-   * @param {string} columnName - 列名
-   * @param {Object} options - 索引选项
-   * @returns {string} CREATE INDEX语句
-   */
-  generateIndex(tableName, columnName, options = {}) {
-    const indexName = options.name || `idx_${tableName}_${columnName}`;
-    const unique = options.unique ? 'UNIQUE ' : '';
-
-    return `CREATE ${unique}INDEX \`${indexName}\` ON \`${tableName}\` (\`${columnName}\`);`;
-  }
-
-  /**
-   * 静态方法：快速导出
-   * @static
-   * @param {string} tableName - 表名
-   * @param {Object} jsonSchema - JSON Schema对象
-   * @returns {string} MySQL DDL语句
-   */
-  static export(tableName, jsonSchema) {
-    const exporter = new MySQLExporter();
-    return exporter.export(tableName, jsonSchema);
-  }
-}
-
-module.exports = MySQLExporter;
-

package/lib/exporters/PostgreSQLExporter.js

@@ -1,289 +0,0 @@
-/**
- * PostgreSQL DDL导出器
- *
- * 将JSON Schema转换为PostgreSQL CREATE TABLE语句
- *
- * @module lib/exporters/PostgreSQLExporter
- * @version 1.0.0
- */
-
-const TypeConverter = require('../utils/TypeConverter');
-
-/**
- * PostgreSQL导出器类
- * @class PostgreSQLExporter
- */
-class PostgreSQLExporter {
-  /**
-   * 构造函数
-   * @param {Object} options - 配置选项
-   * @param {string} options.schema - PostgreSQL schema名称（默认public）
-   */
-  constructor(options = {}) {
-    this.options = {
-      schema: options.schema || 'public',
-      ...options
-    };
-  }
-
-  /**
-   * 导出为PostgreSQL CREATE TABLE语句
-   * @param {string} tableName - 表名
-   * @param {Object} jsonSchema - JSON Schema对象
-   * @returns {string} PostgreSQL DDL语句
-   */
-  export(tableName, jsonSchema) {
-    if (!tableName || typeof tableName !== 'string') {
-      throw new Error('Table name is required');
-    }
-    if (!jsonSchema || jsonSchema.type !== 'object') {
-      throw new Error('JSON Schema must be an object type');
-    }
-
-    const fullTableName = `${this.options.schema}.${tableName}`;
-    const columns = this._convertProperties(jsonSchema);
-    const primaryKey = this._detectPrimaryKey(jsonSchema);
-
-    let ddl = `CREATE TABLE ${fullTableName} (\n`;
-
-    // 添加列定义
-    const columnDefs = columns.map(col => `  ${col}`).join(',\n');
-    ddl += columnDefs;
-
-    // 添加主键
-    if (primaryKey) {
-      ddl += `,\n  PRIMARY KEY (${primaryKey})`;
-    }
-
-    ddl += `\n);`;
-
-    // 添加表注释
-    if (jsonSchema.description) {
-      ddl += `\n\nCOMMENT ON TABLE ${fullTableName} IS '${this._escapeString(jsonSchema.description)}';`;
-    }
-
-    // 添加列注释
-    const commentDdls = this._generateColumnComments(fullTableName, jsonSchema);
-    if (commentDdls.length > 0) {
-      ddl += '\n\n' + commentDdls.join('\n');
-    }
-
-    return ddl;
-  }
-
-  /**
-   * 转换properties为列定义
-   * @private
-   * @param {Object} schema - JSON Schema对象
-   * @returns {Array<string>} 列定义数组
-   */
-  _convertProperties(schema) {
-    if (!schema.properties) {
-      return [];
-    }
-
-    const columns = [];
-    const required = schema.required || [];
-
-    for (const [name, propSchema] of Object.entries(schema.properties)) {
-      const columnDef = this._convertColumn(name, propSchema, required.includes(name));
-      columns.push(columnDef);
-    }
-
-    return columns;
-  }
-
-  /**
-   * 转换单个列
-   * @private
-   * @param {string} name - 列名
-   * @param {Object} schema - 属性Schema
-   * @param {boolean} isRequired - 是否必填
-   * @returns {string} 列定义字符串
-   */
-  _convertColumn(name, schema, isRequired) {
-    const constraints = TypeConverter.extractConstraints(schema);
-    const pgType = TypeConverter.toPostgreSQLType(schema.type, constraints);
-
-    let def = `${name} ${pgType}`;
-
-    // NULL约束
-    if (isRequired) {
-      def += ' NOT NULL';
-    }
-
-    // 默认值
-    if (schema.default !== undefined) {
-      const defaultValue = this._formatDefaultValue(schema.default, schema.type);
-      def += ` DEFAULT ${defaultValue}`;
-    }
-
-    // UNIQUE约束
-    if (schema.format === 'email' || schema.format === 'uuid') {
-      // email和uuid通常是唯一的
-      // def += ' UNIQUE'; // 可选
-    }
-
-    // CHECK约束
-    const checkConstraints = this._generateCheckConstraints(name, schema);
-    if (checkConstraints.length > 0) {
-      def += ' ' + checkConstraints.join(' ');
-    }
-
-    return def;
-  }
-
-  /**
-   * 生成CHECK约束
-   * @private
-   * @param {string} columnName - 列名
-   * @param {Object} schema - 属性Schema
-   * @returns {Array<string>} CHECK约束数组
-   */
-  _generateCheckConstraints(columnName, schema) {
-    const checks = [];
-
-    // 字符串长度
-    if (schema.minLength !== undefined || schema.maxLength !== undefined) {
-      if (schema.minLength !== undefined && schema.maxLength !== undefined) {
-        checks.push(`CHECK (LENGTH(${columnName}) BETWEEN ${schema.minLength} AND ${schema.maxLength})`);
-      } else if (schema.minLength !== undefined) {
-        checks.push(`CHECK (LENGTH(${columnName}) >= ${schema.minLength})`);
-      } else {
-        checks.push(`CHECK (LENGTH(${columnName}) <= ${schema.maxLength})`);
-      }
-    }
-
-    // 数值范围
-    if (schema.minimum !== undefined || schema.maximum !== undefined) {
-      if (schema.minimum !== undefined && schema.maximum !== undefined) {
-        checks.push(`CHECK (${columnName} BETWEEN ${schema.minimum} AND ${schema.maximum})`);
-      } else if (schema.minimum !== undefined) {
-        checks.push(`CHECK (${columnName} >= ${schema.minimum})`);
-      } else {
-        checks.push(`CHECK (${columnName} <= ${schema.maximum})`);
-      }
-    }
-
-    // 枚举
-    if (schema.enum) {
-      const values = schema.enum.map(v => `'${this._escapeString(v)}'`).join(', ');
-      checks.push(`CHECK (${columnName} IN (${values}))`);
-    }
-
-    return checks;
-  }
-
-  /**
-   * 格式化默认值
-   * @private
-   * @param {*} value - 默认值
-   * @param {string} type - 类型
-   * @returns {string} 格式化后的默认值
-   */
-  _formatDefaultValue(value, type) {
-    if (value === null) {
-      return 'NULL';
-    }
-
-    if (type === 'string') {
-      return `'${this._escapeString(value)}'`;
-    }
-
-    if (type === 'boolean') {
-      return value ? 'TRUE' : 'FALSE';
-    }
-
-    if (type === 'object' || type === 'array') {
-      return `'${JSON.stringify(value)}'::JSONB`;
-    }
-
-    return value.toString();
-  }
-
-  /**
-   * 转义字符串
-   * @private
-   * @param {string} str - 字符串
-   * @returns {string} 转义后的字符串
-   */
-  _escapeString(str) {
-    return str.replace(/'/g, "''");
-  }
-
-  /**
-   * 检测主键
-   * @private
-   * @param {Object} schema - JSON Schema对象
-   * @returns {string|null} 主键列名
-   */
-  _detectPrimaryKey(schema) {
-    if (!schema.properties) {
-      return null;
-    }
-
-    // 查找名为id或_id的字段
-    if (schema.properties.id) {
-      return 'id';
-    }
-    if (schema.properties._id) {
-      return '_id';
-    }
-
-    return null;
-  }
-
-  /**
-   * 生成列注释
-   * @private
-   * @param {string} tableName - 表名
-   * @param {Object} schema - JSON Schema对象
-   * @returns {Array<string>} COMMENT语句数组
-   */
-  _generateColumnComments(tableName, schema) {
-    if (!schema.properties) {
-      return [];
-    }
-
-    const comments = [];
-
-    for (const [name, propSchema] of Object.entries(schema.properties)) {
-      if (propSchema.description) {
-        comments.push(`COMMENT ON COLUMN ${tableName}.${name} IS '${this._escapeString(propSchema.description)}';`);
-      }
-    }
-
-    return comments;
-  }
-
-  /**
-   * 生成索引DDL
-   * @param {string} tableName - 表名
-   * @param {string} columnName - 列名
-   * @param {Object} options - 索引选项
-   * @returns {string} CREATE INDEX语句
-   */
-  generateIndex(tableName, columnName, options = {}) {
-    const fullTableName = `${this.options.schema}.${tableName}`;
-    const indexName = options.name || `idx_${tableName}_${columnName}`;
-    const unique = options.unique ? 'UNIQUE ' : '';
-    const method = options.method || 'btree'; // btree, hash, gin, gist
-
-    return `CREATE ${unique}INDEX ${indexName} ON ${fullTableName} USING ${method} (${columnName});`;
-  }
-
-  /**
-   * 静态方法：快速导出
-   * @static
-   * @param {string} tableName - 表名
-   * @param {Object} jsonSchema - JSON Schema对象
-   * @returns {string} PostgreSQL DDL语句
-   */
-  static export(tableName, jsonSchema) {
-    const exporter = new PostgreSQLExporter();
-    return exporter.export(tableName, jsonSchema);
-  }
-}
-
-module.exports = PostgreSQLExporter;
-

package/lib/exporters/index.js

@@ -1,24 +0,0 @@
-/**
- * Exporters - 导出器统一导出
- * @module lib/exporters
- */
-
-const MongoDBExporter = require('./MongoDBExporter');
-const MySQLExporter = require('./MySQLExporter');
-const PostgreSQLExporter = require('./PostgreSQLExporter');
-const MarkdownExporter = require('./MarkdownExporter');
-
-module.exports = {
-  MongoDBExporter,
-  MySQLExporter,
-  PostgreSQLExporter,
-  MarkdownExporter,
-
-  // 别名
-  MongoDB: MongoDBExporter,
-  MySQL: MySQLExporter,
-  PostgreSQL: PostgreSQLExporter,
-  Postgres: PostgreSQLExporter,
-  Markdown: MarkdownExporter
-};
-

package/lib/locales/index.js

@@ -1,8 +0,0 @@
-module.exports = {
-  'zh-CN': require('./zh-CN'),
-  'en-US': require('./en-US'),
-  'ja-JP': require('./ja-JP'),
-  'es-ES': require('./es-ES'),
-  'fr-FR': require('./fr-FR')
-};
-

package/lib/utils/LRUCache.js

@@ -1,174 +0,0 @@
-/**
- * 带内存管理的 LRU 缓存实现
- * 用于安全缓存语言包消息，防止内存泄漏
- * 
- * @module lib/utils/LRUCache
- * @version 2.2.1
- */
-
-/**
- * LRU (Least Recently Used) 缓存
- * 自动清理最少使用的条目，确保内存占用可控
- */
-class LRUCache {
-    /**
-     * 创建 LRU 缓存实例
-     * @param {Object} options - 配置选项
-     * @param {number} [options.maxSize=10] - 最大缓存数量
-     * @param {boolean} [options.enableStats=false] - 是否启用统计
-     */
-    constructor(options = {}) {
-        this.maxSize = options.maxSize || 10;
-        this.enableStats = options.enableStats || false;
-        this.cache = new Map();
-
-        if (this.enableStats) {
-            this.stats = {
-                hits: 0,
-                misses: 0,
-                evictions: 0,
-                sets: 0
-            };
-        }
-    }
-
-    /**
-     * 获取缓存值
-     * @param {string} key - 键
-     * @returns {*} 缓存的值，不存在则返回 undefined
-     */
-    get(key) {
-        if (!this.cache.has(key)) {
-            if (this.enableStats) this.stats.misses++;
-            return undefined;
-        }
-
-        if (this.enableStats) this.stats.hits++;
-
-        // LRU: 移到最后（标记为最近使用）
-        const value = this.cache.get(key);
-        this.cache.delete(key);
-        this.cache.set(key, value);
-
-        return value;
-    }
-
-    /**
-     * 设置缓存值
-     * @param {string} key - 键
-     * @param {*} value - 值
-     */
-    set(key, value) {
-        if (this.enableStats) this.stats.sets++;
-
-        // 如果已存在，先删除（更新顺序）
-        if (this.cache.has(key)) {
-            this.cache.delete(key);
-        }
-
-        // 如果超过容量，删除最旧的（最少使用）
-        if (this.cache.size >= this.maxSize) {
-            const firstKey = this.cache.keys().next().value;
-            this.cache.delete(firstKey);
-
-            if (this.enableStats) this.stats.evictions++;
-
-            // 开发环境警告
-            if (process.env.NODE_ENV === 'development') {
-                console.warn(`[LRUCache] Evicted key: ${firstKey} (cache full: ${this.maxSize})`);
-            }
-        }
-
-        this.cache.set(key, value);
-    }
-
-    /**
-     * 检查键是否存在
-     * @param {string} key - 键
-     * @returns {boolean} 是否存在
-     */
-    has(key) {
-        return this.cache.has(key);
-    }
-
-    /**
-     * 删除指定键
-     * @param {string} key - 键
-     * @returns {boolean} 是否删除成功
-     */
-    delete(key) {
-        return this.cache.delete(key);
-    }
-
-    /**
-     * 清空所有缓存
-     */
-    clear() {
-        this.cache.clear();
-
-        if (this.enableStats) {
-            this.stats = {
-                hits: 0,
-                misses: 0,
-                evictions: 0,
-                sets: 0
-            };
-        }
-    }
-
-    /**
-     * 获取当前缓存大小
-     * @returns {number} 缓存条目数量
-     */
-    get size() {
-        return this.cache.size;
-    }
-
-    /**
-     * 获取所有键
-     * @returns {Array<string>} 键数组
-     */
-    keys() {
-        return Array.from(this.cache.keys());
-    }
-
-    /**
-     * 获取缓存统计信息
-     * @returns {Object} 统计信息
-     */
-    getStats() {
-        if (!this.enableStats) {
-            return { message: 'Stats not enabled. Set enableStats: true in constructor.' };
-        }
-
-        const total = this.stats.hits + this.stats.misses;
-        const hitRate = total > 0 ? (this.stats.hits / total * 100).toFixed(2) : 0;
-
-        return {
-            hits: this.stats.hits,
-            misses: this.stats.misses,
-            evictions: this.stats.evictions,
-            sets: this.stats.sets,
-            hitRate: `${hitRate}%`,
-            size: this.cache.size,
-            maxSize: this.maxSize,
-            efficiency: hitRate >= 80 ? '优秀' : hitRate >= 60 ? '良好' : '需优化'
-        };
-    }
-
-    /**
-     * 重置统计信息
-     */
-    resetStats() {
-        if (this.enableStats) {
-            this.stats = {
-                hits: 0,
-                misses: 0,
-                evictions: 0,
-                sets: 0
-            };
-        }
-    }
-}
-
-module.exports = LRUCache;