@kwirthmagnify/kwirth-common-back 0.5.43 → 0.5.45

package/dist/IBackChannelObject.d.ts

@@ -1,4 +1,5 @@
-import { ISenderAccess, IWebhookAccess, IUserInfo } from '@kwirthmagnify/kwirth-common';
+import { ISenderAccess, IWebhookAccess, IUserInfo, IInstanceConfig } from '@kwirthmagnify/kwirth-common';
+import { IClusterEndpoint, IRemoteChannelHandlers, IRemoteChannelHandle } from './IFederation';
 export interface IBackChannelObject {
     writeStorage?(id: string, secret: boolean, data: any): Promise<void>;
     readStorage?(id: string, secret: boolean): Promise<any>;
@@ -12,4 +13,6 @@ export interface IBackChannelObject {
     getPluginConfig?(pluginId: string): Promise<Record<string, unknown>>;
     senders?: ISenderAccess;
     webhooks?: IWebhookAccess;
+    openRemoteChannel?(endpoint: IClusterEndpoint, config: IInstanceConfig, handlers: IRemoteChannelHandlers): IRemoteChannelHandle;
+    readUserStore?(userId: string, group: string, key: string): Promise<unknown>;
 }

package/dist/IFederation.d.ts

@@ -0,0 +1,21 @@
+import { IInstanceMessage } from '@kwirthmagnify/kwirth-common';
+export interface IClusterEndpoint {
+    name: string;
+    url: string;
+    accessString: string;
+    id?: string;
+}
+export declare enum ERemoteConnState {
+    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 {
+    onMessage: (msg: IInstanceMessage) => void;
+    onState: (state: ERemoteConnState) => void;
+}
+export interface IRemoteChannelHandle {
+    send: (msg: IInstanceMessage) => void;
+    close: () => void;
+}

package/dist/IFederation.js

@@ -0,0 +1,14 @@
+"use strict";
+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"; // conexión cerrada / nunca establecida (terminal o sin credenciales)
+})(ERemoteConnState || (exports.ERemoteConnState = ERemoteConnState = {}));

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './IBackChannelObject';
+export * from './IFederation';
 export * from './ILogin';
 export * from './IChannel';
 export * from './IProvider';

package/dist/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./IBackChannelObject"), exports);
+__exportStar(require("./IFederation"), exports);
 __exportStar(require("./ILogin"), exports);
 __exportStar(require("./IChannel"), exports);
 __exportStar(require("./IProvider"), exports);

package/package.json

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