xero-kiwi 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: deaef4aaa66b0ac56631e391e34e5747c32da981244477ba212ff664cbe41cab
-  data.tar.gz: 6b3bd18bf430e1967d59875308e73749a13e3c2acc2279c9e58d065af94451db
+  metadata.gz: b000115e3c885aaad2274ddd3b75f507af96e5e779b016d290559dedfcb96ab8
+  data.tar.gz: c86cc3db68b995cf2620f45165157759e4ec9e4bac78ca12a2e9493562ea5856
 SHA512:
-  metadata.gz: f34e40a3b9774b0891a06ded04d66dd5857ab9b036c5dadd301a1480894e1c00d71c414b0631c563309f4ab74318859d0c37cdfb4beee9ad9526a04b4edeb612
-  data.tar.gz: b10602ef4148ab48c07fffaecf1a7b65b4b828ef037384309e693326bd3e823bbda79a439cf59d2f69cdcdc623385787c84f326793dc2779c85d83f1f4a6a6d8
+  metadata.gz: 267a35b68a93afcccef4ce0c161f739c627b048461dbc52972b5405df85b4d2b9b3ca3dfb12d135e20ba57c363bb20605a65d25a51fb108708c0b14a2b8d8341
+  data.tar.gz: f8b9e15d6b786fa9090f61bcc093c50a2bf9654f6ad4cf35bb8b6139dc3224e375907075e82bea1c1997be0c88df406c4559018c5cc89c62d398e4130dc26b71

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 ## [Unreleased]
 
+## [0.9.0] - 2026-09-29
+
+### Added
+
+- `Accounting::CreditNote` now models `payments`, which `Prepayment` and `Overpayment` both already did. Found by the asymmetry rather than by any payload comparison — four sibling resources, one missing a field, visible from the class definitions alone. The recorded `credit_notes/list` response carries `Payments` on all seventeen records, with data on two.
+- `Accounting::Prepayment` now models `reference`, which every comparable resource already did — `CreditNote`, `Overpayment`, `Invoice` and `Payment` all carry it. Confirmed against the recorded `prepayments/list` response: `Reference` is present on all nine records, with real values.
+
+  It was twice dismissed as a non-gap, including by me, on the strength of stored XML-era rows where the key was absent. That is the same mistake as the allocation regression — XML-derived data answering a question about JSON — and this time the JSON was already committed in `spec/fixtures` and went unread again. The recorded spec now asserts it.
+
+### Documentation
+
+- Added the four value-object docs — Address, Phone, ExternalLink, PaymentTerms — to the README's documentation table. They existed, were in the `llms.txt` manifest and were reachable from the generated bundles, while being invisible to anyone reading the README. `rake llms:check` now fails when a doc in the manifest is not linked from the README, which is the third index to get a drift guard.
+
 ## [0.8.0] - 2026-09-29
 
 ### Breaking

data/README.md

@@ -79,6 +79,10 @@ below.
 | [Prepayments](docs/accounting/prepayment.md) | Listing and fetching prepayments, the `XeroKiwi::Accounting::Prepayment` resource, LineItem |
 | [Branding Themes](docs/accounting/branding-theme.md) | Listing and fetching branding themes, the `XeroKiwi::Accounting::BrandingTheme` resource |
 | [Tracking Categories](docs/accounting/tracking-category.md) | Listing and fetching tracking categories, the `TrackingCategory` / `TrackingOption` / `Tracking` resources |
+| [Address](docs/accounting/address.md) | The `XeroKiwi::Accounting::Address` value object, nested on Organisation and Contact |
+| [Phone](docs/accounting/phone.md) | The `XeroKiwi::Accounting::Phone` value object, nested on Organisation and Contact |
+| [ExternalLink](docs/accounting/external-link.md) | The `XeroKiwi::Accounting::ExternalLink` value object |
+| [PaymentTerms](docs/accounting/payment-terms.md) | The `XeroKiwi::Accounting::PaymentTerms` and `PaymentTerm` value objects |
 | [Tokens](docs/tokens.md) | The `XeroKiwi::Token` value object, automatic refresh, revocation, persistence callbacks |
 | [OAuth](docs/oauth.md) | Authorization URL building, code exchange, PKCE, ID token verification, full Rails-style example |
 | [Errors](docs/errors.md) | The error hierarchy, what to catch and when |

data/Rakefile

@@ -30,6 +30,14 @@ namespace :llms do
       exit 1
     end
 
+    unlinked = Llms.unlinked_from_readme
+    unless unlinked.empty?
+      warn "✗ These docs are in the manifest but not linked from the README's documentation table:"
+      unlinked.each { |path| warn "    #{path}" }
+      warn "  Add a row for each, or remove them from Llms::DOCS."
+      exit 1
+    end
+
     stale = Llms.outputs.reject do |path, expected|
       File.exist?(path) && File.read(path, encoding: "UTF-8") == expected
     end

data/docs/accounting/credit-note.md

@@ -62,6 +62,7 @@ fields Xero returns:
 | `sent_to_contact` | `Boolean` | Whether the credit note has been sent to the contact. |
 | `remaining_credit` | `Numeric` | The remaining credit balance. |
 | `allocations` | `Array<XeroKiwi::Accounting::Allocation>` | Allocations to invoices. Each has `allocation_id`, the allocated value (as both `amount` and `applied_amount` — see below), `date`, `is_deleted`, and an `invoice` reference. |
+| `payments` | `Array<XeroKiwi::Accounting::Payment>` | Payment records (references), as on prepayments and overpayments. See [Payments](payment.md). |
 | `branding_theme_id` | `String` | The branding theme ID applied to the credit note. |
 | `has_attachments` | `Boolean` | Whether the credit note has attachments. |
 

