@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.
Files changed (45) hide show
  1. package/README.md +94 -14
  2. package/dist/client.d.ts +4 -0
  3. package/dist/client.d.ts.map +1 -1
  4. package/dist/client.js +52 -6
  5. package/dist/client.js.map +1 -1
  6. package/dist/config.d.ts +1 -0
  7. package/dist/config.d.ts.map +1 -1
  8. package/dist/config.js +2 -0
  9. package/dist/config.js.map +1 -1
  10. package/dist/datetime.d.ts +1 -0
  11. package/dist/datetime.d.ts.map +1 -1
  12. package/dist/datetime.js +8 -0
  13. package/dist/datetime.js.map +1 -1
  14. package/dist/format.d.ts +16 -0
  15. package/dist/format.d.ts.map +1 -1
  16. package/dist/format.js +51 -6
  17. package/dist/format.js.map +1 -1
  18. package/dist/index.js +38 -11
  19. package/dist/index.js.map +1 -1
  20. package/dist/tools/alerts.d.ts.map +1 -1
  21. package/dist/tools/alerts.js +82 -29
  22. package/dist/tools/alerts.js.map +1 -1
  23. package/dist/tools/auth.d.ts.map +1 -1
  24. package/dist/tools/auth.js +13 -2
  25. package/dist/tools/auth.js.map +1 -1
  26. package/dist/tools/devices.d.ts.map +1 -1
  27. package/dist/tools/devices.js +194 -87
  28. package/dist/tools/devices.js.map +1 -1
  29. package/dist/tools/index.d.ts +2 -0
  30. package/dist/tools/index.d.ts.map +1 -1
  31. package/dist/tools/index.js +14 -1
  32. package/dist/tools/index.js.map +1 -1
  33. package/dist/tools/organizations.d.ts.map +1 -1
  34. package/dist/tools/organizations.js +69 -33
  35. package/dist/tools/organizations.js.map +1 -1
  36. package/dist/tools/policies.d.ts +3 -0
  37. package/dist/tools/policies.d.ts.map +1 -0
  38. package/dist/tools/policies.js +22 -0
  39. package/dist/tools/policies.js.map +1 -0
  40. package/dist/tools/queries.d.ts.map +1 -1
  41. package/dist/tools/queries.js +152 -72
  42. package/dist/tools/queries.js.map +1 -1
  43. package/dist/types.d.ts +21 -1
  44. package/dist/types.d.ts.map +1 -1
  45. package/package.json +1 -1
package/dist/index.js CHANGED
@@ -6,9 +6,18 @@ import { zodToJsonSchema } from 'zod-to-json-schema';
6
6
  import { loadConfig } from './config.js';
7
7
  import { NinjaClient } from './client.js';
8
8
  import { allTools } from './tools/index.js';
9
+ // Tool arguments are camelCase (deviceId). Accept snake_case spellings (device_id) too,
10
+ // since that is the most common slip when calling tools.
11
+ function camelCaseKeys(args) {
12
+ const out = {};
13
+ for (const [k, v] of Object.entries(args)) {
14
+ out[k.replace(/_([a-z])/g, (_, c) => c.toUpperCase())] = v;
15
+ }
16
+ return out;
17
+ }
9
18
  const config = loadConfig();
10
19
  const client = new NinjaClient(config);
