shori-sdk-ts 1.0.1

package/src/client/ShoriClientBuilder.ts

@@ -0,0 +1,138 @@
+import { ShoriConfig } from "../config/ShoriConfig.js";
+import { ShoriEnvironment } from "../config/ShoriEnvironment.js";
+import { AuthService } from "../auth/AuthService.js";
+import { TokenProvider } from "../auth/TokenProvider.js";
+import { HttpExecutor } from "../http/HttpExecutor.js";
+import { ShoriClient } from "./ShoriClient.js";
+import { ValidationException } from "../exception/ShoriException.js";
+import { RepoModule } from "../modules/repo/repoModule.js";
+import { CaseModule } from "../modules/caso/caseModule.js";
+
+/**
+ * Builder fluido para construir instancias de ShoriClient.
+ *
+ * Equivalente a ShoriClientBuilder.java — misma API, mismo comportamiento.
+ *
+ * @example
+ * ```ts
+ * // Uso básico
+ * const client = new ShoriClientBuilder()
+ *   .environment(ShoriEnvironment.PROD)
+ *   .portalId("mi-portal-id")
+ *   .tenantId("mi-tenant-id")
+ *   .apiKey("mi-api-key")
+ *   .build();
+ *
+ * // Uso en Next.js / NestJS (archivo de configuración)
+ * export const shoriClient = new ShoriClientBuilder()
+ *   .environment(ShoriEnvironment.PROD)
+ *   .portalId(process.env.SHORI_PORTAL_ID!)
+ *   .tenantId(process.env.SHORI_TENANT_ID!)
+ *   .apiKey(process.env.SHORI_API_KEY!)
+ *   .build();
+ * ```
+ */
+export class ShoriClientBuilder {
+  private _environment?: ShoriEnvironment;
+  private _portalId?: string;
+  private _tenantId?: string;
+  private _apiKey?: string;
+  private _timeoutMs: number = 30_000;
+
+  /**
+   * Establece el ambiente de Shori.
+   * @param environment DEV | UAT | PROD
+   */
+  environment(environment: ShoriEnvironment): this {
+    this._environment = environment;
+    return this;
+  }
+
+  /**
+   * Establece el ID del portal de Shori.
+   * @param portalId UUID del portal (ej: "0306444E-38B1-403D-8753-EC9C2BC43215")
+   */
+  portalId(portalId: string): this {
+    this._portalId = portalId;
+    return this;
+  }
+
+  /**
+   * Establece el ID del tenant de Shori.
+   * @param tenantId UUID del tenant (ej: "80ff134a-cae2-4a4a-92b9-a109bdee1183")
+   */
+  tenantId(tenantId: string): this {
+    this._tenantId = tenantId;
+    return this;
+  }
+
+  /**
+   * Establece la API Key para autenticación.
+   * @param apiKey Clave de API proporcionada por Shori
+   */
+  apiKey(apiKey: string): this {
+    this._apiKey = apiKey;
+    return this;
+  }
+
+  /**
+   * Establece el timeout de los requests en milisegundos.
+   * @param timeoutMs Milisegundos. Por defecto: 30000 (30s)
+   */
+  timeoutMs(timeoutMs: number): this {
+    if (timeoutMs <= 0) {
+      throw new ValidationException("El timeout debe ser mayor a 0 ms");
+    }
+    this._timeoutMs = timeoutMs;
+    return this;
+  }
+
+  /**
+   * Valida la configuración y construye la instancia de ShoriClient.
+   *
+   * @returns ShoriClient completamente inicializado
+   * @throws ValidationException si falta algún parámetro requerido
+   */
+  build(): ShoriClient {
+    this.validate();
+
+    const config = new ShoriConfig({
+      environment: this._environment!,
+      portalId: this._portalId!,
+      tenantId: this._tenantId!,
+      apiKey: this._apiKey!,
+      timeoutMs: this._timeoutMs,
+    });
+
+    const authService = new AuthService(config);
+    const tokenProvider = new TokenProvider(authService);
+    const httpExecutor = new HttpExecutor(config, tokenProvider);
+    const repoModule = new RepoModule(config, httpExecutor);
+    const caseModule = new CaseModule(config, httpExecutor, repoModule);
+
+    return new ShoriClient(config, httpExecutor, repoModule, caseModule);
+  }
+
+  private validate(): void {
+    if (!this._environment) {
+      throw new ValidationException(
+        "El ambiente es requerido. Usa .environment(ShoriEnvironment.DEV | UAT | PROD)",
+      );
+    }
+    if (!this._portalId?.trim()) {
+      throw new ValidationException(
+        'El Portal ID es requerido. Usa .portalId("tu-portal-id")',
+      );
+    }
+    if (!this._tenantId?.trim()) {
+      throw new ValidationException(
+        'El Tenant ID es requerido. Usa .tenantId("tu-tenant-id")',
+      );
+    }
+    if (!this._apiKey?.trim()) {
+      throw new ValidationException(
+        'La API Key es requerida. Usa .apiKey("tu-api-key")',
+      );
+    }
+  }
+}

