@patroltech/agent-capabilities 0.0.0-stage → 0.2.0

package/dist/gateway/sdk/patrollers.js

@@ -0,0 +1,132 @@
+import { createPatroller as sdkCreatePatroller, getCreatePatrollerUrl, getGetPatrollerByIdentifierUrl, getGetPatrollerRankingUrl, getGetPatrollerStatsUrl, getListPatrollersUrl, getPatrollerByIdentifier as sdkGetPatrollerByIdentifier, getPatrollerRanking as sdkGetPatrollerRanking, getPatrollerStats as sdkGetPatrollerStats, getUpdatePatrollerUrl, listPatrollers as sdkListPatrollers, updatePatroller as sdkUpdatePatroller, } from '@patroltech/sdk-api';
+import { resolveByName } from '../../domain/resolve-by-name.js';
+import { isNotFound } from './errors.js';
+import { isTruncated } from './list.js';
+// Límite de vigilantes pedidos al listar o resolver por nombre.
+const PATROLLER_LIST_LIMIT = 100;
+// Cap de opciones devueltas cuando no se reconoce el nombre de un vigilante.
+const MAX_PATROLLER_OPTIONS = 15;
+// Cap de entradas del ranking de vigilantes devueltas.
+const MAX_RANKING_ENTRIES = 15;
+// Cap de checkpoints más escaneados devueltos.
+const MAX_TOP_CHECKPOINTS = 10;
+function toCreatedPatroller(p) {
+    return { id: p.id, name: p.name, identifier: p.identifier, organizationId: p.organizationId };
+}
+function fetchPatrollers(t, accountId, token) {
+    const params = { organizationId: accountId, limit: PATROLLER_LIST_LIMIT };
+    return t.data(token, getListPatrollersUrl(params), (init) => sdkListPatrollers(params, init));
+}
+export async function getPatrollerActivity(t, accountId, token) {
+    const body = await fetchPatrollers(t, accountId, token);
+    const items = body.results.map((p) => ({
+        name: p.name,
+        lastScanAt: p.lastScanDate ?? null,
+        status: p.status,
+    }));
+    return { items, total: body.count, truncado: isTruncated(body, items.length) };
+}
+export async function listPatrollers(t, accountId, token) {
+    const body = await fetchPatrollers(t, accountId, token);
+    const items = body.results.map((p) => ({
+        id: p.id,
+        name: p.name,
+        identifier: p.identifier,
+        lastScanAt: p.lastScanDate ?? null,
+    }));
+    return { items, total: body.count, truncado: isTruncated(body, items.length) };
+}
+export async function getPatrollerStats(t, accountId, token, patrollerName) {
+    const listBody = await fetchPatrollers(t, accountId, token);
+    const resolution = resolveByName(patrollerName, listBody.results, (p) => p.name);
+    if (resolution.kind === 'ambiguous') {
+        // Dos "Juan" no se resuelven cogiendo el primero: se pregunta.
+        return {
+            found: false,
+            ambigua: true,
+            opciones: resolution.matches.slice(0, MAX_PATROLLER_OPTIONS).map((p) => p.name),
+        };
+    }
+    if (resolution.kind === 'none') {
+        return {
+            found: false,
+            opciones: listBody.results.slice(0, MAX_PATROLLER_OPTIONS).map((p) => p.name),
+        };
+    }
+    const match = resolution.item;
+    const id = match.id;
+    const stats = await t.data(token, getGetPatrollerStatsUrl(id), (init) => sdkGetPatrollerStats(id, undefined, init));
+    return {
+        found: true,
+        name: match.name,
+        totalScans: stats.totalScans,
+        roundsCompleted: stats.roundsCompleted,
+        totalRounds: stats.totalRounds,
+        completionRate: stats.completionRate,
+        avgTimeBetweenScans: stats.avgTimeBetweenScans,
+        ...(stats.incidentsReported !== undefined
+            ? { incidentsReported: stats.incidentsReported }
+            : {}),
+        ...(stats.incidentsOpen !== undefined ? { incidentsOpen: stats.incidentsOpen } : {}),
+        ...(stats.retentionCutoff !== undefined ? { retentionCutoff: stats.retentionCutoff } : {}),
+    };
+}
+/**
+ * Ranking de vigilantes de la organización (ya viene ordenado de mejor a peor por
+ * el backend), con el resumen del equipo y los checkpoints más escaneados.
+ */
+export async function getPatrollerRanking(t, accountId, token, opts) {
+    const params = {
+        organizationId: accountId,
+        ...(opts?.dateFrom ? { from: opts.dateFrom } : {}),
+        ...(opts?.dateTo ? { to: opts.dateTo } : {}),
+    };
+    const body = await t.data(token, getGetPatrollerRankingUrl(params), (init) => sdkGetPatrollerRanking(params, init));
+    const truncado = body.ranking.length > MAX_RANKING_ENTRIES || body.topCheckpoints.length > MAX_TOP_CHECKPOINTS;
+    return {
+        truncado,
+        summary: body.summary,
+        ranking: body.ranking.slice(0, MAX_RANKING_ENTRIES).map((r) => ({
+            patrollerName: r.patrollerName,
+            totalScans: r.totalScans,
+            roundsCompleted: r.roundsCompleted,
+            completionRate: r.completionRate,
+            avgTimeBetweenScans: r.avgTimeBetweenScans,
+        })),
+        topCheckpoints: body.topCheckpoints.slice(0, MAX_TOP_CHECKPOINTS),
+        ...(body.retentionCutoff !== undefined ? { retentionCutoff: body.retentionCutoff } : {}),
+    };
+}
+export async function createPatroller(t, input, token) {
+    const body = {
+        name: input.name,
+        organizationId: input.organizationId,
+        identifier: input.identifier,
+        ...(input.phone ? { phone: input.phone } : {}),
+    };
+    const created = await t.data(token, getCreatePatrollerUrl(), (init) => sdkCreatePatroller(body, init));
+    return toCreatedPatroller(created);
+}
+export async function getPatrollerByIdentifier(t, identifier, token) {
+    const id = identifier;
+    try {
+        const p = await t.data(token, getGetPatrollerByIdentifierUrl(id), (init) => sdkGetPatrollerByIdentifier(id, init));
+        return toCreatedPatroller(p);
+    }
+    catch (err) {
+        if (isNotFound(err))
+            return null;
+        throw err;
+    }
+}
+export async function updatePatroller(t, input, token) {
+    // Solo los campos que cambian: el backend ignora los ausentes (no los borra).
+    const id = input.id;
+    const body = {
+        ...(input.name ? { name: input.name } : {}),
+        ...(input.phone ? { phone: input.phone } : {}),
+    };
+    const updated = await t.data(token, getUpdatePatrollerUrl(id), (init) => sdkUpdatePatroller(id, body, init));
+    return toCreatedPatroller(updated);
+}
+//# sourceMappingURL=patrollers.js.map

