shori-sdk-ts 1.0.1

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

@@ -0,0 +1,191 @@
+import { z } from "zod";
+import { buildDateFilter } from "../../../utils/shoriUtil.js";
+import { SortDirection } from "./sortDirection.js";
+
+// ── Schema de validación Zod ──────────────────────────────────────────────────
+
+/**
+ * Schema Zod para validar `CommentFilter` en `build()`.
+ *
+ * El campo `casoId` es **requerido**.
+ * Se puede usar también para validar datos externos.
+ */
+export const CommentFilterSchema = z.object({
+  /** UUID del caso. **Requerido.** */
+  casoId: z
+    .string({ error: "casoId es requerido" })
+    .min(1, "casoId no puede estar vacío"),
+  /** Filtro de fecha de creación (calculado internamente). Opcional. */
+  createdAt: z.string().optional(),
+  /** Tamaño de página. Debe ser entre 1 y 200. Por defecto: 20. */
+  pageSize: z
+    .number()
+    .int("pageSize debe ser un entero")
+    .min(1, "pageSize debe ser ≥ 1")
+    .max(200, "pageSize no puede superar 200")
+    .default(20),
+  /** Número de página (0-indexado). Por defecto: 0. */
+  pageNumber: z
+    .number()
+    .int("pageNumber debe ser un entero")
+    .min(0, "pageNumber debe ser ≥ 0")
+    .default(0),
+  /** Dirección de ordenamiento. Por defecto: DESC. */
+  sortDirection: z.nativeEnum(SortDirection).default(SortDirection.DESC),
+});
+
+// ── Clase principal ───────────────────────────────────────────────────────────
+
+/**
+ * Filtro fluido para búsqueda de comentarios de casos en Shori.
+ *
+ * El campo `casoId` es **requerido** — `build()` lanza `ZodError` si no se especifica.
+ * Se usa con `client.caso().comment().search(filter)`.
+ *
+ * @example
+ * ```ts
+ * // Últimos 20 comentarios de un caso
+ * const result = await client.caso().comment().search(
+ *   new CommentFilter()
+ *     .casoId("caso-uuid")
+ *     .pageSize(20)
+ *     .build()
+ * );
+ *
+ * // Filtrado por rango de fechas
+ * const result = await client.caso().comment().search(
+ *   new CommentFilter()
+ *     .casoId("caso-uuid")
+ *     .createdAt("2024-01-01", "2024-01-31", "America/Lima")
+ *     .build()
+ * );
+ *
+ * // Con ordenamiento ascendente (más antiguos primero)
+ * const result = await client.caso().comment().search(
+ *   new CommentFilter()
+ *     .casoId("caso-uuid")
+ *     .sortDirection(SortDirection.ASC)
+ *     .build()
+ * );
+ *
+ * // Manejo de error Zod
+ * try {
+ *   new CommentFilter().build(); // casoId no especificado
+ * } catch (err) {
+ *   if (err instanceof z.ZodError) {
+ *     err.issues.forEach(i => console.error(i.path[0], i.message));
+ *   }
+ * }
+ * ```
+ */
+export class CommentFilter {
+  private _casoId?: string;
+  private _createdAt?: string;
+  private _pageNumber = 0;
+  private _pageSize = 20;
+  private _sortDir = SortDirection.DESC;
+
+  /**
+   * UUID del caso cuyos comentarios se quieren obtener. **Requerido.**
+   *
+   * @param id - UUID del caso
+   */
+  casoId(id: string): this {
+    this._casoId = id;
+    return this;
+  }
+
+  /**
+   * Filtra comentarios por rango de fecha de creación, convirtiendo a UTC.
+   *
+   * @example
+   * ```ts
+   * .createdAt("2024-01-01", "2024-01-31", "America/Lima")
+   * ```
+   *
+   * @param startDate - Fecha de inicio `yyyy-MM-dd`
+   * @param endDate - Fecha de fin `yyyy-MM-dd` (inclusive)
+   * @param timeZone - Zona horaria local (ej: `"America/Lima"`)
+   */
+  createdAt(startDate: string, endDate: string, timeZone: string): this {
+    this._createdAt =
+      buildDateFilter(startDate, endDate, timeZone) ?? undefined;
+    return this;
+  }
+
+  /** Número de página (0-indexado). Por defecto: `0`. */
+  pageNumber(n: number): this {
+    this._pageNumber = n;
+    return this;
+  }
+
+  /** Tamaño de página. Debe ser entre 1 y 200. Por defecto: `20`. */
+  pageSize(size: number): this {
+    this._pageSize = size;
+    return this;
+  }
+
+  /** Dirección de ordenamiento. Por defecto: `SortDirection.DESC`. */
+  sortDirection(dir: SortDirection): this {
+    this._sortDir = dir;
+    return this;
+  }
+
+  /**
+   * Valida la configuración con Zod y retorna este mismo objeto.
+   *
+   * @throws {z.ZodError} si `casoId` no fue especificado o algún campo es inválido
+   * @returns `this`
+   */
+  build(): this {
+    CommentFilterSchema.parse({
+      casoId: this._casoId,
+      createdAt: this._createdAt,
+      pageSize: this._pageSize,
+      pageNumber: this._pageNumber,
+      sortDirection: this._sortDir,
+    });
+    return this;
+  }
+
+  // ── Serialización ─────────────────────────────────────────────────────────
+
+  /** Serializa el filtro al formato que espera el API de Shori */
+  toJSON(): Record<string, unknown> {
+    return {
+      casoId: this._casoId,
+      createdAt: this._createdAt,
+      pagination: {
+        pageNumber: this._pageNumber,
+        pageSize: this._pageSize,
+        sortDirection: this._sortDir,
+      },
+    };
+  }
+
+  // ── Internos ──────────────────────────────────────────────────────────────
+
+  /** @internal */
+  getPageNumber(): number {
+    return this._pageNumber;
+  }
+  /** @internal */
+  getPageSize(): number {
+    return this._pageSize;
+  }
+  /** @internal */
+  applyDefaultInOperators(): void {
+    /* no-op */
+  }
+
+  /** @internal */
+  copyForNextPage(): CommentFilter {
+    const copy = new CommentFilter();
+    copy._casoId = this._casoId;
+    copy._createdAt = this._createdAt;
+    copy._pageNumber = this._pageNumber + 1;
+    copy._pageSize = this._pageSize;
+    copy._sortDir = this._sortDir;
+    return copy;
+  }
+}

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

