@qcobro/common 1.13.0 → 1.14.1

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/index.d.ts

@@ -14,4 +14,5 @@ export * from "./whatsApp.js";
 export * from "./voiceEvent.js";
 export * from "./insight.js";
 export * from "./engineEvents.js";
+export * from "./billing.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC"}

package/dist/schemas/index.js

@@ -14,4 +14,5 @@ export * from "./whatsApp.js";
 export * from "./voiceEvent.js";
 export * from "./insight.js";
 export * from "./engineEvents.js";
+export * from "./billing.js";
 //# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC"}

package/dist/types/billing.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Client interfaces the billing service functions depend on — the Prisma subset
+ * they use, so tests inject stubs with no live database. Monetary columns are
+ * BigInt in the database; these interfaces surface them as `bigint` and the
+ * functions convert to safe-integer micro-unit `number`s at the boundary.
+ */
+/** Prisma's BillingMeter enum values (DB spelling of the common meter keys). */
+export type DbBillingMeter = "SMS" | "EMAIL" | "WHATSAPP_MESSAGE" | "VOICE_PRERECORDED" | "VOICE_AI" | "WHATSAPP_VOICE_PRERECORDED" | "WHATSAPP_VOICE_AI";
+export type DbLedgerEntryKind = "GRANT" | "USAGE_DEBIT" | "VOID" | "ADJUSTMENT";
+export interface WorkspaceBillingRecord {
+    workspaceRef: string;
+    billingAccountId: string;
+    planKey: string;
+    /** Enterprise overrides: a Partial of the shared rates schema (validated on read). */
+    rateOverrides: unknown;
+    stripeSubscriptionItemId: string | null;
+    cycleStart: Date | null;
+    cycleEnd: Date | null;
+}
+export interface UsageRecordRow {
+    id: string;
+    workspaceRef: string;
+    meter: DbBillingMeter;
+    quantity: number;
+    unitPriceMicro: bigint;
+    amountMicro: bigint;
+    increments: string | null;
+    settledAt: Date | null;
+    campaignId: string | null;
+    portfolioAccountId: string | null;
+    providerRef: string | null;
+    at: Date;
+}
+export interface LedgerEntryRow {
+    id: string;
+    workspaceRef: string;
+    kind: DbLedgerEntryKind;
+    amountMicro: bigint;
+    at: Date;
+    usageRecordId: string | null;
+    stripeInvoiceId: string | null;
+}
+/** The Prisma subset the billing functions reach through the tRPC/engine context. */
+export interface BillingAccountRecord {
+    id: string;
+    createdFromUserRef: string;
+    stripeCustomerId: string;
+    stripeSubscriptionId: string | null;
+    collectionMethod: string;
+    paymentFailed: boolean;
+}
+export interface BillingClient {
+    workspaceBilling: {
+        findUnique(args: {
+            where: {
+                workspaceRef: string;
+            };
+        }): Promise<WorkspaceBillingRecord | null>;
+        create(args: {
+            data: Record<string, unknown>;
+        }): Promise<WorkspaceBillingRecord>;
+        update(args: {
+            where: {
+                workspaceRef: string;
+            };
+            data: Record<string, unknown>;
+        }): Promise<WorkspaceBillingRecord>;
+    };
+    billingAccount: {
+        findUnique(args: {
+            where: {
+                id: string;
+            };
+        }): Promise<BillingAccountRecord | null>;
+        findFirst(args: {
+            where: {
+                stripeCustomerId?: string;
+                createdFromUserRef?: string;
+            };
+        }): Promise<BillingAccountRecord | null>;
+        create(args: {
+            data: Record<string, unknown>;
+        }): Promise<BillingAccountRecord>;
+        update(args: {
+            where: {
+                id: string;
+            };
+            data: Record<string, unknown>;
+        }): Promise<BillingAccountRecord>;
+        updateMany(args: {
+            where: {
+                stripeCustomerId: string;
+            };
+            data: Record<string, unknown>;
+        }): Promise<{
+            count: number;
+        }>;
+    };
+    usageRecord: {
+        create(args: {
+            data: Record<string, unknown>;
+        }): Promise<UsageRecordRow>;
+        findUnique(args: {
+            where: {
+                providerRef: string;
+            };
+        }): Promise<UsageRecordRow | null>;
+        update(args: {
+            where: {
+                id: string;
+            };
+            data: Record<string, unknown>;
+        }): Promise<UsageRecordRow>;
+    };
+    ledgerEntry: {
+        create(args: {
+            data: Record<string, unknown>;
+        }): Promise<LedgerEntryRow>;
+        aggregate(args: {
+            where: {
+                workspaceRef: string;
+            };
+            _sum: {
+                amountMicro: true;
+            };
+        }): Promise<{
+            _sum: {
+                amountMicro: bigint | null;
+            };
+        }>;
+    };
+    $transaction<T>(fn: (tx: BillingClient) => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=billing.d.ts.map

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

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

package/dist/types/billing.js

@@ -0,0 +1,8 @@
+/**
+ * Client interfaces the billing service functions depend on — the Prisma subset
+ * they use, so tests inject stubs with no live database. Monetary columns are
+ * BigInt in the database; these interfaces surface them as `bigint` and the
+ * functions convert to safe-integer micro-unit `number`s at the boundary.
+ */
+export {};
+//# sourceMappingURL=billing.js.map

package/dist/types/billing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.js","sourceRoot":"","sources":["../../src/types/billing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/types/engine.d.ts

@@ -12,10 +12,16 @@ export interface Clock {
 }
 /** Channels the engine can dispatch (the subset `dispatchOutreach` supports). */
 export type EngineChannel = "VOICE_AI" | "VOICE_PRERECORDED" | "SMS" | "EMAIL" | "WHATSAPP";
+/**
+ * Which billing meter a dispatch on each channel consumes — THE single mapping
+ * (used by the engine tick, manual outreach, and any future dispatch surface,
+ * so the same traffic can never be metered differently on different paths).
+ */
+export declare const BILLING_METER_OF_CHANNEL: Record<EngineChannel, import("../billing/rates.js").BillingMeter>;
 /** Why a campaign was not dispatched at all this tick. */
-export type CampaignSkipReason = "not_active" | "out_of_window" | "channel_not_configured" | "channel_not_supported" | "empty_number_pool" | "voice_not_synced";
+export type CampaignSkipReason = "not_active" | "out_of_window" | "channel_not_configured" | "channel_not_supported" | "empty_number_pool" | "voice_not_synced" | "credits_exhausted" | "payment_failed";
 /** The outcome of considering a single account during a tick. */
-export type AccountDecision = "dispatched" | "dispatch_failed" | "no_phone" | "no_email" | "intent_suppressed" | "account_suppressed" | "promise_suppressed" | "lifetime_cap" | "daily_cap" | "budget_exhausted";
+export type AccountDecision = "dispatched" | "dispatch_failed" | "no_phone" | "no_email" | "intent_suppressed" | "account_suppressed" | "promise_suppressed" | "lifetime_cap" | "daily_cap" | "budget_exhausted" | "credits_exhausted";
 /** Per-account line in the tick report. */
 export interface AccountDecisionEntry {
     portfolioAccountId: string;

package/dist/types/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/types/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,oFAAoF;AACpF,MAAM,WAAW,KAAK;IACpB,GAAG,IAAI,IAAI,CAAC;CACb;AAED,iFAAiF;AACjF,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,mBAAmB,GAAG,KAAK,GAAG,OAAO,GAAG,UAAU,CAAC;AAE5F,0DAA0D;AAC1D,MAAM,MAAM,kBAAkB,GAC1B,YAAY,GACZ,eAAe,GACf,wBAAwB,GACxB,uBAAuB,GACvB,mBAAmB,GACnB,kBAAkB,CAAC;AAEvB,iEAAiE;AACjE,MAAM,MAAM,eAAe,GACvB,YAAY,GACZ,iBAAiB,GACjB,UAAU,GACV,UAAU,GACV,mBAAmB,GACnB,oBAAoB,GACpB,oBAAoB,GACpB,cAAc,GACd,WAAW,GACX,kBAAkB,CAAC;AAEvB,2CAA2C;AAC3C,MAAM,WAAW,oBAAoB;IACnC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,eAAe,CAAC;IAC1B,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,+CAA+C;AAC/C,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,yEAAyE;IACzE,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,SAAS,EAAE,oBAAoB,EAAE,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,oFAAoF;AACpF,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC;IAC3D;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,4BAA4B,EAAE,WAAW,EAAE,CAAC;CAC7D"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/types/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,oFAAoF;AACpF,MAAM,WAAW,KAAK;IACpB,GAAG,IAAI,IAAI,CAAC;CACb;AAED,iFAAiF;AACjF,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,mBAAmB,GAAG,KAAK,GAAG,OAAO,GAAG,UAAU,CAAC;AAE5F;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAC3C,aAAa,EACb,OAAO,qBAAqB,EAAE,YAAY,CAO3C,CAAC;AAEF,0DAA0D;AAC1D,MAAM,MAAM,kBAAkB,GAC1B,YAAY,GACZ,eAAe,GACf,wBAAwB,GACxB,uBAAuB,GACvB,mBAAmB,GACnB,kBAAkB,GAClB,mBAAmB,GACnB,gBAAgB,CAAC;AAErB,iEAAiE;AACjE,MAAM,MAAM,eAAe,GACvB,YAAY,GACZ,iBAAiB,GACjB,UAAU,GACV,UAAU,GACV,mBAAmB,GACnB,oBAAoB,GACpB,oBAAoB,GACpB,cAAc,GACd,WAAW,GACX,kBAAkB,GAClB,mBAAmB,CAAC;AAExB,2CAA2C;AAC3C,MAAM,WAAW,oBAAoB;IACnC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,eAAe,CAAC;IAC1B,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,+CAA+C;AAC/C,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,yEAAyE;IACzE,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,SAAS,EAAE,oBAAoB,EAAE,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,oFAAoF;AACpF,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC;IAC3D;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,4BAA4B,EAAE,WAAW,EAAE,CAAC;CAC7D"}

package/dist/types/engine.js

@@ -6,5 +6,16 @@
  * The channel-dispatch ports (`OutboundCallClient`, `SmsClient`, `NumberSelector`)
  * are reused from `./dispatch.js` — channel emulators implement those interfaces.
  */
-export {};
+/**
+ * Which billing meter a dispatch on each channel consumes — THE single mapping
+ * (used by the engine tick, manual outreach, and any future dispatch surface,
+ * so the same traffic can never be metered differently on different paths).
+ */
+export const BILLING_METER_OF_CHANNEL = {
+    VOICE_AI: "voiceAi",
+    VOICE_PRERECORDED: "voicePrerecorded",
+    SMS: "sms",
+    EMAIL: "email",
+    WHATSAPP: "whatsappMessage"
+};
 //# sourceMappingURL=engine.js.map

package/dist/types/engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/types/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/types/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAGjC;IACF,QAAQ,EAAE,SAAS;IACnB,iBAAiB,EAAE,kBAAkB;IACrC,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,iBAAiB;CAC5B,CAAC"}

package/dist/types/index.d.ts

@@ -9,4 +9,5 @@ export * from "./email.js";
 export * from "./whatsApp.js";
 export * from "./engine.js";
 export * from "./insight.js";
+export * from "./billing.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}

package/dist/types/index.js

@@ -9,4 +9,5 @@ export * from "./email.js";
 export * from "./whatsApp.js";
 export * from "./engine.js";
 export * from "./insight.js";
+export * from "./billing.js";
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qcobro/common",
-  "version": "1.13.0",
+  "version": "1.14.1",
   "type": "module",
   "files": [
     "dist"