@happyvertical/smrt-marketing 0.39.16

package/dist/models/Campaign.d.ts

@@ -0,0 +1,31 @@
+import { SmrtObject } from '@happyvertical/smrt-core';
+import { CampaignOptions, CampaignStatus } from '../types.js';
+export declare class Campaign extends SmrtObject {
+    tenantId: string | null;
+    /** Stable caller-defined key used by CRM/referral systems. */
+    campaignKey: string;
+    name: string;
+    /** Open objective key such as `awareness` or `demand_generation`. */
+    objective: string;
+    status: CampaignStatus;
+    startAt: Date | null;
+    endAt: Date | null;
+    /** Total campaign budget in integer cents. */
+    budgetCents: number;
+    /** ISO 4217 currency for every campaign/channel amount. */
+    currency: string;
+    metadata: string;
+    constructor(options?: CampaignOptions);
+    initialize(): Promise<this>;
+    save(): Promise<this>;
+    /** Apply one legal transition in memory; callers choose the save boundary. */
+    transitionTo(next: CampaignStatus): this;
+    getMetadata(): Record<string, unknown>;
+    setMetadata(metadata: Record<string, unknown>): void;
+    private assertSchedule;
+    private resolvePriorStatus;
+    private assertStatusTransition;
+    private static coerceDate;
+}
+export default Campaign;
+//# sourceMappingURL=Campaign.d.ts.map

package/dist/models/Campaign.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Campaign.d.ts","sourceRoot":"","sources":["../../src/models/Campaign.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAElE,OAAO,EAAS,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAEnE,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAarB,qBAQa,QAAS,SAAQ,UAAU;IAEtC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B,8DAA8D;IAE9D,WAAW,EAAE,MAAM,CAAM;IAGzB,IAAI,EAAE,MAAM,CAAM;IAElB,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAM;IAEvB,MAAM,EAAE,cAAc,CAAW;IAEjC,OAAO,EAAE,IAAI,GAAG,IAAI,CAAQ;IAE5B,KAAK,EAAE,IAAI,GAAG,IAAI,CAAQ;IAE1B,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAK;IAExB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAS;IAEzB,QAAQ,EAAE,MAAM,CAAQ;gBAEZ,OAAO,GAAE,eAAoB;IAkB1B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IASpC,8EAA8E;IAC9E,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAaxC,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAYtC,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIpD,OAAO,CAAC,cAAc;YAaR,kBAAkB;IAuBhC,OAAO,CAAC,sBAAsB;IAgB9B,OAAO,CAAC,MAAM,CAAC,UAAU;CAS1B;AAED,eAAe,QAAQ,CAAC"}

package/dist/models/CampaignChannel.d.ts

@@ -0,0 +1,22 @@
+import { SmrtObject } from '@happyvertical/smrt-core';
+import { CampaignChannelOptions, CampaignChannelStatus } from '../types.js';
+export declare class CampaignChannel extends SmrtObject {
+    tenantId: string | null;
+    campaignId: string;
+    /** Open kind vocabulary; recommended values live in CAMPAIGN_CHANNEL_KINDS. */
+    channelKind: string;
+    /** Opaque identifier in the namespace named by channelKind. */
+    channelRef: string;
+    allocatedBudgetCents: number;
+    /** Optional execution-specific override of the Campaign start. */
+    startAt: Date | null;
+    /** Optional execution-specific override of the Campaign end. */
+    endAt: Date | null;
+    status: CampaignChannelStatus;
+    constructor(options?: CampaignChannelOptions);
+    initialize(): Promise<this>;
+    save(): Promise<this>;
+    private static coerceDate;
+}
+export default CampaignChannel;
+//# sourceMappingURL=CampaignChannel.d.ts.map

package/dist/models/CampaignChannel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CampaignChannel.d.ts","sourceRoot":"","sources":["../../src/models/CampaignChannel.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAE7E,OAAO,EAAqB,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAE/E,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAIrB,qBAQa,eAAgB,SAAQ,UAAU;IAE7C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG/B,UAAU,EAAE,MAAM,CAAM;IAExB,+EAA+E;IAE/E,WAAW,EAAE,MAAM,CAAM;IAEzB,+DAA+D;IAE/D,UAAU,EAAE,MAAM,CAAM;IAExB,oBAAoB,EAAE,MAAM,CAAK;IAEjC,kEAAkE;IAClE,OAAO,EAAE,IAAI,GAAG,IAAI,CAAQ;IAE5B,gEAAgE;IAChE,KAAK,EAAE,IAAI,GAAG,IAAI,CAAQ;IAE1B,MAAM,EAAE,qBAAqB,CAAa;gBAE9B,OAAO,GAAE,sBAA2B;IAgBjC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBpC,OAAO,CAAC,MAAM,CAAC,UAAU;CAS1B;AAED,eAAe,eAAe,CAAC"}

