@strapi/database 5.58.0 → 5.59.0

package/dist/migrations/users.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/migrations/users.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAEnC,eAAO,MAAM,2BAA2B,GAAI,IAAI,QAAQ,KAAG,qBAgC1D,CAAC"}
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/migrations/users.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAEnC,eAAO,MAAM,2BAA2B,GAAI,IAAI,QAAQ,KAAG,qBAiC1D,CAAC"}

package/dist/migrations/users.js

@@ -24,6 +24,7 @@ const createUserMigrationProvider = (db)=>{
             db,
             tableName: 'strapi_migrations'
         }),
+        withPhase: (phase, fn)=>db.runInPhase(phase, fn),
         logger: {
             info (message) {
                 db.logger.info(logger.transformLogMessage('info', message));

package/dist/migrations/users.js.map

@@ -1 +1 @@
-{"version":3,"file":"users.js","sources":["../../src/migrations/users.ts"],"sourcesContent":["import path from 'path';\n\nimport fse from 'fs-extra';\n\nimport { discoverMigrationFiles } from './discover';\nimport { createMigrationRunner } from './runner';\nimport { resolveMigrationFiles } from './resolver';\nimport { createStorage } from './storage';\nimport { transformLogMessage } from './logger';\n\nimport type { UserMigrationProvider } from './common';\nimport type { Database } from '..';\n\nexport const createUserMigrationProvider = (db: Database): UserMigrationProvider => {\n  const dir = db.config.settings.migrations.dir;\n\n  fse.ensureDirSync(dir);\n\n  const context = { db };\n\n  const runner = createMigrationRunner({\n    storage: createStorage({ db, tableName: 'strapi_migrations' }),\n    logger: {\n      info(message) {\n        db.logger.info(transformLogMessage('info', message));\n      },\n    },\n    async getMigrations() {\n      const filepaths = discoverMigrationFiles(path.resolve(dir));\n      return resolveMigrationFiles(filepaths, context);\n    },\n  });\n\n  return {\n    async shouldRun() {\n      const pendingMigrations = await runner.pending();\n      return pendingMigrations.length > 0 && db.config?.settings?.runMigrations === true;\n    },\n    async up() {\n      await runner.up();\n    },\n    async down() {\n      await runner.down();\n    },\n  };\n};\n"],"names":["createUserMigrationProvider","db","dir","config","settings","migrations","fse","ensureDirSync","context","runner","createMigrationRunner","storage","createStorage","tableName","logger","info","message","transformLogMessage","getMigrations","filepaths","discoverMigrationFiles","path","resolve","resolveMigrationFiles","shouldRun","pendingMigrations","pending","length","runMigrations","up","down"],"mappings":";;;;;;;;;;;;;;;AAaO,MAAMA,8BAA8B,CAACC,EAAAA,GAAAA;IAC1C,MAAMC,GAAAA,GAAMD,GAAGE,MAAM,CAACC,QAAQ,CAACC,UAAU,CAACH,GAAG;AAE7CI,IAAAA,oBAAAA,CAAIC,aAAa,CAACL,GAAAA,CAAAA;AAElB,IAAA,MAAMM,OAAAA,GAAU;AAAEP,QAAAA;AAAG,KAAA;AAErB,IAAA,MAAMQ,WAASC,4BAAAA,CAAsB;AACnCC,QAAAA,OAAAA,EAASC,qBAAAA,CAAc;AAAEX,YAAAA,EAAAA;YAAIY,SAAAA,EAAW;AAAoB,SAAA,CAAA;QAC5DC,MAAAA,EAAQ;AACNC,YAAAA,IAAAA,CAAAA,CAAKC,OAAO,EAAA;AACVf,gBAAAA,EAAAA,CAAGa,MAAM,CAACC,IAAI,CAACE,2BAAoB,MAAA,EAAQD,OAAAA,CAAAA,CAAAA;AAC7C,YAAA;AACF,SAAA;QACA,MAAME,aAAAA,CAAAA,GAAAA;AACJ,YAAA,MAAMC,SAAAA,GAAYC,+BAAAA,CAAuBC,qBAAAA,CAAKC,OAAO,CAACpB,GAAAA,CAAAA,CAAAA;AACtD,YAAA,OAAOqB,+BAAsBJ,SAAAA,EAAWX,OAAAA,CAAAA;AAC1C,QAAA;AACF,KAAA,CAAA;IAEA,OAAO;QACL,MAAMgB,SAAAA,CAAAA,GAAAA;YACJ,MAAMC,iBAAAA,GAAoB,MAAMhB,QAAAA,CAAOiB,OAAO,EAAA;YAC9C,OAAOD,iBAAAA,CAAkBE,MAAM,GAAG,CAAA,IAAK1B,GAAGE,MAAM,EAAEC,UAAUwB,aAAAA,KAAkB,IAAA;AAChF,QAAA,CAAA;QACA,MAAMC,EAAAA,CAAAA,GAAAA;AACJ,YAAA,MAAMpB,SAAOoB,EAAE,EAAA;AACjB,QAAA,CAAA;QACA,MAAMC,IAAAA,CAAAA,GAAAA;AACJ,YAAA,MAAMrB,SAAOqB,IAAI,EAAA;AACnB,QAAA;AACF,KAAA;AACF;;;;"}
+{"version":3,"file":"users.js","sources":["../../src/migrations/users.ts"],"sourcesContent":["import path from 'path';\n\nimport fse from 'fs-extra';\n\nimport { discoverMigrationFiles } from './discover';\nimport { createMigrationRunner } from './runner';\nimport { resolveMigrationFiles } from './resolver';\nimport { createStorage } from './storage';\nimport { transformLogMessage } from './logger';\n\nimport type { UserMigrationProvider } from './common';\nimport type { Database } from '..';\n\nexport const createUserMigrationProvider = (db: Database): UserMigrationProvider => {\n  const dir = db.config.settings.migrations.dir;\n\n  fse.ensureDirSync(dir);\n\n  const context = { db };\n\n  const runner = createMigrationRunner({\n    storage: createStorage({ db, tableName: 'strapi_migrations' }),\n    withPhase: (phase, fn) => db.runInPhase(phase, fn),\n    logger: {\n      info(message) {\n        db.logger.info(transformLogMessage('info', message));\n      },\n    },\n    async getMigrations() {\n      const filepaths = discoverMigrationFiles(path.resolve(dir));\n      return resolveMigrationFiles(filepaths, context);\n    },\n  });\n\n  return {\n    async shouldRun() {\n      const pendingMigrations = await runner.pending();\n      return pendingMigrations.length > 0 && db.config?.settings?.runMigrations === true;\n    },\n    async up() {\n      await runner.up();\n    },\n    async down() {\n      await runner.down();\n    },\n  };\n};\n"],"names":["createUserMigrationProvider","db","dir","config","settings","migrations","fse","ensureDirSync","context","runner","createMigrationRunner","storage","createStorage","tableName","withPhase","phase","fn","runInPhase","logger","info","message","transformLogMessage","getMigrations","filepaths","discoverMigrationFiles","path","resolve","resolveMigrationFiles","shouldRun","pendingMigrations","pending","length","runMigrations","up","down"],"mappings":";;;;;;;;;;;;;;;AAaO,MAAMA,8BAA8B,CAACC,EAAAA,GAAAA;IAC1C,MAAMC,GAAAA,GAAMD,GAAGE,MAAM,CAACC,QAAQ,CAACC,UAAU,CAACH,GAAG;AAE7CI,IAAAA,oBAAAA,CAAIC,aAAa,CAACL,GAAAA,CAAAA;AAElB,IAAA,MAAMM,OAAAA,GAAU;AAAEP,QAAAA;AAAG,KAAA;AAErB,IAAA,MAAMQ,WAASC,4BAAAA,CAAsB;AACnCC,QAAAA,OAAAA,EAASC,qBAAAA,CAAc;AAAEX,YAAAA,EAAAA;YAAIY,SAAAA,EAAW;AAAoB,SAAA,CAAA;AAC5DC,QAAAA,SAAAA,EAAW,CAACC,KAAAA,EAAOC,EAAAA,GAAOf,EAAAA,CAAGgB,UAAU,CAACF,KAAAA,EAAOC,EAAAA,CAAAA;QAC/CE,MAAAA,EAAQ;AACNC,YAAAA,IAAAA,CAAAA,CAAKC,OAAO,EAAA;AACVnB,gBAAAA,EAAAA,CAAGiB,MAAM,CAACC,IAAI,CAACE,2BAAoB,MAAA,EAAQD,OAAAA,CAAAA,CAAAA;AAC7C,YAAA;AACF,SAAA;QACA,MAAME,aAAAA,CAAAA,GAAAA;AACJ,YAAA,MAAMC,SAAAA,GAAYC,+BAAAA,CAAuBC,qBAAAA,CAAKC,OAAO,CAACxB,GAAAA,CAAAA,CAAAA;AACtD,YAAA,OAAOyB,+BAAsBJ,SAAAA,EAAWf,OAAAA,CAAAA;AAC1C,QAAA;AACF,KAAA,CAAA;IAEA,OAAO;QACL,MAAMoB,SAAAA,CAAAA,GAAAA;YACJ,MAAMC,iBAAAA,GAAoB,MAAMpB,QAAAA,CAAOqB,OAAO,EAAA;YAC9C,OAAOD,iBAAAA,CAAkBE,MAAM,GAAG,CAAA,IAAK9B,GAAGE,MAAM,EAAEC,UAAU4B,aAAAA,KAAkB,IAAA;AAChF,QAAA,CAAA;QACA,MAAMC,EAAAA,CAAAA,GAAAA;AACJ,YAAA,MAAMxB,SAAOwB,EAAE,EAAA;AACjB,QAAA,CAAA;QACA,MAAMC,IAAAA,CAAAA,GAAAA;AACJ,YAAA,MAAMzB,SAAOyB,IAAI,EAAA;AACnB,QAAA;AACF,KAAA;AACF;;;;"}

package/dist/migrations/users.mjs

@@ -17,6 +17,7 @@ const createUserMigrationProvider = (db)=>{
             db,
             tableName: 'strapi_migrations'
         }),
+        withPhase: (phase, fn)=>db.runInPhase(phase, fn),
         logger: {
             info (message) {
                 db.logger.info(transformLogMessage('info', message));

package/dist/migrations/users.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"users.mjs","sources":["../../src/migrations/users.ts"],"sourcesContent":["import path from 'path';\n\nimport fse from 'fs-extra';\n\nimport { discoverMigrationFiles } from './discover';\nimport { createMigrationRunner } from './runner';\nimport { resolveMigrationFiles } from './resolver';\nimport { createStorage } from './storage';\nimport { transformLogMessage } from './logger';\n\nimport type { UserMigrationProvider } from './common';\nimport type { Database } from '..';\n\nexport const createUserMigrationProvider = (db: Database): UserMigrationProvider => {\n  const dir = db.config.settings.migrations.dir;\n\n  fse.ensureDirSync(dir);\n\n  const context = { db };\n\n  const runner = createMigrationRunner({\n    storage: createStorage({ db, tableName: 'strapi_migrations' }),\n    logger: {\n      info(message) {\n        db.logger.info(transformLogMessage('info', message));\n      },\n    },\n    async getMigrations() {\n      const filepaths = discoverMigrationFiles(path.resolve(dir));\n      return resolveMigrationFiles(filepaths, context);\n    },\n  });\n\n  return {\n    async shouldRun() {\n      const pendingMigrations = await runner.pending();\n      return pendingMigrations.length > 0 && db.config?.settings?.runMigrations === true;\n    },\n    async up() {\n      await runner.up();\n    },\n    async down() {\n      await runner.down();\n    },\n  };\n};\n"],"names":["createUserMigrationProvider","db","dir","config","settings","migrations","fse","ensureDirSync","context","runner","createMigrationRunner","storage","createStorage","tableName","logger","info","message","transformLogMessage","getMigrations","filepaths","discoverMigrationFiles","path","resolve","resolveMigrationFiles","shouldRun","pendingMigrations","pending","length","runMigrations","up","down"],"mappings":";;;;;;;;AAaO,MAAMA,8BAA8B,CAACC,EAAAA,GAAAA;IAC1C,MAAMC,GAAAA,GAAMD,GAAGE,MAAM,CAACC,QAAQ,CAACC,UAAU,CAACH,GAAG;AAE7CI,IAAAA,GAAAA,CAAIC,aAAa,CAACL,GAAAA,CAAAA;AAElB,IAAA,MAAMM,OAAAA,GAAU;AAAEP,QAAAA;AAAG,KAAA;AAErB,IAAA,MAAMQ,SAASC,qBAAAA,CAAsB;AACnCC,QAAAA,OAAAA,EAASC,aAAAA,CAAc;AAAEX,YAAAA,EAAAA;YAAIY,SAAAA,EAAW;AAAoB,SAAA,CAAA;QAC5DC,MAAAA,EAAQ;AACNC,YAAAA,IAAAA,CAAAA,CAAKC,OAAO,EAAA;AACVf,gBAAAA,EAAAA,CAAGa,MAAM,CAACC,IAAI,CAACE,oBAAoB,MAAA,EAAQD,OAAAA,CAAAA,CAAAA;AAC7C,YAAA;AACF,SAAA;QACA,MAAME,aAAAA,CAAAA,GAAAA;AACJ,YAAA,MAAMC,SAAAA,GAAYC,sBAAAA,CAAuBC,IAAAA,CAAKC,OAAO,CAACpB,GAAAA,CAAAA,CAAAA;AACtD,YAAA,OAAOqB,sBAAsBJ,SAAAA,EAAWX,OAAAA,CAAAA;AAC1C,QAAA;AACF,KAAA,CAAA;IAEA,OAAO;QACL,MAAMgB,SAAAA,CAAAA,GAAAA;YACJ,MAAMC,iBAAAA,GAAoB,MAAMhB,MAAAA,CAAOiB,OAAO,EAAA;YAC9C,OAAOD,iBAAAA,CAAkBE,MAAM,GAAG,CAAA,IAAK1B,GAAGE,MAAM,EAAEC,UAAUwB,aAAAA,KAAkB,IAAA;AAChF,QAAA,CAAA;QACA,MAAMC,EAAAA,CAAAA,GAAAA;AACJ,YAAA,MAAMpB,OAAOoB,EAAE,EAAA;AACjB,QAAA,CAAA;QACA,MAAMC,IAAAA,CAAAA,GAAAA;AACJ,YAAA,MAAMrB,OAAOqB,IAAI,EAAA;AACnB,QAAA;AACF,KAAA;AACF;;;;"}
+{"version":3,"file":"users.mjs","sources":["../../src/migrations/users.ts"],"sourcesContent":["import path from 'path';\n\nimport fse from 'fs-extra';\n\nimport { discoverMigrationFiles } from './discover';\nimport { createMigrationRunner } from './runner';\nimport { resolveMigrationFiles } from './resolver';\nimport { createStorage } from './storage';\nimport { transformLogMessage } from './logger';\n\nimport type { UserMigrationProvider } from './common';\nimport type { Database } from '..';\n\nexport const createUserMigrationProvider = (db: Database): UserMigrationProvider => {\n  const dir = db.config.settings.migrations.dir;\n\n  fse.ensureDirSync(dir);\n\n  const context = { db };\n\n  const runner = createMigrationRunner({\n    storage: createStorage({ db, tableName: 'strapi_migrations' }),\n    withPhase: (phase, fn) => db.runInPhase(phase, fn),\n    logger: {\n      info(message) {\n        db.logger.info(transformLogMessage('info', message));\n      },\n    },\n    async getMigrations() {\n      const filepaths = discoverMigrationFiles(path.resolve(dir));\n      return resolveMigrationFiles(filepaths, context);\n    },\n  });\n\n  return {\n    async shouldRun() {\n      const pendingMigrations = await runner.pending();\n      return pendingMigrations.length > 0 && db.config?.settings?.runMigrations === true;\n    },\n    async up() {\n      await runner.up();\n    },\n    async down() {\n      await runner.down();\n    },\n  };\n};\n"],"names":["createUserMigrationProvider","db","dir","config","settings","migrations","fse","ensureDirSync","context","runner","createMigrationRunner","storage","createStorage","tableName","withPhase","phase","fn","runInPhase","logger","info","message","transformLogMessage","getMigrations","filepaths","discoverMigrationFiles","path","resolve","resolveMigrationFiles","shouldRun","pendingMigrations","pending","length","runMigrations","up","down"],"mappings":";;;;;;;;AAaO,MAAMA,8BAA8B,CAACC,EAAAA,GAAAA;IAC1C,MAAMC,GAAAA,GAAMD,GAAGE,MAAM,CAACC,QAAQ,CAACC,UAAU,CAACH,GAAG;AAE7CI,IAAAA,GAAAA,CAAIC,aAAa,CAACL,GAAAA,CAAAA;AAElB,IAAA,MAAMM,OAAAA,GAAU;AAAEP,QAAAA;AAAG,KAAA;AAErB,IAAA,MAAMQ,SAASC,qBAAAA,CAAsB;AACnCC,QAAAA,OAAAA,EAASC,aAAAA,CAAc;AAAEX,YAAAA,EAAAA;YAAIY,SAAAA,EAAW;AAAoB,SAAA,CAAA;AAC5DC,QAAAA,SAAAA,EAAW,CAACC,KAAAA,EAAOC,EAAAA,GAAOf,EAAAA,CAAGgB,UAAU,CAACF,KAAAA,EAAOC,EAAAA,CAAAA;QAC/CE,MAAAA,EAAQ;AACNC,YAAAA,IAAAA,CAAAA,CAAKC,OAAO,EAAA;AACVnB,gBAAAA,EAAAA,CAAGiB,MAAM,CAACC,IAAI,CAACE,oBAAoB,MAAA,EAAQD,OAAAA,CAAAA,CAAAA;AAC7C,YAAA;AACF,SAAA;QACA,MAAME,aAAAA,CAAAA,GAAAA;AACJ,YAAA,MAAMC,SAAAA,GAAYC,sBAAAA,CAAuBC,IAAAA,CAAKC,OAAO,CAACxB,GAAAA,CAAAA,CAAAA;AACtD,YAAA,OAAOyB,sBAAsBJ,SAAAA,EAAWf,OAAAA,CAAAA;AAC1C,QAAA;AACF,KAAA,CAAA;IAEA,OAAO;QACL,MAAMoB,SAAAA,CAAAA,GAAAA;YACJ,MAAMC,iBAAAA,GAAoB,MAAMpB,MAAAA,CAAOqB,OAAO,EAAA;YAC9C,OAAOD,iBAAAA,CAAkBE,MAAM,GAAG,CAAA,IAAK9B,GAAGE,MAAM,EAAEC,UAAU4B,aAAAA,KAAkB,IAAA;AAChF,QAAA,CAAA;QACA,MAAMC,EAAAA,CAAAA,GAAAA;AACJ,YAAA,MAAMxB,OAAOwB,EAAE,EAAA;AACjB,QAAA,CAAA;QACA,MAAMC,IAAAA,CAAAA,GAAAA;AACJ,YAAA,MAAMzB,OAAOyB,IAAI,EAAA;AACnB,QAAA;AACF,KAAA;AACF;;;;"}

package/dist/pool-diagnostics/details.d.ts

@@ -0,0 +1,58 @@
+import type { EventLoopDelay } from './event-loop';
+export declare const POOL_TIMEOUT_CODE = "DB_POOL_ACQUIRE_TIMEOUT";
+export interface PoolState {
+    used: number;
+    free: number;
+    pendingAcquires: number;
+    pendingCreates: number;
+    min?: number;
+    max?: number;
+}
+export interface PoolTimeoutDetails {
+    code: typeof POOL_TIMEOUT_CODE;
+    /** How long this caller waited before knex gave up. */
+    waitedMs: number;
+    /** The timeout knex applied: the smaller of acquireConnectionTimeout and pool.acquireTimeoutMillis. */
+    acquireTimeoutMs?: number;
+    /** As configured, when set. */
+    acquireConnectionTimeout?: number;
+    poolAcquireTimeoutMillis?: number;
+    /** Pool counts at the moment of the timeout. */
+    pool?: PoolState;
+    /** tarn's message: the error of a failed connection attempt, or "operation timed out for an unknown reason". */
+    poolReason?: string;
+    eventLoopDelay?: EventLoopDelay;
+    phase?: string;
+    hostname: string;
+    pid: number;
+}
+export interface TarnPoolLike {
+    min?: number;
+    max?: number;
+    acquireTimeoutMillis?: number;
+    numUsed(): number;
+    numFree(): number;
+    numPendingAcquires(): number;
+    numPendingCreates(): number;
+}
+export interface KnexClientLike {
+    config?: {
+        acquireConnectionTimeout?: unknown;
+        pool?: {
+            acquireTimeoutMillis?: unknown;
+        };
+    };
+    /** A tarn pool, or knex's wrapper around a native driver pool, which has no counters. */
+    pool?: Partial<TarnPoolLike> | null;
+}
+export interface CollectInput {
+    waitedMs: number;
+    cause: unknown;
+    eventLoopDelay?: EventLoopDelay;
+    phase?: string;
+    hostname: string;
+    pid: number;
+}
+export declare const readPoolState: (pool: Partial<TarnPoolLike> | null | undefined) => PoolState | undefined;
+export declare const collectPoolTimeoutDetails: (client: KnexClientLike, input: CollectInput) => PoolTimeoutDetails;
+//# sourceMappingURL=details.d.ts.map

package/dist/pool-diagnostics/details.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"details.d.ts","sourceRoot":"","sources":["../../src/pool-diagnostics/details.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,eAAO,MAAM,iBAAiB,4BAA4B,CAAC;AAE3D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,iBAAiB,CAAC;IAC/B,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,uGAAuG;IACvG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+BAA+B;IAC/B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,gDAAgD;IAChD,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,gHAAgH;IAChH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,OAAO,IAAI,MAAM,CAAC;IAClB,OAAO,IAAI,MAAM,CAAC;IAClB,kBAAkB,IAAI,MAAM,CAAC;IAC7B,iBAAiB,IAAI,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE;QAAE,wBAAwB,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE;YAAE,oBAAoB,CAAC,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,CAAC;IAC3F,yFAAyF;IACzF,IAAI,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb;AAWD,eAAO,MAAM,aAAa,GACxB,MAAM,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,GAAG,SAAS,KAC7C,SAAS,GAAG,SAcd,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACpC,QAAQ,cAAc,EACtB,OAAO,YAAY,KAClB,kBAkBF,CAAC"}

package/dist/pool-diagnostics/details.js

@@ -0,0 +1,42 @@
+'use strict';
+
+const POOL_TIMEOUT_CODE = 'DB_POOL_ACQUIRE_TIMEOUT';
+const asNumber = (value)=>typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+const hasCounters = (pool)=>typeof pool.numUsed === 'function' && typeof pool.numFree === 'function' && typeof pool.numPendingAcquires === 'function' && typeof pool.numPendingCreates === 'function';
+const readPoolState = (pool)=>{
+    // knex also accepts a pool that only has acquire, release and destroy
+    if (!pool || !hasCounters(pool)) {
+        return undefined;
+    }
+    return {
+        used: pool.numUsed(),
+        free: pool.numFree(),
+        pendingAcquires: pool.numPendingAcquires(),
+        pendingCreates: pool.numPendingCreates(),
+        min: asNumber(pool.min),
+        max: asNumber(pool.max)
+    };
+};
+const collectPoolTimeoutDetails = (client, input)=>{
+    const config = client.config ?? {};
+    return {
+        code: POOL_TIMEOUT_CODE,
+        waitedMs: input.waitedMs,
+        // knex writes the effective (smaller) timeout into the tarn pool options
+        acquireTimeoutMs: asNumber(client.pool?.acquireTimeoutMillis),
+        acquireConnectionTimeout: asNumber(config.acquireConnectionTimeout),
+        poolAcquireTimeoutMillis: asNumber(config.pool?.acquireTimeoutMillis),
+        pool: readPoolState(client.pool),
+        // knex 3.3 keeps tarn's error as `cause`; its message is all tarn keeps of a failed attempt
+        poolReason: input.cause instanceof Error ? input.cause.message : undefined,
+        eventLoopDelay: input.eventLoopDelay,
+        phase: input.phase,
+        hostname: input.hostname,
+        pid: input.pid
+    };
+};
+
+exports.POOL_TIMEOUT_CODE = POOL_TIMEOUT_CODE;
+exports.collectPoolTimeoutDetails = collectPoolTimeoutDetails;
+exports.readPoolState = readPoolState;
+//# sourceMappingURL=details.js.map

package/dist/pool-diagnostics/details.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"details.js","sources":["../../src/pool-diagnostics/details.ts"],"sourcesContent":["import type { EventLoopDelay } from './event-loop';\n\nexport const POOL_TIMEOUT_CODE = 'DB_POOL_ACQUIRE_TIMEOUT';\n\nexport interface PoolState {\n  used: number;\n  free: number;\n  pendingAcquires: number;\n  pendingCreates: number;\n  min?: number;\n  max?: number;\n}\n\nexport interface PoolTimeoutDetails {\n  code: typeof POOL_TIMEOUT_CODE;\n  /** How long this caller waited before knex gave up. */\n  waitedMs: number;\n  /** The timeout knex applied: the smaller of acquireConnectionTimeout and pool.acquireTimeoutMillis. */\n  acquireTimeoutMs?: number;\n  /** As configured, when set. */\n  acquireConnectionTimeout?: number;\n  poolAcquireTimeoutMillis?: number;\n  /** Pool counts at the moment of the timeout. */\n  pool?: PoolState;\n  /** tarn's message: the error of a failed connection attempt, or \"operation timed out for an unknown reason\". */\n  poolReason?: string;\n  eventLoopDelay?: EventLoopDelay;\n  phase?: string;\n  hostname: string;\n  pid: number;\n}\n\nexport interface TarnPoolLike {\n  min?: number;\n  max?: number;\n  acquireTimeoutMillis?: number;\n  numUsed(): number;\n  numFree(): number;\n  numPendingAcquires(): number;\n  numPendingCreates(): number;\n}\n\nexport interface KnexClientLike {\n  config?: { acquireConnectionTimeout?: unknown; pool?: { acquireTimeoutMillis?: unknown } };\n  /** A tarn pool, or knex's wrapper around a native driver pool, which has no counters. */\n  pool?: Partial<TarnPoolLike> | null;\n}\n\nexport interface CollectInput {\n  waitedMs: number;\n  cause: unknown;\n  eventLoopDelay?: EventLoopDelay;\n  phase?: string;\n  hostname: string;\n  pid: number;\n}\n\nconst asNumber = (value: unknown) =>\n  typeof value === 'number' && Number.isFinite(value) ? value : undefined;\n\nconst hasCounters = (pool: Partial<TarnPoolLike>): pool is TarnPoolLike =>\n  typeof pool.numUsed === 'function' &&\n  typeof pool.numFree === 'function' &&\n  typeof pool.numPendingAcquires === 'function' &&\n  typeof pool.numPendingCreates === 'function';\n\nexport const readPoolState = (\n  pool: Partial<TarnPoolLike> | null | undefined\n): PoolState | undefined => {\n  // knex also accepts a pool that only has acquire, release and destroy\n  if (!pool || !hasCounters(pool)) {\n    return undefined;\n  }\n\n  return {\n    used: pool.numUsed(),\n    free: pool.numFree(),\n    pendingAcquires: pool.numPendingAcquires(),\n    pendingCreates: pool.numPendingCreates(),\n    min: asNumber(pool.min),\n    max: asNumber(pool.max),\n  };\n};\n\nexport const collectPoolTimeoutDetails = (\n  client: KnexClientLike,\n  input: CollectInput\n): PoolTimeoutDetails => {\n  const config = client.config ?? {};\n\n  return {\n    code: POOL_TIMEOUT_CODE,\n    waitedMs: input.waitedMs,\n    // knex writes the effective (smaller) timeout into the tarn pool options\n    acquireTimeoutMs: asNumber(client.pool?.acquireTimeoutMillis),\n    acquireConnectionTimeout: asNumber(config.acquireConnectionTimeout),\n    poolAcquireTimeoutMillis: asNumber(config.pool?.acquireTimeoutMillis),\n    pool: readPoolState(client.pool),\n    // knex 3.3 keeps tarn's error as `cause`; its message is all tarn keeps of a failed attempt\n    poolReason: input.cause instanceof Error ? input.cause.message : undefined,\n    eventLoopDelay: input.eventLoopDelay,\n    phase: input.phase,\n    hostname: input.hostname,\n    pid: input.pid,\n  };\n};\n"],"names":["POOL_TIMEOUT_CODE","asNumber","value","Number","isFinite","undefined","hasCounters","pool","numUsed","numFree","numPendingAcquires","numPendingCreates","readPoolState","used","free","pendingAcquires","pendingCreates","min","max","collectPoolTimeoutDetails","client","input","config","code","waitedMs","acquireTimeoutMs","acquireTimeoutMillis","acquireConnectionTimeout","poolAcquireTimeoutMillis","poolReason","cause","Error","message","eventLoopDelay","phase","hostname","pid"],"mappings":";;AAEO,MAAMA,oBAAoB;AAuDjC,MAAMC,QAAAA,GAAW,CAACC,KAAAA,GAChB,OAAOA,KAAAA,KAAU,YAAYC,MAAAA,CAAOC,QAAQ,CAACF,KAAAA,CAAAA,GAASA,KAAAA,GAAQG,SAAAA;AAEhE,MAAMC,WAAAA,GAAc,CAACC,IAAAA,GACnB,OAAOA,KAAKC,OAAO,KAAK,cACxB,OAAOD,IAAAA,CAAKE,OAAO,KAAK,UAAA,IACxB,OAAOF,IAAAA,CAAKG,kBAAkB,KAAK,UAAA,IACnC,OAAOH,IAAAA,CAAKI,iBAAiB,KAAK,UAAA;AAE7B,MAAMC,gBAAgB,CAC3BL,IAAAA,GAAAA;;AAGA,IAAA,IAAI,CAACA,IAAAA,IAAQ,CAACD,WAAAA,CAAYC,IAAAA,CAAAA,EAAO;QAC/B,OAAOF,SAAAA;AACT,IAAA;IAEA,OAAO;AACLQ,QAAAA,IAAAA,EAAMN,KAAKC,OAAO,EAAA;AAClBM,QAAAA,IAAAA,EAAMP,KAAKE,OAAO,EAAA;AAClBM,QAAAA,eAAAA,EAAiBR,KAAKG,kBAAkB,EAAA;AACxCM,QAAAA,cAAAA,EAAgBT,KAAKI,iBAAiB,EAAA;QACtCM,GAAAA,EAAKhB,QAAAA,CAASM,KAAKU,GAAG,CAAA;QACtBC,GAAAA,EAAKjB,QAAAA,CAASM,KAAKW,GAAG;AACxB,KAAA;AACF;AAEO,MAAMC,yBAAAA,GAA4B,CACvCC,MAAAA,EACAC,KAAAA,GAAAA;AAEA,IAAA,MAAMC,MAAAA,GAASF,MAAAA,CAAOE,MAAM,IAAI,EAAC;IAEjC,OAAO;QACLC,IAAAA,EAAMvB,iBAAAA;AACNwB,QAAAA,QAAAA,EAAUH,MAAMG,QAAQ;;QAExBC,gBAAAA,EAAkBxB,QAAAA,CAASmB,MAAAA,CAAOb,IAAI,EAAEmB,oBAAAA,CAAAA;QACxCC,wBAAAA,EAA0B1B,QAAAA,CAASqB,OAAOK,wBAAwB,CAAA;QAClEC,wBAAAA,EAA0B3B,QAAAA,CAASqB,MAAAA,CAAOf,IAAI,EAAEmB,oBAAAA,CAAAA;QAChDnB,IAAAA,EAAMK,aAAAA,CAAcQ,OAAOb,IAAI,CAAA;;QAE/BsB,UAAAA,EAAYR,KAAAA,CAAMS,KAAK,YAAYC,KAAAA,GAAQV,MAAMS,KAAK,CAACE,OAAO,GAAG3B,SAAAA;AACjE4B,QAAAA,cAAAA,EAAgBZ,MAAMY,cAAc;AACpCC,QAAAA,KAAAA,EAAOb,MAAMa,KAAK;AAClBC,QAAAA,QAAAA,EAAUd,MAAMc,QAAQ;AACxBC,QAAAA,GAAAA,EAAKf,MAAMe;AACb,KAAA;AACF;;;;;;"}

package/dist/pool-diagnostics/details.mjs

@@ -0,0 +1,38 @@
+const POOL_TIMEOUT_CODE = 'DB_POOL_ACQUIRE_TIMEOUT';
+const asNumber = (value)=>typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+const hasCounters = (pool)=>typeof pool.numUsed === 'function' && typeof pool.numFree === 'function' && typeof pool.numPendingAcquires === 'function' && typeof pool.numPendingCreates === 'function';
+const readPoolState = (pool)=>{
+    // knex also accepts a pool that only has acquire, release and destroy
+    if (!pool || !hasCounters(pool)) {
+        return undefined;
+    }
+    return {
+        used: pool.numUsed(),
+        free: pool.numFree(),
+        pendingAcquires: pool.numPendingAcquires(),
+        pendingCreates: pool.numPendingCreates(),
+        min: asNumber(pool.min),
+        max: asNumber(pool.max)
+    };
+};
+const collectPoolTimeoutDetails = (client, input)=>{
+    const config = client.config ?? {};
+    return {
+        code: POOL_TIMEOUT_CODE,
+        waitedMs: input.waitedMs,
+        // knex writes the effective (smaller) timeout into the tarn pool options
+        acquireTimeoutMs: asNumber(client.pool?.acquireTimeoutMillis),
+        acquireConnectionTimeout: asNumber(config.acquireConnectionTimeout),
+        poolAcquireTimeoutMillis: asNumber(config.pool?.acquireTimeoutMillis),
+        pool: readPoolState(client.pool),
+        // knex 3.3 keeps tarn's error as `cause`; its message is all tarn keeps of a failed attempt
+        poolReason: input.cause instanceof Error ? input.cause.message : undefined,
+        eventLoopDelay: input.eventLoopDelay,
+        phase: input.phase,
+        hostname: input.hostname,
+        pid: input.pid
+    };
+};
+
+export { POOL_TIMEOUT_CODE, collectPoolTimeoutDetails, readPoolState };
+//# sourceMappingURL=details.mjs.map

package/dist/pool-diagnostics/details.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"details.mjs","sources":["../../src/pool-diagnostics/details.ts"],"sourcesContent":["import type { EventLoopDelay } from './event-loop';\n\nexport const POOL_TIMEOUT_CODE = 'DB_POOL_ACQUIRE_TIMEOUT';\n\nexport interface PoolState {\n  used: number;\n  free: number;\n  pendingAcquires: number;\n  pendingCreates: number;\n  min?: number;\n  max?: number;\n}\n\nexport interface PoolTimeoutDetails {\n  code: typeof POOL_TIMEOUT_CODE;\n  /** How long this caller waited before knex gave up. */\n  waitedMs: number;\n  /** The timeout knex applied: the smaller of acquireConnectionTimeout and pool.acquireTimeoutMillis. */\n  acquireTimeoutMs?: number;\n  /** As configured, when set. */\n  acquireConnectionTimeout?: number;\n  poolAcquireTimeoutMillis?: number;\n  /** Pool counts at the moment of the timeout. */\n  pool?: PoolState;\n  /** tarn's message: the error of a failed connection attempt, or \"operation timed out for an unknown reason\". */\n  poolReason?: string;\n  eventLoopDelay?: EventLoopDelay;\n  phase?: string;\n  hostname: string;\n  pid: number;\n}\n\nexport interface TarnPoolLike {\n  min?: number;\n  max?: number;\n  acquireTimeoutMillis?: number;\n  numUsed(): number;\n  numFree(): number;\n  numPendingAcquires(): number;\n  numPendingCreates(): number;\n}\n\nexport interface KnexClientLike {\n  config?: { acquireConnectionTimeout?: unknown; pool?: { acquireTimeoutMillis?: unknown } };\n  /** A tarn pool, or knex's wrapper around a native driver pool, which has no counters. */\n  pool?: Partial<TarnPoolLike> | null;\n}\n\nexport interface CollectInput {\n  waitedMs: number;\n  cause: unknown;\n  eventLoopDelay?: EventLoopDelay;\n  phase?: string;\n  hostname: string;\n  pid: number;\n}\n\nconst asNumber = (value: unknown) =>\n  typeof value === 'number' && Number.isFinite(value) ? value : undefined;\n\nconst hasCounters = (pool: Partial<TarnPoolLike>): pool is TarnPoolLike =>\n  typeof pool.numUsed === 'function' &&\n  typeof pool.numFree === 'function' &&\n  typeof pool.numPendingAcquires === 'function' &&\n  typeof pool.numPendingCreates === 'function';\n\nexport const readPoolState = (\n  pool: Partial<TarnPoolLike> | null | undefined\n): PoolState | undefined => {\n  // knex also accepts a pool that only has acquire, release and destroy\n  if (!pool || !hasCounters(pool)) {\n    return undefined;\n  }\n\n  return {\n    used: pool.numUsed(),\n    free: pool.numFree(),\n    pendingAcquires: pool.numPendingAcquires(),\n    pendingCreates: pool.numPendingCreates(),\n    min: asNumber(pool.min),\n    max: asNumber(pool.max),\n  };\n};\n\nexport const collectPoolTimeoutDetails = (\n  client: KnexClientLike,\n  input: CollectInput\n): PoolTimeoutDetails => {\n  const config = client.config ?? {};\n\n  return {\n    code: POOL_TIMEOUT_CODE,\n    waitedMs: input.waitedMs,\n    // knex writes the effective (smaller) timeout into the tarn pool options\n    acquireTimeoutMs: asNumber(client.pool?.acquireTimeoutMillis),\n    acquireConnectionTimeout: asNumber(config.acquireConnectionTimeout),\n    poolAcquireTimeoutMillis: asNumber(config.pool?.acquireTimeoutMillis),\n    pool: readPoolState(client.pool),\n    // knex 3.3 keeps tarn's error as `cause`; its message is all tarn keeps of a failed attempt\n    poolReason: input.cause instanceof Error ? input.cause.message : undefined,\n    eventLoopDelay: input.eventLoopDelay,\n    phase: input.phase,\n    hostname: input.hostname,\n    pid: input.pid,\n  };\n};\n"],"names":["POOL_TIMEOUT_CODE","asNumber","value","Number","isFinite","undefined","hasCounters","pool","numUsed","numFree","numPendingAcquires","numPendingCreates","readPoolState","used","free","pendingAcquires","pendingCreates","min","max","collectPoolTimeoutDetails","client","input","config","code","waitedMs","acquireTimeoutMs","acquireTimeoutMillis","acquireConnectionTimeout","poolAcquireTimeoutMillis","poolReason","cause","Error","message","eventLoopDelay","phase","hostname","pid"],"mappings":"AAEO,MAAMA,oBAAoB;AAuDjC,MAAMC,QAAAA,GAAW,CAACC,KAAAA,GAChB,OAAOA,KAAAA,KAAU,YAAYC,MAAAA,CAAOC,QAAQ,CAACF,KAAAA,CAAAA,GAASA,KAAAA,GAAQG,SAAAA;AAEhE,MAAMC,WAAAA,GAAc,CAACC,IAAAA,GACnB,OAAOA,KAAKC,OAAO,KAAK,cACxB,OAAOD,IAAAA,CAAKE,OAAO,KAAK,UAAA,IACxB,OAAOF,IAAAA,CAAKG,kBAAkB,KAAK,UAAA,IACnC,OAAOH,IAAAA,CAAKI,iBAAiB,KAAK,UAAA;AAE7B,MAAMC,gBAAgB,CAC3BL,IAAAA,GAAAA;;AAGA,IAAA,IAAI,CAACA,IAAAA,IAAQ,CAACD,WAAAA,CAAYC,IAAAA,CAAAA,EAAO;QAC/B,OAAOF,SAAAA;AACT,IAAA;IAEA,OAAO;AACLQ,QAAAA,IAAAA,EAAMN,KAAKC,OAAO,EAAA;AAClBM,QAAAA,IAAAA,EAAMP,KAAKE,OAAO,EAAA;AAClBM,QAAAA,eAAAA,EAAiBR,KAAKG,kBAAkB,EAAA;AACxCM,QAAAA,cAAAA,EAAgBT,KAAKI,iBAAiB,EAAA;QACtCM,GAAAA,EAAKhB,QAAAA,CAASM,KAAKU,GAAG,CAAA;QACtBC,GAAAA,EAAKjB,QAAAA,CAASM,KAAKW,GAAG;AACxB,KAAA;AACF;AAEO,MAAMC,yBAAAA,GAA4B,CACvCC,MAAAA,EACAC,KAAAA,GAAAA;AAEA,IAAA,MAAMC,MAAAA,GAASF,MAAAA,CAAOE,MAAM,IAAI,EAAC;IAEjC,OAAO;QACLC,IAAAA,EAAMvB,iBAAAA;AACNwB,QAAAA,QAAAA,EAAUH,MAAMG,QAAQ;;QAExBC,gBAAAA,EAAkBxB,QAAAA,CAASmB,MAAAA,CAAOb,IAAI,EAAEmB,oBAAAA,CAAAA;QACxCC,wBAAAA,EAA0B1B,QAAAA,CAASqB,OAAOK,wBAAwB,CAAA;QAClEC,wBAAAA,EAA0B3B,QAAAA,CAASqB,MAAAA,CAAOf,IAAI,EAAEmB,oBAAAA,CAAAA;QAChDnB,IAAAA,EAAMK,aAAAA,CAAcQ,OAAOb,IAAI,CAAA;;QAE/BsB,UAAAA,EAAYR,KAAAA,CAAMS,KAAK,YAAYC,KAAAA,GAAQV,MAAMS,KAAK,CAACE,OAAO,GAAG3B,SAAAA;AACjE4B,QAAAA,cAAAA,EAAgBZ,MAAMY,cAAc;AACpCC,QAAAA,KAAAA,EAAOb,MAAMa,KAAK;AAClBC,QAAAA,QAAAA,EAAUd,MAAMc,QAAQ;AACxBC,QAAAA,GAAAA,EAAKf,MAAMe;AACb,KAAA;AACF;;;;"}

