@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
|
@@ -26,6 +26,7 @@ import { appendEvent } from "./events.ts";
|
|
|
26
26
|
import { documentFor, type FieldRow } from "./fields.ts";
|
|
27
27
|
import { storedPolicy } from "./policy.ts";
|
|
28
28
|
import { raiseSubmitSignal, SUBMIT_SIGNAL } from "./signals.ts";
|
|
29
|
+
import { countSubmission } from "./tally.ts";
|
|
29
30
|
import { type ViewRow, viewControls, viewer as viewerById, viewFor } from "./viewers.ts";
|
|
30
31
|
|
|
31
32
|
/** The most signals a snapshot keeps: the view's newest. */
|
|
@@ -124,6 +125,8 @@ export interface SubmissionRow {
|
|
|
124
125
|
readonly digest: string;
|
|
125
126
|
readonly stale_view: number;
|
|
126
127
|
readonly created_at: string;
|
|
128
|
+
/** For a submission imported from a hosted home: where it came from (DATA_MODEL §7.3). */
|
|
129
|
+
readonly origin_json?: string | null;
|
|
127
130
|
}
|
|
128
131
|
|
|
129
132
|
interface DeliveryRow {
|
|
@@ -310,6 +313,8 @@ export interface SubmitOutcome {
|
|
|
310
313
|
readonly submission: SubmissionSummary;
|
|
311
314
|
/** `false` when it returned an earlier submission of the same view and revision (D22). */
|
|
312
315
|
readonly created: boolean;
|
|
316
|
+
/** The tallied fields whose counts this submission grew (D165 item 12). */
|
|
317
|
+
readonly tallied?: readonly string[];
|
|
313
318
|
}
|
|
314
319
|
|
|
315
320
|
/**
|
|
@@ -318,6 +323,35 @@ export interface SubmitOutcome {
|
|
|
318
323
|
* `MOSTRA_SUBMIT_POLICY_NONE`, `MOSTRA_SUBMIT_ALREADY` (a {@link SubmitConflict}) under `once`,
|
|
319
324
|
* `MOSTRA_SUBMIT_REVISION_MOVED` when the draft changed since the viewer saw it.
|
|
320
325
|
*/
|
|
326
|
+
/**
|
|
327
|
+
* Whether a submit would be judged afresh: not a repeat of one already recorded (which answers that
|
|
328
|
+
* submission), not refused by the view or a pause before anything is recorded. Only such a submit
|
|
329
|
+
* is admitted by the server's rates and the operator's limits (Fable review of WP-30, 8).
|
|
330
|
+
*/
|
|
331
|
+
export function wouldRecord(
|
|
332
|
+
db: LedgerDb,
|
|
333
|
+
input: Pick<SubmitInput, "artifactId" | "viewerId" | "tokenId" | "viewId" | "expectedRevision">,
|
|
334
|
+
): boolean {
|
|
335
|
+
try {
|
|
336
|
+
const view = viewFor(db, input.viewId, input.artifactId, input.viewerId, input.tokenId);
|
|
337
|
+
const draft = documentFor(db, input.artifactId, input.viewerId, false);
|
|
338
|
+
if (
|
|
339
|
+
draft !== undefined &&
|
|
340
|
+
db.get(
|
|
341
|
+
"SELECT 1 FROM submission WHERE view_id = ? AND draft_document_id = ? AND draft_revision = ?",
|
|
342
|
+
view.id,
|
|
343
|
+
draft.id,
|
|
344
|
+
input.expectedRevision,
|
|
345
|
+
)
|
|
346
|
+
) {
|
|
347
|
+
return false;
|
|
348
|
+
}
|
|
349
|
+
return !db.get("SELECT 1 FROM artifact_pause WHERE artifact_id = ?", input.artifactId);
|
|
350
|
+
} catch {
|
|
351
|
+
return false;
|
|
352
|
+
}
|
|
353
|
+
}
|
|
354
|
+
|
|
321
355
|
export function submit(db: LedgerDb, input: SubmitInput): SubmitOutcome {
|
|
322
356
|
// 1. The view, and through it the exact version the viewer saw, and the channels it accepts.
|
|
323
357
|
const view = viewFor(db, input.viewId, input.artifactId, input.viewerId, input.tokenId);
|
|
@@ -334,7 +368,19 @@ export function submit(db: LedgerDb, input: SubmitInput): SubmitOutcome {
|
|
|
334
368
|
if (repeat)
|
|
335
369
|
return { submission: { ...submissionSummary(db, repeat), duplicate: true }, created: false };
|
|
336
370
|
|
|
337
|
-
// 2. The policy in force
|
|
371
|
+
// 2. The policy in force, and whether the artifact takes answers now: a paused one takes none
|
|
372
|
+
// until resumed, whoever paused it, and the draft stays as it was (D165 item 14).
|
|
373
|
+
const paused = db.get<{ by: string }>(
|
|
374
|
+
"SELECT by FROM artifact_pause WHERE artifact_id = ? ORDER BY by = 'operator' DESC LIMIT 1",
|
|
375
|
+
input.artifactId,
|
|
376
|
+
);
|
|
377
|
+
if (paused) {
|
|
378
|
+
throw new RpcError(
|
|
379
|
+
createDiagnostic("MOSTRA_SUBMIT_PAUSED", {
|
|
380
|
+
message: `This page is paused${paused.by === "operator" ? " by its server's operator" : ""}: it takes no answers until it is resumed, and the draft is kept.`,
|
|
381
|
+
}),
|
|
382
|
+
);
|
|
383
|
+
}
|
|
338
384
|
const artifact = db.get<{ policy_json: string | null; latest_version_id: string | null }>(
|
|
339
385
|
"SELECT policy_json, latest_version_id FROM artifact WHERE id = ?",
|
|
340
386
|
input.artifactId,
|
|
@@ -552,6 +598,13 @@ export function submit(db: LedgerDb, input: SubmitInput): SubmitOutcome {
|
|
|
552
598
|
staleView ? 1 : 0,
|
|
553
599
|
at,
|
|
554
600
|
);
|
|
601
|
+
// Counts by choice grow in the same transaction, so a count is never ahead of, or behind, the
|
|
602
|
+
// submissions it counts (D165 item 12).
|
|
603
|
+
const tallied = countSubmission(db, {
|
|
604
|
+
artifactId: input.artifactId,
|
|
605
|
+
versionId: view.version_id,
|
|
606
|
+
fields: snapshot.draft.fields,
|
|
607
|
+
});
|
|
555
608
|
// The next round starts with the same values (D103).
|
|
556
609
|
if (policy.policy === "epochs") {
|
|
557
610
|
db.run("UPDATE document SET epoch = ? WHERE id = ?", epoch + 1, draft.id);
|
|
@@ -581,5 +634,9 @@ export function submit(db: LedgerDb, input: SubmitInput): SubmitOutcome {
|
|
|
581
634
|
"SELECT * FROM submission WHERE id = ?",
|
|
582
635
|
submissionId,
|
|
583
636
|
) as SubmissionRow;
|
|
584
|
-
return {
|
|
637
|
+
return {
|
|
638
|
+
submission: submissionSummary(db, row),
|
|
639
|
+
created: true,
|
|
640
|
+
...(tallied.length > 0 ? { tallied } : {}),
|
|
641
|
+
};
|
|
585
642
|
}
|
|
@@ -0,0 +1,129 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Counts by choice (D165 item 12, RM-07; DATA_MODEL §7.4, INTERFACES §18.4). An artifact that
|
|
3
|
+
* names a fixed-choice field in its manifest's `tally` gets a count of each choice, grown inside the
|
|
4
|
+
* submit transaction, one more for the choice the new submission holds, and read by viewers under
|
|
5
|
+
* the reserved live key `$tally/<field>`. Nothing else of a submission reaches viewers this way: a
|
|
6
|
+
* value outside the listed choices counts nothing, so free text is never shown, and below the
|
|
7
|
+
* entry's `minTotal` viewers see only the total.
|
|
8
|
+
*/
|
|
9
|
+
import {
|
|
10
|
+
ArtifactManifest,
|
|
11
|
+
type Batches,
|
|
12
|
+
TALLY_LIVE_PREFIX,
|
|
13
|
+
type TallySpec,
|
|
14
|
+
type TallyValue,
|
|
15
|
+
} from "@mostra/protocol";
|
|
16
|
+
import type { LedgerDb } from "../ledger/index.ts";
|
|
17
|
+
|
|
18
|
+
/** The tally entries of a version's manifest; none when it has none or can't be read. */
|
|
19
|
+
export function tallySpecs(db: LedgerDb, versionId: string): readonly TallySpec[] {
|
|
20
|
+
const row = db.get<{ manifest_json: string }>(
|
|
21
|
+
"SELECT manifest_json FROM version WHERE id = ?",
|
|
22
|
+
versionId,
|
|
23
|
+
);
|
|
24
|
+
if (!row) return [];
|
|
25
|
+
try {
|
|
26
|
+
const parsed = ArtifactManifest.safeParse(JSON.parse(row.manifest_json));
|
|
27
|
+
return parsed.success ? (parsed.data.tally ?? []) : [];
|
|
28
|
+
} catch {
|
|
29
|
+
return [];
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* Counts a new submission, in its submit transaction: for each tally of the version the
|
|
35
|
+
* submission names, one more for the choice its draft holds for the field. Returns the fields whose
|
|
36
|
+
* counts grew, so their viewers can be told after the commit.
|
|
37
|
+
*/
|
|
38
|
+
export function countSubmission(
|
|
39
|
+
db: LedgerDb,
|
|
40
|
+
input: {
|
|
41
|
+
readonly artifactId: string;
|
|
42
|
+
readonly versionId: string;
|
|
43
|
+
/** The submission's draft fields, as its snapshot holds them. */
|
|
44
|
+
readonly fields: Readonly<Record<string, { readonly value: unknown }>>;
|
|
45
|
+
},
|
|
46
|
+
): string[] {
|
|
47
|
+
const grown: string[] = [];
|
|
48
|
+
for (const spec of tallySpecs(db, input.versionId)) {
|
|
49
|
+
const value = Object.hasOwn(input.fields, spec.field)
|
|
50
|
+
? input.fields[spec.field]?.value
|
|
51
|
+
: undefined;
|
|
52
|
+
if (typeof value !== "string" || !spec.choices.includes(value)) continue;
|
|
53
|
+
// A row is counted, never replaced (a trigger), so the first answer inserts it and every
|
|
54
|
+
// later one adds to it; the count never goes down (a trigger too).
|
|
55
|
+
const updated = db.run(
|
|
56
|
+
"UPDATE tally SET count = count + 1 WHERE artifact_id = ? AND field_id = ? AND choice = ?",
|
|
57
|
+
input.artifactId,
|
|
58
|
+
spec.field,
|
|
59
|
+
value,
|
|
60
|
+
);
|
|
61
|
+
if (updated.changes === 0) {
|
|
62
|
+
db.run(
|
|
63
|
+
"INSERT INTO tally (artifact_id, field_id, choice, count) VALUES (?, ?, ?, 1)",
|
|
64
|
+
input.artifactId,
|
|
65
|
+
spec.field,
|
|
66
|
+
value,
|
|
67
|
+
);
|
|
68
|
+
}
|
|
69
|
+
grown.push(spec.field);
|
|
70
|
+
}
|
|
71
|
+
return grown;
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
/** The field a tally's live key reads, or `undefined` for any other key. */
|
|
75
|
+
export function tallyField(key: string): string | undefined {
|
|
76
|
+
return key.startsWith(TALLY_LIVE_PREFIX) ? key.slice(TALLY_LIVE_PREFIX.length) : undefined;
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
/** A tally as a live source reads it: its value, and a revision that only grows. */
|
|
80
|
+
export interface TallyState {
|
|
81
|
+
/** The total counted for the field, as a decimal string: it grows with every count. */
|
|
82
|
+
readonly revision: string;
|
|
83
|
+
readonly value: TallyValue;
|
|
84
|
+
/** The value as serializer batches, as every live value travels. */
|
|
85
|
+
readonly batches: Batches;
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
/**
|
|
89
|
+
* The tally of `field` as viewers see it, by the artifact's latest version's entry: each listed
|
|
90
|
+
* choice's count (a choice no one chose is 0), and the total, or only the total below the entry's
|
|
91
|
+
* `minTotal`. `undefined` when the latest version tallies no such field.
|
|
92
|
+
*/
|
|
93
|
+
export function tallyState(
|
|
94
|
+
db: LedgerDb,
|
|
95
|
+
artifactId: string,
|
|
96
|
+
field: string,
|
|
97
|
+
): TallyState | undefined {
|
|
98
|
+
const latest = db.get<{ latest_version_id: string | null }>(
|
|
99
|
+
"SELECT latest_version_id FROM artifact WHERE id = ?",
|
|
100
|
+
artifactId,
|
|
101
|
+
)?.latest_version_id;
|
|
102
|
+
if (!latest) return undefined;
|
|
103
|
+
const spec = tallySpecs(db, latest).find((entry) => entry.field === field);
|
|
104
|
+
if (!spec) return undefined;
|
|
105
|
+
const rows = db.all<{ choice: string; count: number }>(
|
|
106
|
+
"SELECT choice, count FROM tally WHERE artifact_id = ? AND field_id = ?",
|
|
107
|
+
artifactId,
|
|
108
|
+
field,
|
|
109
|
+
);
|
|
110
|
+
const byChoice = new Map(rows.map((row) => [row.choice, row.count]));
|
|
111
|
+
// Every answer ever counted for the field: an earlier version's choices included, so the
|
|
112
|
+
// revision only grows whatever a later version lists.
|
|
113
|
+
const counted = rows.reduce((sum, row) => sum + row.count, 0);
|
|
114
|
+
const counts: Record<string, number> = {};
|
|
115
|
+
let total = 0;
|
|
116
|
+
for (const choice of spec.choices) {
|
|
117
|
+
const count = byChoice.get(choice) ?? 0;
|
|
118
|
+
// defineProperty keeps a choice such as `__proto__` an own key.
|
|
119
|
+
Object.defineProperty(counts, choice, {
|
|
120
|
+
value: count,
|
|
121
|
+
enumerable: true,
|
|
122
|
+
writable: true,
|
|
123
|
+
configurable: true,
|
|
124
|
+
});
|
|
125
|
+
total += count;
|
|
126
|
+
}
|
|
127
|
+
const value: TallyValue = total < (spec.minTotal ?? 0) ? { total } : { counts, total };
|
|
128
|
+
return { revision: String(counted), value, batches: [[{ c: 0, v: value }]] };
|
|
129
|
+
}
|
|
@@ -57,6 +57,9 @@ function viewerOf(row: ViewerRow): Viewer {
|
|
|
57
57
|
...(row.kind === "token" || row.kind === "host" || row.kind === "tailnet"
|
|
58
58
|
? { ref: row.external_ref }
|
|
59
59
|
: {}),
|
|
60
|
+
// A hosted account's name is its identity provider's; an anonymous viewer's, their own.
|
|
61
|
+
...(row.kind === "account" ? { verified: true } : {}),
|
|
62
|
+
...(row.kind === "anonymous" ? { verified: false } : {}),
|
|
60
63
|
};
|
|
61
64
|
}
|
|
62
65
|
|
|
@@ -110,7 +113,37 @@ export function viewerForLink(db: LedgerDb, tokenId: string, name: string): stri
|
|
|
110
113
|
return viewerByRef(db, "token", { ref: `link:${tokenId}`, name });
|
|
111
114
|
}
|
|
112
115
|
|
|
113
|
-
|
|
116
|
+
/**
|
|
117
|
+
* A signed-in person on a hosted link minted without a viewer (D165 item 8): one viewer of kind
|
|
118
|
+
* `account` per account, named as its identity provider verified it.
|
|
119
|
+
*/
|
|
120
|
+
export function viewerForAccount(db: LedgerDb, accountId: string, name?: string): string {
|
|
121
|
+
return viewerByRef(db, "account", { ref: accountId, ...(name !== undefined ? { name } : {}) });
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
/**
|
|
125
|
+
* A person who isn't signed in on a hosted link minted without a viewer (D165 item 8): one viewer
|
|
126
|
+
* of kind `anonymous` per browser and route, by the route's derived key
|
|
127
|
+
* (`HMAC-SHA-256(browser secret, routeId)`), never the shell's raw secret. A name they choose is
|
|
128
|
+
* set apart, unverified ({@link nameAnonymous}).
|
|
129
|
+
*/
|
|
130
|
+
export function viewerForAnonymous(db: LedgerDb, key: string): string {
|
|
131
|
+
return viewerByRef(db, "anonymous", { ref: key });
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
/** Sets the self-chosen, unverified name of an anonymous viewer; any other viewer is left alone. */
|
|
135
|
+
export function nameAnonymous(db: LedgerDb, viewerId: string, name: string | null): boolean {
|
|
136
|
+
return (
|
|
137
|
+
db.run("UPDATE viewer SET name = ? WHERE id = ? AND kind = 'anonymous'", name, viewerId)
|
|
138
|
+
.changes > 0
|
|
139
|
+
);
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
function viewerByRef(
|
|
143
|
+
db: LedgerDb,
|
|
144
|
+
kind: "token" | "host" | "tailnet" | "account" | "anonymous",
|
|
145
|
+
spec: ViewerSpec,
|
|
146
|
+
): string {
|
|
114
147
|
const found = db.get<ViewerRow>(
|
|
115
148
|
"SELECT * FROM viewer WHERE kind = ? AND external_ref = ?",
|
|
116
149
|
kind,
|
package/src/ledger/index.ts
CHANGED
|
@@ -29,7 +29,7 @@ export {
|
|
|
29
29
|
recordResult,
|
|
30
30
|
requestKey,
|
|
31
31
|
} from "./requests.ts";
|
|
32
|
-
export type { LedgerDb } from "./types.ts";
|
|
32
|
+
export type { LedgerDb, MigrationDb, SqlValue } from "./types.ts";
|
|
33
33
|
|
|
34
34
|
/** The ledger's file name inside `<home>/store`. */
|
|
35
35
|
export const LEDGER_FILE = "ledger.sqlite";
|
|
@@ -52,6 +52,17 @@ export interface OpenLedgerOptions {
|
|
|
52
52
|
readonly log: Log;
|
|
53
53
|
/** The migrations to apply. Default: this runtime's {@link MIGRATIONS}. */
|
|
54
54
|
readonly migrations?: readonly Migration[];
|
|
55
|
+
/**
|
|
56
|
+
* `exclusive` (the default) holds SQLite's exclusive lock for as long as the ledger is open:
|
|
57
|
+
* the lock decides who owns a local home (D81). `normal` is a hosted home's (D165 item 0b): the
|
|
58
|
+
* one writer is whoever holds the home's own lock ({@link holdLock}), and a backup replicator
|
|
59
|
+
* may read the ledger from its own process.
|
|
60
|
+
*/
|
|
61
|
+
readonly locking?: "exclusive" | "normal";
|
|
62
|
+
/** SQLite's `wal_autocheckpoint` for a `normal` ledger (a replicator may ask for 0). */
|
|
63
|
+
readonly walAutocheckpoint?: number;
|
|
64
|
+
/** The file's name in `storeDir`. Default: `ledger.sqlite`; a server's directory: `server.sqlite`. */
|
|
65
|
+
readonly fileName?: string;
|
|
55
66
|
}
|
|
56
67
|
|
|
57
68
|
/** The open ledger. Holding this object holds the home's lock. */
|
|
@@ -70,6 +81,13 @@ export interface Ledger {
|
|
|
70
81
|
* `MOSTRA_HOME_DISK_FULL`; a removed ledger throws `MOSTRA_HOME_GONE`. Nothing partial commits.
|
|
71
82
|
*/
|
|
72
83
|
write<T>(fn: (db: LedgerDb) => T): T;
|
|
84
|
+
/**
|
|
85
|
+
* Runs `fn` in one write transaction that may also drop and create triggers: the one path past
|
|
86
|
+
* the write-once triggers, for a remote server operator's explicit removal of an artifact
|
|
87
|
+
* (`ServerHandle.remove`, DATA_MODEL §7.5), which recreates every trigger it dropped before it
|
|
88
|
+
* commits. Nothing else calls it.
|
|
89
|
+
*/
|
|
90
|
+
removal<T>(fn: (db: MigrationDb) => T): T;
|
|
73
91
|
/** Runs `fn` in one read transaction, so it sees a single consistent state. */
|
|
74
92
|
read<T>(fn: (db: LedgerDb) => T): T;
|
|
75
93
|
/**
|
|
@@ -146,9 +164,9 @@ function unreadable(file: string, why: string): RpcError {
|
|
|
146
164
|
}
|
|
147
165
|
|
|
148
166
|
/** Builds a new ledger file at `file` without ever replacing an existing one (DATA_MODEL §6). */
|
|
149
|
-
function createLedgerFile(storeDir: string, file: string, log: Log): void {
|
|
167
|
+
function createLedgerFile(storeDir: string, file: string, log: Log, fileName = LEDGER_FILE): void {
|
|
150
168
|
const Driver = loadDriver();
|
|
151
|
-
const temp = join(storeDir, `${
|
|
169
|
+
const temp = join(storeDir, `${fileName}.${process.pid}.${Date.now()}.creating`);
|
|
152
170
|
const db = new Driver(temp);
|
|
153
171
|
try {
|
|
154
172
|
db.pragma("journal_mode = WAL");
|
|
@@ -181,7 +199,9 @@ function syncDirectory(dir: string): void {
|
|
|
181
199
|
*/
|
|
182
200
|
function removeAbandonedFiles(storeDir: string): void {
|
|
183
201
|
for (const name of readdirSync(storeDir)) {
|
|
184
|
-
const match = /^ledger\.sqlite\.(\d+)\.\d+\.creating(-wal|-shm|-journal)?$/.exec(
|
|
202
|
+
const match = /^(?:ledger|server)\.sqlite\.(\d+)\.\d+\.creating(-wal|-shm|-journal)?$/.exec(
|
|
203
|
+
name,
|
|
204
|
+
);
|
|
185
205
|
if (match && !processExists(Number(match[1]))) rmSync(join(storeDir, name), { force: true });
|
|
186
206
|
}
|
|
187
207
|
}
|
|
@@ -195,7 +215,8 @@ function processExists(pid: number): boolean {
|
|
|
195
215
|
}
|
|
196
216
|
}
|
|
197
217
|
|
|
198
|
-
|
|
218
|
+
/** A migration's queries over a connection; exported for the schema tests, which migrate in memory. */
|
|
219
|
+
export function queries(db: Database): MigrationDb {
|
|
199
220
|
const cache = new Map<string, BetterSqlite3.Statement>();
|
|
200
221
|
const prepare = (sql: string): BetterSqlite3.Statement => {
|
|
201
222
|
let statement = cache.get(sql);
|
|
@@ -219,6 +240,29 @@ function queries(db: Database): MigrationDb {
|
|
|
219
240
|
exec(sql: string): void {
|
|
220
241
|
db.exec(sql);
|
|
221
242
|
},
|
|
243
|
+
widenCheck(table: string, from: string, to: string): void {
|
|
244
|
+
const row = db
|
|
245
|
+
.prepare("SELECT sql FROM sqlite_schema WHERE type = 'table' AND name = ?")
|
|
246
|
+
.get(table) as { sql: string } | undefined;
|
|
247
|
+
if (row?.sql.split(from).length !== 2) {
|
|
248
|
+
throw new Error(`widenCheck: ${table}'s definition doesn't hold ${from} exactly once.`);
|
|
249
|
+
}
|
|
250
|
+
const version = db.pragma("schema_version", { simple: true }) as number;
|
|
251
|
+
db.unsafeMode(true);
|
|
252
|
+
try {
|
|
253
|
+
db.pragma("writable_schema = ON");
|
|
254
|
+
db.prepare("UPDATE sqlite_schema SET sql = ? WHERE type = 'table' AND name = ?").run(
|
|
255
|
+
row.sql.replace(from, to),
|
|
256
|
+
table,
|
|
257
|
+
);
|
|
258
|
+
db.pragma(`schema_version = ${version + 1}`);
|
|
259
|
+
} finally {
|
|
260
|
+
db.pragma("writable_schema = OFF");
|
|
261
|
+
db.unsafeMode(false);
|
|
262
|
+
}
|
|
263
|
+
const problems = db.pragma("integrity_check", { simple: true });
|
|
264
|
+
if (problems !== "ok") throw new Error(`widenCheck: ${table}: ${String(problems)}`);
|
|
265
|
+
},
|
|
222
266
|
};
|
|
223
267
|
}
|
|
224
268
|
|
|
@@ -236,20 +280,28 @@ export function openLedger(options: OpenLedgerOptions): LedgerOpening {
|
|
|
236
280
|
const migrations = options.migrations ?? MIGRATIONS;
|
|
237
281
|
const latest = migrations.at(-1)?.version ?? 0;
|
|
238
282
|
mkdirSync(storeDir, { recursive: true, mode: 0o700 });
|
|
239
|
-
const
|
|
240
|
-
|
|
283
|
+
const fileName = options.fileName ?? LEDGER_FILE;
|
|
284
|
+
const file = join(storeDir, fileName);
|
|
285
|
+
if (!existsSync(file)) createLedgerFile(storeDir, file, log, fileName);
|
|
241
286
|
|
|
242
287
|
const Driver = loadDriver();
|
|
243
288
|
let db: Database;
|
|
244
289
|
try {
|
|
245
|
-
|
|
290
|
+
// A normal-locking ledger waits a moment for a replicator's short checkpoint locks.
|
|
291
|
+
db = new Driver(file, {
|
|
292
|
+
timeout: options.locking === "normal" ? 5_000 : 0,
|
|
293
|
+
fileMustExist: true,
|
|
294
|
+
});
|
|
246
295
|
} catch (error) {
|
|
247
296
|
throw diagnose(error, file) ?? error;
|
|
248
297
|
}
|
|
249
298
|
|
|
250
299
|
try {
|
|
251
300
|
// EXCLUSIVE before the first WAL access: no shared-memory index, and no other connection.
|
|
252
|
-
db.pragma("locking_mode = EXCLUSIVE");
|
|
301
|
+
if (options.locking !== "normal") db.pragma("locking_mode = EXCLUSIVE");
|
|
302
|
+
else if (options.walAutocheckpoint !== undefined) {
|
|
303
|
+
db.pragma(`wal_autocheckpoint = ${Math.max(0, Math.trunc(options.walAutocheckpoint))}`);
|
|
304
|
+
}
|
|
253
305
|
const mode = db.pragma("journal_mode = WAL", { simple: true });
|
|
254
306
|
if (mode !== "wal") throw unreadable(file, `its journal mode is ${String(mode)}, not WAL`);
|
|
255
307
|
db.pragma("synchronous = FULL");
|
|
@@ -316,7 +368,7 @@ function migrate(
|
|
|
316
368
|
`SQLite's integrity check failed (${problems.slice(0, 3).join("; ")})`,
|
|
317
369
|
);
|
|
318
370
|
}
|
|
319
|
-
backup = join(storeDir, `${LEDGER_FILE}.bak-${from}-${latest}`);
|
|
371
|
+
backup = join(storeDir, `${options.fileName ?? LEDGER_FILE}.bak-${from}-${latest}`);
|
|
320
372
|
rmSync(backup, { force: true });
|
|
321
373
|
// VACUUM INTO writes a consistent copy through SQLite, fsynced under synchronous=FULL;
|
|
322
374
|
// copying the file with fs would drop this process's lock (DATA_MODEL §1).
|
|
@@ -399,6 +451,18 @@ function wrap(
|
|
|
399
451
|
}
|
|
400
452
|
return result;
|
|
401
453
|
},
|
|
454
|
+
removal<T>(fn: (db: MigrationDb) => T): T {
|
|
455
|
+
assertInPlace();
|
|
456
|
+
const result = guarded(() => db.transaction(() => fn(target)).immediate());
|
|
457
|
+
for (const listener of listeners) {
|
|
458
|
+
try {
|
|
459
|
+
listener();
|
|
460
|
+
} catch {
|
|
461
|
+
// A listener's failure is its own; the commit stands.
|
|
462
|
+
}
|
|
463
|
+
}
|
|
464
|
+
return result;
|
|
465
|
+
},
|
|
402
466
|
onCommit(listener) {
|
|
403
467
|
listeners.add(listener);
|
|
404
468
|
return () => listeners.delete(listener);
|
|
@@ -418,3 +482,53 @@ function wrap(
|
|
|
418
482
|
},
|
|
419
483
|
};
|
|
420
484
|
}
|
|
485
|
+
|
|
486
|
+
/** A lock held by {@link holdLock}. */
|
|
487
|
+
export interface HeldLock {
|
|
488
|
+
readonly file: string;
|
|
489
|
+
/** Releases it. Idempotent. */
|
|
490
|
+
release(): void;
|
|
491
|
+
}
|
|
492
|
+
|
|
493
|
+
/**
|
|
494
|
+
* Takes an advisory lock that the operating system releases when this process dies (DATA_MODEL
|
|
495
|
+
* §7.1, D165): `file` is a one-row SQLite database held in `locking_mode=EXCLUSIVE` with a write
|
|
496
|
+
* transaction open, so no other process can open it, and no stale PID file can outlive its
|
|
497
|
+
* owner. Needs no native addon beyond the ledger's own driver. Answers `undefined` when another
|
|
498
|
+
* process holds it.
|
|
499
|
+
*/
|
|
500
|
+
export function holdLock(file: string, owner: LedgerOwner): HeldLock | undefined {
|
|
501
|
+
const Driver = loadDriver();
|
|
502
|
+
const db = new Driver(file, { timeout: 0 });
|
|
503
|
+
try {
|
|
504
|
+
db.pragma("locking_mode = EXCLUSIVE");
|
|
505
|
+
db.pragma("journal_mode = DELETE");
|
|
506
|
+
db.prepare("BEGIN EXCLUSIVE").run();
|
|
507
|
+
db.exec(
|
|
508
|
+
"CREATE TABLE IF NOT EXISTS holder (id INTEGER PRIMARY KEY CHECK (id = 1), pid, start_time, at)",
|
|
509
|
+
);
|
|
510
|
+
db.prepare("INSERT OR REPLACE INTO holder (id, pid, start_time, at) VALUES (1, ?, ?, ?)").run(
|
|
511
|
+
owner.pid,
|
|
512
|
+
owner.startTime,
|
|
513
|
+
new Date().toISOString(),
|
|
514
|
+
);
|
|
515
|
+
// The transaction stays open: its lock is the lock.
|
|
516
|
+
} catch (error) {
|
|
517
|
+
db.close();
|
|
518
|
+
if (sqliteCode(error) === "SQLITE_BUSY") return undefined;
|
|
519
|
+
throw diagnose(error, file) ?? error;
|
|
520
|
+
}
|
|
521
|
+
let held = true;
|
|
522
|
+
return {
|
|
523
|
+
file,
|
|
524
|
+
release() {
|
|
525
|
+
if (!held) return;
|
|
526
|
+
held = false;
|
|
527
|
+
try {
|
|
528
|
+
db.prepare("ROLLBACK").run();
|
|
529
|
+
} finally {
|
|
530
|
+
db.close();
|
|
531
|
+
}
|
|
532
|
+
},
|
|
533
|
+
};
|
|
534
|
+
}
|