feat: v3 invoice api get review

.agents/skills/api/rules/aip-126-enums.md

@@ -3,5 +3,5 @@
 Reference: https://kong-aip.netlify.app/aip/126/
 
 - All enum wire values must be `snake_case` (enforced as an error by the `casing-aip-errors` linter rule).
-- Every enum must define an `unknown` member as the zero/default value.
+- Prefer defining an `unknown` member as the zero/default value. This is a recommendation, not a requirement — most domains (charges, subscriptions, currencies) omit it, so do not flag its absence as a violation.
 - Prefer enums over booleans for two-state fields — this allows a third state to be added later without a breaking change.

api/spec/packages/aip-client-javascript/src/index.ts

@@ -64,15 +64,15 @@ export type {
   CreateLabels,
   TaxConfigStripe,
   TaxConfigExternalInvoicing,
-  FlatFeeDiscounts,
+  ChargeFlatFeeDiscounts,
   PriceFree,
   WorkflowCollectionAlignmentSubscription,
   WorkflowPaymentChargeAutomaticallySettings,
   WorkflowPaymentSendInvoiceSettings,
-  InvoiceExternalIds,
+  InvoiceExternalReferences,
   InvoiceAvailableActionDetails,
   InvoiceWorkflowInvoicingSettings,
-  InvoiceLineExternalIds,
+  InvoiceLineExternalReferences,
   LlmCostProvider,
   LlmCostModel,
   RateCardStaticEntitlement,
@@ -157,7 +157,6 @@ export type {
   QueryFilterStringMapItem,
   CustomerKeyReference,
   CustomerUsageAttribution,
-  BillingAddress,
   Address,
   AppStripeCreateCheckoutSessionCustomerUpdate,
   AppStripeCreateCheckoutSessionConsentCollectionPaymentMethodReuseAgreement,
@@ -232,9 +231,8 @@ export type {
   CreateCustomerRequest,
   Customer,
   UpsertCustomerRequest,
-  InvoiceCustomer,
   PartyAddresses,
-  Supplier,
+  InvoiceCustomer,
   AppStripeCreateCheckoutSessionConsentCollection,
   ListCustomerEntitlementAccessResponseData,
   WorkflowCollectionAlignmentAnchored,
@@ -262,7 +260,7 @@ export type {
   PricePagePaginatedResponse,
   CreateCreditGrantRequest,
   CreditGrant,
-  CreateFlatFeeChargeRequest,
+  CreateChargeFlatFeeRequest,
   WorkflowTaxSettings,
   SubscriptionAddonPagePaginatedResponse,
   PlanAddonPagePaginatedResponse,
@@ -271,8 +269,7 @@ export type {
   MeterQueryRequest,
   CustomerPagePaginatedResponse,
   Party,
-  InvoiceBase,
-  CreditNoteInvoice,
+  Supplier,
   AppStripeCreateCheckoutSessionRequestOptions,
   TaxCodePagePaginatedResponse,
   InvoiceWorkflowSettings,
@@ -284,14 +281,15 @@ export type {
   UpdateFeatureRequest,
   CreditGrantPagePaginatedResponse,
   BadRequest,
+  InvoiceBase,
   CustomerStripeCreateCheckoutSessionRequest,
   WorkflowCollectionSettings,
   AppPagePaginatedResponse,
   ProfileApps,
   GovernanceQueryResponse,
-  FlatFeeCharge,
-  UsageBasedCharge,
-  CreateUsageBasedChargeRequest,
+  ChargeFlatFee,
+  ChargeUsageBased,
+  CreateChargeUsageBasedRequest,
   InvoiceLineRateCard,
   RateCard,
   FeaturePagePaginatedResponse,
@@ -310,7 +308,7 @@ export type {
   UpsertPlanRequest,
   AddonPagePaginatedResponse,
   ProfilePagePaginatedResponse,
-  StandardInvoice,
+  InvoiceStandard,
   PlanPagePaginatedResponse,
   SortQueryInput,
   BaseErrorInput,
@@ -368,6 +366,6 @@ export type {
   UpsertPlanRequestInput,
   AddonPagePaginatedResponseInput,
   ProfilePagePaginatedResponseInput,
-  StandardInvoiceInput,
+  InvoiceStandardInput,
   PlanPagePaginatedResponseInput,
 } from './models/types.js'

api/spec/packages/aip-client-javascript/src/models/operations/customers.ts

@@ -5,11 +5,11 @@ import type {
   AppStripeCreateCheckoutSessionResult,
   AppStripeCreateCustomerPortalSessionResult,
   ChargePagePaginatedResponse,
+  CreateChargeFlatFeeRequest,
+  CreateChargeUsageBasedRequest,
   CreateCreditAdjustmentRequest as CreateCreditAdjustmentRequestBody,
   CreateCreditGrantRequestInput,
   CreateCustomerRequest as CreateCustomerRequestBody,
-  CreateFlatFeeChargeRequest,
-  CreateUsageBasedChargeRequest,
   CreditAdjustment,
   CreditBalances,
   CreditGrant,
@@ -172,7 +172,7 @@ export type ListCustomerChargesResponse = ChargePagePaginatedResponse
 
 export type CreateCustomerChargesRequest = {
   customerId: string
-  body: CreateFlatFeeChargeRequest | CreateUsageBasedChargeRequest
+  body: CreateChargeFlatFeeRequest | CreateChargeUsageBasedRequest
 }
 export type CreateCustomerChargesResponse = z.output<
   typeof schemas.createCustomerChargesResponse