@@ -0,0 +1,77 @@
+/**
+ * Operadores de filtrado disponibles en la API de Shori.
+ *
+ * @example
+ * ```ts
+ * FilterOperator.EQ.apply("valor")         // "eq:valor"
+ * FilterOperator.IN.apply("a", "b", "c")   // "in:a, b, c"
+ * FilterOperator.BETWEEN.apply("1", "100") // "bt:1, 100"
+ * FilterOperator.IS_NULL.apply()           // "null:"
+ * FilterOperator.LIKE.apply("García")      // "lk:García"
+ * ```
+ */
+export class FilterOperator {
+  static readonly EQ = new FilterOperator("eq");
+  static readonly NE = new FilterOperator("ne");
+  static readonly GT = new FilterOperator("gt");
+  static readonly GE = new FilterOperator("ge");
+  static readonly LT = new FilterOperator("lt");
+  static readonly LE = new FilterOperator("le");
+  static readonly IN = new FilterOperator("in");
+  static readonly NOT_IN = new FilterOperator("notin");
+  static readonly BETWEEN = new FilterOperator("bt");
+  static readonly LIKE = new FilterOperator("lk");
+  static readonly LIKE_BEFORE = new FilterOperator("lkb");
+  static readonly LIKE_AFTER = new FilterOperator("lka");
+  static readonly IS_NULL = new FilterOperator("null");
+  static readonly IS_NOT_NULL = new FilterOperator("notnull");
+
+  private constructor(readonly symbol: string) {}
+
+  /**
+   * Aplica el operador a uno o varios valores.
+   *
+   * @example
+   * ```ts
+   * FilterOperator.EQ.apply("valor")       // "eq:valor"
+   * FilterOperator.IN.apply("a", "b")      // "in:a, b"
+   * FilterOperator.IS_NULL.apply()         // "null:"
+   * ```
+   */
+  apply(...values: string[]): string {
+    if (
+      this === FilterOperator.IS_NULL ||
+      this === FilterOperator.IS_NOT_NULL
+    ) {
+      return `${this.symbol}:`;
+    }
+    if (values.length === 0) return `${this.symbol}:`;
+    if (values.length === 1) return `${this.symbol}:${sanitize(values[0])}`;
+    return `${this.symbol}:${values.map(sanitize).join(", ")}`;
+  }
+
+  /** Verifica si un valor ya tiene un operador aplicado */
+  static hasOperator(value: string): boolean {
+    const all = [
+      FilterOperator.EQ,
+      FilterOperator.NE,
+      FilterOperator.GT,
+      FilterOperator.GE,
+      FilterOperator.LT,
+      FilterOperator.LE,
+      FilterOperator.IN,
+      FilterOperator.NOT_IN,
+      FilterOperator.BETWEEN,
+      FilterOperator.LIKE,
+      FilterOperator.LIKE_BEFORE,
+      FilterOperator.LIKE_AFTER,
+      FilterOperator.IS_NULL,
+      FilterOperator.IS_NOT_NULL,
+    ];
+    return all.some((op) => value.startsWith(`${op.symbol}:`));
+  }
+}
+
+function sanitize(value: string): string {
+  return value.replace(/,/g, "(#%%#)");
+}

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

