@growth-labs/cms 0.2.0 → 0.3.0

package/src/index.ts

@@ -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):
 //
@@ -50,6 +50,7 @@ export {
 	type CmsActivityLogRow,
 	type CmsApiKeyRow,
 	type CmsNotificationRow,
+	type CmsReaderStateRow,
 	type CmsRole,
 	type CmsTableName,
 	type CmsWebhookRow,
@@ -73,6 +74,7 @@ export {
 	type MediaAssetRow,
 	NON_CMS_TABLES,
 	type PodcastContentRow,
+	type ReaderManualReadState,
 	splitStatements,
 	type VideoContentRow,
 	type VideoProcessingState,

package/src/schema/index.ts

@@ -20,6 +20,7 @@ export type {
 	CmsActivityLogRow,
 	CmsApiKeyRow,
 	CmsNotificationRow,
+	CmsReaderStateRow,
 	CmsRole,
 	CmsWebhookRow,
 	ContentContributorRow,
@@ -40,6 +41,7 @@ export type {
 	MastheadUserRow,
 	MediaAssetRow,
 	PodcastContentRow,
+	ReaderManualReadState,
 	VideoContentRow,
 	VideoProcessingState,
 	WorkspaceInviteRow,

package/src/schema/migrations.ts

@@ -741,6 +741,43 @@ CREATE INDEX idx_content_publication_attempts_recovery
   ON content_publication_attempts(state, updated_at);
 CREATE INDEX idx_content_publication_attempts_content
   ON content_publication_attempts(content_id, created_at DESC);
+`,
+	},
+	{
+		id: '0019_reader_state',
+		sql: `
+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/src/schema/tables.ts

@@ -1,5 +1,7 @@
-// The 11-table content/revision/media/authors/foundry-callback contract that
-// `@growth-labs/cms` owns. Verified against prod `fronts-data` 2026-05-29.
+// The content/revision/media/authors/foundry-callback contract plus additive
+// package-owned CMS platform/product tables. The original 11-table core was
+// verified against prod `fronts-data` 2026-05-29; later entries are versioned
+// migrations with their own workerd contract tests.
 //
 // This list is the CMS boundary made executable: it is exactly the tables the
 // package migration creates and nothing else. Identity/entitlement tables
@@ -23,6 +25,7 @@ export const CMS_TABLES = [
 	'content_contributors',
 	'content_slug_redirects',
 	'content_publication_attempts',
+	'cms_reader_state',
 	// Masthead platform tables (migrations 0008–0011)
 	'workspace_settings',
 	'masthead_users',

package/src/schema/types.ts

@@ -567,6 +567,35 @@ export interface ContentPublicationAttemptRow {
 	updated_at: number
 }
 
+export type ReaderManualReadState = 'read' | 'unread'
+
+/** Package-owned reader product state from migration 0019. */
+export interface CmsReaderStateRow {
+	identity_user_id: string
+	site_id: string
+	content_type: ContentType
+	content_id: string
+	first_opened_at: number | null
+	last_opened_at: number | null
+	max_progress_bps: number
+	media_position_ms: number | null
+	media_duration_ms: number | null
+	progress_observed_at: number | null
+	automatic_completed_at: number | null
+	manual_read_state: ReaderManualReadState | null
+	manual_state_at: number | null
+	manual_mutation_id: string | null
+	saved: number
+	saved_at: number | null
+	saved_mutation_id: string | null
+	preferences_json: string
+	preferences_at: number | null
+	preferences_mutation_id: string | null
+	version: number
+	created_at: number
+	updated_at: number
+}
+
 /**
  * Schema version for the intent_key derivation. Bump ONLY on a breaking change
  * to the canonical-cluster-id semantics; bumping rotates every intent_key (and