Multi-integration Webex chat/HTTP bot that unifies phone, AV, and network status for retail store support. Consolidates data from Webex Calling, Meraki, Workspace ONE (MDM), Atlas AMP, RED digital signage, and OptiSigns into rich per-store status commands. Key surfaces: - /phonestatus, /avstatus — per-store phone & AV device reports with clickable Meraki deep-links and per-port detail. - /webexhost — check/assign Webex Meetings host licenses via the Service App; adaptive-card confirmation flow, HTTP-API-gated. - /offboarduser — full Webex Admin offboarding (auth revoke, device wipe, license removal); adaptive-card confirmation. - /jirapoll — on-demand trigger for the hourly Jira poller. - /bulkavstatuscsv — bulk store CSV export with concurrency limits. Automation: - Hourly Jira poller (node-cron) with an X.AI (Grok) ticket classifier that categorizes unassigned tickets as phone/av/skip, extracts store numbers from free-text, and enriches Jira with the same detailed markdown the chat commands emit (converted to Jira ADF, preserves bold + Meraki links). Idempotent via a `bot-enriched` Jira label. Architecture: - Node.js 20+, ESM, Express 5, webex-node-bot-framework. - Layered integrations (integrations/*), services (services/*), commands (commands/*), utils (utils/*). - Shared markdown renderers (services/renderers/*) feed both chat handlers and the Jira poller so the two surfaces stay in sync. - Hand-rolled markdown-to-ADF converter (utils/markdownToAdf.js) — no new npm dependency. - Node built-in test runner (`node --test tests/*.test.js`), 30 tests covering the converter, renderers, and poller ADF assembly. Docker + docker-compose deployment. Config via .env (see .env.example for the full option surface).
81 lines
No EOL
2.6 KiB
JavaScript
81 lines
No EOL
2.6 KiB
JavaScript
// src/integrations/meraki/networks.js
|
|
|
|
import { fetchAllPages } from './client.js';
|
|
import { logger } from '../../utils/logger.js';
|
|
|
|
// In-memory cache
|
|
let cachedNetworks = [];
|
|
let lastCacheTime = 0;
|
|
const CACHE_TTL_MS = 4 * 60 * 60 * 1000; // 4 hours
|
|
|
|
/**
|
|
* Refresh the full list of networks (called by cron or on cache miss)
|
|
*/
|
|
export async function refreshMerakiNetworksCache() {
|
|
const start = Date.now();
|
|
logger('meraki:networks', 'Refreshing cache', 'debug');
|
|
|
|
try {
|
|
const url = `/organizations/${process.env.MERAKI_ORG_ID}/networks?perPage=5000`;
|
|
cachedNetworks = await fetchAllPages(url);
|
|
lastCacheTime = Date.now();
|
|
|
|
logger('meraki:networks', `Cached ${cachedNetworks.length} networks (${Date.now() - start} ms)`, 'debug');
|
|
} catch (err) {
|
|
logger('meraki:networks', `Cache refresh failed: ${err.message}`, 'warn');
|
|
// Keep old cache if it exists
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get cached networks (auto-refresh if stale or empty)
|
|
*/
|
|
export async function getMerakiNetworks(forceRefresh = false) {
|
|
const now = Date.now();
|
|
if (forceRefresh || !cachedNetworks.length || (now - lastCacheTime > CACHE_TTL_MS)) {
|
|
await refreshMerakiNetworksCache();
|
|
}
|
|
return cachedNetworks;
|
|
}
|
|
|
|
/**
|
|
* Find Meraki network by store number — returns the FULL network object (contains .url, .name, .id, etc.)
|
|
* @param {string|number} storeNum
|
|
* @returns {object|null} full network object or null
|
|
*/
|
|
export async function findMerakiNetwork(storeNum) { // ← renamed for clarity
|
|
if (!storeNum) return null;
|
|
|
|
const raw = String(storeNum).trim();
|
|
let searchTerm = raw.match(/\d+/)[0];
|
|
searchTerm = searchTerm.padStart(5, '0').slice(-5);
|
|
|
|
const networks = await getMerakiNetworks();
|
|
|
|
logger('meraki:find', `Searching store "${raw}" → using 5-digit term "${searchTerm}"`, 'debug');
|
|
|
|
let bestMatch = null;
|
|
let bestScore = -1;
|
|
|
|
for (const net of networks) {
|
|
const name = (net.name || '').toLowerCase();
|
|
const term = searchTerm.toLowerCase();
|
|
|
|
if (name.includes(term)) {
|
|
const score = (name.includes(` ${term}`) || name.includes(`-${term}`) || name.includes(term)) ? 100 : 50;
|
|
if (score > bestScore) {
|
|
bestScore = score;
|
|
bestMatch = net; // ← full object
|
|
}
|
|
}
|
|
}
|
|
|
|
if (bestMatch) {
|
|
logger('meraki:find', `✅ Best match: ${bestMatch.name} (ID: ${bestMatch.id})`, 'debug');
|
|
logger('meraki:networks', `Best match for store ${storeNum}: ${bestMatch?.name || 'none'}`, 'debug');
|
|
return bestMatch; // ← return full network
|
|
}
|
|
|
|
logger('meraki:find', `❌ No match found for 5-digit term "${searchTerm}"`, 'warn');
|
|
return null;
|
|
} |