@qcobro/common 1.12.4 → 1.14.0

package/dist/evaluation/scorecard.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+/**
+ * Contracts for the engine judge: the parameter set `evaluate` runs against and
+ * the scorecard it produces. Thresholds default here; rate caps and the tick
+ * interval mirror the deployment's engine config and are supplied by the caller
+ * (the events endpoint returns them alongside the stream).
+ */
+export const evaluationParametersSchema = z.object({
+    /** Seconds between engine ticks (`engine.tickSeconds`). */
+    tickSeconds: z.number().int().positive(),
+    /** Deployment-wide pacing caps, mirroring the engine config. `0` = channel paused. */
+    ratesPerMinute: z.object({
+        voice: z.number().nonnegative(),
+        sms: z.number().nonnegative(),
+        email: z.number().nonnegative(),
+        whatsApp: z.number().nonnegative()
+    }),
+    thresholds: z
+        .object({
+        /** PERF-2: p95 of provider dispatch latency (the API call, not call duration). */
+        dispatchLatencyP95Ms: z.number().positive().default(2000),
+        /** PERF-3: max fraction of dispatches that may fail, per channel. */
+        maxErrorRate: z.number().min(0).max(1).default(0.02),
+        /** LIVE-1: max consecutive budget-starved in-window ticks before an account counts as starved. */
+        livenessTicks: z.number().int().positive().default(10)
+    })
+        .prefault({})
+});
+//# sourceMappingURL=scorecard.js.map

package/dist/evaluation/scorecard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorecard.js","sourceRoot":"","sources":["../../src/evaluation/scorecard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,2DAA2D;IAC3D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACxC,sFAAsF;IACtF,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC;QACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE;QAC/B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE;QAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE;QAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE;KACnC,CAAC;IACF,UAAU,EAAE,CAAC;SACV,MAAM,CAAC;QACN,kFAAkF;QAClF,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QACzD,qEAAqE;QACrE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;QACpD,kGAAkG;QAClG,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;KACvD,CAAC;SACD,QAAQ,CAAC,EAAE,CAAC;CAChB,CAAC,CAAC"}

package/dist/index.d.ts

@@ -3,6 +3,8 @@ export * from "./errors/index.js";
 export * from "./utils/index.js";
 export * from "./schemas/index.js";
 export * from "./types/index.js";
