import type { OriginationQuestion, OriginationRule, OriginationStep, OriginationTask, StepWrite } from "@repositories/customers/originations/OriginationsTypes.js"; /** * Reconciliación de `customers-origination-steps-manage` (#142, #289): lo que * pide el llamador contra lo que ya existe, nivel por nivel y siempre dentro * del padre. Medido en un realm de prueba el 2026-10-26: * - `accepts_nested_attributes_for` no borra lo ausente: hace falta * `{ id, _destroy: true }`, y basta con eso en cualquier nivel; * - un `id` existente bajo otro padre responde 404: mover es borrar en el * padre original y crear sin `id` en el nuevo, en el mismo `PUT`, y el * elemento recreado (con todo lo que cuelga de él) recibe otro `uuid`; * - una alternativa sin `id` cuyo label ya existe en la pregunta responde 409: * se emparejan por label sin distinguir mayúsculas, como valida la API; * - el `uid` de tarea es único en la originación y el de pregunta, en la * tarea; * - una `choice` creada sin alternativas responde 409. * Recrear un elemento hace lo mismo que la escritura en su lugar: lo que el * llamador omite (alternativas, hijas, textos de ayuda, `options`, * `description`) se copia del anterior, y con `merge` también lo que no envía * de sus colecciones (preguntas, hijas, alternativas), salvo lo que pidió en * otro lugar de la tarea. */ /** Pregunta tal como la pide el llamador: `name` es opcional (#284). */ export type QuestionInput = Omit & { name?: string | undefined; alternatives?: Array<{ label: string; position: number; checked?: boolean | undefined; }> | undefined; children?: QuestionInput[] | undefined; }; export type TaskInput = Omit & { questions?: QuestionInput[] | undefined; }; export type StepInput = Omit & { tasks: TaskInput[]; }; /** * Elemento existente que la escritura borra o recrea. Una alternativa * (`uid` es su label) también puede quedar con otro label (`relabeledTo`). */ export interface RemovedElement { type: "step" | "task" | "question" | "alternative"; uid: string; uuid: string | undefined; /** Dónde estaba (`step s`, `task t`, `question g`); un step no tiene. */ parent: string | undefined; /** `answers_count` de una pregunta; 0 en los demás. */ answers: number; /** De una alternativa: el `uuid` de su pregunta. */ questionUuid?: string | undefined; /** De una alternativa que se conserva con otro label: el label nuevo. */ relabeledTo?: string | undefined; } export interface Reconciliation { steps: StepWrite[]; /** Todo lo existente que se borra o se recrea, con lo que cuelga de ello. */ removed: RemovedElement[]; /** Steps que quedarían sin tareas: la API los rechaza con 409. */ emptied: string[]; } type Strategy = "merge" | "replace"; export declare function reconcileSteps(sent: StepInput[], current: OriginationStep[], strategy: Strategy): Reconciliation; export interface ReferencedElement extends RemovedElement { /** Posición (desde 1) de cada regla que lo referencia. */ rules: number[]; } /** Elementos que se borran o recrean y que alguna regla referencia. */ export declare function referencedByRules(removed: RemovedElement[], rules: OriginationRule[] | null | undefined): ReferencedElement[]; /** Etiqueta legible de un elemento: `task t under step s`. */ export declare function describeElement(element: RemovedElement): string; export {}; //# sourceMappingURL=stepsReconcile.d.ts.map