@hostwebhook/platform-contracts 0.11.0 → 0.12.0

package/dist/servicios/tuneles.d.ts

@@ -69,7 +69,24 @@ export interface TunelLocal {
      * `getOrCreate`, y hay que conservarlo: devolver una dirección que no
      * escucha convertiría un error claro en un timeout del driver.
      */
-    direccionLocalPara(tunnelId: string, host: string, port: number): Promise<DireccionLocal>;
+    /**
+     * @param orgId La organización dueña del túnel.
+     *
+     * 🔥 No es un parámetro de comodidad: es la autorización.
+     *
+     * Mientras esto se resolvía dentro del propio api, el `tunnelId` bastaba —
+     * quien lo tenía en la mano ya había pasado por la puerta que lo sacó de su
+     * propia credencial. Ahora la dirección la da hw-tunnels por HTTP, y ese
+     * servicio no tiene forma de saber quién pregunta: sin `orgId` no puede
+     * comprobar que el túnel es tuyo, así que su `/interno/direccion-tcp`
+     * contesta 400 y NO adivina.
+     *
+     * ⚠️ Va aquí y no como un campo del túnel porque el que autoriza es el que
+     * PREGUNTA, no el preguntado. Con el `orgId` sacado de la fila del túnel, la
+     * comprobación sería «este túnel pertenece a su propio dueño», que es cierta
+     * siempre y no protege de nada.
+     */
+    direccionLocalPara(tunnelId: string, orgId: string, host: string, port: number): Promise<DireccionLocal>;
 }
 /** Lo llama `tunnels/monta-el-tunel-local.ts` al arrancar. */
 export declare function registrarTunelLocal(t: TunelLocal): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hostwebhook/platform-contracts",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Contratos compartidos entre los servicios de HostWebhook: addons del plan, identidad interna, y las formas que cruzan una frontera de red",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",