@happyvertical/smrt-marketing 0.39.16

package/dist/index.js

@@ -0,0 +1,625 @@
+import { CAMPAIGN_CHANNEL_KINDS, CAMPAIGN_CHANNEL_STATUSES, CAMPAIGN_STATUSES } from "./types.js";
+import { ObjectRegistry, SmrtCollection, SmrtObject, field, foreignKey, smrt } from "@happyvertical/smrt-core";
+import { TenantScoped, tenantId } from "@happyvertical/smrt-tenancy";
+//#region src/__smrt-register__.ts
+ObjectRegistry.registerPackageManifest(JSON.parse("{\"version\":\"1.0.0\",\"timestamp\":1784065581918,\"packageName\":\"@happyvertical/smrt-marketing\",\"packageVersion\":\"0.39.16\",\"objects\":{\"@happyvertical/smrt-marketing:CampaignChannelCollection\":{\"name\":\"campaignchannelcollection\",\"className\":\"CampaignChannelCollection\",\"qualifiedName\":\"@happyvertical/smrt-marketing:CampaignChannelCollection\",\"collection\":\"campaignchannels\",\"filePath\":\"/home/runner/.local/share/pnpm/store/.workspaces/arc-happyvertical-node-sqm7p-runner-5xldd/smrt/smrt/packages/marketing/src/collections/CampaignChannelCollection.ts\",\"packageName\":\"@happyvertical/smrt-marketing\",\"fields\":{},\"methods\":{\"findByCampaign\":{\"name\":\"findByCampaign\",\"async\":true,\"parameters\":[{\"name\":\"campaignId\",\"type\":\"string\",\"optional\":false}],\"returnType\":\"Promise<CampaignChannel[]>\",\"isStatic\":false,\"isPublic\":true},\"findByExecutionRef\":{\"name\":\"findByExecutionRef\",\"async\":true,\"parameters\":[{\"name\":\"channelKind\",\"type\":\"string\",\"optional\":false},{\"name\":\"channelRef\",\"type\":\"string\",\"optional\":false}],\"returnType\":\"Promise<CampaignChannel[]>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"campaign_channels\"},\"extends\":\"SmrtCollection\",\"extendsTypeArg\":\"CampaignChannel\",\"exportName\":\"CampaignChannelCollection\",\"collectionExportName\":\"CampaignChannelCollectionCollection\",\"schema\":{\"tableName\":\"campaign_channels\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"campaign_channels\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"}},\"indexes\":[{\"name\":\"campaign_channels_id_idx\",\"columns\":[\"id\"]},{\"name\":\"campaign_channels_slug_context_idx\",\"columns\":[\"slug\",\"context\"],\"unique\":true}],\"version\":\"b64ea87b\"}},\"@happyvertical/smrt-marketing:CampaignCollection\":{\"name\":\"campaigncollection\",\"className\":\"CampaignCollection\",\"qualifiedName\":\"@happyvertical/smrt-marketing:CampaignCollection\",\"collection\":\"campaigns\",\"filePath\":\"/home/runner/.local/share/pnpm/store/.workspaces/arc-happyvertical-node-sqm7p-runner-5xldd/smrt/smrt/packages/marketing/src/collections/CampaignCollection.ts\",\"packageName\":\"@happyvertical/smrt-marketing\",\"fields\":{},\"methods\":{\"findByCampaignKey\":{\"name\":\"findByCampaignKey\",\"async\":true,\"parameters\":[{\"name\":\"campaignKey\",\"type\":\"string\",\"optional\":false},{\"name\":\"tenantId\",\"type\":\"string | null\",\"optional\":true}],\"returnType\":\"Promise<Campaign | null>\",\"isStatic\":false,\"isPublic\":true},\"findByStatus\":{\"name\":\"findByStatus\",\"async\":true,\"parameters\":[{\"name\":\"status\",\"type\":\"CampaignStatus\",\"optional\":false}],\"returnType\":\"Promise<Campaign[]>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"campaigns\"},\"extends\":\"SmrtCollection\",\"extendsTypeArg\":\"Campaign\",\"exportName\":\"CampaignCollection\",\"collectionExportName\":\"CampaignCollectionCollection\",\"schema\":{\"tableName\":\"campaigns\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"campaigns\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"}},\"indexes\":[{\"name\":\"campaigns_id_idx\",\"columns\":[\"id\"]},{\"name\":\"campaigns_slug_context_idx\",\"columns\":[\"slug\",\"context\"],\"unique\":true}],\"version\":\"b1cd973d\"}},\"@happyvertical/smrt-marketing:CampaignMetricSnapshotCollection\":{\"name\":\"campaignmetricsnapshotcollection\",\"className\":\"CampaignMetricSnapshotCollection\",\"qualifiedName\":\"@happyvertical/smrt-marketing:CampaignMetricSnapshotCollection\",\"collection\":\"campaignmetricsnapshots\",\"filePath\":\"/home/runner/.local/share/pnpm/store/.workspaces/arc-happyvertical-node-sqm7p-runner-5xldd/smrt/smrt/packages/marketing/src/collections/CampaignMetricSnapshotCollection.ts\",\"packageName\":\"@happyvertical/smrt-marketing\",\"fields\":{},\"methods\":{\"findByDedupeKey\":{\"name\":\"findByDedupeKey\",\"async\":true,\"parameters\":[{\"name\":\"dedupeKey\",\"type\":\"string\",\"optional\":false}],\"returnType\":\"Promise<CampaignMetricSnapshot | null>\",\"isStatic\":false,\"isPublic\":true},\"getOrCreateByDedupeKey\":{\"name\":\"getOrCreateByDedupeKey\",\"async\":true,\"parameters\":[{\"name\":\"options\",\"type\":\"CampaignMetricSnapshotOptions\",\"optional\":false}],\"returnType\":\"Promise<object>\",\"isStatic\":false,\"isPublic\":true},\"findByCampaign\":{\"name\":\"findByCampaign\",\"async\":true,\"parameters\":[{\"name\":\"campaignId\",\"type\":\"string\",\"optional\":false}],\"returnType\":\"Promise<CampaignMetricSnapshot[]>\",\"isStatic\":false,\"isPublic\":true},\"findByChannel\":{\"name\":\"findByChannel\",\"async\":true,\"parameters\":[{\"name\":\"campaignChannelId\",\"type\":\"string\",\"optional\":false}],\"returnType\":\"Promise<CampaignMetricSnapshot[]>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"campaign_metric_snapshots\"},\"extends\":\"SmrtCollection\",\"extendsTypeArg\":\"CampaignMetricSnapshot\",\"exportName\":\"CampaignMetricSnapshotCollection\",\"collectionExportName\":\"CampaignMetricSnapshotCollectionCollection\",\"schema\":{\"tableName\":\"campaign_metric_snapshots\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"campaign_metric_snapshots\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"}},\"indexes\":[{\"name\":\"campaign_metric_snapshots_id_idx\",\"columns\":[\"id\"]},{\"name\":\"campaign_metric_snapshots_slug_context_idx\",\"columns\":[\"slug\",\"context\"],\"unique\":true}],\"version\":\"268285ee\"}},\"@happyvertical/smrt-marketing:Campaign\":{\"name\":\"campaign\",\"className\":\"Campaign\",\"qualifiedName\":\"@happyvertical/smrt-marketing:Campaign\",\"collection\":\"campaigns\",\"filePath\":\"/home/runner/.local/share/pnpm/store/.workspaces/arc-happyvertical-node-sqm7p-runner-5xldd/smrt/smrt/packages/marketing/src/models/Campaign.ts\",\"packageName\":\"@happyvertical/smrt-marketing\",\"fields\":{\"tenantId\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"sqlType\":\"UUID\",\"nullable\":true,\"__tenancy\":{\"isTenantIdField\":true,\"autoFilter\":true,\"required\":false,\"autoPopulate\":true,\"nullable\":true,\"mode\":\"optional\",\"field\":\"tenantId\",\"allowSuperAdminBypass\":false}}},\"campaignKey\":{\"type\":\"text\",\"required\":true,\"default\":\"\",\"_meta\":{\"required\":true}},\"name\":{\"type\":\"text\",\"required\":true,\"default\":\"\",\"_meta\":{\"required\":true}},\"objective\":{\"type\":\"text\",\"required\":false,\"default\":\"\"},\"status\":{\"type\":\"text\",\"required\":false,\"default\":\"draft\"},\"startAt\":{\"type\":\"datetime\",\"required\":false},\"endAt\":{\"type\":\"datetime\",\"required\":false},\"budgetCents\":{\"type\":\"integer\",\"required\":false,\"default\":0},\"currency\":{\"type\":\"text\",\"required\":false,\"default\":\"USD\"},\"metadata\":{\"type\":\"text\",\"required\":false,\"default\":\"{}\"}},\"methods\":{\"initialize\":{\"name\":\"initialize\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise\",\"isStatic\":false,\"isPublic\":true},\"save\":{\"name\":\"save\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise\",\"isStatic\":false,\"isPublic\":true},\"transitionTo\":{\"name\":\"transitionTo\",\"async\":false,\"parameters\":[{\"name\":\"next\",\"type\":\"CampaignStatus\",\"optional\":false}],\"returnType\":\"any\",\"isStatic\":false,\"isPublic\":true},\"getMetadata\":{\"name\":\"getMetadata\",\"async\":false,\"parameters\":[],\"returnType\":\"Record<string>\",\"isStatic\":false,\"isPublic\":true},\"setMetadata\":{\"name\":\"setMetadata\",\"async\":false,\"parameters\":[{\"name\":\"metadata\",\"type\":\"Record<string>\",\"optional\":false}],\"returnType\":\"void\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"campaigns\",\"conflictColumns\":[\"tenant_id\",\"campaign_key\"],\"api\":{\"include\":[\"list\",\"get\",\"create\",\"update\"]},\"mcp\":{\"include\":[\"list\",\"get\",\"create\",\"update\"]},\"cli\":{\"include\":[\"list\",\"get\",\"create\",\"update\"]},\"tenantScoped\":{\"mode\":\"optional\"}},\"extends\":\"SmrtObject\",\"exportName\":\"Campaign\",\"collectionExportName\":\"CampaignCollection\",\"validationRules\":[{\"field\":\"campaignKey\",\"rule\":\"required\",\"fieldType\":\"text\"},{\"field\":\"name\",\"rule\":\"required\",\"fieldType\":\"text\"}],\"schema\":{\"tableName\":\"campaigns\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"campaigns\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID,\\n  \\\"campaign_key\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"name\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"objective\\\" TEXT DEFAULT '',\\n  \\\"status\\\" TEXT DEFAULT 'draft',\\n  \\\"start_at\\\" TIMESTAMP,\\n  \\\"end_at\\\" TIMESTAMP,\\n  \\\"budget_cents\\\" INTEGER DEFAULT 0,\\n  \\\"currency\\\" TEXT DEFAULT 'USD',\\n  \\\"metadata\\\" TEXT DEFAULT '{}'\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":false,\"unique\":false},\"campaign_key\":{\"type\":\"TEXT\",\"notNull\":true,\"unique\":false,\"default\":\"\"},\"name\":{\"type\":\"TEXT\",\"notNull\":true,\"unique\":false,\"default\":\"\"},\"objective\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false,\"default\":\"\"},\"status\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false,\"default\":\"draft\"},\"start_at\":{\"type\":\"TIMESTAMP\",\"notNull\":false,\"unique\":false},\"end_at\":{\"type\":\"TIMESTAMP\",\"notNull\":false,\"unique\":false},\"budget_cents\":{\"type\":\"INTEGER\",\"notNull\":false,\"unique\":false,\"default\":0},\"currency\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false,\"default\":\"USD\"},\"metadata\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false,\"default\":\"{}\"}},\"indexes\":[{\"name\":\"campaigns_id_idx\",\"columns\":[\"id\"]},{\"name\":\"campaigns_tenant_id_campaign_key_idx\",\"columns\":[\"tenant_id\",\"campaign_key\"],\"unique\":true}],\"version\":\"1963ebd3\"}},\"@happyvertical/smrt-marketing:CampaignChannel\":{\"name\":\"campaignchannel\",\"className\":\"CampaignChannel\",\"qualifiedName\":\"@happyvertical/smrt-marketing:CampaignChannel\",\"collection\":\"campaignchannels\",\"filePath\":\"/home/runner/.local/share/pnpm/store/.workspaces/arc-happyvertical-node-sqm7p-runner-5xldd/smrt/smrt/packages/marketing/src/models/CampaignChannel.ts\",\"packageName\":\"@happyvertical/smrt-marketing\",\"fields\":{\"tenantId\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"sqlType\":\"UUID\",\"nullable\":true,\"__tenancy\":{\"isTenantIdField\":true,\"autoFilter\":true,\"required\":false,\"autoPopulate\":true,\"nullable\":true,\"mode\":\"optional\",\"field\":\"tenantId\",\"allowSuperAdminBypass\":false}}},\"campaignId\":{\"type\":\"foreignKey\",\"required\":true,\"related\":\"Campaign\",\"_meta\":{\"required\":true}},\"channelKind\":{\"type\":\"text\",\"required\":true,\"default\":\"\",\"_meta\":{\"required\":true}},\"channelRef\":{\"type\":\"text\",\"required\":true,\"default\":\"\",\"_meta\":{\"required\":true}},\"allocatedBudgetCents\":{\"type\":\"integer\",\"required\":false,\"default\":0},\"startAt\":{\"type\":\"datetime\",\"required\":false},\"endAt\":{\"type\":\"datetime\",\"required\":false},\"status\":{\"type\":\"text\",\"required\":false,\"default\":\"planned\"}},\"methods\":{\"initialize\":{\"name\":\"initialize\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise\",\"isStatic\":false,\"isPublic\":true},\"save\":{\"name\":\"save\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"campaign_channels\",\"conflictColumns\":[\"campaign_id\",\"channel_kind\",\"channel_ref\"],\"api\":{\"include\":[\"list\",\"get\",\"create\",\"update\",\"delete\"]},\"mcp\":{\"include\":[\"list\",\"get\",\"create\",\"update\"]},\"cli\":{\"include\":[\"list\",\"get\",\"create\",\"update\",\"delete\"]},\"tenantScoped\":{\"mode\":\"optional\"}},\"extends\":\"SmrtObject\",\"exportName\":\"CampaignChannel\",\"collectionExportName\":\"CampaignChannelCollection\",\"validationRules\":[{\"field\":\"campaignId\",\"rule\":\"required\",\"fieldType\":\"foreignKey\"},{\"field\":\"channelKind\",\"rule\":\"required\",\"fieldType\":\"text\"},{\"field\":\"channelRef\",\"rule\":\"required\",\"fieldType\":\"text\"}],\"schema\":{\"tableName\":\"campaign_channels\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"campaign_channels\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID,\\n  \\\"campaign_id\\\" UUID NOT NULL,\\n  \\\"channel_kind\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"channel_ref\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"allocated_budget_cents\\\" INTEGER DEFAULT 0,\\n  \\\"start_at\\\" TIMESTAMP,\\n  \\\"end_at\\\" TIMESTAMP,\\n  \\\"status\\\" TEXT DEFAULT 'planned'\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":false,\"unique\":false},\"campaign_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":true,\"unique\":false},\"channel_kind\":{\"type\":\"TEXT\",\"notNull\":true,\"unique\":false,\"default\":\"\"},\"channel_ref\":{\"type\":\"TEXT\",\"notNull\":true,\"unique\":false,\"default\":\"\"},\"allocated_budget_cents\":{\"type\":\"INTEGER\",\"notNull\":false,\"unique\":false,\"default\":0},\"start_at\":{\"type\":\"TIMESTAMP\",\"notNull\":false,\"unique\":false},\"end_at\":{\"type\":\"TIMESTAMP\",\"notNull\":false,\"unique\":false},\"status\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false,\"default\":\"planned\"}},\"indexes\":[{\"name\":\"campaign_channels_id_idx\",\"columns\":[\"id\"]},{\"name\":\"campaign_channels_campaign_id_channel_kind_idx\",\"columns\":[\"campaign_id\",\"channel_kind\",\"channel_ref\"],\"unique\":true}],\"version\":\"40163dfc\"}},\"@happyvertical/smrt-marketing:CampaignMetricSnapshot\":{\"name\":\"campaignmetricsnapshot\",\"className\":\"CampaignMetricSnapshot\",\"qualifiedName\":\"@happyvertical/smrt-marketing:CampaignMetricSnapshot\",\"collection\":\"campaignmetricsnapshots\",\"filePath\":\"/home/runner/.local/share/pnpm/store/.workspaces/arc-happyvertical-node-sqm7p-runner-5xldd/smrt/smrt/packages/marketing/src/models/CampaignMetricSnapshot.ts\",\"packageName\":\"@happyvertical/smrt-marketing\",\"fields\":{\"tenantId\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"sqlType\":\"UUID\",\"nullable\":true,\"__tenancy\":{\"isTenantIdField\":true,\"autoFilter\":true,\"required\":false,\"autoPopulate\":true,\"nullable\":true,\"mode\":\"optional\",\"field\":\"tenantId\",\"allowSuperAdminBypass\":false}}},\"campaignId\":{\"type\":\"foreignKey\",\"required\":true,\"related\":\"Campaign\",\"_meta\":{\"required\":true}},\"campaignChannelId\":{\"type\":\"foreignKey\",\"required\":false,\"related\":\"CampaignChannel\",\"_meta\":{\"nullable\":true}},\"periodStart\":{\"type\":\"datetime\",\"required\":true,\"_meta\":{\"required\":true}},\"periodEnd\":{\"type\":\"datetime\",\"required\":true,\"_meta\":{\"required\":true}},\"spendCents\":{\"type\":\"integer\",\"required\":false,\"default\":0},\"impressions\":{\"type\":\"integer\",\"required\":false,\"default\":0},\"clicks\":{\"type\":\"integer\",\"required\":false,\"default\":0},\"conversions\":{\"type\":\"integer\",\"required\":false,\"default\":0},\"leads\":{\"type\":\"integer\",\"required\":false,\"default\":0},\"revenueCents\":{\"type\":\"integer\",\"required\":false,\"_meta\":{\"nullable\":true}},\"source\":{\"type\":\"text\",\"required\":true,\"default\":\"\",\"_meta\":{\"required\":true}},\"dedupeKey\":{\"type\":\"text\",\"required\":true,\"default\":\"\",\"_meta\":{\"required\":true}}},\"methods\":{\"initialize\":{\"name\":\"initialize\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise\",\"isStatic\":false,\"isPublic\":true},\"save\":{\"name\":\"save\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise\",\"isStatic\":false,\"isPublic\":true},\"delete\":{\"name\":\"delete\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<void>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"campaign_metric_snapshots\",\"conflictColumns\":[\"dedupe_key\"],\"api\":{\"include\":[\"list\",\"get\",\"create\"]},\"mcp\":{\"include\":[\"list\",\"get\",\"create\"]},\"cli\":{\"include\":[\"list\",\"get\",\"create\"]},\"tenantScoped\":{\"mode\":\"optional\"}},\"extends\":\"SmrtObject\",\"exportName\":\"CampaignMetricSnapshot\",\"collectionExportName\":\"CampaignMetricSnapshotCollection\",\"validationRules\":[{\"field\":\"campaignId\",\"rule\":\"required\",\"fieldType\":\"foreignKey\"},{\"field\":\"periodStart\",\"rule\":\"required\",\"fieldType\":\"datetime\"},{\"field\":\"periodEnd\",\"rule\":\"required\",\"fieldType\":\"datetime\"},{\"field\":\"source\",\"rule\":\"required\",\"fieldType\":\"text\"},{\"field\":\"dedupeKey\",\"rule\":\"required\",\"fieldType\":\"text\"}],\"schema\":{\"tableName\":\"campaign_metric_snapshots\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"campaign_metric_snapshots\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID,\\n  \\\"campaign_id\\\" UUID NOT NULL,\\n  \\\"campaign_channel_id\\\" UUID,\\n  \\\"period_start\\\" TIMESTAMP NOT NULL,\\n  \\\"period_end\\\" TIMESTAMP NOT NULL,\\n  \\\"spend_cents\\\" INTEGER DEFAULT 0,\\n  \\\"impressions\\\" INTEGER DEFAULT 0,\\n  \\\"clicks\\\" INTEGER DEFAULT 0,\\n  \\\"conversions\\\" INTEGER DEFAULT 0,\\n  \\\"leads\\\" INTEGER DEFAULT 0,\\n  \\\"revenue_cents\\\" INTEGER,\\n  \\\"source\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"dedupe_key\\\" TEXT NOT NULL DEFAULT ''\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":false,\"unique\":false},\"campaign_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":true,\"unique\":false},\"campaign_channel_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false,\"unique\":false},\"period_start\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"unique\":false},\"period_end\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"unique\":false},\"spend_cents\":{\"type\":\"INTEGER\",\"notNull\":false,\"unique\":false,\"default\":0},\"impressions\":{\"type\":\"INTEGER\",\"notNull\":false,\"unique\":false,\"default\":0},\"clicks\":{\"type\":\"INTEGER\",\"notNull\":false,\"unique\":false,\"default\":0},\"conversions\":{\"type\":\"INTEGER\",\"notNull\":false,\"unique\":false,\"default\":0},\"leads\":{\"type\":\"INTEGER\",\"notNull\":false,\"unique\":false,\"default\":0},\"revenue_cents\":{\"type\":\"INTEGER\",\"notNull\":false,\"unique\":false},\"source\":{\"type\":\"TEXT\",\"notNull\":true,\"unique\":false,\"default\":\"\"},\"dedupe_key\":{\"type\":\"TEXT\",\"notNull\":true,\"unique\":false,\"default\":\"\"}},\"indexes\":[{\"name\":\"campaign_metric_snapshots_id_idx\",\"columns\":[\"id\"]},{\"name\":\"campaign_metric_snapshots_dedupe_key_idx\",\"columns\":[\"dedupe_key\"],\"unique\":true}],\"version\":\"87e87389\"}}},\"moduleType\":\"smrt\",\"smrtDependencies\":[\"@happyvertical/smrt-core\",\"@happyvertical/smrt-tenancy\"]}"));
+//#endregion
+//#region src/models/Campaign.ts
+var __defProp$2 = Object.defineProperty;
+var __getOwnPropDesc$2 = Object.getOwnPropertyDescriptor;
+var __decorateClass$2 = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$2(target, key) : target;
+	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+	if (kind && result) __defProp$2(target, key, result);
+	return result;
+};
+var CAMPAIGN_STATUS_TRANSITIONS = {
+	draft: ["scheduled"],
+	scheduled: ["active"],
+	active: ["paused", "completed"],
+	paused: ["active", "completed"],
+	completed: ["archived"],
+	archived: []
+};
+var loadedCampaignStatus = /* @__PURE__ */ new WeakMap();
+var Campaign = class extends SmrtObject {
+	tenantId = null;
+	campaignKey = "";
+	name = "";
+	/** Open objective key such as `awareness` or `demand_generation`. */
+	objective = "";
+	status = "draft";
+	startAt = null;
+	endAt = null;
+	/** Total campaign budget in integer cents. */
+	budgetCents = 0;
+	/** ISO 4217 currency for every campaign/channel amount. */
+	currency = "USD";
+	metadata = "{}";
+	constructor(options = {}) {
+		super(options);
+		if (options.tenantId !== void 0) this.tenantId = options.tenantId;
+		if (options.campaignKey !== void 0) this.campaignKey = options.campaignKey;
+		if (options.name !== void 0) this.name = options.name;
+		if (options.objective !== void 0) this.objective = options.objective;
+		if (options.status !== void 0) this.status = options.status;
+		if (options.startAt !== void 0) this.startAt = Campaign.coerceDate(options.startAt);
+		if (options.endAt !== void 0) this.endAt = Campaign.coerceDate(options.endAt);
+		if (options.budgetCents !== void 0) this.budgetCents = options.budgetCents;
+		if (options.currency !== void 0) this.currency = options.currency;
+		if (options.metadata !== void 0) this.metadata = options.metadata;
+	}
+	async initialize() {
+		await super.initialize();
+		this.startAt = Campaign.coerceDate(this.startAt);
+		this.endAt = Campaign.coerceDate(this.endAt);
+		if (await this.isSaved()) loadedCampaignStatus.set(this, this.status);
+		return this;
+	}
+	async save() {
+		const prior = await this.resolvePriorStatus();
+		this.assertStatusTransition(prior);
+		this.assertSchedule();
+		const result = await super.save();
+		loadedCampaignStatus.set(this, this.status);
+		return result;
+	}
+	/** Apply one legal transition in memory; callers choose the save boundary. */
+	transitionTo(next) {
+		if (next === this.status) return this;
+		if (!(CAMPAIGN_STATUS_TRANSITIONS[this.status] ?? []).includes(next)) throw new Error(`Campaign ${this.campaignKey || this.id}: cannot transition '${this.status}' \u2192 '${next}'.`);
+		this.status = next;
+		return this;
+	}
+	getMetadata() {
+		if (!this.metadata) return {};
+		try {
+			const parsed = JSON.parse(this.metadata);
+			return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
+		} catch {
+			return {};
+		}
+	}
+	setMetadata(metadata) {
+		this.metadata = JSON.stringify(metadata ?? {});
+	}
+	assertSchedule() {
+		if (this.startAt && this.endAt && this.endAt.getTime() < this.startAt.getTime()) throw new Error("Campaign endAt must be on or after startAt.");
+		if (!Number.isInteger(this.budgetCents) || this.budgetCents < 0) throw new Error("Campaign budgetCents must be a non-negative integer.");
+	}
+	async resolvePriorStatus() {
+		if (this.id) try {
+			const row = await this.db.get(this.tableName, { id: this.id });
+			if (row && row.status != null) return row.status;
+		} catch {}
+		if (this.campaignKey) try {
+			const row = await this.db.get(this.tableName, {
+				tenant_id: this.tenantId,
+				campaign_key: this.campaignKey
+			});
+			if (row && row.status != null) return row.status;
+		} catch {}
+		return loadedCampaignStatus.get(this);
+	}
+	assertStatusTransition(prior) {
+		if (!CAMPAIGN_STATUSES.includes(this.status)) throw new Error(`Campaign ${this.campaignKey || this.id}: unknown status '${this.status}'.`);
+		if (prior === void 0 || prior === this.status) return;
+		if (!(CAMPAIGN_STATUS_TRANSITIONS[prior] ?? []).includes(this.status)) throw new Error(`Campaign ${this.campaignKey || this.id}: illegal status transition '${prior}' \u2192 '${this.status}'.`);
+	}
+	static coerceDate(value) {
+		if (value == null) return null;
+		if (value instanceof Date) return value;
+		if (typeof value === "number" || typeof value === "string") {
+			const date = new Date(value);
+			return Number.isNaN(date.getTime()) ? null : date;
+		}
+		return null;
+	}
+};
+__decorateClass$2([tenantId({ nullable: true })], Campaign.prototype, "tenantId", 2);
+__decorateClass$2([field({ required: true })], Campaign.prototype, "campaignKey", 2);
+__decorateClass$2([field({ required: true })], Campaign.prototype, "name", 2);
+Campaign = __decorateClass$2([TenantScoped({ mode: "optional" }), smrt({
+	tableName: "campaigns",
+	conflictColumns: ["tenant_id", "campaign_key"],
+	api: { include: [
+		"list",
+		"get",
+		"create",
+		"update"
+	] },
+	mcp: { include: [
+		"list",
+		"get",
+		"create",
+		"update"
+	] },
+	cli: { include: [
+		"list",
+		"get",
+		"create",
+		"update"
+	] }
+})], Campaign);
+//#endregion
+//#region src/models/CampaignChannel.ts
+var __defProp$1 = Object.defineProperty;
+var __getOwnPropDesc$1 = Object.getOwnPropertyDescriptor;
+var __decorateClass$1 = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$1(target, key) : target;
+	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+	if (kind && result) __defProp$1(target, key, result);
+	return result;
+};
+var CampaignChannel = class extends SmrtObject {
+	tenantId = null;
+	campaignId = "";
+	channelKind = "";
+	channelRef = "";
+	allocatedBudgetCents = 0;
+	/** Optional execution-specific override of the Campaign start. */
+	startAt = null;
+	/** Optional execution-specific override of the Campaign end. */
+	endAt = null;
+	status = "planned";
+	constructor(options = {}) {
+		super(options);
+		if (options.tenantId !== void 0) this.tenantId = options.tenantId;
+		if (options.campaignId !== void 0) this.campaignId = options.campaignId;
+		if (options.channelKind !== void 0) this.channelKind = options.channelKind;
+		if (options.channelRef !== void 0) this.channelRef = options.channelRef;
+		if (options.allocatedBudgetCents !== void 0) this.allocatedBudgetCents = options.allocatedBudgetCents;
+		if (options.startAt !== void 0) this.startAt = CampaignChannel.coerceDate(options.startAt);
+		if (options.endAt !== void 0) this.endAt = CampaignChannel.coerceDate(options.endAt);
+		if (options.status !== void 0) this.status = options.status;
+	}
+	async initialize() {
+		await super.initialize();
+		this.startAt = CampaignChannel.coerceDate(this.startAt);
+		this.endAt = CampaignChannel.coerceDate(this.endAt);
+		return this;
+	}
+	async save() {
+		if (!CAMPAIGN_CHANNEL_STATUSES.includes(this.status)) throw new Error(`CampaignChannel ${this.channelRef || this.id}: unknown status '${this.status}'.`);
+		if (!Number.isInteger(this.allocatedBudgetCents) || this.allocatedBudgetCents < 0) throw new Error("CampaignChannel allocatedBudgetCents must be a non-negative integer.");
+		if (this.startAt && this.endAt && this.endAt.getTime() < this.startAt.getTime()) throw new Error("CampaignChannel endAt must be on or after startAt.");
+		return await super.save();
+	}
+	static coerceDate(value) {
+		if (value == null) return null;
+		if (value instanceof Date) return value;
+		if (typeof value === "number" || typeof value === "string") {
+			const date = new Date(value);
+			return Number.isNaN(date.getTime()) ? null : date;
+		}
+		return null;
+	}
+};
+__decorateClass$1([tenantId({ nullable: true })], CampaignChannel.prototype, "tenantId", 2);
+__decorateClass$1([foreignKey(Campaign, { required: true })], CampaignChannel.prototype, "campaignId", 2);
+__decorateClass$1([field({ required: true })], CampaignChannel.prototype, "channelKind", 2);
+__decorateClass$1([field({ required: true })], CampaignChannel.prototype, "channelRef", 2);
+CampaignChannel = __decorateClass$1([TenantScoped({ mode: "optional" }), smrt({
+	tableName: "campaign_channels",
+	conflictColumns: [
+		"campaign_id",
+		"channel_kind",
+		"channel_ref"
+	],
+	api: { include: [
+		"list",
+		"get",
+		"create",
+		"update",
+		"delete"
+	] },
+	mcp: { include: [
+		"list",
+		"get",
+		"create",
+		"update"
+	] },
+	cli: { include: [
+		"list",
+		"get",
+		"create",
+		"update",
+		"delete"
+	] }
+})], CampaignChannel);
+//#endregion
+//#region src/collections/CampaignChannelCollection.ts
+var CampaignChannelCollection = class extends SmrtCollection {
+	static _itemClass = CampaignChannel;
+	async findByCampaign(campaignId) {
+		return await this.list({
+			where: { campaignId },
+			orderBy: "start_at ASC"
+		});
+	}
+	async findByExecutionRef(channelKind, channelRef) {
+		return await this.list({ where: {
+			channelKind,
+			channelRef
+		} });
+	}
+};
+//#endregion
+//#region src/collections/CampaignCollection.ts
+var CampaignCollection = class extends SmrtCollection {
+	static _itemClass = Campaign;
+	async findByCampaignKey(campaignKey, tenantId) {
+		if (!campaignKey) return null;
+		const where = { campaignKey };
+		if (tenantId !== void 0) where.tenantId = tenantId;
+		return (await this.list({
+			where,
+			limit: 1
+		}))[0] ?? null;
+	}
+	async findByStatus(status) {
+		return await this.list({
+			where: { status },
+			orderBy: "start_at ASC"
+		});
+	}
+};
+//#endregion
+//#region src/models/CampaignMetricSnapshot.ts
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+	if (kind && result) __defProp(target, key, result);
+	return result;
+};
+var persistedSnapshotState = /* @__PURE__ */ new WeakMap();
+var CampaignMetricSnapshot = class extends SmrtObject {
+	tenantId = null;
+	campaignId = "";
+	campaignChannelId = null;
+	periodStart = /* @__PURE__ */ new Date();
+	periodEnd = /* @__PURE__ */ new Date();
+	spendCents = 0;
+	impressions = 0;
+	clicks = 0;
+	conversions = 0;
+	leads = 0;
+	revenueCents = null;
+	source = "";
+	dedupeKey = "";
+	constructor(options = {}) {
+		super(options);
+		if (options.tenantId !== void 0) this.tenantId = options.tenantId;
+		if (options.campaignId !== void 0) this.campaignId = options.campaignId;
+		if (options.campaignChannelId !== void 0) this.campaignChannelId = options.campaignChannelId;
+		if (options.periodStart !== void 0) this.periodStart = CampaignMetricSnapshot.coerceDate(options.periodStart) ?? /* @__PURE__ */ new Date(NaN);
+		if (options.periodEnd !== void 0) this.periodEnd = CampaignMetricSnapshot.coerceDate(options.periodEnd) ?? /* @__PURE__ */ new Date(NaN);
+		if (options.spendCents !== void 0) this.spendCents = options.spendCents;
+		if (options.impressions !== void 0) this.impressions = options.impressions;
+		if (options.clicks !== void 0) this.clicks = options.clicks;
+		if (options.conversions !== void 0) this.conversions = options.conversions;
+		if (options.leads !== void 0) this.leads = options.leads;
+		if (options.revenueCents !== void 0) this.revenueCents = options.revenueCents;
+		if (options.source !== void 0) this.source = options.source;
+		if (options.dedupeKey !== void 0) this.dedupeKey = options.dedupeKey;
+	}
+	async initialize() {
+		await super.initialize();
+		this.periodStart = CampaignMetricSnapshot.coerceDate(this.periodStart) ?? /* @__PURE__ */ new Date(NaN);
+		this.periodEnd = CampaignMetricSnapshot.coerceDate(this.periodEnd) ?? /* @__PURE__ */ new Date(NaN);
+		if (this.isPersisted) persistedSnapshotState.set(this, this.serializeState());
+		return this;
+	}
+	async save() {
+		this.assertMetrics();
+		await this.assertChannelMatchesCampaign();
+		const captured = persistedSnapshotState.get(this);
+		if (captured !== void 0) {
+			if (captured !== this.serializeState()) throw new Error(`CampaignMetricSnapshot ${this.id ?? "<new>"}: metric snapshots are immutable evidence; ingest a correcting snapshot instead.`);
+		} else if (this.id && await this.isSaved()) throw new Error(`CampaignMetricSnapshot ${this.id}: refusing to overwrite an existing snapshot from a non-hydrated instance; snapshots are immutable evidence.`);
+		else if (this.dedupeKey) try {
+			const row = await this.db.get(this.tableName, { dedupe_key: this.dedupeKey });
+			if (row && row.id !== this.id) throw new Error(`CampaignMetricSnapshot (dedupeKey '${this.dedupeKey}'): a snapshot with this dedupe key already exists; use MetricIngestionService for idempotent ingestion.`);
+		} catch (error) {
+			if (error instanceof Error && error.message.includes("idempotent ingestion")) throw error;
+		}
+		const result = await super.save();
+		persistedSnapshotState.set(this, this.serializeState());
+		return result;
+	}
+	async delete() {
+		throw new Error(`CampaignMetricSnapshot ${this.id ?? "<new>"}: metric snapshots are immutable evidence and cannot be deleted.`);
+	}
+	assertMetrics() {
+		if (Number.isNaN(this.periodStart.getTime()) || Number.isNaN(this.periodEnd.getTime())) throw new Error("CampaignMetricSnapshot periodStart and periodEnd must be valid dates.");
+		if (this.periodEnd.getTime() < this.periodStart.getTime()) throw new Error("CampaignMetricSnapshot periodEnd must be on or after periodStart.");
+		const integerMetrics = [
+			["spendCents", this.spendCents],
+			["impressions", this.impressions],
+			["clicks", this.clicks],
+			["conversions", this.conversions],
+			["leads", this.leads]
+		];
+		for (const [name, value] of integerMetrics) if (!Number.isInteger(value) || value < 0) throw new Error(`${name} must be a non-negative integer.`);
+		if (this.revenueCents !== null && (!Number.isInteger(this.revenueCents) || this.revenueCents < 0)) throw new Error("revenueCents must be null or a non-negative integer.");
+	}
+	async assertChannelMatchesCampaign() {
+		if (!this.campaignChannelId) return;
+		if ((await this.loadRelated("campaignChannelId")).campaignId !== this.campaignId) throw new Error(`CampaignMetricSnapshot campaignChannelId '${this.campaignChannelId}' does not belong to campaignId '${this.campaignId}'.`);
+	}
+	serializeState() {
+		return JSON.stringify({
+			tenantId: this.tenantId,
+			campaignId: this.campaignId,
+			campaignChannelId: this.campaignChannelId,
+			periodStart: this.periodStart.toISOString(),
+			periodEnd: this.periodEnd.toISOString(),
+			spendCents: this.spendCents,
+			impressions: this.impressions,
+			clicks: this.clicks,
+			conversions: this.conversions,
+			leads: this.leads,
+			revenueCents: this.revenueCents,
+			source: this.source,
+			dedupeKey: this.dedupeKey
+		});
+	}
+	static coerceDate(value) {
+		if (value instanceof Date) return Number.isNaN(value.getTime()) ? null : value;
+		if (typeof value === "number" || typeof value === "string") {
+			const date = new Date(value);
+			return Number.isNaN(date.getTime()) ? null : date;
+		}
+		return null;
+	}
+};
+__decorateClass([tenantId({ nullable: true })], CampaignMetricSnapshot.prototype, "tenantId", 2);
+__decorateClass([foreignKey(Campaign, { required: true })], CampaignMetricSnapshot.prototype, "campaignId", 2);
+__decorateClass([foreignKey(CampaignChannel, { nullable: true })], CampaignMetricSnapshot.prototype, "campaignChannelId", 2);
+__decorateClass([field({ required: true })], CampaignMetricSnapshot.prototype, "periodStart", 2);
+__decorateClass([field({ required: true })], CampaignMetricSnapshot.prototype, "periodEnd", 2);
+__decorateClass([field({
+	type: "integer",
+	nullable: true
+})], CampaignMetricSnapshot.prototype, "revenueCents", 2);
+__decorateClass([field({ required: true })], CampaignMetricSnapshot.prototype, "source", 2);
+__decorateClass([field({ required: true })], CampaignMetricSnapshot.prototype, "dedupeKey", 2);
+CampaignMetricSnapshot = __decorateClass([TenantScoped({ mode: "optional" }), smrt({
+	tableName: "campaign_metric_snapshots",
+	conflictColumns: ["dedupe_key"],
+	api: { include: [
+		"list",
+		"get",
+		"create"
+	] },
+	mcp: { include: [
+		"list",
+		"get",
+		"create"
+	] },
+	cli: { include: [
+		"list",
+		"get",
+		"create"
+	] }
+})], CampaignMetricSnapshot);
+//#endregion
+//#region src/collections/CampaignMetricSnapshotCollection.ts
+var CampaignMetricSnapshotCollection = class extends SmrtCollection {
+	static _itemClass = CampaignMetricSnapshot;
+	async findByDedupeKey(dedupeKey) {
+		if (!dedupeKey) return null;
+		return (await this.list({
+			where: { dedupeKey },
+			limit: 1
+		}))[0] ?? null;
+	}
+	async getOrCreateByDedupeKey(options) {
+		const dedupeKey = options.dedupeKey ?? "";
+		if (!dedupeKey) throw new Error("CampaignMetricSnapshotCollection.getOrCreateByDedupeKey requires a dedupeKey.");
+		const existing = await this.findByDedupeKey(dedupeKey);
+		if (existing) return {
+			snapshot: existing,
+			created: false
+		};
+		try {
+			return {
+				snapshot: await this.create({
+					...options,
+					periodStart: options.periodStart,
+					periodEnd: options.periodEnd,
+					_insertOnly: true
+				}),
+				created: true
+			};
+		} catch (error) {
+			const concurrent = await this.findByDedupeKey(dedupeKey);
+			if (concurrent) return {
+				snapshot: concurrent,
+				created: false
+			};
+			throw error;
+		}
+	}
+	async findByCampaign(campaignId) {
+		return await this.list({
+			where: { campaignId },
+			orderBy: "period_start ASC"
+		});
+	}
+	async findByChannel(campaignChannelId) {
+		return await this.list({
+			where: { campaignChannelId },
+			orderBy: "period_start ASC"
+		});
+	}
+};
+//#endregion
+//#region src/services/BudgetPacingService.ts
+var BudgetPacingService = class BudgetPacingService {
+	constructor(campaigns, channels, snapshots) {
+		this.campaigns = campaigns;
+		this.channels = channels;
+		this.snapshots = snapshots;
+	}
+	campaigns;
+	channels;
+	snapshots;
+	static async create(classOptions = {}) {
+		return new BudgetPacingService(await CampaignCollection.create(classOptions), await CampaignChannelCollection.create(classOptions), await CampaignMetricSnapshotCollection.create(classOptions));
+	}
+	async getCampaignPacing(campaignId, at = /* @__PURE__ */ new Date()) {
+		const campaign = await this.campaigns.get({ id: campaignId });
+		if (!campaign) throw new Error(`Campaign '${campaignId}' was not found.`);
+		const all = await this.snapshots.findByCampaign(campaignId);
+		const rollups = all.filter((snapshot) => !snapshot.campaignChannelId);
+		const used = this.selectCampaignEvidence(all);
+		return this.calculate({
+			campaign,
+			snapshots: used,
+			budgetCents: campaign.budgetCents,
+			startAt: campaign.startAt,
+			endAt: campaign.endAt,
+			at,
+			usedCampaignRollups: rollups.length > 0
+		});
+	}
+	async getChannelPacing(campaignChannelId, at = /* @__PURE__ */ new Date()) {
+		const channel = await this.channels.get({ id: campaignChannelId });
+		if (!channel) throw new Error(`CampaignChannel '${campaignChannelId}' was not found.`);
+		const campaign = await this.campaigns.get({ id: channel.campaignId });
+		if (!campaign) throw new Error(`Campaign '${channel.campaignId}' was not found.`);
+		const snapshots = await this.snapshots.findByChannel(campaignChannelId);
+		return {
+			...this.calculate({
+				campaign,
+				snapshots,
+				budgetCents: channel.allocatedBudgetCents,
+				startAt: channel.startAt ?? campaign.startAt,
+				endAt: channel.endAt ?? campaign.endAt,
+				at,
+				usedCampaignRollups: false
+			}),
+			campaignChannelId
+		};
+	}
+	calculate({ campaign, snapshots, budgetCents, startAt, endAt, at, usedCampaignRollups }) {
+		const spendCents = snapshots.reduce((sum, snapshot) => sum + snapshot.spendCents, 0);
+		const elapsedFraction = this.elapsedFraction(startAt, endAt, at);
+		const expectedSpendCents = elapsedFraction === null ? null : Math.round(budgetCents * elapsedFraction);
+		const varianceCents = expectedSpendCents === null ? null : spendCents - expectedSpendCents;
+		const budgetFraction = budgetCents > 0 ? spendCents / budgetCents : null;
+		return {
+			campaignId: campaign.id ?? "",
+			currency: campaign.currency,
+			budgetCents,
+			spendCents,
+			remainingCents: budgetCents - spendCents,
+			expectedSpendCents,
+			varianceCents,
+			budgetFraction,
+			elapsedFraction,
+			status: this.pacingStatus({
+				campaign,
+				budgetCents,
+				spendCents,
+				elapsedFraction,
+				varianceCents,
+				startAt,
+				at
+			}),
+			snapshotCount: snapshots.length,
+			usedCampaignRollups
+		};
+	}
+	pacingStatus({ campaign, budgetCents, spendCents, elapsedFraction, varianceCents, startAt, at }) {
+		if (budgetCents <= 0) return "unbudgeted";
+		if (spendCents > budgetCents) return "over_budget";
+		if (startAt && at.getTime() < startAt.getTime()) return "not_started";
+		if (campaign.status === "completed" || campaign.status === "archived" || elapsedFraction === 1) return "complete";
+		if (varianceCents === null) return "on_track";
+		const toleranceCents = Math.max(1, Math.round(budgetCents * .05));
+		if (varianceCents > toleranceCents) return "ahead";
+		if (varianceCents < -toleranceCents) return "behind";
+		return "on_track";
+	}
+	/**
+	* Prefer a campaign rollup for each exact reporting period, while retaining
+	* channel evidence for periods that do not yet have a rollup. This prevents
+	* double counting without dropping earlier/later channel-only periods.
+	*/
+	selectCampaignEvidence(snapshots) {
+		const rollupPeriods = new Set(snapshots.filter((snapshot) => !snapshot.campaignChannelId).map((snapshot) => this.periodKey(snapshot)));
+		return snapshots.filter((snapshot) => !snapshot.campaignChannelId || !rollupPeriods.has(this.periodKey(snapshot)));
+	}
+	periodKey(snapshot) {
+		return `${snapshot.periodStart.toISOString()}:${snapshot.periodEnd.toISOString()}`;
+	}
+	elapsedFraction(startAt, endAt, at) {
+		if (!startAt || !endAt) return null;
+		const start = startAt.getTime();
+		const end = endAt.getTime();
+		if (end <= start) return at.getTime() < start ? 0 : 1;
+		return Math.min(1, Math.max(0, (at.getTime() - start) / (end - start)));
+	}
+};
+//#endregion
+//#region src/services/CampaignLifecycleService.ts
+var CampaignLifecycleService = class CampaignLifecycleService {
+	constructor(campaigns) {
+		this.campaigns = campaigns;
+	}
+	campaigns;
+	static async create(classOptions = {}) {
+		return new CampaignLifecycleService(await CampaignCollection.create(classOptions));
+	}
+	async transition(campaignId, next) {
+		const campaign = await this.campaigns.get({ id: campaignId });
+		if (!campaign) throw new Error(`Campaign '${campaignId}' was not found.`);
+		campaign.transitionTo(next);
+		await campaign.save();
+		return campaign;
+	}
+	async schedule(campaignId) {
+		return await this.transition(campaignId, "scheduled");
+	}
+	async activate(campaignId) {
+		return await this.transition(campaignId, "active");
+	}
+	async pause(campaignId) {
+		return await this.transition(campaignId, "paused");
+	}
+	async resume(campaignId) {
+		return await this.transition(campaignId, "active");
+	}
+	async complete(campaignId) {
+		return await this.transition(campaignId, "completed");
+	}
+	async archive(campaignId) {
+		return await this.transition(campaignId, "archived");
+	}
+};
+//#endregion
+//#region src/services/MetricIngestionService.ts
+var MetricIngestionService = class MetricIngestionService {
+	constructor(snapshots) {
+		this.snapshots = snapshots;
+	}
+	snapshots;
+	static async create(classOptions = {}) {
+		return new MetricIngestionService(await CampaignMetricSnapshotCollection.create(classOptions));
+	}
+	async ingest(options) {
+		if (!options.campaignId) throw new Error("Metric ingestion requires campaignId.");
+		if (!options.source?.trim()) throw new Error("Metric ingestion requires source.");
+		if (!options.dedupeKey?.trim()) throw new Error("Metric ingestion requires dedupeKey.");
+		if (options.periodStart == null || options.periodEnd == null) throw new Error("Metric ingestion requires periodStart and periodEnd.");
+		return await this.snapshots.getOrCreateByDedupeKey(options);
+	}
+};
+//#endregion
+export { BudgetPacingService, CAMPAIGN_CHANNEL_KINDS, CAMPAIGN_CHANNEL_STATUSES, CAMPAIGN_STATUSES, Campaign, CampaignChannel, CampaignChannelCollection, CampaignCollection, CampaignLifecycleService, CampaignMetricSnapshot, CampaignMetricSnapshotCollection, MetricIngestionService };
+
+//# sourceMappingURL=index.js.map