shori-sdk-ts 1.0.1

package/README.md

@@ -0,0 +1,114 @@
+# Shori SDK para TypeScript / JavaScript
+
+> SDK desarrollado por el equipo **AITO PERÚ de NTT DATA** para integrar aplicaciones JS/TS con la plataforma **Syntpony Process Management (Shori)**.
+
+## Características
+
+- ✅ **fetch nativo** — sin dependencias externas (Node 18+, browser, Edge Runtime)
+- ✅ **Auto-renovación de tokens** — el Bearer token se renueva automáticamente al expirar
+- ✅ **Builder fluido** — igual que el SDK Java
+- ✅ **TypeScript primero** — tipos completos, IntelliSense incluido
+- ✅ **Dual ESM + CJS** — compatible con `import` y `require`
+- ✅ **Compatible con** Next.js, NestJS, Express, React, Vite, etc.
+
+## Instalación
+
+```bash
+npm install @nttdata/shori-api-client
+```
+
+## Inicio rápido
+
+```ts
+import { ShoriClientBuilder, ShoriEnvironment } from "@nttdata/shori-api-client";
+
+const client = new ShoriClientBuilder()
+  .environment(ShoriEnvironment.PROD)
+  .portalId("tu-portal-id")
+  .tenantId("tu-tenant-id")
+  .apiKey("tu-api-key")
+  .build();
+```
+
+## Uso en Next.js
+
+```ts
+// lib/shori.ts
+import { ShoriClientBuilder, ShoriEnvironment } from "@nttdata/shori-api-client";
+
+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();
+```
+
+## Uso en NestJS
+
+```ts
+// shori.module.ts
+import { Module, Global } from "@nestjs/common";
+import { ShoriClientBuilder, ShoriEnvironment } from "@nttdata/shori-api-client";
+
+@Global()
+@Module({
+  providers: [
+    {
+      provide: "SHORI_CLIENT",
+      useFactory: () =>
+        new ShoriClientBuilder()
+          .environment(ShoriEnvironment.PROD)
+          .portalId(process.env.SHORI_PORTAL_ID!)
+          .tenantId(process.env.SHORI_TENANT_ID!)
+          .apiKey(process.env.SHORI_API_KEY!)
+          .build(),
+    },
+  ],
+  exports: ["SHORI_CLIENT"],
+})
+export class ShoriModule {}
+```
+
+## Variables de entorno recomendadas
+
+```env
+SHORI_PORTAL_ID=tu-portal-uuid
+SHORI_TENANT_ID=tu-tenant-uuid
+SHORI_API_KEY=tu-api-key
+```
+
+## Manejo de errores
+
+```ts
+import {
+  ResourceNotFoundException,
+  AuthenticationException,
+  ApiException,
+} from "@nttdata/shori-api-client";
+
+try {
+  // const caso = await client.caso().findById("uuid");
+} catch (err) {
+  if (err instanceof ResourceNotFoundException) {
+    // 404 — el recurso no existe
+  } else if (err instanceof AuthenticationException) {
+    // credenciales inválidas
+  } else if (err instanceof ApiException) {
+    console.error(`HTTP ${err.statusCode}:`, err.message);
+  }
+}
+```
+
+## Compatibilidad
+
+| Entorno | Versión mínima |
+|---|---|
+| Node.js | 18+ |
+| Next.js | 13+ |
+| NestJS | 9+ |
+| TypeScript | 5.0+ |
+
+---
+
+**AITO PERÚ — NTT DATA**

package/dist/cjs/auth/AuthService.d.ts

@@ -0,0 +1,16 @@
+import type { ShoriConfig } from "../config/ShoriConfig.js";
+/**
+ * Servicio de autenticación con Shori.
+ * Obtiene el Bearer token usando la X-ApiKey.
+ * Equivalente a AuthService.java
+ */
+export declare class AuthService {
+    private readonly config;
+    constructor(config: ShoriConfig);
+    /**
+     * Obtiene el token Bearer desde el endpoint de autenticación.
+     * Usa X-ApiKey — nunca Bearer token.
+     */
+    authenticate(): Promise<string>;
+}
+//# sourceMappingURL=AuthService.d.ts.map

package/dist/cjs/auth/AuthService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthService.d.ts","sourceRoot":"","sources":["../../../src/auth/AuthService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAO5D;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,MAAM,EAAE,WAAW;IAI/B;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;CAqCtC"}

package/dist/cjs/auth/AuthService.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthService = void 0;
+/**
+ * Servicio de autenticación con Shori.
+ * Obtiene el Bearer token usando la X-ApiKey.
+ * Equivalente a AuthService.java
+ */
+class AuthService {
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Obtiene el token Bearer desde el endpoint de autenticación.
+     * Usa X-ApiKey — nunca Bearer token.
+     */
+    async authenticate() {
+        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());
+            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);
+        }
+    }
+}
+exports.AuthService = AuthService;
+//# sourceMappingURL=AuthService.js.map

