@zintrust/core 0.1.19 → 0.1.20

package/src/orm/maintenance/SqliteMaintenance.js

@@ -0,0 +1,14 @@
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
+const supportsResetSchema = (adapter) => typeof adapter.resetSchema === 'function';
+export const SqliteMaintenance = Object.freeze({
+    async dropAllTables(db) {
+        if (db.getType() !== 'sqlite') {
+            throw ErrorFactory.createDatabaseError('dropAllTables is only supported for sqlite');
+        }
+        const adapter = db.getAdapterInstance(false);
+        if (!supportsResetSchema(adapter)) {
+            throw ErrorFactory.createDatabaseError('SQLite adapter does not support resetSchema()');
+        }
+        await adapter.resetSchema();
+    },
+});

package/src/orm/migrations/MigrationStore.d.ts

@@ -0,0 +1,38 @@
+import type { IDatabase } from '../Database';
+import type { MigrationRecord, MigrationRecordStatus, MigrationScope } from '../../migrations/types';
+export declare const MigrationStore: Readonly<{
+    ensureTable(db: IDatabase): Promise<void>;
+    getLastCompletedBatch(db: IDatabase, scope?: MigrationScope, service?: string): Promise<number>;
+    getAppliedMap(db: IDatabase, scope: MigrationScope, service: string): Promise<Map<string, MigrationRecord>>;
+    insertRunning(db: IDatabase, params: {
+        name: string;
+        scope: MigrationScope;
+        service: string;
+        batch: number;
+    }): Promise<void>;
+    markStatus(db: IDatabase, params: {
+        name: string;
+        scope: MigrationScope;
+        service: string;
+        status: MigrationRecordStatus;
+        appliedAt?: string | null;
+    }): Promise<void>;
+    listCompletedInBatchesGte(db: IDatabase, params: {
+        scope: MigrationScope;
+        service: string;
+        minBatch: number;
+    }): Promise<Array<{
+        name: string;
+        batch: number;
+    }>>;
+    listAllCompletedNames(db: IDatabase, params: {
+        scope: MigrationScope;
+        service: string;
+    }): Promise<string[]>;
+    deleteRecord(db: IDatabase, params: {
+        name: string;
+        scope: MigrationScope;
+        service: string;
+    }): Promise<void>;
+}>;
+//# sourceMappingURL=MigrationStore.d.ts.map

package/src/orm/migrations/MigrationStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MigrationStore.d.ts","sourceRoot":"","sources":["../../../../src/orm/migrations/MigrationStore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAI/C,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AA8CjG,eAAO,MAAM,cAAc;oBACH,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;8BASzC,SAAS,UACN,cAAc,YACZ,MAAM,GACd,OAAO,CAAC,MAAM,CAAC;sBAiBZ,SAAS,SACN,cAAc,WACZ,MAAM,GACd,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;sBAyBlC,SAAS,UACL;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,cAAc,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAC9E,OAAO,CAAC,IAAI,CAAC;mBAuCV,SAAS,UACL;QACN,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,cAAc,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,qBAAqB,CAAC;QAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,GACA,OAAO,CAAC,IAAI,CAAC;kCAiBV,SAAS,UACL;QAAE,KAAK,EAAE,cAAc,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GACnE,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;8BAyB5C,SAAS,UACL;QAAE,KAAK,EAAE,cAAc,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GACjD,OAAO,CAAC,MAAM,EAAE,CAAC;qBAgBd,SAAS,UACL;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,cAAc,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAC/D,OAAO,CAAC,IAAI,CAAC;EAShB,CAAC"}

package/src/orm/migrations/MigrationStore.js

