@growth-labs/cms 0.2.0 → 0.3.1

package/dist/engine/reader-state.js

@@ -0,0 +1,493 @@
+export const READER_AUTOMATIC_COMPLETION_BPS = 9_000;
+export const DEFAULT_READER_STATE_BATCH_SIZE = 50;
+export const MAX_READER_STATE_BATCH_SIZE = 100;
+const UUIDV4_PATTERN = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$/;
+const ULID_PATTERN = /^[0-9A-HJKMNP-TV-Z]{26}$/;
+const SITE_ID_PATTERN = /^[a-z][a-z0-9_-]{1,63}$/;
+const CONTENT_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._:@/-]{0,127}$/;
+const MUTATION_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._:@/-]{0,127}$/;
+const PREFERENCE_KEY_PATTERN = /^[A-Za-z][A-Za-z0-9._:-]{0,63}$/;
+const CONTENT_TYPES = new Set(['article', 'video', 'podcast', 'newsletter', 'page']);
+const MAX_PREFERENCE_KEYS = 50;
+const MAX_PREFERENCES_JSON_BYTES = 8_192;
+const MAX_EVENT_FUTURE_SKEW_MS = 5 * 60 * 1_000;
+export class ReaderStateInputError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ReaderStateInputError';
+    }
+}
+export class ReaderStateConflictError extends Error {
+    expectedVersion;
+    actualVersion;
+    constructor(expectedVersion, actualVersion) {
+        super(`@growth-labs/cms reader state version conflict: expected ${expectedVersion}, actual ${actualVersion ?? 'missing'}`);
+        this.expectedVersion = expectedVersion;
+        this.actualVersion = actualVersion;
+        this.name = 'ReaderStateConflictError';
+    }
+}
+export class ReaderStateDurableStateError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ReaderStateDurableStateError';
+    }
+}
+export async function getReaderState(db, scope, key) {
+    const resolvedScope = resolveScope(scope);
+    const resolvedKey = resolveContentKey(key);
+    return loadReaderState(db, resolvedScope, resolvedKey);
+}
+/** Unlock is intentionally a read-only observation: it never creates or completes state. */
+export async function recordReaderUnlock(db, scope, key) {
+    return getReaderState(db, scope, key);
+}
+export async function recordReaderOpen(db, scope, key, options) {
+    const resolvedScope = resolveScope(scope);
+    const resolvedKey = resolveContentKey(key);
+    if (resolveBehavioralConsent(options) === 'denied') {
+        return {
+            applied: false,
+            reason: 'consent_denied',
+            state: await loadReaderState(db, resolvedScope, resolvedKey),
+        };
+    }
+    const mutation = resolveMutation(options);
+    const { occurredAt, expectedVersion } = mutation;
+    return executeMutation(db, resolvedScope, resolvedKey, occurredAt, expectedVersion, db
+        .prepare(`UPDATE cms_reader_state
+				 SET first_opened_at = CASE
+						WHEN first_opened_at IS NULL OR first_opened_at > ? THEN ?
+						ELSE first_opened_at END,
+					 last_opened_at = CASE
+						WHEN last_opened_at IS NULL OR last_opened_at < ? THEN ?
+						ELSE last_opened_at END,
+					 version = version + 1,
+					 updated_at = CASE WHEN updated_at < ? THEN ? ELSE updated_at END
+				 WHERE identity_user_id = ? AND site_id = ? AND content_type = ? AND content_id = ?
+					AND (? IS NULL OR version = ?)
+					AND (first_opened_at IS NULL OR first_opened_at > ?
+						OR last_opened_at IS NULL OR last_opened_at < ?)
+				 RETURNING *`)
+        .bind(occurredAt, occurredAt, occurredAt, occurredAt, occurredAt, occurredAt, resolvedScope.identityUserId, resolvedScope.siteId, resolvedKey.contentType, resolvedKey.contentId, expectedVersion ?? null, expectedVersion ?? null, occurredAt, occurredAt));
+}
+export async function recordReaderProgress(db, scope, key, options) {
+    const resolvedScope = resolveScope(scope);
+    const resolvedKey = resolveContentKey(key);
+    if (resolveBehavioralConsent(options) === 'denied') {
+        return {
+            applied: false,
+            reason: 'consent_denied',
+            state: await loadReaderState(db, resolvedScope, resolvedKey),
+        };
+    }
+    const mutation = resolveMutation(options);
+    const progress = assertBasisPoints(options.progressBasisPoints);
+    const mediaPositionMs = optionalNonNegativeInteger(options.mediaPositionMs, 'mediaPositionMs');
+    const mediaDurationMs = optionalNonNegativeInteger(options.mediaDurationMs, 'mediaDurationMs');
+    if (mediaPositionMs !== undefined &&
+        mediaDurationMs !== undefined &&
+        mediaPositionMs > mediaDurationMs) {
+        throw new ReaderStateInputError('reader mediaPositionMs cannot exceed mediaDurationMs');
+    }
+    const { occurredAt, expectedVersion } = mutation;
+    return executeMutation(db, resolvedScope, resolvedKey, occurredAt, expectedVersion, db
+        .prepare(`UPDATE cms_reader_state
+				 SET max_progress_bps = CASE
+						WHEN max_progress_bps < ? THEN ? ELSE max_progress_bps END,
+					 media_position_ms = CASE
+						WHEN ? IS NOT NULL AND (progress_observed_at IS NULL OR progress_observed_at < ?)
+						THEN ? ELSE media_position_ms END,
+					 media_duration_ms = CASE
+						WHEN ? IS NOT NULL AND (progress_observed_at IS NULL OR progress_observed_at < ?)
+						THEN ? ELSE media_duration_ms END,
+					 progress_observed_at = CASE
+						WHEN progress_observed_at IS NULL OR progress_observed_at < ? THEN ?
+						ELSE progress_observed_at END,
+					 automatic_completed_at = CASE
+						WHEN automatic_completed_at IS NULL
+							AND MAX(max_progress_bps, ?) >= ${READER_AUTOMATIC_COMPLETION_BPS}
+						THEN ? ELSE automatic_completed_at END,
+					 version = version + 1,
+					 updated_at = CASE WHEN updated_at < ? THEN ? ELSE updated_at END
+				 WHERE identity_user_id = ? AND site_id = ? AND content_type = ? AND content_id = ?
+					AND (? IS NULL OR version = ?)
+					AND (max_progress_bps < ?
+						OR progress_observed_at IS NULL OR progress_observed_at < ?
+						OR (automatic_completed_at IS NULL AND ? >= ${READER_AUTOMATIC_COMPLETION_BPS}))
+				 RETURNING *`)
+        .bind(progress, progress, mediaPositionMs ?? null, occurredAt, mediaPositionMs ?? null, mediaDurationMs ?? null, occurredAt, mediaDurationMs ?? null, occurredAt, occurredAt, progress, occurredAt, occurredAt, occurredAt, resolvedScope.identityUserId, resolvedScope.siteId, resolvedKey.contentType, resolvedKey.contentId, expectedVersion ?? null, expectedVersion ?? null, progress, occurredAt, progress));
+}
+export async function setManualReadState(db, scope, key, options) {
+    if (options?.state !== 'read' && options?.state !== 'unread') {
+        throw new ReaderStateInputError('manual reader state must be "read" or "unread"');
+    }
+    return writeManualState(db, scope, key, options.state, options);
+}
+export async function clearManualReadState(db, scope, key, options) {
+    return writeManualState(db, scope, key, null, options);
+}
+async function writeManualState(db, scope, key, state, options) {
+    const resolvedScope = resolveScope(scope);
+    const resolvedKey = resolveContentKey(key);
+    const mutation = resolveExplicitMutation(options);
+    return executeMutation(db, resolvedScope, resolvedKey, mutation.occurredAt, mutation.expectedVersion, db
+        .prepare(`UPDATE cms_reader_state
+				 SET manual_read_state = ?, manual_state_at = ?, manual_mutation_id = ?,
+					 version = version + 1,
+					 updated_at = CASE WHEN updated_at < ? THEN ? ELSE updated_at END
+				 WHERE identity_user_id = ? AND site_id = ? AND content_type = ? AND content_id = ?
+					AND (? IS NULL OR version = ?)
+					AND (manual_state_at IS NULL OR manual_state_at < ?
+						OR (manual_state_at = ? AND COALESCE(manual_mutation_id, '') < ?))
+				 RETURNING *`)
+        .bind(state, mutation.occurredAt, options.mutationId, mutation.occurredAt, mutation.occurredAt, resolvedScope.identityUserId, resolvedScope.siteId, resolvedKey.contentType, resolvedKey.contentId, mutation.expectedVersion ?? null, mutation.expectedVersion ?? null, mutation.occurredAt, mutation.occurredAt, options.mutationId));
+}
+export async function setSavedState(db, scope, key, options) {
+    if (typeof options?.saved !== 'boolean') {
+        throw new ReaderStateInputError('saved reader state must be a boolean');
+    }
+    const resolvedScope = resolveScope(scope);
+    const resolvedKey = resolveContentKey(key);
+    const mutation = resolveExplicitMutation(options);
+    return executeMutation(db, resolvedScope, resolvedKey, mutation.occurredAt, mutation.expectedVersion, db
+        .prepare(`UPDATE cms_reader_state
+				 SET saved = ?, saved_at = ?, saved_mutation_id = ?,
+					 version = version + 1,
+					 updated_at = CASE WHEN updated_at < ? THEN ? ELSE updated_at END
+				 WHERE identity_user_id = ? AND site_id = ? AND content_type = ? AND content_id = ?
+					AND (? IS NULL OR version = ?)
+					AND (saved_at IS NULL OR saved_at < ?
+						OR (saved_at = ? AND COALESCE(saved_mutation_id, '') < ?))
+				 RETURNING *`)
+        .bind(options.saved ? 1 : 0, mutation.occurredAt, options.mutationId, mutation.occurredAt, mutation.occurredAt, resolvedScope.identityUserId, resolvedScope.siteId, resolvedKey.contentType, resolvedKey.contentId, mutation.expectedVersion ?? null, mutation.expectedVersion ?? null, mutation.occurredAt, mutation.occurredAt, options.mutationId));
+}
+export async function setReaderPreferences(db, scope, key, options) {
+    const preferences = normalizePreferences(options?.preferences);
+    const resolvedScope = resolveScope(scope);
+    const resolvedKey = resolveContentKey(key);
+    const mutation = resolveExplicitMutation(options);
+    const preferencesJson = JSON.stringify(preferences);
+    return executeMutation(db, resolvedScope, resolvedKey, mutation.occurredAt, mutation.expectedVersion, db
+        .prepare(`UPDATE cms_reader_state
+				 SET preferences_json = ?, preferences_at = ?, preferences_mutation_id = ?,
+					 version = version + 1,
+					 updated_at = CASE WHEN updated_at < ? THEN ? ELSE updated_at END
+				 WHERE identity_user_id = ? AND site_id = ? AND content_type = ? AND content_id = ?
+					AND (? IS NULL OR version = ?)
+					AND (preferences_at IS NULL OR preferences_at < ?
+						OR (preferences_at = ? AND COALESCE(preferences_mutation_id, '') < ?))
+				 RETURNING *`)
+        .bind(preferencesJson, mutation.occurredAt, options.mutationId, mutation.occurredAt, mutation.occurredAt, resolvedScope.identityUserId, resolvedScope.siteId, resolvedKey.contentType, resolvedKey.contentId, mutation.expectedVersion ?? null, mutation.expectedVersion ?? null, mutation.occurredAt, mutation.occurredAt, options.mutationId));
+}
+export async function getReaderStateBatch(db, scope, keys) {
+    const resolvedScope = resolveScope(scope);
+    if (!Array.isArray(keys)) {
+        throw new ReaderStateInputError('reader state batch keys must be an array');
+    }
+    if (keys.length > MAX_READER_STATE_BATCH_SIZE) {
+        throw new ReaderStateInputError(`reader state batches are limited to ${MAX_READER_STATE_BATCH_SIZE} declared content IDs`);
+    }
+    if (keys.length === 0)
+        return [];
+    const resolvedKeys = keys.map(resolveContentKey);
+    const declared = resolvedKeys.map(() => '(content_type = ? AND content_id = ?)').join(' OR ');
+    const statement = db.prepare(`SELECT * FROM cms_reader_state
+		 WHERE identity_user_id = ? AND site_id = ? AND (${declared})
+		 ORDER BY content_type, content_id`);
+    const bindings = [resolvedScope.identityUserId, resolvedScope.siteId];
+    for (const key of resolvedKeys)
+        bindings.push(key.contentType, key.contentId);
+    const result = await statement.bind(...bindings).all();
+    return (result.results ?? []).map(decodeReaderStateRow);
+}
+export async function listReaderState(db, scope, options = {}) {
+    const resolvedScope = resolveScope(scope);
+    return readReaderStatePage(db, resolvedScope, options, 'updated');
+}
+async function readReaderStatePage(db, scope, options, order) {
+    const limit = resolveLimit(options.limit);
+    const cursor = options.cursor ? decodeCursor(options.cursor, order) : null;
+    const orderColumn = order === 'updated' ? 'updated_at' : 'created_at';
+    let statement;
+    if (cursor) {
+        statement = db
+            .prepare(`SELECT * FROM cms_reader_state
+				 WHERE identity_user_id = ? AND site_id = ?
+					AND (${orderColumn} < ?
+						OR (${orderColumn} = ? AND content_type > ?)
+						OR (${orderColumn} = ? AND content_type = ? AND content_id > ?))
+				 ORDER BY ${orderColumn} DESC, content_type, content_id
+				 LIMIT ?`)
+            .bind(scope.identityUserId, scope.siteId, cursor.orderedAt, cursor.orderedAt, cursor.contentType, cursor.orderedAt, cursor.contentType, cursor.contentId, limit + 1);
+    }
+    else {
+        statement = db
+            .prepare(`SELECT * FROM cms_reader_state
+				 WHERE identity_user_id = ? AND site_id = ?
+				 ORDER BY ${orderColumn} DESC, content_type, content_id
+				 LIMIT ?`)
+            .bind(scope.identityUserId, scope.siteId, limit + 1);
+    }
+    const result = await statement.all();
+    const decoded = (result.results ?? []).map(decodeReaderStateRow);
+    const hasMore = decoded.length > limit;
+    const items = hasMore ? decoded.slice(0, limit) : decoded;
+    const last = items.at(-1);
+    return {
+        items,
+        nextCursor: hasMore && last ? encodeCursor(last, order) : null,
+    };
+}
+export async function exportReaderStatePage(db, scope, options = {}) {
+    const resolvedScope = resolveScope(scope);
+    const page = await readReaderStatePage(db, resolvedScope, options, 'created');
+    return {
+        ...page,
+        scope: resolvedScope,
+        exportedAt: Date.now(),
+    };
+}
+/**
+ * Consent-withdrawal/privacy clear: remove behavioral history while retaining
+ * explicit read/unread, save, and stated preference choices.
+ */
+export async function clearReaderHistory(db, scope) {
+    const resolvedScope = resolveScope(scope);
+    const now = Date.now();
+    const result = await db
+        .prepare(`UPDATE cms_reader_state
+			 SET first_opened_at = NULL, last_opened_at = NULL,
+				 max_progress_bps = 0, media_position_ms = NULL, media_duration_ms = NULL,
+				 progress_observed_at = NULL, automatic_completed_at = NULL,
+				 version = version + 1, updated_at = ?
+			 WHERE identity_user_id = ? AND site_id = ?
+				AND (first_opened_at IS NOT NULL OR last_opened_at IS NOT NULL
+					OR max_progress_bps <> 0 OR media_position_ms IS NOT NULL
+					OR media_duration_ms IS NOT NULL OR progress_observed_at IS NOT NULL
+					OR automatic_completed_at IS NOT NULL)`)
+        .bind(now, resolvedScope.identityUserId, resolvedScope.siteId)
+        .run();
+    return resultChanges(result);
+}
+/** Delete every row for exactly one verified user/site scope. */
+export async function deleteReaderState(db, scope) {
+    const resolvedScope = resolveScope(scope);
+    const result = await db
+        .prepare('DELETE FROM cms_reader_state WHERE identity_user_id = ? AND site_id = ?')
+        .bind(resolvedScope.identityUserId, resolvedScope.siteId)
+        .run();
+    return resultChanges(result);
+}
+async function executeMutation(db, scope, key, occurredAt, expectedVersion, update) {
+    const expected = expectedVersion ?? null;
+    const ensure = db
+        .prepare(`INSERT OR IGNORE INTO cms_reader_state
+				(identity_user_id, site_id, content_type, content_id, created_at, updated_at)
+			 SELECT ?, ?, ?, ?, ?, ?
+			 WHERE ? IS NULL OR ? = 0`)
+        .bind(scope.identityUserId, scope.siteId, key.contentType, key.contentId, occurredAt, occurredAt, expected, expected);
+    const [, updateResult] = await db.batch([ensure, update]);
+    const returnedRow = updateResult?.results?.[0];
+    if (returnedRow) {
+        return { applied: true, reason: 'applied', state: decodeReaderStateRow(returnedRow) };
+    }
+    if (resultChanges(updateResult) > 0) {
+        throw new ReaderStateDurableStateError('reader state mutation changed a row without returning its atomic state');
+    }
+    const state = await loadReaderState(db, scope, key);
+    if (!state) {
+        if (expectedVersion !== undefined) {
+            throw new ReaderStateConflictError(expectedVersion, null);
+        }
+        throw new ReaderStateDurableStateError('reader state mutation did not produce a durable row');
+    }
+    if (expectedVersion !== undefined && state.version !== expectedVersion) {
+        throw new ReaderStateConflictError(expectedVersion, state.version);
+    }
+    return { applied: false, reason: 'stale', state };
+}
+async function loadReaderState(db, scope, key) {
+    const row = await db
+        .prepare(`SELECT * FROM cms_reader_state
+			 WHERE identity_user_id = ? AND site_id = ? AND content_type = ? AND content_id = ?`)
+        .bind(scope.identityUserId, scope.siteId, key.contentType, key.contentId)
+        .first();
+    return row ? decodeReaderStateRow(row) : null;
+}
+function decodeReaderStateRow(row) {
+    let preferences;
+    try {
+        preferences = normalizePreferences(JSON.parse(row.preferences_json));
+    }
+    catch (error) {
+        const detail = error instanceof Error ? `: ${error.message}` : '';
+        throw new ReaderStateDurableStateError(`reader state contains unreadable preferences${detail}`);
+    }
+    return {
+        identityUserId: row.identity_user_id,
+        siteId: row.site_id,
+        contentType: row.content_type,
+        contentId: row.content_id,
+        firstOpenedAt: row.first_opened_at,
+        lastOpenedAt: row.last_opened_at,
+        maxProgressBasisPoints: row.max_progress_bps,
+        mediaPositionMs: row.media_position_ms,
+        mediaDurationMs: row.media_duration_ms,
+        progressObservedAt: row.progress_observed_at,
+        automaticCompletedAt: row.automatic_completed_at,
+        manualReadState: row.manual_read_state,
+        manualStateAt: row.manual_state_at,
+        saved: row.saved === 1,
+        savedAt: row.saved_at,
+        preferences,
+        preferencesAt: row.preferences_at,
+        version: row.version,
+        effectiveRead: row.manual_read_state === 'read' ||
+            (row.manual_read_state === null && row.automatic_completed_at !== null),
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+function resolveScope(scope) {
+    if (!scope || typeof scope !== 'object') {
+        throw new ReaderStateInputError('reader state requires a verified scope');
+    }
+    const identityUserId = scope.identityUserId;
+    if (typeof identityUserId !== 'string' ||
+        !(UUIDV4_PATTERN.test(identityUserId) || ULID_PATTERN.test(identityUserId))) {
+        throw new ReaderStateInputError('reader state requires a verified raw realm user id, never an analytics, local, email, or prefixed subject identifier');
+    }
+    if (typeof scope.siteId !== 'string' || !SITE_ID_PATTERN.test(scope.siteId)) {
+        throw new ReaderStateInputError('reader state requires a verified stable lowercase site id such as "fronts"');
+    }
+    return {
+        identityUserId: UUIDV4_PATTERN.test(identityUserId)
+            ? identityUserId.toLowerCase()
+            : identityUserId,
+        siteId: scope.siteId,
+    };
+}
+function resolveContentKey(key) {
+    if (!key || typeof key !== 'object' || !CONTENT_TYPES.has(key.contentType)) {
+        throw new ReaderStateInputError('reader state requires a supported CMS content type');
+    }
+    if (typeof key.contentId !== 'string' || !CONTENT_ID_PATTERN.test(key.contentId)) {
+        throw new ReaderStateInputError('reader state requires a stable CMS content id using URL-safe identifier characters');
+    }
+    return { contentType: key.contentType, contentId: key.contentId };
+}
+function resolveBehavioralConsent(options) {
+    if (!options || typeof options !== 'object') {
+        throw new ReaderStateInputError('reader behavioral writes require explicit consent state');
+    }
+    if (options.behavioralConsent !== 'granted' && options.behavioralConsent !== 'denied') {
+        throw new ReaderStateInputError('behavioralConsent must be "granted" or "denied"');
+    }
+    return options.behavioralConsent;
+}
+function resolveExplicitMutation(options) {
+    if (!options || typeof options !== 'object') {
+        throw new ReaderStateInputError('explicit reader state writes require mutation options');
+    }
+    if (typeof options.mutationId !== 'string' || !MUTATION_ID_PATTERN.test(options.mutationId)) {
+        throw new ReaderStateInputError('explicit reader state writes require a stable mutationId');
+    }
+    return resolveMutation(options);
+}
+function resolveMutation(options) {
+    const occurredAt = options.occurredAt ?? Date.now();
+    if (!Number.isSafeInteger(occurredAt) || occurredAt < 0) {
+        throw new ReaderStateInputError('reader state occurredAt must be a non-negative epoch millisecond');
+    }
+    if (occurredAt > Date.now() + MAX_EVENT_FUTURE_SKEW_MS) {
+        throw new ReaderStateInputError('reader state occurredAt exceeds the allowed five-minute clock skew');
+    }
+    if (options.expectedVersion !== undefined &&
+        (!Number.isSafeInteger(options.expectedVersion) || options.expectedVersion < 0)) {
+        throw new ReaderStateInputError('reader state expectedVersion must be a non-negative integer');
+    }
+    return { occurredAt, expectedVersion: options.expectedVersion };
+}
+function assertBasisPoints(value) {
+    if (!Number.isInteger(value) || value < 0 || value > 10_000) {
+        throw new ReaderStateInputError('reader progress must be an integer from 0 through 10000');
+    }
+    return value;
+}
+function optionalNonNegativeInteger(value, name) {
+    if (value === undefined)
+        return undefined;
+    if (!Number.isSafeInteger(value) || value < 0) {
+        throw new ReaderStateInputError(`reader ${name} must be a non-negative integer`);
+    }
+    return value;
+}
+function normalizePreferences(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new ReaderStateInputError('reader preferences must be a plain object of stated values');
+    }
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype !== Object.prototype && prototype !== null) {
+        throw new ReaderStateInputError('reader preferences must be a plain object');
+    }
+    const entries = Object.entries(value);
+    if (entries.length > MAX_PREFERENCE_KEYS) {
+        throw new ReaderStateInputError(`reader preferences are limited to ${MAX_PREFERENCE_KEYS} keys`);
+    }
+    const normalized = Object.create(null);
+    for (const [key, preference] of entries.sort(([a], [b]) => a.localeCompare(b))) {
+        if (!PREFERENCE_KEY_PATTERN.test(key) ||
+            ['__proto__', 'constructor', 'prototype'].includes(key)) {
+            throw new ReaderStateInputError('reader preference keys must use safe stable identifiers');
+        }
+        if (preference !== null &&
+            typeof preference !== 'string' &&
+            typeof preference !== 'boolean' &&
+            (typeof preference !== 'number' || !Number.isFinite(preference))) {
+            throw new ReaderStateInputError('reader preference values must be finite scalar values');
+        }
+        normalized[key] = preference;
+    }
+    if (new TextEncoder().encode(JSON.stringify(normalized)).byteLength > MAX_PREFERENCES_JSON_BYTES) {
+        throw new ReaderStateInputError(`reader preferences are limited to ${MAX_PREFERENCES_JSON_BYTES} encoded bytes`);
+    }
+    return normalized;
+}
+function resolveLimit(value) {
+    const limit = value ?? DEFAULT_READER_STATE_BATCH_SIZE;
+    if (!Number.isInteger(limit) || limit < 1 || limit > MAX_READER_STATE_BATCH_SIZE) {
+        throw new ReaderStateInputError(`reader state list limits must be from 1 through ${MAX_READER_STATE_BATCH_SIZE}`);
+    }
+    return limit;
+}
+function encodeCursor(record, order) {
+    const orderedAt = order === 'updated' ? record.updatedAt : record.createdAt;
+    return encodeURIComponent(JSON.stringify([order, orderedAt, record.contentType, record.contentId]));
+}
+function decodeCursor(cursor, expectedOrder) {
+    try {
+        const parsed = JSON.parse(decodeURIComponent(cursor));
+        if (!Array.isArray(parsed) ||
+            parsed.length !== 4 ||
+            parsed[0] !== expectedOrder ||
+            !Number.isSafeInteger(parsed[1])) {
+            throw new Error('shape');
+        }
+        const key = resolveContentKey({ contentType: parsed[2], contentId: parsed[3] });
+        return { order: expectedOrder, orderedAt: parsed[1], ...key };
+    }
+    catch (error) {
+        if (error instanceof ReaderStateInputError)
+            throw error;
+        throw new ReaderStateInputError('reader state cursor is invalid');
+    }
+}
+function resultChanges(result) {
+    const changes = result?.meta?.changes;
+    if (typeof changes !== 'number' || !Number.isFinite(changes)) {
+        throw new ReaderStateDurableStateError('reader state mutation returned no finite change count');
+    }
+    return changes;
+}
+//# sourceMappingURL=reader-state.js.map