package/dist/cjs/auth/AuthService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthService.js","sourceRoot":"","sources":["../../../src/auth/AuthService.ts"],"names":[],"mappings":";;;AAOA;;;;GAIG;AACH,MAAa,WAAW;IAGtB,YAAY,MAAmB;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY;QAChB,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,UAAU,CAAC;QAE7C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAE5E,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE;oBACP,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;oBAC9B,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;oBAClC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;iBACjC;gBACD,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;gBACnD,MAAM,IAAI,KAAK,CACb,+BAA+B,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,CAC1D,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAiB,CAAC;YACrD,OAAO,IAAI,CAAC,KAAK,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBACtD,MAAM,IAAI,KAAK,CACb,6BAA6B,IAAI,CAAC,MAAM,CAAC,SAAS,KAAK,CACxD,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;CACF;AAhDD,kCAgDC"}

package/dist/cjs/auth/TokenProvider.d.ts

@@ -0,0 +1,31 @@
+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 declare class TokenProvider {
+    private token;
+    /** Promise en vuelo para evitar múltiples refreshes simultáneos */
+    private refreshPromise;
+    private readonly authService;
+    constructor(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).
+     */
+    getToken(): Promise<string>;
+    /**
+     * Invalida el token actual y fuerza una nueva autenticación.
+     * Si ya hay un refresh en curso, espera ese mismo (no duplica la llamada).
+     */
+    invalidateAndRefresh(): Promise<string>;
+    private refresh;
+    /** Limpia el token cacheado (útil en tests o al cerrar el cliente) */
+    clear(): void;
+}
+//# sourceMappingURL=TokenProvider.d.ts.map

package/dist/cjs/auth/TokenProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenProvider.d.ts","sourceRoot":"","sources":["../../../src/auth/TokenProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;;;GAOG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAuB;IACpC,mEAAmE;IACnE,OAAO,CAAC,cAAc,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;gBAE9B,WAAW,EAAE,WAAW;IAIpC;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAKjC;;;OAGG;IACG,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC;YAK/B,OAAO;IAiBrB,sEAAsE;IACtE,KAAK,IAAI,IAAI;CAId"}

