@absolutejs/voice 0.0.22-beta.416 → 0.0.22-beta.418

package/dist/index.d.ts

@@ -206,6 +206,6 @@ export type { PlivoInboundMessage, PlivoMediaStreamBridge, PlivoMediaStreamBridg
 export type { VoiceTelephonyCarrierMatrix, VoiceTelephonyCarrierMatrixEntry, VoiceTelephonyCarrierMatrixInput, VoiceTelephonyCarrierMatrixOptions, VoiceTelephonyCarrierMatrixRoutesOptions, VoiceTelephonyCarrierMatrixStatus } from './telephony/matrix';
 export { shapeTelephonyAssistantText } from './telephony/response';
 export type { TelephonyResponseShapeMode, TelephonyResponseShapeOptions } from './telephony/response';
-export { buildVoiceProofPack, buildVoiceProofPackFromObservabilityExport, createVoiceProofPackStaleWhileRefreshSource, createVoiceProofPackArtifacts, createVoiceProofPackOperationsRecordSection, createVoiceProofPackProductionReadinessSection, createVoiceProofPackProviderSloSection, createVoiceProofPackRoutes, createVoiceProofPackSupportBundleSection, renderVoiceProofPackMarkdown, writeVoiceProofPack } from './proofPack';
-export type { VoiceProofPack, VoiceProofPackEvidence, VoiceProofPackInput, VoiceProofPackRefreshState, VoiceProofPackRefreshStatus, VoiceProofPackRoutesOptions, VoiceProofPackSection, VoiceProofPackSourceValue, VoiceProofPackStatus, VoiceProofPackStaleWhileRefreshSource, VoiceProofPackStaleWhileRefreshSourceOptions, VoiceProofPackWriteResult } from './proofPack';
+export { buildVoiceProofPack, buildVoiceProofPackFromObservabilityExport, createVoiceProofPackBuildContext, createVoiceProofRefreshSnapshot, createVoiceProofPackStaleWhileRefreshSource, createVoiceProofPackArtifacts, createVoiceProofPackOperationsRecordSection, createVoiceProofPackProductionReadinessSection, createVoiceProofPackProviderSloSection, createVoiceProofPackRoutes, createVoiceProofPackSupportBundleSection, renderVoiceProofPackMarkdown, writeVoiceProofPack } from './proofPack';
+export type { VoiceProofPack, VoiceProofPackBuildContext, VoiceProofPackBuildContextOptions, VoiceProofPackBuildTiming, VoiceProofPackEvidence, VoiceProofPackInput, VoiceProofPackRefreshState, VoiceProofPackRefreshStatus, VoiceProofPackRoutesOptions, VoiceProofPackSection, VoiceProofPackSourceValue, VoiceProofPackStatus, VoiceProofPackStaleWhileRefreshSource, VoiceProofPackStaleWhileRefreshSourceOptions, VoiceProofPackWriteResult, VoiceProofRefreshSnapshot, VoiceProofRefreshSnapshotOptions } from './proofPack';
 export * from './types';

package/dist/index.js

@@ -39981,6 +39981,93 @@ var summarizeProofPackSections = (sections) => {
   }
   return { fail, pass, sections: sections.length, warn };
 };
