@fayz-ai/plugin-marketing 0.1.1

package/src/format.ts

@@ -0,0 +1,40 @@
+export interface MarketingCurrency {
+  code: string
+  locale: string
+  symbol: string
+}
+
+export const DEFAULT_CURRENCY: MarketingCurrency = { code: 'USD', locale: 'en-US', symbol: '$' }
+
+export function formatCurrency(value: number, currency: MarketingCurrency): string {
+  try {
+    return new Intl.NumberFormat(currency.locale, {
+      style: 'currency',
+      currency: currency.code,
+      maximumFractionDigits: value >= 1000 ? 0 : 2,
+    }).format(value)
+  } catch {
+    return `${currency.symbol}${Math.round(value).toLocaleString()}`
+  }
+}
+
+export function formatNumber(value: number): string {
+  return Math.round(value).toLocaleString()
+}
+
+export function formatPercent(value: number, digits = 1): string {
+  return `${value.toFixed(digits)}%`
+}
+
+/** Compact form for big reach numbers (12.4k). */
+export function formatCompact(value: number): string {
+  if (value >= 1000) return `${(value / 1000).toFixed(value >= 10000 ? 0 : 1)}k`
+  return String(Math.round(value))
+}
+
+/** Percentage-point delta vs a previous value, signed. */
+export function trendDelta(current: number, previous: number): { pct: number; dir: 'up' | 'down' | 'neutral' } {
+  if (previous === 0) return { pct: current > 0 ? 100 : 0, dir: current > 0 ? 'up' : 'neutral' }
+  const pct = ((current - previous) / previous) * 100
+  return { pct: Math.abs(pct), dir: pct > 0.5 ? 'up' : pct < -0.5 ? 'down' : 'neutral' }
+}

package/src/index.ts

