solid-objects 0.12.0 → 0.13.0

package/dist/web/store.d.ts

@@ -0,0 +1,65 @@
+import type { SolidObjectsRuntime } from "../runtime.js";
+export type DashboardRecord = Record<string, unknown>;
+export interface DashboardPageResult {
+    readonly records: readonly DashboardRecord[];
+    readonly page: number;
+    readonly perPage: number;
+    readonly total: number;
+    readonly lastPage: number;
+}
+export interface DashboardStatistics extends DashboardRecord {
+    readonly instances: DashboardRecord;
+    readonly mailbox: DashboardRecord;
+    readonly effects: DashboardRecord;
+    readonly broadcasts: DashboardRecord;
+    readonly reminders: DashboardRecord;
+    readonly deadLetters: DashboardRecord;
+    readonly processes: DashboardRecord;
+    readonly serverTime: string;
+}
+export interface DashboardInstanceDetail {
+    readonly instance: DashboardRecord;
+    readonly readyMessages: readonly DashboardRecord[];
+    readonly claimedMessages: readonly DashboardRecord[];
+    readonly recentMessages: readonly DashboardRecord[];
+    readonly reminders: readonly DashboardRecord[];
+    readonly effects: readonly DashboardRecord[];
+    readonly broadcasts: readonly DashboardRecord[];
+    readonly deadLetters: readonly DashboardRecord[];
+}
+interface PageOptions {
+    readonly page?: string | null;
+    readonly perPage?: string | null;
+    readonly status?: string | null;
+    readonly actorType?: string | null;
+    readonly actorId?: string | null;
+    readonly membership?: string | null;
+}
+export declare class DashboardStore {
+    private readonly runtime;
+    constructor(runtime: SolidObjectsRuntime);
+    statistics(): Promise<DashboardStatistics>;
+    instances(options: PageOptions): Promise<DashboardPageResult>;
+    mailbox(options: PageOptions): Promise<DashboardPageResult>;
+    reminders(options: PageOptions): Promise<DashboardPageResult>;
+    effects(options: PageOptions): Promise<DashboardPageResult>;
+    broadcasts(options: PageOptions): Promise<DashboardPageResult>;
+    deadLetters(options: PageOptions): Promise<DashboardPageResult>;
+    processes(options: PageOptions): Promise<DashboardPageResult>;
+    instance(id: string): Promise<DashboardInstanceDetail | undefined>;
+    message(id: string): Promise<DashboardRecord | undefined>;
+    deadLetter(id: string): Promise<DashboardRecord | undefined>;
+    dashboard(): Promise<DashboardRecord>;
+    setPaused(options: {
+        id: string;
+        paused: boolean;
+    }): Promise<boolean>;
+    healthy(): Promise<void>;
+    private page;
+    private statusPage;
+    private grouped;
+    private substringExpression;
+    private table;
+}
+export {};
+//# sourceMappingURL=store.d.ts.map

package/dist/web/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/web/store.ts"],"names":[],"mappings":"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"}

package/dist/web/store.js

