@terreno/api 57.4.0 → 57.6.1
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.
- package/README.md +5 -5
- package/bunfig.toml +1 -1
- package/dist/actions.js +197 -368
- package/dist/adminModelRouter.js +88 -173
- package/dist/api.js +617 -852
- package/dist/audit/auditApp.js +48 -89
- package/dist/audit/auditEventModel.js +15 -16
- package/dist/audit/cloudTasksEnqueue.js +56 -149
- package/dist/audit/diff.js +70 -160
- package/dist/audit/processQueue.js +25 -70
- package/dist/audit/rbacSink.js +25 -66
- package/dist/audit/record.js +129 -251
- package/dist/auth.js +432 -681
- package/dist/authRecovery.js +155 -269
- package/dist/authTokens.js +43 -118
- package/dist/betterAuthApp.js +25 -26
- package/dist/betterAuthSetup.js +258 -413
- package/dist/browserLogsRoute.d.ts +6 -0
- package/dist/browserLogsRoute.js +97 -0
- package/dist/collectionRegistry.js +32 -47
- package/dist/config.js +53 -122
- package/dist/configurationApp.js +180 -361
- package/dist/configurationPlugin.js +130 -302
- package/dist/consentApp.js +276 -421
- package/dist/docLoader.js +78 -126
- package/dist/envConfigurationPlugin.js +25 -147
- package/dist/errors.js +151 -247
- package/dist/example.js +28 -34
- package/dist/expressServer.d.ts +10 -0
- package/dist/expressServer.js +109 -255
- package/dist/frameworkModelNames.d.ts +24 -0
- package/dist/frameworkModelNames.js +31 -0
- package/dist/githubAuth.js +152 -216
- package/dist/httpClient.js +176 -264
- package/dist/index.d.ts +2 -0
- package/dist/index.js +7 -2
- package/dist/logger.js +145 -278
- package/dist/mcp/auth.js +76 -128
- package/dist/mcp/createMCPRequest.js +4 -5
- package/dist/mcp/handlers.js +268 -480
- package/dist/mcp/query.js +56 -150
- package/dist/mcp/registry.js +17 -30
- package/dist/mcp/schemaGenerator.js +95 -181
- package/dist/mcp/server.js +28 -100
- package/dist/mcp/serviceTokens.js +102 -191
- package/dist/mcp/toolGenerator.js +78 -191
- package/dist/middleware.js +15 -27
- package/dist/migrations/fixtures/all-down/20260910120000-one.js +2 -42
- package/dist/migrations/fixtures/all-down/20260910120001-two.js +2 -42
- package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +1 -39
- package/dist/migrations/fixtures/bad-name/not-a-migration.js +1 -39
- package/dist/migrations/fixtures/valid/20260910120000-alpha.js +1 -39
- package/dist/migrations/fixtures/valid/20260910120001-beta.js +2 -42
- package/dist/migrations/generate.js +107 -229
- package/dist/migrations/load.js +75 -201
- package/dist/migrations/lock.js +54 -126
- package/dist/migrations/runner.js +192 -446
- package/dist/migrations/schemaCatalog.js +122 -263
- package/dist/models/consentForm.js +6 -6
- package/dist/models/consentResponse.js +5 -5
- package/dist/models/mcpServiceToken.js +66 -156
- package/dist/models/notification.js +6 -6
- package/dist/models/notificationPreference.js +6 -6
- package/dist/models/versionConfig.js +5 -5
- package/dist/notifications/notificationService.js +133 -273
- package/dist/notifications/notificationsApp.js +85 -179
- package/dist/notifications/notificationsBeforeSend.js +19 -64
- package/dist/notifiers/googleChatNotifier.js +36 -117
- package/dist/notifiers/slackNotifier.d.ts +31 -2
- package/dist/notifiers/slackNotifier.js +170 -119
- package/dist/notifiers/zoomNotifier.js +60 -111
- package/dist/openApi.js +107 -122
- package/dist/openApiBuilder.js +117 -159
- package/dist/openApiCompat.js +81 -148
- package/dist/openApiEtag.js +7 -7
- package/dist/openApiValidator.js +177 -286
- package/dist/orgs/orgContext.js +87 -157
- package/dist/orgs/orgPermissions.js +29 -68
- package/dist/orgs/orgPlugin.js +9 -27
- package/dist/orgs/organizationModel.js +65 -166
- package/dist/orgs/organizationSettings.js +29 -36
- package/dist/orgs/orgsApp.js +346 -608
- package/dist/permissions.js +88 -181
- package/dist/plugins.js +125 -218
- package/dist/populate.js +130 -240
- package/dist/rateLimit/applyTrustProxy.js +1 -1
- package/dist/rateLimit/createStore.js +7 -8
- package/dist/rateLimit/memoryStore.js +22 -100
- package/dist/rateLimit/middleware.js +48 -99
- package/dist/rateLimit/mongoStore.js +54 -112
- package/dist/rateLimit/policies.js +41 -75
- package/dist/rateLimit/redisStore.js +39 -133
- package/dist/rbac/access.js +119 -267
- package/dist/rbac/assertAllowed.js +95 -171
- package/dist/rbac/auditModel.js +14 -58
- package/dist/rbac/backfillAdmins.js +24 -130
- package/dist/rbac/fieldViews.js +46 -141
- package/dist/rbac/membershipOrgAdminSource.js +28 -99
- package/dist/rbac/middleware.js +30 -96
- package/dist/rbac/modelRouterAccess.js +130 -307
- package/dist/rbac/permissionUtils.js +40 -179
- package/dist/rbac/realtimeAccess.js +81 -147
- package/dist/rbac/resolve.d.ts +1 -1
- package/dist/rbac/resolve.js +148 -342
- package/dist/rbac/roleManager.js +318 -700
- package/dist/rbac/roleModel.js +44 -171
- package/dist/rbac/routes.js +93 -196
- package/dist/rbac/scopes.js +39 -133
- package/dist/rbac/statements.js +23 -91
- package/dist/rbac/userPlugin.js +3 -29
- package/dist/realtime/changeStreamWatcher.js +489 -800
- package/dist/realtime/deprecation.js +8 -10
- package/dist/realtime/queryMatcher.js +110 -191
- package/dist/realtime/queryStore.js +35 -118
- package/dist/realtime/realtimeApp.js +247 -401
- package/dist/realtime/registry.js +19 -30
- package/dist/realtime/sessionRevalidation.js +132 -358
- package/dist/realtime/socketAuth.js +89 -208
- package/dist/realtime/socketUser.js +10 -56
- package/dist/requestContext.js +93 -139
- package/dist/schemaMetadata.js +179 -274
- package/dist/scriptRunner.js +96 -266
- package/dist/scrubAdminFields.js +36 -108
- package/dist/secretProviders.js +130 -299
- package/dist/seedRunner.js +221 -514
- package/dist/sync/adminBroadcastScope.js +58 -170
- package/dist/sync/adminWindowAccess.js +15 -86
- package/dist/sync/adminWindowMutation.js +110 -181
- package/dist/sync/executors.js +425 -629
- package/dist/sync/loadHarness.js +392 -689
- package/dist/sync/models.js +181 -341
- package/dist/sync/mutationHandler.js +533 -801
- package/dist/sync/registrationSideEffects.js +41 -95
- package/dist/sync/registry.js +29 -49
- package/dist/sync/routes.js +484 -817
- package/dist/sync/scripts/compactTombstones.js +83 -228
- package/dist/sync/serialize.js +18 -58
- package/dist/sync/socketHandlers.js +253 -478
- package/dist/sync/streams.js +49 -117
- package/dist/sync/syncApp.js +12 -15
- package/dist/sync/syncBatch.js +63 -168
- package/dist/sync/syncSeqPlugin.js +430 -702
- package/dist/syncConsents.js +113 -253
- package/dist/terrenoApp.js +166 -276
- package/dist/tests/createTestData.js +146 -256
- package/dist/tests/models.js +14 -54
- package/dist/tests/mongoTestSetup.js +42 -103
- package/dist/tests/testHelper.js +31 -93
- package/dist/tests.js +12 -51
- package/dist/transformers.js +61 -164
- package/dist/utils.js +31 -93
- package/dist/vendor/wesleytodd-openapi/index.js +37 -51
- package/dist/vendor/wesleytodd-openapi/lib/generate-doc.js +32 -40
- package/dist/vendor/wesleytodd-openapi/lib/layer-schema.js +3 -3
- package/dist/vendor/wesleytodd-openapi/lib/ui.js +50 -19
- package/dist/vendor/wesleytodd-openapi/lib/validate.js +19 -47
- package/dist/versionCheckPlugin.js +52 -100
- package/dist/webhooks/headerValue.js +2 -2
- package/dist/webhooks/idempotency/memoryStore.js +16 -59
- package/dist/webhooks/idempotency/mongoStore.js +55 -130
- package/dist/webhooks/idempotency/webhookReceipt.js +9 -9
- package/dist/webhooks/rawBody.js +1 -1
- package/dist/webhooks/timingSafeEqual.js +4 -5
- package/dist/webhooks/verifiers/hmac.js +17 -18
- package/dist/webhooks/verifiers/sendgrid.js +20 -22
- package/dist/webhooks/verifiers/stripe.js +31 -65
- package/dist/webhooks/verifiers/twilio.js +23 -73
- package/dist/webhooks/webhooksApp.js +78 -177
- package/dist/zodOpenApi.js +2 -2
- package/package.json +6 -6
- package/src/__tests__/browserLogsRoute.test.ts +165 -0
- package/src/api.arrayOperations.test.ts +44 -0
- package/src/api.ts +64 -39
- package/src/audit/auditApp.test.ts +5 -5
- package/src/audit/auditEventModel.ts +7 -3
- package/src/audit/auditRouter.test.ts +5 -5
- package/src/audit/rbacSink.test.ts +2 -2
- package/src/audit/record.test.ts +2 -2
- package/src/audit/record.ts +3 -2
- package/src/auth.ts +1 -1
- package/src/authRecovery.test.ts +43 -0
- package/src/authRecovery.ts +16 -10
- package/src/authTokens.ts +6 -2
- package/src/authVerification.test.ts +22 -0
- package/src/browserLogsRoute.ts +110 -0
- package/src/configurationPlugin.test.ts +1 -11
- package/src/expressServer.ts +10 -0
- package/src/frameworkModelNames.test.ts +62 -0
- package/src/frameworkModelNames.ts +33 -0
- package/src/index.ts +7 -0
- package/src/isolated/migrateCliConnect.isolated.ts +51 -0
- package/src/mcp/auth.test.ts +34 -1
- package/src/migrations/cli.test.ts +0 -23
- package/src/models/mcpServiceToken.ts +4 -3
- package/src/models/notification.ts +3 -2
- package/src/models/notificationPreference.ts +1 -1
- package/src/notifications/notificationsApp.test.ts +24 -1
- package/src/notifiers/slackNotifier.test.ts +186 -1
- package/src/notifiers/slackNotifier.ts +167 -8
- package/src/orgs/orgPlugin.ts +1 -1
- package/src/orgs/organizationModel.ts +11 -6
- package/src/plugins.test.ts +5 -0
- package/src/plugins.ts +3 -0
- package/src/realtime/realtimeApp.ts +1 -1
- package/src/sync/integration.test.ts +2 -2
- package/src/terrenoApp.ts +3 -0
- package/src/types.d.ts +1 -0
- package/src/webhooks/idempotency/webhookReceipt.ts +4 -3
- package/tsconfig.json +13 -54
- package/tsconfig.typedoc.json +2 -0
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import express from "express";
|
|
2
|
+
/**
|
|
3
|
+
* Dev-only ingestion for the Terreno MCP `read_logs` tool: POST batches of client
|
|
4
|
+
* console / global error lines as JSONL under `.terreno/logs/browser.log`.
|
|
5
|
+
*/
|
|
6
|
+
export declare const addTerrenoDevBrowserLogsRoute: (app: express.Application) => void;
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
exports.addTerrenoDevBrowserLogsRoute = void 0;
|
|
7
|
+
const node_fs_1 = require("node:fs");
|
|
8
|
+
const node_path_1 = require("node:path");
|
|
9
|
+
const express_1 = __importDefault(require("express"));
|
|
10
|
+
const luxon_1 = require("luxon");
|
|
11
|
+
const MAX_BATCH_ENTRIES = 100;
|
|
12
|
+
const MAX_LEVEL_LENGTH = 32;
|
|
13
|
+
const MAX_MESSAGE_LENGTH = 8000;
|
|
14
|
+
const MAX_STACK_LENGTH = 16_000;
|
|
15
|
+
const BROWSER_LOG_BODY_LIMIT_BYTES = 256 * 1024;
|
|
16
|
+
const BROWSER_LOG_BODY_LIMIT = "256kb";
|
|
17
|
+
const MAX_BROWSER_LOG_FILE_BYTES = 5 * 1024 * 1024;
|
|
18
|
+
const shouldEnableBrowserLogs = () => {
|
|
19
|
+
if (process.env.NODE_ENV === "production") {
|
|
20
|
+
return false;
|
|
21
|
+
}
|
|
22
|
+
if (process.env.TERRENO_BROWSER_LOGS === "false" || process.env.TERRENO_BROWSER_LOGS === "0") {
|
|
23
|
+
return false;
|
|
24
|
+
}
|
|
25
|
+
if (process.env.TERRENO_BROWSER_LOGS === "true" || process.env.TERRENO_BROWSER_LOGS === "1") {
|
|
26
|
+
return true;
|
|
27
|
+
}
|
|
28
|
+
return process.env.NODE_ENV === "development";
|
|
29
|
+
};
|
|
30
|
+
const isLoopbackAddress = (address) => {
|
|
31
|
+
return address === "127.0.0.1" || address === "::1" || address === "::ffff:127.0.0.1";
|
|
32
|
+
};
|
|
33
|
+
const isBrowserLogRequestAllowed = (req) => {
|
|
34
|
+
return Boolean(req.user) || isLoopbackAddress(req.socket.remoteAddress);
|
|
35
|
+
};
|
|
36
|
+
/**
|
|
37
|
+
* Dev-only ingestion for the Terreno MCP `read_logs` tool: POST batches of client
|
|
38
|
+
* console / global error lines as JSONL under `.terreno/logs/browser.log`.
|
|
39
|
+
*/
|
|
40
|
+
const addTerrenoDevBrowserLogsRoute = (app) => {
|
|
41
|
+
if (!shouldEnableBrowserLogs()) {
|
|
42
|
+
return;
|
|
43
|
+
}
|
|
44
|
+
app.post("/__terreno/browser-logs", express_1.default.json({ limit: BROWSER_LOG_BODY_LIMIT }), (req, res) => {
|
|
45
|
+
if (!isBrowserLogRequestAllowed(req)) {
|
|
46
|
+
res
|
|
47
|
+
.status(403)
|
|
48
|
+
.json({ error: "Browser log ingestion requires a local or authenticated client" });
|
|
49
|
+
return;
|
|
50
|
+
}
|
|
51
|
+
const parsedBodySize = Buffer.byteLength(JSON.stringify(req.body ?? null));
|
|
52
|
+
if (parsedBodySize > BROWSER_LOG_BODY_LIMIT_BYTES) {
|
|
53
|
+
res.status(413).json({ error: "Browser log payload may not exceed 256 kB" });
|
|
54
|
+
return;
|
|
55
|
+
}
|
|
56
|
+
const body = req.body;
|
|
57
|
+
if (!Array.isArray(body?.entries) || body.entries.length === 0) {
|
|
58
|
+
res.status(400).json({ error: "Expected { entries: [...] }" });
|
|
59
|
+
return;
|
|
60
|
+
}
|
|
61
|
+
if (body.entries.length > MAX_BATCH_ENTRIES) {
|
|
62
|
+
res.status(413).json({ error: `A batch may contain at most ${MAX_BATCH_ENTRIES} entries` });
|
|
63
|
+
return;
|
|
64
|
+
}
|
|
65
|
+
const logDir = (0, node_path_1.join)(process.cwd(), ".terreno", "logs");
|
|
66
|
+
(0, node_fs_1.mkdirSync)(logDir, { recursive: true });
|
|
67
|
+
const path = (0, node_path_1.join)(logDir, "browser.log");
|
|
68
|
+
const lines = [];
|
|
69
|
+
for (const row of body.entries) {
|
|
70
|
+
if (typeof row !== "object" || row === null) {
|
|
71
|
+
continue;
|
|
72
|
+
}
|
|
73
|
+
const r = row;
|
|
74
|
+
const level = (typeof r.level === "string" ? r.level : "info").slice(0, MAX_LEVEL_LENGTH);
|
|
75
|
+
const rawMessage = typeof r.message === "string" ? r.message : JSON.stringify(r.message ?? "");
|
|
76
|
+
lines.push(JSON.stringify({
|
|
77
|
+
level,
|
|
78
|
+
message: rawMessage.slice(0, MAX_MESSAGE_LENGTH),
|
|
79
|
+
source: "browser",
|
|
80
|
+
stack: typeof r.stack === "string" ? r.stack.slice(0, MAX_STACK_LENGTH) : undefined,
|
|
81
|
+
timestamp: typeof r.timestamp === "string" && r.timestamp ? r.timestamp : luxon_1.DateTime.now().toISO(),
|
|
82
|
+
}));
|
|
83
|
+
}
|
|
84
|
+
if (lines.length > 0) {
|
|
85
|
+
const payload = `${lines.join("\n")}\n`;
|
|
86
|
+
const currentSize = (0, node_fs_1.existsSync)(path) ? (0, node_fs_1.statSync)(path).size : 0;
|
|
87
|
+
if (currentSize + Buffer.byteLength(payload) > MAX_BROWSER_LOG_FILE_BYTES) {
|
|
88
|
+
(0, node_fs_1.writeFileSync)(path, payload, { encoding: "utf-8", mode: 0o600 });
|
|
89
|
+
}
|
|
90
|
+
else {
|
|
91
|
+
(0, node_fs_1.appendFileSync)(path, payload, { encoding: "utf-8", mode: 0o600 });
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
res.status(204).end();
|
|
95
|
+
});
|
|
96
|
+
};
|
|
97
|
+
exports.addTerrenoDevBrowserLogsRoute = addTerrenoDevBrowserLogsRoute;
|
|
@@ -1,52 +1,39 @@
|
|
|
1
1
|
"use strict";
|
|
2
|
-
var __assign = (this && this.__assign) || function () {
|
|
3
|
-
__assign = Object.assign || function(t) {
|
|
4
|
-
for (var s, i = 1, n = arguments.length; i < n; i++) {
|
|
5
|
-
s = arguments[i];
|
|
6
|
-
for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
|
|
7
|
-
t[p] = s[p];
|
|
8
|
-
}
|
|
9
|
-
return t;
|
|
10
|
-
};
|
|
11
|
-
return __assign.apply(this, arguments);
|
|
12
|
-
};
|
|
13
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
14
3
|
exports.clearCollectionRegistry = exports.listCollections = exports.getCollection = exports.replaceCollectionOptions = exports.registerCollection = void 0;
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
4
|
+
const errors_1 = require("./errors");
|
|
5
|
+
const registrationSideEffects_1 = require("./sync/registrationSideEffects");
|
|
6
|
+
const withAdminBroadcastDefault = (config) => ({
|
|
7
|
+
...config,
|
|
8
|
+
adminBroadcast: config.adminBroadcast === true,
|
|
9
|
+
});
|
|
18
10
|
/** Store `adminBroadcast: false` when the host omitted the flag (default). */
|
|
19
|
-
|
|
11
|
+
const applyAdminBroadcastDefault = (options) => {
|
|
20
12
|
if (!options.sync) {
|
|
21
13
|
return;
|
|
22
14
|
}
|
|
23
15
|
options.sync = withAdminBroadcastDefault(options.sync);
|
|
24
16
|
};
|
|
25
|
-
|
|
17
|
+
const collectionRegistry = new Map();
|
|
26
18
|
/** OR new option flags onto existing ones so a patch cannot disable a surface. */
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
sync: Boolean(options.sync) || ((_c = existing === null || existing === void 0 ? void 0 : existing.sync) !== null && _c !== void 0 ? _c : false),
|
|
33
|
-
});
|
|
34
|
-
};
|
|
19
|
+
const deriveSurfaces = (options, existing) => ({
|
|
20
|
+
mcp: Boolean(options.mcp) || (existing?.mcp ?? false),
|
|
21
|
+
realtime: Boolean(options.realtime) || (existing?.realtime ?? false),
|
|
22
|
+
sync: Boolean(options.sync) || (existing?.sync ?? false),
|
|
23
|
+
});
|
|
35
24
|
/** Insert or merge a collection. First sync enable runs schema/index guards. */
|
|
36
|
-
|
|
37
|
-
var _b;
|
|
38
|
-
var model = _a.model, options = _a.options, routePath = _a.routePath;
|
|
25
|
+
const registerCollection = ({ model, options, routePath, }) => {
|
|
39
26
|
applyAdminBroadcastDefault(options);
|
|
40
|
-
|
|
41
|
-
|
|
27
|
+
const existing = collectionRegistry.get(routePath);
|
|
28
|
+
const wasSyncEnabled = existing?.surfaces.sync ?? false;
|
|
42
29
|
if (options.sync && wasSyncEnabled) {
|
|
43
|
-
if (
|
|
30
|
+
if (existing?.model.modelName === model.modelName) {
|
|
44
31
|
return;
|
|
45
32
|
}
|
|
46
|
-
|
|
33
|
+
const collectionTag = routePath.replace(/^\//, "");
|
|
47
34
|
throw new errors_1.APIError({
|
|
48
35
|
status: 500,
|
|
49
|
-
title:
|
|
36
|
+
title: `Sync collection tag "${collectionTag}" is already registered (routePath ${routePath}). ` +
|
|
50
37
|
"Each synced model must have a unique route path.",
|
|
51
38
|
});
|
|
52
39
|
}
|
|
@@ -54,27 +41,27 @@ var registerCollection = function (_a) {
|
|
|
54
41
|
(0, registrationSideEffects_1.applySyncRegistrationSideEffects)({
|
|
55
42
|
config: options.sync,
|
|
56
43
|
existingSyncEntries: (0, exports.listCollections)()
|
|
57
|
-
.filter(
|
|
58
|
-
.map(
|
|
44
|
+
.filter((record) => record.surfaces.sync)
|
|
45
|
+
.map((record) => ({
|
|
59
46
|
collectionTag: record.routePath.replace(/^\//, ""),
|
|
60
47
|
modelName: record.model.modelName,
|
|
61
|
-
})
|
|
62
|
-
model
|
|
63
|
-
options
|
|
64
|
-
routePath
|
|
48
|
+
})),
|
|
49
|
+
model,
|
|
50
|
+
options,
|
|
51
|
+
routePath,
|
|
65
52
|
});
|
|
66
53
|
}
|
|
67
54
|
collectionRegistry.set(routePath, {
|
|
68
55
|
model: model,
|
|
69
56
|
options: options,
|
|
70
|
-
routePath
|
|
71
|
-
surfaces: deriveSurfaces(options, existing
|
|
57
|
+
routePath,
|
|
58
|
+
surfaces: deriveSurfaces(options, existing?.surfaces),
|
|
72
59
|
});
|
|
73
60
|
};
|
|
74
61
|
exports.registerCollection = registerCollection;
|
|
75
62
|
/** Swap the options pointer after TerrenoApp enriches it. Unknown path is a no-op. */
|
|
76
|
-
|
|
77
|
-
|
|
63
|
+
const replaceCollectionOptions = (routePath, options) => {
|
|
64
|
+
const existing = collectionRegistry.get(routePath);
|
|
78
65
|
if (!existing) {
|
|
79
66
|
return;
|
|
80
67
|
}
|
|
@@ -83,14 +70,12 @@ var replaceCollectionOptions = function (routePath, options) {
|
|
|
83
70
|
};
|
|
84
71
|
exports.replaceCollectionOptions = replaceCollectionOptions;
|
|
85
72
|
/** @internal */
|
|
86
|
-
|
|
87
|
-
return collectionRegistry.get(routePath);
|
|
88
|
-
};
|
|
73
|
+
const getCollection = (routePath) => collectionRegistry.get(routePath);
|
|
89
74
|
exports.getCollection = getCollection;
|
|
90
|
-
|
|
75
|
+
const listCollections = () => Array.from(collectionRegistry.values());
|
|
91
76
|
exports.listCollections = listCollections;
|
|
92
77
|
/** Wipe the catalog and queued sync indexes so tests cannot leave a stale surface. */
|
|
93
|
-
|
|
78
|
+
const clearCollectionRegistry = () => {
|
|
94
79
|
collectionRegistry.clear();
|
|
95
80
|
(0, registrationSideEffects_1.clearSyncIndexCreationTasks)();
|
|
96
81
|
};
|
package/dist/config.js
CHANGED
|
@@ -21,70 +21,22 @@
|
|
|
21
21
|
* their backing store with `Config.setEnvLoader(fn)`. The optional
|
|
22
22
|
* `envConfigurationPlugin` provides a drop-in Mongoose schema integration.
|
|
23
23
|
*/
|
|
24
|
-
var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
|
|
25
|
-
function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
|
|
26
|
-
return new (P || (P = Promise))(function (resolve, reject) {
|
|
27
|
-
function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
|
|
28
|
-
function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
|
|
29
|
-
function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
|
|
30
|
-
step((generator = generator.apply(thisArg, _arguments || [])).next());
|
|
31
|
-
});
|
|
32
|
-
};
|
|
33
|
-
var __generator = (this && this.__generator) || function (thisArg, body) {
|
|
34
|
-
var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
|
|
35
|
-
return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
|
|
36
|
-
function verb(n) { return function (v) { return step([n, v]); }; }
|
|
37
|
-
function step(op) {
|
|
38
|
-
if (f) throw new TypeError("Generator is already executing.");
|
|
39
|
-
while (g && (g = 0, op[0] && (_ = 0)), _) try {
|
|
40
|
-
if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
|
|
41
|
-
if (y = 0, t) op = [op[0] & 2, t.value];
|
|
42
|
-
switch (op[0]) {
|
|
43
|
-
case 0: case 1: t = op; break;
|
|
44
|
-
case 4: _.label++; return { value: op[1], done: false };
|
|
45
|
-
case 5: _.label++; y = op[1]; op = [0]; continue;
|
|
46
|
-
case 7: op = _.ops.pop(); _.trys.pop(); continue;
|
|
47
|
-
default:
|
|
48
|
-
if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
|
|
49
|
-
if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
|
|
50
|
-
if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
|
|
51
|
-
if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
|
|
52
|
-
if (t[2]) _.ops.pop();
|
|
53
|
-
_.trys.pop(); continue;
|
|
54
|
-
}
|
|
55
|
-
op = body.call(thisArg, _);
|
|
56
|
-
} catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
|
|
57
|
-
if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
|
|
58
|
-
}
|
|
59
|
-
};
|
|
60
|
-
var __values = (this && this.__values) || function(o) {
|
|
61
|
-
var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
|
|
62
|
-
if (m) return m.call(o);
|
|
63
|
-
if (o && typeof o.length === "number") return {
|
|
64
|
-
next: function () {
|
|
65
|
-
if (o && i >= o.length) o = void 0;
|
|
66
|
-
return { value: o && o[i++], done: !o };
|
|
67
|
-
}
|
|
68
|
-
};
|
|
69
|
-
throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
|
|
70
|
-
};
|
|
71
24
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
72
25
|
exports.Config = void 0;
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
26
|
+
const errors_1 = require("./errors");
|
|
27
|
+
const overrides = new Map();
|
|
28
|
+
let cachedEnv = null;
|
|
29
|
+
let envLoader = null;
|
|
77
30
|
// Null-prototype object so lookups don't resolve inherited keys like
|
|
78
31
|
// `constructor` / `toString` as accidentally-registered entries.
|
|
79
|
-
|
|
32
|
+
const REGISTRY = Object.create(null);
|
|
80
33
|
/**
|
|
81
34
|
* Registers a configuration key, its default, and metadata. Re-registration
|
|
82
35
|
* of the same key throws so duplicates surface at boot.
|
|
83
36
|
*/
|
|
84
|
-
|
|
85
|
-
if (registration === void 0) { registration = {}; }
|
|
37
|
+
const register = (key, registration = {}) => {
|
|
86
38
|
if (REGISTRY[key]) {
|
|
87
|
-
throw new errors_1.APIError({ status: 500, title:
|
|
39
|
+
throw new errors_1.APIError({ status: 500, title: `Config key "${key}" registered more than once` });
|
|
88
40
|
}
|
|
89
41
|
REGISTRY[key] = registration;
|
|
90
42
|
};
|
|
@@ -93,41 +45,40 @@ var register = function (key, registration) {
|
|
|
93
45
|
* order documented at the top of this file. Returns `undefined` if no
|
|
94
46
|
* source supplies a value and no default was registered.
|
|
95
47
|
*/
|
|
96
|
-
|
|
97
|
-
var _a;
|
|
48
|
+
const getString = (key) => {
|
|
98
49
|
if (overrides.has(key)) {
|
|
99
50
|
return overrides.get(key);
|
|
100
51
|
}
|
|
101
52
|
if (cachedEnv && key in cachedEnv) {
|
|
102
|
-
|
|
53
|
+
const v = cachedEnv[key];
|
|
103
54
|
if (v !== undefined && v !== "") {
|
|
104
55
|
return v;
|
|
105
56
|
}
|
|
106
57
|
}
|
|
107
58
|
// Guard against process.env keys like "toString" / "constructor" inheriting
|
|
108
59
|
// a function from Object.prototype. Only accept string values.
|
|
109
|
-
|
|
60
|
+
const fromProcess = process.env[key];
|
|
110
61
|
if (typeof fromProcess === "string" && fromProcess !== "") {
|
|
111
62
|
return fromProcess;
|
|
112
63
|
}
|
|
113
|
-
return
|
|
64
|
+
return REGISTRY[key]?.default;
|
|
114
65
|
};
|
|
115
66
|
/**
|
|
116
67
|
* Returns the configured value as a number. Throws if a value is present but
|
|
117
68
|
* not finite — silent NaN propagation has bitten apps before.
|
|
118
69
|
*/
|
|
119
|
-
|
|
120
|
-
|
|
70
|
+
const getNumber = (key) => {
|
|
71
|
+
const raw = getString(key);
|
|
121
72
|
if (raw === undefined) {
|
|
122
73
|
return undefined;
|
|
123
74
|
}
|
|
124
75
|
// Number() rejects partially-numeric strings like "5000ms" (returns NaN)
|
|
125
76
|
// whereas parseFloat would silently truncate to 5000.
|
|
126
|
-
|
|
77
|
+
const parsed = Number(raw);
|
|
127
78
|
if (!Number.isFinite(parsed)) {
|
|
128
79
|
throw new errors_1.APIError({
|
|
129
80
|
code: "invalid-config-value",
|
|
130
|
-
detail:
|
|
81
|
+
detail: `Config key "${key}" is not a valid number: ${JSON.stringify(raw)}`,
|
|
131
82
|
status: 500,
|
|
132
83
|
title: "Invalid config value",
|
|
133
84
|
});
|
|
@@ -138,8 +89,8 @@ var getNumber = function (key) {
|
|
|
138
89
|
* Returns true iff the string value equals "true" (case-insensitive). Mirrors
|
|
139
90
|
* the existing `process.env.X === "true"` idiom.
|
|
140
91
|
*/
|
|
141
|
-
|
|
142
|
-
|
|
92
|
+
const getBoolean = (key) => {
|
|
93
|
+
const raw = getString(key);
|
|
143
94
|
return raw !== undefined && raw.toLowerCase() === "true";
|
|
144
95
|
};
|
|
145
96
|
/**
|
|
@@ -147,8 +98,8 @@ var getBoolean = function (key) {
|
|
|
147
98
|
* malformed JSON so misconfiguration fails loud at the call site rather than
|
|
148
99
|
* producing silent runtime errors later.
|
|
149
100
|
*/
|
|
150
|
-
|
|
151
|
-
|
|
101
|
+
const getJSON = (key) => {
|
|
102
|
+
const raw = getString(key);
|
|
152
103
|
if (raw === undefined) {
|
|
153
104
|
return undefined;
|
|
154
105
|
}
|
|
@@ -159,7 +110,7 @@ var getJSON = function (key) {
|
|
|
159
110
|
throw new errors_1.APIError({
|
|
160
111
|
cause: error,
|
|
161
112
|
code: "invalid-config-value",
|
|
162
|
-
detail:
|
|
113
|
+
detail: `Config key "${key}" is not valid JSON: ${error.message}`,
|
|
163
114
|
status: 500,
|
|
164
115
|
title: "Invalid config value",
|
|
165
116
|
});
|
|
@@ -170,91 +121,71 @@ var getJSON = function (key) {
|
|
|
170
121
|
* admin-editable Mongoose document). Called once at app startup before
|
|
171
122
|
* the first `Config.refresh()`.
|
|
172
123
|
*/
|
|
173
|
-
|
|
124
|
+
const setEnvLoader = (loader) => {
|
|
174
125
|
envLoader = loader;
|
|
175
126
|
};
|
|
176
127
|
/**
|
|
177
128
|
* Reloads the in-memory cache by invoking the registered env loader. No-op
|
|
178
129
|
* (clears cache) if no loader has been registered.
|
|
179
130
|
*/
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
}
|
|
188
|
-
return [4 /*yield*/, envLoader()];
|
|
189
|
-
case 1:
|
|
190
|
-
cachedEnv = _a.sent();
|
|
191
|
-
return [2 /*return*/];
|
|
192
|
-
}
|
|
193
|
-
});
|
|
194
|
-
}); };
|
|
131
|
+
const refresh = async () => {
|
|
132
|
+
if (!envLoader) {
|
|
133
|
+
cachedEnv = {};
|
|
134
|
+
return;
|
|
135
|
+
}
|
|
136
|
+
cachedEnv = await envLoader();
|
|
137
|
+
};
|
|
195
138
|
/** Replaces the cache directly. Intended for the envConfigurationPlugin and tests. */
|
|
196
|
-
|
|
139
|
+
const setCachedEnv = (env) => {
|
|
197
140
|
cachedEnv = env;
|
|
198
141
|
};
|
|
199
142
|
/**
|
|
200
143
|
* Sets an in-process override for `key`. Highest precedence — wins over
|
|
201
144
|
* the cached env map. Intended for tests and bootstrap helpers.
|
|
202
145
|
*/
|
|
203
|
-
|
|
146
|
+
const setOverride = (key, value) => {
|
|
204
147
|
overrides.set(key, value);
|
|
205
148
|
};
|
|
206
149
|
/** Clears every override. Call from afterEach in tests. */
|
|
207
|
-
|
|
150
|
+
const clearOverrides = () => {
|
|
208
151
|
overrides.clear();
|
|
209
152
|
};
|
|
210
153
|
/** Returns the registered default (if any) for `key`. */
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
return (_a = REGISTRY[key]) === null || _a === void 0 ? void 0 : _a.default;
|
|
154
|
+
const getDefault = (key) => {
|
|
155
|
+
return REGISTRY[key]?.default;
|
|
214
156
|
};
|
|
215
157
|
/** Returns the registration metadata for `key`, including secret/description. */
|
|
216
|
-
|
|
158
|
+
const getRegistration = (key) => {
|
|
217
159
|
return REGISTRY[key];
|
|
218
160
|
};
|
|
219
161
|
/** Returns the registered keys, sorted. Used by the admin UI. */
|
|
220
|
-
|
|
162
|
+
const getRegisteredKeys = () => {
|
|
221
163
|
return Object.keys(REGISTRY).sort();
|
|
222
164
|
};
|
|
223
165
|
/** Returns true if `key` was registered. */
|
|
224
|
-
|
|
166
|
+
const isRegistered = (key) => {
|
|
225
167
|
return key in REGISTRY;
|
|
226
168
|
};
|
|
227
169
|
/** Removes every registered key. Intended for tests. */
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
for (var _b = __values(Object.keys(REGISTRY)), _c = _b.next(); !_c.done; _c = _b.next()) {
|
|
232
|
-
var key = _c.value;
|
|
233
|
-
delete REGISTRY[key];
|
|
234
|
-
}
|
|
235
|
-
}
|
|
236
|
-
catch (e_1_1) { e_1 = { error: e_1_1 }; }
|
|
237
|
-
finally {
|
|
238
|
-
try {
|
|
239
|
-
if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
|
|
240
|
-
}
|
|
241
|
-
finally { if (e_1) throw e_1.error; }
|
|
170
|
+
const clearRegistryForTesting = () => {
|
|
171
|
+
for (const key of Object.keys(REGISTRY)) {
|
|
172
|
+
delete REGISTRY[key];
|
|
242
173
|
}
|
|
243
174
|
};
|
|
244
175
|
exports.Config = {
|
|
245
|
-
clearOverrides
|
|
246
|
-
clearRegistryForTesting
|
|
176
|
+
clearOverrides,
|
|
177
|
+
clearRegistryForTesting,
|
|
247
178
|
get: getString,
|
|
248
|
-
getBoolean
|
|
249
|
-
getDefault
|
|
250
|
-
getJSON
|
|
251
|
-
getNumber
|
|
252
|
-
getRegisteredKeys
|
|
253
|
-
getRegistration
|
|
254
|
-
isRegistered
|
|
255
|
-
refresh
|
|
256
|
-
register
|
|
257
|
-
setCachedEnv
|
|
258
|
-
setEnvLoader
|
|
259
|
-
setOverride
|
|
179
|
+
getBoolean,
|
|
180
|
+
getDefault,
|
|
181
|
+
getJSON,
|
|
182
|
+
getNumber,
|
|
183
|
+
getRegisteredKeys,
|
|
184
|
+
getRegistration,
|
|
185
|
+
isRegistered,
|
|
186
|
+
refresh,
|
|
187
|
+
register,
|
|
188
|
+
setCachedEnv,
|
|
189
|
+
setEnvLoader,
|
|
190
|
+
setOverride,
|
|
260
191
|
};
|