@@ -0,0 +1,236 @@
+import { z } from "zod";
+import { FilterOperator } from "./filterOperator.js";
+import { SortDirection } from "./sortDirection.js";
+
+// ── Schema de validación Zod ──────────────────────────────────────────────────
+
+export const PrimaryLevelFilterSchema = z.object({
+  primaryLevelId: z.string().optional(),
+  name: z.string().optional(),
+  systemName: z.string().optional(),
+  responsibleId: z.string().optional(),
+  isActive: z.string().optional(),
+  secondaryLevelCount: z.string().optional(),
+  groupId: z.string().optional(),
+  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("name"),
+    sortDirection: z.nativeEnum(SortDirection).default(SortDirection.DESC),
+  }),
+});
+
+export type PrimaryLevelFilterData = z.infer<typeof PrimaryLevelFilterSchema>;
+
+// ── Clase principal ───────────────────────────────────────────────────────────
+
+/**
+ * Resultado de `PrimaryLevelFilter.builder().build()` — objeto inmutable.
+ *
+ * Los campos son `readonly` y públicos: `JSON.stringify` los serializa
+ * directamente sin necesitar `toJSON()`.
+ *
+ * Se usa con `client.caso().primaryLevel().search(filter)`.
+ *
+ * @example
+ * ```ts
+ * const filter = PrimaryLevelFilter.builder()
+ *   .name(FilterOperator.LIKE, "Atención")
+ *   .isActive(FilterOperator.EQ, "true")
+ *   .pageSize(50)
+ *   .build();
+ *
+ * // IN implícito
+ * const filter = PrimaryLevelFilter.builder()
+ *   .primaryLevelId("uuid-1", "uuid-2")
+ *   .build();
+ * ```
+ */
+export class PrimaryLevelFilter {
+  readonly primaryLevelId?: string;
+  readonly name?: string;
+  readonly systemName?: string;
+  readonly responsibleId?: string;
+  readonly isActive?: string;
+  readonly secondaryLevelCount?: string;
+  readonly groupId?: string;
+  readonly pagination: {
+    pageNumber: number;
+    pageSize: number;
+    orderBy: string;
+    sortDirection: SortDirection;
+  };
+
+  private constructor(data: PrimaryLevelFilterData) {
+    this.primaryLevelId = data.primaryLevelId;
+    this.name = data.name;
+    this.systemName = data.systemName;
+    this.responsibleId = data.responsibleId;
+    this.isActive = data.isActive;
+    this.secondaryLevelCount = data.secondaryLevelCount;
+    this.groupId = data.groupId;
+    this.pagination = data.pagination;
+  }
+
+  static builder(): _PrimaryLevelFilterBuilder {
+    return new _PrimaryLevelFilterBuilder();
+  }
+
+  static _create(data: PrimaryLevelFilterData): PrimaryLevelFilter {
+    return new PrimaryLevelFilter(data);
+  }
+
+  /** @internal */
+  getPageNumber(): number {
+    return this.pagination.pageNumber;
+  }
+  /** @internal */
+  getPageSize(): number {
+    return this.pagination.pageSize;
+  }
+
+  /** @internal */
+  copyForNextPage(): PrimaryLevelFilter {
+    return PrimaryLevelFilter._create({
+      ...this,
+      pagination: {
+        ...this.pagination,
+        pageNumber: this.pagination.pageNumber + 1,
+      },
+    });
+  }
+}
+
+// ── Builder ───────────────────────────────────────────────────────────────────
+
+/**
+ * Builder fluido para `PrimaryLevelFilter`.
+ * Obtén una instancia con `PrimaryLevelFilter.builder()`.
+ */
+export class _PrimaryLevelFilterBuilder {
+  private _primaryLevelId?: string;
+  private _name?: string;
+  private _systemName?: string;
+  private _responsibleId?: string;
+  private _isActive?: string;
+  private _secondaryLevelCount?: string;
+  private _groupId?: string;
+  private _pageNumber?: number;
+  private _pageSize?: number;
+  private _orderBy?: string;
+  private _sortDir?: SortDirection;
+
+  primaryLevelId(
+    operatorOrValue: FilterOperator | string,
+    ...values: string[]
+  ): this {
+    this._primaryLevelId =
+      operatorOrValue instanceof FilterOperator
+        ? operatorOrValue.apply(...values)
+        : FilterOperator.IN.apply(operatorOrValue, ...values);
+    return this;
+  }
+
+  name(operatorOrValue: FilterOperator | string, ...values: string[]): this {
+    this._name =
+      operatorOrValue instanceof FilterOperator
+        ? operatorOrValue.apply(...values)
+        : FilterOperator.IN.apply(operatorOrValue, ...values);
+    return this;
+  }
+
+  systemName(
+    operatorOrValue: FilterOperator | string,
+    ...values: string[]
+  ): this {
+    this._systemName =
+      operatorOrValue instanceof FilterOperator
+        ? operatorOrValue.apply(...values)
+        : FilterOperator.IN.apply(operatorOrValue, ...values);
+    return this;
+  }
+
+  responsibleId(
+    operatorOrValue: FilterOperator | string,
+    ...values: string[]
+  ): this {
+    this._responsibleId =
+      operatorOrValue instanceof FilterOperator
+        ? operatorOrValue.apply(...values)
+        : FilterOperator.IN.apply(operatorOrValue, ...values);
+    return this;
+  }
+
+  isActive(
+    operatorOrValue: FilterOperator | string,
+    ...values: string[]
+  ): this {
+    this._isActive =
+      operatorOrValue instanceof FilterOperator
+        ? operatorOrValue.apply(...values)
+        : FilterOperator.IN.apply(operatorOrValue, ...values);
+    return this;
+  }
+
+  secondaryLevelCount(
+    operatorOrValue: FilterOperator | string,
+    ...values: string[]
+  ): this {
+    this._secondaryLevelCount =
+      operatorOrValue instanceof FilterOperator
+        ? operatorOrValue.apply(...values)
+        : FilterOperator.IN.apply(operatorOrValue, ...values);
+    return this;
+  }
+
+  groupId(operatorOrValue: FilterOperator | string, ...values: string[]): this {
+    this._groupId =
+      operatorOrValue instanceof FilterOperator
+        ? operatorOrValue.apply(...values)
+        : FilterOperator.IN.apply(operatorOrValue, ...values);
+    return this;
+  }
+
+  pageNumber(n: number): this {
+    this._pageNumber = n;
+    return this;
+  }
+  pageSize(size: number): this {
+    this._pageSize = size;
+    return this;
+  }
+  orderBy(field: string): this {
+    this._orderBy = field;
+    return this;
+  }
+  sortDirection(dir: SortDirection): this {
+    this._sortDir = dir;
+    return this;
+  }
+
+  /**
+   * Aplica operadores implícitos, valida con Zod y retorna `PrimaryLevelFilter` inmutable.
+   * @throws {z.ZodError} si la paginación es inválida
+   */
+  build(): PrimaryLevelFilter {
+    const applyIn = (v?: string) =>
+      v && !FilterOperator.hasOperator(v) ? `in:${v}` : v;
+
+    const data = PrimaryLevelFilterSchema.parse({
+      primaryLevelId: applyIn(this._primaryLevelId),
+      name: applyIn(this._name),
+      systemName: applyIn(this._systemName),
+      responsibleId: applyIn(this._responsibleId),
+      isActive: applyIn(this._isActive),
+      secondaryLevelCount: applyIn(this._secondaryLevelCount),
+      groupId: applyIn(this._groupId),
+      pagination: {
+        pageNumber: this._pageNumber,
+        pageSize: this._pageSize,
+        orderBy: this._orderBy,
+        sortDirection: this._sortDir,
+      },
+    });
+    return PrimaryLevelFilter._create(data);
+  }
+}