@@ -0,0 +1,303 @@
+const EFFECT_STATUSES = ["pending", "processing", "completed", "dead"];
+const BROADCAST_STATUSES = ["pending", "processing", "delivered", "dead"];
+const REMINDER_STATUSES = ["scheduled", "paused", "completed"];
+const PROCESS_STATUSES = ["running", "draining", "stopped"];
+export class DashboardStore {
+    runtime;
+    constructor(runtime) {
+        this.runtime = runtime;
+    }
+    async statistics() {
+        return this.runtime.settings.database.connection(async (connection) => {
+            const now = await connection.nowMilliseconds();
+            const [instances, mailbox, effects, broadcasts, reminders, deadLetters, processes] = await Promise.all([
+                connection.get(`SELECT COUNT(*) AS total,
+              SUM(CASE WHEN paused = 1 THEN 1 ELSE 0 END) AS paused,
+              SUM(CASE WHEN activation_expires_at_ms >= ? THEN 1 ELSE 0 END) AS activated
+             FROM ${this.table("instances")}`, [now]),
+                connection.get(`SELECT COUNT(*) AS ready,
+              SUM(CASE WHEN available_at_ms <= ? THEN 1 ELSE 0 END) AS due,
+              MIN(CASE WHEN available_at_ms <= ? THEN available_at_ms END) AS oldest_due
+             FROM ${this.table("ready_messages")}`, [now, now]),
+                this.grouped({
+                    connection,
+                    table: "effects",
+                    column: "status",
+                    statuses: EFFECT_STATUSES,
+                }),
+                this.grouped({
+                    connection,
+                    table: "broadcasts",
+                    column: "status",
+                    statuses: BROADCAST_STATUSES,
+                }),
+                this.grouped({
+                    connection,
+                    table: "reminders",
+                    column: "status",
+                    statuses: REMINDER_STATUSES,
+                }),
+                connection.get(`SELECT COUNT(*) AS total FROM ${this.table("dead_letters")}`),
+                this.grouped({
+                    connection,
+                    table: "processes",
+                    column: "shutdown_state",
+                    statuses: PROCESS_STATUSES,
+                }),
+            ]);
+            const claimed = await connection.get(`SELECT COUNT(*) AS total FROM ${this.table("claimed_messages")}`);
+            const reminderDue = await connection.get(`SELECT COUNT(*) AS total FROM ${this.table("reminders")}
+         WHERE status = 'scheduled' AND run_at_ms <= ?`, [now]);
+            const oldestDue = numeric(mailbox?.oldest_due);
+            return freezeRecord({
+                instances: freezeRecord({
+                    total: numeric(instances?.total),
+                    paused: numeric(instances?.paused),
+                    activated: numeric(instances?.activated),
+                }),
+                mailbox: freezeRecord({
+                    ready: numeric(mailbox?.ready),
+                    due: numeric(mailbox?.due),
+                    claimed: numeric(claimed?.total),
+                    latency: oldestDue === 0 ? 0 : Math.max(0, (now - oldestDue) / 1_000),
+                }),
+                effects,
+                broadcasts,
+                reminders: freezeRecord({ ...reminders, due: numeric(reminderDue?.total) }),
+                deadLetters: freezeRecord({ total: numeric(deadLetters?.total) }),
+                processes,
+                serverTime: new Date(now).toISOString(),
+            });
+        });
+    }
+    instances(options) {
+        const conditions = [];
+        const parameters = [];
+        if (options.actorType) {
+            conditions.push("actor_type = ?");
+            parameters.push(options.actorType);
+        }
+        if (options.actorId) {
+            const expression = this.substringExpression("actor_id");
+            conditions.push(expression);
+            parameters.push(options.actorId);
+        }
+        return this.page({
+            from: this.table("instances"),
+            ...(conditions.length === 0 ? {} : { where: conditions.join(" AND ") }),
+            parameters,
+            order: "updated_at_ms DESC, id DESC",
+        }, options);
+    }
+    mailbox(options) {
+        const membership = options.membership === "claimed" ? "claimed_messages" : "ready_messages";
+        const timeColumn = membership === "claimed_messages" ? "membership.claimed_at_ms" : "membership.available_at_ms";
+        return this.page({
+            from: `${this.table("messages")} messages
+          INNER JOIN ${this.table(membership)} membership ON membership.message_id = messages.id`,
+            order: `${timeColumn} ASC, messages.id ASC`,
+        }, options);
+    }
+    reminders(options) {
+        return this.statusPage({
+            table: "reminders",
+            statuses: REMINDER_STATUSES,
+            order: "run_at_ms ASC, id ASC",
+            options,
+        });
+    }
+    effects(options) {
+        return this.statusPage({
+            table: "effects",
+            statuses: EFFECT_STATUSES,
+            order: "available_at_ms DESC, id DESC",
+            options,
+        });
+    }
+    broadcasts(options) {
+        return this.statusPage({
+            table: "broadcasts",
+            statuses: BROADCAST_STATUSES,
+            order: "available_at_ms DESC, id DESC",
+            options,
+        });
+    }
+    deadLetters(options) {
+        return this.page({
+            from: `${this.table("dead_letters")} dead_letters
+          INNER JOIN ${this.table("messages")} messages ON messages.id = dead_letters.message_id`,
+            select: "dead_letters.id, dead_letters.message_id, dead_letters.instance_id, dead_letters.attempts, dead_letters.error, dead_letters.created_at_ms, dead_letters.retried_message_id, messages.actor_type, messages.actor_id, messages.operation, messages.delivery_mode, messages.arguments",
+            order: "dead_letters.created_at_ms DESC, dead_letters.id DESC",
+        }, options);
+    }
+    processes(options) {
+        return this.statusPage({
+            table: "processes",
+            statusColumn: "shutdown_state",
+            statuses: PROCESS_STATUSES,
+            order: "heartbeat_at_ms DESC, id DESC",
+            options,
+        });
+    }
+    async instance(id) {
+        return this.runtime.settings.database.connection(async (connection) => {
+            const instance = await connection.get(`SELECT * FROM ${this.table("instances")} WHERE id = ?`, [id]);
+            if (!instance)
+                return undefined;
+            const related = { instanceId: id, limit: 10 };
+            const [readyMessages, claimedMessages, recentMessages, reminders, effects, broadcasts, deadLetters,] = await Promise.all([
+                connection.all(`SELECT messages.*, membership.available_at_ms
+             FROM ${this.table("messages")} messages
+             INNER JOIN ${this.table("ready_messages")} membership ON membership.message_id = messages.id
+             WHERE messages.instance_id = ? ORDER BY messages.sequence ASC LIMIT ?`, [related.instanceId, related.limit]),
+                connection.all(`SELECT messages.*, membership.claimed_at_ms
+             FROM ${this.table("messages")} messages
+             INNER JOIN ${this.table("claimed_messages")} membership ON membership.message_id = messages.id
+             WHERE messages.instance_id = ? ORDER BY messages.sequence ASC LIMIT ?`, [related.instanceId, related.limit]),
+                connection.all(`SELECT * FROM ${this.table("messages")} WHERE instance_id = ?
+             ORDER BY sequence DESC LIMIT ?`, [related.instanceId, related.limit]),
+                connection.all(`SELECT * FROM ${this.table("reminders")} WHERE instance_id = ?
+             ORDER BY run_at_ms ASC LIMIT ?`, [related.instanceId, related.limit]),
+                connection.all(`SELECT * FROM ${this.table("effects")} WHERE instance_id = ?
+             ORDER BY available_at_ms DESC LIMIT ?`, [related.instanceId, related.limit]),
+                connection.all(`SELECT * FROM ${this.table("broadcasts")} WHERE instance_id = ?
+             ORDER BY available_at_ms DESC LIMIT ?`, [related.instanceId, related.limit]),
+                connection.all(`SELECT dead_letters.*, messages.actor_type, messages.actor_id, messages.operation,
+              messages.delivery_mode, messages.arguments
+             FROM ${this.table("dead_letters")} dead_letters
+             INNER JOIN ${this.table("messages")} messages ON messages.id = dead_letters.message_id
+             WHERE dead_letters.instance_id = ? ORDER BY dead_letters.created_at_ms DESC LIMIT ?`, [related.instanceId, related.limit]),
+            ]);
+            return Object.freeze({
+                instance: freezeRecord(instance),
+                readyMessages: freezeRecords(readyMessages),
+                claimedMessages: freezeRecords(claimedMessages),
+                recentMessages: freezeRecords(recentMessages),
+                reminders: freezeRecords(reminders),
+                effects: freezeRecords(effects),
+                broadcasts: freezeRecords(broadcasts),
+                deadLetters: freezeRecords(deadLetters),
+            });
+        });
+    }
+    message(id) {
+        return this.runtime.settings.database.connection(async (connection) => {
+            const record = await connection.get(`SELECT messages.*,
+          CASE WHEN ready.message_id IS NOT NULL THEN 'ready'
+               WHEN claimed.message_id IS NOT NULL THEN 'claimed'
+               WHEN messages.completed_at_ms IS NOT NULL THEN 'completed'
+               ELSE 'history' END AS membership
+         FROM ${this.table("messages")} messages
+         LEFT JOIN ${this.table("ready_messages")} ready ON ready.message_id = messages.id
+         LEFT JOIN ${this.table("claimed_messages")} claimed ON claimed.message_id = messages.id
+         WHERE messages.id = ?`, [id]);
+            return record ? freezeRecord(record) : undefined;
+        });
+    }
+    deadLetter(id) {
+        return this.runtime.settings.database.connection(async (connection) => {
+            const record = await connection.get(`SELECT dead_letters.*, messages.actor_type, messages.actor_id, messages.operation,
+          messages.delivery_mode, messages.arguments
+         FROM ${this.table("dead_letters")} dead_letters
+         INNER JOIN ${this.table("messages")} messages ON messages.id = dead_letters.message_id
+         WHERE dead_letters.id = ?`, [id]);
+            return record ? freezeRecord(record) : undefined;
+        });
+    }
+    async dashboard() {
+        return this.runtime.settings.database.connection(async (connection) => {
+            const [processes, deadLetters, instancesByType] = await Promise.all([
+                connection.all(`SELECT * FROM ${this.table("processes")} ORDER BY heartbeat_at_ms DESC LIMIT 10`),
+                connection.all(`SELECT dead_letters.*, messages.actor_type, messages.actor_id, messages.operation
+           FROM ${this.table("dead_letters")} dead_letters
+           INNER JOIN ${this.table("messages")} messages ON messages.id = dead_letters.message_id
+           ORDER BY dead_letters.created_at_ms DESC LIMIT 10`),
+                connection.all(`SELECT actor_type, COUNT(*) AS count FROM ${this.table("instances")}
+           GROUP BY actor_type ORDER BY count DESC LIMIT 12`),
+            ]);
+            return freezeRecord({
+                processes: freezeRecords(processes),
+                deadLetters: freezeRecords(deadLetters),
+                instancesByType: freezeRecords(instancesByType),
+            });
+        });
+    }
+    async setPaused(options) {
+        const result = await this.runtime.settings.database.transaction(async (connection) => {
+            const now = await connection.nowMilliseconds();
+            return connection.run(`UPDATE ${this.table("instances")} SET paused = ?, updated_at_ms = ? WHERE id = ?`, [options.paused, now, options.id]);
+        });
+        return result.changes > 0;
+    }
+    async healthy() {
+        await this.runtime.settings.database.connection((connection) => connection.get(`SELECT 1 AS healthy FROM ${this.table("schema_migrations")} LIMIT 1`));
+    }
+    async page(query, options) {
+        const perPage = boundedInteger(options.perPage, { fallback: 25, maximum: 200 });
+        return this.runtime.settings.database.connection(async (connection) => {
+            const where = query.where ? ` WHERE ${query.where}` : "";
+            const parameters = [...(query.parameters ?? [])];
+            const count = await connection.get(`SELECT COUNT(*) AS count FROM ${query.from}${where}`, parameters);
+            const total = numeric(count?.count);
+            const lastPage = Math.max(Math.ceil(total / perPage), 1);
+            const page = Math.min(boundedInteger(options.page, { fallback: 1, maximum: lastPage }), lastPage);
+            const records = await connection.all(`SELECT ${query.select ?? "*"} FROM ${query.from}${where} ORDER BY ${query.order} LIMIT ? OFFSET ?`, [...parameters, perPage, (page - 1) * perPage]);
+            return Object.freeze({
+                records: freezeRecords(records),
+                page,
+                perPage,
+                total,
+                lastPage,
+            });
+        });
+    }
+    statusPage(options) {
+        const status = options.statuses.includes(options.options.status ?? "")
+            ? options.options.status
+            : undefined;
+        const statusColumn = options.statusColumn ?? "status";
+        return this.page({
+            from: this.table(options.table),
+            ...(status ? { where: `${statusColumn} = ?`, parameters: [status] } : {}),
+            order: options.order,
+        }, options.options);
+    }
+    async grouped(options) {
+        const { connection, table, column, statuses } = options;
+        const rows = await connection.all(`SELECT ${column} AS status, COUNT(*) AS count FROM ${this.table(table)} GROUP BY ${column}`);
+        const counts = new Map(rows.map((row) => [row.status, numeric(row.count)]));
+        return freezeRecord(Object.fromEntries(statuses.map((status) => [status, counts.get(status) ?? 0])));
+    }
+    substringExpression(column) {
+        if (this.runtime.settings.database.family === "sqlite")
+            return `instr(${column}, ?) > 0`;
+        if (this.runtime.settings.database.family === "postgresql")
+            return `POSITION(? IN ${column}) > 0`;
+        return `LOCATE(?, ${column}) > 0`;
+    }
+    table(name) {
+        return this.runtime.repository.table(name);
+    }
+}
+function boundedInteger(value, options) {
+    const parsed = Number.parseInt(value ?? "", 10);
+    if (!Number.isSafeInteger(parsed) || parsed < 1)
+        return options.fallback;
+    return Math.min(parsed, options.maximum);
+}
+function numeric(value) {
+    if (typeof value === "number")
+        return value;
+    if (typeof value === "bigint")
+        return Number(value);
+    if (typeof value === "string")
+        return Number(value);
+    return 0;
+}
+function freezeRecord(record) {
+    return Object.freeze(record);
+}
+function freezeRecords(records) {
+    return Object.freeze(records.map(freezeRecord));
+}
+//# sourceMappingURL=store.js.map