package/dist/engine/reader-state.js.map

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

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export * from './engine/index.js';
 export * from './providers/index.js';
 export type { CmsUser } from './routes/context.js';
-export { type ArticleContentRow, type AuthorRow, applyMigrations, CMS_MIGRATION_SQL, CMS_MIGRATIONS_0002_PLUS, CMS_TABLES, type CmsActivityLogRow, type CmsApiKeyRow, type CmsNotificationRow, type CmsRole, type CmsTableName, type CmsWebhookRow, type ContentContributorRow, type ContentImportRow, type ContentItemRow, type ContentPublicationAttemptRow, type ContentPublicationAttemptState, type ContentPublicationOperation, type ContentRelationRow, type ContentRevisionRow, type ContentSlugRedirectRow, type ContentStatus, type ContentTagLinkRow, type ContentTagRow, type ContentType, type ContentVisibility, type FoundryCallbackEventRow, type MastheadUserRow, type MediaAssetRow, NON_CMS_TABLES, type PodcastContentRow, splitStatements, type VideoContentRow, type VideoProcessingState, type WorkspaceInviteRow, type WorkspaceMembershipRow, type WorkspaceSettingsRow, } from './schema/index.js';
+export { type ArticleContentRow, type AuthorRow, applyMigrations, CMS_MIGRATION_SQL, CMS_MIGRATIONS_0002_PLUS, CMS_TABLES, type CmsActivityLogRow, type CmsApiKeyRow, type CmsNotificationRow, type CmsReaderStateRow, type CmsRole, type CmsTableName, type CmsWebhookRow, type ContentContributorRow, type ContentImportRow, type ContentItemRow, type ContentPublicationAttemptRow, type ContentPublicationAttemptState, type ContentPublicationOperation, type ContentRelationRow, type ContentRevisionRow, type ContentSlugRedirectRow, type ContentStatus, type ContentTagLinkRow, type ContentTagRow, type ContentType, type ContentVisibility, type FoundryCallbackEventRow, type MastheadUserRow, type MediaAssetRow, NON_CMS_TABLES, type PodcastContentRow, type ReaderManualReadState, splitStatements, type VideoContentRow, type VideoProcessingState, type WorkspaceInviteRow, type WorkspaceMembershipRow, type WorkspaceSettingsRow, } from './schema/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgCA,cAAc,mBAAmB,CAAA;AAGjC,cAAc,sBAAsB,CAAA;AAGpC,YAAY,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,EACN,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,eAAe,EAEf,iBAAiB,EACjB,wBAAwB,EAExB,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,4BAA4B,EACjC,KAAK,8BAA8B,EACnC,KAAK,2BAA2B,EAChC,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAElB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,cAAc,EACd,KAAK,iBAAiB,EACtB,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,GACzB,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgCA,cAAc,mBAAmB,CAAA;AAGjC,cAAc,sBAAsB,CAAA;AAGpC,YAAY,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,EACN,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,eAAe,EAEf,iBAAiB,EACjB,wBAAwB,EAExB,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,4BAA4B,EACjC,KAAK,8BAA8B,EACnC,KAAK,2BAA2B,EAChC,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAElB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,GACzB,MAAM,mBAAmB,CAAA"}