+export * from "./evaluation/index.js";
+export * from "./billing/index.js";
 export * from "./config.js";
 /**
  * Placeholder contract proving the shared-schema pattern.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAE5B;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS;;iBAEpB,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAE5B;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS;;iBAEpB,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC"}

package/dist/index.js

@@ -3,6 +3,8 @@ export * from "./errors/index.js";
 export * from "./utils/index.js";
 export * from "./schemas/index.js";
 export * from "./types/index.js";
+export * from "./evaluation/index.js";
+export * from "./billing/index.js";
 export * from "./config.js";
 /**
  * Placeholder contract proving the shared-schema pattern.

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAE5B;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;CACpC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAE5B;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;CACpC,CAAC,CAAC"}

package/dist/schemas/billing.d.ts

@@ -0,0 +1,74 @@
+import { z } from "zod";
+/**
+ * Input schemas for the billing service functions (usage-ledger capability).
+ * The client interfaces they pair with live in `../types/billing.ts`.
+ */
+/** Meters one billable dispatch (priced at write time from the workspace's plan). */
+export declare const meterDispatchSchema: z.ZodObject<{
+    workspaceRef: z.ZodString;
+    meter: z.ZodEnum<{
+        sms: "sms";
+        email: "email";
+        whatsappMessage: "whatsappMessage";
+        voicePrerecorded: "voicePrerecorded";
+        voiceAi: "voiceAi";
+        whatsappVoicePrerecorded: "whatsappVoicePrerecorded";
+        whatsappVoiceAi: "whatsappVoiceAi";
+    }>;
+    at: z.ZodString;
+    campaignId: z.ZodOptional<z.ZodString>;
+    portfolioAccountId: z.ZodOptional<z.ZodString>;
+    providerRef: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type MeterDispatchInput = z.infer<typeof meterDispatchSchema>;
+/** Settles a voice usage record to its actual answered duration (idempotent per ref). */
+export declare const settleVoiceUsageSchema: z.ZodObject<{
+    providerRef: z.ZodString;
+    answeredSeconds: z.ZodNumber;
+    at: z.ZodString;
+}, z.core.$strip>;
+export type SettleVoiceUsageInput = z.infer<typeof settleVoiceUsageSchema>;
+/**
+ * Turns a workspace's billing cycle over (close previous, open next): voids the
+ * unused remainder and grants the new allowance. Idempotent per
+ * `(workspaceRef, stripeInvoiceId)` — a replayed webhook no-ops.
+ */
+export declare const cycleTurnoverSchema: z.ZodObject<{
+    workspaceRef: z.ZodString;
+    stripeInvoiceId: z.ZodString;
+    grantMicro: z.ZodNumber;
+    cycleStart: z.ZodString;
+    cycleEnd: z.ZodString;
+    at: z.ZodString;
+}, z.core.$strip>;
+export type CycleTurnoverInput = z.infer<typeof cycleTurnoverSchema>;
+/** Reads a workspace's billing status (balance, plan, cycle). */
+export declare const getWorkspaceBillingStatusSchema: z.ZodObject<{
+    workspaceRef: z.ZodString;
+}, z.core.$strip>;
+export type GetWorkspaceBillingStatusInput = z.infer<typeof getWorkspaceBillingStatusSchema>;
+/**
+ * Puts a workspace on a paid plan. First paid workspace for a payer → a
+ * Stripe-hosted Checkout session (collects the card, creates customer +
+ * subscription); subsequent workspaces → a prorated subscription item on the
+ * existing subscription, no card entry.
+ */
+export declare const subscribeWorkspaceSchema: z.ZodObject<{
+    workspaceRef: z.ZodString;
+    planKey: z.ZodString;
+    ownerUserRef: z.ZodString;
+    successUrl: z.ZodString;
+    cancelUrl: z.ZodString;
+}, z.core.$strip>;
+export type SubscribeWorkspaceInput = z.infer<typeof subscribeWorkspaceSchema>;
+/**
+ * Changes a workspace's plan. Upgrades apply immediately (prorated charge +
+ * prorated allowance replacing the remainder); downgrades take effect at
+ * period end via a subscription schedule.
+ */
+export declare const changePlanSchema: z.ZodObject<{
+    workspaceRef: z.ZodString;
+    targetPlanKey: z.ZodString;
+}, z.core.$strip>;
+export type ChangePlanInput = z.infer<typeof changePlanSchema>;
+//# sourceMappingURL=billing.d.ts.map

package/dist/schemas/billing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../../src/schemas/billing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AAEH,qFAAqF;AACrF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;iBAS9B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAErE,yFAAyF;AACzF,eAAO,MAAM,sBAAsB;;;;iBAMjC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE3E;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;;;;;iBAU9B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAErE,iEAAiE;AACjE,eAAO,MAAM,+BAA+B;;iBAE1C,CAAC;AACH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAE7F;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB;;;;;;iBAMnC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE/E;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;;;iBAG3B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/schemas/billing.js

@@ -0,0 +1,68 @@
+import { z } from "zod";
+import { billingMeterSchema } from "../billing/rates.js";
+/**
+ * Input schemas for the billing service functions (usage-ledger capability).
+ * The client interfaces they pair with live in `../types/billing.ts`.
+ */
+/** Meters one billable dispatch (priced at write time from the workspace's plan). */
+export const meterDispatchSchema = z.object({
+    workspaceRef: z.string().min(1),
+    meter: billingMeterSchema,
+    /** Dispatch instant, ISO. */
+    at: z.string().min(1),
+    campaignId: z.string().min(1).optional(),
+    portfolioAccountId: z.string().min(1).optional(),
+    /** Provider ref of the dispatch — the settlement correlation key for voice. */
+    providerRef: z.string().min(1).optional()
+});
+/** Settles a voice usage record to its actual answered duration (idempotent per ref). */
+export const settleVoiceUsageSchema = z.object({
+    providerRef: z.string().min(1),
+    /** Answered seconds (answer → hang-up; 0 = never answered, ring time excluded). */
+    answeredSeconds: z.number().int().nonnegative(),
+    /** Settlement instant, ISO. */
+    at: z.string().min(1)
+});
+/**
+ * Turns a workspace's billing cycle over (close previous, open next): voids the
+ * unused remainder and grants the new allowance. Idempotent per
+ * `(workspaceRef, stripeInvoiceId)` — a replayed webhook no-ops.
+ */
+export const cycleTurnoverSchema = z.object({
+    workspaceRef: z.string().min(1),
+    stripeInvoiceId: z.string().min(1),
+    /** The (possibly prorated) allowance to grant, integer micro-units. */
+    grantMicro: z.number().int().nonnegative(),
+    /** New cycle bounds, ISO. */
+    cycleStart: z.string().min(1),
+    cycleEnd: z.string().min(1),
+    /** Turnover instant, ISO. */
+    at: z.string().min(1)
+});
+/** Reads a workspace's billing status (balance, plan, cycle). */
+export const getWorkspaceBillingStatusSchema = z.object({
+    workspaceRef: z.string().min(1)
+});
+/**
+ * Puts a workspace on a paid plan. First paid workspace for a payer → a
+ * Stripe-hosted Checkout session (collects the card, creates customer +
+ * subscription); subsequent workspaces → a prorated subscription item on the
+ * existing subscription, no card entry.
+ */
+export const subscribeWorkspaceSchema = z.object({
+    workspaceRef: z.string().min(1),
+    planKey: z.string().min(1),
+    ownerUserRef: z.string().min(1),
+    successUrl: z.string().url(),
+    cancelUrl: z.string().url()
+});
+/**
+ * Changes a workspace's plan. Upgrades apply immediately (prorated charge +
+ * prorated allowance replacing the remainder); downgrades take effect at
+ * period end via a subscription schedule.
+ */
+export const changePlanSchema = z.object({
+    workspaceRef: z.string().min(1),
+    targetPlanKey: z.string().min(1)
+});
+//# sourceMappingURL=billing.js.map

package/dist/schemas/billing.js.map

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

package/dist/schemas/engineEvents.d.ts

@@ -0,0 +1,407 @@
+import { z } from "zod";
+/**
+ * Engine flight-recorder events. The engine (and the inbound provider webhooks)
+ * emit these as an append-only stream; the pure evaluator in `../evaluation/`
+ * replays a stream to prove a run stayed within parameters. Events are
+ * self-contained: `campaign.evaluated` snapshots the config in force that tick,
+ * so evaluating never requires reading live campaign rows.
+ *
+ * Correlation spine: `tickId` + `seq` order events within a tick;
+ * `workspaceRef`/`campaignId`/`portfolioAccountId`/`providerRef` tie them to the
+ * domain. Only tick lifecycle events are deployment-level (one engine loop ticks
+ * across all workspaces) — everything else carries `workspaceRef`.
+ *
+ * Privacy: recipient identifiers are masked (see `maskRecipient`); rendered
+ * bodies, scripts, and transcripts never enter the stream (they live on the
+ * gestión).
+ */
+export declare const engineEventKindSchema: z.ZodEnum<{
+    "tick.started": "tick.started";
+    "tick.completed": "tick.completed";
+    "campaign.evaluated": "campaign.evaluated";
+    "account.decided": "account.decided";
+    "attempt.reserved": "attempt.reserved";
+    "dispatch.requested": "dispatch.requested";
+    "dispatch.succeeded": "dispatch.succeeded";
+    "dispatch.failed": "dispatch.failed";
+    "provider.event": "provider.event";
+}>;
+export type EngineEventKind = z.infer<typeof engineEventKindSchema>;
+/** Snapshot of the campaign parameters in force during a tick (self-contained stream). */
+export declare const campaignSnapshotSchema: z.ZodObject<{
+    status: z.ZodString;
+    startDate: z.ZodString;
+    endDate: z.ZodNullable<z.ZodString>;
+    daysOfWeek: z.ZodArray<z.ZodNumber>;
+    startTime: z.ZodString;
+    endTime: z.ZodString;
+    maxAttemptsPerAccount: z.ZodNumber;
+    maxAttemptsPerDay: z.ZodNumber;
+    timezone: z.ZodString;
+    channel: z.ZodNullable<z.ZodEnum<{
+        VOICE_AI: "VOICE_AI";
+        VOICE_PRERECORDED: "VOICE_PRERECORDED";
+        SMS: "SMS";
+        EMAIL: "EMAIL";
+        WHATSAPP: "WHATSAPP";
+    }>>;
+}, z.core.$strip>;
+export type CampaignSnapshot = z.infer<typeof campaignSnapshotSchema>;
+declare const tickStartedSchema: z.ZodObject<{
+    id: z.ZodString;
+    at: z.ZodString;
+    tickId: z.ZodOptional<z.ZodString>;
+    seq: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodLiteral<"tick.started">;
+    budgets: z.ZodRecord<z.ZodEnum<{
+        VOICE_AI: "VOICE_AI";
+        VOICE_PRERECORDED: "VOICE_PRERECORDED";
+        SMS: "SMS";
+        EMAIL: "EMAIL";
+        WHATSAPP: "WHATSAPP";
+    }> & z.core.$partial, z.ZodNumber>;
+    perTickMax: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const tickCompletedSchema: z.ZodObject<{
+    id: z.ZodString;
+    at: z.ZodString;
+    tickId: z.ZodOptional<z.ZodString>;
+    seq: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodLiteral<"tick.completed">;
+    durationMs: z.ZodNumber;
+    dispatched: z.ZodNumber;
+    perTickMaxReached: z.ZodBoolean;
+    channelUsage: z.ZodRecord<z.ZodEnum<{
+        VOICE_AI: "VOICE_AI";
+        VOICE_PRERECORDED: "VOICE_PRERECORDED";
+        SMS: "SMS";
+        EMAIL: "EMAIL";
+        WHATSAPP: "WHATSAPP";
+    }> & z.core.$partial, z.ZodObject<{
+        dispatched: z.ZodNumber;
+        budget: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const campaignEvaluatedSchema: z.ZodObject<{
+    id: z.ZodString;
+    at: z.ZodString;
+    tickId: z.ZodOptional<z.ZodString>;
+    seq: z.ZodOptional<z.ZodNumber>;
+    workspaceRef: z.ZodString;
+    kind: z.ZodLiteral<"campaign.evaluated">;
+    campaignId: z.ZodString;
+    campaignName: z.ZodOptional<z.ZodString>;
+    inWindow: z.ZodBoolean;
+    skipReason: z.ZodOptional<z.ZodString>;
+    completed: z.ZodOptional<z.ZodBoolean>;
+    candidateCount: z.ZodNumber;
+    snapshot: z.ZodObject<{
+        status: z.ZodString;
+        startDate: z.ZodString;
+        endDate: z.ZodNullable<z.ZodString>;
+        daysOfWeek: z.ZodArray<z.ZodNumber>;
+        startTime: z.ZodString;
+        endTime: z.ZodString;
+        maxAttemptsPerAccount: z.ZodNumber;
+        maxAttemptsPerDay: z.ZodNumber;
+        timezone: z.ZodString;
+        channel: z.ZodNullable<z.ZodEnum<{
+            VOICE_AI: "VOICE_AI";
+            VOICE_PRERECORDED: "VOICE_PRERECORDED";
+            SMS: "SMS";
+            EMAIL: "EMAIL";
+            WHATSAPP: "WHATSAPP";
+        }>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+declare const accountDecidedSchema: z.ZodObject<{
+    id: z.ZodString;
+    at: z.ZodString;
+    tickId: z.ZodOptional<z.ZodString>;
+    seq: z.ZodOptional<z.ZodNumber>;
+    workspaceRef: z.ZodString;
+    kind: z.ZodLiteral<"account.decided">;
+    campaignId: z.ZodString;
+    portfolioAccountId: z.ZodString;
+    decision: z.ZodString;
+    providerRef: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const attemptReservedSchema: z.ZodObject<{
+    id: z.ZodString;
+    at: z.ZodString;
+    tickId: z.ZodOptional<z.ZodString>;
+    seq: z.ZodOptional<z.ZodNumber>;
+    workspaceRef: z.ZodString;
+    kind: z.ZodLiteral<"attempt.reserved">;
+    campaignId: z.ZodString;
+    portfolioAccountId: z.ZodString;
+}, z.core.$strip>;
+declare const dispatchRequestedSchema: z.ZodObject<{
+    id: z.ZodString;
+    at: z.ZodString;
+    tickId: z.ZodOptional<z.ZodString>;
+    seq: z.ZodOptional<z.ZodNumber>;
+    workspaceRef: z.ZodString;
+    kind: z.ZodLiteral<"dispatch.requested">;
+    campaignId: z.ZodString;
+    portfolioAccountId: z.ZodString;
+    channel: z.ZodEnum<{
+        VOICE_AI: "VOICE_AI";
+        VOICE_PRERECORDED: "VOICE_PRERECORDED";
+        SMS: "SMS";
+        EMAIL: "EMAIL";
+        WHATSAPP: "WHATSAPP";
+    }>;
+    toMasked: z.ZodString;
+}, z.core.$strip>;
+declare const dispatchSucceededSchema: z.ZodObject<{
+    id: z.ZodString;
+    at: z.ZodString;
+    tickId: z.ZodOptional<z.ZodString>;
+    seq: z.ZodOptional<z.ZodNumber>;
+    workspaceRef: z.ZodString;
+    kind: z.ZodLiteral<"dispatch.succeeded">;
+    campaignId: z.ZodString;
+    portfolioAccountId: z.ZodString;
+    channel: z.ZodEnum<{
+        VOICE_AI: "VOICE_AI";
+        VOICE_PRERECORDED: "VOICE_PRERECORDED";
+        SMS: "SMS";
+        EMAIL: "EMAIL";
+        WHATSAPP: "WHATSAPP";
+    }>;
+    providerRef: z.ZodString;
+    latencyMs: z.ZodNumber;
+    toMasked: z.ZodString;
+}, z.core.$strip>;
+declare const dispatchFailedSchema: z.ZodObject<{
+    id: z.ZodString;
+    at: z.ZodString;
+    tickId: z.ZodOptional<z.ZodString>;
+    seq: z.ZodOptional<z.ZodNumber>;
+    workspaceRef: z.ZodString;
+    kind: z.ZodLiteral<"dispatch.failed">;
+    campaignId: z.ZodString;
+    portfolioAccountId: z.ZodString;
+    channel: z.ZodEnum<{
+        VOICE_AI: "VOICE_AI";
+        VOICE_PRERECORDED: "VOICE_PRERECORDED";
+        SMS: "SMS";
+        EMAIL: "EMAIL";
+        WHATSAPP: "WHATSAPP";
+    }>;
+    latencyMs: z.ZodNumber;
+    errorClass: z.ZodString;
+    errorMessage: z.ZodString;
+    toMasked: z.ZodString;
+}, z.core.$strip>;
+declare const providerEventSchema: z.ZodObject<{
+    id: z.ZodString;
+    at: z.ZodString;
+    tickId: z.ZodOptional<z.ZodString>;
+    seq: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodLiteral<"provider.event">;
+    workspaceRef: z.ZodOptional<z.ZodString>;
+    source: z.ZodEnum<{
+        "voice-events": "voice-events";
+        "contact-logs": "contact-logs";
+        "meta-whatsapp": "meta-whatsapp";
+        "email-inbound": "email-inbound";
+    }>;
+    providerRef: z.ZodOptional<z.ZodString>;
+    providerAt: z.ZodOptional<z.ZodString>;
+    matched: z.ZodBoolean;
+    campaignId: z.ZodOptional<z.ZodString>;
+    portfolioAccountId: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+}, z.core.$strip>;
+export declare const engineEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodString;
+    at: z.ZodString;
+    tickId: z.ZodOptional<z.ZodString>;
+    seq: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodLiteral<"tick.started">;
+    budgets: z.ZodRecord<z.ZodEnum<{
+        VOICE_AI: "VOICE_AI";
+        VOICE_PRERECORDED: "VOICE_PRERECORDED";
+        SMS: "SMS";
+        EMAIL: "EMAIL";
+        WHATSAPP: "WHATSAPP";
+    }> & z.core.$partial, z.ZodNumber>;
+    perTickMax: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    at: z.ZodString;
+    tickId: z.ZodOptional<z.ZodString>;
+    seq: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodLiteral<"tick.completed">;
+    durationMs: z.ZodNumber;
+    dispatched: z.ZodNumber;
+    perTickMaxReached: z.ZodBoolean;
+    channelUsage: z.ZodRecord<z.ZodEnum<{
+        VOICE_AI: "VOICE_AI";
+        VOICE_PRERECORDED: "VOICE_PRERECORDED";
+        SMS: "SMS";
+        EMAIL: "EMAIL";
+        WHATSAPP: "WHATSAPP";
+    }> & z.core.$partial, z.ZodObject<{
+        dispatched: z.ZodNumber;
+        budget: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    at: z.ZodString;
+    tickId: z.ZodOptional<z.ZodString>;
+    seq: z.ZodOptional<z.ZodNumber>;
+    workspaceRef: z.ZodString;
+    kind: z.ZodLiteral<"campaign.evaluated">;
+    campaignId: z.ZodString;
+    campaignName: z.ZodOptional<z.ZodString>;
+    inWindow: z.ZodBoolean;
+    skipReason: z.ZodOptional<z.ZodString>;
+    completed: z.ZodOptional<z.ZodBoolean>;
+    candidateCount: z.ZodNumber;
+    snapshot: z.ZodObject<{
+        status: z.ZodString;
+        startDate: z.ZodString;
+        endDate: z.ZodNullable<z.ZodString>;
+        daysOfWeek: z.ZodArray<z.ZodNumber>;
+        startTime: z.ZodString;
+        endTime: z.ZodString;
+        maxAttemptsPerAccount: z.ZodNumber;
+        maxAttemptsPerDay: z.ZodNumber;
+        timezone: z.ZodString;
+        channel: z.ZodNullable<z.ZodEnum<{
+            VOICE_AI: "VOICE_AI";
+            VOICE_PRERECORDED: "VOICE_PRERECORDED";
+            SMS: "SMS";
+            EMAIL: "EMAIL";
+            WHATSAPP: "WHATSAPP";
+        }>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    at: z.ZodString;
+    tickId: z.ZodOptional<z.ZodString>;
+    seq: z.ZodOptional<z.ZodNumber>;
+    workspaceRef: z.ZodString;
+    kind: z.ZodLiteral<"account.decided">;
+    campaignId: z.ZodString;
+    portfolioAccountId: z.ZodString;
+    decision: z.ZodString;
+    providerRef: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    at: z.ZodString;
+    tickId: z.ZodOptional<z.ZodString>;
+    seq: z.ZodOptional<z.ZodNumber>;
+    workspaceRef: z.ZodString;
+    kind: z.ZodLiteral<"attempt.reserved">;
+    campaignId: z.ZodString;
+    portfolioAccountId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    at: z.ZodString;
+    tickId: z.ZodOptional<z.ZodString>;
+    seq: z.ZodOptional<z.ZodNumber>;
+    workspaceRef: z.ZodString;
+    kind: z.ZodLiteral<"dispatch.requested">;
+    campaignId: z.ZodString;
+    portfolioAccountId: z.ZodString;
+    channel: z.ZodEnum<{
+        VOICE_AI: "VOICE_AI";
+        VOICE_PRERECORDED: "VOICE_PRERECORDED";
+        SMS: "SMS";
+        EMAIL: "EMAIL";
+        WHATSAPP: "WHATSAPP";
+    }>;
+    toMasked: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    at: z.ZodString;
+    tickId: z.ZodOptional<z.ZodString>;
+    seq: z.ZodOptional<z.ZodNumber>;
+    workspaceRef: z.ZodString;
+    kind: z.ZodLiteral<"dispatch.succeeded">;
+    campaignId: z.ZodString;
+    portfolioAccountId: z.ZodString;
+    channel: z.ZodEnum<{
+        VOICE_AI: "VOICE_AI";
+        VOICE_PRERECORDED: "VOICE_PRERECORDED";
+        SMS: "SMS";
+        EMAIL: "EMAIL";
+        WHATSAPP: "WHATSAPP";
+    }>;
+    providerRef: z.ZodString;
+    latencyMs: z.ZodNumber;
+    toMasked: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    at: z.ZodString;
+    tickId: z.ZodOptional<z.ZodString>;
+    seq: z.ZodOptional<z.ZodNumber>;
+    workspaceRef: z.ZodString;
+    kind: z.ZodLiteral<"dispatch.failed">;
+    campaignId: z.ZodString;
+    portfolioAccountId: z.ZodString;
+    channel: z.ZodEnum<{
+        VOICE_AI: "VOICE_AI";
+        VOICE_PRERECORDED: "VOICE_PRERECORDED";
+        SMS: "SMS";
+        EMAIL: "EMAIL";
+        WHATSAPP: "WHATSAPP";
+    }>;
+    latencyMs: z.ZodNumber;
+    errorClass: z.ZodString;
+    errorMessage: z.ZodString;
+    toMasked: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    at: z.ZodString;
+    tickId: z.ZodOptional<z.ZodString>;
+    seq: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodLiteral<"provider.event">;
+    workspaceRef: z.ZodOptional<z.ZodString>;
+    source: z.ZodEnum<{
+        "voice-events": "voice-events";
+        "contact-logs": "contact-logs";
+        "meta-whatsapp": "meta-whatsapp";
+        "email-inbound": "email-inbound";
+    }>;
+    providerRef: z.ZodOptional<z.ZodString>;
+    providerAt: z.ZodOptional<z.ZodString>;
+    matched: z.ZodBoolean;
+    campaignId: z.ZodOptional<z.ZodString>;
+    portfolioAccountId: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+}, z.core.$strip>], "kind">;
+export type EngineEvent = z.infer<typeof engineEventSchema>;
+/** `Omit` distributed over the union (a plain Omit collapses the discriminant). */
+type DistOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;
+/** An event as emission sites provide it — the recorder fills the id/at/tickId/seq spine. */
+export type EngineEventInput = DistOmit<EngineEvent, "id" | "at" | "tickId" | "seq">;
+export type TickStartedEvent = z.infer<typeof tickStartedSchema>;
+export type TickCompletedEvent = z.infer<typeof tickCompletedSchema>;
+export type CampaignEvaluatedEvent = z.infer<typeof campaignEvaluatedSchema>;
+export type AccountDecidedEvent = z.infer<typeof accountDecidedSchema>;
+export type AttemptReservedEvent = z.infer<typeof attemptReservedSchema>;
+export type DispatchRequestedEvent = z.infer<typeof dispatchRequestedSchema>;
+export type DispatchSucceededEvent = z.infer<typeof dispatchSucceededSchema>;
+export type DispatchFailedEvent = z.infer<typeof dispatchFailedSchema>;
+export type ProviderEventEvent = z.infer<typeof providerEventSchema>;
+/**
+ * Where engine events land. Prisma-backed in production, in-memory in tests,
+ * no-op when recording is disabled. Implementations MUST be best-effort: a
+ * failing sink is caught and logged by the caller and never fails a tick or a
+ * dispatch.
+ */
+export interface EngineEventSink {
+    record(events: EngineEvent[]): Promise<void>;
+}
+/**
+ * Mask a recipient identifier for the event stream. Phones keep the last 4
+ * characters; emails keep the first character of the local part and the domain.
+ */
+export declare function maskRecipient(to: string): string;
+export {};
+//# sourceMappingURL=engineEvents.d.ts.map

package/dist/schemas/engineEvents.d.ts.map

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