@phenyxhealth/sdk 1.1.2 → 1.1.4

package/.claude/phenyx-sdk.md

@@ -88,7 +88,7 @@ await api.retrieveOars(): Promise<any[]>
 api.getGlobalInfo(globalType: GlobalType): GlobalInfo | undefined
 
 // Obtener elemento especifico de info global
-api.getGlobalInfoElement(globalType: GlobalType, elementName: string): GlobalInfoElement | undefined
+api.getGlobalInfoElement(globalType: GlobalType, field: string, elementName: string): GlobalInfoElement | undefined
 
 // Obtener ID de elemento global por nombre
 api.getGlobalInfoElementId(globalType: GlobalType, elementName: string): string | null
@@ -156,9 +156,10 @@ await api.createResource({ name, author?, typeId, agenda }): Promise<void>
 
 ```typescript
 api.getSendingDepartmentIdByName(name: string): string  // throws si no existe
-api.getCei9IdByName(name: string): string                // throws si no existe
 api.getCie10IdByName(name: string): string               // throws si no existe
-api.getCie10CodeExists(name: string): boolean
+api.getCie10ByCode(code: string): GlobalInfoElement      // throws si no existe
+api.getCie10IdByCode(code: string): string | null         // null si no existe o no se facilita codigo
+api.getCie10CodeExists(code: string): boolean
 api.getElementIdByName(type: string, name: string): string | null
 ```
 
