@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,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
|
+
}
|