@@ -0,0 +1,225 @@
+import React from 'react'
+import type { PluginManifest, PluginScope, VerticalId } from '@fayz-ai/core'
+import { getSupabaseClientOptional, registerTranslations } from '@fayz-ai/core'
+import { MarketingPage } from './MarketingPage'
+import { SettingsView } from './views/SettingsView'
+import { createMarketingDashboardWidgets } from './views/dashboardWidgets'
+import {
+  MarketingContextProvider,
+  type ResolvedMarketingConfig,
+  type MarketingLabels,
+} from './MarketingContext'
+import type {
+  AttributionBridge,
+  MarketingDataProvider,
+  SitesPerformanceBridge,
+} from './data/types'
+import { createMockMarketingProvider } from './data/mock'
+import { createMarketingStore } from './store'
+import { DEFAULT_CURRENCY, type MarketingCurrency } from './format'
+import { MARKETING_PRESETS, type MarketingDomain, type MarketingDomainModules } from './presets'
+import type { AcquisitionChannel, ConversionModel } from './types'
+import { marketingLocales } from './locales'
+
+// ---------------------------------------------------------------------------
+// @fayz-ai/plugin-marketing — acquisition & conversion analytics. ONE plugin,
+// every vertical: a `domain` preset (or explicit conversion + channels) adapts
+// what a conversion is and where it's attributed from. Channels, campaigns,
+// funnel and landing-page CVR are computed generically.
+//
+// Ships a vertical-flavored mock today; real attribution comes via the
+// AttributionBridge / SitesPerformanceBridge seams (read from crm/agenda/
+// orders/sites). Outbound broadcasts + journeys are reserved behind flags.
+// ---------------------------------------------------------------------------
+
+export interface MarketingPluginOptions {
+  /** Vertical preset for conversion model + channels + module defaults. */
+  domain?: MarketingDomain
+  /** Override the conversion model (else taken from the domain preset). */
+  conversion?: ConversionModel
+  /** Override the acquisition channels (else from the domain preset). */
+  channels?: AcquisitionChannel[]
+  modules?: Partial<MarketingDomainModules>
+  currency?: Partial<MarketingCurrency>
+  labels?: Partial<MarketingLabels>
+  navPosition?: number
+  navSection?: 'main' | 'secondary' | 'settings'
+  navLabel?: string
+  scope?: PluginScope
+  verticalId?: VerticalId
+  dataProvider?: MarketingDataProvider
+  /** Optional DI to read real conversions (mounted later). */
+  attributionBridge?: AttributionBridge
+  /** Optional DI to read real landing-page performance (mounted later). */
+  sitesBridge?: SitesPerformanceBridge
+}
+
+const DEFAULT_LABELS: MarketingLabels = {
+  pageTitle: 'Marketing',
+  pageSubtitle: 'Acquisition & conversion performance',
+  overview: 'Overview',
+  channels: 'Channels',
+  campaigns: 'Campaigns',
+  funnel: 'Funnel',
+  landingPages: 'Landing pages',
+  settings: 'Settings',
+}
+
+function resolveConfig(options?: MarketingPluginOptions): { config: ResolvedMarketingConfig; domain: MarketingDomain } {
+  const domain = options?.domain ?? 'agency'
+  const preset = MARKETING_PRESETS[domain]
+  const config: ResolvedMarketingConfig = {
+    conversion: options?.conversion ?? preset.conversion,
+    channels: options?.channels ?? preset.channels,
+    modules: { ...preset.modules, ...options?.modules },
+    currency: { ...DEFAULT_CURRENCY, ...options?.currency },
+    labels: { ...DEFAULT_LABELS, ...options?.labels },
+  }
+  return { config, domain }
+}
+
+function createSafeProvider(config: ResolvedMarketingConfig, domain: MarketingDomain): MarketingDataProvider {
+  // Supabase-backed + bridge-fed providers land later; mock powers it for now.
+  void getSupabaseClientOptional()
+  return createMockMarketingProvider({ channels: config.channels, conversion: config.conversion, domain })
+}
+
+export function createMarketingPlugin(options?: MarketingPluginOptions): PluginManifest {
+  registerTranslations(marketingLocales)
+  const { config, domain } = resolveConfig(options)
+  const provider = options?.dataProvider ?? createSafeProvider(config, domain)
+  const store = createMarketingStore(provider)
+  const dashboardWidgets = createMarketingDashboardWidgets({ config, provider, store })
+
+  const PageComponent: React.ComponentType<unknown> = () =>
+    React.createElement(MarketingContextProvider, { config, provider, store },
+      React.createElement(MarketingPage, { config, provider, store }))
+  PageComponent.displayName = 'MarketingPage'
+
+  // Settings lives in the SDK-core central Settings area (not a module tab).
+  const SettingsComponent: React.ComponentType<unknown> = () =>
+    React.createElement(MarketingContextProvider, { config, provider, store },
+      React.createElement(SettingsView))
+  SettingsComponent.displayName = 'MarketingSettings'
+
+  return {
+    id: 'marketing',
+    name: options?.navLabel ?? config.labels.pageTitle,
+    icon: 'Megaphone',
+    version: '1.0.0',
+    scope: options?.scope ?? 'universal',
+    verticalId: options?.verticalId,
+    defaultEnabled: true,
+    dependencies: [],
+    declaredFeatures: [
+      { id: 'marketing', label: config.labels.pageTitle, group: 'Engage' },
+      ...(config.modules.landingPages ? [{ id: 'marketing.landing-pages', label: config.labels.landingPages, group: 'Engage' }] : []),
+    ],
+    navigation: [
+      {
+        section: options?.navSection ?? 'main',
+        position: options?.navPosition ?? 5,
+        label: options?.navLabel ?? config.labels.pageTitle,
+        route: '/marketing',
+        icon: 'Megaphone',
+        permission: { feature: 'marketing', action: 'read' as const },
+      },
+    ],
+    routes: [
+      {
+        path: '/marketing',
+        component: PageComponent,
+        permission: { feature: 'marketing', action: 'read' as const },
+      },
+    ],
+    widgets: [],
+    dashboardWidgets,
+    events: [
+      { name: 'marketing.conversion.tracked', description: 'A conversion was attributed to a channel/campaign' },
+      { name: 'marketing.campaign.created', description: 'A campaign was created' },
+      { name: 'marketing.campaign.updated', description: 'A campaign was updated' },
+      { name: 'marketing.channel.synced', description: 'A channel pulled fresh attribution data' },
+    ],
+    aiTools: [
+      {
+        id: 'marketing.channel-performance',
+        name: 'channelPerformance',
+        description: 'Returns acquisition performance per channel (reach, conversions, CVR, spend, CPA).',
+        icon: 'Radio',
+        mode: 'read' as const,
+        category: 'Marketing',
+        parameters: {
+          type: 'object' as const,
+          properties: { range: { type: 'string' as const, enum: ['7d', '30d', '90d'] } },
+        },
+        suggestions: [{ label: 'Which channel converts best?' }, { label: 'What is my cost per acquisition?' }],
+        permission: { feature: 'marketing', action: 'read' as const },
+      },
+      {
+        id: 'marketing.top-channels',
+        name: 'topChannels',
+        description: 'Returns the top acquisition channels ranked by conversions.',
+        icon: 'Trophy',
+        mode: 'read' as const,
+        category: 'Marketing',
+        permission: { feature: 'marketing', action: 'read' as const },
+      },
+      {
+        id: 'marketing.campaign-cvr',
+        name: 'campaignCvr',
+        description: 'Lists campaigns with their conversion rate for a date range.',
+        icon: 'Percent',
+        mode: 'read' as const,
+        category: 'Marketing',
+        parameters: {
+          type: 'object' as const,
+          properties: { range: { type: 'string' as const, enum: ['7d', '30d', '90d'] } },
+        },
+        permission: { feature: 'marketing', action: 'read' as const },
+      },
+      {
+        id: 'marketing.create-campaign',
+        name: 'createCampaign',
+        description: 'Creates an acquisition campaign on a channel.',
+        icon: 'Plus',
+        mode: 'persist' as const,
+        category: 'Marketing',
+        parameters: {
+          type: 'object' as const,
+          properties: {
+            name: { type: 'string' as const, description: 'Campaign name' },
+            channelId: { type: 'string' as const, description: 'Acquisition channel id' },
+          },
+          required: ['name', 'channelId'],
+        },
+        permission: { feature: 'marketing', action: 'create' as const },
+      },
+    ],
+    settings: [
+      {
+        id: 'marketing',
+        label: config.labels.pageTitle,
+        icon: 'Megaphone',
+        component: SettingsComponent,
+        order: 20,
+        permission: { feature: 'marketing', action: 'read' as const },
+      },
+    ],
+    locales: marketingLocales,
+  }
+}
+
+export type {
+  MarketingDataProvider,
+  AttributionBridge,
+  SitesPerformanceBridge,
+} from './data/types'
+export type {
+  AcquisitionChannel,
+  ConversionModel,
+  Campaign,
+  ChannelPerformance,
+  LandingPagePerf,
+} from './types'
+export { MARKETING_PRESETS, type MarketingDomain } from './presets'
+export { createMockMarketingProvider } from './data/mock'

