@mostra/runtime 0.10.0 → 0.12.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 +4178 -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-CBUlOmzG.js} +1892 -85
- package/dist/instance-CBUlOmzG.js.map +1 -0
- package/dist/reference/cli.md +1432 -0
- package/dist/reference/diagnostics.json +1579 -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_TEAM_PRESENCE_RATE_LIMITED.md +23 -0
- package/dist/reference/errors/MOSTRA_TEAM_ROSTER_POLICY.md +23 -0
- package/dist/reference/errors/MOSTRA_TEAM_ROSTER_TOO_LARGE.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 +124 -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 +219 -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/teams.md +78 -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 +128 -1
- package/src/gateway/capabilities.ts +8 -0
- package/src/gateway/http.ts +12 -1
- package/src/gateway/index.ts +210 -6
- package/src/gateway/listener.ts +31 -6
- package/src/gateway/routes.ts +8 -0
- package/src/gateway/team.ts +181 -0
- package/src/gc/index.ts +5 -0
- package/src/instance/index.ts +22 -2
- package/src/interaction/ephemeral.ts +21 -0
- package/src/interaction/events.ts +17 -0
- package/src/interaction/index.ts +325 -20
- package/src/interaction/pause.ts +106 -0
- package/src/interaction/roster.ts +585 -0
- package/src/interaction/submissions.ts +42 -1
- package/src/interaction/team.ts +426 -0
- package/src/interaction/viewers.ts +34 -1
- package/src/interaction/wait.ts +150 -0
- package/src/ledger/index.ts +20 -1
- package/src/ledger/migrations.ts +86 -0
- package/src/link/author.ts +215 -0
- package/src/link/hosted.ts +51 -4
- package/src/link/http.ts +6 -1
- package/src/link/index.ts +3 -1
- package/src/link/manager.ts +169 -35
- 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 +91 -0
- package/src/server/feed.ts +277 -0
- package/src/server/handle.ts +172 -0
- package/src/server/hosted-pages.ts +532 -0
- package/src/server/hosted.ts +551 -18
- package/src/server/index.ts +353 -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 +557 -0
- package/src/server/providers.ts +284 -0
- package/src/server/remove.ts +148 -0
- package/src/server/routing.ts +275 -0
- package/src/share/index.ts +50 -2
- package/src/verify/index.ts +7 -0
- package/src/verify/runner.ts +27 -2
- package/dist/instance-FExcyENK.js.map +0 -1
|
@@ -0,0 +1,284 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The remote server's identity providers (INTERFACES §18.5, D165 item 8): the sign-in port's
|
|
3
|
+
* built-in adapters, configured in `identityProviders`, beside those an operator module supplies
|
|
4
|
+
* (asked at every sign-in, so its set can change while the server runs, D167):
|
|
5
|
+
*
|
|
6
|
+
* - `oidc`: any OpenID Connect provider, by its issuer's discovery document; the authorization
|
|
7
|
+
* code flow with PKCE (S256) and a nonce, and the ID token checked (signature, issuer, audience,
|
|
8
|
+
* expiry, nonce) by `openid-client`.
|
|
9
|
+
* - `github`: GitHub's OAuth web flow with PKCE, then `GET /user` for the account's stable ID, its
|
|
10
|
+
* login and name, and its age (`facts.createdAt`) for an operator's policy.
|
|
11
|
+
* - `development`: a page that asks for a name and trusts it, for tests and a self-hoster's first
|
|
12
|
+
* run; its names are never shown as verified.
|
|
13
|
+
*
|
|
14
|
+
* A provider's client secret is read from `clientSecretFile`, never from the configuration itself,
|
|
15
|
+
* and is never logged.
|
|
16
|
+
*/
|
|
17
|
+
import { readFileSync } from "node:fs";
|
|
18
|
+
import { createDiagnostic, RpcError } from "@mostra/protocol";
|
|
19
|
+
import type {
|
|
20
|
+
IdentityProvider,
|
|
21
|
+
SignInContext,
|
|
22
|
+
SignInIdentity,
|
|
23
|
+
SignInPkce,
|
|
24
|
+
} from "@mostra/protocol/operator";
|
|
25
|
+
import * as oidc from "openid-client";
|
|
26
|
+
import type { Environment, Log } from "../log.ts";
|
|
27
|
+
import type { IdentityProviderConfig } from "./config.ts";
|
|
28
|
+
|
|
29
|
+
/** How long a provider's discovery, token exchange or user lookup may take. */
|
|
30
|
+
const PROVIDER_TIMEOUT_MS = 8_000;
|
|
31
|
+
|
|
32
|
+
/** GitHub's endpoints (VERIFIED_FACTS, WP-30). */
|
|
33
|
+
const GITHUB = {
|
|
34
|
+
authorize: "https://github.com/login/oauth/authorize",
|
|
35
|
+
token: "https://github.com/login/oauth/access_token",
|
|
36
|
+
user: "https://api.github.com/user",
|
|
37
|
+
} as const;
|
|
38
|
+
|
|
39
|
+
/** A built-in provider: the port's shape, and whether its names are verified. */
|
|
40
|
+
export interface BuiltInProvider extends IdentityProvider {
|
|
41
|
+
readonly kind: IdentityProviderConfig["kind"];
|
|
42
|
+
/** Whether the names it gives are verified by someone (all but `development`). */
|
|
43
|
+
readonly verifies: boolean;
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
function invalid(message: string): RpcError {
|
|
47
|
+
return new RpcError(createDiagnostic("MOSTRA_REMOTE_CONFIG_INVALID", { message }));
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
function secretOf(config: IdentityProviderConfig): string {
|
|
51
|
+
if (config.clientSecretFile === undefined) {
|
|
52
|
+
throw invalid(
|
|
53
|
+
`The identity provider \`${config.id}\` needs \`clientSecretFile\`, a file holding its client secret.`,
|
|
54
|
+
);
|
|
55
|
+
}
|
|
56
|
+
try {
|
|
57
|
+
const secret = readFileSync(config.clientSecretFile, "utf8").trim();
|
|
58
|
+
if (secret === "") throw new Error("empty");
|
|
59
|
+
return secret;
|
|
60
|
+
} catch {
|
|
61
|
+
throw invalid(
|
|
62
|
+
`The identity provider \`${config.id}\`'s \`clientSecretFile\` (${config.clientSecretFile}) can't be read, or is empty.`,
|
|
63
|
+
);
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
/** A fetch bounded in time, for a provider's own endpoints. */
|
|
68
|
+
async function timedFetch(url: string, init: RequestInit): Promise<Response> {
|
|
69
|
+
return fetch(url, { ...init, signal: AbortSignal.timeout(PROVIDER_TIMEOUT_MS) });
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
/** The OpenID Connect adapter. Discovery happens at the first sign-in and is kept. */
|
|
73
|
+
function oidcProvider(config: IdentityProviderConfig, env: Environment): BuiltInProvider {
|
|
74
|
+
if (config.issuer === undefined || config.clientId === undefined) {
|
|
75
|
+
throw invalid(
|
|
76
|
+
`The identity provider \`${config.id}\` (oidc) needs \`issuer\` and \`clientId\`.`,
|
|
77
|
+
);
|
|
78
|
+
}
|
|
79
|
+
const secret = secretOf(config);
|
|
80
|
+
const issuer = new URL(config.issuer);
|
|
81
|
+
// A test provider on loopback speaks http; nothing else may.
|
|
82
|
+
const insecure =
|
|
83
|
+
issuer.protocol === "http:" &&
|
|
84
|
+
env["MOSTRA_TEST_OIDC_INSECURE"] === "1" &&
|
|
85
|
+
(issuer.hostname === "127.0.0.1" || issuer.hostname === "localhost");
|
|
86
|
+
if (issuer.protocol !== "https:" && !insecure) {
|
|
87
|
+
throw invalid(`The identity provider \`${config.id}\`'s \`issuer\` must be an https: URL.`);
|
|
88
|
+
}
|
|
89
|
+
let discovered: Promise<oidc.Configuration> | undefined;
|
|
90
|
+
const configuration = (): Promise<oidc.Configuration> => {
|
|
91
|
+
discovered ??= oidc
|
|
92
|
+
.discovery(
|
|
93
|
+
issuer,
|
|
94
|
+
config.clientId as string,
|
|
95
|
+
undefined,
|
|
96
|
+
oidc.ClientSecretPost(secret),
|
|
97
|
+
insecure ? { execute: [oidc.allowInsecureRequests], timeout: 8 } : { timeout: 8 },
|
|
98
|
+
)
|
|
99
|
+
.catch((error: unknown) => {
|
|
100
|
+
discovered = undefined;
|
|
101
|
+
throw error;
|
|
102
|
+
});
|
|
103
|
+
return discovered;
|
|
104
|
+
};
|
|
105
|
+
return {
|
|
106
|
+
id: config.id,
|
|
107
|
+
label: config.label ?? config.id,
|
|
108
|
+
kind: "oidc",
|
|
109
|
+
verifies: true,
|
|
110
|
+
async authorize(state: string, pkce: SignInPkce, context: SignInContext) {
|
|
111
|
+
const url = oidc.buildAuthorizationUrl(await configuration(), {
|
|
112
|
+
redirect_uri: context.redirectUri,
|
|
113
|
+
scope: "openid email profile",
|
|
114
|
+
state,
|
|
115
|
+
nonce: context.nonce,
|
|
116
|
+
code_challenge: pkce.challenge,
|
|
117
|
+
code_challenge_method: "S256",
|
|
118
|
+
});
|
|
119
|
+
return url.href;
|
|
120
|
+
},
|
|
121
|
+
async callback(params, context) {
|
|
122
|
+
const current = new URL(context.redirectUri);
|
|
123
|
+
for (const [key, value] of Object.entries(params)) current.searchParams.set(key, value);
|
|
124
|
+
const tokens = await oidc.authorizationCodeGrant(await configuration(), current, {
|
|
125
|
+
pkceCodeVerifier: context.pkce.verifier,
|
|
126
|
+
expectedState: context.state,
|
|
127
|
+
expectedNonce: context.nonce,
|
|
128
|
+
idTokenExpected: true,
|
|
129
|
+
});
|
|
130
|
+
const claims = tokens.claims();
|
|
131
|
+
if (!claims) throw new Error("The provider sent no ID token.");
|
|
132
|
+
const name =
|
|
133
|
+
typeof claims["name"] === "string"
|
|
134
|
+
? claims["name"]
|
|
135
|
+
: typeof claims["preferred_username"] === "string"
|
|
136
|
+
? claims["preferred_username"]
|
|
137
|
+
: undefined;
|
|
138
|
+
const identity: SignInIdentity = {
|
|
139
|
+
provider: config.id,
|
|
140
|
+
subject: claims.sub,
|
|
141
|
+
...(typeof claims["email"] === "string" ? { email: claims["email"] } : {}),
|
|
142
|
+
...(typeof claims["email_verified"] === "boolean"
|
|
143
|
+
? { emailVerified: claims["email_verified"] }
|
|
144
|
+
: {}),
|
|
145
|
+
...(name !== undefined ? { name } : {}),
|
|
146
|
+
};
|
|
147
|
+
return identity;
|
|
148
|
+
},
|
|
149
|
+
};
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
/** The GitHub adapter: an OAuth app's web flow with PKCE (VERIFIED_FACTS, WP-30). */
|
|
153
|
+
function githubProvider(config: IdentityProviderConfig, env: Environment): BuiltInProvider {
|
|
154
|
+
if (config.clientId === undefined) {
|
|
155
|
+
throw invalid(`The identity provider \`${config.id}\` (github) needs \`clientId\`.`);
|
|
156
|
+
}
|
|
157
|
+
const secret = secretOf(config);
|
|
158
|
+
// Tests point the adapter at a fake GitHub on loopback; nothing else may.
|
|
159
|
+
const base = env["MOSTRA_TEST_GITHUB_BASE"];
|
|
160
|
+
const endpoints =
|
|
161
|
+
base !== undefined && /^http:\/\/(127\.0\.0\.1|localhost):\d+$/.test(base)
|
|
162
|
+
? {
|
|
163
|
+
authorize: `${base}/login/oauth/authorize`,
|
|
164
|
+
token: `${base}/login/oauth/access_token`,
|
|
165
|
+
user: `${base}/user`,
|
|
166
|
+
}
|
|
167
|
+
: GITHUB;
|
|
168
|
+
return {
|
|
169
|
+
id: config.id,
|
|
170
|
+
label: config.label ?? "GitHub",
|
|
171
|
+
kind: "github",
|
|
172
|
+
verifies: true,
|
|
173
|
+
authorize(state, pkce, context) {
|
|
174
|
+
const url = new URL(endpoints.authorize);
|
|
175
|
+
url.searchParams.set("client_id", config.clientId as string);
|
|
176
|
+
url.searchParams.set("redirect_uri", context.redirectUri);
|
|
177
|
+
url.searchParams.set("state", state);
|
|
178
|
+
url.searchParams.set("scope", "");
|
|
179
|
+
url.searchParams.set("allow_signup", "true");
|
|
180
|
+
url.searchParams.set("code_challenge", pkce.challenge);
|
|
181
|
+
url.searchParams.set("code_challenge_method", "S256");
|
|
182
|
+
return url.href;
|
|
183
|
+
},
|
|
184
|
+
async callback(params, context) {
|
|
185
|
+
if (params["error"] !== undefined) {
|
|
186
|
+
throw new Error(`GitHub refused the sign-in (${params["error"]}).`);
|
|
187
|
+
}
|
|
188
|
+
const code = params["code"];
|
|
189
|
+
if (code === undefined) throw new Error("GitHub sent no code.");
|
|
190
|
+
const exchanged = await timedFetch(endpoints.token, {
|
|
191
|
+
method: "POST",
|
|
192
|
+
headers: {
|
|
193
|
+
accept: "application/json",
|
|
194
|
+
"content-type": "application/x-www-form-urlencoded",
|
|
195
|
+
},
|
|
196
|
+
body: new URLSearchParams({
|
|
197
|
+
client_id: config.clientId as string,
|
|
198
|
+
client_secret: secret,
|
|
199
|
+
code,
|
|
200
|
+
redirect_uri: context.redirectUri,
|
|
201
|
+
code_verifier: context.pkce.verifier,
|
|
202
|
+
}).toString(),
|
|
203
|
+
});
|
|
204
|
+
const token = (await exchanged.json().catch(() => ({}))) as {
|
|
205
|
+
access_token?: string;
|
|
206
|
+
error?: string;
|
|
207
|
+
};
|
|
208
|
+
if (!exchanged.ok || typeof token.access_token !== "string") {
|
|
209
|
+
throw new Error(`GitHub's code exchange failed (${token.error ?? exchanged.status}).`);
|
|
210
|
+
}
|
|
211
|
+
const user = await timedFetch(endpoints.user, {
|
|
212
|
+
headers: {
|
|
213
|
+
accept: "application/vnd.github+json",
|
|
214
|
+
authorization: `Bearer ${token.access_token}`,
|
|
215
|
+
"user-agent": "mostra-remote-server",
|
|
216
|
+
},
|
|
217
|
+
});
|
|
218
|
+
const found = (await user.json().catch(() => ({}))) as {
|
|
219
|
+
id?: number;
|
|
220
|
+
login?: string;
|
|
221
|
+
name?: string | null;
|
|
222
|
+
email?: string | null;
|
|
223
|
+
created_at?: string;
|
|
224
|
+
};
|
|
225
|
+
if (!user.ok || typeof found.id !== "number") {
|
|
226
|
+
throw new Error(`GitHub's user lookup failed (${user.status}).`);
|
|
227
|
+
}
|
|
228
|
+
return {
|
|
229
|
+
provider: config.id,
|
|
230
|
+
// The numeric ID: a login can be renamed and then taken by someone else.
|
|
231
|
+
subject: String(found.id),
|
|
232
|
+
...(typeof found.email === "string" ? { email: found.email } : {}),
|
|
233
|
+
name: found.name ?? found.login ?? String(found.id),
|
|
234
|
+
facts: {
|
|
235
|
+
login: found.login ?? null,
|
|
236
|
+
...(found.created_at !== undefined ? { createdAt: found.created_at } : {}),
|
|
237
|
+
},
|
|
238
|
+
};
|
|
239
|
+
},
|
|
240
|
+
};
|
|
241
|
+
}
|
|
242
|
+
|
|
243
|
+
/**
|
|
244
|
+
* The development adapter: the device page and the sign-in page ask for a name and trust it
|
|
245
|
+
* (D166 item 4). Its `authorize` sends the person to the server's own name page.
|
|
246
|
+
*/
|
|
247
|
+
function developmentProvider(config: IdentityProviderConfig, apiOrigin: string): BuiltInProvider {
|
|
248
|
+
return {
|
|
249
|
+
id: config.id,
|
|
250
|
+
label: config.label ?? "Development sign-in",
|
|
251
|
+
kind: "development",
|
|
252
|
+
verifies: false,
|
|
253
|
+
authorize(state) {
|
|
254
|
+
const url = new URL(`${apiOrigin}/signin/${config.id}/name`);
|
|
255
|
+
url.searchParams.set("state", state);
|
|
256
|
+
return url.href;
|
|
257
|
+
},
|
|
258
|
+
async callback(params) {
|
|
259
|
+
const name = (params["name"] ?? "").trim().slice(0, 64);
|
|
260
|
+
if (name === "") throw new Error("No name was given.");
|
|
261
|
+
return { provider: config.id, subject: name.toLowerCase(), name };
|
|
262
|
+
},
|
|
263
|
+
};
|
|
264
|
+
}
|
|
265
|
+
|
|
266
|
+
/** Builds the configured providers; a provider it can't use stops the server, naming it. */
|
|
267
|
+
export function builtInProviders(
|
|
268
|
+
configs: readonly IdentityProviderConfig[],
|
|
269
|
+
options: { readonly apiOrigin: string; readonly env: Environment; readonly log: Log },
|
|
270
|
+
): BuiltInProvider[] {
|
|
271
|
+
const seen = new Set<string>();
|
|
272
|
+
return configs.map((config) => {
|
|
273
|
+
if (seen.has(config.id)) throw invalid(`Two identity providers are named \`${config.id}\`.`);
|
|
274
|
+
seen.add(config.id);
|
|
275
|
+
const provider =
|
|
276
|
+
config.kind === "oidc"
|
|
277
|
+
? oidcProvider(config, options.env)
|
|
278
|
+
: config.kind === "github"
|
|
279
|
+
? githubProvider(config, options.env)
|
|
280
|
+
: developmentProvider(config, options.apiOrigin);
|
|
281
|
+
options.log.info("signin.provider", { id: config.id, kind: config.kind });
|
|
282
|
+
return provider;
|
|
283
|
+
});
|
|
284
|
+
}
|
|
@@ -0,0 +1,148 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Removing a hosted artifact (`ServerHandle.remove`, DATA_MODEL §7.5): an explicit deletion,
|
|
3
|
+
* never part of another action. Everything of the artifact goes in one transaction of its home's
|
|
4
|
+
* ledger: its own rows (every table with an `artifact_id`) and every row that references them,
|
|
5
|
+
* followed through the schema's foreign keys, so no table needs listing here and a table a later
|
|
6
|
+
* migration adds is covered by construction. The write-once triggers that keep versions, events,
|
|
7
|
+
* submissions and tokens immutable are dropped for the transaction and created again in it, so the
|
|
8
|
+
* only way past them is this one.
|
|
9
|
+
*/
|
|
10
|
+
import type { MigrationDb, SqlValue } from "../ledger/index.ts";
|
|
11
|
+
|
|
12
|
+
interface ForeignKey {
|
|
13
|
+
readonly table: string;
|
|
14
|
+
readonly from: string;
|
|
15
|
+
readonly to: string;
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
/** What one removal deleted, table by table. */
|
|
19
|
+
export type Removed = Readonly<Record<string, number>>;
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
* Deletes an artifact and everything referencing it from a home's ledger, in the caller's write
|
|
23
|
+
* transaction. Answers the rows deleted per table.
|
|
24
|
+
*/
|
|
25
|
+
export function purgeArtifact(db: MigrationDb, artifactId: string): Removed {
|
|
26
|
+
const tables = db
|
|
27
|
+
.all<{ name: string }>(
|
|
28
|
+
"SELECT name FROM sqlite_schema WHERE type = 'table' AND name NOT LIKE 'sqlite_%'",
|
|
29
|
+
)
|
|
30
|
+
.map((row) => row.name);
|
|
31
|
+
const columns = new Map<string, Set<string>>();
|
|
32
|
+
const children = new Map<string, ForeignKey[]>();
|
|
33
|
+
for (const table of tables) {
|
|
34
|
+
columns.set(
|
|
35
|
+
table,
|
|
36
|
+
new Set(db.all<{ name: string }>(`PRAGMA table_info("${table}")`).map((row) => row.name)),
|
|
37
|
+
);
|
|
38
|
+
for (const key of db.all<{ table: string; from: string; to: string | null }>(
|
|
39
|
+
`PRAGMA foreign_key_list("${table}")`,
|
|
40
|
+
)) {
|
|
41
|
+
const list = children.get(key.table) ?? [];
|
|
42
|
+
list.push({ table, from: key.from, to: key.to ?? "rowid" });
|
|
43
|
+
children.set(key.table, list);
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
// Which rows of each table go: the artifact's own, then whatever references a doomed row.
|
|
48
|
+
const where = new Map<string, { readonly sql: string; readonly params: SqlValue[] }>();
|
|
49
|
+
for (const table of tables) {
|
|
50
|
+
if (table === "artifact") where.set(table, { sql: "id = ?", params: [artifactId] });
|
|
51
|
+
else if (columns.get(table)?.has("artifact_id")) {
|
|
52
|
+
where.set(table, { sql: "artifact_id = ?", params: [artifactId] });
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
// A fixed point over the foreign keys: a table joins once a parent of it is doomed. Bounded,
|
|
56
|
+
// since the schema's references form no long chain.
|
|
57
|
+
let grew = true;
|
|
58
|
+
for (let round = 0; grew && round < 16; round++) {
|
|
59
|
+
grew = false;
|
|
60
|
+
for (const [parent, list] of children) {
|
|
61
|
+
const doomed = where.get(parent);
|
|
62
|
+
if (!doomed) continue;
|
|
63
|
+
for (const key of list) {
|
|
64
|
+
const clause = {
|
|
65
|
+
sql: `"${key.from}" IN (SELECT "${key.to}" FROM "${parent}" WHERE ${doomed.sql})`,
|
|
66
|
+
params: doomed.params,
|
|
67
|
+
};
|
|
68
|
+
const existing = where.get(key.table);
|
|
69
|
+
if (!existing) {
|
|
70
|
+
where.set(key.table, clause);
|
|
71
|
+
grew = true;
|
|
72
|
+
} else if (
|
|
73
|
+
!existing.sql.includes(`"${key.from}" IN (SELECT "${key.to}" FROM "${parent}"`)
|
|
74
|
+
) {
|
|
75
|
+
where.set(key.table, {
|
|
76
|
+
sql: `(${existing.sql}) OR (${clause.sql})`,
|
|
77
|
+
params: [...existing.params, ...clause.params],
|
|
78
|
+
});
|
|
79
|
+
grew = true;
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
const triggers = db.all<{ name: string; sql: string }>(
|
|
86
|
+
`SELECT name, sql FROM sqlite_schema WHERE type = 'trigger' AND tbl_name IN (${[...where.keys()]
|
|
87
|
+
.map(() => "?")
|
|
88
|
+
.join(", ")})`,
|
|
89
|
+
...where.keys(),
|
|
90
|
+
);
|
|
91
|
+
for (const trigger of triggers) db.exec(`DROP TRIGGER "${trigger.name}"`);
|
|
92
|
+
db.exec("PRAGMA defer_foreign_keys = ON");
|
|
93
|
+
const removed: Record<string, number> = {};
|
|
94
|
+
// Children first: a row is read through its parent's clause before the parent goes.
|
|
95
|
+
const order = [...where.keys()].sort((a, b) => depth(b) - depth(a));
|
|
96
|
+
function depth(table: string, seen = new Set<string>()): number {
|
|
97
|
+
if (table === "artifact" || seen.has(table)) return 0;
|
|
98
|
+
seen.add(table);
|
|
99
|
+
let deepest = 0;
|
|
100
|
+
for (const [parent, list] of children) {
|
|
101
|
+
if (list.some((key) => key.table === table) && where.has(parent) && parent !== table) {
|
|
102
|
+
deepest = Math.max(deepest, depth(parent, seen) + 1);
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
return deepest;
|
|
106
|
+
}
|
|
107
|
+
// The clauses read the parents, so the rows to delete are fixed first, by rowid.
|
|
108
|
+
const doomedRows = new Map<string, number[]>();
|
|
109
|
+
for (const table of order) {
|
|
110
|
+
const clause = where.get(table);
|
|
111
|
+
if (!clause) continue;
|
|
112
|
+
doomedRows.set(
|
|
113
|
+
table,
|
|
114
|
+
db
|
|
115
|
+
// Named apart: SQLite answers a table's own column name for `rowid` when it has an
|
|
116
|
+
// INTEGER PRIMARY KEY (`document.id`, `event.cursor`).
|
|
117
|
+
.all<{ row: number }>(
|
|
118
|
+
`SELECT rowid AS row FROM "${table}" WHERE ${clause.sql}`,
|
|
119
|
+
...clause.params,
|
|
120
|
+
)
|
|
121
|
+
.map((found) => found.row),
|
|
122
|
+
);
|
|
123
|
+
}
|
|
124
|
+
for (const table of order) {
|
|
125
|
+
const rows = doomedRows.get(table) ?? [];
|
|
126
|
+
let count = 0;
|
|
127
|
+
for (let index = 0; index < rows.length; index += 500) {
|
|
128
|
+
const slice = rows.slice(index, index + 500);
|
|
129
|
+
count += db.run(
|
|
130
|
+
`DELETE FROM "${table}" WHERE rowid IN (${slice.map(() => "?").join(", ")})`,
|
|
131
|
+
...slice,
|
|
132
|
+
).changes;
|
|
133
|
+
}
|
|
134
|
+
if (count > 0) removed[table] = count;
|
|
135
|
+
}
|
|
136
|
+
for (const trigger of triggers) db.exec(trigger.sql);
|
|
137
|
+
// Nothing left pointing at what went: a row of another artifact naming a removed one would
|
|
138
|
+
// fail the commit anyway; this names it.
|
|
139
|
+
const dangling = db.all<{ table: string; parent: string }>("PRAGMA foreign_key_check");
|
|
140
|
+
if (dangling.length > 0) {
|
|
141
|
+
throw new Error(
|
|
142
|
+
`Removing ${artifactId} would leave ${dangling.length} rows dangling (${[
|
|
143
|
+
...new Set(dangling.map((row) => `${row.table} → ${row.parent}`)),
|
|
144
|
+
].join(", ")}).`,
|
|
145
|
+
);
|
|
146
|
+
}
|
|
147
|
+
return removed;
|
|
148
|
+
}
|