@arquimedes.co/eureka-forms 3.0.71-test → 3.0.72

package/README

@@ -1,4 +1,36 @@
 # E2E
 Se prueban los 3 casos:
 Standalone, desplegando la app buildeada 
-Widget y Libreria con el TestApp, 
+Widget y Libreria con el TestApp, 
+
+# Desarrollo contra lambdas locales
+
+Por defecto `/api` va a la API desplegada del dominio que diga `VITE_REACT_APP_DOMAIN` en `.env`
+(`api.forms.eureka-test.click`). Con la variable `LOCAL_LAMBDAS` va al dev server de serverless, que
+corre las lambdas desde el código de tu máquina — sin desplegar nada.
+
+Primero levantá el dev server en el repo de serverless (`npm start` en `serverless/devserver`), y después:
+
+```bash
+LOCAL_LAMBDAS=1 npm start                              # la app en :3003
+LOCAL_LAMBDAS=1 npm run storybook                      # las stories en :6006
+```
+
+La organización sale del subdominio, igual que desplegada: entrá por `http://arquimedes.localhost:3003`
+y las lambdas atienden a esa org (los navegadores resuelven cualquier subdominio de `localhost` a
+127.0.0.1). Para Storybook, o si preferís entrar por `localhost` pelado, hay que decirla:
+
+```bash
+LOCAL_LAMBDAS=1 LOCAL_ORG=arquimedes npm run storybook
+```
+
+Ambos comandos anuncian a dónde apuntan al arrancar.
+
+Variables:
+
+| variable | para qué |
+| --- | --- |
+| `LOCAL_LAMBDAS=1` | usar las lambdas locales en vez de la API desplegada |
+| `LOCAL_ORG` | la organización, si no entrás por `<org>.localhost` |
+| `DEVSERVER_PORT` | puerto del dev server, si no es 3100 |
+| `FORMS_API_TARGET` | apuntar a otro lado (un túnel, otro stage) e ignorar todo lo anterior |

package/dist/@Types/AvailabilityFormStep.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @deprecated Renombrado a CalendarFormStep.
+ * Este archivo existe solo para compatibilidad retroactiva.
+ * Usar `CalendarFormStep.ts` directamente.
+ */
+export type { AvailabilityStep } from './CalendarFormStep';
+export type { CalendarValue as AvailabilityValue } from './CalendarFormStep';
+export { CalendarEventCategory as AvailabilityEventCategory } from './CalendarFormStep';
+export { CalendarDefaultView } from './CalendarFormStep';
+export type { CalendarEventTemplate } from './CalendarFormStep';
+export type { CalendarEvent } from './CalendarFormStep';
+export declare enum AvailabilityMode {
+    WEEKLY = "WEEKLY",
+    SPECIFIC_DATES = "SPECIFIC_DATES",
+    COMBINED = "COMBINED"
+}
+export declare enum AvailabilityDayOfWeek {
+    MONDAY = 1,
+    TUESDAY = 2,
+    WEDNESDAY = 3,
+    THURSDAY = 4,
+    FRIDAY = 5,
+    SATURDAY = 6,
+    SUNDAY = 7
+}
+export interface AvailabilitySlot {
+    start: string;
+    end: string;
+}
+export interface AvailabilityDay {
+    day: AvailabilityDayOfWeek;
+    slots: AvailabilitySlot[];
+    recurrence?: string;
+}
+export interface AvailabilitySpecificDate {
+    date: string;
+    slots: AvailabilitySlot[];
+}
+export interface AvailabilityExclusion {
+    date?: string;
+    dateRange?: {
+        start: string;
+        end: string;
+    };
+    dayOfWeek?: AvailabilityDayOfWeek;
+    slots?: AvailabilitySlot[];
+    reason?: string;
+}

package/dist/@Types/AvailabilityFormStep.js