package/dist/pool-diagnostics/event-loop.d.ts

@@ -0,0 +1,31 @@
+/** Sampling interval of the event loop delay histogram. */
+export declare const EVENT_LOOP_RESOLUTION_MS = 20;
+/** Every rotation drops the older half, so a report covers the last 30 to 60 s. */
+export declare const EVENT_LOOP_ROTATION_MS = 30000;
+export interface EventLoopDelay {
+    /** Longest delay seen in the window, in ms, sampling interval removed. */
+    maxMs: number;
+    p99Ms: number;
+    /** Length of the window the values cover. */
+    windowMs: number;
+}
+export interface EventLoopMonitor {
+    read(): EventLoopDelay | undefined;
+    stop(): void;
+}
+export interface EventLoopMonitorOptions {
+    /** Injectable clock for tests. */
+    now?: () => number;
+    /** How often the older histogram is cleared and reused. */
+    rotateEveryMs?: number;
+}
+/** The histogram records the time between samples, so an idle loop reads one sampling interval. */
+export declare const toDelayMs: (nanoseconds: number) => number;
+/**
+ * A starved process fires timers late, so an acquire can time out even though the database
+ * answered. Two histograms take turns so a report covers the last one to two rotation periods,
+ * not everything since the process started. Neither the histograms nor the rotation timer keep
+ * the process alive.
+ */
+export declare const createEventLoopMonitor: ({ now, rotateEveryMs, }?: EventLoopMonitorOptions) => EventLoopMonitor;
+//# sourceMappingURL=event-loop.d.ts.map