11
- const server = new Server({ name: 'ninjaone-mcp-server', version: '0.1.0' }, {
20
+ const server = new Server({ name: 'ninjaone-mcp-server', version: '0.3.0' }, {
12
21
  capabilities: { tools: {} },
13
22
  instructions: `
14
23
  NinjaOne RMM MCP server — remote monitoring and management via the NinjaOne Public API v2.
@@ -24,6 +33,7 @@ NinjaOne RMM MCP server — remote monitoring and management via the NinjaOne Pu
24
33
  ## Device filtering
25
34
  - ninja_list_devices and the ninja_query_* tools accept organizationId, locationId, deviceClass, online, or a raw NinjaOne device-filter (df) via deviceFilter.
26
35
  - Device classes include WINDOWS_WORKSTATION, WINDOWS_SERVER, MAC, LINUX_SERVER, etc.
36
+ - deviceFilter (df) accepts ONLY: fields org, loc, class, role, id, status; keywords online / offline (lowercase); operators = / eq, <> / neq, in (a,b); joined with AND. Examples: "offline", "org = 4 AND offline", "class in (WINDOWS_SERVER, MAC)". OR is unreliable (use in (...)). Anything else (last-contact age, free space, name, tags, policy, health, "not") makes NinjaOne return an opaque 500 — filter those client-side from the returned rows.
27
37
 
28
38
  ## Common workflows
29
39
 
@@ -31,21 +41,30 @@ NinjaOne RMM MCP server — remote monitoring and management via the NinjaOne Pu
31
41
  ninja_list_devices with organizationId (and optionally deviceClass or online).
32
42
 
33
43
  ### Inspect one machine
34
- - ninja_get_device — identity, OS, system, last contact/boot.
44
+ - ninja_get_device — identity, OS, system, last contact/boot, rolePolicy & policyOverride.
35
45
  - ninja_get_device_volumes / _disks / _processors / _network — hardware & capacity.
36
46
  - ninja_get_device_software / _os_patches — inventory & patch state.
37
47
 
48
+ ### Policy assignment
49
+ - ninja_get_device reports rolePolicy (inherited from org/location + device role) and policyOverride (device-specific override, if any — usually "(none — inherits role policy)").
50
+ - ninja_list_policies resolves policy ids/names for reference.
51
+
38
52
  ### Fleet stats & reporting
39
- - ninja_query_device_health — health rollup across all/selected devices.
40
- - ninja_query_volumes — disk capacity/usage fleet-wide.
41
- - ninja_query_operating_systems / _computer_systems / _antivirus_status / _os_patches.
53
+ - ninja_query_device_health — health rollup, ONE ROW PER DEVICE (its footer total is the fleet device count). "Health" is NinjaOne's HEALTHY/NEEDS_ATTENTION/UNHEALTHY/UNKNOWN bucket; "Connectivity" is just online/offline and is independent of Health. Drive alerting from Health plus the alert/patch/threat/vuln counts.
54
+ - ninja_query_volumes — disk capacity/usage fleet-wide (one row per VOLUME, several per device).
55
+ - ninja_query_operating_systems / _computer_systems — one row per device.
56
+ - ninja_query_antivirus_status / _os_patches — one row per AV product / patch per device, so totals are record counts, not device counts. antivirus_status has multipleActiveProducts=true to find devices running 2+ AV products ON.
42
57
 
43
58
  ### Alerts
44
- - ninja_list_alerts — currently triggered conditions (scope by device or org).
59
+ - ninja_list_alerts — currently triggered conditions (scope by device or org; filter by severity/priority/sourceType/since). The footer reports "N of M in scope", so an empty result is distinguishable from "nothing active".
45
60
 
46
61
  ## Pagination
47
- - List tools use cursor pagination: pass the reported after=<id>.
48
- - ninja_query_* tools return a cursor name; pass it back as cursor=<name>.
62
+ - List tools use cursor pagination: pass the reported after=<id>. ninja_list_devices/organizations have no total — page until a short page returns.
63
+ - ninja_query_* tools return a cursor name; pass it back as cursor=<name>. The name is the same on every page — NinjaOne holds the position server-side and each call advances it, so never reuse a cursor to repeat a page. The footer states "rows X–Y of TOTAL".
64
+ - Tool arguments are camelCase (deviceId); snake_case (device_id) is also accepted.
65
+
66
+ ## Output format
67
+ - Every tool takes format="markdown" | "json". Markdown = readable tables for presenting to a person. JSON = the same data, typed (raw numbers/booleans, ISO-8601 UTC timestamps) with totals and cursors as fields (total, hasMore, nextCursor / nextAfter) — choose it when paging through results or computing over them. Omit it to use the server default (NINJAONE_FORMAT).
49
68
 
50
69
  ## Datetime
51
70
  - All NinjaOne timestamps are UTC (ISO or epoch). The server renders them in NINJAONE_DATETIMEFORMAT (default: system local). Present values as-is.
@@ -67,9 +86,17 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
67
86
  };
68
87
  }
69
88
  try {
70
- const args = tool.inputSchema.parse(request.params.arguments ?? {});
71
- const text = await tool.handler(client, args);
72
- return { content: [{ type: 'text', text }] };
89
+ const { format: requested, ...args } = tool.inputSchema.parse(camelCaseKeys(request.params.arguments ?? {}));
90
+ const format = requested ?? config.format;
91
+ const result = await tool.handler(client, args);
92
+ if (typeof result === 'string')
93
+ return { content: [{ type: 'text', text: result }] };
94
+ if (format === 'json') {
95
+ // MCP guidance: structuredContent for clients that read it, plus the serialized JSON
96
+ // as text so clients that only forward text blocks still get the data.
97
+ return { content: [{ type: 'text', text: JSON.stringify(result.data) }], structuredContent: result.data };
98
+ }
99
+ return { content: [{ type: 'text', text: result.markdown }] };
73
100
  }
74
101
  catch (err) {
75
102
  const message = err instanceof Error ? err.message : String(err);
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../../src/tools/alerts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAuC,MAAM,aAAa,CAAC;AAIlF,eAAO,MAAM,UAAU,EAAE,cAAc,EA2EtC,CAAC"}
1
+ {"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../../src/tools/alerts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAuC,MAAM,aAAa,CAAC;AAMlF,eAAO,MAAM,UAAU,EAAE,cAAc,EAuItC,CAAC"}
@@ -1,15 +1,24 @@
1
1
  import { z } from 'zod';
2
- import { table } from '../format.js';
3
- import { fromUtc } from '../datetime.js';
2
+ import { DF_SYNTAX_HELP } from '../client.js';
3
+ import { tableResult } from '../format.js';
4
+ import { fromUtc, toIso } from '../datetime.js';
5
+ const sameCI = (a, b) => (a ?? '').toUpperCase() === b.toUpperCase();
4
6
  export const alertTools = [
5
7
  {
6
8
  name: 'ninja_list_alerts',
7
- description: 'List currently triggered alerts (conditions). Optionally scope to one device, or to one organization / raw device-filter (df).',
9
+ description: 'List currently triggered alerts (conditions). Scope to one device, or to one organization / raw device-filter (df); narrow the result client-side by severity, priority, sourceType or since. The response always states how many alerts were in scope and how many matched (JSON: inScope / matched), so "0 of 0" (nothing active) can be told apart from "0 of 12" (filters excluded everything).',
8
10
  inputSchema: z
9
11
  .object({
10
12
  deviceId: z.number().int().optional().describe('Restrict to a single device (uses /v2/device/{id}/alerts)'),
11
13
  organizationId: z.number().int().optional().describe('Restrict to one organization (df: org = <id>)'),
12
- deviceFilter: z.string().optional().describe('Raw NinjaOne device-filter (df) expression'),
14
+ deviceFilter: z.string().optional().describe(`Raw NinjaOne device-filter (df) expression. ${DF_SYNTAX_HELP}`),
15
+ severity: z
16
+ .string()
17
+ .optional()
18
+ .describe('Case-insensitive severity filter, e.g. CRITICAL, MAJOR, MODERATE, MINOR, NONE'),
19
+ priority: z.string().optional().describe('Case-insensitive priority filter, e.g. HIGH, MEDIUM, LOW, NONE'),
20
+ sourceType: z.string().optional().describe('Case-insensitive alert source type filter (as shown in the Source column)'),
21
+ since: z.string().optional().describe('ISO date/time — only alerts raised at or after this moment'),
13
22
  })
14
23
  .strict(),
15
24
  handler: async (client, args) => {
@@ -24,54 +33,98 @@ export const alertTools = [
24
33
  params['df'] = df;
25
34
  alerts = await client.get('/v2/alerts', params);
26
35
  }
27
- const rows = await Promise.all((alerts ?? []).map(async (a) => [
28
- await client.resolveDeviceLabel(a.deviceId),
29
- a.severity ?? a.priority ?? '',
30
- a.sourceType ?? '',
31
- a.message ?? '',
32
- fromUtc(a.createTime),
33
- ]));
34
- return table('Active Alerts', ['Device', 'Severity', 'Source', 'Message', 'Since'], rows);
36
+ alerts = alerts ?? [];
37
+ const inScope = alerts.length;
38
+ let sinceSec;
39
+ if (args.since) {
40
+ const t = Date.parse(args.since);
41
+ if (Number.isNaN(t))
42
+ throw new Error(`Invalid "since" value "${args.since}" — use an ISO date/time, e.g. 2026-10-01 or 2026-10-01T09:00:00Z.`);
43
+ sinceSec = t / 1000;
44
+ }
45
+ const filtered = alerts.filter((a) => (!args.severity || sameCI(a.severity, args.severity)) &&
46
+ (!args.priority || sameCI(a.priority, args.priority)) &&
47
+ (!args.sourceType || sameCI(a.sourceType, args.sourceType)) &&
48
+ (sinceSec === undefined || (a.createTime !== undefined && a.createTime >= sinceSec)));
49
+ const scope = [
50
+ args.deviceId !== undefined ? `device ${args.deviceId}` : null,
51
+ args.organizationId !== undefined ? `org ${args.organizationId}` : null,
52
+ args.deviceFilter ? `df "${args.deviceFilter}"` : null,
53
+ ].filter(Boolean);
54
+ const filters = [
55
+ args.severity ? `severity=${args.severity}` : null,
56
+ args.priority ? `priority=${args.priority}` : null,
57
+ args.sourceType ? `sourceType=${args.sourceType}` : null,
58
+ args.since ? `since=${args.since}` : null,
59
+ ].filter(Boolean);
60
+ const scopeText = scope.length ? scope.join(', ') : 'whole tenant';
61
+ const summary = `_${filtered.length} of ${inScope} active alerts in scope (${scopeText})` +
62
+ `${filters.length ? ` match ${filters.join(', ')}` : ''}._`;
63
+ const items = await Promise.all(filtered.map(async (a) => ({ ...a, device: await client.resolveDeviceLabel(a.deviceId) })));
64
+ const cols = [
65
+ { header: 'Device ID', key: 'deviceId', value: (a) => a.deviceId ?? null, jsonOnly: true },
66
+ { header: 'Device', key: 'device', value: (a) => a.device },
67
+ { header: 'Severity', key: 'severity', value: (a) => a.severity ?? null },
68
+ { header: 'Priority', key: 'priority', value: (a) => a.priority ?? null },
69
+ { header: 'Source', key: 'sourceType', value: (a) => a.sourceType ?? null },
70
+ { header: 'Message', key: 'message', value: (a) => a.message ?? null },
71
+ { header: 'Since', key: 'createTime', value: (a) => toIso(a.createTime), display: (a) => fromUtc(a.createTime) },
72
+ { header: 'UID', key: 'uid', value: (a) => a.uid ?? null, jsonOnly: true },
73
+ ];
74
+ return tableResult('Active Alerts', cols, items, {
75
+ footer: summary,
76
+ meta: { inScope, matched: filtered.length, scope: scopeText, filters: Object.fromEntries(filters.map((f) => f.split('='))) },
77
+ });
35
78
  },
36
79
  },
37
80
  {
38
81
  name: 'ninja_list_activities',
39
- description: 'Tenant-wide activity log. Optionally scope to one organization / device-filter, cap with pageSize, and filter by activity class or type.',
82
+ description: 'Tenant-wide activity log, newest first. Optionally scope to one organization / device-filter and filter by activity class. Default page size is NINJAONE_PAGESIZE (100), minimum 10, maximum 1000. NinjaOne returns no total for activities, so the response reports entries shown and the cursor for older entries (JSON: hasMore / nextAfter).',
40
83
  inputSchema: z
41
84
  .object({
42
85
  organizationId: z.number().int().optional().describe('Restrict to one organization (df: org = <id>)'),
43
- deviceFilter: z.string().optional().describe('Raw NinjaOne device-filter (df) expression'),
86
+ deviceFilter: z.string().optional().describe(`Raw NinjaOne device-filter (df) expression. ${DF_SYNTAX_HELP}`),
44
87
  activityClass: z
45
88
  .string()
46
89
  .optional()
47
90
  .describe('Activity class filter, e.g. SYSTEM, DEVICE, USER, ALL'),
48
- pageSize: z.number().int().min(1).max(1000).optional().describe('Max entries to return'),
49
- after: z.number().int().min(0).optional().describe('Cursor: activityId from a previous page (older <)'),
91
+ pageSize: z.number().int().min(1).max(1000).optional().describe('Max entries to return (10–1000, default NINJAONE_PAGESIZE = 100; NinjaOne raises smaller values to 10)'),
92
+ after: z.number().int().min(0).optional().describe('Cursor: activityId from a previous page (returns older entries)'),
50
93
  })
51
94
  .strict(),
52
95
  handler: async (client, args) => {
53
- const params = {};
96
+ const pageSize = Math.min(args.pageSize ?? client.getDefaultPageSize(), 1000);
97
+ const params = { pageSize };
54
98
  const df = client.buildDeviceFilter({ organizationId: args.organizationId, raw: args.deviceFilter });
55
99
  if (df)
56
100
  params['df'] = df;
57
101
  if (args.activityClass)
58
102
  params['class'] = args.activityClass;
59
- if (args.pageSize)
60
- params['pageSize'] = args.pageSize;
61
103
  if (args.after !== undefined)
62
104
  params['olderThan'] = args.after;
63
105
  const resp = await client.get('/v2/activities', params);
64
106
  const activities = Array.isArray(resp) ? resp : resp.activities ?? [];
65
- const rows = await Promise.all(activities.map(async (a) => [
66
- fromUtc(a.activityTime),
67
- await client.resolveDeviceLabel(a.deviceId),
68
- a.activityType ?? a.type ?? '',
69
- a.status ?? a.statusCode ?? '',
70
- a.message ?? '',
71
- ]));
72
- const out = table('Activities', ['Time', 'Device', 'Type', 'Status', 'Message'], rows);
73
- const lastId = !Array.isArray(resp) ? resp.lastActivityId : activities[activities.length - 1]?.id;
74
- return lastId ? `${out}\n\n_Page older entries with after=${lastId}._` : out;
107
+ const items = await Promise.all(activities.map(async (a) => ({ ...a, device: await client.resolveDeviceLabel(a.deviceId) })));
108
+ const cols = [
109
+ { header: 'ID', key: 'id', value: (a) => a.id ?? null, jsonOnly: true },
110
+ { header: 'Time', key: 'time', value: (a) => toIso(a.activityTime), display: (a) => fromUtc(a.activityTime) },
111
+ { header: 'Device ID', key: 'deviceId', value: (a) => a.deviceId ?? null, jsonOnly: true },
112
+ { header: 'Device', key: 'device', value: (a) => a.device },
113
+ { header: 'Type', key: 'type', value: (a) => a.activityType ?? a.type ?? null },
114
+ { header: 'Status', key: 'status', value: (a) => a.status ?? a.statusCode ?? null },
115
+ { header: 'Message', key: 'message', value: (a) => a.message ?? null },
116
+ ];
117
+ // NinjaOne's lastActivityId is the NEWEST id seen, so the older-page cursor is the id
118
+ // of the last (oldest) row returned.
119
+ const lastId = activities[activities.length - 1]?.id;
120
+ const hasMore = !!lastId && activities.length >= pageSize;
121
+ const footer = hasMore
122
+ ? `_${activities.length} entries (page size ${pageSize}; no total available). Older entries: after=${lastId}._`
123
+ : `_${activities.length} entries (page size ${pageSize}). No older entries._`;
124
+ return tableResult('Activities', cols, items, {
125
+ footer,
126
+ meta: { pageSize, hasMore, nextAfter: hasMore ? lastId : null },
127
+ });
75
128
  },
76
129
  },
77
130
  ];
@@ -1 +1 @@
1
- {"version":3,"file":"alerts.js","sourceRoot":"","sources":["../../src/tools/alerts.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"alerts.js","sourceRoot":"","sources":["../../src/tools/alerts.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/tools/auth.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAgB,MAAM,aAAa,CAAC;AAE3D,eAAO,MAAM,SAAS,EAAE,cAAc,EAsBrC,CAAC"}
1
+ {"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/tools/auth.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAgB,MAAM,aAAa,CAAC;AAE3D,eAAO,MAAM,SAAS,EAAE,cAAc,EAiCrC,CAAC"}
@@ -11,13 +11,24 @@ export const authTools = [
11
11
  ? '✏️ read-write'
12
12
  : '🔒 read-only (set NINJAONE_READWRITE=true to enable write operations)';
13
13
  const scope = client.getGrantedScope() ?? '(unknown)';
14
- return [
14
+ const reachable = orgs?.length ?? 0;
15
+ const markdown = [
15
16
  'NinjaOne connection successful.',
16
17
  `- **Base URL**: ${client.getBaseUrl()}`,
17
18
  `- **Granted scope**: ${scope}`,
18
19
  `- **Mode**: ${mode}`,
19
- `- **Reachable**: organizations endpoint returned ${orgs?.length ?? 0} record(s) (probe with pageSize=1).`,
20
+ `- **Reachable**: organizations endpoint returned ${reachable} record(s) (probe with pageSize=1).`,
20
21
  ].join('\n');
22
+ return {
23
+ markdown,
24
+ data: {
25
+ connected: true,
26
+ baseUrl: client.getBaseUrl(),
27
+ grantedScope: client.getGrantedScope(),
28
+ readWrite: client.isReadWrite(),
29
+ organizationsProbeCount: reachable,
30
+ },
31
+ };
21
32
  },
22
33
  },
23
34
  ];
@@ -1 +1 @@
1
- {"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/tools/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,SAAS,GAAqB;IACzC;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EACT,gJAAgJ;QAClJ,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;QAClC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACxB,0DAA0D;YAC1D,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAiB,mBAAmB,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;YACpF,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE;gBAC/B,CAAC,CAAC,eAAe;gBACjB,CAAC,CAAC,uEAAuE,CAAC;YAC5E,MAAM,KAAK,GAAG,MAAM,CAAC,eAAe,EAAE,IAAI,WAAW,CAAC;YACtD,OAAO;gBACL,iCAAiC;gBACjC,mBAAmB,MAAM,CAAC,UAAU,EAAE,EAAE;gBACxC,wBAAwB,KAAK,EAAE;gBAC/B,eAAe,IAAI,EAAE;gBACrB,oDAAoD,IAAI,EAAE,MAAM,IAAI,CAAC,qCAAqC;aAC3G,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;KACF;CACF,CAAC"}
1
+ {"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/tools/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,SAAS,GAAqB;IACzC;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EACT,gJAAgJ;QAClJ,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;QAClC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACxB,0DAA0D;YAC1D,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAiB,mBAAmB,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;YACpF,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE;gBAC/B,CAAC,CAAC,eAAe;gBACjB,CAAC,CAAC,uEAAuE,CAAC;YAC5E,MAAM,KAAK,GAAG,MAAM,CAAC,eAAe,EAAE,IAAI,WAAW,CAAC;YACtD,MAAM,SAAS,GAAG,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC;YACpC,MAAM,QAAQ,GAAG;gBACf,iCAAiC;gBACjC,mBAAmB,MAAM,CAAC,UAAU,EAAE,EAAE;gBACxC,wBAAwB,KAAK,EAAE;gBAC/B,eAAe,IAAI,EAAE;gBACrB,oDAAoD,SAAS,qCAAqC;aACnG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,OAAO;gBACL,QAAQ;gBACR,IAAI,EAAE;oBACJ,SAAS,EAAE,IAAI;oBACf,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE;oBAC5B,YAAY,EAAE,MAAM,CAAC,eAAe,EAAE;oBACtC,SAAS,EAAE,MAAM,CAAC,WAAW,EAAE;oBAC/B,uBAAuB,EAAE,SAAS;iBACnC;aACF,CAAC;QACJ,CAAC;KACF;CACF,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"devices.d.ts","sourceRoot":"","sources":["../../src/tools/devices.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EAWf,MAAM,aAAa,CAAC;AAwBrB,eAAO,MAAM,WAAW,EAAE,cAAc,EAkOvC,CAAC"}
1
+ {"version":3,"file":"devices.d.ts","sourceRoot":"","sources":["../../src/tools/devices.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EAYf,MAAM,aAAa,CAAC;AAmCrB,eAAO,MAAM,WAAW,EAAE,cAAc,EAgVvC,CAAC"}