Add REST message to get online PAM controllers (#119)

Author: tylerccarson

keeperapi/package-lock.json

@@ -1,7 +1,7 @@
 {
     "name": "@keeper-security/keeperapi",
     "description": "Keeper API Javascript SDK",
-    "version": "17.1.0",
+    "version": "17.1.1",
     "browser": "dist/index.es.js",
     "main": "dist/index.cjs.js",
     "types": "dist/node/index.d.ts",

keeperapi/package.json

@@ -1,7 +1,8 @@
 import { Auth } from './auth'
 import { GraphSync } from './proto'
 import { normal64Bytes, webSafe64FromBytes } from './utils'
-import { pamGetLeafsMessage, pamMultiSyncMessage, pamSyncMessage } from './restMessages'
+import { pamGetLeafsMessage, pamGetOnlineControllersMessage, pamMultiSyncMessage, pamSyncMessage } from './restMessages'
+import { PAM } from './proto'
 
 /**
  * Syncs the PAM link DAG for a single record UID.
@@ -102,3 +103,17 @@ export async function getConfigRootsForRecordUids(
     const result = await auth.executeRouterRest(pamGetLeafsMessage({ vertices }))
     return result.refs ?? []
 }
+
+/**
+ * Returns the UIDs of all PAM controllers that are accessible to the user.
+ */
+export async function getOnlinePamControllerUids(auth: Auth): Promise<string[]> {
+    const result = await auth.executeRouterRest(pamGetOnlineControllersMessage())
+    const controllerUids: string[] = []
+    for (const c of result.controllers) {
+        if (c.controllerUid && c.controllerUid.length > 0) {
+            controllerUids.push(webSafe64FromBytes(c.controllerUid))
+        }
+    }
+    return controllerUids
+}

keeperapi/src/pam.ts

@@ -9,6 +9,7 @@ import {
     Automator,
     Enterprise,
     GraphSync,
+    PAM,
     Records,
     ServiceLogger,
     SsoCloud,
@@ -866,3 +867,6 @@ export const pamGetLeafsMessage = (
         GraphSync.GraphSyncLeafsQuery,
         GraphSync.GraphSyncRefsResult
     )
+
+export const pamGetOnlineControllersMessage = (): RestMessage<PAM.IPAMOnlineControllers, PAM.PAMOnlineControllers> =>
+    createMessage({}, 'api/user/get_controllers', PAM.PAMOnlineControllers, PAM.PAMOnlineControllers)