@an5/orm 1.0.7 → 1.0.8

package/dist/generator/src/types.d.ts

@@ -1,27 +1,27 @@
-export interface Field {
-    name: string;
-    type: string;
-    sqlType: string;
-    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;
-}
+export interface Field {
+    name: string;
+    type: string;
+    sqlType: string;
+    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/dist/generator/src/types.js

@@ -1,2 +1,2 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/index.d.ts

@@ -1,3 +1,6 @@
 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";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -3,9 +3,13 @@ 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;
+exports.DEFAULT_METADATA = exports.An5ClientKnownRequestError = 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; } });
+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; } });
 //# 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 });
+    }
+    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

package/dist/metadata.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Core metadata types for AN5 ORM.
+ * These types are owned by the core package (@an5/orm) so that the ORM never
+ * has to import from generated client artifacts. Generated clients import
+ * these types from @an5/orm instead.
+ */
+export interface RelationDef {
+    modelName: string;
+    relationType: "many" | "one";
+    foreignKey: string;
+    localKey: string;
+}
+export interface ModelFieldMeta {
+    ts: string;
+    sql: string;
+    description?: string;
+}
+export interface An5Metadata {
+    modelToTable: Record<string, string>;
+    relationMap: Record<string, Record<string, RelationDef>>;
+    modelFields: Record<string, Record<string, ModelFieldMeta>>;
+}
+export declare const DEFAULT_METADATA: An5Metadata;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Core metadata types for AN5 ORM.
+ * These types are owned by the core package (@an5/orm) so that the ORM never
+ * has to import from generated client artifacts. Generated clients import
+ * these types from @an5/orm instead.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_METADATA = void 0;
+exports.DEFAULT_METADATA = {
+    modelToTable: {},
+    relationMap: {},
+    modelFields: {},
+};
+//# sourceMappingURL=metadata.js.map

package/dist/scripts/release-cli.d.ts

@@ -1,3 +1,3 @@
-#!/usr/bin/env tsx
-export {};
+#!/usr/bin/env tsx
+export {};
 //# sourceMappingURL=release-cli.d.ts.map

package/dist/scripts/release-cli.js

