@nextera.one/axis-server-sdk 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,59 @@
+import { OnModuleInit } from '@nestjs/common';
+
+declare const HANDLER_METADATA_KEY = "axis:handler";
+declare function Handler(intent?: string): ClassDecorator;
+
+declare const INTENT_ROUTES_KEY = "axis:intent_routes";
+interface IntentRoute {
+    action: string;
+    methodName: string | symbol;
+    absolute?: boolean;
+    frame?: boolean;
+}
+interface IntentOptions {
+    absolute?: boolean;
+    frame?: boolean;
+}
+declare function Intent(action: string, options?: IntentOptions): MethodDecorator;
+
+interface AxisFrame {
+    flags: number;
+    headers: Map<number, Uint8Array>;
+    body: Uint8Array;
+    sig: Uint8Array;
+    metadata?: Record<string, any>;
+}
+
+interface AxisEffect {
+    ok: boolean;
+    effect: string;
+    body?: Uint8Array;
+    headers?: Map<number, Uint8Array>;
+    metadata?: any;
+}
+declare class IntentRouter {
+    private handlers;
+    register(intent: string, handler: any): void;
+    registerHandler(instance: any): void;
+    route(frame: AxisFrame): Promise<AxisEffect>;
+    private recordLatency;
+}
+
+interface AxisHandler {
+    readonly name: string;
+    readonly open?: boolean;
+    readonly description?: string;
+    readonly execute?: (body: Uint8Array, headers?: Map<number, Uint8Array>) => Promise<Uint8Array | any>;
+}
+interface AxisHandlerInit extends AxisHandler, OnModuleInit {
+}
+
+interface AxisCrudHandler extends AxisHandlerInit {
+    create(body: Uint8Array, headers?: Map<number, Uint8Array>): Promise<Uint8Array>;
+    findAll(body: Uint8Array, headers?: Map<number, Uint8Array>): Promise<Uint8Array>;
+    findOne(body: Uint8Array, headers?: Map<number, Uint8Array>): Promise<Uint8Array>;
+    update(body: Uint8Array, headers?: Map<number, Uint8Array>): Promise<Uint8Array>;
+    remove(body: Uint8Array, headers?: Map<number, Uint8Array>): Promise<Uint8Array>;
+}
+
+export { type AxisCrudHandler, type AxisEffect, type AxisFrame, type AxisHandler, type AxisHandlerInit, HANDLER_METADATA_KEY, Handler, INTENT_ROUTES_KEY, Intent, type IntentOptions, type IntentRoute, IntentRouter };

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+import { OnModuleInit } from '@nestjs/common';
+
+declare const HANDLER_METADATA_KEY = "axis:handler";
+declare function Handler(intent?: string): ClassDecorator;
+
+declare const INTENT_ROUTES_KEY = "axis:intent_routes";
+interface IntentRoute {
+    action: string;
+    methodName: string | symbol;
+    absolute?: boolean;
+    frame?: boolean;
+}
+interface IntentOptions {
+    absolute?: boolean;
+    frame?: boolean;
+}
+declare function Intent(action: string, options?: IntentOptions): MethodDecorator;
+
+interface AxisFrame {
+    flags: number;
+    headers: Map<number, Uint8Array>;
+    body: Uint8Array;
+    sig: Uint8Array;
+    metadata?: Record<string, any>;
+}
+
+interface AxisEffect {
+    ok: boolean;
+    effect: string;
+    body?: Uint8Array;
+    headers?: Map<number, Uint8Array>;
+    metadata?: any;
+}
+declare class IntentRouter {
+    private handlers;
+    register(intent: string, handler: any): void;
+    registerHandler(instance: any): void;
+    route(frame: AxisFrame): Promise<AxisEffect>;
+    private recordLatency;
+}
+
+interface AxisHandler {
+    readonly name: string;
+    readonly open?: boolean;
+    readonly description?: string;
+    readonly execute?: (body: Uint8Array, headers?: Map<number, Uint8Array>) => Promise<Uint8Array | any>;
+}
+interface AxisHandlerInit extends AxisHandler, OnModuleInit {
+}
+
+interface AxisCrudHandler extends AxisHandlerInit {
+    create(body: Uint8Array, headers?: Map<number, Uint8Array>): Promise<Uint8Array>;
+    findAll(body: Uint8Array, headers?: Map<number, Uint8Array>): Promise<Uint8Array>;
+    findOne(body: Uint8Array, headers?: Map<number, Uint8Array>): Promise<Uint8Array>;
+    update(body: Uint8Array, headers?: Map<number, Uint8Array>): Promise<Uint8Array>;
+    remove(body: Uint8Array, headers?: Map<number, Uint8Array>): Promise<Uint8Array>;
+}
+
+export { type AxisCrudHandler, type AxisEffect, type AxisFrame, type AxisHandler, type AxisHandlerInit, HANDLER_METADATA_KEY, Handler, INTENT_ROUTES_KEY, Intent, type IntentOptions, type IntentRoute, IntentRouter };

package/dist/index.js

