@nodora/client 0.0.2 → 0.0.3

package/README.md

@@ -24,7 +24,7 @@ const result = await checkout.evaluate("IsDiscountEligible", {
 });
 ```
 
-For configuration options, caching strategies, and detailed usage, see the official [documentation](https://docs.nodora.org).
+For detailed information, see the official [documentation](https://nodora.org/docs).
 
 ## License
 

package/lib/client.d.ts

@@ -130,6 +130,38 @@ export declare class RulesetHandle {
     rule: string,
     input?: Record<string, any>,
   ): Promise<EvaluationResult>;
+
+  /**
+   * Registers a handler to be invoked when the given signal is emitted
+   * during an `evaluate()` call on this handle.
+   *
+   * Multiple handlers can be registered for the same signal; all are
+   * called in registration order. Returns the handle for chaining.
+   *
+   * @param signal - The name of the signal to listen for.
+   * @param handler - Called with the signal's arguments when emitted.
+   *
+   * @example
+   * client.ruleset("Checkout")
+   *   .on("discount_applied", (amount) => log(amount))
+   *   .on("fraud_flagged", (reason) => alert(reason));
+   */
+  on(
+    signal: string,
+    handler: (...args: any[]) => void,
+  ): this;
+
+  /**
+   * Removes a previously registered handler for the given signal.
+   * The handler reference must match the one passed to `on()`.
+   *
+   * @param signal - The name of the signal.
+   * @param handler - The handler to remove.
+   */
+  off(
+    signal: string,
+    handler: (...args: any[]) => void,
+  ): this;
 }
 
 /**

package/lib/client.js

@@ -46,11 +46,13 @@ export class NodoraClient {
   }
 
   _evaluate(rulesetName, ruleName, input) {
-    if (this._abortController.signal.aborted) return;
+    if (this._abortController.signal.aborted) {
+      throw new Error("client is destroyed");
+    }
 
     const entry = this._cache.get(rulesetName);
     if (!entry) {
-      throw new Error(`Ruleset "${rulesetName}" not found`);
+      throw new Error(`ruleset "${rulesetName}" not found`);
     }
 
     let result;
@@ -129,7 +131,7 @@ export class NodoraClient {
     });
 
     if (!res.ok) {
-      throw new Error(`Failed to fetch releases: HTTP ${res.status}`);
+      throw new Error(`failed to fetch releases: HTTP ${res.status}`);
     }
 
     return res.json();
@@ -238,10 +240,45 @@ class RulesetHandle {
   constructor(client, ruleset) {
     this._client = client;
     this._ruleset = ruleset;
+    this._signals = new Map();
   }
 
   async evaluate(rule, input = {}) {
     await this._client.prefetch();
-    return this._client._evaluate(this._ruleset, rule, input);
+    const result = this._client._evaluate(this._ruleset, rule, input);
+
+    if (result.emitted_signals && result.emitted_signals.length > 0) {
+      for (const signal of result.emitted_signals) {
+        const handlers = this._signals.get(signal.name);
+        if (handlers) {
+          for (const handler of handlers) {
+            try {
+              handler(...signal.args);
+            } catch (err) {
+              this._client._onError(err);
+            }
+          }
+        }
+      }
+    }
+    return result;
+  }
+
+  on(signal, handler) {
+    let handlers = this._signals.get(signal);
+    if (!handlers) {
+      handlers = new Set();
+      this._signals.set(signal, handlers);
+    }
+    handlers.add(handler);
+    return this;
+  }
+
+  off(signal, handler) {
+    const handlers = this._signals.get(signal);
+    if (!handlers) return this;
+    handlers.delete(handler);
+    if (handlers.size === 0) this._signals.delete(signal);
+    return this;
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodora/client",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Nodora platform client for ruleset evaluation",
   "main": "lib/client.js",
   "types": "lib/client.d.ts",