@absolutejs/voice 0.0.22-beta.490 → 0.0.22-beta.491

package/dist/campaignControls.d.ts

@@ -0,0 +1,37 @@
+import type { VoiceCampaign, VoiceCampaignAttemptStatus, VoiceCampaignRecipient, VoiceCampaignRecord, VoiceCampaignTimeWindow } from "./campaign";
+export type VoiceCampaignDisposition = "answered" | "busy" | "failed" | "no-answer" | "voicemail";
+export type VoiceCampaignDispositionRetryRule = {
+    backoffMs?: number;
+    maxAttempts?: number;
+    retry?: boolean;
+};
+export type VoiceCampaignDispositionRetryPolicy = Partial<Record<VoiceCampaignDisposition, VoiceCampaignDispositionRetryRule>>;
+export type VoiceDNCList = {
+    contains: (phone: string) => boolean | Promise<boolean>;
+};
+export declare const normalizePhoneNumber: (phone: string) => string;
+export declare const createInMemoryDNCList: (phones: ReadonlyArray<string>) => VoiceDNCList;
+export declare const isPhoneOnDNC: (phone: string, list: VoiceDNCList) => Promise<boolean>;
+export type VoiceCampaignWindowCheckInput = {
+    now?: Date;
+    window: VoiceCampaignTimeWindow;
+};
+export declare const isWithinCampaignWindow: (input: VoiceCampaignWindowCheckInput) => boolean;
+export declare const shouldRetryCampaignAttempt: (input: {
+    attempts: number;
+    campaign: Pick<VoiceCampaign, "maxAttempts">;
+    disposition?: VoiceCampaignDisposition;
+    policy?: VoiceCampaignDispositionRetryPolicy;
+}) => {
+    backoffMs?: number;
+    retry: boolean;
+};
+export type VoiceCampaignDispositionSummary = {
+    attempts: number;
+    byDisposition: Partial<Record<VoiceCampaignDisposition, number>>;
+    byStatus: Record<VoiceCampaignAttemptStatus, number>;
+    campaignId: string;
+    recipientsByStatus: Record<VoiceCampaignRecipient["status"], number>;
+    totalRecipients: number;
+};
+export declare const summarizeVoiceCampaignDispositions: (record: VoiceCampaignRecord) => VoiceCampaignDispositionSummary;

package/dist/index.d.ts

