pure-md5 0.2.0 → 0.2.2

package/planning/03-optimization-size-tree-shaking/SUMMARY.md

@@ -1,168 +0,0 @@
-# Phase 3: Size Optimization and Tree-Shaking Configuration - Planning Summary
-
-## Overview
-
-A complete roadmap has been created for optimizing the pure-md5 library with migration to the modern tsup stack. The plan includes transitioning from the outdated Webpack+Babel+TypeScript to fast and efficient tsup.
-
-## Task Structure
-
-Total of 8 tasks, grouped by priorities:
-
-### Priority 1: Migration to Modern Stack
-
-1. **Task 1**: Migration from Webpack to tsup
-   - Install tsup and update TypeScript
-   - Remove outdated dependencies (Webpack, Babel)
-   - Configure tsup configuration
-   - Update package.json and scripts
-
-2. **Task 6**: tsup Configuration for Different Formats
-   - Configurations for CommonJS, ES modules, UMD
-   - Minimal build with aggressive optimization
-   - Configure exports in package.json
-
-### Priority 2: Code Optimization and Tree-Shaking
-
-3. **Task 2**: Consolidation of Small Modules
-   - Combine ff/gg/hh/ii into round-functions.ts
-   - Combine hex and rhex
-   - Reduce file count from 16 to ~10
-
-4. **Task 3**: Elimination of Code Duplication (add32)
-   - Remove inline definition from index.ts
-   - Single optimized implementation
-
-5. **Task 4**: Moving Runtime Check to Compile-Time
-   - Remove MD5('hello') check from runtime
-   - Move check to tests
-   - Simplify md5 function
-
-### Priority 3: Performance and Metrics
-
-6. **Task 5**: Loop and Operation Optimization
-   - Optimize md51.ts, add32.ts, md5cycle.ts
-   - Improve memory handling
-   - Create performance tests
-
-7. **Task 7**: Bundle Analysis and Metrics
-   - Bundle size measurement system
-   - Performance benchmarks
-   - TypeScript type quality check
-   - Tree-shaking effectiveness analysis
-
-### Priority 4: Documentation and Infrastructure
-
-8. **Task 8**: Documentation and CI/CD Update
-   - Update README and API documentation
-   - Configure GitHub Actions
-   - Code quality configurations
-   - Preparation for publication
-
-## Critical Issues Identified During Analysis
-
-### 1. Outdated Build Stack
-
-- **Problem**: Webpack 4 + TypeScript 3.5 + Babel (2019)
-- **Solution**: Migration to tsup (Task 1)
-
-### 2. Dependency Redundancy
-
-- **Problem**: 13 dev dependencies for a simple library
-- **Solution**: Reduction to 3-5 packages with tsup
-
-### 3. Slow Build
-
-- **Problem**: Webpack + Babel slow transpilation
-- **Solution**: tsup is 10-100 times faster
-
-### 4. Poor Tree-Shaking Due to CommonJS
-
-- **Problem**: `module: "commonjs"` in tsconfig.json
-- **Solution**: ES modules + native tree-shaking in tsup
-
-### 5. Runtime Overhead
-
-- **Problem**: `hex(md51('hello'))` check on every import
-- **Solution**: Move to compile-time (Task 4)
-
-### 6. Code Duplication
-
-- **Problem**: `add32` defined in two places
-- **Solution**: Eliminate duplication (Task 3)
-
-## Expected Results
-
-### Quantitative Metrics
-
-1. **Build speed**: 10-100x acceleration
-2. **Bundle size**: 20-30% reduction
-3. **Dev dependencies**: From 13 to 3-5 packages
-4. **Performance**: 10-20% improvement
-5. **File count**: From 16 to ~10
-
-### Qualitative Improvements
-
-1. **Modern stack**: tsup + TypeScript 5+
-2. **Better tree-shaking**: Native support in tsup
-3. **Flexible builds**: CommonJS, ES modules, UMD, minimal
-4. **Professional infrastructure**: CI/CD, documentation, tests
-5. **Improved developer experience**: Fast builds, watch mode
-
-## Execution Order
-
-Recommended task execution order:
-
-1. **Task 1** → **Task 6** (migration to tsup and format configuration)
-2. **Task 2** → **Task 3** → **Task 4** (code optimization)
-3. **Task 5** → **Task 7** (performance and metrics)
-4. **Task 8** (documentation and infrastructure)
-
-## Risks and Mitigation
-
-### Risk 1: Breaking Backward Compatibility
-
-- **Mitigation**: Preserving all formats (CommonJS, ES modules, UMD)
-- **Mitigation**: Thorough testing of all use cases
-
-### Risk 2: Issues with .d.ts File Generation
-
-- **Mitigation**: tsup has built-in d.ts support
-- **Mitigation**: Check with @arethetypeswrong/cli
-
-### Risk 3: Incompatibility with Existing Consumers
-
-- **Mitigation**: Preserving current API
-- **Mitigation**: Semantic versioning (major version for breaking changes)
-
-### Risk 4: Difficulty Debugging Minified Code
-
-- **Mitigation**: Source maps for development builds
-- **Mitigation**: Separate builds for development and production
-
-## Next Steps After Phase 3
-
-After successful optimization completion:
-
-1. **Phase 4**: File system integration
-2. **Phase 5**: WHATWG Streams support
-3. **Phase 6**: Comprehensive testing and documentation
-4. **Phase 7**: Architectural integration
-
-## Status
-
-- **Planning**: Completed ✅
-- **Implementation**: Awaiting start
-- **Testing**: Awaiting implementation
-- **Documentation**: Partially ready
-
-## Responsible Parties
-
-- AI Agent: Task implementation
-- Maintainer: Review and integration
-- CI/CD: Automatic testing and benchmarks
-
-## Investment
-
-**Time estimate:** 8-16 hours for all tasks
-**Timeline:** 2-3 days with full-time work
-**ROI:** High (accelerated development, reduced maintenance cost)