package/dist/models/CampaignMetricSnapshot.d.ts

@@ -0,0 +1,29 @@
+import { SmrtObject } from '@happyvertical/smrt-core';
+import { CampaignMetricSnapshotOptions } from '../types.js';
+export declare class CampaignMetricSnapshot extends SmrtObject {
+    tenantId: string | null;
+    campaignId: string;
+    /** Null for campaign rollups; set for channel-scoped evidence. */
+    campaignChannelId: string | null;
+    periodStart: Date;
+    periodEnd: Date;
+    spendCents: number;
+    impressions: number;
+    clicks: number;
+    conversions: number;
+    leads: number;
+    revenueCents: number | null;
+    /** Ingestion source such as `google_ads`, `meta`, or `rollup_job`. */
+    source: string;
+    dedupeKey: string;
+    constructor(options?: CampaignMetricSnapshotOptions);
+    initialize(): Promise<this>;
+    save(): Promise<this>;
+    delete(): Promise<void>;
+    private assertMetrics;
+    private assertChannelMatchesCampaign;
+    private serializeState;
+    private static coerceDate;
+}
+export default CampaignMetricSnapshot;
+//# sourceMappingURL=CampaignMetricSnapshot.d.ts.map

package/dist/models/CampaignMetricSnapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CampaignMetricSnapshot.d.ts","sourceRoot":"","sources":["../../src/models/CampaignMetricSnapshot.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,OAAO,EAAqB,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAE/E,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAMjE,qBAQa,sBAAuB,SAAQ,UAAU;IAEpD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG/B,UAAU,EAAE,MAAM,CAAM;IAExB,kEAAkE;IAElE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAGxC,WAAW,EAAE,IAAI,CAAc;IAG/B,SAAS,EAAE,IAAI,CAAc;IAE7B,UAAU,EAAE,MAAM,CAAK;IAEvB,WAAW,EAAE,MAAM,CAAK;IAExB,MAAM,EAAE,MAAM,CAAK;IAEnB,WAAW,EAAE,MAAM,CAAK;IAExB,KAAK,EAAE,MAAM,CAAK;IAGlB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEnC,sEAAsE;IAEtE,MAAM,EAAE,MAAM,CAAM;IAGpB,SAAS,EAAE,MAAM,CAAM;gBAEX,OAAO,GAAE,6BAAkC;IA2BxC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA4CrB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtC,OAAO,CAAC,aAAa;YAkCP,4BAA4B;IAa1C,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,MAAM,CAAC,UAAU;CAU1B;AAED,eAAe,sBAAsB,CAAC"}

package/dist/models/index.d.ts

@@ -0,0 +1,4 @@
+export * from './Campaign.js';
+export * from './CampaignChannel.js';
+export * from './CampaignMetricSnapshot.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/models/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC"}

package/dist/services/BudgetPacingService.d.ts

@@ -0,0 +1,25 @@
+import { SmrtClassOptions } from '@happyvertical/smrt-core';
+import { CampaignChannelCollection, CampaignCollection, CampaignMetricSnapshotCollection } from '../collections/index.js';
+import { BudgetPacingResult } from '../types.js';
+/** Computes spend-to-budget pacing from immutable snapshots; stores nothing. */
+export declare class BudgetPacingService {
+    private readonly campaigns;
+    private readonly channels;
+    private readonly snapshots;
+    constructor(campaigns: CampaignCollection, channels: CampaignChannelCollection, snapshots: CampaignMetricSnapshotCollection);
+    static create(classOptions?: SmrtClassOptions): Promise<BudgetPacingService>;
+    getCampaignPacing(campaignId: string, at?: Date): Promise<BudgetPacingResult>;
+    getChannelPacing(campaignChannelId: string, at?: Date): Promise<BudgetPacingResult>;
+    private calculate;
+    private pacingStatus;
+    /**
+     * 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.
+     */
+    private selectCampaignEvidence;
+    private periodKey;
+    private elapsedFraction;
+}
+export default BudgetPacingService;
+//# sourceMappingURL=BudgetPacingService.d.ts.map

