The store reader and the inspector share one header and record-slot rule; an unknown cultcache.store.* header no longer falls through to the legacy envelope decoder. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
33 lines
1.3 KiB
TypeScript
33 lines
1.3 KiB
TypeScript
export const STORE_FORMAT_VERSION = "cultcache.store.v1";
|
|
|
|
const STORE_FORMAT_PREFIX = "cultcache.store.";
|
|
const PERSISTED_RECORD_SLOTS = 4;
|
|
|
|
/**
|
|
* True for a v1 snapshot, false for anything that is not a CultCache store header (the legacy
|
|
* envelope array). Any other `cultcache.store.*` header is refused by name.
|
|
*/
|
|
export function isV1Snapshot(decoded: unknown): decoded is unknown[] {
|
|
if (!Array.isArray(decoded) || typeof decoded[0] !== "string" || !decoded[0].startsWith(STORE_FORMAT_PREFIX)) {
|
|
return false;
|
|
}
|
|
|
|
if (decoded[0] !== STORE_FORMAT_VERSION) {
|
|
throw new Error(
|
|
`CultCache store format "${decoded[0]}" is not readable; this runtime reads "${STORE_FORMAT_VERSION}" only. ` +
|
|
"The store needs a runtime that resolves document variants.",
|
|
);
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/** Refuses a persisted record with more slots than v1 defines, naming its key and schema id. */
|
|
export function requireV1RecordSlots(record: unknown[]): void {
|
|
if (record.length > PERSISTED_RECORD_SLOTS) {
|
|
throw new Error(
|
|
`CultCache record "${String(record[0])}" (schema "${String(record[1])}") has ${record.length} slots; ` +
|
|
`this runtime reads ${PERSISTED_RECORD_SLOTS}. The store needs a runtime that resolves document variants.`,
|
|
);
|
|
}
|
|
}
|