@@ -0,0 +1,157 @@
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
+import { QueryBuilder } from '../QueryBuilder.js';
+function nowIso() {
+    // MySQL/MariaDB DATETIME does not accept ISO8601 with timezone (e.g. trailing 'Z').
+    // Use a portable UTC datetime string.
+    return new Date().toISOString().slice(0, 19).replace('T', ' ');
+}
+const toSafeService = (service) => {
+    if (typeof service !== 'string')
+        return '';
+    return service.length > 0 ? service : '';
+};
+const assertDbSupportsMigrations = (db) => {
+    const t = db.getType();
+    if (t === 'd1' || t === 'd1-remote') {
+        throw ErrorFactory.createCliError('This project is configured for D1. Use `zin d1:migrate --local|--remote` for now.');
+    }
+};
+const hasMigrationsTableSupport = (adapter) => {
+    return (typeof adapter.ensureMigrationsTable === 'function');
+};
+const requireMigrationsTableSupport = (adapter) => {
+    if (!hasMigrationsTableSupport(adapter)) {
+        throw ErrorFactory.createCliError('Migrations tracking is not supported for this database adapter yet.');
+    }
+    return async () => {
+        await adapter.ensureMigrationsTable();
+    };
+};
+export const MigrationStore = Object.freeze({
+    async ensureTable(db) {
+        assertDbSupportsMigrations(db);
+        const adapter = db.getAdapterInstance(false);
+        const ensure = requireMigrationsTableSupport(adapter);
+        await ensure();
+    },
+    async getLastCompletedBatch(db, scope = 'global', service = '') {
+        assertDbSupportsMigrations(db);
+        const normalizedService = toSafeService(service);
+        const row = await QueryBuilder.create('migrations', db)
+            .max('batch', 'max_batch')
+            .where('status', '=', 'completed')
+            .andWhere('scope', '=', scope)
+            .andWhere('service', '=', normalizedService)
+            .first();
+        const value = row?.max_batch;
+        return typeof value === 'number' && Number.isFinite(value) ? value : 0;
+    },
+    async getAppliedMap(db, scope, service) {
+        assertDbSupportsMigrations(db);
+        const normalizedService = toSafeService(service);
+        const rows = await QueryBuilder.create('migrations', db)
+            .select('name', 'scope', 'service', 'batch', 'status')
+            .selectAs('applied_at', 'appliedAt')
+            .where('scope', '=', scope)
+            .andWhere('service', '=', normalizedService)
+            .get();
+        const map = new Map();
+        for (const r of rows) {
+            if (typeof r.name === 'string' && r.name.length > 0) {
+                map.set(r.name, {
+                    ...r,
+                    service: toSafeService(r.service),
+                });
+            }
+        }
+        return map;
+    },
+    async insertRunning(db, params) {
+        assertDbSupportsMigrations(db);
+        const normalizedService = toSafeService(params.service);
+        const existing = await QueryBuilder.create('migrations', db)
+            .select('id')
+            .where('name', '=', params.name)
+            .andWhere('scope', '=', params.scope)
+            .andWhere('service', '=', normalizedService)
+            .first();
+        // Allow re-running previously failed/running migrations by updating the existing row.
+        // This avoids tripping the UNIQUE(name, scope, service) constraint.
+        if (existing?.id !== undefined && existing.id !== null) {
+            await QueryBuilder.create('migrations', db)
+                .where('name', '=', params.name)
+                .andWhere('scope', '=', params.scope)
+                .andWhere('service', '=', normalizedService)
+                .update({
+                batch: params.batch,
+                status: 'running',
+                applied_at: null,
+            });
+            return;
+        }
+        await QueryBuilder.create('migrations', db).insert({
+            name: params.name,
+            scope: params.scope,
+            service: normalizedService,
+            batch: params.batch,
+            status: 'running',
+            applied_at: null,
+            created_at: nowIso(),
+        });
+    },
+    async markStatus(db, params) {
+        assertDbSupportsMigrations(db);
+        const builder = QueryBuilder.create('migrations', db)
+            .where('name', '=', params.name)
+            .andWhere('scope', '=', params.scope)
+            .andWhere('service', '=', toSafeService(params.service));
+        if (params.appliedAt !== undefined) {
+            await builder.update({ status: params.status, applied_at: params.appliedAt });
+            return;
+        }
+        await builder.update({ status: params.status });
+    },
+    async listCompletedInBatchesGte(db, params) {
+        assertDbSupportsMigrations(db);
+        const rows = await QueryBuilder.create('migrations', db)
+            .select('name', 'batch')
+            .where('status', '=', 'completed')
+            .andWhere('scope', '=', params.scope)
+            .andWhere('service', '=', toSafeService(params.service))
+            .andWhere('batch', '>=', params.minBatch)
+            .orderBy('batch', 'DESC')
+            .orderBy('id', 'DESC')
+            .get();
+        const out = [];
+        for (const r of rows) {
+            const name = typeof r.name === 'string' ? r.name : '';
+            const batch = typeof r.batch === 'number' ? r.batch : Number(r.batch);
+            if (name.length === 0)
+                continue;
+            if (!Number.isFinite(batch))
+                continue;
+            out.push({ name, batch });
+        }
+        return out;
+    },
+    async listAllCompletedNames(db, params) {
+        assertDbSupportsMigrations(db);
+        const rows = await QueryBuilder.create('migrations', db)
+            .select('name')
+            .where('status', '=', 'completed')
+            .andWhere('scope', '=', params.scope)
+            .andWhere('service', '=', toSafeService(params.service))
+            .orderBy('batch', 'DESC')
+            .orderBy('id', 'DESC')
+            .get();
+        return rows.map((r) => (typeof r.name === 'string' ? r.name : '')).filter((n) => n.length > 0);
+    },
+    async deleteRecord(db, params) {
+        assertDbSupportsMigrations(db);
+        await QueryBuilder.create('migrations', db)
+            .where('name', '=', params.name)
+            .andWhere('scope', '=', params.scope)
+            .andWhere('service', '=', toSafeService(params.service))
+            .delete();
+    },
+});

