@patroltech/agent-capabilities 0.0.0-stage → 0.2.1

package/dist/domain/guard-app-message.d.ts

@@ -0,0 +1,15 @@
+import { type FixedTextLanguage } from './language.js';
+/**
+ * Mensaje listo para que el administrador se lo reenvíe al vigilante (por
+ * WhatsApp o email): qué es, su enlace personal y cómo instalar o abrir la app.
+ * El bot no puede enviárselo al vigilante (el backend no tiene esa vía), así
+ * que se lo deja preparado al administrador.
+ *
+ * Solo hechos comprobados del producto: app «Patrol Tech Scan» en Google
+ * Play; con ella instalada el enlace abre la app con el vigilante ya elegido y
+ * basta pulsar «Iniciar Sesión»; en iPhone no hay app y se usa la web desde el
+ * navegador, añadida a la pantalla de inicio; permisos obligatorios Cámara,
+ * Ubicación y Notificaciones.
+ */
+export declare function guardAppMessage(vigilante: string, enlace: string, idioma: FixedTextLanguage): string;
+//# sourceMappingURL=guard-app-message.d.ts.map

package/dist/domain/guard-app-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard-app-message.d.ts","sourceRoot":"","sources":["../../src/domain/guard-app-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEpE;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,iBAAiB,GACxB,MAAM,CAwBR"}

package/dist/domain/guard-app-message.js

@@ -0,0 +1,39 @@
+import { segunIdioma } from './language.js';
+/**
+ * Mensaje listo para que el administrador se lo reenvíe al vigilante (por
+ * WhatsApp o email): qué es, su enlace personal y cómo instalar o abrir la app.
+ * El bot no puede enviárselo al vigilante (el backend no tiene esa vía), así
+ * que se lo deja preparado al administrador.
+ *
+ * Solo hechos comprobados del producto: app «Patrol Tech Scan» en Google
+ * Play; con ella instalada el enlace abre la app con el vigilante ya elegido y
+ * basta pulsar «Iniciar Sesión»; en iPhone no hay app y se usa la web desde el
+ * navegador, añadida a la pantalla de inicio; permisos obligatorios Cámara,
+ * Ubicación y Notificaciones.
+ */
+export function guardAppMessage(vigilante, enlace, idioma) {
+    return segunIdioma(idioma, {
+        es: [
+            `Hola ${vigilante}, te paso tu acceso a PatrolTech, la app con la que escanearás los puntos de control en tus rondas.`,
+            `Tu enlace personal (no lo compartas): ${enlace}`,
+            '- Android: instala «Patrol Tech Scan» desde Google Play y después abre el enlace: se abre la app con tu nombre ya elegido; solo tienes que pulsar «Iniciar Sesión».',
+            '- iPhone: no hay app en la App Store; abre el enlace en el navegador y añádelo a la pantalla de inicio desde el menú del navegador.',
+            'Al entrar, concede los permisos de Cámara, Ubicación y Notificaciones.',
+        ],
+        en: [
+            `Hi ${vigilante}, this is your access to PatrolTech, the app you'll use to scan the checkpoints on your rounds.`,
+            `Your personal link (don't share it): ${enlace}`,
+            '- Android: install «Patrol Tech Scan» from Google Play, then open the link: it opens the app with your name already selected; just tap the sign-in button.',
+            "- iPhone: there's no App Store app; open the link in the browser and add it to your home screen from the browser menu.",
+            'When you sign in, allow Camera, Location and Notifications.',
+        ],
+        fr: [
+            `Bonjour ${vigilante}, voici votre accès à PatrolTech, l'application avec laquelle vous scannerez les points de contrôle pendant vos rondes.`,
+            `Votre lien personnel (ne le partagez pas) : ${enlace}`,
+            "- Android : installez «Patrol Tech Scan» depuis Google Play, puis ouvrez le lien : l'application s'ouvre avec votre nom déjà sélectionné ; il suffit d'appuyer sur le bouton de connexion.",
+            "- iPhone : il n'y a pas d'application sur l'App Store ; ouvrez le lien dans le navigateur et ajoutez-le à l'écran d'accueil depuis le menu du navigateur.",
+            'À la connexion, autorisez la Caméra, la Localisation et les Notifications.',
+        ],
+    }).join('\n');
+}
+//# sourceMappingURL=guard-app-message.js.map

