@adaptic/backend-legacy 0.0.1018 → 0.0.1020

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.
@@ -33,12 +33,31 @@ type EnhanceModelName = keyof ResolversEnhanceMap;
33
33
  * every generated query and mutation on these models invokes the authChecker.
34
34
  */
35
35
  export declare const IR_MODELS: readonly EnhanceModelName[];
36
+ /**
37
+ * Models whose READ actions are decorated as well as their deletes.
38
+ *
39
+ * These three answer to anyone today. A read-only probe of the deployed API
40
+ * with no Authorization header returns a real organisation name, a real user's
41
+ * email address, and a real membership row, so the standing escalation is not
42
+ * theoretical. They were outside the checker entirely: `_all` covers the five
43
+ * investor-relations models, everything else got delete coverage only, and a
44
+ * query the checker never runs for is a query it cannot even count.
45
+ *
46
+ * Decorating them changes NO behaviour while the checker is in shadow — a
47
+ * would-deny is logged and counted and then allowed. What it changes is that
48
+ * the exposure becomes measurable. Enforcement cannot be argued from a
49
+ * would-deny ratio that reflects only surfaces nobody ever authenticated to,
50
+ * and the measurement has to exist before the decision does.
51
+ */
52
+ export declare const TENANT_SCOPED_READ_MODELS: readonly EnhanceModelName[];
36
53
  /** Summary of the coverage applied, for the boot log and tests. */
