liberusoftware / currency-context
Precise money values, ISO currency metadata, context, formatting, and exchange-rate contracts.
Maintainers
Package info
github.com/liberusoftware/module-currency-context
Type:liberu-module
pkg:composer/liberusoftware/currency-context
Requires
- php: ^8.5
- illuminate/contracts: ^13.0
- illuminate/support: ^13.0
- liberusoftware/module-manager: ^1.0
Requires (Dev)
- orchestra/testbench: ^11.1
- pestphp/pest: ^5.0
README
ISO metadata, precise money values, currency roles, formatting, and effective-dated exchange-rate contracts.
Software · Hosting · Services · Liberu Group
Feature scope
ISO metadata, precise money values, currency roles, formatting, and effective-dated exchange-rate contracts. This repository owns this capability as an independently versioned Composer package; hosts integrate it through its declared public boundaries rather than application-specific classes.
Capabilities
foundation.currency
Declared features
- ISO metadata
- Precise money values
- Currency roles
- Formatting
- Effective-dated exchange-rate contracts
Requirements and installation
| Dependency | Supported version |
|---|---|
php |
^8.5 |
illuminate/contracts |
^13.0 |
illuminate/support |
^13.0 |
liberusoftware/module-manager |
^1.0 |
Install the released package from the project root:
composer require liberusoftware/currency-context
The trusted liberusoftware/composer-installer places it in /modules/currency-context. The installed directory remains tracked by the host repository, while Composer and its lock file remain the source of version truth. Installation does not imply runtime enablement or commercial entitlement.
Architecture and integration
- Composer package:
liberusoftware/currency-context - Package type:
liberu-module - Installer name:
currency-context - Category:
foundation - Service provider:
Liberu\Foundation\Currency\CurrencyServiceProvider - Enabled by default:
no
Public contracts
src/Contracts/ExchangeRateProvider.php
Commands
- No console command is provided.
Events
- No package-owned event class is currently published.
Persistence and permissions
database/migrations/2026_08_01_063000_create_currency_context_tables.php
Authorization remains the host application's responsibility unless a public authorizer contract is listed above. Consumers should grant only the permissions needed for the exported capabilities and must not couple to internal tables or classes.
Testing
The package includes 2 test file(s). From a compatible host checkout, run:
vendor/bin/pest modules/currency-context/tests
Changes must preserve the manifest, service-provider integration, package boundaries, and PHP/Laravel compatibility declared above.
Security
Do not report security vulnerabilities through public GitHub issues. Email security@liberusoftware.com with reproduction details and the affected version so the report can be handled privately.
License
This module is open-source software available under the MIT License. The linked licence text is authoritative.
Feedback and contributing
Focused issues and tested pull requests are welcome in the GitHub repository. Keep changes within this module's capability boundary, update tests and documentation, and record user-visible changes in CHANGELOG.md.
Contributors
Thank you to everyone who helps improve Liberu. View the contributors graph.