@opendatalabs/personal-server-ts-server 1.34.1 → 1.35.0

package/dist/storage/pdpp-replication-transport.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Node host for the replica transport engine (core `replication/engine.ts`).
+ * The phase logic lives in core and is shared with PS-Lite; this file binds
+ * it to one better-sqlite3 connection: synchronous transactions, the
+ * process writer lock, the replication door, chunked staging and the
+ * receiver's atomic boundary.
+ */
+import type { Database } from "better-sqlite3";
+import { type ReplicaEngineConfig } from "@opendatalabs/personal-server-ts-core/replication/engine";
+import type { ReplicationExport } from "./pdpp-replication-sqlite.js";
+import type { createReplicaReceiver } from "./pdpp-replication-receiver.js";
+import { createReplicaStagingStore } from "./pdpp-replica-staging.js";
+export { REPLICA_BATCH_BYTES, REPLICA_BATCH_OPERATIONS, REPLICA_RECONCILE_PAGE, REPLICA_REGISTRATION_INTENT_TIMEOUT_MS, REPLICA_VERSION_SQUAT_ATTEMPTS, REPLICA_VERSION_SQUAT_WINDOW_MS, ReplicaAuthorityError, ReplicaCarrierMismatchError, } from "@opendatalabs/personal-server-ts-core/replication/engine";
+/** Unattached stages expire after one hour; cleanup deletes at most this many. */
+export declare const REPLICA_STAGED_OBJECT_LEASE_MS: number;
+export declare const REPLICA_STAGED_OBJECT_CLEANUP_BATCH = 100;
+export declare function createReplicaTransportWorker(deps: ReplicaEngineConfig & {
+    db: Database;
+    exporter: ReplicationExport;
+    receiver: ReturnType<typeof createReplicaReceiver>;
+    /** Narrow deterministic seam for failures at the staging-store boundary. */
+    createStagingStore?: typeof createReplicaStagingStore;
+}): {
+    step: (input?: {
+        now?: number;
+        budget?: import("@opendatalabs/personal-server-ts-core/replication/coordinator").ReplicaBudget;
+        signal?: AbortSignal;
+    }) => Promise<import("@opendatalabs/personal-server-ts-core/replication/coordinator").ProgressReport>;
+    cycle: () => Promise<void>;
+    /** Owner acknowledgement resumes an exhausted writer after its wait and recovery window. */
+    retryVersionSquats: () => number;
+    /** See the engine: re-admit Unsupported batches after a capability change. */
+    readmitUnsupported: () => number;
+    /** See the engine: fetch again slots quarantined for missing fragments. */
+    readmitFragments: () => number;
+    /** A host-observed dependency change (e.g. `mapping:<connection>`). Idempotent. */
+    onDependencyChanged: (key: string) => number;
+};
+//# sourceMappingURL=pdpp-replication-transport.d.ts.map

package/dist/storage/pdpp-replication-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdpp-replication-transport.d.ts","sourceRoot":"","sources":["../../src/storage/pdpp-replication-transport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAEL,KAAK,mBAAmB,EAGzB,MAAM,0DAA0D,CAAC;AAkBlE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAKtE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EACL,yBAAyB,EAG1B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,sCAAsC,EACtC,8BAA8B,EAC9B,+BAA+B,EAC/B,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,0DAA0D,CAAC;AAMlE,kFAAkF;AAClF,eAAO,MAAM,8BAA8B,QAAyB,CAAC;AACrE,eAAO,MAAM,mCAAmC,MAA8B,CAAC;AAa/E,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,mBAAmB,GAAG;IAC1B,EAAE,EAAE,QAAQ,CAAC;IACb,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;IACnD,4EAA4E;IAC5E,kBAAkB,CAAC,EAAE,OAAO,yBAAyB,CAAC;CACvD;;WA4Mm/Q,CAAC;cAAwB,CAAC;cAA+B,CAAC;;;IAX5iR,4FAA4F;8BACpE,MAAM;IAC9B,8EAA8E;8BACtD,MAAM;IAC9B,2EAA2E;4BACrD,MAAM;IAC5B,mFAAmF;+BACxD,MAAM,KAAG,MAAM;EAG7C"}

package/dist/storage/pdpp-replication-transport.js

