@patroltech/agent-capabilities 0.0.0-stage → 0.2.0

package/dist/gateway/sdk/transport.js

@@ -0,0 +1,81 @@
+import { createApiClient, sdkFetch } from '@patroltech/sdk-api';
+import { toPatrolTechApiError } from './errors.js';
+/**
+ * La identidad de la petición la pone el token, nunca las cabeceras por defecto:
+ * se descarta cualquier `Authorization`, con la grafía que sea (si no, con otra
+ * mayúscula irían las dos y el servidor las uniría, o saldría una sin token).
+ */
+function sinAuthorization(headers) {
+    return Object.fromEntries(Object.entries(headers).filter(([name]) => !/^authorization$/i.test(name)));
+}
+/**
+ * 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 async function callSdk(config, token, path, call) {
+    const { baseUrl, fetchImpl, timeoutMs, defaultHeaders } = config;
+    const client = createApiClient({
+        baseUrl,
+        fetchImpl,
+        defaultHeaders: defaultHeaders && (() => sinAuthorization(defaultHeaders())),
+        getAccessToken: () => token,
+    });
+    try {
+        return await call(client.init({ signal: AbortSignal.timeout(timeoutMs) }));
+    }
+    catch (err) {
+        throw toPatrolTechApiError(err, path);
+    }
+}
+/**
+ * Ú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 class SdkTransport {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    get logger() {
+        return this.config.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.
+     */
+    async envelope(token, path, call) {
+        // `sdkFetch` devuelve, además de lo tipado, el resto del envelope (`message`, `meta`…).
+        return (await callSdk(this.config, token, path, call));
+    }
+    /**
+     * 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.
+     */
+    async data(token, path, call) {
+        return (await this.envelope(token, path, call)).data;
+    }
+    /**
+     * 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.
+     */
+    async uncovered(token, method, url, body) {
+        // Sin tipo generado: `T` es el tipo local de la respuesta (README, «Untyped responses»).
+        const res = await this.envelope(token, url, (init) => sdkFetch(url, {
+            ...init,
+            method,
+            ...(body !== undefined
+                ? { headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) }
+                : {}),
+        }));
+        return res.data;
+    }
+}
+//# sourceMappingURL=transport.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../src/gateway/sdk/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAuB,MAAM,qBAAqB,CAAC;AAErF,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAuCnD;;;;GAIG;AACH,SAAS,gBAAgB,CAAC,OAA+B;IACvD,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAC3E,CAAC;AACJ,CAAC;AAUD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAqB,EACrB,KAAoB,EACpB,IAAY,EACZ,IAA0C;IAE1C,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC;IACjE,MAAM,MAAM,GAAG,eAAe,CAAC;QAC7B,OAAO;QACP,SAAS;QACT,cAAc,EAAE,cAAc,IAAI,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,cAAc,EAAE,CAAC,CAAC;QAC5E,cAAc,EAAE,GAAG,EAAE,CAAC,KAAK;KAC5B,CAAC,CAAC;IACH,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,oBAAoB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,MAA0B;QAA1B,WAAM,GAAN,MAAM,CAAoB;IAAG,CAAC;IAE3D,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CACZ,KAAoB,EACpB,IAAY,EACZ,IAAgB;QAEhB,wFAAwF;QACxF,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAA0B,CAAC;IAClF,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CACR,KAAoB,EACpB,IAAY,EACZ,IAAgB;QAEhB,OAAO,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAsB,CAAC;IACzE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS,CAAI,KAAa,EAAE,MAAkB,EAAE,GAAW,EAAE,IAAc;QAC/E,yFAAyF;QACzF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CACnD,QAAQ,CAAc,GAAG,EAAE;YACzB,GAAG,IAAI;YACP,MAAM;YACN,GAAG,CAAC,IAAI,KAAK,SAAS;gBACpB,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE;gBACjF,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CACH,CAAC;QACF,OAAO,GAAG,CAAC,IAAS,CAAC;IACvB,CAAC;CACF"}

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

