@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,427 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A remote server's data directory (DATA_MODEL §7.1) and its hosted homes (§7.2, D165 items 0b,
|
|
3
|
+
* 6): the directory is refused on a network filesystem, held by `server.lock` so a second server
|
|
4
|
+
* refuses it, and its directory ledger `server.sqlite` opens in WAL with normal locking. Each
|
|
5
|
+
* hosted home opens on its first request (its own `home.lock`, its ledger in normal locking, so a
|
|
6
|
+
* backup replicator can read it) and closes after it has been idle a while. Opening and closing one
|
|
7
|
+
* home are serialized, so a home never has two writers in one process, and a request that meets a
|
|
8
|
+
* home being closed waits for the close and opens it again (FAILURE_MODEL §11.2).
|
|
9
|
+
*/
|
|
10
|
+
import { randomBytes } from "node:crypto";
|
|
11
|
+
import { mkdirSync } from "node:fs";
|
|
12
|
+
import { join } from "node:path";
|
|
13
|
+
import { createDiagnostic, RpcError } from "@mostra/protocol";
|
|
14
|
+
import {
|
|
15
|
+
type HeldLock,
|
|
16
|
+
holdLock,
|
|
17
|
+
type Ledger,
|
|
18
|
+
type LedgerOwner,
|
|
19
|
+
openLedger,
|
|
20
|
+
} from "../ledger/index.ts";
|
|
21
|
+
import type { Environment, Log } from "../log.ts";
|
|
22
|
+
import { networkFilesystem, ownedDirectory } from "../platform/index.ts";
|
|
23
|
+
import { SERVER_MIGRATIONS } from "./directory.ts";
|
|
24
|
+
|
|
25
|
+
/** An open hosted home: its ledger, its lock, and whatever the server assembled over them. */
|
|
26
|
+
export interface OpenedHome<T> {
|
|
27
|
+
readonly id: string;
|
|
28
|
+
readonly dir: string;
|
|
29
|
+
readonly ledger: Ledger;
|
|
30
|
+
readonly incarnation: string;
|
|
31
|
+
/** What the server built over the ledger (interaction, gateway routes, sessions). */
|
|
32
|
+
readonly assembled: T;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
/** What opens and closes the parts of a hosted home that live above its ledger. */
|
|
36
|
+
export interface HomeAssembler<T> {
|
|
37
|
+
/** Builds a home's parts over its ledger, once it is open. */
|
|
38
|
+
assemble(home: {
|
|
39
|
+
readonly id: string;
|
|
40
|
+
readonly dir: string;
|
|
41
|
+
readonly ledger: Ledger;
|
|
42
|
+
readonly incarnation: string;
|
|
43
|
+
}): Promise<T>;
|
|
44
|
+
/** Stops them, before the ledger closes. */
|
|
45
|
+
disassemble(assembled: T): Promise<void>;
|
|
46
|
+
/** Whether a home is in use now: a connection, a stream, a poll, a pending delivery, a waiting run. */
|
|
47
|
+
busy(assembled: T): boolean;
|
|
48
|
+
/** The home's incarnation now: a hosted home rotates it when its owner shows it was restored. */
|
|
49
|
+
incarnation?(assembled: T): string;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/** The data directory, held. */
|
|
53
|
+
export interface DataDirectory<T> {
|
|
54
|
+
readonly dir: string;
|
|
55
|
+
readonly directory: Ledger;
|
|
56
|
+
/** Opens a hosted home, or returns it when open; a request waits for a close in progress. */
|
|
57
|
+
home(id: string): Promise<OpenedHome<T>>;
|
|
58
|
+
/** The homes open now. */
|
|
59
|
+
open(): readonly string[];
|
|
60
|
+
/** Notes that a home was used now, so it isn't closed while used. */
|
|
61
|
+
touch(id: string): void;
|
|
62
|
+
/**
|
|
63
|
+
* Closes a home now, if open, and holds it closed until `undrain` (`ServerHandle.drainHome`):
|
|
64
|
+
* every request for it meanwhile is refused with `MOSTRA_REMOTE_HOME_MOVING`, so two data
|
|
65
|
+
* directories never serve one home at once.
|
|
66
|
+
*/
|
|
67
|
+
drain(id: string): Promise<void>;
|
|
68
|
+
/** Serves a drained home again (`ServerHandle.releaseHome`). */
|
|
69
|
+
undrain(id: string): void;
|
|
70
|
+
/**
|
|
71
|
+
* A restore from a backup by hand (`ServerHandle.restored`): the home is closed and rotates its
|
|
72
|
+
* incarnation before it serves anything again.
|
|
73
|
+
*/
|
|
74
|
+
restored(id: string): Promise<void>;
|
|
75
|
+
/** Closes a home now if open (it reopens on its next request). */
|
|
76
|
+
closeHome(id: string): Promise<void>;
|
|
77
|
+
/** Closes every home, then the directory, then releases the lock. */
|
|
78
|
+
close(): Promise<void>;
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
/** Options for {@link openDataDirectory}. */
|
|
82
|
+
export interface DataDirectoryOptions<T> {
|
|
83
|
+
readonly dir: string;
|
|
84
|
+
readonly runtimeVersion: string;
|
|
85
|
+
readonly owner: LedgerOwner;
|
|
86
|
+
readonly log: Log;
|
|
87
|
+
readonly env: Environment;
|
|
88
|
+
readonly assembler: HomeAssembler<T>;
|
|
89
|
+
/** Close a home this long after it was last used and nothing is busy. Default 10 minutes. */
|
|
90
|
+
readonly idleCloseMs?: number;
|
|
91
|
+
readonly walAutocheckpoint?: number;
|
|
92
|
+
/**
|
|
93
|
+
* Homes restored from a backup by hand (`--restored <homeId|all>`): each rotates its incarnation
|
|
94
|
+
* when it first opens (INTERFACES §18.2).
|
|
95
|
+
*/
|
|
96
|
+
readonly restored?: readonly string[];
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
/** A home's head and relay high-water mark, as `home_cursor` records them (DATA_MODEL §7.1). */
|
|
100
|
+
function marksOf(ledger: Ledger): { readonly head: number; readonly relayHigh: number } {
|
|
101
|
+
return ledger.read((db) => ({
|
|
102
|
+
head: db.get<{ head: number | null }>("SELECT MAX(cursor) AS head FROM event")?.head ?? 0,
|
|
103
|
+
relayHigh:
|
|
104
|
+
db.get<{ high: number | null }>("SELECT MAX(relay_seq) AS high FROM relay_run")?.high ?? 0,
|
|
105
|
+
}));
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
/** A fresh incarnation, written in the one transaction that rotates it (DATA_MODEL §7.2). */
|
|
109
|
+
export function rotateIncarnation(ledger: Ledger): string {
|
|
110
|
+
const fresh = randomBytes(16).toString("hex");
|
|
111
|
+
ledger.write((db) => db.run("UPDATE home_meta SET incarnation = ? WHERE id = 1", fresh));
|
|
112
|
+
return fresh;
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
function locked(message: string): RpcError {
|
|
116
|
+
return new RpcError(createDiagnostic("MOSTRA_HOME_LOCKED", { message }));
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
/**
|
|
120
|
+
* Refuses a data directory on a network filesystem (`MOSTRA_HOME_NETWORK_FILESYSTEM`), before
|
|
121
|
+
* anything in it is opened. `MOSTRA_TEST_NETWORK_FILESYSTEM` names a directory tests treat as one,
|
|
122
|
+
* since no test machine mounts NFS.
|
|
123
|
+
*/
|
|
124
|
+
function refuseNetworkFilesystem(dir: string, env: Environment): void {
|
|
125
|
+
const testing = env["MOSTRA_TEST_NETWORK_FILESYSTEM"];
|
|
126
|
+
const found =
|
|
127
|
+
testing !== undefined && testing !== "" && dir.startsWith(testing)
|
|
128
|
+
? "nfs (test)"
|
|
129
|
+
: networkFilesystem(dir);
|
|
130
|
+
if (found !== undefined) {
|
|
131
|
+
throw new RpcError(
|
|
132
|
+
createDiagnostic("MOSTRA_HOME_NETWORK_FILESYSTEM", {
|
|
133
|
+
message: `The data directory ${dir} is on a network filesystem (${found}); a remote server's homes need a local disk.`,
|
|
134
|
+
}),
|
|
135
|
+
);
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
/** Opens and holds a server's data directory. Throws `MOSTRA_HOME_LOCKED` when another server holds it. */
|
|
140
|
+
export async function openDataDirectory<T>(
|
|
141
|
+
options: DataDirectoryOptions<T>,
|
|
142
|
+
): Promise<DataDirectory<T>> {
|
|
143
|
+
const { dir, log } = options;
|
|
144
|
+
mkdirSync(dir, { recursive: true, mode: 0o700 });
|
|
145
|
+
ownedDirectory(dir);
|
|
146
|
+
refuseNetworkFilesystem(dir, options.env);
|
|
147
|
+
const serverLock = holdLock(join(dir, "server.lock"), options.owner);
|
|
148
|
+
if (!serverLock) {
|
|
149
|
+
throw locked(`Another server process holds the data directory ${dir} (server.lock).`);
|
|
150
|
+
}
|
|
151
|
+
let directory: Ledger;
|
|
152
|
+
try {
|
|
153
|
+
const opening = openLedger({
|
|
154
|
+
storeDir: dir,
|
|
155
|
+
fileName: "server.sqlite",
|
|
156
|
+
runtimeVersion: options.runtimeVersion,
|
|
157
|
+
owner: options.owner,
|
|
158
|
+
log,
|
|
159
|
+
migrations: SERVER_MIGRATIONS,
|
|
160
|
+
locking: "normal",
|
|
161
|
+
...(options.walAutocheckpoint !== undefined
|
|
162
|
+
? { walAutocheckpoint: options.walAutocheckpoint }
|
|
163
|
+
: {}),
|
|
164
|
+
});
|
|
165
|
+
if (!opening.ok) throw locked(`server.sqlite in ${dir} is locked by another process.`);
|
|
166
|
+
directory = opening.ledger;
|
|
167
|
+
} catch (error) {
|
|
168
|
+
serverLock.release();
|
|
169
|
+
throw error;
|
|
170
|
+
}
|
|
171
|
+
mkdirSync(join(dir, "homes"), { recursive: true, mode: 0o700 });
|
|
172
|
+
mkdirSync(join(dir, "files"), { recursive: true, mode: 0o700 });
|
|
173
|
+
mkdirSync(join(dir, "keys"), { recursive: true, mode: 0o700 });
|
|
174
|
+
|
|
175
|
+
interface Entry {
|
|
176
|
+
opening: Promise<OpenedHome<T>>;
|
|
177
|
+
lock?: HeldLock;
|
|
178
|
+
ledger?: Ledger;
|
|
179
|
+
incarnation?: () => string;
|
|
180
|
+
lastUsed: number;
|
|
181
|
+
closing?: Promise<void>;
|
|
182
|
+
}
|
|
183
|
+
const entries = new Map<string, Entry>();
|
|
184
|
+
/** `--restored`'s homes not opened since this server started. */
|
|
185
|
+
const restores = new Set(options.restored ?? []);
|
|
186
|
+
|
|
187
|
+
/** Writes a home's high-water marks, which a home opened below them was restored. */
|
|
188
|
+
const recordCursor = (id: string, ledger: Ledger, incarnation: string): void => {
|
|
189
|
+
const { head, relayHigh } = marksOf(ledger);
|
|
190
|
+
directory.write((db) =>
|
|
191
|
+
db.run(
|
|
192
|
+
`INSERT INTO home_cursor (home_id, incarnation, high_cursor, relay_high, updated_at)
|
|
193
|
+
VALUES (?, ?, ?, ?, ?)
|
|
194
|
+
ON CONFLICT(home_id) DO UPDATE SET incarnation = excluded.incarnation,
|
|
195
|
+
high_cursor = excluded.high_cursor, relay_high = excluded.relay_high,
|
|
196
|
+
updated_at = excluded.updated_at`,
|
|
197
|
+
id,
|
|
198
|
+
incarnation,
|
|
199
|
+
head,
|
|
200
|
+
relayHigh,
|
|
201
|
+
new Date().toISOString(),
|
|
202
|
+
),
|
|
203
|
+
);
|
|
204
|
+
};
|
|
205
|
+
const idleCloseMs = options.idleCloseMs ?? 10 * 60_000;
|
|
206
|
+
let closed = false;
|
|
207
|
+
|
|
208
|
+
const openHome = async (id: string): Promise<OpenedHome<T>> => {
|
|
209
|
+
const row = directory.read((db) =>
|
|
210
|
+
db.get<{ data_path: string; drained_at: string | null }>(
|
|
211
|
+
"SELECT data_path, drained_at FROM home WHERE id = ?",
|
|
212
|
+
id,
|
|
213
|
+
),
|
|
214
|
+
);
|
|
215
|
+
if (!row) {
|
|
216
|
+
throw new RpcError(
|
|
217
|
+
createDiagnostic("MOSTRA_HOST_INVALID_PARAMS", { message: `No hosted home ${id}.` }),
|
|
218
|
+
);
|
|
219
|
+
}
|
|
220
|
+
if (row.drained_at !== null) {
|
|
221
|
+
throw new RpcError(
|
|
222
|
+
createDiagnostic("MOSTRA_REMOTE_HOME_MOVING", {
|
|
223
|
+
message: "This account's pages are moving to another machine; try again in a minute.",
|
|
224
|
+
}),
|
|
225
|
+
);
|
|
226
|
+
}
|
|
227
|
+
const homeDir = join(dir, row.data_path);
|
|
228
|
+
mkdirSync(homeDir, { recursive: true, mode: 0o700 });
|
|
229
|
+
const lock = holdLock(join(homeDir, "home.lock"), options.owner);
|
|
230
|
+
if (!lock) throw locked(`Another process holds the hosted home ${id} (home.lock).`);
|
|
231
|
+
try {
|
|
232
|
+
const opening = openLedger({
|
|
233
|
+
storeDir: join(homeDir, "store"),
|
|
234
|
+
runtimeVersion: options.runtimeVersion,
|
|
235
|
+
owner: options.owner,
|
|
236
|
+
log,
|
|
237
|
+
locking: "normal",
|
|
238
|
+
...(options.walAutocheckpoint !== undefined
|
|
239
|
+
? { walAutocheckpoint: options.walAutocheckpoint }
|
|
240
|
+
: {}),
|
|
241
|
+
});
|
|
242
|
+
if (!opening.ok) throw locked(`The hosted home ${id}'s ledger is locked by another process.`);
|
|
243
|
+
const ledger = opening.ledger;
|
|
244
|
+
const stored = ledger.write((db) => {
|
|
245
|
+
const meta = db.get<{ incarnation: string }>(
|
|
246
|
+
"SELECT incarnation FROM home_meta WHERE id = 1",
|
|
247
|
+
);
|
|
248
|
+
if (meta) return meta.incarnation;
|
|
249
|
+
const fresh = randomBytes(16).toString("hex");
|
|
250
|
+
db.run(
|
|
251
|
+
"INSERT INTO home_meta (id, incarnation, created_at) VALUES (1, ?, ?)",
|
|
252
|
+
fresh,
|
|
253
|
+
new Date().toISOString(),
|
|
254
|
+
);
|
|
255
|
+
return fresh;
|
|
256
|
+
});
|
|
257
|
+
// A home restored from a backup reuses cursors its owner may have copied: it rotates its
|
|
258
|
+
// incarnation before it answers anyone, when restored by hand or when it opens below the
|
|
259
|
+
// marks it reached (INTERFACES §18.2, FAILURE_MODEL §11.2).
|
|
260
|
+
const recorded = directory.read((db) =>
|
|
261
|
+
db.get<{ high_cursor: number; relay_high: number }>(
|
|
262
|
+
"SELECT high_cursor, relay_high FROM home_cursor WHERE home_id = ?",
|
|
263
|
+
id,
|
|
264
|
+
),
|
|
265
|
+
);
|
|
266
|
+
const marks = marksOf(ledger);
|
|
267
|
+
const byHand = restores.has(id) || restores.has("all");
|
|
268
|
+
restores.delete(id);
|
|
269
|
+
const below =
|
|
270
|
+
recorded !== undefined &&
|
|
271
|
+
(marks.head < recorded.high_cursor || marks.relayHigh < recorded.relay_high);
|
|
272
|
+
const incarnation = byHand || below ? rotateIncarnation(ledger) : stored;
|
|
273
|
+
if (incarnation !== stored) {
|
|
274
|
+
log.warn("server.home_rotated", { home: id, why: byHand ? "restored" : "below-mark" });
|
|
275
|
+
}
|
|
276
|
+
recordCursor(id, ledger, incarnation);
|
|
277
|
+
try {
|
|
278
|
+
const assembled = await options.assembler.assemble({
|
|
279
|
+
id,
|
|
280
|
+
dir: homeDir,
|
|
281
|
+
ledger,
|
|
282
|
+
incarnation,
|
|
283
|
+
});
|
|
284
|
+
const entry = entries.get(id);
|
|
285
|
+
if (entry) {
|
|
286
|
+
entry.lock = lock;
|
|
287
|
+
entry.ledger = ledger;
|
|
288
|
+
entry.incarnation = () => options.assembler.incarnation?.(assembled) ?? incarnation;
|
|
289
|
+
}
|
|
290
|
+
log.info("server.home_opened", { home: id });
|
|
291
|
+
return { id, dir: homeDir, ledger, incarnation, assembled };
|
|
292
|
+
} catch (error) {
|
|
293
|
+
ledger.close();
|
|
294
|
+
throw error;
|
|
295
|
+
}
|
|
296
|
+
} catch (error) {
|
|
297
|
+
lock.release();
|
|
298
|
+
throw error;
|
|
299
|
+
}
|
|
300
|
+
};
|
|
301
|
+
|
|
302
|
+
const closeHome = async (id: string, entry: Entry): Promise<void> => {
|
|
303
|
+
const opened = await entry.opening.catch(() => undefined);
|
|
304
|
+
if (opened) {
|
|
305
|
+
try {
|
|
306
|
+
recordCursor(id, opened.ledger, entry.incarnation?.() ?? opened.incarnation);
|
|
307
|
+
} catch (error) {
|
|
308
|
+
log.warn("server.home_cursor_failed", { home: id, error });
|
|
309
|
+
}
|
|
310
|
+
await options.assembler
|
|
311
|
+
.disassemble(opened.assembled)
|
|
312
|
+
.catch((error: unknown) => log.warn("server.home_disassemble_failed", { home: id, error }));
|
|
313
|
+
opened.ledger.close();
|
|
314
|
+
}
|
|
315
|
+
entry.lock?.release();
|
|
316
|
+
entries.delete(id);
|
|
317
|
+
log.info("server.home_closed", { home: id });
|
|
318
|
+
};
|
|
319
|
+
|
|
320
|
+
const sweep = setInterval(
|
|
321
|
+
() => {
|
|
322
|
+
const now = Date.now();
|
|
323
|
+
for (const [id, entry] of entries) {
|
|
324
|
+
if (entry.closing || now - entry.lastUsed < idleCloseMs) continue;
|
|
325
|
+
void entry.opening.then(
|
|
326
|
+
(opened) => {
|
|
327
|
+
if (options.assembler.busy(opened.assembled) || entry.closing) return;
|
|
328
|
+
if (Date.now() - entry.lastUsed < idleCloseMs) return;
|
|
329
|
+
entry.closing = closeHome(id, entry);
|
|
330
|
+
},
|
|
331
|
+
() => {
|
|
332
|
+
entries.delete(id);
|
|
333
|
+
},
|
|
334
|
+
);
|
|
335
|
+
}
|
|
336
|
+
},
|
|
337
|
+
Math.min(30_000, Math.max(50, idleCloseMs / 4)),
|
|
338
|
+
);
|
|
339
|
+
sweep.unref();
|
|
340
|
+
// At least every 10 s while a home is open (DATA_MODEL §7.1).
|
|
341
|
+
const marker = setInterval(() => {
|
|
342
|
+
for (const [id, entry] of entries) {
|
|
343
|
+
if (!entry.ledger || entry.closing) continue;
|
|
344
|
+
try {
|
|
345
|
+
recordCursor(id, entry.ledger, entry.incarnation?.() ?? "");
|
|
346
|
+
} catch (error) {
|
|
347
|
+
log.warn("server.home_cursor_failed", { home: id, error });
|
|
348
|
+
}
|
|
349
|
+
}
|
|
350
|
+
}, 10_000);
|
|
351
|
+
marker.unref();
|
|
352
|
+
|
|
353
|
+
return {
|
|
354
|
+
dir,
|
|
355
|
+
directory,
|
|
356
|
+
async home(id) {
|
|
357
|
+
if (closed) throw locked("The server is stopping.");
|
|
358
|
+
for (;;) {
|
|
359
|
+
const entry = entries.get(id);
|
|
360
|
+
if (entry?.closing) {
|
|
361
|
+
await entry.closing;
|
|
362
|
+
continue;
|
|
363
|
+
}
|
|
364
|
+
if (entry) {
|
|
365
|
+
entry.lastUsed = Date.now();
|
|
366
|
+
return entry.opening;
|
|
367
|
+
}
|
|
368
|
+
const fresh: Entry = { opening: openHome(id), lastUsed: Date.now() };
|
|
369
|
+
entries.set(id, fresh);
|
|
370
|
+
fresh.opening.catch(() => {
|
|
371
|
+
if (entries.get(id) === fresh) entries.delete(id);
|
|
372
|
+
});
|
|
373
|
+
return fresh.opening;
|
|
374
|
+
}
|
|
375
|
+
},
|
|
376
|
+
open: () => [...entries.keys()],
|
|
377
|
+
touch(id) {
|
|
378
|
+
const entry = entries.get(id);
|
|
379
|
+
if (entry) entry.lastUsed = Date.now();
|
|
380
|
+
},
|
|
381
|
+
async closeHome(id) {
|
|
382
|
+
const entry = entries.get(id);
|
|
383
|
+
if (!entry) return;
|
|
384
|
+
entry.closing ??= closeHome(id, entry);
|
|
385
|
+
await entry.closing;
|
|
386
|
+
},
|
|
387
|
+
async drain(id) {
|
|
388
|
+
directory.write((db) =>
|
|
389
|
+
db.run(
|
|
390
|
+
"UPDATE home SET drained_at = COALESCE(drained_at, ?) WHERE id = ?",
|
|
391
|
+
new Date().toISOString(),
|
|
392
|
+
id,
|
|
393
|
+
),
|
|
394
|
+
);
|
|
395
|
+
const entry = entries.get(id);
|
|
396
|
+
if (entry) {
|
|
397
|
+
entry.closing ??= closeHome(id, entry);
|
|
398
|
+
await entry.closing;
|
|
399
|
+
}
|
|
400
|
+
log.info("server.home_drained", { home: id });
|
|
401
|
+
},
|
|
402
|
+
undrain(id) {
|
|
403
|
+
directory.write((db) => db.run("UPDATE home SET drained_at = NULL WHERE id = ?", id));
|
|
404
|
+
log.info("server.home_released", { home: id });
|
|
405
|
+
},
|
|
406
|
+
async restored(id) {
|
|
407
|
+
restores.add(id);
|
|
408
|
+
const entry = entries.get(id);
|
|
409
|
+
if (entry) {
|
|
410
|
+
entry.closing ??= closeHome(id, entry);
|
|
411
|
+
await entry.closing;
|
|
412
|
+
}
|
|
413
|
+
},
|
|
414
|
+
async close() {
|
|
415
|
+
if (closed) return;
|
|
416
|
+
closed = true;
|
|
417
|
+
clearInterval(sweep);
|
|
418
|
+
clearInterval(marker);
|
|
419
|
+
for (const [id, entry] of [...entries]) {
|
|
420
|
+
entry.closing ??= closeHome(id, entry);
|
|
421
|
+
await entry.closing;
|
|
422
|
+
}
|
|
423
|
+
directory.close();
|
|
424
|
+
serverLock.release();
|
|
425
|
+
},
|
|
426
|
+
};
|
|
427
|
+
}
|
|
@@ -0,0 +1,210 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A remote server's directory ledger, `server.sqlite` (DATA_MODEL §7.1): what spans hosted homes,
|
|
3
|
+
* and only that. Accounts and their sign-in identities, the homes and the instances linked to
|
|
4
|
+
* them, the hosted routes and every label ever issued, which home holds which version file, and
|
|
5
|
+
* the authorization server's clients, grants and tokens (stored only as SHA-256 hashes).
|
|
6
|
+
*/
|
|
7
|
+
import type { Migration } from "../ledger/index.ts";
|
|
8
|
+
|
|
9
|
+
/** The server directory's migrations: their own list, apart from a home's. */
|
|
10
|
+
export const SERVER_MIGRATIONS: readonly Migration[] = [
|
|
11
|
+
{
|
|
12
|
+
version: 1,
|
|
13
|
+
name: "server directory",
|
|
14
|
+
up(db) {
|
|
15
|
+
db.exec(`
|
|
16
|
+
CREATE TABLE account (
|
|
17
|
+
id TEXT PRIMARY KEY,
|
|
18
|
+
name TEXT,
|
|
19
|
+
status TEXT NOT NULL CHECK (status IN ('active', 'suspended')),
|
|
20
|
+
created_at TEXT NOT NULL
|
|
21
|
+
);
|
|
22
|
+
CREATE TABLE identity (
|
|
23
|
+
provider TEXT NOT NULL,
|
|
24
|
+
subject TEXT NOT NULL,
|
|
25
|
+
account_id TEXT NOT NULL REFERENCES account(id),
|
|
26
|
+
email TEXT,
|
|
27
|
+
name TEXT,
|
|
28
|
+
linked_at TEXT NOT NULL,
|
|
29
|
+
PRIMARY KEY (provider, subject)
|
|
30
|
+
);
|
|
31
|
+
CREATE TABLE home (
|
|
32
|
+
id TEXT PRIMARY KEY,
|
|
33
|
+
owner_account_id TEXT NOT NULL UNIQUE REFERENCES account(id),
|
|
34
|
+
data_path TEXT NOT NULL,
|
|
35
|
+
created_at TEXT NOT NULL,
|
|
36
|
+
suspended_at TEXT
|
|
37
|
+
);
|
|
38
|
+
CREATE TABLE instance_link (
|
|
39
|
+
id TEXT PRIMARY KEY,
|
|
40
|
+
account_id TEXT NOT NULL REFERENCES account(id),
|
|
41
|
+
home_id TEXT NOT NULL REFERENCES home(id),
|
|
42
|
+
name TEXT NOT NULL,
|
|
43
|
+
is_default INTEGER NOT NULL DEFAULT 0,
|
|
44
|
+
relay_high INTEGER NOT NULL DEFAULT 0,
|
|
45
|
+
linked_at TEXT NOT NULL,
|
|
46
|
+
revoked_at TEXT
|
|
47
|
+
);
|
|
48
|
+
CREATE UNIQUE INDEX instance_link_default ON instance_link(account_id) WHERE is_default = 1;
|
|
49
|
+
CREATE TABLE home_cursor (
|
|
50
|
+
home_id TEXT PRIMARY KEY REFERENCES home(id),
|
|
51
|
+
incarnation TEXT NOT NULL,
|
|
52
|
+
high_cursor INTEGER NOT NULL,
|
|
53
|
+
relay_high INTEGER NOT NULL,
|
|
54
|
+
updated_at TEXT NOT NULL
|
|
55
|
+
);
|
|
56
|
+
CREATE TABLE artifact_route (
|
|
57
|
+
id TEXT PRIMARY KEY,
|
|
58
|
+
home_id TEXT NOT NULL REFERENCES home(id),
|
|
59
|
+
artifact_id TEXT NOT NULL,
|
|
60
|
+
owner_link_id TEXT NOT NULL REFERENCES instance_link(id),
|
|
61
|
+
label TEXT NOT NULL UNIQUE,
|
|
62
|
+
created_at TEXT NOT NULL,
|
|
63
|
+
UNIQUE (home_id, artifact_id)
|
|
64
|
+
);
|
|
65
|
+
CREATE TABLE label_issued (
|
|
66
|
+
label TEXT PRIMARY KEY,
|
|
67
|
+
home_id TEXT NOT NULL,
|
|
68
|
+
route_id TEXT,
|
|
69
|
+
kind TEXT NOT NULL CHECK (kind IN ('server', 'operator')),
|
|
70
|
+
issued_at TEXT NOT NULL
|
|
71
|
+
);
|
|
72
|
+
-- A label is issued once, forever: never deleted, never moved to another home.
|
|
73
|
+
CREATE TRIGGER label_issued_kept BEFORE DELETE ON label_issued
|
|
74
|
+
BEGIN
|
|
75
|
+
SELECT RAISE(ABORT, 'an issued label is kept forever');
|
|
76
|
+
END;
|
|
77
|
+
CREATE TRIGGER label_issued_fixed BEFORE UPDATE ON label_issued
|
|
78
|
+
WHEN NEW.label IS NOT OLD.label OR NEW.home_id IS NOT OLD.home_id
|
|
79
|
+
BEGIN
|
|
80
|
+
SELECT RAISE(ABORT, 'an issued label never moves');
|
|
81
|
+
END;
|
|
82
|
+
CREATE TABLE home_file (
|
|
83
|
+
home_id TEXT NOT NULL REFERENCES home(id),
|
|
84
|
+
sha256 TEXT NOT NULL,
|
|
85
|
+
PRIMARY KEY (home_id, sha256)
|
|
86
|
+
);
|
|
87
|
+
CREATE TABLE file_ref (
|
|
88
|
+
sha256 TEXT PRIMARY KEY,
|
|
89
|
+
homes INTEGER NOT NULL CHECK (homes >= 0),
|
|
90
|
+
unreferenced_at TEXT
|
|
91
|
+
);
|
|
92
|
+
CREATE TABLE oauth_client (
|
|
93
|
+
id TEXT PRIMARY KEY,
|
|
94
|
+
kind TEXT NOT NULL CHECK (kind IN ('metadata', 'registered', 'shell', 'cli')),
|
|
95
|
+
metadata_json TEXT NOT NULL,
|
|
96
|
+
created_at TEXT NOT NULL,
|
|
97
|
+
last_used_at TEXT
|
|
98
|
+
);
|
|
99
|
+
CREATE TABLE consent (
|
|
100
|
+
account_id TEXT NOT NULL REFERENCES account(id),
|
|
101
|
+
client_id TEXT NOT NULL REFERENCES oauth_client(id),
|
|
102
|
+
granted_at TEXT NOT NULL,
|
|
103
|
+
revoked_at TEXT,
|
|
104
|
+
PRIMARY KEY (account_id, client_id)
|
|
105
|
+
);
|
|
106
|
+
CREATE TABLE sender_shown (
|
|
107
|
+
account_id TEXT NOT NULL,
|
|
108
|
+
home_id TEXT NOT NULL,
|
|
109
|
+
at TEXT NOT NULL,
|
|
110
|
+
PRIMARY KEY (account_id, home_id)
|
|
111
|
+
);
|
|
112
|
+
CREATE TABLE "grant" (
|
|
113
|
+
id TEXT PRIMARY KEY,
|
|
114
|
+
account_id TEXT NOT NULL REFERENCES account(id),
|
|
115
|
+
client_id TEXT NOT NULL REFERENCES oauth_client(id),
|
|
116
|
+
scope TEXT NOT NULL,
|
|
117
|
+
resource TEXT NOT NULL,
|
|
118
|
+
link_id TEXT REFERENCES instance_link(id),
|
|
119
|
+
created_at TEXT NOT NULL,
|
|
120
|
+
revoked_at TEXT
|
|
121
|
+
);
|
|
122
|
+
CREATE TABLE token (
|
|
123
|
+
hash TEXT PRIMARY KEY,
|
|
124
|
+
grant_id TEXT REFERENCES "grant"(id),
|
|
125
|
+
kind TEXT NOT NULL CHECK (kind IN ('access', 'refresh', 'device', 'code')),
|
|
126
|
+
expires_at TEXT NOT NULL,
|
|
127
|
+
used_at TEXT,
|
|
128
|
+
successor_hash TEXT,
|
|
129
|
+
data_json TEXT
|
|
130
|
+
);
|
|
131
|
+
CREATE TABLE outbound (
|
|
132
|
+
id TEXT PRIMARY KEY,
|
|
133
|
+
port TEXT NOT NULL CHECK (port IN ('metering', 'events')),
|
|
134
|
+
payload_json TEXT NOT NULL,
|
|
135
|
+
attempts INTEGER NOT NULL DEFAULT 0,
|
|
136
|
+
next_attempt_at TEXT NOT NULL
|
|
137
|
+
);
|
|
138
|
+
`);
|
|
139
|
+
},
|
|
140
|
+
},
|
|
141
|
+
{
|
|
142
|
+
version: 2,
|
|
143
|
+
name: "operator, sign-in and links",
|
|
144
|
+
up(db) {
|
|
145
|
+
// WP-30 (DATA_MODEL §7.1, additive). A home an operator drained is refused until released;
|
|
146
|
+
// the hosted links of every home, so a handle's revokeLink finds its home; the instance link
|
|
147
|
+
// of each operator-issued credential; sign-ins in progress and the API origin's browser
|
|
148
|
+
// sessions (both by SHA-256 only); and the monthly metering keys' months.
|
|
149
|
+
db.exec(`
|
|
150
|
+
ALTER TABLE home ADD COLUMN drained_at TEXT;
|
|
151
|
+
ALTER TABLE home ADD COLUMN suspend_reason TEXT;
|
|
152
|
+
CREATE TABLE hosted_token (
|
|
153
|
+
token_id TEXT PRIMARY KEY,
|
|
154
|
+
home_id TEXT NOT NULL REFERENCES home(id),
|
|
155
|
+
route_id TEXT NOT NULL
|
|
156
|
+
);
|
|
157
|
+
CREATE TABLE credential_link (
|
|
158
|
+
account_id TEXT NOT NULL REFERENCES account(id),
|
|
159
|
+
subject TEXT NOT NULL,
|
|
160
|
+
link_id TEXT NOT NULL REFERENCES instance_link(id),
|
|
161
|
+
PRIMARY KEY (account_id, subject)
|
|
162
|
+
);
|
|
163
|
+
CREATE TABLE signin (
|
|
164
|
+
hash TEXT PRIMARY KEY,
|
|
165
|
+
kind TEXT NOT NULL CHECK (kind IN ('provider', 'step', 'authorize')),
|
|
166
|
+
data_json TEXT NOT NULL,
|
|
167
|
+
expires_at TEXT NOT NULL
|
|
168
|
+
);
|
|
169
|
+
CREATE TABLE browser_session (
|
|
170
|
+
hash TEXT PRIMARY KEY,
|
|
171
|
+
account_id TEXT NOT NULL REFERENCES account(id),
|
|
172
|
+
created_at TEXT NOT NULL,
|
|
173
|
+
expires_at TEXT NOT NULL
|
|
174
|
+
);
|
|
175
|
+
CREATE INDEX browser_session_account ON browser_session(account_id);
|
|
176
|
+
-- A host an operator supplies through routing (D165 item 7, D167): a hosted shell for one
|
|
177
|
+
-- home (or one route of it), its frames on <label>.<frame_domain>. Recorded with its
|
|
178
|
+
-- label_issued row when first served, kept forever and never moved to another home.
|
|
179
|
+
CREATE TABLE operator_host (
|
|
180
|
+
host TEXT PRIMARY KEY,
|
|
181
|
+
home_id TEXT NOT NULL REFERENCES home(id),
|
|
182
|
+
route_id TEXT,
|
|
183
|
+
frame_domain TEXT NOT NULL,
|
|
184
|
+
recorded_at TEXT NOT NULL
|
|
185
|
+
);
|
|
186
|
+
CREATE INDEX operator_host_frames ON operator_host(frame_domain);
|
|
187
|
+
CREATE TRIGGER operator_host_kept BEFORE DELETE ON operator_host
|
|
188
|
+
BEGIN
|
|
189
|
+
SELECT RAISE(ABORT, 'an operator host is kept forever');
|
|
190
|
+
END;
|
|
191
|
+
CREATE TRIGGER operator_host_fixed BEFORE UPDATE ON operator_host
|
|
192
|
+
WHEN NEW.host IS NOT OLD.host OR NEW.home_id IS NOT OLD.home_id
|
|
193
|
+
BEGIN
|
|
194
|
+
SELECT RAISE(ABORT, 'an operator host never moves to another home');
|
|
195
|
+
END;
|
|
196
|
+
`);
|
|
197
|
+
},
|
|
198
|
+
},
|
|
199
|
+
{
|
|
200
|
+
version: 3,
|
|
201
|
+
name: "a route's removal in progress",
|
|
202
|
+
up(db) {
|
|
203
|
+
// ServerHandle.remove spans two databases, the home's ledger and this directory, so it
|
|
204
|
+
// records its plan here first (the versions and client files it removes); a removal cut
|
|
205
|
+
// off between them is finished by the next call, and the route serves nothing meanwhile
|
|
206
|
+
// (Fable review of WP-30, 4).
|
|
207
|
+
db.exec("ALTER TABLE artifact_route ADD COLUMN removing_json TEXT");
|
|
208
|
+
},
|
|
209
|
+
},
|
|
210
|
+
];
|