@nextera.one/axis-server-sdk 2.3.8 → 2.3.10

package/dist/sensors/index.mjs

@@ -2658,6 +2658,10 @@ var init_intent_router = __esm({
         this.handlerIntents = /* @__PURE__ */ new Map();
         /** Handler class name → intent namespace prefix (from @Handler('auth')) */
         this.handlerPrefixes = /* @__PURE__ */ new Map();
+        /** Handler namespace prefix → handler class name, used by `handler...intent` lookup. */
+        this.handlerByPrefix = /* @__PURE__ */ new Map();
+        /** Intent → handler class name, avoids scanning handlerIntents for normal lookups. */
+        this.handlerByIntent = /* @__PURE__ */ new Map();
         /** Handler class name → class-level sensor bindings (from @HandlerSensors) */
         this.handlerClassSensors = /* @__PURE__ */ new Map();
         /** Handler class name → class-level observer bindings (from @Handler({ observe: [...] })) */
@@ -2667,35 +2671,37 @@ var init_intent_router = __esm({
         this.sensorRegistry = sensorRegistry;
       }
       getSchema(intent) {
-        return this.intentSchemas.get(intent);
+        return this.intentSchemas.get(this.resolveIntentAlias(intent));
       }
       getValidators(intent) {
-        return this.intentValidators.get(intent);
+        return this.intentValidators.get(this.resolveIntentAlias(intent));
       }
       has(intent) {
-        return this.handlers.has(intent) || _IntentRouter.BUILTIN_INTENTS.has(intent);
+        const resolved = this.resolveIntentAlias(intent);
+        return this.handlers.has(resolved) || _IntentRouter.BUILTIN_INTENTS.has(resolved);
       }
       getRegisteredIntents() {
         return [..._IntentRouter.BUILTIN_INTENTS, ...this.handlers.keys()];
       }
       getIntentEntry(intent) {
-        if (!this.has(intent)) return null;
+        const resolved = this.resolveIntentAlias(intent);
+        if (!this.has(resolved)) return null;
         return {
-          schema: this.intentSchemas.get(intent),
-          validators: this.intentValidators.get(intent),
-          hasSensors: this.intentSensors.has(intent),
-          builtin: _IntentRouter.BUILTIN_INTENTS.has(intent),
-          kind: this.intentKinds.get(intent),
-          chain: this.intentChains.get(intent),
-          capsulePolicy: this.intentCapsulePolicies.get(intent),
-          observerCount: this.getObservers(intent).length
+          schema: this.intentSchemas.get(resolved),
+          validators: this.intentValidators.get(resolved),
+          hasSensors: this.intentSensors.has(resolved),
+          builtin: _IntentRouter.BUILTIN_INTENTS.has(resolved),
+          kind: this.intentKinds.get(resolved),
+          chain: this.intentChains.get(resolved),
+          capsulePolicy: this.intentCapsulePolicies.get(resolved),
+          observerCount: this.getObservers(resolved).length
         };
       }
       getChainConfig(intent) {
-        return this.intentChains.get(intent);
+        return this.intentChains.get(this.resolveIntentAlias(intent));
       }
       getObservers(intent) {
-        return this.intentObservers.get(intent) || [];
+        return this.intentObservers.get(this.resolveIntentAlias(intent)) || [];
       }
       /**
        * Registers a handler for a specific intent.
@@ -2738,6 +2744,14 @@ var init_intent_router = __esm({
         );
         const handlerSensors = Reflect.getMetadata(HANDLER_SENSORS_KEY, instance.constructor) || [];
         const handlerObservers = Reflect.getMetadata(OBSERVER_BINDINGS_KEY, instance.constructor) || [];
+        if (prefix) {
+          this.trackHandlerMeta(
+            instance.constructor.name,
+            prefix,
+            handlerSensors,
+            handlerObservers
+          );
+        }
         const proto = Object.getPrototypeOf(instance);
         for (const route of routes) {
           const intentName = route.absolute ? route.action : `${prefix}.${route.action}`;
@@ -2797,7 +2811,7 @@ var init_intent_router = __esm({
         try {
           const intentBytes = frame.headers.get(TLV_INTENT);
           if (!intentBytes) throw new Error("Missing intent");
-          intent = this.decoder.decode(intentBytes);
+          intent = this.resolveIntentAlias(this.decoder.decode(intentBytes));
           handlerRef = this.intentHandlerRefs.get(intent);
           const observerBindings = this.getObservers(intent);
           await this.emitIntentObservers(observerBindings, {
@@ -3107,25 +3121,25 @@ var init_intent_router = __esm({
       }
       // ─── Policy Getters ────────────────────────────────────────────────────────
       getSensitivity(intent) {
-        return this.intentSensitivity.get(intent);
+        return this.intentSensitivity.get(this.resolveIntentAlias(intent));
       }
       getContract(intent) {
-        return this.intentContracts.get(intent);
+        return this.intentContracts.get(this.resolveIntentAlias(intent));
       }
       getRequiredProof(intent) {
-        return this.intentRequiredProof.get(intent);
+        return this.intentRequiredProof.get(this.resolveIntentAlias(intent));
       }
       isPublic(intent) {
-        return this.publicIntents.has(intent);
+        return this.publicIntents.has(this.resolveIntentAlias(intent));
       }
       isAnonymous(intent) {
-        return this.anonymousIntents.has(intent);
+        return this.anonymousIntents.has(this.resolveIntentAlias(intent));
       }
       isAuthorized(intent) {
-        return this.authorizedIntents.has(intent);
+        return this.authorizedIntents.has(this.resolveIntentAlias(intent));
       }
       getRateLimit(intent) {
-        return this.intentRateLimits.get(intent);
+        return this.intentRateLimits.get(this.resolveIntentAlias(intent));
       }
       // ─── Handler-level Getters ─────────────────────────────────────────────────
       /** All intents registered under the given handler class name. */
@@ -3134,10 +3148,8 @@ var init_intent_router = __esm({
       }
       /** 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;
+        const resolved = this.resolveIntentAlias(intent);
+        return this.handlerByIntent.get(resolved);
       }
       /** All registered handler class names. */
       getRegisteredHandlers() {
@@ -3213,6 +3225,33 @@ var init_intent_router = __esm({
       getHandlerClassObservers(handlerName) {
         return this.handlerClassObservers.get(handlerName);
       }
+      /**
+       * Resolves the optional `handler...intent` wire shorthand to a registered
+       * canonical intent. Existing exact intent names always win.
+       */
+      resolveIntentAlias(intent) {
+        if (this.handlers.has(intent) || _IntentRouter.BUILTIN_INTENTS.has(intent)) {
+          return intent;
+        }
+        const separator = "...";
+        const separatorIndex = intent.indexOf(separator);
+        if (separatorIndex <= 0) return intent;
+        const handlerKey = intent.slice(0, separatorIndex);
+        const action = intent.slice(separatorIndex + separator.length);
+        if (!handlerKey || !action) return intent;
+        const handlerName = this.handlerByPrefix.get(handlerKey) ?? (this.handlerIntents.has(handlerKey) ? handlerKey : void 0);
+        if (!handlerName) return intent;
+        const prefix = this.getHandlerPrefix(handlerName) ?? handlerKey;
+        const handlerIntents = this.getHandlerIntents(handlerName);
+        const prefixedIntent = `${prefix}.${action}`;
+        if (handlerIntents.includes(prefixedIntent)) return prefixedIntent;
+        if (handlerIntents.includes(action)) return action;
+        const suffix = `.${action}`;
+        const suffixMatches = handlerIntents.filter(
+          (candidate) => candidate.endsWith(suffix)
+        );
+        return suffixMatches.length === 1 ? suffixMatches[0] : intent;
+      }
       /** Full summary of a handler's registered intents and aggregated policies. Returns null if unknown. */
       getHandlerSummary(handlerName) {
         const intents = this.getHandlerIntents(handlerName);
@@ -3289,6 +3328,7 @@ var init_intent_router = __esm({
         }
       }
       trackHandlerIntent(handlerName, intent) {
+        this.handlerByIntent.set(intent, handlerName);
         const existing = this.handlerIntents.get(handlerName);
         if (existing) {
           if (!existing.includes(intent)) existing.push(intent);
@@ -3302,6 +3342,7 @@ var init_intent_router = __esm({
        */
       trackHandlerMeta(className, prefix, sensors, observers) {
         this.handlerPrefixes.set(className, prefix);
+        this.handlerByPrefix.set(prefix, className);
         if (sensors.length > 0) {
           this.handlerClassSensors.set(
             className,
@@ -11770,6 +11811,80 @@ var require_intent_registry_sensor = __commonJS({
   }
 });
 
+// src/sensors/law-article-presence.sensor.ts
+var require_law_article_presence_sensor = __commonJS({
+  "src/sensors/law-article-presence.sensor.ts"(exports) {
+    "use strict";
+    var __decorate = exports && exports.__decorate || function(decorators, target, key, desc) {
+      var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+      if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+      else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+      return c > 3 && r && Object.defineProperty(target, key, r), r;
+    };
+    var __metadata = exports && exports.__metadata || function(k, v) {
+      if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+    };
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.LawArticlePresenceSensor = void 0;
+    var sensor_decorator_1 = (init_sensor_decorator(), __toCommonJS(sensor_decorator_exports));
+    var sensor_bands_1 = (init_sensor_bands(), __toCommonJS(sensor_bands_exports));
+    var LawArticlePresenceSensor = class LawArticlePresenceSensor {
+      constructor(options) {
+        this.options = options;
+        this.name = "LawArticlePresenceSensor";
+        this.order = sensor_bands_1.BAND.IDENTITY + 27;
+      }
+      supports(input) {
+        if (this.mode() === "off")
+          return false;
+        if (!input.intent)
+          return false;
+        if (this.exemptIntents().includes(input.intent))
+          return false;
+        return true;
+      }
+      async run(input) {
+        const intent = input.intent;
+        const count = await this.options.getLawArticleCount(intent, input);
+        if (count > 0) {
+          return {
+            action: "ALLOW",
+            meta: { lawArticles: count }
+          };
+        }
+        const reason = `Intent '${intent}' has no law article mapping`;
+        if (this.mode() === "strict") {
+          return {
+            action: "DENY",
+            code: this.options.missingCode ?? "CAPSULE_NOT_LAWFUL",
+            reason
+          };
+        }
+        return {
+          action: "FLAG",
+          scoreDelta: this.options.auditScoreDelta ?? 5,
+          reasons: ["LAW_ARTICLE_MISSING", reason],
+          meta: { lawArticles: 0 }
+        };
+      }
+      mode() {
+        const configured = this.options.mode;
+        if (typeof configured === "function")
+          return configured();
+        return configured ?? "audit";
+      }
+      exemptIntents() {
+        return this.options.exemptIntents ?? ["system.ping"];
+      }
+    };
+    exports.LawArticlePresenceSensor = LawArticlePresenceSensor;
+    exports.LawArticlePresenceSensor = LawArticlePresenceSensor = __decorate([
+      (0, sensor_decorator_1.Sensor)({ phase: "POST_DECODE" }),
+      __metadata("design:paramtypes", [Object])
+    ], LawArticlePresenceSensor);
+  }
+});
+
 // src/sensors/law-evaluation.sensor.ts
 var require_law_evaluation_sensor = __commonJS({
   "src/sensors/law-evaluation.sensor.ts"(exports) {
@@ -13241,6 +13356,7 @@ var init_sensors = __esm({
     __reExport(sensors_exports, __toESM(require_header_tlv_limit_sensor()));
     __reExport(sensors_exports, __toESM(require_intent_allowlist_sensor()));
     __reExport(sensors_exports, __toESM(require_intent_registry_sensor()));
+    __reExport(sensors_exports, __toESM(require_law_article_presence_sensor()));
     __reExport(sensors_exports, __toESM(require_law_evaluation_sensor()));
     __reExport(sensors_exports, __toESM(require_proof_presence_sensor()));
     __reExport(sensors_exports, __toESM(require_protocol_strict_sensor()));