@ai-pip/core 0.1.5 → 0.1.7

package/CHANGELOG.md

@@ -0,0 +1,181 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [0.1.7] - 2026-01-04
+
+### 🐛 Critical Fixes
+
+#### Type Resolution Fix
+- **Fixed nested type resolution**: Changed `moduleResolution` from `"bundler"` to `"nodenext"` in `tsconfig.json`
+- **Added explicit file extensions**: All relative imports now include `.js` extension (required by `nodenext`)
+- **Fixed type accessibility**: Types with nested properties (e.g., `TrustLevel.value`) now resolve correctly in consuming projects
+
+#### What This Fixes
+
+**Problem**: When importing types from `@ai-pip/core` in SDK projects, TypeScript could not resolve nested type properties:
+- `this.data.trust.value` appeared as `any` instead of `TrustLevelType`
+- No autocompletado for nested properties
+- Type inference failed for complex types
+
+**Root Cause**: Incompatibility between `moduleResolution: "bundler"` (used in `@ai-pip-core`) and `moduleResolution: "nodenext"` (used in SDK projects). TypeScript couldn't follow the chain of type imports correctly.
+
+**Solution**: 
+- Aligned `moduleResolution` to `"nodenext"` in both projects
+- Added explicit `.js` extensions to all relative imports (required by Node.js ESM resolution)
+- Changed `module` from `"ESNext"` to `"NodeNext"` for consistency
+
+**Impact**: 
+- ✅ Nested types now resolve correctly
+- ✅ Autocompletado works for all type properties
+- ✅ Type inference works correctly in consuming projects
+- ✅ Better compatibility with Node.js ESM module resolution
+
+### 🔧 Technical Changes
+
+- **Removed `tsconfig.json` from package files**: `tsconfig.json` is only needed for development, not for published packages
+- **Updated `tsconfig.json`**:
+  - `module: "ESNext"` → `module: "NodeNext"`
+  - `moduleResolution: "bundler"` → `moduleResolution: "nodenext"`
+- **Updated all source files**: Added `.js` extension to 107+ relative imports across the codebase
+
+### 📦 Package Changes
+
+- **Removed from `files` array**: `tsconfig.json` (only needed for development)
+- **Package now includes**: `dist/`, `README.md`, `LICENSE` only
+
+### ⚠️ Breaking Changes
+
+**None** - This is a patch version that fixes type resolution issues without changing the API.
+
+### 📚 Documentation
+
+- Updated README to reference centralized CHANGELOG.md
+- Added detailed explanation of type resolution fixes
+
+---
+
+## [0.1.6] - 2025-12-28
+
+### 📚 Documentation Improvements
+- **Centralized documentation**: Moved all protocol documentation to `ai-pip-docs` repository
+- **Updated README**: Added comprehensive links to centralized documentation
+- **Documentation structure**: Reorganized documentation section with links to whitepaper, architecture, roadmap, and SDK guides
+
+### 🔧 Package Improvements
+- **Documentation links**: All documentation now points to `ai-pip-docs` repository
+- **README cleanup**: Removed redundant documentation sections, kept only code-specific documentation
+
+---
+
+## [0.1.5] - 2025-12-28
+
+### 📚 Documentation Improvements
+- **Updated README**: Added links to whitepaper, roadmap, and complete layer documentation
+- **Updated Roadmap**: Added SDK-browser in Phase 4, updated Phase 1 status to 100% completed
+- **Architecture clarification**: Corrected documentation about Shared (not a layer, but shared features)
+- **SDK note**: Updated explanation about AAL and Model Gateway (they are SDK components, not core)
+
+### 🔧 Optimizations
+- **Package size reduction**: Removed `src/` from `files` field in `package.json` to make the package lighter
+- **Optimized package**: Only necessary files are included (`dist/`, `tsconfig.json`, `README.md`, `LICENSE`)
+
+### ✨ Improvements
+- **Layer documentation**: Added link to Shared documentation (shared features)
+- **Documentation organization**: Reorganized documentation section with priority on whitepaper and roadmap
+
+---
+
+## [0.1.3] - 2025-12-28
+
+### ✨ New Features
+- **JavaScript compilation**: The package now compiles to JavaScript (`dist/`) for better compatibility
+- **Type declaration files**: `.d.ts` files are generated for full TypeScript support
+- **Source maps**: Included for better debugging
+
+### 🔧 Technical Changes
+- **Publication structure**: Changed from publishing `.ts` files directly to compiling to `dist/`
+- **Improved exports**: Exports now point to compiled files (`.js` and `.d.ts`)
+- **Relative paths**: Replaced path aliases (`@/`) with relative paths for compatibility
+- **Build configuration**: Fixed generation of `.d.ts` files in `dist/` instead of `src/`
+- **ESLint**: Configured to ignore generated `.d.ts` files
+
+### 🐛 Fixes
+- **Type resolution**: TypeScript types now resolve correctly from `node_modules`
+- **Imports from subpaths**: Fixed imports from `@ai-pip/core/csl`, `@ai-pip/core/isl`, etc.
+- **Complete exports**: Added `default` field to all exports for Node.js ESM
+- **File generation**: `.d.ts` files now generate correctly in `dist/`
+
+### 📚 Documentation
+- **TypeScript requirements**: Improved documentation about required configuration
+- **Updated examples**: Usage examples updated for new structure
+- **Complete CHANGELOG**: Documentation of all versions and deprecations
+
+### 🛠️ Development Improvements
+- **test:install script**: Script to verify installation before publishing
+- **prepublishOnly script**: Automatically runs build, lint, tests, and test:install before publishing
+
+### ⚠️ Breaking Changes
+- **TypeScript configuration required**: It's now **mandatory** to use `module: "NodeNext"` and `moduleResolution: "nodenext"` in `tsconfig.json`
+
+---
+
+## [0.1.2] - 2025-12-28
+
+### ⚠️ DEPRECATED
+
+**Deprecation reason**: This version had issues with compilation and `.d.ts` file generation. Files were generated in incorrect locations (`src/` instead of `dist/`), causing linting errors and type resolution problems.
+
+**Known issues**:
+- `.d.ts` files were generated in `src/` instead of `dist/`
+- ESLint tried to lint generated `.d.ts` files, causing errors
+- Incomplete build configuration (`declarationDir` misconfigured)
+- Types did not resolve correctly in some cases
+
+**Recommendation**: Update to `0.1.3` or higher.
+
+---
+
+## [0.1.1] - 2025-12-28
+
+### ⚠️ DEPRECATED
+
+**Deprecation reason**: This version had issues with path alias resolution (`@/`) that caused errors when importing from other projects. Types did not resolve correctly when the package was installed from npm.
+
+**Known issues**:
+- Errors: `Module '"@ai-pip/core/csl"' has no exported member 'CSLResult'`
+- Path aliases did not work in consumer projects
+- Types did not resolve correctly from `node_modules`
+
+**Recommendation**: Update to `0.1.3` or higher.
+
+---
+
+## [0.1.0] - 2025-12-28
+
+### ⚠️ DEPRECATED
+
+**Deprecation reason**: Initial version with fundamental compatibility issues. Exports did not include the `default` field required by Node.js ESM, causing `ERR_PACKAGE_PATH_NOT_EXPORTED` errors.
+
+**Known issues**:
+- Errors: `ERR_PACKAGE_PATH_NOT_EXPORTED` when importing subpaths
+- Incomplete exports: Missing `default` field in exports
+- Path aliases did not work correctly
+
+**Recommendation**: Update to `0.1.3` or higher.
+
+### 📦 Initial Content
+- **CSL (Context Segmentation Layer)**: Content segmentation and classification
+- **ISL (Instruction Sanitization Layer)**: Instruction sanitization
+- **CPE (Cryptographic Prompt Envelope)**: Cryptographic envelope with HMAC-SHA256
+
+---
+
+**Current Version**: 0.1.7  
+**Status**: Phase 1 - Core Layers (100% completed)
+