package/dist/index.js

@@ -1,8 +1,8 @@
 // @growth-labs/cms — the reusable Fronts-proven publishing/admin engine, as a
 // package (NOT a shared engine). See docs/reference/cms-reuse-decision.md.
 //
-// This package ships the D1 schema contract (the 11-table
-// content/revision/media/authors/foundry-callback set) + its TypeScript row
+// This package ships the D1 schema contract (the original 11-table
+// content/revision/media/authors/foundry-callback set plus additive migrations) + its TypeScript row
 // types (WS7-04/06 foundation) AND the publishing engine — the content
 // data-access core (WS7-05):
 //

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,2EAA2E;AAC3E,EAAE;AACF,0DAA0D;AAC1D,4EAA4E;AAC5E,uEAAuE;AACvE,6BAA6B;AAC7B,EAAE;AACF,qEAAqE;AACrE,iEAAiE;AACjE,qEAAqE;AACrE,iDAAiD;AACjD,+EAA+E;AAC/E,gFAAgF;AAChF,6EAA6E;AAC7E,+EAA+E;AAC/E,oEAAoE;AACpE,2EAA2E;AAC3E,+EAA+E;AAC/E,qBAAqB;AACrB,oEAAoE;AACpE,wEAAwE;AACxE,4EAA4E;AAC5E,yEAAyE;AACzE,8EAA8E;AAC9E,gFAAgF;AAChF,0EAA0E;AAC1E,6EAA6E;AAC7E,iDAAiD;AAEjD,sEAAsE;AACtE,sDAAsD;AACtD,cAAc,mBAAmB,CAAA;AAEjC,mEAAmE;AACnE,cAAc,sBAAsB,CAAA;AAKpC,OAAO,EAGN,eAAe;AACf,qBAAqB;AACrB,iBAAiB,EACjB,wBAAwB;AACxB,iBAAiB;AACjB,UAAU,EAyBV,cAAc,EAEd,eAAe,GAMf,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,2EAA2E;AAC3E,EAAE;AACF,mEAAmE;AACnE,qGAAqG;AACrG,uEAAuE;AACvE,6BAA6B;AAC7B,EAAE;AACF,qEAAqE;AACrE,iEAAiE;AACjE,qEAAqE;AACrE,iDAAiD;AACjD,+EAA+E;AAC/E,gFAAgF;AAChF,6EAA6E;AAC7E,+EAA+E;AAC/E,oEAAoE;AACpE,2EAA2E;AAC3E,+EAA+E;AAC/E,qBAAqB;AACrB,oEAAoE;AACpE,wEAAwE;AACxE,4EAA4E;AAC5E,yEAAyE;AACzE,8EAA8E;AAC9E,gFAAgF;AAChF,0EAA0E;AAC1E,6EAA6E;AAC7E,iDAAiD;AAEjD,sEAAsE;AACtE,sDAAsD;AACtD,cAAc,mBAAmB,CAAA;AAEjC,mEAAmE;AACnE,cAAc,sBAAsB,CAAA;AAKpC,OAAO,EAGN,eAAe;AACf,qBAAqB;AACrB,iBAAiB,EACjB,wBAAwB;AACxB,iBAAiB;AACjB,UAAU,EA0BV,cAAc,EAGd,eAAe,GAMf,MAAM,mBAAmB,CAAA"}

