@absolutejs/voice 0.0.22-beta.413 → 0.0.22-beta.415

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, createVoiceProofPackArtifacts, createVoiceProofPackOperationsRecordSection, createVoiceProofPackProductionReadinessSection, createVoiceProofPackProviderSloSection, createVoiceProofPackRoutes, createVoiceProofPackSupportBundleSection, renderVoiceProofPackMarkdown, writeVoiceProofPack } from './proofPack';
-export type { VoiceProofPack, VoiceProofPackEvidence, VoiceProofPackInput, VoiceProofPackRoutesOptions, VoiceProofPackSection, VoiceProofPackStatus, VoiceProofPackWriteResult } from './proofPack';
+export { buildVoiceProofPack, buildVoiceProofPackFromObservabilityExport, createVoiceProofPackStaleWhileRefreshSource, createVoiceProofPackArtifacts, createVoiceProofPackOperationsRecordSection, createVoiceProofPackProductionReadinessSection, createVoiceProofPackProviderSloSection, createVoiceProofPackRoutes, createVoiceProofPackSupportBundleSection, renderVoiceProofPackMarkdown, writeVoiceProofPack } from './proofPack';
+export type { VoiceProofPack, VoiceProofPackEvidence, VoiceProofPackInput, VoiceProofPackRoutesOptions, VoiceProofPackSection, VoiceProofPackSourceValue, VoiceProofPackStatus, VoiceProofPackStaleWhileRefreshSourceOptions, VoiceProofPackWriteResult } from './proofPack';
 export * from './types';

package/dist/index.js

@@ -32434,6 +32434,7 @@ var assertVoiceObservabilityExportRecord = (input, options) => {
   }
   return result;
 };
+var resolveVoiceObservabilityArtifactIndex = async (source) => typeof source === "function" ? await source() : source;
 var isDeliveryStore = (value) => !Array.isArray(value) && typeof value.list === "function";
 var getString18 = (value) => typeof value === "string" ? value : undefined;
 var getProviderKind = (payload) => getString18(payload.kind) ?? getString18(payload.providerKind);
