@kwirthmagnify/kwirth-common-back 0.5.44 → 0.5.46

package/dist/IFederation.d.ts

@@ -6,8 +6,9 @@ export interface IClusterEndpoint {
     id?: string;
 }
 export declare enum ERemoteConnState {
-    CONNECTED = "connected",
-    RECONNECTING = "reconnecting",
+    CONNECTED = "connected",// socket abierto Y instance válido capturado → operativo
+    HANDSHAKING = "handshaking",// socket abierto pero SIN instance aún (canal remoto arrancando / re-handshake)
+    RECONNECTING = "reconnecting",// sin socket, reintentando con backoff
     DOWN = "down"
 }
 export interface IRemoteChannelHandlers {

package/dist/IFederation.js

@@ -2,9 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ERemoteConnState = void 0;
 // Estado de una conexión remota gestionada por el core. Nunca string literals.
+// Progresión al establecerse: DOWN → RECONNECTING (buscando socket) → HANDSHAKING (socket abierto, pidiendo
+// instance al canal remoto) → CONNECTED (socket + instance = operativo). CONNECTED es el ÚNICO estado en el
+// que un comando llega de verdad al canal remoto.
 var ERemoteConnState;
 (function (ERemoteConnState) {
     ERemoteConnState["CONNECTED"] = "connected";
+    ERemoteConnState["HANDSHAKING"] = "handshaking";
     ERemoteConnState["RECONNECTING"] = "reconnecting";
-    ERemoteConnState["DOWN"] = "down";
+    ERemoteConnState["DOWN"] = "down"; // conexión cerrada / nunca establecida (terminal o sin credenciales)
 })(ERemoteConnState || (exports.ERemoteConnState = ERemoteConnState = {}));

package/dist/IPluvider.d.ts

@@ -0,0 +1,53 @@
+import { IProviderSubscriber, IProviderSubscriptionHelp } from './IProvider';
+/**
+ * Lo que el gestor de extensiones y provider-debug enseñan de un pluvider. El consumidor de un
+ * pluvider es OTRO EQUIPO, asi que hace falta algo que mostrar sin leerse el codigo.
+ */
+export interface IPluviderData {
+    /** Que produce, en una linea. */
+    description: string;
+    /** Nombre del tipo del evento que emite (p.ej. 'IAgoraAlert'), para orientar al consumidor. */
+    eventTypeName?: string;
+}
+/**
+ * Un plugin que ADEMAS produce: expone in-process la informacion que ya genera, para que otros
+ * plugins se suscriban a ella. No es una segunda extension empaquetada dentro del plugin: lo
+ * implementa la MISMA clase del canal, sobre la misma instancia y los mismos datos.
+ *
+ * NO extiende IProvider a proposito. Un pluvider no pasa por la maquinaria de providers —no se mete
+ * en 'clusterInfo.providers', que es lo que recorren los bucles que montan routers, escriben
+ * 'apiKeyApi' o marcan 'started'—, asi que no tiene 'id', 'router', 'routerAlias', 'providesRouter',
+ * 'requiresApiKeyApi' ni 'apiKeyApi'.
+ *
+ * El id tampoco lo escribe el autor: lo compone el core como '<PLUVIDER_ID_PREFIX><channelId>', para
+ * que nadie se equivoque con el prefijo.
+ *
+ * 'TSub' es la forma del filtro de suscripcion. Como en los providers, cada pluvider decide si
+ * filtra y con que forma; si no filtra, se deja el generico sin especificar.
+ *
+ * Ejemplo:
+ *
+ *   class AgoraChannel implements IChannel, IPluvider<IAgoraAlertSubscription> { … }
+ */
+export interface IPluvider<TSub = unknown> {
+    /**
+     * Metadatos del pluvider. Su PRESENCIA es la declaracion: un canal que implementa este metodo se
+     * ofrece como productor, y el core lo registra. No hay flags ni deteccion por duck-typing.
+     */
+    getPluviderData(): IPluviderData;
+    addSubscriber(c: IProviderSubscriber, data: TSub): Promise<void>;
+    removeSubscriber(c: IProviderSubscriber): Promise<void>;
+    updateSubscription?(c: IProviderSubscriber, data: TSub): Promise<void>;
+    /**
+     * Arranca la produccion. El core lo llama en la fase de pluviders, es decir ANTES de
+     * 'startChannel()': el trabajo de fondo vive en este lado y el front se engancha despues.
+     */
+    startProvider(): Promise<void>;
+    stopProvider(): Promise<void>;
+    /**
+     * Obligatorio, a diferencia del homonimo de IProvider, que es opcional. Un provider suele
+     * consumirlo quien lo escribio; un pluvider lo consume gente de fuera, y sin esto no tiene como
+     * saber que escribir en la suscripcion ni que va a recibir.
+     */
+    getSubscriptionHelp(): IProviderSubscriptionHelp;
+}

package/dist/IPluvider.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export * from './IFederation';
 export * from './ILogin';
 export * from './IChannel';
 export * from './IProvider';
+export * from './IPluvider';
 export * from './ISender';
 export * from './IWebhook';
 export * from './IIdpConnector';

package/dist/index.js

@@ -19,6 +19,7 @@ __exportStar(require("./IFederation"), exports);
 __exportStar(require("./ILogin"), exports);
 __exportStar(require("./IChannel"), exports);
 __exportStar(require("./IProvider"), exports);
+__exportStar(require("./IPluvider"), exports);
 __exportStar(require("./ISender"), exports);
 __exportStar(require("./IWebhook"), exports);
 __exportStar(require("./IIdpConnector"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kwirthmagnify/kwirth-common-back",
-  "version": "0.5.44",
+  "version": "0.5.46",
   "description": "Backend interfaces for building Kwirth provider and channel plugins",
   "scripts": {
     "build": "tsc",