@growth-labs/cms 0.2.0 → 0.3.1

package/migrations/0019_reader_state.sql

@@ -0,0 +1,34 @@
+-- Package-owned reader product state. Raw verified realm identity is the only
+-- principal; analytics identifiers never enter this table.
+CREATE TABLE cms_reader_state (
+  identity_user_id TEXT NOT NULL,
+  site_id TEXT NOT NULL,
+  content_type TEXT NOT NULL CHECK (content_type IN ('article','video','podcast','newsletter','page')),
+  content_id TEXT NOT NULL,
+  first_opened_at INTEGER,
+  last_opened_at INTEGER,
+  max_progress_bps INTEGER NOT NULL DEFAULT 0 CHECK (max_progress_bps BETWEEN 0 AND 10000),
+  media_position_ms INTEGER CHECK (media_position_ms IS NULL OR media_position_ms >= 0),
+  media_duration_ms INTEGER CHECK (media_duration_ms IS NULL OR media_duration_ms >= 0),
+  progress_observed_at INTEGER,
+  automatic_completed_at INTEGER,
+  manual_read_state TEXT CHECK (manual_read_state IS NULL OR manual_read_state IN ('read','unread')),
+  manual_state_at INTEGER,
+  manual_mutation_id TEXT,
+  saved INTEGER NOT NULL DEFAULT 0 CHECK (saved IN (0,1)),
+  saved_at INTEGER,
+  saved_mutation_id TEXT,
+  preferences_json TEXT NOT NULL DEFAULT '{}',
+  preferences_at INTEGER,
+  preferences_mutation_id TEXT,
+  version INTEGER NOT NULL DEFAULT 0 CHECK (version >= 0),
+  created_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000),
+  updated_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000),
+  PRIMARY KEY (identity_user_id, site_id, content_type, content_id)
+);
+CREATE INDEX idx_cms_reader_state_library
+  ON cms_reader_state(identity_user_id, site_id, updated_at DESC, content_type, content_id);
+CREATE INDEX idx_cms_reader_state_export
+  ON cms_reader_state(identity_user_id, site_id, created_at DESC, content_type, content_id);
+CREATE INDEX idx_cms_reader_state_saved
+  ON cms_reader_state(identity_user_id, site_id, saved, updated_at DESC);

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "@growth-labs/cms",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "type": "module",
+  "bin": {
+    "growth-labs-cms-migrations": "./dist/cli/migrations.js"
+  },
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
@@ -24,6 +27,10 @@
       "types": "./dist/integration/index.d.ts",
       "import": "./dist/integration/index.js"
     },
+    "./migration-vendor": {
+      "types": "./dist/migration-vendor.d.ts",
+      "import": "./dist/migration-vendor.js"
+    },
     "./ui": {
       "types": "./dist/ui/components/CmsApp.d.ts",
       "import": "./dist/ui/components/CmsApp.js"

package/src/cli/migrations.ts

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+
+import { syncCmsMigrations, verifyCmsMigrations } from '../migration-vendor.js'
+
+interface ParsedArgs {
+	command: 'sync' | 'verify'
+	migrationsDir: string
+	startSequence?: number
+	manifestPath?: string
+}
+
+function usage(): string {
+	return [
+		'Usage:',
+		'  growth-labs-cms-migrations sync --dir <migrations-dir> --start <positive-integer>',
+		'  growth-labs-cms-migrations verify --dir <migrations-dir>',
+		'',
+		'Optional for both commands: --manifest <receipt-path>',
+	].join('\n')
+}
+
+function requireValue(argv: string[], index: number, flag: string): string {
+	const value = argv[index + 1]
+	if (!value || value.startsWith('--')) throw new Error(`${flag} requires a value`)
+	return value
+}
+
+function parseArgs(argv: string[]): ParsedArgs {
+	const command = argv[0]
+	if (command !== 'sync' && command !== 'verify') throw new Error(usage())
+	let migrationsDir: string | undefined
+	let startSequence: number | undefined
+	let manifestPath: string | undefined
+
+	for (let index = 1; index < argv.length; index += 1) {
+		const flag = argv[index]
+		if (flag === '--dir') {
+			migrationsDir = requireValue(argv, index, flag)
+			index += 1
+			continue
+		}
+		if (flag === '--start') {
+			startSequence = Number(requireValue(argv, index, flag))
+			index += 1
+			continue
+		}
+		if (flag === '--manifest') {
+			manifestPath = requireValue(argv, index, flag)
+			index += 1
+			continue
+		}
+		throw new Error(`unknown argument: ${flag}\n\n${usage()}`)
+	}
+
+	if (!migrationsDir) throw new Error(`--dir is required\n\n${usage()}`)
+	if (command === 'sync' && startSequence === undefined) {
+		throw new Error(`--start is required for sync\n\n${usage()}`)
+	}
+	if (command === 'verify' && startSequence !== undefined) {
+		throw new Error('--start is read from the committed manifest during verify')
+	}
+	return { command, migrationsDir, startSequence, manifestPath }
+}
+
+async function main(): Promise<void> {
+	const args = parseArgs(process.argv.slice(2))
+	const result =
+		args.command === 'sync'
+			? await syncCmsMigrations({
+					migrationsDir: args.migrationsDir,
+					startSequence: args.startSequence as number,
+					manifestPath: args.manifestPath,
+				})
+			: await verifyCmsMigrations({
+					migrationsDir: args.migrationsDir,
+					manifestPath: args.manifestPath,
+				})
+	process.stdout.write(`${JSON.stringify({ ok: true, command: args.command, ...result })}\n`)
+}
+
+main().catch((error: unknown) => {
+	const message = error instanceof Error ? error.message : String(error)
+	process.stderr.write(`growth-labs-cms-migrations: ${message}\n`)
+	process.exitCode = 1
+})

package/src/engine/index.ts

@@ -180,6 +180,44 @@ export {
 	updateContentItem,
 	type VideoInput,
 } from './publisher.js'
+// Verified-user/site reader product state. Analytics remains observation-only.
+export {
+	type ClearManualReadStateOptions,
+	type ContentStateKey,
+	clearManualReadState,
+	clearReaderHistory,
+	DEFAULT_READER_STATE_BATCH_SIZE,
+	deleteReaderState,
+	exportReaderStatePage,
+	getReaderState,
+	getReaderStateBatch,
+	listReaderState,
+	MAX_READER_STATE_BATCH_SIZE,
+	READER_AUTOMATIC_COMPLETION_BPS,
+	type ReaderBehavioralConsent,
+	type ReaderPreferences,
+	type ReaderPreferenceValue,
+	ReaderStateConflictError,
+	ReaderStateDurableStateError,
+	type ReaderStateExportPage,
+	ReaderStateInputError,
+	type ReaderStateListOptions,
+	type ReaderStateMutationResult,
+	type ReaderStatePage,
+	type ReaderStateRecord,
+	type ReaderStateScope,
+	type RecordReaderOpenOptions,
+	type RecordReaderProgressOptions,
+	recordReaderOpen,
+	recordReaderProgress,
+	recordReaderUnlock,
+	type SetManualReadStateOptions,
+	type SetReaderPreferencesOptions,
+	type SetSavedStateOptions,
+	setManualReadState,
+	setReaderPreferences,
+	setSavedState,
+} from './reader-state.js'
 // Revision engine — snapshot + word-delta history + restore.
 export {
 	type ContentRevisionPayload,