rhombus-node-mcp/dist/api/onguard-tool-api.js

MCP server for Rhombus API

import { postApi } from "../network/network.js";
import { ActivityEnum } from "../types/schema.js";
import { formatTimestamp } from "../util.js";
/**
 * Calls the unified integration access-event search (POST /eventSearchV2/searchIntegrationAccessEvents),
 * scoped to OnGuard via `activityTypes`, and maps the
 * raw seekpoints to an agent-friendly shape. Typed against the generated public OpenAPI schema.
 */
/**
 * Honeywell OnGuard (Lenel) activity enum values. Passing these as `activityTypes` to the generalized
 * integration access-event search scopes results to OnGuard events only.
 */
export const ONGUARD_ACTIVITY_TYPES = [
    ActivityEnum.ONGUARD_BADGE_AUTHORIZED,
    ActivityEnum.ONGUARD_BADGE_ANOMALY,
    ActivityEnum.ONGUARD_NO_ENTRY_MADE,
];
export async function searchOnGuardEvents(args, timeZone, requestModifiers, sessionId) {
    // Unified third-party integration access-event search, scoped to OnGuard via `activityTypes`. Typed
    // against the generated public OpenAPI schema (Eventsearch_SearchIntegrationAccessEventsWSRequest/Response).
    const body = {
        deviceUuids: args.deviceUuids,
        locationUuids: args.locationUuids,
        afterMs: args.afterMs,
        beforeMs: args.beforeMs,
        cardholderQuery: args.cardholderQuery,
        badgeStatus: args.badgeStatus,
        badgeType: args.badgeType,
        area: args.area,
        anomalyOnly: args.anomalyOnly,
        entryMade: args.entryMade,
        limit: args.limit ?? 200,
        activityTypes: [...ONGUARD_ACTIVITY_TYPES],
    };
    const res = await postApi({
        route: "/eventSearchV2/searchIntegrationAccessEvents",
        body,
        modifiers: requestModifiers,
        sessionId,
    });
    if (res.error) {
        throw new Error(res.status ?? res.errorMsg ?? "OnGuard event search failed");
    }
    const events = (res.events ?? []).map((e) => ({
        timestampMs: e.timestampMs ?? undefined,
        datetime: e.timestampMs != null ? formatTimestamp(e.timestampMs, timeZone) : undefined,
        deviceUuid: e.deviceUuid ?? undefined,
        label: e.customDisplayName ?? e.objectType ?? undefined,
        // Dedicated-event-types put the cardholder in its own `cardholderName` field (customDescription
        // is null on ONGUARD_* docs); keep customDescription as a legacy fallback. The generated schema
        // predates the field, so read it through a cast until `assets/openapi.json` is regenerated.
        cardholderName: e.cardholderName ?? e.customDescription ?? undefined,
        badgeStatus: e.badgeStatus ?? undefined,
        badgeType: e.badgeType ?? undefined,
        areaEntering: e.areaEntering ?? undefined,
        areaExiting: e.areaExiting ?? undefined,
        entryMade: e.entryMade ?? undefined,
        isAnomaly: e.alert ?? undefined,
    }));
    return { events };
}