@@ -0,0 +1,233 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  HANDLER_METADATA_KEY: () => HANDLER_METADATA_KEY,
+  Handler: () => Handler,
+  INTENT_ROUTES_KEY: () => INTENT_ROUTES_KEY,
+  Intent: () => Intent,
+  IntentRouter: () => IntentRouter
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/decorators/handler.decorator.ts
+var import_common = require("@nestjs/common");
+var HANDLER_METADATA_KEY = "axis:handler";
+function Handler(intent) {
+  return (target) => {
+    (0, import_common.SetMetadata)(HANDLER_METADATA_KEY, { intent })(target);
+    (0, import_common.Injectable)()(target);
+  };
+}
+
+// src/decorators/intent.decorator.ts
+var import_reflect_metadata = require("reflect-metadata");
+var INTENT_ROUTES_KEY = "axis:intent_routes";
+function Intent(action, options) {
+  return (target, propertyKey) => {
+    const routes = Reflect.getMetadata(INTENT_ROUTES_KEY, target.constructor) || [];
+    routes.push({
+      action,
+      methodName: propertyKey,
+      absolute: options?.absolute,
+      frame: options?.frame
+    });
+    Reflect.defineMetadata(INTENT_ROUTES_KEY, routes, target.constructor);
+  };
+}
+
+// src/engine/intent.router.ts
+var import_common2 = require("@nestjs/common");
+var IntentRouter = class {
+  constructor() {
+    /** Internal registry of dynamic intent handlers */
+    this.handlers = /* @__PURE__ */ new Map();
+  }
+  /**
+   * Registers a handler for a specific intent.
+   * Handlers can be functions: `(body, headers) => Promise<Uint8Array | AxisEffect>`
+   * Or objects with a method: `handle(frame: AxisFrame) => Promise<AxisEffect>`
+   *
+   * @param {string} intent - The unique intent identifier (e.g., 'axis.vault.create')
+   * @param {any} handler - The handler function or object
+   */
+  register(intent, handler) {
+    this.handlers.set(intent, handler);
+  }
+  /**
+   * Automatically registers all `@Intent`-decorated methods from a handler instance.
+   *
+   * Reads the handler prefix from `@Handler` metadata (or falls back to `instance.name`),
+   * then registers each `@Intent`-decorated method accordingly.
+   *
+   * @param {any} instance - The handler instance with `@Intent`-decorated methods
+   */
+  registerHandler(instance) {
+    const handlerMeta = Reflect.getMetadata(
+      HANDLER_METADATA_KEY,
+      instance.constructor
+    );
+    const prefix = handlerMeta?.intent || instance.name;
+    const routes = Reflect.getMetadata(INTENT_ROUTES_KEY, instance.constructor) || [];
+    for (const route of routes) {
+      const intentName = route.absolute ? route.action : `${prefix}.${route.action}`;
+      const fn = instance[route.methodName].bind(instance);
+      if (route.frame) {
+        this.register(intentName, { handle: fn });
+      } else {
+        this.register(intentName, fn);
+      }
+    }
+  }
+  /**
+   * Routes a decoded AXIS frame to the appropriate handler.
+   *
+   * **Precedence:**
+   * 1. System Built-ins (`system.ping`, `public.ping`, `system.time`, `system.echo`)
+   * 2. Meta-intent execution (`INTENT.EXEC` / `axis.intent.exec`)
+   * 3. Dynamically registered handlers from modules.
+   *
+   * @param {AxisFrame} frame - The validated and decoded binary frame
+   * @returns {Promise<AxisEffect>} The resulting effect of the execution
+   * @throws {Error} If the intent header is missing or no handler is registered
+   */
+  async route(frame) {
+    const start = process.hrtime();
+    let intent = "unknown";
+    try {
+      const intentBytes = frame.headers.get(3);
+      if (!intentBytes) throw new Error("Missing intent");
+      intent = new TextDecoder().decode(intentBytes);
+      let effect;
+      if (intent === "system.ping" || intent === "public.ping") {
+        effect = {
+          ok: true,
+          effect: "pong",
+          headers: /* @__PURE__ */ new Map([
+            [100, new TextEncoder().encode("AXIS_BACKEND_V1")]
+          ]),
+          body: new TextEncoder().encode(
+            JSON.stringify({
+              status: "ok",
+              timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+              version: "1.0.0"
+            })
+          )
+        };
+      } else if (intent === "system.time") {
+        const ts = Date.now().toString();
+        effect = {
+          ok: true,
+          effect: "time",
+          body: new TextEncoder().encode(
+            JSON.stringify({
+              ts,
+              iso: (/* @__PURE__ */ new Date()).toISOString()
+            })
+          )
+        };
+      } else if (intent === "system.echo") {
+        effect = {
+          ok: true,
+          effect: "echo",
+          body: frame.body
+        };
+      } else if (intent === "INTENT.EXEC" || intent === "axis.intent.exec") {
+        try {
+          const bodyJSON = JSON.parse(new TextDecoder().decode(frame.body));
+          const innerIntent = bodyJSON.intent;
+          const innerArgs = bodyJSON.args || {};
+          if (!innerIntent) {
+            throw new Error("INTENT.EXEC missing inner intent");
+          }
+          const innerFrame = {
+            ...frame,
+            headers: new Map(frame.headers),
+            body: new TextEncoder().encode(JSON.stringify(innerArgs))
+          };
+          innerFrame.headers.set(3, new TextEncoder().encode(innerIntent));
+          return await this.route(innerFrame);
+        } catch (e) {
+          throw new Error(`INTENT.EXEC unwrapping failed: ${e.message}`);
+        }
+      } else {
+        const handler = this.handlers.get(intent);
+        if (!handler) {
+          throw new Error(`Intent not found: ${intent}`);
+        }
+        if (typeof handler === "function") {
+          const resultBody = await handler(frame.body, frame.headers);
+          effect = {
+            ok: true,
+            effect: "complete",
+            body: resultBody
+          };
+        } else {
+          if (typeof handler.handle === "function") {
+            effect = await handler.handle(frame);
+          } else if (typeof handler.execute === "function") {
+            const bodyRes = await handler.execute(
+              frame.body,
+              frame.headers
+            );
+            effect = {
+              ok: true,
+              effect: "complete",
+              body: bodyRes
+            };
+          } else {
+            throw new Error(
+              `Handler for ${intent} does not implement handle or execute`
+            );
+          }
+        }
+      }
+      this.recordLatency(intent, start);
+      return effect;
+    } catch (e) {
+      console.error(`Error routing intent ${intent}:`, e.message);
+      throw e;
+    }
+  }
+  recordLatency(intent, start) {
+    const diff = process.hrtime(start);
+    void diff;
+  }
+};
+IntentRouter = __decorateClass([
+  (0, import_common2.Injectable)()
+], IntentRouter);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  HANDLER_METADATA_KEY,
+  Handler,
+  INTENT_ROUTES_KEY,
+  Intent,
+  IntentRouter
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/decorators/handler.decorator.ts","../src/decorators/intent.decorator.ts","../src/engine/intent.router.ts"],"sourcesContent":["// Decorators\nexport { Handler, HANDLER_METADATA_KEY } from './decorators/handler.decorator';\nexport {\n  Intent,\n  INTENT_ROUTES_KEY,\n  IntentRoute,\n  IntentOptions,\n} from './decorators/intent.decorator';\n\n// Engine\nexport { IntentRouter, AxisEffect } from './engine/intent.router';\n\n// Interfaces\nexport { AxisHandler, AxisHandlerInit } from './interfaces/axis-handler.interface';\nexport { AxisCrudHandler } from './interfaces/axis-crud-handler.interface';\n\n// Types\nexport { AxisFrame } from './types/axis-frame';\n","import { Injectable, SetMetadata } from '@nestjs/common';\n\nexport const HANDLER_METADATA_KEY = 'axis:handler';\n\n/**\n * Decorator to mark a class as an Axis Handler.\n * Handlers are responsible for processing intents or specific logic\n * for Axis modules.\n */\nexport function Handler(intent?: string): ClassDecorator {\n  return (target: Function) => {\n    SetMetadata(HANDLER_METADATA_KEY, { intent })(target);\n    Injectable()(target as any);\n  };\n}\n","import 'reflect-metadata';\n\nexport const INTENT_ROUTES_KEY = 'axis:intent_routes';\n\nexport interface IntentRoute {\n  action: string;\n  methodName: string | symbol;\n  absolute?: boolean;\n  frame?: boolean;\n}\n\nexport interface IntentOptions {\n  /** If true, the action is the full intent name (not prefixed with handler name) */\n  absolute?: boolean;\n  /** If true, register as { handle: fn } for frame-based handlers */\n  frame?: boolean;\n}\n\n/**\n * Marks a method as an intent handler.\n *\n * The full intent name is resolved as `{handler_prefix}.{action}` by default.\n * Use `{ absolute: true }` to use the action string as the full intent name.\n * Use `{ frame: true }` for handlers that receive an AxisFrame and return AxisEffect.\n *\n * @example\n * ```ts\n * @Handler('axis.actor_keys')\n * class MyHandler {\n *   @Intent('create')\n *   async create(body: Uint8Array) { ... }\n *\n *   @Intent('public.auth.capsule.issue', { absolute: true })\n *   async publicIssue(body: Uint8Array) { ... }\n *\n *   @Intent('presence.resume', { frame: true })\n *   async handlePresence(frame: AxisFrame) { ... }\n * }\n * ```\n */\nexport function Intent(action: string, options?: IntentOptions): MethodDecorator {\n  return (target, propertyKey) => {\n    const routes: IntentRoute[] =\n      Reflect.getMetadata(INTENT_ROUTES_KEY, target.constructor) || [];\n    routes.push({\n      action,\n      methodName: propertyKey,\n      absolute: options?.absolute,\n      frame: options?.frame,\n    });\n    Reflect.defineMetadata(INTENT_ROUTES_KEY, routes, target.constructor);\n  };\n}\n","import { Injectable } from '@nestjs/common';\nimport { AxisFrame } from '../types/axis-frame';\nimport { HANDLER_METADATA_KEY } from '../decorators/handler.decorator';\nimport { INTENT_ROUTES_KEY, IntentRoute } from '../decorators/intent.decorator';\n\n/**\n * Represents the outcome of an AXIS intent execution.\n *\n * @interface AxisEffect\n */\nexport interface AxisEffect {\n  /** Whether the intent was processed successfully at the application level */\n  ok: boolean;\n  /** A descriptive string classifier for the result (e.g., 'FILE_CREATED', 'PONG') */\n  effect: string;\n  /** Optional binary payload (body) to be returned to the requester */\n  body?: Uint8Array;\n  /** Optional custom TLV headers to be included in the response frame */\n  headers?: Map<number, Uint8Array>;\n  /** Optional metadata for internal logging or audit (not sent to client) */\n  metadata?: any;\n}\n\n/**\n * IntentRouter\n *\n * The central dispatching mechanism of the AXIS backend.\n * Maps binary intents (identified by their name in the header) to specialized handlers.\n *\n * **Features:**\n * 1. **Built-in Fast Path:** Handles high-frequency system intents (ping, time, echo) directly.\n * 2. **Dynamic Handler Registration:** Allows modules to register handlers at runtime.\n * 3. **Decorator-driven Registration:** Uses {@link registerHandler} to auto-register `@Intent`-decorated methods.\n * 4. **Polymorphic Handlers:** Supports both raw function handlers and object-based `{ handle }` handlers.\n *\n * @class IntentRouter\n */\n@Injectable()\nexport class IntentRouter {\n  /** Internal registry of dynamic intent handlers */\n  private handlers = new Map<string, any>();\n\n  /**\n   * Registers a handler for a specific intent.\n   * Handlers can be functions: `(body, headers) => Promise<Uint8Array | AxisEffect>`\n   * Or objects with a method: `handle(frame: AxisFrame) => Promise<AxisEffect>`\n   *\n   * @param {string} intent - The unique intent identifier (e.g., 'axis.vault.create')\n   * @param {any} handler - The handler function or object\n   */\n  register(intent: string, handler: any) {\n    this.handlers.set(intent, handler);\n  }\n\n  /**\n   * Automatically registers all `@Intent`-decorated methods from a handler instance.\n   *\n   * Reads the handler prefix from `@Handler` metadata (or falls back to `instance.name`),\n   * then registers each `@Intent`-decorated method accordingly.\n   *\n   * @param {any} instance - The handler instance with `@Intent`-decorated methods\n   */\n  registerHandler(instance: any) {\n    const handlerMeta = Reflect.getMetadata(\n      HANDLER_METADATA_KEY,\n      instance.constructor,\n    );\n    const prefix: string | undefined = handlerMeta?.intent || instance.name;\n\n    const routes: IntentRoute[] =\n      Reflect.getMetadata(INTENT_ROUTES_KEY, instance.constructor) || [];\n\n    for (const route of routes) {\n      const intentName = route.absolute\n        ? route.action\n        : `${prefix}.${route.action}`;\n      const fn = instance[route.methodName].bind(instance);\n\n      if (route.frame) {\n        this.register(intentName, { handle: fn });\n      } else {\n        this.register(intentName, fn);\n      }\n    }\n  }\n\n  /**\n   * Routes a decoded AXIS frame to the appropriate handler.\n   *\n   * **Precedence:**\n   * 1. System Built-ins (`system.ping`, `public.ping`, `system.time`, `system.echo`)\n   * 2. Meta-intent execution (`INTENT.EXEC` / `axis.intent.exec`)\n   * 3. Dynamically registered handlers from modules.\n   *\n   * @param {AxisFrame} frame - The validated and decoded binary frame\n   * @returns {Promise<AxisEffect>} The resulting effect of the execution\n   * @throws {Error} If the intent header is missing or no handler is registered\n   */\n  async route(frame: AxisFrame): Promise<AxisEffect> {\n    const start = process.hrtime();\n    let intent = 'unknown';\n\n    try {\n      // Extract intent from header TLV (tag 3 = TLV_INTENT)\n      const intentBytes = frame.headers.get(3);\n      if (!intentBytes) throw new Error('Missing intent');\n      intent = new TextDecoder().decode(intentBytes);\n\n      let effect: AxisEffect;\n\n      if (intent === 'system.ping' || intent === 'public.ping') {\n        effect = {\n          ok: true,\n          effect: 'pong',\n          headers: new Map([\n            [100, new TextEncoder().encode('AXIS_BACKEND_V1')],\n          ]),\n          body: new TextEncoder().encode(\n            JSON.stringify({\n              status: 'ok',\n              timestamp: new Date().toISOString(),\n              version: '1.0.0',\n            }),\n          ),\n        };\n      } else if (intent === 'system.time') {\n        const ts = Date.now().toString();\n        effect = {\n          ok: true,\n          effect: 'time',\n          body: new TextEncoder().encode(\n            JSON.stringify({\n              ts,\n              iso: new Date().toISOString(),\n            }),\n          ),\n        };\n      } else if (intent === 'system.echo') {\n        effect = {\n          ok: true,\n          effect: 'echo',\n          body: frame.body,\n        };\n      } else if (intent === 'INTENT.EXEC' || intent === 'axis.intent.exec') {\n        // Meta-intent: Unwrap and execute the inner intent\n        try {\n          const bodyJSON = JSON.parse(new TextDecoder().decode(frame.body));\n          const innerIntent = bodyJSON.intent;\n          const innerArgs = bodyJSON.args || {};\n\n          if (!innerIntent) {\n            throw new Error('INTENT.EXEC missing inner intent');\n          }\n\n          const innerFrame: AxisFrame = {\n            ...frame,\n            headers: new Map(frame.headers),\n            body: new TextEncoder().encode(JSON.stringify(innerArgs)),\n          };\n          innerFrame.headers.set(3, new TextEncoder().encode(innerIntent));\n\n          return await this.route(innerFrame);\n        } catch (e: any) {\n          throw new Error(`INTENT.EXEC unwrapping failed: ${e.message}`);\n        }\n      } else {\n        const handler = this.handlers.get(intent);\n        if (!handler) {\n          throw new Error(`Intent not found: ${intent}`);\n        }\n\n        if (typeof handler === 'function') {\n          const resultBody = await handler(frame.body, frame.headers);\n          effect = {\n            ok: true,\n            effect: 'complete',\n            body: resultBody,\n          };\n        } else {\n          if (typeof (handler as any).handle === 'function') {\n            effect = await (handler as any).handle(frame);\n          } else if (typeof (handler as any).execute === 'function') {\n            const bodyRes = await (handler as any).execute(\n              frame.body,\n              frame.headers,\n            );\n            effect = {\n              ok: true,\n              effect: 'complete',\n              body: bodyRes,\n            };\n          } else {\n            throw new Error(\n              `Handler for ${intent} does not implement handle or execute`,\n            );\n          }\n        }\n      }\n\n      this.recordLatency(intent, start);\n      return effect;\n    } catch (e: any) {\n      console.error(`Error routing intent ${intent}:`, e.message);\n      throw e;\n    }\n  }\n\n  private recordLatency(intent: string, start: [number, number]) {\n    const diff = process.hrtime(start);\n    // Available for subclass telemetry hooks or future logging\n    void diff;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,oBAAwC;AAEjC,IAAM,uBAAuB;AAO7B,SAAS,QAAQ,QAAiC;AACvD,SAAO,CAAC,WAAqB;AAC3B,mCAAY,sBAAsB,EAAE,OAAO,CAAC,EAAE,MAAM;AACpD,kCAAW,EAAE,MAAa;AAAA,EAC5B;AACF;;;ACdA,8BAAO;AAEA,IAAM,oBAAoB;AAsC1B,SAAS,OAAO,QAAgB,SAA0C;AAC/E,SAAO,CAAC,QAAQ,gBAAgB;AAC9B,UAAM,SACJ,QAAQ,YAAY,mBAAmB,OAAO,WAAW,KAAK,CAAC;AACjE,WAAO,KAAK;AAAA,MACV;AAAA,MACA,YAAY;AAAA,MACZ,UAAU,SAAS;AAAA,MACnB,OAAO,SAAS;AAAA,IAClB,CAAC;AACD,YAAQ,eAAe,mBAAmB,QAAQ,OAAO,WAAW;AAAA,EACtE;AACF;;;ACpDA,IAAAA,iBAA2B;AAsCpB,IAAM,eAAN,MAAmB;AAAA,EAAnB;AAEL;AAAA,SAAQ,WAAW,oBAAI,IAAiB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUxC,SAAS,QAAgB,SAAc;AACrC,SAAK,SAAS,IAAI,QAAQ,OAAO;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,gBAAgB,UAAe;AAC7B,UAAM,cAAc,QAAQ;AAAA,MAC1B;AAAA,MACA,SAAS;AAAA,IACX;AACA,UAAM,SAA6B,aAAa,UAAU,SAAS;AAEnE,UAAM,SACJ,QAAQ,YAAY,mBAAmB,SAAS,WAAW,KAAK,CAAC;AAEnE,eAAW,SAAS,QAAQ;AAC1B,YAAM,aAAa,MAAM,WACrB,MAAM,SACN,GAAG,MAAM,IAAI,MAAM,MAAM;AAC7B,YAAM,KAAK,SAAS,MAAM,UAAU,EAAE,KAAK,QAAQ;AAEnD,UAAI,MAAM,OAAO;AACf,aAAK,SAAS,YAAY,EAAE,QAAQ,GAAG,CAAC;AAAA,MAC1C,OAAO;AACL,aAAK,SAAS,YAAY,EAAE;AAAA,MAC9B;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,MAAM,MAAM,OAAuC;AACjD,UAAM,QAAQ,QAAQ,OAAO;AAC7B,QAAI,SAAS;AAEb,QAAI;AAEF,YAAM,cAAc,MAAM,QAAQ,IAAI,CAAC;AACvC,UAAI,CAAC,YAAa,OAAM,IAAI,MAAM,gBAAgB;AAClD,eAAS,IAAI,YAAY,EAAE,OAAO,WAAW;AAE7C,UAAI;AAEJ,UAAI,WAAW,iBAAiB,WAAW,eAAe;AACxD,iBAAS;AAAA,UACP,IAAI;AAAA,UACJ,QAAQ;AAAA,UACR,SAAS,oBAAI,IAAI;AAAA,YACf,CAAC,KAAK,IAAI,YAAY,EAAE,OAAO,iBAAiB,CAAC;AAAA,UACnD,CAAC;AAAA,UACD,MAAM,IAAI,YAAY,EAAE;AAAA,YACtB,KAAK,UAAU;AAAA,cACb,QAAQ;AAAA,cACR,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,cAClC,SAAS;AAAA,YACX,CAAC;AAAA,UACH;AAAA,QACF;AAAA,MACF,WAAW,WAAW,eAAe;AACnC,cAAM,KAAK,KAAK,IAAI,EAAE,SAAS;AAC/B,iBAAS;AAAA,UACP,IAAI;AAAA,UACJ,QAAQ;AAAA,UACR,MAAM,IAAI,YAAY,EAAE;AAAA,YACtB,KAAK,UAAU;AAAA,cACb;AAAA,cACA,MAAK,oBAAI,KAAK,GAAE,YAAY;AAAA,YAC9B,CAAC;AAAA,UACH;AAAA,QACF;AAAA,MACF,WAAW,WAAW,eAAe;AACnC,iBAAS;AAAA,UACP,IAAI;AAAA,UACJ,QAAQ;AAAA,UACR,MAAM,MAAM;AAAA,QACd;AAAA,MACF,WAAW,WAAW,iBAAiB,WAAW,oBAAoB;AAEpE,YAAI;AACF,gBAAM,WAAW,KAAK,MAAM,IAAI,YAAY,EAAE,OAAO,MAAM,IAAI,CAAC;AAChE,gBAAM,cAAc,SAAS;AAC7B,gBAAM,YAAY,SAAS,QAAQ,CAAC;AAEpC,cAAI,CAAC,aAAa;AAChB,kBAAM,IAAI,MAAM,kCAAkC;AAAA,UACpD;AAEA,gBAAM,aAAwB;AAAA,YAC5B,GAAG;AAAA,YACH,SAAS,IAAI,IAAI,MAAM,OAAO;AAAA,YAC9B,MAAM,IAAI,YAAY,EAAE,OAAO,KAAK,UAAU,SAAS,CAAC;AAAA,UAC1D;AACA,qBAAW,QAAQ,IAAI,GAAG,IAAI,YAAY,EAAE,OAAO,WAAW,CAAC;AAE/D,iBAAO,MAAM,KAAK,MAAM,UAAU;AAAA,QACpC,SAAS,GAAQ;AACf,gBAAM,IAAI,MAAM,kCAAkC,EAAE,OAAO,EAAE;AAAA,QAC/D;AAAA,MACF,OAAO;AACL,cAAM,UAAU,KAAK,SAAS,IAAI,MAAM;AACxC,YAAI,CAAC,SAAS;AACZ,gBAAM,IAAI,MAAM,qBAAqB,MAAM,EAAE;AAAA,QAC/C;AAEA,YAAI,OAAO,YAAY,YAAY;AACjC,gBAAM,aAAa,MAAM,QAAQ,MAAM,MAAM,MAAM,OAAO;AAC1D,mBAAS;AAAA,YACP,IAAI;AAAA,YACJ,QAAQ;AAAA,YACR,MAAM;AAAA,UACR;AAAA,QACF,OAAO;AACL,cAAI,OAAQ,QAAgB,WAAW,YAAY;AACjD,qBAAS,MAAO,QAAgB,OAAO,KAAK;AAAA,UAC9C,WAAW,OAAQ,QAAgB,YAAY,YAAY;AACzD,kBAAM,UAAU,MAAO,QAAgB;AAAA,cACrC,MAAM;AAAA,cACN,MAAM;AAAA,YACR;AACA,qBAAS;AAAA,cACP,IAAI;AAAA,cACJ,QAAQ;AAAA,cACR,MAAM;AAAA,YACR;AAAA,UACF,OAAO;AACL,kBAAM,IAAI;AAAA,cACR,eAAe,MAAM;AAAA,YACvB;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAEA,WAAK,cAAc,QAAQ,KAAK;AAChC,aAAO;AAAA,IACT,SAAS,GAAQ;AACf,cAAQ,MAAM,wBAAwB,MAAM,KAAK,EAAE,OAAO;AAC1D,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEQ,cAAc,QAAgB,OAAyB;AAC7D,UAAM,OAAO,QAAQ,OAAO,KAAK;AAEjC,SAAK;AAAA,EACP;AACF;AA9Ka,eAAN;AAAA,MADN,2BAAW;AAAA,GACC;","names":["import_common"]}