package/dist/gateway/sdk/patrollers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patrollers.js","sourceRoot":"","sources":["../../../src/gateway/sdk/patrollers.ts"],"names":[],"mappings":"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"}

package/dist/gateway/sdk/rounds.d.ts

@@ -0,0 +1,15 @@
+import type { ListaTruncable, RoundCheckpointsResult, RoundDetail, RoundRef, RoundsStatus, RouteRoundsSummary, SupportSummary } from '../types/index.js';
+import type { SdkTransport } from './transport.js';
+export declare function getSupportSummary(t: SdkTransport, accountId: string, token: string, windowDays?: number): Promise<SupportSummary>;
+export declare function getRoundsStatus(t: SdkTransport, accountId: string, token: string): Promise<RoundsStatus>;
+export declare function getRoundsDetail(t: SdkTransport, accountId: string, token: string): Promise<ListaTruncable<RouteRoundsSummary>>;
+export declare function getRoundCheckpoints(t: SdkTransport, accountId: string, token: string, routeName?: string): Promise<RoundCheckpointsResult>;
+export declare function getRoundDetail(t: SdkTransport, routeId: string, roundId: string, token: string): Promise<RoundDetail>;
+export declare function getRouteRounds(t: SdkTransport, routeId: string, token: string, { page, limit }: {
+    page: number;
+    limit: number;
+}): Promise<{
+    items: RoundRef[];
+    totalPages: number;
+}>;
+//# sourceMappingURL=rounds.d.ts.map

