shori-sdk-ts 1.0.1

package/dist/types/modules/repo/dto/downloadRequests.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Parámetros para descargar un documento por su UUID.
+ *
+ * @example
+ * ```ts
+ * const file = await client.repo().download().byDocument({
+ *   documentId: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+ *   fileName: "contrato.pdf",
+ * });
+ * console.log(file.name); // "contrato.pdf"
+ * ```
+ */
+export interface GetDocumentByIdRequest {
+    /** UUID del documento a descargar */
+    documentId: string;
+    /**
+     * Nombre del archivo resultado.
+     * Si no se especifica, se usa `"document"` por defecto.
+     */
+    fileName?: string;
+}
+/**
+ * Parámetros para descargar una versión específica de un documento.
+ *
+ * @example
+ * ```ts
+ * const file = await client.repo().download().byDocumentAndVersion({
+ *   documentId: "doc-uuid",
+ *   versionId: "version-uuid",
+ *   fileName: "contrato-v2.pdf",
+ * });
+ * ```
+ */
+export interface DownloadByDocumentAndVersionRequest {
+    /** UUID del documento */
+    documentId: string;
+    /** UUID de la versión específica */
+    versionId: string;
+    /**
+     * Nombre del archivo resultado.
+     * Si no se especifica, se usa `"document"` por defecto.
+     */
+    fileName?: string;
+}
+//# sourceMappingURL=downloadRequests.d.ts.map