@@ -0,0 +1,24 @@
+/**
+ * @deprecated Renombrado a CalendarFormStep.
+ * Este archivo existe solo para compatibilidad retroactiva.
+ * Usar `CalendarFormStep.ts` directamente.
+ */
+export { CalendarEventCategory as AvailabilityEventCategory } from './CalendarFormStep';
+export { CalendarDefaultView } from './CalendarFormStep';
+// Tipos del draft original mantenidos para no romper código existente.
+export var AvailabilityMode;
+(function (AvailabilityMode) {
+    AvailabilityMode["WEEKLY"] = "WEEKLY";
+    AvailabilityMode["SPECIFIC_DATES"] = "SPECIFIC_DATES";
+    AvailabilityMode["COMBINED"] = "COMBINED";
+})(AvailabilityMode || (AvailabilityMode = {}));
+export var AvailabilityDayOfWeek;
+(function (AvailabilityDayOfWeek) {
+    AvailabilityDayOfWeek[AvailabilityDayOfWeek["MONDAY"] = 1] = "MONDAY";
+    AvailabilityDayOfWeek[AvailabilityDayOfWeek["TUESDAY"] = 2] = "TUESDAY";
+    AvailabilityDayOfWeek[AvailabilityDayOfWeek["WEDNESDAY"] = 3] = "WEDNESDAY";
+    AvailabilityDayOfWeek[AvailabilityDayOfWeek["THURSDAY"] = 4] = "THURSDAY";
+    AvailabilityDayOfWeek[AvailabilityDayOfWeek["FRIDAY"] = 5] = "FRIDAY";
+    AvailabilityDayOfWeek[AvailabilityDayOfWeek["SATURDAY"] = 6] = "SATURDAY";
+    AvailabilityDayOfWeek[AvailabilityDayOfWeek["SUNDAY"] = 7] = "SUNDAY";
+})(AvailabilityDayOfWeek || (AvailabilityDayOfWeek = {}));

package/dist/@Types/BankAccountFormStep.d.ts

@@ -0,0 +1,67 @@
+/**
+ * DRAFT — BankAccountFormStep types
+ *
+ * Paso para capturar información de una cuenta bancaria.
+ * Incluye banco, tipo de cuenta, número, país, moneda y titular opcional.
+ */
+import { GBaseStep } from './GenericFormSteps';
+export declare enum BankAccountType {
+    SAVINGS = "SAVINGS",
+    CHECKING = "CHECKING"
+}
+export interface BankAccountStep extends GBaseStep {
+    type: 'BANK_ACCOUNT';
+    label: string;
+    description: string | null;
+    required: boolean;
+    /**
+     * País predeterminado para filtrar la lista de bancos.
+     * Código ISO 3166-1 alpha-2 (ej: "CO", "US", "MX").
+     * El usuario puede cambiarlo si no se restringe.
+     */
+    defaultCountry?: string;
+    /**
+     * Si se define, solo se muestran bancos de estos países.
+     * Si no se define, se permite cualquier país.
+     */
+    allowedCountries?: string[];
+    /**
+     * Si se define, solo se muestran estas monedas.
+     * Códigos ISO 4217 (ej: ["COP", "USD"]).
+     */
+    allowedCurrencies?: string[];
+    /**
+     * Si true, se solicita información del titular de la cuenta
+     * (nombre / identificación).
+     */
+    requireHolder: boolean;
+    size: 1 | 2 | 3 | 4;
+}
+export interface BankAccountHolder {
+    /** Nombre completo del titular */
+    name?: string;
+    /**
+     * Referencia a un registro de identidad en Capta.
+     * Puede ser el id del contacto o el número de documento.
+     */
+    identityRef?: string;
+}
+export interface BankValue {
+    bank: {
+        /** Id interno del banco en el catálogo de Capta */
+        id: string;
+        /** Nombre display del banco */
+        label: string;
+    };
+    /**
+     * Tipo de cuenta. Se acepta string para bancos con tipos no estándar
+     * (ej: "NEQUI", "DAVIPLATA", "CORRIENTE_EXTERIOR").
+     */
+    accountType: BankAccountType | string;
+    accountNumber: string;
+    /** Código ISO 3166-1 alpha-2 del país */
+    country: string;
+    /** Código ISO 4217 de la moneda */
+    currency: string;
+    holder?: BankAccountHolder;
+}

package/dist/@Types/BankAccountFormStep.js

@@ -0,0 +1,14 @@
+/**
+ * DRAFT — BankAccountFormStep types
+ *
+ * Paso para capturar información de una cuenta bancaria.
+ * Incluye banco, tipo de cuenta, número, país, moneda y titular opcional.
+ */
+// ===========================================================================
+// Enums
+// ===========================================================================
+export var BankAccountType;
+(function (BankAccountType) {
+    BankAccountType["SAVINGS"] = "SAVINGS";
+    BankAccountType["CHECKING"] = "CHECKING";
+})(BankAccountType || (BankAccountType = {}));

package/dist/@Types/BookingFormStep.d.ts