package/dist/gateway/sdk/rounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rounds.d.ts","sourceRoot":"","sources":["../../../src/gateway/sdk/rounds.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,cAAc,EACd,sBAAsB,EACtB,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACf,MAAM,mBAAmB,CAAC;AAG3B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AA2CnD,wBAAsB,iBAAiB,CACrC,CAAC,EAAE,YAAY,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,UAAU,GAAE,MAA4B,GACvC,OAAO,CAAC,cAAc,CAAC,CAMzB;AAED,wBAAsB,eAAe,CACnC,CAAC,EAAE,YAAY,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,CAAC,CAQvB;AAED,wBAAsB,eAAe,CACnC,CAAC,EAAE,YAAY,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC,CAgC7C;AAqCD,wBAAsB,mBAAmB,CACvC,CAAC,EAAE,YAAY,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,sBAAsB,CAAC,CAgBjC;AAED,wBAAsB,cAAc,CAClC,CAAC,EAAE,YAAY,EACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,CAAC,CAgBtB;AAED,wBAAsB,cAAc,CAClC,CAAC,EAAE,YAAY,EACf,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/C,OAAO,CAAC;IAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAcpD"}

package/dist/gateway/sdk/rounds.js

@@ -0,0 +1,142 @@
+import { getOrganizationSupportSummary, getGetOrganizationSupportSummaryUrl, getGetRouteRoundCheckpointsUrl, getGetRouteRoundsUrl, getRouteRoundCheckpoints, getRouteRounds as sdkGetRouteRounds, } from '@patroltech/sdk-api';
+import { resolveByName } from '../../domain/resolve-by-name.js';
+import { isTruncated } from './list.js';
+import { fetchRoutes, ROUTE_LIST_LIMIT } from './routes.js';
+const DEFAULT_WINDOW_DAYS = 7;
+// Rutas pedidas al backend al componer el detalle de rondas.
+const ROUTES_DETAIL_REQUEST_LIMIT = 20;
+// Cap de rutas para las que se piden rondas: evita disparar demasiadas peticiones
+// en paralelo al backend cuando la organización tiene muchas rutas.
+const MAX_ROUTES_FOR_ROUNDS_DETAIL = 8;
+// Cap de opciones devueltas cuando no se reconoce el nombre de una ruta.
+const MAX_ROUTE_OPTIONS = 15;
+async function fetchRouteRounds(t, routeId, token, params) {
+    const id = routeId;
+    const page = await t.data(token, getGetRouteRoundsUrl(id, params), (init) => sdkGetRouteRounds(id, params, init));
+    // `results` llega sin tipo en el SDK (ver `RouteRoundItem`).
+    return { ...page, results: page.results };
+}
+export async function getSupportSummary(t, accountId, token, windowDays = DEFAULT_WINDOW_DAYS) {
+    const id = accountId;
+    const params = { windowDays: windowDays || DEFAULT_WINDOW_DAYS };
+    return t.data(token, getGetOrganizationSupportSummaryUrl(id, params), (init) => getOrganizationSupportSummary(id, params, init));
+}
+export async function getRoundsStatus(t, accountId, token) {
+    const summary = await getSupportSummary(t, accountId, token);
+    return {
+        windowDays: summary.rounds.windowDays,
+        open: summary.rounds.inProgress,
+        completed: summary.rounds.completed,
+        incomplete: summary.rounds.incomplete + summary.rounds.expired,
+    };
+}
+export async function getRoundsDetail(t, accountId, token) {
+    const routesBody = await fetchRoutes(t, accountId, token, ROUTES_DETAIL_REQUEST_LIMIT);
+    const routes = routesBody.results.slice(0, MAX_ROUTES_FOR_ROUNDS_DETAIL);
+    const items = await Promise.all(routes.map(async (route) => {
+        let rawRounds = [];
+        let error;
+        try {
+            rawRounds = (await fetchRouteRounds(t, route.id, token, { limit: 3 })).results;
+        }
+        catch (err) {
+            // Una ruta cuya consulta de rondas falla no debe tumbar el resto, pero
+            // tampoco puede parecer "sin rondas": se marca el error.
+            rawRounds = [];
+            error = `no se pudieron leer las rondas de esta ruta: ${err instanceof Error ? err.message : String(err)}`;
+        }
+        return {
+            routeName: route.name,
+            isActive: route.isActive,
+            ...(error ? { error } : {}),
+            rounds: rawRounds.map((r) => ({
+                status: r.status,
+                patrollerName: r.patrollerName ?? null,
+                completedCheckpoints: r.completedCheckpoints,
+                totalCheckpoints: r.totalCheckpoints,
+                startTime: r.startTime,
+                endTime: r.endTime ?? null,
+            })),
+        };
+    }));
+    return { items, total: routesBody.count, truncado: isTruncated(routesBody, items.length) };
+}
+/** La ruta indicada por nombre, o la única (preferentemente activa) si no se indica; si no, por qué no. */
+function pickRoute(routes, routeName) {
+    if (routeName?.trim()) {
+        const resolution = resolveByName(routeName, routes, (r) => r.name);
+        if (resolution.kind === 'ambiguous') {
+            return {
+                found: false,
+                reason: 'route_ambiguous',
+                opciones: resolution.matches.slice(0, MAX_ROUTE_OPTIONS).map((r) => r.name),
+            };
+        }
+        if (resolution.kind === 'none') {
+            return {
+                found: false,
+                reason: 'route_not_found',
+                opciones: routes.slice(0, MAX_ROUTE_OPTIONS).map((r) => r.name),
+            };
+        }
+        return resolution.item;
+    }
+    // Sin ruta indicada: si hay UNA sola (preferentemente activa), se toma por
+    // defecto; si hay varias, se devuelven las opciones para que se listen.
+    const active = routes.filter((r) => r.isActive);
+    const candidates = active.length > 0 ? active : routes;
+    if (candidates.length === 1)
+        return candidates[0];
+    return {
+        found: false,
+        reason: 'route_not_specified',
+        opciones: candidates.slice(0, MAX_ROUTE_OPTIONS).map((r) => r.name),
+    };
+}
+export async function getRoundCheckpoints(t, accountId, token, routeName) {
+    const routesBody = await fetchRoutes(t, accountId, token, ROUTE_LIST_LIMIT);
+    const match = pickRoute(routesBody.results, routeName);
+    if ('found' in match)
+        return match;
+    const rounds = await fetchRouteRounds(t, match.id, token, { limit: 1 });
+    const latestRound = rounds.results[0];
+    if (!latestRound) {
+        return { found: false, reason: 'no_rounds' };
+    }
+    return {
+        found: true,
+        routeName: match.name,
+        ...(await getRoundDetail(t, match.id, latestRound.id, token)),
+    };
+}
+export async function getRoundDetail(t, routeId, roundId, token) {
+    const [route, round] = [routeId, roundId];
+    const body = await t.data(token, getGetRouteRoundCheckpointsUrl(route, round), (init) => getRouteRoundCheckpoints(route, round, init));
+    return {
+        status: body.status,
+        scannedCount: body.scannedCount,
+        totalCount: body.totalCount,
+        checkpoints: body.checkpoints.map((c) => ({
+            checkpointName: c.checkpointName,
+            order: c.order,
+            scanned: c.scanned,
+            scanTime: c.scanTime ?? null,
+        })),
+    };
+}
+export async function getRouteRounds(t, routeId, token, { page, limit }) {
+    const body = await fetchRouteRounds(t, routeId, token, { page, limit });
+    return {
+        totalPages: body.totalPages,
+        items: body.results.map((r) => ({
+            id: r.id,
+            status: r.status,
+            patrollerName: r.patrollerName ?? null,
+            completedCheckpoints: r.completedCheckpoints,
+            totalCheckpoints: r.totalCheckpoints,
+            startTime: r.startTime,
+            endTime: r.endTime ?? null,
+        })),
+    };
+}
+//# sourceMappingURL=rounds.js.map

