@growth-labs/cms 0.1.0

package/dist/schema/insights-ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insights-ingest.d.ts","sourceRoot":"","sources":["../../src/schema/insights-ingest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAevB,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;EAOtC,CAAA;AAEF,eAAO,MAAM,gCAAgC;;;;;;;;;EAG3C,CAAA;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAGhC,CAAA;AAEF;6EAC6E;AAC7E,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;EAMzC,CAAA;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;IAa9B;;;;;;OAMG;;IAEH,kFAAkF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEjF,CAAA;AAKF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAftC;;;;;;WAMG;;QAEH,kFAAkF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqBjF,CAAA;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAcnC,CAAA;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YA/CvC;;;;;;eAMG;;YAEH,kFAAkF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwDhF,CAAA;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAC/E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AACzE,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA"}

package/dist/schema/insights-ingest.js

@@ -0,0 +1,112 @@
+import { z } from 'zod';
+// HMAC insights-ingest payload — the board for ONE (site_id, run_date).
+// Posted to POST /admin/api/content/insights-ingest, HMAC-SHA256 over the raw
+// body in X-Foundry-Signature vs the per-site insights ingest secret (Secrets
+// Store binding). Field names are byte-identical to the migration 0016 columns
+// so the ingest route binds payload -> row with no remapping.
+//
+// Replay safety lives in meta: the route dedupes on meta.event_id (mirroring
+// foundry_callback_events) and rejects/no-ops any meta.run_attempt that is
+// equal-or-lower than the run_attempt already landed for (site_id, run_date) in
+// content_insight_runs. HMAC authenticates the SENDER; it does NOT prevent
+// replay — run_attempt is the monotonic guard.
+// Reusable evidence/brief JSON shapes (stored as TEXT NOT NULL, zod-validated).
+export const InsightEvidenceDemandSchema = z.object({
+    query: z.string().min(1),
+    impressions: z.number().int().nonnegative(),
+    clicks: z.number().int().nonnegative(),
+    ctr: z.number().min(0).max(1),
+    position: z.number().nonnegative(),
+    trend: z.number(),
+});
+export const InsightEvidenceOpportunitySchema = z.object({
+    basis: z.string().min(1),
+    source_count: z.number().int().nonnegative(),
+});
+export const InsightEvidenceSchema = z.union([
+    InsightEvidenceDemandSchema,
+    InsightEvidenceOpportunitySchema,
+]);
+/** One recent competitor article — the COMPETITOR-WATCH pulse evidence (carried in
+ *  the opaque brief blob; the board surfaces it as the raw rival signal). */
+export const InsightCompetitorArticleSchema = z.object({
+    title: z.string().min(1),
+    url: z.string().url(),
+    outlet: z.string().optional(),
+    published: z.string().optional(),
+    covered: z.boolean().optional(),
+});
+export const InsightBriefSchema = z.object({
+    why_now: z.string().min(1),
+    angle: z.string().min(1),
+    cluster: z.object({
+        canonical: z.string().min(1),
+        spokes: z.array(z.string().min(1)),
+    }),
+    sources: z.array(z.object({
+        title: z.string().min(1),
+        url: z.string().url(),
+    })),
+    /**
+     * Which open-web discovery STREAM produced this opportunity row (the theater
+     * split). REQUIRED here: Zod strips unknown brief keys, so without this field the
+     * Foundry-sent brief.discoveryKind is SILENTLY dropped at ingest and the board
+     * can never split the two opportunity sub-kinds. Optional value so old briefs
+     * (and demand rows) still parse.
+     */
+    discoveryKind: z.enum(['competitor', 'audience_question']).optional(),
+    /** COMPETITOR-WATCH pulse: the recent rival articles per theater (raw signal). */
+    competitor_articles: z.array(InsightCompetitorArticleSchema).optional(),
+});
+// One suggestion row. Names == content_insights columns. id/run_id/created_at
+// are server-assigned on insert and are NOT carried in the wire payload; the
+// route mints id, sets run_id = meta.run_id, created_at = unixepoch().
+export const InsightSuggestionRowSchema = z.object({
+    site_id: z.string().min(1),
+    run_date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+    desk: z.string().min(1),
+    suggestion_type: z.enum(['cluster', 'tracker']),
+    signal_type: z.enum(['demand', 'opportunity']),
+    is_best_bet: z.union([z.literal(0), z.literal(1)]),
+    best_bet_rank: z.number().int().positive().nullable(),
+    desk_rank: z.number().int().nonnegative(),
+    headline: z.string().min(1),
+    evidence: InsightEvidenceSchema,
+    brief: InsightBriefSchema,
+    intent_key: z.string().min(1),
+    beat: z.enum(['defense', 'intelligence', 'diplomacy', 'analysis']).nullable(),
+});
+export const InsightsIngestMetaSchema = z.object({
+    event_id: z.string().min(1),
+    run_id: z.string().min(1),
+    site_id: z.string().min(1),
+    run_date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+    run_attempt: z.number().int().positive(),
+    generated_at: z.number().int().positive(),
+    content_hash: z.string().min(1),
+    status: z.enum(['running', 'completed', 'partial', 'failed']),
+    counts: z.object({
+        demand_count: z.number().int().nonnegative(),
+        opportunity_count: z.number().int().nonnegative(),
+    }),
+    error: z.string().nullable().optional(),
+});
+export const InsightsIngestPayloadSchema = z
+    .object({
+    meta: InsightsIngestMetaSchema,
+    rows: z.array(InsightSuggestionRowSchema),
+})
+    // Every row's (site_id, run_date) must match meta (the route scopes the
+    // replace DELETE by meta.site_id + meta.run_date — never run_date alone).
+    .superRefine((payload, ctx) => {
+    for (const [i, row] of payload.rows.entries()) {
+        if (row.site_id !== payload.meta.site_id || row.run_date !== payload.meta.run_date) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ['rows', i],
+                message: 'row (site_id, run_date) must equal meta (site_id, run_date)',
+            });
+        }
+    }
+});
+//# sourceMappingURL=insights-ingest.js.map