package/dist/domain/guard-app-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard-app-message.js","sourceRoot":"","sources":["../../src/domain/guard-app-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA0B,MAAM,eAAe,CAAC;AAEpE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAC7B,SAAiB,EACjB,MAAc,EACd,MAAyB;IAEzB,OAAO,WAAW,CAAC,MAAM,EAAE;QACzB,EAAE,EAAE;YACF,QAAQ,SAAS,qGAAqG;YACtH,yCAAyC,MAAM,EAAE;YACjD,qKAAqK;YACrK,qIAAqI;YACrI,wEAAwE;SACzE;QACD,EAAE,EAAE;YACF,MAAM,SAAS,iGAAiG;YAChH,wCAAwC,MAAM,EAAE;YAChD,4JAA4J;YAC5J,wHAAwH;YACxH,6DAA6D;SAC9D;QACD,EAAE,EAAE;YACF,WAAW,SAAS,yHAAyH;YAC7I,+CAA+C,MAAM,EAAE;YACvD,4LAA4L;YAC5L,2JAA2J;YAC3J,4EAA4E;SAC7E;KACF,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/domain/incident-priority.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Prioridades de una incidencia (códigos de la API) con su nombre en el panel y en los
+ * parámetros/campos en inglés del canal MCP. Interno: no se exporta desde el paquete.
+ */
+export declare const INCIDENT_PRIORITIES: {
+    readonly LOW: {
+        readonly es: "Baja";
+        readonly en: "low";
+    };
+    readonly MEDIUM: {
+        readonly es: "Media";
+        readonly en: "medium";
+    };
+    readonly HIGH: {
+        readonly es: "Alta";
+        readonly en: "high";
+    };
+    readonly CRITICAL: {
+        readonly es: "Crítica";
+        readonly en: "critical";
+    };
+};
+/** El nombre en el panel de una prioridad, o el código tal cual si es otro. */
+export declare function incidentPriorityLabel(code: string): string;
+//# sourceMappingURL=incident-priority.d.ts.map

package/dist/domain/incident-priority.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incident-priority.d.ts","sourceRoot":"","sources":["../../src/domain/incident-priority.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;CAK+B,CAAC;AAEhE,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D"}

package/dist/domain/incident-priority.js

@@ -0,0 +1,15 @@
+/**
+ * Prioridades de una incidencia (códigos de la API) con su nombre en el panel y en los
+ * parámetros/campos en inglés del canal MCP. Interno: no se exporta desde el paquete.
+ */
+export const INCIDENT_PRIORITIES = {
+    LOW: { es: 'Baja', en: 'low' },
+    MEDIUM: { es: 'Media', en: 'medium' },
+    HIGH: { es: 'Alta', en: 'high' },
+    CRITICAL: { es: 'Crítica', en: 'critical' },
+};
+/** El nombre en el panel de una prioridad, o el código tal cual si es otro. */
+export function incidentPriorityLabel(code) {
+    return INCIDENT_PRIORITIES[code]?.es ?? code;
+}
+//# sourceMappingURL=incident-priority.js.map

package/dist/domain/incident-priority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"incident-priority.js","sourceRoot":"","sources":["../../src/domain/incident-priority.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,GAAG,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE;IAC9B,MAAM,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE;IACrC,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE;IAChC,QAAQ,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE;CACkB,CAAC;AAEhE,+EAA+E;AAC/E,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAQ,mBAAkE,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,IAAI,CAAC;AAC/F,CAAC"}

package/dist/domain/incident-status.d.ts

@@ -0,0 +1,29 @@
+import type { FixedTextLanguage } from './language.js';
+/**
+ * Estados y reglas de una incidencia, los mismos que aplica la API, para explicarle al
+ * cliente ANTES de proponer por qué un cambio no se puede hacer. El backend
+ * sigue siendo quien decide.
+ */
+export declare const INCIDENT_STATUSES: readonly ["OPEN", "IN_PROGRESS", "RESOLVED", "DISCARDED", "CLOSED"];
+export type IncidentStatus = (typeof INCIDENT_STATUSES)[number];
+/** Nombres de los estados tal como salen en el panel (i18n `incidentReporting.status`). */
+export declare const INCIDENT_STATUS_LABELS: Record<IncidentStatus, Record<FixedTextLanguage, string>>;
+/** Cómo se nombra cada estado en los parámetros de las tools (en español, sin espacios). */
+export declare const INCIDENT_STATUS_PARAM: {
+    readonly abierto: "OPEN";
+    readonly en_progreso: "IN_PROGRESS";
+    readonly resuelto: "RESOLVED";
+    readonly cerrado: "CLOSED";
+    readonly descartado: "DISCARDED";
+};
+export type IncidentStatusParam = keyof typeof INCIDENT_STATUS_PARAM;
+export declare const INCIDENT_STATUS_PARAMS: [IncidentStatusParam, ...IncidentStatusParam[]];
+/** `ALLOWED_TRANSITIONS` del backend. */
+export declare const INCIDENT_TRANSITIONS: Record<IncidentStatus, readonly IncidentStatus[]>;
+/** Resolver y descartar exigen comentario (`requiresComment`). */
+export declare const INCIDENT_REQUIRES_COMMENT: readonly IncidentStatus[];
+/** Pasar a En progreso exige que esté asignada (`requiresAssignment`). */
+export declare const INCIDENT_REQUIRES_ASSIGNMENT: readonly IncidentStatus[];
+/** Cerrado y Descartado son definitivos: después no se puede cambiar nada (`isIncidentLocked`). */
+export declare const INCIDENT_FINAL: readonly IncidentStatus[];
+//# sourceMappingURL=incident-status.d.ts.map

package/dist/domain/incident-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incident-status.d.ts","sourceRoot":"","sources":["../../src/domain/incident-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,qEAMpB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,2FAA2F;AAC3F,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAM5F,CAAC;AAEF,4FAA4F;AAC5F,eAAO,MAAM,qBAAqB;;;;;;CAMiB,CAAC;AACpD,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,qBAAqB,CAAC;AACrE,eAAO,MAAM,sBAAsB,EAAyC,CAC1E,mBAAmB,EACnB,GAAG,mBAAmB,EAAE,CACzB,CAAC;AAEF,yCAAyC;AACzC,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,cAAc,EAAE,SAAS,cAAc,EAAE,CAMlF,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,yBAAyB,EAAE,SAAS,cAAc,EAA8B,CAAC;AAE9F,0EAA0E;AAC1E,eAAO,MAAM,4BAA4B,EAAE,SAAS,cAAc,EAAoB,CAAC;AAEvF,mGAAmG;AACnG,eAAO,MAAM,cAAc,EAAE,SAAS,cAAc,EAA4B,CAAC"}