@@ -0,0 +1,15 @@
+import type { AlertChannel, AlertType, InviteResult, NewOrgUser, OrgUser } from '../types/index.js';
+import type { SdkTransport } from './transport.js';
+export declare function setAlertPreference(t: SdkTransport, input: {
+    tipo: AlertType;
+    canal: AlertChannel;
+    activar: boolean;
+}, token: string): Promise<void>;
+export declare function listOrgUsers(t: SdkTransport, accountId: string, token: string): Promise<OrgUser[]>;
+export declare function inviteUser(t: SdkTransport, input: NewOrgUser, token: string): Promise<InviteResult>;
+export declare function updateUserRole(t: SdkTransport, input: {
+    userRoleId: string;
+    roleType: 'VIEWER' | 'EDITOR' | 'ADMIN';
+}, token: string): Promise<void>;
+export declare function deleteUserRole(t: SdkTransport, userRoleId: string, token: string): Promise<void>;
+//# sourceMappingURL=users.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../../src/gateway/sdk/users.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACpG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,wBAAsB,kBAAkB,CACtC,CAAC,EAAE,YAAY,EACf,KAAK,EAAE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,EACjE,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAsB,YAAY,CAChC,CAAC,EAAE,YAAY,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,EAAE,CAAC,CAgBpB;AAED,wBAAsB,UAAU,CAC9B,CAAC,EAAE,YAAY,EACf,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,CAAC,CAgBvB;AAED,wBAAsB,cAAc,CAClC,CAAC,EAAE,YAAY,EACf,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAA;CAAE,EACtE,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,cAAc,CAClC,CAAC,EAAE,YAAY,EACf,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/gateway/sdk/users.js

@@ -0,0 +1,49 @@
+import { createOrganizationUser, deleteUserRole as sdkDeleteUserRole, getCreateOrganizationUserUrl, getDeleteUserRoleUrl, getGetOrganizationUsersUrl, getOrganizationUsers, getUpdateUserPreferencesUrl, getUpdateUserRoleUrl, updateUserPreferences, updateUserRole as sdkUpdateUserRole, } from '@patroltech/sdk-api';
+export async function setAlertPreference(t, input, token) {
+    // El backend fusiona `channels` tipo a tipo y canal a canal con lo guardado:
+    // mandar solo el que cambia no toca el resto.
+    const body = {
+        notificationPreferences: { channels: { [input.tipo]: { [input.canal]: input.activar } } },
+    };
+    await t.envelope(token, getUpdateUserPreferencesUrl(), (init) => updateUserPreferences(body, init));
+}
+export async function listOrgUsers(t, accountId, token) {
+    const params = { organizationId: accountId };
+    const body = await t.data(token, getGetOrganizationUsersUrl(params), (init) => getOrganizationUsers(params, init));
+    return body.results.map((u) => ({
+        id: u.id,
+        nombre: u.name,
+        email: u.email,
+        roles: (u.UserRoles ?? []).map((r) => ({
+            id: r.id,
+            rol: r.roleType,
+            ambito: r.roleScope,
+            scopeId: r.scopeId,
+        })),
+    }));
+}
+export async function inviteUser(t, input, token) {
+    // Campos uno a uno (nunca un spread): el backend usaría un `id` para crear el usuario.
+    const body = {
+        organizationId: input.organizationId,
+        name: input.name,
+        email: input.email,
+        roleType: input.roleType,
+        roleScope: input.roleScope,
+        ...(input.roleScope === 'LOCATION' && input.locationId ? { locationId: input.locationId } : {}),
+    };
+    // `data` es null: lo que importa va en el envelope. `meta.emailSent` solo viene con una cuenta nueva.
+    const res = await t.envelope(token, getCreateOrganizationUserUrl(), (init) => createOrganizationUser(body, init));
+    const emailSent = res.meta?.emailSent;
+    return { cuentaNueva: typeof emailSent === 'boolean', emailEnviado: emailSent !== false };
+}
+export async function updateUserRole(t, input, token) {
+    // Solo `roleType`: el backend saca la organización del propio rol, no del body.
+    const id = input.userRoleId;
+    await t.envelope(token, getUpdateUserRoleUrl(id), (init) => sdkUpdateUserRole(id, { roleType: input.roleType }, init));
+}
+export async function deleteUserRole(t, userRoleId, token) {
+    const id = userRoleId;
+    await t.envelope(token, getDeleteUserRoleUrl(id), (init) => sdkDeleteUserRole(id, init));
+}
+//# sourceMappingURL=users.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"users.js","sourceRoot":"","sources":["../../../src/gateway/sdk/users.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,cAAc,IAAI,iBAAiB,EACnC,4BAA4B,EAC5B,oBAAoB,EACpB,0BAA0B,EAC1B,oBAAoB,EACpB,2BAA2B,EAC3B,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,IAAI,iBAAiB,GACpC,MAAM,qBAAqB,CAAC;AAI7B,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,CAAe,EACf,KAAiE,EACjE,KAAa;IAEb,6EAA6E;IAC7E,8CAA8C;IAC9C,MAAM,IAAI,GAAG;QACX,uBAAuB,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE;KAC1F,CAAC;IACF,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,2BAA2B,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAC9D,qBAAqB,CAAC,IAAI,EAAE,IAAI,CAAC,CAClC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,CAAe,EACf,SAAiB,EACjB,KAAa;IAEb,MAAM,MAAM,GAAG,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,0BAA0B,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAC5E,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,CACnC,CAAC;IACF,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9B,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,MAAM,EAAE,CAAC,CAAC,IAAI;QACd,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACrC,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,GAAG,EAAE,CAAC,CAAC,QAAQ;YACf,MAAM,EAAE,CAAC,CAAC,SAAS;YACnB,OAAO,EAAE,CAAC,CAAC,OAAO;SACnB,CAAC,CAAC;KACJ,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,CAAe,EACf,KAAiB,EACjB,KAAa;IAEb,uFAAuF;IACvF,MAAM,IAAI,GAAG;QACX,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChG,CAAC;IACF,sGAAsG;IACtG,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,4BAA4B,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAC3E,sBAAsB,CAAC,IAAI,EAAE,IAAI,CAAC,CACnC,CAAC;IACF,MAAM,SAAS,GAAI,GAAG,CAAC,IAA4C,EAAE,SAAS,CAAC;IAC/E,OAAO,EAAE,WAAW,EAAE,OAAO,SAAS,KAAK,SAAS,EAAE,YAAY,EAAE,SAAS,KAAK,KAAK,EAAE,CAAC;AAC5F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,CAAe,EACf,KAAsE,EACtE,KAAa;IAEb,gFAAgF;IAChF,MAAM,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC;IAC5B,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CACzD,iBAAiB,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,CAC1D,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,CAAe,EACf,UAAkB,EAClB,KAAa;IAEb,MAAM,EAAE,GAAG,UAAU,CAAC;IACtB,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;AAC3F,CAAC"}