package/src/config/ShoriConfig.ts

@@ -0,0 +1,45 @@
+import { ShoriEnvironment, getEnvironmentUrls } from "./ShoriEnvironment.js";
+
+/**
+ * Configuración inmutable del SDK de Shori.
+ * Equivalente a ShoriConfig.java
+ */
+export interface ShoriConfigOptions {
+  /** Ambiente de Shori (DEV, UAT, PROD) */
+  environment: ShoriEnvironment;
+  /** ID del portal */
+  portalId: string;
+  /** ID del tenant */
+  tenantId: string;
+  /** API Key para autenticación */
+  apiKey: string;
+  /** Timeout de los requests en milisegundos. Por defecto: 30000 (30s) */
+  timeoutMs?: number;
+}
+
+/**
+ * Configuración resuelta con URLs calculadas
+ */
+export class ShoriConfig {
+  readonly environment: ShoriEnvironment;
+  readonly portalId: string;
+  readonly tenantId: string;
+  readonly apiKey: string;
+  readonly timeoutMs: number;
+  readonly caseUrl: string;
+  readonly identifyUrl: string;
+  readonly repoUrl: string;
+
+  constructor(options: ShoriConfigOptions) {
+    this.environment = options.environment;
+    this.portalId = options.portalId;
+    this.tenantId = options.tenantId;
+    this.apiKey = options.apiKey;
+    this.timeoutMs = options.timeoutMs ?? 30_000;
+
+    const urls = getEnvironmentUrls(options.environment);
+    this.caseUrl = urls.caseUrl;
+    this.identifyUrl = urls.identifyUrl;
+    this.repoUrl = urls.repoUrl;
+  }
+}

package/src/config/ShoriEnvironment.ts

@@ -0,0 +1,39 @@
+/**
+ * Ambientes pre-configurados de Shori con sus URLs correspondientes.
+ * Equivalente a ShoriEnvironment.java
+ */
+export enum ShoriEnvironment {
+  /** Ambiente de desarrollo */
+  DEV = "DEV",
+  /** Ambiente de UAT (User Acceptance Testing) */
+  UAT = "UAT",
+  /** Ambiente de producción */
+  PROD = "PROD",
+}
+
+/** URLs base por ambiente */
+export const SHORI_ENVIRONMENT_URLS: Record<
+  ShoriEnvironment,
+  { caseUrl: string; identifyUrl: string; repoUrl: string }
+> = {
+  [ShoriEnvironment.DEV]: {
+    caseUrl: "https://shori-caso-uat.clonika.com",
+    identifyUrl: "https://shori-identify-uat.clonika.com",
+    repoUrl: "https://shori-repo-uat.clonika.com",
+  },
+  [ShoriEnvironment.UAT]: {
+    caseUrl: "https://shori-caso-uat.clonika.com",
+    identifyUrl: "https://shori-identify-uat.clonika.com",
+    repoUrl: "https://shori-repo-uat.clonika.com",
+  },
+  [ShoriEnvironment.PROD]: {
+    caseUrl: "https://shori-caso.clonika.com",
+    identifyUrl: "https://shori-identify.clonika.com",
+    repoUrl: "https://shori-repo.clonika.com",
+  },
+};
+
+/** Obtiene las URLs del ambiente dado */
+export function getEnvironmentUrls(env: ShoriEnvironment) {
+  return SHORI_ENVIRONMENT_URLS[env];
+}

