@bantis/local-cipher 2.0.1 → 2.2.0

package/README.md

@@ -124,6 +124,78 @@ function App() {
 }
 ```
 
+## 🚀 Quick Start
+
+### JavaScript Vanilla
+
+```javascript
+import { SecureStorage } from '@bantis/local-cipher';
+
+const storage = SecureStorage.getInstance();
+
+// Store encrypted
+await storage.setItem('accessToken', 'mi-token-secreto');
+
+// Retrieve decrypted
+const token = await storage.getItem('accessToken');
+
+// With expiration (1 hour)
+await storage.setItemWithExpiry('session', sessionData, { expiresIn: 3600000 });
+
+// Remove
+await storage.removeItem('accessToken');
+```
+
+**Before:**
+```
+localStorage: { "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }
+```
+
+**After:**
+```
+localStorage: { "__enc_a7f5d8e2": "Qm9keUVuY3J5cHRlZERhdGE..." }
+```
+
+### React
+
+```jsx
+import { useSecureStorage } from '@bantis/local-cipher/react';
+
+function App() {
+  const [token, setToken, loading] = useSecureStorage('accessToken', '');
+
+  if (loading) return <div>Loading...</div>;
+
+  return (
+    <div>
+      <p>Token: {token}</p>
+      <button onClick={() => setToken('nuevo-token')}>
+        Update Token
+      </button>
+    </div>
+  );
+}
+```
+
+### Angular
+
+```typescript
+import { SecureStorageService } from '@bantis/local-cipher/angular';
+
+@Component({
+  selector: 'app-root',
+  template: `<div>{{ token$ | async }}</div>`
+})
+export class AppComponent {
+  token$ = this.storage.getItem('accessToken');
+
+  constructor(private storage: SecureStorageService) {}
+
+  saveToken(token: string) {
+    this.storage.setItem('accessToken', token).subscribe();
+  }
+}
+```
 ## Angular Integration
 
 ```typescript
@@ -286,29 +358,52 @@ v1 data is automatically migrated to v2 format on first read. No action required
 const storage = SecureStorage.getInstance();  // Works with both
 ```
 
-## Examples
+## Migration from v2.0.x to v2.1.0
+
+> [!WARNING]
+> **Breaking Change:** Framework-specific imports required
+
+### For React Users
+
+**Before (v2.0.x):**
+```typescript
+import { useSecureStorage } from '@bantis/local-cipher';
+```
+
+**After (v2.1.0):**
+```typescript
+import { useSecureStorage } from '@bantis/local-cipher/react';
+```
 
-See [/examples](./examples) directory for:
-- Basic usage
-- React integration
-- Angular integration
-- Advanced features (TTL, events, namespaces)
+### For Angular Users
 
-## Contributing
+**Before (v2.0.x):**
+```typescript
+import { SecureStorageService } from '@bantis/local-cipher';
+```
 
-Contributions welcome! Please read [CONTRIBUTING.md](./CONTRIBUTING.md) first.
+**After (v2.1.0):**
+```typescript
+import { SecureStorageService } from '@bantis/local-cipher/angular';
+```
 
-## Security Issues
+### For Core/Vanilla JS Users
 
-Report security vulnerabilities to [security@example.com](mailto:security@example.com). See [SECURITY.md](./SECURITY.md) for details.
+**No changes required:**
+```typescript
+import { SecureStorage } from '@bantis/local-cipher';  // Still works
+```
 
-## License
+### Why This Change?
 
-MIT © MTT - See [LICENSE](./LICENSE) for details.
+v2.0.x bundled all framework code together, causing dependency conflicts:
+- React projects needed Angular dependencies (`@angular/core`, `rxjs`)
+- Vanilla JS projects loaded unused React/Angular code
+- 40% larger bundle size for non-framework users
 
-## Links
+v2.1.0 separates frameworks into independent bundles:
+- ✅ Core: 42KB (no framework dependencies)
+- ✅ React: 49KB (core + hooks)
+- ✅ Angular: 55KB (core + service)
 
-- [npm package](https://www.npmjs.com/package/@bantis/local-cipher)
-- [GitHub repository](https://github.com/master-tech-team/-bantis-local-cipher)
-- [Changelog](./CHANGELOG.md)
-- [Security Policy](./SECURITY.md)
+## FAQ

package/dist/angular/SecureStorageService.d.ts

@@ -0,0 +1,156 @@
+import { Observable } from 'rxjs';
+import type { SecureStorageConfig, StorageEventData, ExpiryOptions, EncryptedBackup } from '../types';
+/**
+ * Servicio de Angular para SecureStorage v2
+ * Proporciona una API reactiva usando RxJS Observables
+ *
+ * @example
+ * constructor(private secureStorage: SecureStorageService) {}
+ *
+ * // Guardar
+ * this.secureStorage.setItem('token', 'abc123').subscribe();
+ *
+ * // Leer
+ * this.secureStorage.getItem('token').subscribe(token => console.log(token));
+ *
+ * // Escuchar eventos
+ * this.secureStorage.events$.subscribe(event => console.log(event));
+ */
+export declare class SecureStorageService {
+    private storage;
+    private debugInfo$;
+    private eventsSubject$;
+    /**
+     * Observable de eventos de storage
+     */
+    events$: Observable<StorageEventData>;
+    constructor(config?: SecureStorageConfig);
+    /**
+     * Guarda un valor encriptado
+     * @param key - Clave
+     * @param value - Valor a guardar
+     * @returns Observable que completa cuando se guarda
+     */
+    setItem(key: string, value: string): Observable<void>;
+    /**
+     * Guarda un valor con expiración
+     * @param key - Clave
+     * @param value - Valor a guardar
+     * @param options - Opciones de expiración
+     * @returns Observable que completa cuando se guarda
+     */
+    setItemWithExpiry(key: string, value: string, options: ExpiryOptions): Observable<void>;
+    /**
+     * Recupera un valor desencriptado
+     * @param key - Clave
+     * @returns Observable con el valor o null
+     */
+    getItem(key: string): Observable<string | null>;
+    /**
+     * Elimina un valor
+     * @param key - Clave a eliminar
+     * @returns Observable que completa cuando se elimina
+     */
+    removeItem(key: string): Observable<void>;
+    /**
+     * Verifica si existe una clave
+     * @param key - Clave a verificar
+     * @returns Observable con true/false
+     */
+    hasItem(key: string): Observable<boolean>;
+    /**
+     * Limpia todos los datos encriptados
+     */
+    clear(): void;
+    /**
+     * Limpia todos los items expirados
+     * @returns Observable con el número de items eliminados
+     */
+    cleanExpired(): Observable<number>;
+    /**
+     * Verifica la integridad de un valor
+     * @param key - Clave a verificar
+     * @returns Observable con true si es válido
+     */
+    verifyIntegrity(key: string): Observable<boolean>;
+    /**
+     * Obtiene información de integridad de un valor
+     * @param key - Clave
+     * @returns Observable con información de integridad
+     */
+    getIntegrityInfo(key: string): Observable<any>;
+    /**
+     * Crea un namespace para organizar datos
+     * @param name - Nombre del namespace
+     * @returns Instancia de NamespacedStorage
+     */
+    namespace(name: string): import("..").NamespacedStorage;
+    /**
+     * Rota todas las claves de encriptación
+     * @returns Observable que completa cuando termina la rotación
+     */
+    rotateKeys(): Observable<void>;
+    /**
+     * Exporta todos los datos como backup
+     * @returns Observable con el backup
+     */
+    exportEncryptedData(): Observable<EncryptedBackup>;
+    /**
+     * Importa datos desde un backup
+     * @param backup - Backup a importar
+     * @returns Observable que completa cuando termina la importación
+     */
+    importEncryptedData(backup: EncryptedBackup): Observable<void>;
+    /**
+     * Migra datos existentes a formato encriptado
+     * @param keys - Array de claves a migrar
+     * @returns Observable que completa cuando termina la migración
+     */
+    migrateExistingData(keys: string[]): Observable<void>;
+    /**
+     * Obtiene información de debug como Observable
+     * @returns Observable con información de debug que se actualiza automáticamente
+     */
+    getDebugInfo$(): Observable<any>;
+    /**
+     * Obtiene información de debug de forma síncrona
+     */
+    private getDebugInfo;
+    /**
+     * Helper para guardar objetos JSON
+     * @param key - Clave
+     * @param value - Objeto a guardar
+     */
+    setObject<T>(key: string, value: T): Observable<void>;
+    /**
+     * Helper para guardar objetos JSON con expiración
+     * @param key - Clave
+     * @param value - Objeto a guardar
+     * @param options - Opciones de expiración
+     */
+    setObjectWithExpiry<T>(key: string, value: T, options: ExpiryOptions): Observable<void>;
+    /**
+     * Helper para recuperar objetos JSON
+     * @param key - Clave
+     * @returns Observable con el objeto parseado o null
+     */
+    getObject<T>(key: string): Observable<T | null>;
+    /**
+     * Registra un listener para un tipo de evento específico
+     * @param event - Tipo de evento
+     * @param handler - Función manejadora
+     */
+    on(event: any, handler: (data: StorageEventData) => void): void;
+    /**
+     * Elimina un listener de evento
+     * @param event - Tipo de evento
+     * @param handler - Función manejadora
+     */
+    off(event: any, handler: (data: StorageEventData) => void): void;
+    /**
+     * Observable filtrado por tipo de evento
+     * @param eventType - Tipo de evento a filtrar
+     * @returns Observable con eventos del tipo especificado
+     */
+    onEvent$(eventType: string): Observable<StorageEventData>;
+}

package/dist/angular.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @bantis/local-cipher/angular - Angular Integration
+ * Angular service for encrypted browser storage
+ *
+ * @version 2.1.0
+ * @license MIT
+ */
+export * from './index';
+export { SecureStorageService } from './angular/SecureStorageService';