package/dist/gateway/types/access.d.ts

@@ -0,0 +1,32 @@
+export type AccessType = 'ENTRY' | 'EXIT';
+/** Filtros de `GET …/access-logs`; `desde`/`hasta` en ISO UTC. El backend exige la ubicación. */
+export interface AccessLogQuery {
+    locationId: string;
+    zona?: string;
+    tipo?: AccessType;
+    desde?: string;
+    hasta?: string;
+    /** 1-based. */
+    page?: number;
+    /** Máximo 100 (el backend rechaza más). */
+    limit?: number;
+}
+/** Un registro del Control de Acceso. `oculto` = la retención del plan ha borrado sus datos personales. */
+export interface AccessLogEntry {
+    id: string;
+    locationId: string;
+    zona: string | null;
+    tipo: AccessType;
+    fecha: string;
+    /** Persona autorizada (de la lista del panel). */
+    persona: string | null;
+    identificadorPersona: string | null;
+    visitante: string | null;
+    /** Documento del visitante: solo va al Excel, nunca al texto del chat. */
+    documentoVisitante: string | null;
+    empresaVisitante: string | null;
+    destino: string | null;
+    notas: string | null;
+    oculto: boolean;
+}
+//# sourceMappingURL=access.d.ts.map

package/dist/gateway/types/access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.d.ts","sourceRoot":"","sources":["../../../src/gateway/types/access.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AAE1C,iGAAiG;AACjG,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,2GAA2G;AAC3G,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,0EAA0E;IAC1E,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB"}

package/dist/gateway/types/access.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=access.js.map

package/dist/gateway/types/access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.js","sourceRoot":"","sources":["../../../src/gateway/types/access.ts"],"names":[],"mappings":""}

package/dist/gateway/types/billing.d.ts