package/dist/pool-diagnostics/event-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-loop.d.ts","sourceRoot":"","sources":["../../src/pool-diagnostics/event-loop.ts"],"names":[],"mappings":"AAEA,2DAA2D;AAC3D,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,mFAAmF;AACnF,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,IAAI,cAAc,GAAG,SAAS,CAAC;IACnC,IAAI,IAAI,IAAI,CAAC;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,kCAAkC;IAClC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,mGAAmG;AACnG,eAAO,MAAM,SAAS,GAAI,aAAa,MAAM,KAAG,MACuB,CAAC;AAQxE;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,0BAGpC,uBAA4B,KAAG,gBAmCjC,CAAC"}

package/dist/pool-diagnostics/event-loop.js

@@ -0,0 +1,59 @@
+'use strict';
+
+var node_perf_hooks = require('node:perf_hooks');
+
+/** Sampling interval of the event loop delay histogram. */ const EVENT_LOOP_RESOLUTION_MS = 20;
+/** Every rotation drops the older half, so a report covers the last 30 to 60 s. */ const EVENT_LOOP_ROTATION_MS = 30000;
+/** The histogram records the time between samples, so an idle loop reads one sampling interval. */ const toDelayMs = (nanoseconds)=>Math.max(0, Math.round(nanoseconds / 1e6 - EVENT_LOOP_RESOLUTION_MS));
+const startHistogram = ()=>{
+    const histogram = node_perf_hooks.monitorEventLoopDelay({
+        resolution: EVENT_LOOP_RESOLUTION_MS
+    });
+    histogram.enable();
+    return histogram;
+};
+/**
+ * A starved process fires timers late, so an acquire can time out even though the database
+ * answered. Two histograms take turns so a report covers the last one to two rotation periods,
+ * not everything since the process started. Neither the histograms nor the rotation timer keep
+ * the process alive.
+ */ const createEventLoopMonitor = ({ now = ()=>Date.now(), rotateEveryMs = EVENT_LOOP_ROTATION_MS } = {})=>{
+    let older = startHistogram();
+    let newer = startHistogram();
+    let olderStartedAt = now();
+    let newerStartedAt = olderStartedAt;
+    const rotate = ()=>{
+        older.reset();
+        [older, newer] = [
+            newer,
+            older
+        ];
+        olderStartedAt = newerStartedAt;
+        newerStartedAt = now();
+    };
+    const timer = setInterval(rotate, rotateEveryMs);
+    timer.unref();
+    return {
+        read () {
+            if (older.count === 0) {
+                return undefined;
+            }
+            return {
+                maxMs: toDelayMs(older.max),
+                p99Ms: toDelayMs(older.percentile(99)),
+                windowMs: now() - olderStartedAt
+            };
+        },
+        stop () {
+            clearInterval(timer);
+            older.disable();
+            newer.disable();
+        }
+    };
+};
+
+exports.EVENT_LOOP_RESOLUTION_MS = EVENT_LOOP_RESOLUTION_MS;
+exports.EVENT_LOOP_ROTATION_MS = EVENT_LOOP_ROTATION_MS;
+exports.createEventLoopMonitor = createEventLoopMonitor;
+exports.toDelayMs = toDelayMs;
+//# sourceMappingURL=event-loop.js.map