37
54
  export interface AuthorizationMapSummary {
38
55
  /** Models decorated with `_all` (full CRUD coverage). */
39
56
  readonly fullCoverageModels: number;
40
57
  /** Models whose delete mutations were decorated. */
41
58
  readonly deleteCoverageModels: number;
59
+ /** Models whose READ actions were decorated as well ({@link TENANT_SCOPED_READ_MODELS}). */
60
+ readonly readCoverageModels: number;
42
61
  /** Total decorated resolver actions (delete actions + `_all` markers). */
43
62
  readonly decoratedActions: number;
44
63
  /**
@@ -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,mEAAmE;AACnE,MAAM,WAAW,uBAAuB;IACtC,yDAAyD;IACzD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,oDAAoD;IACpD,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,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,CA8CnE;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;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,gBAAgB,EAIhE,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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"}
@@ -41,6 +41,61 @@ export const IR_MODELS = [
41
41
  'InvestorDocument',
42
42
  'TaxDocument',
43
43
  ];
44
+ /**
45
+ * Models whose READ actions are decorated as well as their deletes.
46
+ *
47
+ * These three answer to anyone today. A read-only probe of the deployed API
48
+ * with no Authorization header returns a real organisation name, a real user's
49
+ * email address, and a real membership row, so the standing escalation is not
50
+ * theoretical. They were outside the checker entirely: `_all` covers the five
51
+ * investor-relations models, everything else got delete coverage only, and a
52
+ * query the checker never runs for is a query it cannot even count.
53
+ *
54
+ * Decorating them changes NO behaviour while the checker is in shadow — a
55
+ * would-deny is logged and counted and then allowed. What it changes is that
56
+ * the exposure becomes measurable. Enforcement cannot be argued from a
57
+ * would-deny ratio that reflects only surfaces nobody ever authenticated to,
58
+ * and the measurement has to exist before the decision does.
59
+ */
60
+ export const TENANT_SCOPED_READ_MODELS = [
61
+ 'Organization',
62
+ 'OrgMembership',
63
+ 'User',
64
+ ];
65
+ /**
66
+ * Action-name prefixes that MUTATE. Everything else on a generated CRUD
67
+ * resolver reads.
68
+ *
69
+ * Read actions are derived by exclusion rather than listed, because the
70
+ * generator names them inconsistently — `organizations`, `organization`,
71
+ * `getOrganization`, `findFirstOrganization`, `aggregateOrganization`,
72
+ * `groupByOrganization` are all reads of one model. Enumerating them by hand is
73
+ * how a read gets missed silently; excluding the four mutation shapes cannot.
74
+ */
75
+ const MUTATION_PREFIXES = [
76
+ 'create',
77
+ 'update',
78
+ 'delete',
79
+ 'upsert',
80
+ ];
81
+ /**
82
+ * The read actions a model's generated CRUD resolver actually exposes.
83
+ *
84
+ * Derived from the real prototype, so a generator rename shows up as a smaller
85
+ * set rather than as silently absent coverage.
86
+ */
87
+ function readActionsOf(model) {
88
+ const prototype = crudResolverPrototype(model);
89
+ if (!prototype)
90
+ return [];
91
+ return Object.getOwnPropertyNames(prototype).filter((name) => {
92
+ if (name === 'constructor')
93
+ return false;
94
+ if (typeof prototype[name] !== 'function')
95
+ return false;
96
+ return !MUTATION_PREFIXES.some((prefix) => name.startsWith(prefix));
97
+ });
98
+ }
44
99
  /**
45
100
  * Looks up the generated `<Model>CrudResolver` class for a model, so delete
46
101
  * action names can be validated against the real resolver surface instead of
@@ -68,6 +123,24 @@ export function buildCortexAuthorizationMap() {
68
123
  map[model] = { _all: [Authorized()] };
69
124
  decoratedActions += 1;
70
125
  }
126
+ // Read coverage for the tenant-scoped models, applied BEFORE the delete pass
127
+ // so the two merge into one action config rather than overwriting it.
128
+ const readActionsByModel = new Map();
129
+ let readCoverageModels = 0;
130
+ for (const model of TENANT_SCOPED_READ_MODELS) {
131
+ const actions = readActionsOf(model);
132
+ if (actions.length === 0) {
133
+ skippedActions.push(`${model}:reads`);
134
+ continue;
135
+ }
136
+ const config = {};
137
+ for (const action of actions) {
138
+ config[action] = [Authorized()];
139
+ }
140
+ readActionsByModel.set(model, config);
141
+ decoratedActions += actions.length;
142
+ readCoverageModels += 1;
143
+ }
71
144
  const irModelSet = new Set(IR_MODELS);
72
145
  for (const model of Object.values(Prisma.ModelName)) {
73
146
  // IR models already have full coverage; decorating deletes again would
@@ -76,7 +149,9 @@ export function buildCortexAuthorizationMap() {
76
149
  continue;
77
150
  }
78
151
  const prototype = crudResolverPrototype(model);
79
- const actionsConfig = {};
152
+ const actionsConfig = {
153
+ ...(readActionsByModel.get(model) ?? {}),
154
+ };
80
155
  let coveredForModel = 0;
81
156
  for (const action of [`deleteOne${model}`, `deleteMany${model}`]) {
82
157
  if (prototype && typeof prototype[action] === 'function') {
@@ -87,7 +162,7 @@ export function buildCortexAuthorizationMap() {
87
162
  skippedActions.push(action);
88
163
  }
89
164
  }
90
- if (coveredForModel > 0) {
165
+ if (coveredForModel > 0 || Object.keys(actionsConfig).length > 0) {
91
166
  map[model] =
92
167
  actionsConfig;
93
168
  decoratedActions += coveredForModel;
@@ -99,6 +174,7 @@ export function buildCortexAuthorizationMap() {
99
174
  summary: {
100
175
  fullCoverageModels: IR_MODELS.length,
101
176
  deleteCoverageModels,
177
+ readCoverageModels,
102
178
  decoratedActions,
103
179
  skippedActions,
104
180
  },
@@ -44,6 +44,32 @@ export declare const tenancyScopingDecisionsTotal: Counter<"mode" | "operation"
44
44
  * @returns true if metrics were initialized, false if disabled
45
45
  */
46
46
  export declare function initMetrics(): boolean;
47
+ /**
48
+ * The label used for a request that matched no route.
49
+ *
50
+ * One bucket, not the path that was asked for.
51
+ */
52
+ export declare const UNMATCHED_ROUTE_LABEL = "unmatched";
53
+ /**
54
+ * The bounded route label for a request.
55
+ *
56
+ * `req.route.path` is the Express route PATTERN, so its value set is bounded by
57
+ * this application's own routing table. `req.path` is not bounded by anything —
58
+ * it is whatever the client asked for. Falling back from the first to the second
59
+ * turns a metric label into an attack surface: every unmatched path a scanner
60
+ * probes becomes a new permanent time series, and the registry grows without
61
+ * limit at the caller's discretion. Production carried 679 distinct values, 130
62
+ * of them probes such as `/wp-config.php` and
63
+ * `/@fs/proc/self/cwd/.config/gcloud/application_default_credentials.json`.
64
+ *
65
+ * A request that matched no route is therefore recorded as a single bucket. The
66
+ * request is still counted, with its method and status; what is discarded is the
67
+ * attacker's choice of string.
68
+ *
69
+ * @param req - The request being recorded.
70
+ * @returns The matched route pattern, or {@link UNMATCHED_ROUTE_LABEL}.
71
+ */
72
+ export declare function routeLabel(req: Pick<Request, 'route'>): string;
47
73
  /**
48
74
  * Express middleware that records HTTP request metrics.
49
75
  * Tracks request count and duration for each method/route/status combination.
@@ -84,13 +110,19 @@ export declare function createMetricsPlugin(): {
84
110
  }>;
85
111
  };
86
112
  /**
87
- * Creates an Express router that exposes Prometheus metrics at GET /metrics.
113
+ * Whether an `Authorization` header may read the scrape.
114
+ *
115
+ * Returns true when no token is configured, which is the state every existing
116
+ * deployment is in: the gate is inert until an operator sets one, so shipping it
117
+ * breaks no scraper and closing the endpoint stays an operator decision.
88
118
  *
89
- * The endpoint returns metrics in Prometheus text exposition format.
90
- * This should be scraped by a Prometheus server at regular intervals.
119
+ * The comparison is constant-time so a wrong token cannot be discovered a byte
120
+ * at a time from response timing. A length mismatch short-circuits, which is
121
+ * correct — the length is not the secret, the bytes are.
91
122
  *
92
- * Note: This endpoint should be protected in production (e.g., by firewall rules
93
- * or by requiring a bearer token). It is excluded from rate limiting by default.
123
+ * @param authorization - The request's `Authorization` header, if any.
124
+ * @param expected - The configured token, or `null` when none is configured.
94
125
  */
126
+ export declare function scrapeAuthorized(authorization: string | undefined, expected: string | null): boolean;
95
127
  export declare function createMetricsRouter(): Router;
96
128
  //# sourceMappingURL=metrics.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/config/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EACL,QAAQ,EACR,OAAO,EACP,SAAS,EACT,KAAK,EAEN,MAAM,aAAa,CAAC;AAKrB;;;;GAIG;AACH,eAAO,MAAM,eAAe,sDAAiB,CAAC;AAO9C,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,6CAK5B,CAAC;AAEH,qDAAqD;AACrD,eAAO,MAAM,mBAAmB,+CAM9B,CAAC;AAEH,uDAAuD;AACvD,eAAO,MAAM,sBAAsB,yDAKjC,CAAC;AAEH,0DAA0D;AAC1D,eAAO,MAAM,wBAAwB,gDAMnC,CAAC;AAEH,wDAAwD;AACxD,eAAO,MAAM,kBAAkB,6DAK7B,CAAC;AAMH,qDAAqD;AACrD,eAAO,MAAM,eAAe,kCAM1B,CAAC;AAEH,4CAA4C;AAC5C,eAAO,MAAM,mBAAmB,eAI9B,CAAC;AAMH,6CAA6C;AAC7C,eAAO,MAAM,mBAAmB,eAI9B,CAAC;AAEH,6CAA6C;AAC7C,eAAO,MAAM,0BAA0B,eAIrC,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,sDAKvC,CAAC;AAiCH;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAoBrC;AAMD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,MAAM,IAAI,GACf,IAAI,CAuBN;AAMD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,IAAI;IACrC,eAAe,EAAE,MAAM,OAAO,CAAC;QAC7B,gBAAgB,EAAE,CAAC,cAAc,EAAE;YACjC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YAC9B,SAAS,CAAC,EAAE;gBAAE,SAAS,EAAE,MAAM,CAAA;aAAE,GAAG,IAAI,CAAC;YACzC,QAAQ,EAAE;gBACR,IAAI,EAAE;oBACJ,IAAI,EAAE,MAAM,CAAC;oBACb,YAAY,CAAC,EAAE;wBACb,MAAM,CAAC,EAAE,aAAa,CAAC;4BAAE,UAAU,CAAC,EAAE;gCAAE,IAAI,CAAC,EAAE,MAAM,CAAA;6BAAE,CAAA;yBAAE,CAAC,CAAC;qBAC5D,CAAC;iBACH,CAAC;aACH,CAAC;SACH,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KACrB,CAAC,CAAC;CACJ,CAuDA;AAMD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAuB5C"}
1
+ {"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/config/metrics.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EACL,QAAQ,EACR,OAAO,EACP,SAAS,EACT,KAAK,EAEN,MAAM,aAAa,CAAC;AAKrB;;;;GAIG;AACH,eAAO,MAAM,eAAe,sDAAiB,CAAC;AAO9C,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,6CAK5B,CAAC;AAEH,qDAAqD;AACrD,eAAO,MAAM,mBAAmB,+CAM9B,CAAC;AAEH,uDAAuD;AACvD,eAAO,MAAM,sBAAsB,yDAKjC,CAAC;AAEH,0DAA0D;AAC1D,eAAO,MAAM,wBAAwB,gDAMnC,CAAC;AAEH,wDAAwD;AACxD,eAAO,MAAM,kBAAkB,6DAK7B,CAAC;AAMH,qDAAqD;AACrD,eAAO,MAAM,eAAe,kCAM1B,CAAC;AAEH,4CAA4C;AAC5C,eAAO,MAAM,mBAAmB,eAI9B,CAAC;AAMH,6CAA6C;AAC7C,eAAO,MAAM,mBAAmB,eAI9B,CAAC;AAEH,6CAA6C;AAC7C,eAAO,MAAM,0BAA0B,eAIrC,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,sDAKvC,CAAC;AAiCH;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAoBrC;AAMD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,cAAc,CAAC;AAEjD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,MAAM,CAK9D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,MAAM,IAAI,GACf,IAAI,CAuBN;AAMD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,IAAI;IACrC,eAAe,EAAE,MAAM,OAAO,CAAC;QAC7B,gBAAgB,EAAE,CAAC,cAAc,EAAE;YACjC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YAC9B,SAAS,CAAC,EAAE;gBAAE,SAAS,EAAE,MAAM,CAAA;aAAE,GAAG,IAAI,CAAC;YACzC,QAAQ,EAAE;gBACR,IAAI,EAAE;oBACJ,IAAI,EAAE,MAAM,CAAC;oBACb,YAAY,CAAC,EAAE;wBACb,MAAM,CAAC,EAAE,aAAa,CAAC;4BAAE,UAAU,CAAC,EAAE;gCAAE,IAAI,CAAC,EAAE,MAAM,CAAA;6BAAE,CAAA;yBAAE,CAAC,CAAC;qBAC5D,CAAC;iBACH,CAAC;aACH,CAAC;SACH,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KACrB,CAAC,CAAC;CACJ,CAuDA;AA0BD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,QAAQ,EAAE,MAAM,GAAG,IAAI,GACtB,OAAO,CAOT;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAqC5C"}
@@ -1 +1 @@
1
- {"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../src/config/metrics.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../src/config/metrics.ts"],"names":[],"mappings":"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"}
@@ -1,3 +1,4 @@
1
+ import { timingSafeEqual } from 'node:crypto';
1
2
  import { Router } from 'express';
