tuain-ng-forms-lib 17.3.6 → 17.4.0

package/fesm2022/tuain-ng-forms-lib.mjs

@@ -4,9 +4,16 @@ import { Subject, takeUntil, BehaviorSubject, ReplaySubject } from 'rxjs';
 import yn from 'yn';
 import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
 import { nanoid } from 'nanoid';
+import { fetchEventSource } from '@microsoft/fetch-event-source';
 
 const ICON_RESOLVER = new InjectionToken('ICON_RESOLVER');
 
+/**
+ * Token con el que cada app provee su configuración del stream SSE.
+ * Sigue el mismo patrón que `ICON_RESOLVER`.
+ */
+const SSE_LIVE_CONNECTION_CONFIG = new InjectionToken('SSE_LIVE_CONNECTION_CONFIG');
+
 class FormPiece {
     destroy$ = new Subject();
     _formState = '';
@@ -117,7 +124,7 @@ class FormPiece {
     set disabled(disabled) { this.enabled = !disabled; }
     enable() { this.enabled = true; }
     disable() { this.enabled = false; }
-    formStateChangeCustomSubscribe(form, formChangeSubject) { }
+    formStateChangeCustomSubscribe(_form, _formChangeSubject) { }
     formStateChange(state) {
         if (state) {
             this._formState = state;
@@ -249,7 +256,7 @@ class FormElement extends FormPiecePropagate {
             }
         }
         catch (e) {
-            console.log(`Atributo ${attrName} no presente o valor ${value} inconsistente. ${e}`);
+            console.error(`Atributo ${attrName} no presente o valor ${value} inconsistente. ${e}`);
         }
     }
     isField() { return this.elementType === ElementType.Field; }
@@ -566,7 +573,7 @@ class FieldDescriptor extends FormElement {
     /**
      * @deprecated Since v17. Use options instead. Will be removed in v19.
      */
-    setFieldOptions(newOptions) { return this.options = newOptions; }
+    setFieldOptions(newOptions) { this.options = newOptions; }
     /**
      * @deprecated Since v17. Use intrinsicErrorMessage instead. Will be removed in v19.
      */
@@ -592,7 +599,6 @@ class FieldDescriptor extends FormElement {
             && Array.isArray(fieldCurrentValue) && fieldCurrentValue.length === 0) {
             return true;
         }
-        ;
         if (this._fieldType === this._formConfig.fieldTypes.phone) {
             if (!Array.isArray(fieldCurrentValue)) {
                 return true;
@@ -602,7 +608,6 @@ class FieldDescriptor extends FormElement {
             }
             return false;
         }
-        ;
         const arrayFieldTypes = this._formConfig.arrayFieldTypes ?? null;
         if (arrayFieldTypes && Object.keys(arrayFieldTypes).includes(this._fieldType)) {
             let arraySize = arrayFieldTypes[this._fieldType];
@@ -612,7 +617,6 @@ class FieldDescriptor extends FormElement {
             }
             return (Array.isArray(fieldCurrentValue) && fieldCurrentValue.length < arraySize);
         }
-        ;
         return fieldCurrentValue === '';
     }
     notifyEditionPartial() {
@@ -646,14 +650,14 @@ class FieldDescriptor extends FormElement {
         if (intrinsicValidation && fieldValue && this._minValue && fieldValue < this._minValue) {
             intrinsicValidation = false;
             const formatedMinValue = !isNaN(+this._minValue)
-                ? this._minValue.toLocaleString('es-CO')
+                ? Number(this._minValue).toLocaleString('es-CO')
                 : this._minValue;
             this.setError('99', `El valor de ${this.title} no puede ser inferior a ${formatedMinValue}`);
         }
         if (intrinsicValidation && fieldValue && this._maxValue && fieldValue > this._maxValue) {
             intrinsicValidation = false;
             const formatedMaxValue = !isNaN(+this._maxValue)
-                ? this._maxValue.toLocaleString('es-CO')
+                ? Number(this._maxValue).toLocaleString('es-CO')
                 : this._maxValue;
             this.setError('99', `El valor de ${this.title} no puede ser superior a ${formatedMaxValue}`);
         }
@@ -812,7 +816,7 @@ class FormAction extends FormElement {
             }
         }
     }
-    updateRestrictedVisibility(event) {
+    updateRestrictedVisibility(_event) {
         const newVisible = this._absoluteVisible && this.viewOnState(this._formState);
         (this._visible !== newVisible) && this.setVisibility(newVisible);
     }
@@ -839,7 +843,7 @@ class FormAction extends FormElement {
                     this[propertyName] = receivedAction[propertyName];
                 }
                 catch (e) {
-                    console.log(`Error actualizando la propiedad ${propertyName} de la acción ${this.actionCode}. ${e}`);
+                    console.error(`Error actualizando la propiedad ${propertyName} de la acción ${this.actionCode}. ${e}`);
                 }
             }
         }
@@ -1008,7 +1012,7 @@ class RecordFormSection extends FormPiecePropagate {
     }
     get title() { return this._sectionTitle; }
     set title(title) { this._sectionTitle = title; }
-    getVisibleSubsections(state) {
+    getVisibleSubsections(_state) {
         return this._subSections.filter(subSection => subSection.visible);
     }
     getSubsection(subSectionCode) {
@@ -1223,7 +1227,6 @@ class TableRecordData {
             const rawRecordData = recordData.filter(fieldData => fieldData.fieldCode && fieldNames.includes(fieldData.fieldCode));
             rawRecordData.forEach(fieldData => {
                 const { fieldCode, fieldValue } = fieldData;
-                const fieldDef = recordDefinition.find(column => column.fieldCode === fieldCode);
                 this.recordData[fieldCode] = fieldValue ?? '';
                 if (fieldCode === selectionFieldName) {
                     this.selected = fieldValue;
@@ -1234,7 +1237,6 @@ class TableRecordData {
             const fields = Object.keys(recordData);
             fields.forEach(fieldCode => {
                 const fieldValue = recordData[fieldCode];
-                const fieldDef = recordDefinition.find(column => column.fieldCode === fieldCode);
                 this.recordData[fieldCode] = fieldValue ?? '';
             });
         }
@@ -1257,7 +1259,7 @@ class TableRecordData {
             let wordIsPresent = false;
             for (const fieldCode in this.recordData) {
                 const columnDef = columnObj?.[fieldCode];
-                if (columnDef?.searchable && this.recordData.hasOwnProperty(fieldCode)) {
+                if (columnDef?.searchable && Object.prototype.hasOwnProperty.call(this.recordData, fieldCode)) {
                     const term = word.toUpperCase();
                     let fieldValue;
                     if (columnDef.fieldType.toUpperCase().includes('DATE')) {
@@ -1284,7 +1286,7 @@ class TableRecordData {
         }
         for (const condition of columnFilters) {
             const { fieldCode, operator, values } = condition;
-            if (this.recordData.hasOwnProperty(fieldCode)) {
+            if (Object.prototype.hasOwnProperty.call(this.recordData, fieldCode)) {
                 const fieldValue = this.recordData[fieldCode];
                 const stringValue = fieldValue.toString().toUpperCase();
                 if (operator === ComparisonOperator.G && fieldValue <= values[0]) {
@@ -1465,6 +1467,7 @@ class RecordTable extends FormElement {
     get selectionField() { return this._selectionField; }
     get allSelected() { return this._allSelected; }
     get tableCode() { return this._tableCode; }
+    get code() { return this._tableCode; }
     get tableTitle() { return this._tableTitle; }
     get currentPage() { return this._currentPage; }
     get totalPages() { return this._totalPages; }
@@ -1715,7 +1718,6 @@ class RecordTable extends FormElement {
         this.updateVisibleRecords();
     }
     getTableRecord(recordId) {
-        const recordIdKey = (typeof recordId === 'object') ? JSON.stringify(recordId) : recordId;
         return (this._tableRecordObj && recordId && this._tableRecordObj[recordId])
             ? this._tableRecordObj[recordId] : null;
     }
@@ -1860,9 +1862,7 @@ const HIDE = 'hide';
 const ENABLE = 'enable';
 const DISABLE = 'disable';
 const CLEAN = 'clean';
-const alwaysVisible = 'ALWAYS';
 const neverVisible = 'NONE';
-const onStatesVisible = 'ONSTATES';
 class FormStructureAndData {
     _stateChange = new Subject();
     _immutableData = {};
@@ -2091,7 +2091,7 @@ class FormStructureAndData {
                 field && (field.required = required);
             }
             catch (e) {
-                console.log(`Error modificando campo ${code}: ${e}`);
+                console.error(`Error modificando campo ${code}: ${e}`);
             }
         }
     }
@@ -2159,7 +2159,7 @@ class FormStructureAndData {
                     processedFields += 1;
                 }
                 catch (e) {
-                    console.log(`Error procesando funcion en campo ${field}: ${e}`);
+                    console.error(`Error procesando funcion en campo ${field}: ${e}`);
                 }
             }
         }
@@ -2222,7 +2222,7 @@ class FormStructureAndData {
         for (let index = 0; index < codes.length; index++) {
             const code = codes[index];
             if (code) {
-                resultObject[code] = this.fields?.[code]?.getValue() ?? null;
+                resultObject[code] = this.fields?.[code]?.value ?? null;
             }
         }
         return resultObject;
@@ -2445,7 +2445,7 @@ class PieceComponent {
     enabled = computed(() => !this.disabled());
     customAttributes = signal({});
     setForm(form) { this.form = form; }
-    propagatedAttributeChange(attribute, value) { }
+    propagatedAttributeChange(_attribute, _value) { }
     updatePieceAttribute(signaledAttributes, signaledAttribute, value) {
         if (!signaledAttributes.includes(signaledAttribute)) {
             return;
@@ -2468,7 +2468,7 @@ class PieceComponent {
             }
         }
     }
-    customAttributeChange(subAttribute, value) { }
+    customAttributeChange(_subAttribute, _value) { }
     updateCustomAttribute(attrName, attrValue) {
         this.customAttributes.update(old => ({ ...old, [attrName]: attrValue }));
         this.customAttributeChange(attrName, attrValue);
@@ -3048,9 +3048,9 @@ class LibFormManagerService {
         this.cleanStack();
     }
     // Métodos virtuales para las aplicaciones
-    getFormDefinition(formCode) { }
-    execServerAction(actionDetail) { }
-    goToForm(formCode, token, subject) { }
+    getFormDefinition(_formCode) { }
+    execServerAction(_actionDetail) { }
+    goToForm(_formCode, _token, _subject) { }
     async loadStack() { }
     saveStack() { }
     cleanStack() { this.pageStack = []; }
@@ -3089,7 +3089,7 @@ class LibFormManagerService {
         return token;
     }
     unstack(token = null) {
-        let index = (token) ? this.findFormInStack(token).index : this.pageStack.length - 2;
+        const index = (token) ? this.findFormInStack(token).index : this.pageStack.length - 2;
         let formInfo = null;
         if (index >= 0) {
             formInfo = this.pageStack[index];
@@ -3182,10 +3182,10 @@ class LibEventManagerService {
 }
 
 class LibFileManagementService {
-    openFile(fileBase64Data, fileName, fileType) { }
-    saveFileFromURL(fileUrl, fileName = null, fileType = null) { }
-    saveFile(fileBase64Data, fileName, fileType) { }
-    printPdfFile(pdfBufferData) { }
+    openFile(_fileBase64Data, _fileName, _fileType) { }
+    saveFileFromURL(_fileUrl, _fileName = null, _fileType = null) { }
+    saveFile(_fileBase64Data, _fileName, _fileType) { }
+    printPdfFile(_pdfBufferData) { }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "17.3.12", ngImport: i0, type: LibFileManagementService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
     static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "17.3.12", ngImport: i0, type: LibFileManagementService });
 }
@@ -3194,7 +3194,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "17.3.12", ngImpo
         }] });
 
 const PAYLOAD_VERSION = 'TUAINEXCHANGE_1.0';
-const INLINE_ACTION = 'INLINE';
 const GLOBAL_ACTION = 'GLOBAL';
 const GET_DATA_ACTION = 'GETDATA';
 const SUBJECT = 'subject';
@@ -3314,9 +3313,9 @@ class BasicFormComponent extends FormStructureAndData {
     displayActionServerError() { }
     displayValidationServerError() { }
     displayTableServerError() { }
-    showFieldInfo(code, detail) { }
-    showModalDialog(title, body, options, callback, params) { }
-    openUploadDialog(title, body, options, callback, params) { }
+    showFieldInfo(_code, _detail) { }
+    showModalDialog(_title, _body, _options, _callback, _params) { }
+    openUploadDialog(_title, _body, _options, _callback, _params) { }
     subscribeAppEvent(eventName, callback) {
         this._eventEmiter.subscribe(eventName, callback);
     }
@@ -3666,7 +3665,7 @@ class BasicFormComponent extends FormStructureAndData {
         const clientSectionMethods = this._formSectionsCanDeactivate[code];
         if (clientSectionMethods) {
             for (const clientSectionMethod of clientSectionMethods) {
-                const { callback, properties } = clientSectionMethod;
+                const { callback } = clientSectionMethod;
                 const canActivate = callback(sectionObject);
                 if (canActivate === false) {
                     return false;
@@ -3684,7 +3683,7 @@ class BasicFormComponent extends FormStructureAndData {
         const clientSectionMethods = this._formSectionsActivate[code];
         if (clientSectionMethods) {
             for (const clientSectionMethod of clientSectionMethods) {
-                const { callback, properties } = clientSectionMethod;
+                const { callback } = clientSectionMethod;
                 callback(sectionObject);
             }
         }
@@ -3698,7 +3697,7 @@ class BasicFormComponent extends FormStructureAndData {
         const clientSectionMethods = this._formSectionsInactivate[code];
         if (clientSectionMethods) {
             for (const clientSectionMethod of clientSectionMethods) {
-                const { callback, properties } = clientSectionMethod;
+                const { callback } = clientSectionMethod;
                 callback(sectionObject);
             }
         }
@@ -3711,7 +3710,7 @@ class BasicFormComponent extends FormStructureAndData {
         }
         if (this._actionsInProgress[code]) {
             const { sent } = this._actionsInProgress[code];
-            console.log(`Reingreso sobre acción ${code} con ejecución previa ${sent}`);
+            console.error(`Reingreso sobre acción ${code} con ejecución previa ${sent}`);
             return;
         }
         this._actionsInProgress[code] = { sent: new Date() };
@@ -3721,7 +3720,7 @@ class BasicFormComponent extends FormStructureAndData {
         if (clientActionMethods) {
             const clientActionPromises = [];
             for (const clientActionMethod of clientActionMethods) {
-                const { callback, properties } = clientActionMethod;
+                const { callback } = clientActionMethod;
                 const continueActionPromise = callback(actionObject);
                 clientActionPromises.push(continueActionPromise);
             }
@@ -3750,7 +3749,7 @@ class BasicFormComponent extends FormStructureAndData {
         if (backend) {
             if (this._serverActionsInProgress[code]) {
                 const { sent } = this._serverActionsInProgress[code];
-                console.log(`Reingreso server en acción ${code} con ejecución previa ${sent}`);
+                console.error(`Reingreso server en acción ${code} con ejecución previa ${sent}`);
                 return;
             }
             this._serverActionsInProgress[code] = { sent: new Date() };
@@ -3764,7 +3763,7 @@ class BasicFormComponent extends FormStructureAndData {
         }
         else {
             for (let index = 0; index < this._actionServerError.length; index++) {
-                const { callback, properties } = this._actionServerError[index];
+                const { callback } = this._actionServerError[index];
                 callback(action);
             }
         }
@@ -3822,7 +3821,7 @@ class BasicFormComponent extends FormStructureAndData {
         this.removeEventHandler(this._fieldValidationsStart, codes);
         this.removeEventHandler(this._fieldValidationsFinish, codes);
     }
-    async startFieldInputValidation(code, intrinsicValidation = true) {
+    async startFieldInputValidation(code, _intrinsicValidation = true) {
         this.notifyFormActivity();
         const fieldToValidate = this.getField(code);
         if (!fieldToValidate) {
@@ -3832,7 +3831,7 @@ class BasicFormComponent extends FormStructureAndData {
         if (validationCallbacks) {
             const clientValidationPromises = [];
             for (const validationMethod of validationCallbacks) {
-                const { callback, properties } = validationMethod;
+                const { callback } = validationMethod;
                 const continueValidationPromise = callback(fieldToValidate);
                 clientValidationPromises.push(continueValidationPromise);
             }
@@ -3850,7 +3849,7 @@ class BasicFormComponent extends FormStructureAndData {
         if (eventHandlerCallbacks) {
             const clientEventPromises = [];
             for (const eventHandlerMethod of eventHandlerCallbacks) {
-                const { callback, properties } = eventHandlerMethod;
+                const { callback } = eventHandlerMethod;
                 const clientEventPromise = callback(eventName, eventData, fieldToTrigger);
                 clientEventPromises.push(clientEventPromise);
             }
@@ -3866,7 +3865,7 @@ class BasicFormComponent extends FormStructureAndData {
         if (validationCallbacks) {
             const clientValidationPromises = [];
             for (const validationMethod of validationCallbacks) {
-                const { callback, properties } = validationMethod;
+                const { callback } = validationMethod;
                 const clientValidationPromise = callback(fieldToValidate);
                 clientValidationPromises.push(clientValidationPromise);
             }
@@ -3898,7 +3897,7 @@ class BasicFormComponent extends FormStructureAndData {
             fieldObj?.setErrorCode(this.errorCode);
             fieldObj?.setErrorMessage(this.errorMessage);
             for (let index = 0; index < this._fieldServerError.length; index++) {
-                const { callback, properties } = this._fieldServerError[index];
+                const { callback } = this._fieldServerError[index];
                 callback(fieldObj);
             }
         }
@@ -4052,7 +4051,7 @@ class BasicFormComponent extends FormStructureAndData {
         if (tableActionMethods) {
             const clientActionPromises = [];
             for (const tableActionMethod of tableActionMethods) {
-                const { callback, properties } = tableActionMethod;
+                const { callback } = tableActionMethod;
                 const clientActionPromise = callback(tableActionDetail);
                 clientActionPromises.push(clientActionPromise);
             }
@@ -4088,7 +4087,7 @@ class BasicFormComponent extends FormStructureAndData {
         }
         else {
             for (let index = 0; index < this._tableServerError.length; index++) {
-                const { callback, properties } = this._tableServerError[index];
+                const { callback } = this._tableServerError[index];
                 callback(tableObject);
             }
         }
@@ -4136,7 +4135,7 @@ class BasicFormComponent extends FormStructureAndData {
         if (tableActionMethods) {
             const clientActionPromises = [];
             for (const tableActionMethod of tableActionMethods) {
-                const { callback, properties } = tableActionMethod;
+                const { callback } = tableActionMethod;
                 const clientActionPromise = callback(tableActionDetail);
                 clientActionPromises.push(clientActionPromise);
             }
@@ -4215,7 +4214,7 @@ class BasicFormComponent extends FormStructureAndData {
         if (tableEventHandlers) {
             const clientActionPromises = [];
             for (const tableSelectionMethod of tableEventHandlers) {
-                const { callback, properties } = tableSelectionMethod;
+                const { callback } = tableSelectionMethod;
                 const clientActionPromise = callback(tableSelectionDetail);
                 clientActionPromises.push(clientActionPromise);
             }
@@ -4293,7 +4292,7 @@ class BasicFormComponent extends FormStructureAndData {
         if (tableActionMethods) {
             const clientActionPromises = [];
             for (const tableActionMethod of tableActionMethods) {
-                const { callback, properties } = tableActionMethod;
+                const { callback } = tableActionMethod;
                 const clientActionPromise = callback(tableActionDetail);
                 clientActionPromises.push(clientActionPromise);
             }
@@ -4362,7 +4361,7 @@ class BasicFormComponent extends FormStructureAndData {
         if (tableEventHandlers) {
             const clientActionPromises = [];
             for (const tableActionMethod of tableEventHandlers) {
-                const { callback, properties } = tableActionMethod;
+                const { callback } = tableActionMethod;
                 const clientActionPromise = callback(tableActionDetail);
                 clientActionPromises.push(clientActionPromise);
             }
@@ -4463,7 +4462,7 @@ class BasicFormComponent extends FormStructureAndData {
     }
     notifyFormActivity() {
         if (this._notifyFormActivity) {
-            this._eventEmiter.next('formActivity', { code: this.formCode });
+            this._eventEmiter.next('formActivity', { code: this.name });
         }
     }
     /**
@@ -4793,6 +4792,167 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "17.3.12", ngImpo
             type: Injectable
         }] });
 
+const DEFAULT_STREAM_PATH = '/liveconnect/stream';
+const DEFAULT_SESSION_ENDED_EVENT = 'sessionEnded';
+const SESSION_EVENT_CLASS = 'session';
+const SESSION_REPLACED_EVENT_TYPE = 'sessionReplaced';
+/** Error que detiene los reintentos de `fetchEventSource` (handshake rechazado). */
+class FatalSseError extends Error {
+}
+/**
+ * Canal de eventos servidor→cliente sobre Server-Sent Events (SSE).
+ *
+ * Reemplaza al `LiveConnectionService` basado en Socket.IO que vivía duplicado
+ * en cada app. El uso siempre fue unidireccional (un único handshake y luego
+ * solo recepción), así que SSE encaja sin perder funcionalidad y además gana
+ * reconexión automática nativa.
+ *
+ * El servicio es agnóstico de la app: toda la integración (URL, token de auth,
+ * allow-list, re-emisión al bus, logger) llega por `SSE_LIVE_CONNECTION_CONFIG`.
+ * El ciclo de vida (cuándo abrir/cerrar) lo controla cada app llamando
+ * `open()`/`close()` — típicamente atado a `sessionEstablished`/`sessionEnded`,
+ * y en móvil además al `appStateChange` de Capacitor.
+ */
+class SseLiveConnectionService {
+    _config = inject(SSE_LIVE_CONNECTION_CONFIG);
+    _abort = null;
+    _currentSessionId = null;
+    _connected = false;
+    isConnected() {
+        return this._connected;
+    }
+    /**
+     * Abre el stream SSE para la sesión dada (cierra cualquier stream anterior).
+     * El handshake viaja en el header `Authorization`, no en la URL.
+     */
+    async open(sessionData) {
+        this.close();
+        if (!sessionData) {
+            return;
+        }
+        this._currentSessionId = sessionData?.sessionId ?? null;
+        const logger = this._config.logger;
+        const allowed = this._allowedSet();
+        const token = await this._config.getAuthToken(sessionData);
+        const scheme = this._config.authScheme ?? 'Bearer';
+        const authorization = scheme ? `${scheme} ${token}` : token;
+        const abort = new AbortController();
+        this._abort = abort;
+        this.openEventSource(this._buildStreamUrl(), {
+            signal: abort.signal,
+            openWhenHidden: this._config.keepOpenWhenHidden ?? true,
+            headers: { Authorization: authorization },
+            onopen: async (response) => {
+                const contentType = response.headers.get('content-type') ?? '';
+                if (response.ok && contentType.includes('text/event-stream')) {
+                    this._connected = true;
+                    return;
+                }
+                // 4xx (p. ej. 401) => fatal, no reintentar. 5xx/otros => reintentar.
+                if (response.status >= 400 && response.status < 500) {
+                    throw new FatalSseError(`handshake rechazado: ${response.status}`);
+                }
+                throw new Error(`handshake inesperado: ${response.status}`);
+            },
+            onmessage: msg => {
+                if (!msg.data) {
+                    return; // comentarios/heartbeats no traen `data`
+                }
+                let eventData;
+                try {
+                    eventData = JSON.parse(msg.data);
+                }
+                catch {
+                    logger?.warn?.('[SseLiveConnection] Payload no-JSON descartado');
+                    return;
+                }
+                logger?.debug?.(`[SseLiveConnection] Evento recibido: ${msg.data}`);
+                if (this._handleSessionReplaced(eventData)) {
+                    return;
+                }
+                const eventClass = eventData?.eventClass;
+                if (typeof eventClass !== 'string' || !allowed.has(eventClass)) {
+                    logger?.warn?.('[SseLiveConnection] Evento no permitido rechazado:', eventClass);
+                    return;
+                }
+                this._config.emit(eventClass, eventData);
+            },
+            onerror: err => {
+                this._connected = false;
+                if (err instanceof FatalSseError) {
+                    logger?.warn?.('[SseLiveConnection]', err.message);
+                    throw err; // detiene los reintentos
+                }
+                logger?.warn?.('[SseLiveConnection] error de stream, reintentando', err?.message ?? err);
+                // devolver undefined => fetch-event-source reintenta con backoff propio
+            },
+        }).catch(err => {
+            this._connected = false;
+            if (!(err instanceof FatalSseError) && err?.name !== 'AbortError') {
+                logger?.warn?.('[SseLiveConnection] stream finalizado', err?.message ?? err);
+            }
+        });
+    }
+    /**
+     * Punto de indirección (seam) sobre `fetchEventSource`: permite sustituirlo en
+     * tests (`fetchEventSource` es un binding ESM de solo lectura, no espiable).
+     * En producción delega directamente en la librería.
+     */
+    openEventSource(url, options) {
+        return fetchEventSource(url, options);
+    }
+    /** Cierra el stream actual (idempotente). */
+    close() {
+        if (this._abort) {
+            this._abort.abort();
+            this._abort = null;
+        }
+        this._connected = false;
+    }
+    _buildStreamUrl() {
+        const base = (this._config.buildUrl() ?? '').replace(/\/+$/, '');
+        const path = this._config.streamPath ?? DEFAULT_STREAM_PATH;
+        return `${base}${path.startsWith('/') ? path : '/' + path}`;
+    }
+    _allowedSet() {
+        const allowed = this._config.allowedEvents;
+        return allowed instanceof Set ? allowed : new Set(allowed);
+    }
+    /**
+     * Maneja el evento de lifecycle `sessionReplaced` (otra apertura de sesión
+     * para el mismo usuario). Si el `newSessionId` difiere de la sesión local,
+     * emite el evento de fin de sesión para forzar logout. Se ejecuta antes del
+     * filtro de allow-list porque no se re-emite al bus genérico.
+     * Devuelve `true` cuando consume el evento.
+     */
+    _handleSessionReplaced(eventData) {
+        if ((this._config.handleSessionReplaced ?? true) === false) {
+            return false;
+        }
+        if (eventData?.eventClass !== SESSION_EVENT_CLASS ||
+            eventData?.eventType !== SESSION_REPLACED_EVENT_TYPE) {
+            return false;
+        }
+        const newSessionId = eventData?.eventDetail?.newSessionId ?? null;
+        if (!this._currentSessionId) {
+            return true; // no hay sesión local que cerrar
+        }
+        if (newSessionId && newSessionId === this._currentSessionId) {
+            return true; // corresponde a la propia sesión recién abierta
+        }
+        this._config.logger?.warn?.('[SseLiveConnection] Sesión reemplazada por otra apertura para el mismo usuario', { currentSessionId: this._currentSessionId, newSessionId });
+        const sessionEndedName = this._config.sessionEndedEventName ?? DEFAULT_SESSION_ENDED_EVENT;
+        this._config.emit(sessionEndedName, null);
+        return true;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "17.3.12", ngImport: i0, type: SseLiveConnectionService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "17.3.12", ngImport: i0, type: SseLiveConnectionService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "17.3.12", ngImport: i0, type: SseLiveConnectionService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
 const COMPONENTS = [
     ActionComponent,
     FieldComponent,
@@ -4845,5 +5005,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "17.3.12", ngImpo
  * Generated bundle index. Do not edit.
  */
 
-export { ActionComponent, BaseIconResolverService, BasicFormComponent, ComparisonOperator, ElementComponent, ElementType, FieldComponent, FieldDescriptor, FormAction, FormActionType, FormElement, FormErrorComponent, FormHeaderComponent, FormPiece, FormPiecePropagate, FormStructureAndData, HEADER, ICON_RESOLVER, IconDictionaryService, LibEventManagerService, LibFileManagementService, LibFormManagerService, LibTableComponent, LibTableRecordActionComponent, LibTableRecordFieldComponent, NO_ERROR, PieceComponent, RecordFormSection, RecordFormSubSection, RecordTable, RecordTableColumn, SectionComponent, SubSectionComponent, TableAction, TableRecordData, TuainNgFormsLibModule, elementTypes, formActions, iconDictionary, operators };
+export { ActionComponent, BaseIconResolverService, BasicFormComponent, ComparisonOperator, ElementComponent, ElementType, FieldComponent, FieldDescriptor, FormAction, FormActionType, FormElement, FormErrorComponent, FormHeaderComponent, FormPiece, FormPiecePropagate, FormStructureAndData, HEADER, ICON_RESOLVER, IconDictionaryService, LibEventManagerService, LibFileManagementService, LibFormManagerService, LibTableComponent, LibTableRecordActionComponent, LibTableRecordFieldComponent, NO_ERROR, PieceComponent, RecordFormSection, RecordFormSubSection, RecordTable, RecordTableColumn, SSE_LIVE_CONNECTION_CONFIG, SectionComponent, SseLiveConnectionService, SubSectionComponent, TableAction, TableRecordData, TuainNgFormsLibModule, elementTypes, formActions, iconDictionary, operators };
 //# sourceMappingURL=tuain-ng-forms-lib.mjs.map