package/src/locales/en.ts

@@ -0,0 +1,74 @@
+export const en: Record<string, string> = {
+  // metrics
+  'marketing.metric.conversionRate': 'Conversion rate',
+  'marketing.metric.cpa': 'Cost per acquisition',
+  'marketing.metric.topChannel': 'Top channel',
+  'marketing.metric.spend': 'spend',
+  'marketing.metric.reach': 'Reach',
+  'marketing.metric.cvr': 'CVR',
+  'marketing.metric.totalVisits': 'Total visits',
+  'marketing.metric.pages': 'Pages',
+  'marketing.metric.avgConversion': 'Avg. conversion',
+  // columns
+  'marketing.col.campaign': 'Campaign',
+  'marketing.col.channel': 'Channel',
+  'marketing.col.reach': 'Reach',
+  'marketing.col.leads': 'Leads',
+  'marketing.col.cvr': 'CVR',
+  'marketing.col.spend': 'Spend',
+  'marketing.col.cpa': 'CPA',
+  'marketing.col.status': 'Status',
+  'marketing.col.visits': 'Visits',
+  'marketing.col.conversions': 'Conversions',
+  'marketing.col.type': 'Type',
+  'marketing.col.page': 'Page',
+  // overview
+  'marketing.overview.byChannelSuffix': 'by channel',
+  'marketing.overview.recent': 'Recent campaigns',
+  // channels
+  'marketing.channels.subtitle': 'Acquisition performance by channel',
+  'marketing.channels.campaignsOn': 'Campaigns on this channel',
+  'marketing.channels.noCampaigns': 'No campaigns yet on this channel.',
+  // campaigns
+  'marketing.campaigns.subtitle': 'All acquisition campaigns and their conversion performance',
+  'marketing.campaigns.new': 'New campaign',
+  'marketing.campaigns.empty': 'No campaigns yet — create your first one.',
+  'marketing.campaigns.delete': 'Delete campaign',
+  // composer
+  'marketing.composer.title': 'New campaign',
+  'marketing.composer.name': 'Campaign name',
+  'marketing.composer.namePlaceholder': 'e.g. Spring Promo — Paid Social',
+  'marketing.composer.channel': 'Channel',
+  'marketing.composer.channelPlaceholder': 'Select a channel',
+  'marketing.composer.status': 'Status',
+  'marketing.composer.budget': 'Budget / spend',
+  'marketing.composer.cancel': 'Cancel',
+  'marketing.composer.create': 'Create campaign',
+  'marketing.status.draft': 'draft',
+  'marketing.status.active': 'active',
+  'marketing.status.paused': 'paused',
+  'marketing.status.ended': 'ended',
+  // funnel
+  'marketing.funnel.subtitlePrefix': 'Attribution funnel — reach to',
+  'marketing.funnel.overall': 'Overall conversion rate',
+  'marketing.funnel.ofPrev': 'of prev',
+  // landing pages
+  'marketing.landing.subtitle': 'Per-page visits → conversions performance',
+  // settings
+  'marketing.settings.conversionModel': 'Conversion model',
+  'marketing.settings.conversionModelDesc': "What counts as a conversion in this workspace and where it's attributed from.",
+  'marketing.settings.conversion': 'Conversion',
+  'marketing.settings.valueMetric': 'Value metric',
+  'marketing.settings.attributedFrom': 'Attributed from',
+  'marketing.settings.channels': 'Acquisition channels',
+  'marketing.settings.channelsDesc': 'Sources tracked for this workspace.',
+  'marketing.settings.trackValue': 'Track monetary value',
+  'marketing.settings.trackValueDesc': 'Attribute revenue to channels and campaigns.',
+  'marketing.settings.attribution': 'Attribution',
+  'marketing.settings.attributionDesc': 'How conversions are matched to channels.',
+  'marketing.settings.autoSync': 'Auto-sync conversions',
+  'marketing.settings.autoSyncDesc': 'Pull conversions automatically from the source.',
+  'marketing.settings.assisted': 'Count assisted conversions',
+  'marketing.settings.assistedDesc': 'Credit channels that contributed to a conversion.',
+  'marketing.settings.channelTrackDesc': 'Track this acquisition source.',
+}

