@mostra/runtime 0.9.0 → 0.11.0
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/dist/bin.js +6628 -9
- package/dist/bin.js.map +1 -1
- package/dist/builder/child/main.js +2 -2
- package/dist/{child-Chiavhdx.js → child-BmNZ4a70.js} +2 -2
- package/dist/{child-Chiavhdx.js.map → child-BmNZ4a70.js.map} +1 -1
- package/dist/deps/child/install.js +1 -1
- package/dist/{directories-mJ1qlVht.js → directories-BLJjeSPD.js} +5 -5
- package/dist/directories-BLJjeSPD.js.map +1 -0
- package/dist/{files-FygSJIzK.js → files-DGeWuE4I.js} +2 -2
- package/dist/{files-FygSJIzK.js.map → files-DGeWuE4I.js.map} +1 -1
- package/dist/index.d.ts +2 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -2
- package/dist/{instance-EnaZPs14.js → instance-DCiUHvgZ.js} +3835 -255
- package/dist/instance-DCiUHvgZ.js.map +1 -0
- package/dist/reference/cli.md +1322 -0
- package/dist/reference/diagnostics.json +1552 -0
- package/dist/reference/errors/MOSTRA_A11Y_MINOR.md +23 -0
- package/dist/reference/errors/MOSTRA_A11Y_SERIOUS.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_CANCELLED.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_EVENT_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_EXPORT_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_INTERRUPTED.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_PAUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_RUN_NOT_FOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_THREW.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_TOO_LARGE.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_UNKNOWN_FUNCTION.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_UNSERIALIZABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_BUNDLE_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_DIR_NOT_EMPTY.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_ENTRY_AMBIGUOUS.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_ID_DROPPED.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_NOT_FOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_NO_ENTRY.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_NO_PAGE.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_PATCH_REJECTED.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_PATH_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_SOURCE_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_SOURCE_UNREADABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_TEMPLATE_UNKNOWN.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_VERSION_COLLECTED.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_VERSION_NOT_FOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_BUILD_CRASHED.md +23 -0
- package/dist/reference/errors/MOSTRA_BUILD_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_BUILD_TIMEOUT.md +23 -0
- package/dist/reference/errors/MOSTRA_BUILD_UNRESOLVED.md +23 -0
- package/dist/reference/errors/MOSTRA_CLI_CONFIG_UNWRITABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_CLI_UNKNOWN_COMMAND.md +23 -0
- package/dist/reference/errors/MOSTRA_CLI_USAGE.md +23 -0
- package/dist/reference/errors/MOSTRA_CONSOLE_ERROR.md +23 -0
- package/dist/reference/errors/MOSTRA_CONSOLE_WARNING.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_INSTALL_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_NOT_FOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_OFFLINE.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_SPEC_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_TIMEOUT.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_WARM_CONFLICT.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_BIND_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_BROWSER_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_BUNDLE_DOWNLOAD_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_BUNDLE_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_BUNDLE_UNAVAILABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_HELPER_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_NODE_UNSUPPORTED.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_PORT_TAKEN.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_RUNTIME_INSTALLING.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_RUNTIME_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_SERVICE_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_SHELL_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_WARM_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_CONFLICT.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_DUPLICATE_ID.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_ID_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_ID_UNSTABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_MUTATION_ID_REUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_SHARED.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_TOO_LARGE.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_UNBOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_DISK_FULL.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_GC_INCOMPLETE.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_GONE.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_INTEGRITY.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_LEDGER_UNREADABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_LOCKED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_MISMATCH.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_NETWORK_FILESYSTEM.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_NOT_ALWAYS_ON.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_NOT_OWNED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_SOCKET_TOO_LONG.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_TOO_NEW.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_CONNECTION_CLOSED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_CURSOR_COMPACTED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_IDENTITY_UNAVAILABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_INITIALIZE_ORDER.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_INTERNAL_ERROR.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_INVALID_PARAMS.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_MALFORMED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_MESSAGE_TOO_LARGE.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_METHOD_UNKNOWN.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_NOTIFICATION_UNSUPPORTED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_PORT_UNSUPPORTED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_REQUEST_ID_REUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_REVISION_UNSUPPORTED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_SHUTDOWN_REFUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_SUBSCRIPTION_UNKNOWN.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_TIMEOUT.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_CONTENT_TYPE.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_CSRF_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_FRAME_SESSION.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_HEADERS_TOO_LARGE.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_HOST_REFUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_NOT_SERVED.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_ORIGIN_REFUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_RATE_LIMITED.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_REQUEST_MALFORMED.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_SCOPE_DENIED.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_SESSION_CONFLICT.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_SESSION_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_TOKEN_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_TOKEN_REVOKED.md +23 -0
- package/dist/reference/errors/MOSTRA_LIVE_SOURCE_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_LIVE_TOO_LARGE.md +23 -0
- package/dist/reference/errors/MOSTRA_MANIFEST_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_MANIFEST_NOT_LITERAL.md +23 -0
- package/dist/reference/errors/MOSTRA_MANIFEST_UNKNOWN_KEY.md +23 -0
- package/dist/reference/errors/MOSTRA_NETWORK_EXTERNAL_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_NETWORK_REQUEST_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_PLATFORM_UNSUPPORTED.md +23 -0
- package/dist/reference/errors/MOSTRA_PUBLISH_ID_CONFLICT.md +23 -0
- package/dist/reference/errors/MOSTRA_PUBLISH_SOURCE_CHANGED.md +23 -0
- package/dist/reference/errors/MOSTRA_PUBLISH_VERIFY_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_REGRESSION_ACTION_REMOVED.md +23 -0
- package/dist/reference/errors/MOSTRA_REGRESSION_ARIA.md +23 -0
- package/dist/reference/errors/MOSTRA_REGRESSION_FIELD_REMOVED.md +23 -0
- package/dist/reference/errors/MOSTRA_REGRESSION_LIVE_REMOVED.md +23 -0
- package/dist/reference/errors/MOSTRA_REGRESSION_PAGE_REMOVED.md +23 -0
- package/dist/reference/errors/MOSTRA_REGRESSION_PIXELS.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_CONFIG_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_HOME_MOVING.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_HOME_SUSPENDED.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_LIMIT_REACHED.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_LOGIN_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_NOT_OWNER_INSTANCE.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_NO_INSTANCE.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_OPERATOR_UNAVAILABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_OWNER_OFFLINE.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_PAUSED_BY_OPERATOR.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_QUEUE_FULL.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_RATE_LIMITED.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_SIGN_IN_REQUIRED.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_UNDER_REVIEW.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_UNREACHABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_RUNTIME_BLANK.md +23 -0
- package/dist/reference/errors/MOSTRA_RUNTIME_NOT_READY.md +23 -0
- package/dist/reference/errors/MOSTRA_RUNTIME_PAGE_ERROR.md +23 -0
- package/dist/reference/errors/MOSTRA_RUNTIME_WORKER_CRASHED.md +23 -0
- package/dist/reference/errors/MOSTRA_RUNTIME_WORKER_PARKED.md +23 -0
- package/dist/reference/errors/MOSTRA_SECRET_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_NOT_ENABLED.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_NOT_FOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_PORTS_EXHAUSTED.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_TOOL_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_TOOL_NOT_READY.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_TTL_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_TUNNEL_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_SMOKE_BUDGET.md +23 -0
- package/dist/reference/errors/MOSTRA_SMOKE_NO_EFFECT.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_ALREADY.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_BLOCKED.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_CHANNEL_DENIED.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_NOT_FOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_PAUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_POLICY_NONE.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_REVISION_MOVED.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_SIGNAL_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_VIEW_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_TARGET_UNAVAILABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_TYPE_ERROR.md +23 -0
- package/dist/reference/errors/MOSTRA_TYPE_UNTYPED_PACKAGE.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_ACTION_SKIPPED.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_BASELINE_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_CRASHED.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_LIVE_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_NO_BASELINE.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_SECRET_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_SKIP_CONSEQUENCE.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_TIMEOUT.md +23 -0
- package/dist/reference/self-hosting.md +130 -0
- package/dist/reference/telemetry.md +84 -0
- package/dist/skill/SKILL.md +122 -0
- package/dist/skill/assets/examples/dashboard/index.tsx +161 -0
- package/dist/skill/assets/examples/dashboard/live.ts +25 -0
- package/dist/skill/assets/examples/dashboard/styles.css +125 -0
- package/dist/skill/assets/examples/decision/index.tsx +95 -0
- package/dist/skill/assets/examples/decision/styles.css +125 -0
- package/dist/skill/assets/examples/inbox/actions.ts +23 -0
- package/dist/skill/assets/examples/inbox/index.tsx +109 -0
- package/dist/skill/assets/examples/inbox/styles.css +125 -0
- package/dist/skill/assets/studio.css +125 -0
- package/dist/skill/references/answers.md +217 -0
- package/dist/skill/references/design.md +154 -0
- package/dist/skill/references/libraries.md +167 -0
- package/dist/skill/references/long-lived.md +148 -0
- package/dist/skill/references/mcp.md +68 -0
- package/dist/skill/references/page.md +131 -0
- package/dist/skill/references/server.md +146 -0
- package/dist/skill/references/sharing.md +123 -0
- package/dist/skill/references/verify.md +71 -0
- package/package.json +12 -5
- package/src/actions/index.ts +163 -10
- package/src/bin.ts +78 -1
- package/src/gateway/actions.ts +40 -4
- package/src/gateway/browser.ts +162 -95
- package/src/gateway/capabilities.ts +23 -6
- package/src/gateway/http.ts +12 -1
- package/src/gateway/index.ts +282 -20
- package/src/gateway/listener.ts +31 -6
- package/src/gateway/routes.ts +23 -7
- package/src/gc/index.ts +19 -0
- package/src/instance/index.ts +60 -2
- package/src/interaction/ephemeral.ts +32 -23
- package/src/interaction/events.ts +21 -1
- package/src/interaction/imports.ts +317 -0
- package/src/interaction/index.ts +228 -15
- package/src/interaction/outbox.ts +9 -0
- package/src/interaction/pause.ts +106 -0
- package/src/interaction/results.ts +8 -1
- package/src/interaction/runs.ts +52 -2
- package/src/interaction/submissions.ts +59 -2
- package/src/interaction/tally.ts +129 -0
- package/src/interaction/viewers.ts +34 -1
- package/src/ledger/index.ts +124 -10
- package/src/ledger/migrations.ts +234 -0
- package/src/ledger/types.ts +8 -0
- package/src/link/author.ts +215 -0
- package/src/link/binding.ts +289 -0
- package/src/link/hosted.ts +101 -0
- package/src/link/http.ts +141 -0
- package/src/link/index.ts +10 -0
- package/src/link/manager.ts +1489 -0
- package/src/link/relay.ts +512 -0
- package/src/live/index.ts +112 -2
- package/src/platform/filesystems.ts +78 -0
- package/src/platform/index.ts +1 -0
- package/src/protocol-server/client.ts +53 -0
- package/src/protocol-server/index.ts +19 -2
- package/src/protocol-server/server.ts +38 -7
- package/src/protocol-server/websocket.ts +161 -0
- package/src/publish/bundle.ts +398 -0
- package/src/publish/manifest.ts +9 -0
- package/src/publish/methods.ts +12 -1
- package/src/publish/publisher.ts +127 -0
- package/src/registry/index.ts +35 -14
- package/src/server/api.ts +881 -0
- package/src/server/auth.ts +1139 -0
- package/src/server/authorize.ts +816 -0
- package/src/server/clients.ts +235 -0
- package/src/server/config.ts +228 -0
- package/src/server/data.ts +427 -0
- package/src/server/directory.ts +210 -0
- package/src/server/feed.ts +191 -0
- package/src/server/handle.ts +172 -0
- package/src/server/hosted-pages.ts +532 -0
- package/src/server/hosted.ts +1323 -0
- package/src/server/index.ts +650 -0
- package/src/server/mcp.ts +330 -0
- package/src/server/metering.ts +156 -0
- package/src/server/oauth-clients.ts +510 -0
- package/src/server/operator.ts +498 -0
- package/src/server/providers.ts +284 -0
- package/src/server/relay.ts +1163 -0
- package/src/server/remove.ts +148 -0
- package/src/server/routing.ts +275 -0
- package/src/share/index.ts +110 -6
- package/src/verify/runner.ts +23 -2
- package/dist/directories-mJ1qlVht.js.map +0 -1
- package/dist/instance-EnaZPs14.js.map +0 -1
|
@@ -0,0 +1,235 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Who a request comes from, and how often (D165 item 13, FAILURE_MODEL §11.3). The server sits
|
|
3
|
+
* behind a TLS terminator, so the connection's peer is a proxy: `X-Forwarded-For` is believed only
|
|
4
|
+
* when the peer is one of `trustedProxies`, and read from the right, taking the first address that
|
|
5
|
+
* isn't a trusted proxy, so a forged leftmost entry is ignored. Rates key IPv6 addresses by their
|
|
6
|
+
* /64 (`rateLimits.ipv6Prefix`), so rotating addresses inside one allocation doesn't escape them.
|
|
7
|
+
*
|
|
8
|
+
* The rate limiter is a token bucket per key, in memory: a server setting, never operator
|
|
9
|
+
* policy, and with no setting there is no limit (D165 item 14).
|
|
10
|
+
*/
|
|
11
|
+
import type { IncomingMessage } from "node:http";
|
|
12
|
+
import { isIPv4, isIPv6 } from "node:net";
|
|
13
|
+
|
|
14
|
+
/** An address range: an exact address, or a CIDR block (`10.0.0.0/8`, `fd00::/8`). */
|
|
15
|
+
interface Range {
|
|
16
|
+
readonly v6: boolean;
|
|
17
|
+
readonly bits: bigint;
|
|
18
|
+
readonly prefix: number;
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
/** An address as a number (IPv4 in 32 bits, IPv6 in 128), or `undefined` when it isn't one. */
|
|
22
|
+
function addressBits(address: string): { readonly v6: boolean; readonly bits: bigint } | undefined {
|
|
23
|
+
let text = address.trim();
|
|
24
|
+
if (text.startsWith("[") && text.endsWith("]")) text = text.slice(1, -1);
|
|
25
|
+
// An IPv4 address mapped into IPv6, as Node reports a dual-stack peer.
|
|
26
|
+
const mapped = /^::ffff:(\d+\.\d+\.\d+\.\d+)$/i.exec(text);
|
|
27
|
+
if (mapped) text = mapped[1] as string;
|
|
28
|
+
if (isIPv4(text)) {
|
|
29
|
+
const parts = text.split(".").map(Number);
|
|
30
|
+
return {
|
|
31
|
+
v6: false,
|
|
32
|
+
bits: parts.reduce((sum, part) => (sum << 8n) | BigInt(part), 0n),
|
|
33
|
+
};
|
|
34
|
+
}
|
|
35
|
+
if (!isIPv6(text)) return undefined;
|
|
36
|
+
const zone = text.indexOf("%");
|
|
37
|
+
if (zone !== -1) text = text.slice(0, zone);
|
|
38
|
+
// A trailing IPv4 part becomes two groups. It is what follows the last colon, read without a
|
|
39
|
+
// pattern: an address comes from a client's `X-Forwarded-For` (CodeQL js/polynomial-redos).
|
|
40
|
+
const last = text.slice(text.lastIndexOf(":") + 1);
|
|
41
|
+
if (last.includes(".")) {
|
|
42
|
+
if (!isIPv4(last)) return undefined;
|
|
43
|
+
const parts = last.split(".").map(Number);
|
|
44
|
+
const high = (((parts[0] as number) << 8) | (parts[1] as number)).toString(16);
|
|
45
|
+
const low = (((parts[2] as number) << 8) | (parts[3] as number)).toString(16);
|
|
46
|
+
text = `${text.slice(0, -last.length)}${high}:${low}`;
|
|
47
|
+
}
|
|
48
|
+
const [head, tail] = text.split("::") as [string, string | undefined];
|
|
49
|
+
const left = head === "" ? [] : head.split(":");
|
|
50
|
+
const right = tail === undefined ? [] : tail === "" ? [] : tail.split(":");
|
|
51
|
+
const groups =
|
|
52
|
+
tail === undefined
|
|
53
|
+
? left
|
|
54
|
+
: [...left, ...new Array(8 - left.length - right.length).fill("0"), ...right];
|
|
55
|
+
if (groups.length !== 8) return undefined;
|
|
56
|
+
return {
|
|
57
|
+
v6: true,
|
|
58
|
+
bits: groups.reduce((sum, group) => (sum << 16n) | BigInt(Number.parseInt(group, 16)), 0n),
|
|
59
|
+
};
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
function parseRange(text: string): Range | undefined {
|
|
63
|
+
const [address, prefixText] = text.split("/") as [string, string | undefined];
|
|
64
|
+
const found = addressBits(address);
|
|
65
|
+
if (!found) return undefined;
|
|
66
|
+
const width = found.v6 ? 128 : 32;
|
|
67
|
+
const prefix = prefixText === undefined ? width : Number(prefixText);
|
|
68
|
+
if (!Number.isInteger(prefix) || prefix < 0 || prefix > width) return undefined;
|
|
69
|
+
return { v6: found.v6, bits: found.bits, prefix };
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
function inRange(range: Range, address: { readonly v6: boolean; readonly bits: bigint }): boolean {
|
|
73
|
+
if (range.v6 !== address.v6) return false;
|
|
74
|
+
const width = range.v6 ? 128n : 32n;
|
|
75
|
+
const shift = width - BigInt(range.prefix);
|
|
76
|
+
return range.bits >> shift === address.bits >> shift;
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
/** Whether every entry of `trustedProxies` is an address or a CIDR block. */
|
|
80
|
+
export function validProxies(entries: readonly string[]): string | undefined {
|
|
81
|
+
return entries.find((entry) => parseRange(entry) === undefined);
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
/** Resolves a request's client address through the configured trusted proxies. */
|
|
85
|
+
export interface ClientAddresses {
|
|
86
|
+
/** The client's address: the peer's, or the forwarded one when the peer is a trusted proxy. */
|
|
87
|
+
of(incoming: IncomingMessage): string | undefined;
|
|
88
|
+
/** The key a rate counts the address under: the address, or its IPv6 prefix. */
|
|
89
|
+
keyOf(address: string | undefined): string;
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
/** Options for {@link clientAddresses}. */
|
|
93
|
+
export interface ClientAddressOptions {
|
|
94
|
+
readonly trustedProxies?: readonly string[] | undefined;
|
|
95
|
+
/** IPv6 addresses count per this prefix (default 64). */
|
|
96
|
+
readonly ipv6Prefix?: number | undefined;
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
/** Builds the resolver; an entry that isn't an address or a block is ignored (checked at start). */
|
|
100
|
+
export function clientAddresses(options: ClientAddressOptions): ClientAddresses {
|
|
101
|
+
const proxies = (options.trustedProxies ?? [])
|
|
102
|
+
.map(parseRange)
|
|
103
|
+
.filter((range): range is Range => range !== undefined);
|
|
104
|
+
const trusted = (address: string): boolean => {
|
|
105
|
+
const bits = addressBits(address);
|
|
106
|
+
return bits !== undefined && proxies.some((range) => inRange(range, bits));
|
|
107
|
+
};
|
|
108
|
+
const ipv6Prefix = options.ipv6Prefix ?? 64;
|
|
109
|
+
const seen = new WeakMap<IncomingMessage, string | undefined>();
|
|
110
|
+
return {
|
|
111
|
+
of(incoming) {
|
|
112
|
+
if (seen.has(incoming)) return seen.get(incoming);
|
|
113
|
+
const peer = incoming.socket.remoteAddress;
|
|
114
|
+
let client = peer;
|
|
115
|
+
if (peer !== undefined && trusted(peer)) {
|
|
116
|
+
const header = incoming.headers["x-forwarded-for"];
|
|
117
|
+
const entries = (Array.isArray(header) ? header.join(",") : (header ?? ""))
|
|
118
|
+
.split(",")
|
|
119
|
+
.map((entry) => entry.trim())
|
|
120
|
+
.filter((entry) => entry !== "");
|
|
121
|
+
// From the right: each hop appends the address it saw; the first one that isn't one of
|
|
122
|
+
// ours is the client. Anything to its left was written by the client and is believed by
|
|
123
|
+
// no one.
|
|
124
|
+
for (let index = entries.length - 1; index >= 0; index--) {
|
|
125
|
+
const entry = entries[index] as string;
|
|
126
|
+
if (addressBits(entry) === undefined) break;
|
|
127
|
+
client = entry;
|
|
128
|
+
if (!trusted(entry)) break;
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
seen.set(incoming, client);
|
|
132
|
+
return client;
|
|
133
|
+
},
|
|
134
|
+
keyOf(address) {
|
|
135
|
+
if (address === undefined) return "unknown";
|
|
136
|
+
const bits = addressBits(address);
|
|
137
|
+
if (!bits) return `other:${address}`;
|
|
138
|
+
if (!bits.v6) return `v4:${bits.bits.toString(16)}`;
|
|
139
|
+
const shift = 128n - BigInt(ipv6Prefix);
|
|
140
|
+
return `v6:${(bits.bits >> shift).toString(16)}/${ipv6Prefix}`;
|
|
141
|
+
},
|
|
142
|
+
};
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
/** A rate: `count` per `perMs`. */
|
|
146
|
+
export interface RateLimit {
|
|
147
|
+
readonly count: number;
|
|
148
|
+
readonly perMs: number;
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
/**
|
|
152
|
+
* A token-bucket rate limiter over keys, in memory, bounded in the keys it keeps: each key holds up
|
|
153
|
+
* to `count` tokens and earns them back at `count` per `perMs`, so a burst of `count` passes and
|
|
154
|
+
* the sustained rate is exactly the rate.
|
|
155
|
+
*/
|
|
156
|
+
export class RateLimiter {
|
|
157
|
+
readonly #buckets = new Map<string, { tokens: number; at: number }>();
|
|
158
|
+
readonly #now: () => number;
|
|
159
|
+
readonly #maxKeys: number;
|
|
160
|
+
|
|
161
|
+
constructor(options: { readonly now?: () => number; readonly maxKeys?: number } = {}) {
|
|
162
|
+
this.#now = options.now ?? (() => Date.now());
|
|
163
|
+
this.#maxKeys = options.maxKeys ?? 100_000;
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
/** A key's bucket, refilled to now and marked most recently used, so the bound drops the least. */
|
|
167
|
+
#bucket(key: string, rate: RateLimit, now: number): { tokens: number; at: number } {
|
|
168
|
+
const perToken = rate.perMs / rate.count;
|
|
169
|
+
let bucket = this.#buckets.get(key);
|
|
170
|
+
if (bucket) {
|
|
171
|
+
bucket.tokens = Math.min(rate.count, bucket.tokens + (now - bucket.at) / perToken);
|
|
172
|
+
bucket.at = now;
|
|
173
|
+
this.#buckets.delete(key);
|
|
174
|
+
} else {
|
|
175
|
+
if (this.#buckets.size >= this.#maxKeys) {
|
|
176
|
+
this.#buckets.delete(this.#buckets.keys().next().value as string);
|
|
177
|
+
}
|
|
178
|
+
bucket = { tokens: rate.count, at: now };
|
|
179
|
+
}
|
|
180
|
+
this.#buckets.set(key, bucket);
|
|
181
|
+
return bucket;
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
/** How long until every bucket holds a token: 0 when they all do now. */
|
|
185
|
+
#wait(
|
|
186
|
+
wanted: readonly { readonly key: string; readonly rate: RateLimit }[],
|
|
187
|
+
now: number,
|
|
188
|
+
): { readonly waitMs: number; readonly buckets: { tokens: number }[] } {
|
|
189
|
+
let waitMs = 0;
|
|
190
|
+
const buckets = wanted.map(({ key, rate }) => {
|
|
191
|
+
const bucket = this.#bucket(key, rate, now);
|
|
192
|
+
if (bucket.tokens < 1)
|
|
193
|
+
waitMs = Math.max(waitMs, (1 - bucket.tokens) * (rate.perMs / rate.count));
|
|
194
|
+
return bucket;
|
|
195
|
+
});
|
|
196
|
+
return { waitMs, buckets };
|
|
197
|
+
}
|
|
198
|
+
|
|
199
|
+
/**
|
|
200
|
+
* Takes one token under `key` when there is one. Without one, nothing is taken and the answer
|
|
201
|
+
* says when to try again, in whole seconds (`Retry-After`).
|
|
202
|
+
*/
|
|
203
|
+
take(
|
|
204
|
+
key: string,
|
|
205
|
+
rate: RateLimit,
|
|
206
|
+
): { readonly ok: true } | { readonly ok: false; readonly retryAfterS: number } {
|
|
207
|
+
return this.takeAll([{ key, rate }]);
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
/**
|
|
211
|
+
* Gives back the token `takeAll` took under every key, as far as each bucket's size: an attempt
|
|
212
|
+
* someone refused after the rates admitted it (the operator's `limits`) costs nothing (second
|
|
213
|
+
* Fable review of WP-30, 2).
|
|
214
|
+
*/
|
|
215
|
+
refundAll(wanted: readonly { readonly key: string; readonly rate: RateLimit }[]): void {
|
|
216
|
+
const now = this.#now();
|
|
217
|
+
for (const { key, rate } of wanted) {
|
|
218
|
+
const bucket = this.#bucket(key, rate, now);
|
|
219
|
+
bucket.tokens = Math.min(rate.count, bucket.tokens + 1);
|
|
220
|
+
}
|
|
221
|
+
}
|
|
222
|
+
|
|
223
|
+
/**
|
|
224
|
+
* Takes one token under every key, or none: when any bucket is empty, nothing is taken from the
|
|
225
|
+
* others, and the answer says when the slowest one has a token again (Fable review, 8).
|
|
226
|
+
*/
|
|
227
|
+
takeAll(
|
|
228
|
+
wanted: readonly { readonly key: string; readonly rate: RateLimit }[],
|
|
229
|
+
): { readonly ok: true } | { readonly ok: false; readonly retryAfterS: number } {
|
|
230
|
+
const { waitMs, buckets } = this.#wait(wanted, this.#now());
|
|
231
|
+
if (waitMs > 0) return { ok: false, retryAfterS: Math.max(1, Math.ceil(waitMs / 1000)) };
|
|
232
|
+
for (const bucket of buckets) bucket.tokens -= 1;
|
|
233
|
+
return { ok: true };
|
|
234
|
+
}
|
|
235
|
+
}
|
|
@@ -0,0 +1,228 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The remote server's configuration (INTERFACES §18.1): a JSON file (`--config`) and
|
|
3
|
+
* `MOSTRA_SERVER_<KEY>` variables, read before the server serves anything. A configuration it
|
|
4
|
+
* can't use stops it, naming the key (`MOSTRA_REMOTE_CONFIG_INVALID`). Domains are configuration,
|
|
5
|
+
* never code (D137, D165 item 0a): the dossier and this code name only `example` hosts.
|
|
6
|
+
*/
|
|
7
|
+
import { readFileSync } from "node:fs";
|
|
8
|
+
import { createDiagnostic, Duration, RpcError } from "@mostra/protocol";
|
|
9
|
+
import * as z from "zod";
|
|
10
|
+
import type { Environment } from "../log.ts";
|
|
11
|
+
import { validProxies } from "./clients.ts";
|
|
12
|
+
|
|
13
|
+
/** A rate: `count` per `per` (a duration such as `1m`, as links' lifetimes are written). */
|
|
14
|
+
const RateSchema: z.ZodType<Rate> = z.object({
|
|
15
|
+
count: z.int().min(1),
|
|
16
|
+
per: Duration,
|
|
17
|
+
});
|
|
18
|
+
|
|
19
|
+
/** A host name a link can use: lower-case labels of letters, digits and hyphens. */
|
|
20
|
+
const HostName: z.ZodString = z
|
|
21
|
+
.string()
|
|
22
|
+
.regex(
|
|
23
|
+
/^(?=.{1,253}$)([a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)(\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)*(:\d{1,5})?$/,
|
|
24
|
+
{
|
|
25
|
+
message: "must be a lower-case host name, with a port only for a local test",
|
|
26
|
+
},
|
|
27
|
+
);
|
|
28
|
+
|
|
29
|
+
/**
|
|
30
|
+
* An origin the server is reached at: `https:`, or `http:` for loopback and `*.localhost` (tests
|
|
31
|
+
* and a self-hoster's first run).
|
|
32
|
+
*/
|
|
33
|
+
const Origin: z.ZodType<string> = z.string().refine(
|
|
34
|
+
(value) => {
|
|
35
|
+
try {
|
|
36
|
+
const url = new URL(value);
|
|
37
|
+
if (url.origin !== value) return false;
|
|
38
|
+
if (url.protocol === "https:") return true;
|
|
39
|
+
return (
|
|
40
|
+
url.protocol === "http:" &&
|
|
41
|
+
(url.hostname === "127.0.0.1" ||
|
|
42
|
+
url.hostname === "localhost" ||
|
|
43
|
+
url.hostname.endsWith(".localhost") ||
|
|
44
|
+
url.hostname === "[::1]")
|
|
45
|
+
);
|
|
46
|
+
} catch {
|
|
47
|
+
return false;
|
|
48
|
+
}
|
|
49
|
+
},
|
|
50
|
+
{ message: "must be an https: origin (http: only on loopback), with no path" },
|
|
51
|
+
);
|
|
52
|
+
|
|
53
|
+
/** A rate limit: `count` per `per`. */
|
|
54
|
+
export interface Rate {
|
|
55
|
+
readonly count: number;
|
|
56
|
+
readonly per: string;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/** An identity provider sign-in goes through (§18.5); WP-30 adds `oidc` and `github`. */
|
|
60
|
+
export interface IdentityProviderConfig {
|
|
61
|
+
readonly id: string;
|
|
62
|
+
readonly kind: "development" | "oidc" | "github";
|
|
63
|
+
readonly label?: string | undefined;
|
|
64
|
+
readonly issuer?: string | undefined;
|
|
65
|
+
readonly clientId?: string | undefined;
|
|
66
|
+
readonly clientSecretFile?: string | undefined;
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
/** The configuration a remote server runs with (INTERFACES §18.1). */
|
|
70
|
+
export interface RemoteServerConfig {
|
|
71
|
+
readonly apiOrigin: string;
|
|
72
|
+
readonly domains: { readonly active: string; readonly spares?: string[] | undefined };
|
|
73
|
+
readonly scheme?: "https" | "http" | undefined;
|
|
74
|
+
readonly trustedProxies?: string[] | undefined;
|
|
75
|
+
readonly identityProviders?: IdentityProviderConfig[] | undefined;
|
|
76
|
+
readonly rateLimits?:
|
|
77
|
+
| {
|
|
78
|
+
readonly perIp?:
|
|
79
|
+
| { readonly submissions?: Rate | undefined; readonly requests?: Rate | undefined }
|
|
80
|
+
| undefined;
|
|
81
|
+
readonly perLink?:
|
|
82
|
+
| { readonly submissions?: Rate | undefined; readonly relayedRuns?: Rate | undefined }
|
|
83
|
+
| undefined;
|
|
84
|
+
readonly ipv6Prefix?: number | undefined;
|
|
85
|
+
}
|
|
86
|
+
| undefined;
|
|
87
|
+
readonly ledger?: { readonly walAutocheckpoint?: number | undefined } | undefined;
|
|
88
|
+
readonly relay?:
|
|
89
|
+
| {
|
|
90
|
+
readonly waitingRunsPerArtifact?: number | undefined;
|
|
91
|
+
readonly drainPerSecond?: number | undefined;
|
|
92
|
+
}
|
|
93
|
+
| undefined;
|
|
94
|
+
readonly homes?: { readonly idleCloseMinutes?: number | undefined } | undefined;
|
|
95
|
+
readonly framing?: { readonly frameAncestors: "'none'" } | undefined;
|
|
96
|
+
readonly operator?: string | undefined;
|
|
97
|
+
readonly chatHosts?: Record<string, unknown> | undefined;
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
/** The schema of {@link RemoteServerConfig}. */
|
|
101
|
+
const Config: z.ZodType<RemoteServerConfig> & { readonly shape: Record<string, unknown> } =
|
|
102
|
+
z.strictObject({
|
|
103
|
+
apiOrigin: Origin,
|
|
104
|
+
domains: z.strictObject({
|
|
105
|
+
active: HostName,
|
|
106
|
+
spares: z.array(HostName).optional(),
|
|
107
|
+
}),
|
|
108
|
+
/**
|
|
109
|
+
* The scheme the user-content domain is served on: `https` behind a TLS terminator, `http`
|
|
110
|
+
* for a loopback test. Default `https`.
|
|
111
|
+
*/
|
|
112
|
+
scheme: z.enum(["https", "http"]).optional(),
|
|
113
|
+
trustedProxies: z.array(z.string()).optional(),
|
|
114
|
+
identityProviders: z
|
|
115
|
+
.array(
|
|
116
|
+
z.strictObject({
|
|
117
|
+
id: z.string().regex(/^[a-z][a-z0-9-]{0,31}$/),
|
|
118
|
+
kind: z.enum(["development", "oidc", "github"]),
|
|
119
|
+
label: z.string().min(1).optional(),
|
|
120
|
+
issuer: z.string().optional(),
|
|
121
|
+
clientId: z.string().optional(),
|
|
122
|
+
clientSecretFile: z.string().optional(),
|
|
123
|
+
}),
|
|
124
|
+
)
|
|
125
|
+
.optional(),
|
|
126
|
+
rateLimits: z
|
|
127
|
+
.strictObject({
|
|
128
|
+
perIp: z
|
|
129
|
+
.strictObject({ submissions: RateSchema.optional(), requests: RateSchema.optional() })
|
|
130
|
+
.optional(),
|
|
131
|
+
perLink: z
|
|
132
|
+
.strictObject({ submissions: RateSchema.optional(), relayedRuns: RateSchema.optional() })
|
|
133
|
+
.optional(),
|
|
134
|
+
ipv6Prefix: z.int().min(1).max(128).optional(),
|
|
135
|
+
})
|
|
136
|
+
.optional(),
|
|
137
|
+
ledger: z.strictObject({ walAutocheckpoint: z.int().min(0).optional() }).optional(),
|
|
138
|
+
relay: z
|
|
139
|
+
.strictObject({
|
|
140
|
+
waitingRunsPerArtifact: z.int().min(1).optional(),
|
|
141
|
+
drainPerSecond: z.number().positive().optional(),
|
|
142
|
+
})
|
|
143
|
+
.optional(),
|
|
144
|
+
homes: z.strictObject({ idleCloseMinutes: z.number().positive().optional() }).optional(),
|
|
145
|
+
framing: z.strictObject({ frameAncestors: z.literal("'none'") }).optional(),
|
|
146
|
+
operator: z.string().optional(),
|
|
147
|
+
chatHosts: z.record(z.string(), z.unknown()).optional(),
|
|
148
|
+
});
|
|
149
|
+
|
|
150
|
+
/** The configuration keys, and the variable each also comes from. */
|
|
151
|
+
const KEYS = Object.keys(Config.shape) as (keyof RemoteServerConfig)[];
|
|
152
|
+
|
|
153
|
+
/** `apiOrigin` → `MOSTRA_SERVER_API_ORIGIN`. */
|
|
154
|
+
function variableOf(key: string): string {
|
|
155
|
+
return `MOSTRA_SERVER_${key.replace(/[A-Z]/g, (letter) => `_${letter}`).toUpperCase()}`;
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
function invalid(message: string): RpcError {
|
|
159
|
+
return new RpcError(createDiagnostic("MOSTRA_REMOTE_CONFIG_INVALID", { message }));
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
/**
|
|
163
|
+
* Reads the configuration: the file, then each `MOSTRA_SERVER_<KEY>` (a string for a string key,
|
|
164
|
+
* JSON for the others) over it. Throws `MOSTRA_REMOTE_CONFIG_INVALID` naming the first key it
|
|
165
|
+
* can't use.
|
|
166
|
+
*/
|
|
167
|
+
export function readServerConfig(file: string | undefined, env: Environment): RemoteServerConfig {
|
|
168
|
+
let raw: Record<string, unknown> = {};
|
|
169
|
+
if (file !== undefined) {
|
|
170
|
+
let text: string;
|
|
171
|
+
try {
|
|
172
|
+
text = readFileSync(file, "utf8");
|
|
173
|
+
} catch (error) {
|
|
174
|
+
throw invalid(
|
|
175
|
+
`The configuration file ${file} can't be read (${(error as NodeJS.ErrnoException).code ?? "error"}).`,
|
|
176
|
+
);
|
|
177
|
+
}
|
|
178
|
+
try {
|
|
179
|
+
const parsed = JSON.parse(text) as unknown;
|
|
180
|
+
if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
|
|
181
|
+
throw new Error("not an object");
|
|
182
|
+
}
|
|
183
|
+
raw = parsed as Record<string, unknown>;
|
|
184
|
+
} catch {
|
|
185
|
+
throw invalid(`The configuration file ${file} isn't a JSON object.`);
|
|
186
|
+
}
|
|
187
|
+
}
|
|
188
|
+
for (const key of KEYS) {
|
|
189
|
+
const variable = variableOf(key);
|
|
190
|
+
const value = env[variable];
|
|
191
|
+
if (value === undefined || value === "") continue;
|
|
192
|
+
const stringKey = key === "apiOrigin" || key === "operator" || key === "scheme";
|
|
193
|
+
if (stringKey) raw[key] = value;
|
|
194
|
+
else {
|
|
195
|
+
try {
|
|
196
|
+
raw[key] = JSON.parse(value) as unknown;
|
|
197
|
+
} catch {
|
|
198
|
+
throw invalid(`${variable} isn't JSON.`);
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
}
|
|
202
|
+
const checked = Config.safeParse(raw);
|
|
203
|
+
if (!checked.success) {
|
|
204
|
+
const issue = checked.error.issues[0];
|
|
205
|
+
const path = issue?.path.join(".") || "(configuration)";
|
|
206
|
+
throw invalid(
|
|
207
|
+
`The configuration key \`${path}\` can't be used: ${issue?.message ?? "invalid"}.`,
|
|
208
|
+
);
|
|
209
|
+
}
|
|
210
|
+
const config = checked.data;
|
|
211
|
+
const domains = [config.domains.active, ...(config.domains.spares ?? [])];
|
|
212
|
+
const api = new URL(config.apiOrigin).host;
|
|
213
|
+
if (domains.some((domain) => domain === api || api.endsWith(`.${domain}`))) {
|
|
214
|
+
throw invalid(
|
|
215
|
+
"The configuration key `apiOrigin` can't be on a user-content domain: sign-in and the binding live apart from tenant pages (D165 item 7).",
|
|
216
|
+
);
|
|
217
|
+
}
|
|
218
|
+
const proxy = validProxies(config.trustedProxies ?? []);
|
|
219
|
+
if (proxy !== undefined) {
|
|
220
|
+
throw invalid(
|
|
221
|
+
`The configuration key \`trustedProxies\` names ${JSON.stringify(proxy)}, which is neither an address nor a CIDR block.`,
|
|
222
|
+
);
|
|
223
|
+
}
|
|
224
|
+
if (new Set(domains).size !== domains.length) {
|
|
225
|
+
throw invalid("The configuration key `domains` names one domain twice.");
|
|
226
|
+
}
|
|
227
|
+
return config;
|
|
228
|
+
}
|