@digitaldefiance/ecies-lib 4.4.13 → 4.4.14

package/src/interfaces/library-error.ts

@@ -1,23 +0,0 @@
-/**
- * Standardized error interface for Digital Defiance libraries
- * Ensures consistent error handling across the ecosystem
- */
-export interface LibraryError extends Error {
-  /** The library that generated this error */
-  readonly library: string;
-  /** Unique error code for programmatic handling */
-  readonly errorCode: string;
-  /** HTTP-style status code */
-  readonly statusCode: number;
-}
-
-/**
- * Interface for resources that can be disposed
- * Ensures consistent memory management across libraries
- */
-export interface DisposableResource {
-  /** Dispose of the resource and clean up memory */
-  dispose(): void;
-  /** Whether the resource has been disposed */
-  readonly isDisposed: boolean;
-}

package/src/interfaces/member.ts

@@ -1,84 +0,0 @@
-import type { Wallet } from '@ethereumjs/wallet';
-import type { EmailString } from '../email-string';
-import type MemberType from '../enumerations/member-type';
-import type { SecureBuffer } from '../secure-buffer';
-import type { SecureString } from '../secure-string';
-import type { SignatureUint8Array } from '../types';
-import type { IECIESConstants } from './ecies-consts';
-import type { IEncryptedChunk } from './encrypted-chunk';
-
-/**
- * Interface representing a member with cryptographic capabilities.
- * This interface defines the contract for member operations without
- * referencing concrete class implementations.
- */
-export interface IMember {
-  // Required properties
-  readonly id: Uint8Array;
-  readonly type: MemberType;
-  readonly name: string;
-  readonly email: EmailString;
-  readonly publicKey: Uint8Array;
-  readonly creatorId: Uint8Array;
-  readonly dateCreated: Date;
-  readonly dateUpdated: Date;
-
-  // Optional private data properties
-  readonly privateKey: SecureBuffer | undefined;
-  readonly wallet: Wallet;
-
-  // State properties
-  readonly hasPrivateKey: boolean;
-
-  // Key management methods
-  unloadPrivateKey(): void;
-  unloadWallet(): void;
-  unloadWalletAndPrivateKey(): void;
-  loadWallet(mnemonic: SecureString, eciesParams?: IECIESConstants): void;
-  loadPrivateKey(privateKey: SecureBuffer): void;
-
-  // Cryptographic methods
-  sign(data: Uint8Array): SignatureUint8Array;
-  signData(data: Uint8Array): SignatureUint8Array;
-  verify(signature: SignatureUint8Array, data: Uint8Array): boolean;
-  verifySignature(
-    data: Uint8Array,
-    signature: Uint8Array,
-    publicKey: Uint8Array,
-  ): boolean;
-
-  // Encryption/Decryption methods
-  encryptDataStream(
-    source: AsyncIterable<Uint8Array> | ReadableStream<Uint8Array>,
-    options?: {
-      recipientPublicKey?: Uint8Array;
-      onProgress?: (progress: {
-        bytesProcessed: number;
-        chunksProcessed: number;
-      }) => void;
-      signal?: AbortSignal;
-    },
-  ): AsyncGenerator<IEncryptedChunk, void, unknown>;
-
-  decryptDataStream(
-    source: AsyncIterable<Uint8Array> | ReadableStream<Uint8Array>,
-    options?: {
-      onProgress?: (progress: {
-        bytesProcessed: number;
-        chunksProcessed: number;
-      }) => void;
-      signal?: AbortSignal;
-    },
-  ): AsyncGenerator<Uint8Array, void, unknown>;
-
-  encryptData(
-    data: string | Uint8Array,
-    recipientPublicKey?: Uint8Array,
-  ): Promise<Uint8Array>;
-
-  decryptData(encryptedData: Uint8Array): Promise<Uint8Array>;
-
-  // Serialization methods
-  toJson(): string;
-  dispose(): void;
-}

package/src/interfaces/multi-recipient-chunk.ts