@@ -0,0 +1,196 @@
+import { randomUUID } from "node:crypto";
+import { createReplicaEngine, } from "@opendatalabs/personal-server-ts-core/replication/engine";
+import { perform, runEffectSync, } from "@opendatalabs/personal-server-ts-core/replication/effects";
+import { ReplicaCoordinatorConflict } from "@opendatalabs/personal-server-ts-core/replication/coordinator";
+import { deleteBinary, createBinaryCompactor } from "./pdpp-binary-chunks.js";
+import { createSqliteReplicaCoordinatorState } from "./pdpp-replica-coordinator-state.js";
+import { nodeReplicaContext } from "./pdpp-replica-sql.js";
+import { assertReplicationStepOpen, assertReplicationTransactionOpen, beginReplicationStep, captureWrites, replicationAdmitted, } from "./pdpp-replication-door.js";
+import { currentReplicaWriterIdentity, enableReplicaWriterIdentity, } from "./pdpp-replica-writer-identity.js";
+import { createReplicaStagingStore, STAGED_OBJECT_CLEANUP_BATCH, STAGED_OBJECT_LEASE_MS, } from "./pdpp-replica-staging.js";
+export { REPLICA_BATCH_BYTES, REPLICA_BATCH_OPERATIONS, REPLICA_RECONCILE_PAGE, REPLICA_REGISTRATION_INTENT_TIMEOUT_MS, REPLICA_VERSION_SQUAT_ATTEMPTS, REPLICA_VERSION_SQUAT_WINDOW_MS, ReplicaAuthorityError, ReplicaCarrierMismatchError, } from "@opendatalabs/personal-server-ts-core/replication/engine";
+// One process owns a transport writer per database; other local instances serialize cycles.
+const activeDatabases = new Set();
+const ownedTokens = new Set();
+/** Unattached stages expire after one hour; cleanup deletes at most this many. */
+export const REPLICA_STAGED_OBJECT_LEASE_MS = STAGED_OBJECT_LEASE_MS;
+export const REPLICA_STAGED_OBJECT_CLEANUP_BATCH = STAGED_OBJECT_CLEANUP_BATCH;
+/** Node answers every storage call synchronously; a promise here is a bug. */
+function settled(value) {
+    if (typeof value === "object" &&
+        value !== null &&
+        typeof value.then === "function")
+        throw new Error("replica engine returned a promise on Node");
+    return value;
+}
+export function createReplicaTransportWorker(deps) {
+    const { db, exporter, receiver } = deps;
+    const context = nodeReplicaContext(db);
+    const run = (effect) => runEffectSync(effect, context);
+    /** A synchronous Node call, as one effect operation. */
+    const sync = (call) => perform(call);
+    const databaseKey = db.name && db.name !== ":memory:" ? db.name : db;
+    function acquireWriter(token) {
+        db.transaction(() => {
+            const holder = db
+                .prepare("SELECT pid,token FROM pdpp_transport_lock WHERE id=1")
+                .get();
+            if (holder?.pid === process.pid && !ownedTokens.has(holder.token)) {
+                db.prepare("DELETE FROM pdpp_transport_lock WHERE id=1").run();
+            }
+            else if (holder) {
+                try {
+                    process.kill(holder.pid, 0);
+                }
+                catch (error) {
+                    if (error.code === "ESRCH") {
+                        db.prepare("DELETE FROM pdpp_transport_lock WHERE id=1").run();
+                    }
+                    else
+                        throw error;
+                }
+                if (db.prepare("SELECT 1 FROM pdpp_transport_lock WHERE id=1").get())
+                    throw Object.assign(new Error("replica database worker already active"), { code: "replica_worker_active" });
+            }
+            db.prepare("INSERT INTO pdpp_transport_lock VALUES (1,?,?)").run(process.pid, token);
+        }).immediate();
+        ownedTokens.add(token);
+    }
+    const compactor = createBinaryCompactor(db);
+    const host = {
+        compactCanonical: (bytes) => sync(() => {
+            compactor.step(bytes);
+        }),
+        run,
+        immediate: (effect) => sync(() => db.transaction(() => run(effect)).immediate()),
+        transaction: (effect) => sync(() => db.transaction(() => run(effect))()),
+        commit(effect, _context, signal) {
+            // The receiver's own boundary: its plans read and write derived state,
+            // which a transaction opened on the raw connection would not refresh.
+            if (db.inTransaction)
+                assertReplicationTransactionOpen(db, signal);
+            else
+                assertReplicationStepOpen(db, signal);
+            return receiver.atomically(() => run(effect));
+        },
+        cleanup: (effect) => {
+            run(effect);
+        },
+        captureWrites: (effect) => sync(() => captureWrites(db, () => run(effect))),
+        randomId: () => randomUUID(),
+        door: {
+            admitted: () => replicationAdmitted(db),
+            beginStep: (signal) => beginReplicationStep(db, signal),
+            assertStepOpen: (signal) => assertReplicationStepOpen(db, signal),
+            assertTransactionOpen: (signal) => assertReplicationTransactionOpen(db, signal),
+        },
+        lock: {
+            busy: () => activeDatabases.has(databaseKey),
+            acquire(token) {
+                acquireWriter(token);
+                activeDatabases.add(databaseKey);
+            },
+            release(token) {
+                activeDatabases.delete(databaseKey);
+                try {
+                    db.prepare("DELETE FROM pdpp_transport_lock WHERE id=1 AND token=?").run(token);
+                }
+                finally {
+                    ownedTokens.delete(token);
+                }
+            },
+        },
+        identity: {
+            current: () => sync(() => currentReplicaWriterIdentity(db)),
+            enable: (input) => enableReplicaWriterIdentity({ db, ...input }),
+        },
+        coordinatorState: ({ owner, signal: stepSignal, enabled: isEnabled }) => createSqliteReplicaCoordinatorState({
+            db,
+            owner,
+            atomically: (attempt) => {
+                const signal = stepSignal();
+                if (!signal || !isEnabled())
+                    throw new ReplicaCoordinatorConflict();
+                assertReplicationStepOpen(db, signal);
+                return receiver.atomically(() => {
+                    const result = attempt();
+                    assertReplicationTransactionOpen(db, signal);
+                    return result;
+                });
+            },
+        }),
+        staging({ injected, ...input }) {
+            const create = injected
+                ? (deps.createStagingStore ?? createReplicaStagingStore)
+                : createReplicaStagingStore;
+            const store = create({ db, ...input });
+            return {
+                begin: (admission) => store.begin(admission),
+                verify: (handle, expected) => store.verify(handle, expected),
+                attach: (handle, expected) => sync(() => store.attach(handle, expected)),
+                abort: (admission) => store.abort(admission),
+                reclaimAdmission: (admission) => store.reclaimAdmission(admission),
+                cleanup: () => store.cleanup(),
+                cleanupAttachedTemporaryBytes: () => store.cleanupAttachedTemporaryBytes(),
+            };
+        },
+        sweepStages: () => sync(() => {
+            const untrackedStages = db
+                .prepare(`SELECT m.blob_id FROM pdpp_binary_manifests m
+             WHERE m.namespace='staging'
+               AND NOT EXISTS (
+                 SELECT 1 FROM pdpp_transport_staged_objects s
+                 WHERE s.namespace_key=m.blob_id
+               )
+             ORDER BY m.blob_id LIMIT ?`)
+                .all(STAGED_OBJECT_CLEANUP_BATCH);
+            for (const row of untrackedStages)
+                deleteBinary(db, "staging", row.blob_id);
+        }),
+        exporter: {
+            readBaselinePage: (options) => sync(() => exporter.readBaselinePage(options)),
+            readTailPage: (options) => sync(() => exporter.readTailPage(options)),
+            getBaselineCheckpoint: () => sync(() => exporter.getBaselineCheckpoint()),
+            acknowledgeBaselinePage: (expected, next) => sync(() => exporter.acknowledgeBaselinePage(expected, next)),
+            // The receiver's merge chose these operations for current state; the
+            // baseline copies only what this device's trust accepted.
+            rebaseline: () => sync(() => exporter.rebaseline(receiver.explainState({ credential: deps.credential }))),
+            declarationHistory: () => sync(() => exporter.declarationHistory()),
+            // Node's journal is append-only and stays: rebaseline and completion
+            // dependencies read it (`pdpp-replication-sqlite.ts`).
+            acknowledgePublished: () => sync(() => undefined),
+            readPinnedBlobChunks: (blobId) => exporter.readPinnedBlobChunks(blobId),
+        },
+        receiver: {
+            setPendingEnabled: (value) => receiver.setPendingEnabled(value),
+            quarantine: (input) => sync(() => receiver.quarantine(input)),
+            reconcileStep: (input) => sync(() => receiver.reconcileStep(input)),
+            reconcileQueued: () => sync(() => receiver.reconcileQueued()),
+            copies: {
+                list: (id) => sync(() => receiver.copies.list(id)),
+                decide: (id, refetch) => sync(() => receiver.copies.decide(id, refetch)),
+                apply: (input) => sync(() => receiver.copies.apply(input)),
+                stage: (input) => sync(() => receiver.copies.stage(input)),
+                recordFact: (input) => sync(() => receiver.copies.recordFact(input)),
+                promote: (input) => sync(() => receiver.copies.promote(input)),
+            },
+        },
+        bindings: () => sync(() => db
+            .prepare("SELECT instance,source_id,method,generation,deleted_at FROM pdpp_instance_binding ORDER BY instance")
+            .all()),
+    };
+    const engine = createReplicaEngine(host, deps);
+    return {
+        step: engine.step,
+        cycle: engine.cycle,
+        /** Owner acknowledgement resumes an exhausted writer after its wait and recovery window. */
+        retryVersionSquats: () => settled(engine.retryVersionSquats()),
+        /** See the engine: re-admit Unsupported batches after a capability change. */
+        readmitUnsupported: () => settled(engine.readmitUnsupported()),
+        /** See the engine: fetch again slots quarantined for missing fragments. */
+        readmitFragments: () => settled(engine.readmitFragments()),
+        /** A host-observed dependency change (e.g. `mapping:<connection>`). Idempotent. */
+        onDependencyChanged: (key) => settled(engine.onDependencyChanged(key)),
+    };
+}
+//# sourceMappingURL=pdpp-replication-transport.js.map