package/dist/domain/incident-status.js

@@ -0,0 +1,44 @@
+/**
+ * Estados y reglas de una incidencia, los mismos que aplica la API, para explicarle al
+ * cliente ANTES de proponer por qué un cambio no se puede hacer. El backend
+ * sigue siendo quien decide.
+ */
+export const INCIDENT_STATUSES = [
+    'OPEN',
+    'IN_PROGRESS',
+    'RESOLVED',
+    'DISCARDED',
+    'CLOSED',
+];
+/** Nombres de los estados tal como salen en el panel (i18n `incidentReporting.status`). */
+export const INCIDENT_STATUS_LABELS = {
+    OPEN: { es: 'Abierto', en: 'Open', fr: 'Ouvert' },
+    IN_PROGRESS: { es: 'En progreso', en: 'In Progress', fr: 'En cours' },
+    RESOLVED: { es: 'Resuelto', en: 'Resolved', fr: 'Résolu' },
+    CLOSED: { es: 'Cerrado', en: 'Closed', fr: 'Clôturé' },
+    DISCARDED: { es: 'Descartado', en: 'Discarded', fr: 'Rejeté' },
+};
+/** Cómo se nombra cada estado en los parámetros de las tools (en español, sin espacios). */
+export const INCIDENT_STATUS_PARAM = {
+    abierto: 'OPEN',
+    en_progreso: 'IN_PROGRESS',
+    resuelto: 'RESOLVED',
+    cerrado: 'CLOSED',
+    descartado: 'DISCARDED',
+};
+export const INCIDENT_STATUS_PARAMS = Object.keys(INCIDENT_STATUS_PARAM);
+/** `ALLOWED_TRANSITIONS` del backend. */
+export const INCIDENT_TRANSITIONS = {
+    OPEN: ['IN_PROGRESS', 'DISCARDED'],
+    IN_PROGRESS: ['RESOLVED', 'OPEN', 'DISCARDED'],
+    RESOLVED: ['CLOSED', 'IN_PROGRESS'],
+    DISCARDED: [],
+    CLOSED: [],
+};
+/** Resolver y descartar exigen comentario (`requiresComment`). */
+export const INCIDENT_REQUIRES_COMMENT = ['RESOLVED', 'DISCARDED'];
+/** Pasar a En progreso exige que esté asignada (`requiresAssignment`). */
+export const INCIDENT_REQUIRES_ASSIGNMENT = ['IN_PROGRESS'];
+/** Cerrado y Descartado son definitivos: después no se puede cambiar nada (`isIncidentLocked`). */
+export const INCIDENT_FINAL = ['CLOSED', 'DISCARDED'];
+//# sourceMappingURL=incident-status.js.map

package/dist/domain/incident-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"incident-status.js","sourceRoot":"","sources":["../../src/domain/incident-status.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,MAAM;IACN,aAAa;IACb,UAAU;IACV,WAAW;IACX,QAAQ;CACA,CAAC;AAGX,2FAA2F;AAC3F,MAAM,CAAC,MAAM,sBAAsB,GAA8D;IAC/F,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE;IACjD,WAAW,EAAE,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,UAAU,EAAE;IACrE,QAAQ,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE;IAC1D,MAAM,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE;IACtD,SAAS,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAE;CAC/D,CAAC;AAEF,4FAA4F;AAC5F,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,OAAO,EAAE,MAAM;IACf,WAAW,EAAE,aAAa;IAC1B,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,WAAW;CAC0B,CAAC;AAEpD,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAGtE,CAAC;AAEF,yCAAyC;AACzC,MAAM,CAAC,MAAM,oBAAoB,GAAsD;IACrF,IAAI,EAAE,CAAC,aAAa,EAAE,WAAW,CAAC;IAClC,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC;IAC9C,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC;IACnC,SAAS,EAAE,EAAE;IACb,MAAM,EAAE,EAAE;CACX,CAAC;AAEF,kEAAkE;AAClE,MAAM,CAAC,MAAM,yBAAyB,GAA8B,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AAE9F,0EAA0E;AAC1E,MAAM,CAAC,MAAM,4BAA4B,GAA8B,CAAC,aAAa,CAAC,CAAC;AAEvF,mGAAmG;AACnG,MAAM,CAAC,MAAM,cAAc,GAA8B,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC"}