package/dist/gateway/sdk/rounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rounds.js","sourceRoot":"","sources":["../../../src/gateway/sdk/rounds.ts"],"names":[],"mappings":"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"}

package/dist/gateway/sdk/routes.d.ts

@@ -0,0 +1,18 @@
+import { type PaginatedRoutes } from '@patroltech/sdk-api';
+import type { ListaTruncable, NewRoute, NewTimeWindow, RouteDetails, RouteRef } from '../types/index.js';
+import type { SdkTransport } from './transport.js';
+export declare const ROUTE_LIST_LIMIT = 50;
+/** Una página de rutas de la organización. */
+export declare function fetchRoutes(t: SdkTransport, accountId: string, token: string, limit: number): Promise<PaginatedRoutes>;
+export declare function listRoutes(t: SdkTransport, accountId: string, token: string): Promise<ListaTruncable<RouteRef>>;
+export declare function getRouteDetails(t: SdkTransport, routeId: string, token: string): Promise<RouteDetails | null>;
+export declare function createRoute(t: SdkTransport, input: NewRoute, token: string): Promise<{
+    id: string;
+    name: string;
+}>;
+export declare function addRouteTimeWindow(t: SdkTransport, routeId: string, window: NewTimeWindow, token: string): Promise<void>;
+export declare function deleteRouteTimeWindow(t: SdkTransport, timeWindowId: string, token: string): Promise<void>;
+export declare function setRouteActive(t: SdkTransport, routeId: string, isActive: boolean, token: string): Promise<void>;
+export declare function addCheckpointToRoute(t: SdkTransport, routeId: string, checkpointId: string, order: number, token: string): Promise<void>;
+export declare function removeCheckpointFromRoute(t: SdkTransport, routeId: string, checkpointId: string, token: string): Promise<void>;
+//# sourceMappingURL=routes.d.ts.map

