@growth-labs/cms 0.1.0

package/dist/providers/null.js

@@ -0,0 +1,144 @@
+import { scoreDraft } from '../engine/seo.js';
+const empty = (data) => ({ status: 'empty', data });
+export const nullAnalytics = {
+    async getKpis() {
+        return empty({});
+    },
+    async getReadsTimeSeries() {
+        return empty([]);
+    },
+    async getTopContent() {
+        return empty([]);
+    },
+    async getTrafficSources() {
+        return empty([]);
+    },
+    async getArticleDetail(slug, range) {
+        return empty({
+            id: slug,
+            slug,
+            title: '',
+            contentType: 'article',
+            range,
+            freshness: { status: 'empty' },
+            summary: {
+                reads: 0,
+                uniqueVisitors: 0,
+                sessions: 0,
+                avgReadSeconds: 0,
+                paidStarts: 0,
+                attributedRevenueCents: 0,
+                attributedAmountCents: 0,
+                attributedRevenueCurrency: 'USD',
+                revenueBackedStarts: 0,
+                conversionRateByReads: 0,
+                conversionRateBySessions: 0,
+            },
+            scrollDepth: {
+                scroll25: 0,
+                scroll50: 0,
+                scroll75: 0,
+                scroll90: 0,
+                scroll25Rate: 0,
+                scroll50Rate: 0,
+                scroll75Rate: 0,
+                scroll90Rate: 0,
+            },
+            readsTimeSeries: [],
+            sources: [],
+        });
+    },
+};
+export const nullSubscriptions = {
+    async listMembers() {
+        return empty([]);
+    },
+    async getKpis() {
+        return empty({});
+    },
+    async getPlanMix() {
+        return empty([]);
+    },
+    resolvePlanName(variantId) {
+        return variantId;
+    },
+    async exportMembers() {
+        return empty('');
+    },
+    async createGift() {
+        return empty({ id: '' });
+    },
+    async detectDuplicates() {
+        return empty({
+            billingConflicts: [],
+            canonicalConflicts: [],
+            summary: { billingConflictGroups: 0, canonicalConflictGroups: 0, impactedAccounts: 0 },
+        });
+    },
+    async importLsEntitlements(opts) {
+        // No-op WRITE — nothing to sync without a configured provider. Echo the
+        // requested dryRun so the screen renders an honest zeroed summary.
+        return empty({
+            dryRun: opts.dryRun,
+            synced: 0,
+            usersCreated: 0,
+            usersUpdated: 0,
+            subscriptionsCreated: 0,
+            subscriptionsUpdated: 0,
+            createdEmails: [],
+            updatedEmails: [],
+        });
+    },
+    async listGifts(query) {
+        return empty({
+            rows: [],
+            total: 0,
+            page: query.page,
+            pageSize: query.pageSize,
+            totalPages: 0,
+            summary: { redeemed: 0, pendingClaim: 0 },
+        });
+    },
+};
+export const nullIdentity = {
+    async getSubject() {
+        return null;
+    },
+    async mintOrAttachAccount() {
+        throw new Error('IdentityProvider not configured');
+    },
+};
+export const defaultSeo = {
+    async scoreDraft(input) {
+        return scoreDraft(input);
+    },
+};
+export const nullSearch = {
+    async query() {
+        return empty([]);
+    },
+};
+export const nullSettings = {
+    async listDomains() {
+        return empty([]);
+    },
+    async getIntegrations() {
+        return empty({
+            r2: null,
+            foundry: null,
+            lemonsqueezy: null,
+            customerio: null,
+            search: null,
+            webpush: null,
+        });
+    },
+};
+export const nullProviders = {
+    analytics: nullAnalytics,
+    subscriptions: nullSubscriptions,
+    identity: nullIdentity,
+    seo: defaultSeo,
+    search: nullSearch,
+    settings: nullSettings,
+};
+//# sourceMappingURL=null.js.map

