@an5/orm 1.0.0

package/generator/src/metadata-generator.ts

@@ -0,0 +1,79 @@
+import fs from 'fs';
+import path from 'path';
+import { Model } from './types';
+
+export class MetadataGenerator {
+  constructor(private outputPath: string) {}
+
+  public generate(models: Model[]) {
+    let metaContent = '// This file is auto-generated. Do not edit directly.\n\n';
+
+    metaContent += 'export const modelToTable: Record<string, string> = {\n';
+    for (const model of models) {
+      const props = this.getAllPropertyVariations(model.name);
+      const fullTableName = `[${model.schemaName}].[${model.tableName}]`;
+      for (const prop of props) {
+        metaContent += `  ${prop}: "${fullTableName}",\n`;
+      }
+    }
+    metaContent += '};\n\n';
+
+    metaContent += 'export const modelFields: Record<string, Record<string, { ts: string; sql: string }>> = {\n';
+    for (const model of models) {
+      const props = this.getAllPropertyVariations(model.name);
+      const fieldsStr = `{ ${model.fields.map(f => `${f.name}: { ts: "${f.type}${f.isOptional ? '?' : ''}", sql: "${f.sqlType}" }`).join(', ')} }`;
+      for (const prop of props) {
+        metaContent += `  ${prop}: ${fieldsStr},\n`;
+      }
+    }
+    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);
+      let relationsContent = `  {\n`;
+      for (const rel of model.relations) {
+        relationsContent += `    ${rel.name}: { modelName: "${this.toCamelCase(rel.type)}", relationType: "${rel.isArray ? 'many' : 'one'}", foreignKey: "${rel.foreignKey || 'id'}", localKey: "${rel.localKey || 'id'}" },\n`;
+      }
+      relationsContent += `  }`;
+
+      for (const prop of props) {
+        metaContent += `  ${prop}: ${relationsContent},\n`;
+      }
+    }
+    metaContent += '};\n';
+
+    fs.writeFileSync(this.outputPath, metaContent);
+  }
+
+  private getAllPropertyVariations(modelName: string): string[] {
+    const variations = new Set<string>();
+    
+    // 1. Standard camelCase (e.g. User -> user, McpServer -> mcpServer)
+    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.
+    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));
+      }
+    }
+
+    return Array.from(variations);
+  }
+
+  private toCamelCase(str: string): string {
+    if (!str) return '';
+    return str[0].toLowerCase() + str.slice(1);
+  }
+}

package/generator/src/parser.ts