package/dist/types/modules/repo/dto/downloadRequests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"downloadRequests.d.ts","sourceRoot":"","sources":["../../../../../src/modules/repo/dto/downloadRequests.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,sBAAsB;IACrC,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,mCAAmC;IAClD,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/modules/repo/dto/uploadDocumentRequest.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Parámetros para subir un documento al repositorio de Shori.
+ *
+ * @example
+ * ```ts
+ * // Con un File del navegador (input type="file")
+ * const request: UploadDocumentRequest = {
+ *   file: fileInput.files[0],
+ *   casoId: "caso-uuid",
+ *   casoTypeId: "tipo-uuid",
+ *   isValid: false,
+ *   isDeleted: false,
+ *   encrypted: false,
+ * };
+ *
+ * // Con un Blob generado dinámicamente
+ * const blob = new Blob([pdfBytes], { type: "application/pdf" });
+ * const request: UploadDocumentRequest = {
+ *   file: blob,
+ *   fileName: "contrato.pdf",
+ *   casoId: "caso-uuid",
+ *   casoTypeId: "tipo-uuid",
+ * };
+ * ```
+ */
+export interface UploadDocumentRequest {
+    /** Archivo a subir (File del browser o Blob) */
+    file: Blob | File;
+    /** UUID del caso al que se asocia el documento */
+    casoId: string;
+    /** UUID del tipo de caso */
+    casoTypeId: string;
+    /** Nombre del archivo. Si no se especifica, usa `file.name` (solo para `File`) */
+    fileName?: string;
+    /** UUID de la categoría del documento. Opcional */
+    categoryId?: string;
+    /** Indica si el documento es válido. Por defecto: `false` */
+    isValid?: boolean;
+    /** Indica si el documento está eliminado lógicamente. Por defecto: `false` */
+    isDeleted?: boolean;
+    /** Indica si el documento está cifrado. Por defecto: `false` */
+    encrypted?: boolean;
+}
+//# sourceMappingURL=uploadDocumentRequest.d.ts.map

package/dist/types/modules/repo/dto/uploadDocumentRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploadDocumentRequest.d.ts","sourceRoot":"","sources":["../../../../../src/modules/repo/dto/uploadDocumentRequest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,qBAAqB;IACpC,gDAAgD;IAChD,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB"}

package/dist/types/modules/repo/repoDocumentModule.d.ts

@@ -0,0 +1,71 @@
+import type { HttpExecutor } from "../../http/HttpExecutor.js";
+import type { ShoriConfig } from "../../config/ShoriConfig.js";
+import type { UploadDocumentRequest } from "./dto/uploadDocumentRequest.js";
+/**
+ * Sub-módulo para gestión de documentos en el repositorio de Shori.
+ *
+ * Proporciona operaciones de escritura: subida y eliminación de documentos.
+ * Se accede a través de `client.repo().document()`.
+ *
+ * @example
+ * ```ts
+ * // Subir un documento
+ * const documentId = await client.repo().document().upload({
+ *   file: fileInput.files[0],
+ *   casoId: "caso-uuid",
+ *   casoTypeId: "tipo-uuid",
+ *   isValid: false,
+ *   isDeleted: false,
+ *   encrypted: false,
+ * });
+ *
+ * // Eliminar un documento
+ * await client.repo().document().delete("doc-uuid");
+ * ```
+ */
+export declare class RepoDocumentModule {
+    private readonly config;
+    private readonly http;
+    constructor(config: ShoriConfig, http: HttpExecutor);
+    /**
+     * Sube un documento al repositorio de Shori y lo asocia a un caso.
+     *
+     * Los metadatos del request se envían como query params de la URL.
+     * El archivo se envía como cuerpo binario (`application/octet-stream`).
+     *
+     * @example
+     * ```ts
+     * // Desde un <input type="file">
+     * const docId = await client.repo().document().upload({
+     *   file: event.target.files[0],
+     *   casoId: "caso-uuid",
+     *   casoTypeId: "tipo-uuid",
+     *   categoryId: "category-uuid", // opcional
+     * });
+     *
+     * // Desde un Blob generado
+     * const blob = new Blob([content], { type: "application/pdf" });
+     * const docId = await client.repo().document().upload({
+     *   file: blob,
+     *   casoId: "caso-uuid",
+     *   casoTypeId: "tipo-uuid",
+     * });
+     * ```
+     *
+     * @param request - Archivo y metadatos del documento
+     * @returns UUID del documento creado en el repositorio
+     */
+    upload(request: UploadDocumentRequest): Promise<string>;
+    /**
+     * Elimina un documento del repositorio por su UUID.
+     *
+     * @example
+     * ```ts
+     * await client.repo().document().delete("a1b2c3d4-e5f6-7890-abcd-ef1234567890");
+     * ```
+     *
+     * @param uuid - UUID del documento a eliminar
+     */
+    delete(uuid: string): Promise<void>;
+}
+//# sourceMappingURL=repoDocumentModule.d.ts.map

package/dist/types/modules/repo/repoDocumentModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repoDocumentModule.d.ts","sourceRoot":"","sources":["../../../../src/modules/repo/repoDocumentModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;gBAExB,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY;IAKnD;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,MAAM,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAgB7D;;;;;;;;;OASG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAI1C"}

package/dist/types/modules/repo/repoDownloadModule.d.ts

@@ -0,0 +1,90 @@
+import type { HttpExecutor } from "../../http/HttpExecutor.js";
+import type { ShoriConfig } from "../../config/ShoriConfig.js";
+import type { GetDocumentByIdRequest, DownloadByDocumentAndVersionRequest } from "./dto/downloadRequests.js";
+/**
+ * Sub-módulo para descarga de documentos del repositorio de Shori.
+ *
+ * Todas las descargas retornan un `File` — compatible con browser, Node.js 20+,
+ * Next.js y NestJS. El `File` contiene los bytes del documento y el nombre
+ * especificado en el request (o `"document"` por defecto).
+ *
+ * Se accede a través de `client.repo().download()`.
+ *
+ * @example
+ * ```ts
+ * // Descargar y guardar en el navegador
+ * const file = await client.repo().download().byDocument({
+ *   documentId: "uuid",
+ *   fileName: "contrato.pdf",
+ * });
+ * const url = URL.createObjectURL(file);
+ * const a = document.createElement("a");
+ * a.href = url;
+ * a.download = file.name; // "contrato.pdf"
+ * a.click();
+ *
+ * // Descargar y guardar en Node.js
+ * const file = await client.repo().download().byDocument({
+ *   documentId: "uuid",
+ *   fileName: "contrato.pdf",
+ * });
+ * const buffer = Buffer.from(await file.arrayBuffer());
+ * await fs.promises.writeFile(`/descargas/${file.name}`, buffer);
+ * ```
+ */
+export declare class RepoDownloadModule {
+    private readonly config;
+    private readonly http;
+    constructor(config: ShoriConfig, http: HttpExecutor);
+    /**
+     * Descarga un documento del repositorio por su UUID.
+     *
+     * @example
+     * ```ts
+     * const file = await client.repo().download().byDocument({
+     *   documentId: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+     *   fileName: "contrato-firmado.pdf",
+     * });
+     * console.log(file.name); // "contrato-firmado.pdf"
+     * console.log(file.size); // bytes
+     * ```
+     *
+     * @param request - UUID del documento y nombre del archivo
+     * @returns `File` con el contenido del documento
+     */
+    byDocument(request: GetDocumentByIdRequest): Promise<File>;
+    /**
+     * Descarga una versión específica de un documento.
+     *
+     * @example
+     * ```ts
+     * const file = await client.repo().download().byDocumentAndVersion({
+     *   documentId: "doc-uuid",
+     *   versionId: "version-uuid",
+     *   fileName: "contrato-v2.pdf",
+     * });
+     * ```
+     *
+     * @param request - UUID del documento, UUID de la versión y nombre del archivo
+     * @returns `File` con el contenido de esa versión
+     */
+    byDocumentAndVersion(request: DownloadByDocumentAndVersionRequest): Promise<File>;
+    /**
+     * Descarga la versión exportada de un documento (formato generado por Shori, habitualmente PDF).
+     *
+     * @example
+     * ```ts
+     * const file = await client.repo().download().exportDocument({
+     *   documentId: "doc-uuid",
+     *   fileName: "documento-exportado.pdf",
+     * });
+     * // Convertir a ArrayBuffer para procesarlo
+     * const buffer = await file.arrayBuffer();
+     * ```
+     *
+     * @param request - UUID del documento y nombre del archivo
+     * @returns `File` con el documento en formato exportado
+     */
+    exportDocument(request: GetDocumentByIdRequest): Promise<File>;
+}
+//# sourceMappingURL=repoDownloadModule.d.ts.map

package/dist/types/modules/repo/repoDownloadModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repoDownloadModule.d.ts","sourceRoot":"","sources":["../../../../src/modules/repo/repoDownloadModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EACV,sBAAsB,EACtB,mCAAmC,EACpC,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;gBAExB,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY;IAKnD;;;;;;;;;;;;;;;OAeG;IACG,UAAU,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhE;;;;;;;;;;;;;;OAcG;IACG,oBAAoB,CACxB,OAAO,EAAE,mCAAmC,GAC3C,OAAO,CAAC,IAAI,CAAC;IAQhB;;;;;;;;;;;;;;;OAeG;IACG,cAAc,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;CAOrE"}

package/dist/types/modules/repo/repoModule.d.ts

@@ -0,0 +1,64 @@
+import type { HttpExecutor } from "../../http/HttpExecutor.js";
+import type { ShoriConfig } from "../../config/ShoriConfig.js";
+import { RepoDocumentModule } from "./repoDocumentModule.js";
+import { RepoDownloadModule } from "./repoDownloadModule.js";
+/**
+ * Módulo de Repositorio de Documentos de Shori.
+ *
+ * Façade que agrupa los sub-módulos `document` y `download`.
+ * Se accede a través de `client.repo()`.
+ *
+ * @example
+ * ```ts
+ * // Subir un documento
+ * const docId = await client.repo().document().upload({
+ *   file: fileInput.files[0],
+ *   casoId: "caso-uuid",
+ *   casoTypeId: "tipo-uuid",
+ * });
+ *
+ * // Descargar un documento
+ * const blob = await client.repo().download().byDocument({ documentId: docId });
+ * const url = URL.createObjectURL(blob);
+ *
+ * // Descargar versión específica
+ * const blob2 = await client.repo().download().byDocumentAndVersion({
+ *   documentId: "doc-uuid",
+ *   versionId: "ver-uuid",
+ * });
+ *
+ * // Descargar versión exportada (PDF)
+ * const pdfBlob = await client.repo().download().exportDocument({ documentId: "doc-uuid" });
+ * ```
+ */
+export declare class RepoModule {
+    private readonly documentModule;
+    private readonly downloadModule;
+    constructor(config: ShoriConfig, http: HttpExecutor);
+    /**
+     * Accede al sub-módulo de gestión de documentos.
+     *
+     * Permite subir y eliminar documentos del repositorio.
+     *
+     * @example
+     * ```ts
+     * const docId = await client.repo().document().upload({ file, casoId, casoTypeId });
+     * await client.repo().document().delete("doc-uuid");
+     * ```
+     */
+    document(): RepoDocumentModule;
+    /**
+     * Accede al sub-módulo de descarga de documentos.
+     *
+     * Todas las descargas retornan un `Blob`.
+     *
+     * @example
+     * ```ts
+     * const blob = await client.repo().download().byDocument({ documentId: "uuid" });
+     * const blob2 = await client.repo().download().byDocumentAndVersion({ documentId, versionId });
+     * const pdf = await client.repo().download().exportDocument({ documentId: "uuid" });
+     * ```
+     */
+    download(): RepoDownloadModule;
+}
+//# sourceMappingURL=repoModule.d.ts.map

package/dist/types/modules/repo/repoModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repoModule.d.ts","sourceRoot":"","sources":["../../../../src/modules/repo/repoModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IACpD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;gBAExC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY;IAKnD;;;;;;;;;;OAUG;IACH,QAAQ,IAAI,kBAAkB;IAI9B;;;;;;;;;;;OAWG;IACH,QAAQ,IAAI,kBAAkB;CAG/B"}

package/dist/types/utils/shoriUtil.d.ts

@@ -0,0 +1,3 @@
+export declare function getOffsetMs(dateStr: string, timeZone: string): number;
+export declare function buildDateFilter(startDate: string | null, endDate: string | null, timeZone: string): string | null;
+//# sourceMappingURL=shoriUtil.d.ts.map

package/dist/types/utils/shoriUtil.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shoriUtil.d.ts","sourceRoot":"","sources":["../../../src/utils/shoriUtil.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA0BrE;AAED,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAuBf"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "shori-sdk-ts",
+  "version": "1.0.1",
+  "description": "SDK TypeScript para integrar aplicaciones JS/TS con la plataforma Shori BPM de NTT DATA",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "types": "./dist/types/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "npm run build:esm && npm run build:cjs && npm run build:types",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:types": "tsc -p tsconfig.types.json",
+    "dev": "tsc --watch",
+    "clean": "rimraf dist"
+  },
+  "keywords": [
+    "shori",
+    "nttdata",
+    "bpm",
+    "sdk",
+    "typescript",
+    "javascript"
+  ],
+  "author": "AITO PERÚ — NTT DATA",
+  "license": "MIT",
+  "devDependencies": {
+    "rimraf": "^5.0.0",
+    "typescript": "^5.4.0"
+  },
+  "dependencies": {
+    "zod": "^4.4.3"
+  }
+}