package/dist/storage/pdpp-replication-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdpp-replication-transport.js","sourceRoot":"","sources":["../../src/storage/pdpp-replication-transport.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,mBAAmB,GAIpB,MAAM,0DAA0D,CAAC;AAClE,OAAO,EACL,OAAO,EACP,aAAa,GAGd,MAAM,2DAA2D,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,+DAA+D,CAAC;AAC3G,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,mCAAmC,EAAE,MAAM,qCAAqC,CAAC;AAC1F,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EACL,yBAAyB,EACzB,gCAAgC,EAChC,oBAAoB,EACpB,aAAa,EACb,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,sCAAsC,EACtC,8BAA8B,EAC9B,+BAA+B,EAC/B,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,0DAA0D,CAAC;AAElE,4FAA4F;AAC5F,MAAM,eAAe,GAAG,IAAI,GAAG,EAAqB,CAAC;AACrD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;AAEtC,kFAAkF;AAClF,MAAM,CAAC,MAAM,8BAA8B,GAAG,sBAAsB,CAAC;AACrE,MAAM,CAAC,MAAM,mCAAmC,GAAG,2BAA2B,CAAC;AAE/E,8EAA8E;AAC9E,SAAS,OAAO,CAAI,KAAyB;IAC3C,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAQ,KAA4B,CAAC,IAAI,KAAK,UAAU;QAExD,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,OAAO,KAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,IAMC;IAED,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IACxC,MAAM,OAAO,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAEvC,MAAM,GAAG,GAAG,CAAI,MAA2B,EAAE,EAAE,CAC7C,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,wDAAwD;IACxD,MAAM,IAAI,GAAG,CAAI,IAAa,EAAuB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,MAAM,WAAW,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAErE,SAAS,aAAa,CAAC,KAAa;QAClC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;YAClB,MAAM,MAAM,GAAG,EAAE;iBACd,OAAO,CAAC,sDAAsD,CAAC;iBAC/D,GAAG,EAAgD,CAAC;YACvD,IAAI,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBAClE,EAAE,CAAC,OAAO,CAAC,4CAA4C,CAAC,CAAC,GAAG,EAAE,CAAC;YACjE,CAAC;iBAAM,IAAI,MAAM,EAAE,CAAC;gBAClB,IAAI,CAAC;oBACH,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBAC9B,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAK,KAA+B,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;wBACtD,EAAE,CAAC,OAAO,CAAC,4CAA4C,CAAC,CAAC,GAAG,EAAE,CAAC;oBACjE,CAAC;;wBAAM,MAAM,KAAK,CAAC;gBACrB,CAAC;gBACD,IAAI,EAAE,CAAC,OAAO,CAAC,8CAA8C,CAAC,CAAC,GAAG,EAAE;oBAClE,MAAM,MAAM,CAAC,MAAM,CACjB,IAAI,KAAK,CAAC,wCAAwC,CAAC,EACnD,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAClC,CAAC;YACN,CAAC;YACD,EAAE,CAAC,OAAO,CAAC,gDAAgD,CAAC,CAAC,GAAG,CAC9D,OAAO,CAAC,GAAG,EACX,KAAK,CACN,CAAC;QACJ,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;QACf,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,SAAS,GAAG,qBAAqB,CAAC,EAAE,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAyB;QACjC,gBAAgB,EAAE,CAAC,KAAK,EAAE,EAAE,CAC1B,IAAI,CAAC,GAAG,EAAE;YACR,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC,CAAC;QACJ,GAAG;QACH,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CACpB,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;QAC3D,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QACxE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM;YAC7B,uEAAuE;YACvE,sEAAsE;YACtE,IAAI,EAAE,CAAC,aAAa;gBAAE,gCAAgC,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;;gBAC9D,yBAAyB,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAC3C,OAAO,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE;YAClB,GAAG,CAAC,MAAM,CAAC,CAAC;QACd,CAAC;QACD,aAAa,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3E,QAAQ,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE;QAC5B,IAAI,EAAE;YACJ,QAAQ,EAAE,GAAG,EAAE,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACvC,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,oBAAoB,CAAC,EAAE,EAAE,MAAM,CAAC;YACvD,cAAc,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,yBAAyB,CAAC,EAAE,EAAE,MAAM,CAAC;YACjE,qBAAqB,EAAE,CAAC,MAAM,EAAE,EAAE,CAChC,gCAAgC,CAAC,EAAE,EAAE,MAAM,CAAC;SAC/C;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC;YAC5C,OAAO,CAAC,KAAK;gBACX,aAAa,CAAC,KAAK,CAAC,CAAC;gBACrB,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YACnC,CAAC;YACD,OAAO,CAAC,KAAK;gBACX,eAAe,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;gBACpC,IAAI,CAAC;oBACH,EAAE,CAAC,OAAO,CACR,wDAAwD,CACzD,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACf,CAAC;wBAAS,CAAC;oBACT,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC;SACF;QACD,QAAQ,EAAE;YACR,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,4BAA4B,CAAC,EAAE,CAAC,CAAC;YAC3D,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,2BAA2B,CAAC,EAAE,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC;SACjE;QACD,gBAAgB,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CACtE,mCAAmC,CAAC;YAClC,EAAE;YACF,KAAK;YACL,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE;gBACtB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;gBAC5B,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS,EAAE;oBAAE,MAAM,IAAI,0BAA0B,EAAE,CAAC;gBACpE,yBAAyB,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;gBACtC,OAAO,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE;oBAC9B,MAAM,MAAM,GAAG,OAAO,EAAE,CAAC;oBACzB,gCAAgC,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;oBAC7C,OAAO,MAAM,CAAC;gBAChB,CAAC,CAAC,CAAC;YACL,CAAC;SACF,CAAC;QACJ,OAAO,CAAC,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE;YAC5B,MAAM,MAAM,GAAG,QAAQ;gBACrB,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,IAAI,yBAAyB,CAAC;gBACxD,CAAC,CAAC,yBAAyB,CAAC;YAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;YACvC,OAAO;gBACL,KAAK,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC;gBAC5C,MAAM,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,CAC3B,KAAK,CAAC,MAAM,CAAC,MAA4C,EAAE,QAAQ,CAAC;gBACtE,MAAM,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,CAC3B,IAAI,CAAC,GAAG,EAAE,CACR,KAAK,CAAC,MAAM,CACV,MAA4C,EAC5C,QAAQ,CACT,CACF;gBACH,KAAK,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC;gBAC5C,gBAAgB,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,SAAS,CAAC;gBAClE,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE;gBAC9B,6BAA6B,EAAE,GAAG,EAAE,CAClC,KAAK,CAAC,6BAA6B,EAAE;aACxC,CAAC;QACJ,CAAC;QACD,WAAW,EAAE,GAAG,EAAE,CAChB,IAAI,CAAC,GAAG,EAAE;YACR,MAAM,eAAe,GAAG,EAAE;iBACvB,OAAO,CACN;;;;;;wCAM4B,CAC7B;iBACA,GAAG,CAAC,2BAA2B,CAA0B,CAAC;YAC7D,KAAK,MAAM,GAAG,IAAI,eAAe;gBAC/B,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7C,CAAC,CAAC;QACJ,QAAQ,EAAE;YACR,gBAAgB,EAAE,CAAC,OAAO,EAAE,EAAE,CAC5B,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;YAChD,YAAY,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YACrE,qBAAqB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,qBAAqB,EAAE,CAAC;YACzE,uBAAuB,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAC1C,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC9D,qEAAqE;YACrE,0DAA0D;YAC1D,UAAU,EAAE,GAAG,EAAE,CACf,IAAI,CAAC,GAAG,EAAE,CACR,QAAQ,CAAC,UAAU,CACjB,QAAQ,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CACvD,CACF;YACH,kBAAkB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,kBAAkB,EAAE,CAAC;YACnE,qEAAqE;YACrE,uDAAuD;YACvD,oBAAoB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;YACjD,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC,MAAM,CAAC;SACxE;QACD,QAAQ,EAAE;YACR,iBAAiB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC,KAAK,CAAC;YAC/D,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAC7D,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YACnE,eAAe,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC;YAC7D,MAAM,EAAE;gBACN,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAClD,MAAM,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,CACtB,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;gBACjD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC1D,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC1D,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBACpE,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;aAC/D;SACF;QACD,QAAQ,EAAE,GAAG,EAAE,CACb,IAAI,CAAC,GAAG,EAAE,CACR,EAAE;aACC,OAAO,CACN,qGAAqG,CACtG;aACA,GAAG,EAAE,CACT;KACJ,CAAC;IACF,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC/C,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,4FAA4F;QAC5F,kBAAkB,EAAE,GAAW,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;QACtE,8EAA8E;QAC9E,kBAAkB,EAAE,GAAW,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;QACtE,2EAA2E;QAC3E,gBAAgB,EAAE,GAAW,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAClE,mFAAmF;QACnF,mBAAmB,EAAE,CAAC,GAAW,EAAU,EAAE,CAC3C,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;KAC3C,CAAC;AACJ,CAAC"}

