@nextera.one/axis-server-sdk 2.2.2 → 2.2.4

package/dist/index.mjs

@@ -273,17 +273,76 @@ var init_intent_policy_decorator = __esm({
   }
 });
 
-// src/decorators/handler.decorator.ts
+// src/decorators/handler-sensors.decorator.ts
 import "reflect-metadata";
-function Handler(intent) {
+function HandlerSensors(sensors) {
   return (target) => {
-    Reflect.defineMetadata(HANDLER_METADATA_KEY, { intent }, target);
+    Reflect.defineMetadata(HANDLER_SENSORS_KEY, sensors, target);
   };
 }
-var HANDLER_METADATA_KEY;
-var init_handler_decorator = __esm({
-  "src/decorators/handler.decorator.ts"() {
-    HANDLER_METADATA_KEY = "axis:handler";
+var HANDLER_SENSORS_KEY;
+var init_handler_sensors_decorator = __esm({
+  "src/decorators/handler-sensors.decorator.ts"() {
+    HANDLER_SENSORS_KEY = "axis:handler:sensors";
+  }
+});
+
+// src/decorators/observer.decorator.ts
+import "reflect-metadata";
+function isBindingOptions(value) {
+  return !!value && typeof value === "object" && "use" in value;
+}
+function isDefinitionOptions(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value) && !isBindingOptions(value);
+}
+function toObserverBinding(input) {
+  if (!input) return null;
+  if (isBindingOptions(input)) {
+    const refs = Array.isArray(input.use) ? input.use : [input.use];
+    return { refs, tags: input.tags, events: input.events };
+  }
+  if (Array.isArray(input)) {
+    return { refs: input };
+  }
+  if (typeof input === "function" || typeof input === "string") {
+    return { refs: [input] };
+  }
+  return null;
+}
+function Observer(input) {
+  return ((target, propertyKey) => {
+    const binding = toObserverBinding(input);
+    if (binding) {
+      if (propertyKey !== void 0) {
+        const existing2 = Reflect.getMetadata(OBSERVER_BINDINGS_KEY, target, propertyKey) || [];
+        existing2.push(binding);
+        Reflect.defineMetadata(
+          OBSERVER_BINDINGS_KEY,
+          existing2,
+          target,
+          propertyKey
+        );
+        return;
+      }
+      const existing = Reflect.getMetadata(OBSERVER_BINDINGS_KEY, target) || [];
+      existing.push(binding);
+      Reflect.defineMetadata(OBSERVER_BINDINGS_KEY, existing, target);
+      return;
+    }
+    if (propertyKey !== void 0) {
+      throw new Error(
+        "@Observer method usage must reference one or more observer classes or names"
+      );
+    }
+    const definition = isDefinitionOptions(input) ? input : {};
+    Reflect.defineMetadata(OBSERVER_METADATA_KEY, definition, target);
+  });
+}
+var OBSERVER_METADATA_KEY, OBSERVER_BINDINGS_KEY;
+var init_observer_decorator = __esm({
+  "src/decorators/observer.decorator.ts"() {
+    OBSERVER_METADATA_KEY = "axis:observer";
+    OBSERVER_BINDINGS_KEY = "axis:observer:bindings";
   }
 });
 
@@ -303,6 +362,21 @@ var init_intent_body_decorator = __esm({
 
 // src/decorators/intent.decorator.ts
 import "reflect-metadata";
+function isIntentSensorBindingOptions(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value) && "use" in value;
+}
+function toIntentSensorBinding(input) {
+  if (isIntentSensorBindingOptions(input)) {
+    return {
+      ref: input.use,
+      when: input.when || "before"
+    };
+  }
+  return {
+    ref: input,
+    when: "before"
+  };
+}
 function Intent(action, options) {
   return (target, propertyKey) => {
     const metadata = { intent: action, ...options };
@@ -350,90 +424,62 @@ var init_intent_decorator = __esm({
   }
 });
 
-// src/decorators/intent-sensors.decorator.ts
-import "reflect-metadata";
-function IntentSensors(sensors) {
-  return (target, propertyKey) => {
-    Reflect.defineMetadata(INTENT_SENSORS_KEY, sensors, target, propertyKey);
-  };
-}
-var INTENT_SENSORS_KEY;
-var init_intent_sensors_decorator = __esm({
-  "src/decorators/intent-sensors.decorator.ts"() {
-    INTENT_SENSORS_KEY = "axis:intent:sensors";
-  }
-});
-
-// src/decorators/observer.decorator.ts
+// src/decorators/handler.decorator.ts
 import "reflect-metadata";
-function isBindingOptions(value) {
-  return !!value && typeof value === "object" && "use" in value;
-}
-function isDefinitionOptions(value) {
-  return !!value && typeof value === "object" && !Array.isArray(value) && !isBindingOptions(value);
-}
-function toBinding(input) {
-  if (!input) return null;
-  if (isBindingOptions(input)) {
-    const refs = Array.isArray(input.use) ? input.use : [input.use];
-    return { refs, tags: input.tags, events: input.events };
-  }
-  if (Array.isArray(input)) {
-    return { refs: input };
-  }
-  if (typeof input === "function" || typeof input === "string") {
-    return { refs: [input] };
-  }
-  return null;
-}
-function Observer(input) {
-  return ((target, propertyKey) => {
-    const binding = toBinding(input);
-    if (binding) {
-      if (propertyKey !== void 0) {
-        const existing2 = Reflect.getMetadata(OBSERVER_BINDINGS_KEY, target, propertyKey) || [];
-        existing2.push(binding);
-        Reflect.defineMetadata(
-          OBSERVER_BINDINGS_KEY,
-          existing2,
-          target,
-          propertyKey
-        );
-        return;
-      }
-      const existing = Reflect.getMetadata(OBSERVER_BINDINGS_KEY, target) || [];
-      existing.push(binding);
-      Reflect.defineMetadata(OBSERVER_BINDINGS_KEY, existing, target);
-      return;
+function Handler(intentOrOptions, options) {
+  return (target) => {
+    const intent = typeof intentOrOptions === "string" ? intentOrOptions : void 0;
+    const handlerOptions = typeof intentOrOptions === "string" ? options : intentOrOptions;
+    const sensorBindings = Array.isArray(handlerOptions?.is) ? handlerOptions.is.map(
+      (input) => toIntentSensorBinding(input)
+    ) : [];
+    const observerBindings = Array.isArray(
+      handlerOptions?.observe
+    ) ? handlerOptions.observe.map((input) => toObserverBinding(input)).filter((binding) => !!binding) : [];
+    Reflect.defineMetadata(
+      HANDLER_METADATA_KEY,
+      { intent, ...handlerOptions || {} },
+      target
+    );
+    if (sensorBindings.length > 0) {
+      const existing = Reflect.getMetadata(HANDLER_SENSORS_KEY, target) || [];
+      Reflect.defineMetadata(
+        HANDLER_SENSORS_KEY,
+        [...existing, ...sensorBindings],
+        target
+      );
     }
-    if (propertyKey !== void 0) {
-      throw new Error(
-        "@Observer method usage must reference one or more observer classes or names"
+    if (observerBindings.length > 0) {
+      const existing = Reflect.getMetadata(OBSERVER_BINDINGS_KEY, target) || [];
+      Reflect.defineMetadata(
+        OBSERVER_BINDINGS_KEY,
+        [...existing, ...observerBindings],
+        target
       );
     }
-    const definition = isDefinitionOptions(input) ? input : {};
-    Reflect.defineMetadata(OBSERVER_METADATA_KEY, definition, target);
-  });
+  };
 }
-var OBSERVER_METADATA_KEY, OBSERVER_BINDINGS_KEY;
-var init_observer_decorator = __esm({
-  "src/decorators/observer.decorator.ts"() {
-    OBSERVER_METADATA_KEY = "axis:observer";
-    OBSERVER_BINDINGS_KEY = "axis:observer:bindings";
+var HANDLER_METADATA_KEY;
+var init_handler_decorator = __esm({
+  "src/decorators/handler.decorator.ts"() {
+    init_handler_sensors_decorator();
+    init_observer_decorator();
+    init_intent_decorator();
+    HANDLER_METADATA_KEY = "axis:handler";
   }
 });
 
-// src/decorators/handler-sensors.decorator.ts
+// src/decorators/intent-sensors.decorator.ts
 import "reflect-metadata";
-function HandlerSensors(sensors) {
-  return (target) => {
-    Reflect.defineMetadata(HANDLER_SENSORS_KEY, sensors, target);
+function IntentSensors(sensors) {
+  return (target, propertyKey) => {
+    Reflect.defineMetadata(INTENT_SENSORS_KEY, sensors, target, propertyKey);
   };
 }
-var HANDLER_SENSORS_KEY;
-var init_handler_sensors_decorator = __esm({
-  "src/decorators/handler-sensors.decorator.ts"() {
-    HANDLER_SENSORS_KEY = "axis:handler:sensors";
+var INTENT_SENSORS_KEY;
+var init_intent_sensors_decorator = __esm({
+  "src/decorators/intent-sensors.decorator.ts"() {
+    INTENT_SENSORS_KEY = "axis:intent:sensors";
   }
 });
 
@@ -456,92 +502,6 @@ var init_sensor_decorator = __esm({
   }
 });
 
-// src/decorators/priority-order.decorator.ts
-var require_priority_order_decorator = __commonJS({
-  "src/decorators/priority-order.decorator.ts"(exports) {
-    "use strict";
-    Object.defineProperty(exports, "__esModule", { value: true });
-    exports.priorityOrder = exports.PRIORITY_ORDER_METADATA_KEY = void 0;
-    exports.getPriorityOrder = getPriorityOrder2;
-    exports.comparePriorityOrder = comparePriorityOrder2;
-    exports.getPriorityOrderedTargets = getPriorityOrderedTargets2;
-    exports.PriorityOrder = PriorityOrder2;
-    __require("reflect-metadata");
-    exports.PRIORITY_ORDER_METADATA_KEY = "axis:priority-order";
-    var PRIORITY_ORDER_WEIGHT = {
-      HIGH: 0,
-      MEDIUM: 1,
-      LOW: 2
-    };
-    var priorityOrderRegistry = /* @__PURE__ */ new Set();
-    function normalizePriority(priority) {
-      const normalized = String(priority).toUpperCase();
-      if (normalized === "HIGH" || normalized === "MEDIUM" || normalized === "LOW") {
-        return normalized;
-      }
-      throw new Error(`@PriorityOrder() received invalid priority "${String(priority)}"`);
-    }
-    function normalizeOrder(order) {
-      if (typeof order !== "number" || !Number.isInteger(order) || !Number.isFinite(order) || order < 0) {
-        throw new Error(`@PriorityOrder() requires a non-negative integer order, received "${String(order)}"`);
-      }
-      return order;
-    }
-    function isPriorityOrderOptions(value) {
-      return !!value && typeof value === "object" && !Array.isArray(value);
-    }
-    function resolvePriorityOrder(priorityOrOptions, order = 0) {
-      if (isPriorityOrderOptions(priorityOrOptions)) {
-        return {
-          priority: normalizePriority(priorityOrOptions.priority ?? "MEDIUM"),
-          order: normalizeOrder(priorityOrOptions.order ?? 0)
-        };
-      }
-      return {
-        priority: normalizePriority(priorityOrOptions ?? "MEDIUM"),
-        order: normalizeOrder(order)
-      };
-    }
-    function getPriorityOrder2(target) {
-      return Reflect.getMetadata(exports.PRIORITY_ORDER_METADATA_KEY, target) ?? null;
-    }
-    function comparePriorityOrder2(left, right) {
-      const priorityDelta = PRIORITY_ORDER_WEIGHT[left.priority] - PRIORITY_ORDER_WEIGHT[right.priority];
-      if (priorityDelta !== 0) {
-        return priorityDelta;
-      }
-      return left.order - right.order;
-    }
-    function getPriorityOrderedTargets2(targets) {
-      const pool = targets ? Array.from(targets) : Array.from(priorityOrderRegistry);
-      return pool.sort((left, right) => {
-        const leftMeta = getPriorityOrder2(left);
-        const rightMeta = getPriorityOrder2(right);
-        if (!leftMeta && !rightMeta) {
-          return (left.name || "").localeCompare(right.name || "");
-        }
-        if (!leftMeta)
-          return 1;
-        if (!rightMeta)
-          return -1;
-        const ordered = comparePriorityOrder2(leftMeta, rightMeta);
-        if (ordered !== 0) {
-          return ordered;
-        }
-        return (left.name || "").localeCompare(right.name || "");
-      });
-    }
-    function PriorityOrder2(priorityOrOptions, order = 0) {
-      const definition = resolvePriorityOrder(priorityOrOptions, order);
-      return (target) => {
-        Reflect.defineMetadata(exports.PRIORITY_ORDER_METADATA_KEY, definition, target);
-        priorityOrderRegistry.add(target);
-      };
-    }
-    exports.priorityOrder = PriorityOrder2;
-  }
-});
-
 // src/decorators/tlv-field.decorator.ts
 var require_tlv_field_decorator = __commonJS({
   "src/decorators/tlv-field.decorator.ts"(exports) {
@@ -2415,15 +2375,19 @@ function observerRefKey(ref) {
 function sensorRefKey(ref) {
   return typeof ref === "string" ? ref : ref.name;
 }
-function mergeIntentSensorRefs(...sensorGroups) {
+function sensorBindingKey(binding) {
+  return `${binding.when}:${sensorRefKey(binding.ref)}`;
+}
+function mergeIntentSensorBindings(...sensorGroups) {
   const merged = /* @__PURE__ */ new Map();
   for (const group of sensorGroups) {
     if (!Array.isArray(group)) continue;
-    for (const ref of group) {
-      const key = sensorRefKey(ref);
+    for (const input of group) {
+      const binding = toIntentSensorBinding(input);
+      const key = sensorBindingKey(binding);
       const existing = merged.get(key);
-      if (!existing || typeof existing === "string" && typeof ref !== "string") {
-        merged.set(key, ref);
+      if (!existing || typeof existing.ref === "string" && typeof binding.ref !== "string") {
+        merged.set(key, binding);
       }
     }
   }
@@ -2726,9 +2690,9 @@ var init_intent_router = __esm({
             if (!handler) {
               throw new Error(`Intent not found: ${intent}`);
             }
-            const sensorRefs = this.intentSensors.get(intent);
-            if (sensorRefs && sensorRefs.length > 0) {
-              await this.runIntentSensors(sensorRefs, intent, frame);
+            const sensorBindings = this.intentSensors.get(intent);
+            if (sensorBindings && sensorBindings.length > 0) {
+              await this.runIntentSensors(sensorBindings, intent, frame, "before");
             }
             const decoder = this.intentDecoders.get(intent);
             let decodedBody = frame.body;
@@ -2770,6 +2734,12 @@ var init_intent_router = __esm({
                 );
               }
             }
+            if (sensorBindings && sensorBindings.length > 0) {
+              await this.runIntentSensors(sensorBindings, intent, frame, "after", {
+                decodedBody,
+                effect
+              });
+            }
           }
           await this.emitIntentObservers(observerBindings, {
             event: "intent.completed",
@@ -2813,7 +2783,7 @@ var init_intent_router = __esm({
           methodName
         );
         const meta = Reflect.getMetadata(INTENT_METADATA_KEY, proto, methodName);
-        const combined = mergeIntentSensorRefs(
+        const combined = mergeIntentSensorBindings(
           handlerSensors,
           Array.isArray(intentSensors) ? intentSensors : void 0,
           Array.isArray(meta?.is) ? meta.is : void 0
@@ -2955,8 +2925,10 @@ var init_intent_router = __esm({
         if (!this.observerDispatcher || bindings.length === 0) return;
         await this.observerDispatcher.dispatch(bindings, context);
       }
-      async runIntentSensors(sensorRefs, intent, frame) {
-        for (const sensorRef of sensorRefs) {
+      async runIntentSensors(sensorBindings, intent, frame, stage, extras) {
+        for (const binding of sensorBindings) {
+          if (binding.when !== stage && binding.when !== "both") continue;
+          const sensorRef = binding.ref;
           const sensor = this.resolveIntentSensor(sensorRef);
           const sensorName = sensorRefKey(sensorRef);
           if (!sensor) {
@@ -2973,9 +2945,12 @@ var init_intent_router = __esm({
             frameBody: frame.body,
             metadata: {
               phase: "intent",
+              stage,
               intent,
               schema: this.getSchema(intent),
-              validators: this.getValidators(intent)
+              validators: this.getValidators(intent),
+              decodedBody: extras?.decodedBody,
+              effect: extras?.effect
             }
           };
           if (sensor.supports && !sensor.supports(sensorInput)) continue;
@@ -12634,7 +12609,6 @@ __export(index_exports, {
   ObserverDispatcherService: () => ObserverDispatcherService,
   ObserverRegistry: () => ObserverRegistry,
   PRE_DECODE_BOUNDARY: () => PRE_DECODE_BOUNDARY,
-  PRIORITY_ORDER_METADATA_KEY: () => import_priority_order.PRIORITY_ORDER_METADATA_KEY,
   PROOF_CAPABILITIES: () => PROOF_CAPABILITIES,
   PROOF_CAPSULE: () => PROOF_CAPSULE,
   PROOF_JWT: () => PROOF_JWT,
@@ -12642,7 +12616,6 @@ __export(index_exports, {
   PROOF_MTLS: () => PROOF_MTLS,
   PROOF_NONE: () => PROOF_NONE,
   PROOF_WITNESS: () => PROOF_WITNESS,
-  PriorityOrder: () => import_priority_order.PriorityOrder,
   ProofType: () => ProofType,
   ProofVerificationService: () => ProofVerificationService,
   REQUIRED_PROOF_METADATA_KEY: () => REQUIRED_PROOF_METADATA_KEY,
@@ -12734,7 +12707,6 @@ __export(index_exports, {
   canonicalizeObservation: () => canonicalizeObservation,
   canonicalizeWrit: () => canonicalizeWrit,
   classifyIntent: () => classifyIntent,
-  comparePriorityOrder: () => import_priority_order.comparePriorityOrder,
   computeReceiptHash: () => computeReceiptHash,
   computeSignaturePayload: () => computeSignaturePayload,
   createFabric: () => createFabric,
@@ -12779,8 +12751,6 @@ __export(index_exports, {
   getGrantStatus: () => getGrantStatus,
   getIrreversibleKnots: () => getIrreversibleKnots,
   getPresenceStatus: () => getPresenceStatus,
-  getPriorityOrder: () => import_priority_order.getPriorityOrder,
-  getPriorityOrderedTargets: () => import_priority_order.getPriorityOrderedTargets,
   getSignTarget: () => getSignTarget,
   grantCoversAction: () => grantCoversAction,
   hasScope: () => hasScope,
@@ -12805,7 +12775,6 @@ __export(index_exports, {
   parseAutoClaimEntries: () => parseAutoClaimEntries,
   parseScope: () => parseScope,
   parseStreamEntries: () => parseStreamEntries,
-  priorityOrder: () => import_priority_order.priorityOrder,
   projectAt: () => projectAt,
   queryFabric: () => queryFabric,
   recordOccurrence: () => recordOccurrence,
@@ -12822,6 +12791,8 @@ __export(index_exports, {
   startStage: () => startStage,
   tieKnot: () => tieKnot,
   tlv: () => tlv,
+  toIntentSensorBinding: () => toIntentSensorBinding,
+  toObserverBinding: () => toObserverBinding,
   u64be: () => u64be,
   unpackPasskeyLoginOptionsReq: () => unpackPasskeyLoginOptionsReq,
   unpackPasskeyLoginVerifyReq: () => unpackPasskeyLoginVerifyReq,
@@ -12842,7 +12813,7 @@ __export(index_exports, {
   weave: () => weave,
   withAxisExecutionContext: () => withAxisExecutionContext
 });
-var import_priority_order, import_tlv_field2, import_dto_schema2, import_axis_id, import_axis_response;
+var import_tlv_field2, import_dto_schema2, import_axis_id, import_axis_response;
 var init_index = __esm({
   "src/index.ts"() {
     init_chain_decorator();
@@ -12853,9 +12824,9 @@ var init_index = __esm({
     init_intent_body_decorator();
     init_intent_sensors_decorator();
     init_observer_decorator();
+    init_observer_decorator();
     init_handler_sensors_decorator();
     init_sensor_decorator();
-    import_priority_order = __toESM(require_priority_order_decorator());
     import_tlv_field2 = __toESM(require_tlv_field_decorator());
     import_dto_schema2 = __toESM(require_dto_schema_util());
     init_axis_tlv_dto();
@@ -12927,8 +12898,6 @@ var init_index = __esm({
 init_index();
 var export_AxisIdDto = import_axis_id.AxisIdDto;
 var export_AxisResponseDto = import_axis_response.AxisResponseDto;
-var export_PRIORITY_ORDER_METADATA_KEY = import_priority_order.PRIORITY_ORDER_METADATA_KEY;
-var export_PriorityOrder = import_priority_order.PriorityOrder;
 var export_RESPONSE_TAG_CREATED_AT = import_axis_response.RESPONSE_TAG_CREATED_AT;
 var export_RESPONSE_TAG_CREATED_BY = import_axis_response.RESPONSE_TAG_CREATED_BY;
 var export_RESPONSE_TAG_ID = import_axis_response.RESPONSE_TAG_ID;
@@ -12943,11 +12912,7 @@ var export_TlvRange = import_tlv_field2.TlvRange;
 var export_TlvUtf8Pattern = import_tlv_field2.TlvUtf8Pattern;
 var export_TlvValidate = import_tlv_field2.TlvValidate;
 var export_buildDtoDecoder = import_dto_schema2.buildDtoDecoder;
-var export_comparePriorityOrder = import_priority_order.comparePriorityOrder;
 var export_extractDtoSchema = import_dto_schema2.extractDtoSchema;
-var export_getPriorityOrder = import_priority_order.getPriorityOrder;
-var export_getPriorityOrderedTargets = import_priority_order.getPriorityOrderedTargets;
-var export_priorityOrder = import_priority_order.priorityOrder;
 export {
   ATS1_HDR,
   ATS1_SCHEMA,
@@ -13045,7 +13010,6 @@ export {
   ObserverDispatcherService,
   ObserverRegistry,
   PRE_DECODE_BOUNDARY,
-  export_PRIORITY_ORDER_METADATA_KEY as PRIORITY_ORDER_METADATA_KEY,
   PROOF_CAPABILITIES,
   PROOF_CAPSULE,
   PROOF_JWT,
@@ -13053,7 +13017,6 @@ export {
   PROOF_MTLS,
   PROOF_NONE,
   PROOF_WITNESS,
-  export_PriorityOrder as PriorityOrder,
   ProofType,
   ProofVerificationService,
   REQUIRED_PROOF_METADATA_KEY,
@@ -13145,7 +13108,6 @@ export {
   canonicalizeObservation,
   canonicalizeWrit,
   classifyIntent,
-  export_comparePriorityOrder as comparePriorityOrder,
   computeReceiptHash,
   computeSignaturePayload,
   createFabric,
@@ -13190,8 +13152,6 @@ export {
   getGrantStatus,
   getIrreversibleKnots,
   getPresenceStatus,
-  export_getPriorityOrder as getPriorityOrder,
-  export_getPriorityOrderedTargets as getPriorityOrderedTargets,
   getSignTarget,
   grantCoversAction,
   hasScope,
@@ -13216,7 +13176,6 @@ export {
   parseAutoClaimEntries,
   parseScope,
   parseStreamEntries,
-  export_priorityOrder as priorityOrder,
   projectAt,
   queryFabric,
   recordOccurrence,
@@ -13233,6 +13192,8 @@ export {
   startStage,
   tieKnot,
   tlv,
+  toIntentSensorBinding,
+  toObserverBinding,
   u64be,
   unpackPasskeyLoginOptionsReq,
   unpackPasskeyLoginVerifyReq,