@hostwebhook/node-sdk 0.6.0 → 0.7.0

package/dist/credential-references.d.ts

@@ -37,23 +37,70 @@ export type CredRefShape =
 {
     kind: 'scalar';
     path: string;
+    soloLectura?: boolean;
 }
 /** `extraCredentialIds: ObjectId[]` */
  | {
     kind: 'array';
     path: string;
+    soloLectura?: boolean;
 }
 /** `credentialIds: { plataforma: id | id[] }` */
  | {
     kind: 'map';
     path: string;
+    soloLectura?: boolean;
+}
+/**
+ * `tools: [{ credentialId, ... }]` — un array de OBJETOS, cada uno con su
+ * propia referencia. No es `array`: ahí los elementos SON el id.
+ *
+ * ⚠️ `campo` no es opcional a propósito. Una forma que no dice dónde mirar
+ * dentro del objeto no puede mirar en ningún sitio, y el fallo sería
+ * silencioso: `formasQueReferencian` devolvería vacío y el documento pasaría
+ * por «no usa esta credencial».
+ */
+ | {
+    kind: 'arrayDeObjetos';
+    path: string;
+    campo: string;
+    soloLectura?: boolean;
 };
 /**
- * Las cinco formas que existen hoy.
+ * Las nueve formas que existen hoy.
  *
  * Se barren en TODAS las colecciones de nodos, no sólo en las que declaran el
  * campo: una consulta por un campo que la colección no tiene simplemente no
  * devuelve nada, y así añadir el campo a otro nodo no obliga a tocar esta lista.
+ *
+ * ## Las cuatro que faltaban, y lo que costaban
+ *
+ * Eran cinco, y se quedaban cortas exactamente igual que la versión anterior a
+ * ésta — aquélla miraba dos campos escritos a mano en la consulta, y por eso
+ * nació este fichero. Las que faltaban:
+ *
+ *   `tools[].credentialId`          las credenciales de las TOOLS del AI Node:
+ *                                   toda tool MCP y todo puente de audio
+ *   `audioTranscribeCredentialId`   el puente de transcripción del AI Node
+ *   `embedding.credentialId`        la clave que paga cada `embed` del vector store
+ *   `backend.config.credentialId`   la conexión del backend del vector store
+ *   `results[].credentialId`        a qué cuenta se publicó cada fila de un post
+ *
+ * Consecuencia medible y VIVA: `findConsumers` usa esta misma lista, así que
+ * borrar una credencial `mcp_server` usada sólo por una tool encontraba CERO
+ * consumidores — ni 409, ni desatachado, ni marcador. La credencial
+ * desaparecía y el nodo se quedaba con un id que ya no resuelve. Es el mismo
+ * fallo por el que se perdió la de Mastodon el 12-ago, con otro campo.
+ *
+ * ## ⚠️ `soloLectura`: referenciar no es lo mismo que desatachar
+ *
+ * `results[]` de un post es un REGISTRO HISTÓRICO: dice a qué cuenta se
+ * publicó cada fila. Tiene que contar para encontrar consumidores —que salte
+ * el 409— pero reescribirlo al desatachar sería falsear lo que pasó: una
+ * publicación que SÍ ocurrió quedaría sin decir con qué cuenta.
+ *
+ * Sin esta marca, ampliar la lista habría arreglado el borrado silencioso y
+ * roto el historial en el mismo movimiento.
  */
 export declare const CREDENTIAL_REF_SHAPES: readonly CredRefShape[];
 /** Lee un camino con puntos. Devuelve `undefined` si algo del medio falta. */
@@ -65,7 +112,7 @@ export declare function leerCamino(doc: unknown, path: string): unknown;
  * formas conviven en datos reales (`credentialIds` está declarado como
  * `Record<string, string[] | string>` justamente por eso).
  */
-export declare function valorReferencia(valor: unknown, id: string, kind: CredRefShape['kind']): boolean;
+export declare function valorReferencia(valor: unknown, id: string, forma: CredRefShape): boolean;
 /** Las formas por las que ESTE documento referencia la credencial. */
 export declare function formasQueReferencian(doc: Record<string, unknown>, id: string): CredRefShape[];
 /**
@@ -78,7 +125,7 @@ export declare function formasQueReferencian(doc: Record<string, unknown>, id: s
  * con `[]` haría que el trigger siguiera anunciando que vigila Mastodon sin
  * ninguna cuenta con la que hacerlo.
  */