package/dist/storage/schema-versions.d.ts

@@ -0,0 +1,5 @@
+import type Database from "better-sqlite3";
+export declare const INDEX_SCHEMA_VERSION = 17;
+/** Read both counters before either opener changes the shared database. */
+export declare function assertSupportedSchemaVersions(db: Database.Database, supportedRecordSchemaVersion: number): number;
+//# sourceMappingURL=schema-versions.d.ts.map

package/dist/storage/schema-versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-versions.d.ts","sourceRoot":"","sources":["../../src/storage/schema-versions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAO3C,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,2EAA2E;AAC3E,wBAAgB,6BAA6B,CAC3C,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,4BAA4B,EAAE,MAAM,GACnC,MAAM,CAwBR"}

package/dist/storage/schema-versions.js

@@ -0,0 +1,26 @@
+// v17 is a compatibility fence for the converged runtime. Slots 15 and 16
+// were also used by the conformance line for other additive columns.
+// Older Desktop builds must refuse this database even when PDPP is disabled:
+// they lack retained-history blob protection and the current MCP ingress policy.
+// The table change remains v15's additive replacement_cursor migration.
+export const INDEX_SCHEMA_VERSION = 17;
+/** Read both counters before either opener changes the shared database. */
+export function assertSupportedSchemaVersions(db, supportedRecordSchemaVersion) {
+    const currentVersion = db.pragma("user_version", { simple: true });
+    if (currentVersion > INDEX_SCHEMA_VERSION) {
+        throw new Error(`Unsupported index.db schema version ${currentVersion}; runtime supports ${INDEX_SCHEMA_VERSION}`);
+    }
+    const hasRecordsVersion = db
+        .prepare("SELECT 1 FROM sqlite_master WHERE type = 'table' AND name = 'pdpp_schema_version'")
+        .get() !== undefined;
+    if (hasRecordsVersion) {
+        const records = db
+            .prepare("SELECT version FROM pdpp_schema_version WHERE id = 1")
+            .get();
+        if (records && records.version > supportedRecordSchemaVersion) {
+            throw new Error(`Unsupported index.db PDPP schema version ${records.version}; runtime supports ${supportedRecordSchemaVersion}`);
+        }
+    }
+    return currentVersion;
+}
+//# sourceMappingURL=schema-versions.js.map

