@mostra/runtime 0.10.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 +4058 -310
- package/dist/bin.js.map +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -1
- package/dist/{instance-FExcyENK.js → instance-DCiUHvgZ.js} +682 -47
- 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 +10 -5
- package/src/gateway/actions.ts +20 -0
- package/src/gateway/browser.ts +44 -0
- package/src/gateway/capabilities.ts +8 -0
- package/src/gateway/http.ts +12 -1
- package/src/gateway/index.ts +170 -5
- package/src/gateway/listener.ts +31 -6
- package/src/gateway/routes.ts +8 -0
- package/src/gc/index.ts +5 -0
- package/src/instance/index.ts +20 -1
- package/src/interaction/index.ts +60 -0
- package/src/interaction/pause.ts +106 -0
- package/src/interaction/submissions.ts +42 -1
- package/src/interaction/viewers.ts +34 -1
- package/src/ledger/index.ts +20 -1
- package/src/ledger/migrations.ts +51 -0
- package/src/link/author.ts +215 -0
- package/src/link/hosted.ts +37 -1
- package/src/link/http.ts +6 -1
- package/src/link/index.ts +3 -1
- package/src/link/manager.ts +138 -34
- package/src/protocol-server/client.ts +53 -0
- package/src/protocol-server/index.ts +1 -1
- package/src/server/api.ts +514 -72
- package/src/server/auth.ts +600 -74
- package/src/server/authorize.ts +816 -0
- package/src/server/clients.ts +235 -0
- package/src/server/config.ts +7 -0
- package/src/server/data.ts +59 -1
- package/src/server/directory.ts +69 -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 +519 -18
- package/src/server/index.ts +343 -61
- 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/remove.ts +148 -0
- package/src/server/routing.ts +275 -0
- package/src/verify/runner.ts +23 -2
- package/dist/instance-FExcyENK.js.map +0 -1
package/src/server/hosted.ts
CHANGED
|
@@ -12,13 +12,14 @@
|
|
|
12
12
|
*/
|
|
13
13
|
import { createHash, randomBytes } from "node:crypto";
|
|
14
14
|
import { linkSync, mkdirSync, writeFileSync } from "node:fs";
|
|
15
|
-
import { copyFile, readFile, rm } from "node:fs/promises";
|
|
15
|
+
import { copyFile, readFile, rm, stat } from "node:fs/promises";
|
|
16
16
|
import type { IncomingMessage, ServerResponse } from "node:http";
|
|
17
17
|
import { isAbsolute, join, relative } from "node:path";
|
|
18
18
|
import {
|
|
19
19
|
ArtifactManifest,
|
|
20
20
|
artifactGetMethod,
|
|
21
21
|
artifactListMethod,
|
|
22
|
+
artifactPauseMethod,
|
|
22
23
|
createDiagnostic,
|
|
23
24
|
type HostedPushParams,
|
|
24
25
|
type HostedPushResult,
|
|
@@ -26,13 +27,15 @@ import {
|
|
|
26
27
|
hostedPushMethod,
|
|
27
28
|
hostedSubmissionMethod,
|
|
28
29
|
type InstanceInfo,
|
|
30
|
+
type PausedBy,
|
|
29
31
|
RouteId,
|
|
30
32
|
RpcError,
|
|
31
33
|
remoteTokenMethod,
|
|
34
|
+
viewUrlMethod,
|
|
32
35
|
} from "@mostra/protocol";
|
|
33
36
|
import type { Addressing } from "../addressing/index.ts";
|
|
34
37
|
import { coverageMatcher, readFieldCoverage, readServerFunctions } from "../builder/index.ts";
|
|
35
|
-
import { noFaults } from "../faults.ts";
|
|
38
|
+
import { type Faults, noFaults } from "../faults.ts";
|
|
36
39
|
import {
|
|
37
40
|
Capabilities,
|
|
38
41
|
capabilityKey,
|
|
@@ -45,12 +48,25 @@ import { createEphemeralBus, createInteraction, type Interaction } from "../inte
|
|
|
45
48
|
import type { Ledger } from "../ledger/index.ts";
|
|
46
49
|
import { createLive, liveMethods } from "../live/index.ts";
|
|
47
50
|
import type { Log } from "../log.ts";
|
|
48
|
-
import {
|
|
51
|
+
import { removeTree } from "../platform/index.ts";
|
|
52
|
+
import {
|
|
53
|
+
handler,
|
|
54
|
+
type MethodHandler,
|
|
55
|
+
ProtocolServer,
|
|
56
|
+
type Session,
|
|
57
|
+
} from "../protocol-server/index.ts";
|
|
49
58
|
import { canonicalRef, listingDigest, versionIdFor } from "../publish/index.ts";
|
|
50
59
|
import { openRegistry, type Registry } from "../registry/index.ts";
|
|
51
60
|
import type { Authorization } from "./auth.ts";
|
|
61
|
+
import type { ClientAddresses, RateLimiter } from "./clients.ts";
|
|
52
62
|
import { rotateIncarnation } from "./data.ts";
|
|
63
|
+
import { createOperatorFeed, type OperatorFeed } from "./feed.ts";
|
|
64
|
+
import { type HomeOwner, type HostedPagesOptions, hostedPages } from "./hosted-pages.ts";
|
|
65
|
+
import type { Meter } from "./metering.ts";
|
|
66
|
+
import type { Operator } from "./operator.ts";
|
|
53
67
|
import { createHostedRelay } from "./relay.ts";
|
|
68
|
+
import { purgeArtifact } from "./remove.ts";
|
|
69
|
+
import type { Routing } from "./routing.ts";
|
|
54
70
|
|
|
55
71
|
/** Lower-case Crockford base32, for route labels (one DNS label, 130 bits). */
|
|
56
72
|
const LABEL_ALPHABET = "0123456789abcdefghjkmnpqrstvwxyz";
|
|
@@ -92,10 +108,37 @@ export interface HostedHome {
|
|
|
92
108
|
readonly protocol: ProtocolServer;
|
|
93
109
|
/** The home's current incarnation (DATA_MODEL §7.2). */
|
|
94
110
|
incarnation(): string;
|
|
95
|
-
/**
|
|
96
|
-
|
|
111
|
+
/**
|
|
112
|
+
* The size a pending push of this home gives a client file it names as missing, or `undefined`
|
|
113
|
+
* when none names it: an upload must bring exactly those bytes (Fable review of WP-30, 2).
|
|
114
|
+
*/
|
|
115
|
+
wanted(sha256: string): number | undefined;
|
|
97
116
|
/** Records a file this home uploaded (`PUT /files/<sha256>`, §18.2). */
|
|
98
117
|
uploaded(sha256: string): void;
|
|
118
|
+
/** Pauses or resumes an artifact as its owner or the operator (D165 item 14). */
|
|
119
|
+
pause(
|
|
120
|
+
artifactId: string,
|
|
121
|
+
change: { readonly paused: boolean; readonly by: PausedBy; readonly reason?: string },
|
|
122
|
+
): { readonly paused: boolean; readonly by?: PausedBy };
|
|
123
|
+
/** Quarantines an artifact, or one version of it, here only (D165 item 9). */
|
|
124
|
+
quarantine(artifactId: string, versionId: string | undefined, reason: string): void;
|
|
125
|
+
/** Ends a quarantine: the artifact's, or one version's. */
|
|
126
|
+
release(artifactId: string, versionId: string | undefined): void;
|
|
127
|
+
/** Revokes every live link of an artifact; answers how many were live. */
|
|
128
|
+
revokeLinks(artifactId: string): number;
|
|
129
|
+
/** Revokes one link; `false` when this home has no such link. */
|
|
130
|
+
revokeLink(tokenId: string): boolean;
|
|
131
|
+
/**
|
|
132
|
+
* Removes an artifact and everything of it from this home (`ServerHandle.remove`): its rows, its
|
|
133
|
+
* version files no other version of the home names, and its route; its label is kept issued
|
|
134
|
+
* forever, never served again (DATA_MODEL §7.5).
|
|
135
|
+
*/
|
|
136
|
+
remove(artifactId: string): Promise<{ readonly rows: number }>;
|
|
137
|
+
/**
|
|
138
|
+
* The session of the account's default owner instance, while it is connected: where remote MCP's
|
|
139
|
+
* authoring goes (D165 items 1b, 5). The newest session of the link is its own.
|
|
140
|
+
*/
|
|
141
|
+
defaultOwnerSession(): number | undefined;
|
|
99
142
|
/** Whether a binding is open, a stream or poll is served, or a delivery waits. */
|
|
100
143
|
busy(): boolean;
|
|
101
144
|
/**
|
|
@@ -131,6 +174,8 @@ export interface HostedHomeOptions {
|
|
|
131
174
|
/** The shell's built files. */
|
|
132
175
|
readonly shellDir: string | undefined;
|
|
133
176
|
/** The relay's server settings (`relay` in the configuration, D165 item 4). */
|
|
177
|
+
/** The test fault points (`MOSTRA_TEST_FAULTS`); none by default. */
|
|
178
|
+
readonly faults?: Faults;
|
|
134
179
|
readonly relay?: {
|
|
135
180
|
readonly waitingRunsPerArtifact?: number | undefined;
|
|
136
181
|
readonly drainPerSecond?: number | undefined;
|
|
@@ -141,6 +186,26 @@ export interface HostedHomeOptions {
|
|
|
141
186
|
/** `rateLimits.perLink.relayedRuns`, in milliseconds. */
|
|
142
187
|
readonly perLink?: { readonly count: number; readonly perMs: number } | undefined;
|
|
143
188
|
};
|
|
189
|
+
/** What the server lends every hosted home: its operator, client addresses and rates (WP-30). */
|
|
190
|
+
readonly services?: HostedServices;
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
/** What the server lends every hosted home (WP-30). */
|
|
194
|
+
export interface HostedServices {
|
|
195
|
+
readonly operator: Operator;
|
|
196
|
+
readonly clients: ClientAddresses;
|
|
197
|
+
readonly rates: RateLimiter;
|
|
198
|
+
readonly rateLimits: HostedPagesOptions["rateLimits"];
|
|
199
|
+
/** Who owns a home, as its pages' sender line names them. */
|
|
200
|
+
readonly owner: (homeId: string) => HomeOwner;
|
|
201
|
+
readonly signInOffered: () => boolean;
|
|
202
|
+
readonly madeWith?: { readonly href?: string } | undefined;
|
|
203
|
+
/** The server's routing by exact `Host`: operator hosts, their frames and link hosts (D167). */
|
|
204
|
+
readonly routing: Routing;
|
|
205
|
+
/** The server's meter: views here, submissions through the operator feed. */
|
|
206
|
+
readonly meter: Meter;
|
|
207
|
+
/** Viewer sign-in on the authorization server (INTERFACES §18.4). */
|
|
208
|
+
readonly signin?: HostedPagesOptions["signin"];
|
|
144
209
|
}
|
|
145
210
|
|
|
146
211
|
function refuse(code: Parameters<typeof createDiagnostic>[0], message: string): RpcError {
|
|
@@ -149,10 +214,11 @@ function refuse(code: Parameters<typeof createDiagnostic>[0], message: string):
|
|
|
149
214
|
|
|
150
215
|
/** Opens the parts of a hosted home over its ledger. */
|
|
151
216
|
export async function openHostedHome(options: HostedHomeOptions): Promise<HostedHome> {
|
|
217
|
+
const faults = options.faults ?? noFaults;
|
|
152
218
|
const { id, dir, ledger, directory, log } = options;
|
|
153
219
|
const registry = await openRegistry({ home: dir, ledger });
|
|
154
|
-
/** Pending pushes: version ID →
|
|
155
|
-
const pending = new Map<string,
|
|
220
|
+
/** Pending pushes: version ID → each missing client file's SHA-256 and the size its listing gives. */
|
|
221
|
+
const pending = new Map<string, Map<string, number>>();
|
|
156
222
|
let incarnation = options.incarnation;
|
|
157
223
|
|
|
158
224
|
const ownerLinkOf = (artifactId: string): string | undefined =>
|
|
@@ -207,11 +273,22 @@ export async function openHostedHome(options: HostedHomeOptions): Promise<Hosted
|
|
|
207
273
|
/** The route of an artifact on this home, minted on its first push by `link`. */
|
|
208
274
|
const routeFor = (artifactId: string, link: string): HostedRoute =>
|
|
209
275
|
directory.write((db) => {
|
|
210
|
-
const found = db.get<{
|
|
211
|
-
|
|
276
|
+
const found = db.get<{
|
|
277
|
+
id: string;
|
|
278
|
+
label: string;
|
|
279
|
+
owner_link_id: string;
|
|
280
|
+
removing_json: string | null;
|
|
281
|
+
}>(
|
|
282
|
+
"SELECT id, label, owner_link_id, removing_json FROM artifact_route WHERE home_id = ? AND artifact_id = ?",
|
|
212
283
|
id,
|
|
213
284
|
artifactId,
|
|
214
285
|
);
|
|
286
|
+
if (found?.removing_json != null) {
|
|
287
|
+
throw refuse(
|
|
288
|
+
"MOSTRA_REMOTE_HOME_MOVING",
|
|
289
|
+
"This artifact is being removed from the server; push it again once that's done.",
|
|
290
|
+
);
|
|
291
|
+
}
|
|
215
292
|
if (found) {
|
|
216
293
|
if (found.owner_link_id !== link) {
|
|
217
294
|
const owner = db.get<{ name: string }>(
|
|
@@ -252,10 +329,11 @@ export async function openHostedHome(options: HostedHomeOptions): Promise<Hosted
|
|
|
252
329
|
|
|
253
330
|
// ── Hosted pages (INTERFACES §18.4) ────────────────────────────────────────────────────
|
|
254
331
|
|
|
332
|
+
// A route being removed serves nothing (its removal finishes on the next call).
|
|
255
333
|
const routeOf = (artifactId: string): { id: string; label: string } | undefined =>
|
|
256
334
|
directory.read((db) =>
|
|
257
335
|
db.get<{ id: string; label: string }>(
|
|
258
|
-
"SELECT id, label FROM artifact_route WHERE home_id = ? AND artifact_id = ?",
|
|
336
|
+
"SELECT id, label FROM artifact_route WHERE home_id = ? AND artifact_id = ? AND removing_json IS NULL",
|
|
259
337
|
id,
|
|
260
338
|
artifactId,
|
|
261
339
|
),
|
|
@@ -264,20 +342,44 @@ export async function openHostedHome(options: HostedHomeOptions): Promise<Hosted
|
|
|
264
342
|
directory.read(
|
|
265
343
|
(db) =>
|
|
266
344
|
db.get<{ artifact_id: string }>(
|
|
267
|
-
"SELECT artifact_id FROM artifact_route WHERE id = ? AND home_id = ?",
|
|
345
|
+
"SELECT artifact_id FROM artifact_route WHERE id = ? AND home_id = ? AND removing_json IS NULL",
|
|
268
346
|
routeId,
|
|
269
347
|
id,
|
|
270
348
|
)?.artifact_id,
|
|
271
349
|
);
|
|
272
350
|
const domains = [options.domains.active, ...options.domains.spares];
|
|
273
351
|
const originOf = (host: string): string => `${options.scheme}://${host}`;
|
|
352
|
+
/** The host of one of this server's origins, or `undefined` for another scheme. */
|
|
353
|
+
const hostOfOrigin = (origin: string): string | undefined =>
|
|
354
|
+
origin.startsWith(`${options.scheme}://`) ? origin.slice(options.scheme.length + 3) : undefined;
|
|
355
|
+
/** Whether a shell origin is this home's: a configured apex, or an operator host of it. */
|
|
356
|
+
const servesShell = (origin: string): boolean => {
|
|
357
|
+
const host = hostOfOrigin(origin);
|
|
358
|
+
if (host === undefined) return false;
|
|
359
|
+
return options.services
|
|
360
|
+
? options.services.routing.servesShell(id, host)
|
|
361
|
+
: domains.includes(host);
|
|
362
|
+
};
|
|
274
363
|
const capabilities: Capabilities = new Capabilities({
|
|
275
364
|
ledger,
|
|
276
365
|
log,
|
|
277
366
|
key: capabilityKey(dir, log),
|
|
278
367
|
now: () => Date.now(),
|
|
279
368
|
shellOrigin: () => originOf(options.domains.active),
|
|
280
|
-
servesShell
|
|
369
|
+
servesShell,
|
|
370
|
+
// Every hosted link is indexed in the directory, so the operator's `revokeLink` finds its home.
|
|
371
|
+
onMinted: ({ tokenId, artifactId }) => {
|
|
372
|
+
const route = routeOf(artifactId);
|
|
373
|
+
if (!route) return;
|
|
374
|
+
directory.write((db) =>
|
|
375
|
+
db.run(
|
|
376
|
+
"INSERT OR IGNORE INTO hosted_token (token_id, home_id, route_id) VALUES (?, ?, ?)",
|
|
377
|
+
tokenId,
|
|
378
|
+
id,
|
|
379
|
+
route.id,
|
|
380
|
+
),
|
|
381
|
+
);
|
|
382
|
+
},
|
|
281
383
|
});
|
|
282
384
|
// A hosted home binds nothing: its faces are served through the front. These answer the few
|
|
283
385
|
// questions the gateway asks of loopback addressing, none of which a hosted face reaches.
|
|
@@ -382,13 +484,68 @@ export async function openHostedHome(options: HostedHomeOptions): Promise<Hosted
|
|
|
382
484
|
activated: () => undefined,
|
|
383
485
|
hosted: {
|
|
384
486
|
shellOrigin: () => originOf(options.domains.active),
|
|
385
|
-
servesShell
|
|
487
|
+
servesShell,
|
|
386
488
|
shellPath: (artifactId) => `/a/${routeOf(artifactId)?.id ?? artifactId}`,
|
|
387
489
|
artifactOrigin: (artifactId, shellOrigin) => {
|
|
388
490
|
const route = routeOf(artifactId);
|
|
389
|
-
const
|
|
390
|
-
|
|
491
|
+
const host = hostOfOrigin(shellOrigin);
|
|
492
|
+
if (!route || host === undefined) return undefined;
|
|
493
|
+
const frameDomain = options.services
|
|
494
|
+
? options.services.routing.frameDomainOf(id, route.id, host)
|
|
495
|
+
: domains.includes(host)
|
|
496
|
+
? host
|
|
497
|
+
: undefined;
|
|
498
|
+
return frameDomain === undefined ? undefined : originOf(`${route.label}.${frameDomain}`);
|
|
391
499
|
},
|
|
500
|
+
...(options.services
|
|
501
|
+
? {
|
|
502
|
+
// A new link goes on the operator's host for it when it names one that serves this
|
|
503
|
+
// route (D167, `routing.linkHost`), else on the active domain.
|
|
504
|
+
linkOrigin: async (artifactId: string) => {
|
|
505
|
+
const services = options.services as HostedServices;
|
|
506
|
+
const route = routeOf(artifactId);
|
|
507
|
+
if (!route || !services.operator.has.linkHost) return undefined;
|
|
508
|
+
const wanted = await services.operator.linkHost({
|
|
509
|
+
account: services.owner(id).account,
|
|
510
|
+
home: id,
|
|
511
|
+
routeId: route.id,
|
|
512
|
+
});
|
|
513
|
+
if (wanted === null) return undefined;
|
|
514
|
+
const host = await services.routing.linkHost(id, route.id, wanted);
|
|
515
|
+
return host === undefined ? undefined : originOf(host);
|
|
516
|
+
},
|
|
517
|
+
frameAncestors: (artifactId: string, frameOrigin: string) => {
|
|
518
|
+
const route = routeOf(artifactId);
|
|
519
|
+
const host = hostOfOrigin(frameOrigin);
|
|
520
|
+
if (!route || host === undefined) return "";
|
|
521
|
+
const frameDomain = host.slice(host.indexOf(".") + 1);
|
|
522
|
+
return (options.services as HostedServices).routing
|
|
523
|
+
.ancestorsOf(id, route.id, frameDomain)
|
|
524
|
+
.map(originOf)
|
|
525
|
+
.join(" ");
|
|
526
|
+
},
|
|
527
|
+
}
|
|
528
|
+
: {}),
|
|
529
|
+
...(options.services
|
|
530
|
+
? hostedPages({
|
|
531
|
+
homeId: id,
|
|
532
|
+
ledger,
|
|
533
|
+
interaction,
|
|
534
|
+
capabilities,
|
|
535
|
+
artifact: (artifactId) => registry.get({ artifactId }),
|
|
536
|
+
routeOf,
|
|
537
|
+
owner: () => (options.services as HostedServices).owner(id),
|
|
538
|
+
signInOffered: options.services.signInOffered,
|
|
539
|
+
operator: options.services.operator,
|
|
540
|
+
clients: options.services.clients,
|
|
541
|
+
rates: options.services.rates,
|
|
542
|
+
rateLimits: options.services.rateLimits,
|
|
543
|
+
madeWith: options.services.madeWith,
|
|
544
|
+
...(options.services.signin ? { signin: options.services.signin } : {}),
|
|
545
|
+
viewed: (input) => metered(input.artifactId, input.viewerId),
|
|
546
|
+
log,
|
|
547
|
+
})
|
|
548
|
+
: {}),
|
|
392
549
|
},
|
|
393
550
|
});
|
|
394
551
|
/** The faces of a domain: its shell, and a route's frames, opened when first asked for. */
|
|
@@ -469,6 +626,98 @@ export async function openHostedHome(options: HostedHomeOptions): Promise<Hosted
|
|
|
469
626
|
),
|
|
470
627
|
);
|
|
471
628
|
|
|
629
|
+
/**
|
|
630
|
+
* Quarantines a route's artifact, or one version of it, in this home only (D165 item 9): its
|
|
631
|
+
* links show the neutral "under review" page and its files are withheld; data is kept. An
|
|
632
|
+
* identical version in another home is untouched, since the row is this home's.
|
|
633
|
+
*/
|
|
634
|
+
const quarantine = (artifactId: string, versionId: string | undefined, reason: string): void => {
|
|
635
|
+
ledger.write((db) =>
|
|
636
|
+
db.run(
|
|
637
|
+
`INSERT INTO quarantine (artifact_id, version_id, reason, at) VALUES (?, ?, ?, ?)
|
|
638
|
+
ON CONFLICT (artifact_id, version_id) DO UPDATE SET reason = excluded.reason`,
|
|
639
|
+
artifactId,
|
|
640
|
+
versionId ?? "",
|
|
641
|
+
reason.slice(0, 1_000),
|
|
642
|
+
new Date().toISOString(),
|
|
643
|
+
),
|
|
644
|
+
);
|
|
645
|
+
log.info("server.quarantined", { home: id, artifactId, versionId: versionId ?? null });
|
|
646
|
+
};
|
|
647
|
+
|
|
648
|
+
/**
|
|
649
|
+
* `view/url` on a hosted home under the operator's `limits` (`link`): refused with its words, and
|
|
650
|
+
* refused for now when the operator doesn't answer, since a link creates something (D165 item 9).
|
|
651
|
+
*/
|
|
652
|
+
const limitedLinks = (method: MethodHandler): MethodHandler => ({
|
|
653
|
+
definition: method.definition,
|
|
654
|
+
async handle(params, session) {
|
|
655
|
+
const services = options.services;
|
|
656
|
+
if (services) {
|
|
657
|
+
const ref = (params as { artifact?: unknown }).artifact;
|
|
658
|
+
const artifactId = registry.get(canonicalRef(ref as never)).id;
|
|
659
|
+
const route = routeOf(artifactId);
|
|
660
|
+
const verdict = await services.operator.limit({
|
|
661
|
+
account: services.owner(id).account,
|
|
662
|
+
home: id,
|
|
663
|
+
artifact: artifactId,
|
|
664
|
+
...(route ? { routeId: route.id } : {}),
|
|
665
|
+
operation: "link",
|
|
666
|
+
});
|
|
667
|
+
if (verdict.allowed === "unavailable") {
|
|
668
|
+
throw refuse(
|
|
669
|
+
"MOSTRA_REMOTE_OPERATOR_UNAVAILABLE",
|
|
670
|
+
"The server's operator didn't answer in time; try minting the link again.",
|
|
671
|
+
);
|
|
672
|
+
}
|
|
673
|
+
if (verdict.allowed === false) throw refuse("MOSTRA_REMOTE_LIMIT_REACHED", verdict.message);
|
|
674
|
+
}
|
|
675
|
+
return method.handle(params, session);
|
|
676
|
+
},
|
|
677
|
+
});
|
|
678
|
+
|
|
679
|
+
/**
|
|
680
|
+
* A view for metering, under the viewer's monthly pseudonymous key (D167): the account for a
|
|
681
|
+
* signed-in viewer, the viewer for a link minted with one, the route's key for anyone else.
|
|
682
|
+
*/
|
|
683
|
+
const metered = (artifactId: string, viewerId: string): void => {
|
|
684
|
+
const meter = options.services?.meter;
|
|
685
|
+
if (!meter?.on) return;
|
|
686
|
+
const viewer = ledger.read((db) =>
|
|
687
|
+
db.get<{ kind: string; external_ref: string | null }>(
|
|
688
|
+
"SELECT kind, external_ref FROM viewer WHERE id = ?",
|
|
689
|
+
viewerId,
|
|
690
|
+
),
|
|
691
|
+
);
|
|
692
|
+
const subject =
|
|
693
|
+
viewer?.kind === "account" || viewer?.kind === "anonymous"
|
|
694
|
+
? `${viewer.kind}:${viewer.external_ref ?? viewerId}`
|
|
695
|
+
: `viewer:${id}:${viewerId}`;
|
|
696
|
+
const route = routeOf(artifactId);
|
|
697
|
+
meter.add("views", {
|
|
698
|
+
account: (options.services as HostedServices).owner(id).account,
|
|
699
|
+
home: id,
|
|
700
|
+
artifactId,
|
|
701
|
+
...(route ? { routeId: route.id } : {}),
|
|
702
|
+
dimensions: { viewerKey: meter.viewerKey(subject) },
|
|
703
|
+
});
|
|
704
|
+
};
|
|
705
|
+
|
|
706
|
+
/** The live links of an artifact, revoked; answers how many were live. */
|
|
707
|
+
const revokeLinks = (artifactId: string): number => {
|
|
708
|
+
const tokens = ledger.read((db) =>
|
|
709
|
+
db
|
|
710
|
+
.all<{ id: string }>(
|
|
711
|
+
"SELECT id FROM token WHERE artifact_id = ? AND revoked_at IS NULL",
|
|
712
|
+
artifactId,
|
|
713
|
+
)
|
|
714
|
+
.map((row) => row.id),
|
|
715
|
+
);
|
|
716
|
+
let revoked = 0;
|
|
717
|
+
for (const tokenId of tokens) if (capabilities.revoke(tokenId) === "revoked") revoked += 1;
|
|
718
|
+
return revoked;
|
|
719
|
+
};
|
|
720
|
+
|
|
472
721
|
const push = async (params: HostedPushParams, session: Session): Promise<HostedPushResult> => {
|
|
473
722
|
const link = session.link?.instanceId;
|
|
474
723
|
if (link === undefined || session.attributes["linkId"] !== link) {
|
|
@@ -527,6 +776,24 @@ export async function openHostedHome(options: HostedHomeOptions): Promise<Hosted
|
|
|
527
776
|
if (!manifest.success)
|
|
528
777
|
throw refuse("MOSTRA_HOME_INTEGRITY", "The pushed artifact manifest isn't valid.");
|
|
529
778
|
|
|
779
|
+
const services = options.services;
|
|
780
|
+
// A first push hosts the artifact: the operator's `limits` judge it as a share, failing
|
|
781
|
+
// closed when it doesn't answer (D165 item 9).
|
|
782
|
+
if (services && routeOf(params.artifactId) === undefined) {
|
|
783
|
+
const verdict = await services.operator.limit({
|
|
784
|
+
account: services.owner(id).account,
|
|
785
|
+
home: id,
|
|
786
|
+
artifact: params.artifactId,
|
|
787
|
+
operation: "share",
|
|
788
|
+
});
|
|
789
|
+
if (verdict.allowed === "unavailable") {
|
|
790
|
+
throw refuse(
|
|
791
|
+
"MOSTRA_REMOTE_OPERATOR_UNAVAILABLE",
|
|
792
|
+
"The server's operator didn't answer in time; the share is tried again later.",
|
|
793
|
+
);
|
|
794
|
+
}
|
|
795
|
+
if (verdict.allowed === false) throw refuse("MOSTRA_REMOTE_LIMIT_REACHED", verdict.message);
|
|
796
|
+
}
|
|
530
797
|
const route = routeFor(params.artifactId, link);
|
|
531
798
|
if (registry.hasVersion(version.versionId)) {
|
|
532
799
|
const known = registry
|
|
@@ -541,9 +808,66 @@ export async function openHostedHome(options: HostedHomeOptions): Promise<Hosted
|
|
|
541
808
|
}
|
|
542
809
|
// Only client files are stored: server code never reaches the server (D165 item 3).
|
|
543
810
|
const clientFiles = version.listing.filter(([path]) => path.startsWith("client/"));
|
|
811
|
+
// The sizes a listing gives are what the storage limit is asked with, so each is held to the
|
|
812
|
+
// bytes: one file has one size, a file this home holds already has the size it has on disk, and
|
|
813
|
+
// an upload brings exactly the size given (Fable review of WP-30, 2).
|
|
814
|
+
const sizes = new Map<string, number>();
|
|
815
|
+
for (const [path, , sha, size] of clientFiles) {
|
|
816
|
+
if (!Number.isSafeInteger(size) || size < 0 || (sizes.get(sha) ?? size) !== size) {
|
|
817
|
+
throw refuse(
|
|
818
|
+
"MOSTRA_HOME_INTEGRITY",
|
|
819
|
+
`The listing gives ${path} a size its bytes can't have.`,
|
|
820
|
+
);
|
|
821
|
+
}
|
|
822
|
+
sizes.set(sha, size);
|
|
823
|
+
}
|
|
824
|
+
for (const [sha, size] of sizes) {
|
|
825
|
+
const held = directory.read((db) =>
|
|
826
|
+
db.get("SELECT 1 FROM home_file WHERE home_id = ? AND sha256 = ?", id, sha),
|
|
827
|
+
);
|
|
828
|
+
if (held === undefined) continue;
|
|
829
|
+
const onDisk = await stat(join(options.filesDir, sha)).then(
|
|
830
|
+
(found) => found.size,
|
|
831
|
+
() => undefined,
|
|
832
|
+
);
|
|
833
|
+
if (onDisk !== undefined && onDisk !== size) {
|
|
834
|
+
throw refuse(
|
|
835
|
+
"MOSTRA_HOME_INTEGRITY",
|
|
836
|
+
"The listing gives a held file another size than its bytes.",
|
|
837
|
+
);
|
|
838
|
+
}
|
|
839
|
+
}
|
|
840
|
+
// The operator's `limits` on a push and the bytes it stores: refused for good with its words,
|
|
841
|
+
// and refused for now (fail closed) when the operator doesn't answer (D165 item 9).
|
|
842
|
+
if (services) {
|
|
843
|
+
const owner = services.owner(id).account;
|
|
844
|
+
for (const [operation, quantity] of [
|
|
845
|
+
["version.push", 1],
|
|
846
|
+
["storage", [...sizes.values()].reduce((sum, size) => sum + size, 0)],
|
|
847
|
+
] as const) {
|
|
848
|
+
const verdict = await services.operator.limit({
|
|
849
|
+
account: owner,
|
|
850
|
+
home: id,
|
|
851
|
+
artifact: params.artifactId,
|
|
852
|
+
routeId: route.routeId,
|
|
853
|
+
operation,
|
|
854
|
+
quantity,
|
|
855
|
+
});
|
|
856
|
+
if (verdict.allowed === "unavailable") {
|
|
857
|
+
throw refuse(
|
|
858
|
+
"MOSTRA_REMOTE_OPERATOR_UNAVAILABLE",
|
|
859
|
+
"The server's operator didn't answer in time; the push is tried again later.",
|
|
860
|
+
);
|
|
861
|
+
}
|
|
862
|
+
if (verdict.allowed === false) throw refuse("MOSTRA_REMOTE_LIMIT_REACHED", verdict.message);
|
|
863
|
+
}
|
|
864
|
+
}
|
|
544
865
|
const missing = missingOf([...new Set(clientFiles.map(([, , sha]) => sha))]);
|
|
545
866
|
if (missing.length > 0) {
|
|
546
|
-
pending.set(
|
|
867
|
+
pending.set(
|
|
868
|
+
version.versionId,
|
|
869
|
+
new Map(missing.map((sha) => [sha, sizes.get(sha) as number])),
|
|
870
|
+
);
|
|
547
871
|
return { status: "missing", files: missing, route };
|
|
548
872
|
}
|
|
549
873
|
pending.delete(version.versionId);
|
|
@@ -615,6 +939,31 @@ export async function openHostedHome(options: HostedHomeOptions): Promise<Hosted
|
|
|
615
939
|
artifactId: params.artifactId,
|
|
616
940
|
versionId: version.versionId,
|
|
617
941
|
});
|
|
942
|
+
// The operator's after-push hook reads the client files; its answer can quarantine the
|
|
943
|
+
// version afterwards, never holding up serving it (D165 item 9).
|
|
944
|
+
if (services?.operator.has.pushed) {
|
|
945
|
+
const files = clientFiles.map(([path]) => path);
|
|
946
|
+
const shaOf = new Map(clientFiles.map(([path, , sha]) => [path, sha]));
|
|
947
|
+
services.operator.pushed(
|
|
948
|
+
{
|
|
949
|
+
routeId: route.routeId,
|
|
950
|
+
label: route.label,
|
|
951
|
+
artifactId: params.artifactId,
|
|
952
|
+
home: id,
|
|
953
|
+
versionId: version.versionId,
|
|
954
|
+
manifest: manifest.data,
|
|
955
|
+
files,
|
|
956
|
+
read: async (path) => {
|
|
957
|
+
const sha = shaOf.get(path);
|
|
958
|
+
if (sha === undefined) throw new Error(`No client file ${path} in this version.`);
|
|
959
|
+
return new Uint8Array(await readFile(join(options.filesDir, sha)));
|
|
960
|
+
},
|
|
961
|
+
},
|
|
962
|
+
async (reason) => {
|
|
963
|
+
quarantine(params.artifactId, version.versionId, reason);
|
|
964
|
+
},
|
|
965
|
+
);
|
|
966
|
+
}
|
|
618
967
|
return { status: "complete", versionId: version.versionId, number: committed.version, route };
|
|
619
968
|
};
|
|
620
969
|
|
|
@@ -726,7 +1075,21 @@ export async function openHostedHome(options: HostedHomeOptions): Promise<Hosted
|
|
|
726
1075
|
}
|
|
727
1076
|
return envelope;
|
|
728
1077
|
}),
|
|
729
|
-
...gateway
|
|
1078
|
+
...gateway
|
|
1079
|
+
.methods()
|
|
1080
|
+
.map((method) =>
|
|
1081
|
+
method.definition.method === viewUrlMethod.method ? limitedLinks(method) : method,
|
|
1082
|
+
),
|
|
1083
|
+
handler(artifactPauseMethod, (params) => {
|
|
1084
|
+
// The account's own instances pause and resume as the owner; only the operator, through
|
|
1085
|
+
// its handle, resumes an operator's pause (D165 item 14).
|
|
1086
|
+
const artifactId = registry.get(canonicalRef(params.artifact)).id;
|
|
1087
|
+
return interaction.pause(artifactId, {
|
|
1088
|
+
paused: params.paused,
|
|
1089
|
+
by: "owner",
|
|
1090
|
+
...(params.reason !== undefined ? { reason: params.reason } : {}),
|
|
1091
|
+
});
|
|
1092
|
+
}),
|
|
730
1093
|
...relay.methods(),
|
|
731
1094
|
...liveMethods(live, (ref) => registry.get(canonicalRef(ref)).id),
|
|
732
1095
|
handler(remoteTokenMethod, (params, session) => {
|
|
@@ -747,6 +1110,20 @@ export async function openHostedHome(options: HostedHomeOptions): Promise<Hosted
|
|
|
747
1110
|
});
|
|
748
1111
|
interaction.start();
|
|
749
1112
|
live.start();
|
|
1113
|
+
// The operator's feed of this home's events, and its submissions for metering (§18.6).
|
|
1114
|
+
const feed: OperatorFeed | undefined = options.services
|
|
1115
|
+
? createOperatorFeed({
|
|
1116
|
+
homeId: id,
|
|
1117
|
+
ledger,
|
|
1118
|
+
interaction,
|
|
1119
|
+
operator: options.services.operator,
|
|
1120
|
+
meter: options.services.meter,
|
|
1121
|
+
account: () => (options.services as HostedServices).owner(id).account,
|
|
1122
|
+
routeOf,
|
|
1123
|
+
incarnation: () => incarnation,
|
|
1124
|
+
log,
|
|
1125
|
+
})
|
|
1126
|
+
: undefined;
|
|
750
1127
|
|
|
751
1128
|
return {
|
|
752
1129
|
id,
|
|
@@ -756,7 +1133,13 @@ export async function openHostedHome(options: HostedHomeOptions): Promise<Hosted
|
|
|
756
1133
|
interaction,
|
|
757
1134
|
protocol,
|
|
758
1135
|
incarnation: () => incarnation,
|
|
759
|
-
wanted: (sha) =>
|
|
1136
|
+
wanted: (sha) => {
|
|
1137
|
+
for (const files of pending.values()) {
|
|
1138
|
+
const size = files.get(sha);
|
|
1139
|
+
if (size !== undefined) return size;
|
|
1140
|
+
}
|
|
1141
|
+
return undefined;
|
|
1142
|
+
},
|
|
760
1143
|
uploaded(sha) {
|
|
761
1144
|
directory.write((db) => {
|
|
762
1145
|
const added = db.run(
|
|
@@ -773,9 +1156,127 @@ export async function openHostedHome(options: HostedHomeOptions): Promise<Hosted
|
|
|
773
1156
|
});
|
|
774
1157
|
for (const files of pending.values()) files.delete(sha);
|
|
775
1158
|
},
|
|
1159
|
+
pause: (artifactId, change) => interaction.pause(artifactId, change),
|
|
1160
|
+
quarantine,
|
|
1161
|
+
release(artifactId, versionId) {
|
|
1162
|
+
ledger.write((db) =>
|
|
1163
|
+
db.run(
|
|
1164
|
+
versionId === undefined
|
|
1165
|
+
? "DELETE FROM quarantine WHERE artifact_id = ?"
|
|
1166
|
+
: "DELETE FROM quarantine WHERE artifact_id = ? AND version_id = ?",
|
|
1167
|
+
...(versionId === undefined ? [artifactId] : [artifactId, versionId]),
|
|
1168
|
+
),
|
|
1169
|
+
);
|
|
1170
|
+
},
|
|
1171
|
+
revokeLinks,
|
|
1172
|
+
revokeLink: (tokenId) => capabilities.revoke(tokenId) !== "unknown",
|
|
1173
|
+
async remove(artifactId) {
|
|
1174
|
+
/** The client files a version's listing names. */
|
|
1175
|
+
const clientFilesOf = async (versionId: string): Promise<string[]> => {
|
|
1176
|
+
try {
|
|
1177
|
+
const listing = JSON.parse(
|
|
1178
|
+
await readFile(join(registry.store.versionDir(versionId), "listing.json"), "utf8"),
|
|
1179
|
+
) as [string, boolean, string, number][];
|
|
1180
|
+
return listing.filter(([path]) => path.startsWith("client/")).map(([, , sha]) => sha);
|
|
1181
|
+
} catch {
|
|
1182
|
+
return [];
|
|
1183
|
+
}
|
|
1184
|
+
};
|
|
1185
|
+
// The plan is recorded in the directory before anything goes, so a removal cut off between
|
|
1186
|
+
// the two databases is finished by the next call, from the same plan (Fable review, 4).
|
|
1187
|
+
const recorded = directory.read(
|
|
1188
|
+
(db) =>
|
|
1189
|
+
db.get<{ removing_json: string | null }>(
|
|
1190
|
+
"SELECT removing_json FROM artifact_route WHERE home_id = ? AND artifact_id = ?",
|
|
1191
|
+
id,
|
|
1192
|
+
artifactId,
|
|
1193
|
+
)?.removing_json,
|
|
1194
|
+
);
|
|
1195
|
+
let plan: { readonly versions: string[]; readonly going: string[] };
|
|
1196
|
+
if (recorded != null) plan = JSON.parse(recorded) as typeof plan;
|
|
1197
|
+
else {
|
|
1198
|
+
const versions = registry.get({ artifactId }).versions.map((version) => version.id);
|
|
1199
|
+
const files = new Set<string>();
|
|
1200
|
+
for (const versionId of versions)
|
|
1201
|
+
for (const sha of await clientFilesOf(versionId)) files.add(sha);
|
|
1202
|
+
plan = { versions, going: [...files] };
|
|
1203
|
+
directory.write((db) =>
|
|
1204
|
+
db.run(
|
|
1205
|
+
"UPDATE artifact_route SET removing_json = ? WHERE home_id = ? AND artifact_id = ?",
|
|
1206
|
+
JSON.stringify(plan),
|
|
1207
|
+
id,
|
|
1208
|
+
artifactId,
|
|
1209
|
+
),
|
|
1210
|
+
);
|
|
1211
|
+
}
|
|
1212
|
+
const versions = plan.versions;
|
|
1213
|
+
const going = new Set(plan.going);
|
|
1214
|
+
if (registry.list({}).some((summary) => summary.id === artifactId)) revokeLinks(artifactId);
|
|
1215
|
+
const removed = ledger.removal((db) => purgeArtifact(db, artifactId));
|
|
1216
|
+
// A test cuts the removal off here, between its two databases (`remove:after-purge`).
|
|
1217
|
+
faults.at("remove:after-purge");
|
|
1218
|
+
// Files another version of this home still names stay this home's.
|
|
1219
|
+
const kept = new Set<string>();
|
|
1220
|
+
for (const other of registry.list({})) {
|
|
1221
|
+
for (const version of registry.get({ artifactId: other.id }).versions) {
|
|
1222
|
+
for (const sha of await clientFilesOf(version.id)) kept.add(sha);
|
|
1223
|
+
}
|
|
1224
|
+
}
|
|
1225
|
+
const route = directory.read((db) =>
|
|
1226
|
+
db.get<{ id: string }>(
|
|
1227
|
+
"SELECT id FROM artifact_route WHERE home_id = ? AND artifact_id = ?",
|
|
1228
|
+
id,
|
|
1229
|
+
artifactId,
|
|
1230
|
+
),
|
|
1231
|
+
);
|
|
1232
|
+
directory.write((db) => {
|
|
1233
|
+
for (const sha of going) {
|
|
1234
|
+
if (kept.has(sha)) continue;
|
|
1235
|
+
if (
|
|
1236
|
+
db.run("DELETE FROM home_file WHERE home_id = ? AND sha256 = ?", id, sha).changes > 0
|
|
1237
|
+
) {
|
|
1238
|
+
db.run(
|
|
1239
|
+
`UPDATE file_ref SET homes = homes - 1,
|
|
1240
|
+
unreferenced_at = CASE WHEN homes - 1 = 0 THEN ? ELSE NULL END
|
|
1241
|
+
WHERE sha256 = ?`,
|
|
1242
|
+
new Date().toISOString(),
|
|
1243
|
+
sha,
|
|
1244
|
+
);
|
|
1245
|
+
}
|
|
1246
|
+
}
|
|
1247
|
+
if (route) {
|
|
1248
|
+
db.run("DELETE FROM hosted_token WHERE route_id = ?", route.id);
|
|
1249
|
+
// The route goes; its label stays in `label_issued`, never issued again.
|
|
1250
|
+
db.run("DELETE FROM artifact_route WHERE id = ?", route.id);
|
|
1251
|
+
}
|
|
1252
|
+
});
|
|
1253
|
+
for (const versionId of versions) {
|
|
1254
|
+
await removeTree(registry.store.versionDir(versionId)).catch((error: unknown) =>
|
|
1255
|
+
log.warn("server.remove_files_failed", { versionId, error }),
|
|
1256
|
+
);
|
|
1257
|
+
}
|
|
1258
|
+
const rows = Object.values(removed).reduce((sum, count) => sum + count, 0);
|
|
1259
|
+
log.info("server.artifact_removed", { home: id, artifactId, rows });
|
|
1260
|
+
return { rows };
|
|
1261
|
+
},
|
|
1262
|
+
defaultOwnerSession() {
|
|
1263
|
+
const link = directory.read(
|
|
1264
|
+
(db) =>
|
|
1265
|
+
db.get<{ id: string }>(
|
|
1266
|
+
"SELECT id FROM instance_link WHERE home_id = ? AND is_default = 1 AND revoked_at IS NULL",
|
|
1267
|
+
id,
|
|
1268
|
+
)?.id,
|
|
1269
|
+
);
|
|
1270
|
+
if (link === undefined) return undefined;
|
|
1271
|
+
return protocol
|
|
1272
|
+
.registrants("relay")
|
|
1273
|
+
.filter((entry) => entry.owner === link)
|
|
1274
|
+
.at(-1)?.session;
|
|
1275
|
+
},
|
|
776
1276
|
busy: () => protocol.connections > 0 || bus.activeViews() > 0 || relay.busy(),
|
|
777
1277
|
serve,
|
|
778
1278
|
async stop() {
|
|
1279
|
+
feed?.stop();
|
|
779
1280
|
relay.stop();
|
|
780
1281
|
live.stop();
|
|
781
1282
|
interaction.stop();
|