@@ -0,0 +1,60 @@
+/** Uso frente a los límites del plan. Límite null = sin tope. */
+export interface PlanUsage {
+    plan: string;
+    estadoLicencia: string;
+    /**
+     * true = la organización ya paga una suscripción. null si no se sabe: el
+     * contrato público no lo expone, así que `SdkPatrolTechGateway` siempre da
+     * null y quien pide un checkout recibe del backend `ALREADY_SUBSCRIBED`.
+     */
+    pagaSuscripcion: boolean | null;
+    /** null si el backend no pudo calcular el consumo. */
+    uso: {
+        checkpoints: {
+            usados: number;
+            incluidos: number | null;
+            extraFacturados: number;
+        };
+        ubicaciones: {
+            usadas: number;
+            limite: number | null;
+        };
+        gestores: {
+            usados: number;
+            limite: number | null;
+        };
+    } | null;
+}
+/**
+ * Plan de pago del catálogo (`GET /api/payments/prices`), con los importes ya
+ * en la moneda de la organización (la misma con la que cobrará el checkout).
+ */
+export interface PaidPlan {
+    tierId: string;
+    nombre: string;
+    /** Identificador del tier: `pro` o `business`. */
+    identificador: string;
+    /** `EUR` o `USD`. */
+    moneda: string;
+    checkpointsIncluidos: number;
+    /** Importes en unidades de la moneda (no céntimos); `extra` es cada checkpoint por encima de los incluidos. */
+    mensual: {
+        base: number;
+        extra: number;
+    };
+    anual: {
+        base: number;
+        extra: number;
+    };
+}
+export type BillingInterval = 'month' | 'year';
+/** `POST /api/payments/checkout-session`: a dónde vuelve el cliente al pagar o al cancelar. */
+export interface CheckoutLinkInput {
+    tierId: string;
+    interval: BillingInterval;
+    successUrl: string;
+    cancelUrl: string;
+    /** País ISO-2 del cliente: el backend lo usa para la moneda (manda sobre la IP de quien llama). */
+    country?: string | null;
+}
+//# sourceMappingURL=billing.d.ts.map

package/dist/gateway/types/billing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../../../src/gateway/types/billing.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,eAAe,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,sDAAsD;IACtD,GAAG,EAAE;QACH,WAAW,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,eAAe,EAAE,MAAM,CAAA;SAAE,CAAC;QACnF,WAAW,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAC;QACvD,QAAQ,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAC;KACrD,GAAG,IAAI,CAAC;CACV;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB,EAAE,MAAM,CAAC;IAC7B,+GAA+G;IAC/G,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACxC;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,CAAC;AAE/C,+FAA+F;AAC/F,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,eAAe,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,mGAAmG;IACnG,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB"}

package/dist/gateway/types/billing.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=billing.js.map

package/dist/gateway/types/billing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.js","sourceRoot":"","sources":["../../../src/gateway/types/billing.ts"],"names":[],"mappings":""}

package/dist/gateway/types/checkpoints.d.ts

