shori-sdk-ts 1.0.1

package/src/modules/caso/dto/response/casoSearchResponse.ts

@@ -0,0 +1,95 @@
+import { CasoFileSearchResponse } from "./casoFileSearchResponse";
+
+/**
+ * Respuesta de búsqueda de caso (de `search` / `searchAll`).
+ *
+ * IMPORTANTE: Los nombres de campo coinciden con los JSON de la API.
+ * El UUID del caso es el campo `caso` y el número de caso es `casoId` (número).
+ */
+export interface CasoSearchResponse {
+  /** UUID del caso (campo JSON: "caso") */
+  caso: string;
+  /** Uuid del caso*/
+  casoId: number;
+  /** Número del caso */
+  casoNumber?: number;
+  /** Datos del formulario en formato raw JSON string */
+  casoData?: string;
+  /** UUID del tipo de caso */
+  casoTypeId: string;
+  /** Nombre del producto */
+  casoTypeName: string;
+  /** Nombre interno del producto */
+  casoTypeSystemName: string;
+  casoTypeBlockedAssignment: boolean;
+  /** UUID del nivel secundario */
+  secondaryLevelId: string;
+  /** Nombre del nivel secundario */
+  secondaryLevel: string;
+  secondaryLevelSystemName: string;
+  /** UUID del nivel primario */
+  primaryLevelId: string;
+  /** Nombre del nivel primario */
+  primaryLevel: string;
+  primaryLevelSystemName: string;
+  ownerName: string;
+  /** UUID del usuario asignado */
+  assignedUserId?: string;
+  /** Nombre del usuario asignado */
+  assignedUserName?: string;
+  /** UUID del responsable */
+  responsibleId?: string;
+  /** Nombre del responsable */
+  responsibleName?: string;
+  /** UUID del subestado actual */
+  workingSubStateId: string;
+  /** Nombre del subestado actual */
+  workingSubStateName: string;
+  workingSubStateSystemName: string;
+  /** UUID del estado */
+  stateId?: string;
+  /** Estado del caso */
+  state?: string;
+  stateCode?: string;
+  slaStartDate?: string;
+  endCasoDate?: string;
+  reopenings: number;
+  /** ¿Es urgente? */
+  isUrgent?: boolean;
+  /** UUID de la prioridad */
+  priorityId?: string;
+  /** Nombre de la prioridad */
+  priorityName?: string;
+  prioritySystemName?: string;
+  /** ID externo */
+  externalId?: string;
+  importId?: string;
+  /** Fecha de creación */
+  createdAt?: string;
+  newData?: string;
+  /** Nivel de grupo */
+  groupLevel: number;
+  createdByName: string;
+  /** ¿Está finalizado? */
+  finalized?: boolean;
+  /** ¿SLA pausado? */
+  pausedSla?: boolean;
+  internalClient?: string;
+  pausedSlaDate?: string;
+  slaWorkingSubstateStartTime?: string;
+  slaWorkingSubstateDuration: number;
+  slaWorkingSubsateMaxDate?: string;
+  /** ¿En proceso? */
+  inProcess: boolean;
+  finalizeSla: boolean;
+  slaTimeLeft: number;
+  slaWorkingSubstateTimeLeft: number;
+  customGroupLevelLabel?: string;
+  lastUpdateDate?: string;
+  /** Asunto del caso */
+  subject?: string;
+  externalCreationDate?: string;
+  casoTypeCategoryId?: string;
+  casoTypeCategoryName?: string;
+  files: CasoFileSearchResponse[];
+}

package/src/modules/caso/dto/response/casoTypePrimaryLevelWorkingStateResponse.ts

@@ -0,0 +1,16 @@
+export interface CasoTypePrimaryLevelWorkingStateResponse {
+  id: string;
+  name: string;
+  description?: string;
+  associatedState: string;
+  associatedStateName: string;
+  defaultWorkingSubState: boolean;
+  slaTime: number;
+  pauseGeneralSla: boolean;
+  middlewareClient: boolean;
+  showSla: boolean;
+  finalist: boolean;
+  inUse: boolean;
+  finalizeSla: boolean;
+  active: boolean;
+}

package/src/modules/caso/dto/response/commentResponse.ts

@@ -0,0 +1,12 @@
+/** Un comentario individual */
+export interface CommentResponse {
+  id: string;
+  origin: string;
+  workingStateName: string;
+  userName: string;
+  comment: string;
+  createdAt: string;
+  resolutionGroup: string;
+  taskId: string;
+  internal?: string;
+}