package/dist/pool-diagnostics/event-loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-loop.js","sources":["../../src/pool-diagnostics/event-loop.ts"],"sourcesContent":["import { monitorEventLoopDelay, type IntervalHistogram } from 'node:perf_hooks';\n\n/** Sampling interval of the event loop delay histogram. */\nexport const EVENT_LOOP_RESOLUTION_MS = 20;\n\n/** Every rotation drops the older half, so a report covers the last 30 to 60 s. */\nexport const EVENT_LOOP_ROTATION_MS = 30_000;\n\nexport interface EventLoopDelay {\n  /** Longest delay seen in the window, in ms, sampling interval removed. */\n  maxMs: number;\n  p99Ms: number;\n  /** Length of the window the values cover. */\n  windowMs: number;\n}\n\nexport interface EventLoopMonitor {\n  read(): EventLoopDelay | undefined;\n  stop(): void;\n}\n\nexport interface EventLoopMonitorOptions {\n  /** Injectable clock for tests. */\n  now?: () => number;\n  /** How often the older histogram is cleared and reused. */\n  rotateEveryMs?: number;\n}\n\n/** The histogram records the time between samples, so an idle loop reads one sampling interval. */\nexport const toDelayMs = (nanoseconds: number): number =>\n  Math.max(0, Math.round(nanoseconds / 1e6 - EVENT_LOOP_RESOLUTION_MS));\n\nconst startHistogram = (): IntervalHistogram => {\n  const histogram = monitorEventLoopDelay({ resolution: EVENT_LOOP_RESOLUTION_MS });\n  histogram.enable();\n  return histogram;\n};\n\n/**\n * A starved process fires timers late, so an acquire can time out even though the database\n * answered. Two histograms take turns so a report covers the last one to two rotation periods,\n * not everything since the process started. Neither the histograms nor the rotation timer keep\n * the process alive.\n */\nexport const createEventLoopMonitor = ({\n  now = () => Date.now(),\n  rotateEveryMs = EVENT_LOOP_ROTATION_MS,\n}: EventLoopMonitorOptions = {}): EventLoopMonitor => {\n  let older = startHistogram();\n  let newer = startHistogram();\n  let olderStartedAt = now();\n  let newerStartedAt = olderStartedAt;\n\n  const rotate = () => {\n    older.reset();\n    [older, newer] = [newer, older];\n    olderStartedAt = newerStartedAt;\n    newerStartedAt = now();\n  };\n\n  const timer = setInterval(rotate, rotateEveryMs);\n  timer.unref();\n\n  return {\n    read() {\n      if (older.count === 0) {\n        return undefined;\n      }\n\n      return {\n        maxMs: toDelayMs(older.max),\n        p99Ms: toDelayMs(older.percentile(99)),\n        windowMs: now() - olderStartedAt,\n      };\n    },\n\n    stop() {\n      clearInterval(timer);\n      older.disable();\n      newer.disable();\n    },\n  };\n};\n"],"names":["EVENT_LOOP_RESOLUTION_MS","EVENT_LOOP_ROTATION_MS","toDelayMs","nanoseconds","Math","max","round","startHistogram","histogram","monitorEventLoopDelay","resolution","enable","createEventLoopMonitor","now","Date","rotateEveryMs","older","newer","olderStartedAt","newerStartedAt","rotate","reset","timer","setInterval","unref","read","count","undefined","maxMs","p99Ms","percentile","windowMs","stop","clearInterval","disable"],"mappings":";;;;AAEA,4DACO,MAAMA,wBAAAA,GAA2B;AAExC,oFACO,MAAMC,sBAAAA,GAAyB;AAsBtC,oGACO,MAAMC,SAAAA,GAAY,CAACC,WAAAA,GACxBC,IAAAA,CAAKC,GAAG,CAAC,GAAGD,IAAAA,CAAKE,KAAK,CAACH,WAAAA,GAAc,MAAMH,wBAAAA,CAAAA;AAE7C,MAAMO,cAAAA,GAAiB,IAAA;AACrB,IAAA,MAAMC,YAAYC,qCAAAA,CAAsB;QAAEC,UAAAA,EAAYV;AAAyB,KAAA,CAAA;AAC/EQ,IAAAA,SAAAA,CAAUG,MAAM,EAAA;IAChB,OAAOH,SAAAA;AACT,CAAA;AAEA;;;;;AAKC,IACM,MAAMI,sBAAAA,GAAyB,CAAC,EACrCC,MAAM,IAAMC,IAAAA,CAAKD,GAAG,EAAE,EACtBE,aAAAA,GAAgBd,sBAAsB,EACd,GAAG,EAAE,GAAA;AAC7B,IAAA,IAAIe,KAAAA,GAAQT,cAAAA,EAAAA;AACZ,IAAA,IAAIU,KAAAA,GAAQV,cAAAA,EAAAA;AACZ,IAAA,IAAIW,cAAAA,GAAiBL,GAAAA,EAAAA;AACrB,IAAA,IAAIM,cAAAA,GAAiBD,cAAAA;AAErB,IAAA,MAAME,MAAAA,GAAS,IAAA;AACbJ,QAAAA,KAAAA,CAAMK,KAAK,EAAA;QACX,CAACL,KAAAA,EAAOC,MAAM,GAAG;AAACA,YAAAA,KAAAA;AAAOD,YAAAA;AAAM,SAAA;QAC/BE,cAAAA,GAAiBC,cAAAA;QACjBA,cAAAA,GAAiBN,GAAAA,EAAAA;AACnB,IAAA,CAAA;IAEA,MAAMS,KAAAA,GAAQC,YAAYH,MAAAA,EAAQL,aAAAA,CAAAA;AAClCO,IAAAA,KAAAA,CAAME,KAAK,EAAA;IAEX,OAAO;AACLC,QAAAA,IAAAA,CAAAA,GAAAA;YACE,IAAIT,KAAAA,CAAMU,KAAK,KAAK,CAAA,EAAG;gBACrB,OAAOC,SAAAA;AACT,YAAA;YAEA,OAAO;gBACLC,KAAAA,EAAO1B,SAAAA,CAAUc,MAAMX,GAAG,CAAA;gBAC1BwB,KAAAA,EAAO3B,SAAAA,CAAUc,KAAAA,CAAMc,UAAU,CAAC,EAAA,CAAA,CAAA;AAClCC,gBAAAA,QAAAA,EAAUlB,GAAAA,EAAAA,GAAQK;AACpB,aAAA;AACF,QAAA,CAAA;AAEAc,QAAAA,IAAAA,CAAAA,GAAAA;YACEC,aAAAA,CAAcX,KAAAA,CAAAA;AACdN,YAAAA,KAAAA,CAAMkB,OAAO,EAAA;AACbjB,YAAAA,KAAAA,CAAMiB,OAAO,EAAA;AACf,QAAA;AACF,KAAA;AACF;;;;;;;"}

