@absolutejs/voice 0.0.22-beta.52 → 0.0.22-beta.520

package/dist/client/conversationAnalytics.d.ts

@@ -0,0 +1,29 @@
+import type { StoredVoiceTraceEvent } from "../trace";
+export type VoiceTrafficBucket = {
+    bucketKey: string;
+    callsCompleted: number;
+    callsFailed: number;
+    callsTransferred: number;
+    callsVoicemail: number;
+    callsTotal: number;
+    totalDurationMs: number;
+};
+export type VoiceTrafficSummary = {
+    buckets: VoiceTrafficBucket[];
+    callsByDisposition: Record<string, number>;
+    transferReasons: Record<string, number>;
+    topTransferTargets: Array<{
+        count: number;
+        target: string;
+    }>;
+    totals: VoiceTrafficBucket;
+    windowEndMs: number;
+    windowStartMs: number;
+};
+export type SummarizeVoiceCallTrafficOptions = {
+    bucketBy?: "day" | "hour" | "month";
+    events: ReadonlyArray<StoredVoiceTraceEvent>;
+    fromMs?: number;
+    toMs?: number;
+};
+export declare const summarizeVoiceCallTraffic: (options: SummarizeVoiceCallTrafficOptions) => VoiceTrafficSummary;

package/dist/client/costDashboard.d.ts

@@ -0,0 +1,27 @@
+import type { StoredVoiceTraceEvent } from "../trace";
+export type VoiceCostDashboardBucket = {
+    bucketKey: string;
+    callCount: number;
+    llmUsd: number;
+    sttUsd: number;
+    telephonyMinutes: number;
+    telephonyUsd: number;
+    totalUsd: number;
+    ttsUsd: number;
+};
+export type VoiceCostDashboardReport = {
+    buckets: VoiceCostDashboardBucket[];
+    generatedAt: number;
+    grandTotal: VoiceCostDashboardBucket;
+    windowEndMs: number;
+    windowStartMs: number;
+};
+export type VoiceCostDashboardOptions = {
+    bucketBy?: "day" | "hour" | "month";
+    events: ReadonlyArray<StoredVoiceTraceEvent>;
+    /** Inclusive bucket start filter, epoch ms. */
+    fromMs?: number;
+    /** Inclusive bucket end filter, epoch ms. */
+    toMs?: number;
+};
+export declare const buildVoiceCostDashboardReport: (options: VoiceCostDashboardOptions) => VoiceCostDashboardReport;

package/dist/client/createVoiceStream.d.ts

@@ -1,2 +1,2 @@
-import type { VoiceConnectionOptions, VoiceStream } from '../types';
+import type { VoiceConnectionOptions, VoiceStream } from "../types";
 export declare const createVoiceStream: <TResult = unknown>(path: string, options?: VoiceConnectionOptions) => VoiceStream<TResult>;

package/dist/client/deliveryRuntime.d.ts

@@ -0,0 +1,34 @@
+import type { VoiceDeliveryRuntimeReport } from "../deliveryRuntime";
+export type VoiceDeliveryRuntimeClientOptions = {
+    fetch?: typeof fetch;
+    intervalMs?: number;
+    requeueDeadLettersPath?: string;
+    tickPath?: string;
+};
+export type VoiceDeliveryRuntimeSnapshot = {
+    actionError: string | null;
+    actionStatus: "idle" | "running" | "completed" | "failed";
+    error: string | null;
+    isLoading: boolean;
+    lastAction?: VoiceDeliveryRuntimeActionResult;
+    report?: VoiceDeliveryRuntimeReport;
+    updatedAt?: number;
+};
+export type VoiceDeliveryRuntimeAction = "tick" | "requeue-dead-letters";
+export type VoiceDeliveryRuntimeActionResult = {
+    action: VoiceDeliveryRuntimeAction;
+    result?: unknown;
+    summary?: VoiceDeliveryRuntimeReport["summary"];
+    updatedAt: number;
+};
+export declare const fetchVoiceDeliveryRuntime: (path?: string, options?: Pick<VoiceDeliveryRuntimeClientOptions, "fetch">) => Promise<VoiceDeliveryRuntimeReport>;
+export declare const runVoiceDeliveryRuntimeAction: (action: VoiceDeliveryRuntimeAction, path?: string, options?: VoiceDeliveryRuntimeClientOptions) => Promise<VoiceDeliveryRuntimeActionResult>;
+export declare const createVoiceDeliveryRuntimeStore: (path?: string, options?: VoiceDeliveryRuntimeClientOptions) => {
+    close: () => void;
+    getServerSnapshot: () => VoiceDeliveryRuntimeSnapshot;
+    getSnapshot: () => VoiceDeliveryRuntimeSnapshot;
+    requeueDeadLetters: () => Promise<VoiceDeliveryRuntimeActionResult | undefined>;
+    refresh: () => Promise<VoiceDeliveryRuntimeReport | undefined>;
+    tick: () => Promise<VoiceDeliveryRuntimeActionResult | undefined>;
+    subscribe: (listener: () => void) => () => void;
+};

package/dist/client/deliveryRuntimeWidget.d.ts