package/src/locales/index.ts

@@ -0,0 +1,7 @@
+import { en } from './en'
+import { ptBR } from './pt-BR'
+
+export const marketingLocales: Record<string, Record<string, string>> = {
+  en,
+  'pt-BR': ptBR,
+}

package/src/locales/pt-BR.ts

@@ -0,0 +1,74 @@
+export const ptBR: Record<string, string> = {
+  // metrics
+  'marketing.metric.conversionRate': 'Taxa de conversão',
+  'marketing.metric.cpa': 'Custo por aquisição',
+  'marketing.metric.topChannel': 'Principal canal',
+  'marketing.metric.spend': 'investido',
+  'marketing.metric.reach': 'Alcance',
+  'marketing.metric.cvr': 'CVR',
+  'marketing.metric.totalVisits': 'Total de visitas',
+  'marketing.metric.pages': 'Páginas',
+  'marketing.metric.avgConversion': 'Conversão média',
+  // columns
+  'marketing.col.campaign': 'Campanha',
+  'marketing.col.channel': 'Canal',
+  'marketing.col.reach': 'Alcance',
+  'marketing.col.leads': 'Leads',
+  'marketing.col.cvr': 'CVR',
+  'marketing.col.spend': 'Investimento',
+  'marketing.col.cpa': 'CPA',
+  'marketing.col.status': 'Status',
+  'marketing.col.visits': 'Visitas',
+  'marketing.col.conversions': 'Conversões',
+  'marketing.col.type': 'Tipo',
+  'marketing.col.page': 'Página',
+  // overview
+  'marketing.overview.byChannelSuffix': 'por canal',
+  'marketing.overview.recent': 'Campanhas recentes',
+  // channels
+  'marketing.channels.subtitle': 'Desempenho de aquisição por canal',
+  'marketing.channels.campaignsOn': 'Campanhas neste canal',
+  'marketing.channels.noCampaigns': 'Nenhuma campanha ainda neste canal.',
+  // campaigns
+  'marketing.campaigns.subtitle': 'Todas as campanhas de aquisição e seu desempenho de conversão',
+  'marketing.campaigns.new': 'Nova campanha',
+  'marketing.campaigns.empty': 'Nenhuma campanha ainda — crie a primeira.',
+  'marketing.campaigns.delete': 'Excluir campanha',
+  // composer
+  'marketing.composer.title': 'Nova campanha',
+  'marketing.composer.name': 'Nome da campanha',
+  'marketing.composer.namePlaceholder': 'ex.: Promo de Verão — Mídia Paga',
+  'marketing.composer.channel': 'Canal',
+  'marketing.composer.channelPlaceholder': 'Selecione um canal',
+  'marketing.composer.status': 'Status',
+  'marketing.composer.budget': 'Orçamento / investimento',
+  'marketing.composer.cancel': 'Cancelar',
+  'marketing.composer.create': 'Criar campanha',
+  'marketing.status.draft': 'rascunho',
+  'marketing.status.active': 'ativa',
+  'marketing.status.paused': 'pausada',
+  'marketing.status.ended': 'encerrada',
+  // funnel
+  'marketing.funnel.subtitlePrefix': 'Funil de atribuição — alcance até',
+  'marketing.funnel.overall': 'Taxa de conversão geral',
+  'marketing.funnel.ofPrev': 'do anterior',
+  // landing pages
+  'marketing.landing.subtitle': 'Desempenho de visitas → conversões por página',
+  // settings
+  'marketing.settings.conversionModel': 'Modelo de conversão',
+  'marketing.settings.conversionModelDesc': 'O que conta como conversão neste workspace e de onde é atribuída.',
+  'marketing.settings.conversion': 'Conversão',
+  'marketing.settings.valueMetric': 'Métrica de valor',
+  'marketing.settings.attributedFrom': 'Atribuída de',
+  'marketing.settings.channels': 'Canais de aquisição',
+  'marketing.settings.channelsDesc': 'Fontes monitoradas neste workspace.',
+  'marketing.settings.trackValue': 'Acompanhar valor monetário',
+  'marketing.settings.trackValueDesc': 'Atribuir receita a canais e campanhas.',
+  'marketing.settings.attribution': 'Atribuição',
+  'marketing.settings.attributionDesc': 'Como as conversões são associadas aos canais.',
+  'marketing.settings.autoSync': 'Sincronizar conversões automaticamente',
+  'marketing.settings.autoSyncDesc': 'Importar conversões automaticamente da fonte.',
+  'marketing.settings.assisted': 'Contar conversões assistidas',
+  'marketing.settings.assistedDesc': 'Creditar canais que contribuíram para uma conversão.',
+  'marketing.settings.channelTrackDesc': 'Monitorar esta fonte de aquisição.',
+}