package/planning/04-adapter-backend/03-backend-web-crypto.md

@@ -1,149 +0,0 @@
-# Task 03: Web Crypto API Adapter Implementation
-
-## Goal
-
-Создать адаптер для использования Web Crypto API (Crypto.subtle.digest) для вычисления MD5 хеша.
-
-## Requirements
-
-- Support Web Crypto API в современных браузерах и Node.js 15+
-- Обработка строк и бинарных данных
-- Integration с единым интерфейсом MD5Backend
-
-## Implementation
-
-### 1. Создать файл src/adapters/web-crypto.ts
-
-```typescript
-export class WebCryptoBackend implements MD5Backend {
-  static name = 'webcrypto';
-  static version = '1.0.0';
-  
-  async hash(data: string): Promise<string> {
-    if (!await this.isAvailable()) {
-      throw new Error('Web Crypto API is not available');
-    }
-    
-    const encoder = new TextEncoder();
-    const buffer = encoder.encode(data);
-    const hashBuffer = await crypto.subtle.digest('MD5', buffer);
-    return this.bufferToHex(hashBuffer);
-  }
-  
-  async hashBinary(data: ArrayBuffer | Uint8Array): Promise<string> {
-    if (!await this.isAvailable()) {
-      throw new Error('Web Crypto API is not available');
-    }
-    
-    const buffer = data instanceof Uint8Array 
-      ? data.buffer 
-      : data;
-    const hashBuffer = await crypto.subtle.digest('MD5', buffer);
-    return this.bufferToHex(hashBuffer);
-  }
-  
-  static async isAvailable(): Promise<boolean> {
-    if (typeof crypto === 'undefined' || crypto === null) {
-      return false;
-    }
-    
-    if (typeof crypto.subtle === 'undefined' || crypto.subtle === null) {
-      return false;
-    }
-    
-    try {
-      return typeof crypto.subtle.digest === 'function';
-    } catch {
-      return false;
-    }
-  }
-  
-  private bufferToHex(buffer: ArrayBuffer): string {
-    const bytes = new Uint8Array(buffer);
-    return Array.from(bytes)
-      .map(b => b.toString(16).padStart(2, '0'))
-      .join('');
-  }
-}
-```
-
-### 2. Tests
-
-Создать файл `__tests__/adapters/web-crypto.test.ts`:
-
-```typescript
-describe('WebCryptoBackend', () => {
-  let backend: WebCryptoBackend;
-  
-  beforeAll(async () => {
-    if (!await WebCryptoBackend.isAvailable()) {
-      console.log('Web Crypto API not available, skipping tests');
-      return;
-    }
-    backend = new WebCryptoBackend();
-  });
-  
-  it('should hash string correctly', async () => {
-    const result = await backend.hash('hello');
-    expect(result).toBe('5d41402abc4b2a76b9719d911017c592');
-  });
-  
-  it('should hash empty string', async () => {
-    const result = await backend.hash('');
-    expect(result).toBe('d41d8cd98f00b204e9800998ecf8427e');
-  });
-  
-  it('should hash binary data', async () => {
-    const data = new Uint8Array([104, 101, 108, 108, 111]); // "hello"
-    const result = await backend.hashBinary(data);
-    expect(result).toBe('5d41402abc4b2a76b9719d911017c592');
-  });
-  
-  it('should be available in modern browsers', async () => {
-    const available = await WebCryptoBackend.isAvailable();
-    expect(available).toBe(true);
-  });
-});
-```
-
-### 3. Integration с основным кодом
-
-В `src/adapters/index.ts`:
-
-```typescript
-export { WebCryptoBackend } from './web-crypto.js';
-```
-
-### 4. Conditional exports
-
-В `package.json`:
-
-```json
-{
-  "exports": {
-    "./adapters/webcrypto": {
-      "types": "./dist/adapters/web-crypto.d.ts",
-      "import": "./dist/adapters/web-crypto.js"
-    }
-  }
-}
-```
-
-### 5. Checking в браузере и Node.js
-
-Тестирование в различных окружениях:
-
-```bash
-# Browsers
-npm run test:browser
-
-# Node.js 15+
-node --experimental-global-crypto --experimental-wasm-threads test.js
-```
-
-## Ожидаемый результат
-
-- ✅ WebCryptoBackend реализован
-- ✅ Tests проходят успешно
-- ✅ Интегрирован в общую систему адаптеров
-- ✅ Документирован usage

