@zintrust/core 0.1.0 → 0.1.2

package/src/orm/QueryBuilder.js

@@ -7,20 +7,115 @@ import { ErrorFactory } from '../exceptions/ZintrustError';
  * Escape SQL identifier
  */
 const escapeIdentifier = (id) => `"${id.replaceAll('"', '""')}"`;
+const SAFE_IDENTIFIER_PATH = /^[A-Za-z_]\w*(?:\.[A-Za-z_]\w*)*$/;
+const assertSafeIdentifierPath = (id, label) => {
+    const trimmed = id.trim();
+    if (trimmed.length === 0) {
+        throw ErrorFactory.createDatabaseError(`Empty SQL identifier for ${label}`);
+    }
+    if (!SAFE_IDENTIFIER_PATH.test(trimmed)) {
+        throw ErrorFactory.createDatabaseError(`Unsafe SQL identifier for ${label}`);
+    }
+};
+const normalizeOrderDirection = (direction) => {
+    if (direction === undefined || direction === null)
+        return 'ASC';
+    const trimmed = String(direction).trim();
+    if (trimmed.length === 0)
+        return 'ASC';
+    const normalized = trimmed.toUpperCase();
+    if (normalized === 'ASC' || normalized === 'DESC')
+        return normalized;
+    throw ErrorFactory.createDatabaseError('Unsafe ORDER BY direction');
+};
+const normalizeOperator = (operator) => operator.trim().toUpperCase();
+const ALLOWED_OPERATORS = new Set([
+    '=',
+    '!=',
+    '<>',
+    '<',
+    '<=',
+    '>',
+    '>=',
+    'LIKE',
+    'NOT LIKE',
+    'ILIKE',
+    'NOT ILIKE',
+    'IN',
+    'NOT IN',
+    'BETWEEN',
+    'NOT BETWEEN',
+    'IS',
+    'IS NOT',
+]);
+const assertSafeOperator = (operator) => {
+    const normalized = normalizeOperator(operator);
+    if (!ALLOWED_OPERATORS.has(normalized)) {
+        throw ErrorFactory.createDatabaseError('Unsafe SQL operator');
+    }
+    return normalized;
+};
+const assertSafeLimitOffset = (value, label) => {
+    if (!Number.isFinite(value) || !Number.isInteger(value) || value < 0) {
+        throw ErrorFactory.createDatabaseError(`Unsafe ${label} value`);
+    }
+};
+const isNumericLiteral = (value) => {
+    // Strict, injection-resistant numeric literal allow-list.
+    // Allows: 0, 1, 1.5, 0001
+    // Disallows: 1e3, 1;DROP, 1 as ok
+    return /^(?:0|[1-9]\d*)(?:\.\d+)?$/.test(value);
+};
 /**
  * Build SELECT clause
  */
