xonecode 0.35.0 → 0.36.3

package/dist/core/tunel.js

@@ -0,0 +1,92 @@
+/**
+ * El túnel de ngrok para la sesión remota: las reglas SIN efectos. Quien lanza el proceso es
+ * `agent/remoto/`; aquí solo se lee su log, se compone la dirección del puente y se dicen
+ * los fallos con texto FIJO nuestro.
+ *
+ * **Nada de lo que ngrok escribe cruza el cable.** Su salida lleva la ruta de la configuración,
+ * el correo de la cuenta y, en un error de autenticación, el authtoken tecleado: por eso el
+ * motivo de un fallo se decide por su CÓDIGO (`ERR_NGROK_xxx`) y lo que se enseña es una
+ * entrada de `MOTIVOS_DEL_TUNEL`, nunca la línea. Las líneas de los tests son salida real de
+ * ngrok v3 (`src/core/__oro__/ngrok-v3*.jsonl`), con la ruta, el correo y el token redactados.
+ */
+/** Texto fijo por causa. Es lo ÚNICO que sale de un fallo del túnel hacia el cable. */
+export const MOTIVOS_DEL_TUNEL = {
+    noInstalado: "ngrok no está instalado en esta máquina.",
+    autenticacion: "ngrok no acepta el authtoken (falta o no es válido).",
+    dominio: "ngrok no deja usar ese dominio: no es de tu cuenta, o tu plan no admite dominios propios.",
+    otraSesion: "Ya hay otro ngrok de tu cuenta abierto (en esta máquina o en otra): ciérralo y vuelve a encender.",
+    sinDireccion: "ngrok no dio una dirección pública a tiempo.",
+    seCerro: "ngrok se cerró.",
+    paqueteViejo: "El paquete de la sesión remota instalado no trae el puente: actualízalo.",
+    otro: "ngrok falló y no se pudo abrir el túnel.",
+    puente: "No se pudo arrancar el puente local de la sesión remota.",
+    authtokenSinForma: "Eso no tiene la forma de un authtoken de ngrok.",
+    authtokenNoGuardado: "ngrok no pudo guardar el authtoken.",
+};
+/**
+ * La dirección pública que ngrok anuncia al levantar el túnel: la línea JSON de `msg:
+ * "started tunnel"` (con `--log stdout --log-format json`) trae un `url`. Cualquier otra línea,
+ * o un túnel que no sea https, es `undefined`. No se lee de la API local (4040), que se mueve
+ * si el puerto está ocupado.
+ */
+export function urlPublicaDeLinea(linea) {
+    if (!linea.startsWith("{"))
+        return undefined;
+    let o;
+    try {
+        o = JSON.parse(linea);
+    }
+    catch {
+        return undefined;
+    }
+    if (typeof o !== "object" || o === null)
+        return undefined;
+    const { msg, url } = o;
+    if (msg !== "started tunnel" || typeof url !== "string")
+        return undefined;
+    return url.startsWith("https://") ? url : undefined;
+}
+/** `https://host` → `wss://host/ws`: el puente de la sesión remota atiende el WebSocket en `/ws`. */
+export function servidorDeTunel(https) {
+    const url = new URL(https);
+    if (url.protocol !== "https:")
+        throw new Error("la dirección del túnel tiene que ser https");
+    return `wss://${url.host}/ws`;
+}
+const ETIQUETA = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/;
+/** Un nombre de host con al menos un punto: sin esquema, ruta, puerto ni espacios. */
+export function motivoDeDominioInaceptable(dominio) {
+    if (typeof dominio !== "string" || dominio === "")
+        return "el dominio está vacío";
+    if (dominio.length > 253)
+        return "el dominio es demasiado largo";
+    const etiquetas = dominio.toLowerCase().split(".");
+    if (etiquetas.length < 2)
+        return "el dominio tiene que ser un nombre completo, como mi-app.ngrok.app";
+    if (!etiquetas.every((e) => e.length <= 63 && ETIQUETA.test(e))) {
+        return "el dominio es solo el nombre de host: sin https://, sin ruta, sin puerto";
+    }
+    return undefined;
+}
+// Medido: 105 es el authtoken que no parece uno, 313 el dominio que el plan o la cuenta no
+// permite. Los demás de cada grupo son los de la documentación de ngrok para el mismo fallo.
+// 108 (límite de sesiones simultáneas) y 334 (el endpoint ya está en línea) NO son ni token ni
+// dominio: es otro ngrok de la cuenta abierto —un huérfano de un cierre en seco, por ejemplo—.
+const CODIGOS_DE_AUTENTICACION = new Set(["105", "106", "107", "4018"]);
+const CODIGOS_DE_DOMINIO = new Set(["313", "314", "337"]);
+const CODIGOS_DE_OTRA_SESION = new Set(["108", "334"]);
+/** Por qué se cerró ngrok, mirando solo el CÓDIGO `ERR_NGROK_xxx` de sus líneas, nunca su texto. */
+export function motivoDeSalidaDeNgrok(lineas) {
+    for (const linea of lineas) {
+        for (const m of linea.matchAll(/ERR_NGROK_(\d+)/g)) {
+            if (CODIGOS_DE_AUTENTICACION.has(m[1]))
+                return "autenticacion";
+            if (CODIGOS_DE_DOMINIO.has(m[1]))
+                return "dominio";
+            if (CODIGOS_DE_OTRA_SESION.has(m[1]))
+                return "otraSesion";
+        }
+    }
+    return "otro";
+}
+//# sourceMappingURL=tunel.js.map

package/dist/core/tunel.js.map

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