package/dist/pool-diagnostics/event-loop.mjs

@@ -0,0 +1,54 @@
+import { monitorEventLoopDelay } from 'node:perf_hooks';
+
+/** Sampling interval of the event loop delay histogram. */ const EVENT_LOOP_RESOLUTION_MS = 20;
+/** Every rotation drops the older half, so a report covers the last 30 to 60 s. */ const EVENT_LOOP_ROTATION_MS = 30000;
+/** The histogram records the time between samples, so an idle loop reads one sampling interval. */ const toDelayMs = (nanoseconds)=>Math.max(0, Math.round(nanoseconds / 1e6 - EVENT_LOOP_RESOLUTION_MS));
+const startHistogram = ()=>{
+    const histogram = monitorEventLoopDelay({
+        resolution: EVENT_LOOP_RESOLUTION_MS
+    });
+    histogram.enable();
+    return histogram;
+};
+/**
+ * A starved process fires timers late, so an acquire can time out even though the database
+ * answered. Two histograms take turns so a report covers the last one to two rotation periods,
+ * not everything since the process started. Neither the histograms nor the rotation timer keep
+ * the process alive.
+ */ const createEventLoopMonitor = ({ now = ()=>Date.now(), rotateEveryMs = EVENT_LOOP_ROTATION_MS } = {})=>{
+    let older = startHistogram();
+    let newer = startHistogram();
+    let olderStartedAt = now();
+    let newerStartedAt = olderStartedAt;
+    const rotate = ()=>{
+        older.reset();
+        [older, newer] = [
+            newer,
+            older
+        ];
+        olderStartedAt = newerStartedAt;
+        newerStartedAt = now();
+    };
+    const timer = setInterval(rotate, rotateEveryMs);
+    timer.unref();
+    return {
+        read () {
+            if (older.count === 0) {
+                return undefined;
+            }
+            return {
+                maxMs: toDelayMs(older.max),
+                p99Ms: toDelayMs(older.percentile(99)),
+                windowMs: now() - olderStartedAt
+            };
+        },
+        stop () {
+            clearInterval(timer);
+            older.disable();
+            newer.disable();
+        }
+    };
+};
+
+export { EVENT_LOOP_RESOLUTION_MS, EVENT_LOOP_ROTATION_MS, createEventLoopMonitor, toDelayMs };
+//# sourceMappingURL=event-loop.mjs.map

