@nextera.one/axis-server-sdk 2.1.7 → 2.1.9

package/dist/index.d.mts

@@ -701,6 +701,7 @@ interface IntentRoute extends AxisIntentSensorOptions {
     absolute?: boolean;
     frame?: boolean;
     kind?: IntentKind;
+    sensitivity?: SensitivityLevel;
     chain?: boolean | ChainOptions;
     bodyProfile?: 'TLV_MAP' | 'RAW' | 'TLV_OBJ' | 'TLV_ARR';
     tlv?: IntentTlvField[];
@@ -708,6 +709,7 @@ interface IntentRoute extends AxisIntentSensorOptions {
 }
 interface IntentOptions extends AxisIntentSensorOptions {
     kind?: IntentKind;
+    sensitivity?: SensitivityLevel;
     absolute?: boolean;
     frame?: boolean;
     chain?: boolean | ChainOptions;
@@ -791,6 +793,7 @@ declare function extractDtoSchema(dto: Function): DtoSchema;
 declare function buildDtoDecoder(dto: Function): (bodyBytes: Buffer) => Record<string, any>;
 
 declare abstract class AxisTlvDto {
+    static afterDecode?(dto: Record<string, any>): void;
 }
 
 declare class AxisIdDto extends AxisTlvDto {
@@ -1498,7 +1501,7 @@ declare class IntentRouter {
     route(frame: AxisFrame$2): Promise<AxisEffect>;
     private logIntent;
     registerIntentMeta(intent: string, proto: object, methodName: string, handlerSensors?: AxisIntentSensorRef[], handlerObservers?: AxisObserverBinding[]): void;
-    getSensitivity(intent: string): string | undefined;
+    getSensitivity(intent: string): SensitivityLevel | undefined;
     getContract(intent: string): Record<string, any> | undefined;
     getRequiredProof(intent: string): RequiredProofKind[] | undefined;
     isPublic(intent: string): boolean;

package/dist/index.d.ts

@@ -701,6 +701,7 @@ interface IntentRoute extends AxisIntentSensorOptions {
     absolute?: boolean;
     frame?: boolean;
     kind?: IntentKind;
+    sensitivity?: SensitivityLevel;
     chain?: boolean | ChainOptions;
     bodyProfile?: 'TLV_MAP' | 'RAW' | 'TLV_OBJ' | 'TLV_ARR';
     tlv?: IntentTlvField[];
@@ -708,6 +709,7 @@ interface IntentRoute extends AxisIntentSensorOptions {
 }
 interface IntentOptions extends AxisIntentSensorOptions {
     kind?: IntentKind;
+    sensitivity?: SensitivityLevel;
     absolute?: boolean;
     frame?: boolean;
     chain?: boolean | ChainOptions;
@@ -791,6 +793,7 @@ declare function extractDtoSchema(dto: Function): DtoSchema;
 declare function buildDtoDecoder(dto: Function): (bodyBytes: Buffer) => Record<string, any>;
 
 declare abstract class AxisTlvDto {
+    static afterDecode?(dto: Record<string, any>): void;
 }
 
 declare class AxisIdDto extends AxisTlvDto {
@@ -1498,7 +1501,7 @@ declare class IntentRouter {
     route(frame: AxisFrame$2): Promise<AxisEffect>;
     private logIntent;
     registerIntentMeta(intent: string, proto: object, methodName: string, handlerSensors?: AxisIntentSensorRef[], handlerObservers?: AxisObserverBinding[]): void;
-    getSensitivity(intent: string): string | undefined;
+    getSensitivity(intent: string): SensitivityLevel | undefined;
     getContract(intent: string): Record<string, any> | undefined;
     getRequiredProof(intent: string): RequiredProofKind[] | undefined;
     isPublic(intent: string): boolean;

package/dist/index.js

@@ -327,12 +327,16 @@ __export(intent_decorator_exports, {
 });
 function Intent(action, options) {
   return (target, propertyKey) => {
-    Reflect.defineMetadata(
-      INTENT_METADATA_KEY,
-      { intent: action, ...options },
-      target,
-      propertyKey
-    );
+    const metadata = { intent: action, ...options };
+    Reflect.defineMetadata(INTENT_METADATA_KEY, metadata, target, propertyKey);
+    if (options?.sensitivity) {
+      Reflect.defineMetadata(
+        SENSITIVITY_METADATA_KEY,
+        options.sensitivity,
+        target,
+        propertyKey
+      );
+    }
     const routes = Reflect.getMetadata(INTENT_ROUTES_KEY, target.constructor) || [];
     routes.push({
       action,
@@ -340,6 +344,7 @@ function Intent(action, options) {
       absolute: options?.absolute,
       frame: options?.frame,
       kind: options?.kind,
+      sensitivity: options?.sensitivity,
       chain: options?.chain,
       bodyProfile: options?.bodyProfile,
       tlv: options?.tlv,
@@ -353,6 +358,7 @@ var import_reflect_metadata4, INTENT_METADATA_KEY, INTENT_ROUTES_KEY;
 var init_intent_decorator = __esm({
   "src/decorators/intent.decorator.ts"() {
     import_reflect_metadata4 = require("reflect-metadata");
+    init_intent_policy_decorator();
     INTENT_METADATA_KEY = "axis:intent";
     INTENT_ROUTES_KEY = "axis:intent_routes";
   }
@@ -615,9 +621,12 @@ var require_dto_schema_util = __commonJS({
     var tlv_field_decorator_1 = require_tlv_field_decorator();
     var tlv_1 = (init_tlv(), __toCommonJS(tlv_exports));
     function extractDtoSchema2(dto) {
+      if (typeof dto !== "function") {
+        throw new Error(`extractDtoSchema expected a class constructor but received ${typeof dto} (${String(dto)}) \u2014 did you pass a plain object or instance to @Intent({ dto }) instead of a class?`);
+      }
       const fieldMetas = Reflect.getMetadata(tlv_field_decorator_1.TLV_FIELDS_KEY, dto) || [];
       if (fieldMetas.length === 0) {
-        throw new Error(`DTO class ${dto.name} has no @TlvField decorators \u2014 nothing to validate`);
+        throw new Error(`DTO class ${dto.name || "<anonymous>"} has no @TlvField decorators \u2014 nothing to validate. Make sure the class extends AxisTlvDto and its fields are annotated with @TlvField(tag, { kind }).`);
       }
       const tagByProp = /* @__PURE__ */ new Map();
       const fields = fieldMetas.map((m) => {
@@ -645,14 +654,18 @@ var require_dto_schema_util = __commonJS({
       return { fields, validators };
     }
     function buildDtoDecoder2(dto) {
+      if (typeof dto !== "function") {
+        throw new Error(`buildDtoDecoder expected a class constructor but received ${typeof dto} (${String(dto)}) \u2014 did you pass a plain object or instance to @Intent({ dto }) instead of a class?`);
+      }
       const fieldMetas = Reflect.getMetadata(tlv_field_decorator_1.TLV_FIELDS_KEY, dto) || [];
       if (fieldMetas.length === 0) {
-        throw new Error(`DTO class ${dto.name} has no @TlvField decorators \u2014 cannot build decoder`);
+        throw new Error(`DTO class ${dto.name || "<anonymous>"} has no @TlvField decorators \u2014 cannot build decoder. Make sure the class extends AxisTlvDto and its fields are annotated with @TlvField(tag, { kind }).`);
       }
       const tagMap = /* @__PURE__ */ new Map();
       for (const m of fieldMetas) {
         tagMap.set(m.tag, { property: m.property, kind: m.options.kind });
       }
+      const afterDecode = dto.afterDecode;
       return (bodyBytes) => {
         const tlvMap2 = (0, tlv_1.decodeTLVs)(new Uint8Array(bodyBytes));
         const result = {};
@@ -687,6 +700,7 @@ var require_dto_schema_util = __commonJS({
               result[meta.property] = raw;
           }
         }
+        afterDecode?.(result);
         return result;
       };
     }
@@ -2578,7 +2592,7 @@ var require_intent_router = __commonJS({
         }
         const methodSensitivity = Reflect.getMetadata(intent_policy_decorator_1.SENSITIVITY_METADATA_KEY, proto, methodName);
         const classSensitivity = Reflect.getMetadata(intent_policy_decorator_1.SENSITIVITY_METADATA_KEY, proto.constructor);
-        const sensitivity = methodSensitivity ?? classSensitivity;
+        const sensitivity = meta?.sensitivity ?? methodSensitivity ?? classSensitivity;
         if (sensitivity) {
           this.intentSensitivity.set(intent, sensitivity);
         }