data/docs/accounting/prepayment.md

@@ -57,6 +57,7 @@ fields Xero returns:
 | `currency_code` | `String` | The currency code (e.g. `"NZD"`). |
 | `currency_rate` | `String` | The currency rate (1.0 for base currency). |
 | `invoice_number` | `String` | The invoice number (for receive prepayments only). |
+| `reference` | `String` | The prepayment reference, as on credit notes and overpayments. Nil when Xero sends it empty. |
 | `remaining_credit` | `String` | The remaining credit balance. |
 | `allocations` | `Array<XeroKiwi::Accounting::Allocation>` | Allocations to invoices. Each has `allocation_id`, the allocated value (as both `amount` and `applied_amount` — see below), `date`, `is_deleted`, and an `invoice` reference. |
 | `payments` | `Array<XeroKiwi::Accounting::Payment>` | Payment records (references). See [Payments](payment.md). |

data/lib/xero_kiwi/accounting/credit_note.rb

@@ -31,6 +31,7 @@ module XeroKiwi
       attribute :sent_to_contact,    xero: "SentToContact",    type: :bool
       attribute :remaining_credit,   xero: "RemainingCredit",  type: :decimal
       attribute :allocations,        xero: "Allocations",      type: :collection, of: "Allocation"
+      attribute :payments,           xero: "Payments",         type: :collection, of: "Payment", reference: true
       attribute :branding_theme_id,  xero: "BrandingThemeID",  type: :guid
       attribute :has_attachments,    xero: "HasAttachments",   type: :bool
 

data/lib/xero_kiwi/accounting/prepayment.rb

@@ -25,6 +25,7 @@ module XeroKiwi
       attribute :currency_code,      xero: "CurrencyCode"
       attribute :currency_rate,      xero: "CurrencyRate", type: :decimal
       attribute :invoice_number,     xero: "InvoiceNumber"
+      attribute :reference,          xero: "Reference"
       attribute :remaining_credit,   xero: "RemainingCredit",  type: :decimal
       attribute :allocations,        xero: "Allocations",      type: :collection, of: "Allocation"
       attribute :payments,           xero: "Payments",         type: :collection, of: "Payment", reference: true

data/lib/xero_kiwi/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module XeroKiwi
-  VERSION = "0.8.0"
+  VERSION = "0.9.0"
 end

data/llms-full.txt

@@ -92,6 +92,10 @@ below.
 | [Prepayments](docs/accounting/prepayment.md) | Listing and fetching prepayments, the `XeroKiwi::Accounting::Prepayment` resource, LineItem |
 | [Branding Themes](docs/accounting/branding-theme.md) | Listing and fetching branding themes, the `XeroKiwi::Accounting::BrandingTheme` resource |
 | [Tracking Categories](docs/accounting/tracking-category.md) | Listing and fetching tracking categories, the `TrackingCategory` / `TrackingOption` / `Tracking` resources |
+| [Address](docs/accounting/address.md) | The `XeroKiwi::Accounting::Address` value object, nested on Organisation and Contact |
+| [Phone](docs/accounting/phone.md) | The `XeroKiwi::Accounting::Phone` value object, nested on Organisation and Contact |
+| [ExternalLink](docs/accounting/external-link.md) | The `XeroKiwi::Accounting::ExternalLink` value object |
+| [PaymentTerms](docs/accounting/payment-terms.md) | The `XeroKiwi::Accounting::PaymentTerms` and `PaymentTerm` value objects |
 | [Tokens](docs/tokens.md) | The `XeroKiwi::Token` value object, automatic refresh, revocation, persistence callbacks |
 | [OAuth](docs/oauth.md) | Authorization URL building, code exchange, PKCE, ID token verification, full Rails-style example |
 | [Errors](docs/errors.md) | The error hierarchy, what to catch and when |
@@ -2576,6 +2580,7 @@ fields Xero returns:
 | `sent_to_contact` | `Boolean` | Whether the credit note has been sent to the contact. |
 | `remaining_credit` | `Numeric` | The remaining credit balance. |
 | `allocations` | `Array<XeroKiwi::Accounting::Allocation>` | Allocations to invoices. Each has `allocation_id`, the allocated value (as both `amount` and `applied_amount` — see below), `date`, `is_deleted`, and an `invoice` reference. |
+| `payments` | `Array<XeroKiwi::Accounting::Payment>` | Payment records (references), as on prepayments and overpayments. See [Payments](payment.md). |
 | `branding_theme_id` | `String` | The branding theme ID applied to the credit note. |
 | `has_attachments` | `Boolean` | Whether the credit note has attachments. |
 
@@ -3041,6 +3046,7 @@ fields Xero returns:
 | `currency_code` | `String` | The currency code (e.g. `"NZD"`). |
 | `currency_rate` | `String` | The currency rate (1.0 for base currency). |
 | `invoice_number` | `String` | The invoice number (for receive prepayments only). |
+| `reference` | `String` | The prepayment reference, as on credit notes and overpayments. Nil when Xero sends it empty. |
 | `remaining_credit` | `String` | The remaining credit balance. |
 | `allocations` | `Array<XeroKiwi::Accounting::Allocation>` | Allocations to invoices. Each has `allocation_id`, the allocated value (as both `amount` and `applied_amount` — see below), `date`, `is_deleted`, and an `invoice` reference. |
 | `payments` | `Array<XeroKiwi::Accounting::Payment>` | Payment records (references). See [Payments](payment.md). |

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: xero-kiwi
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Douglas Greyling