package/dist/pool-diagnostics/event-loop.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-loop.mjs","sources":["../../src/pool-diagnostics/event-loop.ts"],"sourcesContent":["import { monitorEventLoopDelay, type IntervalHistogram } from 'node:perf_hooks';\n\n/** Sampling interval of the event loop delay histogram. */\nexport const EVENT_LOOP_RESOLUTION_MS = 20;\n\n/** Every rotation drops the older half, so a report covers the last 30 to 60 s. */\nexport const EVENT_LOOP_ROTATION_MS = 30_000;\n\nexport interface EventLoopDelay {\n  /** Longest delay seen in the window, in ms, sampling interval removed. */\n  maxMs: number;\n  p99Ms: number;\n  /** Length of the window the values cover. */\n  windowMs: number;\n}\n\nexport interface EventLoopMonitor {\n  read(): EventLoopDelay | undefined;\n  stop(): void;\n}\n\nexport interface EventLoopMonitorOptions {\n  /** Injectable clock for tests. */\n  now?: () => number;\n  /** How often the older histogram is cleared and reused. */\n  rotateEveryMs?: number;\n}\n\n/** The histogram records the time between samples, so an idle loop reads one sampling interval. */\nexport const toDelayMs = (nanoseconds: number): number =>\n  Math.max(0, Math.round(nanoseconds / 1e6 - EVENT_LOOP_RESOLUTION_MS));\n\nconst startHistogram = (): IntervalHistogram => {\n  const histogram = monitorEventLoopDelay({ resolution: EVENT_LOOP_RESOLUTION_MS });\n  histogram.enable();\n  return histogram;\n};\n\n/**\n * A starved process fires timers late, so an acquire can time out even though the database\n * answered. Two histograms take turns so a report covers the last one to two rotation periods,\n * not everything since the process started. Neither the histograms nor the rotation timer keep\n * the process alive.\n */\nexport const createEventLoopMonitor = ({\n  now = () => Date.now(),\n  rotateEveryMs = EVENT_LOOP_ROTATION_MS,\n}: EventLoopMonitorOptions = {}): EventLoopMonitor => {\n  let older = startHistogram();\n  let newer = startHistogram();\n  let olderStartedAt = now();\n  let newerStartedAt = olderStartedAt;\n\n  const rotate = () => {\n    older.reset();\n    [older, newer] = [newer, older];\n    olderStartedAt = newerStartedAt;\n    newerStartedAt = now();\n  };\n\n  const timer = setInterval(rotate, rotateEveryMs);\n  timer.unref();\n\n  return {\n    read() {\n      if (older.count === 0) {\n        return undefined;\n      }\n\n      return {\n        maxMs: toDelayMs(older.max),\n        p99Ms: toDelayMs(older.percentile(99)),\n        windowMs: now() - olderStartedAt,\n      };\n    },\n\n    stop() {\n      clearInterval(timer);\n      older.disable();\n      newer.disable();\n    },\n  };\n};\n"],"names":["EVENT_LOOP_RESOLUTION_MS","EVENT_LOOP_ROTATION_MS","toDelayMs","nanoseconds","Math","max","round","startHistogram","histogram","monitorEventLoopDelay","resolution","enable","createEventLoopMonitor","now","Date","rotateEveryMs","older","newer","olderStartedAt","newerStartedAt","rotate","reset","timer","setInterval","unref","read","count","undefined","maxMs","p99Ms","percentile","windowMs","stop","clearInterval","disable"],"mappings":";;AAEA,4DACO,MAAMA,wBAAAA,GAA2B;AAExC,oFACO,MAAMC,sBAAAA,GAAyB;AAsBtC,oGACO,MAAMC,SAAAA,GAAY,CAACC,WAAAA,GACxBC,IAAAA,CAAKC,GAAG,CAAC,GAAGD,IAAAA,CAAKE,KAAK,CAACH,WAAAA,GAAc,MAAMH,wBAAAA,CAAAA;AAE7C,MAAMO,cAAAA,GAAiB,IAAA;AACrB,IAAA,MAAMC,YAAYC,qBAAAA,CAAsB;QAAEC,UAAAA,EAAYV;AAAyB,KAAA,CAAA;AAC/EQ,IAAAA,SAAAA,CAAUG,MAAM,EAAA;IAChB,OAAOH,SAAAA;AACT,CAAA;AAEA;;;;;AAKC,IACM,MAAMI,sBAAAA,GAAyB,CAAC,EACrCC,MAAM,IAAMC,IAAAA,CAAKD,GAAG,EAAE,EACtBE,aAAAA,GAAgBd,sBAAsB,EACd,GAAG,EAAE,GAAA;AAC7B,IAAA,IAAIe,KAAAA,GAAQT,cAAAA,EAAAA;AACZ,IAAA,IAAIU,KAAAA,GAAQV,cAAAA,EAAAA;AACZ,IAAA,IAAIW,cAAAA,GAAiBL,GAAAA,EAAAA;AACrB,IAAA,IAAIM,cAAAA,GAAiBD,cAAAA;AAErB,IAAA,MAAME,MAAAA,GAAS,IAAA;AACbJ,QAAAA,KAAAA,CAAMK,KAAK,EAAA;QACX,CAACL,KAAAA,EAAOC,MAAM,GAAG;AAACA,YAAAA,KAAAA;AAAOD,YAAAA;AAAM,SAAA;QAC/BE,cAAAA,GAAiBC,cAAAA;QACjBA,cAAAA,GAAiBN,GAAAA,EAAAA;AACnB,IAAA,CAAA;IAEA,MAAMS,KAAAA,GAAQC,YAAYH,MAAAA,EAAQL,aAAAA,CAAAA;AAClCO,IAAAA,KAAAA,CAAME,KAAK,EAAA;IAEX,OAAO;AACLC,QAAAA,IAAAA,CAAAA,GAAAA;YACE,IAAIT,KAAAA,CAAMU,KAAK,KAAK,CAAA,EAAG;gBACrB,OAAOC,SAAAA;AACT,YAAA;YAEA,OAAO;gBACLC,KAAAA,EAAO1B,SAAAA,CAAUc,MAAMX,GAAG,CAAA;gBAC1BwB,KAAAA,EAAO3B,SAAAA,CAAUc,KAAAA,CAAMc,UAAU,CAAC,EAAA,CAAA,CAAA;AAClCC,gBAAAA,QAAAA,EAAUlB,GAAAA,EAAAA,GAAQK;AACpB,aAAA;AACF,QAAA,CAAA;AAEAc,QAAAA,IAAAA,CAAAA,GAAAA;YACEC,aAAAA,CAAcX,KAAAA,CAAAA;AACdN,YAAAA,KAAAA,CAAMkB,OAAO,EAAA;AACbjB,YAAAA,KAAAA,CAAMiB,OAAO,EAAA;AACf,QAAA;AACF,KAAA;AACF;;;;"}