package/dist/providers/null.js.map

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

package/dist/providers/types.d.ts

@@ -0,0 +1,277 @@
+import type { SeoScoreInput, SeoScoreResult } from '../engine/seo.js';
+export type ProviderStatus = 'live' | 'partial' | 'empty';
+export interface ProviderResult<T> {
+    status: ProviderStatus;
+    data: T;
+}
+export interface DateRange {
+    from: number;
+    to: number;
+}
+export interface ArticleAnalyticsSource {
+    source: string;
+    medium: string;
+    campaign: string;
+    derivedSource: string;
+    reads: number;
+    uniqueVisitors: number;
+    sessions: number;
+    paidStarts: number;
+}
+export interface ArticleAnalyticsDetail {
+    id: string;
+    slug: string;
+    title: string;
+    contentType: string;
+    status?: string;
+    canonicalUrl?: string;
+    editUrl?: string;
+    range: DateRange;
+    freshness?: {
+        latestDate?: string;
+        status: ProviderStatus;
+    };
+    summary: {
+        reads: number;
+        uniqueVisitors: number;
+        sessions: number;
+        avgReadSeconds: number;
+        paidStarts: number;
+        attributedRevenueCents: number;
+        attributedAmountCents: number;
+        attributedRevenueCurrency: string;
+        revenueBackedStarts: number;
+        conversionRateByReads: number;
+        conversionRateBySessions: number;
+    };
+    scrollDepth: {
+        scroll25: number;
+        scroll50: number;
+        scroll75: number;
+        scroll90: number;
+        scroll25Rate: number;
+        scroll50Rate: number;
+        scroll75Rate: number;
+        scroll90Rate: number;
+    };
+    readsTimeSeries: Array<{
+        t: number;
+        reads: number;
+    }>;
+    sources: ArticleAnalyticsSource[];
+}
+export interface AnalyticsProvider {
+    getKpis(range: DateRange): Promise<ProviderResult<Record<string, number>>>;
+    getReadsTimeSeries(range: DateRange): Promise<ProviderResult<Array<{
+        t: number;
+        reads: number;
+    }>>>;
+    getTopContent(range: DateRange): Promise<ProviderResult<Array<{
+        id: string;
+        title: string;
+        reads: number;
+    }>>>;
+    getTrafficSources(range: DateRange): Promise<ProviderResult<Array<{
+        source: string;
+        sessions: number;
+    }>>>;
+    getArticleDetail(slug: string, range: DateRange): Promise<ProviderResult<ArticleAnalyticsDetail>>;
+}
+export interface SubscriptionMember {
+    id: string;
+    email: string | null;
+    planVariantId: string | null;
+    status: string | null;
+}
+/** A set of accounts that share one normalized LemonSqueezy billing email. */
+export interface BillingConflictGroup {
+    billingEmail: string;
+    accountCount: number;
+    userIds: string[];
+    accountEmails: string[];
+    subscriptionIds: string[];
+    lastSeenAt: number | null;
+}
+/** A set of accounts whose canonical email (gmail dot/plus-folded) collides. */
+export interface CanonicalConflictGroup {
+    canonicalEmail: string;
+    accountCount: number;
+    userIds: string[];
+    accountEmails: string[];
+    lastSeenAt: number | null;
+}
+export interface DuplicateAccountsReport {
+    billingConflicts: BillingConflictGroup[];
+    canonicalConflicts: CanonicalConflictGroup[];
+    summary: {
+        billingConflictGroups: number;
+        canonicalConflictGroups: number;
+        impactedAccounts: number;
+    };
+}
+/** Options for the LemonSqueezy entitlement sync (a host-side WRITE). */
+export interface LsImportOptions {
+    /** Preview only — count what would sync, mutate nothing. */
+    dryRun: boolean;
+    /** Restrict the sync to a single LemonSqueezy store. */
+    storeId?: string;
+    /** Include LemonSqueezy test-mode subscriptions in the sync. */
+    includeTest: boolean;
+}
+/** Summary the sync returns: counts of users/subscriptions created or updated. */
+export interface LsImportSummary {
+    dryRun: boolean;
+    synced: number;
+    usersCreated: number;
+    usersUpdated: number;
+    subscriptionsCreated: number;
+    subscriptionsUpdated: number;
+    createdEmails: string[];
+    updatedEmails: string[];
+}
+/** A single gift order with its claim/delivery + linked-subscription state. */
+export interface GiftOrderRow {
+    id: string;
+    gifterEmail: string;
+    gifterName: string | null;
+    recipientEmail: string;
+    recipientName: string | null;
+    giftMessage: string | null;
+    subscriptionId: string | null;
+    lemonsqueezyOrderId: string | null;
+    planType: string;
+    durationDays: number;
+    status: string;
+    redeemedAt: number | null;
+    createdAt: number;
+    updatedAt: number;
+    subscriptionStatus: string | null;
+    currentPeriodStart: number | null;
+    currentPeriodEnd: number | null;
+}
+/** Query for the paginated gift-orders list. */
+export interface GiftOrdersQuery {
+    q?: string;
+    status?: string;
+    page: number;
+    pageSize: number;
+}
+export interface GiftOrdersPage {
+    rows: GiftOrderRow[];
+    total: number;
+    page: number;
+    pageSize: number;
+    totalPages: number;
+    summary: {
+        redeemed: number;
+        pendingClaim: number;
+    };
+}
+export interface SubscriptionsProvider {
+    listMembers(filter: Record<string, string | undefined>, page: number): Promise<ProviderResult<SubscriptionMember[]>>;
+    getKpis(): Promise<ProviderResult<Record<string, number | null>>>;
+    getPlanMix(): Promise<ProviderResult<Array<{
+        plan: string;
+        count: number;
+    }>>>;
+    resolvePlanName(variantId: string): string;
+    exportMembers(fmt: 'csv' | 'json'): Promise<ProviderResult<string>>;
+    createGift(input: {
+        email: string;
+        planVariantId: string;
+    }): Promise<ProviderResult<{
+        id: string;
+    }>>;
+    /**
+     * Detect accounts that collide on billing email or canonical (gmail-folded)
+     * email — READ-only. Legacy: GET /admin/api/duplicate-accounts.
+     */
+    detectDuplicates(): Promise<ProviderResult<DuplicateAccountsReport>>;
+    /**
+     * Trigger the LemonSqueezy → DB entitlement sync — a privileged WRITE on the
+     * host side (creates/updates users + subscriptions). The provider runs it and
+     * returns a summary. Legacy: POST /admin/api/import-ls-entitlements.
+     */
+    importLsEntitlements(opts: LsImportOptions): Promise<ProviderResult<LsImportSummary>>;
+    /**
+     * List gift orders with claim/delivery tracking — READ-only, paginated.
+     * Legacy: GET /admin/api/gifts.
+     */
+    listGifts(query: GiftOrdersQuery): Promise<ProviderResult<GiftOrdersPage>>;
+}
+/** Thin identity seam — the CMS never mints identity (spec §3.3/§12). */
+export interface IdentityProvider {
+    getSubject(ctx: unknown): Promise<string | null>;
+    mintOrAttachAccount(email: string): Promise<{
+        subject: string;
+    }>;
+}
+export interface LlmDispatchInput {
+    task: string;
+    prompt: string;
+    stream?: boolean;
+}
+export type LlmDispatchResult = {
+    text: string;
+    status?: 'ok';
+} | {
+    text: string;
+    status: 'unavailable';
+    reason?: string;
+} | ReadableStream;
+export interface LlmDispatch {
+    dispatch(input: LlmDispatchInput): Promise<LlmDispatchResult>;
+}
+export interface FoundryJobSpec {
+    contentId: string;
+    sourceUrl: string;
+    sourceKind?: string;
+    kind: string;
+    videoId?: string;
+    title?: string;
+    description?: string | null;
+    processingTriggerTokenHash?: string;
+}
+export interface FoundryDispatch {
+    dispatchVideo(jobSpec: FoundryJobSpec): Promise<{
+        correlationId: string;
+    }>;
+    getJob(correlationId: string): Promise<{
+        state: string;
+    } | null>;
+}
+export interface SeoProvider {
+    scoreDraft(input: SeoScoreInput): Promise<SeoScoreResult>;
+}
+export interface SearchProvider {
+    query(q: string): Promise<ProviderResult<Array<{
+        id: string;
+        title: string;
+        type: string;
+    }>>>;
+}
+export interface CmsDomain {
+    hostname: string;
+    status?: string | null;
+    primary?: boolean;
+    zone?: string | null;
+}
+export interface CmsIntegrationStatus {
+    status: ProviderStatus;
+    configured?: boolean;
+    label?: string;
+    detail?: string | null;
+}
+export interface SettingsProvider {
+    listDomains(): Promise<ProviderResult<CmsDomain[]>>;
+    getIntegrations(): Promise<ProviderResult<Record<string, CmsIntegrationStatus | null>>>;
+}
+export interface CmsProviders {
+    analytics: AnalyticsProvider;
+    subscriptions: SubscriptionsProvider;
+    identity: IdentityProvider;
+    seo: SeoProvider;
+    search: SearchProvider;
+    settings: SettingsProvider;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/providers/types.d.ts.map

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

package/dist/providers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":""}

package/dist/routes/ai.d.ts

@@ -0,0 +1,25 @@
+import type { CmsRouteConfig } from './config.js';
+import { type RouteContext } from './context.js';
+export interface AiRouteHandlers {
+    /** POST /content/:id/ai/proofread — SSE streaming proofread & tighten. */
+    proofreadAndTighten(ctx: RouteContext): Promise<Response>;
+    /** POST /content/:id/ai/headlines — SSE streaming 5-headline suggestions. */
+    suggestHeadlines(ctx: RouteContext): Promise<Response>;
+    /** POST /content/:id/ai/takeaways — sync: generate + persist 3 key takeaways. */
+    generateKeyTakeaways(ctx: RouteContext): Promise<Response>;
+    /** POST /content/:id/ai/meta-description — sync: draft + persist meta description (<160 chars). */
+    draftMetaDescription(ctx: RouteContext): Promise<Response>;
+    /** POST /content/:id/ai/og-image — render + persist a social-card OG image via the injected OgImageRenderer. */
+    generateOgImage(ctx: RouteContext): Promise<Response>;
+}
+/**
+ * Clamp a meta description to at most `limit` characters, breaking at a word
+ * boundary. Trailing whitespace is trimmed from the result.
+ *
+ * Algorithm: if the text is already within the limit, return it unchanged.
+ * Otherwise find the last space at or before position `limit` and cut there.
+ * If there is no space before `limit`, perform a hard cut at `limit`.
+ */
+export declare function clampMeta(text: string, limit: number): string;
+export declare function createAiRoutes(config: CmsRouteConfig): AiRouteHandlers;
+//# sourceMappingURL=ai.d.ts.map

package/dist/routes/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/routes/ai.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,OAAO,EAAqC,KAAK,YAAY,EAAa,MAAM,cAAc,CAAA;AAkB9F,MAAM,WAAW,eAAe;IAC/B,0EAA0E;IAC1E,mBAAmB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IACzD,6EAA6E;IAC7E,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IACtD,iFAAiF;IACjF,oBAAoB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1D,mGAAmG;IACnG,oBAAoB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1D,gHAAgH;IAChH,eAAe,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;CACrD;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAY7D;AA2FD,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,eAAe,CAkStE"}