npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@lssm/lib.economic-evidence

v3.0.2

Published

Provider-neutral economic evidence primitives for usage, cost, budget, replay, and projection refs.

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

farzimfarzim

Keywords

contractspececonomic-evidencecostusagebudgetreplaytypescript

Readme

@lssm/lib.economic-evidence

Provider-neutral economic evidence primitives for ContractSpec applications.

This package is the neutral spine selected by Ultragoal G002 for usage-based and commission-based systems. It records replayable facts and refs for cost, usage, budget decisions, redaction, replay, and projection consumers without owning provider SDKs, BillingOS invoices/payments, FinanceOps advice, or observability implementations.

Exports

  • @lssm/lib.economic-evidence
  • @lssm/lib.economic-evidence/cost
  • @lssm/lib.economic-evidence/decimal
  • @lssm/lib.economic-evidence/dimensions
  • @lssm/lib.economic-evidence/ledger
  • @lssm/lib.economic-evidence/usage
  • @lssm/lib.economic-evidence/budget
  • @lssm/lib.economic-evidence/replay
  • @lssm/lib.economic-evidence/reconciliation
  • @lssm/lib.economic-evidence/seam-kind
  • @lssm/lib.economic-evidence/projection-policy
  • @lssm/lib.economic-evidence/projection-refs
  • @lssm/lib.economic-evidence/unit-economics

Reconciled Cost Truth

EconomicLedgerEntryV1 models the append-only lifecycle estimate → reservation → execution_usage → provider_actual → invoice_import → correction. Corrections cite the entry they supersede; history is never deleted. reconciliationKey keeps successive observations of one economic fact from being double counted, while independent resources or usage lines remain independently additive.

Authoritative provider, invoice, reservation, and correction entries require exact minor-unit or decimal-string amounts. Estimated number-based compatibility records remain explicitly classified as estimates. Hard budget gates return review_required when cost evidence is unknown, stale, or unit-incompatible.

Allocation dimensions cover organization, tenant, workspace, environment, deployable, service, resource, capability, feature, contract/operation/version, endpoint, GraphQL, MCP, webhook, workflow, job, agent/tool invocation, provider/model, flag/variant, experiment, deployment, goal, and cost center. All calculations and canonicalization are deterministic and side-effect free.

Boundary

Producer packages may emit or cite these records. Projection packages may cite refs. This package must remain side-effect free and must not import provider, billing, finance, observability, or runtime implementations.

Projection And Seam Policy

Use createStandardEconomicProjectionRefs() from @lssm/lib.economic-evidence/projection-policy to produce reference-only projections for BillingOS, FinanceOps, observability, and replay reports. Billing projections carry not_an_invoice; FinanceOps projections carry not_accounting_export; observability and replay projections are display-only.

Monorepo Enforcement

src/adoption-enforcement.test.ts guards the current vertical slice: cost-tracking, ai-providers, ai-agent, and builder-runtime must depend on the neutral evidence package; ai/chat/builder public evidence entrypoints must remain exported; and the neutral package must stay free of runtime, provider, billing, finance, observability, and payment dependencies.

The seam-kind bridge maps canonical economic_* evidence ref kinds into the short contract/runtime seam categories (usage, cost, budget, replay, projection). This keeps OperationSpec and runtime events compact while preserving the canonical neutral ref taxonomy for persisted evidence.

Published export maps include explicit browser conditions for the emitted browser artifacts, alongside the existing Node and Bun conditions. A browser bundler can select these without relying on the default server-runtime condition.