package/dist/web/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/web/store.ts"],"names":[],"mappings":"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"}

package/dist/web/types.d.ts

@@ -0,0 +1,82 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { SolidObjectsRuntime } from "../runtime.js";
+export interface DashboardSession {
+    read(key: string): string | undefined | Promise<string | undefined>;
+    write(key: string, value: string): void | Promise<void>;
+}
+export interface DashboardRequestContext {
+    readonly authorizationContext?: unknown;
+    readonly session?: DashboardSession;
+}
+export type DashboardAccess = "authorized" | "authorized-read-only" | "public-read-only";
+export interface DashboardPolicy {
+    readonly action: string;
+    readonly resource: string;
+}
+export interface DashboardPage {
+    readonly title: string;
+    readonly content: string;
+    readonly status?: number;
+}
+export interface DashboardRenderInput {
+    readonly name: string;
+    readonly model: Readonly<Record<string, unknown>>;
+    readonly defaultHtml: string;
+}
+export type DashboardRenderer = (input: DashboardRenderInput) => string;
+export interface DashboardRouteContext {
+    readonly request: Request;
+    readonly requestContext: DashboardRequestContext;
+    readonly params: Readonly<Record<string, string>>;
+    readonly runtime: SolidObjectsRuntime;
+    path(path: string): string;
+    render(page: DashboardPage): Response;
+    escape(value: unknown): string;
+}
+export interface DashboardRoute {
+    readonly method: "GET" | "HEAD" | "POST";
+    readonly path: string;
+    readonly policy: DashboardPolicy;
+    handle(context: DashboardRouteContext): DashboardPage | Response | Promise<DashboardPage | Response>;
+}
+export interface DashboardTab {
+    readonly label: string;
+    readonly path: string;
+}
+export interface DashboardExtension {
+    readonly tab?: DashboardTab;
+    readonly routes?: readonly DashboardRoute[];
+    readonly renderers?: Readonly<Record<string, DashboardRenderer>>;
+    readonly middleware?: readonly DashboardMiddleware[];
+}
+export interface DashboardMiddlewareInput {
+    readonly request: Request;
+    readonly requestContext: DashboardRequestContext;
+}
+export type DashboardMiddleware = (input: DashboardMiddlewareInput, next: () => Promise<Response>) => Promise<Response>;
+export interface DashboardChartLibrary {
+    readonly url: string | null;
+    readonly integrity?: string | null;
+}
+export interface DashboardOptions {
+    readonly runtime: SolidObjectsRuntime;
+    readonly mountPath?: string;
+    readonly access?: DashboardAccess;
+    readonly chartLibrary?: DashboardChartLibrary;
+    readonly extensions?: readonly DashboardExtension[];
+    readonly middleware?: readonly DashboardMiddleware[];
+}
+export interface NodeDashboardRequestContextResolver {
+    (request: IncomingMessage): DashboardRequestContext | Promise<DashboardRequestContext>;
+}
+export interface NodeDashboardHandlerOptions {
+    readonly dashboard: SolidObjectsDashboardContract;
+    readonly resolveContext: NodeDashboardRequestContextResolver;
+    readonly maximumBodyBytes?: number;
+}
+export interface SolidObjectsDashboardContract {
+    readonly mountPath: string;
+    fetch(request: Request, context: DashboardRequestContext): Promise<Response>;
+}
+export type NodeDashboardHandler = (...argumentsValue: [IncomingMessage, ServerResponse, ((error?: unknown) => void)?]) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/web/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/web/types.ts"],"names":[],"mappings":"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"}

