@absolutejs/voice 0.0.22-beta.113 → 0.0.22-beta.114

package/dist/campaign.d.ts

@@ -1,5 +1,6 @@
 import { Elysia } from 'elysia';
 import type { VoiceRedisTaskLeaseCoordinator } from './queue';
+import type { VoiceTelephonyOutcomeDecision, VoiceTelephonyOutcomeProviderEvent, VoiceTelephonyWebhookDecision } from './telephonyOutcome';
 export type VoiceCampaignStatus = 'canceled' | 'completed' | 'draft' | 'paused' | 'running';
 export type VoiceCampaignRecipientStatus = 'canceled' | 'completed' | 'failed' | 'pending' | 'queued';
 export type VoiceCampaignAttemptStatus = 'canceled' | 'failed' | 'queued' | 'running' | 'succeeded';
@@ -251,12 +252,41 @@ export type VoiceCampaignObservabilityReport = {
     };
     summary: VoiceCampaignSummary;
 };
+export type VoiceCampaignTelephonyOutcomeInput<TResult = unknown> = {
+    campaignId?: string;
+    decision: VoiceTelephonyOutcomeDecision;
+    event?: VoiceTelephonyOutcomeProviderEvent;
+    externalCallId?: string;
+    routeResult?: TResult;
+    sessionId?: string;
+    attemptId?: string;
+};
+export type VoiceCampaignTelephonyOutcomeStatus = 'failed' | 'ignore' | 'succeeded';
+export type VoiceCampaignTelephonyOutcomeOptions<TResult = unknown> = {
+    resolveCampaignId?: (input: VoiceCampaignTelephonyOutcomeInput<TResult>) => Promise<string | undefined> | string | undefined;
+    resolveExternalCallId?: (input: VoiceCampaignTelephonyOutcomeInput<TResult>) => Promise<string | undefined> | string | undefined;
+    resolveAttemptId?: (input: VoiceCampaignTelephonyOutcomeInput<TResult>) => Promise<string | undefined> | string | undefined;
+    runtime?: VoiceCampaignRuntime;
+    statusForDecision?: (input: VoiceCampaignTelephonyOutcomeInput<TResult>) => Promise<VoiceCampaignTelephonyOutcomeStatus> | VoiceCampaignTelephonyOutcomeStatus;
+    store?: VoiceCampaignStore;
+};
+export type VoiceCampaignTelephonyOutcomeResult = {
+    applied: boolean;
+    campaignId?: string;
+    error?: string;
+    externalCallId?: string;
+    reason?: 'ignored' | 'missing-attempt' | 'missing-campaign' | 'missing-runtime' | 'terminal-attempt';
+    status?: 'failed' | 'succeeded';
+    attemptId?: string;
+};
 export declare const createVoiceMemoryCampaignStore: () => VoiceCampaignStore;
 export declare const summarizeVoiceCampaigns: (records: VoiceCampaignRecord[]) => VoiceCampaignSummary;
 export declare const buildVoiceCampaignObservabilityReport: (records: VoiceCampaignRecord[], options?: VoiceCampaignObservabilityOptions) => Promise<VoiceCampaignObservabilityReport>;
 export declare const createVoiceCampaign: (options: VoiceCampaignRuntimeOptions) => VoiceCampaignRuntime;
 export declare const createVoiceCampaignWorker: (options: VoiceCampaignWorkerOptions) => VoiceCampaignWorker;
 export declare const createVoiceCampaignWorkerLoop: (options: VoiceCampaignWorkerLoopOptions) => VoiceCampaignWorkerLoop;
