@absolutejs/voice 0.0.22-beta.143 → 0.0.22-beta.145

package/dist/deliverySinkRoutes.d.ts

@@ -9,6 +9,29 @@ export type VoiceDeliverySinkDescriptor = {
     id: string;
     kind: VoiceDeliverySinkKind;
     label: string;
+    mode?: string;
+    target?: string;
+};
+export type VoiceDeliverySinkDescriptorInput = {
+    description?: string;
+    href?: string;
+    id?: string;
+    kind: VoiceDeliverySinkKind;
+    label?: string;
+    mode?: string;
+    target?: string;
+};
+export type VoiceDeliverySinkPairOptions = {
+    auditHref?: string;
+    auditId?: string;
+    auditLabel?: string;
+    description?: string;
+    kind: VoiceDeliverySinkKind;
+    mode?: string;
+    target?: string;
+    traceHref?: string;
+    traceId?: string;
+    traceLabel?: string;
 };
 export type VoiceDeliverySinkReport = {
     auditDeliveries?: VoiceTraceDeliverySinkSurface<VoiceAuditSinkDeliveryQueueSummary>;
@@ -41,6 +64,13 @@ export type VoiceDeliverySinkRoutesOptions = {
         store: VoiceTraceSinkDeliveryStore;
     };
 };