package/dist/migration-vendor-files.d.ts

@@ -0,0 +1,17 @@
+export interface StagedMigrationVendorFile {
+    tempPath: string;
+    targetPath: string;
+}
+export interface MigrationVendorFileOperations {
+    link(source: string, target: string): Promise<void>;
+    unlink(path: string): Promise<void>;
+}
+export declare function rollbackNewFiles(paths: string[], operations?: MigrationVendorFileOperations): Promise<void>;
+/**
+ * Link every pre-staged file without replacing an existing directory entry.
+ * A later failure removes all targets linked by this attempt and every temp.
+ */
+export declare function commitNewFilesAtomically(files: StagedMigrationVendorFile[], operations?: MigrationVendorFileOperations): Promise<string[]>;
+/** Commit staged SQL, then run the receipt/final verification boundary. */
+export declare function commitStagedMigrationBatch(files: StagedMigrationVendorFile[], finalize: () => Promise<void>, operations?: MigrationVendorFileOperations): Promise<string[]>;
+//# sourceMappingURL=migration-vendor-files.d.ts.map

package/dist/migration-vendor-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-vendor-files.d.ts","sourceRoot":"","sources":["../src/migration-vendor-files.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,yBAAyB;IACzC,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,6BAA6B;IAC7C,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACnC;AAmBD,wBAAsB,gBAAgB,CACrC,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,GAAE,6BAAkD,GAC5D,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC7C,KAAK,EAAE,yBAAyB,EAAE,EAClC,UAAU,GAAE,6BAAkD,GAC5D,OAAO,CAAC,MAAM,EAAE,CAAC,CA8BnB;AAED,2EAA2E;AAC3E,wBAAsB,0BAA0B,CAC/C,KAAK,EAAE,yBAAyB,EAAE,EAClC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC7B,UAAU,GAAE,6BAAkD,GAC5D,OAAO,CAAC,MAAM,EAAE,CAAC,CAgBnB"}