package/src/auth/AuthService.ts

@@ -0,0 +1,61 @@
+import type { ShoriConfig } from "../config/ShoriConfig.js";
+
+/** Respuesta del endpoint de autenticación. */
+interface AuthResponse {
+  token: string;
+}
+
+/**
+ * Servicio de autenticación con Shori.
+ * Obtiene el Bearer token usando la X-ApiKey.
+ * Equivalente a AuthService.java
+ */
+export class AuthService {
+  private readonly config: ShoriConfig;
+
+  constructor(config: ShoriConfig) {
+    this.config = config;
+  }
+
+  /**
+   * Obtiene el token Bearer desde el endpoint de autenticación.
+   * Usa X-ApiKey — nunca Bearer token.
+   */
+  async authenticate(): Promise<string> {
+    const url = `${this.config.caseUrl}/v2/auth`;
+
+    const controller = new AbortController();
+    const timerId = setTimeout(() => controller.abort(), this.config.timeoutMs);
+
+    try {
+      const response = await fetch(url, {
+        method: "GET",
+        headers: {
+          "X-ApiKey": this.config.apiKey,
+          "X-TenantId": this.config.tenantId,
+          "X-Portal": this.config.portalId,
+        },
+        signal: controller.signal,
+      });
+
+      if (!response.ok) {
+        const body = await response.text().catch(() => "");
+        throw new Error(
+          `Error de autenticación HTTP ${response.status}: ${body}`,
+        );
+      }
+
+      const data = (await response.json()) as AuthResponse;
+      return data.token;
+    } catch (err) {
+      if (err instanceof Error && err.name === "AbortError") {
+        throw new Error(
+          `Timeout de autenticación (${this.config.timeoutMs}ms)`,
+        );
+      }
+      throw err;
+    } finally {
+      clearTimeout(timerId);
+    }
+  }
+}

