@envsec/core
v1.1.2
Published
Core secrets management engine — native OS credential store adapters + metadata DB
Maintainers
Readme
@envsec/core
Core secrets management engine for envsec — native OS credential store adapters and SQLite metadata database.
Overview
This package provides the foundational services used by the envsec CLI and @envsec/sdk:
- KeychainAccess — platform-specific credential store adapters (macOS Keychain, Linux Secret Service, Windows Credential Manager)
- MetadataStore — SQLite-based metadata tracking (key names, timestamps, expiry)
- SecretStore — high-level facade combining keychain operations with metadata
- Domain types — validated schemas for context names, secret keys, and durations
Installation
npm install @envsec/core
# or
pnpm add @envsec/coreMost users should use
envsec(CLI) or@envsec/sdk(programmatic API) instead of this package directly.
Architecture
Built with Effect 4 ([email protected]) using the layered service pattern.
- Services define interfaces as
Context.Service - Implementations provide concrete
Layerinstances - SecretStore composes
KeychainAccess+MetadataStoreinto a single facade
Supported Platforms
| OS | Backend | Tool / API |
| ------- | -------------------------- | -------------------------------- |
| macOS | Keychain | security CLI |
| Linux | Secret Service API (D-Bus) | secret-tool (libsecret) |
| Windows | Credential Manager | cmdkey + PowerShell (advapi32) |
License
MIT