package/dist/cjs/auth/TokenProvider.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenProvider = void 0;
+/**
+ * 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.
+ */
+class TokenProvider {
+    constructor(authService) {
+        this.token = null;
+        /** Promise en vuelo para evitar múltiples refreshes simultáneos */
+        this.refreshPromise = null;
+        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() {
+        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() {
+        this.token = null;
+        return this.refresh();
+    }
+    async refresh() {
+        // 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() {
+        this.token = null;
+        this.refreshPromise = null;
+    }
+}
+exports.TokenProvider = TokenProvider;
+//# sourceMappingURL=TokenProvider.js.map

package/dist/cjs/auth/TokenProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenProvider.js","sourceRoot":"","sources":["../../../src/auth/TokenProvider.ts"],"names":[],"mappings":";;;AAEA;;;;;;;GAOG;AACH,MAAa,aAAa;IAMxB,YAAY,WAAwB;QAL5B,UAAK,GAAkB,IAAI,CAAC;QACpC,mEAAmE;QAC3D,mBAAc,GAA2B,IAAI,CAAC;QAIpD,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ;QACZ,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,oBAAoB;QACxB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;IAEO,KAAK,CAAC,OAAO;QACnB,4DAA4D;QAC5D,IAAI,IAAI,CAAC,cAAc;YAAE,OAAO,IAAI,CAAC,cAAc,CAAC;QAEpD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,WAAW;aACnC,YAAY,EAAE;aACd,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;YACjB,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;YACtB,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEL,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,sEAAsE;IACtE,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;IAC7B,CAAC;CACF;AAnDD,sCAmDC"}

package/dist/cjs/client/ShoriClient.d.ts

@@ -0,0 +1,82 @@
+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 declare class ShoriClient {
+    /** Configuración activa del cliente */
+    readonly config: ShoriConfig;
+    /** @internal — usado por los módulos de negocio */
+    readonly _httpExecutor: HttpExecutor;
+    private readonly _repoModule;
+    private readonly _caseModule;
+    /** @internal — usar ShoriClientBuilder para crear instancias */
+    constructor(config: ShoriConfig, httpExecutor: HttpExecutor, repoModule: RepoModule, 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;
+    /**
+     * 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;
+    /**
+     * 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;
+}
+//# sourceMappingURL=ShoriClient.d.ts.map

package/dist/cjs/client/ShoriClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShoriClient.d.ts","sourceRoot":"","sources":["../../../src/client/ShoriClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEhE;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,WAAW;IACtB,uCAAuC;IACvC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B,mDAAmD;IACnD,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC;IAErC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IAEzC,gEAAgE;gBAE9D,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,UAAU;IAQxB;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,IAAI,UAAU;IAIlB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,IAAI,IAAI,UAAU;IAIlB;;;;;OAKG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/cjs/client/ShoriClient.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShoriClient = void 0;
+/**
+ * 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();
+ * ```
+ */
+class ShoriClient {
+    /** @internal — usar ShoriClientBuilder para crear instancias */
+    constructor(config, httpExecutor, repoModule, 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() {
+        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() {
+        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() {
+        // No-op en TS: fetch nativo no mantiene conexiones persistentes
+    }
+}
+exports.ShoriClient = ShoriClient;
+//# sourceMappingURL=ShoriClient.js.map

package/dist/cjs/client/ShoriClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShoriClient.js","sourceRoot":"","sources":["../../../src/client/ShoriClient.ts"],"names":[],"mappings":";;;AAKA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAa,WAAW;IAUtB,gEAAgE;IAChE,YACE,MAAmB,EACnB,YAA0B,EAC1B,UAAsB,EACtB,UAAsB;QAEtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;QAClC,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAChC,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACH,KAAK;QACH,gEAAgE;IAClE,CAAC;CACF;AAhFD,kCAgFC"}

package/dist/cjs/client/ShoriClientBuilder.d.ts

@@ -0,0 +1,67 @@
+import { ShoriEnvironment } from "../config/ShoriEnvironment.js";
+import { ShoriClient } from "./ShoriClient.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 declare class ShoriClientBuilder {
+    private _environment?;
+    private _portalId?;
+    private _tenantId?;
+    private _apiKey?;
+    private _timeoutMs;
+    /**
+     * Establece el ambiente de Shori.
+     * @param environment DEV | UAT | PROD
+     */
+    environment(environment: ShoriEnvironment): this;
+    /**
+     * Establece el ID del portal de Shori.
+     * @param portalId UUID del portal (ej: "0306444E-38B1-403D-8753-EC9C2BC43215")
+     */
+    portalId(portalId: string): this;
+    /**
+     * Establece el ID del tenant de Shori.
+     * @param tenantId UUID del tenant (ej: "80ff134a-cae2-4a4a-92b9-a109bdee1183")
+     */
+    tenantId(tenantId: string): this;
+    /**
+     * Establece la API Key para autenticación.
+     * @param apiKey Clave de API proporcionada por Shori
+     */
+    apiKey(apiKey: string): this;
+    /**
+     * Establece el timeout de los requests en milisegundos.
+     * @param timeoutMs Milisegundos. Por defecto: 30000 (30s)
+     */
+    timeoutMs(timeoutMs: number): 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;
+    private validate;
+}
+//# sourceMappingURL=ShoriClientBuilder.d.ts.map

package/dist/cjs/client/ShoriClientBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShoriClientBuilder.d.ts","sourceRoot":"","sources":["../../../src/client/ShoriClientBuilder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAIjE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAK/C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,YAAY,CAAC,CAAmB;IACxC,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,UAAU,CAAkB;IAEpC;;;OAGG;IACH,WAAW,CAAC,WAAW,EAAE,gBAAgB,GAAG,IAAI;IAKhD;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKhC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKhC;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK5B;;;OAGG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQlC;;;;;OAKG;IACH,KAAK,IAAI,WAAW;IAoBpB,OAAO,CAAC,QAAQ;CAsBjB"}

package/dist/cjs/client/ShoriClientBuilder.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShoriClientBuilder = void 0;
+const ShoriConfig_js_1 = require("../config/ShoriConfig.js");
+const AuthService_js_1 = require("../auth/AuthService.js");
+const TokenProvider_js_1 = require("../auth/TokenProvider.js");
+const HttpExecutor_js_1 = require("../http/HttpExecutor.js");
+const ShoriClient_js_1 = require("./ShoriClient.js");
+const ShoriException_js_1 = require("../exception/ShoriException.js");
+const repoModule_js_1 = require("../modules/repo/repoModule.js");
+const caseModule_js_1 = require("../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();
+ * ```
+ */
+class ShoriClientBuilder {
+    constructor() {
+        this._timeoutMs = 30000;
+    }
+    /**
+     * Establece el ambiente de Shori.
+     * @param environment DEV | UAT | PROD
+     */
+    environment(environment) {
+        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) {
+        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) {
+        this._tenantId = tenantId;
+        return this;
+    }
+    /**
+     * Establece la API Key para autenticación.
+     * @param apiKey Clave de API proporcionada por Shori
+     */
+    apiKey(apiKey) {
+        this._apiKey = apiKey;
+        return this;
+    }
+    /**
+     * Establece el timeout de los requests en milisegundos.
+     * @param timeoutMs Milisegundos. Por defecto: 30000 (30s)
+     */
+    timeoutMs(timeoutMs) {
+        if (timeoutMs <= 0) {
+            throw new ShoriException_js_1.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() {
+        this.validate();
+        const config = new ShoriConfig_js_1.ShoriConfig({
+            environment: this._environment,
+            portalId: this._portalId,
+            tenantId: this._tenantId,
+            apiKey: this._apiKey,
+            timeoutMs: this._timeoutMs,
+        });
+        const authService = new AuthService_js_1.AuthService(config);
+        const tokenProvider = new TokenProvider_js_1.TokenProvider(authService);
+        const httpExecutor = new HttpExecutor_js_1.HttpExecutor(config, tokenProvider);
+        const repoModule = new repoModule_js_1.RepoModule(config, httpExecutor);
+        const caseModule = new caseModule_js_1.CaseModule(config, httpExecutor, repoModule);
+        return new ShoriClient_js_1.ShoriClient(config, httpExecutor, repoModule, caseModule);
+    }
+    validate() {
+        if (!this._environment) {
+            throw new ShoriException_js_1.ValidationException("El ambiente es requerido. Usa .environment(ShoriEnvironment.DEV | UAT | PROD)");
+        }
+        if (!this._portalId?.trim()) {
+            throw new ShoriException_js_1.ValidationException('El Portal ID es requerido. Usa .portalId("tu-portal-id")');
+        }
+        if (!this._tenantId?.trim()) {
+            throw new ShoriException_js_1.ValidationException('El Tenant ID es requerido. Usa .tenantId("tu-tenant-id")');
+        }
+        if (!this._apiKey?.trim()) {
+            throw new ShoriException_js_1.ValidationException('La API Key es requerida. Usa .apiKey("tu-api-key")');
+        }
+    }
+}
+exports.ShoriClientBuilder = ShoriClientBuilder;
+//# sourceMappingURL=ShoriClientBuilder.js.map

package/dist/cjs/client/ShoriClientBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShoriClientBuilder.js","sourceRoot":"","sources":["../../../src/client/ShoriClientBuilder.ts"],"names":[],"mappings":";;;AAAA,6DAAuD;AAEvD,2DAAqD;AACrD,+DAAyD;AACzD,6DAAuD;AACvD,qDAA+C;AAC/C,sEAAqE;AACrE,iEAA2D;AAC3D,iEAA2D;AAE3D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAa,kBAAkB;IAA/B;QAKU,eAAU,GAAW,KAAM,CAAC;IAkGtC,CAAC;IAhGC;;;OAGG;IACH,WAAW,CAAC,WAA6B;QACvC,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,QAAgB;QACvB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,QAAgB;QACvB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,MAAc;QACnB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,SAAiB;QACzB,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,uCAAmB,CAAC,kCAAkC,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,KAAK;QACH,IAAI,CAAC,QAAQ,EAAE,CAAC;QAEhB,MAAM,MAAM,GAAG,IAAI,4BAAW,CAAC;YAC7B,WAAW,EAAE,IAAI,CAAC,YAAa;YAC/B,QAAQ,EAAE,IAAI,CAAC,SAAU;YACzB,QAAQ,EAAE,IAAI,CAAC,SAAU;YACzB,MAAM,EAAE,IAAI,CAAC,OAAQ;YACrB,SAAS,EAAE,IAAI,CAAC,UAAU;SAC3B,CAAC,CAAC;QAEH,MAAM,WAAW,GAAG,IAAI,4BAAW,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,aAAa,GAAG,IAAI,gCAAa,CAAC,WAAW,CAAC,CAAC;QACrD,MAAM,YAAY,GAAG,IAAI,8BAAY,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QAC7D,MAAM,UAAU,GAAG,IAAI,0BAAU,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACxD,MAAM,UAAU,GAAG,IAAI,0BAAU,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;QAEpE,OAAO,IAAI,4BAAW,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IACvE,CAAC;IAEO,QAAQ;QACd,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,IAAI,uCAAmB,CAC3B,+EAA+E,CAChF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;YAC5B,MAAM,IAAI,uCAAmB,CAC3B,0DAA0D,CAC3D,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;YAC5B,MAAM,IAAI,uCAAmB,CAC3B,0DAA0D,CAC3D,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;YAC1B,MAAM,IAAI,uCAAmB,CAC3B,oDAAoD,CACrD,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAvGD,gDAuGC"}