@awarevue/agent-sdk 2.0.74 → 2.0.75

package/dist/agent-app-with-defaults.d.ts

@@ -0,0 +1,16 @@
+import { FromAgent, FromServer, Message } from '@awarevue/api-types';
+import { Agent } from './agent';
+import { AgentApp, AgentOptions } from './agent-app';
+import { DuplexTransport } from './transport_types';
+export type AgentAppWithDefaultsOptions = Omit<AgentOptions, 'transport'> & {
+    url: string;
+    apiKey: string;
+    transport?: DuplexTransport<Message<FromServer>, Message<FromAgent>>;
+};
+/**
+ * Creates an AgentApp instance with default transport settings (WS transport wrapped in a logging decorator) if no custom transport is provided.
+ * @param agent The agent instance to use.
+ * @param options Configuration options for the AgentApp.
+ * @returns A configured AgentApp instance.
+ */
+export declare function createAgentApp(agent: Agent, options: AgentAppWithDefaultsOptions): AgentApp;

package/dist/agent-app-with-defaults.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAgentApp = createAgentApp;
+const agent_app_1 = require("./agent-app");
+const logging_1 = require("./transports/logging");
+const ws_1 = require("./transports/ws");
+/**
+ * Creates an AgentApp instance with default transport settings (WS transport wrapped in a logging decorator) if no custom transport is provided.
+ * @param agent The agent instance to use.
+ * @param options Configuration options for the AgentApp.
+ * @returns A configured AgentApp instance.
+ */
+function createAgentApp(agent, options) {
+    const { url, apiKey, transport, ...rest } = options;
+    const finalTransport = transport !== null && transport !== void 0 ? transport : new logging_1.LoggingDuplexTransport(new ws_1.WsDuplexTransport({
+        url,
+        headers: {
+            Authorization: `APIKey ${apiKey}`,
+        },
+    }));
+    return new agent_app_1.AgentApp(agent, { ...rest, transport: finalTransport });
+}

package/dist/agent-protocol.d.ts

@@ -27,6 +27,6 @@ export declare class AgentProtocol<D extends Direction> {
     constructor(transport: DuplexTransport<Message<Inbound<D>>, Message<Outbound<D>>>, options: AgentProtocolOptions);
     getReply$: <K extends RequestKind>(payload: Extract<Outbound<D>, {
         kind: K;
-    }>) => Observable<Message<PayloadByKind[ResponseKind<K>]>>;
+    }>, timeoutMs?: number) => Observable<Message<PayloadByKind[ResponseKind<K>]>>;
     send: (payload: Outbound<D>) => void;
 }

package/dist/agent-protocol.js

@@ -15,17 +15,24 @@ class AgentProtocol {
             version: constants_1.AGENT_PROTOCOL_VERSION,
             on: Date.now(),
         });
