@adaptic/backend 0.0.1041 → 0.0.1043

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -57,7 +57,29 @@ export declare const IR_MODELS: readonly EnhanceModelName[];
57
57
  *
58
58
  * Decorating them changes NO behaviour while the checker is in shadow — a
59
59
  * would-deny is logged and counted and then allowed. What it changes is that
60
- * the exposure becomes measurable. Enforcement cannot be argued from a
60
+ * the exposure becomes measurable.
61
+ *
62
+ * `Fund` joined them on 2026-09-27, and it is the one admission that corrects a
63
+ * belief rather than adding a surface. The exposure is an unauthenticated
64
+ * request receiving HTTP 200 with every fund's P&L — measured on the deployed
65
+ * API by Sophie Nguyen at 02:42Z and independently by James Kirkland at
66
+ * 09:46:56Z, not inferred from the schema. `Fund` carries `aum`,
67
+ * `navPerShare` and `highWaterMarkNav`.
68
+ *
69
+ * The belief it corrects: this gap was being treated as something the
70
+ * `CORTEX_AUTHCHECKER_ENFORCE` flip would close. **It would not have.** `Fund`
71
+ * was in neither list, so its reads were never decorated, so the checker never
72
+ * ran for them — and per the paragraph above, a query the checker never runs
73
+ * for is a query it cannot even count. Waiting for the enforcement flip would
74
+ * have closed the four models here and left every fund's P&L answering to
75
+ * anyone, with nothing in the would-deny ratio to show it. Coverage and
76
+ * enforcement are separate axes and only one of them was being tracked.
77
+ *
78
+ * `FundAssignment` is a candidate and is deliberately NOT admitted here. It
79
+ * reveals which accounts belong to which fund, which is structural rather than
80
+ * P&L, and no anonymous probe of it has been run. Admitting it on inspection
81
+ * would break the criterion this list is built on — by measurement, not by
82
+ * reading the schema. Measure it, then admit it. Enforcement cannot be argued from a
61
83
  * would-deny ratio that reflects only surfaces nobody ever authenticated to,
62
84
  * and the measurement has to exist before the decision does.
63
85
  */