package/dist/domain/language.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Idioma BASE de un locale (`es_MX` → `es`, `en-US` → `en`).
+ *
+ * Hay canales que solo tienen textos por idioma base: se normaliza al guardar el
+ * idioma del contacto y al usarlo, para que el que se guarda y el que se usa sean
+ * el mismo.
+ */
+export declare function baseLanguage(language: string): string;
+export type ReplyLanguage = 'es' | 'en' | 'fr';
+/**
+ * Idioma de un texto del cliente, o `null` si es demasiado corto o no hay un
+ * ganador claro («Hi», «ok», «👍», un número, «de la»).
+ *
+ * Heurística por palabras funcionales + caracteres propios, sin
+ * dependencias. Techo: solo es/en/fr; frases de 1 palabra o de puro vocabulario
+ * técnico no deciden; textos mezclados deciden por mayoría simple; otros idiomas
+ * romances (pt, it, ca) pueden leerse como es/fr. Si hace falta más, un detector
+ * de n-gramas (franc/cld3) o preguntar a un modelo.
+ */
+export declare function detectLanguage(text: string): ReplyLanguage | null;
+/**
+ * Idioma en que debe ir la respuesta del bot: el del último mensaje del cliente;
+ * si ese no decide, el de sus últimos 3 mensajes juntos; si tampoco, el idioma
+ * (base) guardado del contacto; y, en último caso, español.
+ */
+export declare function resolveReplyLanguage(customerMessages: readonly string[], contactLanguage: string | null): ReplyLanguage;
+/**
+ * Idioma de los textos FIJOS del bot (los que no escribe el modelo: confirmación
+ * de una acción, errores del backend…). Hay versión en los tres idiomas de
+ * respuesta, así que es el mismo idioma en que contesta el modelo.
+ */
+export type FixedTextLanguage = ReplyLanguage;
+export declare function fixedTextLanguage(language: ReplyLanguage): FixedTextLanguage;
+/**
+ * El texto del idioma pedido. Con un `Record` el compilador exige los tres: un
+ * idioma nuevo no cae en silencio al de otro (lo que pasaba con `idioma === 'en' ? … : …`).
+ */
+export declare function segunIdioma<T>(idioma: FixedTextLanguage, textos: Record<FixedTextLanguage, T>): T;
+//# sourceMappingURL=language.d.ts.map

package/dist/domain/language.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language.d.ts","sourceRoot":"","sources":["../../src/domain/language.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AA+D/C;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAejE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,gBAAgB,EAAE,SAAS,MAAM,EAAE,EACnC,eAAe,EAAE,MAAM,GAAG,IAAI,GAC7B,aAAa,CAQf;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,aAAa,CAAC;AAE9C,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,GAAG,iBAAiB,CAE5E;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC,GAAG,CAAC,CAEjG"}

package/dist/domain/language.js