package/dist/web/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/web/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/web/types.ts"],"names":[],"mappings":""}

package/docs/api.md

@@ -16,6 +16,11 @@ generic signatures; this index explains the supported role of every export.
 - `Actor`: base class providing `ref()`, `actorId`, `currentMessage`,
   `observables()`, `reject()`, `emit()`, `commitAction()`, `schedule()`,
   `sendTo()`, and protected lifecycle hooks.
+- `broadcastValue(value)`: mark an observable so its changed value enters the
+  durable invalidation envelope.
+- `broadcastInvalidation(value)`: compare the real observable value but put
+  only its name in the durable envelope when it changes.
+- `ObservableBroadcast`: the immutable marker type returned by either helper.
 - `VERSION`: running package version.
 - `ActorClass`, `ActorReference`, `ActorMessageSender`, `ActorSnapshot`,
   `ActorOperationNames`, `ActorQueryNames`, `StagedOperations`, and
@@ -31,6 +36,49 @@ generic signatures; this index explains the supported role of every export.
 `PayloadBroadcasts`, and `PayloadBroadcastValue` describe actor-declared
 transactional work and typed personalized projections.
 
+`observables()` returns a flat object. Unwrapped values are invalidation-only:
+their real values participate in change detection, but only their names enter
+the durable envelope. Use an explicit marker when wire behavior matters:
+
+```typescript
+override observables(): Record<string, unknown> {
+  return {
+    version: broadcastValue(this.document.version),
+    sidebar: broadcastInvalidation(this.sidebarForCurrentState()),
+  }
+}
+```
+
+Both values must be JSON-compatible and are evaluated after each successful
+turn. An invalidation-only value participates in change detection but is never
+written to the broadcast outbox or invalidation envelope. The envelope carries
+its name in `invalidations`, allowing component registries to refresh a
+reauthorized endpoint without exposing the value.
+
+`MessageReference` does not retain an invocation's authorization context.
+Supply `authorizationContext` to each `status()`, `result()`, and `wait()` call;
+the runtime reauthorizes the persisted operation every time. Durable results
+are JSON, so an operation that returns `undefined` or is declared `void`
+resolves as `null`.
+
+Declare named payload return shapes with a `type` alias rather than an
+`interface`. `PayloadBroadcastValue` requires the implicit string index
+signature of a JSON object, which TypeScript gives object type aliases but not
+interfaces.
+
+Snapshots return `DeepReadonly`, so application helpers should accept readonly
+structure rather than cast it away. A helper that only needs a session ID can
+preserve its useful result type with a generic boundary:
+
+```typescript
+function playerForSession<PlayerType extends { sessionId: string }>(options: {
+  room: { readonly players: readonly PlayerType[] }
+  sessionId: string | null
+}): PlayerType | undefined {
+  return options.room.players.find((player) => player.sessionId === options.sessionId)
+}
+```
+
 ### Runtime managers
 
 Every manager below is available as a property on `SolidObjectsRuntime`; the
