@zintrust/core 0.1.19 → 0.1.21

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

@@ -3,16 +3,16 @@
  * Implements caching, lazy-loading, and parallel generation
  */
 export interface IGenerationCache {
-    get(type: string, params: Record<string, unknown>): string | null;
-    set(type: string, params: Record<string, unknown>, code: string): void;
-    save(): void;
-    clear(): void;
-    getStats(): {
+    get(type: string, params: Record<string, unknown>): Promise<string | null>;
+    set(type: string, params: Record<string, unknown>, code: string): Promise<void>;
+    save(): Promise<void>;
+    clear(): Promise<void>;
+    getStats(): Promise<{
         size: number;
         entries: number;
         diskUsage: string;
         keys: string[];
-    };
+    }>;
 }
 /**
  * Generation Cache - Cache generated code to avoid re-generating identical code
@@ -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

@@ -95,26 +95,26 @@ function startCacheCleanup(state) {
 function createCacheInstance(state) {
     return {
         /**
-         * Get from cache
+         * Get from cache (async)
          */
-        get(type, params) {
+        async get(type, params) {
             const key = getCacheKey(type, params);
             const entry = state.cache.get(key);
             if (entry === undefined)
-                return null;
+                return Promise.resolve(null); //NoSONAR
             // Check TTL
             if (Date.now() - entry.timestamp > state.ttlMs) {
                 state.cache.delete(key);
                 const file = path.join(state.cacheDir, `${key}.json`);
                 deleteFileNonBlocking(file);
-                return null;
+                return Promise.resolve(null); //NoSONAR
             }
-            return entry.code;
+            return Promise.resolve(entry.code); //NoSONAR
         },
         /**
-         * Set in cache
+         * Set in cache (async)
          */
-        set(type, params, code) {
+        async set(type, params, code) {
             const key = getCacheKey(type, params);
             // If key already exists, delete first so insertion order updates for LRU
             if (state.cache.has(key))
@@ -134,27 +134,36 @@ function createCacheInstance(state) {
                     deleteFileNonBlocking(file);
                 }
             }
+            // Save to disk asynchronously
+            const file = path.join(state.cacheDir, `${key}.json`);
+            try {
+                await fs.fsPromises.access(state.cacheDir);
+            }
+            catch {
+                await fs.fsPromises.mkdir(state.cacheDir, { recursive: true });
+            }
+            await fs.fsPromises.writeFile(file, JSON.stringify({ code, timestamp: Date.now() }, null, 2));
         },
         /**
-         * Save cache to disk
+         * Save cache to disk (async)
          */
-        save() {
-            saveCacheToDisk(state);
+        async save() {
+            await saveCacheToDisk(state);
         },
         /**
-         * Clear cache
+         * Clear cache (async)
          */
-        clear() {
+        async clear() {
             if (state.cleanupInterval) {
                 clearInterval(state.cleanupInterval);
                 state.cleanupInterval = undefined;
             }
-            clearCache(state);
+            await clearCache(state);
         },
         /**
-         * Get cache statistics
+         * Get cache statistics (async)
          */
-        getStats() {
+        async getStats() {
             return getCacheStats(state);
         },
     };
@@ -166,38 +175,66 @@ function attachCacheStateForTests(instance, state) {
     });
 }
 /**
- * Save cache to disk
+ * Save cache to disk (async)
  */
-function saveCacheToDisk(state) {
-    if (fs.existsSync(state.cacheDir) === false) {
-        fs.mkdirSync(state.cacheDir, { recursive: true });
+async function saveCacheToDisk(state) {
+    try {
+        try {
+            await fs.fsPromises.access(state.cacheDir);
+        }
+        catch {
+            await fs.fsPromises.mkdir(state.cacheDir, { recursive: true });
+        }
+        const writes = Array.from(state.cache.entries()).map(async ([key, entry]) => {
+            const file = path.join(state.cacheDir, `${key}.json`);
+            await fs.fsPromises.writeFile(file, JSON.stringify(entry, null, 2));
+        });
+        await Promise.all(writes);
     }
-    for (const [key, entry] of state.cache.entries()) {
-        const file = path.join(state.cacheDir, `${key}.json`);
-        fs.writeFileSync(file, JSON.stringify(entry, null, 2));
+    catch (error) {
+        Logger.error('Failed to save cache to disk', error);
     }
 }
 /**
- * Clear cache
+ * Clear cache (async)
  */
-function clearCache(state) {
+async function clearCache(state) {
     state.cache.clear();
-    if (fs.existsSync(state.cacheDir) === true) {
-        fs.rmSync(state.cacheDir, { recursive: true });
+    try {
+        try {
+            await fs.fsPromises.access(state.cacheDir);
+        }
+        catch {
+            return; // Dir doesn't exist
+        }
+        await fs.fsPromises.rm(state.cacheDir, { recursive: true });
+    }
+    catch (error) {
+        Logger.error('Failed to clear cache', error);
     }
 }
 /**
- * Get cache statistics
+ * Get cache statistics (async)
  */
-function getCacheStats(state) {
+async function getCacheStats(state) {
     let diskUsage = 0;
-    if (fs.existsSync(state.cacheDir) === true) {
-        const files = fs.readdirSync(state.cacheDir);
-        for (const file of files) {
-            const stats = fs.statSync(path.join(state.cacheDir, file));
-            diskUsage += stats.size;
+    try {
+        try {
+            await fs.fsPromises.access(state.cacheDir);
+            const files = await fs.fsPromises.readdir(state.cacheDir);
+            const sizes = await Promise.all(files.map(async (file) => {
+                const stats = await fs.fsPromises.stat(path.join(state.cacheDir, file));
+                return stats.size;
+            }));
+            diskUsage = sizes.reduce((sum, size) => sum + size, 0);
+        }
+        catch {
+            // ignore
         }
     }
+    catch {
+        // ignore
+    }
     return {
         size: diskUsage,
         entries: state.cache.size,
@@ -242,23 +279,38 @@ function toInt32(value) {
     return uint32 > 2147483647 ? uint32 - 4294967296 : uint32;
 }
 /**
- * Load cache from disk
+ * Load cache from disk (async)
  */
-function loadFromDisk(state) {
-    if (fs.existsSync(state.cacheDir) === true) {
+async function loadFromDisk(state) {
+    try {
         try {
-            const files = fs.readdirSync(state.cacheDir);
-            for (const file of files) {
-                if (file.endsWith('.json') === true) {
-                    const content = fs.readFileSync(path.join(state.cacheDir, file), 'utf-8');
-                    const data = JSON.parse(content);
-                    state.cache.set(file.replace('.json', ''), data);
-                }
-            }
+            await fs.fsPromises.access(state.cacheDir);
         }
-        catch (err) {
-            Logger.error(`Failed to load cache from disk: ${err instanceof Error ? err.message : String(err)}`);
+        catch {
+            return;
         }
+        const files = await fs.fsPromises.readdir(state.cacheDir);
+        const jsonFiles = files.filter((file) => file.endsWith('.json') === true);
+        const parsedEntries = await Promise.all(jsonFiles.map(async (file) => {
+            const filePath = path.join(state.cacheDir, file);
+            const content = await fs.fsPromises.readFile(filePath, 'utf-8');
+            try {
+                const data = JSON.parse(content);
+                return { key: file.replace('.json', ''), data };
+            }
+            catch {
+                // ignore corrupted files
+                return null;
+            }
+        }));
+        for (const entry of parsedEntries) {
+            if (entry !== null) {
+                state.cache.set(entry.key, entry.data);
+            }
+        }
+    }
+    catch (err) {
+        Logger.error(`Failed to load cache from disk: ${err instanceof Error ? err.message : String(err)}`);
     }
 }
 /**
@@ -340,17 +392,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;
     });
 }
@@ -440,17 +526,36 @@ async function generateInParallel(stats, generators, batchSize) {
  */
 async function generateWithCache(cache, stats, type, params, generatorFn) {
     // Try cache
-    const cached = cache.get(type, params);
+    let cached = null;
+    try {
+        cached = await cache.get(type, params);
+    }
+    catch (err) {
+        Logger.warn('GenerationCache.get failed; treating as cache miss', {
+            type,
+            error: err instanceof Error ? err.message : String(err),
+        });
+    }
     if (cached !== null) {
-        stats.cacheHits++;
-        return JSON.parse(cached);
+        try {
+            stats.cacheHits++;
+            return JSON.parse(cached);
+        }
+        catch (err) {
+            Logger.warn('Failed to parse cached generation result; treating as cache miss', {
+                type,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
     }
     // Generate
     const startTime = performance.now();
     const result = await generatorFn();
     const duration = performance.now() - startTime;
-    // Cache result
-    cache.set(type, params, JSON.stringify(result));
+    // Cache result (fire-and-forget)
+    void cache
+        .set(type, params, JSON.stringify(result))
+        .catch((err) => Logger.error('GenerationCache.set failed', err));
     stats.cacheMisses++;
     stats.savedTime += duration;
     return result;
@@ -458,6 +563,16 @@ async function generateWithCache(cache, stats, type, params, generatorFn) {
 /**
  * Get optimization statistics
  */
+function getCacheStatusSync(cache) {
+    const state = cache[GENERATION_CACHE_STATE_SYMBOL];
+    const map = state?.cache;
+    if (!(map instanceof Map))
+        return { size: 0, keys: [] };
+    return {
+        size: map.size,
+        keys: Array.from(map.keys()),
+    };
+}
 function getOptimizerStats(cache, stats) {
     const total = stats.cacheHits + stats.cacheMisses;
     const hitRate = total > 0 ? (stats.cacheHits / total) * 100 : 0;
@@ -467,7 +582,7 @@ function getOptimizerStats(cache, stats) {
         hitRate: `${hitRate.toFixed(1)}%`,
         parallelRuns: stats.parallelRuns,
         estimatedSavedTime: `${stats.savedTime.toFixed(2)}ms`,
-        cacheStatus: cache.getStats(),
+        cacheStatus: getCacheStatusSync(cache),
     };
 }
 export default PerformanceOptimizer;

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"}