package/dist/storage/schema-versions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-versions.js","sourceRoot":"","sources":["../../src/storage/schema-versions.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,qEAAqE;AACrE,6EAA6E;AAC7E,iFAAiF;AACjF,wEAAwE;AACxE,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEvC,2EAA2E;AAC3E,MAAM,UAAU,6BAA6B,CAC3C,EAAqB,EACrB,4BAAoC;IAEpC,MAAM,cAAc,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAW,CAAC;IAC7E,IAAI,cAAc,GAAG,oBAAoB,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,uCAAuC,cAAc,sBAAsB,oBAAoB,EAAE,CAClG,CAAC;IACJ,CAAC;IACD,MAAM,iBAAiB,GACrB,EAAE;SACC,OAAO,CACN,mFAAmF,CACpF;SACA,GAAG,EAAE,KAAK,SAAS,CAAC;IACzB,IAAI,iBAAiB,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,EAAE;aACf,OAAO,CAAC,sDAAsD,CAAC;aAC/D,GAAG,EAAqC,CAAC;QAC5C,IAAI,OAAO,IAAI,OAAO,CAAC,OAAO,GAAG,4BAA4B,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CACb,4CAA4C,OAAO,CAAC,OAAO,sBAAsB,4BAA4B,EAAE,CAChH,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/dist/storage/strava-method-transition.d.ts