-const buildSelectClause = (columns) => columns.map((c) => (c === '*' ? c : escapeIdentifier(c))).join(', ');
-/**
- * Build WHERE clause
- */
-const buildWhereClause = (conditions) => {
+const buildSelectClause = (columns) => columns
+    .map((c) => {
+    if (c === '*')
+        return c;
+    if (isNumericLiteral(c))
+        return c;
+    assertSafeIdentifierPath(c, 'select column');
+    return escapeIdentifier(c);
+})
+    .join(', ');
+const compileWhere = (conditions) => {
     if (conditions.length === 0)
-        return '';
-    const sql = conditions
-        .map((clause) => `${escapeIdentifier(clause.column)} ${clause.operator} ?`)
-        .join(' AND ');
-    return ` WHERE ${sql}`;
+        return { sql: '', parameters: [] };
+    const parameters = [];
+    const clauses = conditions.map((clause) => {
+        assertSafeIdentifierPath(clause.column, 'where column');
+        const operator = assertSafeOperator(clause.operator);
+        const columnSql = escapeIdentifier(clause.column);
+        if (operator === 'IN' || operator === 'NOT IN') {
+            if (!Array.isArray(clause.value) || clause.value.length === 0) {
+                throw ErrorFactory.createDatabaseError('IN operator requires a non-empty array');
+            }
+            const values = clause.value;
+            const placeholders = values.map(() => '?').join(', ');
+            for (const v of values)
+                parameters.push(v);
+            return `${columnSql} ${operator} (${placeholders})`;
+        }
+        if (operator === 'BETWEEN' || operator === 'NOT BETWEEN') {
+            if (!Array.isArray(clause.value) || clause.value.length !== 2) {
+                throw ErrorFactory.createDatabaseError('BETWEEN operator requires a 2-item array');
+            }
+            const range = clause.value;
+            parameters.push(range[0], range[1]);
+            return `${columnSql} ${operator} ? AND ?`;
+        }
+        if (operator === 'IS' || operator === 'IS NOT') {
+            if (clause.value === null || clause.value === undefined) {
+                return `${columnSql} ${operator} NULL`;
+            }
+            parameters.push(clause.value);
+            return `${columnSql} ${operator} ?`;
+        }
+        parameters.push(clause.value);
+        return `${columnSql} ${operator} ?`;
+    });
+    return { sql: ` WHERE ${clauses.join(' AND ')}`, parameters };
 };
 /**
  * Build ORDER BY clause
@@ -28,19 +123,74 @@ const buildWhereClause = (conditions) => {
 const buildOrderByClause = (orderBy) => {
     if (!orderBy)
         return '';
-    return ` ORDER BY ${orderBy.column} ${orderBy.direction}`;
+    const col = orderBy.column.trim();
+    if (!isNumericLiteral(col)) {
+        assertSafeIdentifierPath(col, 'order by column');
+    }
+    const dir = normalizeOrderDirection(orderBy.direction);
+    // Keep output unquoted for backwards compatibility; validation prevents injection.
+    return ` ORDER BY ${col} ${dir}`;
 };
 /**
  * Build LIMIT and OFFSET clause
  */
 const buildLimitOffsetClause = (limit, offset) => {
     let sql = '';
-    if (limit !== undefined && limit !== null)
+    if (limit !== undefined && limit !== null) {
+        assertSafeLimitOffset(limit, 'LIMIT');
         sql += ` LIMIT ${limit}`;
-    if (offset !== undefined && offset !== null)
+    }
+    if (offset !== undefined && offset !== null) {
+        assertSafeLimitOffset(offset, 'OFFSET');
         sql += ` OFFSET ${offset}`;
+    }
     return sql;
 };
+const buildSelectQuery = (state) => {
+    if (state.tableName.length > 0) {
+        assertSafeIdentifierPath(state.tableName, 'table name');
+    }
+    const columns = buildSelectClause(state.selectColumns);
+    const fromClause = state.tableName.length > 0 ? ` FROM ${escapeIdentifier(state.tableName)}` : '';
+    const where = compileWhere(state.whereConditions);
+    const sql = `SELECT ${columns}${fromClause}${where.sql}${buildOrderByClause(state.orderByClause)}${buildLimitOffsetClause(state.limitValue, state.offsetValue)}`;
+    return { sql, parameters: where.parameters };
+};
+const applyWhereCondition = (state, column, operator, value) => {
+    const col = String(column).trim();
+    assertSafeIdentifierPath(col, 'where column');
+    let op;
+    let val;
+    // Shorthand: where('id', 123)
+    if (value === undefined) {
+        op = '=';
+        val = operator;
+    }
+    else {
+        if (typeof operator !== 'string') {
+            throw ErrorFactory.createDatabaseError('Unsafe SQL operator');
+        }
+        op = assertSafeOperator(operator);
+        val = value;
+    }
+    state.whereConditions.push({ column: col, operator: op, value: val });
+};
+const applyOrderByClause = (state, column, direction) => {
+    const col = String(column).trim();
+    if (!isNumericLiteral(col)) {
+        assertSafeIdentifierPath(col, 'order by column');
+    }
+    const dir = normalizeOrderDirection(direction);
+    state.orderByClause = { column: col, direction: dir };
+};
+const applyLimit = (state, count) => {
+    assertSafeLimitOffset(count, 'LIMIT');
+    state.limitValue = count;
+};
+const applyOffset = (state, count) => {
+    assertSafeLimitOffset(count, 'OFFSET');
+    state.offsetValue = count;
+};
 /**
  * Execute query and return first result
  */
@@ -69,9 +219,7 @@ function createBuilder(state, db) {
             return builder;
         },
         where: (column, operator, value) => {
-            const finalOperator = value === undefined ? '=' : operator;
-            const finalValue = value === undefined ? operator : value;
-            state.whereConditions.push({ column, operator: finalOperator, value: finalValue });
+            applyWhereCondition(state, column, operator, value);
             return builder;
         },
         andWhere: (column, operator, value) => builder.where(column, operator, value),
@@ -82,15 +230,15 @@ function createBuilder(state, db) {
         },
         leftJoin: (tableJoin, on) => builder.join(tableJoin, on),
         orderBy: (column, direction = 'ASC') => {
-            state.orderByClause = { column, direction };
+            applyOrderByClause(state, column, direction);
             return builder;
         },
         limit: (count) => {
-            state.limitValue = count;
+            applyLimit(state, count);
             return builder;
         },
         offset: (count) => {
-            state.offsetValue = count;
+            applyOffset(state, count);
             return builder;
         },
         getWhereClauses: () => state.whereConditions,
@@ -101,12 +249,8 @@ function createBuilder(state, db) {
         getOrderBy: () => state.orderByClause,
         getJoins: () => state.joins,
         isReadOperation: () => true,
-        toSQL: () => {
-            const columns = buildSelectClause(state.selectColumns);
-            const tableEscaped = escapeIdentifier(state.tableName);
-            return `SELECT ${columns} FROM ${tableEscaped}${buildWhereClause(state.whereConditions)}${buildOrderByClause(state.orderByClause)}${buildLimitOffsetClause(state.limitValue, state.offsetValue)}`;
-        },
-        getParameters: () => state.whereConditions.map((clause) => clause.value),
+        toSQL: () => buildSelectQuery(state).sql,
+        getParameters: () => buildSelectQuery(state).parameters,
         first: async () => executeFirst(builder, db),
         get: async () => executeGet(builder, db),
     };
@@ -122,13 +266,29 @@ export const QueryBuilder = Object.freeze({
     /**
      * Create a new query builder instance
      */
-    create(table, db) {
+    create(tableOrDb, db) {
+        const hasTable = typeof tableOrDb === 'string';
+        const tableName = hasTable ? String(tableOrDb).trim() : '';
+        const database = hasTable ? db : tableOrDb;
+        if (tableName.length > 0) {
+            assertSafeIdentifierPath(tableName, 'table name');
+        }
         const state = {
-            tableName: table,
+            tableName,
             whereConditions: [],
             selectColumns: ['*'],
             joins: [],
         };
-        return createBuilder(state, db);
+        return createBuilder(state, database);
+    },
+    /**
+     * Ping the database connection.
+     *
+     * This is intentionally a tiny, dependency-free check that can be reused by
+     * health/readiness endpoints without embedding SQL in route handlers.
+     */
+    async ping(db) {
+        // Use the QueryBuilder itself to avoid embedding raw SQL at call sites.
+        await QueryBuilder.create('', db).select('1').get();
     },
 });

package/src/orm/adapters/D1Adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"D1Adapter.d.ts","sourceRoot":"","sources":["../../../../src/orm/adapters/D1Adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,cAAc,EAAe,gBAAgB,EAAe,MAAM,sBAAsB,CAAC;AAoBlG;;GAEG;AACH,eAAO,MAAM,SAAS;IACpB;;OAEG;oBAEa,cAAc,GAAG,gBAAgB;EAkGjD,CAAC;AAEH,eAAe,SAAS,CAAC"}
+{"version":3,"file":"D1Adapter.d.ts","sourceRoot":"","sources":["../../../../src/orm/adapters/D1Adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAE,cAAc,EAAe,gBAAgB,EAAe,MAAM,sBAAsB,CAAC;AAUlG;;GAEG;AACH,eAAO,MAAM,SAAS;IACpB;;OAEG;oBAEa,cAAc,GAAG,gBAAgB;EAkHjD,CAAC;AAEH,eAAe,SAAS,CAAC"}

package/src/orm/adapters/D1Adapter.js

@@ -1,25 +1,16 @@
 /**
  * Cloudflare D1 Database Adapter
  */
+import { Cloudflare } from '../../config/cloudflare';
 import { FeatureFlags } from '../../config/features';
 import { Logger } from '../../config/logger';
 import { ErrorFactory } from '../../exceptions/ZintrustError';
+import { QueryBuilder } from '../QueryBuilder';
 /**
  * Get D1 binding from config or global environment
  */
 function getD1Binding(_config) {
-    // 1. Check config
-    if (_config.d1 !== undefined && _config.d1 !== null)
-        return _config.d1;
-    // 2. Check global env (Cloudflare Workers)
-    const globalEnv = globalThis.env;
-    if (globalEnv?.DB !== undefined)
-        return globalEnv.DB;
-    // 3. Check global scope
-    const globalDB = globalThis.DB;
-    if (globalDB !== undefined)
-        return globalDB;
-    return null;
+    return Cloudflare.getD1Binding(_config);
 }
 /**
  * D1 adapter implementation
@@ -78,6 +69,21 @@ export const D1Adapter = Object.freeze({
                     throw ErrorFactory.createTryCatchError(`D1 queryOne failed: ${sql}`, error);
                 }
             },
+            async ping() {
+                if (!connected)
+                    throw ErrorFactory.createConnectionError('Database not connected');
+                const db = getD1Binding(_config);
+                if (db === null) {
+                    throw ErrorFactory.createConfigError('D1 database binding not found');
+                }
+                try {
+                    // Use a minimal, side-effect-free query.
+                    await db.prepare(QueryBuilder.create('').select('1').toSQL()).bind().first();
+                }
+                catch (error) {
+                    throw ErrorFactory.createTryCatchError('D1 ping failed', error);
+                }
+            },
             async transaction(callback) {
                 if (!connected)
                     throw ErrorFactory.createConnectionError('Database not connected');

package/src/orm/adapters/MySQLAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MySQLAdapter.d.ts","sourceRoot":"","sources":["../../../../src/orm/adapters/MySQLAdapter.ts"],"names":[],"mappings":"AAEA;;GAEG;AAKH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAe,MAAM,sBAAsB,CAAC;AAErF;;;GAGG;AACH,eAAO,MAAM,YAAY;IACvB;;OAEG;mBACY,cAAc,GAAG,gBAAgB;EA0EhD,CAAC;AAEH,eAAe,YAAY,CAAC"}
+{"version":3,"file":"MySQLAdapter.d.ts","sourceRoot":"","sources":["../../../../src/orm/adapters/MySQLAdapter.ts"],"names":[],"mappings":"AAEA;;GAEG;AAKH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAe,MAAM,sBAAsB,CAAC;AAGrF;;;GAGG;AACH,eAAO,MAAM,YAAY;IACvB;;OAEG;mBACY,cAAc,GAAG,gBAAgB;EA8EhD,CAAC;AAEH,eAAe,YAAY,CAAC"}

package/src/orm/adapters/MySQLAdapter.js

@@ -6,6 +6,7 @@
 import { FeatureFlags } from '../../config/features';
 import { Logger } from '../../config/logger';
 import { ErrorFactory } from '../../exceptions/ZintrustError';
+import { QueryBuilder } from '../QueryBuilder';
 /**
  * MySQL adapter implementation
  * Sealed namespace for immutability
@@ -38,6 +39,9 @@ export const MySQLAdapter = Object.freeze({
                 const result = await this.query(sql, parameters);
                 return result.rows[0] ?? null;
             },
+            async ping() {
+                await this.query(QueryBuilder.create('').select('1').toSQL(), []);
+            },
             async transaction(callback) {
                 if (!connected)
                     throw ErrorFactory.createConnectionError('Database not connected');

package/src/orm/adapters/PostgreSQLAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PostgreSQLAdapter.d.ts","sourceRoot":"","sources":["../../../../src/orm/adapters/PostgreSQLAdapter.ts"],"names":[],"mappings":"AAEA;;GAEG;AAKH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAe,MAAM,sBAAsB,CAAC;AAErF;;;GAGG;AACH,eAAO,MAAM,iBAAiB;IAC5B;;OAEG;mBACY,cAAc,GAAG,gBAAgB;EA6EhD,CAAC;AAEH,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"PostgreSQLAdapter.d.ts","sourceRoot":"","sources":["../../../../src/orm/adapters/PostgreSQLAdapter.ts"],"names":[],"mappings":"AAEA;;GAEG;AAKH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAe,MAAM,sBAAsB,CAAC;AAGrF;;;GAGG;AACH,eAAO,MAAM,iBAAiB;IAC5B;;OAEG;mBACY,cAAc,GAAG,gBAAgB;EAiFhD,CAAC;AAEH,eAAe,iBAAiB,CAAC"}

package/src/orm/adapters/PostgreSQLAdapter.js

@@ -6,6 +6,7 @@
 import { FeatureFlags } from '../../config/features';
 import { Logger } from '../../config/logger';
 import { ErrorFactory } from '../../exceptions/ZintrustError';
+import { QueryBuilder } from '../QueryBuilder';
 /**
  * PostgreSQL adapter implementation
  * Sealed namespace for immutability
@@ -38,6 +39,9 @@ export const PostgreSQLAdapter = Object.freeze({
                 const result = await this.query(sql, parameters);
                 return result.rows[0] ?? null;
             },
+            async ping() {
+                await this.query(QueryBuilder.create('').select('1').toSQL(), []);
+            },
             async transaction(callback) {
                 if (!connected)
                     throw ErrorFactory.createConnectionError('Database not connected');

package/src/orm/adapters/SQLServerAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SQLServerAdapter.d.ts","sourceRoot":"","sources":["../../../../src/orm/adapters/SQLServerAdapter.ts"],"names":[],"mappings":"AAEA;;GAEG;AAKH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAe,MAAM,sBAAsB,CAAC;AAErF;;;GAGG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;OAEG;mBACY,cAAc,GAAG,gBAAgB;EAwEhD,CAAC;AAEH,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"SQLServerAdapter.d.ts","sourceRoot":"","sources":["../../../../src/orm/adapters/SQLServerAdapter.ts"],"names":[],"mappings":"AAEA;;GAEG;AAKH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAe,MAAM,sBAAsB,CAAC;AAGrF;;;GAGG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;OAEG;mBACY,cAAc,GAAG,gBAAgB;EA4EhD,CAAC;AAEH,eAAe,gBAAgB,CAAC"}

package/src/orm/adapters/SQLServerAdapter.js

@@ -6,6 +6,7 @@
 import { FeatureFlags } from '../../config/features';
 import { Logger } from '../../config/logger';
 import { ErrorFactory } from '../../exceptions/ZintrustError';
+import { QueryBuilder } from '../QueryBuilder';
 /**
  * SQL Server adapter implementation
  * Sealed namespace for immutability
@@ -38,6 +39,9 @@ export const SQLServerAdapter = Object.freeze({
                 const result = await this.query(sql, parameters);
                 return result.rows[0] ?? null;
             },
+            async ping() {
+                await this.query(QueryBuilder.create('').select('1').toSQL(), []);
+            },
             async transaction(callback) {
                 try {
                     return await callback(this);

package/src/orm/adapters/SQLiteAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SQLiteAdapter.d.ts","sourceRoot":"","sources":["../../../../src/orm/adapters/SQLiteAdapter.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAMH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAe,MAAM,sBAAsB,CAAC;AA4HrF,iBAAS,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,gBAAgB,CAgDrE;AAED,eAAO,MAAM,aAAa;;EAExB,CAAC"}
+{"version":3,"file":"SQLiteAdapter.d.ts","sourceRoot":"","sources":["../../../../src/orm/adapters/SQLiteAdapter.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAMH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAe,MAAM,sBAAsB,CAAC;AA6HrF,iBAAS,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,gBAAgB,CAoDrE;AAED,eAAO,MAAM,aAAa;;EAExB,CAAC"}

package/src/orm/adapters/SQLiteAdapter.js

@@ -8,6 +8,7 @@ import { FeatureFlags } from '../../config/features';
 import { Logger } from '../../config/logger';
 import { ErrorFactory } from '../../exceptions/ZintrustError';
 import { performance } from '../../node-singletons/perf-hooks';
+import { QueryBuilder } from '../QueryBuilder';
 import Database from 'better-sqlite3';
 function normalizeFilename(database) {
     const value = (database ?? '').trim();
@@ -107,6 +108,9 @@ function createSQLiteAdapter(config) {
             const result = await adapter.query(sql, parameters);
             return result.rows[0] ?? null;
         },
+        async ping() {
+            await adapter.query(QueryBuilder.create('').select('1').toSQL(), []);
+        },
         async transaction(callback) {
             return transactionSQLite(state, adapter, callback);
         },

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

@@ -1 +1 @@
-{"version":3,"file":"Benchmark.d.ts","sourceRoot":"","sources":["../../../src/performance/Benchmark.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,CAAC,EACP,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,CAAC,EACX,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,eAAe,CAAC;IACnB,YAAY,CAAC,CAAC,EACZ,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5B,UAAU,IAAI,eAAe,EAAE,CAAC;IAChC,QAAQ,IAAI,MAAM,CAAC;IACnB,MAAM,IAAI,cAAc,CAAC;IACzB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,QAAQ,EAAE,cAAc,GAAG,gBAAgB,CAAC;IACpD,mBAAmB,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM,CAAC;CAC3D;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS;IACpB;;OAEG;kBACU,MAAM,GAAuB,UAAU;EAuCpD,CAAC;AAkMH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,IAAI,IAAI,cAAc,EAAE,CAAC;IACzB,QAAQ,IAAI,WAAW,CAAC;IACxB,WAAW,IAAI,MAAM,CAAC;CACvB;AACD;;;GAGG;AACH,eAAO,MAAM,aAAa;IACxB;;OAEG;cACO,cAAc;EA6ExB,CAAC"}
+{"version":3,"file":"Benchmark.d.ts","sourceRoot":"","sources":["../../../src/performance/Benchmark.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,CAAC,EACP,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,CAAC,EACX,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,eAAe,CAAC;IACnB,YAAY,CAAC,CAAC,EACZ,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5B,UAAU,IAAI,eAAe,EAAE,CAAC;IAChC,QAAQ,IAAI,MAAM,CAAC;IACnB,MAAM,IAAI,cAAc,CAAC;IACzB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,QAAQ,EAAE,cAAc,GAAG,gBAAgB,CAAC;IACpD,mBAAmB,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM,CAAC;CAC3D;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS;IACpB;;OAEG;kBACU,MAAM,GAAuB,UAAU;EAuCpD,CAAC;AAqMH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,IAAI,IAAI,cAAc,EAAE,CAAC;IACzB,QAAQ,IAAI,WAAW,CAAC;IACxB,WAAW,IAAI,MAAM,CAAC;CACvB;AACD;;;GAGG;AACH,eAAO,MAAM,aAAa;IACxB;;OAEG;cACO,cAAc;EA6ExB,CAAC"}

package/src/performance/Benchmark.js

@@ -70,12 +70,15 @@ function runMeasure(name, fn, iterations, metadata) {
 async function runMeasureAsync(name, fn, iterations, metadata) {
     const durations = [];
     const memBefore = process.memoryUsage().heapUsed;
+    // Benchmark iterations must run sequentially to measure time per run.
+    /* eslint-disable no-await-in-loop */
     for (let i = 0; i < iterations; i++) {
         const start = performance.now();
         await fn();
         const duration = performance.now() - start;
         durations.push(duration);
     }
+    /* eslint-enable no-await-in-loop */
     const memAfter = process.memoryUsage().heapUsed;
     const totalDuration = durations.reduce((a, b) => a + b, 0);
     return {

package/src/performance/CodeGenerationBenchmark.js

@@ -2,12 +2,12 @@
  * Code Generation Benchmarks
  * Measure performance of all code generators
  */
+import { esmFilePath } from '../common/index';
 import { Logger } from '../config/logger';
 import { ErrorFactory } from '../exceptions/ZintrustError';
 import { fs } from '../node-singletons/index.js';
-import { fileURLToPath } from '../node-singletons/url';
+import * as path from '../node-singletons/path';
 import { Benchmark, MemoryMonitor } from './Benchmark';
-import * as path from 'node:path';
 function isBenchmarkFactory(value) {
     if (typeof value !== 'object' || value === null)
         return false;
@@ -221,7 +221,7 @@ const isMain = (() => {
         const entrypoint = process.argv[1];
         if (typeof entrypoint !== 'string')
             return false;
-        const currentFilePath = fileURLToPath(new URL(import.meta.url));
+        const currentFilePath = esmFilePath(import.meta.url);
         // Use realpathSync to handle symlinks (common on macOS /var -> /private/var)
         if (!('realpathSync' in fs)) {
             return path.resolve(entrypoint) === path.resolve(currentFilePath);

package/src/performance/Optimizer.d.ts

@@ -22,7 +22,7 @@ export declare const GenerationCache: Readonly<{
     /**
      * Create a new generation cache instance
      */
-    create(cacheDir?: string, ttlMs?: number): IGenerationCache;
+    create(cacheDir?: string, ttlMs?: number, maxEntries?: number): IGenerationCache;
 }>;
 export interface ILazyLoader {
     load<T>(modulePath: string): Promise<T>;

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

@@ -1 +1 @@
-{"version":3,"file":"Optimizer.d.ts","sourceRoot":"","sources":["../../../src/performance/Optimizer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IAClE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACvE,IAAI,IAAI,IAAI,CAAC;IACb,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,IAAI;QACV,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;CACH;AASD;;;GAGG;AACH,eAAO,MAAM,eAAe;IAC1B;;OAEG;sBAES,MAAM,UACT,MAAM,GACZ,gBAAgB;EAyFnB,CAAC;AAiHH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU;IACrB;;OAEG;cACO,WAAW;EAqCrB,CAAC;AAEH;;GAEG;AAEH;;GAEG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,UAAU,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EACnC,SAAS,GAAE,MAAU,GACpB,OAAO,CAAC,CAAC,EAAE,CAAC,CAUd;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAEjF;AAED,eAAO,MAAM,iBAAiB;;;EAG5B,CAAC;AAEH;;GAEG;AAEH;;GAEG;AAEH,wBAAgB,cAAc,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAC9D,EAAE,EAAE,CAAC,EACL,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,CAAA;CAAO,GAC7E,CAAC,CAmBH;AAED,eAAO,MAAM,OAAO;;EAElB,CAAC;AAEH,MAAM,WAAW,qBAAqB;IACpC,iBAAiB,CAAC,CAAC,EACjB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,WAAW,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAC5B,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,kBAAkB,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7F,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,QAAQ,IAAI;QACV,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,WAAW,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC;KAC/C,CAAC;IACF,SAAS,IAAI,IAAI,CAAC;IAClB,KAAK,IAAI,IAAI,CAAC;CACf;AASD;;;GAGG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;OAEG;cACO,qBAAqB;EAoE/B,CAAC;AA0FH,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"Optimizer.d.ts","sourceRoot":"","sources":["../../../src/performance/Optimizer.ts"],"names":[],"mappings":"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"}