@@ -48,7 +96,7 @@ class and result types are also exported for integration typing.
 - `runtime.doctor` / `Doctor`: `run({ roundTrip })` structured installation
   report.
 - `runtime.testing` / `SolidObjectsTestHelper`: deterministic `drain()` and
-  dependency-ordered `reset()`.
+  explicit-time `runDueReminders()`, plus dependency-ordered `reset()`.
 - `runtime.realtime` / `RealtimeManager`: `connect()`, process-local
   `publish()`, and `close()`.
 
@@ -60,11 +108,20 @@ The manager types are `DeadLetter`; `ReminderPage`, `ReminderPageOptions`,
 `QuietReconciliationOptions`, `ReconciliationInstance`, `ReconciliationPage`,
 `ReconciliationPageOptions`, and `ReconciliationStatesOptions`;
 `RetentionOptions`, `RetentionResult`, and `RetentionTarget`; and
-`TestDrainOptions` and `TestHelperRole`. `RealtimeConnectionOptions`,
+`RunDueRemindersOptions`, `TestDrainOptions`, and `TestHelperRole`.
+`RealtimeConnectionOptions`,
 `RealtimeSession`, and `SubscriptionRequest` define the server session API.
 `AdministrationOptions` carries the application-owned authorization context
 for administration calls.
 