package/dist/schema/insights-ingest.js.map

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

package/dist/schema/migrations.d.ts

@@ -0,0 +1,63 @@
+/**
+ * The full CMS schema as a single SQL string. Byte-identical in intent to
+ * migrations/0001_create_cms_tables.sql. Statements are separated by `;` and
+ * may be split with {@link splitStatements} for drivers that require one
+ * statement per call (e.g. D1's `exec`).
+ *
+ * Divergence preserved: `media_assets` timestamps are TEXT `datetime('now')`
+ * while content tables are INTEGER `unixepoch()`. Do not normalize.
+ */
+export declare const CMS_MIGRATION_SQL = "\nCREATE TABLE content_items (\n  id TEXT PRIMARY KEY,\n  type TEXT NOT NULL CHECK (type IN ('article','video','podcast','newsletter')),\n  status TEXT NOT NULL CHECK (status IN ('draft','scheduled','published','archived')),\n  visibility TEXT NOT NULL CHECK (visibility IN ('free','premium')),\n  slug TEXT NOT NULL UNIQUE,\n  title TEXT NOT NULL,\n  seo_title TEXT,\n  description TEXT,\n  excerpt TEXT,\n  byline TEXT,\n  channel TEXT,\n  primary_topic TEXT,\n  featured INTEGER NOT NULL DEFAULT 0,\n  author_id TEXT,\n  hero_image_id TEXT,\n  hero_image_alt TEXT,\n  hero_image_caption TEXT,\n  social_image_id TEXT,\n  canonical_url TEXT,\n  publish_at INTEGER,\n  published_at INTEGER,\n  created_at INTEGER NOT NULL DEFAULT (unixepoch()),\n  updated_at INTEGER NOT NULL DEFAULT (unixepoch()),\n  publish_tz TEXT NOT NULL DEFAULT 'Europe/Paris',\n  ai_locked_fields TEXT NOT NULL DEFAULT '[]',\n  published_revision_id TEXT,\n  FOREIGN KEY (author_id) REFERENCES authors(id)\n);\nCREATE INDEX idx_content_items_status ON content_items(status);\nCREATE INDEX idx_content_items_type ON content_items(type);\nCREATE INDEX idx_content_items_publish_at ON content_items(publish_at DESC);\nCREATE INDEX idx_content_items_channel ON content_items(channel);\nCREATE INDEX idx_content_items_author_id ON content_items(author_id);\nCREATE INDEX idx_content_items_topic_status_type_published\n  ON content_items(primary_topic, status, type, published_at DESC);\nCREATE INDEX idx_content_items_published_at ON content_items(published_at DESC);\nCREATE TABLE article_content (\n  content_id TEXT PRIMARY KEY,\n  body_markdown TEXT NOT NULL,\n  body_html TEXT,\n  word_count INTEGER,\n  read_time_minutes INTEGER,\n  subtitle TEXT,\n  ai_takeaways TEXT,\n  ai_takeaways_at INTEGER,\n  ai_takeaways_model TEXT,\n  editor_takeaways TEXT,\n  ai_takeaways_correlation_id TEXT,\n  faq_correlation_id TEXT,\n  faq_generated_at INTEGER,\n  faq_model TEXT,\n  FOREIGN KEY (content_id) REFERENCES content_items(id) ON DELETE CASCADE\n);\nCREATE TABLE video_content (\n  content_id TEXT PRIMARY KEY,\n  script TEXT NOT NULL,\n  video_id TEXT NOT NULL,\n  duration_seconds INTEGER,\n  thumbnail_image_id TEXT,\n  processing_state TEXT NOT NULL DEFAULT 'pending'\n    CHECK (processing_state IN ('pending','queued','fetching','transcribing','transcoding','ready','failed')),\n  processing_correlation_id TEXT,\n  processing_started_at INTEGER,\n  processing_completed_at INTEGER,\n  processing_last_event_at INTEGER,\n  processing_error TEXT,\n  processing_source_url TEXT,\n  processing_source_kind TEXT,\n  source_fetched INTEGER NOT NULL DEFAULT 0,\n  transcript_ready INTEGER NOT NULL DEFAULT 0,\n  hls_ready INTEGER NOT NULL DEFAULT 0,\n  transcript_url TEXT,\n  hls_manifest_url TEXT,\n  hls_poster_url TEXT,\n  FOREIGN KEY (content_id) REFERENCES content_items(id) ON DELETE CASCADE\n);\nCREATE TABLE podcast_content (\n  content_id TEXT PRIMARY KEY,\n  transcript TEXT NOT NULL,\n  audio_r2_key TEXT NOT NULL,\n  duration_seconds INTEGER,\n  FOREIGN KEY (content_id) REFERENCES content_items(id) ON DELETE CASCADE\n);\nCREATE TABLE content_revisions (\n  id TEXT PRIMARY KEY,\n  content_id TEXT NOT NULL,\n  payload_json TEXT NOT NULL,\n  created_at INTEGER NOT NULL DEFAULT (unixepoch()),\n  created_by TEXT,\n  FOREIGN KEY (content_id) REFERENCES content_items(id) ON DELETE CASCADE\n);\nCREATE TABLE content_tags (\n  id TEXT PRIMARY KEY,\n  slug TEXT NOT NULL UNIQUE,\n  label TEXT NOT NULL\n);\nCREATE TABLE content_tag_links (\n  content_id TEXT NOT NULL,\n  tag_id TEXT NOT NULL,\n  PRIMARY KEY (content_id, tag_id),\n  FOREIGN KEY (content_id) REFERENCES content_items(id) ON DELETE CASCADE,\n  FOREIGN KEY (tag_id) REFERENCES content_tags(id) ON DELETE CASCADE\n);\nCREATE TABLE content_relations (\n  content_id TEXT NOT NULL,\n  related_id TEXT NOT NULL,\n  rank INTEGER NOT NULL DEFAULT 0,\n  reason TEXT,\n  PRIMARY KEY (content_id, related_id),\n  FOREIGN KEY (content_id) REFERENCES content_items(id) ON DELETE CASCADE,\n  FOREIGN KEY (related_id) REFERENCES content_items(id) ON DELETE CASCADE\n);\nCREATE TABLE media_assets (\n  id TEXT PRIMARY KEY,\n  site_id TEXT NOT NULL DEFAULT 'fronts',\n  asset_type TEXT NOT NULL DEFAULT 'image',\n  source_type TEXT,\n  original_filename TEXT,\n  status TEXT NOT NULL DEFAULT 'ready',\n  object_key TEXT,\n  public_url TEXT,\n  url TEXT,\n  width INTEGER,\n  height INTEGER,\n  variants_json TEXT,\n  r2_binding TEXT,\n  created_at TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at TEXT NOT NULL DEFAULT (datetime('now')),\n  pinned INTEGER NOT NULL DEFAULT 0\n);\nCREATE INDEX idx_media_assets_site_id ON media_assets(site_id);\nCREATE INDEX idx_media_assets_object_key ON media_assets(object_key);\nCREATE INDEX idx_media_assets_type_status ON media_assets(asset_type, status);\nCREATE INDEX idx_media_assets_pinned_created ON media_assets(pinned DESC, created_at DESC);\nCREATE TABLE authors (\n  id TEXT PRIMARY KEY,\n  name TEXT NOT NULL,\n  slug TEXT NOT NULL UNIQUE,\n  bio TEXT,\n  avatar TEXT,\n  email TEXT,\n  social TEXT,\n  created_at INTEGER NOT NULL DEFAULT (strftime('%s','now')),\n  updated_at INTEGER NOT NULL DEFAULT (strftime('%s','now'))\n);\nCREATE TABLE foundry_callback_events (\n  event_id TEXT PRIMARY KEY,\n  event_kind TEXT NOT NULL,\n  correlation_id TEXT NOT NULL,\n  received_at INTEGER NOT NULL DEFAULT (unixepoch())\n);\n";
+/**
+ * Split {@link CMS_MIGRATION_SQL} into individual statements. Naive `;`-split is
+ * safe here because the contract contains no semicolons inside string literals
+ * or triggers. Empty fragments (whitespace/comments) are dropped.
+ */
+export declare function splitStatements(sql: string): string[];
+/** Minimal structural shape of a D1Database, to avoid a hard dependency here. */
+interface D1Like {
+    exec(query: string): Promise<unknown>;
+}
+/**
+ * Masthead migrations layered on the 0001 baseline (spec §4). Applied in order
+ * AFTER CMS_MIGRATION_SQL. Same constraints as the baseline: no `;` inside a
+ * string literal or trigger (splitStatements is a naive `;`-split), statements
+ * semicolon-terminated, whitespace collapsed before D1 exec. AND: no `--`
+ * comments inside an inlined block — the whitespace-collapse would fold a
+ * comment onto the same line as the next statement and comment it out (the
+ * `.sql` files DO carry a leading `--` header; the alignment test strips it).
+ *
+ * 0002 is a TABLE REBUILD (D1 can't ALTER a CHECK in place); 0003+ are ADD
+ * COLUMN / CREATE TABLE. CRITICAL: seven tables (article_content, video_content,
+ * podcast_content, content_revisions, content_tag_links, content_relations, and
+ * content_contributors) reference content_items. The package declares those FKs
+ * ON DELETE CASCADE, but on the LIVE prod fronts-data DB some of those tables
+ * pre-date the package and carry NO `ON DELETE` clause (NO ACTION) — e.g.
+ * content_contributors from Fronts legacy migration 0035. The package's own
+ * `CREATE TABLE IF NOT EXISTS` NO-OPs against those pre-existing tables, so on
+ * prod neither a CASCADE nor a deferred pragma can be relied on to clear the child
+ * rows before the parent DROP. With FK enforcement ON (D1's default during apply),
+ * `DROP TABLE content_items` is REJECTED while ANY child still references it.
+ * So 0002 stashes each child into a `_cms0002_bk_*` table, then EXPLICITLY
+ * `DELETE FROM <child>` (clearing NO-ACTION *and* cascade references alike), does
+ * the parent rebuild, then restores the children from the stash. The explicit
+ * DELETE/restore is the load-bearing, FK-action-independent fix; the prepended
+ * `PRAGMA defer_foreign_keys = ON` is defense-in-depth only (it does not reliably
+ * span the per-statement exec runner). On an empty DB the stash/delete/restore is
+ * a no-op and the temp tables are dropped, so the net table set is unchanged.
+ */
+export declare const CMS_MIGRATIONS_0002_PLUS: {
+    id: string;
+    sql: string;
+}[];
+/**
+ * Apply the CMS schema to a D1 database one statement at a time. D1's `exec`
+ * is newline-sensitive (it treats each line as a complete statement), so each
+ * statement is flattened to a single line first. Intended for tests and
+ * provisioning tooling, NOT request-time use. Prefer
+ * `wrangler d1 migrations apply` for real deploys.
+ */
+export declare function applyMigrations(db: D1Like): Promise<void>;
+export type { CmsTableName } from './tables.js';
+export { CMS_TABLES } from './tables.js';
+//# sourceMappingURL=migrations.d.ts.map

package/dist/schema/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/schema/migrations.ts"],"names":[],"mappings":"AAYA;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,myKAyJ7B,CAAA;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAKrD;AAED,iFAAiF;AACjF,UAAU,MAAM;IACf,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,wBAAwB,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAgWjE,CAAA;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW/D;AAED,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG/C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA"}