@@ -0,0 +1,18 @@
+import type { DataStoragePort } from "@opendatalabs/personal-server-ts-core/ports";
+import type { LegacyScopeViewPort } from "@opendatalabs/personal-server-ts-core/storage/legacy-scope-view";
+import { type createSqliteRecordStore } from "./pdpp-records-sqlite-store.js";
+/** Runtime contract a host checks before it requests the transition. */
+export declare const STRAVA_BROWSER_TRANSITION_CONTRACT = "strava-browser-transition-v1";
+/**
+ * `none`: no transition. `pending`: no completed browser run is evaluated yet.
+ * `account_mismatch`: a completed run lacks saved ids. `covered`: handed over.
+ */
+export type StravaTransitionStatus = "none" | "pending" | "account_mismatch" | "covered";
+type Store = ReturnType<typeof createSqliteRecordStore>;
+export declare function createStravaMethodTransition(store: Store, base: LegacyScopeViewPort, files: DataStoragePort): {
+    transition: (instance: string, expectedGeneration: number) => Promise<import("./pdpp-records-sqlite-store.js").PdppInstanceBinding>;
+    status: (instance: string) => Promise<StravaTransitionStatus>;
+    view: LegacyScopeViewPort;
+};
+export {};
+//# sourceMappingURL=strava-method-transition.d.ts.map