package/src/auth/TokenProvider.ts

@@ -0,0 +1,62 @@
+import type { AuthService } from "./AuthService.js";
+
+/**
+ * Proveedor de tokens Bearer con lazy-loading y renovación automática.
+ *
+ * Equivalente a TokenProvider.java.
+ * En JS no hay threads, pero sí hay concurrencia async — si múltiples
+ * requests se ejecutan en paralelo y el token expira, solo uno refresca
+ * y los demás reutilizan el resultado gracias al Promise compartido.
+ */
+export class TokenProvider {
+  private token: string | null = null;
+  /** Promise en vuelo para evitar múltiples refreshes simultáneos */
+  private refreshPromise: Promise<string> | null = null;
+  private readonly authService: AuthService;
+
+  constructor(authService: AuthService) {
+    this.authService = authService;
+  }
+
+  /**
+   * Obtiene el token Bearer vigente.
+   * Si no hay token, autentica de forma lazy.
+   * Si hay una autenticación en curso, espera a la misma (no lanza una segunda).
+   */
+  async getToken(): Promise<string> {
+    if (this.token) return this.token;
+    return this.refresh();
+  }
+
+  /**
+   * Invalida el token actual y fuerza una nueva autenticación.
+   * Si ya hay un refresh en curso, espera ese mismo (no duplica la llamada).
+   */
+  async invalidateAndRefresh(): Promise<string> {
+    this.token = null;
+    return this.refresh();
+  }
+
+  private async refresh(): Promise<string> {
+    // Si ya hay un refresh en curso, compartir el mismo Promise
+    if (this.refreshPromise) return this.refreshPromise;
+
+    this.refreshPromise = this.authService
+      .authenticate()
+      .then((newToken) => {
+        this.token = newToken;
+        return newToken;
+      })
+      .finally(() => {
+        this.refreshPromise = null;
+      });
+
+    return this.refreshPromise;
+  }
+
+  /** Limpia el token cacheado (útil en tests o al cerrar el cliente) */
+  clear(): void {
+    this.token = null;
+    this.refreshPromise = null;
+  }
+}

