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

package/README.md

@@ -2781,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,
@@ -2819,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)
       };
     }
   }));
@@ -26701,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) {
@@ -26712,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/package.json

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