@an5/orm 1.0.7 → 1.0.9

package/dist/generator/src/index.js

@@ -9,6 +9,7 @@ const code_generator_1 = require("./code-generator");
 const metadata_generator_1 = require("./metadata-generator");
 const python_generator_1 = require("./python-generator");
 const dotnet_generator_1 = require("./dotnet-generator");
+const golang_generator_1 = require("./golang-generator");
 const fs_1 = __importDefault(require("fs"));
 function clearGeneratedFiles(outputDir, extension) {
     if (!fs_1.default.existsSync(outputDir)) {
@@ -26,15 +27,25 @@ function clearGeneratedFiles(outputDir, extension) {
     }
 }
 async function main() {
-    const rootDir = process.cwd();
+    let rootDir = process.cwd();
     let config = {};
     try {
         let configPath = path_1.default.join(rootDir, 'an5Orm.config.js');
         if (!fs_1.default.existsSync(configPath)) {
             configPath = path_1.default.join(rootDir, 'an5Orm.config.cjs');
         }
+        if (!fs_1.default.existsSync(configPath)) {
+            configPath = path_1.default.join(rootDir, '..', 'an5Orm.config.js');
+        }
+        if (!fs_1.default.existsSync(configPath)) {
+            configPath = path_1.default.join(rootDir, '..', 'an5Orm.config.cjs');
+        }
         if (fs_1.default.existsSync(configPath)) {
             config = require(configPath);
+            rootDir = path_1.default.dirname(configPath);
+        }
+        else if (fs_1.default.existsSync(path_1.default.join(rootDir, '..', 'an5Schema'))) {
+            rootDir = path_1.default.resolve(rootDir, '..');
         }
     }
     catch (err) {
@@ -45,10 +56,12 @@ async function main() {
     const outputMetadataPath = path_1.default.resolve(rootDir, config.outputs?.typescript?.metadataFile || 'an5Client/typescript/an5Metadata.ts');
     const outputPythonMetadataPath = path_1.default.resolve(rootDir, config.outputs?.python?.metadataFile || 'an5Client/python/an5_metadata.py');
     const outputDotnetDir = path_1.default.resolve(rootDir, config.outputs?.dotnet?.outputDir || 'an5Client/dotnet');
+    const outputGolangDir = path_1.default.resolve(rootDir, config.outputs?.golang?.outputDir || 'an5Client/golang');
     console.log('🚀 Starting ORM generation...');
     try {
         clearGeneratedFiles(outputTypesDir, '.ts');
         clearGeneratedFiles(outputDotnetDir, '.cs');
+        clearGeneratedFiles(outputGolangDir, '.go');
         if (fs_1.default.existsSync(outputMetadataPath)) {
             fs_1.default.unlinkSync(outputMetadataPath);
         }
@@ -74,10 +87,13 @@ async function main() {
         }
         const pythonGen = new python_generator_1.PythonGenerator(outputPythonMetadataPath);
         pythonGen.generate(models);
-        console.log(`✨ Generated Python metadata in ${outputPythonMetadataPath}`);
+        console.log(`✨ Generated Python metadata and client models in ${pythonDir}`);
         const dotnetGen = new dotnet_generator_1.DotnetGenerator(outputDotnetDir);
         dotnetGen.generate(models);
         console.log(`✨ Generated .NET models in ${outputDotnetDir}`);
+        const golangGen = new golang_generator_1.GolangGenerator(outputGolangDir);
+        golangGen.generate(models);
+        console.log(`✨ Generated Golang models in ${outputGolangDir}`);
         console.log('✅ ORM generation completed successfully.');
     }
     catch (error) {

package/dist/generator/src/metadata-generator.d.ts

@@ -1,8 +1,11 @@
 import { Model } from './types';
 export declare class MetadataGenerator {
     private outputPath;
-    constructor(outputPath: string);
+    private relationImport;
+    constructor(outputPath: string, relationImport?: string);
     generate(models: Model[]): void;
     private getAllPropertyVariations;
+    private toSnakeCase;
+    private formatFieldMetadata;
     private toCamelCase;
 }

package/dist/generator/src/metadata-generator.js

@@ -6,11 +6,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MetadataGenerator = void 0;
 const fs_1 = __importDefault(require("fs"));
 class MetadataGenerator {
-    constructor(outputPath) {
+    constructor(outputPath, relationImport = 'import type { RelationDef } from "@an5/orm";') {
         this.outputPath = outputPath;
+        this.relationImport = relationImport;
     }
     generate(models) {
         let metaContent = '// This file is auto-generated. Do not edit directly.\n\n';
+        metaContent += `${this.relationImport}\n\n`;
         metaContent += 'export const modelToTable: Record<string, string> = {\n';
         for (const model of models) {
             const props = this.getAllPropertyVariations(model.name);
@@ -37,7 +39,6 @@ class MetadataGenerator {
             }
         }
         metaContent += '};\n\n';
-        metaContent += 'export interface RelationDef {\n  modelName: string;\n  relationType: "many" | "one";\n  foreignKey: string;\n  localKey: string;\n}\n\n';
         metaContent += 'export const relationMap: Record<string, Record<string, RelationDef>> = {\n';
         for (const model of models) {
             const props = this.getAllPropertyVariations(model.name);
@@ -55,22 +56,35 @@ class MetadataGenerator {
     }
     getAllPropertyVariations(modelName) {
         const variations = new Set();
-        // 1. Standard camelCase (e.g. User -> user, McpServer -> mcpServer)
+        // 1. PascalCase (User)
+        variations.add(modelName);
+        // 2. camelCase (user)
         variations.add(this.toCamelCase(modelName));
-        // 2. Handle known acronyms at start (e.g. LLMProvider -> lLMProvider)
-        // This is already handled by toCamelCase if it only lowercases the first letter.
-        // But we might want 'llmProvider' as well.
+        // 3. Plural PascalCase (Users)
+        variations.add(modelName + 's');
+        // 4. Plural camelCase (users)
+        variations.add(this.toCamelCase(modelName) + 's');
+        // 5. snake_case (user, mc_server)
+        variations.add(this.toSnakeCase(modelName));
+        variations.add(this.toSnakeCase(modelName) + 's');
         const acronyms = ['LLM', 'AI', 'MCP', 'IT', 'QC', 'HR', 'MR', 'WH', 'SSIS', 'API', 'URL', 'ID', 'JSON'];
         for (const acronym of acronyms) {
             if (modelName.startsWith(acronym)) {
-                // e.g. LLMProvider -> llmProvider
                 variations.add(acronym.toLowerCase() + modelName.slice(acronym.length));
-                // e.g. LLMProvider -> lLMProvider (Prisma style)
                 variations.add(acronym[0].toLowerCase() + acronym.slice(1) + modelName.slice(acronym.length));
+                variations.add(acronym.toLowerCase() + modelName.slice(acronym.length) + 's');
             }
         }
         return Array.from(variations);
     }
+    toSnakeCase(str) {
+        if (!str)
+            return '';
+        return str
+            .replace(/([A-Z]+)([A-Z][a-z])/g, '$1_$2')
+            .replace(/([a-z\d])([A-Z])/g, '$1_$2')
+            .toLowerCase();
+    }
     formatFieldMetadata(field) {
         const entries = [
             `ts: ${JSON.stringify(`${field.type}${field.isOptional ? '?' : ''}`)}`,

package/dist/generator/src/python-generator.d.ts

@@ -3,7 +3,17 @@ export declare class PythonGenerator {
     private outputPath;
     constructor(outputPath: string);
     generate(models: Model[]): void;
+    private getPyFilterType;
+    private generateOrmTypes;
+    private generateMetadata;
+    private mapPyType;
+    private generateModels;
+    private generateClient;
+    private generateInit;
     private getAllPropertyVariations;
+    private formatFields;
+    private pyString;
     private toCamelCase;
     private toSnakeCase;
+    private capitalize;
 }

package/dist/generator/src/python-generator.js

@@ -5,11 +5,111 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PythonGenerator = void 0;
 const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
 class PythonGenerator {
     constructor(outputPath) {
         this.outputPath = outputPath;
     }
     generate(models) {
+        const outputDir = path_1.default.dirname(this.outputPath);
+        if (!fs_1.default.existsSync(outputDir)) {
+            fs_1.default.mkdirSync(outputDir, { recursive: true });
+        }
+        // 1. Generate an5_metadata.py
+        this.generateMetadata(models);
+        // 2. Generate an5_models.py
+        this.generateModels(models, outputDir);
+        // 3. Generate an5_orm_types.py - type-safe ORM filter/args dataclasses
+        this.generateOrmTypes(models, outputDir);
+        // 4. Generate an5_client.py
+        this.generateClient(models, outputDir);
+        // 5. Generate __init__.py
+        this.generateInit(models, outputDir);
+    }
+    getPyFilterType(fieldType) {
+        const lower = fieldType.toLowerCase();
+        if (['datetime', 'datetime2', 'date', 'smalldatetime', 'datetimeoffset', 'timestamp'].includes(lower))
+            return 'DateTimeFilter';
+        if (['bool', 'boolean', 'bit'].includes(lower))
+            return 'BoolFilter';
+        if (['int', 'integer', 'smallint', 'tinyint', 'bigint', 'number'].includes(lower))
+            return 'IntFilter';
+        if (['float', 'real', 'double', 'decimal', 'numeric', 'money'].includes(lower))
+            return 'NumberFilter';
+        return 'StringFilter';
+    }
+    generateOrmTypes(models, outputDir) {
+        let content = '# This file is auto-generated. Do not edit directly.\n';
+        content += '"""\nAN5 ORM typed filter/args dataclasses for type-safe queries.\n\nUsage example::\n\n    db.user.find_many(where=UserWhereInput(name=StringFilter(contains="John")),\n                      order_by=UserOrderByInput(created_at="desc"),\n                      take=10)\n"""\n';
+        content += 'from __future__ import annotations\n';
+        content += 'from dataclasses import dataclass, field\n';
+        content += 'from typing import List, Optional, Any\n';
+        content += 'from datetime import datetime\n\n';
+        // Base filter types
+        content += '# ─── Base filter types ────────────────────────────────────────────────────────\n\n';
+        content += `@dataclass\nclass StringFilter:\n    """Type-safe filter for string fields."""\n    equals: Optional[str] = None\n    not_: Optional[str] = None\n    contains: Optional[str] = None\n    starts_with: Optional[str] = None\n    ends_with: Optional[str] = None\n    in_: Optional[List[str]] = None\n    not_in: Optional[List[str]] = None\n    gt: Optional[str] = None\n    gte: Optional[str] = None\n    lt: Optional[str] = None\n    lte: Optional[str] = None\n\n`;
+        content += `@dataclass\nclass IntFilter:\n    """Type-safe filter for integer fields."""\n    equals: Optional[int] = None\n    not_: Optional[int] = None\n    in_: Optional[List[int]] = None\n    not_in: Optional[List[int]] = None\n    gt: Optional[int] = None\n    gte: Optional[int] = None\n    lt: Optional[int] = None\n    lte: Optional[int] = None\n\n`;
+        content += `@dataclass\nclass NumberFilter:\n    """Type-safe filter for float/decimal fields."""\n    equals: Optional[float] = None\n    not_: Optional[float] = None\n    in_: Optional[List[float]] = None\n    not_in: Optional[List[float]] = None\n    gt: Optional[float] = None\n    gte: Optional[float] = None\n    lt: Optional[float] = None\n    lte: Optional[float] = None\n\n`;
+        content += `@dataclass\nclass BoolFilter:\n    """Type-safe filter for boolean fields."""\n    equals: Optional[bool] = None\n\n`;
+        content += `@dataclass\nclass DateTimeFilter:\n    """Type-safe filter for datetime fields."""\n    equals: Optional[datetime] = None\n    not_: Optional[datetime] = None\n    in_: Optional[List[datetime]] = None\n    not_in: Optional[List[datetime]] = None\n    gt: Optional[datetime] = None\n    gte: Optional[datetime] = None\n    lt: Optional[datetime] = None\n    lte: Optional[datetime] = None\n\n`;
+        // Per-model types
+        for (const model of models) {
+            const name = this.capitalize(model.name);
+            content += `# ─── ${name} ORM Types ────────────────────────────────────────────────────────\n\n`;
+            // WhereInput
+            content += `@dataclass\nclass ${name}WhereInput:\n    """Type-safe WHERE filter for ${name} queries."""\n`;
+            content += `    AND: Optional[List['${name}WhereInput']] = None\n`;
+            content += `    OR: Optional[List['${name}WhereInput']] = None\n`;
+            content += `    NOT: Optional['${name}WhereInput'] = None\n`;
+            for (const f of model.fields) {
+                const ft = this.getPyFilterType(f.type);
+                content += `    ${this.toSnakeCase(f.name)}: Optional[${ft}] = None\n`;
+            }
+            content += '\n';
+            // OrderByInput
+            content += `@dataclass\nclass ${name}OrderByInput:\n    """Type-safe ORDER BY for ${name} queries. Value: 'asc' or 'desc'."""\n`;
+            for (const f of model.fields) {
+                content += `    ${this.toSnakeCase(f.name)}: Optional[str] = None\n`;
+            }
+            content += '\n';
+            // CreateInput
+            const requiredFields = model.fields.filter(f => !f.isId && !f.isOptional && !f.hasDefault);
+            const optionalFields = model.fields.filter(f => !f.isId && (f.isOptional || f.hasDefault));
+            content += `@dataclass\nclass ${name}CreateInput:\n    """Typed data for creating a new ${name} record."""\n`;
+            for (const f of requiredFields) {
+                content += `    ${this.toSnakeCase(f.name)}: ${this.mapPyType(f.type)}\n`;
+            }
+            for (const f of optionalFields) {
+                content += `    ${this.toSnakeCase(f.name)}: Optional[${this.mapPyType(f.type)}] = None\n`;
+            }
+            if (requiredFields.length === 0 && optionalFields.length === 0)
+                content += '    pass\n';
+            content += '\n';
+            // UpdateInput
+            const updateFields = model.fields.filter(f => !f.isId);
+            content += `@dataclass\nclass ${name}UpdateInput:\n    """Typed data for updating an existing ${name} record."""\n`;
+            for (const f of updateFields) {
+                content += `    ${this.toSnakeCase(f.name)}: Optional[${this.mapPyType(f.type)}] = None\n`;
+            }
+            if (updateFields.length === 0)
+                content += '    pass\n';
+            content += '\n';
+            // FindManyArgs
+            content += `@dataclass\nclass ${name}FindManyArgs:\n    """ORM-style args for ${name}.find_many()."""\n`;
+            content += `    where: Optional[${name}WhereInput] = None\n`;
+            content += `    order_by: Optional[${name}OrderByInput] = None\n`;
+            content += `    take: Optional[int] = None\n`;
+            content += `    skip: int = 0\n`;
+            content += `    select: Optional[List[str]] = None\n\n`;
+            // FindFirstArgs
+            content += `@dataclass\nclass ${name}FindFirstArgs:\n    """ORM-style args for ${name}.find_first()."""\n`;
+            content += `    where: Optional[${name}WhereInput] = None\n`;
+            content += `    order_by: Optional[${name}OrderByInput] = None\n`;
+            content += `    select: Optional[List[str]] = None\n\n`;
+        }
+        fs_1.default.writeFileSync(path_1.default.join(outputDir, 'an5_orm_types.py'), content);
+    }
+    generateMetadata(models) {
         let pyContent = '# This file is auto-generated. Do not edit directly.\n\n';
         // 1. MODEL_TO_TABLE
         pyContent += 'MODEL_TO_TABLE = {\n';
@@ -61,11 +161,146 @@ class PythonGenerator {
         pyContent += '}\n';
         fs_1.default.writeFileSync(this.outputPath, pyContent);
     }
+    mapPyType(fieldType) {
+        const lower = fieldType.toLowerCase();
+        if (['int', 'integer', 'smallint', 'tinyint', 'bigint', 'number'].includes(lower)) {
+            return 'int';
+        }
+        if (['float', 'real', 'double', 'decimal', 'numeric', 'money'].includes(lower)) {
+            return 'float';
+        }
+        if (['bool', 'boolean', 'bit'].includes(lower)) {
+            return 'bool';
+        }
+        if (['datetime', 'datetime2', 'date', 'smalldatetime', 'datetimeoffset', 'timestamp'].includes(lower)) {
+            return 'datetime';
+        }
+        if (['bytes', 'binary', 'varbinary'].includes(lower)) {
+            return 'bytes';
+        }
+        return 'str';
+    }
+    generateModels(models, outputDir) {
+        let content = '# This file is auto-generated. Do not edit directly.\n';
+        content += 'from dataclasses import dataclass, field\n';
+        content += 'from typing import Optional, List, Any\n';
+        content += 'from datetime import datetime\n\n';
+        for (const model of models) {
+            if (model.description) {
+                content += `"""${model.description}"""\n`;
+            }
+            content += `@dataclass\nclass ${model.name}:\n`;
+            if (model.fields.length === 0 && model.relations.length === 0) {
+                content += '    pass\n\n';
+                continue;
+            }
+            // Required fields first
+            const required = model.fields.filter(f => !f.isOptional && !f.hasDefault);
+            const optionals = model.fields.filter(f => f.isOptional || f.hasDefault);
+            for (const f of required) {
+                const pyType = this.mapPyType(f.type);
+                const snakeName = this.toSnakeCase(f.name);
+                content += `    ${snakeName}: ${pyType}\n`;
+            }
+            for (const f of optionals) {
+                const pyType = this.mapPyType(f.type);
+                const snakeName = this.toSnakeCase(f.name);
+                content += `    ${snakeName}: Optional[${pyType}] = None\n`;
+            }
+            // Relations
+            for (const rel of model.relations) {
+                const relName = this.toSnakeCase(rel.name);
+                if (rel.isArray) {
+                    content += `    ${relName}: List[Any] = field(default_factory=list)\n`;
+                }
+                else {
+                    content += `    ${relName}: Optional[Any] = None\n`;
+                }
+            }
+            content += '\n';
+        }
+        fs_1.default.writeFileSync(path_1.default.join(outputDir, 'an5_models.py'), content);
+    }
+    generateClient(models, outputDir) {
+        let content = '# This file is auto-generated. Do not edit directly.\n';
+        content += 'import os\n';
+        content += 'from typing import Dict, List, Optional, Any, Callable\n\n';
+        content += 'try:\n';
+        content += '    from an5_adapter import An5Adapter, AdapterTableClient, create_an5_adapter, set_adapter_metadata\n';
+        content += 'except ImportError:\n';
+        content += '    from .an5_adapter import An5Adapter, AdapterTableClient, create_an5_adapter, set_adapter_metadata\n\n';
+        content += 'try:\n';
+        content += '    from .an5_metadata import MODEL_TO_TABLE, MODEL_FIELDS\n';
+        content += 'except ImportError:\n';
+        content += '    from an5_metadata import MODEL_TO_TABLE, MODEL_FIELDS\n\n';
+        content += 'class An5Client:\n';
+        content += '    """AN5 Python ORM Client - type-safe database access.\n\n';
+        content += '    Usage:\n';
+        content += '        db = An5Client()\n';
+        content += '        users = db.user.find_many(where={"name": {"contains": "John"}}, order_by={"created_at": "asc"}, take=10)\n';
+        content += '        user  = db.user.find_first(where={"id": "abc"})\n';
+        content += '        new   = db.user.create(data={"name": "Alice", "email": "alice@example.com"})\n';
+        content += '    """\n';
+        content += '    def __init__(self, connection_string: Optional[str] = None):\n';
+        content += '        conn_str = (connection_string or \n';
+        content += '                    os.getenv("DATABASE_URL") or \n';
+        content += '                    "Server=localhost;Database=master;Trusted_Connection=True;TrustServerCertificate=True;")\n';
+        content += '        set_adapter_metadata({"model_to_table": MODEL_TO_TABLE, "model_fields": MODEL_FIELDS})\n';
+        content += '        self.adapter: An5Adapter = create_an5_adapter(conn_str)\n\n';
+        for (const model of models) {
+            const propName = this.toSnakeCase(model.name) + 's';
+            const singleName = this.toSnakeCase(model.name);
+            content += `        client = AdapterTableClient(self.adapter, "${model.name}")\n`;
+            content += `        self.${model.name}: AdapterTableClient = client\n`;
+            content += `        self.${model.name}s: AdapterTableClient = client\n`;
+            content += `        self.${singleName}: AdapterTableClient = client\n`;
+            content += `        self.${propName}: AdapterTableClient = client\n`;
+        }
+        content += '\n';
+        content += '    def __getattr__(self, name: str) -> AdapterTableClient:\n';
+        content += '        return self.adapter.table(name)\n\n';
+        content += '    def query_raw(self, sql: str, *params) -> List[Dict]:\n';
+        content += '        return self.adapter.query_raw(sql, *params)\n\n';
+        content += '    def execute_raw(self, sql: str, *params) -> int:\n';
+        content += '        return self.adapter.execute_raw(sql, *params)\n\n';
+        content += '    def transaction(self, fn: Callable) -> Any:\n';
+        content += '        return self.adapter.transaction(fn)\n';
+        fs_1.default.writeFileSync(path_1.default.join(outputDir, 'an5_client.py'), content);
+    }
+    generateInit(models, outputDir) {
+        let content = '# This file is auto-generated. Do not edit directly.\n';
+        content += 'from .an5_metadata import MODEL_TO_TABLE, MODEL_DESCRIPTIONS, MODEL_FIELDS, RELATION_MAP\n';
+        content += 'from .an5_models import *\n';
+        content += 'from .an5_orm_types import (\n';
+        content += '    StringFilter, IntFilter, NumberFilter, BoolFilter, DateTimeFilter,\n';
+        for (const m of models) {
+            const name = this.capitalize(m.name);
+            content += `    ${name}WhereInput, ${name}OrderByInput,\n`;
+            content += `    ${name}CreateInput, ${name}UpdateInput,\n`;
+            content += `    ${name}FindManyArgs, ${name}FindFirstArgs,\n`;
+        }
+        content += ')\n';
+        content += 'from .an5_client import An5Client\n\n';
+        content += '__all__ = [\n';
+        content += '    "MODEL_TO_TABLE",\n';
+        content += '    "MODEL_DESCRIPTIONS",\n';
+        content += '    "MODEL_FIELDS",\n';
+        content += '    "RELATION_MAP",\n';
+        content += '    "An5Client",\n';
+        content += '    "StringFilter", "IntFilter", "NumberFilter", "BoolFilter", "DateTimeFilter",\n';
+        for (const m of models) {
+            const name = this.capitalize(m.name);
+            content += `    "${m.name}",\n`;
+            content += `    "${name}WhereInput", "${name}OrderByInput",\n`;
+            content += `    "${name}CreateInput", "${name}UpdateInput",\n`;
+            content += `    "${name}FindManyArgs", "${name}FindFirstArgs",\n`;
+        }
+        content += ']\n';
+        fs_1.default.writeFileSync(path_1.default.join(outputDir, '__init__.py'), content);
+    }
     getAllPropertyVariations(modelName) {
         const variations = new Set();
-        // 1. camelCase (User -> user, McpServer -> mcpServer)
         variations.add(this.toCamelCase(modelName));
-        // 2. snake_case (User -> user, McpServer -> mcp_server)
         variations.add(this.toSnakeCase(modelName));
         const acronyms = ['LLM', 'AI', 'MCP', 'IT', 'QC', 'HR', 'MR', 'WH', 'SSIS', 'API', 'URL', 'ID', 'JSON'];
         for (const acronym of acronyms) {
@@ -101,5 +336,10 @@ class PythonGenerator {
             .replace(/([a-z\d])([A-Z])/g, '$1_$2')
             .toLowerCase();
     }
+    capitalize(str) {
+        if (!str)
+            return '';
+        return str[0].toUpperCase() + str.slice(1);
+    }
 }
 exports.PythonGenerator = PythonGenerator;

package/dist/index.d.ts

@@ -1,3 +1,7 @@
-export { An5ORM, an5Orm, default } from "./an5Orm";
-export type { Middleware, MiddlewareParams } from "./an5Orm";
+export { An5ClientKnownRequestError } from "./errors";
+export { DEFAULT_METADATA } from "./metadata";
+export type { RelationDef, ModelFieldMeta, An5Metadata } from "./metadata";
+export { quoteIdentifier, quoteTableIdentifier, sanitizeParamName, normalizeSortDirection, toNonNegativeInt, buildOrderBy, parseWhere, } from "./sql-utils";
+export { generateDiff, buildMigrationFile, buildCreateTableSql, generateColumnDiff, parseSchemaText, } from "./migration-core";
+export { An5Adapter, createAn5Adapter, AdapterTableClient, } from "@an5/adapters";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,11 +1,26 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = exports.an5Orm = exports.An5ORM = void 0;
-var an5Orm_1 = require("./an5Orm");
-Object.defineProperty(exports, "An5ORM", { enumerable: true, get: function () { return an5Orm_1.An5ORM; } });
-Object.defineProperty(exports, "an5Orm", { enumerable: true, get: function () { return an5Orm_1.an5Orm; } });
-Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(an5Orm_1).default; } });
+exports.AdapterTableClient = exports.createAn5Adapter = exports.An5Adapter = exports.parseSchemaText = exports.generateColumnDiff = exports.buildCreateTableSql = exports.buildMigrationFile = exports.generateDiff = exports.parseWhere = exports.buildOrderBy = exports.toNonNegativeInt = exports.normalizeSortDirection = exports.sanitizeParamName = exports.quoteTableIdentifier = exports.quoteIdentifier = exports.DEFAULT_METADATA = exports.An5ClientKnownRequestError = void 0;
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "An5ClientKnownRequestError", { enumerable: true, get: function () { return errors_1.An5ClientKnownRequestError; } });
+var metadata_1 = require("./metadata");
+Object.defineProperty(exports, "DEFAULT_METADATA", { enumerable: true, get: function () { return metadata_1.DEFAULT_METADATA; } });
+var sql_utils_1 = require("./sql-utils");
+Object.defineProperty(exports, "quoteIdentifier", { enumerable: true, get: function () { return sql_utils_1.quoteIdentifier; } });
+Object.defineProperty(exports, "quoteTableIdentifier", { enumerable: true, get: function () { return sql_utils_1.quoteTableIdentifier; } });
+Object.defineProperty(exports, "sanitizeParamName", { enumerable: true, get: function () { return sql_utils_1.sanitizeParamName; } });
+Object.defineProperty(exports, "normalizeSortDirection", { enumerable: true, get: function () { return sql_utils_1.normalizeSortDirection; } });
+Object.defineProperty(exports, "toNonNegativeInt", { enumerable: true, get: function () { return sql_utils_1.toNonNegativeInt; } });
+Object.defineProperty(exports, "buildOrderBy", { enumerable: true, get: function () { return sql_utils_1.buildOrderBy; } });
+Object.defineProperty(exports, "parseWhere", { enumerable: true, get: function () { return sql_utils_1.parseWhere; } });
+var migration_core_1 = require("./migration-core");
+Object.defineProperty(exports, "generateDiff", { enumerable: true, get: function () { return migration_core_1.generateDiff; } });
+Object.defineProperty(exports, "buildMigrationFile", { enumerable: true, get: function () { return migration_core_1.buildMigrationFile; } });
+Object.defineProperty(exports, "buildCreateTableSql", { enumerable: true, get: function () { return migration_core_1.buildCreateTableSql; } });
+Object.defineProperty(exports, "generateColumnDiff", { enumerable: true, get: function () { return migration_core_1.generateColumnDiff; } });
+Object.defineProperty(exports, "parseSchemaText", { enumerable: true, get: function () { return migration_core_1.parseSchemaText; } });
+var adapters_1 = require("@an5/adapters");
+Object.defineProperty(exports, "An5Adapter", { enumerable: true, get: function () { return adapters_1.An5Adapter; } });
+Object.defineProperty(exports, "createAn5Adapter", { enumerable: true, get: function () { return adapters_1.createAn5Adapter; } });
+Object.defineProperty(exports, "AdapterTableClient", { enumerable: true, get: function () { return adapters_1.AdapterTableClient; } });
 //# sourceMappingURL=index.js.map

package/dist/logger.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Structured Logger for an5Orm
+ * Provides consistent logging with levels, timestamps, and context.
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LogEntry {
+    level: LogLevel;
+    message: string;
+    timestamp: string;
+    context?: string;
+    data?: any;
+    duration?: number;
+    error?: Error;
+}
+export interface LoggerOptions {
+    level?: LogLevel;
+    prefix?: string;
+    json?: boolean;
+    colors?: boolean;
+}
+export declare class Logger {
+    private level;
+    private prefix;
+    private json;
+    private colors;
+    constructor(options?: LoggerOptions);
+    private formatEntry;
+    private log;
+    debug(message: string, options?: {
+        context?: string;
+        data?: any;
+    }): void;
+    info(message: string, options?: {
+        context?: string;
+        data?: any;
+        duration?: number;
+    }): void;
+    warn(message: string, options?: {
+        context?: string;
+        data?: any;
+    }): void;
+    error(message: string, error?: Error, options?: {
+        context?: string;
+        data?: any;
+    }): void;
+    child(context: string): Logger;
+    timer(label: string): {
+        end: () => void;
+    };
+}
+export declare const logger: Logger;
+export declare function createLogger(context: string): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * Structured Logger for an5Orm
+ * Provides consistent logging with levels, timestamps, and context.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = exports.Logger = void 0;
+exports.createLogger = createLogger;
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+const COLORS = {
+    debug: '\x1b[36m', // cyan
+    info: '\x1b[32m', // green
+    warn: '\x1b[33m', // yellow
+    error: '\x1b[31m', // red
+    reset: '\x1b[0m',
+};
+class Logger {
+    constructor(options = {}) {
+        this.level = LOG_LEVELS[options.level || 'info'];
+        this.prefix = options.prefix || '';
+        this.json = options.json || false;
+        this.colors = options.colors !== false && !this.json;
+    }
+    formatEntry(entry) {
+        if (this.json) {
+            return JSON.stringify({
+                level: entry.level,
+                message: entry.message,
+                timestamp: entry.timestamp,
+                context: entry.context,
+                duration: entry.duration,
+                ...(entry.data && { data: entry.data }),
+                ...(entry.error && { error: entry.error.message, stack: entry.error.stack }),
+            });
+        }
+        const color = this.colors ? COLORS[entry.level] : '';
+        const reset = this.colors ? COLORS.reset : '';
+        const prefix = this.prefix ? `[${this.prefix}]` : '';
+        const context = entry.context ? `[${entry.context}]` : '';
+        const duration = entry.duration !== undefined ? ` (${entry.duration}ms)` : '';
+        const timestamp = entry.timestamp;
+        let line = `${color}${timestamp} ${entry.level.toUpperCase().padEnd(5)}${reset} ${prefix}${context} ${entry.message}${duration}`;
+        if (entry.error) {
+            line += `\n${color}${entry.error.stack || entry.error.message}${reset}`;
+        }
+        return line;
+    }
+    log(level, message, options) {
+        if (LOG_LEVELS[level] < this.level)
+            return;
+        const entry = {
+            level,
+            message,
+            timestamp: new Date().toISOString(),
+            ...options,
+        };
+        const formatted = this.formatEntry(entry);
+        switch (level) {
+            case 'error':
+                console.error(formatted);
+                break;
+            case 'warn':
+                console.warn(formatted);
+                break;
+            case 'debug':
+                console.debug(formatted);
+                break;
+            default:
+                console.log(formatted);
+        }
+    }
+    debug(message, options) {
+        this.log('debug', message, options);
+    }
+    info(message, options) {
+        this.log('info', message, options);
+    }
+    warn(message, options) {
+        this.log('warn', message, options);
+    }
+    error(message, error, options) {
+        this.log('error', message, { ...options, ...(error !== undefined ? { error } : {}) });
+    }
+    child(context) {
+        return new Logger({
+            level: Object.keys(LOG_LEVELS).find(k => LOG_LEVELS[k] === this.level),
+            prefix: this.prefix ? `${this.prefix}:${context}` : context,
+            json: this.json,
+            colors: this.colors,
+        });
+    }
+    timer(label) {
+        const start = Date.now();
+        return {
+            end: () => {
+                const duration = Date.now() - start;
+                this.info(`${label} completed`, { duration });
+            },
+        };
+    }
+}
+exports.Logger = Logger;
+// Default logger instance
+exports.logger = new Logger({
+    level: process.env.LOG_LEVEL || 'info',
+    prefix: 'an5Orm',
+});
+// Create scoped loggers
+function createLogger(context) {
+    return exports.logger.child(context);
+}
+//# sourceMappingURL=logger.js.map