package/src/exception/ShoriException.ts

@@ -0,0 +1,43 @@
+/** Excepción base del SDK de Shori */
+export class ShoriException extends Error {
+  readonly cause?: unknown;
+  constructor(message: string, cause?: unknown) {
+    super(message);
+    this.name = "ShoriException";
+    this.cause = cause;
+  }
+}
+
+/** Error HTTP del API (4xx, 5xx) */
+export class ApiException extends ShoriException {
+  readonly statusCode: number;
+  constructor(message: string, statusCode: number, cause?: unknown) {
+    super(message, cause);
+    this.name = "ApiException";
+    this.statusCode = statusCode;
+  }
+}
+
+/** Error de autenticación */
+export class AuthenticationException extends ShoriException {
+  constructor(message: string, cause?: unknown) {
+    super(message, cause);
+    this.name = "AuthenticationException";
+  }
+}
+
+/** Recurso no encontrado (HTTP 404) */
+export class ResourceNotFoundException extends ShoriException {
+  constructor(message: string) {
+    super(message);
+    this.name = "ResourceNotFoundException";
+  }
+}
+
+/** Parámetro inválido en el SDK */
+export class ValidationException extends ShoriException {
+  constructor(message: string) {
+    super(message);
+    this.name = "ValidationException";
+  }
+}

package/src/http/HttpExecutor.ts