+The packaged `solid-objects quickstart` command is config-free and runs the
+SQLite example shipped in the npm artifact. Every other CLI command loads the
+application runtime configured through `--config`.
+
+`ProcessRecord.shutdownState` is `"running"`, `"draining"`, or `"stopped"`;
+there is no separate `running` field. `RetentionResult.count` means eligible
+rows for `preview()` and rows actually deleted for `prune()`.
+
 ### Registration and integration
 
 - `runtime.register(ActorClass)`: validate and register an actor definition.
@@ -72,7 +129,9 @@ for administration calls.
   isolated runtime.
 - `runtime.registerEffect(name, handler)`: register an at-least-once external
   effect handler. `EffectContext` carries the stable effect ID and source
-  identity.
+  identity. Success operations receive `{ effectId, arguments, result }` and
+  failure operations receive `{ effectId, arguments, error }`; `arguments` is
+  the JSON object originally staged by `emit()`.
 - `runtime.registerCommitAction(name, handler)`: register a same-database
   fenced transaction handler. `CommitActionContext` includes the active
   `DatabaseConnection`.
@@ -93,6 +152,11 @@ for administration calls.
 `DatabaseConnection`, `DatabaseFamily`, and `RunResult` support custom database
 and commit-action integration.
 
+`BroadcastEvent.observables` contains changed value-broadcast projections.
+`BroadcastEvent.invalidations` contains changed invalidation-only names. The
+runtime always supplies the array; consumers should treat its absence from an
+older or application-produced event as an empty array.
+
 ### Runtime extensions and manual workers
 
 `runtime.registerComponent(factory, { count = 1 })` adds application-owned