@@ -1,61 +0,0 @@
-/**
- * Multi-recipient encrypted chunk format
- *
- * Structure:
- * - Header (32 bytes): magic, version, recipientCount, chunkIndex, etc.
- * - Recipient headers (variable): encrypted symmetric keys for each recipient
- * - Encrypted data (variable): data encrypted with symmetric key
- */
-
-/**
- * Multi-recipient chunk header (32 bytes)
- */
-export interface IMultiRecipientChunkHeader {
-  /** Magic bytes: 0x4D524543 ("MREC") */
-  magic: number;
-  /** Version: 0x0001 */
-  version: number;
-  /** Number of recipients */
-  recipientCount: number;
-  /** Chunk index */
-  chunkIndex: number;
-  /** Original data size */
-  originalSize: number;
-  /** Encrypted data size */
-  encryptedSize: number;
-  /** Flags (bit 0: isLast, bit 1: hasChecksum) */
-  flags: number;
-}
-
-/**
- * Recipient header (variable size)
- */
-export interface IRecipientHeader {
-  /** Recipient ID (size determined by ID provider) */
-  id: Uint8Array;
-  /** Encrypted symmetric key size (2 bytes) */
-  keySize: number;
-  /** Encrypted symmetric key (variable) */
-  encryptedKey: Uint8Array;
-}
-
-/**
- * Multi-recipient encrypted chunk
- */
-export interface IMultiRecipientChunk {
-  /** Chunk index */
-  index: number;
-  /** Complete chunk data (header + recipient headers + encrypted data) */
-  data: Uint8Array;
-  /** Whether this is the last chunk */
-  isLast: boolean;
-  /** Number of recipients */
-  recipientCount: number;
-}
-
-// Re-export interface (type-only), utility function and constant from lib
-export {
-  MULTI_RECIPIENT_CONSTANTS,
-  getMultiRecipientConstants,
-} from '../lib/multi-recipient-chunk-utils';
-export type { IMultiRecipientConstants } from '../lib/multi-recipient-chunk-utils';

package/src/interfaces/pbkdf2-config.ts

@@ -1,6 +0,0 @@
-export interface IPbkdf2Config {
-  hashBytes: number;
-  saltBytes: number;
-  iterations: number;
-  algorithm: string;
-}

package/src/interfaces/pbkdf2-consts.ts

@@ -1,10 +0,0 @@
-export interface IPBkdf2Consts {
-  /** Hash algorithm (sha512) */
-  ALGORITHM: string;
-
-  /** Number of bytes in a salt. */
-  SALT_BYTES: number;
-
-  /** Expected number of pbkdf2 iterations per second when hashing a password. */
-  ITERATIONS_PER_SECOND: number;
-}

package/src/interfaces/pbkdf2-result.ts

@@ -1,5 +0,0 @@
-export interface IPbkdf2Result {
-  salt: Uint8Array;
-  hash: Uint8Array;
-  iterations: number;
-}

package/src/interfaces/stream-config.ts

@@ -1,17 +0,0 @@
-/**
- * Configuration for streaming encryption operations
- */
-export interface IStreamConfig {
-  /** Chunk size in bytes (default: 1MB) */
-  chunkSize: number;
-  /** Whether to include checksums for each chunk */
-  includeChecksums: boolean;
-}
-
-/**
- * Default streaming configuration
- */
-export const DEFAULT_STREAM_CONFIG: IStreamConfig = {
-  chunkSize: 1024 * 1024, // 1MB
-  includeChecksums: false,
-};

package/src/interfaces/stream-header.ts

@@ -1,34 +0,0 @@
-import type { EciesEncryptionTypeEnum } from '../enumerations/ecies-encryption-type';
-
-/**
- * Stream header structure (128 bytes fixed)
- */
-export interface IStreamHeader {
-  /** Magic bytes: 0x45435354 ("ECST") */
-  magic: number;
-  /** Version: 0x0001 */
-  version: number;
-  /** Encryption type */
-  encryptionType: EciesEncryptionTypeEnum;
-  /** Chunk size in bytes */
-  chunkSize: number;
-  /** Total number of chunks (0 if unknown) */
-  totalChunks: number;
-  /** Total bytes to process (0 if unknown) */
-  totalBytes: number;
-  /** Timestamp when stream started */
-  timestamp: number;
-}
-
-/**
- * Constants for stream header format
- */
-export const STREAM_HEADER_CONSTANTS: {
-  readonly MAGIC: 0x45435354;
-  readonly VERSION: 0x0001;
-  readonly HEADER_SIZE: 128;
-} = {
-  MAGIC: 0x45435354, // "ECST"
-  VERSION: 0x0001,
-  HEADER_SIZE: 128,
-} as const;

