@minnowdb/core 0.6.1 → 0.6.3

package/dist/storage/toolkit/record-core.js

@@ -1,6 +1,37 @@
 import { CompactionBacklogError, CompactionJobConflictError, assertCompactionOutputProvenance, compactionOutputSegmentIds, createManifest, createGarbageCollectionJobRecord, advanceGarbageCollectionJobRecord, collectFtsCandidates, collectFtsPostingsBounded, activePostingStorageColumnIds, invalidateUncoveredFtsColumns, invalidateUncoveredSecondaryIndexes, GarbageCollectionJobConflictError, LeaseConflictError, LeaseExpiredError, LeaseOwnerConflictError, MAX_LEASE_TTL_MS, MAX_ACTIVE_LEASES, MAX_ACTIVE_TEMP_OWNERS, MAX_ACTIVE_COMPACTION_JOBS, MAX_ACTIVE_UNIQUE_KEY_BUILDS, MAX_ACTIVE_TRANSACTIONS, MAX_TERMINAL_TRANSACTION_RECORDS, MAX_TERMINAL_COMPACTION_JOB_RECORDS, MAX_COMPLETED_GARBAGE_COLLECTION_JOB_RECORDS, MAX_PINNED_MANIFEST_VERSION_LAG, MAX_PINNED_RETIRED_BLOCKS, MAX_PINNED_RETIRED_BYTES, MAX_RETIRED_HISTORY_BYTES, MAX_GLOBAL_STAGED_ARTIFACT_BYTES, MAX_GLOBAL_STAGED_BLOCKS, MAX_GLOBAL_STAGED_SEGMENTS, MAX_TEMP_OWNER_TTL_MS, MAX_ROW_ID, MAX_ROW_ID_EXCLUSIVE_END, MAX_AUTO_INCREMENT_EXCLUSIVE_END, MAX_LEVEL_ZERO_SEGMENTS, MAX_MANIFEST_BLOCK_PRESENCE_IDS, MAX_STORAGE_ID_CHARACTERS, MAX_CATALOG_RECORDS, MAX_CATALOG_RETAINED_BYTES, MAX_MANIFEST_RECORDS, MAX_MANIFEST_RETAINED_BYTES, MAX_SEGMENT_RECORDS, MAX_SEGMENT_RETAINED_BYTES, MAX_FTS_CANDIDATE_ROW_IDS, MAX_FTS_POSTINGS_PER_CHUNK, MAX_FTS_POSTING_ROW_IDS_PER_CHUNK, MAX_FTS_POSTING_TERM_CHARACTERS, MAX_FTS_TOKENS_PER_DOCUMENT, MAX_FTS_BASE_CHUNKS, MAX_FTS_DELTA_CHUNKS, SnapshotManifestMissingError, StorageResourceLimitError, TableInUseError, TableRecordConflictError, TempOwnerConflictError, TransactionRecordConflictError, UniqueKeyConflictError, UniqueKeyBuildConflictError, UniqueIndexCoverageError, assertTransactionArtifactBatchLimits, assertTransactionArtifactJournalLimits, assertTempRunPageBatchLimits, assertStorageBulkReadItems, boundedMaintenanceBatchItems, normalizeCompactionJobRecord, normalizeGarbageCollectionJobRecord, normalizeSegmentRecord, updateCompactionJobRecord, updateTransactionRecord, updateGarbageCollectionPlanningRecord, validateTableColumns, validateTableForeignKey, validateSecondaryIndexes, secondaryIndexColumnIds, secondaryIndexWriteContractChanged, secondaryUniqueKeyNamespace, transactionCommitDeltaRetainedBytes, uniqueKeyBuildChunkRetainedBytes, MAX_UNIQUE_KEY_BUILD_TTL_MS, MAX_UNIQUE_KEY_BUILD_STAGED_BYTES, MAX_UNIQUE_KEY_BUILD_STAGED_BYTES_TOTAL, MAX_UNIQUE_KEY_BUILD_TOKENS_PER_CHUNK, validateFtsPostingQueries, validateCanonicalManifestChangedTableIds, catalogRecordRetainedBytes, manifestRecordRetainedReservationBytes, segmentRecordRetainedBytes, snapshotAcceleratorItemRetainedUsage, assertSnapshotImportAcceleratorUsage, SchemaConflictError, WriteConflictError, } from "../types.js";
 import { dateIsoString } from "../../date-value.js";
 import { assertWellFormedString, crc32, MAX_STORED_BLOCK_BYTE_LENGTH, } from "../../block-format/index.js";