@@ -0,0 +1,249 @@
+/**
+ * BookingFormStep — paso de agendamiento (flujo ligero).
+ *
+ * Permite que alguien externo agende en el calendario de una o varias personas.
+ * Flujo: (seleccionar persona) → seleccionar día → seleccionar hora.
+ *
+ * A diferencia del paso CALENDAR, este NO usa MUI X Scheduler:
+ * presenta una UI ligera de date-picker + lista de slots disponibles.
+ * La disponibilidad real la calcula el backend leyendo los calendarios referenciados.
+ */
+import { GBaseStep } from './GenericFormSteps';
+import FormStepTypes from '../constants/FormStepTypes';
+/**
+ * Modalidad de la cita.
+ */
+export declare enum BookingMode {
+    /** Presencial — requiere ubicación física. */
+    IN_PERSON = "IN_PERSON",
+    /** Virtual / remota (Meet, Teams, Zoom, etc.). */
+    VIRTUAL = "VIRTUAL",
+    /** Híbrida — se acuerda entre las partes. */
+    HYBRID = "HYBRID"
+}
+/**
+ * Cómo se maneja la selección de la persona a agendar.
+ */
+export declare enum PersonSelectionMode {
+    /**
+     * Un único calendario destino, sin selector de persona visible.
+     * El backend asigna automáticamente el slot disponible.
+     */
+    NONE = "NONE",
+    /**
+     * El usuario puede elegir una persona específica o dejar que el sistema asigne.
+     */
+    OPTIONAL = "OPTIONAL",
+    /**
+     * El usuario debe elegir una persona antes de ver los horarios disponibles.
+     */
+    REQUIRED = "REQUIRED"
+}
+/**
+ * De dónde sale el correo al que se envía la confirmación de la cita.
+ */
+export declare enum BookingContactEmailSourceTypes {
+    /** Un paso de correo anterior del formulario: el picker lo lee y no pide el correo. */
+    STEP = "STEP",
+    /** El picker pide el correo en el agendamiento, validado y obligatorio. */
+    FIELD = "FIELD"
+}
+/**
+ * El correo de confirmación del paso. `stepId` es obligatorio cuando `source === STEP`.
+ */
+export interface BookingContactEmail {
+    source: BookingContactEmailSourceTypes;
+    stepId?: string;
+}
+/**
+ * Whose mailbox organizes the meeting of a confirmed appointment. The backend resolves it; forms only
+ * mirrors the field.
+ */
+export declare enum BookingOrganizerSourceTypes {
+    /** The mailbox of the agent who takes the appointment. */
+    AGENT = "AGENT",
+    /** A fixed mailbox, `email`. */
+    MAILBOX = "MAILBOX"
+}
+/** The organizer of the step's meetings. `email` is required when `source === MAILBOX`. */
+export interface BookingOrganizer {
+    source: BookingOrganizerSourceTypes;
+    email?: string;
+}
+/**
+ * Perfil de una persona cuyo calendario se puede agendar.
+ */
+export interface BookablePerson {
+    /** Identificador único de la persona en el sistema. */
+    id: string;
+    /** Nombre visible en la UI de selección. */
+    name: string;
+    /** URL del avatar / foto de perfil. */
+    avatarUrl?: string;
+    /** Rol o cargo visible al usuario (ej: "Técnico", "Asesor comercial"). */
+    role?: string;
+    /** Descripción breve opcional. */
+    description?: string;
+}
+/**
+ * Paso de tipo `BOOKING`.
+ * UI ligera: persona → día → slot de hora.
+ */
+export interface BookingStep extends GBaseStep {
+    type: FormStepTypes.BOOKING;
+    label: string;
+    description: string | null;
+    required: boolean;
+    /** Modalidad de la cita (presencial, virtual, híbrida). */
+    bookingMode: BookingMode;
+    /**
+     * Tipo de atención sobre el que se agenda (plantilla de evento de la organización).
+     *
+     * Cuando está definido, solo se ofrecen las franjas que el agente abrió para
+     * ese mismo tipo de atención; las franjas generales (jornada laboral, presencial
+     * o virtual) quedan fuera de la oferta. La precedencia es absoluta: mientras
+     * exista al menos una franja de este tipo en el horizonte consultado, no se
+     * ofrece ninguna franja general.
+     */
+    idEventTemplate?: string;
+    /**
+     * Permite caer a las franjas generales cuando nadie abrió una franja para el
+     * `idEventTemplate` pedido.
+     *
+     * Solo entra en juego cuando no existe ninguna franja de ese tipo de atención en
+     * todo el horizonte; si existe aunque sea una, las generales siguen sin ofrecerse.
+     * Al caer a las generales se vuelve a aplicar la regla de `bookingMode`.
+     * No tiene efecto si no se definió `idEventTemplate`.
+     * @default false
+     */
+    fallbackToGeneral?: boolean;
+    /**
+     * With several event templates on offer, the requester picks one before the day and the hour.
+     * With a single template there is nothing to pick.
+     * @default true
+     */
+    requesterPicksType?: boolean;
+    /** Whose mailbox organizes the meeting; absent means the agent's. */
+    organizer?: BookingOrganizer;
+    /**
+     * Cómo se presenta la selección de persona al usuario.
+     * @default PersonSelectionMode.NONE
+     */
+    personSelectionMode?: PersonSelectionMode;
+    /**
+     * Lista de personas agendables.
+     * Requerido si `personSelectionMode` es `OPTIONAL` o `REQUIRED`.
+     */
+    persons?: BookablePerson[];
+    /**
+     * De dónde sale el correo de confirmación. El nombre del que agenda se pide siempre (o se reutiliza
+     * de un paso de nombre ya diligenciado); el correo lo lee de un paso anterior o lo pide el picker.
+     */
+    contactEmail: BookingContactEmail;
+    /** Duración en minutos de cada slot de cita. */
+    durationMinutes: number;
+    /**
+     * Buffer en minutos entre citas consecutivas.
+     * @default 0
+     */
+    bufferMinutes?: number;
+    /**
+     * Mínimo de horas de anticipación para agendar (ej: no se puede agendar con menos de 2h).
+     * @default 0
+     */
+    minNoticeHours?: number;
+    /**
+     * Máximo de días hacia el futuro en los que se pueden ver slots disponibles.
+     * @default 30
+     */
+    maxAdvanceDays?: number;
+    /**
+     * Minutos que se bloquea el slot mientras el usuario termina el formulario.
+     * Si no confirma a tiempo, el slot vuelve a estar disponible.
+     * @default 15
+     */
+    temporaryLockMinutes?: number;
+    /**
+     * Separación entre las horas de inicio ofrecidas, anclada al reloj; divisor de 60.
+     * @default 15
+     */
+    slotIntervalMinutes?: number;
+    /**
+     * Ofrece también el inicio de cada hueco que deja una reunión o una cita. Ausente cuenta como `true`.
+     * @default true
+     */
+    fillGaps?: boolean;
+    size: 1 | 2 | 3 | 4;
+}
+/**
+ * An event template the requester can pick, as the picker shows it. `id` is the offer's signed handle,
+ * never the template's id.
+ */
+export interface BookingEventTemplateOption {
+    id: string;
+    name: string;
+    description?: string;
+    durationMinutes: number;
+    bookingMode?: BookingMode;
+}
+/**
+ * Un slot de tiempo disponible para agendamiento.
+ * El backend calcula esto cruzando el calendario del profesional con el horario configurado.
+ */
+export interface BookingSlot {
+    /** ID único del slot (puede incluir personId, fecha y hora). */
+    id: string;
+    /** Hora de inicio en formato 24h `HH:mm`. */
+    startTime: string;
+    /** Hora de fin en formato 24h `HH:mm`. */
+    endTime: string;
+    /** Si el slot sigue disponible para ser reservado. */
+    available: boolean;
+    /** Instante ISO de inicio, cuando el host lo conoce; permite mostrar la hora en el reloj de quien agenda. */
+    start?: string;
+}
+/**
+ * Valor que se guarda tras completar un paso de tipo `BOOKING`.
+ */
+export interface BookingValue {
+    type: 'BOOKING_VALUE';
+    /** ID generado por el backend al bloquear el slot. */
+    slotId?: string;
+    /** Fecha de la cita en formato ISO `YYYY-MM-DD`. */
+    date: string;
+    /** Hora de inicio en formato 24h `HH:mm`. */
+    startTime: string;
+    /** Hora de fin en formato 24h `HH:mm`. */
+    endTime: string;
+    /** ID de la persona seleccionada o asignada. */
+    personId?: string;
+    /** Nombre de la persona (incluido si `personSelectionMode !== NONE`). */
+    personName?: string;
+    /** The event template the requester picked, as the hold answered it. */
+    eventTemplate?: {
+        name: string;
+        durationMinutes: number;
+    };
+    /** Nombre de contacto del que agenda (escrito en el picker o tomado de un paso de nombre). */
+    contactName?: string;
+    /** Correo de contacto del que agenda (escrito en el picker o tomado del paso de correo). */
+    contactEmail?: string;
+    /**
+     * Estado del slot en el ciclo de vida del formulario.
+     * - `PENDING`: bloqueado temporalmente, formulario sin enviar.
+     * - `CONFIRMED`: reserva en firme, formulario enviado.
+     */
+    status: 'PENDING' | 'CONFIRMED';
+    /** Timestamp ISO hasta el que está bloqueado el slot (cuando `status === 'PENDING'`). */
+    lockedUntil?: string;
+    /**
+     * La cita que el backend creó al bloquear el slot. Junto con `hold`, es lo que el envío del
+     * formulario necesita para convertir el bloqueo en una cita en firme.
+     */
+    appointment?: string;
+    /**
+     * Secreto que identifica al dueño del bloqueo. Solo quien lo tiene puede renovarlo, liberarlo o
+     * confirmarlo; viaja con el envío y el backend no lo conserva en el ticket.
+     */
+    hold?: string;
+}