-        this.getReply$ = (payload) => {
+        this.getReply$ = (payload, timeoutMs) => {
             const responseKind = api_types_1.ReplyKindByRequestKind[payload.kind];
-            const reply$ = (id) => this.transport.messages$.pipe((0, rxjs_1.mergeMap)((message) => {
-                if (message.kind === 'error-rs' && message.requestId === id) {
+            const reply$ = (id) => this.transport.messages$.pipe(
+            // pass through only messages with matching requestId (it could be response, error or progress update)
+            (0, rxjs_1.filter)((message) => 'requestId' in message && message.requestId === id), (0, rxjs_1.mergeMap)((message) => {
+                // if the agent responded with an error message related to our request, throw an error to fail the stream
+                if (message.kind === 'error-rs') {
                     const error = message.error;
                     return (0, rxjs_1.throwError)(() => new Error(`Server failed to process message ${payload.kind}: ${error}`));
                 }
                 return (0, rxjs_1.of)(message);
-            }), (0, rxjs_1.filter)((message) => message.kind === responseKind &&
-                'requestId' in message &&
-                message.requestId === id), (0, rxjs_1.take)(1), (0, rxjs_1.timeout)(this.options.replyTimeout || 10000));
+            }), 
+            // enforce timeout (progress updates will reset the timer, but if no messages arrive for `timeoutMs` duration, the request is considered failed)
+            (0, rxjs_1.timeout)(timeoutMs || this.options.replyTimeout || 10000), 
+            // pass through only the final response message (filter out progress updates)
+            (0, rxjs_1.filter)((message) => message.kind === responseKind), 
+            // we only expect one response message, so complete the stream after the response arrives
+            (0, rxjs_1.take)(1));
             return (0, rxjs_1.of)(this.addEnvelope({ ...payload, id: AgentProtocol.nextId() })).pipe(
             // send the message to the agent
             (0, rxjs_1.tap)((p) => this.transport.send(p)), 

package/dist/default-validator.d.ts

@@ -7,4 +7,4 @@ export declare const createValidator: <T extends Agent>(agent: T) => (context: C
     objectKind?: "person" | "zone" | "schedule" | "device" | "accessRule" | undefined;
     objectId?: string | undefined;
     index?: number | undefined;
-}[], Record<"accessRule" | "schedule" | "person" | "device" | "zone", Record<string, Record<string, unknown>>>]>;
+}[], Record<"accessRule" | "schedule" | "person" | "zone" | "device", Record<string, Record<string, unknown>>>]>;

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './agent-app';
+export * from './agent-app-with-defaults';
 export * from './agent';
 export * from './constants';
 export * from './agent-protocol';

package/dist/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./agent-app"), exports);
+__exportStar(require("./agent-app-with-defaults"), exports);
 __exportStar(require("./agent"), exports);
 __exportStar(require("./constants"), exports);
 __exportStar(require("./agent-protocol"), exports);

package/dist/package.json

@@ -4,7 +4,7 @@
     "type": "git",
     "url": "git+https://github.com/Linc-Security-Systems/aware-essentials.git"
   },
-  "version": "2.0.74",
+  "version": "2.0.75",
   "description": "SDK for building Agent implementations that speak the agent protocol.",
   "author": "Yaser Awajan",
   "license": "MIT",
@@ -31,12 +31,12 @@
     "lint:fix": "yarn lint --fix"
   },
   "peerDependencies": {
-    "@awarevue/api-types": "2.0.74",
+    "@awarevue/api-types": "2.0.75",
     "rxjs": "^7.8.2",
     "ws": "^8"
   },
   "devDependencies": {
-    "@awarevue/api-types": "2.0.74",
+    "@awarevue/api-types": "2.0.75",
     "@types/node": "^20.12.7",
     "@types/ws": "^8.18.1",
     "@typescript-eslint/eslint-plugin": "^8.31.1",

package/dist/transports/logging.js

@@ -16,7 +16,7 @@ class LoggingDuplexTransport {
         this.inner = inner;
         this.label = (_a = opts.label) !== null && _a !== void 0 ? _a : 'transport';
         this.sink =
-            (_b = opts.logger) !== null && _b !== void 0 ? _b : ((direction, label, msg) => console.log(`[${label}] ${direction}`, JSON.stringify(msg, null, 2)));
+            (_b = opts.logger) !== null && _b !== void 0 ? _b : ((direction, label, msg) => console.log(`[${label}] ${direction}`, JSON.stringify(msg)));
         this.connected$ = inner.connected$;
         // Tap into the incoming stream before exposing it to consumers.
         this.messages$ = inner.messages$.pipe((0, operators_1.tap)((msg) => this.sink('IN', this.label, msg)));

package/package.json

@@ -4,7 +4,7 @@
     "type": "git",
     "url": "git+https://github.com/Linc-Security-Systems/aware-essentials.git"
   },
-  "version": "2.0.74",
+  "version": "2.0.75",
   "description": "SDK for building Agent implementations that speak the agent protocol.",
   "author": "Yaser Awajan",
   "license": "MIT",
@@ -31,12 +31,12 @@
     "lint:fix": "yarn lint --fix"
   },
   "peerDependencies": {
-    "@awarevue/api-types": "2.0.74",
+    "@awarevue/api-types": "2.0.75",
     "rxjs": "^7.8.2",
     "ws": "^8"
   },
   "devDependencies": {
-    "@awarevue/api-types": "2.0.74",
+    "@awarevue/api-types": "2.0.75",
     "@types/node": "^20.12.7",
     "@types/ws": "^8.18.1",
     "@typescript-eslint/eslint-plugin": "^8.31.1",