@absolutejs/voice 0.0.22-beta.393 → 0.0.22-beta.394

package/dist/index.d.ts

@@ -31,6 +31,8 @@ export { assertVoiceCompetitiveCoverage, buildVoiceCompetitiveCoverageReport, cr
 export type { VoiceCompetitiveCoverageAssertionInput, VoiceCompetitiveCoverageAssertionReport, VoiceCompetitiveCoverageIssue, VoiceCompetitiveCoverageLevel, VoiceCompetitiveCoverageReport, VoiceCompetitiveCoverageReportInput, VoiceCompetitiveCoverageRoutesOptions, VoiceCompetitiveCoverageStatus, VoiceCompetitiveCoverageSummary, VoiceCompetitiveDepthLevel, VoiceCompetitiveEvidence, VoiceCompetitiveSurface } from './competitiveCoverage';
 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 type { VoiceEvidenceAssertionInput, VoiceProofAssertionInput, VoiceProofAssertionResult, VoiceProofAssertionSummary } from './proofAssertions';
 export { applyVoiceProfileSwitchGuard, buildVoiceProfileSwitchReadinessReport, buildVoiceProfileSwitchLiveDecisionReport, createVoiceProfileSwitchLiveDecisionRoutes, createVoiceProfileSwitchPolicyProofRoutes, createVoiceProfileSwitchReadinessRoutes, recommendVoiceProfileSwitch, renderVoiceProfileSwitchLiveDecisionHTML, renderVoiceProfileSwitchPolicyProofHTML, renderVoiceProfileSwitchReadinessHTML, runVoiceProfileSwitchPolicyProof } from './profileSwitchRecommendation';
 export type { VoiceProfileSwitchGuardAction, VoiceProfileSwitchGuardDecision, VoiceProfileSwitchGuardMode, VoiceProfileSwitchGuardOptions, VoiceProfileSwitchObservedSignals, VoiceProfileSwitchLiveDecisionEvidence, VoiceProfileSwitchLiveDecisionReport, VoiceProfileSwitchLiveDecisionReportOptions, VoiceProfileSwitchLiveDecisionRoutesOptions, VoiceProfileSwitchLiveDecisionSession, VoiceProfileSwitchPolicyProofCase, VoiceProfileSwitchPolicyProofCaseResult, VoiceProfileSwitchPolicyProofOptions, VoiceProfileSwitchPolicyProofReport, VoiceProfileSwitchPolicyProofRoutesOptions, VoiceProfileSwitchReadinessIssue, VoiceProfileSwitchReadinessOptions, VoiceProfileSwitchReadinessReport, VoiceProfileSwitchReadinessRoutesOptions, VoiceProfileSwitchReadinessStatus, VoiceProfileSwitchRecommendation, VoiceProfileSwitchRecommendationOptions } from './profileSwitchRecommendation';
 export { buildVoiceProviderDecisionTraceReport, createVoiceProviderDecisionTraceEvent, createVoiceProviderDecisionTraceRoutes, listVoiceProviderDecisionTraces, renderVoiceProviderDecisionTraceHTML, renderVoiceProviderDecisionTraceMarkdown } from './providerDecisionTraces';

package/dist/index.js

@@ -18347,6 +18347,44 @@ var formatVoiceProofTrendAge = (ageMs) => {
   const days = Math.floor(hours / 24);
   return `${days}d ${hours % 24}h`;
 };
+// src/proofAssertions.ts
+var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var createVoiceProofAssertion = (input) => ({
+  kind: "json-assertion",
+  name: input.name,
+  ok: input.ok === true,
+  summary: input.summary ?? (input.ok === true ? undefined : {
+    issues: [input.missingIssue ?? `${input.name} proof is missing.`]
+  })
+});
+var createVoiceEvidenceAssertion = (input) => {
+  if (input.evidence === undefined) {
+    return createVoiceProofAssertion({
+      missingIssue: input.missingIssue,
+      name: input.name,
+      ok: false
+    });
+  }
+  return {
+    kind: "json-assertion",
+    name: input.name,
+    ok: input.ok?.(input.evidence) ?? (isRecord(input.evidence) && input.evidence.ok === true),
+    summary: input.summary?.(input.evidence) ?? (isRecord(input.evidence) ? input.evidence : undefined)
+  };
+};
+var summarizeVoiceProofAssertions = (assertions) => {
+  const failures = assertions.filter((assertion) => !assertion.ok).map((assertion) => ({
+    name: assertion.name,
+    summary: assertion.summary
+  }));
+  return {
+    failed: failures.length,
+    failures,
+    ok: failures.length === 0,
+    passed: assertions.length - failures.length,
+    total: assertions.length
+  };
+};
 // src/providerRouterTraces.ts
 var buildVoiceProviderRouterTraceEvent = (options) => ({
   at: options.at ?? options.event.at,
@@ -23472,7 +23510,7 @@ var DEFAULT_MACHINE_VOICEMAIL_VALUES = [
   "voicemail"
 ];
 var DEFAULT_NO_ANSWER_SIP_CODES = [408, 480, 486, 487, 603];
-var isRecord = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
+var isRecord2 = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
 var uniqueSorted4 = (values) => Array.from(new Set(values)).sort();
 var findMissing3 = (values, required) => {
   if (!required?.length) {
@@ -23514,9 +23552,9 @@ var evaluateVoiceTelephonyWebhookNormalizationEvidence = (input = {}) => {
   const duplicateDecisions = decisions.filter((decision) => decision.duplicate === true);
   const duplicateProviders = uniqueSorted4(duplicateDecisions.map((decision) => decision.provider ?? decision.event?.provider).filter(isTelephonyWebhookProvider));
   const duplicateIdempotencyKeys = new Set(duplicateDecisions.map((decision) => decision.idempotencyKey).filter((key) => typeof key === "string" && key.length > 0)).size;
-  const duplicateCampaignOutcomesApplied = duplicateDecisions.filter((decision) => isRecord(decision.campaignOutcome) && decision.campaignOutcome.applied === true).length;
-  const duplicateOutcomeReasons = uniqueSorted4(duplicateDecisions.map((decision) => isRecord(decision.campaignOutcome) ? decision.campaignOutcome.reason : undefined).filter((reason) => typeof reason === "string"));
-  const routeResults = decisions.filter((decision) => isRecord(decision.routeResult)).length;
+  const duplicateCampaignOutcomesApplied = duplicateDecisions.filter((decision) => isRecord2(decision.campaignOutcome) && decision.campaignOutcome.applied === true).length;
+  const duplicateOutcomeReasons = uniqueSorted4(duplicateDecisions.map((decision) => isRecord2(decision.campaignOutcome) ? decision.campaignOutcome.reason : undefined).filter((reason) => typeof reason === "string"));
+  const routeResults = decisions.filter((decision) => isRecord2(decision.routeResult)).length;
   const missingSessionIds = decisions.filter((decision) => !decision.sessionId).length;
   const rejectedVerificationAttempts = verificationAttempts.filter((attempt) => attempt.rejected === true || attempt.status === 401 || attempt.verification?.ok === false && attempt.verification.reason === "invalid-signature");
   const rejectedVerificationProviders = uniqueSorted4(rejectedVerificationAttempts.map((attempt) => attempt.provider).filter(isTelephonyWebhookProvider));
@@ -23636,18 +23674,18 @@ var parseMaybeJSON = (value) => {
   }
 };
 var flattenPayload = (value) => {
-  if (!isRecord(value)) {
+  if (!isRecord2(value)) {
     return {};
   }
-  const data = isRecord(value.data) ? value.data : undefined;
-  const payload = isRecord(value.payload) ? value.payload : undefined;
-  const event = isRecord(value.event) ? value.event : undefined;
+  const data = isRecord2(value.data) ? value.data : undefined;
+  const payload = isRecord2(value.payload) ? value.payload : undefined;
+  const event = isRecord2(value.event) ? value.event : undefined;
   return {
     ...value,
     ...payload,
     ...event,
     ...data,
-    ...isRecord(data?.payload) ? data.payload : undefined
+    ...isRecord2(data?.payload) ? data.payload : undefined
   };
 };
 var toBase64 = (bytes) => Buffer.from(new Uint8Array(bytes)).toString("base64");
@@ -31552,12 +31590,12 @@ var assertVoiceObservabilityExportSchema = (input) => {
     throw new Error(`Unsupported voice observability export schema: ${input.schema?.id ?? "missing"}@${input.schema?.version ?? "missing"}`);
   }
 };
-var isRecord2 = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
+var isRecord3 = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
 var isStatus2 = (value) => value === "fail" || value === "pass" || value === "warn";
-var getRecord2 = (value, key) => isRecord2(value) && isRecord2(value[key]) ? value[key] : undefined;
-var getRecordArray = (value, key) => isRecord2(value) && Array.isArray(value[key]) ? value[key] : undefined;
+var getRecord2 = (value, key) => isRecord3(value) && isRecord3(value[key]) ? value[key] : undefined;
+var getRecordArray = (value, key) => isRecord3(value) && Array.isArray(value[key]) ? value[key] : undefined;
 var inferVoiceObservabilityExportRecordKind = (record) => {
-  if (isRecord2(record.manifest) && isRecord2(record.artifactIndex)) {
+  if (isRecord3(record.manifest) && isRecord3(record.artifactIndex)) {
     return "database-record";
   }
   if (Array.isArray(record.receipts)) {
@@ -31566,10 +31604,10 @@ var inferVoiceObservabilityExportRecordKind = (record) => {
   if (typeof record.runId === "string" && Array.isArray(record.destinations)) {
     return "delivery-receipt";
   }
-  if (Array.isArray(record.destinations) && isRecord2(record.summary) && typeof record.exportStatus === "string") {
+  if (Array.isArray(record.destinations) && isRecord3(record.summary) && typeof record.exportStatus === "string") {
     return "delivery-report";
   }
-  if (Array.isArray(record.artifacts) && isRecord2(record.summary)) {
+  if (Array.isArray(record.artifacts) && isRecord3(record.summary)) {
     return Array.isArray(record.envelopes) ? "manifest" : "artifact-index";
   }
   return;
@@ -31635,7 +31673,7 @@ var validateDeliveryDestinations = (issues, destinations, path) => {
   }
   destinations.forEach((destination, index) => {
     const destinationPath = `${path}.${index}`;
-    if (!isRecord2(destination)) {
+    if (!isRecord3(destination)) {
       pushValidationIssue(issues, {
         code: "voice.observability.export.invalid_shape",
         message: `${destinationPath} must be an object.`,
@@ -31656,7 +31694,7 @@ var validateDeliveryDestinations = (issues, destinations, path) => {
 };
 var validateVoiceObservabilityExportRecord = (input, options = {}) => {
   const issues = [];
-  if (!isRecord2(input)) {
+  if (!isRecord3(input)) {
     return {
       issues: [
         {
@@ -31691,21 +31729,21 @@ var validateVoiceObservabilityExportRecord = (input, options = {}) => {
     requireArrayField(issues, input, "sessionIds", "$");
     requireNumberField(issues, input, "checkedAt", "$");
     requireStatusField(issues, input, "status", "$");
-    if (!isRecord2(input.deliveries)) {
+    if (!isRecord3(input.deliveries)) {
       pushValidationIssue(issues, {
         code: "voice.observability.export.missing_field",
         message: "$.deliveries must be an object.",
         path: "$.deliveries"
       });
     }
-    if (!isRecord2(input.redaction)) {
+    if (!isRecord3(input.redaction)) {
       pushValidationIssue(issues, {
         code: "voice.observability.export.missing_field",
         message: "$.redaction must be an object.",
         path: "$.redaction"
       });
     }
-    if (!isRecord2(input.summary)) {
+    if (!isRecord3(input.summary)) {
       pushValidationIssue(issues, {
         code: "voice.observability.export.missing_field",
         message: "$.summary must be an object.",
@@ -31717,7 +31755,7 @@ var validateVoiceObservabilityExportRecord = (input, options = {}) => {
     requireArrayField(issues, input, "artifacts", "$");
     requireNumberField(issues, input, "checkedAt", "$");
     requireStatusField(issues, input, "status", "$");
-    if (!isRecord2(input.summary)) {
+    if (!isRecord3(input.summary)) {
       pushValidationIssue(issues, {
         code: "voice.observability.export.missing_field",
         message: "$.summary must be an object.",
@@ -31729,7 +31767,7 @@ var validateVoiceObservabilityExportRecord = (input, options = {}) => {
     requireNumberField(issues, input, "checkedAt", "$");
     requireStatusField(issues, input, "status", "$");
     requireStatusField(issues, input, "exportStatus", "$");
-    if (!isRecord2(input.manifest)) {
+    if (!isRecord3(input.manifest)) {
       pushValidationIssue(issues, {
         code: "voice.observability.export.missing_field",
         message: "$.manifest must be an object.",
@@ -31743,7 +31781,7 @@ var validateVoiceObservabilityExportRecord = (input, options = {}) => {
         path: `$.manifest${issue.path.slice(1)}`
       })));
     }
-    if (!isRecord2(input.artifactIndex)) {
+    if (!isRecord3(input.artifactIndex)) {
       pushValidationIssue(issues, {
         code: "voice.observability.export.missing_field",
         message: "$.artifactIndex must be an object.",
@@ -31881,11 +31919,11 @@ var buildObservabilityExportDatabaseRecord = (input) => ({
 });
 var parseObservabilityExportJson = (value) => typeof value === "string" ? JSON.parse(value) : value;
 var collectReplayDeliveryDestinations = (value) => {
-  if (!isRecord2(value)) {
+  if (!isRecord3(value)) {
     return [];
   }
   if (Array.isArray(value.destinations)) {
-    return value.destinations.filter((destination) => isRecord2(destination));
+    return value.destinations.filter((destination) => isRecord3(destination));
   }
   if (Array.isArray(value.receipts)) {
     return value.receipts.flatMap((receipt) => collectReplayDeliveryDestinations(receipt));
@@ -31894,8 +31932,8 @@ var collectReplayDeliveryDestinations = (value) => {
 };
 var replayIssueSeverity = (status) => status === "fail" ? "fail" : "warn";
 var buildVoiceObservabilityExportReplayReport = (records) => {
-  const manifest = records.manifest ?? (isRecord2(records.databaseRecord) ? records.databaseRecord.manifest : undefined);
-  const artifactIndex = records.artifactIndex ?? (isRecord2(records.databaseRecord) ? records.databaseRecord.artifactIndex : undefined);
+  const manifest = records.manifest ?? (isRecord3(records.databaseRecord) ? records.databaseRecord.manifest : undefined);
+  const artifactIndex = records.artifactIndex ?? (isRecord3(records.databaseRecord) ? records.databaseRecord.artifactIndex : undefined);
   const validations = {
     artifactIndex: validateVoiceObservabilityExportRecord(artifactIndex, {
       kind: "artifact-index"
@@ -31920,12 +31958,12 @@ var buildVoiceObservabilityExportReplayReport = (records) => {
     kind,
     issue
   })) ?? []);
-  const manifestRecord = isRecord2(manifest) ? manifest : undefined;
-  const artifactIndexRecord = isRecord2(artifactIndex) ? artifactIndex : undefined;
+  const manifestRecord = isRecord3(manifest) ? manifest : undefined;
+  const artifactIndexRecord = isRecord3(artifactIndex) ? artifactIndex : undefined;
   const artifacts = [
     ...Array.isArray(manifestRecord?.artifacts) ? manifestRecord.artifacts : [],
     ...Array.isArray(artifactIndexRecord?.artifacts) ? artifactIndexRecord.artifacts : []
-  ].filter((artifact) => isRecord2(artifact));
+  ].filter((artifact) => isRecord3(artifact));
   const failedArtifacts = artifacts.filter((artifact) => artifact.status === "fail");
   const deliveryDestinations = [
     ...collectReplayDeliveryDestinations(records.deliveryReport),
@@ -31934,7 +31972,7 @@ var buildVoiceObservabilityExportReplayReport = (records) => {
   ];
   const failedDeliveryDestinations = deliveryDestinations.filter((destination) => destination.status === "failed");
   const issues = [
-    ...!records.manifest && !isRecord2(records.databaseRecord) ? [
+    ...!records.manifest && !isRecord3(records.databaseRecord) ? [
       {
         code: "voice.observability.export_replay.missing_record",
         label: "Export manifest",
@@ -31942,7 +31980,7 @@ var buildVoiceObservabilityExportReplayReport = (records) => {
         value: "manifest"
       }
     ] : [],
-    ...!records.artifactIndex && !isRecord2(records.databaseRecord) ? [
+    ...!records.artifactIndex && !isRecord3(records.databaseRecord) ? [
       {
         code: "voice.observability.export_replay.missing_record",
         label: "Artifact index",
@@ -32120,7 +32158,7 @@ var loadVoiceObservabilityExportReplaySource = async (source) => {
 };
 var replayVoiceObservabilityExport = async (source) => buildVoiceObservabilityExportReplayReport(await loadVoiceObservabilityExportReplaySource(source));
 var escapeObservabilityReplayHtml = (value) => String(value).replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
-var isVoiceObservabilityExportReplayReport = (value) => isRecord2(value) && isRecord2(value.summary) && isRecord2(value.records) && Array.isArray(value.issues) && typeof value.checkedAt === "number" && isStatus2(value.status);
+var isVoiceObservabilityExportReplayReport = (value) => isRecord3(value) && isRecord3(value.summary) && isRecord3(value.records) && Array.isArray(value.issues) && typeof value.checkedAt === "number" && isStatus2(value.status);
 var resolveVoiceObservabilityExportReplayReport = async (input) => {
   const resolved = typeof input === "function" ? await input() : input;
   return isVoiceObservabilityExportReplayReport(resolved) ? resolved : replayVoiceObservabilityExport(resolved);
@@ -39311,6 +39349,7 @@ export {
   summarizeVoiceProviderHealth,
   summarizeVoiceProviderFallbackRecovery,
   summarizeVoiceProviderCapabilities,
+  summarizeVoiceProofAssertions,
   summarizeVoiceProductionReadinessGate,
   summarizeVoiceOpsTasks,
   summarizeVoiceOpsTaskQueue,
@@ -39670,6 +39709,7 @@ export {
   createVoiceProviderCapabilityHTMLHandler,
   createVoiceProofTrendRoutes,
   createVoiceProofTrendRecommendationRoutes,
+  createVoiceProofAssertion,
   createVoiceProfileTraceTagger,
   createVoiceProfileSwitchReadinessRoutes,
   createVoiceProfileSwitchPolicyProofRoutes,
@@ -39780,6 +39820,7 @@ export {
   createVoiceExternalObjectMapId,
   createVoiceExternalObjectMap,
   createVoiceExperiment,
+  createVoiceEvidenceAssertion,
   createVoiceEvalRoutes,
   createVoiceDiagnosticsRoutes,
   createVoiceDemoReadyRoutes,

package/dist/proofAssertions.d.ts

@@ -0,0 +1,32 @@
+export type VoiceProofAssertionResult = {
+    kind: 'json-assertion';
+    name: string;
+    ok: boolean;
+    summary?: Record<string, unknown>;
+};
+export type VoiceProofAssertionSummary = {
+    failed: number;
+    failures: Array<{
+        name: string;
+        summary?: Record<string, unknown>;
+    }>;
+    ok: boolean;
+    passed: number;
+    total: number;
+};
+export type VoiceProofAssertionInput = {
+    missingIssue?: string;
+    name: string;
+    ok?: boolean;
+    summary?: Record<string, unknown>;
+};
+export type VoiceEvidenceAssertionInput<TEvidence> = {
+    evidence?: TEvidence;
+    missingIssue?: string;
+    name: string;
+    ok?: (evidence: TEvidence) => boolean;
+    summary?: (evidence: TEvidence) => Record<string, unknown>;
+};
+export declare const createVoiceProofAssertion: (input: VoiceProofAssertionInput) => VoiceProofAssertionResult;
+export declare const createVoiceEvidenceAssertion: <TEvidence>(input: VoiceEvidenceAssertionInput<TEvidence>) => VoiceProofAssertionResult;
+export declare const summarizeVoiceProofAssertions: (assertions: VoiceProofAssertionResult[]) => VoiceProofAssertionSummary;

package/package.json

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