package/src/performance/CodeGenerationBenchmark.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CodeGenerationBenchmark.d.ts","sourceRoot":"","sources":["../../../src/performance/CodeGenerationBenchmark.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,WAAW,wBAAwB;IACvC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,KAAK,yBAAyB,GAAG;IAC/B,IAAI,wBAAwB,CAAC;IAC7B,MAAM,EAAE,MAAM,wBAAwB,CAAC;CACxC,CAAC;AAgDF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,yBAmCG,CAAC;AAoL1C;;GAEG;AACH,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAOjE"}
+{"version":3,"file":"CodeGenerationBenchmark.d.ts","sourceRoot":"","sources":["../../../src/performance/CodeGenerationBenchmark.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,MAAM,WAAW,wBAAwB;IACvC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,KAAK,yBAAyB,GAAG;IAC/B,IAAI,wBAAwB,CAAC;IAC7B,MAAM,EAAE,MAAM,wBAAwB,CAAC;CACxC,CAAC;AAgDF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,yBAmCG,CAAC;AAoL1C;;GAEG;AACH,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAOjE"}

package/src/performance/Optimizer.d.ts

@@ -63,6 +63,7 @@ export declare const ParallelGenerator: Readonly<{
 export declare function createMemoized<T extends (...args: any[]) => any>(fn: T, options?: {
     ttl?: number;
     keyGenerator?: (args: Parameters<T>) => string;
+    maxSize?: number;
 }): T;
 export declare const Memoize: Readonly<{
     create: typeof createMemoized;

package/src/performance/Optimizer.d.ts.map

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

package/src/performance/Optimizer.js

@@ -340,17 +340,51 @@ export const ParallelGenerator = Object.freeze({
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function createMemoized(fn, options = {}) {
     const cache = new Map();
+    const maxSize = options.maxSize ?? 1000; // Default max size: 1000 entries
+    const evictLRU = () => {
+        if (cache.size < maxSize)
+            return;
+        // Find oldest entry (LRU)
+        let oldestKey = null;
+        let oldestTime = Infinity;
+        for (const [key, entry] of cache.entries()) {
+            if (entry.lastAccessAt < oldestTime) {
+                oldestTime = entry.lastAccessAt;
+                oldestKey = key;
+            }
+        }
+        if (oldestKey !== null) {
+            cache.delete(oldestKey);
+        }
+    };
     return ((...args) => {
-        const key = options.keyGenerator === undefined ? JSON.stringify(args) : options.keyGenerator(args);
+        let key;
+        if (options.keyGenerator === undefined) {
+            // Optimization: Avoid JSON.stringify for simple primitive arguments
+            const arePrimitives = args.every((a) => a === null ||
+                typeof a === 'string' ||
+                typeof a === 'number' ||
+                typeof a === 'boolean' ||
+                a === 'undefined');
+            key = arePrimitives ? args.join('|') : JSON.stringify(args);
+        }
+        else {
+            key = options.keyGenerator(args);
+        }
         const entry = cache.get(key);
         if (entry !== undefined) {
-            if (options.ttl === undefined || Date.now() - entry.timestamp < options.ttl) {
+            if (options.ttl === undefined || Date.now() - entry.createdAt < options.ttl) {
+                // Update access time for LRU; TTL remains based on creation time
+                entry.lastAccessAt = Date.now();
                 return entry.result;
             }
             cache.delete(key);
         }
         const result = fn(...args);
-        cache.set(key, { result, timestamp: Date.now() });
+        // Evict LRU before adding new entry
+        evictLRU();
+        const now = Date.now();
+        cache.set(key, { result, createdAt: now, lastAccessAt: now });
         return result;
     });
 }

package/src/profiling/MemoryProfiler.d.ts

@@ -2,7 +2,7 @@
  * Memory Profiler
  * Tracks heap memory usage and garbage collection events
  */
-import { MemoryDelta, MemorySnapshot } from './types';
+import type { MemoryDelta, MemorySnapshot } from './types';
 export interface IMemoryProfiler {
     start(): void;
     end(): MemorySnapshot;

package/src/profiling/MemoryProfiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MemoryProfiler.d.ts","sourceRoot":"","sources":["../../../src/profiling/MemoryProfiler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC9B,KAAK,IAAI,IAAI,CAAC;IACd,GAAG,IAAI,cAAc,CAAC;IACtB,KAAK,IAAI,WAAW,CAAC;IACrB,gBAAgB,IAAI,cAAc,GAAG,IAAI,CAAC;IAC1C,cAAc,IAAI,cAAc,GAAG,IAAI,CAAC;IACxC,SAAS,IAAI,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc;IACzB;;OAEG;cACO,eAAe;IAmEzB;;OAEG;uBACgB,MAAM,GAAG,MAAM;EAGlC,CAAC;AAEH;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQjD"}
+{"version":3,"file":"MemoryProfiler.d.ts","sourceRoot":"","sources":["../../../src/profiling/MemoryProfiler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,KAAK,IAAI,IAAI,CAAC;IACd,GAAG,IAAI,cAAc,CAAC;IACtB,KAAK,IAAI,WAAW,CAAC;IACrB,gBAAgB,IAAI,cAAc,GAAG,IAAI,CAAC;IAC1C,cAAc,IAAI,cAAc,GAAG,IAAI,CAAC;IACxC,SAAS,IAAI,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc;IACzB;;OAEG;cACO,eAAe;IAmEzB;;OAEG;uBACgB,MAAM,GAAG,MAAM;EAGlC,CAAC;AAEH;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQjD"}

package/src/profiling/N1Detector.d.ts

@@ -2,7 +2,7 @@
  * N+1 Query Pattern Detector
  * Analyzes query logs to identify N+1 patterns
  */
-import { IN1Detector } from './types';
+import type { IN1Detector } from './types';
 /**\n * N1Detector analyzes query logs to identify N+1 patterns
  * Groups identical queries and flags those executed 5+ times as critical
  * Sealed namespace for immutability

package/src/profiling/N1Detector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"N1Detector.d.ts","sourceRoot":"","sources":["../../../src/profiling/N1Detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAA4B,MAAM,kBAAkB,CAAC;AAEzE;;;GAGG;AACH,eAAO,MAAM,UAAU;IACrB;;OAEG;cACO,WAAW;EAiCrB,CAAC"}
+{"version":3,"file":"N1Detector.d.ts","sourceRoot":"","sources":["../../../src/profiling/N1Detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAA4B,MAAM,kBAAkB,CAAC;AAE9E;;;GAGG;AACH,eAAO,MAAM,UAAU;IACrB;;OAEG;cACO,WAAW;EAiCrB,CAAC"}

package/src/profiling/QueryLogger.d.ts

@@ -2,7 +2,7 @@
  * Query Logger
  * Tracks database query execution with parameters, duration, and context
  */
-import { QueryLogEntry } from './types';
+import type { QueryLogEntry } from './types';
 /**
  * QueryLogger tracks all database queries executed during a request context
  * Provides N+1 detection heuristic by flagging identical queries executed 5+ times

package/src/profiling/QueryLogger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QueryLogger.d.ts","sourceRoot":"","sources":["../../../src/profiling/QueryLogger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC;;OAEG;IACH,UAAU,IAAI,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnF;;OAEG;IACH,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CAAC;IAE/C;;OAEG;IACH,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,GAAG;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAE3F;;OAEG;IACH,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CAAC;IAErE;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;OAEG;IACH,UAAU,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;IAE3C;;OAEG;IACH,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAExC;;OAEG;IACH,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5C;AASD;;;;GAIG;AACH,eAAO,MAAM,WAAW;;mBAGP,YAAY;IAG3B;;OAEG;wBACiB,MAAM,GAAG,IAAI;IAcjC;;OAEG;kBACW,MAAM;IAIpB;;OAEG;kBAEI,MAAM,UACH,OAAO,EAAE,YACP,MAAM,YACP,MAAM,GACd,IAAI;IA+BP;;OAEG;0BACkB,MAAM,GAAoB,aAAa,EAAE;IAK9D;;OAEG;8BAEQ,MAAM,GACd,GAAG,CAAC,MAAM,EAAE,aAAa,GAAG;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IAiB1D;;;OAGG;4BACoB,MAAM,cAA8B,MAAM,GAAO,aAAa,EAAE;IAavF;;OAEG;oBACa,MAAM,GAAG,IAAI;IAS7B;;OAEG;kBACW,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;IAU1C;;OAEG;4BACoB,MAAM,GAAoB,MAAM;IAIvD;;OAEG;+BACuB,MAAM,GAAoB,MAAM;EAI1D,CAAC"}
+{"version":3,"file":"QueryLogger.d.ts","sourceRoot":"","sources":["../../../src/profiling/QueryLogger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC;;OAEG;IACH,UAAU,IAAI,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnF;;OAEG;IACH,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CAAC;IAE/C;;OAEG;IACH,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,GAAG;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAE3F;;OAEG;IACH,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CAAC;IAErE;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;OAEG;IACH,UAAU,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;IAE3C;;OAEG;IACH,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAExC;;OAEG;IACH,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5C;AASD;;;;GAIG;AACH,eAAO,MAAM,WAAW;;mBAGP,YAAY;IAG3B;;OAEG;wBACiB,MAAM,GAAG,IAAI;IAcjC;;OAEG;kBACW,MAAM;IAIpB;;OAEG;kBAEI,MAAM,UACH,OAAO,EAAE,YACP,MAAM,YACP,MAAM,GACd,IAAI;IA+BP;;OAEG;0BACkB,MAAM,GAAoB,aAAa,EAAE;IAK9D;;OAEG;8BAEQ,MAAM,GACd,GAAG,CAAC,MAAM,EAAE,aAAa,GAAG;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IAiB1D;;;OAGG;4BACoB,MAAM,cAA8B,MAAM,GAAO,aAAa,EAAE;IAavF;;OAEG;oBACa,MAAM,GAAG,IAAI;IAS7B;;OAEG;kBACW,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;IAU1C;;OAEG;4BACoB,MAAM,GAAoB,MAAM;IAIvD;;OAEG;+BACuB,MAAM,GAAoB,MAAM;EAI1D,CAAC"}

package/src/profiling/RequestProfiler.d.ts

@@ -2,9 +2,9 @@
  * Request Profiler
  * Comprehensive profiling of request execution combining query, N+1, and memory metrics
  */
-import { IMemoryProfiler } from './MemoryProfiler';
-import { IQueryLogger } from './QueryLogger';
-import { IN1Detector, ProfileReport } from './types';
+import type { IMemoryProfiler } from './MemoryProfiler';
+import type { IQueryLogger } from './QueryLogger';
+import type { IN1Detector, ProfileReport } from './types';
 export interface IRequestProfiler {
     getQueryLogger(): IQueryLogger;
     getN1Detector(): IN1Detector;

package/src/profiling/RequestProfiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RequestProfiler.d.ts","sourceRoot":"","sources":["../../../src/profiling/RequestProfiler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAkB,MAAM,2BAA2B,CAAC;AAE5E,OAAO,EAAE,YAAY,EAAe,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAa,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAC/B,cAAc,IAAI,YAAY,CAAC;IAC/B,aAAa,IAAI,WAAW,CAAC;IAC7B,iBAAiB,IAAI,eAAe,CAAC;IACrC,cAAc,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACnE,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAAC;CAChD;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe;IAC1B;;OAEG;cACO,gBAAgB;EAkE1B,CAAC;AAmBH;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,eAAe,eAAe,CAAC"}
+{"version":3,"file":"RequestProfiler.d.ts","sourceRoot":"","sources":["../../../src/profiling/RequestProfiler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAC,MAAM,2BAA2B,CAAC;AAGhE,OAAO,KAAK,EAAE,YAAY,EAAC,MAAM,wBAAwB,CAAC;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAa,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE9E,MAAM,WAAW,gBAAgB;IAC/B,cAAc,IAAI,YAAY,CAAC;IAC/B,aAAa,IAAI,WAAW,CAAC;IAC7B,iBAAiB,IAAI,eAAe,CAAC;IACrC,cAAc,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACnE,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAAC;CAChD;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe;IAC1B;;OAEG;cACO,gBAAgB;EAkE1B,CAAC;AAmBH;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,eAAe,eAAe,CAAC"}

package/src/routes/metrics.d.ts

@@ -0,0 +1,2 @@
+export { registerMetricsRoutes } from '../../routes/metrics';
+//# sourceMappingURL=metrics.d.ts.map

package/src/routes/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/routes/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC"}

package/src/routes/metrics.js

@@ -0,0 +1 @@
+export { registerMetricsRoutes } from '../../routes/metrics.js';

package/src/routing/CoreRoutes.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Core Routes - Framework built-in routes
+ * Health, metrics, and documentation endpoints
+ * Not customizable by developers; provide env-based configuration
+ */
+import type { IRouter } from './Router';
+/**
+ * Register all core framework routes
+ */
+export declare const registerCoreRoutes: (router: IRouter) => void;
+export default registerCoreRoutes;
+//# sourceMappingURL=CoreRoutes.d.ts.map

package/src/routing/CoreRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreRoutes.d.ts","sourceRoot":"","sources":["../../../src/routing/CoreRoutes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAqJ/C;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,OAAO,KAAG,IAMpD,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/src/routing/CoreRoutes.js

@@ -0,0 +1,151 @@
+/**
+ * Core Routes - Framework built-in routes
+ * Health, metrics, and documentation endpoints
+ * Not customizable by developers; provide env-based configuration
+ */
+import { RuntimeHealthProbes } from '../health/RuntimeHealthProbes.js';
+import { PrometheusMetrics } from '../observability/PrometheusMetrics.js';
+import { appConfig } from '../config/app.js';
+import { Env } from '../config/env.js';
+import { Logger } from '../config/logger.js';
+import { useDatabase } from '../orm/Database.js';
+import { QueryBuilder } from '../orm/QueryBuilder.js';
+import { registerDocRoutes } from './doc.js';
+import { registerErrorRoutes } from './error.js';
+import { registerErrorPagesRoutes } from './errorPages.js';
+import { Router } from './Router.js';
+/**
+ * Register health endpoints
+ */
+async function handleHealthRoute(_req, res) {
+    const environment = Env.NODE_ENV ?? 'development';
+    try {
+        const db = useDatabase();
+        const maybeIsConnected = db.isConnected;
+        const maybeConnect = db.connect;
+        if (typeof maybeIsConnected === 'function' && maybeIsConnected.call(db) === false) {
+            if (typeof maybeConnect === 'function') {
+                await maybeConnect.call(db);
+            }
+        }
+        await QueryBuilder.ping(db);
+        const uptime = typeof process !== 'undefined' && typeof process.uptime === 'function' ? process.uptime() : 0;
+        res.json({
+            status: 'healthy',
+            timestamp: new Date().toISOString(),
+            uptime,
+            database: 'connected',
+            environment,
+        });
+    }
+    catch (error) {
+        Logger.error('Health check failed:', error);
+        const isProd = environment === 'production' || environment === 'prod';
+        res.setStatus(503).json({
+            status: 'unhealthy',
+            timestamp: new Date().toISOString(),
+            database: 'disconnected',
+            error: isProd ? 'Service unavailable' : error.message,
+        });
+    }
+}
+function handleHealthLiveRoute(_req, res) {
+    const uptime = typeof process !== 'undefined' && typeof process.uptime === 'function' ? process.uptime() : 0;
+    res.json({
+        status: 'alive',
+        timestamp: new Date().toISOString(),
+        uptime,
+    });
+}
+async function handleHealthReadyRoute(_req, res) {
+    const startTime = Date.now();
+    const environment = appConfig.environment;
+    let databaseResponseTime = null;
+    let cacheResponseTime = null;
+    try {
+        const db = useDatabase();
+        const maybeIsConnected = db.isConnected;
+        const maybeConnect = db.connect;
+        if (typeof maybeIsConnected === 'function' && maybeIsConnected.call(db) === false) {
+            if (typeof maybeConnect === 'function') {
+                await maybeConnect.call(db);
+            }
+        }
+        await QueryBuilder.ping(db);
+        databaseResponseTime = Date.now() - startTime;
+        cacheResponseTime = await RuntimeHealthProbes.pingKvCache(2000);
+        res.json({
+            status: 'ready',
+            timestamp: new Date().toISOString(),
+            environment,
+            dependencies: {
+                database: {
+                    status: 'ready',
+                    responseTime: databaseResponseTime,
+                },
+                ...(cacheResponseTime === null
+                    ? {}
+                    : {
+                        cache: {
+                            status: 'ready',
+                            responseTime: cacheResponseTime,
+                        },
+                    }),
+            },
+        });
+    }
+    catch (error) {
+        Logger.error('Readiness check failed:', error);
+        const isProd = environment === 'production';
+        const responseTime = Date.now() - startTime;
+        const dependencies = {
+            database: {
+                status: databaseResponseTime === null ? 'unavailable' : 'ready',
+                responseTime: databaseResponseTime ?? responseTime,
+            },
+        };
+        if (RuntimeHealthProbes.getCacheDriverName() === 'kv') {
+            dependencies['cache'] = {
+                status: 'unavailable',
+                responseTime: cacheResponseTime ?? responseTime,
+            };
+        }
+        res.setStatus(503).json({
+            status: 'not_ready',
+            timestamp: new Date().toISOString(),
+            environment,
+            dependencies,
+            error: isProd ? 'Service unavailable' : error.message,
+        });
+    }
+}
+function registerHealthRoutes(router) {
+    Router.get(router, '/health', handleHealthRoute);
+    Router.get(router, '/health/live', handleHealthLiveRoute);
+    Router.get(router, '/health/ready', handleHealthReadyRoute);
+}
+/**
+ * Register metrics endpoint
+ */
+const registerMetricsRoutes = (router) => {
+    if (Env.getBool('METRICS_ENABLED', false) === false)
+        return;
+    const pathFromEnv = Env.get('METRICS_PATH', '/metrics').trim();
+    const metricsPath = pathFromEnv === '' ? '/metrics' : pathFromEnv;
+    Router.get(router, metricsPath, async (_req, res) => {
+        const { contentType, body } = await PrometheusMetrics.getMetricsText();
+        res.setHeader('Content-Type', contentType);
+        res.send(body);
+    });
+};
+/**
+ * Register all core framework routes
+ */
+export const registerCoreRoutes = (router) => {
+    registerHealthRoutes(router);
+    registerMetricsRoutes(router);
+    registerDocRoutes(router);
+    registerErrorPagesRoutes(router);
+    registerErrorRoutes(router);
+};
+export default registerCoreRoutes;

package/src/routing/RouteRegistry.d.ts

@@ -0,0 +1,39 @@
+import type { ISchema, SchemaType } from '../validation/Validator';
+export type ValidationSchema = ISchema | SchemaType;
+export type RouteMetaInput = RouteMeta | {
+    summary?: string;
+    description?: string;
+    tags?: readonly string[];
+    requestSchema?: ValidationSchema;
+    responseSchema?: unknown;
+    responseStatus?: number;
+};
+export type RouteMeta = {
+    summary?: string;
+    description?: string;
+    tags?: readonly string[];
+    request?: {
+        bodySchema?: ValidationSchema;
+        querySchema?: ValidationSchema;
+        paramsSchema?: ValidationSchema;
+        headersSchema?: ValidationSchema;
+    };
+    response?: {
+        status?: number;
+        schema?: unknown;
+    };
+};
+export type RouteRegistration = {
+    method: string;
+    path: string;
+    middleware?: readonly string[];
+    meta?: RouteMeta;
+};
+export declare const normalizeRouteMeta: (input?: RouteMetaInput) => RouteMeta | undefined;
+export declare const RouteRegistry: Readonly<{
+    record(route: RouteRegistration): void;
+    list(): readonly RouteRegistration[];
+    clear(): void;
+}>;
+export default RouteRegistry;
+//# sourceMappingURL=RouteRegistry.d.ts.map

package/src/routing/RouteRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteRegistry.d.ts","sourceRoot":"","sources":["../../../src/routing/RouteRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEjE,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,UAAU,CAAC;AAEpD,MAAM,MAAM,cAAc,GACtB,SAAS,GACT;IACE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,gBAAgB,CAAC;IACjC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEN,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAEzB,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,gBAAgB,CAAC;QAC9B,WAAW,CAAC,EAAE,gBAAgB,CAAC;QAC/B,YAAY,CAAC,EAAE,gBAAgB,CAAC;QAChC,aAAa,CAAC,EAAE,gBAAgB,CAAC;KAClC,CAAC;IAEF,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,QAAQ,cAAc,KAAG,SAAS,GAAG,SAwCvE,CAAC;AAUF,eAAO,MAAM,aAAa;kBACV,iBAAiB,GAAG,IAAI;YAI9B,SAAS,iBAAiB,EAAE;aAK3B,IAAI;EAGb,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/src/routing/RouteRegistry.js

@@ -0,0 +1,44 @@
+export const normalizeRouteMeta = (input) => {
+    if (input === undefined)
+        return undefined;
+    // If it already looks like the normalized shape, return as-is.
+    if (typeof input === 'object' &&
+        input !== null &&
+        ('request' in input || 'response' in input || 'summary' in input || 'tags' in input)) {
+        const any = input;
+        return any;
+    }
+    const any = input;
+    return {
+        summary: any.summary,
+        description: any.description,
+        tags: any.tags,
+        request: any.requestSchema === undefined
+            ? undefined
+            : {
+                bodySchema: any.requestSchema,
+            },
+        response: any.responseSchema === undefined && any.responseStatus === undefined
+            ? undefined
+            : {
+                status: any.responseStatus,
+                schema: any.responseSchema,
+            },
+    };
+};
+const state = {
+    routes: [],
+};
+export const RouteRegistry = Object.freeze({
+    record(route) {
+        state.routes.push(route);
+    },
+    list() {
+        // Return readonly reference to avoid unnecessary array cloning
+        return state.routes;
+    },
+    clear() {
+        state.routes.length = 0;
+    },
+});
+export default RouteRegistry;