@peable.to/shared-types 0.3.0 → 0.3.1-oxy-one.0

package/dist/esm/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/dist/types/billing.d.ts

@@ -29,6 +29,8 @@ export interface BillingHostedSession {
 /** Provider observations only. Consumers own plan/status/entitlement interpretation. */
 export interface BillingSubscription {
     providerSubscriptionId: string;
+    /** Discovery only; invoice must still be read and proven paid. */
+    latestInvoiceId?: string | null;
     providerCustomerId: string;
     providerPriceId: string;
     storeId: string;
@@ -43,3 +45,42 @@ export interface BillingSubscription {
     cancelAt: string | null;
     cancelledAt: string | null;
 }
+/** Owned recurring checkout correlation; completing checkout is not paid evidence. */
+export interface BillingCheckoutSession extends BillingHostedSession {
+    id: string;
+}
+export interface BillingCheckoutObservation {
+    id: string;
+    status: 'open' | 'complete' | 'expired';
+    storeId: string;
+    planId: string;
+    providerCustomerId: string;
+    providerPriceId: string;
+    subscription: BillingSubscription | null;
+}
+/** Authenticated authoritative read, one settled full non-prorated line only.
+ * Tax figures are provider observations, not a tax quote or seller configuration. */
+export interface BillingInvoiceState extends BillingPaidInvoice {
+    chargeId: string;
+    amountRefunded: string;
+    state: 'paid' | 'fully_refunded' | 'partially_refunded';
+}
+export interface BillingPaidInvoice {
+    invoiceId: string;
+    lineId: string;
+    paymentIntentId: string;
+    providerSubscriptionId: string;
+    providerCustomerId: string;
+    providerPriceId: string;
+    storeId: string;
+    planId: string;
+    livemode: boolean;
+    currency: string;
+    amountPaid: string;
+    netAmount: string | null;
+    taxAmount: string | null;
+    periodStart: string;
+    periodEnd: string;
+    paidAt: string;
+    observedAt: string;
+}

package/dist/types/event.d.ts

@@ -58,7 +58,7 @@ export type WebhookEventType = 'payment_intent.confirming' | 'payment_intent.set
  * Additive to a published contract: an existing consumer that switches on
  * this union keeps compiling and simply never matches it.
  */
- | 'connected_account.updated';
+ | 'connected_account.updated' | 'billing.observation.updated';
 /**
  * Which resource each event type carries under `data.object`.
  *
@@ -68,7 +68,16 @@ export type WebhookEventType = 'payment_intent.confirming' | 'payment_intent.set
  * the default would silently ship a PaymentIntent to a consumer expecting
  * something else — which typechecks on both sides and fails only in production.
  */
+/** Wake-up only. Re-read the owner-bound SDK resource; this is never paid or grant authority. */
+export interface BillingObservation {
+    object: 'billing_observation';
+    resourceKind: 'subscription' | 'invoice';
+    resourceId: string;
+    revision: number;
+    observedAt: string;
+}
 export interface WebhookEventPayload {
+    'billing.observation.updated': BillingObservation;
     'payment_intent.confirming': PaymentIntent;
     'payment_intent.settled': PaymentIntent;
     'payment_intent.failed': PaymentIntent;

package/dist/types/index.d.ts

@@ -1,7 +1,7 @@
 export { UNITS_PER_COIN, isBaseUnitString, type CurrencyCode, CURRENCY_CODES, CURRENCY_DECIMALS, decimalsFor, isCurrencyCode, } from './money';
 export { type NetworkType } from './network';
 export { type PaymentIntentStatus, type PaymentIntentRail, type PaymentIntent, type CreatePaymentIntentParams, isValidStatusTransition, canStillBePaid, reachesSettlementFromPayer, POST_SETTLEMENT_STATUSES, PAYMENT_INTENT_STATUSES, PAYMENT_INTENT_RAILS, CHAIN_ONLY_STATUSES, CARD_ONLY_STATUSES, } from './paymentIntent';
-export { type WebhookEventType, type WebhookEvent, type WebhookEventPayload, } from './event';
+export { type WebhookEventType, type WebhookEvent, type WebhookEventPayload, type BillingObservation, } from './event';
 export { type Dispute, type DisputeEvidence, type DisputeStatus } from './dispute';
 export { type CapabilityStatus, type ConnectedAccount, type Refund, type RefundOrigin, type RefundStatus, type Settlement, type Transfer, type TransferReversal, type TransferReversalStatus, type TransferStatus, type TransferWithReversal, } from './settlement';
 export { type WebhookDelivery, type WebhookDeliveryStatus, } from './webhookDelivery';
@@ -11,4 +11,4 @@ export { type MerchantDisplay } from './merchantDisplay';
 export { type PaymentLink, type PublicPaymentLink, type CreatePaymentLinkParams, } from './paymentLink';
 export { type CheckoutSession, type CheckoutSessionPublic, type CreateCheckoutSessionParams, } from './checkoutSession';
 export { SOCIAL_SOURCE_APP_MAX_LENGTH, SOCIAL_SOURCE_REF_MAX_LENGTH, type SocialPaymentSource, type SocialNextAddressRequest, type SocialNextAddressResponse, type SocialReceiveCursorResponse, type SocialPaymentDirection, type SocialPayment, type SocialPaymentsResponse, type EnrichmentKind, type EnrichmentResult, type EnrichRequest, type EnrichResponse, } from './social';
-export { BILLING_SUBSCRIPTION_STATUSES, type BillingSubscriptionStatus, type BillingCustomer, type EnsureBillingCustomerParams, type CreateBillingCheckoutParams, type CreateBillingPortalParams, type BillingHostedSession, type BillingSubscription, } from './billing';
+export { BILLING_SUBSCRIPTION_STATUSES, type BillingSubscriptionStatus, type BillingCheckoutSession, type BillingCheckoutObservation, type BillingPaidInvoice, type BillingInvoiceState, type BillingCustomer, type EnsureBillingCustomerParams, type CreateBillingCheckoutParams, type CreateBillingPortalParams, type BillingHostedSession, type BillingSubscription, } from './billing';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peable.to/shared-types",
-  "version": "0.3.0",
+  "version": "0.3.1-oxy-one.0",
   "description": "Shared TypeScript types for the Peable Gateway — the wire contract shared by the backend, SDK, and frontend.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -8,7 +8,9 @@
   "source": "src/index.ts",
   "sideEffects": false,
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "registry": "https://registry.npmjs.org/",
+    "tag": "oxy-one"
   },
   "exports": {
     ".": {