@growth-labs/cms 0.1.3 → 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,12 +50,16 @@ export {
 	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,
@@ -70,6 +74,7 @@ export {
 	type MediaAssetRow,
 	NON_CMS_TABLES,
 	type PodcastContentRow,
+	type ReaderManualReadState,
 	splitStatements,
 	type VideoContentRow,
 	type VideoProcessingState,

package/src/schema/index.ts

@@ -20,11 +20,15 @@ export type {
 	CmsActivityLogRow,
 	CmsApiKeyRow,
 	CmsNotificationRow,
+	CmsReaderStateRow,
 	CmsRole,
 	CmsWebhookRow,
 	ContentContributorRow,
 	ContentImportRow,
 	ContentItemRow,
+	ContentPublicationAttemptRow,
+	ContentPublicationAttemptState,
+	ContentPublicationOperation,
 	ContentRelationRow,
 	ContentRevisionRow,
 	ContentSlugRedirectRow,
@@ -37,6 +41,7 @@ export type {
 	MastheadUserRow,
 	MediaAssetRow,
 	PodcastContentRow,
+	ReaderManualReadState,
 	VideoContentRow,
 	VideoProcessingState,
 	WorkspaceInviteRow,

package/src/schema/migrations.ts

@@ -713,6 +713,71 @@ CREATE INDEX IF NOT EXISTS idx_content_items_topic_status_type_published
   ON content_items(primary_topic, status, type, published_at DESC);
 CREATE INDEX IF NOT EXISTS idx_content_items_published_at ON content_items(published_at DESC);
 CREATE INDEX IF NOT EXISTS idx_content_items_deleted_at ON content_items(deleted_at);
+`,
+	},
+	{
+		id: '0018_content_publication_attempts',
+		sql: `
+CREATE TABLE content_publication_attempts (
+  id TEXT PRIMARY KEY,
+  operation TEXT NOT NULL CHECK (operation IN ('publish','rollback')),
+  content_id TEXT NOT NULL,
+  revision_id TEXT NOT NULL,
+  previous_revision_id TEXT,
+  state TEXT NOT NULL CHECK (state IN ('preparing','prepared','committing','pending_retry','committed','superseded','aborting','aborted','abort_failed')),
+  surface_names_json TEXT NOT NULL DEFAULT '[]',
+  pending_surface_names_json TEXT NOT NULL DEFAULT '[]',
+  prepared_surface_names_json TEXT NOT NULL DEFAULT '[]',
+  receipts_json TEXT NOT NULL DEFAULT '[]',
+  version INTEGER NOT NULL DEFAULT 0 CHECK (version >= 0),
+  package_version TEXT,
+  last_error TEXT,
+  created_at INTEGER NOT NULL DEFAULT (unixepoch()),
+  updated_at INTEGER NOT NULL DEFAULT (unixepoch()),
+  FOREIGN KEY (content_id) REFERENCES content_items(id) ON DELETE CASCADE,
+  FOREIGN KEY (revision_id) REFERENCES content_revisions(id) ON DELETE CASCADE
+);
+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
@@ -22,6 +24,8 @@ export const CMS_TABLES = [
 	'foundry_callback_events',
 	'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

@@ -536,6 +536,66 @@ export interface ContentInsightDismissalRow {
 	dismissed_by: string | null
 }
 
+export type ContentPublicationOperation = 'publish' | 'rollback'
+export type ContentPublicationAttemptState =
+	| 'preparing'
+	| 'prepared'
+	| 'committing'
+	| 'pending_retry'
+	| 'committed'
+	| 'superseded'
+	| 'aborting'
+	| 'aborted'
+	| 'abort_failed'
+
+/** Durable publication outbox row. JSON columns are decoded by the publication engine. */
+export interface ContentPublicationAttemptRow {
+	id: string
+	operation: ContentPublicationOperation
+	content_id: string
+	revision_id: string
+	previous_revision_id: string | null
+	state: ContentPublicationAttemptState
+	surface_names_json: string
+	pending_surface_names_json: string
+	prepared_surface_names_json: string
+	receipts_json: string
+	version: number
+	package_version: string | null
+	last_error: string | null
+	created_at: number
+	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