@absolutejs/voice 0.0.22-beta.213 → 0.0.22-beta.215

package/dist/productionReadiness.d.ts

@@ -12,6 +12,7 @@ import type { VoiceReconnectContractReport } from './reconnectContract';
 import type { VoiceAuditEventStore, VoiceAuditEventType, VoiceAuditOutcome } from './audit';
 import { type VoiceAuditSinkDeliveryStore } from './auditSinks';
 import type { VoiceProviderContractMatrixReport, VoiceProviderStackCapabilityGapReport } from './providerStackRecommendations';
+import { type VoiceProviderSloReport, type VoiceProviderSloReportOptions } from './providerSlo';
 import type { VoiceCampaignReadinessProofReport } from './campaign';
 import { type VoiceOpsRecoveryReport } from './opsRecovery';
 export type VoiceProductionReadinessStatus = 'fail' | 'pass' | 'warn';
@@ -95,6 +96,7 @@ export type VoiceProductionReadinessReport = {
         phoneAgentSmoke?: string;
         providerContracts?: string;
         providerRoutingContracts?: string;
+        providerSlo?: string;
         quality?: string;
         reconnectContracts?: string;
         resilience?: string;
@@ -172,6 +174,12 @@ export type VoiceProductionReadinessReport = {
             status: VoiceProductionReadinessStatus;
             total: number;
         };
+        providerSlo?: {
+            events: number;
+            eventsWithLatency: number;
+            issues: number;
+            status: VoiceProductionReadinessStatus;
+        };
         reconnectContracts?: {
             failed: number;
             passed: number;
@@ -339,6 +347,10 @@ export type VoiceProductionReadinessRoutesOptions = {
         query: Record<string, unknown>;
         request: Request;
     }) => Promise<readonly VoiceProviderRoutingContractReport[]> | readonly VoiceProviderRoutingContractReport[]);
+    providerSlo?: false | VoiceProviderSloReport | VoiceProviderSloReportOptions | ((input: {
+        query: Record<string, unknown>;
+        request: Request;
+    }) => Promise<VoiceProviderSloReport | VoiceProviderSloReportOptions> | VoiceProviderSloReport | VoiceProviderSloReportOptions);
     providerStack?: false | VoiceProviderStackCapabilityGapReport | ((input: {
         query: Record<string, unknown>;
         request: Request;

package/dist/providerSlo.d.ts

@@ -0,0 +1,110 @@
+import { Elysia } from 'elysia';
+import { type VoiceRoutingEvent, type VoiceRoutingEventKind } from './resilienceRoutes';
+import type { StoredVoiceTraceEvent, VoiceTraceEventStore } from './trace';
+export type VoiceProviderSloStatus = 'fail' | 'pass' | 'warn';
+export type VoiceProviderSloThresholds = {
+    maxAverageElapsedMs?: number;
+    maxErrorRate?: number;
+    maxFallbackRate?: number;
+    maxP95ElapsedMs?: number;
+    maxTimeoutRate?: number;
+    minSamples?: number;
+};
+export type VoiceProviderSloThresholdConfig = Partial<Record<VoiceRoutingEventKind, VoiceProviderSloThresholds>>;
+export type VoiceProviderSloMetric = {
+    actual: number;
+    label: string;
+    pass: boolean;
+    threshold: number;
+    unit: 'count' | 'ms' | 'rate';
+};
+export type VoiceProviderSloIssue = {
+    code: string;
+    detail?: string;
+    kind?: VoiceRoutingEventKind;
+    label: string;
+    sessionId?: string;
+    status: Exclude<VoiceProviderSloStatus, 'pass'>;
+    value?: number | string;
+};
+export type VoiceProviderSloKindReport = {
+    events: number;
+    eventsWithLatency: number;
+    fallbacks: number;
+    issues: VoiceProviderSloIssue[];
+    kind: VoiceRoutingEventKind;
+    metrics: Record<string, VoiceProviderSloMetric>;
+    providers: string[];
+    status: VoiceProviderSloStatus;
+    thresholds: Required<VoiceProviderSloThresholds>;
+    timeouts: number;
+    unresolvedErrors: number;
+};
+export type VoiceProviderSloSessionReport = {
+    errorCount: number;
+    fallbackCount: number;
+    kinds: VoiceRoutingEventKind[];
+    lastEventAt: number;
+    maxElapsedMs?: number;
+    sessionId: string;
+    status: VoiceProviderSloStatus;
+    timeoutCount: number;
+};
+export type VoiceProviderSloReport = {
+    checkedAt: number;
+    events: number;
+    eventsWithLatency: number;
+    issues: VoiceProviderSloIssue[];
+    kinds: Record<VoiceRoutingEventKind, VoiceProviderSloKindReport>;
+    sessions: VoiceProviderSloSessionReport[];
+    status: VoiceProviderSloStatus;
+    thresholds: Record<VoiceRoutingEventKind, Required<VoiceProviderSloThresholds>>;
+};
+export type VoiceProviderSloReportOptions = {
+    events?: StoredVoiceTraceEvent[] | VoiceRoutingEvent[];
+    requiredKinds?: readonly VoiceRoutingEventKind[];
+    store?: VoiceTraceEventStore;
+    thresholds?: VoiceProviderSloThresholdConfig;
+};
+export type VoiceProviderSloRoutesOptions = VoiceProviderSloReportOptions & {
+    headers?: HeadersInit;
+    htmlPath?: false | string;
+    markdownPath?: false | string;
+    name?: string;
+    path?: string;
+    render?: (report: VoiceProviderSloReport) => string | Promise<string>;
+    title?: string;
+};
+export declare const buildVoiceProviderSloReport: (options?: VoiceProviderSloReportOptions) => Promise<VoiceProviderSloReport>;
+export declare const renderVoiceProviderSloMarkdown: (report: VoiceProviderSloReport) => string;
+export declare const renderVoiceProviderSloHTML: (report: VoiceProviderSloReport, options?: {
+    title?: string;
+}) => string;
+export declare const createVoiceProviderSloRoutes: (options: VoiceProviderSloRoutesOptions) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/package.json

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