@aiqa/sdk 2.0.1 → 2.1.0-develop.1

package/dist/browser/browser.d.ts

@@ -285,6 +285,13 @@ declare class AiQaSdk implements IAiqaSdk {
     internalListeners: Map<SdkEvent, Set<(...args: any[]) => void>>;
     internalEvents: Set<SdkEvent>;
     private wrappersByEvent;
+    /**
+     * Trailing-debounce window (ms) applied per fact in {@link addFact}. Defaults
+     * to {@link ADD_FACT_DEBOUNCE_MS}; set to 0 to disable debouncing and send
+     * every call immediately.
+     */
+    addFactDebounceMs: number;
+    private pendingAddFacts;
     constructor(applicationId: string, applicationSecret: string, url?: string);
     on(name: SdkEvent, callback: (...args: any[]) => any): void;
     off(name: SdkEvent, callback?: (...args: any[]) => any): void;
@@ -294,6 +301,8 @@ declare class AiQaSdk implements IAiqaSdk {
     getApplication(): Promise<Application>;
     getFacts(): Promise<ApplicationFact[]>;
     addFact(fact: ApplicationFactInput): Promise<AddFactResult>;
+    private flushAddFact;
+    private sendAddFact;
     flagFact(factId: string): Promise<FlagFactResult>;
     setConversationProduct(product: string): Promise<SetConversationProductResult>;
     setConversationLanguage(language: ConversationLanguage): Promise<SetConversationLanguageResult>;

package/dist/browser/browser.js

@@ -3397,7 +3397,7 @@ var compareVersions = (left, right) => {
 // package.json
 var package_default = {
   name: "@aiqa/sdk",
-  version: "2.1.0-develop.1",
+  version: "2.0.0",
   main: "dist/node/node.js",
   module: "dist/node/node.js",
   types: "dist/node/node.d.ts",
@@ -3479,6 +3479,7 @@ var package_default = {
 var SDK_VERSION = package_default.version ?? "0.0.1";
 var DEFAULT_URL = "ws://localhost:3025/ws";
 var DEFAULT_TIMEOUT_MS = 6e4;
+var ADD_FACT_DEBOUNCE_MS = 500;
 var RUNTIME = typeof window !== "undefined" && typeof window.document !== "undefined" ? "browser" : "node";
 var USER_AGENT = RUNTIME === "browser" ? typeof navigator !== "undefined" ? navigator.userAgent : "browser/unknown" : typeof process !== "undefined" ? `node ${process.version} ${process.platform}` : "node/unknown";
 function isThenable(value2) {
@@ -3524,6 +3525,15 @@ var AiQaSdk = class {
     // same fn twice registers two wrappers and two off() calls clear
     // both.
     this.wrappersByEvent = /* @__PURE__ */ new Map();
+    /**
+     * Trailing-debounce window (ms) applied per fact in {@link addFact}. Defaults
+     * to {@link ADD_FACT_DEBOUNCE_MS}; set to 0 to disable debouncing and send
+     * every call immediately.
+     */
+    this.addFactDebounceMs = ADD_FACT_DEBOUNCE_MS;
+    // In-flight debounce state keyed by fact id: the pending timer, the latest
+    // payload to send when it fires, and every caller awaiting that send.
+    this.pendingAddFacts = /* @__PURE__ */ new Map();
     this.url = url2 ?? DEFAULT_URL;
     this.internalListeners = /* @__PURE__ */ new Map();
     this.internalEvents = /* @__PURE__ */ new Set(["authenticated"]);
@@ -3650,6 +3660,13 @@ var AiQaSdk = class {
       this.socket.disconnect();
     }
     this.wrappersByEvent.clear();
+    for (const entry of this.pendingAddFacts.values()) {
+      clearTimeout(entry.timer);
+      entry.waiters.forEach(
+        (w) => w.reject(new Error("Socket disconnected before addFact was sent"))
+      );
+    }
+    this.pendingAddFacts.clear();
   }
   sendMessage(method, data) {
     return new Promise((resolve, reject) => {
@@ -3699,7 +3716,40 @@ var AiQaSdk = class {
     const result = await this.sendMessage("GET_FACTS" /* GET_FACTS */);
     return result && result.data !== void 0 ? result.data : result;
   }
-  async addFact(fact) {
+  addFact(fact) {
+    if (this.addFactDebounceMs <= 0) {
+      return this.sendAddFact(fact);
+    }
+    const key = fact.questionId ?? fact.id;
+    return new Promise((resolve, reject) => {
+      const existing = this.pendingAddFacts.get(key);
+      if (existing) {
+        clearTimeout(existing.timer);
+        existing.latest = fact;
+        existing.waiters.push({ resolve, reject });
+        existing.timer = setTimeout(
+          () => this.flushAddFact(key),
+          this.addFactDebounceMs
+        );
+        return;
+      }
+      this.pendingAddFacts.set(key, {
+        latest: fact,
+        waiters: [{ resolve, reject }],
+        timer: setTimeout(() => this.flushAddFact(key), this.addFactDebounceMs)
+      });
+    });
+  }
+  flushAddFact(key) {
+    const entry = this.pendingAddFacts.get(key);
+    if (!entry) return;
+    this.pendingAddFacts.delete(key);
+    this.sendAddFact(entry.latest).then(
+      (result) => entry.waiters.forEach((w) => w.resolve(result)),
+      (error) => entry.waiters.forEach((w) => w.reject(error))
+    );
+  }
+  async sendAddFact(fact) {
     const payload = {
       ...fact,
       critical: fact.critical ?? false,