@happyvertical/smrt-marketing 0.39.16

package/dist/svelte/types.js

@@ -0,0 +1,80 @@
+export function campaignStatusBadgeVariant(status) {
+    switch (status) {
+        case 'active':
+            return 'success';
+        case 'scheduled':
+            return 'info';
+        case 'paused':
+            return 'warning';
+        case 'completed':
+            return 'primary';
+        case 'archived':
+            return 'default';
+        default:
+            return 'default';
+    }
+}
+export function pacingStatusBadgeVariant(status) {
+    switch (status) {
+        case 'on_track':
+        case 'complete':
+            return 'success';
+        case 'ahead':
+            return 'info';
+        case 'behind':
+        case 'not_started':
+            return 'warning';
+        case 'over_budget':
+            return 'error';
+        default:
+            return 'default';
+    }
+}
+export function summarizeMarketingDashboard(campaigns) {
+    const byCurrency = new Map();
+    let channelCount = 0;
+    let impressions = 0;
+    let clicks = 0;
+    let conversions = 0;
+    let leads = 0;
+    for (const campaign of campaigns) {
+        const currency = campaign.currency || 'USD';
+        const total = byCurrency.get(currency) ?? {
+            currency,
+            budgetCents: 0,
+            spendCents: 0,
+        };
+        total.budgetCents += campaign.budgetCents;
+        total.spendCents += campaign.spendCents ?? 0;
+        byCurrency.set(currency, total);
+        channelCount += campaign.channelCount ?? 0;
+        impressions += campaign.impressions ?? 0;
+        clicks += campaign.clicks ?? 0;
+        conversions += campaign.conversions ?? 0;
+        leads += campaign.leads ?? 0;
+    }
+    return {
+        campaignCount: campaigns.length,
+        activeCampaignCount: campaigns.filter((campaign) => campaign.status === 'active').length,
+        channelCount,
+        impressions,
+        clicks,
+        conversions,
+        leads,
+        currencyTotals: [...byCurrency.values()].sort((a, b) => a.currency.localeCompare(b.currency)),
+    };
+}
+export function calculateChannelMix(channels) {
+    const totalSpend = channels.reduce((sum, channel) => sum + channel.spendCents, 0);
+    const totalAllocation = channels.reduce((sum, channel) => sum + channel.allocatedBudgetCents, 0);
+    return channels.map((channel) => ({
+        ...channel,
+        spendFraction: totalSpend > 0 ? channel.spendCents / totalSpend : 0,
+        allocationFraction: totalAllocation > 0 ? channel.allocatedBudgetCents / totalAllocation : 0,
+    }));
+}
+export function cappedBudgetProgress(pacing) {
+    if (pacing.budgetFraction === null)
+        return 0;
+    return Math.max(0, Math.min(1, pacing.budgetFraction));
+}

package/dist/types.d.ts