package/dist/services/BudgetPacingService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BudgetPacingService.d.ts","sourceRoot":"","sources":["../../src/services/BudgetPacingService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,gCAAgC,EACjC,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAAE,kBAAkB,EAAsB,MAAM,aAAa,CAAC;AAE1E,gFAAgF;AAChF,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAFT,SAAS,EAAE,kBAAkB,EAC7B,QAAQ,EAAE,yBAAyB,EACnC,SAAS,EAAE,gCAAgC;WAGjD,MAAM,CACjB,YAAY,GAAE,gBAAqB,GAClC,OAAO,CAAC,mBAAmB,CAAC;IAQzB,iBAAiB,CACrB,UAAU,EAAE,MAAM,EAClB,EAAE,OAAa,GACd,OAAO,CAAC,kBAAkB,CAAC;IAkBxB,gBAAgB,CACpB,iBAAiB,EAAE,MAAM,EACzB,EAAE,OAAa,GACd,OAAO,CAAC,kBAAkB,CAAC;IAwB9B,OAAO,CAAC,SAAS;IAsDjB,OAAO,CAAC,YAAY;IAuCpB;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAe9B,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,eAAe;CAWxB;AAED,eAAe,mBAAmB,CAAC"}

package/dist/services/CampaignLifecycleService.d.ts

@@ -0,0 +1,19 @@
+import { SmrtClassOptions } from '@happyvertical/smrt-core';
+import { CampaignCollection } from '../collections/CampaignCollection.js';
+import { Campaign } from '../models/Campaign.js';
+import { CampaignStatus } from '../types.js';
+/** Single authoritative write path for Campaign lifecycle changes. */
+export declare class CampaignLifecycleService {
+    private readonly campaigns;
+    constructor(campaigns: CampaignCollection);
+    static create(classOptions?: SmrtClassOptions): Promise<CampaignLifecycleService>;
+    transition(campaignId: string, next: CampaignStatus): Promise<Campaign>;
+    schedule(campaignId: string): Promise<Campaign>;
+    activate(campaignId: string): Promise<Campaign>;
+    pause(campaignId: string): Promise<Campaign>;
+    resume(campaignId: string): Promise<Campaign>;
+    complete(campaignId: string): Promise<Campaign>;
+    archive(campaignId: string): Promise<Campaign>;
+}
+export default CampaignLifecycleService;
+//# sourceMappingURL=CampaignLifecycleService.d.ts.map

package/dist/services/CampaignLifecycleService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CampaignLifecycleService.d.ts","sourceRoot":"","sources":["../../src/services/CampaignLifecycleService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,sEAAsE;AACtE,qBAAa,wBAAwB;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,kBAAkB;WAE7C,MAAM,CACjB,YAAY,GAAE,gBAAqB,GAClC,OAAO,CAAC,wBAAwB,CAAC;IAM9B,UAAU,CACd,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,QAAQ,CAAC;IAQd,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI/C,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI/C,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI5C,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI7C,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI/C,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;CAGrD;AAED,eAAe,wBAAwB,CAAC"}

package/dist/services/MetricIngestionService.d.ts

@@ -0,0 +1,16 @@
+import { SmrtClassOptions } from '@happyvertical/smrt-core';
+import { CampaignMetricSnapshotCollection } from '../collections/CampaignMetricSnapshotCollection.js';
+import { CampaignMetricSnapshot } from '../models/CampaignMetricSnapshot.js';
+import { CampaignMetricSnapshotOptions } from '../types.js';
+/** Idempotent, validation-first ingestion for immutable metric evidence. */
+export declare class MetricIngestionService {
+    private readonly snapshots;
+    constructor(snapshots: CampaignMetricSnapshotCollection);
+    static create(classOptions?: SmrtClassOptions): Promise<MetricIngestionService>;
+    ingest(options: CampaignMetricSnapshotOptions): Promise<{
+        snapshot: CampaignMetricSnapshot;
+        created: boolean;
+    }>;
+}
+export default MetricIngestionService;
+//# sourceMappingURL=MetricIngestionService.d.ts.map

package/dist/services/MetricIngestionService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetricIngestionService.d.ts","sourceRoot":"","sources":["../../src/services/MetricIngestionService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,gCAAgC,EAAE,MAAM,oDAAoD,CAAC;AACtG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAEjE,4EAA4E;AAC5E,qBAAa,sBAAsB;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,gCAAgC;WAE3D,MAAM,CACjB,YAAY,GAAE,gBAAqB,GAClC,OAAO,CAAC,sBAAsB,CAAC;IAM5B,MAAM,CACV,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC;QAAE,QAAQ,EAAE,sBAAsB,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CAenE;AAED,eAAe,sBAAsB,CAAC"}

package/dist/services/index.d.ts

@@ -0,0 +1,4 @@
+export * from './BudgetPacingService.js';
+export * from './CampaignLifecycleService.js';
+export * from './MetricIngestionService.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC"}