package/src/presets.ts

@@ -0,0 +1,115 @@
+import type { AcquisitionChannel, ConversionModel } from './types'
+
+// ---------------------------------------------------------------------------
+// Domain presets — the abstraction that lets ONE plugin feed every vertical.
+// Each preset defines what a "conversion" is (and where it's attributed from)
+// plus the acquisition channels that vertical actually uses. Channel ids align
+// with plugin-crm's `lead-sources` registry where they overlap.
+// ---------------------------------------------------------------------------
+
+export type MarketingDomain = 'agency' | 'beauty' | 'resto'
+
+export interface MarketingDomainModules {
+  channels: boolean
+  campaigns: boolean
+  funnel: boolean
+  landingPages: boolean
+  /** Outbound — reserved, off by default, implemented in a later milestone. */
+  broadcasts: boolean
+  journeys: boolean
+}
+
+export interface MarketingDomainPreset {
+  conversion: ConversionModel
+  channels: AcquisitionChannel[]
+  modules: MarketingDomainModules
+}
+
+const AGENCY: MarketingDomainPreset = {
+  conversion: {
+    id: 'won-deal',
+    label: 'Won deal',
+    labelPlural: 'Won deals',
+    valueLabel: 'Pipeline value',
+    source: 'crm',
+    avgValue: 3200,
+  },
+  channels: [
+    { id: 'paid-search', label: 'Paid Search', icon: 'Search', kind: 'paid' },
+    { id: 'paid-social', label: 'Paid Social', icon: 'Megaphone', kind: 'paid' },
+    { id: 'organic', label: 'Organic / SEO', icon: 'Globe', kind: 'organic' },
+    { id: 'email', label: 'Email', icon: 'Mail', kind: 'outbound' },
+    { id: 'referral', label: 'Referral', icon: 'Users', kind: 'referral' },
+    { id: 'direct', label: 'Direct', icon: 'MousePointerClick', kind: 'direct' },
+  ],
+  modules: { channels: true, campaigns: true, funnel: true, landingPages: true, broadcasts: false, journeys: false },
+}
+
+const BEAUTY: MarketingDomainPreset = {
+  conversion: {
+    id: 'booking',
+    label: 'Booking',
+    labelPlural: 'Bookings',
+    valueLabel: 'Booking revenue',
+    source: 'agenda',
+    avgValue: 85,
+  },
+  channels: [
+    { id: 'instagram', label: 'Instagram', icon: 'Instagram', kind: 'social' },
+    { id: 'google', label: 'Google', icon: 'Globe', kind: 'organic' },
+    { id: 'referral', label: 'Referral', icon: 'Users', kind: 'referral' },
+    { id: 'whatsapp', label: 'WhatsApp', icon: 'MessageCircle', kind: 'social' },
+    { id: 'walkin', label: 'Walk-in', icon: 'DoorOpen', kind: 'direct' },
+  ],
+  modules: { channels: true, campaigns: true, funnel: true, landingPages: false, broadcasts: false, journeys: false },
+}
+
+const RESTO: MarketingDomainPreset = {
+  conversion: {
+    id: 'order',
+    label: 'Order',
+    labelPlural: 'Orders',
+    valueLabel: 'Revenue',
+    source: 'orders',
+    avgValue: 42,
+  },
+  channels: [
+    { id: 'ifood', label: 'iFood', icon: 'Utensils', kind: 'paid' },
+    { id: 'delivery', label: 'Delivery apps', icon: 'Bike', kind: 'paid' },
+    { id: 'google', label: 'Google', icon: 'Globe', kind: 'organic' },
+    { id: 'instagram', label: 'Instagram', icon: 'Instagram', kind: 'social' },
+    { id: 'walkin', label: 'Walk-in', icon: 'DoorOpen', kind: 'direct' },
+  ],
+  modules: { channels: true, campaigns: true, funnel: true, landingPages: false, broadcasts: false, journeys: false },
+}
+
+export const MARKETING_PRESETS: Record<MarketingDomain, MarketingDomainPreset> = {
+  agency: AGENCY,
+  beauty: BEAUTY,
+  resto: RESTO,
+}
+
+/** Vertical-flavored campaign name templates for the mock seed. */
+export const CAMPAIGN_NAME_SEEDS: Record<MarketingDomain, string[]> = {
+  agency: [
+    'Q2 Lead-gen — Search',
+    'LinkedIn Retargeting',
+    'Webinar Funnel',
+    'Newsletter Nurture',
+    'Partner Referral Push',
+  ],
+  beauty: [
+    'Summer Glow Promo',
+    'New Client — Instagram',
+    'Birthday Offer Blast',
+    'Win-back 90 days',
+    'Google Reviews Boost',
+  ],
+  resto: [
+    'iFood Weekend Combo',
+    'Happy Hour Promo',
+    'New Menu Launch',
+    'Loyalty Double Points',
+    'Instagram Stories Drop',
+  ],
+}