+var createVoiceProofPackBuildContext = (options = {}) => {
+  const now = options.now ?? Date.now;
+  const cachedValues = new Map;
+  const timings = [];
+  const time = async (label, run) => {
+    const startedAt = now();
+    try {
+      return await run();
+    } finally {
+      const endedAt = now();
+      const timing = {
+        durationMs: Math.max(0, endedAt - startedAt),
+        endedAt,
+        label,
+        startedAt
+      };
+      timings.push(timing);
+      options.onTiming?.(timing);
+    }
+  };
+  const cache = (key, loader) => {
+    const cached = cachedValues.get(key);
+    if (cached) {
+      return cached;
+    }
+    const value = Promise.resolve(loader());
+    cachedValues.set(key, value);
+    return value;
+  };
+  return {
+    cache,
+    clear: (key) => {
+      if (key === undefined) {
+        cachedValues.clear();
+        return;
+      }
+      cachedValues.delete(key);
+    },
+    getTimings: () => [...timings],
+    time
+  };
+};
+var createSnapshotTraceStore = (events) => ({
+  append: async () => {
+    throw new Error("Voice proof refresh snapshot trace store is read-only.");
+  },
+  get: async (id) => events.find((event) => event.id === id),
+  list: async (filter) => filterVoiceTraceEvents([...events], filter),
+  remove: async () => {
+    throw new Error("Voice proof refresh snapshot trace store is read-only.");
+  }
+});
+var createSnapshotAuditStore = (events) => ({
+  append: async () => {
+    throw new Error("Voice proof refresh snapshot audit store is read-only.");
+  },
+  get: async (id) => events.find((event) => event.id === id),
+  list: async (filter) => filterVoiceAuditEvents([...events], filter)
+});
+var createSnapshotTraceDeliveryStore = (deliveries) => ({
+  get: async (id) => deliveries.find((delivery) => delivery.id === id),
+  list: async () => [...deliveries],
+  remove: async () => {
+    throw new Error("Voice proof refresh snapshot delivery store is read-only.");
+  },
+  set: async () => {
+    throw new Error("Voice proof refresh snapshot delivery store is read-only.");
+  }
+});
+var createVoiceProofRefreshSnapshot = async (options = {}) => {
+  const [traceEvents, auditEvents, traceDeliveries, auditSinkDeliveries] = await Promise.all([
+    options.events ?? await options.traceStore?.list(options.traceFilter) ?? [],
+    options.audit ? await options.audit.list(options.auditFilter) : [],
+    options.traceDeliveries ? await options.traceDeliveries.list() : [],
+    options.auditSinkDeliveries ? await options.auditSinkDeliveries.list() : []
+  ]);
+  return {
+    auditEvents,
+    auditSinkDeliveries,
+    auditStore: createSnapshotAuditStore(auditEvents),
+    capturedAt: Date.now(),
+    traceDeliveries,
+    traceDeliveryStore: createSnapshotTraceDeliveryStore(traceDeliveries),
+    traceEvents,
+    traceStore: createSnapshotTraceStore(traceEvents)
+  };
+};
 var toProofPackStatus = (status) => {
   if (status === "fail" || status === "failed") {
     return "fail";
@@ -40826,12 +40913,14 @@ export {
   createVoiceProofTrendRoutes,
   createVoiceProofTrendRecommendationRoutes,
   createVoiceProofTraceStore,
+  createVoiceProofRefreshSnapshot,
   createVoiceProofPackSupportBundleSection,
   createVoiceProofPackStaleWhileRefreshSource,
   createVoiceProofPackRoutes,
   createVoiceProofPackProviderSloSection,
   createVoiceProofPackProductionReadinessSection,
   createVoiceProofPackOperationsRecordSection,
+  createVoiceProofPackBuildContext,
   createVoiceProofPackArtifacts,
   createVoiceProofAssertion,
   createVoiceProfileTraceTagger,

package/dist/proofPack.d.ts

@@ -1,10 +1,12 @@
 import { Elysia } from 'elysia';
+import { type StoredVoiceAuditEvent, type VoiceAuditEventFilter, type VoiceAuditEventStore } from './audit';
 import type { VoiceObservabilityExportArtifact, VoiceObservabilityExportReport } from './observabilityExport';
 import type { VoiceCallDebuggerReport } from './callDebugger';
 import type { VoiceOperationsRecord } from './operationsRecord';
 import type { VoiceProductionReadinessReport } from './productionReadiness';
 import type { VoiceProviderSloReport } from './providerSlo';
 import type { VoiceSessionSnapshot } from './sessionSnapshot';
+import { type StoredVoiceTraceEvent, type VoiceTraceEventFilter, type VoiceTraceEventStore, type VoiceTraceSinkDeliveryRecord, type VoiceTraceSinkDeliveryStore } from './trace';
 export type VoiceProofPackStatus = 'fail' | 'pass' | 'warn';
 export type VoiceProofPackEvidence = {
     detail?: string;
@@ -53,6 +55,43 @@ export type VoiceProofPackWriteResult = {
     markdownPath: string;
     proofPack: VoiceProofPack;
 };
+export type VoiceProofPackBuildTiming = {
+    durationMs: number;
+    endedAt: number;
+    label: string;
+    startedAt: number;
+};
+export type VoiceProofPackBuildContext = {
+    cache: <TValue>(key: string, loader: () => Promise<TValue> | TValue) => Promise<TValue>;
+    clear: (key?: string) => void;
+    getTimings: () => VoiceProofPackBuildTiming[];
+    time: <TValue>(label: string, run: () => Promise<TValue> | TValue) => Promise<TValue>;
+};
+export type VoiceProofPackBuildContextOptions = {
+    now?: () => number;
+    onTiming?: (timing: VoiceProofPackBuildTiming) => void;
+};
+export type VoiceProofRefreshSnapshotOptions = {
+    audit?: VoiceAuditEventStore;
+    auditFilter?: VoiceAuditEventFilter;
+    auditSinkDeliveries?: {
+        list: () => Promise<unknown[]> | unknown[];
+    };
+    events?: StoredVoiceTraceEvent[];
+    traceDeliveries?: VoiceTraceSinkDeliveryStore;
+    traceFilter?: VoiceTraceEventFilter;
+    traceStore?: VoiceTraceEventStore;
+};
+export type VoiceProofRefreshSnapshot = {
+    auditEvents: StoredVoiceAuditEvent[];
+    auditStore: VoiceAuditEventStore;
+    auditSinkDeliveries: unknown[];
+    capturedAt: number;
+    traceDeliveries: VoiceTraceSinkDeliveryRecord[];
+    traceDeliveryStore: VoiceTraceSinkDeliveryStore;
+    traceEvents: StoredVoiceTraceEvent[];
+    traceStore: VoiceTraceEventStore;
+};
 export type VoiceProofPackSourceValue = VoiceProofPack | VoiceProofPackInput;
 export type VoiceProofPackStaleWhileRefreshSourceOptions = {
     maxAgeMs?: number;
@@ -83,6 +122,8 @@ export type VoiceProofPackRoutesOptions = {
     name?: string;
     source: VoiceProofPackSourceValue | (() => VoiceProofPackSourceValue | Promise<VoiceProofPackSourceValue>);
 };
+export declare const createVoiceProofPackBuildContext: (options?: VoiceProofPackBuildContextOptions) => VoiceProofPackBuildContext;
+export declare const createVoiceProofRefreshSnapshot: (options?: VoiceProofRefreshSnapshotOptions) => Promise<VoiceProofRefreshSnapshot>;
 export declare const createVoiceProofPackProviderSloSection: (report: VoiceProviderSloReport, options?: {
     href?: string;
     title?: string;

package/package.json

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