@@ -83,6 +83,8 @@ export { createPunctuationSemanticTurnDetector, createRegexSemanticTurnDetector,
 export { VOICE_WEBHOOK_SIGNATURE_HEADER, VOICE_WEBHOOK_TIMESTAMP_HEADER, extractVoiceWebhookSignatureFromHeaders, signVoiceWebhookBody, verifyVoiceWebhookSignature, } from "./webhookVerification";
 export { describeVoiceAgentUIState, deriveVoiceAgentUIState, voiceAgentUIStateOrder, } from "./agentState";
 export type { VoiceAgentUIInput, VoiceAgentUIState, } from "./agentState";
+export { createInMemoryDNCList, isPhoneOnDNC, isWithinCampaignWindow, normalizePhoneNumber, shouldRetryCampaignAttempt, summarizeVoiceCampaignDispositions, } from "./campaignControls";
+export type { VoiceCampaignDisposition, VoiceCampaignDispositionRetryPolicy, VoiceCampaignDispositionRetryRule, VoiceCampaignDispositionSummary, VoiceCampaignWindowCheckInput, VoiceDNCList, } from "./campaignControls";
 export { createVoiceBackchannelDriver } from "./backchannel";
 export type { VoiceBackchannelCue, VoiceBackchannelDriver, VoiceBackchannelDriverOptions, } from "./backchannel";
 export { createVoiceIVRSession, describeVoiceIVRPlan, evaluateVoiceIVRPlan, } from "./ivrPlan";

package/dist/index.js

@@ -35515,6 +35515,90 @@ var voiceAgentUIStateOrder = [
   "thinking",
   "speaking"
 ];
+// src/campaignControls.ts
+var normalizePhoneNumber = (phone) => phone.replace(/[\s()-]/g, "").trim();
+var createInMemoryDNCList = (phones) => {
+  const set = new Set(phones.map(normalizePhoneNumber));
+  return {
+    contains: (phone) => set.has(normalizePhoneNumber(phone))
+  };
+};
+var isPhoneOnDNC = async (phone, list) => Promise.resolve(list.contains(phone));
+var isWithinCampaignWindow = (input) => {
+  const now = input.now ?? new Date;
+  const offsetMinutes = input.window.timeZoneOffsetMinutes ?? 0;
+  const shifted = new Date(now.getTime() + offsetMinutes * 60000);
+  const day = shifted.getUTCDay();
+  if (input.window.daysOfWeek && !input.window.daysOfWeek.includes(day)) {
+    return false;
+  }
+  const hour = shifted.getUTCHours();
+  if (input.window.startHour <= input.window.endHour) {
+    return hour >= input.window.startHour && hour < input.window.endHour;
+  }
+  return hour >= input.window.startHour || hour < input.window.endHour;
+};
+var shouldRetryCampaignAttempt = (input) => {
+  if (input.attempts >= input.campaign.maxAttempts) {
+    return { retry: false };
+  }
+  const rule = input.disposition ? input.policy?.[input.disposition] : undefined;
+  if (rule && rule.retry === false) {
+    return { retry: false };
+  }
+  if (rule?.maxAttempts !== undefined && input.attempts >= rule.maxAttempts) {
+    return { retry: false };
+  }
+  return { backoffMs: rule?.backoffMs, retry: true };
+};
+var dispositionFromAttempt = (attempt) => {
+  const metadata = attempt.metadata;
+  if (metadata && typeof metadata.disposition === "string") {
+    return metadata.disposition;
+  }
+  if (attempt.status === "failed") {
+    return "failed";
+  }
+  if (attempt.status === "succeeded") {
+    return "answered";
+  }
+  return;
+};
+var summarizeVoiceCampaignDispositions = (record) => {
+  const byStatus = {
+    canceled: 0,
+    failed: 0,
+    queued: 0,
+    running: 0,
+    succeeded: 0
+  };
+  const byDisposition = {};
+  for (const attempt of record.attempts) {
+    byStatus[attempt.status] = (byStatus[attempt.status] ?? 0) + 1;
+    const disposition = dispositionFromAttempt(attempt);
+    if (disposition) {
+      byDisposition[disposition] = (byDisposition[disposition] ?? 0) + 1;
+    }
+  }
+  const recipientsByStatus = {
+    canceled: 0,
+    completed: 0,
+    failed: 0,
+    pending: 0,
+    queued: 0
+  };
+  for (const recipient of record.recipients) {
+    recipientsByStatus[recipient.status] = (recipientsByStatus[recipient.status] ?? 0) + 1;
+  }
+  return {
+    attempts: record.attempts.length,
+    byDisposition,
+    byStatus,
+    campaignId: record.campaign.id,
+    recipientsByStatus,
+    totalRecipients: record.recipients.length
+  };
+};
 // src/backchannel.ts
 var DEFAULT_CUES = [
   { text: "mm-hmm" },
@@ -46502,6 +46586,7 @@ export {
   summarizeVoiceHandoffHealth,
   summarizeVoiceHandoffDeliveries,
   summarizeVoiceCampaigns,
+  summarizeVoiceCampaignDispositions,
   summarizeVoiceCallerTranscript,
   summarizeVoiceBrowserMedia,
   summarizeVoiceBargeIn,
@@ -46513,6 +46598,7 @@ export {
   signVoiceWebhookBody,
   signVoiceTwilioWebhook,
   signVoicePlivoWebhook,
+  shouldRetryCampaignAttempt,
   shapeTelephonyAssistantText,
   selectVoiceTraceEventsForPrune,
   saveVoiceIncidentBundleArtifact,
@@ -46684,6 +46770,7 @@ export {
   parseVoiceTelephonyWebhookEvent,
   parseVoiceSessionSnapshot,
   normalizeVoiceProofTrendReport,
+  normalizePhoneNumber,
   muteVoiceMonitorIssue,
   matchesVoiceOpsTaskAssignmentRule,
   markVoiceOpsTaskSLABreached,
@@ -46694,7 +46781,9 @@ export {
   listVoiceRoutingEvents,
   listVoiceProviderDecisionTraces,
   listVoiceOpsTasks,
+  isWithinCampaignWindow,
   isVoiceOpsTaskOverdue,
+  isPhoneOnDNC,
   importVoiceCampaignRecipients,
   heartbeatVoiceOpsTask,
   hasVoiceOpsTaskSLABreach,
@@ -47116,6 +47205,7 @@ export {
   createMemoryVoiceTelephonyWebhookIdempotencyStore,
   createMemoryVoicePlivoWebhookNonceStore,
   createJSONVoiceAssistantModel,
+  createInMemoryDNCList,
   createId,
   createGeminiVoiceAssistantModel,
   createDomainPhraseHints,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@absolutejs/voice",
-  "version": "0.0.22-beta.490",
+  "version": "0.0.22-beta.491",
   "description": "Voice primitives and Elysia plugin for AbsoluteJS",
   "repository": {
     "type": "git",