2
3
  import { Registry, Counter, Histogram, Gauge, collectDefaultMetrics, } from 'prom-client';
3
4
  import { logger } from '../utils/logger.mjs';
@@ -151,6 +152,37 @@ export function initMetrics() {
151
152
  // ---------------------------------------------------------------------------
152
153
  // Express middleware
153
154
  // ---------------------------------------------------------------------------
155
+ /**
156
+ * The label used for a request that matched no route.
157
+ *
158
+ * One bucket, not the path that was asked for.
159
+ */
160
+ export const UNMATCHED_ROUTE_LABEL = 'unmatched';
161
+ /**
162
+ * The bounded route label for a request.
163
+ *
164
+ * `req.route.path` is the Express route PATTERN, so its value set is bounded by
165
+ * this application's own routing table. `req.path` is not bounded by anything —
166
+ * it is whatever the client asked for. Falling back from the first to the second
167
+ * turns a metric label into an attack surface: every unmatched path a scanner
168
+ * probes becomes a new permanent time series, and the registry grows without
169
+ * limit at the caller's discretion. Production carried 679 distinct values, 130
170
+ * of them probes such as `/wp-config.php` and
171
+ * `/@fs/proc/self/cwd/.config/gcloud/application_default_credentials.json`.
172
+ *
173
+ * A request that matched no route is therefore recorded as a single bucket. The
174
+ * request is still counted, with its method and status; what is discarded is the
175
+ * attacker's choice of string.
176
+ *
177
+ * @param req - The request being recorded.
178
+ * @returns The matched route pattern, or {@link UNMATCHED_ROUTE_LABEL}.
179
+ */
180
+ export function routeLabel(req) {
181
+ const matched = req.route?.path;
182
+ return typeof matched === 'string' && matched.length > 0
183
+ ? matched
184
+ : UNMATCHED_ROUTE_LABEL;
185
+ }
154
186
  /**
155
187
  * Express middleware that records HTTP request metrics.
156
188
  * Tracks request count and duration for each method/route/status combination.
@@ -166,7 +198,7 @@ export function metricsMiddleware(req, res, next) {
166
198
  res.on('finish', () => {
167
199
  const durationNs = Number(process.hrtime.bigint() - start);
168
200
  const durationSeconds = durationNs / 1e9;
169
- const route = req.route?.path || req.path || 'unknown';
201
+ const route = routeLabel(req);
170
202
  const method = req.method;
171
203
  const statusCode = String(res.statusCode);
172
204
  httpRequestsTotal.inc({ method, route, status_code: statusCode });
@@ -243,9 +275,57 @@ export function createMetricsPlugin() {
243
275
  * Note: This endpoint should be protected in production (e.g., by firewall rules
244
276
  * or by requiring a bearer token). It is excluded from rate limiting by default.
245
277
  */
278
+ /**
279
+ * Whether the scrape endpoint requires a bearer token, and which one.
280
+ *
281
+ * Read per request rather than captured at boot so the switch can be turned on
282
+ * without a restart.
283
+ */
284
+ function metricsScrapeToken() {
285
+ const token = process.env.METRICS_SCRAPE_TOKEN;
286
+ return typeof token === 'string' && token.length > 0 ? token : null;
287
+ }
288
+ /**
289
+ * Whether an `Authorization` header may read the scrape.
290
+ *
291
+ * Returns true when no token is configured, which is the state every existing
292
+ * deployment is in: the gate is inert until an operator sets one, so shipping it
293
+ * breaks no scraper and closing the endpoint stays an operator decision.
294
+ *
295
+ * The comparison is constant-time so a wrong token cannot be discovered a byte
296
+ * at a time from response timing. A length mismatch short-circuits, which is
297
+ * correct — the length is not the secret, the bytes are.
298
+ *
299
+ * @param authorization - The request's `Authorization` header, if any.
300
+ * @param expected - The configured token, or `null` when none is configured.
301
+ */
302
+ export function scrapeAuthorized(authorization, expected) {
303
+ if (expected === null)
304
+ return true;
305
+ const header = authorization ?? '';
306
+ if (!header.startsWith('Bearer '))
307
+ return false;
308
+ const presented = Buffer.from(header.slice(7), 'utf8');
309
+ const wanted = Buffer.from(expected, 'utf8');
310
+ return presented.length === wanted.length && timingSafeEqual(presented, wanted);
311
+ }
246
312
  export function createMetricsRouter() {
247
313
  const router = Router();
248
- router.get('/metrics', async (_req, res) => {
314
+ router.get('/metrics', async (req, res) => {
315
+ // Optional bearer gate. Inert until METRICS_SCRAPE_TOKEN is set, so
316
+ // enabling it is an operator decision and no existing scraper breaks by
317
+ // deploying this. When set, the endpoint stops being world-readable.
318
+ //
319
+ // This is defence in depth, not the fix. The endpoint is mounted outside
320
+ // Apollo and outside auth on purpose, and restricting it at the ingress
321
+ // remains the right control; it simply is not in place, and until it is
322
+ // this scrape exposes the service's whole operational posture — request
323
+ // volumes, error rates, and the authorization counters that reveal the
324
+ // checker is running in shadow — to anyone who asks.
325
+ if (!scrapeAuthorized(req.get('authorization'), metricsScrapeToken())) {
326
+ res.status(401).set('WWW-Authenticate', 'Bearer').send('Unauthorized');
327
+ return;
328
+ }
249
329
  try {
250
330
  const metrics = await metricsRegistry.metrics();
251
331
  res.set('Content-Type', metricsRegistry.contentType);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@adaptic/backend-legacy",
3
- "version": "0.0.1018",
3
+ "version": "0.0.1020",
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",