package/dist/gateway/sdk/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/gateway/sdk/routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAiBL,KAAK,eAAe,EAErB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,cAAc,EACd,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,QAAQ,EACT,MAAM,mBAAmB,CAAC;AAG3B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnD,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,8CAA8C;AAC9C,wBAAsB,WAAW,CAC/B,CAAC,EAAE,YAAY,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,eAAe,CAAC,CAG1B;AAED,wBAAsB,UAAU,CAC9B,CAAC,EAAE,YAAY,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CASnC;AAED,wBAAsB,eAAe,CACnC,CAAC,EAAE,YAAY,EACf,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAyB9B;AAED,wBAAsB,WAAW,CAC/B,CAAC,EAAE,YAAY,EACf,KAAK,EAAE,QAAQ,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAMvC;AAED,wBAAsB,kBAAkB,CACtC,CAAC,EAAE,YAAY,EACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,qBAAqB,CACzC,CAAC,EAAE,YAAY,EACf,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,cAAc,CAClC,CAAC,EAAE,YAAY,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,oBAAoB,CACxC,CAAC,EAAE,YAAY,EACf,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,yBAAyB,CAC7C,CAAC,EAAE,YAAY,EACf,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAKf"}

package/dist/gateway/sdk/routes.js

@@ -0,0 +1,74 @@
+import { addCheckpointToRoute as sdkAddCheckpointToRoute, addTimeWindowToRoute, createRouteComplete, getAddCheckpointToRouteUrl, getAddTimeWindowToRouteUrl, getCreateRouteCompleteUrl, getGetRouteWithDetailsUrl, getListRoutesUrl, getRemoveCheckpointFromRouteUrl, getRemoveTimeWindowFromRouteUrl, getRouteWithDetails, getToggleRouteActiveUrl, listRoutes as sdkListRoutes, removeCheckpointFromRoute as sdkRemoveCheckpointFromRoute, removeTimeWindowFromRoute, toggleRouteActive, } from '@patroltech/sdk-api';
+import { isNotFound } from './errors.js';
+import { isTruncated } from './list.js';
+// Límite de rutas consultadas al listar o resolver una ruta por nombre.
+export const ROUTE_LIST_LIMIT = 50;
+/** Una página de rutas de la organización. */
+export async function fetchRoutes(t, accountId, token, limit) {
+    const params = { organizationId: accountId, limit };
+    return t.data(token, getListRoutesUrl(params), (init) => sdkListRoutes(params, init));
+}
+export async function listRoutes(t, accountId, token) {
+    const body = await fetchRoutes(t, accountId, token, ROUTE_LIST_LIMIT);
+    const items = body.results.map((r) => ({
+        id: r.id,
+        name: r.name,
+        isActive: r.isActive,
+        locationId: typeof r.locationId === 'string' ? r.locationId : null,
+    }));
+    return { items, total: body.count, truncado: isTruncated(body, items.length) };
+}
+export async function getRouteDetails(t, routeId, token) {
+    const id = routeId;
+    let r;
+    try {
+        r = await t.data(token, getGetRouteWithDetailsUrl(id), (init) => getRouteWithDetails(id, init));
+    }
+    catch (err) {
+        if (isNotFound(err))
+            return null;
+        throw err;
+    }
+    return {
+        id: r.id,
+        name: r.name,
+        isActive: r.isActive,
+        locationId: r.locationId,
+        checkpoints: (r.checkpoints ?? [])
+            .map((c) => ({ checkpointId: c.checkpointId, order: c.order }))
+            .sort((a, b) => a.order - b.order),
+        // El backend las devuelve `HH:MM:SS`; aquí van `HH:MM` como las que se envían.
+        timeWindows: (r.timeWindows ?? []).map((w) => ({
+            id: w.id,
+            startTime: w.startTime.slice(0, 5),
+            endTime: w.endTime.slice(0, 5),
+            days: w.days,
+        })),
+    };
+}
+export async function createRoute(t, input, token) {
+    // El cuerpo tal cual (id del bot, horarios UTC con su zona).
+    const r = await t.data(token, getCreateRouteCompleteUrl(), (init) => createRouteComplete(input, init));
+    return { id: r.id, name: r.name };
+}
+export async function addRouteTimeWindow(t, routeId, window, token) {
+    const id = routeId;
+    await t.envelope(token, getAddTimeWindowToRouteUrl(id), (init) => addTimeWindowToRoute(id, window, init));
+}
+export async function deleteRouteTimeWindow(t, timeWindowId, token) {
+    const id = timeWindowId;
+    await t.envelope(token, getRemoveTimeWindowFromRouteUrl(id), (init) => removeTimeWindowFromRoute(id, init));
+}
+export async function setRouteActive(t, routeId, isActive, token) {
+    const id = routeId;
+    await t.envelope(token, getToggleRouteActiveUrl(id), (init) => toggleRouteActive(id, { isActive }, init));
+}
+export async function addCheckpointToRoute(t, routeId, checkpointId, order, token) {
+    const [route, checkpoint] = [routeId, checkpointId];
+    await t.envelope(token, getAddCheckpointToRouteUrl(route, checkpoint), (init) => sdkAddCheckpointToRoute(route, checkpoint, { order }, init));
+}
+export async function removeCheckpointFromRoute(t, routeId, checkpointId, token) {
+    const [route, checkpoint] = [routeId, checkpointId];
+    await t.envelope(token, getRemoveCheckpointFromRouteUrl(route, checkpoint), (init) => sdkRemoveCheckpointFromRoute(route, checkpoint, init));
+}
+//# sourceMappingURL=routes.js.map