@@ -33619,7 +33620,7 @@ var createVoiceObservabilityExportRoutes = (options = {}) => {
   });
   app.get(path, async () => Response.json(await buildReport(), { headers }));
   if (artifactIndexPath !== false) {
-    app.get(artifactIndexPath, async () => Response.json(buildVoiceObservabilityArtifactIndex(await buildReport()), { headers }));
+    app.get(artifactIndexPath, async () => Response.json(options.artifactIndex ? await resolveVoiceObservabilityArtifactIndex(options.artifactIndex) : buildVoiceObservabilityArtifactIndex(await buildReport()), { headers }));
   }
   if (artifactDownloadPath !== false) {
     app.get(`${artifactDownloadPath}/:artifactId`, async ({ params }) => {
@@ -39951,6 +39952,11 @@ import { Elysia as Elysia66 } from "elysia";
 import { mkdir as mkdir5 } from "fs/promises";
 import { dirname as dirname3, join as join4 } from "path";
 var toGeneratedAt = (value) => value === undefined ? new Date().toISOString() : typeof value === "number" ? new Date(value).toISOString() : value;
+var getProofPackGeneratedAtMs = (proofPack) => {
+  const generatedAt = buildVoiceProofPack(proofPack).generatedAt;
+  const generatedAtMs = Date.parse(generatedAt);
+  return Number.isFinite(generatedAtMs) ? generatedAtMs : 0;
+};
 var summarizeProofPackSections = (sections) => {
   let pass = 0;
   let warn = 0;
@@ -40162,6 +40168,34 @@ var buildVoiceProofPack = (input) => {
     summary
   };
 };
+var createVoiceProofPackStaleWhileRefreshSource = (options) => {
+  const maxAgeMs = options.maxAgeMs ?? 5 * 60000;
+  const now = options.now ?? Date.now;
+  let refreshPromise;
+  const refresh = async () => {
+    const refreshed = await options.refresh();
+    return refreshed ?? options.read();
+  };
+  const startRefresh = () => {
+    refreshPromise ??= refresh().finally(() => {
+      refreshPromise = undefined;
+    });
+    return refreshPromise;
+  };
+  return async () => {
+    let current;
+    try {
+      current = await options.read();
+    } catch {
+      return startRefresh();
+    }
+    if (now() - getProofPackGeneratedAtMs(current) <= maxAgeMs) {
+      return current;
+    }
+    startRefresh().catch((error) => options.onRefreshError?.(error));
+    return current;
+  };
+};
 var buildVoiceProofPackFromObservabilityExport = (report, input = {}) => buildVoiceProofPack({
   ...input,
   artifacts: report.artifacts,
@@ -40724,6 +40758,7 @@ export {
   createVoiceProofTrendRecommendationRoutes,
   createVoiceProofTraceStore,
   createVoiceProofPackSupportBundleSection,
+  createVoiceProofPackStaleWhileRefreshSource,
   createVoiceProofPackRoutes,
   createVoiceProofPackProviderSloSection,
   createVoiceProofPackProductionReadinessSection,

package/dist/observabilityExport.d.ts

@@ -399,6 +399,7 @@ export type VoiceObservabilityExportOptions = {
 export type VoiceObservabilityExportRoutesOptions = VoiceObservabilityExportOptions & {
     headers?: HeadersInit;
     artifactDownloadPath?: false | string;
+    artifactIndex?: VoiceObservabilityExportArtifactIndex | (() => VoiceObservabilityExportArtifactIndex | Promise<VoiceObservabilityExportArtifactIndex>);
     artifactIndexPath?: false | string;
     deliveryDestinations?: VoiceObservabilityExportDeliveryDestination[];
     deliveryPath?: false | string;

package/dist/proofPack.d.ts

@@ -53,12 +53,20 @@ export type VoiceProofPackWriteResult = {
     markdownPath: string;
     proofPack: VoiceProofPack;
 };
+export type VoiceProofPackSourceValue = VoiceProofPack | VoiceProofPackInput;
+export type VoiceProofPackStaleWhileRefreshSourceOptions = {
+    maxAgeMs?: number;
+    now?: () => number;
+    onRefreshError?: (error: unknown) => void;
+    read: () => VoiceProofPackSourceValue | Promise<VoiceProofPackSourceValue>;
+    refresh: () => VoiceProofPackSourceValue | void | Promise<VoiceProofPackSourceValue | void>;
+};
 export type VoiceProofPackRoutesOptions = {
     headers?: HeadersInit;
     jsonPath?: false | string;
     markdownPath?: false | string;
     name?: string;
-    source: VoiceProofPack | VoiceProofPackInput | (() => VoiceProofPack | VoiceProofPackInput | Promise<VoiceProofPack | VoiceProofPackInput>);
+    source: VoiceProofPackSourceValue | (() => VoiceProofPackSourceValue | Promise<VoiceProofPackSourceValue>);
 };
 export declare const createVoiceProofPackProviderSloSection: (report: VoiceProviderSloReport, options?: {
     href?: string;
@@ -77,6 +85,7 @@ export declare const createVoiceProofPackSupportBundleSection: (input: {
     title?: string;
 }) => VoiceProofPackSection;
 export declare const buildVoiceProofPack: (input: VoiceProofPackInput | VoiceProofPack) => VoiceProofPack;
+export declare const createVoiceProofPackStaleWhileRefreshSource: (options: VoiceProofPackStaleWhileRefreshSourceOptions) => () => Promise<VoiceProofPackSourceValue>;
 export declare const buildVoiceProofPackFromObservabilityExport: (report: VoiceObservabilityExportReport, input?: Omit<VoiceProofPackInput, "artifacts" | "sections">) => VoiceProofPack;
 export declare const renderVoiceProofPackMarkdown: (proofPack: VoiceProofPack) => string;
 export declare const writeVoiceProofPack: (input: VoiceProofPackInput | VoiceProofPack, options?: {

package/package.json

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