package/planning/04-adapter-backend/04-backend-node-crypto.md

@@ -1,181 +0,0 @@
-# Task 04: Node.js Crypto Adapter Implementation
-
-## Goal
-
-Создать адаптер для использования нативного `node:crypto` модуля для вычисления MD5 хеша.
-
-## Requirements
-
-- Support Node.js crypto API (версии 10+)
-- Обработка строк и бинарных данных
-- Потоковая обработка через update/digest
-- Integration с единым интерфейсом MD5Backend
-
-## Implementation
-
-### 1. Создать файл src/adapters/node-crypto.ts
-
-```typescript
-export class NodeCryptoBackend implements MD5Backend {
-  static name = 'nodecrypto';
-  static version = '1.0.0';
-  
-  private hashInstance: import('node:crypto').Hash | null = null;
-  
-  hash(data: string): string {
-    if (!this.isAvailable()) {
-      throw new Error('Node.js Crypto is not available');
-    }
-    
-    const crypto = require('node:crypto');
-    return crypto.createHash('md5').update(data).digest('hex');
-  }
-  
-  hashBinary(data: ArrayBuffer | Uint8Array): string {
-    if (!this.isAvailable()) {
-      throw new Error('Node.js Crypto is not available');
-    }
-    
-    const crypto = require('node:crypto');
-    const buffer = data instanceof Uint8Array 
-      ? data 
-      : Buffer.from(data);
-    return crypto.createHash('md5').update(buffer).digest('hex');
-  }
-  
-  update(data: string | ArrayBuffer | Uint8Array): void {
-    if (!this.hashInstance) {
-      const crypto = require('node:crypto');
-      this.hashInstance = crypto.createHash('md5');
-    }
-    
-    if (data instanceof ArrayBuffer) {
-      this.hashInstance.update(Buffer.from(data));
-    } else if (data instanceof Uint8Array) {
-      this.hashInstance.update(data);
-    } else {
-      this.hashInstance.update(data);
-    }
-  }
-  
-  digest(encoding: 'hex' | 'buffer' = 'hex'): string | Uint8Array {
-    if (!this.hashInstance) {
-      return encoding === 'hex' ? '' : new Uint8Array(0);
-    }
-    
-    return encoding === 'hex' 
-      ? this.hashInstance.digest('hex') 
-      : this.hashInstance.digest();
-  }
-  
-  reset(): void {
-    this.hashInstance = null;
-  }
-  
-  static isAvailable(): boolean {
-    try {
-      const crypto = require('node:crypto');
-      return typeof crypto.createHash === 'function';
-    } catch {
-      return false;
-    }
-  }
-}
-```
-
-### 2. Tests
-
-Создать файл `__tests__/adapters/node-crypto.test.ts`:
-
-```typescript
-describe('NodeCryptoBackend', () => {
-  let backend: NodeCryptoBackend;
-  
-  beforeAll(() => {
-    if (!NodeCryptoBackend.isAvailable()) {
-      console.log('Node.js Crypto not available, skipping tests');
-      return;
-    }
-    backend = new NodeCryptoBackend();
-  });
-  
-  it('should hash string correctly', () => {
-    const result = backend.hash('hello');
-    expect(result).toBe('5d41402abc4b2a76b9719d911017c592');
-  });
-  
-  it('should hash empty string', () => {
-    const result = backend.hash('');
-    expect(result).toBe('d41d8cd98f00b204e9800998ecf8427e');
-  });
-  
-  it('should hash binary data', () => {
-    const data = new Uint8Array([104, 101, 108, 108, 111]); // "hello"
-    const result = backend.hashBinary(data);
-    expect(result).toBe('5d41402abc4b2a76b9719d911017c592');
-  });
-  
-  it('should support streaming via update/digest', () => {
-    backend.update('he');
-    backend.update('l');
-    backend.update('lo');
-    const result = backend.digest('hex');
-    expect(result).toBe('5d41402abc4b2a76b9719d911017c592');
-  });
-  
-  it('should reset state', () => {
-    backend.update('hello');
-    backend.reset();
-    backend.update('world');
-    const result = backend.digest('hex');
-    expect(result).toBe('5d41402abc4b2a76b9719d911017c592'); // "world" hash
-  });
-  
-  it('should be available in Node.js', () => {
-    const available = NodeCryptoBackend.isAvailable();
-    expect(available).toBe(true);
-  });
-});
-```
-
-### 3. Integration с основным кодом
-
-В `src/adapters/index.ts`:
-
-```typescript
-export { NodeCryptoBackend } from './node-crypto.js';
-```
-
-### 4. Conditional exports
-
-В `package.json`:
-
-```json
-{
-  "exports": {
-    "./adapters/node": {
-      "types": "./dist/adapters/node-crypto.d.ts",
-      "import": "./dist/adapters/node-crypto.js",
-      "require": "./dist/adapters/node-crypto.cjs"
-    }
-  }
-}
-```
-
-### 5. Support CommonJS
-
-Для совместимости с CommonJS добавить `src/adapters/node-crypto.cjs`:
-
-```javascript
-'use strict';
-const { NodeCryptoBackend } = require('./node-crypto.js');
-module.exports = { NodeCryptoBackend };
-```
-
-## Ожидаемый результат
-
-- ✅ NodeCryptoBackend реализован
-- ✅ Support потоковой обработки (update/digest)
-- ✅ Tests проходят успешно
-- ✅ Интегрирован в общую систему адаптеров
-- ✅ Документирован usage

