rawsql-ts 0.19.0 → 0.21.0

package/dist/utils/SchemaManager.js

@@ -1,7 +1,7 @@
 "use strict";
 /**
  * Central schema management utility for rawsql-ts.
- * Converts user-defined table definitions into resolvers and JSON mappings consumed by collectors and builders.
+ * Converts user-defined table definitions into resolvers consumed by collectors and builders.
  *
  * @example
  * ```typescript
@@ -25,11 +25,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SchemaManager = void 0;
 exports.createSchemaManager = createSchemaManager;
 exports.createTableColumnResolver = createTableColumnResolver;
-exports.createJsonMappingFromSchema = createJsonMappingFromSchema;
 // === Schema Manager Class ===
 /**
  * Central schema management utility for rawsql-ts
- * Converts user-defined schemas to various internal formats
+ * Converts user-defined schemas to resolvers consumed by schema-aware utilities
  */
 class SchemaManager {
     constructor(schemas) {
@@ -84,56 +83,6 @@ class SchemaManager {
     createTableColumnResolver() {
         return (tableName) => this.getTableColumns(tableName);
     }
-    /**
-     * Generate JSON mapping configuration for PostgresJsonQueryBuilder
-     * @param rootTableName Root table for the JSON structure
-     * @returns JSON mapping configuration
-     */
-    createJsonMapping(rootTableName) {
-        var _a;
-        const rootTable = this.schemas[rootTableName];
-        if (!rootTable) {
-            throw new Error(`Table '${rootTableName}' not found in schema registry`);
-        }
-        // Build root entity columns mapping
-        const rootColumns = {};
-        Object.entries(rootTable.columns).forEach(([columnName, column]) => {
-            rootColumns[columnName] = column.jsonAlias || column.name;
-        });
-        // Build nested entities from relationships
-        const nestedEntities = [];
-        (_a = rootTable.relationships) === null || _a === void 0 ? void 0 : _a.forEach(rel => {
-            const relatedTable = this.schemas[rel.table];
-            if (!relatedTable) {
-                throw new Error(`Related table '${rel.table}' not found in schema registry`);
-            }
-            // Build columns mapping for related table
-            const relatedColumns = {};
-            Object.entries(relatedTable.columns).forEach(([columnName, column]) => {
-                relatedColumns[columnName] = column.jsonAlias || column.name;
-            });
-            // Determine relationship type for JSON builder
-            const relationshipType = rel.type;
-            nestedEntities.push({
-                id: rel.propertyName,
-                name: relatedTable.displayName || rel.table,
-                parentId: rootTableName,
-                propertyName: rel.propertyName,
-                relationshipType: relationshipType,
-                columns: relatedColumns
-            });
-        });
-        return {
-            rootName: rootTableName,
-            rootEntity: {
-                id: rootTableName,
-                name: rootTable.displayName || rootTableName,
-                columns: rootColumns
-            },
-            nestedEntities,
-            resultFormat: "single"
-        };
-    }
     /**
      * Get all table names in the schema
      * @returns Array of table names
@@ -204,14 +153,4 @@ function createTableColumnResolver(schemas) {
     const manager = new SchemaManager(schemas);
     return manager.createTableColumnResolver();
 }
-/**
- * Create JSON mapping from schema definitions
- * @param schemas Schema registry object
- * @param rootTableName Root table name
- * @returns JSON mapping for PostgresJsonQueryBuilder
- */
-function createJsonMappingFromSchema(schemas, rootTableName) {
-    const manager = new SchemaManager(schemas);
-    return manager.createJsonMapping(rootTableName);
-}
 //# sourceMappingURL=SchemaManager.js.map

package/dist/utils/SchemaManager.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rawsql-ts",
-  "version": "0.19.0",
+  "version": "0.21.0",
   "description": "High-performance SQL parser and AST analyzer written in TypeScript. Provides fast parsing and advanced transformation capabilities.",
   "main": "dist/index.js",
   "module": "dist/esm/index.js",
@@ -26,6 +26,8 @@
     "access": "public"
   },
   "devDependencies": {
+    "@appland/sql-parser": "^1.5.1",
+    "@guanmingchiu/sqlparser-ts": "^0.61.1",
     "@types/benchmark": "^2.1.5",
     "@types/node": "^22.13.10",
     "@typescript-eslint/eslint-plugin": "^8.26.1",
@@ -38,9 +40,13 @@
     "eslint-plugin-filenames": "^1.3.2",
     "eslint-plugin-prettier": "^5.2.3",
     "microtime": "^3.1.1",
+    "mitata": "^1.0.34",
     "node-sql-parser": "^5.4.0",
+    "pgsql-ast-parser": "^12.0.2",
     "sql-formatter": "^15.5.2",
+    "sqlite-parser": "^1.0.1",
     "sql-parser-cst": "^0.33.1",
+    "sqlite3-parser": "^0.7.1",
     "ts-node": "^10.9.2",
     "typescript": "^5.8.2",
     "vitest": "^4.0.15"
@@ -60,6 +66,8 @@
     "clean": "tsc --build --clean && node -e \"const fs = require('fs'); if (fs.existsSync('dist')) fs.rmSync('dist', {recursive: true, force: true});\"",
     "lint": "eslint . --ext .ts,.tsx --fix",
     "postbuild": "node ../../scripts/sync-rawsql-dist.js",
-    "benchmark": "ts-node ../../benchmarks/parse-benchmark.ts"
+    "benchmark": "ts-node ../../benchmarks/parse-benchmark.ts",
+    "benchmark:sqlite3-parser": "ts-node ../../benchmarks/sqlite3-parser-benchmark.ts",
+    "benchmark:sqlite3-parser:bun": "bun ../../benchmarks/sqlite3-parser-bun-benchmark.ts"
   }
 }

package/dist/esm/transformers/EnhancedJsonMapping.d.ts

@@ -1,194 +0,0 @@
-/**
- * Enhanced JSON mapping structure that extends the base JsonMapping interface
- * with additional metadata and type safety features.
- */
-/**
- * Supported column types for enhanced mapping.
- */
-export type ColumnType = 'string' | 'number' | 'boolean' | 'date' | 'auto';
-/**
- * Enhanced column configuration that supports both simple and complex mappings.
- */
-export interface ColumnConfig {
-    /** Source column name */
-    column: string;
-    /** Type enforcement for this column */
-    type?: ColumnType;
-    /** Whether this field is nullable */
-    nullable?: boolean;
-    /** Custom transformation function */
-    transform?: string;
-}
-/**
- * Column mapping can be either a simple string or enhanced configuration.
- */
-export type ColumnMapping = string | ColumnConfig;
-/**
- * Enhanced entity definition with additional metadata.
- */
-export interface EnhancedEntity {
-    id: string;
-    name: string;
-    columns: Record<string, ColumnMapping>;
-    /** Entity description for documentation */
-    description?: string;
-}
-/**
- * Enhanced nested entity with relationship metadata.
- */
-export interface EnhancedNestedEntity extends EnhancedEntity {
-    parentId: string;
-    propertyName: string;
-    relationshipType: 'object' | 'array';
-    /** Join condition for complex relationships */
-    joinCondition?: string;
-}
-/**
- * Type protection configuration.
- */
-export interface TypeProtectionConfig {
-    /** Columns that should be treated as strings */
-    protectedStringFields: string[];
-    /** Columns that should be parsed as dates */
-    dateFields?: string[];
-    /** Columns that should be parsed as numbers */
-    numberFields?: string[];
-    /** Custom type transformations */
-    customTransforms?: Record<string, string>;
-}
-/**
- * Enhanced JSON mapping with type safety and metadata support.
- */
-export interface EnhancedJsonMapping {
-    /** Root entity name */
-    rootName: string;
-    /** Root entity definition */
-    rootEntity: EnhancedEntity;
-    /** Nested entities */
-    nestedEntities: EnhancedNestedEntity[];
-    /** Result format */
-    resultFormat?: 'array' | 'single';
-    /** Empty result fallback */
-    emptyResult?: string;
-    /** Type information */
-    typeInfo?: {
-        interface: string;
-        importPath: string;
-        generics?: string[];
-    };
-    /** Type protection configuration */
-    typeProtection?: TypeProtectionConfig;
-    /** Mapping metadata */
-    metadata?: {
-        version: string;
-        description?: string;
-        author?: string;
-        createdAt?: string;
-        updatedAt?: string;
-    };
-}
-/**
- * Legacy JSON mapping interface (from PostgresJsonQueryBuilder).
- */
-export interface LegacyJsonMapping {
-    rootName: string;
-    rootEntity: {
-        id: string;
-        name: string;
-        columns: {
-            [jsonKey: string]: string;
-        };
-    };
-    nestedEntities: Array<{
-        id: string;
-        name: string;
-        parentId: string;
-        propertyName: string;
-        relationshipType?: "object" | "array";
-        columns: {
-            [jsonKey: string]: string;
-        };
-    }>;
-    resultFormat?: "array" | "single";
-    emptyResult?: string;
-}
-/**
- * Converts enhanced column configurations to simple string mappings for legacy compatibility.
- *
- * This function transforms complex column configurations (with type info, nullable flags, etc.)
- * into simple string mappings that can be used with PostgresJsonQueryBuilder.
- *
- * **Supported Input Formats:**
- * - Simple strings: `"user_name"` → `"user_name"`
- * - Column config: `{ column: "u.name", type: "string" }` → `"u.name"`
- * - From config: `{ from: "user_name", nullable: true }` → `"user_name"`
- *
- * @param columns - Record of field names to column configurations
- * @returns Record of field names to column source strings
- *
- * @example
- * ```typescript
- * const enhanced = {
- *   id: { column: "u.user_id", type: "number" },
- *   name: { from: "user_name", type: "string" },
- *   email: "email_address"
- * };
- *
- * const legacy = convertColumnsToLegacy(enhanced);
- * // Result: { id: "u.user_id", name: "user_name", email: "email_address" }
- * ```
- */
-export declare function convertColumnsToLegacy(columns: Record<string, any>): Record<string, string>;
-/**
- * Converts any unified JSON mapping format to legacy JsonMapping format.
- *
- * This universal converter handles Enhanced, Unified, and Legacy formats, providing
- * a single interface for converting complex mapping configurations to the simple
- * format expected by PostgresJsonQueryBuilder.
- *
- * **Supported Input Formats:**
- * - **Enhanced**: With metadata, type protection, and advanced column configs
- * - **Unified**: Standard format with rootName and rootEntity
- * - **Legacy**: Already compatible format (returned as-is)
- *
- * **Features:**
- * - Automatic format detection
- * - Column configuration simplification
- * - Nested entity handling
- * - Type protection extraction
- *
- * @param input - JSON mapping in any supported format
- * @returns Legacy JsonMapping compatible with PostgresJsonQueryBuilder
- *
- * @throws {Error} When input is null, undefined, or malformed
- *
- * @example
- * ```typescript
- * // Enhanced format input
- * const enhanced = {
- *   rootName: "User",
- *   rootEntity: {
- *     columns: {
- *       id: { column: "u.user_id", type: "number" },
- *       name: { column: "u.user_name", type: "string" }
- *     }
- *   },
- *   metadata: { version: "2.0" }
- * };
- *
- * const legacy = convertToLegacyJsonMapping(enhanced);
- * // Result: Compatible with PostgresJsonQueryBuilder
- * ```
- *
- * @see {@link convertColumnsToLegacy} For column-specific conversion
- * @see {@link extractTypeProtection} For type safety features
- */
-export declare function convertToLegacyJsonMapping(input: any): LegacyJsonMapping;
-/**
- * Converts enhanced mapping to legacy format for backward compatibility.
- */
-export declare function toLegacyMapping(enhanced: EnhancedJsonMapping): LegacyJsonMapping;
-/**
- * Extracts type protection configuration from enhanced mapping.
- */
-export declare function extractTypeProtection(enhanced: EnhancedJsonMapping): TypeProtectionConfig;

package/dist/esm/transformers/EnhancedJsonMapping.js

@@ -1,217 +0,0 @@
-/**
- * Enhanced JSON mapping structure that extends the base JsonMapping interface
- * with additional metadata and type safety features.
- */
-/**
- * Converts enhanced column configurations to simple string mappings for legacy compatibility.
- *
- * This function transforms complex column configurations (with type info, nullable flags, etc.)
- * into simple string mappings that can be used with PostgresJsonQueryBuilder.
- *
- * **Supported Input Formats:**
- * - Simple strings: `"user_name"` → `"user_name"`
- * - Column config: `{ column: "u.name", type: "string" }` → `"u.name"`
- * - From config: `{ from: "user_name", nullable: true }` → `"user_name"`
- *
- * @param columns - Record of field names to column configurations
- * @returns Record of field names to column source strings
- *
- * @example
- * ```typescript
- * const enhanced = {
- *   id: { column: "u.user_id", type: "number" },
- *   name: { from: "user_name", type: "string" },
- *   email: "email_address"
- * };
- *
- * const legacy = convertColumnsToLegacy(enhanced);
- * // Result: { id: "u.user_id", name: "user_name", email: "email_address" }
- * ```
- */
-export function convertColumnsToLegacy(columns) {
-    const result = {};
-    for (const [key, config] of Object.entries(columns)) {
-        if (typeof config === 'string') {
-            result[key] = config;
-        }
-        else if (config && typeof config === 'object') {
-            if ('column' in config) {
-                result[key] = config.column;
-            }
-            else if ('from' in config) {
-                result[key] = config.from;
-            }
-            else {
-                result[key] = key; // fallback
-            }
-        }
-        else {
-            result[key] = key; // fallback
-        }
-    }
-    return result;
-}
-/**
- * Converts any unified JSON mapping format to legacy JsonMapping format.
- *
- * This universal converter handles Enhanced, Unified, and Legacy formats, providing
- * a single interface for converting complex mapping configurations to the simple
- * format expected by PostgresJsonQueryBuilder.
- *
- * **Supported Input Formats:**
- * - **Enhanced**: With metadata, type protection, and advanced column configs
- * - **Unified**: Standard format with rootName and rootEntity
- * - **Legacy**: Already compatible format (returned as-is)
- *
- * **Features:**
- * - Automatic format detection
- * - Column configuration simplification
- * - Nested entity handling
- * - Type protection extraction
- *
- * @param input - JSON mapping in any supported format
- * @returns Legacy JsonMapping compatible with PostgresJsonQueryBuilder
- *
- * @throws {Error} When input is null, undefined, or malformed
- *
- * @example
- * ```typescript
- * // Enhanced format input
- * const enhanced = {
- *   rootName: "User",
- *   rootEntity: {
- *     columns: {
- *       id: { column: "u.user_id", type: "number" },
- *       name: { column: "u.user_name", type: "string" }
- *     }
- *   },
- *   metadata: { version: "2.0" }
- * };
- *
- * const legacy = convertToLegacyJsonMapping(enhanced);
- * // Result: Compatible with PostgresJsonQueryBuilder
- * ```
- *
- * @see {@link convertColumnsToLegacy} For column-specific conversion
- * @see {@link extractTypeProtection} For type safety features
- */
-export function convertToLegacyJsonMapping(input) {
-    if (!input) {
-        throw new Error('Input mapping is required');
-    }
-    // If it's already in legacy format, return as-is
-    if (input.rootName && input.rootEntity &&
-        typeof input.rootEntity.columns === 'object' &&
-        !input.typeInfo && !input.typeProtection && !input.metadata) {
-        // Check if columns are already in string format
-        const allColumnsAreStrings = Object.values(input.rootEntity.columns).every(col => typeof col === 'string');
-        if (allColumnsAreStrings) {
-            return input;
-        }
-    }
-    // Enhanced format conversion
-    if (input.rootName && input.rootEntity) {
-        return {
-            rootName: input.rootName,
-            rootEntity: {
-                id: input.rootEntity.id || 'root',
-                name: input.rootEntity.name || input.rootName,
-                columns: convertColumnsToLegacy(input.rootEntity.columns || {})
-            },
-            nestedEntities: (input.nestedEntities || []).map((entity) => ({
-                id: entity.id,
-                name: entity.name,
-                parentId: entity.parentId,
-                propertyName: entity.propertyName,
-                relationshipType: entity.relationshipType,
-                columns: convertColumnsToLegacy(entity.columns || {})
-            })),
-            resultFormat: input.resultFormat,
-            emptyResult: input.emptyResult
-        };
-    }
-    throw new Error('Unsupported mapping format');
-}
-/**
- * Converts enhanced mapping to legacy format for backward compatibility.
- */
-export function toLegacyMapping(enhanced) {
-    return {
-        rootName: enhanced.rootName,
-        rootEntity: {
-            id: enhanced.rootEntity.id,
-            name: enhanced.rootEntity.name,
-            columns: convertColumnsToLegacy(enhanced.rootEntity.columns)
-        },
-        nestedEntities: enhanced.nestedEntities.map(entity => ({
-            id: entity.id,
-            name: entity.name,
-            parentId: entity.parentId,
-            propertyName: entity.propertyName,
-            relationshipType: entity.relationshipType,
-            columns: convertColumnsToLegacy(entity.columns)
-        })),
-        resultFormat: enhanced.resultFormat,
-        emptyResult: enhanced.emptyResult
-    };
-}
-/**
- * Extracts type protection configuration from enhanced mapping.
- */
-export function extractTypeProtection(enhanced) {
-    const protectedStringFields = [];
-    const dateFields = [];
-    const numberFields = [];
-    // Use existing type protection if available
-    if (enhanced.typeProtection) {
-        return {
-            protectedStringFields: enhanced.typeProtection.protectedStringFields || [],
-            dateFields: enhanced.typeProtection.dateFields,
-            numberFields: enhanced.typeProtection.numberFields,
-            customTransforms: enhanced.typeProtection.customTransforms
-        };
-    }
-    // Process root entity
-    for (const [key, config] of Object.entries(enhanced.rootEntity.columns)) {
-        if (typeof config === 'object' && config.type) {
-            const columnName = config.column;
-            switch (config.type) {
-                case 'string':
-                    protectedStringFields.push(columnName);
-                    break;
-                case 'date':
-                    dateFields.push(columnName);
-                    break;
-                case 'number':
-                    numberFields.push(columnName);
-                    break;
-            }
-        }
-    }
-    // Process nested entities
-    for (const entity of enhanced.nestedEntities) {
-        for (const [key, config] of Object.entries(entity.columns)) {
-            if (typeof config === 'object' && config.type) {
-                const columnName = config.column;
-                switch (config.type) {
-                    case 'string':
-                        protectedStringFields.push(columnName);
-                        break;
-                    case 'date':
-                        dateFields.push(columnName);
-                        break;
-                    case 'number':
-                        numberFields.push(columnName);
-                        break;
-                }
-            }
-        }
-    }
-    return {
-        protectedStringFields,
-        dateFields: dateFields.length > 0 ? dateFields : undefined,
-        numberFields: numberFields.length > 0 ? numberFields : undefined,
-        customTransforms: undefined
-    };
-}
-//# sourceMappingURL=EnhancedJsonMapping.js.map

package/dist/esm/transformers/EnhancedJsonMapping.js.map

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