@@ -1 +1 @@
1
- {"version":3,"file":"authorization-map.d.ts","sourceRoot":"","sources":["../../../src/auth/authorization-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,iCAAiC,CAAC;AAIzC,yEAAyE;AACzE,KAAK,gBAAgB,GAAG,MAAM,mBAAmB,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,SAAS,gBAAgB,EAMhD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,gBAAgB,EAKhE,CAAC;AAmCF,mEAAmE;AACnE,MAAM,WAAW,uBAAuB;IACtC,yDAAyD;IACzD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,oDAAoD;IACpD,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,4FAA4F;IAC5F,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,0EAA0E;IAC1E,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAmBD,6DAA6D;AAC7D,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,GAAG,EAAE,mBAAmB,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;CAC3C;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,IAAI,qBAAqB,CAoEnE;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,IAAI,uBAAuB,CAcrE"}
1
+ {"version":3,"file":"authorization-map.d.ts","sourceRoot":"","sources":["../../../src/auth/authorization-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,iCAAiC,CAAC;AAIzC,yEAAyE;AACzE,KAAK,gBAAgB,GAAG,MAAM,mBAAmB,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,SAAS,gBAAgB,EAMhD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,gBAAgB,EAMhE,CAAC;AAmCF,mEAAmE;AACnE,MAAM,WAAW,uBAAuB;IACtC,yDAAyD;IACzD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,oDAAoD;IACpD,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,4FAA4F;IAC5F,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,0EAA0E;IAC1E,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAmBD,6DAA6D;AAC7D,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,GAAG,EAAE,mBAAmB,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;CAC3C;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,IAAI,qBAAqB,CAoEnE;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,IAAI,uBAAuB,CAcrE"}
@@ -1 +1 @@
1
- {"version":3,"file":"authorization-map.js","sourceRoot":"","sources":["../../../src/auth/authorization-map.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"authorization-map.js","sourceRoot":"","sources":["../../../src/auth/authorization-map.ts"],"names":[],"mappings":"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"}
@@ -65,7 +65,29 @@ export const IR_MODELS = [
65
65
  *
66
66
  * Decorating them changes NO behaviour while the checker is in shadow — a
67
67
  * would-deny is logged and counted and then allowed. What it changes is that
68
- * the exposure becomes measurable. Enforcement cannot be argued from a
68
+ * the exposure becomes measurable.
69
+ *
70
+ * `Fund` joined them on 2026-09-27, and it is the one admission that corrects a
71
+ * belief rather than adding a surface. The exposure is an unauthenticated
72
+ * request receiving HTTP 200 with every fund's P&L — measured on the deployed
73
+ * API by Sophie Nguyen at 02:42Z and independently by James Kirkland at
74
+ * 09:46:56Z, not inferred from the schema. `Fund` carries `aum`,
75
+ * `navPerShare` and `highWaterMarkNav`.
76
+ *
77
+ * The belief it corrects: this gap was being treated as something the
78
+ * `CORTEX_AUTHCHECKER_ENFORCE` flip would close. **It would not have.** `Fund`
79
+ * was in neither list, so its reads were never decorated, so the checker never
80
+ * ran for them — and per the paragraph above, a query the checker never runs
81
+ * for is a query it cannot even count. Waiting for the enforcement flip would
82
+ * have closed the four models here and left every fund's P&L answering to
83
+ * anyone, with nothing in the would-deny ratio to show it. Coverage and
84
+ * enforcement are separate axes and only one of them was being tracked.
85
+ *
86
+ * `FundAssignment` is a candidate and is deliberately NOT admitted here. It
87
+ * reveals which accounts belong to which fund, which is structural rather than
88
+ * P&L, and no anonymous probe of it has been run. Admitting it on inspection
89
+ * would break the criterion this list is built on — by measurement, not by
90
+ * reading the schema. Measure it, then admit it. Enforcement cannot be argued from a
69
91
  * would-deny ratio that reflects only surfaces nobody ever authenticated to,
70
92
  * and the measurement has to exist before the decision does.
71
93
  */
@@ -74,6 +96,7 @@ export const TENANT_SCOPED_READ_MODELS = [
74
96
  'OrgMembership',
75
97
  'User',
76
98
  'AuditLog',
99
+ 'Fund',
77
100
  ];
78
101
  /**
79
102
  * Action-name prefixes that MUTATE. Everything else on a generated CRUD
package/esm/health.d.ts CHANGED
@@ -1,4 +1,62 @@
1
1
  import { Router } from 'express';
2
+ type DatabaseCheck = 'recent-query' | 'probe';
3
+ /**
4
+ * How recently a query must have completed for `/health` to accept it as
5
+ * proof the database is answering, without issuing a query of its own.
6
+ *
7
+ * Derived from the heartbeat rather than set by hand: it tolerates every
8
+ * heartbeat but the last before reconnection being missed, plus half an
9
+ * interval of slack — `(MAX_HEARTBEAT_FAILURES - 0.5) * HEARTBEAT_INTERVAL_MS`,
10
+ * 75s at the current 3 x 30s. That keeps it longer than one heartbeat interval,
11
+ * so an idle process that the heartbeat keeps refreshing never goes stale, and
12
+ * shorter than the reconnect point, so a database that has stopped answering
13
+ * reads as disconnected before the heartbeat gives up on the client.
14
+ *
15
+ * A saturated pool still completes queries, each bounded by the statement
16
+ * timeout, so saturation alone does not let it go stale — provided that
17
+ * timeout is shorter than this window (see
18
+ * {@link warnIfStatementTimeoutDefeatsFreshness}).
19
+ */
20
+ export declare const DB_SUCCESS_FRESHNESS_MS: number;
21
+ /**
22
+ * Warn when the configured statement timeout is not shorter than the
23
+ * freshness window.
24
+ *
25
+ * The case for trusting a recent success under saturation is that every query
26
+ * on a busy pool finishes or fails within the statement timeout, so completed
27
+ * queries keep arriving inside {@link DB_SUCCESS_FRESHNESS_MS}. A timeout at or
28
+ * above the window breaks that: a pool full of long-running statements can go
29
+ * a whole window without a completion and `/health` would fall back to a probe
30
+ * that cannot get a connection. A value that is not a positive integer (unset
31
+ * timeouts parse from the default; `0` disables the timeout in Postgres) is
32
+ * treated the same way, since it bounds nothing.
33
+ *
34
+ * @param statementTimeoutMs - The resolved statement timeout (injectable for tests).
35
+ * @returns True if a warning was logged.
36
+ */
37
+ export declare function warnIfStatementTimeoutDefeatsFreshness(statementTimeoutMs?: number): boolean;
38
+ /**
39
+ * Budget for the fallback probe when no recent success exists. Well under the
40
+ * 10s pool wait so a saturated pool yields an answer inside the platform's
41
+ * probe timeout rather than hanging the request.
42
+ */
43
+ export declare const HEALTH_PROBE_TIMEOUT_MS = 2000;
44
+ /**
45
+ * Decide whether the database is answering this process, without depending
46
+ * on a free pool connection when there is already evidence that it is.
47
+ *
48
+ * A query that completed within {@link DB_SUCCESS_FRESHNESS_MS} is taken as
49
+ * that evidence and no query is issued. Only when there is none (startup, or a
50
+ * database that has stopped answering) does it fall back to a bounded probe.
51
+ *
52
+ * @param now - Current epoch ms (injectable for tests).
53
+ * @returns The database status, how it was decided, and the success age.
54
+ */
55
+ export declare function checkDatabaseReadiness(now?: number): Promise<{
56
+ database: 'connected' | 'disconnected';
57
+ databaseCheck: DatabaseCheck;
58
+ lastQuerySucceededSecondsAgo: number | null;
59
+ }>;
2
60
  /**
3
61
  * Creates an Express router with health-probe endpoints.
4
62
  *
@@ -9,11 +67,16 @@ import { Router } from 'express';
9
67
  * is reachable (`SELECT 1`), HTTP 503 otherwise. Suitable for Cloud Run
10
68
  * startup probes and load-balancer readiness.
11
69
  * - `GET /health` — Full health snapshot including memory usage and database
12
- * status. Returns 503 when the database is unreachable. Kept for
13
- * backward compatibility with existing Railway/uptime checks.
70
+ * status. Returns 503 only when the database has stopped answering this
71
+ * process: a query that completed within the freshness window counts as
72
+ * proof without taking a pool connection, so a saturated-but-working pool
73
+ * reads as healthy. With no recent success it falls back to a bounded
74
+ * probe (see {@link checkDatabaseReadiness}). Kept for backward
75
+ * compatibility with existing Railway/uptime checks.
14
76
  *
15
77
  * All endpoints should be mounted before auth middleware so they remain
16
78
  * accessible without authentication.
17
79
  */
18
80
  export declare function createHealthRouter(): Router;
81
+ export {};
19
82
  //# sourceMappingURL=health.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,MAAM,EAAE,MAAM,SAAS,CAAC;AAuDpD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAkD3C"}
1
+ {"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,MAAM,EAAE,MAAM,SAAS,CAAC;AAgDpD,KAAK,aAAa,GAAG,cAAc,GAAG,OAAO,CAAC;AAE9C;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,uBAAuB,QACoB,CAAC;AAEzD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sCAAsC,CACpD,kBAAkB,GAAE,MAAoC,GACvD,OAAO,CAgBT;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAqD7C;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,GAAE,MAAmB,GACvB,OAAO,CAAC;IACT,QAAQ,EAAE,WAAW,GAAG,cAAc,CAAC;IACvC,aAAa,EAAE,aAAa,CAAC;IAC7B,4BAA4B,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C,CAAC,CAuBD;AAkBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAuD3C"}
package/esm/health.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/health.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/health.ts"],"names":[],"mappings":"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"}
package/esm/health.mjs CHANGED
@@ -1,5 +1,5 @@
1
1
  import { Router } from 'express';
2
- import prisma from './prismaClient.mjs';
2
+ import prisma, { getLastQuerySucceededAt, HEARTBEAT_INTERVAL_MS, MAX_HEARTBEAT_FAILURES, resolveStatementTimeoutMs, } from './prismaClient.mjs';
3
3
  import { logger } from './utils/logger.mjs';
4
4
  const SERVICE_NAME = 'backend-legacy';
5
5
  /**
@@ -18,6 +18,135 @@ function getPackageVersion() {
18
18
  const PACKAGE_VERSION = getPackageVersion();
19
19
  /** Tracks the process start time for uptime calculation */
20
20
  const startedAt = Date.now();
21
+ /**
22
+ * How recently a query must have completed for `/health` to accept it as
23
+ * proof the database is answering, without issuing a query of its own.
24
+ *
25
+ * Derived from the heartbeat rather than set by hand: it tolerates every
26
+ * heartbeat but the last before reconnection being missed, plus half an
27
+ * interval of slack — `(MAX_HEARTBEAT_FAILURES - 0.5) * HEARTBEAT_INTERVAL_MS`,
28
+ * 75s at the current 3 x 30s. That keeps it longer than one heartbeat interval,
29
+ * so an idle process that the heartbeat keeps refreshing never goes stale, and
30
+ * shorter than the reconnect point, so a database that has stopped answering
31
+ * reads as disconnected before the heartbeat gives up on the client.
32
+ *
33
+ * A saturated pool still completes queries, each bounded by the statement
34
+ * timeout, so saturation alone does not let it go stale — provided that
35
+ * timeout is shorter than this window (see
36
+ * {@link warnIfStatementTimeoutDefeatsFreshness}).
37
+ */
38
+ export const DB_SUCCESS_FRESHNESS_MS = (MAX_HEARTBEAT_FAILURES - 0.5) * HEARTBEAT_INTERVAL_MS;
39
+ /**
40
+ * Warn when the configured statement timeout is not shorter than the
41
+ * freshness window.
42
+ *
43
+ * The case for trusting a recent success under saturation is that every query
44
+ * on a busy pool finishes or fails within the statement timeout, so completed
45
+ * queries keep arriving inside {@link DB_SUCCESS_FRESHNESS_MS}. A timeout at or
46
+ * above the window breaks that: a pool full of long-running statements can go
47
+ * a whole window without a completion and `/health` would fall back to a probe
48
+ * that cannot get a connection. A value that is not a positive integer (unset
49
+ * timeouts parse from the default; `0` disables the timeout in Postgres) is
50
+ * treated the same way, since it bounds nothing.
51
+ *
52
+ * @param statementTimeoutMs - The resolved statement timeout (injectable for tests).
53
+ * @returns True if a warning was logged.
54
+ */
55
+ export function warnIfStatementTimeoutDefeatsFreshness(statementTimeoutMs = resolveStatementTimeoutMs()) {
56
+ if (Number.isFinite(statementTimeoutMs) &&
57
+ statementTimeoutMs > 0 &&
58
+ statementTimeoutMs < DB_SUCCESS_FRESHNESS_MS) {
59
+ return false;
60
+ }
61
+ logger.warn('DATABASE_STATEMENT_TIMEOUT_MS is not shorter than the /health freshness window — a saturated pool can read as disconnected', {
62
+ statementTimeoutMs,
63
+ freshnessWindowMs: DB_SUCCESS_FRESHNESS_MS,
64
+ });
65
+ return true;
66
+ }
67
+ /**
68
+ * Budget for the fallback probe when no recent success exists. Well under the
69
+ * 10s pool wait so a saturated pool yields an answer inside the platform's
70
+ * probe timeout rather than hanging the request.
71
+ */
72
+ export const HEALTH_PROBE_TIMEOUT_MS = 2_000;
73
+ /** The one probe query this module may have outstanding on the pool. */
74
+ let outstandingProbe;
75
+ /**
76
+ * Probe the live client with `SELECT 1`, giving up after `timeoutMs`.
77
+ *
78
+ * Reads `global.prisma` rather than the module-level import, because the
79
+ * heartbeat's reconnect path replaces `global.prisma` and the import stays
80
+ * pinned to the original (by then disconnected) client.
81
+ *
82
+ * At most one probe query is ever outstanding: a caller that arrives while a
83
+ * previous probe is still queued on the pool waits on that same query instead
84
+ * of adding another waiter, so frequent health checks cannot themselves deepen
85
+ * a saturated pool's queue.
86
+ *
87
+ * @param timeoutMs - How long to wait for the probe before calling it failed.
88
+ * @returns True if the probe completed within the budget.
89
+ */
90
+ async function probeLiveClient(timeoutMs) {
91
+ if (!outstandingProbe) {
92
+ const client = global.prisma ?? prisma;
93
+ outstandingProbe = Promise.resolve(client.$queryRaw `SELECT 1`).finally(() => {
94
+ outstandingProbe = undefined;
95
+ });
96
+ }
97
+ const probe = outstandingProbe;
98
+ let timer;
99
+ const timedOut = new Promise((resolve) => {
100
+ timer = setTimeout(() => resolve(false), timeoutMs);
101
+ });
102
+ try {
103
+ return await Promise.race([
104
+ probe.then(() => true, (dbError) => {
105
+ logger.warn('Health check: database probe failed', {
106
+ error: dbError instanceof Error ? dbError.message : String(dbError),
107
+ });
108
+ return false;
109
+ }),
110
+ timedOut,
111
+ ]);
112
+ }
113
+ finally {
114
+ clearTimeout(timer);
115
+ }
116
+ }
117
+ /**
118
+ * Decide whether the database is answering this process, without depending
119
+ * on a free pool connection when there is already evidence that it is.
120
+ *
121
+ * A query that completed within {@link DB_SUCCESS_FRESHNESS_MS} is taken as
122
+ * that evidence and no query is issued. Only when there is none (startup, or a
123
+ * database that has stopped answering) does it fall back to a bounded probe.
124
+ *
125
+ * @param now - Current epoch ms (injectable for tests).
126
+ * @returns The database status, how it was decided, and the success age.
127
+ */
128
+ export async function checkDatabaseReadiness(now = Date.now()) {
129
+ const lastSuccess = getLastQuerySucceededAt();
130
+ const ageMs = lastSuccess === undefined ? undefined : now - lastSuccess;
131
+ if (ageMs !== undefined && ageMs <= DB_SUCCESS_FRESHNESS_MS) {
132
+ return {
133
+ database: 'connected',
134
+ databaseCheck: 'recent-query',
135
+ lastQuerySucceededSecondsAgo: Math.max(0, Math.floor(ageMs / 1000)),
136
+ };
137
+ }
138
+ const answered = await probeLiveClient(HEALTH_PROBE_TIMEOUT_MS);
139
+ // A successful probe goes through the same client extension and refreshes
140
+ // the stamp; report the age as it stands after the probe.
141
+ const after = getLastQuerySucceededAt();
142
+ return {
143
+ database: answered ? 'connected' : 'disconnected',
144
+ databaseCheck: 'probe',
145
+ lastQuerySucceededSecondsAgo: after === undefined
146
+ ? null
147
+ : Math.max(0, Math.floor((Date.now() - after) / 1000)),
148
+ };
149
+ }
21
150
  /**
22
151
  * Checks database connectivity by issuing a lightweight query.
23
152
  * Returns 'connected' or 'disconnected'. Never throws.
@@ -44,13 +173,18 @@ async function checkDatabase() {
44
173
  * is reachable (`SELECT 1`), HTTP 503 otherwise. Suitable for Cloud Run
45
174
  * startup probes and load-balancer readiness.
46
175
  * - `GET /health` — Full health snapshot including memory usage and database
47
- * status. Returns 503 when the database is unreachable. Kept for
48
- * backward compatibility with existing Railway/uptime checks.
176
+ * status. Returns 503 only when the database has stopped answering this
177
+ * process: a query that completed within the freshness window counts as
178
+ * proof without taking a pool connection, so a saturated-but-working pool
179
+ * reads as healthy. With no recent success it falls back to a bounded
180
+ * probe (see {@link checkDatabaseReadiness}). Kept for backward
181
+ * compatibility with existing Railway/uptime checks.
49
182
  *
50
183
  * All endpoints should be mounted before auth middleware so they remain
51
184
  * accessible without authentication.
52
185
  */
53
186
  export function createHealthRouter() {
187
+ warnIfStatementTimeoutDefeatsFreshness();
54
188
  const router = Router();
55
189
  router.get('/livez', (_req, res) => {
56
190
  res.status(200).json({
@@ -73,7 +207,8 @@ export function createHealthRouter() {
73
207
  });
74
208
  });
75
209
  router.get('/health', async (_req, res) => {
76
- const databaseStatus = await checkDatabase();
210
+ const readiness = await checkDatabaseReadiness();
211
+ const databaseStatus = readiness.database;
77
212
  const isHealthy = databaseStatus === 'connected';
78
213
  const statusCode = isHealthy ? 200 : 503;
79
214
  const memoryUsage = process.memoryUsage();
@@ -89,6 +224,8 @@ export function createHealthRouter() {
89
224
  heapTotal: Math.round(memoryUsage.heapTotal / 1024 / 1024),
90
225
  },
91
226
  database: databaseStatus,
227
+ databaseCheck: readiness.databaseCheck,
228
+ lastQuerySucceededSecondsAgo: readiness.lastQuerySucceededSecondsAgo,
92
229
  };
93
230
  res.status(statusCode).json(body);
94
231
  });
@@ -29,6 +29,28 @@ export declare const DEFAULT_FIND_MANY_TAKE = 50000;
29
29
  * @returns The row ceiling to apply to an unqualified `findMany`.
30
30
  */
31
31
  export declare function resolveFindManyTake(): number;
32
+ /**
33
+ * When a query on this process's Prisma client last completed successfully.
34
+ *
35
+ * This is the evidence `/health` uses for "the database is answering this
36
+ * process". It is recorded as a side effect of ordinary traffic and of the
37
+ * heartbeat, so reading it never needs a pool connection — which is the point:
38
+ * a pool that is saturated but still completing work keeps this fresh, and a
39
+ * database that has stopped answering lets it go stale.
40
+ *
41
+ * @returns Epoch milliseconds of the last success, or undefined if none yet.
42
+ */
43
+ export declare function getLastQuerySucceededAt(): number | undefined;
44
+ /**
45
+ * Run a query and stamp the success time if it resolves.
46
+ *
47
+ * A rejected query leaves the stamp alone; any completed round trip, including
48
+ * one issued by a caller that has since given up waiting on it, refreshes it.
49
+ *
50
+ * @param run - Executes the underlying operation.
51
+ * @returns Whatever the operation returned.
52
+ */
53
+ export declare function stampQuerySuccess<T>(run: () => Promise<T>): Promise<T>;
32
54
  /**
33
55
  * Apply the unqualified-`findMany` ceiling to a Prisma client.
34
56
  *
@@ -47,6 +69,22 @@ export declare function resolveFindManyTake(): number;
47
69
  * @returns The client with the ceiling applied.
48
70
  */
49
71
  export declare function withFindManyGuard(client: PrismaClient): PrismaClient;
72
+ /** Default statement timeout (30s) prevents hung queries from blocking pool slots indefinitely */
73
+ export declare const DEFAULT_STATEMENT_TIMEOUT_MS = 30000;
74
+ /** Heartbeat interval: how often we verify the DB connection is alive */
75
+ export declare const HEARTBEAT_INTERVAL_MS = 30000;
76
+ /** Consecutive heartbeat failures before triggering client reconnection */
77
+ export declare const MAX_HEARTBEAT_FAILURES = 3;
78
+ /**
79
+ * Resolve the per-statement timeout appended to a direct Postgres URL.
80
+ *
81
+ * Parsed exactly as the URL builder has always parsed it, so a value that is
82
+ * not a positive integer comes back as-is (NaN, 0, negative) for the caller to
83
+ * judge rather than being silently replaced.
84
+ *
85
+ * @returns The statement timeout in milliseconds.
86
+ */
87
+ export declare function resolveStatementTimeoutMs(): number;
50
88
  declare const prisma: PrismaClient;
51
89
  /**
52
90
  * Starts the periodic database heartbeat monitor.
@@ -1 +1 @@
1
- {"version":3,"file":"prismaClient.d.ts","sourceRoot":"","sources":["../../src/prismaClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAW9C;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAY5C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CA2BpE;AAyQD,QAAA,MAAM,MAAM,EAAE,YAA4B,CAAC;AAgH3C;;;;GAIG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,IAAI,CAgBzD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAMlD;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,SAAS,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB3E;AAED,eAAe,MAAM,CAAC"}
1
+ {"version":3,"file":"prismaClient.d.ts","sourceRoot":"","sources":["../../src/prismaClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAW9C;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAY5C;AAKD;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,SAAS,CAE5D;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAI5E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAsCpE;AAED,kGAAkG;AAClG,eAAO,MAAM,4BAA4B,QAAQ,CAAC;AAElD,yEAAyE;AACzE,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAE3C,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAMlD;AA4PD,QAAA,MAAM,MAAM,EAAE,YAA4B,CAAC;AAgH3C;;;;GAIG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,IAAI,CAgBzD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAMlD;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,SAAS,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB3E;AAED,eAAe,MAAM,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"prismaClient.js","sourceRoot":"","sources":["../../src/prismaClient.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"prismaClient.js","sourceRoot":"","sources":["../../src/prismaClient.ts"],"names":[],"mappings":"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"}
@@ -42,6 +42,36 @@ export function resolveFindManyTake() {
42
42
  }
43
43
  return parsed;
44
44
  }
45
+ /** Wall-clock ms of the most recent query that completed successfully, or undefined before the first. */
46
+ let lastQuerySucceededAt;
47
+ /**
48
+ * When a query on this process's Prisma client last completed successfully.
49
+ *
50
+ * This is the evidence `/health` uses for "the database is answering this
51
+ * process". It is recorded as a side effect of ordinary traffic and of the
52
+ * heartbeat, so reading it never needs a pool connection — which is the point:
53
+ * a pool that is saturated but still completing work keeps this fresh, and a
54
+ * database that has stopped answering lets it go stale.
55
+ *
56
+ * @returns Epoch milliseconds of the last success, or undefined if none yet.
57
+ */
58
+ export function getLastQuerySucceededAt() {
59
+ return lastQuerySucceededAt;
60
+ }
61
+ /**
62
+ * Run a query and stamp the success time if it resolves.
63
+ *
64
+ * A rejected query leaves the stamp alone; any completed round trip, including
65
+ * one issued by a caller that has since given up waiting on it, refreshes it.
66
+ *
67
+ * @param run - Executes the underlying operation.
68
+ * @returns Whatever the operation returned.
69
+ */
70
+ export async function stampQuerySuccess(run) {
71
+ const result = await run();
72
+ lastQuerySucceededAt = Date.now();
73
+ return result;
74
+ }
45
75
  /**
46
76
  * Apply the unqualified-`findMany` ceiling to a Prisma client.
47
77
  *
@@ -61,7 +91,18 @@ export function resolveFindManyTake() {
61
91
  */
62
92
  export function withFindManyGuard(client) {
63
93
  const ceiling = resolveFindManyTake();
64
- const extended = client.$extends({
94
+ // The success stamp rides this wrapper because it is the one applied at both
95
+ // client assignment sites (initial and reconnect), so the stamp survives a
96
+ // reconnect without the reconnect path having to know about it.
97
+ const stamped = client.$extends({
98
+ name: 'query-success-stamp',
99
+ query: {
100
+ async $allOperations({ args, query }) {
101
+ return stampQuerySuccess(() => query(args));
102
+ },
103
+ },
104
+ });
105
+ const extended = stamped.$extends({
65
106
  name: 'find-many-ceiling',
66
107
  query: {
67
108
  $allModels: {
@@ -85,11 +126,24 @@ export function withFindManyGuard(client) {
85
126
  return extended;
86
127
  }
87
128
  /** Default statement timeout (30s) prevents hung queries from blocking pool slots indefinitely */
88
- const DEFAULT_STATEMENT_TIMEOUT_MS = 30000;
129
+ export const DEFAULT_STATEMENT_TIMEOUT_MS = 30000;
89
130
  /** Heartbeat interval: how often we verify the DB connection is alive */
90
- const HEARTBEAT_INTERVAL_MS = 30000;
131
+ export const HEARTBEAT_INTERVAL_MS = 30000;
91
132
  /** Consecutive heartbeat failures before triggering client reconnection */
92
- const MAX_HEARTBEAT_FAILURES = 3;
133
+ export const MAX_HEARTBEAT_FAILURES = 3;
134
+ /**
135
+ * Resolve the per-statement timeout appended to a direct Postgres URL.
136
+ *
137
+ * Parsed exactly as the URL builder has always parsed it, so a value that is
138
+ * not a positive integer comes back as-is (NaN, 0, negative) for the caller to
139
+ * judge rather than being silently replaced.
140
+ *
141
+ * @returns The statement timeout in milliseconds.
142
+ */
143
+ export function resolveStatementTimeoutMs() {
144
+ return parseInt(process.env.DATABASE_STATEMENT_TIMEOUT_MS ||
145
+ String(DEFAULT_STATEMENT_TIMEOUT_MS), 10);
146
+ }
93
147
  /** Heartbeat query timeout (5s) — shorter than pool timeout to detect issues early */
94
148
  const HEARTBEAT_TIMEOUT_MS = 5000;
95
149
  /**
@@ -198,8 +252,7 @@ function buildDatabaseUrl() {
198
252
  poolTimeoutMs: poolTimeout,
199
253
  environment: process.env.NODE_ENV || 'development',
200
254
  });
201
- const statementTimeoutMs = parseInt(process.env.DATABASE_STATEMENT_TIMEOUT_MS ||
202
- String(DEFAULT_STATEMENT_TIMEOUT_MS), 10);
255
+ const statementTimeoutMs = resolveStatementTimeoutMs();
203
256
  return `${baseUrl}${separator}connection_limit=${poolSize}&pool_timeout=${Math.floor(poolTimeout / 1000)}&statement_timeout=${statementTimeoutMs}&idle_in_transaction_session_timeout=${statementTimeoutMs}`;
204
257
  }
205
258
  // Create a singleton that works in all environments
package/health.cjs CHANGED
@@ -1,11 +1,44 @@
1
1
  "use strict";
2
- var __importDefault = (this && this.__importDefault) || function (mod) {
3
- return (mod && mod.__esModule) ? mod : { "default": mod };
4
- };
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
5
35
  Object.defineProperty(exports, "__esModule", { value: true });
36
+ exports.HEALTH_PROBE_TIMEOUT_MS = exports.DB_SUCCESS_FRESHNESS_MS = void 0;
37
+ exports.warnIfStatementTimeoutDefeatsFreshness = warnIfStatementTimeoutDefeatsFreshness;
38
+ exports.checkDatabaseReadiness = checkDatabaseReadiness;
6
39
  exports.createHealthRouter = createHealthRouter;
7
40
  const express_1 = require("express");
8
- const prismaClient_1 = __importDefault(require("./prismaClient.cjs"));
41
+ const prismaClient_1 = __importStar(require("./prismaClient.cjs"));
9
42
  const logger_1 = require("./utils/logger.cjs");
10
43
  const SERVICE_NAME = 'backend-legacy';
11
44
  /**
@@ -24,6 +57,136 @@ function getPackageVersion() {
24
57
  const PACKAGE_VERSION = getPackageVersion();
25
58
  /** Tracks the process start time for uptime calculation */
26
59
  const startedAt = Date.now();
60
+ /**
61
+ * How recently a query must have completed for `/health` to accept it as
62
+ * proof the database is answering, without issuing a query of its own.
63
+ *
64
+ * Derived from the heartbeat rather than set by hand: it tolerates every
65
+ * heartbeat but the last before reconnection being missed, plus half an
66
+ * interval of slack — `(MAX_HEARTBEAT_FAILURES - 0.5) * HEARTBEAT_INTERVAL_MS`,
67
+ * 75s at the current 3 x 30s. That keeps it longer than one heartbeat interval,
68
+ * so an idle process that the heartbeat keeps refreshing never goes stale, and
69
+ * shorter than the reconnect point, so a database that has stopped answering
70
+ * reads as disconnected before the heartbeat gives up on the client.
71
+ *
72
+ * A saturated pool still completes queries, each bounded by the statement
73
+ * timeout, so saturation alone does not let it go stale — provided that
74
+ * timeout is shorter than this window (see
75
+ * {@link warnIfStatementTimeoutDefeatsFreshness}).
76
+ */
77
+ exports.DB_SUCCESS_FRESHNESS_MS = (prismaClient_1.MAX_HEARTBEAT_FAILURES - 0.5) * prismaClient_1.HEARTBEAT_INTERVAL_MS;
78
+ /**
79
+ * Warn when the configured statement timeout is not shorter than the
80
+ * freshness window.
81
+ *
82
+ * The case for trusting a recent success under saturation is that every query
83
+ * on a busy pool finishes or fails within the statement timeout, so completed
84
+ * queries keep arriving inside {@link DB_SUCCESS_FRESHNESS_MS}. A timeout at or
85
+ * above the window breaks that: a pool full of long-running statements can go
86
+ * a whole window without a completion and `/health` would fall back to a probe
87
+ * that cannot get a connection. A value that is not a positive integer (unset
88
+ * timeouts parse from the default; `0` disables the timeout in Postgres) is
89
+ * treated the same way, since it bounds nothing.
90
+ *
91
+ * @param statementTimeoutMs - The resolved statement timeout (injectable for tests).
92
+ * @returns True if a warning was logged.
93
+ */
94
+ function warnIfStatementTimeoutDefeatsFreshness(statementTimeoutMs = (0, prismaClient_1.resolveStatementTimeoutMs)()) {
95
+ if (Number.isFinite(statementTimeoutMs) &&
96
+ statementTimeoutMs > 0 &&
97
+ statementTimeoutMs < exports.DB_SUCCESS_FRESHNESS_MS) {
98
+ return false;
99
+ }
100
+ logger_1.logger.warn('DATABASE_STATEMENT_TIMEOUT_MS is not shorter than the /health freshness window — a saturated pool can read as disconnected', {
101
+ statementTimeoutMs,
102
+ freshnessWindowMs: exports.DB_SUCCESS_FRESHNESS_MS,
103
+ });
104
+ return true;
105
+ }
106
+ /**
107
+ * Budget for the fallback probe when no recent success exists. Well under the
108
+ * 10s pool wait so a saturated pool yields an answer inside the platform's
109
+ * probe timeout rather than hanging the request.
110
+ */
111
+ exports.HEALTH_PROBE_TIMEOUT_MS = 2000;
112
+ /** The one probe query this module may have outstanding on the pool. */
113
+ let outstandingProbe;
114
+ /**
115
+ * Probe the live client with `SELECT 1`, giving up after `timeoutMs`.
116
+ *
117
+ * Reads `global.prisma` rather than the module-level import, because the
118
+ * heartbeat's reconnect path replaces `global.prisma` and the import stays
119
+ * pinned to the original (by then disconnected) client.
120
+ *
121
+ * At most one probe query is ever outstanding: a caller that arrives while a
122
+ * previous probe is still queued on the pool waits on that same query instead
123
+ * of adding another waiter, so frequent health checks cannot themselves deepen
124
+ * a saturated pool's queue.
125
+ *
126
+ * @param timeoutMs - How long to wait for the probe before calling it failed.
127
+ * @returns True if the probe completed within the budget.
128
+ */
129
+ async function probeLiveClient(timeoutMs) {
130
+ var _a;
131
+ if (!outstandingProbe) {
132
+ const client = (_a = global.prisma) !== null && _a !== void 0 ? _a : prismaClient_1.default;
133
+ outstandingProbe = Promise.resolve(client.$queryRaw `SELECT 1`).finally(() => {
134
+ outstandingProbe = undefined;
135
+ });
136
+ }
137
+ const probe = outstandingProbe;
138
+ let timer;
139
+ const timedOut = new Promise((resolve) => {
140
+ timer = setTimeout(() => resolve(false), timeoutMs);
141
+ });
142
+ try {
143
+ return await Promise.race([
144
+ probe.then(() => true, (dbError) => {
145
+ logger_1.logger.warn('Health check: database probe failed', {
146
+ error: dbError instanceof Error ? dbError.message : String(dbError),
147
+ });
148
+ return false;
149
+ }),
150
+ timedOut,
151
+ ]);
152
+ }
153
+ finally {
154
+ clearTimeout(timer);
155
+ }
156
+ }
157
+ /**
158
+ * Decide whether the database is answering this process, without depending
159
+ * on a free pool connection when there is already evidence that it is.
160
+ *
161
+ * A query that completed within {@link DB_SUCCESS_FRESHNESS_MS} is taken as
162
+ * that evidence and no query is issued. Only when there is none (startup, or a
163
+ * database that has stopped answering) does it fall back to a bounded probe.
164
+ *
165
+ * @param now - Current epoch ms (injectable for tests).
166
+ * @returns The database status, how it was decided, and the success age.
167
+ */
168
+ async function checkDatabaseReadiness(now = Date.now()) {
169
+ const lastSuccess = (0, prismaClient_1.getLastQuerySucceededAt)();
170
+ const ageMs = lastSuccess === undefined ? undefined : now - lastSuccess;
171
+ if (ageMs !== undefined && ageMs <= exports.DB_SUCCESS_FRESHNESS_MS) {
172
+ return {
173
+ database: 'connected',
174
+ databaseCheck: 'recent-query',
175
+ lastQuerySucceededSecondsAgo: Math.max(0, Math.floor(ageMs / 1000)),
176
+ };
177
+ }
178
+ const answered = await probeLiveClient(exports.HEALTH_PROBE_TIMEOUT_MS);
179
+ // A successful probe goes through the same client extension and refreshes
180
+ // the stamp; report the age as it stands after the probe.
181
+ const after = (0, prismaClient_1.getLastQuerySucceededAt)();
182
+ return {
183
+ database: answered ? 'connected' : 'disconnected',
184
+ databaseCheck: 'probe',
185
+ lastQuerySucceededSecondsAgo: after === undefined
186
+ ? null
187
+ : Math.max(0, Math.floor((Date.now() - after) / 1000)),
188
+ };
189
+ }
27
190
  /**
28
191
  * Checks database connectivity by issuing a lightweight query.
29
192
  * Returns 'connected' or 'disconnected'. Never throws.
@@ -50,13 +213,18 @@ async function checkDatabase() {
50
213
  * is reachable (`SELECT 1`), HTTP 503 otherwise. Suitable for Cloud Run
51
214
  * startup probes and load-balancer readiness.
52
215
  * - `GET /health` — Full health snapshot including memory usage and database
53
- * status. Returns 503 when the database is unreachable. Kept for
54
- * backward compatibility with existing Railway/uptime checks.
216
+ * status. Returns 503 only when the database has stopped answering this
217
+ * process: a query that completed within the freshness window counts as
218
+ * proof without taking a pool connection, so a saturated-but-working pool
219
+ * reads as healthy. With no recent success it falls back to a bounded
220
+ * probe (see {@link checkDatabaseReadiness}). Kept for backward
221
+ * compatibility with existing Railway/uptime checks.
55
222
  *
56
223
  * All endpoints should be mounted before auth middleware so they remain
57
224
  * accessible without authentication.
58
225
  */
59
226
  function createHealthRouter() {
227
+ warnIfStatementTimeoutDefeatsFreshness();
60
228
  const router = (0, express_1.Router)();
61
229
  router.get('/livez', (_req, res) => {
62
230
  res.status(200).json({
@@ -79,7 +247,8 @@ function createHealthRouter() {
79
247
  });
80
248
  });
81
249
  router.get('/health', async (_req, res) => {
82
- const databaseStatus = await checkDatabase();
250
+ const readiness = await checkDatabaseReadiness();
251
+ const databaseStatus = readiness.database;
83
252
  const isHealthy = databaseStatus === 'connected';
84
253
  const statusCode = isHealthy ? 200 : 503;
85
254
  const memoryUsage = process.memoryUsage();
@@ -95,6 +264,8 @@ function createHealthRouter() {
95
264
  heapTotal: Math.round(memoryUsage.heapTotal / 1024 / 1024),
96
265
  },
97
266
  database: databaseStatus,
267
+ databaseCheck: readiness.databaseCheck,
268
+ lastQuerySucceededSecondsAgo: readiness.lastQuerySucceededSecondsAgo,
98
269
  };
99
270
  res.status(statusCode).json(body);
100
271
  });
package/health.d.ts CHANGED
@@ -1,4 +1,62 @@
1
1
  import { Router } from 'express';
2
+ type DatabaseCheck = 'recent-query' | 'probe';
3
+ /**
4
+ * How recently a query must have completed for `/health` to accept it as
5
+ * proof the database is answering, without issuing a query of its own.
6
+ *
7
+ * Derived from the heartbeat rather than set by hand: it tolerates every
8
+ * heartbeat but the last before reconnection being missed, plus half an
9
+ * interval of slack — `(MAX_HEARTBEAT_FAILURES - 0.5) * HEARTBEAT_INTERVAL_MS`,
10
+ * 75s at the current 3 x 30s. That keeps it longer than one heartbeat interval,
11
+ * so an idle process that the heartbeat keeps refreshing never goes stale, and
12
+ * shorter than the reconnect point, so a database that has stopped answering
13
+ * reads as disconnected before the heartbeat gives up on the client.
14
+ *
15
+ * A saturated pool still completes queries, each bounded by the statement
16
+ * timeout, so saturation alone does not let it go stale — provided that
17
+ * timeout is shorter than this window (see
18
+ * {@link warnIfStatementTimeoutDefeatsFreshness}).
19
+ */
20
+ export declare const DB_SUCCESS_FRESHNESS_MS: number;
21
+ /**
22
+ * Warn when the configured statement timeout is not shorter than the
23
+ * freshness window.
24
+ *
25
+ * The case for trusting a recent success under saturation is that every query
26
+ * on a busy pool finishes or fails within the statement timeout, so completed
27
+ * queries keep arriving inside {@link DB_SUCCESS_FRESHNESS_MS}. A timeout at or
28
+ * above the window breaks that: a pool full of long-running statements can go
29
+ * a whole window without a completion and `/health` would fall back to a probe
30
+ * that cannot get a connection. A value that is not a positive integer (unset
31
+ * timeouts parse from the default; `0` disables the timeout in Postgres) is
32
+ * treated the same way, since it bounds nothing.
33
+ *
34
+ * @param statementTimeoutMs - The resolved statement timeout (injectable for tests).
35
+ * @returns True if a warning was logged.
36
+ */
37
+ export declare function warnIfStatementTimeoutDefeatsFreshness(statementTimeoutMs?: number): boolean;
38
+ /**
39
+ * Budget for the fallback probe when no recent success exists. Well under the
40
+ * 10s pool wait so a saturated pool yields an answer inside the platform's
41
+ * probe timeout rather than hanging the request.
42
+ */
43
+ export declare const HEALTH_PROBE_TIMEOUT_MS = 2000;
44
+ /**
45
+ * Decide whether the database is answering this process, without depending
46
+ * on a free pool connection when there is already evidence that it is.
47
+ *
48
+ * A query that completed within {@link DB_SUCCESS_FRESHNESS_MS} is taken as
49
+ * that evidence and no query is issued. Only when there is none (startup, or a
50
+ * database that has stopped answering) does it fall back to a bounded probe.
51
+ *
52
+ * @param now - Current epoch ms (injectable for tests).
53
+ * @returns The database status, how it was decided, and the success age.
54
+ */
55
+ export declare function checkDatabaseReadiness(now?: number): Promise<{
56
+ database: 'connected' | 'disconnected';
57
+ databaseCheck: DatabaseCheck;
58
+ lastQuerySucceededSecondsAgo: number | null;
59
+ }>;
2
60
  /**
3
61
  * Creates an Express router with health-probe endpoints.
4
62
  *
@@ -9,11 +67,16 @@ import { Router } from 'express';
9
67
  * is reachable (`SELECT 1`), HTTP 503 otherwise. Suitable for Cloud Run
10
68
  * startup probes and load-balancer readiness.
11
69
  * - `GET /health` — Full health snapshot including memory usage and database
12
- * status. Returns 503 when the database is unreachable. Kept for
13
- * backward compatibility with existing Railway/uptime checks.
70
+ * status. Returns 503 only when the database has stopped answering this
71
+ * process: a query that completed within the freshness window counts as
72
+ * proof without taking a pool connection, so a saturated-but-working pool
73
+ * reads as healthy. With no recent success it falls back to a bounded
74
+ * probe (see {@link checkDatabaseReadiness}). Kept for backward
75
+ * compatibility with existing Railway/uptime checks.
14
76
  *
15
77
  * All endpoints should be mounted before auth middleware so they remain
16
78
  * accessible without authentication.
17
79
  */
18
80
  export declare function createHealthRouter(): Router;
81
+ export {};
19
82
  //# sourceMappingURL=health.d.ts.map
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@adaptic/backend",
3
- "version": "0.0.1041",
3
+ "version": "0.0.1043",
4
4
  "description": "Backend executable CRUD functions with dynamic variables construction, and type definitions for the Adaptic AI platform.",
5
5
  "type": "module",
6
6
  "types": "index.d.ts",
package/prismaClient.cjs CHANGED
@@ -1,8 +1,11 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.DEFAULT_FIND_MANY_TAKE = void 0;
3
+ exports.MAX_HEARTBEAT_FAILURES = exports.HEARTBEAT_INTERVAL_MS = exports.DEFAULT_STATEMENT_TIMEOUT_MS = exports.DEFAULT_FIND_MANY_TAKE = void 0;
4
4
  exports.resolveFindManyTake = resolveFindManyTake;
5
+ exports.getLastQuerySucceededAt = getLastQuerySucceededAt;
6
+ exports.stampQuerySuccess = stampQuerySuccess;
5
7
  exports.withFindManyGuard = withFindManyGuard;
8
+ exports.resolveStatementTimeoutMs = resolveStatementTimeoutMs;
6
9
  exports.startConnectionHealthMonitor = startConnectionHealthMonitor;
7
10
  exports.stopConnectionHealthMonitor = stopConnectionHealthMonitor;
8
11
  exports.disconnectWithTimeout = disconnectWithTimeout;
@@ -50,6 +53,36 @@ function resolveFindManyTake() {
50
53
  }
51
54
  return parsed;
52
55
  }
56
+ /** Wall-clock ms of the most recent query that completed successfully, or undefined before the first. */
57
+ let lastQuerySucceededAt;
58
+ /**
59
+ * When a query on this process's Prisma client last completed successfully.
60
+ *
61
+ * This is the evidence `/health` uses for "the database is answering this
62
+ * process". It is recorded as a side effect of ordinary traffic and of the
63
+ * heartbeat, so reading it never needs a pool connection — which is the point:
64
+ * a pool that is saturated but still completing work keeps this fresh, and a
65
+ * database that has stopped answering lets it go stale.
66
+ *
67
+ * @returns Epoch milliseconds of the last success, or undefined if none yet.
68
+ */
69
+ function getLastQuerySucceededAt() {
70
+ return lastQuerySucceededAt;
71
+ }
72
+ /**
73
+ * Run a query and stamp the success time if it resolves.
74
+ *
75
+ * A rejected query leaves the stamp alone; any completed round trip, including
76
+ * one issued by a caller that has since given up waiting on it, refreshes it.
77
+ *
78
+ * @param run - Executes the underlying operation.
79
+ * @returns Whatever the operation returned.
80
+ */
81
+ async function stampQuerySuccess(run) {
82
+ const result = await run();
83
+ lastQuerySucceededAt = Date.now();
84
+ return result;
85
+ }
53
86
  /**
54
87
  * Apply the unqualified-`findMany` ceiling to a Prisma client.
55
88
  *
@@ -69,7 +102,18 @@ function resolveFindManyTake() {
69
102
  */
70
103
  function withFindManyGuard(client) {
71
104
  const ceiling = resolveFindManyTake();
72
- const extended = client.$extends({
105
+ // The success stamp rides this wrapper because it is the one applied at both
106
+ // client assignment sites (initial and reconnect), so the stamp survives a
107
+ // reconnect without the reconnect path having to know about it.
108
+ const stamped = client.$extends({
109
+ name: 'query-success-stamp',
110
+ query: {
111
+ async $allOperations({ args, query }) {
112
+ return stampQuerySuccess(() => query(args));
113
+ },
114
+ },
115
+ });
116
+ const extended = stamped.$extends({
73
117
  name: 'find-many-ceiling',
74
118
  query: {
75
119
  $allModels: {
@@ -93,11 +137,24 @@ function withFindManyGuard(client) {
93
137
  return extended;
94
138
  }
95
139
  /** Default statement timeout (30s) prevents hung queries from blocking pool slots indefinitely */
96
- const DEFAULT_STATEMENT_TIMEOUT_MS = 30000;
140
+ exports.DEFAULT_STATEMENT_TIMEOUT_MS = 30000;
97
141
  /** Heartbeat interval: how often we verify the DB connection is alive */
98
- const HEARTBEAT_INTERVAL_MS = 30000;
142
+ exports.HEARTBEAT_INTERVAL_MS = 30000;
99
143
  /** Consecutive heartbeat failures before triggering client reconnection */
100
- const MAX_HEARTBEAT_FAILURES = 3;
144
+ exports.MAX_HEARTBEAT_FAILURES = 3;
145
+ /**
146
+ * Resolve the per-statement timeout appended to a direct Postgres URL.
147
+ *
148
+ * Parsed exactly as the URL builder has always parsed it, so a value that is
149
+ * not a positive integer comes back as-is (NaN, 0, negative) for the caller to
150
+ * judge rather than being silently replaced.
151
+ *
152
+ * @returns The statement timeout in milliseconds.
153
+ */
154
+ function resolveStatementTimeoutMs() {
155
+ return parseInt(process.env.DATABASE_STATEMENT_TIMEOUT_MS ||
156
+ String(exports.DEFAULT_STATEMENT_TIMEOUT_MS), 10);
157
+ }
101
158
  /** Heartbeat query timeout (5s) — shorter than pool timeout to detect issues early */
102
159
  const HEARTBEAT_TIMEOUT_MS = 5000;
103
160
  /**
@@ -206,8 +263,7 @@ function buildDatabaseUrl() {
206
263
  poolTimeoutMs: poolTimeout,
207
264
  environment: process.env.NODE_ENV || 'development',
208
265
  });
209
- const statementTimeoutMs = parseInt(process.env.DATABASE_STATEMENT_TIMEOUT_MS ||
210
- String(DEFAULT_STATEMENT_TIMEOUT_MS), 10);
266
+ const statementTimeoutMs = resolveStatementTimeoutMs();
211
267
  return `${baseUrl}${separator}connection_limit=${poolSize}&pool_timeout=${Math.floor(poolTimeout / 1000)}&statement_timeout=${statementTimeoutMs}&idle_in_transaction_session_timeout=${statementTimeoutMs}`;
212
268
  }
213
269
  // Create a singleton that works in all environments
@@ -347,7 +403,7 @@ async function heartbeat() {
347
403
  consecutiveFailures: heartbeatFailures,
348
404
  error: errorMessage,
349
405
  });
350
- if (heartbeatFailures >= MAX_HEARTBEAT_FAILURES) {
406
+ if (heartbeatFailures >= exports.MAX_HEARTBEAT_FAILURES) {
351
407
  logger_1.logger.error('Database heartbeat exceeded failure threshold, reconnecting Prisma client', {
352
408
  consecutiveFailures: heartbeatFailures,
353
409
  });
@@ -417,12 +473,12 @@ function startConnectionHealthMonitor() {
417
473
  if (heartbeatTimer)
418
474
  return () => stopConnectionHealthMonitor();
419
475
  logger_1.logger.info('Starting database connection health monitor', {
420
- intervalMs: HEARTBEAT_INTERVAL_MS,
421
- failureThreshold: MAX_HEARTBEAT_FAILURES,
476
+ intervalMs: exports.HEARTBEAT_INTERVAL_MS,
477
+ failureThreshold: exports.MAX_HEARTBEAT_FAILURES,
422
478
  });
423
479
  heartbeatTimer = setInterval(() => {
424
480
  void heartbeat();
425
- }, HEARTBEAT_INTERVAL_MS);
481
+ }, exports.HEARTBEAT_INTERVAL_MS);
426
482
  // Run an initial heartbeat immediately
427
483
  void heartbeat();
428
484
  return () => stopConnectionHealthMonitor();
package/prismaClient.d.ts CHANGED
@@ -29,6 +29,28 @@ export declare const DEFAULT_FIND_MANY_TAKE = 50000;
29
29
  * @returns The row ceiling to apply to an unqualified `findMany`.
30
30
  */
31
31
  export declare function resolveFindManyTake(): number;
32
+ /**
33
+ * When a query on this process's Prisma client last completed successfully.
34
+ *
35
+ * This is the evidence `/health` uses for "the database is answering this
36
+ * process". It is recorded as a side effect of ordinary traffic and of the
37
+ * heartbeat, so reading it never needs a pool connection — which is the point:
38
+ * a pool that is saturated but still completing work keeps this fresh, and a
39
+ * database that has stopped answering lets it go stale.
40
+ *
41
+ * @returns Epoch milliseconds of the last success, or undefined if none yet.
42
+ */
43
+ export declare function getLastQuerySucceededAt(): number | undefined;
44
+ /**
45
+ * Run a query and stamp the success time if it resolves.
46
+ *
47
+ * A rejected query leaves the stamp alone; any completed round trip, including
48
+ * one issued by a caller that has since given up waiting on it, refreshes it.
49
+ *
50
+ * @param run - Executes the underlying operation.
51
+ * @returns Whatever the operation returned.
52
+ */
53
+ export declare function stampQuerySuccess<T>(run: () => Promise<T>): Promise<T>;
32
54
  /**
33
55
  * Apply the unqualified-`findMany` ceiling to a Prisma client.
34
56
  *
@@ -47,6 +69,22 @@ export declare function resolveFindManyTake(): number;
47
69
  * @returns The client with the ceiling applied.
48
70
  */
49
71
  export declare function withFindManyGuard(client: PrismaClient): PrismaClient;
72
+ /** Default statement timeout (30s) prevents hung queries from blocking pool slots indefinitely */
73
+ export declare const DEFAULT_STATEMENT_TIMEOUT_MS = 30000;
74
+ /** Heartbeat interval: how often we verify the DB connection is alive */
75
+ export declare const HEARTBEAT_INTERVAL_MS = 30000;
76
+ /** Consecutive heartbeat failures before triggering client reconnection */
77
+ export declare const MAX_HEARTBEAT_FAILURES = 3;
78
+ /**
79
+ * Resolve the per-statement timeout appended to a direct Postgres URL.
80
+ *
81
+ * Parsed exactly as the URL builder has always parsed it, so a value that is
82
+ * not a positive integer comes back as-is (NaN, 0, negative) for the caller to
83
+ * judge rather than being silently replaced.
84
+ *
85
+ * @returns The statement timeout in milliseconds.
86
+ */
87
+ export declare function resolveStatementTimeoutMs(): number;
50
88
  declare const prisma: PrismaClient;
51
89
  /**
52
90
  * Starts the periodic database heartbeat monitor.