package/dist/storage/strava-method-transition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strava-method-transition.d.ts","sourceRoot":"","sources":["../../src/storage/strava-method-transition.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AACnF,OAAO,KAAK,EAEV,mBAAmB,EACpB,MAAM,iEAAiE,CAAC;AAEzE,OAAO,EAEL,KAAK,uBAAuB,EAG7B,MAAM,gCAAgC,CAAC;AAmBxC,wEAAwE;AACxE,eAAO,MAAM,kCAAkC,iCACf,CAAC;AASjC;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAChC,MAAM,GAAG,SAAS,GAAG,kBAAkB,GAAG,SAAS,CAAC;AAEtD,KAAK,KAAK,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAwBxD,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,mBAAmB,EACzB,KAAK,EAAE,eAAe;2BA4Bc,MAAM,sBAAsB,MAAM;uBA8FtC,MAAM,KAAG,OAAO,CAAC,sBAAsB,CAAC;;EA8DzE"}

package/dist/storage/strava-method-transition.js

@@ -0,0 +1,209 @@
+import { createHash } from "node:crypto";
+import { PdppBindingError, } from "./pdpp-records-sqlite-store.js";
+/*
+ * Strava export → browser transition.
+ *
+ *   owner POST transition-strava-browser
+ *        │  snapshot readable export bodies, archive rows, bind strava-browser
+ *        ▼
+ *   strava.activities ── saved export body ──┐ until a COMPLETED browser run
+ *                                            │ holds every saved activity id
+ *                                            ▼
+ *                         browser rows (normal legacy view from then on)
+ *   strava.coverage_diagnostics ── saved export body, frozen
+ *
+ * Strava browser records carry no athlete id, so id coverage is the only
+ * evidence that the browser signed in to the same account. A completed run
+ * that misses saved ids keeps the export and reports `account_mismatch`.
+ */
+/** Runtime contract a host checks before it requests the transition. */
+export const STRAVA_BROWSER_TRANSITION_CONTRACT = "strava-browser-transition-v1";
+const ACTIVITIES = "strava.activities";
+const DIAGNOSTICS = "strava.coverage_diagnostics";
+const SCOPES = [ACTIVITIES, DIAGNOSTICS];
+const SOURCE = "https://registry.pdpp.dev/sources/strava";
+const BROWSER_METHOD = "strava-browser";
+const ACTIVITIES_STREAM = "activities";
+function isStravaScope(scope) {
+    return SCOPES.includes(scope);
+}
+function activityIds(data) {
+    const rows = data?.activities;
+    if (!Array.isArray(rows))
+        return null;
+    const ids = new Set();
+    for (const row of rows) {
+        const id = row?.id;
+        if (typeof id !== "string")
+            return null;
+        ids.add(id);
+    }
+    return ids;
+}
+export function createStravaMethodTransition(store, base, files) {
+    /** The export bodies an owner could read before the switch. */
+    async function snapshots(instance) {
+        const saved = {};
+        for (const scope of SCOPES) {
+            const read = await base.readLatest(scope);
+            if (read.kind === "canonical") {
+                saved[scope] = read.envelope;
+                continue;
+            }
+            if (read.kind === "file") {
+                const head = files.findEntry({ scope });
+                if (head)
+                    saved[scope] = await files.readEnvelope(scope, head.collectedAt);
+                continue;
+            }
+            // Diagnostics are informational. Unreadable activities would be lost.
+            if (scope === ACTIVITIES && !store.getInstanceBinding(instance).empty)
+                throw new PdppBindingError("strava_previous_data_not_readable");
+        }
+        // Coverage needs every saved id; without them no run could hand over.
+        const activities = saved[ACTIVITIES];
+        if (activities && activityIds(activities.data) === null)
+            throw new PdppBindingError("strava_previous_data_not_readable");
+        return saved;
+    }
+    async function transition(instance, expectedGeneration) {
+        if (store.stravaTransition(instance))
+            return store.transitionStravaToBrowser({
+                instance,
+                expectedGeneration,
+                expectedWriteClock: 0,
+                snapshots: {},
+            });
+        const clock = store.transitionWriteClock();
+        const heads = SCOPES.map((scope) => JSON.stringify(files.findEntry({ scope })));
+        const saved = await snapshots(instance);
+        return store.readSnapshot(() => {
+            // Legacy files have their own index clock; recheck it with the rows.
+            const moved = SCOPES.some((scope, index) => JSON.stringify(files.findEntry({ scope })) !== heads[index]);
+            if (moved)
+                throw new PdppBindingError("binding_generation_mismatch");
+            return store.transitionStravaToBrowser({
+                instance,
+                expectedGeneration,
+                expectedWriteClock: clock,
+                snapshots: saved,
+            });
+        });
+    }
+    /** The current transition and saved body of `scope`, while still valid. */
+    function saved(scope) {
+        if (!isStravaScope(scope) || base.isReset(scope))
+            return null;
+        const transitions = store.listStravaTransitions();
+        if (transitions.length !== 1)
+            return null;
+        const [current] = transitions;
+        const binding = store.getInstanceBinding(current.instance);
+        if (binding.deletedAt !== null ||
+            binding.method !== BROWSER_METHOD ||
+            binding.generation !== current.generation ||
+            store.listConnections(SOURCE).length !== 1)
+            return null;
+        const envelope = current.snapshots[scope];
+        if (!envelope)
+            return null;
+        const digest = createHash("sha256")
+            .update(JSON.stringify(envelope))
+            .digest("hex");
+        return {
+            transition: current,
+            envelope,
+            revision: `strava-transition:${current.generation}:${digest}`,
+        };
+    }
+    function completedBrowserRun(transition) {
+        return store
+            .listStreamCompletions(transition.instance)
+            .some((receipt) => receipt.stream === ACTIVITIES_STREAM &&
+            receipt.method === BROWSER_METHOD &&
+            receipt.generation === transition.generation);
+    }
+    /**
+     * Judge the browser rows against the saved activities. Only a completed
+     * run counts; a covering one records the handover.
+     */
+    async function evaluate(before) {
+        const current = await base.readLatest(ACTIVITIES);
+        if (before.transition.activitiesCovered)
+            return { status: "covered", current };
+        if (!completedBrowserRun(before.transition) || current.kind !== "canonical")
+            return { status: "pending", current };
+        // Unreadable saved ids fail closed: nothing proves the same account.
+        const savedIds = activityIds(before.envelope.data);
+        const browserIds = activityIds(current.envelope.data);
+        const covers = savedIds !== null &&
+            browserIds !== null &&
+            [...savedIds].every((id) => browserIds.has(id));
+        if (!covers)
+            return { status: "account_mismatch", current };
+        store.confirmStravaTransition(before.transition.instance, before.transition.generation);
+        return { status: "covered", current };
+    }
+    async function status(instance) {
+        const before = saved(ACTIVITIES);
+        if (before?.transition.instance === instance)
+            return (await evaluate(before)).status;
+        const transition = store.stravaTransition(instance);
+        return transition?.activitiesCovered ? "covered" : "none";
+    }
+    function savedBody(before) {
+        return {
+            kind: "canonical",
+            envelope: before.envelope,
+            revision: before.revision,
+        };
+    }
+    /** Listed as the saved body until browser rows have taken over. */
+    function listedSaved(scope) {
+        const before = saved(scope);
+        if (!before)
+            return null;
+        if (scope === ACTIVITIES && before.transition.activitiesCovered)
+            return null;
+        return before;
+    }
+    const view = {
+        ...base,
+        async readLatest(scope) {
+            const before = saved(scope);
+            if (!before)
+                return base.readLatest(scope);
+            // Diagnostics stay frozen at the export's last body.
+            if (scope === DIAGNOSTICS)
+                return savedBody(before);
+            const { status: verdict, current } = await evaluate(before);
+            // A reset, deletion or replacement during the read invalidates it.
+            if (saved(scope)?.revision !== before.revision)
+                return base.readLatest(scope);
+            return verdict === "covered" ? current : savedBody(before);
+        },
+        listingFor(scope) {
+            const before = listedSaved(scope);
+            return before
+                ? { kind: "canonical", collectedAt: before.envelope.collectedAt }
+                : base.listingFor(scope);
+        },
+        listCanonicalScopes(prefix) {
+            const listed = new Map(base.listCanonicalScopes(prefix).map((item) => [item.scope, item]));
+            for (const scope of SCOPES) {
+                const before = listedSaved(scope);
+                if (!before || (prefix && !scope.startsWith(prefix)))
+                    continue;
+                listed.set(scope, { scope, collectedAt: before.envelope.collectedAt });
+            }
+            return [...listed.values()];
+        },
+        resetTakeover(scope) {
+            base.resetTakeover(scope);
+            store.clearStravaTransitionScope(scope);
+        },
+        ownsScope: (scope) => saved(scope) !== null || base.ownsScope(scope),
+    };
+    return { transition, status, view };
+}
+//# sourceMappingURL=strava-method-transition.js.map

package/dist/storage/strava-method-transition.js.map

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