@@ -469,7 +470,8 @@ for (const status of [
 - `PhenyxSDK` es un alias de `PhenyxApi` (se exporta como default y como named export `PhenyxSDK`)
 - `login()` inicializa automaticamente: `globalInfo`, `activeTables`, `doctors`, `defaultDuration`, `defaultCompatibleLinacs`, y `oars`
 - Los metodos `get*ByName` buscan en los datos ya cargados en memoria (no hacen llamadas HTTP)
-- Los metodos `getSendingDepartmentIdByName`, `getCei9IdByName`, `getCie10IdByName` lanzan Error si no encuentran el elemento
+- Los metodos `getSendingDepartmentIdByName`, `getCie10IdByName`, `getCie10ByCode` lanzan Error si no encuentran el elemento
+- `getCie10IdByCode` retorna `null` si no existe el codigo o no se facilita
 - `getContrastingColor()` y `newId()` son metodos estaticos - se usan sin instancia: `PhenyxSDK.newId()`
 - **IDs en GlobalInfo**: Al hacer `push` de un elemento nuevo a `globalInfo.elements`, debes enviar un `id` (el servidor da error si no lo envias), pero el servidor lo ignora y asigna su propio ID. Siempre haz `getGlobalInfo()` despues de `updateGlobalInfo()` si necesitas referenciar los elementos creados
 - Las funciones de validacion (`beSureDoctorExists`, `beSureLinacsExists`, `checkGlobals`) crean automaticamente los recursos que no existan

package/README.md

@@ -244,8 +244,11 @@ const color = getContrastingColor(); // '244, 67, 54' (formato RGB)
 // Obtener ID de departamento emisor
 const deptId = api.getSendingDepartmentIdByName("Oncología");
 
-// Obtener ID de código CIE10
-const cie10Id = api.getCie10IdByName("C78.9");
+// Obtener ID de código CIE10 por nombre
+const cie10Id = api.getCie10IdByName("Neoplasia maligna");
+
+// Obtener elemento CIE10 por código
+const cie10 = api.getCie10ByCode("C78.9");
 ```
 
 ## Funciones de Validación

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phenyxhealth/sdk",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "type": "module",
   "description": "SDK oficial para PhenyxHealth - Sistema integral de gestión de radioterapia. Incluye gestión de pacientes, recursos humanos, equipos médicos y configuración global.",
   "main": "./src/index.js",

package/src/PhenyxApi.js

@@ -332,16 +332,16 @@ class PhenyxApi {
             ?.find(item => item.name === globalType.name);
     }
 
-    getGlobalInfoElement = (globalType, elementName) => {
+    getGlobalInfoElement = (globalType, field, elementName) => {
         return this.getGlobalInfo(globalType)
             ?.elements
-            ?.find(item => item.name.toLowerCase() === elementName.toLowerCase());
+            ?.find(item => item[field]?.toLowerCase() === elementName.toLowerCase());
     }
 
     getGlobalInfoElementId = (globalType, elementName) => {
         if (!elementName) return null;
 
-        return this.getGlobalInfoElement(globalType, elementName)?.id;
+        return this.getGlobalInfoElement(globalType, 'name', elementName)?.id;
     }
 
     /**
@@ -417,7 +417,7 @@ class PhenyxApi {
     }
 
     getSendingDepartmentIdByName = (name) => {
-        const sendingDepartment = this.getGlobalInfoElement(this.globalTypes.sendingDepartment, name);
+        const sendingDepartment = this.getGlobalInfoElement(this.globalTypes.sendingDepartment, 'name', name);
         if (!sendingDepartment) {
             throw new Error(`Sending Department ${name} not found`);
         }
@@ -433,15 +433,37 @@ class PhenyxApi {
      * const cie10Id = api.getCie10IdByName('C78.9');
      */
     getCie10IdByName = (name) => {
-        const cie10 = this.getGlobalInfoElement(this.globalTypes.cie10, name);
+        const cie10 = this.getGlobalInfoElement(this.globalTypes.cie10, 'name', name);
         if (!cie10) {
             throw new Error(`CIE10 ${name} not found`);
         }
         return cie10.id;
     }
 
-    getCie10CodeExists = (name) => {
-        return !!this.getGlobalInfoElement(this.globalTypes.cie10, name);
+    /**
+     * Obtiene un elemento CIE10 por su código
+     * @param {string} code - Código CIE10 (ej: 'C78.9')
+     * @returns {Object} Elemento CIE10
+     * @throws {Error} Si no se encuentra el código
+     * @example
+     * const cie10 = api.getCie10ByCode('C78.9');
+     */
+    getCie10ByCode = (code) => {
+        const cie10 = this.getGlobalInfoElement(this.globalTypes.cie10, 'code', code);
+        if (!cie10) {
+            throw new Error(`CIE10 code ${code} not found`);
+        }
+        return cie10;
+    }
+
+    getCie10IdByCode = (code) => {
+        if (!code) return null;
+        const cie10 = this.getGlobalInfoElement(this.globalTypes.cie10, 'code', code);
+        return cie10?.id || null;
+    }
+
+    getCie10CodeExists = (code) => {
+        return !!this.getGlobalInfoElement(this.globalTypes.cie10, 'code', code);
     }
 
     /**

package/types/index.d.ts

@@ -89,6 +89,7 @@ declare module "@phenyxhealth/sdk" {
   export interface GlobalInfoElement {
     id: string;
     name: string;
+    code?: string;
     color: string;
     createdAt: string;
     updatedAt: string;
@@ -275,11 +276,13 @@ declare module "@phenyxhealth/sdk" {
     /**
      * Obtiene un elemento específico de información global
      * @param globalType Tipo global
-     * @param elementName Nombre del elemento
+     * @param field Campo por el que buscar (ej: 'name', 'code')
+     * @param elementName Valor a buscar en el campo indicado
      * @returns Elemento global o undefined
      */
     getGlobalInfoElement(
       globalType: GlobalType,
+      field: string,
       elementName: string,
     ): GlobalInfoElement | undefined;
 
@@ -413,6 +416,21 @@ declare module "@phenyxhealth/sdk" {
      */
     getCie10IdByName(name: string): string;
 
+    /**
+     * Obtiene un elemento CIE10 por su código
+     * @param code Código CIE10 (ej: 'C78.9')
+     * @returns Elemento CIE10
+     * @throws Error si no se encuentra el código
+     */
+    getCie10ByCode(code: string): GlobalInfoElement;
+
+    /**
+     * Obtiene el ID de un CIE10 por su código
+     * @param code Código CIE10 (ej: 'C78.9')
+     * @returns ID del CIE10 o null si no existe o no se facilita código
+     */
+    getCie10IdByCode(code: string): string | null;
+
     /**
      * Obtiene el estado de peer review formateado
      * @param status Estado a formatear