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

package/dist/index.d.ts

@@ -31,6 +31,10 @@ 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 { fetchVoiceProofTarget, getVoiceProofTargetLogicalFailure, mapVoiceProofTargetsWithConcurrency, runVoiceProofTargets } from './proofRunner';
+export type { VoiceProofTarget, VoiceProofTargetMethod, VoiceProofTargetResult, VoiceProofTargetRunnerOptions, VoiceProofTargetRunOptions } from './proofRunner';
 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,208 @@ 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/proofRunner.ts
+var encoder = new TextEncoder;
+var trimBaseUrl = (baseUrl) => baseUrl.replace(/\/$/, "");
+var safeArtifactName = (name) => name.replace(/[^a-z0-9_.-]/gi, "-");
+var summarizeValue = (value) => {
+  if (Array.isArray(value)) {
+    return { count: value.length };
+  }
+  if (!value || typeof value !== "object") {
+    return value;
+  }
+  const record = value;
+  const preferredKeys = [
+    "status",
+    "ok",
+    "pass",
+    "ready",
+    "proof",
+    "total",
+    "passed",
+    "failed",
+    "issues",
+    "summary",
+    "links",
+    "actions",
+    "checks",
+    "campaigns",
+    "recipients",
+    "attempts",
+    "telephonyMedia",
+    "operationsRecordHref",
+    "sentEvents",
+    "tasks",
+    "reviews",
+    "events",
+    "eventsWithLatency",
+    "observabilityExportReplay",
+    "validationIssues",
+    "deliveryDestinations",
+    "failedDeliveryDestinations",
+    "failedArtifacts",
+    "artifacts",
+    "kinds",
+    "redaction",
+    "retentionPlan",
+    "zeroRetentionAvailable"
+  ];
+  const summary = {};
+  for (const key of preferredKeys) {
+    if (key in record) {
+      summary[key] = summarizeValue(record[key]);
+    }
+  }
+  return Object.keys(summary).length > 0 ? summary : {
+    keys: Object.keys(record).slice(0, 12)
+  };
+};
+var getVoiceProofTargetLogicalFailure = (value) => {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return;
+  }
+  const record = value;
+  if (record.status === "fail") {
+    return 'Response status is "fail".';
+  }
+  if (record.pass === false) {
+    return "Response pass is false.";
+  }
+  if (record.ok === false) {
+    return "Response ok is false.";
+  }
+  return;
+};
+var mapVoiceProofTargetsWithConcurrency = async (items, limit, mapper) => {
+  const results = new Array(items.length);
+  let nextIndex = 0;
+  const workerCount = Math.min(Math.max(1, limit), items.length);
+  const workers = Array.from({ length: workerCount }, async () => {
+    while (nextIndex < items.length) {
+      const index = nextIndex;
+      nextIndex += 1;
+      const item = items[index];
+      if (item !== undefined) {
+        results[index] = await mapper(item);
+      }
+    }
+  });
+  await Promise.all(workers);
+  return results;
+};
+var fetchVoiceProofTarget = async (target, options) => {
+  const method = target.method ?? "GET";
+  const baseUrl = trimBaseUrl(options.baseUrl);
+  const url = `${baseUrl}${target.path}`;
+  const fetcher = options.fetch ?? globalThis.fetch;
+  const now = options.now ?? performance.now.bind(performance);
+  const startedAt = now();
+  const controller = new AbortController;
+  const timeout = options.timeoutMs && options.timeoutMs > 0 ? setTimeout(() => controller.abort(), options.timeoutMs) : undefined;
+  try {
+    const response = await fetcher(url, {
+      body: target.body === undefined ? undefined : JSON.stringify(target.body),
+      headers: {
+        accept: target.accept ?? (target.kind === "json" ? "application/json" : "text/markdown,text/plain,*/*"),
+        ...target.body === undefined ? {} : { "content-type": "application/json" }
+      },
+      method,
+      signal: controller.signal
+    });
+    const text = await response.text();
+    const bytes = encoder.encode(text).byteLength;
+    let body = text;
+    let parseError;
+    if (target.kind === "json" && text.trim()) {
+      try {
+        body = JSON.parse(text);
+      } catch (error) {
+        parseError = error instanceof Error ? error.message : String(error);
+      }
+    }
+    const missingText = target.kind === "text" ? (target.requiredText ?? []).filter((item) => !text.includes(item)) : [];
+    const logicalFailure = target.kind === "json" && !parseError && !target.allowLogicalFail ? getVoiceProofTargetLogicalFailure(body) : undefined;
+    await options.writeArtifact?.({
+      content: target.kind === "json" ? `${JSON.stringify(parseError ? { parseError, text } : body, null, 2)}
+` : text,
+      name: `${safeArtifactName(target.name)}.${target.kind === "json" ? "json" : "md"}`,
+      target
+    });
+    return {
+      body,
+      bytes,
+      elapsedMs: Math.round(now() - startedAt),
+      error: parseError ?? logicalFailure ?? (missingText.length > 0 ? `Missing required text: ${missingText.join(", ")}` : undefined),
+      kind: target.kind,
+      method,
+      name: target.name,
+      ok: response.ok && !parseError && !logicalFailure && missingText.length === 0,
+      path: target.path,
+      status: response.status,
+      summary: parseError ? { bytes, parseError } : target.kind === "json" ? summarizeValue(body) : {
+        bytes,
+        requiredTextFound: missingText.length === 0
+      },
+      url
+    };
+  } catch (error) {
+    return {
+      bytes: 0,
+      elapsedMs: Math.round(now() - startedAt),
+      error: error instanceof Error ? error.message : String(error),
+      kind: target.kind,
+      method,
+      name: target.name,
+      ok: false,
+      path: target.path,
+      url
+    };
+  } finally {
+    if (timeout) {
+      clearTimeout(timeout);
+    }
+  }
+};
+var runVoiceProofTargets = (targets, options) => mapVoiceProofTargetsWithConcurrency(targets, options.concurrency ?? 2, (target) => fetchVoiceProofTarget(target, options));
 // src/providerRouterTraces.ts
 var buildVoiceProviderRouterTraceEvent = (options) => ({
   at: options.at ?? options.event.at,
@@ -23472,7 +23674,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 +23716,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,25 +23838,25 @@ 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");
 var timingSafeEqual = (left, right) => {
-  const encoder = new TextEncoder;
-  const leftBytes = encoder.encode(left);
-  const rightBytes = encoder.encode(right);
+  const encoder2 = new TextEncoder;
+  const leftBytes = encoder2.encode(left);
+  const rightBytes = encoder2.encode(right);
   if (leftBytes.length !== rightBytes.length) {
     return false;
   }
@@ -23665,12 +23867,12 @@ var timingSafeEqual = (left, right) => {
   return diff === 0;
 };
 var signHmacSHA1Base64 = async (secret, payload) => {
-  const encoder = new TextEncoder;
-  const key = await crypto.subtle.importKey("raw", encoder.encode(secret), {
+  const encoder2 = new TextEncoder;
+  const key = await crypto.subtle.importKey("raw", encoder2.encode(secret), {
     hash: "SHA-1",
     name: "HMAC"
   }, false, ["sign"]);
-  const signature = await crypto.subtle.sign("HMAC", key, encoder.encode(payload));
+  const signature = await crypto.subtle.sign("HMAC", key, encoder2.encode(payload));
   return toBase64(signature);
 };
 var sortedParamsForSignature = (body) => Object.entries(flattenPayload(body)).filter(([, value]) => value !== undefined && value !== null).sort(([left], [right]) => left.localeCompare(right)).map(([key, value]) => `${key}${String(value)}`).join("");
@@ -25270,9 +25472,9 @@ var createPlivoMediaStreamBridge = (socket, options) => {
 };
 var toBase642 = (bytes) => Buffer5.from(new Uint8Array(bytes)).toString("base64");
 var timingSafeEqual2 = (left, right) => {
-  const encoder = new TextEncoder;
-  const leftBytes = encoder.encode(left);
-  const rightBytes = encoder.encode(right);
+  const encoder2 = new TextEncoder;
+  const leftBytes = encoder2.encode(left);
+  const rightBytes = encoder2.encode(right);
   if (leftBytes.length !== rightBytes.length) {
     return false;
   }
@@ -25283,12 +25485,12 @@ var timingSafeEqual2 = (left, right) => {
   return diff === 0;
 };
 var signHmacSHA256Base64 = async (secret, payload) => {
-  const encoder = new TextEncoder;
-  const key = await crypto.subtle.importKey("raw", encoder.encode(secret), {
+  const encoder2 = new TextEncoder;
+  const key = await crypto.subtle.importKey("raw", encoder2.encode(secret), {
     hash: "SHA-256",
     name: "HMAC"
   }, false, ["sign"]);
-  const signature = await crypto.subtle.sign("HMAC", key, encoder.encode(payload));
+  const signature = await crypto.subtle.sign("HMAC", key, encoder2.encode(payload));
   return toBase642(signature);
 };
 var sortedParamsForSignature2 = (body) => {
@@ -31552,12 +31754,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 +31768,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 +31837,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 +31858,7 @@ var validateDeliveryDestinations = (issues, destinations, path) => {
 };
 var validateVoiceObservabilityExportRecord = (input, options = {}) => {
   const issues = [];
-  if (!isRecord2(input)) {
+  if (!isRecord3(input)) {
     return {
       issues: [
         {
@@ -31691,21 +31893,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 +31919,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 +31931,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 +31945,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 +32083,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 +32096,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 +32122,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 +32136,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 +32144,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 +32322,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);
@@ -37411,18 +37613,18 @@ var createVoiceMemoryStore = () => {
 import { Elysia as Elysia61 } from "elysia";
 var toHex6 = (bytes) => Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
 var signVoiceOpsWebhookBody = async (input) => {
-  const encoder = new TextEncoder;
-  const key = await crypto.subtle.importKey("raw", encoder.encode(input.secret), {
+  const encoder2 = new TextEncoder;
+  const key = await crypto.subtle.importKey("raw", encoder2.encode(input.secret), {
     hash: "SHA-256",
     name: "HMAC"
   }, false, ["sign"]);
-  const signature = await crypto.subtle.sign("HMAC", key, encoder.encode(`${input.timestamp}.${input.body}`));
+  const signature = await crypto.subtle.sign("HMAC", key, encoder2.encode(`${input.timestamp}.${input.body}`));
   return `sha256=${toHex6(new Uint8Array(signature))}`;
 };
 var timingSafeEqual3 = (left, right) => {
-  const encoder = new TextEncoder;
-  const leftBytes = encoder.encode(left);
-  const rightBytes = encoder.encode(right);
+  const encoder2 = new TextEncoder;
+  const leftBytes = encoder2.encode(left);
+  const rightBytes = encoder2.encode(right);
   if (leftBytes.length !== rightBytes.length) {
     return false;
   }
@@ -39311,6 +39513,7 @@ export {
   summarizeVoiceProviderHealth,
   summarizeVoiceProviderFallbackRecovery,
   summarizeVoiceProviderCapabilities,
+  summarizeVoiceProofAssertions,
   summarizeVoiceProductionReadinessGate,
   summarizeVoiceOpsTasks,
   summarizeVoiceOpsTaskQueue,
@@ -39345,6 +39548,7 @@ export {
   runVoiceReconnectContract,
   runVoiceRealCallProfileRecoveryLoop,
   runVoiceProviderRoutingContract,
+  runVoiceProofTargets,
   runVoiceProfileSwitchPolicyProof,
   runVoicePhoneAgentProductionSmokeContract,
   runVoiceOutcomeContractSuite,
@@ -39483,6 +39687,7 @@ export {
   muteVoiceMonitorIssue,
   matchesVoiceOpsTaskAssignmentRule,
   markVoiceOpsTaskSLABreached,
+  mapVoiceProofTargetsWithConcurrency,
   loadVoiceRealCallProfileEvidenceFromTraceStore,
   loadVoiceObservabilityExportReplaySource,
   listVoiceRoutingEvents,
@@ -39492,6 +39697,7 @@ export {
   importVoiceCampaignRecipients,
   heartbeatVoiceOpsTask,
   hasVoiceOpsTaskSLABreach,
+  getVoiceProofTargetLogicalFailure,
   getVoiceLiveOpsControlStatus,
   getVoiceCampaignDialerProofStatus,
   getLatestVoiceTelephonyMediaReport,
@@ -39500,6 +39706,7 @@ export {
   formatVoiceProofTrendAge,
   filterVoiceTraceEvents,
   filterVoiceAuditEvents,
+  fetchVoiceProofTarget,
   failVoiceOpsTask,
   exportVoiceTrace,
   exportVoiceAuditTrail,
@@ -39670,6 +39877,7 @@ export {
   createVoiceProviderCapabilityHTMLHandler,
   createVoiceProofTrendRoutes,
   createVoiceProofTrendRecommendationRoutes,
+  createVoiceProofAssertion,
   createVoiceProfileTraceTagger,
   createVoiceProfileSwitchReadinessRoutes,
   createVoiceProfileSwitchPolicyProofRoutes,
@@ -39780,6 +39988,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/dist/proofRunner.d.ts

@@ -0,0 +1,43 @@
+export type VoiceProofTargetMethod = 'GET' | 'POST';
+export type VoiceProofTarget = {
+    accept?: string;
+    allowLogicalFail?: boolean;
+    body?: unknown;
+    kind: 'json' | 'text';
+    method?: VoiceProofTargetMethod;
+    name: string;
+    path: string;
+    requiredText?: string[];
+};
+export type VoiceProofTargetResult = {
+    body?: unknown;
+    bytes: number;
+    elapsedMs: number;
+    error?: string;
+    kind: VoiceProofTarget['kind'];
+    method: VoiceProofTargetMethod;
+    name: string;
+    ok: boolean;
+    path: string;
+    status?: number;
+    summary?: Record<string, unknown>;
+    url: string;
+};
+export type VoiceProofTargetRunnerOptions = {
+    baseUrl: string;
+    fetch?: typeof fetch;
+    now?: () => number;
+    timeoutMs?: number;
+    writeArtifact?: (input: {
+        content: string;
+        name: string;
+        target: VoiceProofTarget;
+    }) => Promise<void> | void;
+};
+export type VoiceProofTargetRunOptions = VoiceProofTargetRunnerOptions & {
+    concurrency?: number;
+};
+export declare const getVoiceProofTargetLogicalFailure: (value: unknown) => "Response status is \"fail\"." | "Response pass is false." | "Response ok is false." | undefined;
+export declare const mapVoiceProofTargetsWithConcurrency: <TInput, TOutput>(items: TInput[], limit: number, mapper: (item: TInput) => Promise<TOutput>) => Promise<TOutput[]>;
+export declare const fetchVoiceProofTarget: (target: VoiceProofTarget, options: VoiceProofTargetRunnerOptions) => Promise<VoiceProofTargetResult>;
+export declare const runVoiceProofTargets: (targets: VoiceProofTarget[], options: VoiceProofTargetRunOptions) => Promise<VoiceProofTargetResult[]>;

package/package.json

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