package/planning/04-adapter-backend/05-backend-pure-js.md

@@ -1,174 +0,0 @@
-# Task 05: Рефакторинг Pure JS кода в адаптер
-
-## Goal
-
-Преобразовать существующую реализацию MD5 в адаптер, соответствующий интерфейсу MD5Backend.
-
-## Текущая структура
-
-Текущий код находится в `src/`:
-- `src/index.ts` - главная функция md5
-- `src/md51.ts` - обработка сообщений
-- `src/md5blk.ts` - обработка блоков
-- `src/md5cycle.ts` - цикл MD5
-- `src/round-functions.ts` - функции раунда
-- и т.д.
-
-## Рефакторинг
-
-### 1. Создать файл src/adapters/pure-js.ts
-
-```typescript
-import { hex, md51 } from '../index.js';
-
-export class PureJSBackend implements MD5Backend {
-  static name = 'purejs';
-  static version = '0.1.0';
-  
-  private state: {
-    data: string;
-    finished: boolean;
-  };
-  
-  constructor() {
-    this.state = { data: '', finished: false };
-  }
-  
-  hash(data: string): string {
-    return md51(data);
-  }
-  
-  hashBinary(data: ArrayBuffer | Uint8Array): string {
-    const text = data instanceof ArrayBuffer
-      ? new TextDecoder().decode(data)
-      : new TextDecoder().decode(data);
-    return md51(text);
-  }
-  
-  update(data: string | ArrayBuffer | Uint8Array): void {
-    if (this.state.finished) {
-      // Reset if already finished
-      this.state = { data: '', finished: false };
-    }
-    
-    if (data instanceof ArrayBuffer) {
-      this.state.data += new TextDecoder().decode(data);
-    } else if (data instanceof Uint8Array) {
-      this.state.data += new TextDecoder().decode(data);
-    } else {
-      this.state.data += data;
-    }
-  }
-  
-  digest(encoding: 'hex' | 'buffer' = 'hex'): string | Uint8Array {
-    const result = md51(this.state.data);
-    this.state.finished = true;
-    
-    if (encoding === 'buffer') {
-      return this.hexToBuffer(result);
-    }
-    return result;
-  }
-  
-  reset(): void {
-    this.state = { data: '', finished: false };
-  }
-  
-  static isAvailable(): boolean {
-    return true; // Always available
-  }
-  
-  private hexToBuffer(hex: string): Uint8Array {
-    const bytes = [];
-    for (let i = 0; i < hex.length; i += 2) {
-      bytes.push(parseInt(hex.substring(i, i + 2), 16));
-    }
-    return new Uint8Array(bytes);
-  }
-}
-```
-
-### 2. Checking текущей реализации
-
-Убедиться, что `md51` работает корректно:
-
-```typescript
-// Test from __tests__/md51.test.ts
-it('should hash "hello" correctly', () => {
-  expect(md51('hello')).toBe('5d41402abc4b2a76b9719d911017c592');
-});
-```
-
-### 3. Integration с адаптерами
-
-В `src/adapters/index.ts`:
-
-```typescript
-export { PureJSBackend } from './pure-js.js';
-```
-
-### 4. Conditional exports
-
-В `package.json`:
-
-```json
-{
-  "exports": {
-    "./adapters/purejs": {
-      "types": "./dist/adapters/pure-js.d.ts",
-      "import": "./dist/adapters/pure-js.js"
-    }
-  }
-}
-```
-
-### 5. Tests
-
-Создать файл `__tests__/adapters/pure-js.test.ts`:
-
-```typescript
-describe('PureJSBackend', () => {
-  let backend: PureJSBackend;
-  
-  beforeAll(() => {
-    backend = new PureJSBackend();
-  });
-  
-  it('should hash string correctly', () => {
-    const result = backend.hash('hello');
-    expect(result).toBe('5d41402abc4b2a76b9719d911017c592');
-  });
-  
-  it('should hash empty string', () => {
-    const result = backend.hash('');
-    expect(result).toBe('d41d8cd98f00b204e9800998ecf8427e');
-  });
-  
-  it('should hash binary data', () => {
-    const data = new Uint8Array([104, 101, 108, 108, 111]); // "hello"
-    const result = backend.hashBinary(data);
-    expect(result).toBe('5d41402abc4b2a76b9719d911017c592');
-  });
-  
-  it('should support streaming via update/digest', () => {
-    backend.update('he');
-    backend.update('l');
-    backend.update('lo');
-    const result = backend.digest('hex');
-    expect(result).toBe('5d41402abc4b2a76b9719d911017c592');
-  });
-  
-  it('should be always available', () => {
-    const available = PureJSBackend.isAvailable();
-    expect(available).toBe(true);
-  });
-});
-```
-
-## Ожидаемый результат
-
-- ✅ PureJSBackend реализован из существующего кода
-- ✅ Сохранена совместимость с текущим API
-- ✅ Support потоковой обработки (update/digest)
-- ✅ Tests проходят успешно
-- ✅ Интегрирован в общую систему адаптеров