@@ -1,116 +1,116 @@
-#!/usr/bin/env tsx
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const child_process_1 = require("child_process");
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-function run(cmd, allowFail = false) {
-    try {
-        return (0, child_process_1.execSync)(cmd, { encoding: 'utf8' }).trim();
-    }
-    catch (error) {
-        if (allowFail)
-            return error.stdout?.toString()?.trim() || '';
-        throw error;
-    }
-}
-function inferComponent(file) {
-    const normalized = file.replace('\\', '/').toLowerCase();
-    if (normalized.includes('/generator/'))
-        return 'generator';
-    if (normalized.includes('/an5client/'))
-        return 'client';
-    if (normalized.includes('/an5schema/'))
-        return 'schema';
-    if (normalized.includes('/.github/'))
-        return 'ci';
-    if (normalized.includes('package.json') || normalized.includes('tsconfig'))
-        return 'build';
-    if (normalized.includes('.md'))
-        return 'docs';
-    return 'misc';
-}
-function collectChanges() {
-    const status = run('git status --porcelain');
-    const files = status
-        .split('\n')
-        .map(l => l.trim())
-        .filter(Boolean)
-        .map(l => l.slice(3).trim())
-        .filter(Boolean);
-    const groups = new Map();
-    for (const file of files) {
-        const component = inferComponent(file);
-        if (!groups.has(component)) {
-            groups.set(component, { component, files: [], summary: '' });
-        }
-        groups.get(component).files.push(file);
-    }
-    return Array.from(groups.values()).map(group => ({
-        ...group,
-        summary: `${group.component} updates`
-    }));
-}
-function generateChangelog(groups) {
-    const lines = ['# Changelog', ''];
-    for (const group of groups) {
-        lines.push(`## ${group.component}`);
-        lines.push(`- ${group.summary}`);
-        for (const file of group.files) {
-            lines.push(`  - ${file}`);
-        }
-        lines.push('');
-    }
-    return lines.join('\n').trim();
-}
-async function maybeUseLLM(summary) {
-    let apiKey = '';
-    try {
-        const configPath = require('path').join(__dirname, '..', '..', 'an5Adapters', 'typescript', 'config');
-        const mod = require(configPath);
-        if (mod?.getLlmConfig) {
-            const db = await mod.getLlmConfig();
-            if (db)
-                apiKey = db.apiKey;
-        }
-    }
-    catch { }
-    if (!apiKey)
-        return summary;
-    try {
-        const prompt = `Summarize these changes into one concise release note in English:\n${summary}`;
-        const payload = JSON.stringify({ model: 'gpt-4o-mini', messages: [{ role: 'system', content: 'You are a helpful release note writer.' }, { role: 'user', content: prompt }] });
-        const response = run(`curl -s https://api.openai.com/v1/chat/completions -H "Authorization: Bearer ${apiKey}" -H "Content-Type: application/json" -d '${payload}'`, true);
-        const parsed = JSON.parse(response);
-        return parsed.choices?.[0]?.message?.content?.trim() || summary;
-    }
-    catch {
-        return summary;
-    }
-}
-async function main() {
-    const groups = collectChanges();
-    if (groups.length === 0) {
-        console.log('No modified files detected.');
-        process.exit(0);
-    }
-    const changelog = generateChangelog(groups);
-    const outputPath = path_1.default.resolve(process.cwd(), 'CHANGELOG.md');
-    fs_1.default.writeFileSync(outputPath, changelog + '\n');
-    const summary = groups.map(g => `${g.component}: ${g.files.join(', ')}`).join('\n');
-    const llmSummary = await maybeUseLLM(summary);
-    console.log('\nGenerated changelog:\n');
-    console.log(changelog);
-    console.log('\nLLM summary:\n');
-    console.log(llmSummary);
-    const message = groups.map(g => g.component).join(', ');
-    const commitMessage = `chore: update ${message}`;
-    run(`git add -A`);
-    run(`git commit -m "${commitMessage}"`, true);
-    console.log(`\nCommitted with: ${commitMessage}`);
-}
-main().catch(console.error);
+#!/usr/bin/env tsx
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const child_process_1 = require("child_process");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+function run(cmd, allowFail = false) {
+    try {
+        return (0, child_process_1.execSync)(cmd, { encoding: 'utf8' }).trim();
+    }
+    catch (error) {
+        if (allowFail)
+            return error.stdout?.toString()?.trim() || '';
+        throw error;
+    }
+}
+function inferComponent(file) {
+    const normalized = file.replace('\\', '/').toLowerCase();
+    if (normalized.includes('/generator/'))
+        return 'generator';
+    if (normalized.includes('/an5client/'))
+        return 'client';
+    if (normalized.includes('/an5schema/'))
+        return 'schema';
+    if (normalized.includes('/.github/'))
+        return 'ci';
+    if (normalized.includes('package.json') || normalized.includes('tsconfig'))
+        return 'build';
+    if (normalized.includes('.md'))
+        return 'docs';
+    return 'misc';
+}
+function collectChanges() {
+    const status = run('git status --porcelain');
+    const files = status
+        .split('\n')
+        .map(l => l.trim())
+        .filter(Boolean)
+        .map(l => l.slice(3).trim())
+        .filter(Boolean);
+    const groups = new Map();
+    for (const file of files) {
+        const component = inferComponent(file);
+        if (!groups.has(component)) {
+            groups.set(component, { component, files: [], summary: '' });
+        }
+        groups.get(component).files.push(file);
+    }
+    return Array.from(groups.values()).map(group => ({
+        ...group,
+        summary: `${group.component} updates`
+    }));
+}
+function generateChangelog(groups) {
+    const lines = ['# Changelog', ''];
+    for (const group of groups) {
+        lines.push(`## ${group.component}`);
+        lines.push(`- ${group.summary}`);
+        for (const file of group.files) {
+            lines.push(`  - ${file}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n').trim();
+}
+async function maybeUseLLM(summary) {
+    let apiKey = '';
+    try {
+        const configPath = require('path').join(__dirname, '..', '..', 'an5Adapters', 'typescript', 'config');
+        const mod = require(configPath);
+        if (mod?.getLlmConfig) {
+            const db = await mod.getLlmConfig();
+            if (db)
+                apiKey = db.apiKey;
+        }
+    }
+    catch { }
+    if (!apiKey)
+        return summary;
+    try {
+        const prompt = `Summarize these changes into one concise release note in English:\n${summary}`;
+        const payload = JSON.stringify({ model: 'gpt-4o-mini', messages: [{ role: 'system', content: 'You are a helpful release note writer.' }, { role: 'user', content: prompt }] });
+        const response = run(`curl -s https://api.openai.com/v1/chat/completions -H "Authorization: Bearer ${apiKey}" -H "Content-Type: application/json" -d '${payload}'`, true);
+        const parsed = JSON.parse(response);
+        return parsed.choices?.[0]?.message?.content?.trim() || summary;
+    }
+    catch {
+        return summary;
+    }
+}
+async function main() {
+    const groups = collectChanges();
+    if (groups.length === 0) {
+        console.log('No modified files detected.');
+        process.exit(0);
+    }
+    const changelog = generateChangelog(groups);
+    const outputPath = path_1.default.resolve(process.cwd(), 'CHANGELOG.md');
+    fs_1.default.writeFileSync(outputPath, changelog + '\n');
+    const summary = groups.map(g => `${g.component}: ${g.files.join(', ')}`).join('\n');
+    const llmSummary = await maybeUseLLM(summary);
+    console.log('\nGenerated changelog:\n');
+    console.log(changelog);
+    console.log('\nLLM summary:\n');
+    console.log(llmSummary);
+    const message = groups.map(g => g.component).join(', ');
+    const commitMessage = `chore: update ${message}`;
+    run(`git add -A`);
+    run(`git commit -m "${commitMessage}"`, true);
+    console.log(`\nCommitted with: ${commitMessage}`);
+}
+main().catch(console.error);
 //# sourceMappingURL=release-cli.js.map

package/dist/sql-utils.d.ts

@@ -0,0 +1,29 @@
+import type { RelationDef } from "./metadata";
+/**
+ * SQL Server identifier quoting.
+ *
+ * Wraps a bare identifier in square brackets and escapes any embedded
+ * closing bracket (`]` → `]]`), which is the only character that can break
+ * out of a bracketed identifier in T-SQL. This blocks SQL injection through
+ * user-supplied column / alias names.
+ */
+export declare function quoteIdentifier(name: string): string;
+/** Sanitizes a parameter name to a safe T-SQL identifier fragment. */
+export declare function sanitizeParamName(name: string): string;
+/** Validates a direction token, defaulting to ASC. */
+export declare function normalizeSortDirection(dir: unknown): "ASC" | "DESC";
+/** Coerces a value to a non-negative integer, or returns the fallback. */
+export declare function toNonNegativeInt(value: unknown, fallback?: number): number;
+export interface QueryContext {
+    relationMap?: Record<string, Record<string, RelationDef>>;
+    modelToTable?: Record<string, string>;
+}
+export declare function buildOrderBy(orderBy: any): string;
+/**
+ * Recursively builds a WHERE clause from a Prisma-style filter object.
+ *
+ * Values are always bound as parameters (`@name`); only identifiers are
+ * interpolated directly, and they are run through {@link quoteIdentifier}.
+ */
+export declare function parseWhere(modelName: string, where: any, params: Record<string, any>, prefix?: string, ctx?: QueryContext): string;
+//# sourceMappingURL=sql-utils.d.ts.map