+export declare const applyVoiceCampaignTelephonyOutcome: <TResult = unknown>(input: VoiceCampaignTelephonyOutcomeInput<TResult>, options?: VoiceCampaignTelephonyOutcomeOptions<TResult>) => Promise<VoiceCampaignTelephonyOutcomeResult>;
+export declare const createVoiceCampaignTelephonyOutcomeHandler: <TResult = unknown>(options: VoiceCampaignTelephonyOutcomeOptions<TResult>) => (input: VoiceTelephonyWebhookDecision<TResult>) => Promise<VoiceCampaignTelephonyOutcomeResult>;
 export declare const runVoiceCampaignProof: (options?: VoiceCampaignProofOptions) => Promise<VoiceCampaignProofReport>;
 export declare const renderVoiceCampaignsHTML: (records: VoiceCampaignRecord[], options?: {
     title?: string;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { voice } from './plugin';
 export { createVoiceAppKit, createVoiceAppKitRoutes, summarizeVoiceAppKitStatus } from './appKit';
-export { buildVoiceCampaignObservabilityReport, createVoiceCampaign, createVoiceCampaignRoutes, createVoiceCampaignWorker, createVoiceCampaignWorkerLoop, createVoiceMemoryCampaignStore, renderVoiceCampaignObservabilityHTML, renderVoiceCampaignsHTML, runVoiceCampaignProof, summarizeVoiceCampaigns } from './campaign';
+export { applyVoiceCampaignTelephonyOutcome, buildVoiceCampaignObservabilityReport, createVoiceCampaignTelephonyOutcomeHandler, createVoiceCampaign, createVoiceCampaignRoutes, createVoiceCampaignWorker, createVoiceCampaignWorkerLoop, createVoiceMemoryCampaignStore, renderVoiceCampaignObservabilityHTML, renderVoiceCampaignsHTML, runVoiceCampaignProof, summarizeVoiceCampaigns } from './campaign';
 export { createVoiceAssistant, createVoiceExperiment, summarizeVoiceAssistantRuns } from './assistant';
 export { createVoiceAssistantHealthHTMLHandler, createVoiceAssistantHealthJSONHandler, createVoiceAssistantHealthRoutes, renderVoiceAssistantHealthHTML, summarizeVoiceAssistantHealth } from './assistantHealth';
 export { createVoiceBargeInRoutes, renderVoiceBargeInHTML, summarizeVoiceBargeIn } from './bargeInRoutes';

package/dist/index.js

@@ -10984,6 +10984,155 @@ var createVoiceCampaignWorkerLoop = (options) => {
     tick
   };
 };
+var firstOutcomeString = (values) => {
+  for (const value of values) {
+    if (typeof value === "string" && value.trim()) {
+      return value.trim();
+    }
+    if (typeof value === "number" && Number.isFinite(value)) {
+      return String(value);
+    }
+  }
+};
+var resolveDefaultCampaignOutcomeIds = (input) => {
+  const metadata = input.event?.metadata ?? {};
+  const decisionMetadata = input.decision.metadata ?? {};
+  const routeResult = typeof input.routeResult === "object" && input.routeResult !== null ? input.routeResult : {};
+  return {
+    campaignId: input.campaignId ?? firstOutcomeString([
+      metadata.campaignId,
+      metadata.voiceCampaignId,
+      decisionMetadata.campaignId,
+      decisionMetadata.voiceCampaignId,
+      routeResult.campaignId,
+      routeResult.voiceCampaignId
+    ]),
+    externalCallId: input.externalCallId ?? firstOutcomeString([
+      metadata.externalCallId,
+      metadata.callId,
+      metadata.callSid,
+      metadata.callUuid,
+      decisionMetadata.externalCallId,
+      decisionMetadata.callId,
+      decisionMetadata.callSid,
+      decisionMetadata.callUuid,
+      routeResult.externalCallId,
+      routeResult.callId,
+      routeResult.callSid,
+      routeResult.callUuid,
+      input.sessionId
+    ]),
+    attemptId: input.attemptId ?? firstOutcomeString([
+      metadata.attemptId,
+      metadata.voiceCampaignAttemptId,
+      decisionMetadata.attemptId,
+      decisionMetadata.voiceCampaignAttemptId,
+      routeResult.attemptId,
+      routeResult.voiceCampaignAttemptId
+    ])
+  };
+};
+var defaultCampaignOutcomeStatus = (input) => {
+  switch (input.decision.action) {
+    case "complete":
+    case "transfer":
+      return "succeeded";
+    case "escalate":
+    case "no-answer":
+    case "voicemail":
+      return "failed";
+    default:
+      return "ignore";
+  }
+};
+var findCampaignAttempt = async (input) => {
+  const records = input.campaignId ? [await input.runtime.get(input.campaignId)].filter(Boolean) : await input.runtime.list();
+  for (const record of records) {
+    const attempt = record.attempts.find((item) => input.attemptId && item.id === input.attemptId || input.externalCallId && item.externalCallId === input.externalCallId);
+    if (attempt) {
+      return {
+        attempt,
+        record
+      };
+    }
+  }
+};
+var applyVoiceCampaignTelephonyOutcome = async (input, options = {}) => {
+  const runtime = options.runtime ?? (options.store ? createVoiceCampaign({
+    store: options.store
+  }) : undefined);
+  if (!runtime) {
+    return {
+      applied: false,
+      reason: "missing-runtime"
+    };
+  }
+  const defaults = resolveDefaultCampaignOutcomeIds(input);
+  const campaignId = await options.resolveCampaignId?.(input) ?? defaults.campaignId;
+  const attemptId = await options.resolveAttemptId?.(input) ?? defaults.attemptId;
+  const externalCallId = await options.resolveExternalCallId?.(input) ?? defaults.externalCallId;
+  const status = await options.statusForDecision?.(input) ?? defaultCampaignOutcomeStatus(input);
+  if (status === "ignore") {
+    return {
+      applied: false,
+      campaignId,
+      externalCallId,
+      reason: "ignored",
+      attemptId
+    };
+  }
+  const match = await findCampaignAttempt({
+    attemptId,
+    campaignId,
+    externalCallId,
+    runtime
+  });
+  if (!match) {
+    return {
+      applied: false,
+      campaignId,
+      externalCallId,
+      reason: campaignId ? "missing-attempt" : "missing-campaign",
+      attemptId
+    };
+  }
+  if (match.attempt.status === "failed" || match.attempt.status === "succeeded") {
+    return {
+      applied: false,
+      campaignId: match.record.campaign.id,
+      externalCallId: match.attempt.externalCallId ?? externalCallId,
+      reason: "terminal-attempt",
+      status: match.attempt.status,
+      attemptId: match.attempt.id
+    };
+  }
+  await runtime.completeAttempt(match.record.campaign.id, match.attempt.id, {
+    error: status === "failed" ? input.decision.reason ?? input.decision.disposition ?? input.event?.reason ?? input.event?.status ?? input.decision.action : undefined,
+    externalCallId: externalCallId ?? match.attempt.externalCallId,
+    metadata: {
+      telephonyAction: input.decision.action,
+      telephonyConfidence: input.decision.confidence,
+      telephonyDisposition: input.decision.disposition,
+      telephonyProvider: input.event?.provider,
+      telephonySource: input.decision.source,
+      telephonyStatus: input.event?.status
+    },
+    status
+  });
+  return {
+    applied: true,
+    campaignId: match.record.campaign.id,
+    externalCallId: externalCallId ?? match.attempt.externalCallId,
+    status,
+    attemptId: match.attempt.id
+  };
+};
+var createVoiceCampaignTelephonyOutcomeHandler = (options) => (input) => applyVoiceCampaignTelephonyOutcome({
+  decision: input.decision,
+  event: input.event,
+  routeResult: input.routeResult,
+  sessionId: input.sessionId
+}, options);
 var defaultProofRecipients = () => [
   {
     id: "campaign-proof-recipient-1",
@@ -19330,6 +19479,7 @@ export {
   createVoiceDiagnosticsRoutes,
   createVoiceCampaignWorkerLoop,
   createVoiceCampaignWorker,
+  createVoiceCampaignTelephonyOutcomeHandler,
   createVoiceCampaignRoutes,
   createVoiceCampaign,
   createVoiceCallReviewRecorder,
@@ -19389,6 +19539,7 @@ export {
   applyVoiceOpsTaskPolicy,
   applyVoiceOpsTaskAssignmentRule,
   applyVoiceHandoffDeliveryResult,
+  applyVoiceCampaignTelephonyOutcome,
   applyRiskTieredPhraseHintCorrections,
   applyPhraseHintCorrections,
   TURN_PROFILE_DEFAULTS

package/package.json

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