netanalyzer/tests/atlasClient.test.js
Joseph McQueen b3c37bd7df feat: st command suite, Webex phone + Atlas AV integrations, dockerized remote agent
Rebrand NetAnalyzer -> StoreHealthAnalyzer and consolidate the store
reporting surface into a single `st [number]` command with focused
sub-modes.

Commands
- st [number]                - general info (SIW + brands + Meraki net link)
- st [number] network        - switches, APs, store server
- st [number] pos            - registers, payment terminals, customer display
- st [number] ios            - MDM-tracked iOS hardware
- st [number] phone          - wired 78xx + DECT basestations/handsets with
                               registration state, extensions and main DID
- st [number] av             - Atlas AMPs + MDM-tracked Apple TVs, video
                               walls, music players, LED displays
- Removed `analyze` in favor of the unified `st` surface

Integrations
- integrations/webex: Service App OAuth with rotating refresh tokens,
  seed + cleanup scripts, tokens/ storage (git-ignored)
- integrations/atlas: Xyte client + cached device discovery keyed on
  zero-padded 6-digit store numbers, cold-cache failure -> unavailable
  banner instead of a misleading empty result
- services/webexPhone, services/webexService, services/avService: shape
  raw upstream data into the report layer's contract
- utils/merakiMatcher: FQDN hostname extraction so payment terminals
  match Meraki descriptions; case-insensitive lookup
- utils/chunkReport: split long markdown replies at 7000-char boundaries

Reliability / ops
- server.js: awaited framework.stop() + 8s hard-kill timer so nodemon /
  Docker restarts don't leak WDM device registrations ("excessive device
  registrations")
- nodemon.json: SIGINT so the graceful path always runs
- scripts/cleanupWebexDevices.js: one-shot WDM cleanup utility
- Group-space routing: hears() regexes tolerate the leading @BotName
  prefix Webex prepends to mentions
- Replaced HTML-unsafe <number> placeholders with [number] in all help
  strings

Remote agent containerization
- docker/remote-agent/: multi-stage node:22-alpine image, non-root user,
  tini for signal handling, minimal deps (ws/axios/dotenv)
- docker/remote-agent/package.sh: docker buildx build defaulting to
  linux/amd64 (with override), saves image + assembles deploy/ + writes
  SHA256 + zips for offline transfer
- docker/remote-agent/deploy/: runtime docker-compose.yml, install.sh
  with platform sanity check, remote-host README
- .dockerignore + .gitignore updates for build artifacts and dist bundles
- npm run agent:package convenience script

Cleanup
- Dropped storeHealth.js / HealthReport.js and their tests/mocks in favor
  of the shared storeDetail pipeline
- Store model handles null SIW records gracefully; toSummary always
  ends with a newline so the Meraki link sits on its own line

Tests
- 144 tests across 14 suites passing; new coverage for atlasClient,
  atlasDevices, avService, avCategory classification, webexPhone,
  webexServiceAppAuth, storeDetail integration, siw, chunkReport and
  the updated meraki matcher

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-06 09:54:41 -04:00

76 lines
2.6 KiB
JavaScript

jest.mock('../config', () => ({ logLevel: 'error' }));
jest.mock('axios', () => {
const get = jest.fn();
const create = jest.fn(() => ({ get }));
return { __esModule: true, default: { create }, create, __get: get };
});
const axios = require('axios');
const atlasClientModule = require('../integrations/atlas/atlasClient');
const { atlasGet, AtlasUnavailableError, resetClientForTests } = atlasClientModule;
describe('atlasClient', () => {
const originalKey = process.env.ATLAS_AUTH_KEY;
beforeEach(() => {
jest.clearAllMocks();
resetClientForTests();
});
afterAll(() => {
if (originalKey === undefined) delete process.env.ATLAS_AUTH_KEY;
else process.env.ATLAS_AUTH_KEY = originalKey;
});
it('throws AtlasUnavailableError when ATLAS_AUTH_KEY is missing', async () => {
delete process.env.ATLAS_AUTH_KEY;
await expect(atlasGet('organization/devices')).rejects.toBeInstanceOf(AtlasUnavailableError);
});
it('creates an axios instance with the env-provided Authorization header (no Bearer prefix)', async () => {
process.env.ATLAS_AUTH_KEY = 'secret-token-123';
axios.__get.mockResolvedValue({ status: 200, data: { ok: true } });
await atlasGet('organization/devices', { page: 1 });
expect(axios.create).toHaveBeenCalledTimes(1);
const cfg = axios.create.mock.calls[0][0];
expect(cfg.headers.Authorization).toBe('secret-token-123');
expect(cfg.baseURL).toBe('https://hub.xyte.io/core/v1');
});
it('honors ATLAS_BASE_URL override', async () => {
process.env.ATLAS_AUTH_KEY = 'k';
process.env.ATLAS_BASE_URL = 'https://atlas.test/api/v2';
axios.__get.mockResolvedValue({ status: 200, data: {} });
await atlasGet('organization/devices');
expect(axios.create.mock.calls[0][0].baseURL).toBe('https://atlas.test/api/v2');
delete process.env.ATLAS_BASE_URL;
});
it('returns response.data on success and strips leading slash from path', async () => {
process.env.ATLAS_AUTH_KEY = 'k';
axios.__get.mockResolvedValue({ status: 200, data: { items: [1, 2] } });
const data = await atlasGet('/organization/devices', { page: 2 });
expect(data).toEqual({ items: [1, 2] });
expect(axios.__get).toHaveBeenCalledWith(
'/organization/devices',
expect.objectContaining({ params: { page: 2 } })
);
});
it('throws with status detail on 4xx response', async () => {
process.env.ATLAS_AUTH_KEY = 'k';
axios.__get.mockResolvedValue({
status: 403,
statusText: 'Forbidden',
data: { message: 'invalid key' },
});
await expect(atlasGet('organization/devices')).rejects.toThrow(/invalid key/);
});
});