code-auditor-mcp 4.1.0 → 5.0.1

package/dist/services/whitelistService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"whitelistService.d.ts","sourceRoot":"","sources":["../../src/services/whitelistService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,EACf,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAI/B,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmB;IAE1C,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,gBAAgB;IAOtC;;OAEG;IACG,YAAY,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAK7F;;OAEG;IACG,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,aAAa,EACnB,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,cAAc,CAAC;IAY1B;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxE;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAKxE;;OAEG;IACG,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAoDhF;;OAEG;IACG,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAOlF;;OAEG;IACG,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;QACxD,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,mBAAmB,EAAE,CAAC;KACpC,CAAC;IA0BF;;OAEG;IACG,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;QAC3D,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;IAyBF;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;OAEG;IACH,OAAO,CAAC,eAAe;CA6BxB;AAGD,eAAO,MAAM,gBAAgB,kBAAiC,CAAC;AAE/D,wBAAsB,YAAY,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,eAAe,6BAEhF;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,aAAa,EACnB,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,2BAGpB;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,iBAEhF;AAED,wBAAsB,yBAAyB,CAAC,WAAW,EAAE,MAAM,kCAElE;AAED,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,MAAM;WA3IpD,MAAM;iBACA,mBAAmB,EAAE;GA4IrC"}
+{"version":3,"file":"whitelistService.d.ts","sourceRoot":"","sources":["../../src/services/whitelistService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,EACf,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAyC/B;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmB;IAE1C,OAAO;IAEP;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,gBAAgB;IAOtC;;OAEG;IACG,YAAY,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAK7F;;;;;;;;OAQG;IACG,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,aAAa,EACnB,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,cAAc,CAAC;IAY1B;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxE;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAKxE;;;;;OAKG;IACG,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAoDhF;;;;;OAKG;IACG,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAOlF;;;;;OAKG;IACG,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;QACxD,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,mBAAmB,EAAE,CAAC;KACpC,CAAC;IA0BF;;;;;OAKG;IACG,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;QAC3D,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;IAyBF;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;OAEG;IACH,OAAO,CAAC,eAAe;CAGxB;AAYD,eAAO,MAAM,gBAAgB,kBAAiC,CAAC;AAE/D,wBAAsB,YAAY,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,eAAe,6BAEhF;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,aAAa,EACnB,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,2BAGpB;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,iBAEhF;AAED,wBAAsB,yBAAyB,CAAC,WAAW,EAAE,MAAM,kCAElE;AAED,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,MAAM;WAvHpD,MAAM;iBACA,mBAAmB,EAAE;GAwHrC"}

package/dist/services/whitelistService.js

@@ -6,9 +6,52 @@ import { getDatabase } from '../codeIndexService.js';
 import { WhitelistType, WhitelistStatus } from '../types/whitelist.js';
 import { promises as fs } from 'fs';
 import path from 'path';
+const FRAMEWORK_LIBRARIES = [
+    'react', 'react-dom', 'react-router', 'react-redux',
+    'vue', 'vue-router', 'vuex',
+    'angular', '@angular/core', '@angular/common',
+    'next', 'nextjs', '@next/font',
+    'express', 'fastify', 'koa',
+    'nestjs', '@nestjs/core',
+    'electron',
+    '@testing-library/react', 'jest', 'vitest', 'mocha',
+    'webpack', 'vite', 'rollup', 'parcel',
+    'typescript', '@types/node'
+];
+const SHARED_LIBRARIES = [
+    'lodash', 'underscore', 'ramda',
+    'axios', 'node-fetch', 'got', 'ky',
+    'moment', 'dayjs', 'date-fns',
+    'uuid', 'nanoid', 'shortid',
+    'chalk', 'colors', 'ora', 'inquirer',
+    'dotenv', 'config', 'yargs', 'commander',
+    'joi', 'yup', 'zod', 'ajv',
+    'winston', 'pino', 'bunyan', 'debug',
+    'prettier', 'eslint', '@typescript-eslint',
+    'husky', 'lint-staged',
+    'classnames', 'clsx',
+    'query-string', 'qs',
+    'formik', 'react-hook-form',
+    'swr', 'react-query', '@tanstack/react-query',
+    'zustand', 'mobx', 'recoil', 'jotai',
+    'styled-components', 'emotion', '@emotion/styled',
+    'tailwindcss', 'postcss', 'autoprefixer',
+    'framer-motion', 'react-spring',
+    'd3', 'chart.js', 'recharts',
+    'monaco-editor', 'codemirror',
+    'markdown-it', 'marked', 'remark'
+];
+/**
+ * Manages whitelisted dependencies and classes for the SOLID analyzer.
+ */
 export class WhitelistService {
     static instance;
     constructor() { }
+    /**
+     * Return the process-wide singleton service instance.
+     *
+     * @returns The singleton `WhitelistService`.
+     */
     static getInstance() {
         if (!WhitelistService.instance) {
             WhitelistService.instance = new WhitelistService();
@@ -20,14 +63,20 @@ export class WhitelistService {
      */
     async getWhitelist(type, status) {
         const db = await getDatabase();
-        return db.getWhitelist(type, status);
+        return db.whitelist.getWhitelist(type, status);
     }
     /**
-     * Add a new whitelist entry
+     * Add a new whitelist entry.
+     *
+     * @param name - The entry name to whitelist.
+     * @param type - The whitelist type.
+     * @param description - Optional entry description.
+     * @param patterns - Optional matching patterns.
+     * @returns The created whitelist entry.
      */
     async addEntry(name, type, description, patterns) {
         const db = await getDatabase();
-        return db.addWhitelistEntry({
+        return db.whitelist.addWhitelistEntry({
             name,
             type,
             status: WhitelistStatus.Active,
@@ -41,17 +90,20 @@ export class WhitelistService {
      */
     async updateStatus(name, status) {
         const db = await getDatabase();
-        await db.updateWhitelistStatus(name, status);
+        await db.whitelist.updateWhitelistStatus(name, status);
     }
     /**
      * Check if a name is whitelisted
      */
     async isWhitelisted(name, type) {
         const db = await getDatabase();
-        return db.isWhitelisted(name, type);
+        return db.whitelist.isWhitelisted(name, type);
     }
     /**
-     * Detect whitelist candidates from package.json
+     * Detect whitelist candidates from package.json.
+     *
+     * @param projectPath - The project path whose dependencies are scanned.
+     * @returns The candidate whitelist suggestions.
      */
     async detectFromPackageJson(projectPath) {
         const suggestions = [];
@@ -99,7 +151,10 @@ export class WhitelistService {
         return suggestions;
     }
     /**
-     * Detect whitelist candidates from usage patterns
+     * Detect whitelist candidates from usage patterns.
+     *
+     * @param projectPath - The project path to scan for usage patterns.
+     * @returns The candidate whitelist suggestions.
      */
     async detectFromUsagePatterns(projectPath) {
         // TODO: Implement usage pattern detection
@@ -108,7 +163,10 @@ export class WhitelistService {
         return [];
     }
     /**
-     * Auto-populate whitelist for a project
+     * Auto-populate whitelist for a project.
+     *
+     * @param projectPath - The project whose high-confidence candidates are added.
+     * @returns The number added and the remaining low-confidence suggestions.
      */
     async autoPopulateWhitelist(projectPath) {
         const suggestions = await this.detectFromPackageJson(projectPath);
@@ -131,7 +189,10 @@ export class WhitelistService {
         };
     }
     /**
-     * Whitelist ALL dependencies from package.json
+     * Whitelist ALL dependencies from package.json.
+     *
+     * @param projectPath - The project whose dependencies are all whitelisted.
+     * @returns The number added and any dependency names that failed.
      */
     async whitelistAllDependencies(projectPath) {
         const suggestions = await this.detectFromPackageJson(projectPath);
@@ -156,55 +217,35 @@ export class WhitelistService {
      * Check if a dependency is a known framework library
      */
     isFrameworkLibrary(dep) {
-        const frameworks = [
-            'react', 'react-dom', 'react-router', 'react-redux',
-            'vue', 'vue-router', 'vuex',
-            'angular', '@angular/core', '@angular/common',
-            'next', 'nextjs', '@next/font',
-            'express', 'fastify', 'koa',
-            'nestjs', '@nestjs/core',
-            'electron',
-            '@testing-library/react', 'jest', 'vitest', 'mocha',
-            'webpack', 'vite', 'rollup', 'parcel',
-            'typescript', '@types/node'
-        ];
-        return frameworks.some(framework => dep === framework || dep.startsWith(`${framework}/`) || dep.startsWith(`@${framework}/`));
+        return matchesLibrary(dep, FRAMEWORK_LIBRARIES);
     }
     /**
      * Check if a dependency is a common shared/utility library
      */
     isSharedLibrary(dep) {
-        const sharedLibs = [
-            'lodash', 'underscore', 'ramda',
-            'axios', 'node-fetch', 'got', 'ky',
-            'moment', 'dayjs', 'date-fns',
-            'uuid', 'nanoid', 'shortid',
-            'chalk', 'colors', 'ora', 'inquirer',
-            'dotenv', 'config', 'yargs', 'commander',
-            'joi', 'yup', 'zod', 'ajv',
-            'winston', 'pino', 'bunyan', 'debug',
-            'prettier', 'eslint', '@typescript-eslint',
-            'husky', 'lint-staged',
-            'classnames', 'clsx',
-            'query-string', 'qs',
-            'formik', 'react-hook-form',
-            'swr', 'react-query', '@tanstack/react-query',
-            'zustand', 'mobx', 'recoil', 'jotai',
-            'styled-components', 'emotion', '@emotion/styled',
-            'tailwindcss', 'postcss', 'autoprefixer',
-            'framer-motion', 'react-spring',
-            'd3', 'chart.js', 'recharts',
-            'monaco-editor', 'codemirror',
-            'markdown-it', 'marked', 'remark'
-        ];
-        return sharedLibs.some(lib => dep === lib || dep.startsWith(`${lib}/`) || dep.startsWith(`@${lib}/`));
+        return matchesLibrary(dep, SHARED_LIBRARIES);
     }
 }
+/**
+ * True when `dep` is the library or a subpath / scoped subpath of it.
+ */
+function matchesLibrary(dep, libs) {
+    return libs.some(lib => dep === lib || dep.startsWith(`${lib}/`) || dep.startsWith(`@${lib}/`));
+}
 // Export singleton instance methods for convenience
 export const whitelistService = WhitelistService.getInstance();
 export async function getWhitelist(type, status) {
     return whitelistService.getWhitelist(type, status);
 }
+/**
+ * Add a whitelist entry via the singleton service.
+ *
+ * @param name - The entry name to whitelist.
+ * @param type - The whitelist type.
+ * @param description - Optional entry description.
+ * @param patterns - Optional matching patterns.
+ * @returns The created whitelist entry.
+ */
 export async function addWhitelistEntry(name, type, description, patterns) {
     return whitelistService.addEntry(name, type, description, patterns);
 }

package/dist/services/whitelistService.js.map

@@ -1 +1 @@
-{"version":3,"file":"whitelistService.js","sourceRoot":"","sources":["../../src/services/whitelistService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAEL,aAAa,EACb,eAAe,EAEhB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,OAAO,gBAAgB;IACnB,MAAM,CAAC,QAAQ,CAAmB;IAE1C,gBAAuB,CAAC;IAExB,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC;YAC/B,gBAAgB,CAAC,QAAQ,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACrD,CAAC;QACD,OAAO,gBAAgB,CAAC,QAAQ,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,IAAoB,EAAE,MAAwB;QAC/D,MAAM,EAAE,GAAG,MAAM,WAAW,EAAE,CAAC;QAC/B,OAAO,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CACZ,IAAY,EACZ,IAAmB,EACnB,WAAoB,EACpB,QAAmB;QAEnB,MAAM,EAAE,GAAG,MAAM,WAAW,EAAE,CAAC;QAC/B,OAAO,EAAE,CAAC,iBAAiB,CAAC;YAC1B,IAAI;YACJ,IAAI;YACJ,MAAM,EAAE,eAAe,CAAC,MAAM;YAC9B,WAAW;YACX,QAAQ;YACR,OAAO,EAAE,MAAM;SAChB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,IAAY,EAAE,MAAuB;QACtD,MAAM,EAAE,GAAG,MAAM,WAAW,EAAE,CAAC;QAC/B,MAAM,EAAE,CAAC,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,IAAY,EAAE,IAAmB;QACnD,MAAM,EAAE,GAAG,MAAM,WAAW,EAAE,CAAC;QAC/B,OAAO,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CAAC,WAAmB;QAC7C,MAAM,WAAW,GAA0B,EAAE,CAAC;QAC9C,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QAE/D,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;YAC5E,MAAM,OAAO,GAAG;gBACd,GAAG,WAAW,CAAC,YAAY;gBAC3B,GAAG,WAAW,CAAC,eAAe;gBAC9B,GAAG,WAAW,CAAC,gBAAgB;aAChC,CAAC;YAEF,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBACrD,8BAA8B;gBAC9B,IAAI,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,aAAa,CAAC,iBAAiB,CAAC,EAAE,CAAC;oBACnE,SAAS;gBACX,CAAC;gBAED,iCAAiC;gBACjC,MAAM,UAAU,GAAwB;oBACtC,IAAI,EAAE,GAAG;oBACT,IAAI,EAAE,aAAa,CAAC,iBAAiB;oBACrC,MAAM,EAAE,uBAAuB,OAAO,GAAG;oBACzC,SAAS,EAAE,CAAC;oBACZ,QAAQ,EAAE,EAAE;oBACZ,UAAU,EAAE,GAAG;iBAChB,CAAC;gBAEF,uCAAuC;gBACvC,IAAI,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;oBACjC,UAAU,CAAC,IAAI,GAAG,aAAa,CAAC,cAAc,CAAC;oBAC/C,UAAU,CAAC,MAAM,GAAG,6BAA6B,OAAO,GAAG,CAAC;oBAC5D,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC;gBAC/B,CAAC;gBAED,yCAAyC;gBACzC,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC9B,UAAU,CAAC,IAAI,GAAG,aAAa,CAAC,aAAa,CAAC;oBAC9C,UAAU,CAAC,MAAM,GAAG,2BAA2B,OAAO,GAAG,CAAC;oBAC1D,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC;gBAC/B,CAAC;gBAED,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,sCAAsC;YACtC,OAAO,CAAC,IAAI,CAAC,kCAAkC,eAAe,GAAG,EAAE,KAAK,CAAC,CAAC;QAC5E,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,uBAAuB,CAAC,WAAmB;QAC/C,0CAA0C;QAC1C,sEAAsE;QACtE,2DAA2D;QAC3D,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CAAC,WAAmB;QAI7C,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC;QAClE,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,gDAAgD;QAChD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,IAAI,UAAU,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;gBAClC,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,QAAQ,CACjB,UAAU,CAAC,IAAI,EACf,UAAU,CAAC,IAAI,EACf,UAAU,CAAC,MAAM,CAClB,CAAC;oBACF,KAAK,EAAE,CAAC;gBACV,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,IAAI,CAAC,iBAAiB,UAAU,CAAC,IAAI,gBAAgB,EAAE,KAAK,CAAC,CAAC;gBACxE,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,KAAK;YACL,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC;SAC1D,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,wBAAwB,CAAC,WAAmB;QAIhD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC;QAClE,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,gDAAgD;QAChD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,QAAQ,CACjB,UAAU,CAAC,IAAI,EACf,UAAU,CAAC,IAAI,EACf,UAAU,CAAC,MAAM,CAClB,CAAC;gBACF,KAAK,EAAE,CAAC;YACV,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;oBAC3E,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;oBAC7B,OAAO,CAAC,IAAI,CAAC,iBAAiB,UAAU,CAAC,IAAI,gBAAgB,EAAE,KAAK,CAAC,CAAC;gBACxE,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,GAAW;QACpC,MAAM,UAAU,GAAG;YACjB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa;YACnD,KAAK,EAAE,YAAY,EAAE,MAAM;YAC3B,SAAS,EAAE,eAAe,EAAE,iBAAiB;YAC7C,MAAM,EAAE,QAAQ,EAAE,YAAY;YAC9B,SAAS,EAAE,SAAS,EAAE,KAAK;YAC3B,QAAQ,EAAE,cAAc;YACxB,UAAU;YACV,wBAAwB,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO;YACnD,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ;YACrC,YAAY,EAAE,aAAa;SAC5B,CAAC;QAEF,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CACjC,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,SAAS,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,SAAS,GAAG,CAAC,CACzF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,GAAW;QACjC,MAAM,UAAU,GAAG;YACjB,QAAQ,EAAE,YAAY,EAAE,OAAO;YAC/B,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI;YAClC,QAAQ,EAAE,OAAO,EAAE,UAAU;YAC7B,MAAM,EAAE,QAAQ,EAAE,SAAS;YAC3B,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU;YACpC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW;YACxC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YAC1B,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO;YACpC,UAAU,EAAE,QAAQ,EAAE,oBAAoB;YAC1C,OAAO,EAAE,aAAa;YACtB,YAAY,EAAE,MAAM;YACpB,cAAc,EAAE,IAAI;YACpB,QAAQ,EAAE,iBAAiB;YAC3B,KAAK,EAAE,aAAa,EAAE,uBAAuB;YAC7C,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO;YACpC,mBAAmB,EAAE,SAAS,EAAE,iBAAiB;YACjD,aAAa,EAAE,SAAS,EAAE,cAAc;YACxC,eAAe,EAAE,cAAc;YAC/B,IAAI,EAAE,UAAU,EAAE,UAAU;YAC5B,eAAe,EAAE,YAAY;YAC7B,aAAa,EAAE,QAAQ,EAAE,QAAQ;SAClC,CAAC;QAEF,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAC3B,GAAG,KAAK,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC,CACvE,CAAC;IACJ,CAAC;CACF;AAED,oDAAoD;AACpD,MAAM,CAAC,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,WAAW,EAAE,CAAC;AAE/D,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAoB,EAAE,MAAwB;IAC/E,OAAO,gBAAgB,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAY,EACZ,IAAmB,EACnB,WAAoB,EACpB,QAAmB;IAEnB,OAAO,gBAAgB,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAAY,EAAE,MAAuB;IAC/E,OAAO,gBAAgB,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,WAAmB;IACjE,OAAO,gBAAgB,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,WAAmB;IAC7D,OAAO,gBAAgB,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"whitelistService.js","sourceRoot":"","sources":["../../src/services/whitelistService.ts"],"names":[],"mappings":"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"}

package/dist/sqlite/betterSqlite3.d.ts

@@ -13,15 +13,49 @@
 import type { OpenSqliteOptions, SqliteDatabase, SqliteStatement, SqliteTransaction } from './types.js';
 /** True when `msg` indicates better-sqlite3's native binding was never built. */
 export declare function isMissingBetterSqlite3Binding(message: string): boolean;
-/** Capability probe: can this process load better-sqlite3 (binding included)? */
+/**
+ * Capability probe: can this process load better-sqlite3 (binding included)?
+ *
+ * @returns True when better-sqlite3 (with its native binding) loads.
+ */
 export declare function isBetterSqlite3Available(): boolean;
+/**
+ * SQLite database backed by the better-sqlite3 native module.
+ */
 export declare class BetterSqlite3Database implements SqliteDatabase {
     private readonly db;
+    /**
+     * Open (or create) a database through better-sqlite3.
+     * @param dbPath The database file path.
+     * @param opts Open options carrying the busy timeout.
+     */
     constructor(dbPath: string, opts: OpenSqliteOptions);
+    /**
+     * Prepare a SQL statement for later execution.
+     * @param sql The SQL to prepare.
+     * @returns A prepared statement.
+     */
     prepare(sql: string): SqliteStatement;
+    /**
+     * Execute one or more SQL statements directly.
+     * @param sql The SQL to execute.
+     */
     exec(sql: string): void;
+    /**
+     * Run a PRAGMA statement and return its result.
+     * @param pragmaSql The PRAGMA body (without the `PRAGMA` prefix).
+     * @returns The pragma result.
+     */
     pragma(pragmaSql: string): unknown;
+    /**
+     * Wrap a function in a SQLite transaction.
+     * @param fn The function to run transactionally.
+     * @returns A callable transaction.
+     */
     transaction<Args extends unknown[] = unknown[], R = unknown>(fn: (...args: Args) => R): SqliteTransaction<Args, R>;
+    /**
+     * Close the underlying database.
+     */
     close(): void;
 }
 //# sourceMappingURL=betterSqlite3.d.ts.map

package/dist/sqlite/betterSqlite3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"betterSqlite3.d.ts","sourceRoot":"","sources":["../../src/sqlite/betterSqlite3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,iBAAiB,EAClB,MAAM,YAAY,CAAC;AASpB,iFAAiF;AACjF,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtE;AA6BD,iFAAiF;AACjF,wBAAgB,wBAAwB,IAAI,OAAO,CAOlD;AAED,qBAAa,qBAAsB,YAAW,cAAc;IAC1D,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;gBAE3B,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB;IAKnD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe;IAIrC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIvB,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIlC,WAAW,CAAC,IAAI,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC,GAAG,OAAO,EACzD,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,GACvB,iBAAiB,CAAC,IAAI,EAAE,CAAC,CAAC;IAI7B,KAAK,IAAI,IAAI;CAGd"}
+{"version":3,"file":"betterSqlite3.d.ts","sourceRoot":"","sources":["../../src/sqlite/betterSqlite3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,iBAAiB,EAClB,MAAM,YAAY,CAAC;AASpB,iFAAiF;AACjF,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtE;AA6BD;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAOlD;AAED;;GAEG;AACH,qBAAa,qBAAsB,YAAW,cAAc;IAC1D,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;IAEvC;;;;OAIG;gBACS,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB;IAKnD;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe;IAIrC;;;OAGG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIvB;;;;OAIG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIlC;;;;OAIG;IACH,WAAW,CAAC,IAAI,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC,GAAG,OAAO,EACzD,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,GACvB,iBAAiB,CAAC,IAAI,EAAE,CAAC,CAAC;IAI7B;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/sqlite/betterSqlite3.js

@@ -44,7 +44,11 @@ function loadBetterSqlite3() {
         throw e instanceof Error ? e : new Error(String(e));
     }
 }
-/** Capability probe: can this process load better-sqlite3 (binding included)? */
+/**
+ * Capability probe: can this process load better-sqlite3 (binding included)?
+ *
+ * @returns True when better-sqlite3 (with its native binding) loads.
+ */
 export function isBetterSqlite3Available() {
     try {
         loadBetterSqlite3();
@@ -54,24 +58,54 @@ export function isBetterSqlite3Available() {
         return false;
     }
 }
+/**
+ * SQLite database backed by the better-sqlite3 native module.
+ */
 export class BetterSqlite3Database {
     db;
+    /**
+     * Open (or create) a database through better-sqlite3.
+     * @param dbPath The database file path.
+     * @param opts Open options carrying the busy timeout.
+     */
     constructor(dbPath, opts) {
         const DatabaseCtor = loadBetterSqlite3();
         this.db = new DatabaseCtor(dbPath, { timeout: opts.timeoutMs });
     }
+    /**
+     * Prepare a SQL statement for later execution.
+     * @param sql The SQL to prepare.
+     * @returns A prepared statement.
+     */
     prepare(sql) {
         return this.db.prepare(sql);
     }
+    /**
+     * Execute one or more SQL statements directly.
+     * @param sql The SQL to execute.
+     */
     exec(sql) {
         this.db.exec(sql);
     }
+    /**
+     * Run a PRAGMA statement and return its result.
+     * @param pragmaSql The PRAGMA body (without the `PRAGMA` prefix).
+     * @returns The pragma result.
+     */
     pragma(pragmaSql) {
         return this.db.pragma(pragmaSql);
     }
+    /**
+     * Wrap a function in a SQLite transaction.
+     * @param fn The function to run transactionally.
+     * @returns A callable transaction.
+     */
     transaction(fn) {
         return this.db.transaction(fn);
     }
+    /**
+     * Close the underlying database.
+     */
     close() {
         this.db.close();
     }

package/dist/sqlite/betterSqlite3.js.map

@@ -1 +1 @@
-{"version":3,"file":"betterSqlite3.js","sourceRoot":"","sources":["../../src/sqlite/betterSqlite3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAS5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,wBAAwB,GAAa;IACzC,qCAAqC,EAAE,wCAAwC;IAC/E,4BAA4B,EAAE,oCAAoC;CACnE,CAAC;AAEF,iFAAiF;AACjF,MAAM,UAAU,6BAA6B,CAAC,OAAe;IAC3D,OAAO,wBAAwB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,iFAAiF;AACjF,SAAS,qBAAqB,CAAC,QAAgB;IAC7C,OAAO,CACL,8EAA8E;QAC9E,gFAAgF;QAChF,wFAAwF;QACxF,+CAA+C;QAC/C,8EAA8E;QAC9E,2BAA2B;QAC3B,wDAAwD;QACxD,iCAAiC;QACjC,qBAAqB,QAAQ,EAAE,CAChC,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB;IACxB,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,gBAAgB,CAAoB,CAAC;IACtD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACvD,IAAI,6BAA6B,CAAC,GAAG,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9C,CAAC;QACD,MAAM,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,wBAAwB;IACtC,IAAI,CAAC;QACH,iBAAiB,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,OAAO,qBAAqB;IACf,EAAE,CAAoB;IAEvC,YAAY,MAAc,EAAE,IAAuB;QACjD,MAAM,YAAY,GAAG,iBAAiB,EAAE,CAAC;QACzC,IAAI,CAAC,EAAE,GAAG,IAAI,YAAY,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,CAAC,GAAW;QACjB,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAoB,CAAC;IACjD,CAAC;IAED,IAAI,CAAC,GAAW;QACd,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,CAAC,SAAiB;QACtB,OAAO,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAED,WAAW,CACT,EAAwB;QAExB,OAAO,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,CAA+B,CAAC;IAC/D,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF"}
+{"version":3,"file":"betterSqlite3.js","sourceRoot":"","sources":["../../src/sqlite/betterSqlite3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAS5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,wBAAwB,GAAa;IACzC,qCAAqC,EAAE,wCAAwC;IAC/E,4BAA4B,EAAE,oCAAoC;CACnE,CAAC;AAEF,iFAAiF;AACjF,MAAM,UAAU,6BAA6B,CAAC,OAAe;IAC3D,OAAO,wBAAwB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,iFAAiF;AACjF,SAAS,qBAAqB,CAAC,QAAgB;IAC7C,OAAO,CACL,8EAA8E;QAC9E,gFAAgF;QAChF,wFAAwF;QACxF,+CAA+C;QAC/C,8EAA8E;QAC9E,2BAA2B;QAC3B,wDAAwD;QACxD,iCAAiC;QACjC,qBAAqB,QAAQ,EAAE,CAChC,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB;IACxB,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,gBAAgB,CAAoB,CAAC;IACtD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACvD,IAAI,6BAA6B,CAAC,GAAG,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9C,CAAC;QACD,MAAM,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB;IACtC,IAAI,CAAC;QACH,iBAAiB,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,qBAAqB;IACf,EAAE,CAAoB;IAEvC;;;;OAIG;IACH,YAAY,MAAc,EAAE,IAAuB;QACjD,MAAM,YAAY,GAAG,iBAAiB,EAAE,CAAC;QACzC,IAAI,CAAC,EAAE,GAAG,IAAI,YAAY,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,GAAW;QACjB,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAoB,CAAC;IACjD,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,GAAW;QACd,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAiB;QACtB,OAAO,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,WAAW,CACT,EAAwB;QAExB,OAAO,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,CAA+B,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/sqlite/driver.d.ts

@@ -11,6 +11,16 @@
  * backend for the parity test suite; an invalid value is an error.
  */
 import type { OpenSqliteOptions, SqliteBackend, SqliteDatabase } from './types.js';
+/**
+ * SQLite busy timeout shared by every open path (the facade and the LokiJS
+ * migration). The database is shared across forked processes (a detached audit
+ * runner and its shard workers); better-sqlite3's default busy timeout (~5s) is
+ * too short for a running job's long completion transaction, so a queued job's
+ * lease `BEGIN IMMEDIATE` (or the runner's own writes) would throw SQLITE_BUSY
+ * ("database is locked") instead of waiting. A generous timeout makes
+ * contention block gracefully; the lease loop also retries SQLITE_BUSY.
+ */
+export declare const DB_BUSY_TIMEOUT_MS = 30000;
 /** The backend selected by the most recent {@link openSqlite} call. */
 export declare function getActiveBackend(): SqliteBackend | undefined;
 /**
@@ -18,7 +28,20 @@ export declare function getActiveBackend(): SqliteBackend | undefined;
  * otherwise the last backend an {@link openSqlite} selected, otherwise a
  * capability probe (which builtin is actually loadable on this Node). "none"
  * when neither backend can load.
+ *
+ * @returns The active (or likely) backend name, or "none".
  */
 export declare function describeSqliteBackend(): string;
+/**
+ * Open a SQLite database using the best available backend.
+ *
+ * Prefers the Node built-in `node:sqlite` when it can open a database, and
+ * falls back to `better-sqlite3`. An explicit `CODE_AUDITOR_SQLITE_BACKEND`
+ * override forces one backend, and an invalid value is an error.
+ *
+ * @param dbPath The database file path.
+ * @param opts Open options passed to the selected backend.
+ * @returns An open database, or throws when no backend is usable.
+ */
 export declare function openSqlite(dbPath: string, opts: OpenSqliteOptions): SqliteDatabase;
 //# sourceMappingURL=driver.d.ts.map

package/dist/sqlite/driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../src/sqlite/driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACb,cAAc,EACf,MAAM,YAAY,CAAC;AAMpB,uEAAuE;AACvE,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,SAAS,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAO9C;AAoBD,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,cAAc,CAyClF"}
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../src/sqlite/driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACb,cAAc,EACf,MAAM,YAAY,CAAC;AAMpB;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAEzC,uEAAuE;AACvE,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,SAAS,CAE5D;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAO9C;AAoBD;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,cAAc,CAyClF"}

package/dist/sqlite/driver.js

@@ -13,6 +13,16 @@
 import { NodeSqliteDatabase, isNodeSqliteAvailable } from './nodeSqlite.js';
 import { BetterSqlite3Database, isBetterSqlite3Available } from './betterSqlite3.js';
 let activeBackend;
+/**
+ * SQLite busy timeout shared by every open path (the facade and the LokiJS
+ * migration). The database is shared across forked processes (a detached audit
+ * runner and its shard workers); better-sqlite3's default busy timeout (~5s) is
+ * too short for a running job's long completion transaction, so a queued job's
+ * lease `BEGIN IMMEDIATE` (or the runner's own writes) would throw SQLITE_BUSY
+ * ("database is locked") instead of waiting. A generous timeout makes
+ * contention block gracefully; the lease loop also retries SQLITE_BUSY.
+ */
+export const DB_BUSY_TIMEOUT_MS = 30_000;
 /** The backend selected by the most recent {@link openSqlite} call. */
 export function getActiveBackend() {
     return activeBackend;
@@ -22,6 +32,8 @@ export function getActiveBackend() {
  * otherwise the last backend an {@link openSqlite} selected, otherwise a
  * capability probe (which builtin is actually loadable on this Node). "none"
  * when neither backend can load.
+ *
+ * @returns The active (or likely) backend name, or "none".
  */
 export function describeSqliteBackend() {
     const override = process.env.CODE_AUDITOR_SQLITE_BACKEND;
@@ -49,6 +61,17 @@ function loudFailure(tried, errors) {
         '  pnpm approve-builds        # select better-sqlite3\n' +
         '  pnpm rebuild better-sqlite3');
 }
+/**
+ * Open a SQLite database using the best available backend.
+ *
+ * Prefers the Node built-in `node:sqlite` when it can open a database, and
+ * falls back to `better-sqlite3`. An explicit `CODE_AUDITOR_SQLITE_BACKEND`
+ * override forces one backend, and an invalid value is an error.
+ *
+ * @param dbPath The database file path.
+ * @param opts Open options passed to the selected backend.
+ * @returns An open database, or throws when no backend is usable.
+ */
 export function openSqlite(dbPath, opts) {
     const override = process.env.CODE_AUDITOR_SQLITE_BACKEND;
     if (override !== undefined && override !== 'node-sqlite' && override !== 'better-sqlite3') {

package/dist/sqlite/driver.js.map

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

package/dist/sqlite/nodeSqlite.d.ts

@@ -13,15 +13,49 @@
  * check in `driver.ts`.
  */
 import type { OpenSqliteOptions, SqliteDatabase, SqliteStatement, SqliteTransaction } from './types.js';
-/** Capability probe: can this Node load the `node:sqlite` builtin? */
+/**
+ * Capability probe: can this Node load the `node:sqlite` builtin?
+ *
+ * @returns True when `node:sqlite` (with `DatabaseSync`) loads.
+ */
 export declare function isNodeSqliteAvailable(): boolean;
+/**
+ * SQLite database backed by the Node built-in `node:sqlite`.
+ */
 export declare class NodeSqliteDatabase implements SqliteDatabase {
     private readonly db;
+    /**
+     * Open (or create) a database through `node:sqlite`.
+     * @param dbPath The database file path.
+     * @param opts Open options carrying the busy timeout.
+     */
     constructor(dbPath: string, opts: OpenSqliteOptions);
+    /**
+     * Prepare a SQL statement for later execution.
+     * @param sql The SQL to prepare.
+     * @returns A prepared statement.
+     */
     prepare(sql: string): SqliteStatement;
+    /**
+     * Execute one or more SQL statements directly.
+     * @param sql The SQL to execute.
+     */
     exec(sql: string): void;
+    /**
+     * Run a PRAGMA statement, discarding the result (node:sqlite has no pragma API).
+     * @param pragmaSql The PRAGMA body (without the `PRAGMA` prefix).
+     * @returns Always undefined.
+     */
     pragma(pragmaSql: string): unknown;
+    /**
+     * Wrap a function in a SQLite transaction via explicit BEGIN/COMMIT/ROLLBACK.
+     * @param fn The function to run transactionally.
+     * @returns A callable transaction with `immediate`/`deferred` variants.
+     */
     transaction<Args extends unknown[] = unknown[], R = unknown>(fn: (...args: Args) => R): SqliteTransaction<Args, R>;
+    /**
+     * Close the underlying database.
+     */
     close(): void;
 }
 //# sourceMappingURL=nodeSqlite.d.ts.map

package/dist/sqlite/nodeSqlite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nodeSqlite.d.ts","sourceRoot":"","sources":["../../src/sqlite/nodeSqlite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EAEd,eAAe,EACf,iBAAiB,EAClB,MAAM,YAAY,CAAC;AA8CpB,sEAAsE;AACtE,wBAAgB,qBAAqB,IAAI,OAAO,CAO/C;AAsCD,qBAAa,kBAAmB,YAAW,cAAc;IACvD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAe;gBAEtB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB;IAOnD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe;IAQrC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQvB,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IASlC,WAAW,CAAC,IAAI,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC,GAAG,OAAO,EACzD,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,GACvB,iBAAiB,CAAC,IAAI,EAAE,CAAC,CAAC;IA2B7B,KAAK,IAAI,IAAI;CAGd"}
+{"version":3,"file":"nodeSqlite.d.ts","sourceRoot":"","sources":["../../src/sqlite/nodeSqlite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EAEd,eAAe,EACf,iBAAiB,EAClB,MAAM,YAAY,CAAC;AA8CpB;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAO/C;AAsCD;;GAEG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAe;IAElC;;;;OAIG;gBACS,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB;IAOnD;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe;IAQrC;;;OAGG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQvB;;;;OAIG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IASlC;;;;OAIG;IACH,WAAW,CAAC,IAAI,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC,GAAG,OAAO,EACzD,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,GACvB,iBAAiB,CAAC,IAAI,EAAE,CAAC,CAAC;IA2B7B;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/sqlite/nodeSqlite.js

@@ -53,7 +53,11 @@ function loadDatabaseSync() {
     }
     return mod.DatabaseSync;
 }
-/** Capability probe: can this Node load the `node:sqlite` builtin? */
+/**
+ * Capability probe: can this Node load the `node:sqlite` builtin?
+ *
+ * @returns True when `node:sqlite` (with `DatabaseSync`) loads.
+ */
 export function isNodeSqliteAvailable() {
     try {
         loadDatabaseSync();
@@ -100,14 +104,27 @@ class NodeSqliteStatement {
         }
     }
 }
+/**
+ * SQLite database backed by the Node built-in `node:sqlite`.
+ */
 export class NodeSqliteDatabase {
     db;
+    /**
+     * Open (or create) a database through `node:sqlite`.
+     * @param dbPath The database file path.
+     * @param opts Open options carrying the busy timeout.
+     */
     constructor(dbPath, opts) {
         const DatabaseSyncCtor = loadDatabaseSync();
         this.db = new DatabaseSyncCtor(dbPath);
         // node:sqlite has no `timeout` constructor option; busy timeout is a PRAGMA.
         this.db.exec(`PRAGMA busy_timeout = ${opts.timeoutMs}`);
     }
+    /**
+     * Prepare a SQL statement for later execution.
+     * @param sql The SQL to prepare.
+     * @returns A prepared statement.
+     */
     prepare(sql) {
         try {
             return new NodeSqliteStatement(this.db.prepare(sql));
@@ -116,6 +133,10 @@ export class NodeSqliteDatabase {
             throw normalizeSqliteError(e);
         }
     }
+    /**
+     * Execute one or more SQL statements directly.
+     * @param sql The SQL to execute.
+     */
     exec(sql) {
         try {
             this.db.exec(sql);
@@ -124,6 +145,11 @@ export class NodeSqliteDatabase {
             throw normalizeSqliteError(e);
         }
     }
+    /**
+     * Run a PRAGMA statement, discarding the result (node:sqlite has no pragma API).
+     * @param pragmaSql The PRAGMA body (without the `PRAGMA` prefix).
+     * @returns Always undefined.
+     */
     pragma(pragmaSql) {
         try {
             this.db.exec(`PRAGMA ${pragmaSql}`);
@@ -133,6 +159,11 @@ export class NodeSqliteDatabase {
         }
         return undefined;
     }
+    /**
+     * Wrap a function in a SQLite transaction via explicit BEGIN/COMMIT/ROLLBACK.
+     * @param fn The function to run transactionally.
+     * @returns A callable transaction with `immediate`/`deferred` variants.
+     */
     transaction(fn) {
         const run = (mode, args) => {
             try {
@@ -161,6 +192,9 @@ export class NodeSqliteDatabase {
         txn.deferred = (...args) => run('deferred', args);
         return txn;
     }
+    /**
+     * Close the underlying database.
+     */
     close() {
         this.db.close();
     }