@steve31415/baselib 3.54.0 → 3.55.0

package/dist/db.js

@@ -75,6 +75,19 @@ export const DEFAULT_STATEMENT_TIMEOUT_MS = 10 * 60_000;
  *  outside that and well inside the 15 s checkout timeout, so a stall that
  *  the timeout later kills has already been seen to be slow. */
 export const SLOW_CONNECT_MS = 2_000;
+// Headroom judged 2026-11-05 (coder task cec8d1c7), for this threshold and
+// `connectionTimeoutMillis` below: 6 slow-but-successful connects in the
+// week to 2026-11-05 across ~16 apps, 2.1–4.4 s, at most 0.29 of the 15 s
+// timeout. Two causes, both accepted: (1) Cloud SQL's IAM login itself
+// taking 2.5–4.4 s with tcp/tls fast (radar, always-on CPU; ~2 a week,
+// one of them a 4.4 s wait on Steve's own page load); (2) a CPU-starved
+// process stretching every step alike — a LISTEN bridge reconnecting with
+// no request in flight on a throttled-CPU service after the Thursday idle
+// reset (chime, todo), or reader under corpus's daily 11:05 UTC burst of
+// ~700 lookups at 12-way concurrency. Neither approaches the timeout, and
+// a retry would not shorten a server-side login. Keep 15 s; revisit if a
+// login-only stall reaches 7.5 s (half the timeout) or the login-only
+// kind exceeds 4 a week (KNOWN_LOG_PATTERNS.md, "new connection was slow").
 /** Pool settings every fleet pool carries; `createPool` applies them and
  *  is the way to get them (a hand-built pool spreads this, but prefer
  *  `createPool` with `user` / `sessionOptions` over building one). Decided
@@ -279,7 +292,13 @@ const CONNECT_TIMING_MESSAGE = 'database pool: new connection was slow or failed
  *  each step finished, in ms from the start — `tcpMs` (socket connected),
  *  `tlsMs` (TLS done; the Cloud SQL connector's socket only), `authMs`
  *  (the server accepted the login; with IAM authentication Cloud SQL checks
- *  the token here). The point is the step a stall sits in: before `tcp` is
+ *  the token here). These marks are cumulative; `stepsMs` gives each
+ *  step's own duration (`tcp`, `tls`, `login` — login runs from the end of
+ *  TLS, or of TCP without TLS), so a reader need not subtract (triage
+ *  2026-11-05 read a cumulative `authMs` as "all in the login"). Each mark
+ *  is taken when the event loop handles the event, so a CPU-starved
+ *  process stretches every step alike, while a slow server-side login
+ *  shows fast tcp/tls and a long login. The point is the step a stall sits in: before `tcp` is
  *  the network path, between `tcp` and `tls` the Cloud SQL front end or the
  *  certificate, between `tls`/`tcp` and `authenticated` the database login.
  *  pg-pool's own events cannot say this, and a handshake whose checkout
@@ -320,6 +339,14 @@ function timeNewConnections(pool, logger, options) {
             if (!err)
                 this.#reached = 'ready';
             const expiry = options.credentialExpiry?.();
+            const { tcp, tls, authenticated } = this.#marks;
+            const stepsMs = {};
+            if (tcp !== undefined)
+                stepsMs.tcp = tcp;
+            if (tls !== undefined && tcp !== undefined)
+                stepsMs.tls = tls - tcp;
+            if (authenticated !== undefined)
+                stepsMs.login = authenticated - (tls ?? tcp ?? 0);
             const meta = {
                 outcome: err ? 'failed' : 'slow',
                 reached: this.#reached,
@@ -327,6 +354,7 @@ function timeNewConnections(pool, logger, options) {
                 tcpMs: this.#marks.tcp,
                 tlsMs: this.#marks.tls,
                 authMs: this.#marks.authenticated,
+                stepsMs,
                 pool: { total: pool.totalCount, idle: pool.idleCount, waiting: pool.waitingCount, max: pool.options.max },
                 ...(options.credentialExpiry ? (expiry === undefined ? { credentialUnknown: true } : { credentialRemainingMs: expiry - Date.now() }) : {}),
                 ...(err ? { error: err } : {}),

package/dist/rum.d.ts

@@ -11,7 +11,11 @@ export interface RumOptions {
  * The same-origin resource of one initiator type (`script`, `fetch`) that
  * finished last before `before` (ms since navigation start) — for a single-page
  * app, the entry script and the first data fetch that first paint waited on.
- * Times are ms since navigation start; `bytes` 0 means served from cache.
+ * `start_ms`, `sent_ms`, `first_byte_ms` and `end_ms` are ms since navigation
+ * start; `dns_ms` and `connect_ms` are durations. A request the browser (or an
+ * extension in it) held before sending shows as `sent_ms - start_ms` well over
+ * `dns_ms + connect_ms`; a cold network shows in those two; `bytes` 0 means
+ * served from cache.
  */
 export declare function lastResourceBefore(entries: readonly PerformanceResourceTiming[], initiatorType: string, before: number): Record<string, string | number | undefined> | undefined;
 /**

package/dist/rum.js

@@ -35,7 +35,11 @@ function resourcePath(url) {
  * The same-origin resource of one initiator type (`script`, `fetch`) that
  * finished last before `before` (ms since navigation start) — for a single-page
  * app, the entry script and the first data fetch that first paint waited on.
- * Times are ms since navigation start; `bytes` 0 means served from cache.
+ * `start_ms`, `sent_ms`, `first_byte_ms` and `end_ms` are ms since navigation
+ * start; `dns_ms` and `connect_ms` are durations. A request the browser (or an
+ * extension in it) held before sending shows as `sent_ms - start_ms` well over
+ * `dns_ms + connect_ms`; a cold network shows in those two; `bytes` 0 means
+ * served from cache.
  */
 export function lastResourceBefore(entries, initiatorType, before) {
     let pick;
@@ -56,10 +60,15 @@ export function lastResourceBefore(entries, initiatorType, before) {
     }
     if (!pick)
         return undefined;
+    const positive = (n) => (n > 0 ? n : undefined);
+    const span = (from, to) => (from > 0 && to >= from ? to - from : undefined);
     return {
         path: resourcePath(pick.name),
         start_ms: ms(pick.startTime),
-        first_byte_ms: ms(pick.responseStart > 0 ? pick.responseStart : undefined),
+        sent_ms: ms(positive(pick.requestStart)),
+        dns_ms: ms(span(pick.domainLookupStart, pick.domainLookupEnd)),
+        connect_ms: ms(span(pick.connectStart, pick.connectEnd)),
+        first_byte_ms: ms(positive(pick.responseStart)),
         end_ms: ms(pick.responseEnd),
         bytes: pick.transferSize,
         protocol: pick.nextHopProtocol || undefined,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steve31415/baselib",
-  "version": "3.54.0",
+  "version": "3.55.0",
   "description": "Plasticine new-world shared platform library: logging, auth, service-to-service auth, db, HTTP, sync, app updates",
   "type": "module",
   "license": "MIT",