package/src/store.ts

@@ -0,0 +1,66 @@
+import { createStore, type StoreApi } from 'zustand/vanilla'
+import type { MarketingDataProvider, SaveCampaignInput } from './data/types'
+import type {
+  Campaign,
+  ChannelPerformance,
+  DateRangeKey,
+  FunnelStage,
+  LandingPagePerf,
+  MarketingOverview,
+} from './types'
+
+export interface MarketingUIState {
+  range: DateRangeKey
+  overview: MarketingOverview | null
+  channels: ChannelPerformance[]
+  campaigns: Campaign[]
+  funnel: FunnelStage[]
+  landingPages: LandingPagePerf[]
+  loading: boolean
+
+  load(): Promise<void>
+  setRange(range: DateRangeKey): Promise<void>
+  saveCampaign(input: SaveCampaignInput): Promise<Campaign>
+  deleteCampaign(id: string): Promise<void>
+}
+
+export function createMarketingStore(provider: MarketingDataProvider): StoreApi<MarketingUIState> {
+  return createStore<MarketingUIState>((set, get) => ({
+    range: '30d',
+    overview: null,
+    channels: [],
+    campaigns: [],
+    funnel: [],
+    landingPages: [],
+    loading: false,
+
+    async load() {
+      const range = get().range
+      set({ loading: true })
+      const [overview, channels, campaigns, funnel, landingPages] = await Promise.all([
+        provider.overview({ range }),
+        provider.channelPerformance({ range }),
+        provider.listCampaigns({ range }),
+        provider.funnel({ range }),
+        provider.landingPages({ range }),
+      ])
+      set({ overview, channels, campaigns, funnel, landingPages, loading: false })
+    },
+
+    async setRange(range) {
+      set({ range })
+      await get().load()
+    },
+
+    async saveCampaign(input) {
+      const created = await provider.saveCampaign(input)
+      await get().load()
+      return created
+    },
+
+    async deleteCampaign(id) {
+      await provider.deleteCampaign(id)
+      await get().load()
+    },
+  }))
+}