@@ -0,0 +1,84 @@
+import type { ListaTruncable } from './common.js';
+/**
+ * Checkpoint con lo necesario para filtrar y reenviar su QR. `codigo` solo
+ * viene si el usuario es EDITOR de esa ubicación: a un VIEWER el backend se lo
+ * oculta (`[redacted]`), y entonces es null.
+ */
+export interface CheckpointRef {
+    id: string;
+    name: string;
+    locationId: string;
+    locationName: string;
+    /** Tipo del método de verificación (`qr_static`, `manual_code`, `nfc_sun`…); null si no tiene. */
+    metodo: string | null;
+    codigo: string | null;
+    /** Primer escaneo del checkpoint (ISO); null = nunca escaneado. Ausente si el backend no lo informa. */
+    primerEscaneo?: string | null;
+    /** Código de 8 caracteres de la columna «Identificador» del panel; ausente si el backend no lo informa. */
+    identificador?: string;
+}
+export interface CheckpointRefsResult extends ListaTruncable<CheckpointRef> {
+    ubicacionesConError: number;
+}
+/** Reglas antifraude de un checkpoint (`fraudRules`, backend `fraud-detection/domain/FraudTypes.ts`). Sin una regla = desactivada. */
+export interface CheckpointFraudRules {
+    gpsProximity?: {
+        maxDistanceMeters: number;
+        maxAccuracyMeters?: number;
+    };
+    undergroundMode?: {
+        enabled: boolean;
+    };
+}
+/** Posición y reglas antifraude de un checkpoint, para leerlas antes de cambiarlas. */
+export interface CheckpointDetail {
+    id: string;
+    name: string;
+    locationId: string;
+    metodo: string | null;
+    latitud: number | null;
+    longitud: number | null;
+    reglasAntifraude: CheckpointFraudRules;
+    /** Reglas guardadas que el bot no conoce: si hay alguna, no se reescriben desde el bot. */
+    reglasDesconocidas: string[];
+}
+/** Punto de control configurado en la organización, con su ubicación. */
+export interface CheckpointInfo {
+    /** El que piden las herramientas que actúan sobre checkpoints concretos (p. ej. la hoja de QR). */
+    id: string;
+    name: string;
+    locationName: string | null;
+    identificador?: string;
+}
+/** Checkpoints de la organización, con las ubicaciones que no se pudieron leer. */
+export interface CheckpointsResult extends ListaTruncable<CheckpointInfo> {
+    /** Nº de ubicaciones cuya consulta falló: sus checkpoints NO están en la lista. */
+    ubicacionesConError: number;
+}
+/** Método de verificación con el que se crea un checkpoint desde el bot (el código lo genera el servidor). */
+export type CheckpointMethod = 'qr_static' | 'manual_code';
+/** Checkpoint tal como lo devuelve el alta (o la búsqueda que la recupera tras un fallo). */
+export interface CreatedCheckpoint {
+    id: string;
+    name: string;
+    locationId: string;
+    metodo: string | null;
+    /** El código que va en el QR o que se teclea; null si el backend no lo muestra. */
+    codigo: string | null;
+    /** ISO; null si el backend no lo informa. */
+    creadoEn: string | null;
+}
+/**
+ * Ruta de la que se quitó un checkpoint al archivarlo (`affectedRoutes` de
+ * `POST /api/checkpoints/:id/archive`): el backend desactiva la que se queda
+ * sin checkpoints.
+ */
+export interface ArchivedCheckpointRoute {
+    id: string;
+    name: string;
+    /** No le queda ningún checkpoint. */
+    leftEmpty: boolean;
+    /** Estaba activa y el archivado la ha desactivado por quedarse vacía. */
+    deactivated: boolean;
+}
+//# sourceMappingURL=checkpoints.d.ts.map

package/dist/gateway/types/checkpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoints.d.ts","sourceRoot":"","sources":["../../../src/gateway/types/checkpoints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,kGAAkG;IAClG,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,wGAAwG;IACxG,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,2GAA2G;IAC3G,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAqB,SAAQ,cAAc,CAAC,aAAa,CAAC;IACzE,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,sIAAsI;AACtI,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE,eAAe,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CACxC;AAED,uFAAuF;AACvF,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gBAAgB,EAAE,oBAAoB,CAAC;IACvC,2FAA2F;IAC3F,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC7B,mGAAmG;IACnG,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,mFAAmF;AACnF,MAAM,WAAW,iBAAkB,SAAQ,cAAc,CAAC,cAAc,CAAC;IACvE,mFAAmF;IACnF,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,8GAA8G;AAC9G,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,aAAa,CAAC;AAE3D,6FAA6F;AAC7F,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,mFAAmF;IACnF,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,WAAW,EAAE,OAAO,CAAC;CACtB"}

package/dist/gateway/types/checkpoints.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=checkpoints.js.map

package/dist/gateway/types/checkpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoints.js","sourceRoot":"","sources":["../../../src/gateway/types/checkpoints.ts"],"names":[],"mappings":""}

package/dist/gateway/types/common.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Lista que el cliente puede haber capado (para no disparar peticiones ni
+ * tokens sin límite). `truncado` es la señal honesta de que hay más datos de
+ * los devueltos: sin ella el modelo afirmaba totales y ausencias sobre 100 de
+ * 3.000 escaneos.
+ */
+export interface ListaTruncable<T> {
+    items: T[];
+    /** Total que informa el backend, cuando lo informa. */
+    total?: number;
+    truncado: boolean;
+}
+//# sourceMappingURL=common.d.ts.map

package/dist/gateway/types/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/gateway/types/common.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;CACnB"}

package/dist/gateway/types/common.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=common.js.map

package/dist/gateway/types/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/gateway/types/common.ts"],"names":[],"mappings":""}

package/dist/gateway/types/incidents.d.ts

