@nextera.one/axis-server-sdk 2.3.13 → 2.3.15

package/dist/index.mjs

@@ -2659,6 +2659,15 @@ var init_intent_router = __esm({
         const resolved = this.resolveIntentAlias(intent);
         return this.handlers.has(resolved) || isBuiltinIntent(resolved);
       }
+      /**
+       * True only when the application registered a concrete handler.
+       * Unlike `has()`, this intentionally ignores SDK built-in fallbacks so
+       * discovery layers can override simple built-ins such as `system.ping`.
+       */
+      hasRegisteredHandler(intent) {
+        const resolved = this.resolveIntentAlias(intent);
+        return this.handlers.has(resolved);
+      }
       getRegisteredIntents() {
         return [...BUILTIN_INTENTS, ...this.handlers.keys()];
       }
@@ -2778,9 +2787,14 @@ var init_intent_router = __esm({
        * Routes a decoded AXIS frame to the appropriate handler.
        *
        * **Precedence:**
-       * 1. System Built-ins (`system.ping`, `public.ping`, `system.time`, `system.echo`)
-       * 2. Meta-intent execution (`INTENT.EXEC` / `axis.intent.exec`)
-       * 3. Dynamically registered handlers from modules.
+       * 1. SDK meta-intents (`CHAIN.EXEC`, `INTENT.EXEC`)
+       * 2. Dynamically registered handlers from modules
+       * 3. Simple SDK built-in fallback (`system.ping`, `public.ping`, `system.time`, `system.echo`)
+       *
+       * Registered app handlers intentionally win over simple built-ins. This lets
+       * applications attach sensors, rate limits, and custom responses to intents
+       * like `system.ping` while keeping a default fallback for apps that do not
+       * register their own handler.
        *
        * @param {AxisFrame} frame - The validated and decoded binary frame
        * @returns {Promise<AxisEffect>} The resulting effect of the execution
@@ -2834,6 +2848,16 @@ var init_intent_router = __esm({
        * This keeps route() focused on observer/error lifecycle concerns.
        */
       async routeResolvedIntent(intent, frame) {
+        if (isChainExecIntent(intent)) {
+          const chainRequest = this.parseChainRequestBody(frame.body);
+          return this.executeChainRequest(frame, chainRequest);
+        }
+        if (isIntentExecIntent(intent)) {
+          return this.routeIntentExec(frame);
+        }
+        if (this.handlers.has(intent)) {
+          return this.routeRegisteredIntent(intent, frame);
+        }
         const builtinEffect = routeSystemBuiltinIntent(
           intent,
           frame.body,
@@ -2845,13 +2869,6 @@ var init_intent_router = __esm({
           }
           return builtinEffect;
         }
-        if (isChainExecIntent(intent)) {
-          const chainRequest = this.parseChainRequestBody(frame.body);
-          return this.executeChainRequest(frame, chainRequest);
-        }
-        if (isIntentExecIntent(intent)) {
-          return this.routeIntentExec(frame);
-        }
         return this.routeRegisteredIntent(intent, frame);
       }
       /**