package/dist/@Types/BookingFormStep.js

@@ -0,0 +1,65 @@
+/**
+ * BookingFormStep — paso de agendamiento (flujo ligero).
+ *
+ * Permite que alguien externo agende en el calendario de una o varias personas.
+ * Flujo: (seleccionar persona) → seleccionar día → seleccionar hora.
+ *
+ * A diferencia del paso CALENDAR, este NO usa MUI X Scheduler:
+ * presenta una UI ligera de date-picker + lista de slots disponibles.
+ * La disponibilidad real la calcula el backend leyendo los calendarios referenciados.
+ */
+// ===========================================================================
+// Enums
+// ===========================================================================
+/**
+ * Modalidad de la cita.
+ */
+export var BookingMode;
+(function (BookingMode) {
+    /** Presencial — requiere ubicación física. */
+    BookingMode["IN_PERSON"] = "IN_PERSON";
+    /** Virtual / remota (Meet, Teams, Zoom, etc.). */
+    BookingMode["VIRTUAL"] = "VIRTUAL";
+    /** Híbrida — se acuerda entre las partes. */
+    BookingMode["HYBRID"] = "HYBRID";
+})(BookingMode || (BookingMode = {}));
+/**
+ * Cómo se maneja la selección de la persona a agendar.
+ */
+export var PersonSelectionMode;
+(function (PersonSelectionMode) {
+    /**
+     * Un único calendario destino, sin selector de persona visible.
+     * El backend asigna automáticamente el slot disponible.
+     */
+    PersonSelectionMode["NONE"] = "NONE";
+    /**
+     * El usuario puede elegir una persona específica o dejar que el sistema asigne.
+     */
+    PersonSelectionMode["OPTIONAL"] = "OPTIONAL";
+    /**
+     * El usuario debe elegir una persona antes de ver los horarios disponibles.
+     */
+    PersonSelectionMode["REQUIRED"] = "REQUIRED";
+})(PersonSelectionMode || (PersonSelectionMode = {}));
+/**
+ * De dónde sale el correo al que se envía la confirmación de la cita.
+ */
+export var BookingContactEmailSourceTypes;
+(function (BookingContactEmailSourceTypes) {
+    /** Un paso de correo anterior del formulario: el picker lo lee y no pide el correo. */
+    BookingContactEmailSourceTypes["STEP"] = "STEP";
+    /** El picker pide el correo en el agendamiento, validado y obligatorio. */
+    BookingContactEmailSourceTypes["FIELD"] = "FIELD";
+})(BookingContactEmailSourceTypes || (BookingContactEmailSourceTypes = {}));
+/**
+ * Whose mailbox organizes the meeting of a confirmed appointment. The backend resolves it; forms only
+ * mirrors the field.
+ */
+export var BookingOrganizerSourceTypes;
+(function (BookingOrganizerSourceTypes) {
+    /** The mailbox of the agent who takes the appointment. */
+    BookingOrganizerSourceTypes["AGENT"] = "AGENT";
+    /** A fixed mailbox, `email`. */
+    BookingOrganizerSourceTypes["MAILBOX"] = "MAILBOX";
+})(BookingOrganizerSourceTypes || (BookingOrganizerSourceTypes = {}));