@zenti/sdk 0.1.0

package/tests/parser.test.ts

@@ -0,0 +1,132 @@
+import { parseZenti, ZentiValidationError } from '../src/parser';
+
+const VALID_ZENTI = `
+version: "1.0"
+name: "TestAgent"
+
+core:
+  openness: 0.7
+  conscientiousness: 0.9
+  extraversion: 0.4
+  agreeableness: 0.8
+  neuroticism: 0.2
+
+identity:
+  role: "Agente de soporte de prueba"
+  backstory: "Experto técnico con amplia experiencia"
+  communication_style: "Profesional y conciso"
+
+examples:
+  on_brand:
+    - user: "no funciona"
+      agent: "Entiendo tu frustración. Cuéntame qué error ves."
+  off_brand:
+    - user: "no funciona"
+      agent: "No sé, prueba reiniciando."
+
+guardrails:
+  always:
+    - "Reconocer el problema antes de dar solución"
+  never:
+    - "Decir 'no puedo' sin ofrecer alternativa"
+  escalate_if:
+    - "El usuario menciona cancelación"
+`;
+
+describe('Parser — archivo válido', () => {
+  test('parsea correctamente todos los campos', () => {
+    const persona = parseZenti(VALID_ZENTI);
+    expect(persona.name).toBe('TestAgent');
+    expect(persona.version).toBe('1.0');
+  });
+
+  test('parsea el núcleo Big Five con valores numéricos correctos', () => {
+    const persona = parseZenti(VALID_ZENTI);
+    expect(persona.core.openness).toBe(0.7);
+    expect(persona.core.conscientiousness).toBe(0.9);
+    expect(persona.core.extraversion).toBe(0.4);
+    expect(persona.core.agreeableness).toBe(0.8);
+    expect(persona.core.neuroticism).toBe(0.2);
+  });
+
+  test('parsea la identidad narrativa', () => {
+    const persona = parseZenti(VALID_ZENTI);
+    expect(persona.identity.role).toBe('Agente de soporte de prueba');
+    expect(persona.identity.backstory).toBe('Experto técnico con amplia experiencia');
+    expect(persona.identity.communication_style).toBe('Profesional y conciso');
+  });
+
+  test('parsea los ejemplos on_brand y off_brand', () => {
+    const persona = parseZenti(VALID_ZENTI);
+    expect(persona.examples.on_brand).toHaveLength(1);
+    expect(persona.examples.on_brand[0].user).toBe('no funciona');
+    expect(persona.examples.off_brand).toHaveLength(1);
+  });
+
+  test('parsea los guardrails', () => {
+    const persona = parseZenti(VALID_ZENTI);
+    expect(persona.guardrails.always).toContain('Reconocer el problema antes de dar solución');
+    expect(persona.guardrails.never).toContain("Decir 'no puedo' sin ofrecer alternativa");
+    expect(persona.guardrails.escalate_if).toContain('El usuario menciona cancelación');
+  });
+});
+
+describe('Parser — errores de validación', () => {
+  test('lanza ZentiValidationError si falta la capa core', () => {
+    const invalid = `
+version: "1.0"
+name: "Sin Core"
+identity:
+  role: "test"
+  backstory: "test"
+  communication_style: "test"
+examples:
+  on_brand: []
+  off_brand: []
+guardrails:
+  always: []
+  never: []
+  escalate_if: []
+`;
+    expect(() => parseZenti(invalid)).toThrow(ZentiValidationError);
+    expect(() => parseZenti(invalid)).toThrow(/core/);
+  });
+
+  test('lanza ZentiValidationError si falta la capa identity', () => {
+    const invalid = VALID_ZENTI.replace(
+      /identity:[\s\S]*?communication_style:[^\n]+/,
+      ''
+    );
+    expect(() => parseZenti(invalid)).toThrow(ZentiValidationError);
+  });
+
+  test('lanza ZentiValidationError si un valor de core está fuera de rango', () => {
+    const invalid = VALID_ZENTI.replace('openness: 0.7', 'openness: 1.5');
+    expect(() => parseZenti(invalid)).toThrow(ZentiValidationError);
+    expect(() => parseZenti(invalid)).toThrow(/0\.0 y 1\.0/);
+  });
+
+  test('lanza ZentiValidationError si un valor de core no es número', () => {
+    const invalid = VALID_ZENTI.replace('openness: 0.7', 'openness: "alto"');
+    expect(() => parseZenti(invalid)).toThrow(ZentiValidationError);
+    expect(() => parseZenti(invalid)).toThrow(/número/);
+  });
+
+  test('lanza ZentiValidationError para YAML malformado', () => {
+    expect(() => parseZenti('{ clave: [sin cerrar')).toThrow(ZentiValidationError);
+    expect(() => parseZenti('{ clave: [sin cerrar')).toThrow(/YAML inválido/);
+  });
+
+  test('lanza ZentiValidationError si falta el campo name', () => {
+    const invalid = VALID_ZENTI.replace('name: "TestAgent"', '');
+    expect(() => parseZenti(invalid)).toThrow(ZentiValidationError);
+  });
+
+  test('lanza ZentiValidationError si examples.on_brand no es array', () => {
+    const invalid = VALID_ZENTI.replace(
+      'on_brand:\n    - user: "no funciona"\n      agent: "Entiendo tu frustración. Cuéntame qué error ves."',
+      'on_brand: "no es un array"'
+    );
+    expect(() => parseZenti(invalid)).toThrow(ZentiValidationError);
+  });
+});

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "tests"]
+}

package/tsconfig.test.json

@@ -0,0 +1,7 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "rootDir": "."
+  },
+  "include": ["src/**/*", "tests/**/*"]
+}