@nextera.one/axis-server-sdk 2.3.2 → 2.3.4

package/dist/index.mjs

@@ -2382,10 +2382,7 @@ var intent_router_exports = {};
 __export(intent_router_exports, {
   IntentRouter: () => IntentRouter
 });
-import {
-  decodeChainEnvelope,
-  decodeChainRequest
-} from "@nextera.one/axis-protocol";
+import { decodeChainEnvelope, decodeChainRequest } from "@nextera.one/axis-protocol";
 function observerRefKey(ref) {
   return typeof ref === "string" ? ref : ref.name;
 }
@@ -2513,6 +2510,8 @@ var init_intent_router = __esm({
         this.cceHandlers = /* @__PURE__ */ new Map();
         /** CCE pipeline configuration (set via configureCce) */
         this.ccePipelineConfig = null;
+        /** Reverse index: handler class name → list of registered intents */
+        this.handlerIntents = /* @__PURE__ */ new Map();
         this.dependencyResolver = dependencyResolver;
         this.observerDispatcher = observerDispatcher;
         this.sensorRegistry = sensorRegistry;
@@ -2602,6 +2601,7 @@ var init_intent_router = __esm({
             intentName,
             `${instance.constructor.name}.${String(route.methodName)}`
           );
+          this.trackHandlerIntent(instance.constructor.name, intentName);
           this.registerIntentMeta(
             intentName,
             proto,
@@ -2625,6 +2625,7 @@ var init_intent_router = __esm({
             handlerSensors,
             handlerObservers
           );
+          this.trackHandlerIntent(instance.constructor.name, intentName);
         }
       }
       /**
@@ -2976,6 +2977,106 @@ var init_intent_router = __esm({
       getRateLimit(intent) {
         return this.intentRateLimits.get(intent);
       }
+      // ─── Handler-level Getters ─────────────────────────────────────────────────
+      /** All intents registered under the given handler class name. */
+      getHandlerIntents(handlerName) {
+        return this.handlerIntents.get(handlerName) ?? [];
+      }
+      /** Returns the handler class name that owns the given intent, or undefined if not found. */
+      getHandlerByIntent(intent) {
+        for (const [handlerName, intents] of this.handlerIntents) {
+          if (intents.includes(intent)) return handlerName;
+        }
+        return void 0;
+      }
+      /** All registered handler class names. */
+      getRegisteredHandlers() {
+        return Array.from(this.handlerIntents.keys());
+      }
+      /** The system/builtin intents (ping, time, echo, chain, intent.exec). */
+      getSystemIntents() {
+        return [..._IntentRouter.BUILTIN_INTENTS];
+      }
+      /** True if every intent in the handler is public, or any one is public — returns true if ANY intent is @AxisPublic. */
+      isHandlerPublic(handlerName) {
+        return this.getHandlerIntents(handlerName).some((i) => this.isPublic(i));
+      }
+      /** True if any intent in the handler is @AxisAnonymous. */
+      isHandlerAnonymous(handlerName) {
+        return this.getHandlerIntents(handlerName).some((i) => this.isAnonymous(i));
+      }
+      /** True if any intent in the handler is @AxisAuthorized. */
+      isHandlerAuthorized(handlerName) {
+        return this.getHandlerIntents(handlerName).some(
+          (i) => this.isAuthorized(i)
+        );
+      }
+      /** Union of all required proof kinds across the handler's intents (deduplicated). */
+      getHandlerProof(handlerName) {
+        const all = this.getHandlerIntents(handlerName).flatMap(
+          (i) => this.getRequiredProof(i) ?? []
+        );
+        if (all.length === 0) return void 0;
+        return [...new Set(all)];
+      }
+      /** Contract from the first intent that has one (class-level contracts propagate to all intents). */
+      getHandlerContract(handlerName) {
+        for (const intent of this.getHandlerIntents(handlerName)) {
+          const contract = this.getContract(intent);
+          if (contract) return contract;
+        }
+        return void 0;
+      }
+      /** Sensitivity from the first intent that has one. */
+      getHandlerSensitivity(handlerName) {
+        for (const intent of this.getHandlerIntents(handlerName)) {
+          const sensitivity = this.getSensitivity(intent);
+          if (sensitivity) return sensitivity;
+        }
+        return void 0;
+      }
+      /** Rate limit from the first intent that has one. */
+      getHandlerRateLimit(handlerName) {
+        for (const intent of this.getHandlerIntents(handlerName)) {
+          const rateLimit = this.getRateLimit(intent);
+          if (rateLimit) return rateLimit;
+        }
+        return void 0;
+      }
+      /** Capsule policy from the first intent that has one. */
+      getHandlerCapsulePolicy(handlerName) {
+        for (const intent of this.getHandlerIntents(handlerName)) {
+          const policy = this.intentCapsulePolicies.get(intent);
+          if (policy) return policy;
+        }
+        return void 0;
+      }
+      /** Full summary of a handler's registered intents and aggregated policies. Returns null if unknown. */
+      getHandlerSummary(handlerName) {
+        const intents = this.getHandlerIntents(handlerName);
+        if (intents.length === 0) return null;
+        return {
+          handler: handlerName,
+          intents,
+          isPublic: this.isHandlerPublic(handlerName),
+          isAnonymous: this.isHandlerAnonymous(handlerName),
+          isAuthorized: this.isHandlerAuthorized(handlerName),
+          requiredProof: this.getHandlerProof(handlerName),
+          contract: this.getHandlerContract(handlerName),
+          sensitivity: this.getHandlerSensitivity(handlerName),
+          rateLimit: this.getHandlerRateLimit(handlerName),
+          capsulePolicy: this.getHandlerCapsulePolicy(handlerName)
+        };
+      }
+      /** Summary of all registered handlers keyed by handler class name. */
+      getAllHandlerSummaries() {
+        const result = /* @__PURE__ */ new Map();
+        for (const handlerName of this.handlerIntents.keys()) {
+          const summary = this.getHandlerSummary(handlerName);
+          if (summary) result.set(handlerName, summary);
+        }
+        return result;
+      }
       async emitIntentObservers(bindings, context) {
         if (!this.observerDispatcher) return;
         await this.observerDispatcher.dispatch(
@@ -3022,6 +3123,14 @@ var init_intent_router = __esm({
           }
         }
       }
+      trackHandlerIntent(handlerName, intent) {
+        const existing = this.handlerIntents.get(handlerName);
+        if (existing) {
+          if (!existing.includes(intent)) existing.push(intent);
+        } else {
+          this.handlerIntents.set(handlerName, [intent]);
+        }
+      }
       resolveIntentSensor(ref) {
         const registered = this.sensorRegistry?.resolve(ref);
         if (registered) {