@absolutejs/voice 0.0.22-beta.226 → 0.0.22-beta.228

package/README.md

@@ -1299,8 +1299,8 @@ app.use(
 Built-in profiles:
 
 - `meeting-recorder`: live latency, session health, provider fallback, routing contracts, reconnect proof, and barge-in interruption proof.
-- `phone-agent`: carrier readiness, phone-agent smoke proof, campaign readiness proof, handoffs, provider routing contracts, audit/trace delivery health, and delivery runtime proof.
-- `ops-heavy`: audit evidence, operator action history, audit/trace delivery health, delivery runtime proof, and deploy-gate support.
+- `phone-agent`: carrier readiness, phone-agent smoke proof, campaign readiness proof, handoffs, provider routing contracts, audit/trace delivery health, customer-owned observability export delivery history, and delivery runtime proof.
+- `ops-heavy`: audit evidence, operator action history, audit/trace delivery health, customer-owned observability export delivery history, delivery runtime proof, and deploy-gate support.
 
 Phone-agent fast path:
 
@@ -1316,6 +1316,11 @@ app.use(
 			carriers: loadCarrierMatrixInputs,
 			deliveryRuntime,
 			explain: true,
+			observabilityExportDeliveryHistory: {
+				store: observabilityExportDeliveryReceipts,
+				maxAgeMs: 60 * 60 * 1000,
+				failOnStale: true
+			},
 			phoneAgentSmokes: async () => [await runPhoneSmoke()],
 			providerRoutingContracts: async () => [await runProviderRoutingContract()],
 			traceDeliveries: runtime.traceDeliveries
@@ -1334,6 +1339,9 @@ app.use(
 			audit: runtime.audit,
 			auditDeliveries: runtime.auditDeliveries,
 			deliveryRuntime,
+			observabilityExportDeliveryHistory: {
+				store: observabilityExportDeliveryReceipts
+			},
 			traceDeliveries: runtime.traceDeliveries
 		}),
 		gate: {
@@ -2773,6 +2781,19 @@ app.use(
 				keyPrefix: 'voice/observability-exports',
 				kind: 's3',
 				label: 'S3 customer-owned observability archive'
+			},
+			{
+				kind: 'sqlite',
+				path: '.voice-runtime/observability-exports.sqlite',
+				tableName: 'voice_observability_exports',
+				label: 'SQLite customer-owned observability warehouse'
+			},
+			{
+				connectionString: process.env.VOICE_OBSERVABILITY_EXPORT_POSTGRES_URL,
+				kind: 'postgres',
+				schemaName: 'voice',
+				tableName: 'observability_exports',
+				label: 'Postgres customer-owned observability warehouse'
 			}
 		],
 		deliveryReceipts: observabilityReceipts,
@@ -2811,7 +2832,7 @@ const exportReport = await buildVoiceObservabilityExport({
 });
 ```
 
-The route helper exposes JSON at `/api/voice/observability-export`, an artifact index at `/api/voice/observability-export/artifacts`, per-artifact downloads at `/api/voice/observability-export/artifacts/:artifactId`, delivery at `POST /api/voice/observability-export/deliveries`, delivery history at `GET /api/voice/observability-export/deliveries`, Markdown at `/voice/observability-export.md`, and HTML at `/voice/observability-export`. Path-backed artifacts are hashed with SHA-256 by default, include byte size and freshness metadata, and can fail the export when required evidence is missing or stale. File delivery writes `manifest.json`, `artifact-index.json`, and artifact files into a customer-owned archive directory; webhook delivery posts the manifest and artifact index to a buyer-owned collector, SIEM bridge, or warehouse endpoint; S3 delivery writes the same manifest, index, and artifact files through Bun's native S3 client. Delivery receipt stores persist run id, destinations, status, and target history so operators can prove exports have been continuously healthy. Failed trace/audit deliveries fail the export report, pending deliveries warn, and every trace/audit envelope includes the linked operations-record URL when one is configured. This is the primitive to use when customers ask how voice evidence leaves the app without going through a hosted vendor dashboard.
+The route helper exposes JSON at `/api/voice/observability-export`, an artifact index at `/api/voice/observability-export/artifacts`, per-artifact downloads at `/api/voice/observability-export/artifacts/:artifactId`, delivery at `POST /api/voice/observability-export/deliveries`, delivery history at `GET /api/voice/observability-export/deliveries`, Markdown at `/voice/observability-export.md`, and HTML at `/voice/observability-export`. Path-backed artifacts are hashed with SHA-256 by default, include byte size and freshness metadata, and can fail the export when required evidence is missing or stale. File delivery writes `manifest.json`, `artifact-index.json`, and artifact files into a customer-owned archive directory; webhook delivery posts the manifest and artifact index to a buyer-owned collector, SIEM bridge, or warehouse endpoint; S3 delivery writes the same manifest, index, and artifact files through Bun's native S3 client; SQLite and Postgres delivery persist the manifest, artifact index, checksum metadata, status, run id, and timestamps into buyer-owned database tables. Delivery receipt stores persist run id, destinations, status, and target history so operators can prove exports have been continuously healthy. Failed trace/audit deliveries fail the export report, pending deliveries warn, and every trace/audit envelope includes the linked operations-record URL when one is configured. This is the primitive to use when customers ask how voice evidence leaves the app without going through a hosted vendor dashboard.
 
 Pass the same report into production readiness when export health should block deploys:
 

package/dist/index.js

@@ -22448,6 +22448,7 @@ var createVoiceOpsRecoveryRoutes = (options = {}) => {
 
 // src/observabilityExport.ts
 import { Elysia as Elysia39 } from "elysia";
+import { Database } from "bun:sqlite";
 import { createHash } from "crypto";
 import { mkdir as mkdir4, readFile as readFile2, stat, unlink } from "fs/promises";
 import { join as join3 } from "path";
@@ -23038,6 +23039,116 @@ var writeS3Object = async (input) => {
     type: input.contentType
   });
 };
+var quoteObservabilityIdentifier = (value) => `"${value.replace(/"/g, '""')}"`;
+var normalizeObservabilityIdentifier = (value) => value?.trim().replace(/[^a-zA-Z0-9_]+/g, "_").replace(/^_+|_+$/g, "") || "voice_observability_exports";
+var buildObservabilityExportDatabaseRecord = (input) => ({
+  artifactCount: input.artifactIndex.summary.total,
+  artifactIndex: input.artifactIndex,
+  checkedAt: input.checkedAt,
+  exportStatus: input.report.status,
+  manifest: input.report,
+  runId: input.runId,
+  status: input.report.status
+});
+var deliverObservabilityExportToSQLite = async (input) => {
+  if (!input.destination.database && !input.destination.path) {
+    throw new Error("SQLite observability export delivery requires destination.database or destination.path.");
+  }
+  const database = input.destination.database ?? new Database(input.destination.path, { create: true });
+  const table = quoteObservabilityIdentifier(normalizeObservabilityIdentifier(input.destination.tableName));
+  const record = buildObservabilityExportDatabaseRecord(input);
+  database.exec(`CREATE TABLE IF NOT EXISTS ${table} (
+			run_id TEXT PRIMARY KEY,
+			checked_at INTEGER NOT NULL,
+			status TEXT NOT NULL,
+			export_status TEXT NOT NULL,
+			artifact_count INTEGER NOT NULL,
+			manifest_json TEXT NOT NULL,
+			artifact_index_json TEXT NOT NULL,
+			payload_json TEXT NOT NULL
+		)`);
+  database.query(`INSERT INTO ${table}
+			 (run_id, checked_at, status, export_status, artifact_count, manifest_json, artifact_index_json, payload_json)
+			 VALUES ($runId, $checkedAt, $status, $exportStatus, $artifactCount, $manifest, $artifactIndex, $payload)
+			 ON CONFLICT(run_id) DO UPDATE SET
+				checked_at = excluded.checked_at,
+				status = excluded.status,
+				export_status = excluded.export_status,
+				artifact_count = excluded.artifact_count,
+				manifest_json = excluded.manifest_json,
+				artifact_index_json = excluded.artifact_index_json,
+				payload_json = excluded.payload_json`).run({
+    $artifactCount: input.artifactIndex.summary.total,
+    $artifactIndex: input.index,
+    $checkedAt: input.checkedAt,
+    $exportStatus: input.report.status,
+    $manifest: input.manifest,
+    $payload: JSON.stringify(record),
+    $runId: input.runId,
+    $status: input.report.status
+  });
+  return input.destination.path ? `sqlite://${input.destination.path}/${table.replaceAll('"', "")}` : `sqlite://memory/${table.replaceAll('"', "")}`;
+};
+var deliverObservabilityExportToPostgres = async (input) => {
+  const sql = input.destination.sql ?? (input.destination.connectionString ? (() => {
+    const client = new Bun.SQL(input.destination.connectionString);
+    return { unsafe: client.unsafe.bind(client) };
+  })() : undefined);
+  if (!sql) {
+    throw new Error("Postgres observability export delivery requires destination.sql or destination.connectionString.");
+  }
+  const schema = normalizeObservabilityIdentifier(input.destination.schemaName ?? "public");
+  const table = normalizeObservabilityIdentifier(input.destination.tableName);
+  const qualifiedTable = `${quoteObservabilityIdentifier(schema)}.${quoteObservabilityIdentifier(table)}`;
+  const record = buildObservabilityExportDatabaseRecord(input);
+  await sql.unsafe(`CREATE SCHEMA IF NOT EXISTS ${quoteObservabilityIdentifier(schema)}`);
+  await sql.unsafe(`CREATE TABLE IF NOT EXISTS ${qualifiedTable} (
+			run_id TEXT PRIMARY KEY,
+			checked_at BIGINT NOT NULL,
+			status TEXT NOT NULL,
+			export_status TEXT NOT NULL,
+			artifact_count INTEGER NOT NULL,
+			manifest_json JSONB NOT NULL,
+			artifact_index_json JSONB NOT NULL,
+			payload JSONB NOT NULL
+		)`);
+  await sql.unsafe(`INSERT INTO ${qualifiedTable}
+		 (run_id, checked_at, status, export_status, artifact_count, manifest_json, artifact_index_json, payload)
+		 VALUES ($1, $2, $3, $4, $5, $6::jsonb, $7::jsonb, $8::jsonb)
+		 ON CONFLICT (run_id) DO UPDATE SET
+			checked_at = EXCLUDED.checked_at,
+			status = EXCLUDED.status,
+			export_status = EXCLUDED.export_status,
+			artifact_count = EXCLUDED.artifact_count,
+			manifest_json = EXCLUDED.manifest_json,
+			artifact_index_json = EXCLUDED.artifact_index_json,
+			payload = EXCLUDED.payload`, [
+    input.runId,
+    input.checkedAt,
+    input.report.status,
+    input.report.status,
+    input.artifactIndex.summary.total,
+    input.manifest,
+    input.index,
+    JSON.stringify(record)
+  ]);
+  return `postgres://${schema}/${table}`;
+};
+var observabilityExportDeliveryFailureTarget = (destination) => {
+  if (destination.kind === "file") {
+    return destination.directory;
+  }
+  if (destination.kind === "s3") {
+    return destination.bucket ? `s3://${destination.bucket}/${normalizeExportS3KeyPrefix(destination.keyPrefix)}` : normalizeExportS3KeyPrefix(destination.keyPrefix);
+  }
+  if (destination.kind === "sqlite") {
+    return destination.path ?? "sqlite://memory";
+  }
+  if (destination.kind === "postgres") {
+    return destination.connectionString ?? "postgres://configured-client";
+  }
+  return destination.url;
+};
 var createVoiceMemoryObservabilityExportDeliveryReceiptStore = () => {
   const receipts = new Map;
   return {
@@ -23437,7 +23548,7 @@ var deliverVoiceObservabilityExport = async (options) => {
 `;
   const destinations = await Promise.all(options.destinations.map(async (destination) => {
     const destinationId = destination.id ?? `${destination.kind}-${destination.label ?? "export"}`;
-    const label = destination.label ?? (destination.kind === "file" ? "File observability export" : "Webhook observability export");
+    const label = destination.label ?? (destination.kind === "file" ? "File observability export" : destination.kind === "s3" ? "S3 observability export" : destination.kind === "sqlite" ? "SQLite observability export" : destination.kind === "postgres" ? "Postgres observability export" : "Webhook observability export");
     try {
       if (destination.kind === "file") {
         const target = join3(destination.directory, runId);
@@ -23507,6 +23618,48 @@ var deliverVoiceObservabilityExport = async (options) => {
           target: destination.bucket ? `s3://${destination.bucket}/${rootKey}` : rootKey
         };
       }
+      if (destination.kind === "sqlite") {
+        const target = await deliverObservabilityExportToSQLite({
+          artifactIndex,
+          checkedAt,
+          destination,
+          index,
+          manifest,
+          report: options.report,
+          runId
+        });
+        return {
+          artifactCount: artifactIndex.summary.total,
+          deliveredAt: Date.now(),
+          destinationId,
+          destinationKind: destination.kind,
+          label,
+          manifestBytes: byteLength(manifest),
+          status: "delivered",
+          target
+        };
+      }
+      if (destination.kind === "postgres") {
+        const target = await deliverObservabilityExportToPostgres({
+          artifactIndex,
+          checkedAt,
+          destination,
+          index,
+          manifest,
+          report: options.report,
+          runId
+        });
+        return {
+          artifactCount: artifactIndex.summary.total,
+          deliveredAt: Date.now(),
+          destinationId,
+          destinationKind: destination.kind,
+          label,
+          manifestBytes: byteLength(manifest),
+          status: "delivered",
+          target
+        };
+      }
       const controller = new AbortController;
       const timeout = setTimeout(() => controller.abort(), destination.timeoutMs ?? 1e4);
       try {
@@ -23551,7 +23704,7 @@ var deliverVoiceObservabilityExport = async (options) => {
         label,
         manifestBytes: byteLength(manifest),
         status: "failed",
-        target: destination.kind === "file" ? destination.directory : destination.kind === "s3" ? destination.bucket ? `s3://${destination.bucket}/${normalizeExportS3KeyPrefix(destination.keyPrefix)}` : normalizeExportS3KeyPrefix(destination.keyPrefix) : destination.url
+        target: observabilityExportDeliveryFailureTarget(destination)
       };
     }
   }));