@@ -0,0 +1,61 @@
+import { SmrtObjectOptions } from '@happyvertical/smrt-core';
+export declare const CAMPAIGN_STATUSES: readonly ["draft", "scheduled", "active", "paused", "completed", "archived"];
+export type CampaignStatus = (typeof CAMPAIGN_STATUSES)[number];
+export declare const CAMPAIGN_CHANNEL_KINDS: readonly ["ad_group", "social_post", "message", "content", "event", "referral_program"];
+export type CampaignChannelKind = (typeof CAMPAIGN_CHANNEL_KINDS)[number] | (string & {});
+export declare const CAMPAIGN_CHANNEL_STATUSES: readonly ["planned", "scheduled", "active", "paused", "completed", "cancelled"];
+export type CampaignChannelStatus = (typeof CAMPAIGN_CHANNEL_STATUSES)[number];
+export interface CampaignOptions extends SmrtObjectOptions {
+    tenantId?: string | null;
+    campaignKey?: string;
+    name?: string;
+    objective?: string;
+    status?: CampaignStatus;
+    startAt?: Date | string | number | null;
+    endAt?: Date | string | number | null;
+    budgetCents?: number;
+    currency?: string;
+    metadata?: string;
+}
+export interface CampaignChannelOptions extends SmrtObjectOptions {
+    tenantId?: string | null;
+    campaignId?: string;
+    channelKind?: CampaignChannelKind;
+    channelRef?: string;
+    allocatedBudgetCents?: number;
+    startAt?: Date | string | number | null;
+    endAt?: Date | string | number | null;
+    status?: CampaignChannelStatus;
+}
+export interface CampaignMetricSnapshotOptions extends SmrtObjectOptions {
+    tenantId?: string | null;
+    campaignId?: string;
+    campaignChannelId?: string | null;
+    periodStart?: Date | string | number;
+    periodEnd?: Date | string | number;
+    spendCents?: number;
+    impressions?: number;
+    clicks?: number;
+    conversions?: number;
+    leads?: number;
+    revenueCents?: number | null;
+    source?: string;
+    dedupeKey?: string;
+}
+export type BudgetPacingStatus = 'unbudgeted' | 'not_started' | 'behind' | 'on_track' | 'ahead' | 'over_budget' | 'complete';
+export interface BudgetPacingResult {
+    campaignId: string;
+    campaignChannelId?: string;
+    currency: string;
+    budgetCents: number;
+    spendCents: number;
+    remainingCents: number;
+    expectedSpendCents: number | null;
+    varianceCents: number | null;
+    budgetFraction: number | null;
+    elapsedFraction: number | null;
+    status: BudgetPacingStatus;
+    snapshotCount: number;
+    usedCampaignRollups: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,29 @@
+//#region src/types.ts
+var CAMPAIGN_STATUSES = [
+	"draft",
+	"scheduled",
+	"active",
+	"paused",
+	"completed",
+	"archived"
+];
+var CAMPAIGN_CHANNEL_KINDS = [
+	"ad_group",
+	"social_post",
+	"message",
+	"content",
+	"event",
+	"referral_program"
+];
+var CAMPAIGN_CHANNEL_STATUSES = [
+	"planned",
+	"scheduled",
+	"active",
+	"paused",
+	"completed",
+	"cancelled"
+];
+//#endregion
+export { CAMPAIGN_CHANNEL_KINDS, CAMPAIGN_CHANNEL_STATUSES, CAMPAIGN_STATUSES };
+
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../src/types.ts"],"sourcesContent":["/** Shared model and service contracts for @happyvertical/smrt-marketing. */\n\nimport type { SmrtObjectOptions } from '@happyvertical/smrt-core';\n\nexport const CAMPAIGN_STATUSES = [\n  'draft',\n  'scheduled',\n  'active',\n  'paused',\n  'completed',\n  'archived',\n] as const;\n\nexport type CampaignStatus = (typeof CAMPAIGN_STATUSES)[number];\n\nexport const CAMPAIGN_CHANNEL_KINDS = [\n  'ad_group',\n  'social_post',\n  'message',\n  'content',\n  'event',\n  'referral_program',\n] as const;\n\nexport type CampaignChannelKind =\n  | (typeof CAMPAIGN_CHANNEL_KINDS)[number]\n  | (string & {});\n\nexport const CAMPAIGN_CHANNEL_STATUSES = [\n  'planned',\n  'scheduled',\n  'active',\n  'paused',\n  'completed',\n  'cancelled',\n] as const;\n\nexport type CampaignChannelStatus = (typeof CAMPAIGN_CHANNEL_STATUSES)[number];\n\nexport interface CampaignOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  campaignKey?: string;\n  name?: string;\n  objective?: string;\n  status?: CampaignStatus;\n  startAt?: Date | string | number | null;\n  endAt?: Date | string | number | null;\n  budgetCents?: number;\n  currency?: string;\n  metadata?: string;\n}\n\nexport interface CampaignChannelOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  campaignId?: string;\n  channelKind?: CampaignChannelKind;\n  channelRef?: string;\n  allocatedBudgetCents?: number;\n  startAt?: Date | string | number | null;\n  endAt?: Date | string | number | null;\n  status?: CampaignChannelStatus;\n}\n\nexport interface CampaignMetricSnapshotOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  campaignId?: string;\n  campaignChannelId?: string | null;\n  periodStart?: Date | string | number;\n  periodEnd?: Date | string | number;\n  spendCents?: number;\n  impressions?: number;\n  clicks?: number;\n  conversions?: number;\n  leads?: number;\n  revenueCents?: number | null;\n  source?: string;\n  dedupeKey?: string;\n}\n\nexport type BudgetPacingStatus =\n  | 'unbudgeted'\n  | 'not_started'\n  | 'behind'\n  | 'on_track'\n  | 'ahead'\n  | 'over_budget'\n  | 'complete';\n\nexport interface BudgetPacingResult {\n  campaignId: string;\n  campaignChannelId?: string;\n  currency: string;\n  budgetCents: number;\n  spendCents: number;\n  remainingCents: number;\n  expectedSpendCents: number | null;\n  varianceCents: number | null;\n  budgetFraction: number | null;\n  elapsedFraction: number | null;\n  status: BudgetPacingStatus;\n  snapshotCount: number;\n  usedCampaignRollups: boolean;\n}\n"],"mappings":";AAIO,IAAM,oBAAoB;CAC/B;CACA;CACA;CACA;CACA;CACA;AACF;AAIO,IAAM,yBAAyB;CACpC;CACA;CACA;CACA;CACA;CACA;AACF;AAMO,IAAM,4BAA4B;CACvC;CACA;CACA;CACA;CACA;CACA;AACF"}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@happyvertical/smrt-marketing",
+  "version": "0.39.16",
+  "description": "Cross-channel campaign coordination, immutable performance evidence, budget pacing, and reusable Svelte marketing surfaces for SMRT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "CLAUDE.md",
+    "AGENTS.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./svelte": {
+      "types": "./dist/svelte/index.d.ts",
+      "svelte": "./dist/svelte/index.js",
+      "import": "./dist/svelte/index.js"
+    },
+    "./manifest": "./dist/manifest.json",
+    "./manifest.json": "./dist/manifest.json"
+  },
+  "dependencies": {
+    "@happyvertical/smrt-core": "0.39.16",
+    "@happyvertical/smrt-tenancy": "0.39.16",
+    "@happyvertical/smrt-ui": "0.39.16"
+  },
+  "peerDependencies": {
+    "svelte": "^5.56.4"
+  },
+  "devDependencies": {
+    "@happyvertical/sql": "^0.78.1",
+    "@sveltejs/package": "^2.5.8",
+    "@sveltejs/vite-plugin-svelte": "^7.1.2",
+    "@testing-library/svelte": "^5.4.2",
+    "@types/node": "24.13.2",
+    "jsdom": "^26.1.0",
+    "svelte": "^5.56.4",
+    "svelte-check": "^4.7.1",
+    "typescript": "^5.9.3",
+    "vite": "^8.1.3",
+    "vitest": "^4.1.9",
+    "@happyvertical/smrt-vitest": "0.39.16"
+  },
+  "smrtRawPrimitives": "strict",
+  "keywords": [
+    "smrt",
+    "marketing",
+    "campaigns",
+    "budget-pacing",
+    "multi-tenant"
+  ],
+  "author": "HappyVertical",
+  "license": "MIT",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/happyvertical/smrt.git",
+    "directory": "packages/marketing"
+  },
+  "scripts": {
+    "build": "vite build --mode library && svelte-package -i src/svelte -o dist/svelte --tsconfig tsconfig.svelte.json",
+    "build:watch": "vite build --mode library --watch",
+    "clean": "rm -rf dist",
+    "dev": "vite dev",
+    "test": "vitest run && vitest run --config vitest.svelte.config.ts",
+    "test:coverage": "vitest run --coverage --coverage.reportsDirectory=coverage/models && vitest run --coverage --config vitest.svelte.config.ts --coverage.reportsDirectory=coverage/svelte",
+    "test:postgres": "node ../../scripts/run-with-ci-postgres.mjs -- pnpm exec vitest run src/__tests__/marketing.postgres.test.ts",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit -p tsconfig.json && node ../../scripts/svelte-check-a11y.mjs --tsconfig ./tsconfig.svelte.json",
+    "verify:pack": "node ../../scripts/verify-package-types-exports.js ."
+  }
+}