@aiqa/sdk 1.5.0-develop.1 → 1.5.0-develop.2

package/dist/browser/browser.d.ts

@@ -32,7 +32,7 @@ declare enum ConversationLanguage {
     ES = "es",
     FR = "fr"
 }
-type SdkEvent = Methods | "connect" | "disconnect" | "close" | "error" | "reconnect_attempt" | "reconnect_error" | "reconnect_failed" | "authenticated" | "app_version" | "FACT_VERIFIED";
+type SdkEvent = Methods | "connect" | "disconnect" | "close" | "error" | "reconnect_attempt" | "reconnect_error" | "reconnect_failed" | "authenticated" | "app_version" | "FACT_VERIFIED" | "TRANSCRIPTION_UPDATED";
 declare enum FactAnswerFormatType {
     string = "STRING",
     number = "NUMBER",
@@ -182,6 +182,72 @@ interface FactVerifiedPayload {
 type FlagFactResult = {
     success: boolean;
 };
+/**
+ * Coarse dialog-act label produced by the backend's `UtteranceEnricher`.
+ * Advisory only — do not gate production behaviour on this value; the
+ * enricher emits its best-effort categorical guess plus a separate
+ * `dialog_act_confidence` band.
+ *
+ * Mirrors `DialogAct` in
+ * `libs/types/src/utterance-enrichment.ts` on the backend.
+ */
+type DialogAct = "question" | "answer" | "acknowledgement" | "filler" | "other";
+/**
+ * Categorical confidence band for `dialog_act` ONLY. Named distinctly
+ * from the numeric STT `confidence` field on the same utterance — the
+ * two are unrelated and conflating them is a documented drift hazard on
+ * the backend.
+ *
+ * Mirrors `DialogActConfidence` in
+ * `libs/types/src/utterance-enrichment.ts` on the backend.
+ */
+type DialogActConfidence = "high" | "medium" | "low";
+/**
+ * Persisted utterance shape — matches `TranscriptionUtteranceDto` on the
+ * gateway (`apps/realtime-verification/src/socket/realtimeVerification.gateway.output.dto.ts`)
+ * and the `Utterance` interface in `libs/types/src/common.ts` field for
+ * field. Sent over the wire by the `TRANSCRIPTION_UPDATED` broadcast.
+ *
+ * The 7 enricher classification fields are all optional because
+ * pre-cutover utterances (persisted before backend PR #234) lack them.
+ * Treat any missing or nullish value as "unknown" — NOT as a deliberate
+ * negative signal. `is_ivr_filler_candidate === false` in particular
+ * does NOT round-trip through `undefined`, so consumer logic that wants
+ * "definitely not a filler" must check `=== false` after confirming the
+ * field is present.
+ */
+type Utterance = {
+    /** UUIDv7 — chronologically sortable. Use `id` (NOT `order`) for sorting. */
+    id: string;
+    call_id: number;
+    /**
+     * NOT YET IMPLEMENTED — currently hardcoded to 0 at write sites on
+     * the backend. Do not use for sorting; sort by `id` (UUIDv7) instead.
+     */
+    order: number;
+    is_agent: boolean | null;
+    speaker: number;
+    text: string;
+    text_en: string | null;
+    start_time: number;
+    end_time: number;
+    dialog_act?: DialogAct;
+    dialog_act_confidence?: DialogActConfidence;
+    confidence?: number | null;
+    top_alt_margin?: number | null;
+    is_ivr_filler_candidate?: boolean;
+    spoken_digits_normalized?: string | null;
+    vendor?: string | null;
+};
+/**
+ * Payload of the `TRANSCRIPTION_UPDATED` broadcast event. Mirrors
+ * `TranscriptionUpdateResponseDto` on the gateway.
+ */
+type TranscriptionUpdate = {
+    policyNumber: string;
+    conversationId: string;
+    utterance: Utterance;
+};
 type SdkError = {
     code: "INVALID_CONFIG" | "CONNECTION_ERROR" | "TIMEOUT" | "SERVER_ERROR" | "UNEXPECTED_RESPONSE";
     message: string;
@@ -229,4 +295,4 @@ declare class AiQaSdk implements IAiqaSdk {
     private isManagerEvent;
 }
 
-export { type AddFactResult, AiQaSdk, type Application, type ApplicationFact, type ApplicationFactAnswerChoice, type ApplicationFactAnswerFormat, type ApplicationFactInput, ConversationLanguage, FactAnswerFormatType, type FactVerifiedPayload, type FlagFactResult, IAiqaSdk, Methods, type QuestionStatus, type SdkError, type SdkEvent, type SetConversationLanguageResult, type SetConversationProductResult, type VerificationStatus };
+export { type AddFactResult, AiQaSdk, type Application, type ApplicationFact, type ApplicationFactAnswerChoice, type ApplicationFactAnswerFormat, type ApplicationFactInput, ConversationLanguage, type DialogAct, type DialogActConfidence, FactAnswerFormatType, type FactVerifiedPayload, type FlagFactResult, IAiqaSdk, Methods, type QuestionStatus, type SdkError, type SdkEvent, type SetConversationLanguageResult, type SetConversationProductResult, type TranscriptionUpdate, type Utterance, type VerificationStatus };

package/dist/browser/browser.js

@@ -3396,7 +3396,7 @@ var compareVersions = (left, right) => {
 // package.json
 var package_default = {
   name: "@aiqa/sdk",
-  version: "1.4.0-develop.3",
+  version: "1.5.0-develop.1",
   main: "dist/node/node.js",
   module: "dist/node/node.js",
   types: "dist/node/node.d.ts",