@@ -0,0 +1,53 @@
+import type { IncidentStatus } from '../../domain/incident-status.js';
+/** Incidencia tal como la lista el backend. `titulo` es null si la oculta la retención del plan. */
+export interface IncidentRef {
+    id: string;
+    titulo: string | null;
+    estado: IncidentStatus;
+    prioridad: string;
+    locationId: string | null;
+    asignadoAId: string | null;
+    asignadoA: string | null;
+    creadaEn: string;
+}
+/** A qué incidencia va una escritura: el `locationId` da el rol de ubicación y el `organizationId` el gate de la App. */
+export interface IncidentTarget {
+    incidentId: string;
+    organizationId: string;
+    locationId: string | null;
+}
+/** Una entrada del historial de una incidencia (`tipo` es el del backend: CREATED, STATUS_CHANGE, COMMENT…). */
+export interface IncidentTimelineEntry {
+    tipo: string;
+    autor: string | null;
+    texto: string | null;
+    /** Valor anterior y nuevo en los cambios (estado, prioridad, asignación…). */
+    antes: string | null;
+    despues: string | null;
+    fecha: string;
+    /** Lleva una foto o un vídeo enlazado (la URL no se guarda). */
+    conAdjunto: boolean;
+}
+/** Detalle de una incidencia. `oculta` = la retención del plan ya no conserva sus datos. */
+export interface IncidentDetail {
+    id: string;
+    oculta: boolean;
+    titulo: string | null;
+    descripcion: string | null;
+    estado: IncidentStatus;
+    prioridad: string;
+    categoria: string | null;
+    subcategoria: string | null;
+    reportadaPor: string | null;
+    asignadaA: string | null;
+    locationId: string | null;
+    creadaEn: string;
+    resueltaEn: string | null;
+    cerradaEn: string | null;
+    /** Nombres de los checkpoints vinculados. */
+    checkpoints: string[];
+    timeline: IncidentTimelineEntry[];
+    fotos: number;
+    videos: number;
+}
+//# sourceMappingURL=incidents.d.ts.map

package/dist/gateway/types/incidents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incidents.d.ts","sourceRoot":"","sources":["../../../src/gateway/types/incidents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE,oGAAoG;AACpG,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,yHAAyH;AACzH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,gHAAgH;AAChH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,8EAA8E;IAC9E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,4FAA4F;AAC5F,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/gateway/types/incidents.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=incidents.js.map

package/dist/gateway/types/incidents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"incidents.js","sourceRoot":"","sources":["../../../src/gateway/types/incidents.ts"],"names":[],"mappings":""}

package/dist/gateway/types/index.d.ts

@@ -0,0 +1,12 @@
+export * from './common.js';
+export * from './rounds.js';
+export * from './checkpoints.js';
+export * from './routes.js';
+export * from './patrollers.js';
+export * from './incidents.js';
+export * from './users.js';
+export * from './locations.js';
+export * from './billing.js';
+export * from './access.js';
+export * from './scans.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/gateway/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/gateway/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/gateway/types/index.js

@@ -0,0 +1,12 @@
+export * from './common.js';
+export * from './rounds.js';
+export * from './checkpoints.js';
+export * from './routes.js';
+export * from './patrollers.js';
+export * from './incidents.js';
+export * from './users.js';
+export * from './locations.js';
+export * from './billing.js';
+export * from './access.js';
+export * from './scans.js';
+//# sourceMappingURL=index.js.map

package/dist/gateway/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/gateway/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/gateway/types/locations.d.ts

@@ -0,0 +1,7 @@
+export interface LocationRef {
+    id: string;
+    name: string;
+    /** Dirección postal (obligatoria en el backend); ausente o null si no se conoce. */
+    address?: string | null;
+}
+//# sourceMappingURL=locations.d.ts.map

package/dist/gateway/types/locations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locations.d.ts","sourceRoot":"","sources":["../../../src/gateway/types/locations.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB"}

package/dist/gateway/types/locations.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=locations.js.map

package/dist/gateway/types/locations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locations.js","sourceRoot":"","sources":["../../../src/gateway/types/locations.ts"],"names":[],"mappings":""}

package/dist/gateway/types/patrollers.d.ts

