@nextera.one/axis-server-sdk 1.0.0 → 1.1.0

package/dist/index.mjs

@@ -31,20 +31,366 @@ function Handler(intent) {
 
 // src/decorators/intent.decorator.ts
 import "reflect-metadata";
+var INTENT_METADATA_KEY = "axis:intent";
 var INTENT_ROUTES_KEY = "axis:intent_routes";
 function Intent(action, options) {
   return (target, propertyKey) => {
+    Reflect.defineMetadata(
+      INTENT_METADATA_KEY,
+      { intent: action, ...options },
+      target,
+      propertyKey
+    );
     const routes = Reflect.getMetadata(INTENT_ROUTES_KEY, target.constructor) || [];
     routes.push({
       action,
       methodName: propertyKey,
       absolute: options?.absolute,
-      frame: options?.frame
+      frame: options?.frame,
+      kind: options?.kind,
+      bodyProfile: options?.bodyProfile,
+      tlv: options?.tlv,
+      dto: options?.dto
     });
     Reflect.defineMetadata(INTENT_ROUTES_KEY, routes, target.constructor);
   };
 }
 
+// src/decorators/tlv-field.decorator.ts
+import "reflect-metadata";
+var TLV_FIELDS_KEY = "axis:tlv:fields";
+var TLV_VALIDATORS_KEY = "axis:tlv:validators";
+function TlvField(tag, options) {
+  return (target, propertyKey) => {
+    const existing = Reflect.getOwnMetadata(TLV_FIELDS_KEY, target.constructor) || [];
+    existing.push({
+      property: String(propertyKey),
+      tag,
+      options
+    });
+    Reflect.defineMetadata(TLV_FIELDS_KEY, existing, target.constructor);
+  };
+}
+function TlvValidate(validator) {
+  return (target, propertyKey) => {
+    const existing = Reflect.getOwnMetadata(TLV_VALIDATORS_KEY, target.constructor) || [];
+    const prop = String(propertyKey);
+    let entry = existing.find((e) => e.property === prop);
+    if (!entry) {
+      entry = { property: prop, tag: 0, validators: [] };
+      existing.push(entry);
+    }
+    entry.validators.push(validator);
+    Reflect.defineMetadata(TLV_VALIDATORS_KEY, existing, target.constructor);
+  };
+}
+function TlvUtf8Pattern(pattern, message) {
+  return TlvValidate((val, prop) => {
+    const str = new TextDecoder().decode(val);
+    return pattern.test(str) ? null : message || `${prop}: failed pattern check`;
+  });
+}
+function TlvMinLen(min, message) {
+  return TlvValidate((val, prop) => {
+    return val.length >= min ? null : message || `${prop}: too short (${val.length} < ${min})`;
+  });
+}
+function TlvEnum(allowed, message) {
+  const set = new Set(allowed);
+  return TlvValidate((val, prop) => {
+    const str = new TextDecoder().decode(val);
+    return set.has(str) ? null : message || `${prop}: must be one of [${allowed.join(", ")}]`;
+  });
+}
+function TlvRange(min, max, message) {
+  return TlvValidate((val, prop) => {
+    if (val.length !== 8) return `${prop}: u64 must be 8 bytes`;
+    let n = 0n;
+    for (const b of val) n = n << 8n | BigInt(b);
+    if (n < min || n > max) {
+      return message || `${prop}: value ${n} out of range [${min}, ${max}]`;
+    }
+    return null;
+  });
+}
+
+// src/decorators/dto-schema.util.ts
+import "reflect-metadata";
+
+// src/core/varint.ts
+function encodeVarint(value) {
+  if (value < 0) throw new Error("Varint must be unsigned");
+  const bytes2 = [];
+  while (true) {
+    const byte = value & 127;
+    value >>>= 7;
+    if (value === 0) {
+      bytes2.push(byte);
+      break;
+    }
+    bytes2.push(byte | 128);
+  }
+  return new Uint8Array(bytes2);
+}
+function decodeVarint(buf, offset = 0) {
+  let value = 0;
+  let shift = 0;
+  let length = 0;
+  while (true) {
+    if (offset + length >= buf.length) {
+      throw new Error("Varint decode out of bounds");
+    }
+    const byte = buf[offset + length];
+    value += (byte & 127) * Math.pow(2, shift);
+    length++;
+    shift += 7;
+    if ((byte & 128) === 0) {
+      break;
+    }
+    if (length > 8) throw new Error("Varint too large");
+  }
+  return { value, length };
+}
+function varintLength(value) {
+  if (value < 0) throw new Error("Varint must be unsigned");
+  let len = 0;
+  do {
+    value >>>= 7;
+    len++;
+  } while (value !== 0);
+  return len;
+}
+
+// src/core/tlv.ts
+function encodeTLVs(tlvs) {
+  const sorted = [...tlvs].sort((a, b) => a.type - b.type);
+  for (let i = 0; i < sorted.length - 1; i++) {
+    if (sorted[i].type === sorted[i + 1].type) {
+      throw new Error(`Duplicate TLV type: ${sorted[i].type}`);
+    }
+  }
+  let totalSize = 0;
+  for (const t of sorted) {
+    totalSize += varintLength(t.type);
+    totalSize += varintLength(t.value.length);
+    totalSize += t.value.length;
+  }
+  const buf = new Uint8Array(totalSize);
+  let offset = 0;
+  for (const t of sorted) {
+    const typeBytes = encodeVarint(t.type);
+    buf.set(typeBytes, offset);
+    offset += typeBytes.length;
+    const lenBytes = encodeVarint(t.value.length);
+    buf.set(lenBytes, offset);
+    offset += lenBytes.length;
+    buf.set(t.value, offset);
+    offset += t.value.length;
+  }
+  return buf;
+}
+function decodeTLVsList(buf, maxItems = 1024) {
+  const list = [];
+  let offset = 0;
+  while (offset < buf.length) {
+    if (list.length >= maxItems) throw new Error("TLV_LIMIT");
+    const { value: type, length: typeLen } = decodeVarint(buf, offset);
+    offset += typeLen;
+    const { value: len, length: lenLen } = decodeVarint(buf, offset);
+    offset += lenLen;
+    if (offset + len > buf.length) {
+      throw new Error(`TLV violation: Length ${len} exceeds buffer`);
+    }
+    const value = buf.slice(offset, offset + len);
+    list.push({ type, value });
+    offset += len;
+  }
+  return list;
+}
+function decodeTLVs(buf) {
+  const map2 = /* @__PURE__ */ new Map();
+  let offset = 0;
+  let lastType = -1;
+  while (offset < buf.length) {
+    const { value: type, length: typeLen } = decodeVarint(buf, offset);
+    offset += typeLen;
+    if (type <= lastType) {
+      throw new Error(
+        `TLV violation: Unsorted or duplicate type ${type} after ${lastType}`
+      );
+    }
+    lastType = type;
+    const { value: len, length: lenLen } = decodeVarint(buf, offset);
+    offset += lenLen;
+    if (offset + len > buf.length) {
+      throw new Error(`TLV violation: Length ${len} exceeds buffer`);
+    }
+    const value = buf.slice(offset, offset + len);
+    map2.set(type, value);
+    offset += len;
+  }
+  return map2;
+}
+function decodeObject(bytes2, depth = 0, limits = { maxDepth: 8, maxItems: 128 }) {
+  if (depth > limits.maxDepth) {
+    throw new Error("OBJECT_DEPTH_EXCEEDED");
+  }
+  const map2 = decodeTLVs(bytes2);
+  return map2;
+}
+function decodeArray(bytes2, itemType, maxItems = 256) {
+  const list = decodeTLVsList(bytes2, maxItems);
+  const items = [];
+  for (const tlv2 of list) {
+    if (tlv2.type !== itemType) {
+      throw new Error(`INVALID_ARRAY_ITEM:${tlv2.type}`);
+    }
+    items.push(tlv2.value);
+  }
+  return items;
+}
+
+// src/decorators/dto-schema.util.ts
+function extractDtoSchema(dto) {
+  const fieldMetas = Reflect.getOwnMetadata(TLV_FIELDS_KEY, dto) || [];
+  if (fieldMetas.length === 0) {
+    throw new Error(
+      `DTO class ${dto.name} has no @TlvField decorators \u2014 nothing to validate`
+    );
+  }
+  const tagByProp = /* @__PURE__ */ new Map();
+  const fields = fieldMetas.map((m) => {
+    tagByProp.set(m.property, m.tag);
+    return {
+      name: m.property,
+      tag: m.tag,
+      kind: m.options.kind,
+      required: m.options.required,
+      maxLen: m.options.maxLen,
+      max: m.options.max,
+      scope: m.options.scope
+    };
+  });
+  const validatorMetas = Reflect.getOwnMetadata(TLV_VALIDATORS_KEY, dto) || [];
+  const validators = /* @__PURE__ */ new Map();
+  for (const vm of validatorMetas) {
+    const tag = tagByProp.get(vm.property);
+    if (tag === void 0) {
+      throw new Error(
+        `@TlvValidate on ${dto.name}.${vm.property} but no @TlvField found for that property`
+      );
+    }
+    vm.tag = tag;
+    validators.set(tag, vm.validators);
+  }
+  return { fields, validators };
+}
+function buildDtoDecoder(dto) {
+  const fieldMetas = Reflect.getOwnMetadata(TLV_FIELDS_KEY, dto) || [];
+  if (fieldMetas.length === 0) {
+    throw new Error(
+      `DTO class ${dto.name} has no @TlvField decorators \u2014 cannot build decoder`
+    );
+  }
+  const tagMap = /* @__PURE__ */ new Map();
+  for (const m of fieldMetas) {
+    tagMap.set(m.tag, { property: m.property, kind: m.options.kind });
+  }
+  return (bodyBytes) => {
+    const tlvMap2 = decodeTLVs(new Uint8Array(bodyBytes));
+    const result = {};
+    for (const [tag, raw] of tlvMap2) {
+      const meta = tagMap.get(tag);
+      if (!meta) continue;
+      switch (meta.kind) {
+        case "utf8":
+          result[meta.property] = new TextDecoder().decode(raw);
+          break;
+        case "u64": {
+          let n = 0n;
+          for (let i = 0; i < raw.length; i++) {
+            n = n << 8n | BigInt(raw[i]);
+          }
+          result[meta.property] = n;
+          break;
+        }
+        case "bytes":
+        case "bytes16":
+          result[meta.property] = raw;
+          break;
+        case "bool":
+          result[meta.property] = raw.length > 0 && raw[0] !== 0;
+          break;
+        case "obj":
+        case "arr":
+          result[meta.property] = JSON.parse(new TextDecoder().decode(raw));
+          break;
+        default:
+          result[meta.property] = raw;
+      }
+    }
+    return result;
+  };
+}
+
+// src/base/axis-tlv.dto.ts
+var AxisTlvDto = class {
+};
+
+// src/base/axis-id.dto.ts
+var AxisIdDto = class extends AxisTlvDto {
+};
+__decorateClass([
+  TlvField(1, { kind: "utf8", required: true, maxLen: 128 }),
+  TlvMinLen(1, "id must not be empty")
+], AxisIdDto.prototype, "id", 2);
+
+// src/base/axis-partial-type.ts
+import "reflect-metadata";
+function AxisPartialType(BaseDto) {
+  class PartialDto extends BaseDto {
+  }
+  const fields = Reflect.getOwnMetadata(TLV_FIELDS_KEY, BaseDto) || [];
+  const partialFields = fields.map((f) => ({
+    property: f.property,
+    tag: f.tag,
+    options: { ...f.options, required: false }
+  }));
+  Reflect.defineMetadata(TLV_FIELDS_KEY, partialFields, PartialDto);
+  const validators = Reflect.getOwnMetadata(TLV_VALIDATORS_KEY, BaseDto) || [];
+  if (validators.length > 0) {
+    Reflect.defineMetadata(TLV_VALIDATORS_KEY, [...validators], PartialDto);
+  }
+  Object.defineProperty(PartialDto, "name", {
+    value: `Partial${BaseDto.name}`
+  });
+  return PartialDto;
+}
+
+// src/base/axis-response.dto.ts
+var RESPONSE_TAG_ID = 1;
+var RESPONSE_TAG_CREATED_AT = 2;
+var RESPONSE_TAG_UPDATED_AT = 3;
+var RESPONSE_TAG_CREATED_BY = 4;
+var RESPONSE_TAG_UPDATED_BY = 5;
+var AxisResponseDto = class extends AxisTlvDto {
+};
+__decorateClass([
+  TlvField(RESPONSE_TAG_ID, { kind: "utf8" })
+], AxisResponseDto.prototype, "id", 2);
+__decorateClass([
+  TlvField(RESPONSE_TAG_CREATED_AT, { kind: "u64" })
+], AxisResponseDto.prototype, "created_at", 2);
+__decorateClass([
+  TlvField(RESPONSE_TAG_UPDATED_AT, { kind: "u64" })
+], AxisResponseDto.prototype, "updated_at", 2);
+__decorateClass([
+  TlvField(RESPONSE_TAG_CREATED_BY, { kind: "utf8" })
+], AxisResponseDto.prototype, "created_by", 2);
+__decorateClass([
+  TlvField(RESPONSE_TAG_UPDATED_BY, { kind: "utf8" })
+], AxisResponseDto.prototype, "updated_by", 2);
+
 // src/engine/intent.router.ts
 import { Injectable as Injectable2 } from "@nestjs/common";
 var IntentRouter = class {
@@ -285,139 +631,6 @@ var ERR_BAD_SIGNATURE = "BAD_SIGNATURE";
 var ERR_REPLAY_DETECTED = "REPLAY_DETECTED";
 var ERR_CONTRACT_VIOLATION = "CONTRACT_VIOLATION";
 
-// src/core/varint.ts
-function encodeVarint(value) {
-  if (value < 0) throw new Error("Varint must be unsigned");
-  const bytes2 = [];
-  while (true) {
-    const byte = value & 127;
-    value >>>= 7;
-    if (value === 0) {
-      bytes2.push(byte);
-      break;
-    }
-    bytes2.push(byte | 128);
-  }
-  return new Uint8Array(bytes2);
-}
-function decodeVarint(buf, offset = 0) {
-  let value = 0;
-  let shift = 0;
-  let length = 0;
-  while (true) {
-    if (offset + length >= buf.length) {
-      throw new Error("Varint decode out of bounds");
-    }
-    const byte = buf[offset + length];
-    value += (byte & 127) * Math.pow(2, shift);
-    length++;
-    shift += 7;
-    if ((byte & 128) === 0) {
-      break;
-    }
-    if (length > 8) throw new Error("Varint too large");
-  }
-  return { value, length };
-}
-function varintLength(value) {
-  if (value < 0) throw new Error("Varint must be unsigned");
-  let len = 0;
-  do {
-    value >>>= 7;
-    len++;
-  } while (value !== 0);
-  return len;
-}
-
-// src/core/tlv.ts
-function encodeTLVs(tlvs) {
-  const sorted = [...tlvs].sort((a, b) => a.type - b.type);
-  for (let i = 0; i < sorted.length - 1; i++) {
-    if (sorted[i].type === sorted[i + 1].type) {
-      throw new Error(`Duplicate TLV type: ${sorted[i].type}`);
-    }
-  }
-  let totalSize = 0;
-  for (const t of sorted) {
-    totalSize += varintLength(t.type);
-    totalSize += varintLength(t.value.length);
-    totalSize += t.value.length;
-  }
-  const buf = new Uint8Array(totalSize);
-  let offset = 0;
-  for (const t of sorted) {
-    const typeBytes = encodeVarint(t.type);
-    buf.set(typeBytes, offset);
-    offset += typeBytes.length;
-    const lenBytes = encodeVarint(t.value.length);
-    buf.set(lenBytes, offset);
-    offset += lenBytes.length;
-    buf.set(t.value, offset);
-    offset += t.value.length;
-  }
-  return buf;
-}
-function decodeTLVsList(buf, maxItems = 1024) {
-  const list = [];
-  let offset = 0;
-  while (offset < buf.length) {
-    if (list.length >= maxItems) throw new Error("TLV_LIMIT");
-    const { value: type, length: typeLen } = decodeVarint(buf, offset);
-    offset += typeLen;
-    const { value: len, length: lenLen } = decodeVarint(buf, offset);
-    offset += lenLen;
-    if (offset + len > buf.length) {
-      throw new Error(`TLV violation: Length ${len} exceeds buffer`);
-    }
-    const value = buf.slice(offset, offset + len);
-    list.push({ type, value });
-    offset += len;
-  }
-  return list;
-}
-function decodeTLVs(buf) {
-  const map2 = /* @__PURE__ */ new Map();
-  let offset = 0;
-  let lastType = -1;
-  while (offset < buf.length) {
-    const { value: type, length: typeLen } = decodeVarint(buf, offset);
-    offset += typeLen;
-    if (type <= lastType) {
-      throw new Error(
-        `TLV violation: Unsorted or duplicate type ${type} after ${lastType}`
-      );
-    }
-    lastType = type;
-    const { value: len, length: lenLen } = decodeVarint(buf, offset);
-    offset += lenLen;
-    if (offset + len > buf.length) {
-      throw new Error(`TLV violation: Length ${len} exceeds buffer`);
-    }
-    const value = buf.slice(offset, offset + len);
-    map2.set(type, value);
-    offset += len;
-  }
-  return map2;
-}
-function decodeObject(bytes2, depth = 0, limits = { maxDepth: 8, maxItems: 128 }) {
-  if (depth > limits.maxDepth) {
-    throw new Error("OBJECT_DEPTH_EXCEEDED");
-  }
-  const map2 = decodeTLVs(bytes2);
-  return map2;
-}
-function decodeArray(bytes2, itemType, maxItems = 256) {
-  const list = decodeTLVsList(bytes2, maxItems);
-  const items = [];
-  for (const tlv2 of list) {
-    if (tlv2.type !== itemType) {
-      throw new Error(`INVALID_ARRAY_ITEM:${tlv2.type}`);
-    }
-    items.push(tlv2.value);
-  }
-  return items;
-}
-
 // src/core/signature.ts
 import * as crypto from "crypto";
 
@@ -2189,7 +2402,11 @@ export {
   AXIS_VERSION,
   ats1_exports as Ats1Codec,
   AxisFrameZ,
+  AxisIdDto,
   T as AxisPacketTags,
+  AxisPartialType,
+  AxisResponseDto,
+  AxisTlvDto,
   BodyProfile,
   CAPABILITIES,
   ContractViolationError,
@@ -2207,6 +2424,7 @@ export {
   FLAG_HAS_WITNESS,
   HANDLER_METADATA_KEY,
   Handler,
+  INTENT_METADATA_KEY,
   INTENT_REQUIREMENTS,
   INTENT_ROUTES_KEY,
   INTENT_SENSITIVITY_MAP,
@@ -2236,6 +2454,11 @@ export {
   PROOF_NONE,
   PROOF_WITNESS,
   ProofType,
+  RESPONSE_TAG_CREATED_AT,
+  RESPONSE_TAG_CREATED_BY,
+  RESPONSE_TAG_ID,
+  RESPONSE_TAG_UPDATED_AT,
+  RESPONSE_TAG_UPDATED_BY,
   RiskDecision,
   Schema2002_PasskeyLoginOptionsRes,
   Schema2011_PasskeyLoginVerifyReq,
@@ -2250,6 +2473,7 @@ export {
   TLV_EFFECT,
   TLV_ERROR_CODE,
   TLV_ERROR_MSG,
+  TLV_FIELDS_KEY,
   TLV_INDEX,
   TLV_INTENT,
   TLV_KID,
@@ -2273,12 +2497,20 @@ export {
   TLV_TRACE_ID,
   TLV_TS,
   TLV_UPLOAD_ID,
+  TLV_VALIDATORS_KEY,
+  TlvEnum,
+  TlvField,
+  TlvMinLen,
+  TlvRange,
+  TlvUtf8Pattern,
+  TlvValidate,
   axis1SigningBytes,
   b64urlDecode,
   b64urlDecodeString,
   b64urlEncode,
   b64urlEncodeString,
   buildAts1Hdr,
+  buildDtoDecoder,
   buildPacket,
   buildReceiptHash,
   buildTLVs,
@@ -2301,6 +2533,7 @@ export {
   encodeFrame,
   encodeTLVs,
   encodeVarint,
+  extractDtoSchema,
   generateEd25519KeyPair,
   getSignTarget,
   hasScope,