package/README.md

@@ -5,74 +5,74 @@
 [![npm version](https://img.shields.io/npm/v/@ai-pip/core)](https://www.npmjs.com/package/@ai-pip/core)
 [![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)
 
-## 📋 Descripción
+## 📋 Description
 
-**AI-PIP (AI Prompt Integrity Protocol)** es un protocolo de seguridad de múltiples capas diseñado para proteger sistemas de IA contra prompt injection y manipulación maliciosa de contexto.
+**AI-PIP (AI Prompt Integrity Protocol)** is a multi-layer security protocol designed to protect AI systems against prompt injection and malicious context manipulation.
 
-Este paquete contiene la implementación **core** del protocolo, que incluye funciones puras, value objects inmutables y contratos semánticos entre capas.
+This package contains the **core** implementation of the protocol, which includes pure functions, immutable value objects, and semantic contracts between layers.
 
-## 🏗️ Arquitectura
+## 🏗️ Architecture
 
-El protocolo AI-PIP está compuesto por las siguientes capas:
+The AI-PIP protocol is composed of the following layers:
 
-### ✅ Capas Implementadas
+### ✅ Implemented Layers
 
-- **CSL (Context Segmentation Layer)**: Segmenta y clasifica contenido según su origen
-- **ISL (Instruction Sanitization Layer)**: Sanitiza instrucciones según nivel de confianza
-- **CPE (Cryptographic Prompt Envelope)**: Genera envoltorio criptográfico con firma HMAC-SHA256
+- **CSL (Context Segmentation Layer)**: Segments and classifies content according to its origin
+- **ISL (Instruction Sanitization Layer)**: Sanitizes instructions according to trust level
+- **CPE (Cryptographic Prompt Envelope)**: Generates cryptographic envelope with HMAC-SHA256 signature
 
-### 🔧 Features Compartidas
+### 🔧 Shared Features
 
-- **Shared**: Funciones compartidas y linaje global e incremental (no es una capa, son features compartidas entre capas)
+- **Shared**: Shared functions and global incremental lineage (not a layer, but features shared between layers)
 
-### 📝 Nota sobre AAL y Model Gateway
+### 📝 Note on AAL and Model Gateway
 
-**AAL (Agent Action Lock)** y **Model Gateway** son componentes del SDK, no del core semántico. El core semántico se enfoca en funciones puras y señales, mientras que estas capas requieren decisiones operativas y efectos secundarios que pertenecen a la implementación (SDK).
+**AAL (Agent Action Lock)** and **Model Gateway** are SDK components, not part of the semantic core. The semantic core focuses on pure functions and signals, while these layers require operational decisions and side effects that belong to the implementation (SDK).
 
-## 📦 Instalación
+## 📦 Installation
 
 ```bash
 pnpm add @ai-pip/core
-# o
+# or
 npm install @ai-pip/core
-# o
+# or
 yarn add @ai-pip/core
 ```
 
-## 🚀 Uso Básico
+## 🚀 Basic Usage
 
-### Importar desde el paquete principal
+### Import from main package
 
 ```typescript
 import { segment, sanitize, envelope } from '@ai-pip/core'
 import type { CSLResult, ISLResult, CPEResult } from '@ai-pip/core'
 ```
 
-### Ejemplo Completo
+### Complete Example
 
 ```typescript
 import { segment, sanitize, envelope } from '@ai-pip/core'
 import type { CSLResult, ISLResult, CPEResult } from '@ai-pip/core'
 
-// 1. Segmentar contenido (CSL)
+// 1. Segment content (CSL)
 const cslResult: CSLResult = segment({
   content: 'User input here',
   source: 'UI',
   metadata: {}
 })
 
-// 2. Sanitizar contenido (ISL)
+// 2. Sanitize content (ISL)
 const islResult: ISLResult = sanitize(cslResult)
 
-// 3. Generar envelope criptográfico (CPE)
+// 3. Generate cryptographic envelope (CPE)
 const secretKey = 'your-secret-key'
 const cpeResult: CPEResult = envelope(islResult, secretKey)
 
-// cpeResult.envelope contiene el prompt protegido
+// cpeResult.envelope contains the protected prompt
 console.log(JSON.stringify(cpeResult, null, 2))
 ```
 
-### Ejemplo con funciones adicionales
+### Example with additional functions
 
 ```typescript
 import {
@@ -91,59 +91,69 @@ import type {
   TrustLevel
 } from '@ai-pip/core'
 
-// Clasificar un source
+// Classify a source
 const trust = classifySource('UI' as Source)
 
-// Agregar entrada de linaje
+// Add lineage entry
 const updatedLineage = addLineageEntry(cslResult.lineage, {
   step: 'CUSTOM',
   timestamp: Date.now()
 })
 
-// Generar nonce
+// Generate nonce
 const nonce = createNonce()
 ```
 
-## 📚 Documentación
+## 📚 Documentation
 
-### Documentación de Capas
+All AI-PIP protocol documentation is centralized in the [documentation repository](https://github.com/AI-PIP/ai-pip-docs):
 
-- **[CSL - Context Segmentation Layer](docs/layer/csl.md)**: Documentación completa de la capa de segmentación
-- **[ISL - Instruction Sanitization Layer](docs/layer/isl.md)**: Documentación completa de la capa de sanitización
-- **[CPE - Cryptographic Prompt Envelope](docs/layer/cpe.md)**: Documentación completa del envoltorio criptográfico
+### Protocol Documentation
 
+- **[Whitepaper](https://github.com/AI-PIP/ai-pip-docs/blob/main/docs/whitepaper.md)** - Complete technical specification
+- **[Architecture](https://github.com/AI-PIP/ai-pip-docs/blob/main/docs/architecture.md)** - Semantic architecture
+- **[Roadmap](https://github.com/AI-PIP/ai-pip-docs/blob/main/docs/roadmap.md)** - Development plan
 
-- **[Shared - Features Compartidas](docs/layer/shared.md)**: Funciones compartidas y linaje global
+### Core Documentation
 
-### Documentación General
+- **[Core Overview](https://github.com/AI-PIP/ai-pip-docs/blob/main/docs/core/CORE.md)** - Semantic core description
+- **[CSL (Context Segmentation Layer)](https://github.com/AI-PIP/ai-pip-docs/blob/main/docs/core/layers/CSL.md)** - Context segmentation layer
+- **[ISL (Instruction Sanitization Layer)](https://github.com/AI-PIP/ai-pip-docs/blob/main/docs/core/layers/ISL.md)** - Instruction sanitization layer
+- **[CPE (Cryptographic Prompt Envelope)](https://github.com/AI-PIP/ai-pip-docs/blob/main/docs/core/layers/CPE.md)** - Cryptographic prompt envelope
+- **[Shared](https://github.com/AI-PIP/ai-pip-docs/blob/main/docs/core/layers/shared.md)** - Shared features and lineage
 
-- **[Whitepaper](docs/whitepaper.md)**: Especificación técnica completa del protocolo AI-PIP
-- **[Roadmap](docs/roadmap.md)**: Plan de desarrollo y evolución del protocolo
-- **[Arquitectura](docs/architecture.md)**: Arquitectura semántica del protocolo
-- **[SDK Reference](docs/SDK.md)**: Referencia para desarrollo de SDKs
+### SDK Documentation
+
+- **[SDK](https://github.com/AI-PIP/ai-pip-docs/blob/main/docs/sdk/sdk.md)** - SDK implementation guide
+- **[SDK Reference](https://github.com/AI-PIP/ai-pip-docs/blob/main/docs/sdk/sdk-reference.md)** - Complete SDK reference guide
+
+### Code-Specific Documentation
+
+- **[CHANGELOG](./CHANGELOG.md)** - Package version history
+- **[API Reference](#-basic-usage)** - Usage examples in this README
 
 ## 🧪 Testing
 
 ```bash
-# Ejecutar tests
+# Run tests
 pnpm test
 
-# Tests en modo watch
+# Tests in watch mode
 pnpm test:watch
 
-# Tests con cobertura
+# Tests with coverage
 pnpm test:coverage
 
-# UI de tests
+# Test UI
 pnpm test:ui
 ```
 
-**Cobertura actual**: 87%
+**Current coverage**: 87%
 
-## 🔧 Desarrollo
+## 🔧 Development
 
 ```bash
-# Instalar dependencias
+# Install dependencies
 pnpm install
 
 # Type checking
@@ -152,21 +162,21 @@ pnpm type-check
 # Linting
 pnpm lint
 
-# Desarrollo
+# Development
 pnpm dev
 ```
 
-## 📋 Requisitos
+## 📋 Requirements
 
 ### Runtime
 - **Node.js**: >= 18.0.0
-- **pnpm**: >= 8.0.0 (recomendado) o npm/yarn
+- **pnpm**: >= 8.0.0 (recommended) or npm/yarn
 
-### TypeScript ⚠️ **REQUERIDO**
+### TypeScript ⚠️ **REQUIRED**
 
-Este paquete utiliza ESM (`"type": "module"`) y exports con subpaths. Para que TypeScript resuelva correctamente los imports y tipos, tu proyecto **DEBE** tener la siguiente configuración en `tsconfig.json`:
+This package uses ESM (`"type": "module"`) and exports with subpaths. For TypeScript to correctly resolve imports and types, your project **MUST** have the following configuration in `tsconfig.json`:
 
-**Configuración mínima requerida:**
+**Minimum required configuration:**
 
 ```json
 {
@@ -178,12 +188,12 @@ Este paquete utiliza ESM (`"type": "module"`) y exports con subpaths. Para que T
 }
 ```
 
-**⚠️ CRÍTICO**: Sin esta configuración, obtendrás errores como:
+**⚠️ CRITICAL**: Without this configuration, you will get errors like:
 - `Module '"@ai-pip/core/csl"' has no exported member 'CSLResult'`
 - `ERR_PACKAGE_PATH_NOT_EXPORTED`
-- Los tipos no se resolverán correctamente
+- Types will not resolve correctly
 
-#### Ejemplo de `tsconfig.json` completo recomendado
+#### Recommended complete `tsconfig.json` example
 
 ```json
 {
@@ -200,159 +210,69 @@ Este paquete utiliza ESM (`"type": "module"`) y exports con subpaths. Para que T
 }
 ```
 
-#### Notas importantes
+#### Important notes
 
-- **Desde la versión 0.1.2+**: Esta configuración es obligatoria. Las versiones anteriores (0.1.0, 0.1.1) están deprecadas.
-- **Si usas `tsx` o `ts-node`**: Aunque ejecutes TypeScript directamente, **aún necesitas** esta configuración en `tsconfig.json` para que TypeScript resuelva los tipos correctamente.
-- **JavaScript puro**: Si usas JavaScript sin TypeScript, no necesitas esta configuración, pero perderás el soporte de tipos.
+- **From version 0.1.2+**: This configuration is mandatory. Previous versions (0.1.0, 0.1.1) are deprecated.
+- **If you use `tsx` or `ts-node`**: Even if you run TypeScript directly, you **still need** this configuration in `tsconfig.json` for TypeScript to resolve types correctly.
+- **Pure JavaScript**: If you use JavaScript without TypeScript, you don't need this configuration, but you will lose type support.
 
-## 📄 Licencia
+## 📄 License
 
-Apache-2.0 - Ver [LICENSE](LICENSE) para más detalles.
+Apache-2.0 - See [LICENSE](LICENSE) for more details.
 
-## 🤝 Contribuir
+## 🤝 Contributing
 
-Las contribuciones son bienvenidas. Por favor:
+Contributions are welcome. Please:
 
-1. Revisa el [Roadmap](docs/roadmap.md) para ver qué está pendiente
-2. Abre un issue para discutir cambios mayores
-3. Envía un pull request con tus mejoras
+1. Review the [Roadmap](https://github.com/AI-PIP/ai-pip-docs/blob/main/roadmap.md) to see what's pending
+2. Open an issue to discuss major changes
+3. Submit a pull request with your improvements
 
-**Repositorio**: https://github.com/AI-PIP/ai-pip-core  
+**Repository**: https://github.com/AI-PIP/ai-pip-core  
 **Issues**: https://github.com/AI-PIP/ai-pip-core/issues
 
-## 🔗 Enlaces
+## 🔗 Links
 
-- **Documentación**: [docs/](docs/)
+- **Documentation**: [ai-pip-docs](https://github.com/AI-PIP/ai-pip-docs)
 - **NPM Package**: https://www.npmjs.com/package/@ai-pip/core
 - **GitHub**: https://github.com/AI-PIP/ai-pip-core
 
-## 🔮 Mejoras Futuras
+## 🔮 Future Improvements
 
-### Imports por Capa Específica
+### Imports by Specific Layer
 
-Actualmente, se recomienda importar desde el paquete principal (`@ai-pip/core`) para evitar confusiones con nombres similares entre capas. En futuras versiones, se mejorará el soporte para imports directos desde capas específicas:
+Currently, it's recommended to import from the main package (`@ai-pip/core`) to avoid confusion with similar names between layers. In future versions, support for direct imports from specific layers will be improved:
 
 ```typescript
-// Futuro (en desarrollo)
+// Future (in development)
 import { segment } from '@ai-pip/core/csl'
 import { sanitize } from '@ai-pip/core/isl'
 import { envelope } from '@ai-pip/core/cpe'
 ```
 
-Esto permitirá:
-- **Mejor organización**: Importar solo lo necesario de cada capa
-- **Evitar conflictos**: Prevenir confusiones con funciones de nombres similares
-- **Tree-shaking mejorado**: Los bundlers podrán eliminar código no usado más eficientemente
+This will enable:
+- **Better organization**: Import only what's needed from each layer
+- **Avoid conflicts**: Prevent confusion with similarly named functions
+- **Improved tree-shaking**: Bundlers will be able to eliminate unused code more efficiently
 
-**Nota**: Los exports por capa están técnicamente disponibles, pero se recomienda usar el paquete principal hasta que se complete la optimización de resolución de módulos.
+**Note**: Exports by layer are technically available, but it's recommended to use the main package until module resolution optimization is complete.
 
 ---
 
 ## 📝 CHANGELOG
 
-### [0.1.5] - 2025-12-28
-
-#### 📚 Mejoras de Documentación
-- **README actualizado**: Agregados links a whitepaper, roadmap y documentación completa de capas
-- **Roadmap actualizado**: Agregado SDK-browser en Fase 4, actualizado estado de Fase 1 a 100% completado
-- **Clarificación de arquitectura**: Corregida documentación sobre Shared (no es una capa, son features compartidas)
-- **Nota sobre SDK**: Actualizada explicación sobre AAL y Model Gateway (son componentes del SDK, no del core)
-
-#### 🔧 Optimizaciones
-- **Reducción de tamaño del paquete**: Removido `src/` del campo `files` en `package.json` para hacer el paquete más liviano
-- **Paquete optimizado**: Solo se incluyen archivos necesarios (`dist/`, `tsconfig.json`, `README.md`, `LICENSE`)
-
-#### ✨ Mejoras
-- **Documentación de capas**: Agregado link a documentación de Shared (features compartidas)
-- **Organización de documentación**: Reorganizada sección de documentación con prioridad en whitepaper y roadmap
-
----
-
-### [0.1.3] - 2025-12-28
-
-#### ✨ Nuevas características
-- **Compilación a JavaScript**: El paquete ahora se compila a JavaScript (`dist/`) para mayor compatibilidad
-- **Archivos de declaración de tipos**: Se generan archivos `.d.ts` para soporte completo de TypeScript
-- **Source maps**: Incluidos para mejor debugging
-
-#### 🔧 Cambios técnicos
-- **Estructura de publicación**: Cambio de publicar archivos `.ts` directamente a compilar a `dist/`
-- **Exports mejorados**: Los exports ahora apuntan a archivos compilados (`.js` y `.d.ts`)
-- **Rutas relativas**: Reemplazo de path aliases (`@/`) por rutas relativas para compatibilidad
-- **Configuración de build**: Corregida la generación de archivos `.d.ts` en `dist/` en lugar de `src/`
-- **ESLint**: Configurado para ignorar archivos `.d.ts` generados
-
-#### 🐛 Correcciones
-- **Resolución de tipos**: Los tipos TypeScript ahora se resuelven correctamente desde `node_modules`
-- **Imports desde subpaths**: Corregidos los imports desde `@ai-pip/core/csl`, `@ai-pip/core/isl`, etc.
-- **Exports completos**: Agregado campo `default` a todos los exports para Node.js ESM
-- **Generación de archivos**: Archivos `.d.ts` ahora se generan correctamente en `dist/`
-
-#### 📚 Documentación
-- **Requisitos de TypeScript**: Documentación mejorada sobre configuración requerida
-- **Ejemplos actualizados**: Ejemplos de uso actualizados para la nueva estructura
-- **CHANGELOG completo**: Documentación de todas las versiones y deprecaciones
-
-#### 🛠️ Mejoras de desarrollo
-- **Script test:install**: Script para verificar instalación antes de publicar
-- **Script prepublishOnly**: Ejecuta automáticamente build, lint, tests y test:install antes de publicar
-
-#### ⚠️ Breaking Changes
-- **Configuración TypeScript requerida**: Ahora es **obligatorio** usar `module: "NodeNext"` y `moduleResolution: "nodenext"` en `tsconfig.json`
-
----
-
-### [0.1.2] - 2025-12-28
-
-#### ⚠️ DEPRECADA
-
-**Motivo de deprecación**: Esta versión tenía problemas con la compilación y generación de archivos `.d.ts`. Los archivos se generaban en ubicaciones incorrectas (`src/` en lugar de `dist/`), causando errores de linting y problemas de resolución de tipos.
-
-**Problemas conocidos**:
-- Archivos `.d.ts` se generaban en `src/` en lugar de `dist/`
-- ESLint intentaba lintear archivos `.d.ts` generados, causando errores
-- Configuración de build incompleta (`declarationDir` mal configurado)
-- Los tipos no se resolvían correctamente en algunos casos
-
-**Recomendación**: Actualizar a `0.1.3` o superior.
-
----
-
-### [0.1.1] - 2025-12-28
-
-#### ⚠️ DEPRECADA
-
-**Motivo de deprecación**: Esta versión tenía problemas con la resolución de path aliases (`@/`) que causaban errores al importar desde otros proyectos. Los tipos no se resolvían correctamente cuando el paquete se instalaba desde npm.
-
-**Problemas conocidos**:
-- Errores: `Module '"@ai-pip/core/csl"' has no exported member 'CSLResult'`
-- Path aliases no funcionaban en proyectos consumidores
-- Tipos no se resolvían correctamente desde `node_modules`
-
-**Recomendación**: Actualizar a `0.1.3` o superior.
-
----
-
-### [0.1.0] - 2025-12-28
-
-#### ⚠️ DEPRECADA
-
-**Motivo de deprecación**: Versión inicial con problemas fundamentales de compatibilidad. Los exports no incluían el campo `default` requerido por Node.js ESM, causando errores `ERR_PACKAGE_PATH_NOT_EXPORTED`.
+### [0.1.7] - 2026-01-01
 
-**Problemas conocidos**:
-- Errores: `ERR_PACKAGE_PATH_NOT_EXPORTED` al importar subpaths
-- Exports incompletos: Faltaba el campo `default` en los exports
-- Path aliases no funcionaban correctamente
+#### 🐛 Critical Fixes
+- **Fixed nested type resolution**: Changed `moduleResolution` from `"bundler"` to `"nodenext"` to fix type accessibility issues
+- **Added explicit file extensions**: All relative imports now include `.js` extension (required by `nodenext`)
+- **Removed `tsconfig.json` from package**: Only needed for development, not for published packages
 
-**Recomendación**: Actualizar a `0.1.3` o superior.
+**What this fixes**: TypeScript now correctly recognizes and resolves all type properties in consuming projects. Previously, nested type properties were not recognized, appearing as `any` instead of their correct types, and autocompletado didn't work for type properties. This fix ensures proper type inference, autocompletado, and type checking for all exported types and their nested properties.
 
-#### 📦 Contenido inicial
-- **CSL (Context Segmentation Layer)**: Segmentación y clasificación de contenido
-- **ISL (Instruction Sanitization Layer)**: Sanitización de instrucciones
-- **CPE (Cryptographic Prompt Envelope)**: Envoltorio criptográfico con HMAC-SHA256
+For complete details and all version history, see [CHANGELOG.md](./CHANGELOG.md).
 
 ---
 
-**Versión actual**: 0.1.5  
-**Estado**: Fase 1 - Capas Core (100% completado)
+**Current Version**: 0.1.7  
+**Status**: Phase 1 - Core Layers (100% completed)

package/dist/cpe/envelope.d.ts

@@ -28,7 +28,7 @@
  * // - lineage: linaje completo
  * ```
  */
-import type { ISLResult } from '../isl/types';
-import type { CPEResult } from './types';
+import type { ISLResult } from '../isl/types.js';
+import type { CPEResult } from './types.js';
 export declare function envelope(islResult: ISLResult, secretKey: string): CPEResult;
 //# sourceMappingURL=envelope.d.ts.map

package/dist/cpe/envelope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/cpe/envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,SAAS,CAAA;AAUpD,wBAAgB,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,CAwE3E"}
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/cpe/envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,YAAY,CAAA;AAUvD,wBAAgB,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,CAwE3E"}

package/dist/cpe/envelope.js

@@ -1,11 +1,11 @@
-import { createNonce } from './value-objects/Nonce';
-import { createMetadata } from './value-objects/Metadata';
-import { createSignature } from './value-objects/Signature';
-import { EnvelopeError } from './exceptions';
+import { createNonce } from './value-objects/Nonce.js';
+import { createMetadata } from './value-objects/Metadata.js';
+import { createSignature } from './value-objects/Signature.js';
+import { EnvelopeError } from './exceptions/index.js';
 // Serialización NO es core - va al SDK
 // El core solo define la estructura del envelope
-import { addLineageEntries } from '../shared/lineage';
-import { createLineageEntry } from '../csl/value-objects/LineageEntry';
+import { addLineageEntries } from '../shared/lineage.js';
+import { createLineageEntry } from '../csl/value-objects/LineageEntry.js';
 export function envelope(islResult, secretKey) {
     const startTime = Date.now();
     try {