@@ -0,0 +1,202 @@
+import fs from 'fs';
+import path from 'path';
+import { Model, Field, Relation } from './types';
+
+// SQL Server type → TypeScript type mapping
+const AN5_TO_TS: Record<string, string> = {
+  // String types
+  'NVARCHAR': 'string',
+  'VARCHAR': 'string',
+  'CHAR': 'string',
+  'NCHAR': 'string',
+  'TEXT': 'string',
+  'NTEXT': 'string',
+  'XML': 'string',
+  // Numeric types
+  'INT': 'number',
+  'SMALLINT': 'number',
+  'TINYINT': 'number',
+  'BIGINT': 'number | bigint',
+  'FLOAT': 'number',
+  'REAL': 'number',
+  'DECIMAL': 'number',
+  'NUMERIC': 'number',
+  'MONEY': 'number',
+  'SMALLMONEY': 'number',
+  // Boolean
+  'BIT': 'boolean',
+  // Date types
+  'DATETIME': 'Date',
+  'DATETIME2': 'Date',
+  'SMALLDATETIME': 'Date',
+  'DATE': 'Date',
+  'TIME': 'Date',
+  'DATETIMEOFFSET': 'Date',
+  // Binary types
+  'VARBINARY': 'Buffer',
+  'BINARY': 'Buffer',
+  'IMAGE': 'Buffer',
+  // Other
+  'UNIQUEIDENTIFIER': 'string',
+  'SQL_VARIANT': 'any',
+  'ROWVERSION': 'Buffer',
+  'HIERARCHYID': 'string',
+  'GEOGRAPHY': 'string',
+  'GEOMETRY': 'string',
+  'VECTOR': 'number[] | string',
+};
+
+// Parse base type from "NVARCHAR(255)" → "NVARCHAR"
+function parseSqlType(raw: string): { base: string; params: string } {
+  const match = raw.match(/^(\w+)(?:\((.+)\))?$/);
+  if (!match) return { base: raw, params: '' };
+  return { base: match[1].toUpperCase(), params: match[2] || '' };
+}
+
+// Map SQL Server type to TypeScript type
+export function sqlTypeToTs(sqlType: string): string {
+  const { base } = parseSqlType(sqlType);
+  return AN5_TO_TS[base] || 'any';
+}
+
+export class SchemaParser {
+  private schemaText: string = '';
+
+  constructor(private schemaDir: string) {}
+
+  public async parse(): Promise<Model[]> {
+    this.loadSchema();
+    const lines = this.schemaText.split('\n');
+    const models: Model[] = [];
+    let currentModel: Model | null = null;
+
+    for (let line of lines) {
+      line = line.trim();
+      if (!line || line.startsWith('//')) continue;
+
+      const modelHeaderMatch = line.match(/^model\s+(\w+)\s*\{/);
+      if (modelHeaderMatch) {
+        const modelName = modelHeaderMatch[1];
+        currentModel = {
+          name: modelName,
+          tableName: modelName.toLowerCase() + 's',
+          schemaName: 'dbo',
+          fields: [],
+          relations: []
+        };
+        models.push(currentModel);
+        continue;
+      }
+
+      if (line === '}') {
+        currentModel = null;
+        continue;
+      }
+
+      if (currentModel) {
+        this.parseModelLine(line, currentModel);
+      }
+    }
+
+    this.postProcessRelations(models);
+    return models;
+  }
+
+  private loadSchema() {
+    if (fs.existsSync(this.schemaDir)) {
+      const files = fs.readdirSync(this.schemaDir).filter(f => f.endsWith('.an5'));
+      for (const file of files) {
+        this.schemaText += fs.readFileSync(path.join(this.schemaDir, file), 'utf8') + '\n';
+      }
+    } else {
+      throw new Error(`No schema directory found at ${this.schemaDir}`);
+    }
+  }
+
+  private parseModelLine(line: string, model: Model) {
+    if (line.startsWith('@@map')) {
+      const mapMatch = line.match(/@@map\("(.+)"\)/);
+      if (mapMatch) model.tableName = mapMatch[1];
+      return;
+    }
+    if (line.startsWith('@@schema')) {
+      const schemaMatch = line.match(/@@schema\("(.+)"\)/);
+      if (schemaMatch) model.schemaName = schemaMatch[1];
+      return;
+    }
+    if (line.startsWith('@@unique')) {
+      const uniqueMatch = line.match(/@@unique\(\[([\w,\s]+)\]\)/);
+      if (uniqueMatch) {
+        const fields = uniqueMatch[1].split(',').map(f => f.trim());
+        model.compoundUniques = model.compoundUniques || [];
+        model.compoundUniques.push(fields);
+      }
+      return;
+    }
+    if (line.startsWith('@@description')) {
+      const descMatch = line.match(/@@description\("(.+)"\)/);
+      if (descMatch) model.description = descMatch[1];
+      return;
+    }
+    if (line.startsWith('@@')) return;
+
+    const parts = line.split(/\s+/);
+    const fieldName = parts[0];
+    let fieldType = parts[1];
+    if (!fieldName || !fieldType) return;
+
+    const isArray = fieldType.endsWith('[]');
+    const isOptional = fieldType.endsWith('?');
+    const cleanType = fieldType.replace('[]', '').replace('?', '');
+
+    // Parse SQL Server type (e.g., "NVARCHAR(255)" → base="NVARCHAR")
+    const { base: sqlBase } = parseSqlType(cleanType);
+
+    let tsType = 'any';
+    let isRelation = false;
+
+    // Check if it's a known SQL Server type
+    if (AN5_TO_TS[sqlBase]) {
+      tsType = sqlTypeToTs(cleanType);
+    } else if (cleanType[0] === cleanType[0].toUpperCase() && !cleanType.includes('(')) {
+      // Uppercase without parens = likely a relation to another model
+      tsType = cleanType;
+      isRelation = true;
+    }
+
+    if (isRelation) {
+      let foreignKey = '', localKey = '', relationName = '';
+      const nameMatch = line.match(/@relation\("(\w+)"/);
+      if (nameMatch) relationName = nameMatch[1];
+      const relationMatch = line.match(/@relation\((?:.*fields:\s*\[(\w+)\],)?\s*(?:.*references:\s*\[(\w+)\],?)?.*\)/);
+      if (relationMatch) {
+        foreignKey = relationMatch[1] || '';
+        localKey = relationMatch[2] || '';
+      }
+      model.relations.push({ name: fieldName, type: tsType, isArray, isOptional, foreignKey, localKey, relationName });
+    } else {
+      const hasDefault = line.includes('@default') || line.includes('@updatedAt') || line.includes('@id');
+      const isId = line.includes('@id');
+      let description: string | undefined;
+      const descMatch = line.match(/@description\("(.+)"\)/);
+      if (descMatch) description = descMatch[1];
+      model.fields.push({ name: fieldName, type: tsType, sqlType: cleanType, isOptional, hasDefault, isId, description });
+    }
+  }
+
+  private postProcessRelations(models: Model[]) {
+    for (const model of models) {
+      for (const rel of model.relations) {
+        if (!rel.foreignKey || !rel.localKey) {
+          const targetModel = models.find(m => m.name === rel.type);
+          if (targetModel) {
+            let opposite = rel.relationName ?
+              targetModel.relations.find(r => r.type === model.name && r.relationName === rel.relationName && r.foreignKey && r.localKey) :
+              targetModel.relations.find(r => r.type === model.name && r.foreignKey && r.localKey);
+            if (opposite) { rel.foreignKey = opposite.foreignKey; rel.localKey = opposite.localKey; }
+          }
+        }
+      }
+    }
+  }
+}

package/generator/src/python-generator.ts

@@ -0,0 +1,90 @@
+import fs from 'fs';
+import path from 'path';
+import { Model } from './types';
+
+export class PythonGenerator {
+  constructor(private outputPath: string) {}
+
+  public generate(models: Model[]) {
+    let pyContent = '# This file is auto-generated. Do not edit directly.\n\n';
+
+    // 1. MODEL_TO_TABLE
+    pyContent += 'MODEL_TO_TABLE = {\n';
+    for (const model of models) {
+      const props = this.getAllPropertyVariations(model.name);
+      const fullTableName = `[${model.schemaName}].[${model.tableName}]`;
+      for (const prop of props) {
+        pyContent += `    "${prop}": "${fullTableName}",\n`;
+      }
+    }
+    pyContent += '}\n\n';
+
+    // 2. MODEL_FIELDS
+    pyContent += 'MODEL_FIELDS = {\n';
+    for (const model of models) {
+      const props = this.getAllPropertyVariations(model.name);
+      const fieldsStr = `{ ${model.fields.map(f => `"${f.name}": "${f.type}${f.isOptional ? '?' : ''}"`).join(', ')} }`;
+      for (const prop of props) {
+        pyContent += `    "${prop}": ${fieldsStr},\n`;
+      }
+    }
+    pyContent += '}\n\n';
+
+    // 3. RELATION_MAP
+    pyContent += 'RELATION_MAP = {\n';
+    for (const model of models) {
+      const props = this.getAllPropertyVariations(model.name);
+      let relationsContent = `{\n`;
+      for (const rel of model.relations) {
+        relationsContent += `        "${rel.name}": {\n`;
+        relationsContent += `            "modelName": "${this.toCamelCase(rel.type)}",\n`;
+        relationsContent += `            "relationType": "${rel.isArray ? 'many' : 'one'}",\n`;
+        relationsContent += `            "foreignKey": "${rel.foreignKey || 'id'}",\n`;
+        relationsContent += `            "localKey": "${rel.localKey || 'id'}"\n`;
+        relationsContent += `        },\n`;
+      }
+      relationsContent += `    }`;
+
+      for (const prop of props) {
+        pyContent += `    "${prop}": ${relationsContent},\n`;
+      }
+    }
+    pyContent += '}\n';
+
+    fs.writeFileSync(this.outputPath, pyContent);
+  }
+
+  private getAllPropertyVariations(modelName: string): string[] {
+    const variations = new Set<string>();
+    
+    // 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) {
+      if (modelName.startsWith(acronym)) {
+        variations.add(acronym.toLowerCase() + modelName.slice(acronym.length));
+        variations.add(acronym[0].toLowerCase() + acronym.slice(1) + modelName.slice(acronym.length));
+        variations.add(this.toSnakeCase(acronym.toLowerCase() + modelName.slice(acronym.length)));
+      }
+    }
+
+    return Array.from(variations);
+  }
+
+  private toCamelCase(str: string): string {
+    if (!str) return '';
+    return str[0].toLowerCase() + str.slice(1);
+  }
+
+  private toSnakeCase(str: string): string {
+    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();
+  }
+}

package/generator/src/types.ts

@@ -0,0 +1,29 @@
+export interface Field {
+  name: string;
+  type: string;       // TypeScript type (string, number, boolean, Date, etc.)
+  sqlType: string;    // SQL Server type (NVARCHAR(255), INT, DATETIME2, etc.)
+  isOptional: boolean;
+  hasDefault: boolean;
+  isId: boolean;
+  description?: string;
+}
+
+export interface Relation {
+  name: string;
+  type: string;
+  isArray: boolean;
+  isOptional: boolean;
+  foreignKey: string;
+  localKey: string;
+  relationName: string;
+}
+
+export interface Model {
+  name: string;
+  tableName: string;
+  schemaName: string;
+  fields: Field[];
+  relations: Relation[];
+  compoundUniques?: string[][];
+  description?: string;
+}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@an5/orm",
+  "version": "1.0.0",
+  "description": "The lightweight ORM for SQL Server with support for TypeScript, Python, and .NET (C#).",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/**/*.{js,d.ts}",
+    "generator/src/**/*.ts",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/an5ORM/an5Orm.git"
+  },
+  "scripts": {
+    "generate": "npx tsx generator/src/index.ts",
+    "db:push": "npx tsx push.ts",
+    "db:pull": "npx tsx pull.ts",
+    "db:seed": "npx tsx seed.ts",
+    "db:cleanup": "npx tsx cleanup.ts",
+    "db:migrate": "npx tsx migrate.ts",
+    "db:migrate:diff": "npx tsx migrate.ts diff",
+    "db:migrate:generate": "npx tsx migrate.ts generate",
+    "db:migrate:status": "npx tsx migrate.ts status",
+    "release:cli": "npx tsx scripts/release-cli.ts",
+    "release": "node scripts/release.js",
+    "test": "node test/smoke.test.js",
+    "test:unit": "node test/unit.test.js",
+    "test:generator": "node test/generator.test.js"
+  },
+  "dependencies": {
+    "@an5/adapters": "^0.1.0",
+    "bcryptjs": "^2.4.3",
+    "dotenv": "^16.4.5",
+    "mssql": "^12.5.5"
+  },
+  "devDependencies": {
+    "@types/bcryptjs": "^2.4.6",
+    "@types/mssql": "^9.1.8",
+    "@types/node": "^20.11.0",
+    "tsx": "^4.7.1",
+    "typescript": "^6.0.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}