package/dist/index.mjs

@@ -0,0 +1,206 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+
+// src/decorators/handler.decorator.ts
+import { Injectable, SetMetadata } from "@nestjs/common";
+var HANDLER_METADATA_KEY = "axis:handler";
+function Handler(intent) {
+  return (target) => {
+    SetMetadata(HANDLER_METADATA_KEY, { intent })(target);
+    Injectable()(target);
+  };
+}
+
+// src/decorators/intent.decorator.ts
+import "reflect-metadata";
+var INTENT_ROUTES_KEY = "axis:intent_routes";
+function Intent(action, options) {
+  return (target, propertyKey) => {
+    const routes = Reflect.getMetadata(INTENT_ROUTES_KEY, target.constructor) || [];
+    routes.push({
+      action,
+      methodName: propertyKey,
+      absolute: options?.absolute,
+      frame: options?.frame
+    });
+    Reflect.defineMetadata(INTENT_ROUTES_KEY, routes, target.constructor);
+  };
+}
+
+// src/engine/intent.router.ts
+import { Injectable as Injectable2 } from "@nestjs/common";
+var IntentRouter = class {
+  constructor() {
+    /** Internal registry of dynamic intent handlers */
+    this.handlers = /* @__PURE__ */ new Map();
+  }
+  /**
+   * Registers a handler for a specific intent.
+   * Handlers can be functions: `(body, headers) => Promise<Uint8Array | AxisEffect>`
+   * Or objects with a method: `handle(frame: AxisFrame) => Promise<AxisEffect>`
+   *
+   * @param {string} intent - The unique intent identifier (e.g., 'axis.vault.create')
+   * @param {any} handler - The handler function or object
+   */
+  register(intent, handler) {
+    this.handlers.set(intent, handler);
+  }
+  /**
+   * Automatically registers all `@Intent`-decorated methods from a handler instance.
+   *
+   * Reads the handler prefix from `@Handler` metadata (or falls back to `instance.name`),
+   * then registers each `@Intent`-decorated method accordingly.
+   *
+   * @param {any} instance - The handler instance with `@Intent`-decorated methods
+   */
+  registerHandler(instance) {
+    const handlerMeta = Reflect.getMetadata(
+      HANDLER_METADATA_KEY,
+      instance.constructor
+    );
+    const prefix = handlerMeta?.intent || instance.name;
+    const routes = Reflect.getMetadata(INTENT_ROUTES_KEY, instance.constructor) || [];
+    for (const route of routes) {
+      const intentName = route.absolute ? route.action : `${prefix}.${route.action}`;
+      const fn = instance[route.methodName].bind(instance);
+      if (route.frame) {
+        this.register(intentName, { handle: fn });
+      } else {
+        this.register(intentName, fn);
+      }
+    }
+  }
+  /**
+   * Routes a decoded AXIS frame to the appropriate handler.
+   *
+   * **Precedence:**
+   * 1. System Built-ins (`system.ping`, `public.ping`, `system.time`, `system.echo`)
+   * 2. Meta-intent execution (`INTENT.EXEC` / `axis.intent.exec`)
+   * 3. Dynamically registered handlers from modules.
+   *
+   * @param {AxisFrame} frame - The validated and decoded binary frame
+   * @returns {Promise<AxisEffect>} The resulting effect of the execution
+   * @throws {Error} If the intent header is missing or no handler is registered
+   */
+  async route(frame) {
+    const start = process.hrtime();
+    let intent = "unknown";
+    try {
+      const intentBytes = frame.headers.get(3);
+      if (!intentBytes) throw new Error("Missing intent");
+      intent = new TextDecoder().decode(intentBytes);
+      let effect;
+      if (intent === "system.ping" || intent === "public.ping") {
+        effect = {
+          ok: true,
+          effect: "pong",
+          headers: /* @__PURE__ */ new Map([
+            [100, new TextEncoder().encode("AXIS_BACKEND_V1")]
+          ]),
+          body: new TextEncoder().encode(
+            JSON.stringify({
+              status: "ok",
+              timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+              version: "1.0.0"
+            })
+          )
+        };
+      } else if (intent === "system.time") {
+        const ts = Date.now().toString();
+        effect = {
+          ok: true,
+          effect: "time",
+          body: new TextEncoder().encode(
+            JSON.stringify({
+              ts,
+              iso: (/* @__PURE__ */ new Date()).toISOString()
+            })
+          )
+        };
+      } else if (intent === "system.echo") {
+        effect = {
+          ok: true,
+          effect: "echo",
+          body: frame.body
+        };
+      } else if (intent === "INTENT.EXEC" || intent === "axis.intent.exec") {
+        try {
+          const bodyJSON = JSON.parse(new TextDecoder().decode(frame.body));
+          const innerIntent = bodyJSON.intent;
+          const innerArgs = bodyJSON.args || {};
+          if (!innerIntent) {
+            throw new Error("INTENT.EXEC missing inner intent");
+          }
+          const innerFrame = {
+            ...frame,
+            headers: new Map(frame.headers),
+            body: new TextEncoder().encode(JSON.stringify(innerArgs))
+          };
+          innerFrame.headers.set(3, new TextEncoder().encode(innerIntent));
+          return await this.route(innerFrame);
+        } catch (e) {
+          throw new Error(`INTENT.EXEC unwrapping failed: ${e.message}`);
+        }
+      } else {
+        const handler = this.handlers.get(intent);
+        if (!handler) {
+          throw new Error(`Intent not found: ${intent}`);
+        }
+        if (typeof handler === "function") {
+          const resultBody = await handler(frame.body, frame.headers);
+          effect = {
+            ok: true,
+            effect: "complete",
+            body: resultBody
+          };
+        } else {
+          if (typeof handler.handle === "function") {
+            effect = await handler.handle(frame);
+          } else if (typeof handler.execute === "function") {
+            const bodyRes = await handler.execute(
+              frame.body,
+              frame.headers
+            );
+            effect = {
+              ok: true,
+              effect: "complete",
+              body: bodyRes
+            };
+          } else {
+            throw new Error(
+              `Handler for ${intent} does not implement handle or execute`
+            );
+          }
+        }
+      }
+      this.recordLatency(intent, start);
+      return effect;
+    } catch (e) {
+      console.error(`Error routing intent ${intent}:`, e.message);
+      throw e;
+    }
+  }
+  recordLatency(intent, start) {
+    const diff = process.hrtime(start);
+    void diff;
+  }
+};
+IntentRouter = __decorateClass([
+  Injectable2()
+], IntentRouter);
+export {
+  HANDLER_METADATA_KEY,
+  Handler,
+  INTENT_ROUTES_KEY,
+  Intent,
+  IntentRouter
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/decorators/handler.decorator.ts","../src/decorators/intent.decorator.ts","../src/engine/intent.router.ts"],"sourcesContent":["import { Injectable, SetMetadata } from '@nestjs/common';\n\nexport const HANDLER_METADATA_KEY = 'axis:handler';\n\n/**\n * Decorator to mark a class as an Axis Handler.\n * Handlers are responsible for processing intents or specific logic\n * for Axis modules.\n */\nexport function Handler(intent?: string): ClassDecorator {\n  return (target: Function) => {\n    SetMetadata(HANDLER_METADATA_KEY, { intent })(target);\n    Injectable()(target as any);\n  };\n}\n","import 'reflect-metadata';\n\nexport const INTENT_ROUTES_KEY = 'axis:intent_routes';\n\nexport interface IntentRoute {\n  action: string;\n  methodName: string | symbol;\n  absolute?: boolean;\n  frame?: boolean;\n}\n\nexport interface IntentOptions {\n  /** If true, the action is the full intent name (not prefixed with handler name) */\n  absolute?: boolean;\n  /** If true, register as { handle: fn } for frame-based handlers */\n  frame?: boolean;\n}\n\n/**\n * Marks a method as an intent handler.\n *\n * The full intent name is resolved as `{handler_prefix}.{action}` by default.\n * Use `{ absolute: true }` to use the action string as the full intent name.\n * Use `{ frame: true }` for handlers that receive an AxisFrame and return AxisEffect.\n *\n * @example\n * ```ts\n * @Handler('axis.actor_keys')\n * class MyHandler {\n *   @Intent('create')\n *   async create(body: Uint8Array) { ... }\n *\n *   @Intent('public.auth.capsule.issue', { absolute: true })\n *   async publicIssue(body: Uint8Array) { ... }\n *\n *   @Intent('presence.resume', { frame: true })\n *   async handlePresence(frame: AxisFrame) { ... }\n * }\n * ```\n */\nexport function Intent(action: string, options?: IntentOptions): MethodDecorator {\n  return (target, propertyKey) => {\n    const routes: IntentRoute[] =\n      Reflect.getMetadata(INTENT_ROUTES_KEY, target.constructor) || [];\n    routes.push({\n      action,\n      methodName: propertyKey,\n      absolute: options?.absolute,\n      frame: options?.frame,\n    });\n    Reflect.defineMetadata(INTENT_ROUTES_KEY, routes, target.constructor);\n  };\n}\n","import { Injectable } from '@nestjs/common';\nimport { AxisFrame } from '../types/axis-frame';\nimport { HANDLER_METADATA_KEY } from '../decorators/handler.decorator';\nimport { INTENT_ROUTES_KEY, IntentRoute } from '../decorators/intent.decorator';\n\n/**\n * Represents the outcome of an AXIS intent execution.\n *\n * @interface AxisEffect\n */\nexport interface AxisEffect {\n  /** Whether the intent was processed successfully at the application level */\n  ok: boolean;\n  /** A descriptive string classifier for the result (e.g., 'FILE_CREATED', 'PONG') */\n  effect: string;\n  /** Optional binary payload (body) to be returned to the requester */\n  body?: Uint8Array;\n  /** Optional custom TLV headers to be included in the response frame */\n  headers?: Map<number, Uint8Array>;\n  /** Optional metadata for internal logging or audit (not sent to client) */\n  metadata?: any;\n}\n\n/**\n * IntentRouter\n *\n * The central dispatching mechanism of the AXIS backend.\n * Maps binary intents (identified by their name in the header) to specialized handlers.\n *\n * **Features:**\n * 1. **Built-in Fast Path:** Handles high-frequency system intents (ping, time, echo) directly.\n * 2. **Dynamic Handler Registration:** Allows modules to register handlers at runtime.\n * 3. **Decorator-driven Registration:** Uses {@link registerHandler} to auto-register `@Intent`-decorated methods.\n * 4. **Polymorphic Handlers:** Supports both raw function handlers and object-based `{ handle }` handlers.\n *\n * @class IntentRouter\n */\n@Injectable()\nexport class IntentRouter {\n  /** Internal registry of dynamic intent handlers */\n  private handlers = new Map<string, any>();\n\n  /**\n   * Registers a handler for a specific intent.\n   * Handlers can be functions: `(body, headers) => Promise<Uint8Array | AxisEffect>`\n   * Or objects with a method: `handle(frame: AxisFrame) => Promise<AxisEffect>`\n   *\n   * @param {string} intent - The unique intent identifier (e.g., 'axis.vault.create')\n   * @param {any} handler - The handler function or object\n   */\n  register(intent: string, handler: any) {\n    this.handlers.set(intent, handler);\n  }\n\n  /**\n   * Automatically registers all `@Intent`-decorated methods from a handler instance.\n   *\n   * Reads the handler prefix from `@Handler` metadata (or falls back to `instance.name`),\n   * then registers each `@Intent`-decorated method accordingly.\n   *\n   * @param {any} instance - The handler instance with `@Intent`-decorated methods\n   */\n  registerHandler(instance: any) {\n    const handlerMeta = Reflect.getMetadata(\n      HANDLER_METADATA_KEY,\n      instance.constructor,\n    );\n    const prefix: string | undefined = handlerMeta?.intent || instance.name;\n\n    const routes: IntentRoute[] =\n      Reflect.getMetadata(INTENT_ROUTES_KEY, instance.constructor) || [];\n\n    for (const route of routes) {\n      const intentName = route.absolute\n        ? route.action\n        : `${prefix}.${route.action}`;\n      const fn = instance[route.methodName].bind(instance);\n\n      if (route.frame) {\n        this.register(intentName, { handle: fn });\n      } else {\n        this.register(intentName, fn);\n      }\n    }\n  }\n\n  /**\n   * Routes a decoded AXIS frame to the appropriate handler.\n   *\n   * **Precedence:**\n   * 1. System Built-ins (`system.ping`, `public.ping`, `system.time`, `system.echo`)\n   * 2. Meta-intent execution (`INTENT.EXEC` / `axis.intent.exec`)\n   * 3. Dynamically registered handlers from modules.\n   *\n   * @param {AxisFrame} frame - The validated and decoded binary frame\n   * @returns {Promise<AxisEffect>} The resulting effect of the execution\n   * @throws {Error} If the intent header is missing or no handler is registered\n   */\n  async route(frame: AxisFrame): Promise<AxisEffect> {\n    const start = process.hrtime();\n    let intent = 'unknown';\n\n    try {\n      // Extract intent from header TLV (tag 3 = TLV_INTENT)\n      const intentBytes = frame.headers.get(3);\n      if (!intentBytes) throw new Error('Missing intent');\n      intent = new TextDecoder().decode(intentBytes);\n\n      let effect: AxisEffect;\n\n      if (intent === 'system.ping' || intent === 'public.ping') {\n        effect = {\n          ok: true,\n          effect: 'pong',\n          headers: new Map([\n            [100, new TextEncoder().encode('AXIS_BACKEND_V1')],\n          ]),\n          body: new TextEncoder().encode(\n            JSON.stringify({\n              status: 'ok',\n              timestamp: new Date().toISOString(),\n              version: '1.0.0',\n            }),\n          ),\n        };\n      } else if (intent === 'system.time') {\n        const ts = Date.now().toString();\n        effect = {\n          ok: true,\n          effect: 'time',\n          body: new TextEncoder().encode(\n            JSON.stringify({\n              ts,\n              iso: new Date().toISOString(),\n            }),\n          ),\n        };\n      } else if (intent === 'system.echo') {\n        effect = {\n          ok: true,\n          effect: 'echo',\n          body: frame.body,\n        };\n      } else if (intent === 'INTENT.EXEC' || intent === 'axis.intent.exec') {\n        // Meta-intent: Unwrap and execute the inner intent\n        try {\n          const bodyJSON = JSON.parse(new TextDecoder().decode(frame.body));\n          const innerIntent = bodyJSON.intent;\n          const innerArgs = bodyJSON.args || {};\n\n          if (!innerIntent) {\n            throw new Error('INTENT.EXEC missing inner intent');\n          }\n\n          const innerFrame: AxisFrame = {\n            ...frame,\n            headers: new Map(frame.headers),\n            body: new TextEncoder().encode(JSON.stringify(innerArgs)),\n          };\n          innerFrame.headers.set(3, new TextEncoder().encode(innerIntent));\n\n          return await this.route(innerFrame);\n        } catch (e: any) {\n          throw new Error(`INTENT.EXEC unwrapping failed: ${e.message}`);\n        }\n      } else {\n        const handler = this.handlers.get(intent);\n        if (!handler) {\n          throw new Error(`Intent not found: ${intent}`);\n        }\n\n        if (typeof handler === 'function') {\n          const resultBody = await handler(frame.body, frame.headers);\n          effect = {\n            ok: true,\n            effect: 'complete',\n            body: resultBody,\n          };\n        } else {\n          if (typeof (handler as any).handle === 'function') {\n            effect = await (handler as any).handle(frame);\n          } else if (typeof (handler as any).execute === 'function') {\n            const bodyRes = await (handler as any).execute(\n              frame.body,\n              frame.headers,\n            );\n            effect = {\n              ok: true,\n              effect: 'complete',\n              body: bodyRes,\n            };\n          } else {\n            throw new Error(\n              `Handler for ${intent} does not implement handle or execute`,\n            );\n          }\n        }\n      }\n\n      this.recordLatency(intent, start);\n      return effect;\n    } catch (e: any) {\n      console.error(`Error routing intent ${intent}:`, e.message);\n      throw e;\n    }\n  }\n\n  private recordLatency(intent: string, start: [number, number]) {\n    const diff = process.hrtime(start);\n    // Available for subclass telemetry hooks or future logging\n    void diff;\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAAA,SAAS,YAAY,mBAAmB;AAEjC,IAAM,uBAAuB;AAO7B,SAAS,QAAQ,QAAiC;AACvD,SAAO,CAAC,WAAqB;AAC3B,gBAAY,sBAAsB,EAAE,OAAO,CAAC,EAAE,MAAM;AACpD,eAAW,EAAE,MAAa;AAAA,EAC5B;AACF;;;ACdA,OAAO;AAEA,IAAM,oBAAoB;AAsC1B,SAAS,OAAO,QAAgB,SAA0C;AAC/E,SAAO,CAAC,QAAQ,gBAAgB;AAC9B,UAAM,SACJ,QAAQ,YAAY,mBAAmB,OAAO,WAAW,KAAK,CAAC;AACjE,WAAO,KAAK;AAAA,MACV;AAAA,MACA,YAAY;AAAA,MACZ,UAAU,SAAS;AAAA,MACnB,OAAO,SAAS;AAAA,IAClB,CAAC;AACD,YAAQ,eAAe,mBAAmB,QAAQ,OAAO,WAAW;AAAA,EACtE;AACF;;;ACpDA,SAAS,cAAAA,mBAAkB;AAsCpB,IAAM,eAAN,MAAmB;AAAA,EAAnB;AAEL;AAAA,SAAQ,WAAW,oBAAI,IAAiB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUxC,SAAS,QAAgB,SAAc;AACrC,SAAK,SAAS,IAAI,QAAQ,OAAO;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,gBAAgB,UAAe;AAC7B,UAAM,cAAc,QAAQ;AAAA,MAC1B;AAAA,MACA,SAAS;AAAA,IACX;AACA,UAAM,SAA6B,aAAa,UAAU,SAAS;AAEnE,UAAM,SACJ,QAAQ,YAAY,mBAAmB,SAAS,WAAW,KAAK,CAAC;AAEnE,eAAW,SAAS,QAAQ;AAC1B,YAAM,aAAa,MAAM,WACrB,MAAM,SACN,GAAG,MAAM,IAAI,MAAM,MAAM;AAC7B,YAAM,KAAK,SAAS,MAAM,UAAU,EAAE,KAAK,QAAQ;AAEnD,UAAI,MAAM,OAAO;AACf,aAAK,SAAS,YAAY,EAAE,QAAQ,GAAG,CAAC;AAAA,MAC1C,OAAO;AACL,aAAK,SAAS,YAAY,EAAE;AAAA,MAC9B;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,MAAM,MAAM,OAAuC;AACjD,UAAM,QAAQ,QAAQ,OAAO;AAC7B,QAAI,SAAS;AAEb,QAAI;AAEF,YAAM,cAAc,MAAM,QAAQ,IAAI,CAAC;AACvC,UAAI,CAAC,YAAa,OAAM,IAAI,MAAM,gBAAgB;AAClD,eAAS,IAAI,YAAY,EAAE,OAAO,WAAW;AAE7C,UAAI;AAEJ,UAAI,WAAW,iBAAiB,WAAW,eAAe;AACxD,iBAAS;AAAA,UACP,IAAI;AAAA,UACJ,QAAQ;AAAA,UACR,SAAS,oBAAI,IAAI;AAAA,YACf,CAAC,KAAK,IAAI,YAAY,EAAE,OAAO,iBAAiB,CAAC;AAAA,UACnD,CAAC;AAAA,UACD,MAAM,IAAI,YAAY,EAAE;AAAA,YACtB,KAAK,UAAU;AAAA,cACb,QAAQ;AAAA,cACR,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,cAClC,SAAS;AAAA,YACX,CAAC;AAAA,UACH;AAAA,QACF;AAAA,MACF,WAAW,WAAW,eAAe;AACnC,cAAM,KAAK,KAAK,IAAI,EAAE,SAAS;AAC/B,iBAAS;AAAA,UACP,IAAI;AAAA,UACJ,QAAQ;AAAA,UACR,MAAM,IAAI,YAAY,EAAE;AAAA,YACtB,KAAK,UAAU;AAAA,cACb;AAAA,cACA,MAAK,oBAAI,KAAK,GAAE,YAAY;AAAA,YAC9B,CAAC;AAAA,UACH;AAAA,QACF;AAAA,MACF,WAAW,WAAW,eAAe;AACnC,iBAAS;AAAA,UACP,IAAI;AAAA,UACJ,QAAQ;AAAA,UACR,MAAM,MAAM;AAAA,QACd;AAAA,MACF,WAAW,WAAW,iBAAiB,WAAW,oBAAoB;AAEpE,YAAI;AACF,gBAAM,WAAW,KAAK,MAAM,IAAI,YAAY,EAAE,OAAO,MAAM,IAAI,CAAC;AAChE,gBAAM,cAAc,SAAS;AAC7B,gBAAM,YAAY,SAAS,QAAQ,CAAC;AAEpC,cAAI,CAAC,aAAa;AAChB,kBAAM,IAAI,MAAM,kCAAkC;AAAA,UACpD;AAEA,gBAAM,aAAwB;AAAA,YAC5B,GAAG;AAAA,YACH,SAAS,IAAI,IAAI,MAAM,OAAO;AAAA,YAC9B,MAAM,IAAI,YAAY,EAAE,OAAO,KAAK,UAAU,SAAS,CAAC;AAAA,UAC1D;AACA,qBAAW,QAAQ,IAAI,GAAG,IAAI,YAAY,EAAE,OAAO,WAAW,CAAC;AAE/D,iBAAO,MAAM,KAAK,MAAM,UAAU;AAAA,QACpC,SAAS,GAAQ;AACf,gBAAM,IAAI,MAAM,kCAAkC,EAAE,OAAO,EAAE;AAAA,QAC/D;AAAA,MACF,OAAO;AACL,cAAM,UAAU,KAAK,SAAS,IAAI,MAAM;AACxC,YAAI,CAAC,SAAS;AACZ,gBAAM,IAAI,MAAM,qBAAqB,MAAM,EAAE;AAAA,QAC/C;AAEA,YAAI,OAAO,YAAY,YAAY;AACjC,gBAAM,aAAa,MAAM,QAAQ,MAAM,MAAM,MAAM,OAAO;AAC1D,mBAAS;AAAA,YACP,IAAI;AAAA,YACJ,QAAQ;AAAA,YACR,MAAM;AAAA,UACR;AAAA,QACF,OAAO;AACL,cAAI,OAAQ,QAAgB,WAAW,YAAY;AACjD,qBAAS,MAAO,QAAgB,OAAO,KAAK;AAAA,UAC9C,WAAW,OAAQ,QAAgB,YAAY,YAAY;AACzD,kBAAM,UAAU,MAAO,QAAgB;AAAA,cACrC,MAAM;AAAA,cACN,MAAM;AAAA,YACR;AACA,qBAAS;AAAA,cACP,IAAI;AAAA,cACJ,QAAQ;AAAA,cACR,MAAM;AAAA,YACR;AAAA,UACF,OAAO;AACL,kBAAM,IAAI;AAAA,cACR,eAAe,MAAM;AAAA,YACvB;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAEA,WAAK,cAAc,QAAQ,KAAK;AAChC,aAAO;AAAA,IACT,SAAS,GAAQ;AACf,cAAQ,MAAM,wBAAwB,MAAM,KAAK,EAAE,OAAO;AAC1D,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEQ,cAAc,QAAgB,OAAyB;AAC7D,UAAM,OAAO,QAAQ,OAAO,KAAK;AAEjC,SAAK;AAAA,EACP;AACF;AA9Ka,eAAN;AAAA,EADNC,YAAW;AAAA,GACC;","names":["Injectable","Injectable"]}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@nextera.one/axis-server-sdk",
+  "version": "0.1.0",
+  "description": "Axis Protocol server-side SDK — decorators, interfaces, and routing primitives for building Axis handlers",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "npm run build",
+    "dev": "tsup --watch"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/digital-pages-co/axis.git",
+    "directory": "axis-server-sdk"
+  },
+  "homepage": "https://axisprotocol.io",
+  "bugs": {
+    "url": "https://github.com/digital-pages-co/axis/issues"
+  },
+  "keywords": [
+    "axis",
+    "protocol",
+    "typescript",
+    "server",
+    "sdk",
+    "handler",
+    "decorator",
+    "intent",
+    "router",
+    "binary"
+  ],
+  "author": "NextEra.One",
+  "license": "Apache-2.0",
+  "type": "commonjs",
+  "peerDependencies": {
+    "@nestjs/common": ">=10.0.0",
+    "reflect-metadata": ">=0.1.12"
+  },
+  "devDependencies": {
+    "@nestjs/common": "^11.1.12",
+    "@nestjs/core": "^11.1.12",
+    "@types/node": "^22.0.0",
+    "reflect-metadata": "^0.2.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {}
+}