@@ -0,0 +1,68 @@
+export interface PatrollerActivity {
+    name: string;
+    lastScanAt: string | null;
+    status: 'active' | 'inactive' | 'alert';
+}
+export interface PatrollerRef {
+    id: string;
+    name: string;
+    /** Identificador corto (8 hex) con el que el enlace de la app preselecciona al vigilante. */
+    identifier: string;
+    lastScanAt: string | null;
+}
+export type PatrollerStatsResult = {
+    found: true;
+    name: string;
+    totalScans: number;
+    roundsCompleted: number;
+    totalRounds: number;
+    completionRate: number;
+    avgTimeBetweenScans: number | null;
+    incidentsReported?: number;
+    incidentsOpen?: number;
+    /** Antes de esta fecha (UTC) la retención de datos ya no deja ver el detalle; `null`, ilimitada. */
+    retentionCutoff?: string | null;
+} | {
+    found: false;
+    opciones: string[];
+    /** El nombre casaba con varios vigilantes: hay que elegir. */ ambigua?: boolean;
+};
+/** Entrada del ranking de vigilantes de la organización (ya viene ordenado de mejor a peor). */
+export interface PatrollerRankingEntry {
+    patrollerName: string;
+    totalScans: number;
+    roundsCompleted: number;
+    completionRate: number;
+    avgTimeBetweenScans: number | null;
+}
+/** Ranking de vigilantes de la organización, con resumen del equipo y checkpoints más escaneados. */
+export interface PatrollerRanking {
+    summary: {
+        totalScans: number;
+        activePatrollers: number;
+        avgScansPerPatroller: number;
+        bestCompletionRate: number;
+    };
+    ranking: PatrollerRankingEntry[];
+    topCheckpoints: {
+        checkpointName: string;
+        totalScans: number;
+    }[];
+    /** true si el ranking o los checkpoints top se han recortado. */
+    truncado: boolean;
+    /** El periodo nunca empieza antes de esta fecha (UTC), por la retención de datos; `null`, ilimitada. */
+    retentionCutoff?: string | null;
+}
+/** Vigilante tal como lo devuelve el alta o `GET /api/patrollers/identifier/:identifier`. */
+export interface CreatedPatroller {
+    id: string;
+    name: string;
+    identifier: string;
+    organizationId: string;
+}
+/** Tipos de alerta que el usuario puede configurar (`userConfigurable` en el AlertTypeRegistry del backend). */
+export declare const ALERT_TYPES: readonly ["pending_route", "missed_route", "upcoming_deadline", "patroller_inactive", "suspicious_scan", "role_assignment", "incident_created", "incident_status_changed", "incident_assigned", "incident_comment"];
+export type AlertType = (typeof ALERT_TYPES)[number];
+export declare const ALERT_CHANNELS: readonly ["email", "push", "whatsapp"];
+export type AlertChannel = (typeof ALERT_CHANNELS)[number];
+//# sourceMappingURL=patrollers.d.ts.map

package/dist/gateway/types/patrollers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patrollers.d.ts","sourceRoot":"","sources":["../../../src/gateway/types/patrollers.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;CACzC;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,6FAA6F;IAC7F,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,MAAM,oBAAoB,GAC5B;IACE,KAAK,EAAE,IAAI,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oGAAoG;IACpG,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,GACD;IACE,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8DAA8D,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAClF,CAAC;AAEN,gGAAgG;AAChG,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,qGAAqG;AACrG,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;QACzB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,cAAc,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjE,iEAAiE;IACjE,QAAQ,EAAE,OAAO,CAAC;IAClB,wGAAwG;IACxG,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,6FAA6F;AAC7F,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,gHAAgH;AAChH,eAAO,MAAM,WAAW,qNAWd,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,eAAO,MAAM,cAAc,wCAAyC,CAAC;AACrE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/gateway/types/patrollers.js

@@ -0,0 +1,15 @@
+/** Tipos de alerta que el usuario puede configurar (`userConfigurable` en el AlertTypeRegistry del backend). */
+export const ALERT_TYPES = [
+    'pending_route',
+    'missed_route',
+    'upcoming_deadline',
+    'patroller_inactive',
+    'suspicious_scan',
+    'role_assignment',
+    'incident_created',
+    'incident_status_changed',
+    'incident_assigned',
+    'incident_comment',
+];
+export const ALERT_CHANNELS = ['email', 'push', 'whatsapp'];
+//# sourceMappingURL=patrollers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"patrollers.js","sourceRoot":"","sources":["../../../src/gateway/types/patrollers.ts"],"names":[],"mappings":"AAmEA,gHAAgH;AAChH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,eAAe;IACf,cAAc;IACd,mBAAmB;IACnB,oBAAoB;IACpB,iBAAiB;IACjB,iBAAiB;IACjB,kBAAkB;IAClB,yBAAyB;IACzB,mBAAmB;IACnB,kBAAkB;CACV,CAAC;AAGX,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAU,CAAC"}