@@ -0,0 +1,37 @@
+import { type VoiceDeliveryRuntimeClientOptions, type VoiceDeliveryRuntimeSnapshot } from "./deliveryRuntime";
+export type VoiceDeliveryRuntimeSurfaceView = {
+    deadLettered: number;
+    detail: string;
+    failed: number;
+    id: "audit" | "trace";
+    label: string;
+    pending: number;
+    status: "pass" | "warn" | "disabled";
+    total: number;
+};
+export type VoiceDeliveryRuntimeViewModel = {
+    description: string;
+    error: string | null;
+    actionError: string | null;
+    actionStatus: VoiceDeliveryRuntimeSnapshot["actionStatus"];
+    isLoading: boolean;
+    isRunning: boolean;
+    label: string;
+    status: "pass" | "warn" | "loading" | "error";
+    surfaces: VoiceDeliveryRuntimeSurfaceView[];
+    title: string;
+    updatedAt?: number;
+};
+export type VoiceDeliveryRuntimeWidgetOptions = VoiceDeliveryRuntimeClientOptions & {
+    description?: string;
+    includeActions?: boolean;
+    title?: string;
+};
+export declare const createVoiceDeliveryRuntimeViewModel: (snapshot: VoiceDeliveryRuntimeSnapshot, options?: VoiceDeliveryRuntimeWidgetOptions) => VoiceDeliveryRuntimeViewModel;
+export declare const renderVoiceDeliveryRuntimeHTML: (snapshot: VoiceDeliveryRuntimeSnapshot, options?: VoiceDeliveryRuntimeWidgetOptions) => string;
+export declare const getVoiceDeliveryRuntimeCSS: () => string;
+export declare const mountVoiceDeliveryRuntime: (element: Element, path?: string, options?: VoiceDeliveryRuntimeWidgetOptions) => {
+    close: () => void;
+    refresh: () => Promise<import("..").VoiceDeliveryRuntimeReport | undefined>;
+};
+export declare const defineVoiceDeliveryRuntimeElement: (tagName?: string) => void;

package/dist/client/duplex.d.ts

@@ -1,3 +1,3 @@
-import type { VoiceAudioPlayer, VoiceBargeInBinding, VoiceBargeInOptions, VoiceController, VoiceDuplexController, VoiceDuplexControllerOptions } from '../types';
-export declare const bindVoiceBargeIn: <TResult = unknown>(controller: Pick<VoiceController<TResult>, "partial" | "sendAudio" | "subscribe">, player: Pick<VoiceAudioPlayer, "interrupt" | "isPlaying">, options?: VoiceBargeInOptions) => VoiceBargeInBinding;
+import type { VoiceAudioPlayer, VoiceBargeInBinding, VoiceBargeInOptions, VoiceController, VoiceDuplexController, VoiceDuplexControllerOptions } from "../types";
+export declare const bindVoiceBargeIn: <TResult = unknown>(controller: Pick<VoiceController<TResult>, "partial" | "sendAudio" | "sessionId" | "subscribe">, player: Pick<VoiceAudioPlayer, "interrupt" | "isPlaying" | "lastInterruptLatencyMs" | "lastPlaybackStopLatencyMs">, options?: VoiceBargeInOptions) => VoiceBargeInBinding;
 export declare const createVoiceDuplexController: <TResult = unknown>(path: string, options?: VoiceDuplexControllerOptions) => VoiceDuplexController<TResult>;

package/dist/client/htmx.d.ts

@@ -1,2 +1,2 @@
-import type { VoiceHTMXBindingOptions, VoiceStream } from '../types';
+import type { VoiceHTMXBindingOptions, VoiceStream } from "../types";
 export declare const bindVoiceHTMX: <TResult = unknown>(stream: VoiceStream<TResult>, options: VoiceHTMXBindingOptions) => () => void;

package/dist/client/htmxAttributes.d.ts

@@ -0,0 +1,28 @@
+export type VoiceHTMXPollingAttributes = {
+    /** Set true to emit hx-get/hx-trigger when refreshUrl is also provided. */
+    poll?: boolean;
+    /** Polling cadence. Default 5_000ms. Clamped to >= 1_000ms. */
+    pollIntervalMs?: number;
+    /** Extra HTMX attributes to splice in. Keys without the 'hx-' prefix have it added. */
+    pushAttributes?: Record<string, string>;
+    /** URL hx-get fires against. Without it, polling is skipped. */
+    refreshUrl?: string;
+    /** hx-swap value. Default 'outerHTML'. */
+    swap?: string;
+    /** Optional hx-target selector. */
+    target?: string;
+};
+export declare const buildVoiceHTMXAttributes: (attrs: VoiceHTMXPollingAttributes | undefined) => string;
+/**
+ * Injects HTMX polling attributes into the first opening tag of an HTML string.
+ * Returns the original HTML unchanged when attrs produce no attributes.
+ */
+export declare const wrapVoiceHTMLWithHTMXPolling: (html: string, attrs: VoiceHTMXPollingAttributes | undefined) => string;
+/**
+ * Wraps arbitrary HTML in a self-refreshing div that polls refreshUrl.
+ * Use this when the inner HTML doesn't have a stable root element to mutate.
+ */
+export declare const wrapVoiceHTMLInHTMXContainer: (html: string, attrs: VoiceHTMXPollingAttributes & {
+    className?: string;
+    elementTag?: string;
+}) => string;