package/dist/gateway/sdk/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../src/gateway/sdk/routes.ts"],"names":[],"mappings":"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"}

package/dist/gateway/sdk/scans.d.ts

@@ -0,0 +1,4 @@
+import type { ListaTruncable, RecentScan, ScanQuery } from '../types/index.js';
+import type { SdkTransport } from './transport.js';
+export declare function getRecentScans(t: SdkTransport, accountId: string, token: string, opts?: ScanQuery): Promise<ListaTruncable<RecentScan>>;
+//# sourceMappingURL=scans.d.ts.map

package/dist/gateway/sdk/scans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scans.d.ts","sourceRoot":"","sources":["../../../src/gateway/sdk/scans.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAc,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE3F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAsDnD,wBAAsB,cAAc,CAClC,CAAC,EAAE,YAAY,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,SAAS,GACf,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAiBrC"}

package/dist/gateway/sdk/scans.js

@@ -0,0 +1,72 @@
+import { getListScansUrl, listScans, } from '@patroltech/sdk-api';
+import { explainScan } from '../../domain/scan-explanation.js';
+import { isTruncated } from './list.js';
+const DEFAULT_SCANS_LIMIT = 10;
+/** Solo los datos del móvil que vienen; undefined si no hay ninguno. */
+function scanDevice(d) {
+    if (!d)
+        return undefined;
+    const modelo = [d.manufacturer, d.deviceName].filter((x) => !!x).join(' ');
+    const sistema = [d.platform, d.osVersion].filter((x) => !!x).join(' ');
+    const device = {
+        ...(modelo ? { modelo } : {}),
+        ...(sistema ? { sistema } : {}),
+        ...(typeof d.batteryLevel === 'number' ? { bateriaPct: Math.round(d.batteryLevel) } : {}),
+        ...(d.batteryStatus ? { cargando: d.batteryStatus === 'charging' } : {}),
+        ...(d.connectionType ? { conexion: d.connectionType } : {}),
+    };
+    return Object.keys(device).length > 0 ? device : undefined;
+}
+function toRecentScan(s) {
+    const base = {
+        timestamp: s.timestamp,
+        checkpointName: s.checkpointName ?? null,
+        patrollerName: s.patrollerName ?? null,
+    };
+    // Fuera del historial del plan el backend oculta el detalle: no hay nada que explicar.
+    if (s.redacted === true) {
+        return {
+            ...base,
+            fraudFlagged: false,
+            validacion: 'oculto por la retención de datos',
+            motivosSospecha: [],
+        };
+    }
+    const dispositivo = scanDevice(s.deviceInfo);
+    const gps = s.fraudFlags?.gpsProximity;
+    return {
+        ...base,
+        fraudFlagged: s.fraudFlags?.flagged === true,
+        ...explainScan({
+            validationStatus: s.validationStatus ?? null,
+            validationReason: s.validationReason ?? null,
+            fraudFlags: s.fraudFlags ?? null,
+        }),
+        ...(dispositivo ? { dispositivo } : {}),
+        ...(typeof gps?.distanceMeters === 'number'
+            ? { distanciaGpsM: Math.round(gps.distanceMeters) }
+            : {}),
+        ...(typeof gps?.accuracyMeters === 'number'
+            ? { precisionGpsM: Math.round(gps.accuracyMeters) }
+            : {}),
+    };
+}
+export async function getRecentScans(t, accountId, token, opts) {
+    // Mismo orden de parámetros que siempre; solo los que vienen.
+    const params = {
+        organizationId: accountId,
+        limit: opts?.limit || DEFAULT_SCANS_LIMIT,
+        ...(opts?.page ? { page: opts.page } : {}),
+        ...(opts?.dateFrom ? { dateFrom: opts.dateFrom } : {}),
+        ...(opts?.dateTo ? { dateTo: opts.dateTo } : {}),
+        ...(opts?.patrollerId ? { patroller: opts.patrollerId } : {}),
+        ...(opts?.checkpointId ? { checkpoint: opts.checkpointId } : {}),
+        ...(opts?.locationId ? { locationId: opts.locationId } : {}),
+        ...(opts?.soloSospechosos ? { fraudStatus: 'flagged' } : {}),
+        ...(opts?.soloNoValidos ? { validationStatus: 'rejected' } : {}),
+    };
+    const body = await t.data(token, getListScansUrl(params), (init) => listScans(params, init));
+    const items = body.results.map(toRecentScan);
+    return { items, total: body.count, truncado: isTruncated(body, items.length) };
+}
+//# sourceMappingURL=scans.js.map