-export declare function valorTrasDesatacar(valor: unknown, id: string, kind: CredRefShape['kind']): unknown;
+export declare function valorTrasDesatacar(valor: unknown, id: string, forma: CredRefShape): unknown;
 /**
  * Los dos campos que `credentials.service.remove` escribe en cada nodo que se
  * queda huérfano, para que la pantalla pueda decir QUÉ credencial era y
@@ -88,7 +135,7 @@ export declare const CAMPOS_MARCADOR_DETACH: readonly ["credentialDetachedAt", "
 /** El `$unset` que los quita. */
 export declare const UNSET_MARCADOR_DETACH: Record<string, ''>;
 /** ¿Este valor trae al menos una credencial puesta? */
-export declare function valorTieneCredencial(valor: unknown, kind: CredRefShape['kind']): boolean;
+export declare function valorTieneCredencial(valor: unknown, forma: CredRefShape): boolean;
 /**
  * ¿El nodo tiene AHORA alguna credencial, por cualquiera de las cinco formas?
  *

package/dist/credential-references.js

@@ -43,11 +43,40 @@ exports.tieneAlgunaCredencial = tieneAlgunaCredencial;
 exports.marcadorEsFosil = marcadorEsFosil;
 exports.dtoTocaCredencial = dtoTocaCredencial;
 /**
- * Las cinco formas que existen hoy.
+ * Las nueve formas que existen hoy.
  *
  * Se barren en TODAS las colecciones de nodos, no sólo en las que declaran el
  * campo: una consulta por un campo que la colección no tiene simplemente no
  * devuelve nada, y así añadir el campo a otro nodo no obliga a tocar esta lista.
+ *
+ * ## Las cuatro que faltaban, y lo que costaban
+ *
+ * Eran cinco, y se quedaban cortas exactamente igual que la versión anterior a
+ * ésta — aquélla miraba dos campos escritos a mano en la consulta, y por eso
+ * nació este fichero. Las que faltaban:
+ *
+ *   `tools[].credentialId`          las credenciales de las TOOLS del AI Node:
+ *                                   toda tool MCP y todo puente de audio
+ *   `audioTranscribeCredentialId`   el puente de transcripción del AI Node
+ *   `embedding.credentialId`        la clave que paga cada `embed` del vector store
+ *   `backend.config.credentialId`   la conexión del backend del vector store
+ *   `results[].credentialId`        a qué cuenta se publicó cada fila de un post
+ *
+ * Consecuencia medible y VIVA: `findConsumers` usa esta misma lista, así que
+ * borrar una credencial `mcp_server` usada sólo por una tool encontraba CERO
+ * consumidores — ni 409, ni desatachado, ni marcador. La credencial
+ * desaparecía y el nodo se quedaba con un id que ya no resuelve. Es el mismo
+ * fallo por el que se perdió la de Mastodon el 12-ago, con otro campo.
+ *
+ * ## ⚠️ `soloLectura`: referenciar no es lo mismo que desatachar
+ *
+ * `results[]` de un post es un REGISTRO HISTÓRICO: dice a qué cuenta se
+ * publicó cada fila. Tiene que contar para encontrar consumidores —que salte
+ * el 409— pero reescribirlo al desatachar sería falsear lo que pasó: una
+ * publicación que SÍ ocurrió quedaría sin decir con qué cuenta.
+ *
+ * Sin esta marca, ampliar la lista habría arreglado el borrado silencioso y
+ * roto el historial en el mismo movimiento.
  */
 exports.CREDENTIAL_REF_SHAPES = [
     { kind: 'scalar', path: 'credentialId' },
@@ -55,6 +84,16 @@ exports.CREDENTIAL_REF_SHAPES = [
     { kind: 'array', path: 'extraCredentialIds' },
     { kind: 'map', path: 'credentialIds' },
     { kind: 'map', path: 'serviceConfig.social_media.credentialIds' },
+    { kind: 'arrayDeObjetos', path: 'tools', campo: 'credentialId' },
+    { kind: 'scalar', path: 'audioTranscribeCredentialId' },
+    { kind: 'scalar', path: 'embedding.credentialId' },
+    { kind: 'scalar', path: 'backend.config.credentialId' },
+    {
+        kind: 'arrayDeObjetos',
+        path: 'results',
+        campo: 'credentialId',
+        soloLectura: true,
+    },
 ];
 const mismoId = (v, id) => v !== null && v !== undefined && String(v) === id;
 /** Lee un camino con puntos. Devuelve `undefined` si algo del medio falta. */
@@ -74,13 +113,19 @@ function leerCamino(doc, path) {
  * formas conviven en datos reales (`credentialIds` está declarado como
  * `Record<string, string[] | string>` justamente por eso).
  */
-function valorReferencia(valor, id, kind) {
+function valorReferencia(valor, id, forma) {
     if (valor === null || valor === undefined)
         return false;
-    if (kind === 'scalar')
+    if (forma.kind === 'scalar')
         return mismoId(valor, id);
-    if (kind === 'array')
+    if (forma.kind === 'array')
         return Array.isArray(valor) && valor.some((v) => mismoId(v, id));
+    if (forma.kind === 'arrayDeObjetos') {
+        return (Array.isArray(valor) &&
+            valor.some((o) => o !== null &&
+                typeof o === 'object' &&
+                mismoId(o[forma.campo], id)));
+    }
     // map
     if (typeof valor !== 'object' || Array.isArray(valor))
         return false;
@@ -88,7 +133,7 @@ function valorReferencia(valor, id, kind) {
 }
 /** Las formas por las que ESTE documento referencia la credencial. */
 function formasQueReferencian(doc, id) {
-    return exports.CREDENTIAL_REF_SHAPES.filter((forma) => valorReferencia(leerCamino(doc, forma.path), id, forma.kind));
+    return exports.CREDENTIAL_REF_SHAPES.filter((forma) => valorReferencia(leerCamino(doc, forma.path), id, forma));
 }
 /**
  * El valor que hay que dejar en el campo al quitar la credencial.
@@ -100,7 +145,22 @@ function formasQueReferencian(doc, id) {
  * con `[]` haría que el trigger siguiera anunciando que vigila Mastodon sin
  * ninguna cuenta con la que hacerlo.
  */
-function valorTrasDesatacar(valor, id, kind) {
+function valorTrasDesatacar(valor, id, forma) {
+    const kind = forma.kind;
+    if (kind === 'arrayDeObjetos') {
+        /* ⚠️ Se le quita el id a la fila, pero la fila SE QUEDA. Borrar la tool
+           entera sería borrarle al usuario algo que él configuró porque nosotros
+           borramos otra cosa; sin credencial dará un error con nombre, que es lo
+           que toca. */
+        if (!Array.isArray(valor))
+            return null;
+        const resto = valor.map((o) => o !== null &&
+            typeof o === 'object' &&
+            mismoId(o[forma.campo], id)
+            ? { ...o, [forma.campo]: null }
+            : o);
+        return resto.length > 0 ? resto : null;
+    }
     if (kind === 'scalar')
         return null;
     if (kind === 'array') {
@@ -141,9 +201,19 @@ exports.UNSET_MARCADOR_DETACH = {
     credentialDetachedName: '',
 };
 /** ¿Este valor trae al menos una credencial puesta? */
-function valorTieneCredencial(valor, kind) {
+function valorTieneCredencial(valor, forma) {
     if (valor === null || valor === undefined || valor === '')
         return false;
+    const kind = forma.kind;
+    if (kind === 'arrayDeObjetos') {
+        return (Array.isArray(valor) &&
+            valor.some((o) => {
+                if (o === null || typeof o !== 'object')
+                    return false;
+                const v = o[forma.campo];
+                return v !== null && v !== undefined && v !== '';
+            }));
+    }
     if (kind === 'scalar')
         return true;
     if (kind === 'array')
@@ -166,7 +236,7 @@ function valorTieneCredencial(valor, kind) {
 function tieneAlgunaCredencial(doc) {
     if (!doc || typeof doc !== 'object')
         return false;
-    return exports.CREDENTIAL_REF_SHAPES.some((forma) => valorTieneCredencial(leerCamino(doc, forma.path), forma.kind));
+    return exports.CREDENTIAL_REF_SHAPES.some((forma) => valorTieneCredencial(leerCamino(doc, forma.path), forma));
 }
 /**
  * ¿Hay que quitarle el marcador a este documento?

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hostwebhook/node-sdk",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "El SDK de un nodo de HostWebhook: ciclo de vida, ejecución con iteración, reintentos, filtros y validación de esquema — lo que comparten la api y el futuro servicio de nodos",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",