npmextra/changelog.md

Changelog

2025-08-16 - 5.3.3 - fix(appdata)

Redact sensitive values in AppData logs and add redaction tests

• Add redactSensitiveValue helper in AppData to mask secrets (API keys, tokens, passwords, JWTs, etc.) during logging.
• Use redaction when logging raw and final mapping values in processMappingValue and nested key logging to avoid leaking sensitive data.
• Improve log output for long or special values (JWT/base64 detection, length-aware previews) while preserving actual stored values.
• Add test/test.redaction.ts to verify sensitive environment values are redacted in console output but still stored correctly in the kv store.
• Add local config .claude/settings.local.json (editor/CI permissions/settings).

2025-08-16 - 5.3.2 - fix(dependencies)

Bump @push.rocks/qenv to ^6.1.3 and add local Claude settings

• Bumped dependency @push.rocks/qenv from ^6.1.2 to ^6.1.3 in package.json
• Added .claude/settings.local.json to provide local Claude permissions and tooling allowances for development/CI helpers

2025-08-15 - 5.3.1 - fix(AppData/Conversion)

Improve boolean conversion and mapping evaluation in AppData, ensuring falsy values (like false, 0, and empty strings) are correctly handled and logged. Also, reduce test timeout and add local permissions settings for development.

• Enhanced toBoolean and evaluateMappingValue functions to properly preserve and log falsy values.
• Added detailed logging for mapping spec processing and nested key evaluations.
• Reduced test timeout in package.json for faster CI feedback.
• Introduced .claude/settings.local.json with updated permissions for local development.

2025-08-15 - 5.3.0 - feat(AppData)

Refactor AppData class for declarative env mapping and enhanced static helpers

• Introduced a singleton Qenv provider to optimize environment variable resolution.
• Centralized type conversion logic with utility functions for boolean, JSON, base64, number, and string conversions.
• Replaced complex switch statements with a composable, declarative mapping pipeline for processing envMapping.
• Enhanced logging during AppData initialization to clearly report key processing and overwrite operations.
• Added new static helper methods for environment variable access (valueAsBoolean, valueAsJson, valueAsBase64, valueAsString, valueAsNumber).
• Fixed boolean conversion issues and ensured backward compatibility with the deprecated 'ephermal' option.

2025-08-15 - 5.2.0 - feat(AppData)

Major refactoring of AppData class for improved elegance and maintainability

• New Features:

  • Added static helper methods for direct environment variable access:
    • AppData.valueAsBoolean() - Convert env vars to boolean
    • AppData.valueAsJson() - Parse env vars as JSON
    • AppData.valueAsBase64() - Decode base64 env vars
    • AppData.valueAsString() - Get env vars as string
    • AppData.valueAsNumber() - Parse env vars as number
  • Enhanced logging for AppData initialization and key processing:
    • Shows which storage type is being used (custom, ephemeral, auto-selected)
    • Logs each key being processed with its spec type
    • Reports success/failure for each key with type information
    • Provides summary statistics of processed keys

• Architecture Improvements:

  • Replaced 100+ line switch statement with declarative pipeline architecture
  • Introduced centralized type converters and transform registry
  • Implemented composable transform pipeline: parseMappingSpec() → resolveSource() → applyTransforms()
  • Added singleton Qenv provider to reduce allocations
  • Reduced code complexity by ~70% while maintaining 100% backward compatibility

• Bug Fixes:

  • Fixed boolean conversion to properly handle both string and boolean inputs
  • Added ephemeral option (correctly spelled) while maintaining backward compatibility with deprecated ephermal

• Performance:

  • Optimized environment variable resolution with shared Qenv instance
  • Reduced object allocations in static helpers

2025-08-15 - 5.1.4 - fix(AppData, dev dependencies, settings)

Improve boolean conversion in AppData, update @types/node dependency, and add local settings file.

• Fixed env var boolean conversion to properly handle non-string values in AppData.
• Updated @types/node from ^20.14.5 to ^22 in package.json.
• Added .claude/settings.local.json to configure project permissions locally.

2025-08-15 - 5.1.3 - fix(appdata)

Fix iteration over overwriteObject in AppData and update configuration for dependency and path handling

• Replaced incorrect looping constructs in the AppData class to properly iterate over overwriteObject keys
• Improved environment variable mapping and file path resolution in multiple TS modules
• Updated dependency versions and adjusted git workflow configurations
• Enhanced project configuration including TS config and build script adjustments

2024-11-06 - 5.1.2 - fix(appdata)

Fix iteration over overwriteObject in AppData class

• Corrected the for loop from in to of inside the AppData class for iterating over overwriteObject keys.

2024-11-05 - 5.1.1 - fix(AppData)

Fix issue with overwrite object handling in AppData class

• Corrected logic to handle cases when overwriteObject is undefined.

2024-11-05 - 5.1.0 - feat(appdata)

Add support for overwriting keys using the overwriteObject option in AppData

• Introduced the overwriteObject option in IAppDataOptions to allow overwriting specific keys in the AppData class.

2024-06-19 - 5.0.17 - 5.0.23 - Core Updates

Routine maintenance and updates to the core components.

• Multiple core updates and fixes improving stability

2024-06-12 - 5.0.13 - 5.0.16 - Core Updates

Maintenance focus on core systems with enhancements and problem resolutions.

• Enhancements and updates in the core functionality

2024-05-29 - 5.0.13 - Documentation Update

Descriptive improvements aligned with current features.

• Updated core description for better clarity in documentation

2024-04-01 - 5.0.10 - Configuration Update

Improved configuration management for build processes.

• Updated npmextra.json to reflect changes in git repository management

2024-02-12 - 5.0.0 - 5.0.9 - Major Core Enhancements

A series of critical updates with resolved issues in the core components.

• Introduction of new core features
• Several core system updates

2024-02-12 - 4.0.16 - Major Version Transition

Migration to the new major version with impactful changes.

• BREAKING CHANGE: Significant updates requiring attention for smooth transition

2023-08-24 - 3.0.9 - 4.0.16 - Organization Updates

Formatted updates with attention to organizational standards and practice.

• SWITCH to a new organizational scheme

2023-07-11 - 3.0.9 - Organizational Enhancement

Shifts aligning with contemporary structuring and logistics.

• Strategic realignment with organizational principles