package/dist/gateway/sdk/scans.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scans.js","sourceRoot":"","sources":["../../../src/gateway/sdk/scans.ts"],"names":[],"mappings":"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"}

package/dist/gateway/sdk/transport.d.ts

@@ -0,0 +1,77 @@
+import { type SdkRequestInit } from '@patroltech/sdk-api';
+import type { Logger } from '../../ports/Logger.js';
+/**
+ * Lo que devuelve una función generada del SDK: la unión de sus respuestas por
+ * status, cada una con su `data` (ya desenvuelto del envelope `ApiResponse`).
+ * El SDK lanza en las no-2xx, así que aquí solo llegan las 2xx.
+ */
+export interface SdkResponse {
+    data: unknown;
+    status: number;
+}
+/** El `data` de las respuestas 2xx del tipo generado: lo único que puede llegar sin lanzar. */
+export type SuccessData<R> = R extends {
+    status: 200 | 201 | 202 | 203 | 204 | 206;
+    data: infer D;
+} ? D : never;
+/**
+ * Lo que devuelve `sdkFetch` además de `data`: el resto de campos del envelope
+ * (`message`, `meta`…), que el OpenAPI no describe.
+ */
+export interface SdkEnvelopeExtras {
+    meta?: unknown;
+    message?: unknown;
+    [field: string]: unknown;
+}
+/** Una llamada a una función generada del SDK con las opciones de esta petición. */
+export type SdkCall<R extends SdkResponse = SdkResponse> = (init: SdkRequestInit) => Promise<R>;
+export interface SdkTransportConfig {
+    baseUrl: string;
+    fetchImpl?: typeof fetch;
+    timeoutMs: number;
+    logger: Logger;
+    /** Cabeceras que se suman a cada petición; se piden en cada una (id de petición, cliente…). */
+    defaultHeaders?: () => Record<string, string>;
+}
+type HttpMethod = 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE';
+/** Configuración de `callSdk`: la misma para todos los usuarios (el token va en cada llamada). */
+export type SdkCallConfig = Pick<SdkTransportConfig, 'baseUrl' | 'fetchImpl' | 'timeoutMs' | 'defaultHeaders'>;
+/**
+ * Una llamada a una función generada del SDK con su propia configuración (base, token, `fetch`,
+ * cabeceras sin `Authorization` y timeout): nada global. Un rechazo del backend sale como
+ * `PatrolTechApiError` (status, `path` y cuerpo), que entiende `translateBackendError`; un fallo
+ * de red o timeout, tal cual. Es lo que usa `SdkTransport` y lo que reutilizan los consumidores
+ * que llaman a operaciones del SDK fuera del gateway (el MCP: propuestas, directorio, hoja de QR).
+ * El timeout evita que una llamada colgada bloquee a quien procesa en serie.
+ */
+export declare function callSdk<R>(config: SdkCallConfig, token: string | null, path: string, call: (init: SdkRequestInit) => Promise<R>): Promise<R>;
+/**
+ * Único punto por el que pasan las llamadas al backend: cada una con su propia
+ * configuración del SDK (base, token, `fetch`; nada global, así un servidor
+ * multi-tenant no mezcla identidades), con timeout y con los errores traducidos
+ * a `PatrolTechApiError`.
+ */
+export declare class SdkTransport {
+    private readonly config;
+    constructor(config: SdkTransportConfig);
+    get logger(): Logger;
+    /**
+     * La respuesta entera (status, `data` y los demás campos del envelope).
+     * `token` null = endpoint público (sin cabecera `Authorization`). `path` solo
+     * nombra la ruta en el error.
+     */
+    envelope<R extends SdkResponse>(token: string | null, path: string, call: SdkCall<R>): Promise<R & SdkEnvelopeExtras>;
+    /**
+     * El payload (`data`) de la respuesta, con el tipo que el SDK genera del
+     * OpenAPI para su respuesta 2xx: sin genérico a mano ni cast.
+     */
+    data<R extends SdkResponse>(token: string | null, path: string, call: SdkCall<R>): Promise<SuccessData<R>>;
+    /**
+     * Endpoint o parámetro que el OpenAPI aún no describe (README, «Pending OpenAPI
+     * coverage»): misma vía del SDK (`sdkFetch` con la configuración de esta petición),
+     * con la URL completa construida por quien llama.
+     */
+    uncovered<T>(token: string, method: HttpMethod, url: string, body?: unknown): Promise<T>;
+}
+export {};
+//# sourceMappingURL=transport.d.ts.map

package/dist/gateway/sdk/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/gateway/sdk/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAGpD;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,+FAA+F;AAC/F,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,CAAA;CAAE,GAC/F,CAAC,GACD,KAAK,CAAC;AAEV;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,oFAAoF;AACpF,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,IAAI,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAEhG,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,+FAA+F;IAC/F,cAAc,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/C;AAaD,KAAK,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE9D,kGAAkG;AAClG,MAAM,MAAM,aAAa,GAAG,IAAI,CAC9B,kBAAkB,EAClB,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,gBAAgB,CACzD,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAC7B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,GACzC,OAAO,CAAC,CAAC,CAAC,CAaZ;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,kBAAkB;IAEvD,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;;OAIG;IACG,QAAQ,CAAC,CAAC,SAAS,WAAW,EAClC,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GACf,OAAO,CAAC,CAAC,GAAG,iBAAiB,CAAC;IAKjC;;;OAGG;IACG,IAAI,CAAC,CAAC,SAAS,WAAW,EAC9B,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GACf,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAI1B;;;;OAIG;IACG,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;CAa/F"}