package/dist/pool-diagnostics/format.d.ts

@@ -0,0 +1,9 @@
+import type { PoolTimeoutDetails } from './details';
+/** Where the error and the warning point readers. The only place the URL lives. */
+export declare const POOL_TIMEOUT_DOCS_URL = "https://docs.strapi.io/cms/configurations/database#connection-pool-timeouts";
+export declare const appendDocsLink: (message: string) => string;
+/** Facts only, one bullet per fact, in the house style of multi-line warnings. */
+export declare const formatPoolTimeoutWarning: (details: PoolTimeoutDetails, { suppressed }: {
+    suppressed: number;
+}) => string;
+//# sourceMappingURL=format.d.ts.map

package/dist/pool-diagnostics/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/pool-diagnostics/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEpD,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,gFAC6C,CAAC;AAEhF,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,KAAG,MAC+C,CAAC;AAQjG,kFAAkF;AAClF,eAAO,MAAM,wBAAwB,GACnC,SAAS,kBAAkB,EAC3B,gBAAgB;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,KACrC,MAsDF,CAAC"}

package/dist/pool-diagnostics/format.js

@@ -0,0 +1,46 @@
+'use strict';
+
+/** Where the error and the warning point readers. The only place the URL lives. */ const POOL_TIMEOUT_DOCS_URL = 'https://docs.strapi.io/cms/configurations/database#connection-pool-timeouts';
+const appendDocsLink = (message)=>message.includes(POOL_TIMEOUT_DOCS_URL) ? message : `${message} See ${POOL_TIMEOUT_DOCS_URL}.`;
+const valueOrUnknown = (value)=>value === undefined ? 'unknown' : String(value);
+// driver errors and labels can span lines; keep each to one bullet
+const singleLine = (text)=>text?.replace(/\s+/g, ' ').trim();
+/** Facts only, one bullet per fact, in the house style of multi-line warnings. */ const formatPoolTimeoutWarning = (details, { suppressed })=>{
+    const lines = [
+        `[database] connection pool timeout: waited ${Math.round(details.waitedMs)} ms for a connection (acquire timeout ${valueOrUnknown(details.acquireTimeoutMs)} ms)`
+    ];
+    if (details.pool) {
+        const { used, free, max, min, pendingAcquires, pendingCreates } = details.pool;
+        lines.push(`  - connections: ${used} in use, ${free} free, max ${valueOrUnknown(max)}, min ${valueOrUnknown(min)}`);
+        lines.push(`  - waiting for a connection: ${pendingAcquires}, connections being opened: ${pendingCreates}`);
+    } else {
+        // a timeout implies a pool exists, so this is a pool without tarn counters
+        lines.push('  - connections: pool counters not available');
+    }
+    if (details.acquireConnectionTimeout !== undefined && details.poolAcquireTimeoutMillis !== undefined) {
+        lines.push(`  - timeout settings: acquireConnectionTimeout ${details.acquireConnectionTimeout}, pool.acquireTimeoutMillis ${details.poolAcquireTimeoutMillis} (knex applies the smaller)`);
+    }
+    const reason = singleLine(details.poolReason);
+    lines.push(`  - reason reported by the pool: ${reason || 'not available'}`);
+    if (details.eventLoopDelay) {
+        const { maxMs, p99Ms, windowMs } = details.eventLoopDelay;
+        lines.push(`  - event loop delay over the last ${Math.round(windowMs / 1000)} s: max ${Math.round(maxMs)} ms, p99 ${Math.round(p99Ms)} ms`);
+    }
+    const phase = singleLine(details.phase);
+    const where = [
+        phase ? `phase ${phase}` : undefined,
+        `host ${details.hostname}`,
+        `pid ${details.pid}`
+    ].filter(Boolean).join(', ');
+    lines.push(`  - ${where}`);
+    if (suppressed > 0) {
+        lines.push(`  - pool timeouts since the previous report: ${suppressed}`);
+    }
+    lines.push(`See ${POOL_TIMEOUT_DOCS_URL}.`);
+    return lines.join('\n');
+};
+
+exports.POOL_TIMEOUT_DOCS_URL = POOL_TIMEOUT_DOCS_URL;
+exports.appendDocsLink = appendDocsLink;
+exports.formatPoolTimeoutWarning = formatPoolTimeoutWarning;
+//# sourceMappingURL=format.js.map

package/dist/pool-diagnostics/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sources":["../../src/pool-diagnostics/format.ts"],"sourcesContent":["import type { PoolTimeoutDetails } from './details';\n\n/** Where the error and the warning point readers. The only place the URL lives. */\nexport const POOL_TIMEOUT_DOCS_URL =\n  'https://docs.strapi.io/cms/configurations/database#connection-pool-timeouts';\n\nexport const appendDocsLink = (message: string): string =>\n  message.includes(POOL_TIMEOUT_DOCS_URL) ? message : `${message} See ${POOL_TIMEOUT_DOCS_URL}.`;\n\nconst valueOrUnknown = (value: number | undefined) =>\n  value === undefined ? 'unknown' : String(value);\n\n// driver errors and labels can span lines; keep each to one bullet\nconst singleLine = (text: string | undefined) => text?.replace(/\\s+/g, ' ').trim();\n\n/** Facts only, one bullet per fact, in the house style of multi-line warnings. */\nexport const formatPoolTimeoutWarning = (\n  details: PoolTimeoutDetails,\n  { suppressed }: { suppressed: number }\n): string => {\n  const lines = [\n    `[database] connection pool timeout: waited ${Math.round(details.waitedMs)} ms for a connection (acquire timeout ${valueOrUnknown(details.acquireTimeoutMs)} ms)`,\n  ];\n\n  if (details.pool) {\n    const { used, free, max, min, pendingAcquires, pendingCreates } = details.pool;\n    lines.push(\n      `  - connections: ${used} in use, ${free} free, max ${valueOrUnknown(max)}, min ${valueOrUnknown(min)}`\n    );\n    lines.push(\n      `  - waiting for a connection: ${pendingAcquires}, connections being opened: ${pendingCreates}`\n    );\n  } else {\n    // a timeout implies a pool exists, so this is a pool without tarn counters\n    lines.push('  - connections: pool counters not available');\n  }\n\n  if (\n    details.acquireConnectionTimeout !== undefined &&\n    details.poolAcquireTimeoutMillis !== undefined\n  ) {\n    lines.push(\n      `  - timeout settings: acquireConnectionTimeout ${details.acquireConnectionTimeout}, pool.acquireTimeoutMillis ${details.poolAcquireTimeoutMillis} (knex applies the smaller)`\n    );\n  }\n\n  const reason = singleLine(details.poolReason);\n  lines.push(`  - reason reported by the pool: ${reason || 'not available'}`);\n\n  if (details.eventLoopDelay) {\n    const { maxMs, p99Ms, windowMs } = details.eventLoopDelay;\n    lines.push(\n      `  - event loop delay over the last ${Math.round(windowMs / 1000)} s: max ${Math.round(maxMs)} ms, p99 ${Math.round(p99Ms)} ms`\n    );\n  }\n\n  const phase = singleLine(details.phase);\n  const where = [\n    phase ? `phase ${phase}` : undefined,\n    `host ${details.hostname}`,\n    `pid ${details.pid}`,\n  ]\n    .filter(Boolean)\n    .join(', ');\n  lines.push(`  - ${where}`);\n\n  if (suppressed > 0) {\n    lines.push(`  - pool timeouts since the previous report: ${suppressed}`);\n  }\n\n  lines.push(`See ${POOL_TIMEOUT_DOCS_URL}.`);\n\n  return lines.join('\\n');\n};\n"],"names":["POOL_TIMEOUT_DOCS_URL","appendDocsLink","message","includes","valueOrUnknown","value","undefined","String","singleLine","text","replace","trim","formatPoolTimeoutWarning","details","suppressed","lines","Math","round","waitedMs","acquireTimeoutMs","pool","used","free","max","min","pendingAcquires","pendingCreates","push","acquireConnectionTimeout","poolAcquireTimeoutMillis","reason","poolReason","eventLoopDelay","maxMs","p99Ms","windowMs","phase","where","hostname","pid","filter","Boolean","join"],"mappings":"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"}

