@absolutejs/voice 0.0.22-beta.111 → 0.0.22-beta.112

package/dist/campaign.d.ts

@@ -1,4 +1,5 @@
 import { Elysia } from 'elysia';
+import type { VoiceRedisTaskLeaseCoordinator } from './queue';
 export type VoiceCampaignStatus = 'canceled' | 'completed' | 'draft' | 'paused' | 'running';
 export type VoiceCampaignRecipientStatus = 'canceled' | 'completed' | 'failed' | 'pending' | 'queued';
 export type VoiceCampaignAttemptStatus = 'canceled' | 'failed' | 'queued' | 'running' | 'succeeded';
@@ -157,9 +158,45 @@ export type VoiceCampaignRoutesOptions = VoiceCampaignRuntimeOptions & {
     path?: string;
     title?: string;
 };
+export type VoiceCampaignWorkerOptions = {
+    campaignIds?: string[];
+    leaseMs?: number;
+    leases: VoiceRedisTaskLeaseCoordinator;
+    maxCampaigns?: number;
+    runtime?: VoiceCampaignRuntime;
+    statuses?: VoiceCampaignStatus[];
+    store?: VoiceCampaignStore;
+    workerId: string;
+};
+export type VoiceCampaignWorkerResult = {
+    attempted: number;
+    campaigns: number;
+    errors: Array<{
+        campaignId: string;
+        error: string;
+    }>;
+    skipped: number;
+    started: VoiceCampaignAttempt[];
+};
+export type VoiceCampaignWorker = {
+    drain: () => Promise<VoiceCampaignWorkerResult>;
+};
+export type VoiceCampaignWorkerLoopOptions = {
+    onError?: (error: unknown) => void | Promise<void>;
+    pollIntervalMs?: number;
+    worker: VoiceCampaignWorker;
+};
+export type VoiceCampaignWorkerLoop = {
+    isRunning: () => boolean;
+    start: () => void;
+    stop: () => void;
+    tick: () => Promise<VoiceCampaignWorkerResult>;
+};
 export declare const createVoiceMemoryCampaignStore: () => VoiceCampaignStore;
 export declare const summarizeVoiceCampaigns: (records: VoiceCampaignRecord[]) => VoiceCampaignSummary;
 export declare const createVoiceCampaign: (options: VoiceCampaignRuntimeOptions) => VoiceCampaignRuntime;
+export declare const createVoiceCampaignWorker: (options: VoiceCampaignWorkerOptions) => VoiceCampaignWorker;
+export declare const createVoiceCampaignWorkerLoop: (options: VoiceCampaignWorkerLoopOptions) => VoiceCampaignWorkerLoop;
 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 { createVoiceCampaign, createVoiceCampaignRoutes, createVoiceMemoryCampaignStore, renderVoiceCampaignsHTML, runVoiceCampaignProof, summarizeVoiceCampaigns } from './campaign';
+export { createVoiceCampaign, createVoiceCampaignRoutes, createVoiceCampaignWorker, createVoiceCampaignWorkerLoop, createVoiceMemoryCampaignStore, 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

@@ -10794,6 +10794,90 @@ var createVoiceCampaign = (options) => {
     }
   };
 };
+var getCampaignLeaseTaskId = (campaignId) => `voice-campaign:${campaignId}`;
+var createVoiceCampaignWorker = (options) => {
+  const leaseMs = Math.max(1, options.leaseMs ?? 30000);
+  const runtime = options.runtime ?? createVoiceCampaign({
+    store: options.store ?? createVoiceMemoryCampaignStore()
+  });
+  const statuses = options.statuses ?? ["running"];
+  const campaignIds = new Set(options.campaignIds);
+  const maxCampaigns = Math.max(1, options.maxCampaigns ?? Number.MAX_SAFE_INTEGER);
+  return {
+    drain: async () => {
+      const result = {
+        attempted: 0,
+        campaigns: 0,
+        errors: [],
+        skipped: 0,
+        started: []
+      };
+      const campaigns = [...await runtime.list()].filter((record) => (campaignIds.size === 0 || campaignIds.has(record.campaign.id)) && statuses.includes(record.campaign.status)).sort((left, right) => left.campaign.createdAt - right.campaign.createdAt).slice(0, maxCampaigns);
+      for (const record of campaigns) {
+        const campaignId = record.campaign.id;
+        const taskId = getCampaignLeaseTaskId(campaignId);
+        const claimed = await options.leases.claim({
+          leaseMs,
+          taskId,
+          workerId: options.workerId
+        });
+        if (!claimed) {
+          result.skipped += 1;
+          continue;
+        }
+        try {
+          const tick = await runtime.tick(campaignId);
+          result.campaigns += 1;
+          result.attempted += tick.attempted;
+          result.started.push(...tick.started);
+          result.errors.push(...tick.errors.map((error) => ({
+            campaignId,
+            error: error.error
+          })));
+        } catch (error) {
+          result.errors.push({
+            campaignId,
+            error: error instanceof Error ? error.message : String(error)
+          });
+        } finally {
+          await options.leases.release({
+            taskId,
+            workerId: options.workerId
+          });
+        }
+      }
+      return result;
+    }
+  };
+};
+var createVoiceCampaignWorkerLoop = (options) => {
+  const pollIntervalMs = Math.max(1, options.pollIntervalMs ?? 1000);
+  let timer;
+  let running = false;
+  const tick = async () => options.worker.drain();
+  return {
+    isRunning: () => running,
+    start: () => {
+      if (timer) {
+        return;
+      }
+      running = true;
+      timer = setInterval(() => {
+        tick().catch((error) => {
+          options.onError?.(error);
+        });
+      }, pollIntervalMs);
+    },
+    stop: () => {
+      if (timer) {
+        clearInterval(timer);
+        timer = undefined;
+      }
+      running = false;
+    },
+    tick
+  };
+};
 var defaultProofRecipients = () => [
   {
     id: "campaign-proof-recipient-1",
@@ -19123,6 +19207,8 @@ export {
   createVoiceExperiment,
   createVoiceEvalRoutes,
   createVoiceDiagnosticsRoutes,
+  createVoiceCampaignWorkerLoop,
+  createVoiceCampaignWorker,
   createVoiceCampaignRoutes,
   createVoiceCampaign,
   createVoiceCallReviewRecorder,

package/package.json

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