@teamnetwork-nz/ninjaone-mcp-server 0.1.0 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +94 -14
- package/dist/client.d.ts +4 -0
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +52 -6
- package/dist/client.js.map +1 -1
- package/dist/config.d.ts +1 -0
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +2 -0
- package/dist/config.js.map +1 -1
- package/dist/datetime.d.ts +1 -0
- package/dist/datetime.d.ts.map +1 -1
- package/dist/datetime.js +8 -0
- package/dist/datetime.js.map +1 -1
- package/dist/format.d.ts +16 -0
- package/dist/format.d.ts.map +1 -1
- package/dist/format.js +51 -6
- package/dist/format.js.map +1 -1
- package/dist/index.js +38 -11
- package/dist/index.js.map +1 -1
- package/dist/tools/alerts.d.ts.map +1 -1
- package/dist/tools/alerts.js +82 -29
- package/dist/tools/alerts.js.map +1 -1
- package/dist/tools/auth.d.ts.map +1 -1
- package/dist/tools/auth.js +13 -2
- package/dist/tools/auth.js.map +1 -1
- package/dist/tools/devices.d.ts.map +1 -1
- package/dist/tools/devices.js +194 -87
- package/dist/tools/devices.js.map +1 -1
- package/dist/tools/index.d.ts +2 -0
- package/dist/tools/index.d.ts.map +1 -1
- package/dist/tools/index.js +14 -1
- package/dist/tools/index.js.map +1 -1
- package/dist/tools/organizations.d.ts.map +1 -1
- package/dist/tools/organizations.js +69 -33
- package/dist/tools/organizations.js.map +1 -1
- package/dist/tools/policies.d.ts +3 -0
- package/dist/tools/policies.d.ts.map +1 -0
- package/dist/tools/policies.js +22 -0
- package/dist/tools/policies.js.map +1 -0
- package/dist/tools/queries.d.ts.map +1 -1
- package/dist/tools/queries.js +152 -72
- package/dist/tools/queries.js.map +1 -1
- package/dist/types.d.ts +21 -1
- package/dist/types.d.ts.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -77,6 +77,7 @@ Region → base URL:
|
|
|
77
77
|
| `NINJAONE_READWRITE` | `false` | `true` enables write helpers (Phase 1 ships no write tools) |
|
|
78
78
|
| `NINJAONE_DATETIMEFORMAT` | `local` | Timezone for date display — `local`, an IANA name (e.g. `Pacific/Auckland`), or `UTC` |
|
|
79
79
|
| `NINJAONE_PAGESIZE` | `100` | Default page size for list/query tools |
|
|
80
|
+
| `NINJAONE_FORMAT` | `markdown` | Default output format when a call omits `format`: `markdown` or `json` (see [Output format](#output-format-markdown-or-json)) |
|
|
80
81
|
|
|
81
82
|
## Claude Desktop configuration
|
|
82
83
|
|
|
@@ -106,7 +107,7 @@ claude mcp add ninjaone \
|
|
|
106
107
|
-- npx -y @teamnetwork-nz/ninjaone-mcp-server
|
|
107
108
|
```
|
|
108
109
|
|
|
109
|
-
## Available tools (
|
|
110
|
+
## Available tools (24, all read-only)
|
|
110
111
|
|
|
111
112
|
### Connection
|
|
112
113
|
| Tool | Description |
|
|
@@ -124,32 +125,37 @@ claude mcp add ninjaone \
|
|
|
124
125
|
| Tool | Description |
|
|
125
126
|
|---|---|
|
|
126
127
|
| `ninja_list_devices` | List machines — filter by org, location, class, online/offline, or raw `df` |
|
|
127
|
-
| `ninja_get_device` | Full device record: identity, OS, system, last contact/boot, IPs |
|
|
128
|
+
| `ninja_get_device` | Full device record: identity, OS, system, role policy & policy override, last contact/boot, IPs |
|
|
128
129
|
| `ninja_get_device_disks` | Physical disks — model, capacity, SMART |
|
|
129
130
|
| `ninja_get_device_volumes` | Logical volumes — capacity, free, % used |
|
|
130
131
|
| `ninja_get_device_processors` | CPUs — cores, clock |
|
|
131
132
|
| `ninja_get_device_network` | Network interfaces — IP/MAC/gateway/DNS |
|
|
132
|
-
| `ninja_get_device_software` | Installed software inventory |
|
|
133
|
+
| `ninja_get_device_software` | Installed software inventory (system vs user component) |
|
|
133
134
|
| `ninja_get_device_os_patches` | OS patch state |
|
|
134
135
|
| `ninja_get_device_last_user` | Last logged-on user |
|
|
135
|
-
| `ninja_get_device_activities` |
|
|
136
|
+
| `ninja_get_device_activities` | Device activity log, newest first (200 default, page older with `after`) |
|
|
136
137
|
| `ninja_get_device_custom_fields` | Custom field values |
|
|
137
138
|
|
|
138
139
|
### Fleet stats (aggregate queries)
|
|
139
140
|
| Tool | Description |
|
|
140
141
|
|---|---|
|
|
141
|
-
| `ninja_query_device_health` | Health
|
|
142
|
+
| `ninja_query_device_health` | Health bucket + connectivity + alert/patch/threat/vuln counts, one row per device |
|
|
142
143
|
| `ninja_query_operating_systems` | OS distribution per device |
|
|
143
144
|
| `ninja_query_computer_systems` | Make/model/serial/RAM per device |
|
|
144
145
|
| `ninja_query_volumes` | Disk capacity/usage fleet-wide |
|
|
145
|
-
| `ninja_query_antivirus_status` | AV product & protection status |
|
|
146
|
+
| `ninja_query_antivirus_status` | AV product & protection status (one row per product per device); `multipleActiveProducts=true` lists devices with 2+ products ON |
|
|
146
147
|
| `ninja_query_os_patches` | Pending OS patches fleet-wide |
|
|
147
148
|
|
|
148
149
|
### Alerts & activities
|
|
149
150
|
| Tool | Description |
|
|
150
151
|
|---|---|
|
|
151
|
-
| `ninja_list_alerts` | Currently triggered alerts (by device or org) |
|
|
152
|
-
| `ninja_list_activities` | Tenant-wide activity log |
|
|
152
|
+
| `ninja_list_alerts` | Currently triggered alerts (by device or org); filter by severity / priority / sourceType / since; reports "N of M in scope" |
|
|
153
|
+
| `ninja_list_activities` | Tenant-wide activity log, newest first; page older with `after` |
|
|
154
|
+
|
|
155
|
+
### Reference / lookups
|
|
156
|
+
| Tool | Description |
|
|
157
|
+
|---|---|
|
|
158
|
+
| `ninja_list_policies` | List policies (id, name, node class) — resolves the names shown in `ninja_get_device`'s `rolePolicy` / `policyOverride` |
|
|
153
159
|
|
|
154
160
|
## Agent guidance
|
|
155
161
|
|
|
@@ -167,14 +173,88 @@ the organisation name — e.g. `TEAMnetwork Systems - 81674` → `81674`. It app
|
|
|
167
173
|
`ninja_get_device`; organisations without such an id show it blank / `(none)`. Devices
|
|
168
174
|
inherit it from their organisation.
|
|
169
175
|
|
|
170
|
-
###
|
|
171
|
-
`
|
|
172
|
-
|
|
173
|
-
|
|
176
|
+
### Output format: Markdown or JSON
|
|
177
|
+
Every tool accepts `format="markdown" | "json"`, so the caller picks per request:
|
|
178
|
+
|
|
179
|
+
- **`markdown`** (default) — readable tables for presenting to a person. Totals and cursors
|
|
180
|
+
are in the footer line.
|
|
181
|
+
- **`json`** — the same data as typed JSON, returned as MCP `structuredContent` (and
|
|
182
|
+
serialized into the text block for clients that only forward text). Numbers and booleans
|
|
183
|
+
are raw (`capacityBytes`, `percentUsed: 27`, `offline: false`), every timestamp is
|
|
184
|
+
ISO-8601 UTC, and paging is data: `total`, `offset`, `hasMore`, `nextCursor` (query tools)
|
|
185
|
+
or `nextAfter` (list/activity tools). Some columns exist only in JSON (device ids, UIDs,
|
|
186
|
+
extra counts) where the Markdown table would be too wide.
|
|
187
|
+
|
|
188
|
+
Use `json` when paging through results or computing over them (e.g. filtering
|
|
189
|
+
`ninja_query_volumes` on `percentUsed`); use `markdown` when the answer is for a human.
|
|
190
|
+
Set `NINJAONE_FORMAT=json` to make JSON the server-wide default for headless/automation use.
|
|
191
|
+
`ninja_test_connection` and all `get_*`/`list_*`/`query_*` tools support it.
|
|
192
|
+
|
|
193
|
+
### Argument names
|
|
194
|
+
Arguments are camelCase: `ninja_get_device(deviceId=3)`. snake_case spellings
|
|
195
|
+
(`device_id`) are accepted and converted.
|
|
196
|
+
|
|
197
|
+
### Device filtering (`deviceFilter` / `df`)
|
|
198
|
+
`ninja_list_devices`, `ninja_list_alerts`, `ninja_list_activities` and the `ninja_query_*`
|
|
199
|
+
tools accept `organizationId`, `locationId`, `deviceClass`, `online`, or a raw NinjaOne
|
|
200
|
+
device-filter via `deviceFilter`. The convenience params and the raw filter are ANDed.
|
|
201
|
+
|
|
202
|
+
NinjaOne's `df` grammar is narrow and **returns an opaque `500 FAILURE` for anything it
|
|
203
|
+
does not recognise**. This server surfaces the exact filter that was sent plus this
|
|
204
|
+
cheat-sheet when that happens. Verified against a live tenant (2026-10-03):
|
|
205
|
+
|
|
206
|
+
| Works | Example |
|
|
207
|
+
|---|---|
|
|
208
|
+
| Keywords `online`, `offline` (lowercase) | `offline` |
|
|
209
|
+
| Fields `org`, `loc`, `class`, `role`, `id`, `status` | `org = 4`, `class in (WINDOWS_SERVER, MAC)`, `status eq APPROVED` |
|
|
210
|
+
| Operators `=` / `eq`, `<>` / `neq`, `in (a,b)` | `org <> 4`, `loc in (1,4)` |
|
|
211
|
+
| `AND` (case-insensitive) | `org = 4 AND offline` |
|
|
212
|
+
|
|
213
|
+
| Does **not** work (500) | Do this instead |
|
|
214
|
+
|---|---|
|
|
215
|
+
| `lastContactDaysAgo …`, `lastContact …` | Page `ninja_list_devices` (filter `offline`) and compare *Last Contact* yourself |
|
|
216
|
+
| `freeSpacePercent …` | Page `ninja_query_volumes` and filter on *% Used* |
|
|
217
|
+
| `name`, `tag`, `policy`, `group`, `pending`, `approved` | Use `status eq APPROVED`; filter the rest client-side |
|
|
218
|
+
| `not offline`, `!offline`, `org not in (…)`, `ne` | `online`, `org <> 4` |
|
|
219
|
+
| `OR` between clauses | Unreliable (`online OR offline` returned a partial set) — use `in (...)` |
|
|
220
|
+
|
|
221
|
+
### Fleet counts: devices vs. rows
|
|
222
|
+
`ninja_list_devices` returns one page (default 100) with no total — a 100-row result is the
|
|
223
|
+
page size, not the fleet size. For the fleet device count call
|
|
224
|
+
`ninja_query_device_health(pageSize=1)`; its footer total is one row per device.
|
|
225
|
+
`ninja_query_operating_systems` / `_computer_systems` are also one row per device (a few
|
|
226
|
+
devices may not have reported yet, e.g. 831 vs 834). `ninja_query_volumes`,
|
|
227
|
+
`_antivirus_status` and `_os_patches` are **one row per volume / AV product / patch**, so
|
|
228
|
+
their totals are record counts, not device counts.
|
|
229
|
+
|
|
230
|
+
### Device health: `Health` vs `Connectivity`
|
|
231
|
+
`ninja_query_device_health` has two independent columns. **Health** is NinjaOne's
|
|
232
|
+
`healthStatus` (`HEALTHY` / `NEEDS_ATTENTION` / `UNHEALTHY` / `UNKNOWN`) — drive alerting
|
|
233
|
+
from this plus the Alerts / Pending Patches / Threats / Crit Vulns counts. **Connectivity**
|
|
234
|
+
is only whether the agent is online (🟢) or offline (🔴). A device can be online and
|
|
235
|
+
`UNHEALTHY`, or offline with `UNKNOWN` health; that is not a contradiction.
|
|
236
|
+
|
|
237
|
+
### Antivirus
|
|
238
|
+
`ninja_query_antivirus_status` lists one row per AV product per device. Windows Defender
|
|
239
|
+
`OFF` beside one third-party product `ON` is the normal healthy state. Pass
|
|
240
|
+
`multipleActiveProducts=true` to list only devices with **2+ products `ON`** (the genuine
|
|
241
|
+
conflict case); it scans the whole result set server-side.
|
|
242
|
+
|
|
243
|
+
### Alerts
|
|
244
|
+
`ninja_list_alerts` supports client-side `severity`, `priority`, `sourceType` and `since`
|
|
245
|
+
filters and always reports `N of M active alerts in scope`, so an empty result can be told
|
|
246
|
+
apart from "everything was filtered out".
|
|
174
247
|
|
|
175
248
|
### Pagination
|
|
176
|
-
- List tools use cursor pagination — pass the reported `after=<id>`.
|
|
177
|
-
|
|
249
|
+
- List tools use cursor pagination — pass the reported `after=<id>`. For
|
|
250
|
+
`ninja_list_activities` / `ninja_get_device_activities` the cursor is the **oldest id on
|
|
251
|
+
the page** (shown in the footer); NinjaOne enforces a minimum `pageSize` of 10 there and
|
|
252
|
+
returns no total.
|
|
253
|
+
- `ninja_query_*` tools return a cursor name — pass it back as `cursor=<name>`. The name is
|
|
254
|
+
**the same on every page**: NinjaOne holds the position server-side and each call that
|
|
255
|
+
passes the cursor advances it, so don't reuse a cursor to re-fetch a page (start a new
|
|
256
|
+
query without `cursor` instead). The footer reads `rows X–Y of TOTAL`.
|
|
257
|
+
- In `markdown` format totals/cursors live in the footer line; in `json` they are fields.
|
|
178
258
|
|
|
179
259
|
## Read-only mode (default)
|
|
180
260
|
|
package/dist/client.d.ts
CHANGED
|
@@ -6,6 +6,7 @@ export interface DeviceFilterOptions {
|
|
|
6
6
|
online?: boolean;
|
|
7
7
|
raw?: string;
|
|
8
8
|
}
|
|
9
|
+
export declare const DF_SYNTAX_HELP: string;
|
|
9
10
|
export interface PagingParams {
|
|
10
11
|
pageSize?: number;
|
|
11
12
|
after?: number | string;
|
|
@@ -19,6 +20,7 @@ export declare class NinjaClient {
|
|
|
19
20
|
private orgNameCache;
|
|
20
21
|
private locationNameCache;
|
|
21
22
|
private deviceLabelCache;
|
|
23
|
+
private policyNameCache;
|
|
22
24
|
constructor(config: NinjaConfig);
|
|
23
25
|
authenticate(): Promise<void>;
|
|
24
26
|
private ensureToken;
|
|
@@ -43,6 +45,8 @@ export declare class NinjaClient {
|
|
|
43
45
|
resolveLocationName(id: number | undefined): Promise<string>;
|
|
44
46
|
private ensureDeviceCache;
|
|
45
47
|
resolveDeviceLabel(id: number | undefined): Promise<string>;
|
|
48
|
+
private ensurePolicyCache;
|
|
49
|
+
resolvePolicyName(id: number | undefined): Promise<string>;
|
|
46
50
|
clearNameCaches(): void;
|
|
47
51
|
}
|
|
48
52
|
//# sourceMappingURL=client.d.ts.map
|
package/dist/client.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;
|
|
1
|
+
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAKD,eAAO,MAAM,cAAc,QAI8F,CAAC;AAE1H,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,YAAY,CAAuB;IAG3C,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,iBAAiB,CAAoC;IAC7D,OAAO,CAAC,gBAAgB,CAAoC;IAC5D,OAAO,CAAC,eAAe,CAAoC;gBAE/C,MAAM,EAAE,WAAW;IAUzB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;YA2CrB,WAAW;IAMzB,OAAO,CAAC,UAAU;IAKlB,eAAe,IAAI,MAAM,GAAG,IAAI;IAIhC,UAAU,IAAI,MAAM;IAIpB,kBAAkB,IAAI,MAAM;YAMd,OAAO;IAkDrB,WAAW,IAAI,OAAO;IAItB,OAAO,CAAC,oBAAoB;IAQtB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIlE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAKhD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAKhD,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAKjD,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAOzC,WAAW,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAS3D,iBAAiB,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,MAAM,GAAG,SAAS;YAenD,cAAc;YAed,mBAAmB;IAe3B,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAQvD,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAM1D,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;YAMpD,iBAAiB;IAsBzB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;YAMnD,iBAAiB;IAezB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAOhE,eAAe,IAAI,IAAI;CAMxB"}
|
package/dist/client.js
CHANGED
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
import axios from 'axios';
|
|
2
2
|
import { extractTeamlinkId } from './teamlink.js';
|
|
3
|
+
// Device-filter (df) syntax verified live against the oc tenant (2026-10-03). NinjaOne
|
|
4
|
+
// answers an unrecognised field/operator with a bare `500 FAILURE`, so this text is both
|
|
5
|
+
// the tool-schema documentation and the hint appended to df errors.
|
|
6
|
+
export const DF_SYNTAX_HELP = 'Supported fields: org, loc, class, role, id, status. Keywords: online, offline (lowercase). ' +
|
|
7
|
+
'Operators: = / eq, <> / neq, in (a,b). Combine with AND (OR is unreliable — use `in (...)` instead). ' +
|
|
8
|
+
'Examples: "offline", "org = 4 AND offline", "class in (WINDOWS_SERVER, MAC)", "status eq APPROVED". ' +
|
|
9
|
+
'NOT supported: last-contact age, free space, name, tags, policy, group, health, "not"/"!" — filter those client-side.';
|
|
3
10
|
export class NinjaClient {
|
|
4
11
|
http;
|
|
5
12
|
config;
|
|
@@ -10,6 +17,7 @@ export class NinjaClient {
|
|
|
10
17
|
orgNameCache = null;
|
|
11
18
|
locationNameCache = null;
|
|
12
19
|
deviceLabelCache = null;
|
|
20
|
+
policyNameCache = null;
|
|
13
21
|
constructor(config) {
|
|
14
22
|
this.config = config;
|
|
15
23
|
this.http = axios.create({
|
|
@@ -100,7 +108,13 @@ export class NinjaClient {
|
|
|
100
108
|
respData?.['message'] ??
|
|
101
109
|
respData?.['error'] ??
|
|
102
110
|
err.message;
|
|
103
|
-
|
|
111
|
+
const status = err.response?.status;
|
|
112
|
+
const df = params?.['df'];
|
|
113
|
+
if (df !== undefined && status !== undefined && status >= 400 && status < 600) {
|
|
114
|
+
throw new Error(`NinjaOne API error [${status}]: ${msg}. The request was GET ${path} with deviceFilter (df) = ${JSON.stringify(df)}. ` +
|
|
115
|
+
`NinjaOne returns an opaque 500 when it does not recognise a df expression. ${DF_SYNTAX_HELP}`);
|
|
116
|
+
}
|
|
117
|
+
throw new Error(`NinjaOne API error [${status}]: ${msg}`);
|
|
104
118
|
}
|
|
105
119
|
throw err;
|
|
106
120
|
}
|
|
@@ -223,11 +237,19 @@ export class NinjaClient {
|
|
|
223
237
|
return this.deviceLabelCache;
|
|
224
238
|
const cache = new Map();
|
|
225
239
|
try {
|
|
226
|
-
//
|
|
227
|
-
|
|
228
|
-
for (
|
|
229
|
-
|
|
230
|
-
|
|
240
|
+
// Page through every device (1000/page); unresolved ids fall back to the raw id.
|
|
241
|
+
let after;
|
|
242
|
+
for (let page = 0; page < 50; page++) {
|
|
243
|
+
const devices = await this.get('/v2/devices', { pageSize: 1000, ...(after ? { after } : {}) });
|
|
244
|
+
for (const d of devices ?? []) {
|
|
245
|
+
if (d.id !== undefined)
|
|
246
|
+
cache.set(d.id, d.displayName ?? d.systemName ?? d.dnsName ?? String(d.id));
|
|
247
|
+
}
|
|
248
|
+
if (!devices || devices.length < 1000)
|
|
249
|
+
break;
|
|
250
|
+
after = devices[devices.length - 1]?.id;
|
|
251
|
+
if (after === undefined)
|
|
252
|
+
break;
|
|
231
253
|
}
|
|
232
254
|
}
|
|
233
255
|
catch {
|
|
@@ -242,11 +264,35 @@ export class NinjaClient {
|
|
|
242
264
|
const cache = await this.ensureDeviceCache();
|
|
243
265
|
return cache.get(id) ?? String(id);
|
|
244
266
|
}
|
|
267
|
+
async ensurePolicyCache() {
|
|
268
|
+
if (this.policyNameCache)
|
|
269
|
+
return this.policyNameCache;
|
|
270
|
+
const cache = new Map();
|
|
271
|
+
try {
|
|
272
|
+
const policies = await this.get('/v2/policies');
|
|
273
|
+
for (const p of policies ?? []) {
|
|
274
|
+
if (p.id !== undefined)
|
|
275
|
+
cache.set(p.id, p.name ?? String(p.id));
|
|
276
|
+
}
|
|
277
|
+
}
|
|
278
|
+
catch {
|
|
279
|
+
// ignore
|
|
280
|
+
}
|
|
281
|
+
this.policyNameCache = cache;
|
|
282
|
+
return cache;
|
|
283
|
+
}
|
|
284
|
+
async resolvePolicyName(id) {
|
|
285
|
+
if (id === undefined)
|
|
286
|
+
return '';
|
|
287
|
+
const cache = await this.ensurePolicyCache();
|
|
288
|
+
return cache.get(id) ?? String(id);
|
|
289
|
+
}
|
|
245
290
|
// Drop cached names so the next resolve refetches (e.g. after a known change).
|
|
246
291
|
clearNameCaches() {
|
|
247
292
|
this.orgNameCache = null;
|
|
248
293
|
this.locationNameCache = null;
|
|
249
294
|
this.deviceLabelCache = null;
|
|
295
|
+
this.policyNameCache = null;
|
|
250
296
|
}
|
|
251
297
|
}
|
|
252
298
|
//# sourceMappingURL=client.js.map
|
package/dist/client.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAA4C,MAAM,OAAO,CAAC;AAGjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAA4C,MAAM,OAAO,CAAC;AAGjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAUlD,uFAAuF;AACvF,yFAAyF;AACzF,oEAAoE;AACpE,MAAM,CAAC,MAAM,cAAc,GACzB,8FAA8F;IAC9F,uGAAuG;IACvG,sGAAsG;IACtG,uHAAuH,CAAC;AAO1H,MAAM,OAAO,WAAW;IACd,IAAI,CAAgB;IACpB,MAAM,CAAc;IACpB,WAAW,GAAkB,IAAI,CAAC;IAClC,cAAc,GAAG,CAAC,CAAC,CAAC,eAAe;IACnC,YAAY,GAAkB,IAAI,CAAC;IAE3C,4FAA4F;IACpF,YAAY,GAA+B,IAAI,CAAC;IAChD,iBAAiB,GAA+B,IAAI,CAAC;IACrD,gBAAgB,GAA+B,IAAI,CAAC;IACpD,eAAe,GAA+B,IAAI,CAAC;IAE3D,YAAY,MAAmB;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;SAChD,CAAC,CAAC;IACL,CAAC;IAED,8EAA8E;IAE9E,KAAK,CAAC,YAAY;QAChB,MAAM,IAAI,GAAG,IAAI,eAAe,CAAC;YAC/B,UAAU,EAAE,oBAAoB;YAChC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;YAC/B,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY;YACvC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;SACzB,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC;QACT,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAgB,iBAAiB,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE;gBAC7E,OAAO,EAAE,EAAE,cAAc,EAAE,mCAAmC,EAAE;aACjE,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,IAAI,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC5B,MAAM,CAAC,GAAG,GAAG,CAAC,QAAQ,EAAE,IAA2C,CAAC;gBACpE,MAAM,MAAM,GACT,CAAC,EAAE,CAAC,YAAY,CAAY;oBAC5B,CAAC,EAAE,CAAC,mBAAmB,CAAY;oBACnC,CAAC,EAAE,CAAC,OAAO,CAAY;oBACxB,GAAG,CAAC,OAAO,CAAC;gBACd,MAAM,IAAI,KAAK,CACb,mCAAmC,GAAG,CAAC,QAAQ,EAAE,MAAM,MAAM,MAAM,IAAI;oBACrE,sEAAsE,CACzE,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC;QACtC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC;QAC5C,oCAAoC;QACpC,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC;QACpD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,MAAM,CAAC;QAClD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,kCAAkC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,iBAAiB,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CACvH,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,WAAW;QACvB,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC3D,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;IAEO,UAAU;QAChB,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAC5D,OAAO,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;IACzD,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED,kBAAkB;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED,6EAA6E;IAErE,KAAK,CAAC,OAAO,CACnB,MAAc,EACd,IAAY,EACZ,IAAc,EACd,MAAgC,EAChC,KAAK,GAAG,IAAI;QAEZ,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAEzB,MAAM,GAAG,GAAuB;YAC9B,MAAM;YACN,GAAG,EAAE,IAAI;YACT,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE;YAC1B,MAAM;YACN,IAAI;SACL,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAI,GAAG,CAAC,CAAC;YAC7C,OAAO,IAAI,CAAC,IAAI,CAAC;QACnB,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,IAAI,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC;gBACrE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;gBACxB,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC1B,OAAO,IAAI,CAAC,OAAO,CAAI,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YAC5D,CAAC;YACD,IAAI,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC5B,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,EAAE,IAA2C,CAAC;gBAC3E,MAAM,GAAG,GACN,QAAQ,EAAE,CAAC,mBAAmB,CAAY;oBAC1C,QAAQ,EAAE,CAAC,YAAY,CAAY;oBACnC,QAAQ,EAAE,CAAC,SAAS,CAAY;oBAChC,QAAQ,EAAE,CAAC,OAAO,CAAY;oBAC/B,GAAG,CAAC,OAAO,CAAC;gBACd,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACpC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;gBAC1B,IAAI,EAAE,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;oBAC9E,MAAM,IAAI,KAAK,CACb,uBAAuB,MAAM,MAAM,GAAG,yBAAyB,IAAI,6BAA6B,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI;wBACpH,8EAA8E,cAAc,EAAE,CACjG,CAAC;gBACJ,CAAC;gBACD,MAAM,IAAI,KAAK,CAAC,uBAAuB,MAAM,MAAM,GAAG,EAAE,CAAC,CAAC;YAC5D,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,8EAA8E;IAE9E,WAAW;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;IAC/B,CAAC;IAEO,oBAAoB;QAC1B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CACb,+FAA+F,CAChG,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,IAAY,EAAE,MAAgC;QACzD,OAAO,IAAI,CAAC,OAAO,CAAI,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,IAAI,CAAI,IAAY,EAAE,IAAa;QACvC,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAI,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,IAAY,EAAE,IAAc;QACvC,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAI,KAAK,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,KAAK,CAAI,IAAY,EAAE,IAAa;QACxC,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAI,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,MAAM,CAAI,IAAY;QAC1B,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAI,QAAQ,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,8EAA8E;IAE9E,WAAW,CAAC,MAAqB;QAC/B,MAAM,CAAC,GAA4B,EAAE,CAAC;QACtC,CAAC,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACzE,IAAI,MAAM,EAAE,KAAK,KAAK,SAAS;YAAE,CAAC,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;QAC3D,OAAO,CAAC,CAAC;IACX,CAAC;IAED,gFAAgF;IAChF,yEAAyE;IACzE,iBAAiB,CAAC,IAA0B;QAC1C,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC;QAC5B,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;QACpF,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAC5E,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAClE,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI;YAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK;YAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,IAAI,CAAC,GAAG;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QACtC,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,8EAA8E;IAEtE,KAAK,CAAC,cAAc;QAC1B,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC,YAAY,CAAC;QAChD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAiB,mBAAmB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YACrF,KAAK,MAAM,CAAC,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;gBAC3B,IAAI,CAAC,CAAC,EAAE,KAAK,SAAS;oBAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,8DAA8D;QAChE,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,KAAK,CAAC,mBAAmB;QAC/B,IAAI,IAAI,CAAC,iBAAiB;YAAE,OAAO,IAAI,CAAC,iBAAiB,CAAC;QAC1D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAa,eAAe,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7E,KAAK,MAAM,CAAC,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;gBAC3B,IAAI,CAAC,CAAC,EAAE,KAAK,SAAS;oBAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,EAAsB;QACzC,IAAI,EAAE,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,kFAAkF;IAClF,yDAAyD;IACzD,KAAK,CAAC,iBAAiB,CAAC,EAAsB;QAC5C,IAAI,EAAE,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC1C,OAAO,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,EAAsB;QAC9C,IAAI,EAAE,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC/C,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IAEO,KAAK,CAAC,iBAAiB;QAC7B,IAAI,IAAI,CAAC,gBAAgB;YAAE,OAAO,IAAI,CAAC,gBAAgB,CAAC;QACxD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;QACxC,IAAI,CAAC;YACH,iFAAiF;YACjF,IAAI,KAAyB,CAAC;YAC9B,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;gBACrC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAW,aAAa,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBACzG,KAAK,MAAM,CAAC,IAAI,OAAO,IAAI,EAAE,EAAE,CAAC;oBAC9B,IAAI,CAAC,CAAC,EAAE,KAAK,SAAS;wBAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACtG,CAAC;gBACD,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI;oBAAE,MAAM;gBAC7C,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC;gBACxC,IAAI,KAAK,KAAK,SAAS;oBAAE,MAAM;YACjC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,EAAsB;QAC7C,IAAI,EAAE,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC7C,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IAEO,KAAK,CAAC,iBAAiB;QAC7B,IAAI,IAAI,CAAC,eAAe;YAAE,OAAO,IAAI,CAAC,eAAe,CAAC;QACtD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAW,cAAc,CAAC,CAAC;YAC1D,KAAK,MAAM,CAAC,IAAI,QAAQ,IAAI,EAAE,EAAE,CAAC;gBAC/B,IAAI,CAAC,CAAC,EAAE,KAAK,SAAS;oBAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,EAAsB;QAC5C,IAAI,EAAE,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC7C,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,+EAA+E;IAC/E,eAAe;QACb,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAC9B,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC7B,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;IAC9B,CAAC;CACF"}
|
package/dist/config.d.ts
CHANGED
package/dist/config.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;
|
|
1
|
+
{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC;CAC7B;AAYD,wBAAgB,UAAU,IAAI,WAAW,CAgDxC"}
|
package/dist/config.js
CHANGED
|
@@ -40,6 +40,7 @@ export function loadConfig() {
|
|
|
40
40
|
// "management" when readWrite is enabled.
|
|
41
41
|
const scope = readWrite ? 'monitoring management' : 'monitoring';
|
|
42
42
|
const pageSize = clampPageSize(process.env.NINJAONE_PAGESIZE);
|
|
43
|
+
const format = process.env.NINJAONE_FORMAT?.trim().toLowerCase() === 'json' ? 'json' : 'markdown';
|
|
43
44
|
return {
|
|
44
45
|
baseUrl: baseUrl.replace(/\/$/, ''),
|
|
45
46
|
clientId: clientId,
|
|
@@ -47,6 +48,7 @@ export function loadConfig() {
|
|
|
47
48
|
scope,
|
|
48
49
|
readWrite,
|
|
49
50
|
pageSize,
|
|
51
|
+
format,
|
|
50
52
|
};
|
|
51
53
|
}
|
|
52
54
|
function clampPageSize(raw) {
|
package/dist/config.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
|
package/dist/datetime.d.ts
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
export declare function getConfiguredTz(): string;
|
|
2
2
|
export declare function fromUtc(value: string | number | null | undefined): string;
|
|
3
|
+
export declare function toIso(value: string | number | null | undefined): string | null;
|
|
3
4
|
export declare function maybeFromUtc(val: unknown): unknown;
|
|
4
5
|
//# sourceMappingURL=datetime.d.ts.map
|
package/dist/datetime.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"datetime.d.ts","sourceRoot":"","sources":["../src/datetime.ts"],"names":[],"mappings":"AASA,wBAAgB,eAAe,IAAI,MAAM,CAGxC;AAID,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAuBzE;AAqBD,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAGlD"}
|
|
1
|
+
{"version":3,"file":"datetime.d.ts","sourceRoot":"","sources":["../src/datetime.ts"],"names":[],"mappings":"AASA,wBAAgB,eAAe,IAAI,MAAM,CAGxC;AAID,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAuBzE;AAID,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAI9E;AAqBD,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAGlD"}
|
package/dist/datetime.js
CHANGED
|
@@ -38,6 +38,14 @@ export function fromUtc(value) {
|
|
|
38
38
|
return String(value);
|
|
39
39
|
}
|
|
40
40
|
}
|
|
41
|
+
// Normalise any NinjaOne timestamp (epoch seconds/millis or ISO string) to ISO-8601 UTC
|
|
42
|
+
// ("2026-10-03T00:52:27.000Z") for structured output. Returns null when absent/unparseable.
|
|
43
|
+
export function toIso(value) {
|
|
44
|
+
if (value === null || value === undefined || value === '')
|
|
45
|
+
return null;
|
|
46
|
+
const d = toDate(value);
|
|
47
|
+
return d && !isNaN(d.getTime()) ? d.toISOString() : null;
|
|
48
|
+
}
|
|
41
49
|
// NinjaOne epoch timestamps may be seconds (10-digit) or millis (13-digit), sometimes
|
|
42
50
|
// fractional seconds. Normalise to a Date.
|
|
43
51
|
function toDate(value) {
|
package/dist/datetime.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"datetime.js","sourceRoot":"","sources":["../src/datetime.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"datetime.js","sourceRoot":"","sources":["../src/datetime.ts"],"names":[],"mappings":"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"}
|
package/dist/format.d.ts
CHANGED
|
@@ -1,7 +1,23 @@
|
|
|
1
|
+
import type { ToolResult } from './types.js';
|
|
1
2
|
export declare function humanBytes(bytes: number | undefined | null): string;
|
|
2
3
|
export declare function formatClock(value: number | undefined | null): string;
|
|
3
4
|
export declare function joinList(value: unknown): string;
|
|
5
|
+
export declare function percentUsedNum(free: number | undefined, capacity: number | undefined): number | null;
|
|
4
6
|
export declare function percentUsed(free: number | undefined, capacity: number | undefined): string;
|
|
7
|
+
export declare function toList(value: unknown): string[];
|
|
8
|
+
export interface Column<T> {
|
|
9
|
+
header: string;
|
|
10
|
+
key: string;
|
|
11
|
+
value: (item: T) => unknown;
|
|
12
|
+
display?: (item: T) => string;
|
|
13
|
+
jsonOnly?: boolean;
|
|
14
|
+
}
|
|
15
|
+
export interface TableOptions {
|
|
16
|
+
footer?: string;
|
|
17
|
+
meta?: Record<string, unknown>;
|
|
18
|
+
emptyMessage?: string;
|
|
19
|
+
}
|
|
20
|
+
export declare function tableResult<T>(title: string, cols: Column<T>[], items: T[], opts?: TableOptions): ToolResult;
|
|
5
21
|
export declare function table(title: string, headers: string[], rows: string[][]): string;
|
|
6
22
|
export declare function objectBlock(label: string, obj: Record<string, unknown>): string;
|
|
7
23
|
//# sourceMappingURL=format.d.ts.map
|
package/dist/format.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAOnE;AAID,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAIpE;AAID,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAK/C;AAGD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAGpG;AAGD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG1F;AAGD,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAI/C;AAMD,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;IAC5B,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAOD,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,GAAE,YAAiB,GAAG,UAAU,CAYhH;AAGD,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAUhF;AAID,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAK/E"}
|
package/dist/format.js
CHANGED
|
@@ -31,12 +31,42 @@ export function joinList(value) {
|
|
|
31
31
|
return '';
|
|
32
32
|
return String(value);
|
|
33
33
|
}
|
|
34
|
-
// Percent used given free & capacity (both bytes).
|
|
35
|
-
export function
|
|
34
|
+
// Percent used given free & capacity (both bytes), as a number (null when unknowable).
|
|
35
|
+
export function percentUsedNum(free, capacity) {
|
|
36
36
|
if (!capacity || free === undefined)
|
|
37
|
-
return
|
|
38
|
-
|
|
39
|
-
|
|
37
|
+
return null;
|
|
38
|
+
return Math.round(((capacity - free) / capacity) * 100);
|
|
39
|
+
}
|
|
40
|
+
// Percent used for display ("27%", or '' when unknowable).
|
|
41
|
+
export function percentUsed(free, capacity) {
|
|
42
|
+
const n = percentUsedNum(free, capacity);
|
|
43
|
+
return n === null ? '' : `${n}%`;
|
|
44
|
+
}
|
|
45
|
+
// Normalise a list-ish field (array, or ';'/',' separated string) to a string array.
|
|
46
|
+
export function toList(value) {
|
|
47
|
+
if (Array.isArray(value))
|
|
48
|
+
return value.filter(Boolean).map(String);
|
|
49
|
+
if (typeof value === 'string')
|
|
50
|
+
return value.split(/[;,]/).map((s) => s.trim()).filter(Boolean);
|
|
51
|
+
return [];
|
|
52
|
+
}
|
|
53
|
+
function cellText(v) {
|
|
54
|
+
return v === null || v === undefined ? '' : String(v);
|
|
55
|
+
}
|
|
56
|
+
// Build both renderings of a table from one set of items.
|
|
57
|
+
export function tableResult(title, cols, items, opts = {}) {
|
|
58
|
+
const shown = cols.filter((c) => !c.jsonOnly);
|
|
59
|
+
const body = items.map((it) => shown.map((c) => (c.display ? c.display(it) : cellText(c.value(it)))));
|
|
60
|
+
let markdown = items.length === 0 && opts.emptyMessage ? opts.emptyMessage : table(title, shown.map((c) => c.header), body);
|
|
61
|
+
if (opts.footer)
|
|
62
|
+
markdown += `\n\n${opts.footer}`;
|
|
63
|
+
const data = {
|
|
64
|
+
title,
|
|
65
|
+
count: items.length,
|
|
66
|
+
...opts.meta,
|
|
67
|
+
rows: items.map((it) => Object.fromEntries(cols.map((c) => [c.key, c.value(it) ?? null]))),
|
|
68
|
+
};
|
|
69
|
+
return { markdown, data };
|
|
40
70
|
}
|
|
41
71
|
// Render a Markdown table from headers + rows. Empty rows → "No records" line.
|
|
42
72
|
export function table(title, headers, rows) {
|
|
@@ -54,11 +84,26 @@ export function table(title, headers, rows) {
|
|
|
54
84
|
// Render a single object as a key/value block, dropping empty values and converting
|
|
55
85
|
// ISO datetime strings to the configured timezone.
|
|
56
86
|
export function objectBlock(label, obj) {
|
|
57
|
-
const lines = Object.entries(obj)
|
|
87
|
+
const lines = Object.entries(flatten(obj))
|
|
58
88
|
.filter(([, v]) => v !== null && v !== undefined && v !== '' && !(Array.isArray(v) && v.length === 0))
|
|
59
89
|
.map(([k, v]) => `- **${k}**: ${render(v)}`);
|
|
60
90
|
return `**${label}**\n\n${lines.join('\n')}`;
|
|
61
91
|
}
|
|
92
|
+
// Expand nested plain objects into dotted keys (settings.psa.enabled: true) so they read
|
|
93
|
+
// as fields rather than a JSON blob. Arrays and non-plain values are left as-is.
|
|
94
|
+
function flatten(obj, prefix = '', depth = 0) {
|
|
95
|
+
const out = {};
|
|
96
|
+
for (const [k, v] of Object.entries(obj)) {
|
|
97
|
+
const key = prefix ? `${prefix}.${k}` : k;
|
|
98
|
+
if (v && typeof v === 'object' && !Array.isArray(v) && depth < 4 && Object.keys(v).length > 0) {
|
|
99
|
+
Object.assign(out, flatten(v, key, depth + 1));
|
|
100
|
+
}
|
|
101
|
+
else {
|
|
102
|
+
out[key] = v;
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
return out;
|
|
106
|
+
}
|
|
62
107
|
function render(v) {
|
|
63
108
|
const converted = maybeFromUtc(v);
|
|
64
109
|
if (typeof converted === 'object')
|
package/dist/format.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;
|
|
1
|
+
{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"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"}
|