package/src/modules/caso/dto/response/commentSearchResult.ts

@@ -0,0 +1,11 @@
+import { CommentResponse } from "./commentResponse";
+
+/** Resultado paginado de una búsqueda de comentarios */
+export interface CommentSearchResult {
+  /** Lista de comentarios de la página actual */
+  comments: CommentResponse[];
+  /** Total de comentarios */
+  count: number;
+  numElements: number;
+  pag: number;
+}

package/src/modules/caso/dto/response/fileCategoryResponse.ts

@@ -0,0 +1,6 @@
+export interface FileCategoryResponse {
+  categoryId: string;
+  name: string;
+  description: string;
+  categories: string[];
+}

package/src/modules/caso/dto/response/formResponse.ts

@@ -0,0 +1,26 @@
+/**
+ * Respuesta del formulario
+ */
+export interface FormResponse {
+  /**
+   * UUID del formulario
+   */
+  id: string;
+  /**
+   * UUID del formulario
+   */
+  formId: string;
+  /**
+   * UUID del tipo de formulario
+   */
+  formTypeId: string;
+  /**
+   * Nombre del tipo de formulario
+   */
+  formTypeName: string;
+  /**
+   * Código
+   */
+  code: string;
+  active: boolean;
+}

package/src/modules/caso/dto/response/groupLevelLabelResponse.ts

@@ -0,0 +1,4 @@
+export interface GroupLevelLabelResponse {
+  groupLevel: number;
+  customGroupLevelLabel: string;
+}

package/src/modules/caso/dto/response/permissionResponse.ts

@@ -0,0 +1,11 @@
+export interface PermissionResponse {
+  id: string;
+  groupId: string;
+  groupName: string;
+  create: boolean;
+  view: boolean;
+  update: boolean;
+  groupLevel: number;
+  clientGroup: boolean;
+  customGroupLevelLabel: string;
+}

package/src/modules/caso/dto/response/priorityResponse.ts

@@ -0,0 +1,10 @@
+import { TranslationResponse } from "./translationResponse";
+
+export interface PriorityResponse {
+  id: string;
+  name: string;
+  systemName: string;
+  weight: number;
+  active: boolean;
+  translations: TranslationResponse[];
+}

package/src/modules/caso/dto/response/productResponse.ts

@@ -0,0 +1,64 @@
+import { ActionResponse } from "./actionResponse";
+import { CaseDataFieldResponse } from "./caseDataFieldResponse";
+import { CasoTypePrimaryLevelWorkingStateResponse } from "./casoTypePrimaryLevelWorkingStateResponse";
+import { FormResponse } from "./formResponse";
+import { GroupLevelLabelResponse } from "./groupLevelLabelResponse";
+import { PermissionResponse } from "./permissionResponse";
+import { PriorityResponse } from "./priorityResponse";
+import { TypologyResponse } from "./typologyResponse";
+
+/**
+ * Respuesta con información de un producto/tipo de caso.
+ */
+export interface ProductResponse {
+  createdAt: string;
+  createdBy: string;
+  updatedAt: string;
+  updatedBy: string;
+  casoTypeId: string;
+  name: string;
+  systemName: string;
+  description: string;
+  secondaryLevelId: string;
+  secondaryLevelName: string;
+  secondaryLevelActive: boolean;
+  primaryLevelId: string;
+  primaryLevelName: string;
+  primaryLevelActive: boolean;
+  active: boolean;
+  blockedAssignment: boolean;
+  filePermitted: boolean;
+  validationFiles: boolean;
+  comments: boolean;
+  showHistory: boolean;
+  draft: boolean;
+  viewFiles: boolean;
+  deallocationTypeCode: string;
+  ownerId: string;
+  ownerName: string;
+  assignedUserId: string;
+  assignedUserName: string;
+  defaultPriority: PriorityResponse;
+  casoTypePrimaryLevelWorkingStates: CasoTypePrimaryLevelWorkingStateResponse[];
+  actions: ActionResponse[];
+  permissions: PermissionResponse[];
+  casoDataFields: CaseDataFieldResponse[];
+  forms: FormResponse[];
+  priorities: PriorityResponse[];
+  typologies: TypologyResponse[];
+  groupLevelActive: boolean;
+  slaTime: number;
+  worklog: string;
+  defaultWorkingSubStates: boolean;
+  generalSla: boolean;
+  inProgress: boolean;
+  timezone: string;
+  encryptfiles: boolean;
+  groupLevelLabels: GroupLevelLabelResponse[];
+  useExternalCreationDate: boolean;
+  fileCategoryAvailable: boolean;
+  customCategory: boolean;
+  internalComment: boolean;
+  capacityGapLowerThresholdPercent: number;
+  capacityGapUpperThresholdPercent: number;
+}

