fix(resources): throw descriptive error when JSON:API data is empty or absent

[asachs01]

Defect

All 13 single-resource get* methods across src/resources/ followed this pattern:

const data = Array.isArray(response.data) ? response.data[0] : response.data;
return { id: data.id, ...data.attributes } as any;

When the API returns { data: [] } (data[0] is undefined) or a body with no data key at all, the next line crashes with an anonymous, undiagnosable TypeError: Cannot read properties of undefined (reading 'id') instead of a clear error. The comment in http.ts (lines 96-100) already documented this exact failure mode being triggered by content-type fallbacks returning {}.

Part of the fleet sweep for unchecked response-envelope access, following wyre-technology/halopsa-mcp#76 / wyre-technology/node-halopsa#59.

Fix

Added a shared unwrapJsonApiData<T>(response, context) helper to src/json-api-mapper.ts (mirroring node-halopsa's centralized unwrapSingle) that throws a descriptive AuvikError — Auvik returned no <entity> for <id> (response data was empty or missing) — when the entity is missing, and routed all 13 sites through it:

• alerts.ts — getHistory
• billing.ts — getUsageDevice
• inventory-configuration.ts — get
• inventory-device.ts — getInfo, getDetails, getWarranty, getLifecycle
• inventory-entity.ts — getNote, getAudit
• inventory-interface.ts — getInfo
• inventory-network.ts — getInfo, getDetails
• tenants.ts — get

No behavior change for valid { data: {...} } and { data: [{...}] } shapes.

Test plan

TDD: tests were written first and confirmed failing on the unguarded code (26 failures, all TypeError: Cannot read properties of undefined), then the fix turned them green.

• New table-driven suite tests/resources/unwrap-empty-data.test.ts covering all 13 methods x 4 shapes (52 tests): { data: [] } throws descriptive AuvikError, {} throws descriptive AuvikError, { data: {...} } resolves, { data: [{...}] } resolves.
• Baseline before: 9 files / 45 tests passing. After: 10 files / 97 tests passing (45 + 52).
• npm run lint (tsc --noEmit) clean, npm run build (tsup incl. DTS) green.

---

^{Need help on this PR? Tag @codesmith-bot with what you need. Autofix is enabled.}

[github-actions]

🎉 This PR is included in version 1.3.1 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