package/dist/pool-diagnostics/format.mjs

@@ -0,0 +1,42 @@
+/** Where the error and the warning point readers. The only place the URL lives. */ const POOL_TIMEOUT_DOCS_URL = 'https://docs.strapi.io/cms/configurations/database#connection-pool-timeouts';
+const appendDocsLink = (message)=>message.includes(POOL_TIMEOUT_DOCS_URL) ? message : `${message} See ${POOL_TIMEOUT_DOCS_URL}.`;
+const valueOrUnknown = (value)=>value === undefined ? 'unknown' : String(value);
+// driver errors and labels can span lines; keep each to one bullet
+const singleLine = (text)=>text?.replace(/\s+/g, ' ').trim();
+/** Facts only, one bullet per fact, in the house style of multi-line warnings. */ const formatPoolTimeoutWarning = (details, { suppressed })=>{
+    const lines = [
+        `[database] connection pool timeout: waited ${Math.round(details.waitedMs)} ms for a connection (acquire timeout ${valueOrUnknown(details.acquireTimeoutMs)} ms)`
+    ];
+    if (details.pool) {
+        const { used, free, max, min, pendingAcquires, pendingCreates } = details.pool;
+        lines.push(`  - connections: ${used} in use, ${free} free, max ${valueOrUnknown(max)}, min ${valueOrUnknown(min)}`);
+        lines.push(`  - waiting for a connection: ${pendingAcquires}, connections being opened: ${pendingCreates}`);
+    } else {
+        // a timeout implies a pool exists, so this is a pool without tarn counters
+        lines.push('  - connections: pool counters not available');
+    }
+    if (details.acquireConnectionTimeout !== undefined && details.poolAcquireTimeoutMillis !== undefined) {
+        lines.push(`  - timeout settings: acquireConnectionTimeout ${details.acquireConnectionTimeout}, pool.acquireTimeoutMillis ${details.poolAcquireTimeoutMillis} (knex applies the smaller)`);
+    }
+    const reason = singleLine(details.poolReason);
+    lines.push(`  - reason reported by the pool: ${reason || 'not available'}`);
+    if (details.eventLoopDelay) {
+        const { maxMs, p99Ms, windowMs } = details.eventLoopDelay;
+        lines.push(`  - event loop delay over the last ${Math.round(windowMs / 1000)} s: max ${Math.round(maxMs)} ms, p99 ${Math.round(p99Ms)} ms`);
+    }
+    const phase = singleLine(details.phase);
+    const where = [
+        phase ? `phase ${phase}` : undefined,
+        `host ${details.hostname}`,
+        `pid ${details.pid}`
+    ].filter(Boolean).join(', ');
+    lines.push(`  - ${where}`);
+    if (suppressed > 0) {
+        lines.push(`  - pool timeouts since the previous report: ${suppressed}`);
+    }
+    lines.push(`See ${POOL_TIMEOUT_DOCS_URL}.`);
+    return lines.join('\n');
+};
+
+export { POOL_TIMEOUT_DOCS_URL, appendDocsLink, formatPoolTimeoutWarning };
+//# sourceMappingURL=format.mjs.map

package/dist/pool-diagnostics/format.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.mjs","sources":["../../src/pool-diagnostics/format.ts"],"sourcesContent":["import type { PoolTimeoutDetails } from './details';\n\n/** Where the error and the warning point readers. The only place the URL lives. */\nexport const POOL_TIMEOUT_DOCS_URL =\n  'https://docs.strapi.io/cms/configurations/database#connection-pool-timeouts';\n\nexport const appendDocsLink = (message: string): string =>\n  message.includes(POOL_TIMEOUT_DOCS_URL) ? message : `${message} See ${POOL_TIMEOUT_DOCS_URL}.`;\n\nconst valueOrUnknown = (value: number | undefined) =>\n  value === undefined ? 'unknown' : String(value);\n\n// driver errors and labels can span lines; keep each to one bullet\nconst singleLine = (text: string | undefined) => text?.replace(/\\s+/g, ' ').trim();\n\n/** Facts only, one bullet per fact, in the house style of multi-line warnings. */\nexport const formatPoolTimeoutWarning = (\n  details: PoolTimeoutDetails,\n  { suppressed }: { suppressed: number }\n): string => {\n  const lines = [\n    `[database] connection pool timeout: waited ${Math.round(details.waitedMs)} ms for a connection (acquire timeout ${valueOrUnknown(details.acquireTimeoutMs)} ms)`,\n  ];\n\n  if (details.pool) {\n    const { used, free, max, min, pendingAcquires, pendingCreates } = details.pool;\n    lines.push(\n      `  - connections: ${used} in use, ${free} free, max ${valueOrUnknown(max)}, min ${valueOrUnknown(min)}`\n    );\n    lines.push(\n      `  - waiting for a connection: ${pendingAcquires}, connections being opened: ${pendingCreates}`\n    );\n  } else {\n    // a timeout implies a pool exists, so this is a pool without tarn counters\n    lines.push('  - connections: pool counters not available');\n  }\n\n  if (\n    details.acquireConnectionTimeout !== undefined &&\n    details.poolAcquireTimeoutMillis !== undefined\n  ) {\n    lines.push(\n      `  - timeout settings: acquireConnectionTimeout ${details.acquireConnectionTimeout}, pool.acquireTimeoutMillis ${details.poolAcquireTimeoutMillis} (knex applies the smaller)`\n    );\n  }\n\n  const reason = singleLine(details.poolReason);\n  lines.push(`  - reason reported by the pool: ${reason || 'not available'}`);\n\n  if (details.eventLoopDelay) {\n    const { maxMs, p99Ms, windowMs } = details.eventLoopDelay;\n    lines.push(\n      `  - event loop delay over the last ${Math.round(windowMs / 1000)} s: max ${Math.round(maxMs)} ms, p99 ${Math.round(p99Ms)} ms`\n    );\n  }\n\n  const phase = singleLine(details.phase);\n  const where = [\n    phase ? `phase ${phase}` : undefined,\n    `host ${details.hostname}`,\n    `pid ${details.pid}`,\n  ]\n    .filter(Boolean)\n    .join(', ');\n  lines.push(`  - ${where}`);\n\n  if (suppressed > 0) {\n    lines.push(`  - pool timeouts since the previous report: ${suppressed}`);\n  }\n\n  lines.push(`See ${POOL_TIMEOUT_DOCS_URL}.`);\n\n  return lines.join('\\n');\n};\n"],"names":["POOL_TIMEOUT_DOCS_URL","appendDocsLink","message","includes","valueOrUnknown","value","undefined","String","singleLine","text","replace","trim","formatPoolTimeoutWarning","details","suppressed","lines","Math","round","waitedMs","acquireTimeoutMs","pool","used","free","max","min","pendingAcquires","pendingCreates","push","acquireConnectionTimeout","poolAcquireTimeoutMillis","reason","poolReason","eventLoopDelay","maxMs","p99Ms","windowMs","phase","where","hostname","pid","filter","Boolean","join"],"mappings":"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"}

package/dist/pool-diagnostics/index.d.ts

@@ -0,0 +1,33 @@
+import type { Knex } from 'knex';
+import { type EventLoopMonitor } from './event-loop';
+export { POOL_TIMEOUT_CODE } from './details';
+export type { PoolState, PoolTimeoutDetails } from './details';
+export type { EventLoopDelay } from './event-loop';
+export { POOL_TIMEOUT_DOCS_URL } from './format';
+export interface PoolDiagnosticsOptions {
+    logger: {
+        warn(message: string): void;
+    };
+    getPhase?: () => string | undefined;
+    now?: () => number;
+    hostname?: string;
+    pid?: number;
+    intervalMs?: number;
+    /** Injected in tests; null turns the event loop measurement off. */
+    eventLoopMonitor?: EventLoopMonitor | null;
+}
+export interface PoolDiagnostics {
+    dispose(): void;
+}
+/** knex also uses KnexTimeoutError for query timeouts; only pool acquire timeouts are described. */
+export declare const isPoolAcquireTimeout: (error: unknown) => error is Error;
+/**
+ * Wraps acquireConnection on the knex client Strapi created. On a pool acquire timeout, the same
+ * error object gets a deeper stack, a docs link and `details`; at most one warning block per
+ * interval goes to the logger. Facts are collected before the error is changed, so a failure while
+ * collecting leaves the error's class, name and message as knex made them (its stack may already be
+ * deeper); a failing logger only loses the warning. An error that already carries `details` from
+ * an earlier install is passed through.
+ */
+export declare const installPoolDiagnostics: (knex: Knex, options: PoolDiagnosticsOptions) => PoolDiagnostics;
+//# sourceMappingURL=index.d.ts.map

package/dist/pool-diagnostics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pool-diagnostics/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAIjC,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAI7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,YAAY,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/D,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AASjD,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE;QAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACpC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,oGAAoG;AACpG,eAAO,MAAM,oBAAoB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,KAGb,CAAC;AAgBnD;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GACjC,MAAM,IAAI,EACV,SAAS,sBAAsB,KAC9B,eAkFF,CAAC"}