package/dist/migration-vendor-files.js

@@ -0,0 +1,67 @@
+import { link, unlink } from 'node:fs/promises';
+const DEFAULT_OPERATIONS = { link, unlink };
+async function removePaths(paths, operations) {
+    const errors = [];
+    for (const path of [...paths].reverse()) {
+        try {
+            await operations.unlink(path);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT')
+                errors.push(error);
+        }
+    }
+    return errors;
+}
+export async function rollbackNewFiles(paths, operations = DEFAULT_OPERATIONS) {
+    const errors = await removePaths(paths, operations);
+    if (errors.length > 0) {
+        throw new AggregateError(errors, 'failed to roll back newly linked CMS migration files');
+    }
+}
+/**
+ * Link every pre-staged file without replacing an existing directory entry.
+ * A later failure removes all targets linked by this attempt and every temp.
+ */
+export async function commitNewFilesAtomically(files, operations = DEFAULT_OPERATIONS) {
+    const committed = [];
+    let failure;
+    try {
+        for (const file of files) {
+            await operations.link(file.tempPath, file.targetPath);
+            committed.push(file.targetPath);
+        }
+    }
+    catch (error) {
+        failure = error;
+    }
+    const cleanupErrors = await removePaths(files.map((file) => file.tempPath), operations);
+    if (failure) {
+        const rollbackErrors = await removePaths(committed, operations);
+        const errors = [failure, ...cleanupErrors, ...rollbackErrors].filter((error) => error !== undefined);
+        const primary = failure instanceof Error ? `: ${failure.message}` : '';
+        throw new AggregateError(errors, `CMS migration file commit failed${primary}`);
+    }
+    // A hard-linked target remains valid when unlinking only its staged temp
+    // fails. The caller's outer finally retries temp cleanup; rolling targets
+    // back here would turn a harmless leftover temp into data loss.
+    return committed;
+}
+/** Commit staged SQL, then run the receipt/final verification boundary. */
+export async function commitStagedMigrationBatch(files, finalize, operations = DEFAULT_OPERATIONS) {
+    const committed = await commitNewFilesAtomically(files, operations);
+    try {
+        await finalize();
+        return committed;
+    }
+    catch (error) {
+        try {
+            await rollbackNewFiles(committed, operations);
+        }
+        catch (rollbackError) {
+            throw new AggregateError([error, rollbackError], 'CMS migration batch finalization failed and rollback was incomplete');
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=migration-vendor-files.js.map