███╗ ██╗ ██████╗ ██╗██████╗ ███████╗████████╗ █████╗ ██████╗██╗ ██╗
████╗ ██║██╔═══██╗██║██╔══██╗ ██╔════╝╚══██╔══╝██╔══██╗██╔════╝██║ ██╔╝
██╔██╗ ██║██║ ██║██║██║ ██║ █████╗ ██║ ███████║██║ █████╔╝
██║╚██╗██║██║ ██║██║██║ ██║ ██╔══╝ ██║ ██╔══██║██║ ██╔═██╗
██║ ╚████║╚██████╔╝██║██████╔╝ ███████╗ ██║ ██║ ██║╚██████╗██║ ██╗
╚═╝ ╚═══╝ ╚═════╝ ╚═╝╚═════╝ ╚══════╝ ╚═╝ ╚═╝ ╚═╝ ╚═════╝╚═╝ ╚═╝
LedgerBill VS Code Extension | BSL 1.1 | © Noir Stack LLC
A Noir Stack LLC Product
Build and validate LedgerBill usage-metering integrations from VS Code.
This extension is designed for customer organizations using LedgerBill's public API. It does not expose LedgerBill Platform Admin, internal diagnostics, route governance, key rotation, or LedgerBill team-only operations.
Features
- Store an organization-scoped LedgerBill API key in VS Code Secret Storage.
- Check the public LedgerBill OpenAPI contract.
- Open the LedgerBill API reference.
- Preview usage rating without writing billable usage.
- Report a usage event with an idempotency key.
- Insert
.envsettings for server-side integrations. - Add JavaScript and TypeScript snippets for
/api/v1/usage.
Commands
LedgerBill: Set API KeyLedgerBill: Clear API KeyLedgerBill: Check ConnectionLedgerBill: Open API ReferenceLedgerBill: Preview Usage RatingLedgerBill: Report Usage EventLedgerBill: Insert .env Template
Settings
| Setting | Default | Description |
|---|---|---|
ledgerbill.baseUrl |
https://ledgerbill.app |
LedgerBill API base URL. |
ledgerbill.tenantId |
empty | Optional tenant ID for generated snippets and session-scoped calls. |
ledgerbill.defaultFeatureKey |
api_calls |
Default feature key for usage previews and reports. |
Getting Started
- Install the extension.
- Run
LedgerBill: Set API Key. - Paste an organization-scoped API key from LedgerBill.
- Run
LedgerBill: Check Connection. - Run
LedgerBill: Preview Usage Rating.
Publishing
This package is structured for formal Marketplace submission:
npm install
npm run lint
npm test
npm run package
To publish with the verified LedgerBill Marketplace publisher, run:
npm run publish
Links
- Marketplace publisher: https://marketplace.visualstudio.com/items?itemName=LedgerBill.ledgerbill
- Website: https://ledgerbill.app
- Company: https://noirstack.com
- Issues: https://github.com/no1rstack/ledgerbill-sdk/issues
- Support: https://github.com/no1rstack/ledgerbill-sdk/issues
- LinkedIn: https://www.linkedin.com/company/113360045/
- Source: https://github.com/no1rstack/ledgerbill-sdk/tree/main/extensions/ledgerbill-vscode
Privacy and Security
API keys are stored with VS Code Secret Storage. The extension sends requests only to the configured LedgerBill base URL and only calls customer-facing endpoints:
/api/openapi.json/api/docs/api/v1/usage/preview/api/v1/usage
When running LedgerBill: Check Connection, the extension validates /api/openapi.json for:
- Required governed tags:
Tenant AdministrationBilling OperationsDeveloper APIsStripe IntegrationPolicy AdministrationAudit & GovernanceReplay Operations
- Forbidden public terms:
event-sourcedplatform admins/Platform Administratorplatform operations
The OpenAPI source of truth is src/openapi.ts, published at /api/openapi.json.
Requirements
- VS Code 1.92.0 or newer.
- A LedgerBill organization API key.
License
This project is licensed under the Business Source License 1.1 (BSL).
- Change Date: 2030-06-14 (4 years from initial release)
- Change License: Apache License 2.0
- Commercial Use: Restricted until Change Date
- After Change Date: Automatically converts to Apache 2.0
For more details, see LICENSE.
© 2026 Noir Stack LLC. All rights reserved.
For alternative licensing arrangements, contact: [email protected]