@fayz-ai/plugin-marketing 0.1.1

package/dist/views/dashboardWidgets.d.ts

@@ -0,0 +1,11 @@
+import type { StoreApi } from 'zustand';
+import type { DashboardWidgetDef } from '@fayz-ai/core';
+import { type ResolvedMarketingConfig } from '../MarketingContext';
+import type { MarketingDataProvider } from '../data/types';
+import type { MarketingUIState } from '../store';
+export declare function createMarketingDashboardWidgets(ctx: {
+    config: ResolvedMarketingConfig;
+    provider: MarketingDataProvider;
+    store: StoreApi<MarketingUIState>;
+}): DashboardWidgetDef[];
+//# sourceMappingURL=dashboardWidgets.d.ts.map

package/dist/views/dashboardWidgets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboardWidgets.d.ts","sourceRoot":"","sources":["../../src/views/dashboardWidgets.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAMvD,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAkIhD,wBAAgB,+BAA+B,CAAC,GAAG,EAAE;IACnD,MAAM,EAAE,uBAAuB,CAAA;IAC/B,QAAQ,EAAE,qBAAqB,CAAA;IAC/B,KAAK,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAA;CAClC,GAAG,kBAAkB,EAAE,CAuBvB"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@fayz-ai/plugin-marketing",
+  "version": "0.1.1",
+  "description": "Fayz SDK — marketing campaigns & broadcasts plugin",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "dependencies": {
+    "@tanstack/react-table": "^8.20.0",
+    "lucide-react": "^0.400.0",
+    "zustand": "^4.5.0",
+    "@fayz-ai/ui": "^0.1.6",
+    "@fayz-ai/saas": "^0.1.6",
+    "@fayz-ai/core": "^0.1.6"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.0",
+    "react": "^18.3.0",
+    "tsup": "^8.2.0",
+    "typescript": "^5.5.0",
+    "@types/react-dom": "^18.3.0"
+  },
+  "license": "MIT",
+  "keywords": [
+    "fayz",
+    "fayz-plugin",
+    "fayz-sdk"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup && tsc --emitDeclarationOnly --declaration --declarationMap --noEmit false",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}

package/src/MarketingContext.tsx

@@ -0,0 +1,39 @@
+import React from 'react'
+import { createPluginContext } from '@fayz-ai/saas'
+import type { AcquisitionChannel, ConversionModel } from './types'
+import type { MarketingCurrency } from './format'
+import type { MarketingDomainModules } from './presets'
+import type { MarketingDataProvider } from './data/types'
+import type { MarketingUIState } from './store'
+
+export interface MarketingLabels {
+  pageTitle: string
+  pageSubtitle: string
+  overview: string
+  channels: string
+  campaigns: string
+  funnel: string
+  landingPages: string
+  settings: string
+}
+
+export interface ResolvedMarketingConfig {
+  conversion: ConversionModel
+  channels: AcquisitionChannel[]
+  modules: MarketingDomainModules
+  currency: MarketingCurrency
+  labels: MarketingLabels
+}
+
+const ctx = createPluginContext<ResolvedMarketingConfig, MarketingDataProvider, MarketingUIState>('MarketingPage')
+
+export const MarketingContextProvider = ctx.ContextProvider
+export const useMarketingConfig = ctx.useConfig
+export const useMarketingProvider = ctx.useProvider
+export const useMarketingStore = ctx.useStore
+
+/** Convenience: look up a channel definition by id. */
+export function useChannelLookup(): Map<string, AcquisitionChannel> {
+  const { channels } = useMarketingConfig()
+  return React.useMemo(() => new Map(channels.map((c) => [c.id, c])), [channels])
+}

package/src/MarketingPage.tsx

@@ -0,0 +1,94 @@
+import React from 'react'
+import type { StoreApi } from 'zustand/vanilla'
+import { ModulePage, type ModuleNavItem } from '@fayz-ai/ui'
+import { useTranslation } from '@fayz-ai/core'
+import type { PluginQuickAction } from '@fayz-ai/core'
+import { useModuleNavigation, ModuleActionBar, createViewRouter } from '@fayz-ai/saas'
+import { MarketingContextProvider, type ResolvedMarketingConfig } from './MarketingContext'
+import type { MarketingDataProvider } from './data/types'
+import type { MarketingUIState } from './store'
+import { OverviewView } from './views/OverviewView'
+import { ChannelsView } from './views/ChannelsView'
+import { ChannelDetailView } from './views/ChannelDetailView'
+import { CampaignsView } from './views/CampaignsView'
+import { FunnelView } from './views/FunnelView'
+import { LandingPagesView } from './views/LandingPagesView'
+
+function buildNav(
+  config: ResolvedMarketingConfig,
+  view: string,
+  navigate: (v: string) => void,
+): ModuleNavItem[] {
+  const items: ModuleNavItem[] = [
+    { id: 'overview', label: config.labels.overview, icon: 'BarChart3', active: view === 'overview', onClick: () => navigate('overview') },
+  ]
+  if (config.modules.channels) {
+    items.push({
+      id: 'channels', label: config.labels.channels, icon: 'Radio',
+      active: view === 'channels' || view.startsWith('channel-detail:'),
+      onClick: () => navigate('channels'),
+    })
+  }
+  if (config.modules.campaigns) {
+    items.push({ id: 'campaigns', label: config.labels.campaigns, icon: 'Megaphone', active: view === 'campaigns', onClick: () => navigate('campaigns') })
+  }
+  if (config.modules.funnel) {
+    items.push({ id: 'funnel', label: config.labels.funnel, icon: 'Filter', active: view === 'funnel', onClick: () => navigate('funnel') })
+  }
+  if (config.modules.landingPages) {
+    items.push({ id: 'landing-pages', label: config.labels.landingPages, icon: 'LayoutTemplate', active: view === 'landing-pages', onClick: () => navigate('landing-pages') })
+  }
+  return items
+}
+
+export function MarketingPage({ config, provider, store }: {
+  config: ResolvedMarketingConfig
+  provider: MarketingDataProvider
+  store: StoreApi<MarketingUIState>
+}) {
+  const t = useTranslation()
+  const { view, direction, navigate } = useModuleNavigation('/marketing', {
+    overview: 0, channels: 0, campaigns: 0, funnel: 0, 'landing-pages': 0,
+    'channel-detail': 1,
+  }, 'overview')
+
+  React.useEffect(() => { void store.getState().load() }, [store])
+
+  const isOverview = view === 'overview'
+  const nav = buildNav(config, view, navigate)
+
+  const quickActions = React.useMemo<PluginQuickAction[]>(() => [
+    { id: 'new-campaign', label: t('marketing.campaigns.new'), icon: 'Megaphone', description: config.labels.campaigns, action: () => navigate('campaigns') },
+  ], [t, config.labels.campaigns])
+
+  const renderView = createViewRouter([
+    { id: 'channels', render: () => <ChannelsView onOpen={(id) => navigate(`channel-detail:${id}`)} /> },
+    { id: 'channel-detail', render: ({ id }) => <ChannelDetailView channelId={id!} onBack={() => navigate('channels')} /> },
+    { id: 'campaigns', render: () => <CampaignsView /> },
+    { id: 'funnel', render: () => <FunnelView /> },
+    { id: 'landing-pages', render: () => <LandingPagesView /> },
+    { id: 'overview', render: () => <OverviewView /> },
+  ], 'overview')
+
+  return (
+    <MarketingContextProvider config={config} provider={provider} store={store}>
+      <ModulePage
+        title={config.labels.pageTitle}
+        subtitle={config.labels.pageSubtitle}
+        nav={nav}
+        showHeader={isOverview}
+        viewKey={view}
+        direction={direction}
+        headerAction={
+          <ModuleActionBar
+            quickActions={quickActions}
+            settingsPath="/settings/marketing"
+            settingsLabel={config.labels.pageTitle}
+          />
+        }
+      >
+        {renderView(view)}
+      </ModulePage>
+    </MarketingContextProvider>
+  )
+}

package/src/components/MarketingBits.tsx

@@ -0,0 +1,131 @@
+import React from 'react'
+import { ArrowDownRight, ArrowUpRight } from 'lucide-react'
+import { cn, SegmentedControl } from '@fayz-ai/ui'
+import { useTranslation } from '@fayz-ai/core'
+import type { CampaignStatus, DateRangeKey } from '../types'
+import { trendDelta } from '../format'
+import { useMarketingStore } from '../MarketingContext'
+import { ChannelIcon } from './icons'
+import { useChannelLookup } from '../MarketingContext'
+
+// ---------------------------------------------------------------------------
+// KPI card with optional trend chip.
+// ---------------------------------------------------------------------------
+
+export function KpiCard({
+  icon: Icon, label, value, sub, current, previous, invertTrend,
+}: {
+  icon: React.ComponentType<{ className?: string }>
+  label: string
+  value: string
+  sub?: string
+  current?: number
+  previous?: number
+  /** for cost-style metrics where down is good (e.g. CPA) */
+  invertTrend?: boolean
+}) {
+  const trend = current != null && previous != null ? trendDelta(current, previous) : null
+  const good = trend ? (invertTrend ? trend.dir === 'down' : trend.dir === 'up') : false
+  const bad = trend ? (invertTrend ? trend.dir === 'up' : trend.dir === 'down') : false
+  return (
+    <div className="rounded-card border border-border bg-card p-4">
+      <div className="flex items-center gap-2 text-muted-foreground">
+        <Icon className="h-4 w-4" />
+        <span className="text-xs font-medium">{label}</span>
+      </div>
+      <div className="mt-2 flex items-end justify-between gap-2">
+        <p className="text-2xl font-semibold text-foreground">{value}</p>
+        {trend && trend.dir !== 'neutral' && (
+          <span className={cn(
+            'mb-0.5 inline-flex items-center gap-0.5 text-xs font-medium',
+            good && 'text-emerald-600', bad && 'text-rose-600',
+            !good && !bad && 'text-muted-foreground',
+          )}>
+            {trend.dir === 'up' ? <ArrowUpRight className="h-3 w-3" /> : <ArrowDownRight className="h-3 w-3" />}
+            {trend.pct.toFixed(0)}%
+          </span>
+        )}
+      </div>
+      {sub && <p className="mt-0.5 text-xs text-muted-foreground">{sub}</p>}
+    </div>
+  )
+}
+
+// ---------------------------------------------------------------------------
+// Date-range selector (segmented). Reads/writes the shared store range.
+// ---------------------------------------------------------------------------
+
+const RANGES: DateRangeKey[] = ['7d', '30d', '90d']
+
+export function RangeTabs() {
+  const range = useMarketingStore((s) => s.range)
+  const setRange = useMarketingStore((s) => s.setRange)
+  return (
+    <SegmentedControl
+      options={RANGES}
+      value={range}
+      onChange={(r) => void setRange(r)}
+      aria-label="Time range"
+    />
+  )
+}
+
+// ---------------------------------------------------------------------------
+// Status badge for campaigns.
+// ---------------------------------------------------------------------------
+
+const STATUS_STYLE: Record<CampaignStatus, string> = {
+  active: 'bg-emerald-100 text-emerald-700',
+  paused: 'bg-amber-100 text-amber-700',
+  ended: 'bg-muted text-muted-foreground',
+  draft: 'bg-slate-100 text-slate-600',
+}
+
+export function StatusBadge({ status }: { status: CampaignStatus }) {
+  const t = useTranslation()
+  return (
+    <span className={cn('rounded-full px-2 py-0.5 text-xs font-medium capitalize', STATUS_STYLE[status])}>
+      {t(`marketing.status.${status}`)}
+    </span>
+  )
+}
+
+// ---------------------------------------------------------------------------
+// Channel cell (icon + label) used in tables.
+// ---------------------------------------------------------------------------
+
+export function ChannelCell({ channelId }: { channelId: string }) {
+  const lookup = useChannelLookup()
+  const ch = lookup.get(channelId)
+  return (
+    <span className="inline-flex items-center gap-1.5 text-foreground">
+      <ChannelIcon name={ch?.icon ?? 'Link2'} className="h-3.5 w-3.5 text-muted-foreground" />
+      {ch?.label ?? channelId}
+    </span>
+  )
+}
+
+// ---------------------------------------------------------------------------
+// Horizontal proportion bar (funnel / channel-mix), no charting dep.
+// ---------------------------------------------------------------------------
+
+export function ProportionBar({ value, max, color, label, right }: {
+  value: number
+  max: number
+  color: string
+  label: React.ReactNode
+  right?: React.ReactNode
+}) {
+  const pct = max > 0 ? Math.max((value / max) * 100, 2) : 0
+  return (
+    <div className="flex items-center gap-3">
+      <div className="w-32 shrink-0 text-sm text-muted-foreground">{label}</div>
+      <div className="h-7 flex-1 overflow-hidden rounded-md bg-muted/40">
+        <div className="flex h-full items-center rounded-md px-2 text-xs font-semibold"
+          style={{ width: `${pct}%`, backgroundColor: color + '26', color }}>
+          {right}
+        </div>
+      </div>
+    </div>
+  )
+}

package/src/components/icons.tsx

@@ -0,0 +1,17 @@
+import React from 'react'
+import {
+  Search, Megaphone, Globe, Mail, Users, MousePointerClick,
+  Instagram, MessageCircle, DoorOpen, Utensils, Bike, Link2,
+} from 'lucide-react'
+
+// Channel icon names referenced by presets → lucide components. Falls back to
+// a generic link icon for anything unmapped.
+const ICONS: Record<string, React.ComponentType<{ className?: string }>> = {
+  Search, Megaphone, Globe, Mail, Users, MousePointerClick,
+  Instagram, MessageCircle, DoorOpen, Utensils, Bike,
+}
+
+export function ChannelIcon({ name, className }: { name: string; className?: string }) {
+  const Icon = ICONS[name] ?? Link2
+  return <Icon className={className} />
+}

package/src/data/mock.ts

@@ -0,0 +1,233 @@
+import type { MarketingDataProvider, SaveCampaignInput } from './types'
+import type {
+  AcquisitionChannel,
+  AcquisitionChannelKind,
+  Campaign,
+  ChannelPerformance,
+  ConversionModel,
+  DateRangeKey,
+  FunnelStage,
+  LandingPagePerf,
+  MarketingOverview,
+  MarketingQuery,
+} from '../types'
+import { CAMPAIGN_NAME_SEEDS, type MarketingDomain } from '../presets'
+
+// ---------------------------------------------------------------------------
+// Deterministic seed knobs (no Date.now at module init for stable analytics).
+// ---------------------------------------------------------------------------
+
+const RANGE_FACTOR: Record<DateRangeKey, number> = { '7d': 0.25, '30d': 1, '90d': 3.05 }
+const BASE_REACH = [4200, 3100, 2600, 1900, 1500, 1200, 1000]
+
+const KIND_LEAD_RATE: Record<AcquisitionChannelKind, number> = {
+  paid: 0.18, social: 0.22, organic: 0.14, referral: 0.3, direct: 0.1, outbound: 0.16,
+}
+const KIND_CONV_RATE: Record<AcquisitionChannelKind, number> = {
+  paid: 0.28, social: 0.25, organic: 0.32, referral: 0.45, direct: 0.22, outbound: 0.24,
+}
+const KIND_SPEND30: Record<AcquisitionChannelKind, number> = {
+  paid: 2800, social: 900, outbound: 600, organic: 0, referral: 0, direct: 0,
+}
+
+interface ChannelBase {
+  channelId: string
+  kind: AcquisitionChannelKind
+  reach: number
+  leads: number
+  conversions: number
+  spend: number
+  value: number
+}
+
+export interface MockMarketingConfig {
+  channels: AcquisitionChannel[]
+  conversion: ConversionModel
+  domain: MarketingDomain
+}
+
+function channelBase30(channels: AcquisitionChannel[], conversion: ConversionModel): ChannelBase[] {
+  return channels.map((ch, i) => {
+    const reach = BASE_REACH[i % BASE_REACH.length]
+    const leads = Math.round(reach * KIND_LEAD_RATE[ch.kind])
+    const conversions = Math.round(leads * KIND_CONV_RATE[ch.kind])
+    const spend = KIND_SPEND30[ch.kind]
+    const value = Math.round(conversions * conversion.avgValue)
+    return { channelId: ch.id, kind: ch.kind, reach, leads, conversions, spend, value }
+  })
+}
+
+function scale(n: number, range: DateRangeKey): number {
+  return Math.round(n * RANGE_FACTOR[range])
+}
+
+function toPerformance(base: ChannelBase, range: DateRangeKey): ChannelPerformance {
+  const reach = scale(base.reach, range)
+  const leads = scale(base.leads, range)
+  const conversions = scale(base.conversions, range)
+  const spend = scale(base.spend, range)
+  const value = scale(base.value, range)
+  return {
+    channelId: base.channelId,
+    reach, leads, conversions, spend, value,
+    cvr: reach > 0 ? (conversions / reach) * 100 : 0,
+    cpa: conversions > 0 && spend > 0 ? spend / conversions : 0,
+  }
+}
+
+function seedCampaigns(cfg: MockMarketingConfig): Campaign[] {
+  const names = CAMPAIGN_NAME_SEEDS[cfg.domain]
+  const base = channelBase30(cfg.channels, cfg.conversion)
+  const statuses: Campaign['status'][] = ['active', 'active', 'paused', 'ended', 'draft']
+  const startDays = [12, 26, 40, 8, 3]
+  const baseDate = new Date('2026-06-16T00:00:00Z').getTime()
+
+  return names.map((name, i) => {
+    const ch = cfg.channels[i % cfg.channels.length]
+    const b = base[i % base.length]
+    const status = statuses[i % statuses.length]
+    const draft = status === 'draft'
+    const start = new Date(baseDate - startDays[i % startDays.length] * 86_400_000).toISOString()
+    // Campaigns carry a slice of their channel's volume so totals stay plausible.
+    const share = 0.55 + (i % 3) * 0.12
+    return {
+      id: `cmp-${i + 1}`,
+      name,
+      channelId: ch.id,
+      status,
+      start,
+      end: status === 'ended' ? new Date(baseDate - 2 * 86_400_000).toISOString() : undefined,
+      spend: draft ? 0 : Math.round(b.spend * share),
+      reach: draft ? 0 : Math.round(b.reach * share),
+      leads: draft ? 0 : Math.round(b.leads * share),
+      conversions: draft ? 0 : Math.round(b.conversions * share),
+      value: draft ? 0 : Math.round(b.value * share),
+    }
+  })
+}
+
+function scaleCampaign(c: Campaign, range: DateRangeKey): Campaign {
+  if (c.status === 'draft') return c
+  return {
+    ...c,
+    spend: scale(c.spend, range),
+    reach: scale(c.reach, range),
+    leads: scale(c.leads, range),
+    conversions: scale(c.conversions, range),
+    value: scale(c.value, range),
+  }
+}
+
+function seedLandingPages(): Array<Omit<LandingPagePerf, 'cvr'>> {
+  // 30d baseline; scaled per range at read time.
+  return [
+    { id: 'lp-1', name: 'Free Consultation Funnel', type: 'Funnel', visits: 3820, conversions: 474 },
+    { id: 'lp-2', name: 'Summer Promo Landing', type: 'Landing page', visits: 1560, conversions: 126 },
+    { id: 'lp-3', name: 'Pricing Page', type: 'Landing page', visits: 2240, conversions: 198 },
+    { id: 'lp-4', name: 'Company Website', type: 'Website', visits: 9240, conversions: 296 },
+  ]
+}
+
+export function createMockMarketingProvider(cfg: MockMarketingConfig): MarketingDataProvider {
+  const base = channelBase30(cfg.channels, cfg.conversion)
+  const campaigns = seedCampaigns(cfg)
+  const landing = seedLandingPages()
+  let counter = 100
+
+  async function channelPerformance(query: MarketingQuery): Promise<ChannelPerformance[]> {
+    const list = base.map((b) => toPerformance(b, query.range))
+    return query.channelId ? list.filter((c) => c.channelId === query.channelId) : list
+  }
+
+  return {
+    channelPerformance,
+
+    async overview(query: MarketingQuery): Promise<MarketingOverview> {
+      const perf = await channelPerformance(query)
+      const reach = perf.reduce((s, c) => s + c.reach, 0)
+      const conversions = perf.reduce((s, c) => s + c.conversions, 0)
+      const spend = perf.reduce((s, c) => s + c.spend, 0)
+      const value = perf.reduce((s, c) => s + c.value, 0)
+      const cvr = reach > 0 ? (conversions / reach) * 100 : 0
+      const top = [...perf].sort((a, b) => b.conversions - a.conversions)[0]
+      return {
+        conversions,
+        conversionsPrev: Math.round(conversions * 0.86),
+        cvr,
+        cvrPrev: cvr * 0.94,
+        spend,
+        cpa: conversions > 0 && spend > 0 ? spend / conversions : 0,
+        value,
+        topChannelId: top?.channelId ?? null,
+        channelMix: perf.map((c) => ({ channelId: c.channelId, conversions: c.conversions })),
+      }
+    },
+
+    async funnel(query: MarketingQuery): Promise<FunnelStage[]> {
+      const perf = await channelPerformance(query)
+      const reach = perf.reduce((s, c) => s + c.reach, 0)
+      const leads = perf.reduce((s, c) => s + c.leads, 0)
+      const conversions = perf.reduce((s, c) => s + c.conversions, 0)
+      const qualified = Math.round(leads * 0.62)
+      return [
+        { id: 'reach', label: 'Reach / visits', count: reach, color: '#6366f1' },
+        { id: 'leads', label: 'Leads', count: leads, color: '#0ea5e9' },
+        { id: 'qualified', label: 'Qualified', count: qualified, color: '#14b8a6' },
+        { id: 'converted', label: cfg.conversion.labelPlural, count: conversions, color: '#22c55e' },
+      ]
+    },
+
+    async listCampaigns(query: MarketingQuery): Promise<Campaign[]> {
+      const list = query.channelId ? campaigns.filter((c) => c.channelId === query.channelId) : campaigns
+      return list.map((c) => scaleCampaign(c, query.range))
+    },
+
+    async getCampaign(id: string): Promise<Campaign | null> {
+      return campaigns.find((c) => c.id === id) ?? null
+    },
+
+    async saveCampaign(input: SaveCampaignInput): Promise<Campaign> {
+      if (input.id) {
+        const existing = campaigns.find((c) => c.id === input.id)
+        if (existing) {
+          Object.assign(existing, {
+            name: input.name, channelId: input.channelId, status: input.status,
+            start: input.start, end: input.end, spend: input.spend,
+          })
+          return existing
+        }
+      }
+      const b = base.find((x) => x.channelId === input.channelId) ?? base[0]
+      const active = input.status === 'active'
+      const created: Campaign = {
+        id: `cmp-${++counter}`,
+        name: input.name,
+        channelId: input.channelId,
+        status: input.status,
+        start: input.start,
+        end: input.end,
+        spend: input.spend,
+        // New campaigns ramp from a small slice of their channel's volume.
+        reach: active ? Math.round(b.reach * 0.15) : 0,
+        leads: active ? Math.round(b.leads * 0.15) : 0,
+        conversions: active ? Math.round(b.conversions * 0.15) : 0,
+        value: active ? Math.round(b.value * 0.15) : 0,
+      }
+      campaigns.unshift(created)
+      return created
+    },
+
+    async deleteCampaign(id: string): Promise<void> {
+      const idx = campaigns.findIndex((c) => c.id === id)
+      if (idx >= 0) campaigns.splice(idx, 1)
+    },
+
+    async landingPages(query: MarketingQuery): Promise<LandingPagePerf[]> {
+      return landing.map((p) => {
+        const visits = scale(p.visits, query.range)
+        const conversions = scale(p.conversions, query.range)
+        return { ...p, visits, conversions, cvr: visits > 0 ? (conversions / visits) * 100 : 0 }
+      })
+    },
+  }
+}

package/src/data/types.ts

@@ -0,0 +1,55 @@
+import type {
+  Campaign,
+  CampaignStatus,
+  ChannelPerformance,
+  FunnelStage,
+  LandingPagePerf,
+  MarketingOverview,
+  MarketingQuery,
+} from '../types'
+
+// ---------------------------------------------------------------------------
+// Provider — everything the marketing surface reads/writes. The mock provider
+// computes analytics from a vertical-flavored seed; a Supabase-backed provider
+// lands later. Attribution + sites data can also come from sibling plugins via
+// the bridge seams below (defined now, injected later).
+// ---------------------------------------------------------------------------
+
+export interface SaveCampaignInput {
+  id?: string
+  name: string
+  channelId: string
+  status: CampaignStatus
+  start: string
+  end?: string
+  spend: number
+}
+
+export interface MarketingDataProvider {
+  overview(query: MarketingQuery): Promise<MarketingOverview>
+  channelPerformance(query: MarketingQuery): Promise<ChannelPerformance[]>
+  listCampaigns(query: MarketingQuery): Promise<Campaign[]>
+  getCampaign(id: string): Promise<Campaign | null>
+  saveCampaign(input: SaveCampaignInput): Promise<Campaign>
+  deleteCampaign(id: string): Promise<void>
+  funnel(query: MarketingQuery): Promise<FunnelStage[]>
+  landingPages(query: MarketingQuery): Promise<LandingPagePerf[]>
+}
+
+// ---------------------------------------------------------------------------
+// Bridge seams (optional DI). Apps inject these to swap mock numbers for real
+// conversions read from plugin-crm / plugin-agenda / plugin-orders, and real
+// landing-page performance read from plugin-sites. Mirrors the agenda↔financial
+// bridge pattern (plugins compose via DI, never direct imports).
+// ---------------------------------------------------------------------------
+
+export interface AttributionBridge {
+  conversionsByChannel(
+    query: MarketingQuery,
+  ): Promise<Array<{ channelId: string; conversions: number; value: number }>>
+  funnel(query: MarketingQuery): Promise<FunnelStage[]>
+}
+
+export interface SitesPerformanceBridge {
+  landingPages(query: MarketingQuery): Promise<LandingPagePerf[]>
+}