+export declare const createVoiceDeliverySinkDescriptor: (input: VoiceDeliverySinkDescriptorInput) => VoiceDeliverySinkDescriptor;
+export declare const createVoiceFileDeliverySink: (input?: Omit<VoiceDeliverySinkDescriptorInput, "kind">) => VoiceDeliverySinkDescriptor;
+export declare const createVoiceWebhookDeliverySink: (input?: Omit<VoiceDeliverySinkDescriptorInput, "kind">) => VoiceDeliverySinkDescriptor;
+export declare const createVoiceS3DeliverySink: (input?: Omit<VoiceDeliverySinkDescriptorInput, "kind">) => VoiceDeliverySinkDescriptor;
+export declare const createVoicePostgresDeliverySink: (input?: Omit<VoiceDeliverySinkDescriptorInput, "kind">) => VoiceDeliverySinkDescriptor;
+export declare const createVoiceSQLiteDeliverySink: (input?: Omit<VoiceDeliverySinkDescriptorInput, "kind">) => VoiceDeliverySinkDescriptor;
+export declare const createVoiceDeliverySinkPair: (options: VoiceDeliverySinkPairOptions) => VoiceDeliverySinkDescriptor[];
 export declare const buildVoiceDeliverySinkReport: (options: VoiceDeliverySinkRoutesOptions) => Promise<VoiceDeliverySinkReport>;
 export declare const renderVoiceDeliverySinkHTML: (report: VoiceDeliverySinkReport, options?: {
     title?: string;

package/dist/index.d.ts

@@ -12,11 +12,11 @@ export { createVoiceBargeInRoutes, renderVoiceBargeInHTML, summarizeVoiceBargeIn
 export { createVoiceReconnectContractRoutes, renderVoiceReconnectContractHTML, summarizeVoiceReconnectContractSnapshots, runVoiceReconnectContract } from './reconnectContract';
 export { buildVoiceDiagnosticsMarkdown, createVoiceDiagnosticsRoutes, resolveVoiceDiagnosticsTraceFilter } from './diagnosticsRoutes';
 export { buildVoiceDemoReadyReport, createVoiceDemoReadyRoutes, renderVoiceDemoReadyHTML } from './demoReadyRoutes';
-export { buildVoiceDeliverySinkReport, createVoiceDeliverySinkRoutes, renderVoiceDeliverySinkHTML } from './deliverySinkRoutes';
+export { buildVoiceDeliverySinkReport, createVoiceDeliverySinkDescriptor, createVoiceDeliverySinkPair, createVoiceDeliverySinkRoutes, createVoiceFileDeliverySink, createVoicePostgresDeliverySink, createVoiceS3DeliverySink, createVoiceSQLiteDeliverySink, createVoiceWebhookDeliverySink, renderVoiceDeliverySinkHTML } from './deliverySinkRoutes';
 export { applyVoiceDataRetentionPolicy, buildVoiceDataRetentionPlan } from './dataControl';
 export type { VoiceDataRetentionPolicy, VoiceDataRetentionReport, VoiceDataRetentionScope, VoiceDataRetentionScopeReport, VoiceDataRetentionStores } from './dataControl';
 export type { VoiceDemoReadyReport, VoiceDemoReadyRoutesOptions, VoiceDemoReadySection, VoiceDemoReadyStatus } from './demoReadyRoutes';
-export type { VoiceDeliverySinkDescriptor, VoiceDeliverySinkKind, VoiceDeliverySinkReport, VoiceDeliverySinkRoutesOptions, VoiceTraceDeliverySinkSurface } from './deliverySinkRoutes';
+export type { VoiceDeliverySinkDescriptor, VoiceDeliverySinkDescriptorInput, VoiceDeliverySinkKind, VoiceDeliverySinkPairOptions, VoiceDeliverySinkReport, VoiceDeliverySinkRoutesOptions, VoiceTraceDeliverySinkSurface } from './deliverySinkRoutes';
 export { compareVoiceEvalBaseline, createVoiceFileEvalBaselineStore, createVoiceFileScenarioFixtureStore, createVoiceEvalRoutes, renderVoiceEvalBaselineHTML, renderVoiceEvalHTML, renderVoiceScenarioEvalHTML, renderVoiceScenarioFixtureEvalHTML, runVoiceScenarioEvals, runVoiceScenarioFixtureEvals, runVoiceSessionEvals } from './evalRoutes';
 export { createVoiceSimulationSuiteRoutes, renderVoiceSimulationSuiteHTML, runVoiceSimulationSuite } from './simulationSuite';
 export { createVoiceWorkflowContract, createVoiceWorkflowContractHandler, createVoiceWorkflowContractPreset, createVoiceWorkflowScenario, recordVoiceWorkflowContractTrace, validateVoiceWorkflowRouteResult } from './workflowContract';

package/dist/index.js

@@ -11348,6 +11348,56 @@ var rollupDeliverySinkStatus = (report) => {
   ];
   return statuses.includes("fail") ? "fail" : statuses.includes("warn") ? "warn" : "pass";
 };
+var deliverySinkLabel = (kind) => `${String(kind).replaceAll(/[-_]+/g, " ")} sink`;
+var createVoiceDeliverySinkDescriptor = (input) => ({
+  description: input.description,
+  href: input.href,
+  id: input.id ?? `${input.kind}-sink`,
+  kind: input.kind,
+  label: input.label ?? deliverySinkLabel(input.kind),
+  mode: input.mode,
+  target: input.target
+});
+var createVoiceFileDeliverySink = (input = {}) => createVoiceDeliverySinkDescriptor({
+  ...input,
+  kind: "file"
+});
+var createVoiceWebhookDeliverySink = (input = {}) => createVoiceDeliverySinkDescriptor({
+  ...input,
+  kind: "webhook"
+});
+var createVoiceS3DeliverySink = (input = {}) => createVoiceDeliverySinkDescriptor({
+  ...input,
+  kind: "s3"
+});
+var createVoicePostgresDeliverySink = (input = {}) => createVoiceDeliverySinkDescriptor({
+  ...input,
+  kind: "postgres"
+});
+var createVoiceSQLiteDeliverySink = (input = {}) => createVoiceDeliverySinkDescriptor({
+  ...input,
+  kind: "sqlite"
+});
+var createVoiceDeliverySinkPair = (options) => [
+  createVoiceDeliverySinkDescriptor({
+    description: options.description,
+    href: options.auditHref,
+    id: options.auditId ?? `${options.kind}-audit-sink`,
+    kind: options.kind,
+    label: options.auditLabel ?? `${deliverySinkLabel(options.kind)} audit`,
+    mode: options.mode,
+    target: options.target
+  }),
+  createVoiceDeliverySinkDescriptor({
+    description: options.description,
+    href: options.traceHref,
+    id: options.traceId ?? `${options.kind}-trace-sink`,
+    kind: options.kind,
+    label: options.traceLabel ?? `${deliverySinkLabel(options.kind)} trace`,
+    mode: options.mode,
+    target: options.target
+  })
+];
 var buildVoiceDeliverySinkReport = async (options) => {
   const [auditSummary, traceSummary] = await Promise.all([
     options.auditDeliveries ? Promise.resolve(options.auditDeliveries.store.list()).then((deliveries) => summarizeVoiceAuditSinkDeliveries(deliveries)) : undefined,
@@ -11382,11 +11432,14 @@ var renderSurfaceCard = (surface) => {
 };
 var renderVoiceDeliverySinkHTML = (report, options = {}) => {
   const title = options.title ?? "AbsoluteJS Voice Delivery Sinks";
-  const sinks = report.sinks.length ? report.sinks.map((sink) => `<article><span>${escapeHtml14(sink.kind)}</span><strong style="font-size:1.5rem">${escapeHtml14(sink.label)}</strong>${sink.description ? `<p class="muted">${escapeHtml14(sink.description)}</p>` : ""}${sink.href ? `<p><a href="${escapeHtml14(sink.href)}">Open sink</a></p>` : ""}</article>`).join("") : '<article><span>Sink</span><strong style="font-size:1.5rem">Not described</strong><p class="muted">Pass sink descriptors to document your file, webhook, S3, SQLite, or Postgres targets.</p></article>';
+  const sinks = report.sinks.length ? report.sinks.map((sink) => `<article><span>${escapeHtml14(sink.kind)}</span><strong style="font-size:1.5rem">${escapeHtml14(sink.label)}</strong>${sink.description ? `<p class="muted">${escapeHtml14(sink.description)}</p>` : ""}${sink.mode ? `<p class="muted">Mode: ${escapeHtml14(sink.mode)}</p>` : ""}${sink.target ? `<p class="muted">Target: <code>${escapeHtml14(sink.target)}</code></p>` : ""}${sink.href ? `<p><a href="${escapeHtml14(sink.href)}">Open sink</a></p>` : ""}</article>`).join("") : '<article><span>Sink</span><strong style="font-size:1.5rem">Not described</strong><p class="muted">Pass sink descriptors to document your file, webhook, S3, SQLite, or Postgres targets.</p></article>';
   return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml14(title)}</title><style>body{background:#11120d;color:#fbf7e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{max-width:1120px;margin:auto;padding:32px}a{color:#fde68a;text-decoration:none}.hero{background:linear-gradient(135deg,rgba(253,230,138,.2),rgba(34,197,94,.14));border:1px solid #3a3420;border-radius:30px;margin-bottom:18px;padding:28px}.eyebrow{color:#fde68a;font-weight:900;letter-spacing:.12em;text-transform:uppercase}h1{font-size:clamp(2.4rem,6vw,4.8rem);line-height:.9;margin:.2rem 0 1rem}.status{border:1px solid #575030;border-radius:999px;display:inline-flex;font-weight:900;padding:8px 12px}.status.pass{border-color:rgba(34,197,94,.65)}.status.warn{border-color:rgba(245,158,11,.65)}.status.fail{border-color:rgba(239,68,68,.75)}.muted{color:#b8b093}.grid{display:grid;gap:14px;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));margin:18px 0}article,.card{background:#191a13;border:1px solid #33311f;border-radius:22px;padding:18px}article span{color:#b8b093;display:block;font-weight:800}article strong{display:block;font-size:2.4rem;margin-top:8px}pre{background:#0c0d09;border:1px solid #33311f;border-radius:18px;color:#fef3c7;overflow:auto;padding:16px}code{color:#fef3c7}</style></head><body><main><p><a href="/production-readiness">Production readiness</a></p><section class="hero"><p class="eyebrow">Composable sink primitive</p><h1>${escapeHtml14(title)}</h1><p class="muted">Delivery queues prove audit and trace exports without owning your infrastructure. Swap file, webhook, S3, SQLite, or Postgres sinks behind the same readiness surface.</p><p class="status ${escapeHtml14(report.status)}">Overall: ${escapeHtml14(report.status.toUpperCase())}</p><p class="muted">Checked ${escapeHtml14(new Date(report.checkedAt).toLocaleString())}</p></section><section class="grid">${renderSurfaceCard(report.auditDeliveries)}${renderSurfaceCard(report.traceDeliveries)}${sinks}</section><section class="card"><h2>Primitive shape</h2><p class="muted">Mount delivery sink routes beside audit and trace delivery queues. Production readiness can consume the same stores for pass/fail evidence.</p><pre>createVoiceDeliverySinkRoutes({
   auditDeliveries: { store: runtimeStorage.auditDeliveries },
   traceDeliveries: { store: runtimeStorage.traceDeliveries },
-  sinks: [{ id: "audit-file", kind: "file", label: "Audit file sink" }]
+  sinks: createVoiceDeliverySinkPair({
+    kind: "file",
+    target: "file://.voice-runtime/voice-demo"
+  })
 })</pre></section></main></body></html>`;
 };
 var createVoiceDeliverySinkRoutes = (options) => {
@@ -20288,15 +20341,16 @@ var buildVoiceOpsConsoleReport = async (options) => {
   const trace = summarizeVoiceTrace(events);
   const deliverySinkOptions = options.deliverySinks || undefined;
   const deliverySinks = deliverySinkOptions ? await buildVoiceDeliverySinkReport(deliverySinkOptions) : undefined;
-  const links = options.links ?? (deliverySinks ? [
-    ...DEFAULT_LINKS,
+  const baseLinks = options.links ?? DEFAULT_LINKS;
+  const links = deliverySinks && !baseLinks.some((link) => link.href === (deliverySinkOptions?.htmlPath ?? "/delivery-sinks") || link.statusHref === (deliverySinkOptions?.path ?? "/api/voice-delivery-sinks")) ? [
+    ...baseLinks,
     {
       description: "Configured audit and trace delivery sinks with queue health.",
       href: deliverySinkOptions?.htmlPath === false ? deliverySinkOptions.path ?? "/api/voice-delivery-sinks" : deliverySinkOptions?.htmlPath ?? "/delivery-sinks",
       label: "Delivery Sinks",
       statusHref: deliverySinkOptions?.path ?? "/api/voice-delivery-sinks"
     }
-  ] : DEFAULT_LINKS);
+  ] : baseLinks;
   return {
     checkedAt: Date.now(),
     deliverySinks,
@@ -20499,17 +20553,20 @@ var summarizeVoiceOpsStatus = async (options) => {
     };
     statuses.push(status);
   }
+  const baseLinks = options.links ?? DEFAULT_LINKS2;
+  const deliverySinkOptions = options.deliverySinks || undefined;
+  const links = deliverySinkOptions && !baseLinks.some((link) => link.href === (deliverySinkOptions.htmlPath ?? "/delivery-sinks") || link.statusHref === (deliverySinkOptions.path ?? "/api/voice-delivery-sinks")) ? [
+    ...baseLinks,
+    {
+      description: "Audit and trace delivery sink health.",
+      href: deliverySinkOptions.htmlPath === false ? deliverySinkOptions.path ?? "/api/voice-delivery-sinks" : deliverySinkOptions.htmlPath ?? "/delivery-sinks",
+      label: "Delivery Sinks",
+      statusHref: deliverySinkOptions.path ?? "/api/voice-delivery-sinks"
+    }
+  ] : baseLinks;
   return {
     checkedAt: Date.now(),
-    links: options.links ?? (options.deliverySinks ? [
-      ...DEFAULT_LINKS2,
-      {
-        description: "Audit and trace delivery sink health.",
-        href: options.deliverySinks.htmlPath === false ? options.deliverySinks.path ?? "/api/voice-delivery-sinks" : options.deliverySinks.htmlPath ?? "/delivery-sinks",
-        label: "Delivery Sinks",
-        statusHref: options.deliverySinks.path ?? "/api/voice-delivery-sinks"
-      }
-    ] : DEFAULT_LINKS2),
+    links,
     status: statuses.includes("fail") ? "fail" : "pass",
     surfaces,
     ...countStatus(statuses)
@@ -23058,6 +23115,7 @@ export {
   createVoiceWebhookHandoffAdapter,
   createVoiceWebhookDeliveryWorkerLoop,
   createVoiceWebhookDeliveryWorker,
+  createVoiceWebhookDeliverySink,
   createVoiceTwilioRedirectHandoffAdapter,
   createVoiceTwilioCampaignDialer,
   createVoiceTurnQualityRoutes,
@@ -23115,10 +23173,12 @@ export {
   createVoiceSQLiteReviewStore,
   createVoiceSQLiteIntegrationEventStore,
   createVoiceSQLiteExternalObjectMapStore,
+  createVoiceSQLiteDeliverySink,
   createVoiceSQLiteCampaignStore,
   createVoiceSQLiteAuditSinkDeliveryStore,
   createVoiceSQLiteAuditEventStore,
   createVoiceS3ReviewStore,
+  createVoiceS3DeliverySink,
   createVoiceRoutingDecisionSummary,
   createVoiceReviewSavedEvent,
   createVoiceResilienceRoutes,
@@ -23144,6 +23204,7 @@ export {
   createVoicePostgresReviewStore,
   createVoicePostgresIntegrationEventStore,
   createVoicePostgresExternalObjectMapStore,
+  createVoicePostgresDeliverySink,
   createVoicePostgresCampaignStore,
   createVoicePostgresAuditSinkDeliveryStore,
   createVoicePostgresAuditEventStore,
@@ -23200,6 +23261,7 @@ export {
   createVoiceFileIntegrationEventStore,
   createVoiceFileExternalObjectMapStore,
   createVoiceFileEvalBaselineStore,
+  createVoiceFileDeliverySink,
   createVoiceFileCampaignStore,
   createVoiceFileAuditSinkDeliveryStore,
   createVoiceFileAuditEventStore,
@@ -23211,6 +23273,8 @@ export {
   createVoiceDiagnosticsRoutes,
   createVoiceDemoReadyRoutes,
   createVoiceDeliverySinkRoutes,
+  createVoiceDeliverySinkPair,
+  createVoiceDeliverySinkDescriptor,
   createVoiceCampaignWorkerLoop,
   createVoiceCampaignWorker,
   createVoiceCampaignTelephonyOutcomeHandler,

package/package.json

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