Skip to content

Rulvar API reference


Rulvar API reference / @rulvar/core / InvoiceCardinality

Interface: InvoiceCardinality ​

Defined in: packages/core/src/engine/invoice.ts:201

Logical dispatches against provider HTTP requests (RV1210). One row is one DISPATCH, and a dispatch that absorbed provider-side continuations (RV905) is billed by the provider as several requests, so a per-request statement has MORE lines than this export has rows BY CONSTRUCTION. The counters state that difference instead of leaving a host to meet it as an unexplained count mismatch: a reconciliation that compares row count against statement line count should compare wireRequests, and wireIdsMissing says how many of those requests carry no join key at all.

Properties ​

PropertyTypeDescriptionDefined in
dispatchRowsnumberRows folding a real provider call; unattributed remainders excluded.packages/core/src/engine/invoice.ts:203
multiWireRowsnumberRows whose dispatch absorbed more than one wire request.packages/core/src/engine/invoice.ts:207
wireIdsMissingnumberWire requests with no recorded join key, across EVERY dispatch row (RV1410): a multi-wire row contributes the requests its id set left unnamed, and a single-wire row contributes its one request when neither responseId nor an id set names it. Failed requests count like any other: the provider may have billed them, and a statement line cannot be joined to a row that has no id either way.packages/core/src/engine/invoice.ts:217
wireRequestsnumberProvider HTTP requests those rows represent, absorbed continuations counted.packages/core/src/engine/invoice.ts:205