@mostra/runtime 0.10.0 → 0.11.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/bin.js +4058 -310
- package/dist/bin.js.map +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -1
- package/dist/{instance-FExcyENK.js → instance-DCiUHvgZ.js} +682 -47
- package/dist/instance-DCiUHvgZ.js.map +1 -0
- package/dist/reference/cli.md +1322 -0
- package/dist/reference/diagnostics.json +1552 -0
- package/dist/reference/errors/MOSTRA_A11Y_MINOR.md +23 -0
- package/dist/reference/errors/MOSTRA_A11Y_SERIOUS.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_CANCELLED.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_EVENT_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_EXPORT_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_INTERRUPTED.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_PAUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_RUN_NOT_FOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_THREW.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_TOO_LARGE.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_UNKNOWN_FUNCTION.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_UNSERIALIZABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_BUNDLE_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_DIR_NOT_EMPTY.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_ENTRY_AMBIGUOUS.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_ID_DROPPED.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_NOT_FOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_NO_ENTRY.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_NO_PAGE.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_PATCH_REJECTED.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_PATH_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_SOURCE_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_SOURCE_UNREADABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_TEMPLATE_UNKNOWN.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_VERSION_COLLECTED.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_VERSION_NOT_FOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_BUILD_CRASHED.md +23 -0
- package/dist/reference/errors/MOSTRA_BUILD_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_BUILD_TIMEOUT.md +23 -0
- package/dist/reference/errors/MOSTRA_BUILD_UNRESOLVED.md +23 -0
- package/dist/reference/errors/MOSTRA_CLI_CONFIG_UNWRITABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_CLI_UNKNOWN_COMMAND.md +23 -0
- package/dist/reference/errors/MOSTRA_CLI_USAGE.md +23 -0
- package/dist/reference/errors/MOSTRA_CONSOLE_ERROR.md +23 -0
- package/dist/reference/errors/MOSTRA_CONSOLE_WARNING.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_INSTALL_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_NOT_FOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_OFFLINE.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_SPEC_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_TIMEOUT.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_WARM_CONFLICT.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_BIND_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_BROWSER_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_BUNDLE_DOWNLOAD_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_BUNDLE_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_BUNDLE_UNAVAILABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_HELPER_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_NODE_UNSUPPORTED.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_PORT_TAKEN.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_RUNTIME_INSTALLING.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_RUNTIME_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_SERVICE_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_SHELL_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_WARM_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_CONFLICT.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_DUPLICATE_ID.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_ID_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_ID_UNSTABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_MUTATION_ID_REUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_SHARED.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_TOO_LARGE.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_UNBOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_DISK_FULL.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_GC_INCOMPLETE.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_GONE.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_INTEGRITY.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_LEDGER_UNREADABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_LOCKED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_MISMATCH.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_NETWORK_FILESYSTEM.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_NOT_ALWAYS_ON.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_NOT_OWNED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_SOCKET_TOO_LONG.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_TOO_NEW.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_CONNECTION_CLOSED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_CURSOR_COMPACTED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_IDENTITY_UNAVAILABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_INITIALIZE_ORDER.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_INTERNAL_ERROR.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_INVALID_PARAMS.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_MALFORMED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_MESSAGE_TOO_LARGE.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_METHOD_UNKNOWN.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_NOTIFICATION_UNSUPPORTED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_PORT_UNSUPPORTED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_REQUEST_ID_REUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_REVISION_UNSUPPORTED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_SHUTDOWN_REFUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_SUBSCRIPTION_UNKNOWN.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_TIMEOUT.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_CONTENT_TYPE.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_CSRF_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_FRAME_SESSION.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_HEADERS_TOO_LARGE.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_HOST_REFUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_NOT_SERVED.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_ORIGIN_REFUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_RATE_LIMITED.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_REQUEST_MALFORMED.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_SCOPE_DENIED.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_SESSION_CONFLICT.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_SESSION_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_TOKEN_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_TOKEN_REVOKED.md +23 -0
- package/dist/reference/errors/MOSTRA_LIVE_SOURCE_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_LIVE_TOO_LARGE.md +23 -0
- package/dist/reference/errors/MOSTRA_MANIFEST_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_MANIFEST_NOT_LITERAL.md +23 -0
- package/dist/reference/errors/MOSTRA_MANIFEST_UNKNOWN_KEY.md +23 -0
- package/dist/reference/errors/MOSTRA_NETWORK_EXTERNAL_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_NETWORK_REQUEST_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_PLATFORM_UNSUPPORTED.md +23 -0
- package/dist/reference/errors/MOSTRA_PUBLISH_ID_CONFLICT.md +23 -0
- package/dist/reference/errors/MOSTRA_PUBLISH_SOURCE_CHANGED.md +23 -0
- package/dist/reference/errors/MOSTRA_PUBLISH_VERIFY_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_REGRESSION_ACTION_REMOVED.md +23 -0
- package/dist/reference/errors/MOSTRA_REGRESSION_ARIA.md +23 -0
- package/dist/reference/errors/MOSTRA_REGRESSION_FIELD_REMOVED.md +23 -0
- package/dist/reference/errors/MOSTRA_REGRESSION_LIVE_REMOVED.md +23 -0
- package/dist/reference/errors/MOSTRA_REGRESSION_PAGE_REMOVED.md +23 -0
- package/dist/reference/errors/MOSTRA_REGRESSION_PIXELS.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_CONFIG_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_HOME_MOVING.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_HOME_SUSPENDED.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_LIMIT_REACHED.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_LOGIN_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_NOT_OWNER_INSTANCE.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_NO_INSTANCE.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_OPERATOR_UNAVAILABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_OWNER_OFFLINE.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_PAUSED_BY_OPERATOR.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_QUEUE_FULL.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_RATE_LIMITED.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_SIGN_IN_REQUIRED.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_UNDER_REVIEW.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_UNREACHABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_RUNTIME_BLANK.md +23 -0
- package/dist/reference/errors/MOSTRA_RUNTIME_NOT_READY.md +23 -0
- package/dist/reference/errors/MOSTRA_RUNTIME_PAGE_ERROR.md +23 -0
- package/dist/reference/errors/MOSTRA_RUNTIME_WORKER_CRASHED.md +23 -0
- package/dist/reference/errors/MOSTRA_RUNTIME_WORKER_PARKED.md +23 -0
- package/dist/reference/errors/MOSTRA_SECRET_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_NOT_ENABLED.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_NOT_FOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_PORTS_EXHAUSTED.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_TOOL_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_TOOL_NOT_READY.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_TTL_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_TUNNEL_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_SMOKE_BUDGET.md +23 -0
- package/dist/reference/errors/MOSTRA_SMOKE_NO_EFFECT.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_ALREADY.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_BLOCKED.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_CHANNEL_DENIED.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_NOT_FOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_PAUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_POLICY_NONE.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_REVISION_MOVED.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_SIGNAL_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_VIEW_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_TARGET_UNAVAILABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_TYPE_ERROR.md +23 -0
- package/dist/reference/errors/MOSTRA_TYPE_UNTYPED_PACKAGE.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_ACTION_SKIPPED.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_BASELINE_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_CRASHED.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_LIVE_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_NO_BASELINE.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_SECRET_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_SKIP_CONSEQUENCE.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_TIMEOUT.md +23 -0
- package/dist/reference/self-hosting.md +130 -0
- package/dist/reference/telemetry.md +84 -0
- package/dist/skill/SKILL.md +122 -0
- package/dist/skill/assets/examples/dashboard/index.tsx +161 -0
- package/dist/skill/assets/examples/dashboard/live.ts +25 -0
- package/dist/skill/assets/examples/dashboard/styles.css +125 -0
- package/dist/skill/assets/examples/decision/index.tsx +95 -0
- package/dist/skill/assets/examples/decision/styles.css +125 -0
- package/dist/skill/assets/examples/inbox/actions.ts +23 -0
- package/dist/skill/assets/examples/inbox/index.tsx +109 -0
- package/dist/skill/assets/examples/inbox/styles.css +125 -0
- package/dist/skill/assets/studio.css +125 -0
- package/dist/skill/references/answers.md +217 -0
- package/dist/skill/references/design.md +154 -0
- package/dist/skill/references/libraries.md +167 -0
- package/dist/skill/references/long-lived.md +148 -0
- package/dist/skill/references/mcp.md +68 -0
- package/dist/skill/references/page.md +131 -0
- package/dist/skill/references/server.md +146 -0
- package/dist/skill/references/sharing.md +123 -0
- package/dist/skill/references/verify.md +71 -0
- package/package.json +10 -5
- package/src/gateway/actions.ts +20 -0
- package/src/gateway/browser.ts +44 -0
- package/src/gateway/capabilities.ts +8 -0
- package/src/gateway/http.ts +12 -1
- package/src/gateway/index.ts +170 -5
- package/src/gateway/listener.ts +31 -6
- package/src/gateway/routes.ts +8 -0
- package/src/gc/index.ts +5 -0
- package/src/instance/index.ts +20 -1
- package/src/interaction/index.ts +60 -0
- package/src/interaction/pause.ts +106 -0
- package/src/interaction/submissions.ts +42 -1
- package/src/interaction/viewers.ts +34 -1
- package/src/ledger/index.ts +20 -1
- package/src/ledger/migrations.ts +51 -0
- package/src/link/author.ts +215 -0
- package/src/link/hosted.ts +37 -1
- package/src/link/http.ts +6 -1
- package/src/link/index.ts +3 -1
- package/src/link/manager.ts +138 -34
- package/src/protocol-server/client.ts +53 -0
- package/src/protocol-server/index.ts +1 -1
- package/src/server/api.ts +514 -72
- package/src/server/auth.ts +600 -74
- package/src/server/authorize.ts +816 -0
- package/src/server/clients.ts +235 -0
- package/src/server/config.ts +7 -0
- package/src/server/data.ts +59 -1
- package/src/server/directory.ts +69 -0
- package/src/server/feed.ts +191 -0
- package/src/server/handle.ts +172 -0
- package/src/server/hosted-pages.ts +532 -0
- package/src/server/hosted.ts +519 -18
- package/src/server/index.ts +343 -61
- package/src/server/mcp.ts +330 -0
- package/src/server/metering.ts +156 -0
- package/src/server/oauth-clients.ts +510 -0
- package/src/server/operator.ts +498 -0
- package/src/server/providers.ts +284 -0
- package/src/server/remove.ts +148 -0
- package/src/server/routing.ts +275 -0
- package/src/verify/runner.ts +23 -2
- package/dist/instance-FExcyENK.js.map +0 -1
|
@@ -0,0 +1,510 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The authorization server's clients (INTERFACES §18.5; VERIFIED_FACTS, WP-30): first-party ones
|
|
3
|
+
* (the CLI, and one hosted shell per user-content domain), clients that registered through Dynamic
|
|
4
|
+
* Client Registration (RFC 7591, deprecated by the MCP specification and still Claude's fallback),
|
|
5
|
+
* and clients named by a Client ID Metadata Document: an `https` URL with a path whose document the
|
|
6
|
+
* server fetches.
|
|
7
|
+
*
|
|
8
|
+
* A metadata document is fetched over `https` only, from a public address only: the name is
|
|
9
|
+
* resolved once, every address it gives must be public (no loopback, private, link-local,
|
|
10
|
+
* unique-local, carrier-grade NAT, multicast, reserved or cloud metadata address), and the request
|
|
11
|
+
* goes to the address that was checked, so a second resolution can't move it (DNS rebinding). No
|
|
12
|
+
* redirect is followed; at most 64 KiB, within 5 s; the document's `client_id` must equal its URL;
|
|
13
|
+
* it is cached as its `Cache-Control` allows (at least a minute, at most a day).
|
|
14
|
+
*
|
|
15
|
+
* A redirect URI matches exactly, except that the port is ignored for `http://127.0.0.1`,
|
|
16
|
+
* `http://[::1]` and `http://localhost` (RFC 8252 §7.3; Claude Code's loopback callback).
|
|
17
|
+
*/
|
|
18
|
+
import { randomBytes } from "node:crypto";
|
|
19
|
+
import { lookup } from "node:dns/promises";
|
|
20
|
+
import { request as httpRequest } from "node:http";
|
|
21
|
+
import { request as httpsRequest } from "node:https";
|
|
22
|
+
import type { LookupFunction } from "node:net";
|
|
23
|
+
import { isIP } from "node:net";
|
|
24
|
+
import type { Ledger } from "../ledger/index.ts";
|
|
25
|
+
import type { Environment, Log } from "../log.ts";
|
|
26
|
+
|
|
27
|
+
/** The largest metadata document read. */
|
|
28
|
+
const MAX_DOCUMENT_BYTES = 64 * 1024;
|
|
29
|
+
/** How long fetching one may take. */
|
|
30
|
+
const FETCH_TIMEOUT_MS = 5_000;
|
|
31
|
+
/** Registered clients unused this long are removed (INTERFACES §18.5). */
|
|
32
|
+
const UNUSED_CLIENT_MS = 30 * 24 * 60 * 60 * 1000;
|
|
33
|
+
|
|
34
|
+
/** What the server knows of a client. */
|
|
35
|
+
export interface OAuthClient {
|
|
36
|
+
readonly id: string;
|
|
37
|
+
readonly kind: "metadata" | "registered" | "shell" | "cli";
|
|
38
|
+
readonly name: string;
|
|
39
|
+
readonly redirectUris: readonly string[];
|
|
40
|
+
/** Whether the name was stated by the client itself, never checked (all but first-party). */
|
|
41
|
+
readonly unverified: boolean;
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/** A refusal of a client, as an OAuth error. */
|
|
45
|
+
export interface ClientRefusal {
|
|
46
|
+
readonly error:
|
|
47
|
+
| "invalid_client"
|
|
48
|
+
| "invalid_request"
|
|
49
|
+
| "invalid_redirect_uri"
|
|
50
|
+
| "invalid_client_metadata";
|
|
51
|
+
readonly description: string;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
/**
|
|
55
|
+
* An IPv6 address's eight 16-bit groups, whatever its written form (`::` compressed, a dotted
|
|
56
|
+
* IPv4 tail, hex), or `undefined` when it isn't one.
|
|
57
|
+
*/
|
|
58
|
+
function ipv6Groups(address: string): number[] | undefined {
|
|
59
|
+
let text = address.toLowerCase();
|
|
60
|
+
const zone = text.indexOf("%");
|
|
61
|
+
if (zone !== -1) text = text.slice(0, zone);
|
|
62
|
+
// A dotted IPv4 tail, read by position rather than a backtracking pattern: the name comes from
|
|
63
|
+
// a client's metadata document URL (as clients.ts reads `X-Forwarded-For`).
|
|
64
|
+
const colon = text.lastIndexOf(":");
|
|
65
|
+
const dotted = text.slice(colon + 1);
|
|
66
|
+
if (colon !== -1 && dotted.includes(".")) {
|
|
67
|
+
const parts = dotted.split(".");
|
|
68
|
+
if (parts.length !== 4 || parts.some((part) => !/^\d{1,3}$/.test(part))) return undefined;
|
|
69
|
+
const [a, b, c, d] = parts.map(Number) as [number, number, number, number];
|
|
70
|
+
if ([a, b, c, d].some((part) => part > 255)) return undefined;
|
|
71
|
+
text = `${text.slice(0, colon + 1)}${((a << 8) | b).toString(16)}:${((c << 8) | d).toString(16)}`;
|
|
72
|
+
}
|
|
73
|
+
const halves = text.split("::");
|
|
74
|
+
if (halves.length > 2) return undefined;
|
|
75
|
+
const parse = (half: string): number[] =>
|
|
76
|
+
half === "" ? [] : half.split(":").map((group) => Number.parseInt(group, 16));
|
|
77
|
+
const head = parse(halves[0] as string);
|
|
78
|
+
const tail = halves.length === 2 ? parse(halves[1] as string) : [];
|
|
79
|
+
const missing = 8 - head.length - tail.length;
|
|
80
|
+
if (halves.length === 1 ? missing !== 0 : missing < 1) return undefined;
|
|
81
|
+
const groups = [...head, ...Array<number>(halves.length === 2 ? missing : 0).fill(0), ...tail];
|
|
82
|
+
return groups.length === 8 && groups.every((group) => group >= 0 && group <= 0xffff)
|
|
83
|
+
? groups
|
|
84
|
+
: undefined;
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
/** Whether an IP address is one no client document may come from. */
|
|
88
|
+
export function forbiddenAddress(address: string): boolean {
|
|
89
|
+
const family = isIP(address);
|
|
90
|
+
if (family === 4) {
|
|
91
|
+
const [a, b] = address.split(".").map(Number) as [number, number];
|
|
92
|
+
return (
|
|
93
|
+
a === 0 ||
|
|
94
|
+
a === 10 ||
|
|
95
|
+
a === 127 ||
|
|
96
|
+
(a === 100 && b >= 64 && b <= 127) ||
|
|
97
|
+
(a === 169 && b === 254) ||
|
|
98
|
+
(a === 172 && b >= 16 && b <= 31) ||
|
|
99
|
+
(a === 192 && b === 168) ||
|
|
100
|
+
(a === 192 && b === 0) ||
|
|
101
|
+
(a === 198 && (b === 18 || b === 19)) ||
|
|
102
|
+
a >= 224
|
|
103
|
+
);
|
|
104
|
+
}
|
|
105
|
+
if (family !== 6) return true;
|
|
106
|
+
const groups = ipv6Groups(address);
|
|
107
|
+
if (!groups) return true;
|
|
108
|
+
const [g0, g1, g2, g3, g4, g5, g6, g7] = groups as [
|
|
109
|
+
number,
|
|
110
|
+
number,
|
|
111
|
+
number,
|
|
112
|
+
number,
|
|
113
|
+
number,
|
|
114
|
+
number,
|
|
115
|
+
number,
|
|
116
|
+
number,
|
|
117
|
+
];
|
|
118
|
+
const embedded = `${g6 >> 8}.${g6 & 0xff}.${g7 >> 8}.${g7 & 0xff}`;
|
|
119
|
+
// IPv4-mapped (::ffff:a.b.c.d) and IPv4-compatible (::a.b.c.d) addresses reach the IPv4
|
|
120
|
+
// address they carry, however they are written (`::ffff:7f00:1` is 127.0.0.1).
|
|
121
|
+
if (g0 === 0 && g1 === 0 && g2 === 0 && g3 === 0 && g4 === 0 && (g5 === 0xffff || g5 === 0)) {
|
|
122
|
+
if (g5 === 0 && g6 === 0 && (g7 === 0 || g7 === 1)) return true; // :: and ::1
|
|
123
|
+
return forbiddenAddress(embedded);
|
|
124
|
+
}
|
|
125
|
+
return (
|
|
126
|
+
(g0 & 0xffc0) === 0xfe80 || // link-local fe80::/10
|
|
127
|
+
(g0 & 0xfe00) === 0xfc00 || // unique-local fc00::/7
|
|
128
|
+
(g0 & 0xff00) === 0xff00 || // multicast ff00::/8
|
|
129
|
+
(g0 === 0x64 && g1 === 0xff9b) || // NAT64 64:ff9b::/96 and 64:ff9b:1::/48
|
|
130
|
+
g0 === 0x2002 || // 6to4, which carries an IPv4 address
|
|
131
|
+
(g0 === 0x2001 && g1 === 0) || // Teredo 2001::/32
|
|
132
|
+
(g0 === 0x2001 && g1 === 0xdb8) || // documentation
|
|
133
|
+
(g0 === 0x0100 && g1 === 0 && g2 === 0 && g3 === 0) // discard 100::/64
|
|
134
|
+
);
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
/** Whether a redirect URI a request names is one the client's list allows. */
|
|
138
|
+
export function redirectAllowed(registered: readonly string[], asked: string): boolean {
|
|
139
|
+
if (registered.includes(asked)) return true;
|
|
140
|
+
let url: URL;
|
|
141
|
+
try {
|
|
142
|
+
url = new URL(asked);
|
|
143
|
+
} catch {
|
|
144
|
+
return false;
|
|
145
|
+
}
|
|
146
|
+
const loopback =
|
|
147
|
+
url.protocol === "http:" &&
|
|
148
|
+
(url.hostname === "127.0.0.1" || url.hostname === "[::1]" || url.hostname === "localhost");
|
|
149
|
+
if (!loopback) return false;
|
|
150
|
+
return registered.some((entry) => {
|
|
151
|
+
try {
|
|
152
|
+
const known = new URL(entry);
|
|
153
|
+
return (
|
|
154
|
+
known.protocol === "http:" &&
|
|
155
|
+
known.hostname === url.hostname &&
|
|
156
|
+
known.pathname === url.pathname &&
|
|
157
|
+
known.search === url.search
|
|
158
|
+
);
|
|
159
|
+
} catch {
|
|
160
|
+
return false;
|
|
161
|
+
}
|
|
162
|
+
});
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
/** Whether a redirect URI may be registered at all: https, or http on a loopback name. */
|
|
166
|
+
function redirectRegistrable(uri: string): boolean {
|
|
167
|
+
try {
|
|
168
|
+
const url = new URL(uri);
|
|
169
|
+
if (url.hash !== "") return false;
|
|
170
|
+
if (url.protocol === "https:") return true;
|
|
171
|
+
return (
|
|
172
|
+
url.protocol === "http:" &&
|
|
173
|
+
(url.hostname === "127.0.0.1" || url.hostname === "[::1]" || url.hostname === "localhost")
|
|
174
|
+
);
|
|
175
|
+
} catch {
|
|
176
|
+
return false;
|
|
177
|
+
}
|
|
178
|
+
}
|
|
179
|
+
|
|
180
|
+
/** Options for {@link createClients}. */
|
|
181
|
+
export interface ClientsOptions {
|
|
182
|
+
readonly directory: Ledger;
|
|
183
|
+
readonly log: Log;
|
|
184
|
+
readonly env: Environment;
|
|
185
|
+
readonly now?: () => number;
|
|
186
|
+
/**
|
|
187
|
+
* Whether an origin is a hosted shell's (a domain's apex, or a host an operator supplies): each
|
|
188
|
+
* is a first-party public client, `<origin>/_mostra/signin`.
|
|
189
|
+
*/
|
|
190
|
+
readonly isShellOrigin: (origin: string) => boolean;
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
/** The authorization server's clients. */
|
|
194
|
+
export interface Clients {
|
|
195
|
+
/** A client by its ID: first-party, registered, or fetched from its metadata document. */
|
|
196
|
+
find(clientId: string): Promise<OAuthClient | ClientRefusal>;
|
|
197
|
+
/** Dynamic Client Registration (RFC 7591): the client's answer, or a refusal. */
|
|
198
|
+
register(metadata: unknown): Record<string, unknown> | ClientRefusal;
|
|
199
|
+
/** Notes a client was used, so an unused registration can be removed after 30 days. */
|
|
200
|
+
used(clientId: string): void;
|
|
201
|
+
/** The client ID of a domain's hosted shell. */
|
|
202
|
+
shellClientId(shellOrigin: string): string;
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
/** Whether a client ID names a metadata document: an https URL with a path. */
|
|
206
|
+
export function metadataClientId(clientId: string): URL | undefined {
|
|
207
|
+
try {
|
|
208
|
+
const url = new URL(clientId);
|
|
209
|
+
return url.protocol === "https:" && url.pathname.length > 1 && url.hash === ""
|
|
210
|
+
? url
|
|
211
|
+
: undefined;
|
|
212
|
+
} catch {
|
|
213
|
+
return undefined;
|
|
214
|
+
}
|
|
215
|
+
}
|
|
216
|
+
|
|
217
|
+
/** The loopback addresses a test's metadata origin may resolve to (`MOSTRA_TEST_CIMD_ORIGIN`). */
|
|
218
|
+
const LOOPBACK = new Set(["127.0.0.1", "::1"]);
|
|
219
|
+
|
|
220
|
+
/** Builds the clients over the directory. */
|
|
221
|
+
export function createClients(options: ClientsOptions): Clients {
|
|
222
|
+
const { directory, log } = options;
|
|
223
|
+
const now = options.now ?? (() => Date.now());
|
|
224
|
+
const fetched = new Map<string, { client: OAuthClient; until: number }>();
|
|
225
|
+
// Tests serve a metadata document from loopback over http; only that exact origin, by name.
|
|
226
|
+
const testOrigin = options.env["MOSTRA_TEST_CIMD_ORIGIN"];
|
|
227
|
+
|
|
228
|
+
const sweep = (): void => {
|
|
229
|
+
directory.write((db) =>
|
|
230
|
+
db.run(
|
|
231
|
+
"DELETE FROM oauth_client WHERE kind = 'registered' AND COALESCE(last_used_at, created_at) < ? AND id NOT IN (SELECT client_id FROM \"grant\" WHERE revoked_at IS NULL)",
|
|
232
|
+
new Date(now() - UNUSED_CLIENT_MS).toISOString(),
|
|
233
|
+
),
|
|
234
|
+
);
|
|
235
|
+
};
|
|
236
|
+
|
|
237
|
+
/** Fetches a document from a checked public address, with no redirect, bounded. */
|
|
238
|
+
const fetchDocument = (url: URL): Promise<{ status: number; body: string; maxAge: number }> =>
|
|
239
|
+
new Promise((resolve, reject) => {
|
|
240
|
+
const test =
|
|
241
|
+
testOrigin !== undefined && url.origin === testOrigin.replace(/^http:/, "https:");
|
|
242
|
+
// Every address the name has is checked, on the connection that uses it. Node.js asks for
|
|
243
|
+
// all of them (`all: true`, its happy-eyeballs connect) or for one, and expects the answer
|
|
244
|
+
// in the shape it asked for. A test's loopback origin passes the same lookup, with its
|
|
245
|
+
// loopback address allowed, so the tests run this path.
|
|
246
|
+
const pinned: LookupFunction = (hostname, options, callback) => {
|
|
247
|
+
lookup(hostname, { all: true, verbatim: true })
|
|
248
|
+
.then((addresses) => {
|
|
249
|
+
if (addresses.length === 0) throw new Error("no address");
|
|
250
|
+
for (const found of addresses) {
|
|
251
|
+
const allowed = test && LOOPBACK.has(found.address);
|
|
252
|
+
if (!allowed && forbiddenAddress(found.address)) {
|
|
253
|
+
throw new Error(`the name resolves to a non-public address (${found.address})`);
|
|
254
|
+
}
|
|
255
|
+
}
|
|
256
|
+
if ((options as { all?: boolean }).all === true) {
|
|
257
|
+
(callback as unknown as (error: null, list: typeof addresses) => void)(
|
|
258
|
+
null,
|
|
259
|
+
addresses,
|
|
260
|
+
);
|
|
261
|
+
return;
|
|
262
|
+
}
|
|
263
|
+
const chosen = addresses[0] as { address: string; family: number };
|
|
264
|
+
callback(null, chosen.address, chosen.family);
|
|
265
|
+
})
|
|
266
|
+
.catch((error: Error) => callback(error, "", 0));
|
|
267
|
+
};
|
|
268
|
+
const literal = isIP(url.hostname.replace(/^\[|\]$/g, ""));
|
|
269
|
+
if (!test && literal !== 0 && forbiddenAddress(url.hostname.replace(/^\[|\]$/g, ""))) {
|
|
270
|
+
reject(new Error("the document's address isn't public"));
|
|
271
|
+
return;
|
|
272
|
+
}
|
|
273
|
+
const target = test ? new URL(url.href.replace(/^https:/, "http:")) : url;
|
|
274
|
+
const request = (test ? httpRequest : httpsRequest)(
|
|
275
|
+
target,
|
|
276
|
+
{
|
|
277
|
+
method: "GET",
|
|
278
|
+
headers: { accept: "application/json", "user-agent": "mostra-remote-server" },
|
|
279
|
+
timeout: FETCH_TIMEOUT_MS,
|
|
280
|
+
lookup: pinned,
|
|
281
|
+
},
|
|
282
|
+
(response) => {
|
|
283
|
+
let size = 0;
|
|
284
|
+
const chunks: Buffer[] = [];
|
|
285
|
+
response.on("data", (chunk: Buffer) => {
|
|
286
|
+
size += chunk.length;
|
|
287
|
+
if (size > MAX_DOCUMENT_BYTES) {
|
|
288
|
+
request.destroy(new Error("the document is larger than 64 KiB"));
|
|
289
|
+
return;
|
|
290
|
+
}
|
|
291
|
+
chunks.push(chunk);
|
|
292
|
+
});
|
|
293
|
+
response.on("end", () => {
|
|
294
|
+
const cache = String(response.headers["cache-control"] ?? "");
|
|
295
|
+
const age = /max-age=(\d+)/.exec(cache);
|
|
296
|
+
const noStore = /no-store|no-cache/.test(cache);
|
|
297
|
+
resolve({
|
|
298
|
+
status: response.statusCode ?? 0,
|
|
299
|
+
body: Buffer.concat(chunks).toString("utf8"),
|
|
300
|
+
maxAge: noStore ? 60 : Math.min(86_400, Math.max(60, age ? Number(age[1]) : 300)),
|
|
301
|
+
});
|
|
302
|
+
});
|
|
303
|
+
response.on("error", reject);
|
|
304
|
+
},
|
|
305
|
+
);
|
|
306
|
+
const deadline = setTimeout(
|
|
307
|
+
() => request.destroy(new Error("the document took longer than 5 s")),
|
|
308
|
+
FETCH_TIMEOUT_MS,
|
|
309
|
+
);
|
|
310
|
+
request.on("close", () => clearTimeout(deadline));
|
|
311
|
+
request.on("timeout", () => request.destroy(new Error("the document took longer than 5 s")));
|
|
312
|
+
request.on("error", reject);
|
|
313
|
+
request.end();
|
|
314
|
+
});
|
|
315
|
+
|
|
316
|
+
const fromDocument = async (url: URL): Promise<OAuthClient | ClientRefusal> => {
|
|
317
|
+
const cached = fetched.get(url.href);
|
|
318
|
+
if (cached && cached.until > now()) return cached.client;
|
|
319
|
+
let answer: { status: number; body: string; maxAge: number };
|
|
320
|
+
try {
|
|
321
|
+
answer = await fetchDocument(url);
|
|
322
|
+
} catch (error) {
|
|
323
|
+
log.warn("oauth.cimd_refused", { client: url.href, reason: (error as Error).message });
|
|
324
|
+
return {
|
|
325
|
+
error: "invalid_client",
|
|
326
|
+
description: `The client's metadata document can't be fetched: ${(error as Error).message}.`,
|
|
327
|
+
};
|
|
328
|
+
}
|
|
329
|
+
if (answer.status !== 200) {
|
|
330
|
+
// A redirect is never followed: the document must be served at its own URL.
|
|
331
|
+
return {
|
|
332
|
+
error: "invalid_client",
|
|
333
|
+
description: `The client's metadata document answered ${answer.status}, not 200.`,
|
|
334
|
+
};
|
|
335
|
+
}
|
|
336
|
+
let document: {
|
|
337
|
+
client_id?: unknown;
|
|
338
|
+
client_name?: unknown;
|
|
339
|
+
redirect_uris?: unknown;
|
|
340
|
+
};
|
|
341
|
+
try {
|
|
342
|
+
document = JSON.parse(answer.body) as typeof document;
|
|
343
|
+
} catch {
|
|
344
|
+
return { error: "invalid_client", description: "The client's metadata document isn't JSON." };
|
|
345
|
+
}
|
|
346
|
+
if (document.client_id !== url.href) {
|
|
347
|
+
return {
|
|
348
|
+
error: "invalid_client",
|
|
349
|
+
description: "The metadata document's client_id isn't its own URL.",
|
|
350
|
+
};
|
|
351
|
+
}
|
|
352
|
+
const redirects = Array.isArray(document.redirect_uris)
|
|
353
|
+
? document.redirect_uris.filter(
|
|
354
|
+
(uri): uri is string => typeof uri === "string" && redirectRegistrable(uri),
|
|
355
|
+
)
|
|
356
|
+
: [];
|
|
357
|
+
if (redirects.length === 0) {
|
|
358
|
+
return {
|
|
359
|
+
error: "invalid_client",
|
|
360
|
+
description: "The metadata document names no usable redirect_uris.",
|
|
361
|
+
};
|
|
362
|
+
}
|
|
363
|
+
const client: OAuthClient = {
|
|
364
|
+
id: url.href,
|
|
365
|
+
kind: "metadata",
|
|
366
|
+
name:
|
|
367
|
+
typeof document.client_name === "string" && document.client_name.trim() !== ""
|
|
368
|
+
? document.client_name.trim().slice(0, 128)
|
|
369
|
+
: url.hostname,
|
|
370
|
+
redirectUris: redirects,
|
|
371
|
+
unverified: true,
|
|
372
|
+
};
|
|
373
|
+
fetched.set(url.href, { client, until: now() + answer.maxAge * 1000 });
|
|
374
|
+
if (fetched.size > 1_000) fetched.delete(fetched.keys().next().value as string);
|
|
375
|
+
directory.write((db) =>
|
|
376
|
+
db.run(
|
|
377
|
+
`INSERT INTO oauth_client (id, kind, metadata_json, created_at) VALUES (?, 'metadata', ?, ?)
|
|
378
|
+
ON CONFLICT (id) DO UPDATE SET metadata_json = excluded.metadata_json`,
|
|
379
|
+
client.id,
|
|
380
|
+
JSON.stringify({ client_name: client.name, redirect_uris: client.redirectUris }),
|
|
381
|
+
new Date(now()).toISOString(),
|
|
382
|
+
),
|
|
383
|
+
);
|
|
384
|
+
return client;
|
|
385
|
+
};
|
|
386
|
+
|
|
387
|
+
const shellClientId = (shellOrigin: string): string => `${shellOrigin}/_mostra/signin`;
|
|
388
|
+
|
|
389
|
+
return {
|
|
390
|
+
shellClientId,
|
|
391
|
+
|
|
392
|
+
async find(clientId) {
|
|
393
|
+
if (clientId === "mostra-cli") {
|
|
394
|
+
return {
|
|
395
|
+
id: clientId,
|
|
396
|
+
kind: "cli",
|
|
397
|
+
name: "Mostra CLI",
|
|
398
|
+
redirectUris: [],
|
|
399
|
+
unverified: false,
|
|
400
|
+
};
|
|
401
|
+
}
|
|
402
|
+
const suffix = "/_mostra/signin";
|
|
403
|
+
const origin = clientId.endsWith(suffix) ? clientId.slice(0, -suffix.length) : undefined;
|
|
404
|
+
if (origin !== undefined && options.isShellOrigin(origin)) {
|
|
405
|
+
directory.write((db) =>
|
|
406
|
+
db.run(
|
|
407
|
+
"INSERT OR IGNORE INTO oauth_client (id, kind, metadata_json, created_at) VALUES (?, 'shell', ?, ?)",
|
|
408
|
+
clientId,
|
|
409
|
+
JSON.stringify({ client_name: "Mostra" }),
|
|
410
|
+
new Date(now()).toISOString(),
|
|
411
|
+
),
|
|
412
|
+
);
|
|
413
|
+
return {
|
|
414
|
+
id: clientId,
|
|
415
|
+
kind: "shell",
|
|
416
|
+
name: "Mostra",
|
|
417
|
+
redirectUris: [`${origin}/_mostra/signin`],
|
|
418
|
+
unverified: false,
|
|
419
|
+
};
|
|
420
|
+
}
|
|
421
|
+
const url = metadataClientId(clientId);
|
|
422
|
+
if (url) return fromDocument(url);
|
|
423
|
+
const row = directory.read((db) =>
|
|
424
|
+
db.get<{ metadata_json: string }>(
|
|
425
|
+
"SELECT metadata_json FROM oauth_client WHERE id = ? AND kind = 'registered'",
|
|
426
|
+
clientId,
|
|
427
|
+
),
|
|
428
|
+
);
|
|
429
|
+
if (!row) return { error: "invalid_client", description: "Unknown client." };
|
|
430
|
+
const metadata = JSON.parse(row.metadata_json) as {
|
|
431
|
+
client_name?: string;
|
|
432
|
+
redirect_uris: string[];
|
|
433
|
+
};
|
|
434
|
+
return {
|
|
435
|
+
id: clientId,
|
|
436
|
+
kind: "registered",
|
|
437
|
+
name: metadata.client_name ?? "An unnamed client",
|
|
438
|
+
redirectUris: metadata.redirect_uris,
|
|
439
|
+
unverified: true,
|
|
440
|
+
};
|
|
441
|
+
},
|
|
442
|
+
|
|
443
|
+
register(metadata) {
|
|
444
|
+
sweep();
|
|
445
|
+
const body = (typeof metadata === "object" && metadata !== null ? metadata : {}) as {
|
|
446
|
+
redirect_uris?: unknown;
|
|
447
|
+
client_name?: unknown;
|
|
448
|
+
token_endpoint_auth_method?: unknown;
|
|
449
|
+
grant_types?: unknown;
|
|
450
|
+
};
|
|
451
|
+
const redirects = Array.isArray(body.redirect_uris)
|
|
452
|
+
? body.redirect_uris.filter((uri): uri is string => typeof uri === "string")
|
|
453
|
+
: [];
|
|
454
|
+
if (
|
|
455
|
+
redirects.length === 0 ||
|
|
456
|
+
redirects.length > 10 ||
|
|
457
|
+
!redirects.every(redirectRegistrable)
|
|
458
|
+
) {
|
|
459
|
+
return {
|
|
460
|
+
error: "invalid_redirect_uri",
|
|
461
|
+
description:
|
|
462
|
+
"redirect_uris must list https: addresses, or http: on 127.0.0.1, [::1] or localhost.",
|
|
463
|
+
};
|
|
464
|
+
}
|
|
465
|
+
if (
|
|
466
|
+
body.token_endpoint_auth_method !== undefined &&
|
|
467
|
+
body.token_endpoint_auth_method !== "none"
|
|
468
|
+
) {
|
|
469
|
+
return {
|
|
470
|
+
error: "invalid_client_metadata",
|
|
471
|
+
description:
|
|
472
|
+
"This server registers public clients only (token_endpoint_auth_method none).",
|
|
473
|
+
};
|
|
474
|
+
}
|
|
475
|
+
const name =
|
|
476
|
+
typeof body.client_name === "string" ? body.client_name.trim().slice(0, 128) : undefined;
|
|
477
|
+
const id = `mcl_${randomBytes(16).toString("hex")}`;
|
|
478
|
+
const at = new Date(now());
|
|
479
|
+
directory.write((db) =>
|
|
480
|
+
db.run(
|
|
481
|
+
"INSERT INTO oauth_client (id, kind, metadata_json, created_at, last_used_at) VALUES (?, 'registered', ?, ?, ?)",
|
|
482
|
+
id,
|
|
483
|
+
JSON.stringify({ client_name: name, redirect_uris: redirects }),
|
|
484
|
+
at.toISOString(),
|
|
485
|
+
at.toISOString(),
|
|
486
|
+
),
|
|
487
|
+
);
|
|
488
|
+
log.info("oauth.client_registered", { client: id });
|
|
489
|
+
return {
|
|
490
|
+
client_id: id,
|
|
491
|
+
client_id_issued_at: Math.floor(at.getTime() / 1000),
|
|
492
|
+
...(name !== undefined ? { client_name: name } : {}),
|
|
493
|
+
redirect_uris: redirects,
|
|
494
|
+
token_endpoint_auth_method: "none",
|
|
495
|
+
grant_types: ["authorization_code", "refresh_token"],
|
|
496
|
+
response_types: ["code"],
|
|
497
|
+
};
|
|
498
|
+
},
|
|
499
|
+
|
|
500
|
+
used(clientId) {
|
|
501
|
+
directory.write((db) =>
|
|
502
|
+
db.run(
|
|
503
|
+
"UPDATE oauth_client SET last_used_at = ? WHERE id = ?",
|
|
504
|
+
new Date(now()).toISOString(),
|
|
505
|
+
clientId,
|
|
506
|
+
),
|
|
507
|
+
);
|
|
508
|
+
},
|
|
509
|
+
};
|
|
510
|
+
}
|