@@ -0,0 +1,274 @@
+import type { ShoriConfig } from "../config/ShoriConfig.js";
+import type { TokenProvider } from "../auth/TokenProvider.js";
+import {
+  ApiException,
+  AuthenticationException,
+  ResourceNotFoundException,
+} from "../exception/ShoriException.js";
+
+/**
+ * Ejecutor HTTP que maneja todas las comunicaciones con la API de Shori.
+ *
+ * Usa `fetch` nativo — compatible con Node.js 18+, browser, Next.js, NestJS,
+ * Express y cualquier entorno que soporte la API de fetch estándar.
+ *
+ * A diferencia del SDK Java, no gestiona un pool de conexiones explícito:
+ * el runtime de JS administra las conexiones HTTP automáticamente.
+ *
+ * **Modos de operación:**
+ * - Requests de autenticación — usan `X-ApiKey` directamente (vía `getWithApiKey`)
+ * - Requests normales — usan Bearer token con retry automático en 401 (vía los métodos públicos)
+ *
+ * **Retry en 401:**
+ * Si un request devuelve `401 Unauthorized`, el executor invalida el token,
+ * lanza una nueva autenticación y reintenta el request una sola vez.
+ * Si vuelve a fallar con 401, lanza `AuthenticationException`.
+ *
+ * **Thread safety:**
+ * En JS no existen threads concurrentes, pero sí concurrencia async.
+ * Si múltiples `await` reciben 401 al mismo tiempo, el `TokenProvider`
+ * garantiza que solo se ejecute una autenticación — las demás esperan
+ * el mismo `Promise` sin lanzar llamadas adicionales.
+ *
+ * @example
+ * ```ts
+ * // Uso interno — los módulos de negocio usan HttpExecutor a través de ShoriClient
+ * const casos = await httpExecutor.get<CaseSearchResult>(url);
+ * const nuevo  = await httpExecutor.post<CasoCreateResponse>(url, body);
+ * await httpExecutor.delete(url);
+ * const blob   = await httpExecutor.downloadBlob(url);
+ * const docId  = await httpExecutor.uploadFile<string>(url, file);
+ * ```
+ */
+export class HttpExecutor {
+  private readonly config: ShoriConfig;
+  private readonly tokenProvider: TokenProvider;
+
+  constructor(config: ShoriConfig, tokenProvider: TokenProvider) {
+    this.config = config;
+    this.tokenProvider = tokenProvider;
+  }
+
+  // =========================================================================
+  // MÉTODO DE AUTENTICACIÓN (usa X-ApiKey, sin Bearer)
+  // Solo debe ser llamado por AuthService.
+  // =========================================================================
+
+  /**
+   * GET con X-ApiKey. Exclusivo para AuthService.
+   */
+  async getWithApiKey<T>(url: string): Promise<T> {
+    const response = await this.fetchWithTimeout(url, {
+      method: "GET",
+      headers: this.authHeaders(),
+    });
+
+    if (!response.ok) {
+      const body = await response.text().catch(() => "");
+      throw new AuthenticationException(
+        `Error de autenticación HTTP ${response.status}: ${body}`,
+      );
+    }
+
+    return response.json() as Promise<T>;
+  }
+
+  // =========================================================================
+  // MÉTODOS NORMALES (usan Bearer token + retry automático en 401)
+  // =========================================================================
+
+  async get<T>(url: string): Promise<T> {
+    return this.withRetry(() => this.doGet<T>(url));
+  }
+
+  async getList<T>(url: string): Promise<T[]> {
+    return this.withRetry(() => this.doGetList<T>(url));
+  }
+
+  async post<T>(url: string, body?: unknown): Promise<T> {
+    return this.withRetry(() => this.doPost<T>(url, body));
+  }
+
+  async put<T>(url: string, body?: unknown): Promise<T> {
+    return this.withRetry(() => this.doPut<T>(url, body));
+  }
+
+  async delete(url: string): Promise<void> {
+    return this.withRetry(() => this.doDelete(url));
+  }
+
+  async downloadBlob(url: string): Promise<Blob> {
+    return this.withRetry(() => this.doDownloadBlob(url));
+  }
+
+  async uploadFile<T>(url: string, file: Blob | File): Promise<T> {
+    return this.withRetry(() => this.doUploadFile<T>(url, file));
+  }
+
+  // =========================================================================
+  // IMPLEMENTACIONES INTERNAS
+  // =========================================================================
+
+  /**
+   * Retry automático en 401: invalida el token y reintenta una vez.
+   * Equivalente al executeWithRetry de Java pero con Promises.
+   */
+  private async withRetry<T>(fn: () => Promise<T>): Promise<T> {
+    try {
+      return await fn();
+    } catch (err) {
+      if (err instanceof UnauthorizedError) {
+        await this.tokenProvider.invalidateAndRefresh();
+        try {
+          return await fn();
+        } catch (err2) {
+          if (err2 instanceof UnauthorizedError) {
+            throw new AuthenticationException(
+              "Token sigue inválido después de renovar. Verifica las credenciales.",
+            );
+          }
+          throw err2;
+        }
+      }
+      throw err;
+    }
+  }
+
+  private async doGet<T>(url: string): Promise<T> {
+    const response = await this.fetchWithTimeout(url, {
+      method: "GET",
+      headers: await this.bearerHeaders(),
+    });
+    this.checkStatus(response, url);
+    return response.json() as Promise<T>;
+  }
+
+  private async doGetList<T>(url: string): Promise<T[]> {
+    const response = await this.fetchWithTimeout(url, {
+      method: "GET",
+      headers: await this.bearerHeaders(),
+    });
+    this.checkStatus(response, url);
+    return response.json() as Promise<T[]>;
+  }
+
+  private async doPost<T>(url: string, body?: unknown): Promise<T> {
+    const response = await this.fetchWithTimeout(url, {
+      method: "POST",
+      headers: {
+        ...(await this.bearerHeaders()),
+        "Content-Type": "application/json",
+      },
+      body: body !== undefined ? JSON.stringify(body) : undefined,
+    });
+    this.checkStatus(response, url);
+    const text = await response.text();
+    return text ? (JSON.parse(text) as T) : (undefined as T);
+  }
+
+  private async doPut<T>(url: string, body?: unknown): Promise<T> {
+    const response = await this.fetchWithTimeout(url, {
+      method: "PUT",
+      headers: {
+        ...(await this.bearerHeaders()),
+        "Content-Type": "application/json",
+      },
+      body: body !== undefined ? JSON.stringify(body) : undefined,
+    });
+    this.checkStatus(response, url);
+    const text = await response.text();
+    return text ? (JSON.parse(text) as T) : (undefined as T);
+  }
+
+  private async doDelete(url: string): Promise<void> {
+    const response = await this.fetchWithTimeout(url, {
+      method: "DELETE",
+      headers: await this.bearerHeaders(),
+    });
+    this.checkStatus(response, url);
+  }
+
+  private async doDownloadBlob(url: string): Promise<Blob> {
+    const response = await this.fetchWithTimeout(url, {
+      method: "GET",
+      headers: await this.bearerHeaders(),
+    });
+    this.checkStatus(response, url);
+    return response.blob();
+  }
+
+  private async doUploadFile<T>(url: string, file: Blob | File): Promise<T> {
+    const response = await this.fetchWithTimeout(url, {
+      method: "POST",
+      headers: {
+        ...(await this.bearerHeaders()),
+        "Content-Type": "application/octet-stream",
+      },
+      body: file,
+    });
+    this.checkStatus(response, url);
+    return response.json() as Promise<T>;
+  }
+
+  // =========================================================================
+  // UTILIDADES
+  // =========================================================================
+
+  /** fetch con AbortController para timeout */
+  private async fetchWithTimeout(
+    url: string,
+    options: RequestInit,
+  ): Promise<Response> {
+    const controller = new AbortController();
+    const timerId = setTimeout(() => controller.abort(), this.config.timeoutMs);
+    try {
+      return await fetch(url, { ...options, signal: controller.signal });
+    } catch (err) {
+      if (err instanceof Error && err.name === "AbortError") {
+        throw new ApiException(
+          `Timeout (${this.config.timeoutMs}ms) en ${url}`,
+          408,
+        );
+      }
+      throw new ApiException(`Error de red en ${url}`, 0, err);
+    } finally {
+      clearTimeout(timerId);
+    }
+  }
+
+  private checkStatus(response: Response, url: string): void {
+    if (response.status === 401) throw new UnauthorizedError();
+    if (response.status === 404)
+      throw new ResourceNotFoundException(`Recurso no encontrado: ${url}`);
+    if (response.status >= 400)
+      throw new ApiException(
+        `Error HTTP ${response.status} en ${url}`,
+        response.status,
+      );
+  }
+
+  private authHeaders(): Record<string, string> {
+    return {
+      "X-ApiKey": this.config.apiKey,
+      "X-TenantId": this.config.tenantId,
+      "X-Portal": this.config.portalId,
+    };
+  }
+
+  private async bearerHeaders(): Promise<Record<string, string>> {
+    const token = await this.tokenProvider.getToken();
+    return {
+      Authorization: `Bearer ${token}`,
+      "X-TenantId": this.config.tenantId,
+      "X-Portal": this.config.portalId,
+    };
+  }
+}
+
+/** Error interno para señalizar 401 y activar el retry */
+class UnauthorizedError extends Error {
+  constructor() {
+    super("Unauthorized");
+    this.name = "UnauthorizedError";
+  }
+}

