@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,650 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The remote server (ARCHITECTURE §15, INTERFACES §18, D165): one process holding many hosted
|
|
3
|
+
* homes behind one listener. It speaks plain HTTP behind a TLS terminator and routes every request
|
|
4
|
+
* by its exact `Host`: the API origin (the network binding, version files, sign-in) or a
|
|
5
|
+
* user-content domain (the hosted shell on its apex, an artifact's pages on its route's label).
|
|
6
|
+
* It runs no artifact code: server code runs on each artifact's owner instance, through the relay.
|
|
7
|
+
*
|
|
8
|
+
* ```ts
|
|
9
|
+
* const server = await startServer({ data: "/var/lib/mostra", config: readServerConfig(file, env), … });
|
|
10
|
+
* // … mostra-runtime server serves until it is stopped
|
|
11
|
+
* await server.close();
|
|
12
|
+
* ```
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
import { readFileSync } from "node:fs";
|
|
16
|
+
import { createServer, type IncomingMessage, type Server, type ServerResponse } from "node:http";
|
|
17
|
+
import type { AddressInfo } from "node:net";
|
|
18
|
+
import { join } from "node:path";
|
|
19
|
+
import type { Duplex } from "node:stream";
|
|
20
|
+
import { getRequestListener } from "@hono/node-server";
|
|
21
|
+
import {
|
|
22
|
+
createDiagnostic,
|
|
23
|
+
type Diagnostic,
|
|
24
|
+
type Duration,
|
|
25
|
+
durationMs,
|
|
26
|
+
RouteId,
|
|
27
|
+
RpcError,
|
|
28
|
+
} from "@mostra/protocol";
|
|
29
|
+
import { faultsFrom } from "../faults.ts";
|
|
30
|
+
import {
|
|
31
|
+
BASE_HEADERS,
|
|
32
|
+
documentHeaders,
|
|
33
|
+
locateShell,
|
|
34
|
+
resetOnClose,
|
|
35
|
+
shellAssetResponse,
|
|
36
|
+
} from "../gateway/index.ts";
|
|
37
|
+
import { appendEvent } from "../interaction/index.ts";
|
|
38
|
+
import type { LedgerOwner } from "../ledger/index.ts";
|
|
39
|
+
import type { Environment, Log } from "../log.ts";
|
|
40
|
+
import { type Api, createApi } from "./api.ts";
|
|
41
|
+
import { type Authorization, createAuthorization } from "./auth.ts";
|
|
42
|
+
import { type Authorize, createAuthorize } from "./authorize.ts";
|
|
43
|
+
import { clientAddresses, RateLimiter } from "./clients.ts";
|
|
44
|
+
import type { RemoteServerConfig } from "./config.ts";
|
|
45
|
+
import { type DataDirectory, type HomeAssembler, openDataDirectory } from "./data.ts";
|
|
46
|
+
import { createHandle } from "./handle.ts";
|
|
47
|
+
import { type HostedHome, type HostedServices, openHostedHome } from "./hosted.ts";
|
|
48
|
+
import { type HomeOwner, homeUnavailable } from "./hosted-pages.ts";
|
|
49
|
+
import { createRemoteMcp, serverDocs } from "./mcp.ts";
|
|
50
|
+
import { createMeter, type Meter } from "./metering.ts";
|
|
51
|
+
import { createClients } from "./oauth-clients.ts";
|
|
52
|
+
import { loadOperator, type Operator } from "./operator.ts";
|
|
53
|
+
import { type BuiltInProvider, builtInProviders } from "./providers.ts";
|
|
54
|
+
import { createRouting, type Destination, type Routing } from "./routing.ts";
|
|
55
|
+
|
|
56
|
+
export { type RemoteServerConfig, readServerConfig } from "./config.ts";
|
|
57
|
+
|
|
58
|
+
/** Options for {@link startServer}. */
|
|
59
|
+
export interface ServerOptions {
|
|
60
|
+
/** The data directory (`--data`). */
|
|
61
|
+
readonly data: string;
|
|
62
|
+
readonly config: RemoteServerConfig;
|
|
63
|
+
/** `host:port` to listen on (`--listen`). Default `127.0.0.1:8080`. */
|
|
64
|
+
readonly listen?: string;
|
|
65
|
+
/** Homes restored from a backup by hand (`--restored`): their incarnations rotate first. */
|
|
66
|
+
readonly restored?: readonly string[];
|
|
67
|
+
readonly runtimeVersion: string;
|
|
68
|
+
readonly owner: LedgerOwner;
|
|
69
|
+
readonly log: Log;
|
|
70
|
+
readonly env: Environment;
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
/** A running remote server. */
|
|
74
|
+
export interface RemoteServer {
|
|
75
|
+
/** Where it listens: `http://host:port`. */
|
|
76
|
+
readonly address: string;
|
|
77
|
+
readonly config: RemoteServerConfig;
|
|
78
|
+
/** Stops listening, closes every hosted home, then the directory, and releases the locks. */
|
|
79
|
+
close(): Promise<void>;
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
/** An answer as JSON, with the headers every server answer carries. */
|
|
83
|
+
function json(response: ServerResponse, status: number, body: unknown): void {
|
|
84
|
+
const text = JSON.stringify(body);
|
|
85
|
+
response.writeHead(status, {
|
|
86
|
+
"content-type": "application/json; charset=utf-8",
|
|
87
|
+
"content-length": Buffer.byteLength(text),
|
|
88
|
+
"cache-control": "no-store",
|
|
89
|
+
"cross-origin-resource-policy": "same-origin",
|
|
90
|
+
"referrer-policy": "no-referrer",
|
|
91
|
+
"x-content-type-options": "nosniff",
|
|
92
|
+
});
|
|
93
|
+
response.end(text);
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
function refusal(response: ServerResponse, status: number, diagnostic: Diagnostic): void {
|
|
97
|
+
json(response, status, diagnostic);
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
/** Splits `host:port`, with `[::1]:port` for IPv6. */
|
|
101
|
+
function parseListen(listen: string): { host: string; port: number } {
|
|
102
|
+
const match = /^(\[[^\]]+\]|[^:]+):(\d{1,5})$/.exec(listen);
|
|
103
|
+
if (!match) {
|
|
104
|
+
throw new RpcError(
|
|
105
|
+
createDiagnostic("MOSTRA_REMOTE_CONFIG_INVALID", {
|
|
106
|
+
message: `--listen ${listen} isn't host:port.`,
|
|
107
|
+
}),
|
|
108
|
+
);
|
|
109
|
+
}
|
|
110
|
+
return { host: (match[1] as string).replace(/^\[|\]$/g, ""), port: Number(match[2]) };
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
/** Starts the remote server: its data directory, then its listener. */
|
|
114
|
+
export async function startServer(options: ServerOptions): Promise<RemoteServer> {
|
|
115
|
+
const { config, log } = options;
|
|
116
|
+
// The authorization server and the operator module are made once the directory is open; homes
|
|
117
|
+
// open only after both.
|
|
118
|
+
let auth: Authorization | undefined;
|
|
119
|
+
let operator: Operator | undefined;
|
|
120
|
+
let meter: Meter | undefined;
|
|
121
|
+
let routing: Routing;
|
|
122
|
+
let authorizer: Authorize | undefined;
|
|
123
|
+
let api: Api | undefined;
|
|
124
|
+
const shellDir = locateShell(options.env);
|
|
125
|
+
const clients = clientAddresses({
|
|
126
|
+
trustedProxies: config.trustedProxies,
|
|
127
|
+
ipv6Prefix: config.rateLimits?.ipv6Prefix,
|
|
128
|
+
});
|
|
129
|
+
const rates = new RateLimiter();
|
|
130
|
+
const faults = faultsFrom(options.env);
|
|
131
|
+
const rateOf = (rate: { count: number; per: string } | undefined) =>
|
|
132
|
+
rate === undefined ? undefined : { count: rate.count, perMs: durationMs(rate.per as Duration) };
|
|
133
|
+
/**
|
|
134
|
+
* `rateLimits.perIp.requests`: every request to the server, from one client address (IPv6 per
|
|
135
|
+
* /64), API origin and hosted hosts alike, before anything else is read (D165 item 13). A
|
|
136
|
+
* health check is never counted. Without the setting there is no limit.
|
|
137
|
+
*/
|
|
138
|
+
const perIpRequests = rateOf(config.rateLimits?.perIp?.requests);
|
|
139
|
+
/** Who owns a home, as its pages' sender line names them (D161). */
|
|
140
|
+
const ownerOf = (homeId: string): HomeOwner => {
|
|
141
|
+
const row = data.directory.read((db) =>
|
|
142
|
+
db.get<{ account: string; name: string | null; provider: string | null }>(
|
|
143
|
+
`SELECT a.id AS account, a.name, (SELECT i.provider FROM identity i WHERE i.account_id = a.id
|
|
144
|
+
ORDER BY i.linked_at LIMIT 1) AS provider
|
|
145
|
+
FROM home h JOIN account a ON a.id = h.owner_account_id WHERE h.id = ?`,
|
|
146
|
+
homeId,
|
|
147
|
+
),
|
|
148
|
+
);
|
|
149
|
+
if (!row) return { account: "" };
|
|
150
|
+
const provider = config.identityProviders?.find((candidate) => candidate.id === row.provider);
|
|
151
|
+
// A name the development provider took on trust is unverified (D161).
|
|
152
|
+
const verifiedBy =
|
|
153
|
+
provider && provider.kind !== "development"
|
|
154
|
+
? (provider.label ?? (provider.kind === "github" ? "GitHub" : provider.id))
|
|
155
|
+
: undefined;
|
|
156
|
+
return {
|
|
157
|
+
account: row.account,
|
|
158
|
+
...(row.name !== null ? { name: row.name } : {}),
|
|
159
|
+
...(verifiedBy !== undefined ? { verifiedBy } : {}),
|
|
160
|
+
};
|
|
161
|
+
};
|
|
162
|
+
const services = (): HostedServices => ({
|
|
163
|
+
operator: operator as Operator,
|
|
164
|
+
clients,
|
|
165
|
+
rates,
|
|
166
|
+
rateLimits: {
|
|
167
|
+
perIpSubmissions: rateOf(config.rateLimits?.perIp?.submissions),
|
|
168
|
+
perLinkSubmissions: rateOf(config.rateLimits?.perLink?.submissions),
|
|
169
|
+
},
|
|
170
|
+
owner: ownerOf,
|
|
171
|
+
meter: meter as Meter,
|
|
172
|
+
routing,
|
|
173
|
+
signin: {
|
|
174
|
+
start: (signin, challenge) => (authorizer as Authorize).startViewerSignin(signin, challenge),
|
|
175
|
+
finish: (input) => (authorizer as Authorize).finishViewerSignin(input),
|
|
176
|
+
},
|
|
177
|
+
signInOffered: () =>
|
|
178
|
+
(config.identityProviders?.length ?? 0) > 0 || (operator?.has.identity ?? false),
|
|
179
|
+
});
|
|
180
|
+
const assembler: HomeAssembler<HostedHome> = {
|
|
181
|
+
assemble: (home) =>
|
|
182
|
+
openHostedHome({
|
|
183
|
+
faults,
|
|
184
|
+
id: home.id,
|
|
185
|
+
dir: home.dir,
|
|
186
|
+
ledger: home.ledger,
|
|
187
|
+
incarnation: home.incarnation,
|
|
188
|
+
directory: data.directory,
|
|
189
|
+
filesDir: join(options.data, "files"),
|
|
190
|
+
auth: auth as Authorization,
|
|
191
|
+
runtimeVersion: options.runtimeVersion,
|
|
192
|
+
log,
|
|
193
|
+
scheme: config.scheme ?? "https",
|
|
194
|
+
domains: { active: config.domains.active, spares: config.domains.spares ?? [] },
|
|
195
|
+
shellDir,
|
|
196
|
+
services: services(),
|
|
197
|
+
relay: {
|
|
198
|
+
waitingRunsPerArtifact: config.relay?.waitingRunsPerArtifact,
|
|
199
|
+
drainPerSecond: config.relay?.drainPerSecond,
|
|
200
|
+
...(config.rateLimits?.perLink?.relayedRuns
|
|
201
|
+
? {
|
|
202
|
+
perLink: {
|
|
203
|
+
count: config.rateLimits.perLink.relayedRuns.count,
|
|
204
|
+
perMs: durationMs(config.rateLimits.perLink.relayedRuns.per as Duration),
|
|
205
|
+
},
|
|
206
|
+
}
|
|
207
|
+
: {}),
|
|
208
|
+
...(options.env["MOSTRA_TEST_RELAY_LIVE_MS"] !== undefined
|
|
209
|
+
? { liveRenewMs: Number(options.env["MOSTRA_TEST_RELAY_LIVE_MS"]) }
|
|
210
|
+
: {}),
|
|
211
|
+
...(options.env["MOSTRA_TEST_RELAY_SWEEP_MS"] !== undefined
|
|
212
|
+
? { sweepMs: Number(options.env["MOSTRA_TEST_RELAY_SWEEP_MS"]) }
|
|
213
|
+
: {}),
|
|
214
|
+
},
|
|
215
|
+
}),
|
|
216
|
+
disassemble: (home) => home.stop(),
|
|
217
|
+
incarnation: (home) => home.incarnation(),
|
|
218
|
+
busy: (home) => home.busy(),
|
|
219
|
+
};
|
|
220
|
+
const data: DataDirectory<HostedHome> = await openDataDirectory({
|
|
221
|
+
dir: options.data,
|
|
222
|
+
runtimeVersion: options.runtimeVersion,
|
|
223
|
+
owner: options.owner,
|
|
224
|
+
log,
|
|
225
|
+
env: options.env,
|
|
226
|
+
assembler,
|
|
227
|
+
...(options.restored !== undefined ? { restored: options.restored } : {}),
|
|
228
|
+
...(config.homes?.idleCloseMinutes !== undefined
|
|
229
|
+
? { idleCloseMs: config.homes.idleCloseMinutes * 60_000 }
|
|
230
|
+
: {}),
|
|
231
|
+
...(config.ledger?.walAutocheckpoint !== undefined
|
|
232
|
+
? { walAutocheckpoint: config.ledger.walAutocheckpoint }
|
|
233
|
+
: {}),
|
|
234
|
+
});
|
|
235
|
+
const handle = createHandle({
|
|
236
|
+
apiOrigin: config.apiOrigin,
|
|
237
|
+
data: () => data,
|
|
238
|
+
directory: () => data.directory,
|
|
239
|
+
suspended: (homeId) => api?.closeHome(homeId),
|
|
240
|
+
log,
|
|
241
|
+
});
|
|
242
|
+
try {
|
|
243
|
+
operator = await loadOperator({
|
|
244
|
+
path: config.operator,
|
|
245
|
+
handle,
|
|
246
|
+
directory: data.directory,
|
|
247
|
+
log,
|
|
248
|
+
...(Number(options.env["MOSTRA_TEST_OPERATOR_DISPATCH_MS"]) > 0
|
|
249
|
+
? { dispatchMs: Number(options.env["MOSTRA_TEST_OPERATOR_DISPATCH_MS"]) }
|
|
250
|
+
: {}),
|
|
251
|
+
});
|
|
252
|
+
} catch (error) {
|
|
253
|
+
await data.close();
|
|
254
|
+
throw error;
|
|
255
|
+
}
|
|
256
|
+
routing = createRouting({
|
|
257
|
+
apiHost: new URL(config.apiOrigin).host,
|
|
258
|
+
domains: () => [config.domains.active, ...(config.domains.spares ?? [])],
|
|
259
|
+
active: () => config.domains.active,
|
|
260
|
+
directory: data.directory,
|
|
261
|
+
operator,
|
|
262
|
+
log,
|
|
263
|
+
});
|
|
264
|
+
meter = createMeter({
|
|
265
|
+
operator,
|
|
266
|
+
keysDir: join(options.data, "keys"),
|
|
267
|
+
log,
|
|
268
|
+
...(Number(options.env["MOSTRA_TEST_METER_WINDOW_MS"]) > 0
|
|
269
|
+
? { windowMs: Number(options.env["MOSTRA_TEST_METER_WINDOW_MS"]) }
|
|
270
|
+
: {}),
|
|
271
|
+
activeHomes: () => data.open().map((home) => ({ home, account: ownerOf(home).account })),
|
|
272
|
+
});
|
|
273
|
+
auth = createAuthorization({
|
|
274
|
+
directory: data.directory,
|
|
275
|
+
config,
|
|
276
|
+
log,
|
|
277
|
+
operator,
|
|
278
|
+
...(Number(options.env["MOSTRA_TEST_ACCESS_TTL_MS"]) > 0
|
|
279
|
+
? { accessTtlMs: Number(options.env["MOSTRA_TEST_ACCESS_TTL_MS"]) }
|
|
280
|
+
: {}),
|
|
281
|
+
...(Number(options.env["MOSTRA_TEST_ROTATION_GRACE_MS"]) > 0
|
|
282
|
+
? { rotationGraceMs: Number(options.env["MOSTRA_TEST_ROTATION_GRACE_MS"]) }
|
|
283
|
+
: {}),
|
|
284
|
+
// A new instance link is a hosted event the account's instances see (§18.5).
|
|
285
|
+
linked: ({ homeId, linkId, name }) => {
|
|
286
|
+
void data.home(homeId).then(
|
|
287
|
+
(home) =>
|
|
288
|
+
home.assembled.ledger.write((db) =>
|
|
289
|
+
appendEvent(db, {
|
|
290
|
+
artifactId: null,
|
|
291
|
+
type: "instance.linked",
|
|
292
|
+
actor: { kind: "mostra" },
|
|
293
|
+
payload: { instanceId: linkId, name },
|
|
294
|
+
}),
|
|
295
|
+
),
|
|
296
|
+
(error: unknown) => log.error("server.linked_event_failed", { home: homeId, error }),
|
|
297
|
+
);
|
|
298
|
+
},
|
|
299
|
+
});
|
|
300
|
+
// The authorization server's clients and browser pages (INTERFACES §18.5).
|
|
301
|
+
const scheme = config.scheme ?? "https";
|
|
302
|
+
const oauthClients = createClients({
|
|
303
|
+
directory: data.directory,
|
|
304
|
+
log,
|
|
305
|
+
env: options.env,
|
|
306
|
+
isShellOrigin: (origin) => {
|
|
307
|
+
if (!origin.startsWith(`${scheme}://`)) return false;
|
|
308
|
+
const host = origin.slice(scheme.length + 3);
|
|
309
|
+
if (domains.includes(host)) return true;
|
|
310
|
+
return (
|
|
311
|
+
data.directory.read((db) => db.get("SELECT 1 FROM operator_host WHERE host = ?", host)) !==
|
|
312
|
+
undefined
|
|
313
|
+
);
|
|
314
|
+
},
|
|
315
|
+
});
|
|
316
|
+
let providers: BuiltInProvider[];
|
|
317
|
+
try {
|
|
318
|
+
providers = builtInProviders(config.identityProviders ?? [], {
|
|
319
|
+
apiOrigin: config.apiOrigin,
|
|
320
|
+
env: options.env,
|
|
321
|
+
log,
|
|
322
|
+
});
|
|
323
|
+
} catch (error) {
|
|
324
|
+
operator?.stop();
|
|
325
|
+
await data.close();
|
|
326
|
+
throw error;
|
|
327
|
+
}
|
|
328
|
+
const authorize = createAuthorize({
|
|
329
|
+
apiOrigin: config.apiOrigin,
|
|
330
|
+
directory: data.directory,
|
|
331
|
+
auth,
|
|
332
|
+
clients: oauthClients,
|
|
333
|
+
operator,
|
|
334
|
+
providers,
|
|
335
|
+
ownerName: (homeId) => ownerOf(homeId).name,
|
|
336
|
+
log,
|
|
337
|
+
});
|
|
338
|
+
authorizer = authorize;
|
|
339
|
+
const mcp = createRemoteMcp({
|
|
340
|
+
apiOrigin: config.apiOrigin,
|
|
341
|
+
version: options.runtimeVersion,
|
|
342
|
+
docs: serverDocs(),
|
|
343
|
+
log,
|
|
344
|
+
operator,
|
|
345
|
+
meter,
|
|
346
|
+
home: async (id) => (await data.home(id)).assembled,
|
|
347
|
+
ensureHome: (accountId) => (auth as Authorization).ensureHome(accountId),
|
|
348
|
+
});
|
|
349
|
+
api = createApi({
|
|
350
|
+
config,
|
|
351
|
+
auth,
|
|
352
|
+
mcp,
|
|
353
|
+
authorize,
|
|
354
|
+
clients: oauthClients,
|
|
355
|
+
registrations: { addresses: clients, rates },
|
|
356
|
+
operator,
|
|
357
|
+
log,
|
|
358
|
+
filesDir: join(options.data, "files"),
|
|
359
|
+
home: async (id) => (await data.home(id)).assembled,
|
|
360
|
+
touch: (id) => data.touch(id),
|
|
361
|
+
suspended: (id) => suspendedHome(id),
|
|
362
|
+
message: (id) => meter?.add("relay.messages", { account: ownerOf(id).account, home: id }),
|
|
363
|
+
stored: (id, bytes) =>
|
|
364
|
+
meter?.add("bytes.stored", { account: ownerOf(id).account, home: id }, bytes),
|
|
365
|
+
...(Number(options.env["MOSTRA_TEST_GRANT_RECHECK_MS"]) > 0
|
|
366
|
+
? { recheckMs: Number(options.env["MOSTRA_TEST_GRANT_RECHECK_MS"]) }
|
|
367
|
+
: {}),
|
|
368
|
+
});
|
|
369
|
+
const served: Api = api;
|
|
370
|
+
const apiHost = new URL(config.apiOrigin).host;
|
|
371
|
+
const domains = [config.domains.active, ...(config.domains.spares ?? [])];
|
|
372
|
+
|
|
373
|
+
const onRequest = (request: IncomingMessage, response: ServerResponse): void => {
|
|
374
|
+
const host = (request.headers.host ?? "").toLowerCase();
|
|
375
|
+
const path = (request.url ?? "/").split("?")[0] ?? "/";
|
|
376
|
+
// Cookies never reach anything on a hosted host (D165 item 8): dropped before routing. Only
|
|
377
|
+
// the API origin's own sign-in pages read the cookies it set itself.
|
|
378
|
+
if (host !== apiHost) delete request.headers.cookie;
|
|
379
|
+
if (host === apiHost && request.method === "GET" && path === "/health") {
|
|
380
|
+
json(response, 200, { status: "ok", homes: data.open().length });
|
|
381
|
+
return;
|
|
382
|
+
}
|
|
383
|
+
if (perIpRequests) {
|
|
384
|
+
const taken = rates.take(`request-ip:${clients.keyOf(clients.of(request))}`, perIpRequests);
|
|
385
|
+
if (!taken.ok) {
|
|
386
|
+
response.setHeader("retry-after", String(taken.retryAfterS));
|
|
387
|
+
refusal(
|
|
388
|
+
response,
|
|
389
|
+
429,
|
|
390
|
+
createDiagnostic("MOSTRA_REMOTE_RATE_LIMITED", {
|
|
391
|
+
message: "Too many requests from this address; try again shortly.",
|
|
392
|
+
}),
|
|
393
|
+
);
|
|
394
|
+
return;
|
|
395
|
+
}
|
|
396
|
+
}
|
|
397
|
+
if (host === apiHost) {
|
|
398
|
+
served.request(request, response, path).catch((error: unknown) => {
|
|
399
|
+
log.error("server.api_failed", { path, error });
|
|
400
|
+
if (!response.headersSent) {
|
|
401
|
+
refusal(
|
|
402
|
+
response,
|
|
403
|
+
500,
|
|
404
|
+
createDiagnostic("MOSTRA_HOST_INTERNAL_ERROR", {
|
|
405
|
+
message: "The server failed to answer.",
|
|
406
|
+
}),
|
|
407
|
+
);
|
|
408
|
+
} else response.destroy();
|
|
409
|
+
});
|
|
410
|
+
return;
|
|
411
|
+
}
|
|
412
|
+
const hostRefused = (): void =>
|
|
413
|
+
refusal(
|
|
414
|
+
response,
|
|
415
|
+
421,
|
|
416
|
+
createDiagnostic("MOSTRA_HYGIENE_HOST_REFUSED", {
|
|
417
|
+
message: "This server serves no pages at this host.",
|
|
418
|
+
}),
|
|
419
|
+
);
|
|
420
|
+
// An empty or malformed Host gets nothing, and is never asked of an operator.
|
|
421
|
+
if (!/^[a-z0-9.-]{1,253}(:\d{1,5})?$/.test(host)) {
|
|
422
|
+
hostRefused();
|
|
423
|
+
return;
|
|
424
|
+
}
|
|
425
|
+
routing
|
|
426
|
+
.destination(host)
|
|
427
|
+
.then(async (destination) => {
|
|
428
|
+
if (destination.kind === "none" || destination.kind === "api") {
|
|
429
|
+
hostRefused();
|
|
430
|
+
return;
|
|
431
|
+
}
|
|
432
|
+
// Every hosted answer keeps its page in an agent cluster of its own and out of indexes
|
|
433
|
+
// (ARCHITECTURE §15.6, D161).
|
|
434
|
+
response.setHeader("origin-agent-cluster", "?1");
|
|
435
|
+
response.setHeader("x-robots-tag", "noindex");
|
|
436
|
+
await hosted(request, response, destination, path);
|
|
437
|
+
})
|
|
438
|
+
.catch((error: unknown) => {
|
|
439
|
+
log.error("server.hosted_failed", { error });
|
|
440
|
+
if (!response.headersSent) {
|
|
441
|
+
refusal(
|
|
442
|
+
response,
|
|
443
|
+
500,
|
|
444
|
+
createDiagnostic("MOSTRA_HOST_INTERNAL_ERROR", {
|
|
445
|
+
message: "The server failed to answer.",
|
|
446
|
+
}),
|
|
447
|
+
);
|
|
448
|
+
} else response.destroy();
|
|
449
|
+
});
|
|
450
|
+
};
|
|
451
|
+
|
|
452
|
+
const notServed = (response: ServerResponse): void =>
|
|
453
|
+
refusal(
|
|
454
|
+
response,
|
|
455
|
+
404,
|
|
456
|
+
createDiagnostic("MOSTRA_HYGIENE_NOT_SERVED", { message: "Nothing is served at this path." }),
|
|
457
|
+
);
|
|
458
|
+
|
|
459
|
+
/** The shell's own files, the same on every domain's apex. */
|
|
460
|
+
const assets = getRequestListener(
|
|
461
|
+
async (request: Request) =>
|
|
462
|
+
(shellDir === undefined ? undefined : await shellAssetResponse(shellDir, request)) ??
|
|
463
|
+
new Response(
|
|
464
|
+
JSON.stringify(
|
|
465
|
+
createDiagnostic("MOSTRA_HYGIENE_NOT_SERVED", { message: "No shell file at this path." }),
|
|
466
|
+
),
|
|
467
|
+
{
|
|
468
|
+
status: 404,
|
|
469
|
+
headers: { "content-type": "application/json", "cache-control": "no-store" },
|
|
470
|
+
},
|
|
471
|
+
),
|
|
472
|
+
{ overrideGlobalObjects: false },
|
|
473
|
+
);
|
|
474
|
+
|
|
475
|
+
/** Whether the operator suspended a home (`ServerHandle.suspendHome`). */
|
|
476
|
+
const suspendedHome = (homeId: string): boolean =>
|
|
477
|
+
data.directory.read(
|
|
478
|
+
(db) =>
|
|
479
|
+
db.get<{ suspended_at: string | null }>(
|
|
480
|
+
"SELECT suspended_at FROM home WHERE id = ?",
|
|
481
|
+
homeId,
|
|
482
|
+
)?.suspended_at != null,
|
|
483
|
+
);
|
|
484
|
+
|
|
485
|
+
/**
|
|
486
|
+
* A home whose pages are served now: a suspended one answers 403 and one being moved 503,
|
|
487
|
+
* each with its diagnostic, and nothing of it is opened for a page (D165 item 9).
|
|
488
|
+
*/
|
|
489
|
+
const pagesOf = async (homeId: string, response: ServerResponse) => {
|
|
490
|
+
if (suspendedHome(homeId)) {
|
|
491
|
+
refusal(response, 403, homeUnavailable("suspended"));
|
|
492
|
+
return undefined;
|
|
493
|
+
}
|
|
494
|
+
try {
|
|
495
|
+
const opened = await data.home(homeId);
|
|
496
|
+
// Requests and the bytes they sent count against the home's owner (metering, §18.6): one
|
|
497
|
+
// HTTP/1.1 connection answers one request at a time, so its written bytes are this one's.
|
|
498
|
+
if (meter?.on) {
|
|
499
|
+
const socket = response.socket;
|
|
500
|
+
const before = socket?.bytesWritten ?? 0;
|
|
501
|
+
response.once("finish", () => {
|
|
502
|
+
const account = ownerOf(homeId).account;
|
|
503
|
+
meter?.add("requests", { account, home: homeId });
|
|
504
|
+
meter?.add(
|
|
505
|
+
"bytes.egress",
|
|
506
|
+
{ account, home: homeId },
|
|
507
|
+
Math.max(0, (socket?.bytesWritten ?? before) - before),
|
|
508
|
+
);
|
|
509
|
+
});
|
|
510
|
+
}
|
|
511
|
+
return opened;
|
|
512
|
+
} catch (error) {
|
|
513
|
+
if (error instanceof RpcError && error.diagnostic.code === "MOSTRA_REMOTE_HOME_MOVING") {
|
|
514
|
+
response.setHeader("retry-after", "30");
|
|
515
|
+
refusal(response, 503, error.diagnostic);
|
|
516
|
+
return undefined;
|
|
517
|
+
}
|
|
518
|
+
throw error;
|
|
519
|
+
}
|
|
520
|
+
};
|
|
521
|
+
|
|
522
|
+
/** A route of the directory: its home and ID, by ID or by label. */
|
|
523
|
+
const routeBy = (column: "id" | "label", value: string) =>
|
|
524
|
+
data.directory.read((db) =>
|
|
525
|
+
db.get<{ id: string; home_id: string }>(
|
|
526
|
+
`SELECT id, home_id FROM artifact_route WHERE ${column} = ? AND removing_json IS NULL`,
|
|
527
|
+
value,
|
|
528
|
+
),
|
|
529
|
+
);
|
|
530
|
+
|
|
531
|
+
/**
|
|
532
|
+
* A hosted request (§18.4): a shell (a configured apex, or an operator's host for one home or
|
|
533
|
+
* one route) serves only `/a/<routeId>` of the routes it may show and the shell's files; a
|
|
534
|
+
* route's label serves that route's frames.
|
|
535
|
+
*/
|
|
536
|
+
const hosted = async (
|
|
537
|
+
request: IncomingMessage,
|
|
538
|
+
response: ServerResponse,
|
|
539
|
+
destination: Exclude<Destination, { kind: "none" | "api" }>,
|
|
540
|
+
path: string,
|
|
541
|
+
): Promise<void> => {
|
|
542
|
+
if (destination.kind === "shell") {
|
|
543
|
+
if (path.startsWith("/_mostra/shell/assets/")) {
|
|
544
|
+
await assets(request, response);
|
|
545
|
+
return;
|
|
546
|
+
}
|
|
547
|
+
// Where a page's sign-in returns (INTERFACES §18.4): the shell's own page, which finishes it
|
|
548
|
+
// for the route that started it. It reads only the fragment and query it was sent.
|
|
549
|
+
if (path === "/_mostra/signin" && (request.method === "GET" || request.method === "HEAD")) {
|
|
550
|
+
if (shellDir === undefined) {
|
|
551
|
+
notServed(response);
|
|
552
|
+
return;
|
|
553
|
+
}
|
|
554
|
+
const html = readFileSync(join(shellDir, "index.html"));
|
|
555
|
+
response.writeHead(200, {
|
|
556
|
+
...BASE_HEADERS,
|
|
557
|
+
...documentHeaders({ kind: "shell", origin: "", shellOrigin: "" }, "'none'"),
|
|
558
|
+
"content-type": "text/html; charset=utf-8",
|
|
559
|
+
"cache-control": "no-store",
|
|
560
|
+
});
|
|
561
|
+
response.end(request.method === "HEAD" ? undefined : html);
|
|
562
|
+
return;
|
|
563
|
+
}
|
|
564
|
+
const match = /^\/a\/(rte_[0-9A-HJKMNP-TV-Z]{26})(?:\/|$)/.exec(path);
|
|
565
|
+
const route =
|
|
566
|
+
match?.[1] !== undefined && RouteId.is(match[1]) ? routeBy("id", match[1]) : undefined;
|
|
567
|
+
// An operator's host shows only its own home's routes, or its one route.
|
|
568
|
+
if (
|
|
569
|
+
!route ||
|
|
570
|
+
(destination.homeId !== undefined && route.home_id !== destination.homeId) ||
|
|
571
|
+
(destination.routeId !== undefined && route.id !== destination.routeId)
|
|
572
|
+
) {
|
|
573
|
+
notServed(response);
|
|
574
|
+
return;
|
|
575
|
+
}
|
|
576
|
+
const home = await pagesOf(route.home_id, response);
|
|
577
|
+
if (!home) return;
|
|
578
|
+
await home.assembled.serve(request, response, {
|
|
579
|
+
kind: "shell",
|
|
580
|
+
domain: destination.host,
|
|
581
|
+
routeId: route.id,
|
|
582
|
+
});
|
|
583
|
+
return;
|
|
584
|
+
}
|
|
585
|
+
const home = await pagesOf(destination.route.homeId, response);
|
|
586
|
+
if (!home) return;
|
|
587
|
+
await home.assembled.serve(request, response, {
|
|
588
|
+
kind: "frame",
|
|
589
|
+
domain: destination.frameDomain,
|
|
590
|
+
routeId: destination.route.id,
|
|
591
|
+
});
|
|
592
|
+
};
|
|
593
|
+
|
|
594
|
+
// Up to 1 MiB of headers (D98 item 9): a sibling tenant page can fill the parent domain's cookie
|
|
595
|
+
// jar (180 cookies of 4 KiB, no public-suffix entry, D137), and its cookies, dropped unread here,
|
|
596
|
+
// must never cost another page its session (D165 item 8).
|
|
597
|
+
const listener: Server = createServer({ maxHeaderSize: 1024 * 1024 }, onRequest);
|
|
598
|
+
// Stopping resets its connections, so none stays in TIME_WAIT on the server's port (#132).
|
|
599
|
+
const stopListener = resetOnClose(listener);
|
|
600
|
+
listener.keepAliveTimeout = 305_000;
|
|
601
|
+
listener.headersTimeout = 30_000;
|
|
602
|
+
listener.requestTimeout = 120_000;
|
|
603
|
+
listener.on("upgrade", (request: IncomingMessage, socket: Duplex, head: Buffer) => {
|
|
604
|
+
const host = (request.headers.host ?? "").toLowerCase();
|
|
605
|
+
const path = (request.url ?? "/").split("?")[0] ?? "/";
|
|
606
|
+
if (host === apiHost) {
|
|
607
|
+
served.upgrade(request, socket, head, path);
|
|
608
|
+
return;
|
|
609
|
+
}
|
|
610
|
+
socket.end("HTTP/1.1 404 Not Found\r\nconnection: close\r\ncontent-length: 0\r\n\r\n");
|
|
611
|
+
});
|
|
612
|
+
const { host, port } = parseListen(options.listen ?? "127.0.0.1:8080");
|
|
613
|
+
try {
|
|
614
|
+
await new Promise<void>((resolve, reject) => {
|
|
615
|
+
listener.once("error", reject);
|
|
616
|
+
listener.listen(port, host, () => {
|
|
617
|
+
listener.off("error", reject);
|
|
618
|
+
resolve();
|
|
619
|
+
});
|
|
620
|
+
});
|
|
621
|
+
} catch (error) {
|
|
622
|
+
await data.close();
|
|
623
|
+
throw new RpcError(
|
|
624
|
+
createDiagnostic("MOSTRA_ENV_BIND_FAILED", {
|
|
625
|
+
message: `The server can't listen on ${host}:${port}: ${(error as NodeJS.ErrnoException).code ?? (error as Error).message}.`,
|
|
626
|
+
}),
|
|
627
|
+
);
|
|
628
|
+
}
|
|
629
|
+
const bound = listener.address() as AddressInfo;
|
|
630
|
+
const address = `http://${bound.family === "IPv6" ? `[${bound.address}]` : bound.address}:${bound.port}`;
|
|
631
|
+
log.info("server.listening", { address, apiOrigin: config.apiOrigin, domains: [...domains] });
|
|
632
|
+
let closing: Promise<void> | undefined;
|
|
633
|
+
return {
|
|
634
|
+
address,
|
|
635
|
+
config,
|
|
636
|
+
close() {
|
|
637
|
+
closing ??= (async () => {
|
|
638
|
+
served.close();
|
|
639
|
+
await mcp.close().catch(() => undefined);
|
|
640
|
+
// What the operator hasn't taken yet stays queued in the directory for the next start.
|
|
641
|
+
meter?.stop();
|
|
642
|
+
operator?.stop();
|
|
643
|
+
await stopListener();
|
|
644
|
+
await data.close();
|
|
645
|
+
log.info("server.stopped", {});
|
|
646
|
+
})();
|
|
647
|
+
return closing;
|
|
648
|
+
},
|
|
649
|
+
};
|
|
650
|
+
}
|