package/src/interfaces/stream-progress.ts

@@ -1,31 +0,0 @@
-/**
- * Progress information for streaming operations
- */
-export interface IStreamProgress {
-  /** Total bytes processed so far */
-  bytesProcessed: number;
-  /** Total bytes to process (undefined for unknown-length streams) */
-  totalBytes?: number;
-  /** Number of chunks processed */
-  chunksProcessed: number;
-  /** Percentage complete (0-100, undefined if totalBytes unknown) */
-  percentComplete?: number;
-  /** Current throughput in bytes per second */
-  throughputBytesPerSec: number;
-  /** Estimated time remaining in seconds (undefined if totalBytes unknown) */
-  estimatedTimeRemaining?: number;
-  /** Timestamp when operation started */
-  startTime: number;
-  /** Elapsed time in milliseconds */
-  elapsedTime: number;
-}
-
-/**
- * Callback function for progress updates
- */
-export type ProgressCallback = (progress: IStreamProgress) => void | Promise<void>;
-
-/**
- * Callback function for chunk completion
- */
-export type ChunkCallback = (chunk: { index: number; size: number }) => void | Promise<void>;

package/src/lib/configuration-provenance-utils.ts

@@ -1,29 +0,0 @@
-import { sha256 } from '@noble/hashes/sha2.js';
-import { bytesToHex } from '@noble/hashes/utils.js';
-import type { IConstants } from '../interfaces/constants';
-
-/**
- * Calculates a checksum for a configuration object.
- * Uses SHA-256 of JSON representation.
- */
-export function calculateConfigChecksum(config: IConstants): string {
-  // Create a stable JSON representation with BigInt support
-  const replacer = (_key: string, value: any) =>
-    typeof value === 'bigint' ? value.toString() : value;
-  const stable = JSON.stringify(config, replacer);
-  const encoder = new TextEncoder();
-  const data = encoder.encode(stable);
-  return bytesToHex(sha256(data));
-}
-
-/**
- * Captures a stack trace for provenance tracking
- */
-export function captureCreationStack(): string {
-  const stack = new Error().stack;
-  if (!stack) return 'stack unavailable';
-
-  // Remove the first two lines (Error message and this function)
-  const lines = stack.split('\n').slice(2);
-  return lines.join('\n');
-}

package/src/lib/crypto-container.ts

@@ -1,64 +0,0 @@
-/**
- * Service Container for dependency injection
- */
-
-import { I18nEngine } from '@digitaldefiance/i18n-lib';
-import { Constants } from '../constants';
-import { EciesStringKey } from '../enumerations/ecies-string-key';
-import { EciesComponentId, getEciesI18nEngine } from '../i18n-setup';
-import type { IConstants } from '../interfaces/constants';
-
-export enum CryptoServiceKey {
-  ECIES = 'ecies',
-  PBKDF2 = 'pbkdf2',
-  AES_GCM = 'aes-gcm',
-  PASSWORD_LOGIN = 'password-login',
-  FILE = 'file',
-  XOR = 'xor',
-}
-
-export class CryptoContainer {
-  private services = new Map<CryptoServiceKey, unknown>();
-  private config: IConstants;
-  private i18n: I18nEngine;
-
-  private constructor(config: IConstants, i18n: I18nEngine) {
-    this.config = config;
-    this.i18n = i18n;
-    this.initServices();
-  }
-
-  static create(
-    config: IConstants = Constants,
-    i18n?: I18nEngine,
-  ): CryptoContainer {
-    return new CryptoContainer(config, i18n || getEciesI18nEngine());
-  }
-
-  get<T>(key: CryptoServiceKey): T {
-    const service = this.services.get(key);
-    if (!service) {
-      throw new Error(
-        this.i18n.translate(
-          EciesComponentId,
-          EciesStringKey.Error_Container_ServiceNotFoundTemplate,
-          { service: key },
-        ),
-      );
-    }
-    return service as T;
-  }
-
-  private initServices(): void {
-    // Services will be lazily loaded to avoid circular dependencies
-    // Implementation will be added as services are migrated
-  }
-
-  getConfig(): IConstants {
-    return this.config;
-  }
-
-  getI18n(): I18nEngine {
-    return this.i18n;
-  }
-}