@@ -0,0 +1,112 @@
+/**
+ * Idioma BASE de un locale (`es_MX` → `es`, `en-US` → `en`).
+ *
+ * Hay canales que solo tienen textos por idioma base: se normaliza al guardar el
+ * idioma del contacto y al usarlo, para que el que se guarda y el que se usa sean
+ * el mismo.
+ */
+export function baseLanguage(language) {
+    return language.split(/[-_]/)[0].toLowerCase();
+}
+const SUPPORTED = ['es', 'en', 'fr'];
+// Palabras funcionales frecuentes y fórmulas de cortesía. Las que comparten dos
+// idiomas ("de", "la", "que", "no") puntúan en ambos y no deshacen empates.
+// "a" se deja fuera: es artículo en inglés, preposición en español y verbo en francés.
+const FUNCTION_WORDS = {
+    es: new Set(('el la los las un una unos unas de del al y o que en con por para sin sobre es son está están estoy estás hay ha he ' +
+        'tengo tiene tienes puedo puede quiero no sí yo tú usted mi mis tu su sus me te se nos le lo les este esta esto ese ' +
+        'esa eso pero como cómo qué cuál cuando cuándo donde dónde muy más también ya hola gracias buenos buenas días tardes ' +
+        'noches vale perdón disculpa favor ayuda bien funciona').split(' ')),
+    en: new Set(("the an and or of to in on at for with from by about is are was were be been am have has had do does did don't " +
+        "can can't cannot will would should could i i'm you your you're he she it it's we they my our their this that these " +
+        'those what which when where how why not no yes just but so if there here hi hello hey thanks thank please sorry ' +
+        'good morning way need help').split(' ')),
+    fr: new Set(('le la les un une des du de et ou que qui en dans avec pour par sur sans est sont suis êtes avons avez ai je tu il ' +
+        'elle nous vous ils elles mon ma mes ton ta votre vos notre ce cette ces mais pas ne oui non très aussi bonjour ' +
+        "bonsoir salut merci beaucoup plaît désolé comment pourquoi quand où c'est j'ai ça marche").split(' ')),
+};
+// Caracteres que delatan el idioma (una sola vez por texto, no por aparición).
+const CHAR_SIGNALS = {
+    es: /[ñ¿¡áíóú]/,
+    fr: /[çàèêœâîôûùëï]/,
+};
+const CHAR_SIGNAL_WEIGHT = 2;
+// Saludos que solo existen en un idioma: bastan solos para decidir («Hi» → inglés). Sin esto, un
+// «Hi» no llegaba al mínimo y ganaba el idioma guardado del contacto.
+const GREETINGS = {
+    es: new Set(['hola', 'buenas']),
+    en: new Set(['hi', 'hello', 'hey']),
+    fr: new Set(['bonjour', 'bonsoir', 'salut']),
+};
+/** Puntos mínimos para decidir: con menos, el texto no dice nada fiable («ok», «Gracias»). */
+const MIN_SCORE = 2;
+/**
+ * Quita lo que el SISTEMA escribe en español dentro de un mensaje del cliente
+ * (marcas de adjunto y la descripción de una imagen), que si no arrastraría la
+ * detección al español. La transcripción de un audio sí son palabras del
+ * cliente: se queda, sin su etiqueta.
+ */
+function customerWords(text) {
+    return text
+        .replace(/Contenido de la imagen:[\s\S]*?(?:<<\/adjunto_del_cliente>>|$)/g, ' ')
+        .replace(/Transcripción del audio:/g, ' ')
+        .replace(/<<\/?adjunto_del_cliente>>/g, ' ')
+        .replace(/\[El usuario ha (?:enviado|compartido)[^\]]*\]/g, ' ');
+}
+/**
+ * Idioma de un texto del cliente, o `null` si es demasiado corto o no hay un
+ * ganador claro («Hi», «ok», «👍», un número, «de la»).
+ *
+ * Heurística por palabras funcionales + caracteres propios, sin
+ * dependencias. Techo: solo es/en/fr; frases de 1 palabra o de puro vocabulario
+ * técnico no deciden; textos mezclados deciden por mayoría simple; otros idiomas
+ * romances (pt, it, ca) pueden leerse como es/fr. Si hace falta más, un detector
+ * de n-gramas (franc/cld3) o preguntar a un modelo.
+ */
+export function detectLanguage(text) {
+    const clean = customerWords(text).toLowerCase().replace(/[’`]/g, "'");
+    const scores = { es: 0, en: 0, fr: 0 };
+    for (const word of clean.match(/\p{L}+(?:'\p{L}+)*/gu) ?? []) {
+        for (const lang of SUPPORTED) {
+            if (GREETINGS[lang].has(word))
+                scores[lang] += MIN_SCORE;
+            else if (FUNCTION_WORDS[lang].has(word))
+                scores[lang] += 1;
+        }
+    }
+    if (CHAR_SIGNALS.es.test(clean))
+        scores.es += CHAR_SIGNAL_WEIGHT;
+    if (CHAR_SIGNALS.fr.test(clean))
+        scores.fr += CHAR_SIGNAL_WEIGHT;
+    const [first, second] = [...SUPPORTED].sort((a, b) => scores[b] - scores[a]);
+    if (scores[first] < MIN_SCORE || scores[first] === scores[second])
+        return null;
+    return first;
+}
+/**
+ * Idioma en que debe ir la respuesta del bot: el del último mensaje del cliente;
+ * si ese no decide, el de sus últimos 3 mensajes juntos; si tampoco, el idioma
+ * (base) guardado del contacto; y, en último caso, español.
+ */
+export function resolveReplyLanguage(customerMessages, contactLanguage) {
+    const last = customerMessages.at(-1);
+    const fromLast = last === undefined ? null : detectLanguage(last);
+    if (fromLast)
+        return fromLast;
+    const fromRecent = detectLanguage(customerMessages.slice(-3).join('\n'));
+    if (fromRecent)
+        return fromRecent;
+    const contact = contactLanguage ? baseLanguage(contactLanguage) : null;
+    return SUPPORTED.find((l) => l === contact) ?? 'es';
+}
+export function fixedTextLanguage(language) {
+    return language;
+}
+/**
+ * El texto del idioma pedido. Con un `Record` el compilador exige los tres: un
+ * idioma nuevo no cae en silencio al de otro (lo que pasaba con `idioma === 'en' ? … : …`).
+ */
+export function segunIdioma(idioma, textos) {
+    return textos[idioma];
+}
+//# sourceMappingURL=language.js.map

package/dist/domain/language.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language.js","sourceRoot":"","sources":["../../src/domain/language.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AACjD,CAAC;AAID,MAAM,SAAS,GAA6B,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAE/D,gFAAgF;AAChF,4EAA4E;AAC5E,uFAAuF;AACvF,MAAM,cAAc,GAA+C;IACjE,EAAE,EAAE,IAAI,GAAG,CACT,CACE,qHAAqH;QACrH,qHAAqH;QACrH,sHAAsH;QACtH,uDAAuD,CACxD,CAAC,KAAK,CAAC,GAAG,CAAC,CACb;IACD,EAAE,EAAE,IAAI,GAAG,CACT,CACE,gHAAgH;QAChH,qHAAqH;QACrH,kHAAkH;QAClH,4BAA4B,CAC7B,CAAC,KAAK,CAAC,GAAG,CAAC,CACb;IACD,EAAE,EAAE,IAAI,GAAG,CACT,CACE,oHAAoH;QACpH,iHAAiH;QACjH,0FAA0F,CAC3F,CAAC,KAAK,CAAC,GAAG,CAAC,CACb;CACF,CAAC;AAEF,+EAA+E;AAC/E,MAAM,YAAY,GAAiD;IACjE,EAAE,EAAE,WAAW;IACf,EAAE,EAAE,gBAAgB;CACrB,CAAC;AACF,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAC7B,iGAAiG;AACjG,sEAAsE;AACtE,MAAM,SAAS,GAA+C;IAC5D,EAAE,EAAE,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC/B,EAAE,EAAE,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACnC,EAAE,EAAE,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;CAC7C,CAAC;AACF,8FAA8F;AAC9F,MAAM,SAAS,GAAG,CAAC,CAAC;AAEpB;;;;;GAKG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI;SACR,OAAO,CAAC,iEAAiE,EAAE,GAAG,CAAC;SAC/E,OAAO,CAAC,2BAA2B,EAAE,GAAG,CAAC;SACzC,OAAO,CAAC,6BAA6B,EAAE,GAAG,CAAC;SAC3C,OAAO,CAAC,iDAAiD,EAAE,GAAG,CAAC,CAAC;AACrE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACtE,MAAM,MAAM,GAAkC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;IACtE,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,sBAAsB,CAAC,IAAI,EAAE,EAAE,CAAC;QAC7D,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;iBACpD,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IACD,IAAI,YAAY,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,MAAM,CAAC,EAAE,IAAI,kBAAkB,CAAC;IACjE,IAAI,YAAY,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,MAAM,CAAC,EAAE,IAAI,kBAAkB,CAAC;IAEjE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7E,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/E,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,gBAAmC,EACnC,eAA8B;IAE9B,MAAM,IAAI,GAAG,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAClE,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,UAAU,GAAG,cAAc,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACzE,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAClC,MAAM,OAAO,GAAG,eAAe,CAAC,CAAC,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACvE,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,IAAI,CAAC;AACtD,CAAC;AASD,MAAM,UAAU,iBAAiB,CAAC,QAAuB;IACvD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAI,MAAyB,EAAE,MAAoC;IAC5F,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC"}

package/dist/domain/money.d.ts

@@ -0,0 +1,3 @@
+/** «11 €», «250 US$» (con espacio normal: Intl pone uno duro). */
+export declare function importe(valor: number, moneda: string): string;
+//# sourceMappingURL=money.d.ts.map

package/dist/domain/money.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.d.ts","sourceRoot":"","sources":["../../src/domain/money.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAS7D"}

package/dist/domain/money.js

@@ -0,0 +1,12 @@
+/** «11 €», «250 US$» (con espacio normal: Intl pone uno duro). */
+export function importe(valor, moneda) {
+    return new Intl.NumberFormat('es-ES', {
+        style: 'currency',
+        currency: moneda,
+        minimumFractionDigits: 0,
+        maximumFractionDigits: 2,
+    })
+        .format(valor)
+        .replace(/\u00a0/g, ' ');
+}
+//# sourceMappingURL=money.js.map

package/dist/domain/money.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.js","sourceRoot":"","sources":["../../src/domain/money.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,MAAc;IACnD,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE;QACpC,KAAK,EAAE,UAAU;QACjB,QAAQ,EAAE,MAAM;QAChB,qBAAqB,EAAE,CAAC;QACxB,qBAAqB,EAAE,CAAC;KACzB,CAAC;SACC,MAAM,CAAC,KAAK,CAAC;SACb,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;AAC7B,CAAC"}

package/dist/domain/puesta-en-marcha.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Las cuatro lecturas del backend que hacen falta para saber en qué punto de la
+ * puesta en marcha está una organización. Es un puerto mínimo: cualquier cliente
+ * del backend que las ofrezca (el `PatrolTechClient` del bot, el gateway) lo cumple.
+ */
+export interface PuestaEnMarchaSource {
+    getSupportSummary(orgId: string, token: string): Promise<{
+        checkpoints: {
+            total: number;
+        };
+        patrollers: {
+            total: number;
+        };
+    }>;
+    listPatrollers(orgId: string, token: string): Promise<{
+        items: {
+            lastScanAt: string | null;
+        }[];
+    }>;
+    listRoutes(orgId: string, token: string): Promise<{
+        items: unknown[];
+    }>;
+    getRecentScans(orgId: string, token: string, opts: {
+        limit: number;
+    }): Promise<{
+        items: {
+            timestamp: string;
+        }[];
+    }>;
+}
+/** Hitos de la puesta en marcha de una organización, tal como los da el backend. */
+export interface PuestaEnMarcha {
+    checkpointsCreados: number;
+    vigilantes: number;
+    /** Vigilantes con algún escaneo: señal de que ya usan la app. */
+    vigilantesConAlgunEscaneo: number;
+    hayEscaneos: boolean;
+    ultimoEscaneo: string | null;
+    rutasCreadas: number;
+}
+/**
+ * Consulta al backend en qué punto de la puesta en marcha está la organización.
+ * La usan `consultar_puesta_en_marcha`, el siguiente paso tras cada acción y el
+ * nudge: los tres deciden con el mismo estado real. Lanza si el backend falla.
+ */
+export declare function leerPuestaEnMarcha(patrolTech: PuestaEnMarchaSource, orgId: string, token: string): Promise<PuestaEnMarcha>;
+//# sourceMappingURL=puesta-en-marcha.d.ts.map

package/dist/domain/puesta-en-marcha.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"puesta-en-marcha.d.ts","sourceRoot":"","sources":["../../src/domain/puesta-en-marcha.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,CACf,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,WAAW,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,UAAU,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IAC9E,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE;YAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,EAAE,CAAA;KAAE,CAAC,CAAC;IAClG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;IACxE,cAAc,CACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GACtB,OAAO,CAAC;QAAE,KAAK,EAAE;YAAE,SAAS,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,CAAC,CAAC;CAChD;AAED,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,yBAAyB,EAAE,MAAM,CAAC;IAClC,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,oBAAoB,EAChC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,cAAc,CAAC,CAezB"}

package/dist/domain/puesta-en-marcha.js

@@ -0,0 +1,22 @@
+/**
+ * Consulta al backend en qué punto de la puesta en marcha está la organización.
+ * La usan `consultar_puesta_en_marcha`, el siguiente paso tras cada acción y el
+ * nudge: los tres deciden con el mismo estado real. Lanza si el backend falla.
+ */
+export async function leerPuestaEnMarcha(patrolTech, orgId, token) {
+    const [resumen, vigilantes, rutas, escaneos] = await Promise.all([
+        patrolTech.getSupportSummary(orgId, token),
+        patrolTech.listPatrollers(orgId, token),
+        patrolTech.listRoutes(orgId, token),
+        patrolTech.getRecentScans(orgId, token, { limit: 1 }),
+    ]);
+    return {
+        checkpointsCreados: resumen.checkpoints.total,
+        vigilantes: resumen.patrollers.total,
+        vigilantesConAlgunEscaneo: vigilantes.items.filter((p) => p.lastScanAt).length,
+        hayEscaneos: escaneos.items.length > 0,
+        ultimoEscaneo: escaneos.items[0]?.timestamp ?? null,
+        rutasCreadas: rutas.items.length,
+    };
+}
+//# sourceMappingURL=puesta-en-marcha.js.map

package/dist/domain/puesta-en-marcha.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"puesta-en-marcha.js","sourceRoot":"","sources":["../../src/domain/puesta-en-marcha.ts"],"names":[],"mappings":"AA8BA;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAAgC,EAChC,KAAa,EACb,KAAa;IAEb,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC/D,UAAU,CAAC,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC;QAC1C,UAAU,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC;QACvC,UAAU,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC;QACnC,UAAU,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;KACtD,CAAC,CAAC;IACH,OAAO;QACL,kBAAkB,EAAE,OAAO,CAAC,WAAW,CAAC,KAAK;QAC7C,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,KAAK;QACpC,yBAAyB,EAAE,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM;QAC9E,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;QACtC,aAAa,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,SAAS,IAAI,IAAI;QACnD,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;KACjC,CAAC;AACJ,CAAC"}

package/dist/domain/qr-image.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Lado del PNG en píxeles: a 300 ppp son ~8,5 cm, de sobra para imprimir y
+ * pegar el QR junto al punto de control sin que se pixele.
+ */
+export declare const QR_IMAGE_SIZE_PX = 1024;
+export interface QrImage {
+    png: Buffer;
+    /** Pie para el mensaje: nombre del checkpoint y el código tal cual va en el QR. */
+    caption: string;
+}
+/**
+ * Imagen del QR de un checkpoint (el texto `PT-XXXXXXXXXX` o una URL) lista para
+ * imprimir, con el pie que la acompaña en el mensaje.
+ *
+ * `qrcode` sin canvas solo pinta el QR; escribir el nombre y el
+ * código al pie DENTRO del PNG exigiría una dependencia nativa (canvas) o una
+ * fuente de mapa de bits propia. El nombre y el código van en el `caption` del
+ * mensaje; si hace falta en la propia imagen, se compone aquí sin cambiar a
+ * los llamadores.
+ */
+export declare function checkpointQrImage(input: {
+    code: string;
+    name: string;
+}): Promise<QrImage>;
+//# sourceMappingURL=qr-image.d.ts.map

package/dist/domain/qr-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qr-image.d.ts","sourceRoot":"","sources":["../../src/domain/qr-image.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,mFAAmF;IACnF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAU/F"}

package/dist/domain/qr-image.js

@@ -0,0 +1,28 @@
+import { toBuffer } from 'qrcode';
+/**
+ * Lado del PNG en píxeles: a 300 ppp son ~8,5 cm, de sobra para imprimir y
+ * pegar el QR junto al punto de control sin que se pixele.
+ */
+export const QR_IMAGE_SIZE_PX = 1024;
+/**
+ * Imagen del QR de un checkpoint (el texto `PT-XXXXXXXXXX` o una URL) lista para
+ * imprimir, con el pie que la acompaña en el mensaje.
+ *
+ * `qrcode` sin canvas solo pinta el QR; escribir el nombre y el
+ * código al pie DENTRO del PNG exigiría una dependencia nativa (canvas) o una
+ * fuente de mapa de bits propia. El nombre y el código van en el `caption` del
+ * mensaje; si hace falta en la propia imagen, se compone aquí sin cambiar a
+ * los llamadores.
+ */
+export async function checkpointQrImage(input) {
+    const png = await toBuffer(input.code, {
+        type: 'png',
+        width: QR_IMAGE_SIZE_PX,
+        // Margen de 4 módulos: el mínimo que pide el estándar para que lea bien impreso.
+        margin: 4,
+        // M (~15 % recuperable): aguanta una pegatina algo rayada sin engordar el QR.
+        errorCorrectionLevel: 'M',
+    });
+    return { png, caption: `${input.name}\n${input.code}` };
+}
+//# sourceMappingURL=qr-image.js.map

package/dist/domain/qr-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qr-image.js","sourceRoot":"","sources":["../../src/domain/qr-image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAElC;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAQrC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAqC;IAC3E,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE;QACrC,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,gBAAgB;QACvB,iFAAiF;QACjF,MAAM,EAAE,CAAC;QACT,8EAA8E;QAC9E,oBAAoB,EAAE,GAAG;KAC1B,CAAC,CAAC;IACH,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;AAC1D,CAAC"}

package/dist/domain/resolve-by-name.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Forma comparable de un nombre: sin tildes, sin mayúsculas y con los espacios
+ * colapsados. Por WhatsApp escriben «almacen norte» para «Almacén Norte».
+ */
+export declare function normalizeName(s: string): string;
+/**
+ * Resolución de un nombre dicho por el usuario (organización, vigilante, ruta)
+ * contra la lista de elementos a los que tiene acceso.
+ *
+ * Reglas, en este orden: cadena vacía = NO resuelto; coincidencia exacta del
+ * nombre (sin distinguir mayúsculas, tildes ni espacios repetidos: `normalizeName`);
+ * identificador exacto (cuando el llamador sabe mapearlo, p. ej. el id que
+ * devuelve un botón de WhatsApp); índice numérico
+ * 1-based ("2"); y por último substring. Un substring que casa con más de un
+ * elemento es AMBIGUO y se devuelve como tal: coger el primero en silencio hacía
+ * que "Vigilancia" con Madrid y Barcelona respondiera con los datos de Madrid
+ * sin que nadie se enterase.
+ */
+export type NameMatch<T> = {
+    kind: 'found';
+    item: T;
+} | {
+    kind: 'none';
+} | {
+    kind: 'ambiguous';
+    matches: T[];
+};
+export declare function resolveByName<T>(input: string, items: readonly T[], nameOf: (item: T) => string, opts?: {
+    byIndex?: boolean;
+    idOf?: (item: T) => string;
+}): NameMatch<T>;
+//# sourceMappingURL=resolve-by-name.d.ts.map

package/dist/domain/resolve-by-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-by-name.d.ts","sourceRoot":"","sources":["../../src/domain/resolve-by-name.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IACrB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,CAAC,EAAE,CAAA;CAAE,CAAC;AAEtF,wBAAgB,aAAa,CAAC,CAAC,EAC7B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAC3B,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAA;CAAO,GAC3D,SAAS,CAAC,CAAC,CAAC,CA4Bd"}

package/dist/domain/resolve-by-name.js

@@ -0,0 +1,40 @@
+/**
+ * Forma comparable de un nombre: sin tildes, sin mayúsculas y con los espacios
+ * colapsados. Por WhatsApp escriben «almacen norte» para «Almacén Norte».
+ */
+export function normalizeName(s) {
+    return s.normalize('NFD').replace(/\p{M}/gu, '').toLowerCase().replace(/\s+/g, ' ').trim();
+}
+export function resolveByName(input, items, nameOf, opts = {}) {
+    const trimmed = input.trim();
+    // Vacío no resuelve: `''.includes('')` es true y devolvía SIEMPRE el primero.
+    if (!trimmed)
+        return { kind: 'none' };
+    const lower = normalizeName(trimmed);
+    const nombre = (item) => normalizeName(nameOf(item));
+    const exact = items.filter((item) => nombre(item) === lower);
+    if (exact.length === 1)
+        return { kind: 'found', item: exact[0] };
+    if (exact.length > 1)
+        return { kind: 'ambiguous', matches: exact };
+    if (opts.idOf) {
+        const byId = items.filter((item) => opts.idOf(item).toLowerCase() === trimmed.toLowerCase());
+        if (byId.length === 1)
+            return { kind: 'found', item: byId[0] };
+    }
+    // El índice va DESPUÉS del nombre exacto: una organización llamada "2" era
+    // inalcanzable por su nombre mientras hubiera dos o más (M2). Un índice fuera
+    // de rango NO corta la resolución: "2024" puede ser parte de un nombre.
+    if (opts.byIndex && /^\d+$/.test(trimmed)) {
+        const idx = Number(trimmed) - 1;
+        if (idx >= 0 && idx < items.length)
+            return { kind: 'found', item: items[idx] };
+    }
+    const contains = items.filter((item) => nombre(item).includes(lower));
+    if (contains.length === 1)
+        return { kind: 'found', item: contains[0] };
+    if (contains.length > 1)
+        return { kind: 'ambiguous', matches: contains };
+    return { kind: 'none' };
+}
+//# sourceMappingURL=resolve-by-name.js.map

package/dist/domain/resolve-by-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-by-name.js","sourceRoot":"","sources":["../../src/domain/resolve-by-name.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,CAAS;IACrC,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC7F,CAAC;AAkBD,MAAM,UAAU,aAAa,CAC3B,KAAa,EACb,KAAmB,EACnB,MAA2B,EAC3B,OAA0D,EAAE;IAE5D,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,8EAA8E;IAC9E,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,CAAC,IAAO,EAAU,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAEhE,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC;IAC7D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAEnE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAK,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9F,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,CAAC;IAED,2EAA2E;IAC3E,8EAA8E;IAC9E,wEAAwE;IACxE,IAAI,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,GAAG,KAAK,CAAC,MAAM;YAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IACjF,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IACzE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1B,CAAC"}