package/src/modules/caso/dto/response/translationResponse.ts

@@ -0,0 +1,5 @@
+export interface TranslationResponse {
+  codeLang: string;
+  translation: string;
+  defaultTranslation: string;
+}

package/src/modules/caso/dto/response/typologyResponse.ts

@@ -0,0 +1,12 @@
+import { FileCategoryResponse } from "./fileCategoryResponse";
+
+/** Tipología de archivo y sus categorías asociadas */
+export interface TypologyResponse {
+  typologyId: string;
+  name: string;
+  label: string;
+  encryptData: boolean;
+  parentTypology: string;
+  casoType: string;
+  filesCategory: FileCategoryResponse[];
+}

package/src/modules/caso/filter/caseFilter.ts

@@ -0,0 +1,337 @@
+import { z } from "zod";
+import { buildDateFilter } from "../../../utils/shoriUtil.js";
+import { FilterOperator } from "./filterOperator.js";
+import { SortDirection } from "./sortDirection.js";
+
+// ── Schema de validación Zod ──────────────────────────────────────────────────
+
+/**
+ * Schema Zod para `CaseFilter`.
+ * Aplica defaults y valida al llamar `build()`.
+ */
+export const CaseFilterSchema = z.object({
+  workingSubStateId: z
+    .string({ error: "workingSubStateId es requerido" })
+    .min(1, "workingSubStateId no puede estar vacío"),
+  casoId: z.string().optional(),
+  casoTypeId: z.string().optional(),
+  primaryLevelId: z.string().optional(),
+  secondaryLevelId: z.string().optional(),
+  createdAt: z.string().optional(),
+  casoData: z
+    .array(z.object({ fieldId: z.string(), fieldValue: z.string() }))
+    .default([]),
+  pagination: z.object({
+    pageNumber: z.number().int().min(0).default(0),
+    pageSize: z.number().int().min(1).max(200).default(20),
+    orderBy: z.string().default("createdAt"),
+    sortDirection: z.nativeEnum(SortDirection).default(SortDirection.DESC),
+  }),
+});
+
+/** Tipo inferido del schema */
+export type CaseFilterData = z.infer<typeof CaseFilterSchema>;
+
+// ── Tipos internos ────────────────────────────────────────────────────────────
+
+interface SearchCaseDataItem {
+  fieldId: string;
+  fieldValue: string;
+}
+
+// ── Clase principal ───────────────────────────────────────────────────────────
+
+/**
+ * Resultado de `CaseFilterBuilder.build()` — objeto inmutable listo para enviar al API.
+ *
+ * Los campos son `readonly` y públicos: `JSON.stringify` los serializa
+ * directamente sin necesitar `toJSON()`.
+ *
+ * @example
+ * ```ts
+ * const filter = CaseFilter.builder()
+ *   .casoTypeId(FilterOperator.EQ, "tipo-uuid")
+ *   .workingSubStateId(FilterOperator.IN, "estado-1", "estado-2")
+ *   .pageSize(20)
+ *   .build(); // ← retorna CaseFilter (inmutable)
+ *
+ * const result = await client.caso().search(filter);
+ *
+ * // Manejo de error Zod
+ * try {
+ *   CaseFilter.builder().build(); // workingSubStateId faltante
+ * } catch (err) {
+ *   if (err instanceof z.ZodError) {
+ *     err.issues.forEach(i => console.error(i.path[0], i.message));
+ *   }
+ * }
+ * ```
+ */
+export class CaseFilter {
+  readonly workingSubStateId: string;
+  readonly casoId?: string;
+  readonly casoTypeId?: string;
+  readonly primaryLevelId?: string;
+  readonly secondaryLevelId?: string;
+  readonly createdAt?: string;
+  readonly casoData: SearchCaseDataItem[];
+  readonly pagination: {
+    pageNumber: number;
+    pageSize: number;
+    orderBy: string;
+    sortDirection: SortDirection;
+  };
+
+  /** @internal — usar {@link CaseFilter.builder()} */
+  private constructor(data: CaseFilterData) {
+    this.workingSubStateId = data.workingSubStateId;
+    this.casoId = data.casoId;
+    this.casoTypeId = data.casoTypeId;
+    this.primaryLevelId = data.primaryLevelId;
+    this.secondaryLevelId = data.secondaryLevelId;
+    this.createdAt = data.createdAt;
+    this.casoData = data.casoData;
+    this.pagination = data.pagination;
+  }
+
+  /**
+   * Crea un nuevo Builder para construir una instancia de `CaseFilter`.
+   */
+  static builder(): _CaseFilterBuilder {
+    return new _CaseFilterBuilder();
+  }
+
+  /** @internal */
+  static _create(data: CaseFilterData): CaseFilter {
+    return new CaseFilter(data);
+  }
+
+  // ── Internos para CaseModule (paginación) ─────────────────────────────────
+
+  /** @internal */
+  getPageNumber(): number {
+    return this.pagination.pageNumber;
+  }
+  /** @internal */
+  getPageSize(): number {
+    return this.pagination.pageSize;
+  }
+
+  /** @internal — crea copia para la siguiente página */
+  copyForNextPage(): CaseFilter {
+    return CaseFilter._create({
+      workingSubStateId: this.workingSubStateId,
+      casoId: this.casoId,
+      casoTypeId: this.casoTypeId,
+      primaryLevelId: this.primaryLevelId,
+      secondaryLevelId: this.secondaryLevelId,
+      createdAt: this.createdAt,
+      casoData: this.casoData,
+      pagination: {
+        ...this.pagination,
+        pageNumber: this.pagination.pageNumber + 1,
+      },
+    });
+  }
+}
+
+// ── Builder ───────────────────────────────────────────────────────────────────
+
+/**
+ * Builder fluido para `CaseFilter`.
+ *
+ * La validación ocurre en `build()` con Zod.
+ * Obtén una instancia con `CaseFilter.builder()`.
+ */
+export class _CaseFilterBuilder {
+  private _casoId?: string;
+  private _casoTypeId?: string;
+  private _primaryLevelId?: string;
+  private _secondaryLevelId?: string;
+  private _workingSubStateId?: string;
+  private _createdAt?: string;
+  private _casoData: SearchCaseDataItem[] = [];
+  private _pageNumber?: number;
+  private _pageSize?: number;
+  private _orderBy?: string;
+  private _sortDir?: SortDirection;
+
+  // ── Filtros principales ───────────────────────────────────────────────────
+
+  /** Filtra por número de caso. @example `.casoNumber(FilterOperator.EQ, "uuid")` */
+  casoNumber(
+    operatorOrValue: FilterOperator | string,
+    ...values: string[]
+  ): this {
+    this._casoId =
+      operatorOrValue instanceof FilterOperator
+        ? operatorOrValue.apply(...values)
+        : FilterOperator.IN.apply(operatorOrValue, ...values);
+    return this;
+  }
+
+  /** Filtra por UUID del tipo de caso. @example `.casoTypeId(FilterOperator.EQ, "tipo-uuid")` */
+  casoTypeId(
+    operatorOrValue: FilterOperator | string,
+    ...values: string[]
+  ): this {
+    this._casoTypeId =
+      operatorOrValue instanceof FilterOperator
+        ? operatorOrValue.apply(...values)
+        : FilterOperator.IN.apply(operatorOrValue, ...values);
+    return this;
+  }
+
+  /** Filtra por UUID del nivel primario (servicio). */
+  primaryLevelId(
+    operatorOrValue: FilterOperator | string,
+    ...values: string[]
+  ): this {
+    this._primaryLevelId =
+      operatorOrValue instanceof FilterOperator
+        ? operatorOrValue.apply(...values)
+        : FilterOperator.IN.apply(operatorOrValue, ...values);
+    return this;
+  }
+
+  /** Filtra por UUID del nivel secundario (proceso). */
+  secondaryLevelId(
+    operatorOrValue: FilterOperator | string,
+    ...values: string[]
+  ): this {
+    this._secondaryLevelId =
+      operatorOrValue instanceof FilterOperator
+        ? operatorOrValue.apply(...values)
+        : FilterOperator.IN.apply(operatorOrValue, ...values);
+    return this;
+  }
+
+  /**
+   * Filtra por UUID del subestado de trabajo. **Requerido.**
+   * @example `.workingSubStateId(FilterOperator.IN, "estado-1", "estado-2")`
+   */
+  workingSubStateId(
+    operatorOrValue: FilterOperator | string,
+    ...values: string[]
+  ): this {
+    this._workingSubStateId =
+      operatorOrValue instanceof FilterOperator
+        ? operatorOrValue.apply(...values)
+        : FilterOperator.IN.apply(operatorOrValue, ...values);
+    return this;
+  }
+
+  // ── Filtros de fecha ──────────────────────────────────────────────────────
+
+  /** Filtra por rango de fecha de creación. @example `.createdAt("2024-01-01", "2024-12-31", "America/Lima")` */
+  createdAt(
+    startDate: string | null,
+    endDate: string | null,
+    timeZone: string,
+  ): this {
+    this._createdAt =
+      buildDateFilter(startDate, endDate, timeZone) ?? undefined;
+    return this;
+  }
+  createdAtFrom(startDate: string, timeZone: string): this {
+    return this.createdAt(startDate, null, timeZone);
+  }
+  createdAtTo(endDate: string, timeZone: string): this {
+    return this.createdAt(null, endDate, timeZone);
+  }
+
+  // ── Filtros de datos del formulario ───────────────────────────────────────
+
+  /** Agrega filtro sobre un campo dinámico del formulario. @example `.dataField("nombre", FilterOperator.LIKE, "García")` */
+  dataField(
+    fieldId: string,
+    operator: FilterOperator,
+    ...values: string[]
+  ): this {
+    const fieldValue =
+      operator === FilterOperator.IS_NULL ||
+      operator === FilterOperator.IS_NOT_NULL
+        ? operator.apply()
+        : operator.apply(...values);
+    this._casoData.push({ fieldId, fieldValue });
+    return this;
+  }
+  dataEquals(fieldId: string, value: string): this {
+    return this.dataField(fieldId, FilterOperator.EQ, value);
+  }
+  dataLike(fieldId: string, value: string): this {
+    return this.dataField(fieldId, FilterOperator.LIKE, value);
+  }
+  dataStartsWith(fieldId: string, value: string): this {
+    return this.dataField(fieldId, FilterOperator.LIKE_AFTER, value);
+  }
+  dataBetween(fieldId: string, from: string, to: string): this {
+    return this.dataField(fieldId, FilterOperator.BETWEEN, from, to);
+  }
+  dataIn(fieldId: string, ...values: string[]): this {
+    return this.dataField(fieldId, FilterOperator.IN, ...values);
+  }
+  dataIsNull(fieldId: string): this {
+    return this.dataField(fieldId, FilterOperator.IS_NULL);
+  }
+  dataIsNotNull(fieldId: string): this {
+    return this.dataField(fieldId, FilterOperator.IS_NOT_NULL);
+  }
+
+  // ── Paginación ────────────────────────────────────────────────────────────
+
+  /** Número de página (0-indexado). Zod default: `0`. */
+  pageNumber(n: number): this {
+    this._pageNumber = n;
+    return this;
+  }
+  /** Tamaño de página (1-200). Zod default: `20`. */
+  pageSize(size: number): this {
+    this._pageSize = size;
+    return this;
+  }
+  /** Campo de ordenamiento. Zod default: `"createdAt"`. */
+  orderBy(field: string): this {
+    this._orderBy = field;
+    return this;
+  }
+  /** Dirección de ordenamiento. Zod default: `DESC`. */
+  sortDirection(dir: SortDirection): this {
+    this._sortDir = dir;
+    return this;
+  }
+
+  // ── build() ───────────────────────────────────────────────────────────────
+
+  /**
+   * Aplica operadores implícitos, valida con Zod y retorna `CaseFilter` inmutable.
+   *
+   * @throws {z.ZodError} si `workingSubStateId` falta o la paginación es inválida
+   * @returns `CaseFilter` — instancia inmutable lista para enviar al API
+   */
+  build(): CaseFilter {
+    const applyIn = (v?: string) =>
+      v && !FilterOperator.hasOperator(v) ? `in:${v}` : v;
+    const applyInToData = (item: SearchCaseDataItem) =>
+      item.fieldValue && !item.fieldValue.match(/^\w+:/)
+        ? { ...item, fieldValue: `in:${item.fieldValue}` }
+        : item;
+
+    const data = CaseFilterSchema.parse({
+      workingSubStateId: applyIn(this._workingSubStateId),
+      casoId: applyIn(this._casoId),
+      casoTypeId: applyIn(this._casoTypeId),
+      primaryLevelId: applyIn(this._primaryLevelId),
+      secondaryLevelId: applyIn(this._secondaryLevelId),
+      createdAt: this._createdAt,
+      casoData: this._casoData.map(applyInToData),
+      pagination: {
+        pageNumber: this._pageNumber,
+        pageSize: this._pageSize,
+        orderBy: this._orderBy,
+        sortDirection: this._sortDir,
+      },
+    });
+    return CaseFilter._create(data);
+  }
+}