@absolutejs/voice 0.0.22-beta.397 → 0.0.22-beta.399

package/dist/angular/voice-session-snapshot.service.d.ts

@@ -0,0 +1,13 @@
+import { type VoiceSessionSnapshotClientOptions } from '../client/sessionSnapshot';
+import type { VoiceSessionSnapshot } from '../sessionSnapshot';
+export declare class VoiceSessionSnapshotService {
+    connect(path: string, options?: VoiceSessionSnapshotClientOptions): {
+        close: () => void;
+        download: () => Blob;
+        error: import("@angular/core").Signal<string | null>;
+        isLoading: import("@angular/core").Signal<boolean>;
+        refresh: () => Promise<VoiceSessionSnapshot | undefined>;
+        snapshot: import("@angular/core").Signal<VoiceSessionSnapshot | undefined>;
+        updatedAt: import("@angular/core").Signal<number | undefined>;
+    };
+}

package/dist/client/index.d.ts

@@ -12,6 +12,8 @@ export { createVoiceLiveTurnLatencyMonitor } from './liveTurnLatency';
 export { createVoiceOpsStatusStore, fetchVoiceOpsStatus } from './opsStatus';
 export { createVoicePlatformCoverageStore, fetchVoicePlatformCoverage } from './platformCoverage';
 export { createVoiceProofTrendsStore, fetchVoiceProofTrends } from './proofTrends';
+export { createVoiceSessionSnapshotStore, fetchVoiceSessionSnapshot } from './sessionSnapshot';
+export type { VoiceSessionSnapshotClientOptions, VoiceSessionSnapshotClientState } from './sessionSnapshot';
 export { createVoiceProfileComparisonStore, fetchVoiceProfileComparison } from './profileComparison';
 export { createVoiceProfileSwitchRecommendationStore, fetchVoiceProfileSwitchRecommendation } from './profileSwitchRecommendation';
 export { createVoiceReadinessFailuresStore, fetchVoiceReadinessFailures } from './readinessFailures';

package/dist/client/index.js

@@ -2974,6 +2974,98 @@ var createVoiceProofTrendsStore = (path = "/api/voice/proof-trends", options = {
     }
   };
 };
