Rulvar API reference / @rulvar/rulvar / InvoicePricingProvenance
Interface: InvoicePricingProvenance
Defined in: packages/core/dist/index.d.ts
Where the fold's rates came from (RV407): composed says the caller priced with the snapshot's composedPriceUsd (RV611), the engine's own composition, so pin-covered rows reproduce the settled numbers and anything past the last pin priced at the caller's current table; snapshot says the caller priced with the raw pinned rows alone (the pre-RV611 label); current-table says the live table priced it, the historical behavior for journals without a pin. Attached by the caller, who is the one that chose.
Properties
| Property | Type | Description | Defined in |
|---|---|---|---|
currentPricingVersion? | string | The version of the caller's CURRENT table (RV706): on composed exports, the table that priced everything past pinnedThroughSeq; on current-table exports, the whole fold's table. The pinned segments each name their own version, and without this field the composition's second half stayed anonymous. Absent when the caller's table declares no version. | packages/core/dist/index.d.ts |
pinnedThroughSeq? | number | On composed exports: the last pin's settle seq. Rows at or past it (a segment journaled but not yet settled) priced at the current table, not any pin; each row's entrySeq locates it against this bound. | packages/core/dist/index.d.ts |
pricingVersion? | string | - | packages/core/dist/index.d.ts |
rows? | AppliedPricingRow[] | The pinned rows the fold used; present on snapshot-priced exports. Each row's rates carries ratesVerifiedAt when the pinning table stamped one (RV814): the machine-readable answer to how fresh the rates that priced settled history were. | packages/core/dist/index.d.ts |
segments? | PinnedPricingSegment[] | Per-pin coverage (RV611): every settled segment's version and rows with its seq boundaries, not only the last. A fold across a price-table rotation used to export one pricingVersion while its rows priced under several; this array is the honest declaration. | packages/core/dist/index.d.ts |
source | "snapshot" | "current-table" | "composed" | - | packages/core/dist/index.d.ts |