schema-dsl 1.2.4 → 2.0.0

package/src/utils/TypeConverter.ts

@@ -0,0 +1,215 @@
+/**
+ * TypeConverter — Schema type conversion utilities (static methods).
+ *
+ * Maps JSON Schema types to target-format types:
+ *   - JSON Schema type
+ *   - MongoDB BSON type
+ *   - MySQL column type
+ *   - PostgreSQL column type
+ *
+ * Also includes format helpers: normalizePropertyName, formatToRegex, mergeSchemas, extractConstraints.
+ */
+
+import type { JSONSchema } from '../types/schema.js'
+
+// ==================== Type aliases ====================
+
+export type JSType = string | string[]
+
+const MYSQL_INTEGER_RANGES = [
+  { type: 'TINYINT', min: -128, max: 127 },
+  { type: 'SMALLINT', min: -32768, max: 32767 },
+  { type: 'INT', min: -2147483648, max: 2147483647 },
+] as const
+
+// ==================== TypeConverter ====================
+
+export class TypeConverter {
+  // ========== JSON Schema types ==========
+
+  static toJSONSchemaType(nativeType: string): string {
+    const mapping: Record<string, string> = {
+      string: 'string',
+      number: 'number',
+      integer: 'integer',
+      boolean: 'boolean',
+      object: 'object',
+      array: 'array',
+      null: 'null',
+      any: 'string',
+      email: 'string',
+      url: 'string',
+      uuid: 'string',
+      date: 'string',
+      datetime: 'string',
+    }
+    return mapping[nativeType.toLowerCase()] ?? 'string'
+  }
+
+  // ========== MongoDB types ==========
+
+  static toMongoDBType(jsonSchemaType: JSType): string {
+    const t = Array.isArray(jsonSchemaType) ? jsonSchemaType[0] : jsonSchemaType
+    const mapping: Record<string, string> = {
+      string: 'string',
+      number: 'double',
+      integer: 'int',
+      boolean: 'bool',
+      object: 'object',
+      array: 'array',
+      null: 'null',
+    }
+    return mapping[String(t).toLowerCase()] ?? 'string'
+  }
+
+  // ========== MySQL types ==========
+
+  static toMySQLType(jsonSchemaType: JSType, schema?: JSONSchema): string {
+    const t = Array.isArray(jsonSchemaType) ? jsonSchemaType[0] : jsonSchemaType
+
+    // Enum detection: if schema has enum values, use ENUM type
+    if (schema?.enum && Array.isArray(schema.enum)) {
+      const values = (schema.enum as unknown[]).map(v => `'${String(v).replace(/'/g, "''")}'`).join(', ')
+      return `ENUM(${values})`
+    }
+
+    switch (String(t).toLowerCase()) {
+      case 'string': {
+        // Check for date format
+        if (schema?.format === 'date' || schema?.format === 'date-time') {
+          return 'DATETIME'
+        }
+        const maxLen = schema?.maxLength ?? 255
+        if (maxLen <= 255) return `VARCHAR(${maxLen})`
+        if (maxLen <= 65535) return 'TEXT'
+        return 'LONGTEXT'
+      }
+      case 'number':
+        return 'DOUBLE'
+      case 'integer': {
+        const max = schema?.maximum
+        const min = schema?.minimum
+
+        for (const range of MYSQL_INTEGER_RANGES) {
+          if (min !== undefined && max !== undefined && min >= range.min && max <= range.max) {
+            return range.type
+          }
+        }
+
+        return 'BIGINT'
+      }
+      case 'boolean':
+        return 'BOOLEAN'
+      case 'object':
+        return 'JSON'
+      case 'array':
+        return 'JSON'
+      case 'null':
+        return 'NULL'
+      default:
+        return 'VARCHAR(255)'
+    }
+  }
+
+  // ========== PostgreSQL types ==========
+
+  static toPostgreSQLType(jsonSchemaType: JSType, schema?: JSONSchema): string {
+    const t = Array.isArray(jsonSchemaType) ? jsonSchemaType[0] : jsonSchemaType
+
+    switch (String(t).toLowerCase()) {
+      case 'string': {
+        // Handle date format
+        if (schema?.format === 'date') return 'DATE'
+        if (schema?.format === 'date-time') return 'TIMESTAMP'
+        const maxLen = schema?.maxLength
+        if (maxLen !== undefined && maxLen <= 255) return `VARCHAR(${maxLen})`
+        if (maxLen !== undefined) return 'TEXT'
+        return 'VARCHAR(255)'
+      }
+      case 'number':
+        return 'DOUBLE PRECISION'
+      case 'integer':
+        return 'BIGINT'
+      case 'boolean':
+        return 'BOOLEAN'
+      case 'object':
+        return 'JSONB'
+      case 'array':
+        return 'JSONB'
+      case 'null':
+        return 'NULL'
+      default:
+        return 'TEXT'
+    }
+  }
+
+  // ========== Property name normalisation ==========
+
+  static normalizePropertyName(name: string): string {
+    return name
+      .trim()
+      .replace(/[^a-zA-Z0-9_]/g, '_')
+      .replace(/^(\d)/, '_$1')
+      .replace(/_+/g, '_')
+      .replace(/^_+|_+$/g, '')
+  }
+
+  // ========== Format → RegExp ==========
+
+  static formatToRegex(format: string): RegExp | null {
+    const formats: Record<string, RegExp> = {
+      email: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
+      uri: /^https?:\/\/.+/,
+      date: /^\d{4}-\d{2}-\d{2}$/,
+      'date-time': /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$/,
+      time: /^\d{2}:\d{2}:\d{2}$/,
+      uuid: /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,
+      ipv4: /^(\d{1,3}\.){3}\d{1,3}$/,
+      ipv6: /^[0-9a-f:]+$/i,
+    }
+    return formats[format] ?? null
+  }
+
+  // ========== Schema merging ==========
+
+  static mergeSchemas(...schemas: JSONSchema[]): JSONSchema {
+    const result: Record<string, unknown> = {}
+
+    for (const schema of schemas) {
+      for (const [key, value] of Object.entries(schema)) {
+        if (key === 'properties') {
+          result['properties'] = {
+            ...((result['properties'] as Record<string, unknown>) ?? {}),
+            ...(value as Record<string, unknown>),
+          }
+        } else if (key === 'required') {
+          const existing = (result['required'] as string[]) ?? []
+          result['required'] = [...new Set([...existing, ...(value as string[])])]
+        } else {
+          result[key] = value
+        }
+      }
+    }
+
+    return result as JSONSchema
+  }
+
+  // ========== Constraint extraction ==========
+
+  static extractConstraints(schema: JSONSchema): Record<string, unknown> {
+    const constraintKeys = [
+      'minimum', 'maximum', 'exclusiveMinimum', 'exclusiveMaximum',
+      'multipleOf', 'minLength', 'maxLength', 'pattern',
+      'minItems', 'maxItems', 'uniqueItems', 'minProperties', 'maxProperties',
+      'enum', 'format', 'const',
+    ] as const
+
+    const result: Record<string, unknown> = {}
+    for (const key of constraintKeys) {
+      if (key in schema) {
+        result[key] = (schema as Record<string, unknown>)[key]
+      }
+    }
+    return result
+  }
+}

package/src/utils/index.ts

@@ -0,0 +1,10 @@
+/**
+ * src/utils/index.ts — Utility library unified exports.
+ */
+
+export { TypeConverter } from './TypeConverter.js'
+export type { JSType } from './TypeConverter.js'
+
+export { SchemaHelper } from './SchemaHelper.js'
+
+export { SchemaUtils } from './SchemaUtils.js'