package/src/client/ShoriClient.ts

@@ -0,0 +1,104 @@
+import type { ShoriConfig } from "../config/ShoriConfig.js";
+import type { HttpExecutor } from "../http/HttpExecutor.js";
+import type { RepoModule } from "../modules/repo/repoModule.js";
+import type { CaseModule } from "../modules/caso/caseModule.js";
+
+/**
+ * Punto de entrada principal del SDK de Shori para TypeScript/JavaScript.
+ *
+ * Compatible con Node.js 18+, React, Next.js, NestJS, Express y cualquier
+ * entorno que soporte fetch nativo.
+ *
+ * @example
+ * ```ts
+ * import { ShoriClientBuilder, ShoriEnvironment } from "@nttdata/shori-api-client";
+ *
+ * const client = new ShoriClientBuilder()
+ *   .environment(ShoriEnvironment.PROD)
+ *   .portalId("mi-portal-id")
+ *   .tenantId("mi-tenant-id")
+ *   .apiKey("mi-api-key")
+ *   .build();
+ * ```
+ */
+export class ShoriClient {
+  /** Configuración activa del cliente */
+  readonly config: ShoriConfig;
+
+  /** @internal — usado por los módulos de negocio */
+  readonly _httpExecutor: HttpExecutor;
+
+  private readonly _repoModule: RepoModule;
+  private readonly _caseModule: CaseModule;
+
+  /** @internal — usar ShoriClientBuilder para crear instancias */
+  constructor(
+    config: ShoriConfig,
+    httpExecutor: HttpExecutor,
+    repoModule: RepoModule,
+    caseModule: CaseModule,
+  ) {
+    this.config = config;
+    this._httpExecutor = httpExecutor;
+    this._repoModule = repoModule;
+    this._caseModule = caseModule;
+  }
+
+  /**
+   * Accede al módulo de Repositorio de Documentos.
+   *
+   * Permite subir, descargar y eliminar documentos del repositorio de Shori.
+   *
+   * @example
+   * ```ts
+   * // Subir
+   * const docId = await client.repo().document().upload({ file, casoId, casoTypeId });
+   *
+   * // Descargar
+   * const blob = await client.repo().download().byDocument({ documentId: docId });
+   *
+   * // Exportar como PDF
+   * const pdf = await client.repo().download().exportDocument({ documentId: docId });
+   * ```
+   */
+  repo(): RepoModule {
+    return this._repoModule;
+  }
+
+  /**
+   * Accede al módulo de Casos.
+   *
+   * Permite crear, buscar, actualizar casos y acceder a sub-módulos
+   * especializados para estados, comentarios y tipos de caso.
+   *
+   * @example
+   * ```ts
+   * // Crear un caso.
+   * const result = await client.caso().create({ casoTypeId, formId, priority });
+   *
+   * // Buscar con auto-paginación
+   * const todos = await client.caso().searchAll(
+   *   new CaseFilter().casoTypeId(FilterOperator.EQ, "tipo-uuid")
+   *     .workingSubStateId(FilterOperator.IN, ...openStateIds)
+   * );
+   *
+   * // Sub-módulos
+   * client.caso().state()    // avanzar estado
+   * client.caso().comment()  // comentarios
+   * client.caso().casoType() // tipos de caso
+   * ```
+   */
+  caso(): CaseModule {
+    return this._caseModule;
+  }
+
+  /**
+   * Libera los recursos asociados al cliente.
+   *
+   * En JS/TS no hay pool que cerrar — este método existe por
+   * paridad de API con el SDK Java y para compatibilidad futura.
+   */
+  close(): void {
+    // No-op en TS: fetch nativo no mantiene conexiones persistentes
+  }
+}