@@ -24908,6 +25061,7 @@ var profileSurfaceLabels = {
     audit: "audit evidence configured",
     auditDeliveries: "audit delivery queue configured",
     deliveryRuntime: "delivery runtime configured",
+    observabilityExportDeliveryHistory: "observability export delivery history configured",
     opsActionHistory: "operator action history configured",
     traceDeliveries: "trace delivery queue configured"
   },
@@ -24916,6 +25070,7 @@ var profileSurfaceLabels = {
     campaignReadiness: "campaign readiness proof configured",
     carriers: "carrier readiness configured",
     deliveryRuntime: "delivery runtime configured",
+    observabilityExportDeliveryHistory: "observability export delivery history configured",
     phoneAgentSmokes: "phone-agent smoke proof configured",
     providerRoutingContracts: "provider routing contracts configured",
     traceDeliveries: "trace delivery queue configured"
@@ -24932,6 +25087,7 @@ var profileRequiredKeys = {
     "opsActionHistory",
     "auditDeliveries",
     "traceDeliveries",
+    "observabilityExportDeliveryHistory",
     "deliveryRuntime"
   ],
   "phone-agent": [
@@ -24941,6 +25097,7 @@ var profileRequiredKeys = {
     "providerRoutingContracts",
     "auditDeliveries",
     "traceDeliveries",
+    "observabilityExportDeliveryHistory",
     "deliveryRuntime"
   ]
 };
@@ -24953,6 +25110,7 @@ var configuredProfileKeys = (options) => {
     "campaignReadiness",
     "carriers",
     "deliveryRuntime",
+    "observabilityExportDeliveryHistory",
     "opsActionHistory",
     "phoneAgentSmokes",
     "providerRoutingContracts",
@@ -25071,6 +25229,12 @@ var profileExplanation = (profile, options, links) => {
           key: "deliveryRuntime",
           label: "Delivery runtime"
         },
+        {
+          configured: isConfigured(options.observabilityExportDeliveryHistory),
+          href: links.observabilityExportDeliveries,
+          key: "observabilityExportDeliveryHistory",
+          label: "Observability export delivery"
+        },
         {
           configured: isConfigured(options.auditDeliveries),
           href: links.auditDeliveries,
@@ -25109,6 +25273,12 @@ var profileExplanation = (profile, options, links) => {
         key: "deliveryRuntime",
         label: "Delivery runtime"
       },
+      {
+        configured: isConfigured(options.observabilityExportDeliveryHistory),
+        href: links.observabilityExportDeliveries,
+        key: "observabilityExportDeliveryHistory",
+        label: "Observability export delivery"
+      },
       {
         configured: isConfigured(options.auditDeliveries),
         href: links.auditDeliveries,
@@ -25152,6 +25322,7 @@ var createVoiceReadinessProfile = (profile, options = {}) => {
       carriers: "/carriers",
       deliveryRuntime: "/delivery-runtime",
       handoffs: "/handoffs",
+      observabilityExportDeliveries: "/api/voice/observability-export/deliveries",
       phoneAgentSmoke: "/sessions",
       providerRoutingContracts: "/resilience",
       resilience: "/resilience",
@@ -25165,6 +25336,7 @@ var createVoiceReadinessProfile = (profile, options = {}) => {
       deliveryRuntime: options.deliveryRuntime,
       gate: options.gate,
       links: links2,
+      observabilityExportDeliveryHistory: options.observabilityExportDeliveryHistory,
       phoneAgentSmokes: options.phoneAgentSmokes,
       profile: profileExplanation(profile, options, links2),
       proofSources: options.proofSources,
@@ -25177,6 +25349,7 @@ var createVoiceReadinessProfile = (profile, options = {}) => {
     audit: "/audit",
     auditDeliveries: "/audit/deliveries",
     deliveryRuntime: "/delivery-runtime",
+    observabilityExportDeliveries: "/api/voice/observability-export/deliveries",
     opsActions: "/voice/ops-actions",
     traceDeliveries: "/traces/deliveries"
   }, options.links);
@@ -25186,6 +25359,7 @@ var createVoiceReadinessProfile = (profile, options = {}) => {
     deliveryRuntime: options.deliveryRuntime,
     gate: options.gate,
     links,
+    observabilityExportDeliveryHistory: options.observabilityExportDeliveryHistory,
     opsActionHistory,
     profile: profileExplanation(profile, options, links),
     proofSources: options.proofSources,
@@ -26680,7 +26854,7 @@ var createVoiceTraceDeliveryRoutes = (options) => {
   return routes;
 };
 // src/sqliteStore.ts
-import { Database } from "bun:sqlite";
+import { Database as Database2 } from "bun:sqlite";
 var normalizeTableNameSegment = (value) => value.trim().replace(/[^a-zA-Z0-9_]+/g, "_").replace(/^_+|_+$/g, "") || "voice";
 var resolveTableName = (input) => {
   if (input.options.tableName) {
@@ -26691,7 +26865,7 @@ var resolveTableName = (input) => {
   return `${prefix}_${fallback}`;
 };
 var openVoiceSQLiteDatabase = (path) => {
-  const database = new Database(path, {
+  const database = new Database2(path, {
     create: true
   });
   database.exec("PRAGMA journal_mode = WAL;");

package/dist/observabilityExport.d.ts

@@ -1,10 +1,12 @@
 import { Elysia } from 'elysia';
 import type { S3Client, S3Options } from 'bun';
+import { Database } from 'bun:sqlite';
 import { type VoiceAuditSinkDeliveryQueueSummary, type VoiceAuditSinkDeliveryRecord, type VoiceAuditSinkDeliveryStore } from './auditSinks';
 import type { VoiceAuditEventStore, VoiceAuditEventType } from './audit';
 import { type VoiceOperationsRecord } from './operationsRecord';
 import { type VoiceTraceSinkDeliveryQueueSummary } from './queue';
 import { type StoredVoiceTraceEvent, type VoiceTraceEventStore, type VoiceTraceEventType, type VoiceTraceRedactionConfig, type VoiceTraceSinkDeliveryRecord, type VoiceTraceSinkDeliveryStore, type VoiceTraceSummary } from './trace';
+import type { VoicePostgresClient } from './postgresStore';
 export type VoiceObservabilityExportStatus = 'fail' | 'pass' | 'warn';
 export type VoiceObservabilityExportArtifactKind = 'incident' | 'markdown' | 'operations-record' | 'proof-pack' | 'readiness' | 'screenshot' | 'slo' | 'trace' | 'audit' | 'custom';
 export type VoiceObservabilityExportArtifactChecksum = {
@@ -123,6 +125,21 @@ export type VoiceObservabilityExportDeliveryDestination = {
     kind: 's3';
     label?: string;
 }) | {
+    database?: Database;
+    id?: string;
+    kind: 'sqlite';
+    label?: string;
+    path?: string;
+    tableName?: string;
+} | {
+    connectionString?: string;
+    id?: string;
+    kind: 'postgres';
+    label?: string;
+    schemaName?: string;
+    sql?: VoicePostgresClient;
+    tableName?: string;
+} | {
     fetch?: typeof fetch;
     headers?: Record<string, string>;
     id?: string;

package/dist/readinessProfiles.d.ts

@@ -10,6 +10,7 @@ export type VoiceReadinessProfileOptions = {
     explain?: boolean;
     gate?: VoiceProductionReadinessRoutesOptions['gate'];
     links?: VoiceProductionReadinessRoutesOptions['links'];
+    observabilityExportDeliveryHistory?: VoiceProductionReadinessRoutesOptions['observabilityExportDeliveryHistory'];
     opsActionHistory?: VoiceProductionReadinessOpsActionHistoryOptions;
     phoneAgentSmokes?: VoiceProductionReadinessRoutesOptions['phoneAgentSmokes'];
     proofSources?: VoiceProductionReadinessRoutesOptions['proofSources'];

package/package.json

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