+/**
+ * A deep copy for the plain record shapes this core stores — objects, arrays, and primitives,
+ * bigint included. Every read and every job advance copies a record across this boundary, and
+ * `structuredClone` was a sixth of a settle phase's CPU; a value outside the plain shape
+ * (a typed array, a Date, a Map) falls back to `structuredClone` for that value, so the copy
+ * stays exact whatever the record carries.
+ */
+function cloneRecord(value) {
+    return cloneRecordValue(value);
+}
+function cloneRecordValue(value) {
+    if (typeof value !== "object" || value === null) {
+        // Preserve structuredClone's rejection of uncloneable leaves instead of silently sharing.
+        return typeof value === "function" ? structuredClone(value) : value;
+    }
+    if (Array.isArray(value)) {
+        const copy = new Array(value.length);
+        for (let index = 0; index < value.length; index += 1) {
+            copy[index] = cloneRecordValue(value[index]);
+        }
+        return copy;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype !== Object.prototype && prototype !== null)
+        return structuredClone(value);
+    const copy = {};
+    for (const key of Object.keys(value)) {
+        copy[key] = cloneRecordValue(value[key]);
+    }
+    return copy;
+}
 const postingTextEncoder = new TextEncoder();
 const RESOURCE_EXPIRY_SWEEP_ITEMS = 64;
 /** Leaves ample canonical-wire overhead below the 4 MiB metadata frame ceiling. */