@@ -134,7 +198,8 @@ The root exports `SolidObjectsError` and its supported subclasses:
 - admission and payload failures: `MailboxFull`, `InvalidPayload`,
   `PayloadTooLarge`, `IdempotencyConflict`, `InvalidPayloadBroadcast`, and
   `UnknownPayloadBroadcast`;
-- definition and execution failures: `InvalidActor`, `UnknownActorType`,
+- definition and execution failures: `InvalidActor`, `InvalidRejectionCode`,
+  `UnknownActorType`,
   `UnknownOperation`, `ActorCallCycle`, `QueryMutatedState`,
   `StateMigrationError`, `ApplicationWriteForbidden`, `UnknownEffect`, and
   `UnknownCommitAction`;
@@ -193,5 +258,35 @@ and `SyncTimeoutWaitingOn` type timeout diagnostics. See
   `ComponentRefreshFailure`, and `ComponentRegistryOptions`: framework-neutral
   refresh contract types.
 
+`InvalidationEnvelope.observables` contains values and
+`InvalidationEnvelope.invalidations` contains names without values. The
+component registry reacts to names in either location.
+
 The wire format, trust boundary, revision rules, and component semantics are in
 [Browser protocol](browser-protocol.md).
+
+## `solid-objects/web`
+
+- `createDashboard(options)` creates an immutable `SolidObjectsDashboard` with
+  a standard `fetch(request, context)` entry point.
+- `createNodeDashboardHandler(options)` adapts the Fetch entry point to
+  `node:http` and Connect-compatible middleware.
+- `DashboardOptions` selects the runtime, mount path, `DashboardAccess`, chart library,
+  `DashboardExtension` objects, and `DashboardMiddleware` functions.
+- `DashboardRequestContext` supplies the existing administration authorization
+  context and an optional `DashboardSession`. Read/write access requires the
+  session so its `read()` and `write()` methods can hold the masked CSRF token
+  across requests; read-only modes do not create CSRF state.
+- `DashboardRoute`, `DashboardRouteContext`, `DashboardPolicy`, `DashboardPage`,
+  and `DashboardTab` define extension pages. Every route requires a policy.
+- `DashboardRenderer`, `DashboardRenderInput`, and `DashboardMiddlewareInput`
+  define immutable view overrides and middleware inputs.
+- `DashboardChartLibrary` selects the CDN, a self-hosted script, or disabled
+  charts.
+- `NodeDashboardHandler`, `NodeDashboardHandlerOptions`, and
+  `NodeDashboardRequestContextResolver` describe the Node adapter.
+- `SolidObjectsDashboardContract` is the minimal Fetch contract accepted by the
+  Node adapter.
+
+Mounting, authorization actions, CSRF behavior, pages, and extensions are in
+[Operator dashboard](dashboard.md).