+// src/client/sessionSnapshot.ts
+var withTurnId = (path, turnId) => {
+  if (!turnId) {
+    return path;
+  }
+  const url = new URL(path, "http://absolutejs.local");
+  url.searchParams.set("turnId", turnId);
+  return `${url.pathname}${url.search}`;
+};
+var fetchVoiceSessionSnapshot = async (path, options = {}) => {
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const response = await fetchImpl(withTurnId(path, options.turnId));
+  if (!response.ok) {
+    throw new Error(`Voice session snapshot failed: HTTP ${response.status}`);
+  }
+  return await response.json();
+};
+var createVoiceSessionSnapshotStore = (path, options = {}) => {
+  const listeners = new Set;
+  let closed = false;
+  let timer;
+  let snapshot = {
+    error: null,
+    isLoading: false
+  };
+  const emit = () => {
+    for (const listener of listeners) {
+      listener();
+    }
+  };
+  const refresh = async () => {
+    if (closed) {
+      return snapshot.snapshot;
+    }
+    snapshot = { ...snapshot, error: null, isLoading: true };
+    emit();
+    try {
+      const next = await fetchVoiceSessionSnapshot(path, options);
+      snapshot = {
+        error: null,
+        isLoading: false,
+        snapshot: next,
+        updatedAt: Date.now()
+      };
+      emit();
+      return next;
+    } catch (error) {
+      snapshot = {
+        ...snapshot,
+        error: error instanceof Error ? error.message : String(error),
+        isLoading: false
+      };
+      emit();
+      throw error;
+    }
+  };
+  const download = () => {
+    const current = snapshot.snapshot;
+    if (current === undefined) {
+      throw new Error("Voice session snapshot has not been loaded.");
+    }
+    return new Blob([JSON.stringify(current, null, 2)], {
+      type: "application/json"
+    });
+  };
+  const close = () => {
+    closed = true;
+    if (timer) {
+      clearInterval(timer);
+      timer = undefined;
+    }
+    listeners.clear();
+  };
+  if (options.intervalMs && options.intervalMs > 0) {
+    timer = setInterval(() => {
+      refresh().catch(() => {});
+    }, options.intervalMs);
+  }
+  return {
+    close,
+    download,
+    getServerSnapshot: () => snapshot,
+    getSnapshot: () => snapshot,
+    refresh,
+    subscribe: (listener) => {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    }
+  };
+};
 // src/client/profileComparison.ts
 var fetchVoiceProfileComparison = async (path = "/api/voice/real-call-profile-history", options = {}) => {
   const fetchImpl = options.fetch ?? globalThis.fetch;
@@ -10973,6 +11065,7 @@ export {
   fetchVoiceTurnQuality,
   fetchVoiceTurnLatency,
   fetchVoiceTraceTimeline,
+  fetchVoiceSessionSnapshot,
   fetchVoiceRoutingStatus,
   fetchVoiceReadinessFailures,
   fetchVoiceProviderStatus,
@@ -11013,6 +11106,7 @@ export {
   createVoiceTraceTimelineViewModel,
   createVoiceTraceTimelineStore,
   createVoiceStream,
+  createVoiceSessionSnapshotStore,
   createVoiceRoutingStatusViewModel,
   createVoiceRoutingStatusStore,
   createVoiceReadinessFailuresViewModel,

package/dist/client/sessionSnapshot.d.ts

@@ -0,0 +1,21 @@
+import type { VoiceSessionSnapshot } from '../sessionSnapshot';
+export type VoiceSessionSnapshotClientOptions = {
+    fetch?: typeof fetch;
+    intervalMs?: number;
+    turnId?: string;
+};
+export type VoiceSessionSnapshotClientState = {
+    error: string | null;
+    isLoading: boolean;
+    snapshot?: VoiceSessionSnapshot;
+    updatedAt?: number;
+};
+export declare const fetchVoiceSessionSnapshot: (path: string, options?: Pick<VoiceSessionSnapshotClientOptions, "fetch" | "turnId">) => Promise<VoiceSessionSnapshot>;
+export declare const createVoiceSessionSnapshotStore: (path: string, options?: VoiceSessionSnapshotClientOptions) => {
+    close: () => void;
+    download: () => Blob;
+    getServerSnapshot: () => VoiceSessionSnapshotClientState;
+    getSnapshot: () => VoiceSessionSnapshotClientState;
+    refresh: () => Promise<VoiceSessionSnapshot | undefined>;
+    subscribe: (listener: () => void) => () => void;
+};

package/dist/index.d.ts

@@ -32,9 +32,9 @@ export type { VoiceCompetitiveCoverageAssertionInput, VoiceCompetitiveCoverageAs
 export type { VoicePlatformCoverageAssertionInput, VoicePlatformCoverageAssertionReport, VoicePlatformCoverageEvidence, VoicePlatformCoverageRoutesOptions, VoicePlatformCoverageStatus, VoicePlatformCoverageSummary, VoicePlatformCoverageSummaryInput, VoicePlatformCoverageSurface } from './platformCoverage';
 export { assertVoiceProofTrendEvidence, appendVoiceRealCallProfileRecoveryEvidence, buildEmptyVoiceProofTrendReport, buildVoiceProofTrendProfileSummaries, buildVoiceProofTrendRecommendationReport, buildVoiceProofTrendReportFromRealCallProfiles, buildVoiceProofTrendReport, buildVoiceRealCallProfileEvidenceFromTraceEvents, buildVoiceRealCallProfileDefaults, buildVoiceRealCallProfileHistoryReport, buildVoiceRealCallProfileReadinessCheck, buildVoiceRealCallProfileRecoveryJobHistoryCheck, buildVoiceRealCallProfileRecoveryActions, createVoiceInMemoryRealCallProfileRecoveryJobStore, createVoiceRealCallProfileTraceCollector, createVoiceSQLiteRealCallProfileRecoveryJobStore, createVoiceProofTrendRecommendationRoutes, createVoiceProofTrendRoutes, createVoiceRealCallProfileHistoryRoutes, createVoiceRealCallProfileRecoveryActionRoutes, DEFAULT_VOICE_PROOF_TREND_PROFILE_DEFINITIONS, DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS, evaluateVoiceProofTrendEvidence, formatVoiceProofTrendAge, loadVoiceRealCallProfileEvidenceFromTraceStore, normalizeVoiceProofTrendReport, readVoiceProofTrendReportFile, renderVoiceProofTrendRecommendationHTML, renderVoiceProofTrendRecommendationMarkdown, renderVoiceRealCallProfileHistoryHTML, renderVoiceRealCallProfileHistoryMarkdown, runVoiceRealCallProfileRecoveryLoop, resolveVoiceRealCallProfileProviderRoute } from './proofTrends';
 export { createVoiceEvidenceAssertion, createVoiceProofAssertion, summarizeVoiceProofAssertions } from './proofAssertions';
-export { buildVoiceSessionSnapshot, buildVoiceSessionSnapshotStatus, parseVoiceSessionSnapshot } from './sessionSnapshot';
+export { buildVoiceSessionSnapshot, buildVoiceSessionSnapshotStatus, createVoiceSessionSnapshotRoutes, parseVoiceSessionSnapshot } from './sessionSnapshot';
 export type { VoiceEvidenceAssertionInput, VoiceProofAssertionInput, VoiceProofAssertionResult, VoiceProofAssertionSummary } from './proofAssertions';
-export type { VoiceSessionSnapshot, VoiceSessionSnapshotInput, VoiceSessionSnapshotQualityEvidence, VoiceSessionSnapshotStatus } from './sessionSnapshot';
+export type { VoiceSessionSnapshot, VoiceSessionSnapshotInput, VoiceSessionSnapshotQualityEvidence, VoiceSessionSnapshotRoutesOptions, VoiceSessionSnapshotRouteSource, VoiceSessionSnapshotRouteSourceInput, VoiceSessionSnapshotStatus } from './sessionSnapshot';
 export { fetchVoiceProofTarget, getVoiceProofTargetLogicalFailure, mapVoiceProofTargetsWithConcurrency, runVoiceCommandProofTarget, runVoiceCommandProofTargets, runVoiceProofTargets } from './proofRunner';
 export type { VoiceCommandProofExecutionResult, VoiceCommandProofTarget, VoiceCommandProofTargetResult, VoiceCommandProofTargetRunnerOptions, VoiceCommandProofTargetRunOptions, VoiceProofTarget, VoiceProofTargetMethod, VoiceProofTargetResult, VoiceProofTargetRunnerOptions, VoiceProofTargetRunOptions } from './proofRunner';
 export { applyVoiceProfileSwitchGuard, buildVoiceProfileSwitchReadinessReport, buildVoiceProfileSwitchLiveDecisionReport, createVoiceProfileSwitchLiveDecisionRoutes, createVoiceProfileSwitchPolicyProofRoutes, createVoiceProfileSwitchReadinessRoutes, recommendVoiceProfileSwitch, renderVoiceProfileSwitchLiveDecisionHTML, renderVoiceProfileSwitchPolicyProofHTML, renderVoiceProfileSwitchReadinessHTML, runVoiceProfileSwitchPolicyProof } from './profileSwitchRecommendation';