@@ -1153,12 +1184,12 @@ export class RecordCore {
         if (this.#tempOwners.size >= MAX_ACTIVE_TEMP_OWNERS) {
             throw new StorageResourceLimitError("temp owner", this.#tempOwners.size + 1, MAX_ACTIVE_TEMP_OWNERS);
         }
-        this.#tempOwners.set(record.ownerId, structuredClone(record));
+        this.#tempOwners.set(record.ownerId, cloneRecord(record));
     }
     getTempOwner(ownerId) {
         validateId(ownerId);
         const record = this.#tempOwners.get(ownerId);
-        return record === undefined ? undefined : structuredClone(record);
+        return record === undefined ? undefined : cloneRecord(record);
     }
     renewTempOwner(input) {
         validateId(input.ownerId);
@@ -1176,7 +1207,7 @@ export class RecordCore {
             revision: safeWholeIncrement(record.revision, "Temp owner revision"),
         };
         this.#tempOwners.set(input.ownerId, renewed);
-        return structuredClone(renewed);
+        return cloneRecord(renewed);
     }
     listExpiredTempOwnerPage(expiresAtCutoff, afterCursor, limit) {
         const page = boundedExpiryPage(this.#tempOwners, expiresAtCutoff, afterCursor, limit, (record) => record.ownerId, "Temp owner page");
@@ -1278,7 +1309,7 @@ export class RecordCore {
     }
     /** Applies a table whose complete admission checks already passed. */
     #installTableRecord(record) {
-        this.#setTable(structuredClone(record));
+        this.#setTable(cloneRecord(record));
         this.#tableIdsByName.set(record.name, record.id);
         if (record.uniqueKeyColumnId !== undefined)
             this.#uniqueKeys.set(record.id, new OrderedStringSet());
@@ -1305,7 +1336,7 @@ export class RecordCore {
     }
     getTable(id) {
         const record = this.#tables.get(id);
-        return record === undefined ? undefined : structuredClone(record);
+        return record === undefined ? undefined : cloneRecord(record);
     }
     updateTable(id, expectedRevision, update) {
         const record = this.#tables.get(id);
@@ -1368,18 +1399,16 @@ export class RecordCore {
         validateTableView(nextView ?? undefined);
         const updated = {
             ...base,
-            columns: update.columns === undefined ? record.columns : structuredClone(update.columns),
-            ...(nextFts === null || nextFts === undefined
-                ? {}
-                : { ftsColumns: structuredClone(nextFts) }),
+            columns: update.columns === undefined ? record.columns : cloneRecord(update.columns),
+            ...(nextFts === null || nextFts === undefined ? {} : { ftsColumns: cloneRecord(nextFts) }),
             ...(nextSecondary === null || nextSecondary === undefined
                 ? {}
-                : { secondaryIndexes: structuredClone(nextSecondary) }),
+                : { secondaryIndexes: cloneRecord(nextSecondary) }),
             ...(nextTriggers === null || nextTriggers === undefined
                 ? {}
-                : { triggers: structuredClone(nextTriggers) }),
-            ...(nextForeignKeys === undefined ? {} : { foreignKeys: structuredClone(nextForeignKeys) }),
-            ...(nextView === null || nextView === undefined ? {} : { view: structuredClone(nextView) }),
+                : { triggers: cloneRecord(nextTriggers) }),
+            ...(nextForeignKeys === undefined ? {} : { foreignKeys: cloneRecord(nextForeignKeys) }),
+            ...(nextView === null || nextView === undefined ? {} : { view: cloneRecord(nextView) }),
             revision: safeWholeIncrement(expectedRevision, "Table revision"),
         };
         validateSecondaryIndexes(updated);
@@ -1440,7 +1469,7 @@ export class RecordCore {
         this.#setTable(updated);
         this.#catalogEpoch = nextCatalogEpoch;
         this.#schemaEpoch = nextSchemaEpoch;
-        return structuredClone(updated);
+        return cloneRecord(updated);
     }
     removeTable(id, expectedRevision, options = {}) {
         const record = this.#tables.get(id);
@@ -1526,7 +1555,7 @@ export class RecordCore {
         this.#deleteTableRecords(table);
         this.#catalogEpoch = nextCatalogEpoch;
         this.#schemaEpoch = nextSchemaEpoch;
-        return structuredClone(manifest);
+        return cloneRecord(manifest);
     }
     dropTableColumn(input) {
         validateId(input.tableId);
@@ -1603,7 +1632,7 @@ export class RecordCore {
         this.#deleteFtsColumn(input.tableId, input.columnId);
         this.#catalogEpoch = nextCatalogEpoch;
         this.#schemaEpoch = nextSchemaEpoch;
-        return structuredClone(manifest);
+        return cloneRecord(manifest);
     }
     #assertTableNotInUse(id) {
         const target = this.#tables.get(id);
@@ -1675,7 +1704,7 @@ export class RecordCore {
         }
         validateFtsBaseInput(input, "Full-text base");
         const key = `${tableId}/${columnId}`;
-        this.#ftsBases.set(key, structuredClone(input));
+        this.#ftsBases.set(key, cloneRecord(input));
         const deltas = this.#ftsDeltas.get(key);
         if (deltas !== undefined) {
             for (const version of [...deltas.keys()]) {
@@ -1777,7 +1806,7 @@ export class RecordCore {
                 continue;
             }
             deltas.set(version, {
-                postings: structuredClone(column.postings),
+                postings: cloneRecord(column.postings),
                 totalTokens: column.totalTokens,
             });
             this.#ftsDeltas.set(key, deltas);
@@ -1798,7 +1827,7 @@ export class RecordCore {
                 continue;
             deltaChunkCount += 1;
             deltaTokens += delta.totalTokens;
-            chunkLists.push(structuredClone(delta.postings));
+            chunkLists.push(cloneRecord(delta.postings));
         }
         return { chunkLists, deltaChunkCount, deltaTokens };
     }
@@ -1940,7 +1969,7 @@ export class RecordCore {
             this.#manifestBlocks.delete(id);
         for (const id of reclaimedTransactionIds)
             this.#transactions.delete(id);
-        this.#garbageCollectionJobs.set(updated.id, structuredClone(updated));
+        this.#garbageCollectionJobs.set(updated.id, cloneRecord(updated));
     }
     getTableByName(name) {
         const id = this.#tableIdsByName.get(name);
@@ -1953,7 +1982,7 @@ export class RecordCore {
     listTables() {
         return [...this.#tables.values()]
             .sort((left, right) => left.name.localeCompare(right.name))
-            .map((record) => structuredClone(record));
+            .map((record) => cloneRecord(record));
     }
     getSegment(id) {
         const record = this.#segments.get(id);
@@ -2138,7 +2167,7 @@ export class RecordCore {
         this.#replaceSegments([desired, ...rebasedOldOwnerSegments]);
         this.#setTransaction(updatedOldOwner);
         this.#setTransaction(updatedReplacement);
-        return structuredClone(updatedReplacement);
+        return cloneRecord(updatedReplacement);
     }
     reserveRowIds(tableId, count) {
         validateId(tableId);
@@ -2253,7 +2282,7 @@ export class RecordCore {
                 updatedAt: input.createdAt,
             };
             if (deepRecordEqual(current.record, expected))
-                return structuredClone(current.record);
+                return cloneRecord(current.record);
             throw new UniqueKeyBuildConflictError(input.buildId, "another live owner exists");
         }
         if (current?.record.state === "completed") {
@@ -2282,12 +2311,12 @@ export class RecordCore {
             updatedAt: input.createdAt,
         };
         this.#setUniqueKeyBuild({ record, chunks: [], tokens: new Set(), completedInput: null }, input.buildId);
-        return structuredClone(record);
+        return cloneRecord(record);
     }
     getUniqueKeyBuild(buildId) {
         validateId(buildId);
         const state = this.#uniqueKeyBuilds.get(buildId);
-        return state === undefined ? undefined : structuredClone(state.record);
+        return state === undefined ? undefined : cloneRecord(state.record);
     }
     renewUniqueKeyBuild(input) {
         validateId(input.buildId);
@@ -2301,13 +2330,13 @@ export class RecordCore {
             throw new UniqueKeyBuildConflictError(input.buildId, "ownership expired or changed");
         }
         if (input.expiresAt <= state.record.expiresAt)
-            return structuredClone(state.record);
+            return cloneRecord(state.record);
         const next = {
             ...state,
             record: { ...state.record, expiresAt: input.expiresAt, updatedAt: input.updatedAt },
         };
         this.#setUniqueKeyBuild(next, input.buildId);
-        return structuredClone(next.record);
+        return cloneRecord(next.record);
     }
     appendUniqueKeyBuildChunk(input) {
         validateId(input.buildId);
@@ -2326,7 +2355,7 @@ export class RecordCore {
         }
         if (input.ordinal < state.record.nextOrdinal) {
             if (deepRecordEqual(state.chunks[input.ordinal], input.keyTokens)) {
-                return structuredClone(state.record);
+                return cloneRecord(state.record);
             }
             throw new UniqueKeyBuildConflictError(input.buildId, "chunk replay changed");
         }
@@ -2357,7 +2386,7 @@ export class RecordCore {
             completedInput: null,
         };
         this.#setUniqueKeyBuild(next, input.buildId);
-        return structuredClone(next.record);
+        return cloneRecord(next.record);
     }
     finishUniqueKeyBuild(input) {
         validateId(input.buildId);
@@ -2372,7 +2401,7 @@ export class RecordCore {
             const table = this.#tables.get(state.record.tableId);
             if (table === undefined)
                 throw new UniqueKeyBuildConflictError(input.buildId, "table was removed");
-            return structuredClone(table);
+            return cloneRecord(table);
         }
         if (state?.record.state !== "active" ||
             state.record.ownerId !== input.ownerId ||
@@ -2421,11 +2450,11 @@ export class RecordCore {
             record: completedRecord,
             chunks: [],
             tokens: state.tokens,
-            completedInput: structuredClone(input),
+            completedInput: cloneRecord(input),
         }, input.buildId);
         this.#catalogEpoch = nextCatalogEpoch;
         this.#schemaEpoch = nextSchemaEpoch;
-        return structuredClone(updated);
+        return cloneRecord(updated);
     }
     abortUniqueKeyBuild(input) {
         validateId(input.buildId);
@@ -2550,15 +2579,15 @@ export class RecordCore {
     }
     getCurrentManifest() {
         const manifest = this.#currentVersion === null ? undefined : this.#manifests.get(this.#currentVersion);
-        return manifest === undefined ? undefined : structuredClone(manifest);
+        return manifest === undefined ? undefined : cloneRecord(manifest);
     }
     getManifest(version) {
         const manifest = this.#manifests.get(version);
-        return manifest === undefined ? undefined : structuredClone(manifest);
+        return manifest === undefined ? undefined : cloneRecord(manifest);
     }
     listManifestPage(afterVersion, limit) {
         validatePageLimit(limit);
-        const records = boundedRecordPage(this.#manifests, afterVersion, limit).map((manifest) => structuredClone(manifest));
+        const records = boundedRecordPage(this.#manifests, afterVersion, limit).map((manifest) => cloneRecord(manifest));
         return {
             records,
             nextCursor: records.length === limit ? (records.at(-1)?.version ?? null) : null,
@@ -2621,13 +2650,13 @@ export class RecordCore {
             this.#assertTableForeignKeys(pending.record);
         }
         const record = {
-            ...structuredClone(input.record),
+            ...cloneRecord(input.record),
             snapshotVersion: this.#currentVersion,
             schemaEpochGuard: this.#schemaEpoch,
             ...(pending === undefined
                 ? {}
                 : {
-                    pendingTable: structuredClone(pending.record),
+                    pendingTable: cloneRecord(pending.record),
                     pendingTableNextRowId: pending.nextRowId,
                     catalogEpochGuard: pending.expectedCatalogEpoch,
                 }),
@@ -2680,14 +2709,14 @@ export class RecordCore {
             this.#nextAutoIncrement.set(autoCounterKey, autoIncrementValues.endExclusive);
         }
         return {
-            record: structuredClone(record),
+            record: cloneRecord(record),
             ...(rowIds === undefined ? {} : { rowIds }),
             ...(autoIncrementValues === undefined ? {} : { autoIncrementValues }),
         };
     }
     createTransaction(record) {
         const normalized = {
-            ...structuredClone(record),
+            ...cloneRecord(record),
             ...(record.status === "active" && record.schemaEpochGuard === undefined
                 ? { schemaEpochGuard: this.#schemaEpoch }
                 : {}),
@@ -2728,7 +2757,7 @@ export class RecordCore {
     }
     getTransaction(id) {
         const record = this.#transactions.get(id);
-        return record === undefined ? undefined : structuredClone(record);
+        return record === undefined ? undefined : cloneRecord(record);
     }
     getTransactions(ids) {
         assertStorageBulkReadItems(ids, "Transaction read");
@@ -2736,12 +2765,12 @@ export class RecordCore {
             validateId(id);
         return ids.map((id) => {
             const record = this.#transactions.get(id);
-            return record === undefined ? undefined : structuredClone(record);
+            return record === undefined ? undefined : cloneRecord(record);
         });
     }
     listTransactionPage(afterId, limit) {
         validatePageLimit(limit);
-        const records = boundedRecordPage(this.#transactions, afterId, limit).map((record) => structuredClone(record));
+        const records = boundedRecordPage(this.#transactions, afterId, limit).map((record) => cloneRecord(record));
         return { records, nextCursor: records.length === limit ? (records.at(-1)?.id ?? null) : null };
     }
     updateTransaction(id, expectedRevision, update) {
@@ -2756,7 +2785,7 @@ export class RecordCore {
         }
         this.#assertPendingArtifactsAvailable(updated, update.pendingBlockIds !== undefined, update.pendingSegmentIds !== undefined);
         this.#setTransaction(updated);
-        return structuredClone(updated);
+        return cloneRecord(updated);
     }
     renewTransaction(input) {
         validateId(input.transactionId);
@@ -2790,7 +2819,7 @@ export class RecordCore {
             updatedAt: input.updatedAt,
         });
         this.#setTransaction(updated);
-        return structuredClone(updated);
+        return cloneRecord(updated);
     }
     /**
      * Validates and applies the record half of staging: the journal update and the segment
@@ -2806,7 +2835,7 @@ export class RecordCore {
         this.#assertTransactionResourceTransition(plan.updated, blockByteLengths);
         this.#replaceSegments(plan.segments);
         this.#setTransaction(plan.updated, blockByteLengths);
-        return structuredClone(plan.updated);
+        return cloneRecord(plan.updated);
     }
     /**
      * Runs the complete staging preflight without changing record state. Persistent adapters use
@@ -2991,7 +3020,7 @@ export class RecordCore {
         const updated = updateTransactionRecord(current, update);
         this.#replaceSegments([], input.removeSegmentIds);
         this.#setTransaction(updated);
-        return structuredClone(updated);
+        return cloneRecord(updated);
     }
     #validateStagedSegment(segment, transactionId, journalBlockIds) {
         if (segment.transactionId !== transactionId) {
@@ -3085,7 +3114,7 @@ export class RecordCore {
                 throw new WriteConflictError(input.expectedManifestVersion, this.#currentVersion);
             }
             base = {
-                ...structuredClone(input.transaction.record),
+                ...cloneRecord(input.transaction.record),
                 snapshotVersion: input.expectedManifestVersion,
             };
             validateTransactionRuntimeRecord(base, "Transaction");
@@ -3532,7 +3561,7 @@ export class RecordCore {
             columnId: column.columnId,
             count: this.#ftsDeltas.get(`${changes.tableId}/${column.columnId}`)?.size ?? 0,
         })));
-        return structuredClone({
+        return cloneRecord({
             ...manifest,
             ...(ftsDeltaCounts.length === 0 ? {} : { ftsDeltaCounts }),
         });
@@ -3549,21 +3578,21 @@ export class RecordCore {
         if (this.#leases.size >= MAX_ACTIVE_LEASES) {
             throw new StorageResourceLimitError("lease", this.#leases.size + 1, MAX_ACTIVE_LEASES);
         }
-        this.#leases.set(record.id, structuredClone(record));
+        this.#leases.set(record.id, cloneRecord(record));
     }
     getLease(id) {
         const record = this.#leases.get(id);
-        return record === undefined ? undefined : structuredClone(record);
+        return record === undefined ? undefined : cloneRecord(record);
     }
     listLeases() {
         return [...this.#leases.values()]
             .sort((left, right) => left.id.localeCompare(right.id))
-            .map((record) => structuredClone(record));
+            .map((record) => cloneRecord(record));
     }
     listExpiredLeasePage(expiresAtCutoff, afterCursor, limit) {
         const page = boundedExpiryPage(this.#leases, expiresAtCutoff, afterCursor, limit, (record) => record.id, "Lease page");
         return {
-            records: page.records.map((record) => structuredClone(record)),
+            records: page.records.map((record) => cloneRecord(record)),
             nextCursor: page.nextCursor,
         };
     }
@@ -3583,7 +3612,7 @@ export class RecordCore {
             revision: safeWholeIncrement(record.revision, "Lease revision"),
         };
         this.#leases.set(input.id, renewed);
-        return structuredClone(renewed);
+        return cloneRecord(renewed);
     }
     moveLease(input) {
         const cutoff = validateBoundedExpiration(input.expiresAtCutoff, input.expiresAt, "Lease", MAX_LEASE_TTL_MS);
@@ -3603,7 +3632,7 @@ export class RecordCore {
             revision: safeWholeIncrement(record.revision, "Lease revision"),
         };
         this.#leases.set(input.id, moved);
-        return structuredClone(moved);
+        return cloneRecord(moved);
     }
     removeLeaseIfExpired(id, expectedRevision, expiresAtCutoff) {
         const cutoff = Date.parse(expiresAtCutoff);
@@ -3654,17 +3683,17 @@ export class RecordCore {
     }
     getCompactionJob(id) {
         const record = this.#compactionJobs.get(id);
-        return record === undefined ? undefined : structuredClone(record);
+        return record === undefined ? undefined : cloneRecord(record);
     }
     listCompactionJobs(tableId) {
         return [...this.#compactionJobs.values()]
             .filter((record) => tableId === undefined || record.tableId === tableId)
             .sort((left, right) => left.createdAt.localeCompare(right.createdAt) || left.id.localeCompare(right.id))
-            .map((record) => structuredClone(record));
+            .map((record) => cloneRecord(record));
     }
     listCompactionJobPage(afterId, limit) {
         validatePageLimit(limit);
-        const records = boundedRecordPage(this.#compactionJobs, afterId, limit).map((record) => structuredClone(record));
+        const records = boundedRecordPage(this.#compactionJobs, afterId, limit).map((record) => cloneRecord(record));
         return { records, nextCursor: records.length === limit ? (records.at(-1)?.id ?? null) : null };
     }
     updateCompactionJob(id, expectedRevision, update) {
@@ -3679,7 +3708,7 @@ export class RecordCore {
         this.#assertCompactionJobReferences(updated);
         this.#assertTerminalCompactionJobTransition(current, updated);
         this.#compactionJobs.set(id, updated);
-        return structuredClone(updated);
+        return cloneRecord(updated);
     }
     #assertCompactionJobReferences(job) {
         // Cancelled/aborted jobs are retained diagnostics rather than live physical roots.
@@ -3746,7 +3775,7 @@ export class RecordCore {
             throw new CompactionJobConflictError(id, expectedRevision, current?.revision ?? null);
         }
         if (isTerminalCompactionJob(current)) {
-            return structuredClone(current);
+            return cloneRecord(current);
         }
         const transaction = current.transactionId === null ? undefined : this.#transactions.get(current.transactionId);
         if (transaction?.status === "committed") {
@@ -3761,7 +3790,7 @@ export class RecordCore {
             });
             this.#assertTerminalCompactionJobTransition(current, published);
             this.#compactionJobs.set(id, published);
-            return structuredClone(published);
+            return cloneRecord(published);
         }
         const cancelled = updateCompactionJobRecord(current, {
             state: "cancelled",
@@ -3780,7 +3809,7 @@ export class RecordCore {
             this.#setTransaction(abortedTransaction);
         }
         this.#compactionJobs.set(id, cancelled);
-        return structuredClone(cancelled);
+        return cloneRecord(cancelled);
     }
     removeCompactionJob(id) {
         if (!this.canRemoveCompactionJob(id))
@@ -3850,7 +3879,7 @@ export class RecordCore {
         assertGarbageCollectionCandidateProvenance(record, this.#manifests, this.#manifestBlocks, this.#segments, this.#transactions, this.#roots);
         this.#pruneOneCompletedGarbageCollectionJob();
         this.#garbageCollectionJobs.set(record.id, record);
-        return structuredClone(record);
+        return cloneRecord(record);
     }
     updateGarbageCollectionPlanning(input) {
         const current = this.#garbageCollectionJobs.get(input.jobId);
@@ -3860,20 +3889,20 @@ export class RecordCore {
         const updated = updateGarbageCollectionPlanningRecord(current, input);
         assertGarbageCollectionCandidateProvenance(updated, this.#manifests, this.#manifestBlocks, this.#segments, this.#transactions, this.#roots);
         this.#garbageCollectionJobs.set(updated.id, updated);
-        return structuredClone(updated);
+        return cloneRecord(updated);
     }
     getGarbageCollectionJob(id) {
         const record = this.#garbageCollectionJobs.get(id);
-        return record === undefined ? undefined : structuredClone(record);
+        return record === undefined ? undefined : cloneRecord(record);
     }
     listGarbageCollectionJobs() {
         return [...this.#garbageCollectionJobs.values()]
             .sort((left, right) => left.createdAt.localeCompare(right.createdAt) || left.id.localeCompare(right.id))
-            .map((record) => structuredClone(record));
+            .map((record) => cloneRecord(record));
     }
     listGarbageCollectionJobPage(afterId, limit) {
         validatePageLimit(limit);
-        const records = boundedRecordPage(this.#garbageCollectionJobs, afterId, limit).map((record) => structuredClone(record));
+        const records = boundedRecordPage(this.#garbageCollectionJobs, afterId, limit).map((record) => cloneRecord(record));
         return { records, nextCursor: records.length === limit ? (records.at(-1)?.id ?? null) : null };
     }
     /**
@@ -4048,7 +4077,7 @@ export class RecordCore {
         reclaimedTransactionIds.forEach((id) => this.#transactions.delete(id));
         this.#garbageCollectionJobs.set(updated.id, updated);
         return {
-            job: structuredClone(updated),
+            job: cloneRecord(updated),
             prunedManifestVersions,
             alreadyPrunedManifestVersions,
             retainedManifestVersions,
@@ -4095,7 +4124,7 @@ export class RecordCore {
             });
             yield {
                 kind: "table",
-                record: structuredClone(table),
+                record: cloneRecord(table),
                 nextRowId: this.#nextRowIds.get(table.id) ?? 1n,
                 autoIncrement,
             };
@@ -4133,7 +4162,7 @@ export class RecordCore {
             yield {
                 kind: "transaction",
                 record: {
-                    ...structuredClone(record),
+                    ...cloneRecord(record),
                     pendingBlockIds: [],
                     pendingSegmentIds: [],
                 },
@@ -4305,7 +4334,7 @@ export class RecordCore {
         const manifest = this.#manifests.get(version);
         if (manifest === undefined)
             throw new SnapshotManifestMissingError(version);
-        return structuredClone(manifest);
+        return cloneRecord(manifest);
     }
     /** O(1) counters for diagnostics; callers never need to clone the full durable state. */
     storageRecordStats() {
@@ -4404,7 +4433,7 @@ export class RecordCore {
                         throw new Error("Snapshot tables are not in canonical ID order");
                     }
                     previousTableId = item.record.id;
-                    const record = structuredClone(item.record);
+                    const record = cloneRecord(item.record);
                     validateTableRuntimeRecord(record, `Snapshot table ${item.record.id}`);
                     if (trial.#tables.has(record.id) || trial.#tableIdsByName.has(record.name)) {
                         throw new Error(`Snapshot repeats a table identity: ${record.id}`);
@@ -4448,7 +4477,7 @@ export class RecordCore {
                     if (record.status !== "committed" || record.committedVersion === null) {
                         throw new Error(`Snapshot transaction is not committed: ${record.id}`);
                     }
-                    trial.#setTransaction(structuredClone(record));
+                    trial.#setTransaction(cloneRecord(record));
                     break;
                 }
                 case "unique-generation": {
@@ -4510,7 +4539,7 @@ export class RecordCore {
                         throw new Error(`Snapshot posting chunk is out of order: ${item.storageColumnId}`);
                     }
                     retainAcceleratorChunk(item);
-                    const chunk = structuredClone(item.postings);
+                    const chunk = cloneRecord(item.postings);
                     if (posting.previousTerm !== undefined &&
                         chunk[0] !== undefined &&
                         chunk[0].term <= posting.previousTerm) {
@@ -4671,7 +4700,7 @@ export class RecordCore {
     }
     /** Replaces the whole record state with a dump's content. */
     load(state) {
-        const cloned = structuredClone(state);
+        const cloned = cloneRecord(state);
         validateRecordCoreState(cloned, this.#physical);
         // A recovery candidate may intentionally discard an unpublished WAL suffix whose physical
         // blocks were already reclaimed. Clearing the old candidate state must therefore not need
@@ -6414,7 +6443,7 @@ export function validateTempRunPageIdentity(ownerId, runId, pageIndex) {
 }
 function emptyGarbageCollectionStep(job) {
     return {
-        job: structuredClone(job),
+        job: cloneRecord(job),
         prunedManifestVersions: [],
         alreadyPrunedManifestVersions: [],
         retainedManifestVersions: [],