Replace custom getenv with npm package

[konard]

Summary

This PR addresses issue #3 by replacing the custom getenv implementation with the official getenv npm package, while maintaining backward compatibility and the existing case-insensitive lookup feature.

Key Changes

• Dependency Addition: Added getenv npm package (v2.0.0) for robust type casting and validation
• Enhanced getenv() function: Now uses the official package's type-safe methods:
  • getenv.int() / getenv.float() for numeric values
  • getenv.boolish() for boolean values with flexible parsing
  • getenv.string() for string values
• Maintained Features: Preserved case-insensitive lookup across multiple naming conventions (UPPER_CASE, camelCase, kebab-case, snake_case, PascalCase)
• Stricter Linting: Enforced no-unused-vars rule without exceptions, using modern catch { } syntax for ignored errors
• Documentation: Updated README with attribution to the getenv package

Test Results

All tests passing locally and in CI:

• ✅ 47/47 tests pass
• ✅ Linting and formatting checks pass
• ✅ Tests pass on Node.js, Bun, and Deno
• ✅ Changeset validation passes

Breaking Changes

None - the changes are fully backward compatible with the existing API.

🤖 Generated with Claude Code

Fixes #3

[konard]

🤖 AI Work Session Started

Starting automated work session at 2025-11-15T11:57:43.595Z

The PR has been converted to draft mode while work is in progress.

This comment marks the beginning of an AI work session. Please wait working session to finish, and provide your feedback.

[konard]

✅ PR is ready for review

I've successfully resolved the CI failure and completed the implementation:

What was done:

1. Fixed CI failure: Created the required changeset file (.changeset/use-getenv-package.md) documenting this patch release
2. Verified all changes:
   • All 47 tests pass locally and in CI
   • Linting and formatting checks pass
   • Tests pass on Node.js, Bun, and Deno
   • All CI checks are now passing ✅

Summary of changes in this PR:

• Replaced custom getenv implementation with the official getenv npm package
• Enhanced type safety using getenv.int(), getenv.float(), getenv.boolish(), and getenv.string()
• Maintained backward compatibility with case-insensitive lookup across multiple naming conventions
• Enforced stricter no-unused-vars linting with modern catch { } syntax
• Updated documentation with proper attribution

The PR is now ready for merge! 🚀

🤖 Generated with Claude Code

[konard]

🤖 Solution Draft Log

This log file contains the complete execution trace of the AI solution draft process.

💰 Cost estimation:

• Public pricing estimate: $1.534290 USD
• Calculated by Anthropic: $0.704521 USD
• Difference: $-0.829770 (-54.08%)
  📎 Log file uploaded as GitHub Gist (200KB)
  🔗 View complete solution draft log

---

Now working session is ended, feel free to review and add any feedback on the solution draft.

[konard]

🔄 Auto-restart 1/3

Detected uncommitted changes from previous run. Starting new session to review and commit them.

Uncommitted files:

M package-lock.json

---

Auto-restart will stop after changes are committed or after 2 more iterations. Please wait until working session will end and give your feedback.

[konard]

✅ Auto-restart Complete

Successfully handled uncommitted changes from previous session.

What was done:

1. Reviewed uncommitted changes: The package-lock.json had automated npm updates adding "peer": true markers to dev dependencies (acorn, eslint-plugin-n, eslint-config-prettier, prettier)
2. Verified local tests: All 47 tests pass ✅
3. Verified linting: ESLint check passes ✅
4. Committed changes: Added commit with proper message explaining the automated npm update
5. Pushed to remote: Successfully pushed to branch
6. Verified CI: All CI checks passing ✅

Current PR Status:

• ✅ All 47 tests passing
• ✅ All linting checks passing
• ✅ Tests pass on Node.js, Bun, and Deno
• ✅ Changeset validation passing
• ✅ All CI workflows successful
• ✅ PR is mergeable
• ✅ No uncommitted changes remaining

The PR is ready for merge! 🚀

🤖 Generated with Claude Code

[konard]

🤖 Solution Draft Log

This log file contains the complete execution trace of the AI solution draft process.

💰 Cost estimation:

• Public pricing estimate: $0.947449 USD
• Calculated by Anthropic: $0.410484 USD
• Difference: $-0.536965 (-56.67%)
  📎 Log file uploaded as GitHub Gist (345KB)
  🔗 View complete solution draft log

---

Now working session is ended, feel free to review and add any feedback on the solution draft.