package/src/index.ts

@@ -0,0 +1,67 @@
+// ── Config ────────────────────────────────────────────────────────────────
+export {
+  ShoriEnvironment,
+  SHORI_ENVIRONMENT_URLS,
+  getEnvironmentUrls,
+} from "./config/ShoriEnvironment.js";
+export { ShoriConfig } from "./config/ShoriConfig.js";
+export type { ShoriConfigOptions } from "./config/ShoriConfig.js";
+
+// ── Auth ──────────────────────────────────────────────────────────────────
+export { AuthService } from "./auth/AuthService.js";
+export { TokenProvider } from "./auth/TokenProvider.js";
+
+// ── HTTP ──────────────────────────────────────────────────────────────────
+export { HttpExecutor } from "./http/HttpExecutor.js";
+
+// ── Client ────────────────────────────────────────────────────────────────
+export { ShoriClient } from "./client/ShoriClient.js";
+export { ShoriClientBuilder } from "./client/ShoriClientBuilder.js";
+
+// ── Módulo Caso ───────────────────────────────────────────────────────────
+export { CaseModule } from "./modules/caso/caseModule.js";
+export { CaseStateModule } from "./modules/caso/caseStateModule.js";
+export { CaseCommentModule } from "./modules/caso/caseCommentModule.js";
+export { CaseTypeModule } from "./modules/caso/caseTypeModule.js";
+export { CaseFilesModule } from "./modules/caso/caseFilesModule.js";
+export { CaseFileTypologyModule } from "./modules/caso/caseFileTypologyModule.js";
+export { CaseFilter } from "./modules/caso/filter/caseFilter.js";
+export { CommentFilter } from "./modules/caso/filter/commentFilter.js";
+export { PrimaryLevelFilter } from "./modules/caso/filter/primaryLevelFilter.js";
+export { SecondaryLevelFilter } from "./modules/caso/filter/secondaryLevelFilter.js";
+export { FilterOperator } from "./modules/caso/filter/filterOperator.js";
+export { SortDirection } from "./modules/caso/filter/sortDirection.js";
+export { CasoCreateRequest } from "./modules/caso/dto/request/casoCreateRequest.js";
+export { CasoUpdateRequest } from "./modules/caso/dto/request/casoUpdateRequest.js";
+export { NextStateRequest } from "./modules/caso/dto/request/nextStateRequest.js";
+export { GetAttachmentFilesRequest } from "./modules/caso/dto/request/getAttachmentFilesRequest.js";
+export { CasoCreateResponse } from "./modules/caso/dto/response/casoCreateResponse.js";
+export { CasoResponse } from "./modules/caso/dto/response/casoResponse.js";
+export { CasoSearchResponse } from "./modules/caso/dto/response/casoSearchResponse.js";
+export { CaseSearchResult } from "./modules/caso/dto/response/caseSearchResult.js";
+export { CommentResponse } from "./modules/caso/dto/response/commentResponse.js";
+export { CommentSearchResult } from "./modules/caso/dto/response/commentSearchResult.js";
+export { ProductResponse } from "./modules/caso/dto/response/productResponse.js";
+export { CasoFileSearchResponse } from "./modules/caso/dto/response/casoFileSearchResponse.js";
+export { CasoFileUpdateRequest } from "./modules/caso/dto/request/casoFileUpdateRequest.js";
+export { TypologyResponse } from "./modules/caso/dto/response/typologyResponse.js";
+export { AddCommentResponse } from "./modules/caso/dto/response/addCommentResponse.js";
+
+// ── Módulo Repo ───────────────────────────────────────────────────────────
+export { RepoModule } from "./modules/repo/repoModule.js";
+export { RepoDocumentModule } from "./modules/repo/repoDocumentModule.js";
+export { RepoDownloadModule } from "./modules/repo/repoDownloadModule.js";
+export type { UploadDocumentRequest } from "./modules/repo/dto/uploadDocumentRequest.js";
+export type {
+  GetDocumentByIdRequest,
+  DownloadByDocumentAndVersionRequest,
+} from "./modules/repo/dto/downloadRequests.js";
+
+// ── Exceptions ────────────────────────────────────────────────────────────
+export {
+  ShoriException,
+  ApiException,
+  AuthenticationException,
+  ResourceNotFoundException,
+  ValidationException,
+} from "./exception/ShoriException.js";