@nextera.one/axis-server-sdk 2.2.3 → 2.2.5

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";
   }
 });
 
@@ -1106,6 +1152,7 @@ var init_axis_chain_executor = __esm({
           timestamp: startedAt,
           chainId: envelope.chainId,
           stepId: step.stepId,
+          handler: step.handler,
           intent: step.intent,
           envelope,
           step,
@@ -1140,6 +1187,7 @@ var init_axis_chain_executor = __esm({
             timestamp: finishedAt,
             chainId: envelope.chainId,
             stepId: step.stepId,
+            handler: step.handler,
             intent: step.intent,
             effect,
             envelope,
@@ -1154,6 +1202,7 @@ var init_axis_chain_executor = __esm({
             timestamp: finishedAt,
             chainId: envelope.chainId,
             stepId: step.stepId,
+            handler: step.handler,
             intent: step.intent,
             envelope,
             step,
@@ -1168,6 +1217,7 @@ var init_axis_chain_executor = __esm({
             timestamp: finishedAt,
             chainId: envelope.chainId,
             stepId: step.stepId,
+            handler: step.handler,
             intent: step.intent,
             effect,
             envelope,
@@ -1198,6 +1248,7 @@ var init_axis_chain_executor = __esm({
             timestamp: finishedAt,
             chainId: envelope.chainId,
             stepId: step.stepId,
+            handler: step.handler,
             intent: step.intent,
             error: error.message,
             envelope,
@@ -2329,15 +2380,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);
       }
     }
   }
@@ -2412,6 +2467,8 @@ var init_intent_router = __esm({
         this.handlers = /* @__PURE__ */ new Map();
         /** Per-intent sensor refs (resolved through SensorRegistry at call time) */
         this.intentSensors = /* @__PURE__ */ new Map();
+        /** Per-intent handler identifier (e.g. UsersHandler.usersPage) */
+        this.intentHandlerRefs = /* @__PURE__ */ new Map();
         /** Per-intent body decoders */
         this.intentDecoders = /* @__PURE__ */ new Map();
         /** Per-intent TLV schemas */
@@ -2487,6 +2544,16 @@ var init_intent_router = __esm({
        */
       register(intent, handler) {
         this.handlers.set(intent, handler);
+        if (typeof handler === "function" && handler.name) {
+          this.intentHandlerRefs.set(intent, handler.name);
+        } else if (handler && typeof handler === "object") {
+          const objectName = handler.constructor?.name;
+          if (objectName) {
+            this.intentHandlerRefs.set(intent, `${objectName}.handle`);
+          }
+        } else {
+          this.intentHandlerRefs.set(intent, `intent:${intent}`);
+        }
       }
       /**
        * Automatically registers all `@Intent`-decorated methods from a handler instance.
@@ -2517,6 +2584,10 @@ var init_intent_router = __esm({
           } else {
             this.register(intentName, fn);
           }
+          this.intentHandlerRefs.set(
+            intentName,
+            `${instance.constructor.name}.${String(route.methodName)}`
+          );
           this.registerIntentMeta(
             intentName,
             proto,
@@ -2557,15 +2628,18 @@ var init_intent_router = __esm({
       async route(frame) {
         const start = process.hrtime();
         let intent = "unknown";
+        let handlerRef;
         try {
           const intentBytes = frame.headers.get(TLV_INTENT);
           if (!intentBytes) throw new Error("Missing intent");
           intent = this.decoder.decode(intentBytes);
+          handlerRef = this.intentHandlerRefs.get(intent);
           const observerBindings = this.getObservers(intent);
           await this.emitIntentObservers(observerBindings, {
             event: "intent.received",
             timestamp: Date.now(),
             intent,
+            handler: handlerRef,
             frame
           });
           let effect;
@@ -2640,9 +2714,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;
@@ -2684,11 +2758,18 @@ 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",
             timestamp: Date.now(),
             intent,
+            handler: handlerRef,
             frame,
             effect,
             metadata: effect.metadata
@@ -2700,6 +2781,7 @@ var init_intent_router = __esm({
             event: "intent.failed",
             timestamp: Date.now(),
             intent,
+            handler: handlerRef,
             frame,
             error: e.message
           });
@@ -2727,7 +2809,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
@@ -2869,8 +2951,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) {
@@ -2887,9 +2971,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;
@@ -8068,6 +8155,61 @@ var init_disk_upload_file_store = __esm({
 function unique(values) {
   return Array.from(new Set(values));
 }
+function matchesObserverIntent(intents, intent) {
+  if (!intents || intents.length === 0) {
+    return true;
+  }
+  if (!intent) {
+    return false;
+  }
+  return intents.includes(intent);
+}
+function normalizeHandlerToken(value) {
+  return value.trim().toLowerCase();
+}
+function matchesObserverHandler(handlers, handler) {
+  if (!handlers || handlers.length === 0) {
+    return true;
+  }
+  if (!handler) {
+    return false;
+  }
+  const normalizedHandler = normalizeHandlerToken(handler);
+  return handlers.some((candidate) => {
+    if (!candidate) {
+      return false;
+    }
+    const normalizedCandidate = normalizeHandlerToken(candidate);
+    return normalizedHandler === normalizedCandidate || normalizedHandler.endsWith(`.${normalizedCandidate}`) || normalizedHandler.startsWith(`${normalizedCandidate}.`) || normalizedCandidate.endsWith(`.${normalizedHandler}`) || normalizedCandidate.startsWith(`${normalizedHandler}.`);
+  });
+}
+function observerRefKey2(ref) {
+  return typeof ref === "string" ? ref : ref.name || "(anonymous)";
+}
+function mergeBindingRefs(...bindingGroups) {
+  const merged = /* @__PURE__ */ new Map();
+  for (const bindings of bindingGroups) {
+    for (const binding of bindings) {
+      for (const ref of binding.refs) {
+        const key = observerRefKey2(ref);
+        const current = merged.get(key);
+        if (!current) {
+          merged.set(key, {
+            refs: [ref],
+            tags: binding.tags ? [...new Set(binding.tags)] : void 0,
+            events: binding.events ? [...new Set(binding.events)] : void 0
+          });
+          continue;
+        }
+        current.tags = Array.from(
+          /* @__PURE__ */ new Set([...current.tags || [], ...binding.tags || []])
+        );
+        current.events = current.events === void 0 || binding.events === void 0 ? void 0 : Array.from(/* @__PURE__ */ new Set([...current.events || [], ...binding.events]));
+      }
+    }
+  }
+  return Array.from(merged.values());
+}
 var ObserverDispatcherService;
 var init_observer_dispatcher_service = __esm({
   "src/engine/observer-dispatcher.service.ts"() {
@@ -8078,9 +8220,20 @@ var init_observer_dispatcher_service = __esm({
         this.logger = createAxisLogger(_ObserverDispatcherService.name);
       }
       async dispatch(bindings, context) {
-        if (!bindings || bindings.length === 0) return;
+        const explicitBindings = bindings || [];
+        const implicitRegistrations = this.getImplicitRegistrations();
+        if (!explicitBindings.length && implicitRegistrations.length === 0) {
+          return;
+        }
         const invoked = /* @__PURE__ */ new Set();
-        for (const binding of bindings) {
+        const implicitBindings = implicitRegistrations.map(
+          (registration) => ({
+            refs: [registration.instance.constructor],
+            events: registration.events
+          })
+        );
+        const merged = mergeBindingRefs(explicitBindings, implicitBindings);
+        for (const binding of merged) {
           if (binding.events && binding.events.length > 0 && !binding.events.includes(context.event)) {
             continue;
           }
@@ -8091,6 +8244,9 @@ var init_observer_dispatcher_service = __esm({
               continue;
             }
             if (invoked.has(registration.name)) continue;
+            if (!matchesObserverIntent(registration.intents, context.intent) || !matchesObserverHandler(registration.handlers, context.handler)) {
+              continue;
+            }
             if (registration.events && registration.events.length > 0 && !registration.events.includes(context.event)) {
               continue;
             }
@@ -8116,6 +8272,9 @@ var init_observer_dispatcher_service = __esm({
           }
         }
       }
+      getImplicitRegistrations() {
+        return this.registry.list();
+      }
     };
   }
 });
@@ -12730,6 +12889,8 @@ __export(index_exports, {
   startStage: () => startStage,
   tieKnot: () => tieKnot,
   tlv: () => tlv,
+  toIntentSensorBinding: () => toIntentSensorBinding,
+  toObserverBinding: () => toObserverBinding,
   u64be: () => u64be,
   unpackPasskeyLoginOptionsReq: () => unpackPasskeyLoginOptionsReq,
   unpackPasskeyLoginVerifyReq: () => unpackPasskeyLoginVerifyReq,
@@ -12761,6 +12922,7 @@ 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_tlv_field2 = __toESM(require_tlv_field_decorator());
@@ -13128,6 +13290,8 @@ export {
   startStage,
   tieKnot,
   tlv,
+  toIntentSensorBinding,
+  toObserverBinding,
   u64be,
   unpackPasskeyLoginOptionsReq,
   unpackPasskeyLoginVerifyReq,