@wildo-ai/external-connectors-models 1.1.4 → 1.1.5

package/dist/esm/protocols/billing.standard-interface.schemas.d.ts

@@ -62,6 +62,45 @@ export declare enum ProrationBehavior {
     /** Prorate and invoice the difference IMMEDIATELY rather than at the next cycle. */
     ALWAYS_INVOICE = "always_invoice"
 }
+/**
+ * How the provider treats a subscription change whose resulting payment does not succeed (#535, decision D6).
+ *
+ * Wildo applies a confirmed plan change IMMEDIATELY: entitlements move at local completion, and a failed proration
+ * payment moves the subscription to `past_due` through the webhook projection, where dunning owns what happens next.
+ * The value is DECLARED on every engine-issued change rather than left to the provider's default, so a change of that
+ * default can never silently change the semantics.
+ *
+ * Deliberately a one-member vocabulary. `pending_if_incomplete` (apply only after payment, expire after 23 h) was
+ * weighed and rejected in #535; add a member only with a decision that changes D6.
+ *
+ * spec-cite: https://docs.stripe.com/api/subscriptions/update — `payment_behavior`; the value equals Stripe's wire value,
+ * so the Stripe adapter passes it untranslated, as it does `ProrationBehavior`.
+ */
+export declare enum StandardBilling_SubscriptionPaymentBehavior {
+    /** Apply the change now; an unpaid resulting invoice leaves the subscription `past_due`. */
+    ALLOW_INCOMPLETE = "allow_incomplete"
+}
+/**
+ * What a FAILED provider mutation tells the caller about whether the change took effect (#535, decision D3).
+ *
+ * The distinction that matters is not the HTTP status but what may be recorded next: a conclusive refusal and a request
+ * that never executed may both be recorded as "no effect", while an indeterminate outcome must NEVER be — the provider
+ * may have applied it, or may still apply it. Only the adapter can read its vendor's error shape, so each adapter
+ * classifies (`StandardBilling_Interface.classifyMutationError`) and the engine decides on the class alone.
+ *
+ * spec-cite: https://docs.stripe.com/error-low-level — "Network errors", "Server errors", "Content errors" (the
+ * source of the classes for the Stripe adapter; other adapters map their own vendor's equivalents).
+ */
+export declare enum StandardBilling_MutationErrorClass {
+    /** The provider evaluated the request and refused it (e.g. a declined card, a missing object). No effect. */
+    CONCLUSIVE_REJECTION = "conclusive_rejection",
+    /** Refused before execution (rate limit, authentication). No effect; a later attempt must use a NEW idempotency key. */
+    NOT_EXECUTED = "not_executed",
+    /** Another request with the same idempotency key is still being processed. The outcome is not known yet. */
+    IN_FLIGHT_CONFLICT = "in_flight_conflict",
+    /** Timeout, connection loss, server error, or a failure after the provider answered. The change may have applied. */
+    INDETERMINATE = "indeterminate"
+}
 /**
  * Subscription status values (maps to Stripe subscription statuses).
  */
@@ -143,10 +182,37 @@ export interface StandardBilling_WebhookEvent {
     createdAt: Date;
 }
 export interface StandardBilling_CreateCustomerRequest {
-    /** Descriptive name (e.g., organization name or user display name) */
-    name: string;
-    /** Contact email for invoices and receipts */
-    email: string;
+    /**
+     * Descriptive name — the organisation's name for an org-scoped account, the person's display name
+     * for a user-scoped one.
+     *
+     * OPTIONAL, and that is the point (issue #486). It was required, and a caller that could not
+     * resolve one therefore had to INVENT it: the engine sent the literal `'Unknown'` for every
+     * customer it ever created. A contract that cannot express "we do not know" forces every caller to
+     * lie, and a fabricated value is worse than an absent one — an operator reading the provider
+     * dashboard cannot tell it from a real answer.
+     */
+    name?: string;
+    /**
+     * Contact email for invoices and receipts.
+     *
+     * OPTIONAL for the same reason as `name`, and additionally because **an organisation frequently has
+     * no billing email at all**. Sending a natural person's address for an ORGANISATION's customer
+     * record would put personal data on a record that is not about a person — the opposite of data
+     * minimisation, which asks that personal data be "adequate, relevant and limited to what is
+     * necessary".
+     * spec-cite: GDPR Art. 5(1)(c) — https://gdpr-info.eu/art-5-gdpr/
+     *
+     * It also makes the later erasure story cheap: an organisation record carrying no individual's
+     * identity never has to be visited when that individual exercises their right to erasure, so the
+     * obligation to inform recipients of an erasure does not reach it.
+     * spec-cite: GDPR Art. 17(2) — https://gdpr-info.eu/art-17-gdpr/
+     *
+     * Absent is a legitimate value at the provider: Stripe's own customer `email` is optional.
+     * spec-cite: N/A — describes the Stripe Customer object's declared optionality in this
+     * repository's own words (https://docs.stripe.com/api/customers/object).
+     */
+    email?: string;
     /** Arbitrary key-value metadata stored on the provider customer */
     metadata?: Record<string, string>;
 }
@@ -224,6 +290,8 @@ export interface StandardBilling_SyncPriceRequest {
     amount: number;
     currency: string;
     interval?: BillingInterval;
+    /** Multiplier of the recurring interval (3 months = quarterly). Omitted means 1; ignored for one-time prices. */
+    intervalCount?: number;
     /** For TIERED/VOLUME pricing models */
     tiers?: Array<{
         upTo: number | null;
@@ -281,14 +349,32 @@ export interface StandardBilling_CreateSubscriptionResponse {
     providerSubscriptionId: string;
     status: string;
 }
+/** Provider-confirmed identities of correlated additions from the same update operation. */
+export interface StandardBilling_UpdateSubscriptionResponse {
+    createdItems: Array<{
+        clientItemKey: string;
+        providerSubscriptionItemId: string;
+    }>;
+}
 export interface StandardBilling_UpdateSubscriptionRequest {
+    /**
+     * Server-owned identity of one attempted change, reused with the SAME subscription and payload
+     * when recovering a lost response. Never generate a new key for a retry. Provider retention is
+     * bounded: this does not replace confirmation consumption, freshness checks or reconciliation.
+     * This is request transport metadata, not subscription metadata or a browser authoring field.
+     */
+    idempotencyKey?: string;
+    /** Item patches: omitted existing items are retained; an item without an ID is added. */
     items?: Array<{
-        /** Provider-side subscription item ID (used to target the correct item on the provider).
-         * If omitted, the provider transformer falls back to index-based matching. */
+        /** Provider-side subscription item ID to update. Omit only when adding a new item. */
         providerSubscriptionItemId?: string;
+        /** Backend-generated correlation key for an intentional new item; echoed with its created provider ID. */
+        clientItemKey?: string;
         providerPriceId: string;
         quantity?: number;
     }>;
+    /** Explicit provider-side item IDs to remove. Omitting an item from `items` never removes it. */
+    removedProviderSubscriptionItemIds?: string[];
     /** Provider promotion code to apply */
     providerPromotionCodeId?: string;
     /**
@@ -301,9 +387,31 @@ export interface StandardBilling_UpdateSubscriptionRequest {
      * subscription update did before this field existed.
      */
     prorationBehavior?: ProrationBehavior;
+    /**
+     * How the provider treats an unpaid resulting invoice (#535, D6). Absent sends none, so the provider's default
+     * applies; the engine's own plan-change dispatch always declares it.
+     */
+    paymentBehavior?: StandardBilling_SubscriptionPaymentBehavior;
+    /** Unix seconds used for proration. Reuse the preview instant when confirming the same change. */
+    prorationDate?: number;
     metadata?: Record<string, string>;
 }
-export interface StandardBilling_CancelSubscriptionOptions {
+/**
+ * Hypothetical item patch for an upcoming invoice. Item identity, quantity and proration must match
+ * the eventual update; selecting the first provider item can accidentally preview an addon change.
+ * Omitted items remain on the subscription. This request never changes the subscription itself.
+ */
+export type StandardBilling_SubscriptionPreviewRequest = Pick<StandardBilling_UpdateSubscriptionRequest, 'items' | 'removedProviderSubscriptionItemIds' | 'prorationBehavior' | 'prorationDate'>;
+/**
+ * Request transport options shared by the subscription mutations that carry no payload of their own.
+ *
+ * `idempotencyKey` has the same contract as on {@link StandardBilling_UpdateSubscriptionRequest}: a server-owned
+ * identity of ONE attempted change, reused with the same subscription and options only to recover a lost response.
+ */
+export interface StandardBilling_SubscriptionMutationOptions {
+    idempotencyKey?: string;
+}
+export interface StandardBilling_CancelSubscriptionOptions extends StandardBilling_SubscriptionMutationOptions {
     /** If true, subscription remains active until current period ends */
     atPeriodEnd?: boolean;
 }
@@ -341,6 +449,7 @@ export interface StandardBilling_SubscriptionData {
  * Returned by retrieveUpcomingInvoice() for plan change previews.
  */
 export interface StandardBilling_InvoicePreview {
+    /** Upcoming invoice amount due, in currency minor units; not a promise of an immediate charge. */
     amount: number;
     currency: string;
     lineItems: Array<{
@@ -496,14 +605,25 @@ export interface StandardBilling_Interface {
     syncProduct(request: StandardBilling_SyncProductRequest): Promise<StandardBilling_SyncProductResponse>;
     syncPrice(request: StandardBilling_SyncPriceRequest): Promise<StandardBilling_SyncPriceResponse>;
     createSubscription(request: StandardBilling_CreateSubscriptionRequest): Promise<StandardBilling_CreateSubscriptionResponse>;
-    updateSubscription(providerSubscriptionId: string, request: StandardBilling_UpdateSubscriptionRequest): Promise<void>;
+    updateSubscription(providerSubscriptionId: string, request: StandardBilling_UpdateSubscriptionRequest): Promise<StandardBilling_UpdateSubscriptionResponse>;
     cancelSubscription(providerSubscriptionId: string, options?: StandardBilling_CancelSubscriptionOptions): Promise<void>;
     pauseSubscription(providerSubscriptionId: string): Promise<void>;
+    /** Resume paused payment collection; does not undo a scheduled cancellation. */
     resumeSubscription(providerSubscriptionId: string): Promise<void>;
+    /** Remove a pending period-end cancellation without changing collection or lifecycle status. */
+    removeScheduledCancellation(providerSubscriptionId: string, options?: StandardBilling_SubscriptionMutationOptions): Promise<void>;
+    /**
+     * Classify an error thrown by `updateSubscription`, `cancelSubscription` or `removeScheduledCancellation` (#535, D3).
+     *
+     * Must answer {@link StandardBilling_MutationErrorClass.INDETERMINATE} for anything the adapter cannot positively place
+     * — including an error the adapter itself threw AFTER the provider answered — because every other class licenses the
+     * caller to record that the change did not happen.
+     */
+    classifyMutationError(error: unknown): StandardBilling_MutationErrorClass;
     /** On-demand retrieval for reconciliation (if webhook missed) */
     retrieveSubscription(providerSubscriptionId: string): Promise<StandardBilling_SubscriptionData>;
-    /** Preview prorated cost of a plan change before user commits */
-    retrieveUpcomingInvoice(providerSubscriptionId: string, newPriceId?: string): Promise<StandardBilling_InvoicePreview>;
+    /** Preview the upcoming invoice for an optional item change; the amount is not necessarily charged immediately. */
+    retrieveUpcomingInvoice(providerSubscriptionId: string, request?: StandardBilling_SubscriptionPreviewRequest): Promise<StandardBilling_InvoicePreview>;
     /**
      * Invoices the provider holds for one customer, newest first.
      *

package/dist/esm/protocols/billing.standard-interface.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"billing.standard-interface.schemas.d.ts","sourceRoot":"","sources":["../../../src/protocols/billing.standard-interface.schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"billing.standard-interface.schemas.d.ts","sourceRoot":"","sources":["../../../../src/protocols/billing.standard-interface.schemas.ts"],"names":[],"mappings":"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"}

package/dist/esm/protocols/billing.standard-interface.schemas.js

@@ -69,6 +69,47 @@ export var ProrationBehavior;
     /** Prorate and invoice the difference IMMEDIATELY rather than at the next cycle. */
     ProrationBehavior["ALWAYS_INVOICE"] = "always_invoice";
 })(ProrationBehavior || (ProrationBehavior = {}));
+/**
+ * How the provider treats a subscription change whose resulting payment does not succeed (#535, decision D6).
+ *
+ * Wildo applies a confirmed plan change IMMEDIATELY: entitlements move at local completion, and a failed proration
+ * payment moves the subscription to `past_due` through the webhook projection, where dunning owns what happens next.
+ * The value is DECLARED on every engine-issued change rather than left to the provider's default, so a change of that
+ * default can never silently change the semantics.
+ *
+ * Deliberately a one-member vocabulary. `pending_if_incomplete` (apply only after payment, expire after 23 h) was
+ * weighed and rejected in #535; add a member only with a decision that changes D6.
+ *
+ * spec-cite: https://docs.stripe.com/api/subscriptions/update — `payment_behavior`; the value equals Stripe's wire value,
+ * so the Stripe adapter passes it untranslated, as it does `ProrationBehavior`.
+ */
+export var StandardBilling_SubscriptionPaymentBehavior;
+(function (StandardBilling_SubscriptionPaymentBehavior) {
+    /** Apply the change now; an unpaid resulting invoice leaves the subscription `past_due`. */
+    StandardBilling_SubscriptionPaymentBehavior["ALLOW_INCOMPLETE"] = "allow_incomplete";
+})(StandardBilling_SubscriptionPaymentBehavior || (StandardBilling_SubscriptionPaymentBehavior = {}));
+/**
+ * What a FAILED provider mutation tells the caller about whether the change took effect (#535, decision D3).
+ *
+ * The distinction that matters is not the HTTP status but what may be recorded next: a conclusive refusal and a request
+ * that never executed may both be recorded as "no effect", while an indeterminate outcome must NEVER be — the provider
+ * may have applied it, or may still apply it. Only the adapter can read its vendor's error shape, so each adapter
+ * classifies (`StandardBilling_Interface.classifyMutationError`) and the engine decides on the class alone.
+ *
+ * spec-cite: https://docs.stripe.com/error-low-level — "Network errors", "Server errors", "Content errors" (the
+ * source of the classes for the Stripe adapter; other adapters map their own vendor's equivalents).
+ */
+export var StandardBilling_MutationErrorClass;
+(function (StandardBilling_MutationErrorClass) {
+    /** The provider evaluated the request and refused it (e.g. a declined card, a missing object). No effect. */
+    StandardBilling_MutationErrorClass["CONCLUSIVE_REJECTION"] = "conclusive_rejection";
+    /** Refused before execution (rate limit, authentication). No effect; a later attempt must use a NEW idempotency key. */
+    StandardBilling_MutationErrorClass["NOT_EXECUTED"] = "not_executed";
+    /** Another request with the same idempotency key is still being processed. The outcome is not known yet. */
+    StandardBilling_MutationErrorClass["IN_FLIGHT_CONFLICT"] = "in_flight_conflict";
+    /** Timeout, connection loss, server error, or a failure after the provider answered. The change may have applied. */
+    StandardBilling_MutationErrorClass["INDETERMINATE"] = "indeterminate";
+})(StandardBilling_MutationErrorClass || (StandardBilling_MutationErrorClass = {}));
 /**
  * Subscription status values (maps to Stripe subscription statuses).
  */

package/dist/esm/protocols/billing.standard-interface.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"billing.standard-interface.schemas.js","sourceRoot":"","sources":["../../../src/protocols/billing.standard-interface.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,kEAAkE;AAClE,yEAAyE;AACzE,kEAAkE;AAElE;;GAEG;AACH,MAAM,CAAN,IAAY,YASX;AATD,WAAY,YAAY;IACtB,6BAAa,CAAA;IACb,qCAAqB,CAAA;IACrB,+CAA+C;IAC/C,iCAAiB,CAAA;IACjB,mDAAmD;IACnD,uCAAuB,CAAA;IACvB,mCAAmC;IACnC,mCAAmB,CAAA;AACrB,CAAC,EATW,YAAY,KAAZ,YAAY,QASvB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,kCAAe,CAAA;IACf,gCAAa,CAAA;AACf,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,cAKX;AALD,WAAY,cAAc;IACxB,mDAAmD;IACnD,yCAAuB,CAAA;IACvB,2CAA2C;IAC3C,yCAAuB,CAAA;AACzB,CAAC,EALW,cAAc,KAAd,cAAc,QAKzB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAN,IAAY,iBAOX;AAPD,WAAY,iBAAiB;IAC3B,6FAA6F;IAC7F,4DAAuC,CAAA;IACvC,2FAA2F;IAC3F,kCAAa,CAAA;IACb,oFAAoF;IACpF,sDAAiC,CAAA;AACnC,CAAC,EAPW,iBAAiB,KAAjB,iBAAiB,QAO5B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,kBAUX;AAVD,WAAY,kBAAkB;IAC5B,uCAAiB,CAAA;IACjB,2CAAqB,CAAA;IACrB,uCAAiB,CAAA;IACjB,6CAAuB,CAAA;IACvB,8DAA8D;IAC9D,+CAAyB,CAAA;IACzB,+DAAyC,CAAA;IACzC,2CAAqB,CAAA;IACrB,uCAAiB,CAAA;AACnB,CAAC,EAVW,kBAAkB,KAAlB,kBAAkB,QAU7B;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAN,IAAY,aAWX;AAXD,WAAY,aAAa;IACvB,4FAA4F;IAC5F,gCAAe,CAAA;IACf,sCAAsC;IACtC,8BAAa,CAAA;IACb,eAAe;IACf,8BAAa,CAAA;IACb,oEAAoE;IACpE,8BAAa,CAAA;IACb,yDAAyD;IACzD,gDAA+B,CAAA;AACjC,CAAC,EAXW,aAAa,KAAb,aAAa,QAWxB;AAED,kEAAkE;AAClE,+BAA+B;AAC/B,kEAAkE;AAElE;;;;GAIG;AACH,MAAM,CAAN,IAAY,yBAkCX;AAlCD,WAAY,yBAAyB;IACnC,0CAA0C;IAC1C,0EAA6C,CAAA;IAC7C,0EAA6C,CAAA;IAC7C,0EAA6C,CAAA;IAC7C,wFAA2D,CAAA;IAE3D,iEAAiE;IACjE,0DAA6B,CAAA;IAC7B,8EAAiD,CAAA;IACjD,oEAAuC,CAAA;IAEvC,oFAAoF;IACpF,sFAAyD,CAAA;IAEzD,oCAAoC;IACpC,kEAAqC,CAAA;IACrC,kEAAqC,CAAA;IAErC,mFAAmF;IACnF,qFAAqF;IACrF,8DAAiC,CAAA;IACjC,8DAAiC,CAAA;IACjC,8DAAiC,CAAA;IAEjC,yEAAyE;IACzE,oFAAuD,CAAA;IACvD,oFAAuD,CAAA;IACvD,oFAAuD,CAAA;IAEvD,kFAAkF;IAClF,qFAAqF;IACrF,gFAAmD,CAAA;IACnD,gFAAmD,CAAA;AACrD,CAAC,EAlCW,yBAAyB,KAAzB,yBAAyB,QAkCpC","sourcesContent":["/**\n * Standard Billing Interface\n * --------\n * This is the canonical interface that Wildo uses internally for all billing\n * operations. The ETL layer transforms these standard requests into\n * provider-specific API calls (e.g., Stripe, Paddle, LemonSqueezy).\n *\n * Design Principles:\n * 1. Provider-agnostic — works with any billing provider\n * 2. Hosted-first — uses provider-hosted checkout and portals (no PCI scope)\n * 3. Webhook-driven — state changes flow in via webhooks, not polling\n * 4. Scope-agnostic — billing accounts map to any Wildo scope (org, user)\n *\n * @see billing-and-features-system.md §7.1 (Standard Billing Interface)\n */\n\n// ===============================================================\n// Billing Interface Enums (canonical source, re-exported by saas-models)\n// ===============================================================\n\n/**\n * Pricing model for a price entry.\n */\nexport enum PricingModel {\n  FLAT = 'flat',\n  PER_UNIT = 'per_unit',\n  /** Volume pricing (all units at tier price) */\n  TIERED = 'tiered',\n  /** Incremental (each tier priced independently) */\n  GRADUATED = 'graduated',\n  /** Price per package of N units */\n  PACKAGE = 'package',\n}\n\n/**\n * Billing interval for recurring prices.\n */\nexport enum BillingInterval {\n  MONTH = 'month',\n  YEAR = 'year',\n}\n\n/**\n * Tax display mode: how prices are displayed (HT vs TTC).\n */\nexport enum TaxDisplayMode {\n  /** Price amounts are HT (tax added at checkout) */\n  EXCLUSIVE = 'exclusive',\n  /** Price amounts are TTC (tax embedded) */\n  INCLUSIVE = 'inclusive',\n}\n\n/**\n * How a mid-cycle subscription change is settled.\n *\n * A PROTOCOL vocabulary, and it lives here for the same reason {@link TaxDisplayMode} does: these three\n * values are the wire values a billing provider accepts. It was declared in `@wildo-ai/saas-models`\n * until 2026-09-08 and re-exported the other way round, which is why an authored proration could be\n * resolved by the engine and had no field on the request to travel in — the request contract could not\n * name the type without a package cycle, so the resolved value was sent as provider METADATA and\n * ignored (#516).\n *\n * `@wildo-ai/saas-models` re-exports it, so every existing consumer is unchanged.\n */\nexport enum ProrationBehavior {\n  /** Credit the unused time and charge the new price pro rata, settled on the next invoice. */\n  CREATE_PRORATIONS = 'create_prorations',\n  /** No proration: the change takes effect and the next invoice is the new price in full. */\n  NONE = 'none',\n  /** Prorate and invoice the difference IMMEDIATELY rather than at the next cycle. */\n  ALWAYS_INVOICE = 'always_invoice',\n}\n\n/**\n * Subscription status values (maps to Stripe subscription statuses).\n */\nexport enum SubscriptionStatus {\n  ACTIVE = 'active',\n  PAST_DUE = 'past_due',\n  UNPAID = 'unpaid',\n  CANCELLED = 'cancelled',\n  /** Stripe: first payment never completed within 23h window */\n  INCOMPLETE = 'incomplete',\n  INCOMPLETE_EXPIRED = 'incomplete_expired',\n  TRIALING = 'trialing',\n  PAUSED = 'paused',\n}\n\n/**\n * Invoice lifecycle status, as the PROVIDER reports it.\n *\n * A PROTOCOL vocabulary for the same reason {@link SubscriptionStatus} is one: these are the states\n * a billing provider puts an invoice in, and the adapter's job is to map its own wire values onto\n * them. It was declared in `@wildo-ai/saas-models` until 2026-09-09 and could not be named by this\n * package at all, so `listInvoices` — the read the reconciliation sweep needs — had no way to type\n * the one field the sweep compares.\n *\n * Moved rather than duplicated: a second enum with the same five members would be two sources for\n * one closed vocabulary, which is what `CLAUDE.md` forbids. `@wildo-ai/saas-models` re-exports it\n * exactly as it already re-exports `SubscriptionStatus`, `TaxDisplayMode` and `ProrationBehavior`,\n * so every existing consumer — including the `invoiceRefs` schema, the badge palette and the\n * documentation catalogue — imports the same specifier it always did.\n */\nexport enum InvoiceStatus {\n  /** Not finalized: the provider has not issued it for collection and it may still change. */\n  DRAFT = 'draft',\n  /** Finalized and awaiting payment. */\n  OPEN = 'open',\n  /** Settled. */\n  PAID = 'paid',\n  /** Cancelled by the provider or the merchant; never collectable. */\n  VOID = 'void',\n  /** Written off — payment was attempted and abandoned. */\n  UNCOLLECTIBLE = 'uncollectible',\n}\n\n// ===============================================================\n// Standard Billing Event Types\n// ===============================================================\n\n/**\n * Canonical billing events the system cares about.\n * Provider-specific events are mapped to these types by the transformer.\n * Only events that affect local state (features, status) need to be handled.\n */\nexport enum StandardBilling_EventType {\n  // Subscription lifecycle (→ feature sync)\n  SUBSCRIPTION_CREATED = 'subscription.created',\n  SUBSCRIPTION_UPDATED = 'subscription.updated',\n  SUBSCRIPTION_DELETED = 'subscription.deleted',\n  SUBSCRIPTION_TRIAL_WILL_END = 'subscription.trial_will_end',\n\n  // Invoice status (→ billing status tracking, past_due detection)\n  INVOICE_PAID = 'invoice.paid',\n  INVOICE_PAYMENT_FAILED = 'invoice.payment_failed',\n  INVOICE_FINALIZED = 'invoice.finalized',\n\n  // Checkout (→ one-off purchase completion for ONE_TIME, CREDIT_PACK, ITEM products)\n  CHECKOUT_SESSION_COMPLETED = 'checkout.session.completed',\n\n  // Customer (→ billing account sync)\n  CUSTOMER_UPDATED = 'customer.updated',\n  CUSTOMER_DELETED = 'customer.deleted',\n\n  // Coupon (→ no local action; coupons are managed through Wildo's promotion system.\n  // Included for logging/audit in case coupons are modified directly on the provider.)\n  COUPON_CREATED = 'coupon.created',\n  COUPON_UPDATED = 'coupon.updated',\n  COUPON_DELETED = 'coupon.deleted',\n\n  // Customer discount (→ subscription re-sync to pick up discount changes)\n  CUSTOMER_DISCOUNT_CREATED = 'customer.discount.created',\n  CUSTOMER_DISCOUNT_UPDATED = 'customer.discount.updated',\n  CUSTOMER_DISCOUNT_DELETED = 'customer.discount.deleted',\n\n  // Payment method (→ no local action needed; provider manages via Customer Portal.\n  // Included for completeness: apps can optionally log these events for audit trails.)\n  PAYMENT_METHOD_ATTACHED = 'payment_method.attached',\n  PAYMENT_METHOD_DETACHED = 'payment_method.detached',\n}\n\n// ===============================================================\n// Standard Billing Webhook Event\n// ===============================================================\n\n/**\n * Canonical webhook event representation.\n * Provider transformers parse raw webhook payloads into this shape.\n */\nexport interface StandardBilling_WebhookEvent {\n  /** Canonical event type */\n  type: StandardBilling_EventType;\n  /** Provider-assigned event ID (for idempotency) */\n  providerEventId: string;\n  /** Event payload — shape varies by event type */\n  data: Record<string, unknown>;\n  /** When the event occurred at the provider */\n  createdAt: Date;\n}\n\n// ===============================================================\n// Request/Response Types\n// ===============================================================\n\n// ── Customer ────────────────────────────────────────────────────\n\nexport interface StandardBilling_CreateCustomerRequest {\n  /** Descriptive name (e.g., organization name or user display name) */\n  name: string;\n  /** Contact email for invoices and receipts */\n  email: string;\n  /** Arbitrary key-value metadata stored on the provider customer */\n  metadata?: Record<string, string>;\n}\n\nexport interface StandardBilling_CreateCustomerResponse {\n  providerCustomerId: string;\n}\n\n/**\n * Postal address on a provider customer record.\n *\n * Every field is independently clearable (`null`) rather than merely omittable: `undefined` means\n * \"leave whatever the provider already has\", `null` means \"blank it\". Subject erasure needs the\n * second meaning — an address that is silently preserved because the request could only express\n * \"no change\" is personal data surviving an erasure.\n */\nexport interface StandardBilling_CustomerAddress {\n  line1?: string | null;\n  line2?: string | null;\n  city?: string | null;\n  state?: string | null;\n  postalCode?: string | null;\n  /** ISO 3166-1 alpha-2 country code. */\n  country?: string | null;\n}\n\nexport interface StandardBilling_UpdateCustomerRequest {\n  name?: string;\n  email?: string;\n  metadata?: Record<string, string>;\n  /**\n   * Contact phone. `null` clears it at the provider — see {@link StandardBilling_CustomerAddress}\n   * for why clearability is expressed separately from omission.\n   */\n  phone?: string | null;\n  /**\n   * Billing address. `null` clears the whole address; a partial object clears only the fields it\n   * sets to `null` and leaves the rest untouched.\n   */\n  address?: StandardBilling_CustomerAddress | null;\n}\n\n/**\n * A stored payment instrument attached to a provider customer.\n *\n * Deliberately thin: enough to identify an instrument for detachment and to render a\n * \"•••• 4242\"-style hint, and nothing more. Wildo never handles raw instrument data — that is the\n * whole point of routing users through the provider-hosted portal — so this carries no PAN, no\n * expiry, and no billing details.\n */\nexport interface StandardBilling_PaymentMethodSummary {\n  providerPaymentMethodId: string;\n  /**\n   * Instrument kind as the provider names it (`'card'`, `'sepa_debit'`, `'us_bank_account'`, …).\n   * Intentionally an OPEN provider identifier, not a closed Wildo vocabulary: the set differs per\n   * provider and grows without our involvement, and nothing in the framework branches on it — it\n   * is carried for display and diagnostics only.\n   */\n  type: string;\n  /** Last four digits, when the instrument exposes them. */\n  last4?: string;\n}\n\n// ── Product/Price Sync ──────────────────────────────────────────\n\nexport interface StandardBilling_SyncProductRequest {\n  /** Internal Wildo product key (stored in metadata for reverse lookup) */\n  productKey: string;\n  name: string;\n  description?: string;\n  /** If set, updates existing provider product instead of creating new */\n  providerProductId?: string;\n  metadata?: Record<string, string>;\n}\n\nexport interface StandardBilling_SyncProductResponse {\n  providerProductId: string;\n}\n\nexport interface StandardBilling_SyncPriceRequest {\n  providerProductId: string;\n  model: PricingModel;\n  /** Amount in smallest currency unit (cents) */\n  amount: number;\n  currency: string;\n  interval?: BillingInterval;\n  /** For TIERED/VOLUME pricing models */\n  tiers?: Array<{\n    upTo: number | null;\n    unitAmount: number;\n    flatAmount?: number;\n  }>;\n  /** For PACKAGE pricing */\n  packageSize?: number;\n  /** Tax behavior */\n  taxBehavior?: TaxDisplayMode;\n  /** If set, updates existing provider price instead of creating new */\n  providerPriceId?: string;\n  metadata?: Record<string, string>;\n}\n\nexport interface StandardBilling_SyncPriceResponse {\n  providerPriceId: string;\n}\n\n// ── Subscription Lifecycle ──────────────────────────────────────\n\nexport interface StandardBilling_CreateSubscriptionRequest {\n  providerCustomerId: string;\n  items: Array<{\n    providerPriceId: string;\n    quantity?: number;\n  }>;\n  trialPeriodDays?: number;\n  /** Provider promotion code to apply */\n  providerPromotionCodeId?: string;\n  /**\n   * Ask the provider to compute tax on this purchase (#408, 2026-09-08).\n   *\n   * Set from the application's `billing.tax.calculationMode`, which is PROVIDER_MANAGED or\n   * DISABLED — Wildo never calculates tax locally, so the only question a provider is asked is\n   * whether to calculate at all. A provider that cannot compute tax ignores this; one that can and\n   * is not configured for the customer's jurisdiction will say so at the call, which is the right\n   * place for that failure.\n   *\n   * Distinct from a price's `taxBehavior`, which says whether a displayed amount INCLUDES tax.\n   * That one has always reached the provider; this one decides whether tax is computed.\n   */\n  automaticTax?: boolean;\n  /**\n   * Require a payment method up front for a trial (#408, 2026-09-08).\n   *\n   * Set from the product's `behaviorPolicy.trial.requirePaymentMethod`, which was declared,\n   * labelled, rendered on billing screens and passed to no provider call — so a trial declared as\n   * requiring a card behaved identically to one that did not. Wonder Todos' enterprise plan\n   * (`true`) and professional plan (`false`) were indistinguishable at the provider.\n   *\n   * Two provider-side consequences follow and a connector should honour both: collect the payment\n   * method during checkout, and decide what happens if the trial ends without one.\n   */\n  requirePaymentMethodForTrial?: boolean;\n  metadata?: Record<string, string>;\n}\n\nexport interface StandardBilling_CreateSubscriptionResponse {\n  providerSubscriptionId: string;\n  status: string;\n}\n\nexport interface StandardBilling_UpdateSubscriptionRequest {\n  items?: Array<{\n    /** Provider-side subscription item ID (used to target the correct item on the provider).\n     * If omitted, the provider transformer falls back to index-based matching. */\n    providerSubscriptionItemId?: string;\n    providerPriceId: string;\n    quantity?: number;\n  }>;\n  /** Provider promotion code to apply */\n  providerPromotionCodeId?: string;\n  /**\n   * How the provider settles this mid-cycle change (#516).\n   *\n   * The engine resolves it from the target product's `upgrade`/`downgrade` behaviour policy and it\n   * had nowhere to travel: it was put in `metadata`, a free-form bag the provider does not read, so a\n   * product declaring `NONE` for a downgrade was still prorated by the provider's own default. Absent\n   * means \"do not send one\" — the provider applies its account default, which is what every\n   * subscription update did before this field existed.\n   */\n  prorationBehavior?: ProrationBehavior;\n  metadata?: Record<string, string>;\n}\n\nexport interface StandardBilling_CancelSubscriptionOptions {\n  /** If true, subscription remains active until current period ends */\n  atPeriodEnd?: boolean;\n}\n\n// ── Read/Sync (Reconciliation) ──────────────────────────────────\n\n/**\n * StandardBilling_SubscriptionData: canonical subscription representation\n * returned by the provider adapter's retrieveSubscription().\n * Used for reconciliation when webhooks may have been missed.\n */\nexport interface StandardBilling_SubscriptionData {\n  providerSubscriptionId: string;\n  status: SubscriptionStatus;\n  currentPeriodStart: Date;\n  currentPeriodEnd: Date;\n  cancelAtPeriodEnd: boolean;\n  trialEnd?: Date;\n  items: Array<{\n    providerSubscriptionItemId: string;\n    providerProductId: string;\n    providerPriceId: string;\n    quantity: number;\n  }>;\n  /** Active discount on this subscription (from coupon/promotion code) */\n  discount?: {\n    providerCouponId: string;\n    percentOff?: number;\n    amountOff?: number;\n    currency?: string;\n    duration: string;\n    durationInMonths?: number;\n    end?: Date;\n  };\n}\n\n/**\n * StandardBilling_InvoicePreview: canonical upcoming invoice from provider.\n * Returned by retrieveUpcomingInvoice() for plan change previews.\n */\nexport interface StandardBilling_InvoicePreview {\n  amount: number;\n  currency: string;\n  lineItems: Array<{\n    description: string;\n    amount: number;\n    quantity: number;\n    providerPriceId?: string;\n  }>;\n  periodStart: Date;\n  periodEnd: Date;\n}\n\n/**\n * StandardBilling_InvoiceData: an invoice the provider ALREADY holds.\n *\n * Distinct from {@link StandardBilling_InvoicePreview}, and the distinction is the point: a preview\n * is a hypothetical the provider computes on request and never stores, while this is a record that\n * exists at the provider whether or not Wildo ever heard about it. The second is what a\n * reconciliation sweep needs — a webhook that was never delivered leaves an invoice that exists\n * there and nowhere here, and no amount of previewing finds it.\n *\n * Deliberately thin. It carries what `invoiceRefs` stores and nothing else: line items, tax\n * breakdowns and payment attempts live at the provider, and the customer reaches them through the\n * provider-hosted portal.\n */\nexport interface StandardBilling_InvoiceData {\n  providerInvoiceId: string;\n  /** The customer the invoice was billed to — the key that maps it back to a local billing account. */\n  providerCustomerId: string;\n  status: InvoiceStatus;\n  /**\n   * The invoice TOTAL, in the CURRENCY's smallest unit.\n   *\n   * The total, not the amount PAID: an invoice's value does not depend on whether it has been\n   * settled, and an unpaid invoice recorded at zero is indistinguishable from a zero invoice.\n   */\n  total: number;\n  currency: string;\n  hostedInvoiceUrl?: string;\n  invoicePdfUrl?: string;\n  /** When the provider created the invoice — used to bound how far back a sweep looks. */\n  createdAt: Date;\n}\n\n// ── Checkout / Portal (Provider-Hosted UI) ──────────────────────\n\nexport interface StandardBilling_CreateCheckoutSessionRequest {\n  providerCustomerId: string;\n  lineItems: Array<{\n    providerPriceId: string;\n    quantity?: number;\n  }>;\n  /** Checkout mode: 'subscription' for recurring, 'payment' for one-time */\n  mode: 'subscription' | 'payment';\n  successUrl: string;\n  cancelUrl: string;\n  /** Allow promotion codes in checkout */\n  allowPromotionCodes?: boolean;\n  /** Pre-fill promotion code */\n  providerPromotionCodeId?: string;\n  /** Trial period for subscriptions */\n  trialPeriodDays?: number;\n  /**\n   * Ask the provider to compute tax on this purchase (#408, 2026-09-08).\n   *\n   * Set from the application's `billing.tax.calculationMode`, which is PROVIDER_MANAGED or\n   * DISABLED — Wildo never calculates tax locally, so the only question a provider is asked is\n   * whether to calculate at all. A provider that cannot compute tax ignores this; one that can and\n   * is not configured for the customer's jurisdiction will say so at the call, which is the right\n   * place for that failure.\n   *\n   * Distinct from a price's `taxBehavior`, which says whether a displayed amount INCLUDES tax.\n   * That one has always reached the provider; this one decides whether tax is computed.\n   */\n  automaticTax?: boolean;\n  /**\n   * Require a payment method up front for a trial (#408, 2026-09-08).\n   *\n   * Set from the product's `behaviorPolicy.trial.requirePaymentMethod`, which was declared,\n   * labelled, rendered on billing screens and passed to no provider call — so a trial declared as\n   * requiring a card behaved identically to one that did not. Wonder Todos' enterprise plan\n   * (`true`) and professional plan (`false`) were indistinguishable at the provider.\n   *\n   * Two provider-side consequences follow and a connector should honour both: collect the payment\n   * method during checkout, and decide what happens if the trial ends without one.\n   */\n  requirePaymentMethodForTrial?: boolean;\n  metadata?: Record<string, string>;\n}\n\nexport interface StandardBilling_CreateCheckoutSessionResponse {\n  /** Redirect URL for the hosted checkout page */\n  url: string;\n  sessionId: string;\n}\n\nexport interface StandardBilling_CreateCustomerPortalSessionResponse {\n  /** Redirect URL for the customer portal */\n  url: string;\n}\n\n// ── Usage Reporting (METERED products via Billing Meter Events) ─\n\nexport interface StandardBilling_ReportUsageRequest {\n  /** Meter event name (corresponds to the meter's event_name) */\n  meterEventName: string;\n  /** Provider customer ID (maps to payload.stripe_customer_id in Stripe) */\n  providerCustomerId: string;\n  /** Usage value to report */\n  value: number;\n  /** Optional event timestamp */\n  timestamp?: Date;\n  /** Optional unique event identifier (for idempotency) */\n  identifier?: string;\n}\n\n// ── Promotions ──────────────────────────────────────────────────\n\nexport interface StandardBilling_CreateCouponRequest {\n  /** Discount amount in smallest currency unit (for fixed discounts) */\n  amountOff?: number;\n  /** Discount percentage (for percentage discounts) */\n  percentOff?: number;\n  currency?: string;\n  duration: 'once' | 'repeating' | 'forever';\n  durationInMonths?: number;\n  maxRedemptions?: number;\n  metadata?: Record<string, string>;\n}\n\nexport interface StandardBilling_CreateCouponResponse {\n  providerCouponId: string;\n}\n\nexport interface StandardBilling_CreatePromotionCodeResponse {\n  providerPromotionId: string;\n}\n\n// ===============================================================\n// Standard Billing Interface\n// ===============================================================\n\n/**\n * Provider-agnostic billing interface.\n * Each billing provider (Stripe, Paddle, etc.) implements this interface\n * through a transformer that maps canonical operations to provider SDK calls.\n */\nexport interface StandardBilling_Interface {\n  // ── Customer (maps to BillingAccount) ──\n  createCustomer(request: StandardBilling_CreateCustomerRequest): Promise<StandardBilling_CreateCustomerResponse>;\n  updateCustomer(providerCustomerId: string, request: StandardBilling_UpdateCustomerRequest): Promise<void>;\n  /**\n   * Hard-delete the provider customer.\n   *\n   * ⚠️ NOT the subject-erasure path. Erasing a subject ANONYMIZES this customer (blank the personal\n   * fields, keep the record) because the financial history hanging off it — invoices, subscriptions,\n   * usage — is retained under a legal obligation and must stay attributable to its provider record.\n   * Deleting the customer would strand exactly the audit trail retention exists to preserve.\n   * Reserve this for a genuine account teardown with no retained history.\n   */\n  deleteCustomer(providerCustomerId: string): Promise<void>;\n\n  // ── Payment instruments ──\n  /**\n   * Stored payment instruments for a customer. Used by subject erasure to enumerate what must be\n   * detached; day-to-day management belongs in the provider-hosted portal.\n   */\n  listPaymentMethods(providerCustomerId: string): Promise<StandardBilling_PaymentMethodSummary[]>;\n  /**\n   * Detach an instrument from its customer. Detaching does NOT delete the instrument's transaction\n   * history at the provider — it stops future charges and unlinks it from the customer, which is\n   * what erasure needs and what the retained invoice record requires.\n   */\n  detachPaymentMethod(providerPaymentMethodId: string): Promise<void>;\n\n  // ── Product/Price sync (Wildo → Provider) ──\n  syncProduct(request: StandardBilling_SyncProductRequest): Promise<StandardBilling_SyncProductResponse>;\n  syncPrice(request: StandardBilling_SyncPriceRequest): Promise<StandardBilling_SyncPriceResponse>;\n\n  // ── Subscription lifecycle ──\n  // NOTE: User-initiated plan changes, cancellation, and payment method management\n  // should use createCustomerPortalSession() instead of calling these directly.\n  // These methods are for: initial checkout completion, backend-driven upgrades,\n  // admin-triggered changes, and webhook-driven updates.\n  createSubscription(request: StandardBilling_CreateSubscriptionRequest): Promise<StandardBilling_CreateSubscriptionResponse>;\n  updateSubscription(providerSubscriptionId: string, request: StandardBilling_UpdateSubscriptionRequest): Promise<void>;\n  cancelSubscription(providerSubscriptionId: string, options?: StandardBilling_CancelSubscriptionOptions): Promise<void>;\n  pauseSubscription(providerSubscriptionId: string): Promise<void>;\n  resumeSubscription(providerSubscriptionId: string): Promise<void>;\n\n  // ── Read/sync (for reconciliation and upcoming cost preview) ──\n  /** On-demand retrieval for reconciliation (if webhook missed) */\n  retrieveSubscription(providerSubscriptionId: string): Promise<StandardBilling_SubscriptionData>;\n  /** Preview prorated cost of a plan change before user commits */\n  retrieveUpcomingInvoice(providerSubscriptionId: string, newPriceId?: string): Promise<StandardBilling_InvoicePreview>;\n  /**\n   * Invoices the provider holds for one customer, newest first.\n   *\n   * The RECOVERY read for {@link StandardBilling_EventType.INVOICE_PAID} and its siblings. Wildo\n   * never creates an invoice — every local `invoiceRefs` row exists because a webhook arrived — so a\n   * delivery that is lost, or that arrives while the application is down and exhausts the provider's\n   * retries, leaves an invoice with no local trace and nothing that could notice. This is the only\n   * call that can find one.\n   *\n   * `limit` bounds one page and an adapter may cap it lower; the sweep asks for a recent window\n   * rather than the whole history, because an invoice older than the window has either been\n   * reconciled already or is a backlog no single tick should try to drain.\n   */\n  listInvoices(providerCustomerId: string, options?: { limit?: number }): Promise<StandardBilling_InvoiceData[]>;\n\n  // ── Provider-hosted UI (primary user-facing interactions) ──\n  /** Hosted checkout page — NO Stripe Elements needed, no PCI scope */\n  createCheckoutSession(request: StandardBilling_CreateCheckoutSessionRequest): Promise<StandardBilling_CreateCheckoutSessionResponse>;\n  /** Customer portal for: invoices, payment methods, billing address, cancel */\n  createCustomerPortalSession(providerCustomerId: string, returnUrl: string): Promise<StandardBilling_CreateCustomerPortalSessionResponse>;\n\n  // ── Usage reporting (for METERED products) ──\n  reportUsage(request: StandardBilling_ReportUsageRequest): Promise<void>;\n\n  // ── Webhooks ──\n  /** HTTP header name that carries the webhook signature (e.g., 'stripe-signature') */\n  readonly webhookSignatureHeaderName: string;\n  verifyWebhookSignature(payload: string | Uint8Array, signature: string, secret: string): boolean;\n  /** Parse a raw webhook payload into a canonical event. Returns null for unknown/unhandled event types. */\n  parseWebhookEvent(payload: string | Uint8Array): StandardBilling_WebhookEvent | null;\n\n  // ── Promotions (synced to provider) ──\n  createCoupon(request: StandardBilling_CreateCouponRequest): Promise<StandardBilling_CreateCouponResponse>;\n  createPromotionCode(providerCouponId: string, code: string): Promise<StandardBilling_CreatePromotionCodeResponse>;\n}\n"]}
+{"version":3,"file":"billing.standard-interface.schemas.js","sourceRoot":"","sources":["../../../../src/protocols/billing.standard-interface.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Standard Billing Interface\n * --------\n * This is the canonical interface that Wildo uses internally for all billing\n * operations. The ETL layer transforms these standard requests into\n * provider-specific API calls (e.g., Stripe, Paddle, LemonSqueezy).\n *\n * Design Principles:\n * 1. Provider-agnostic — works with any billing provider\n * 2. Hosted-first — uses provider-hosted checkout and portals (no PCI scope)\n * 3. Webhook-driven — state changes flow in via webhooks, not polling\n * 4. Scope-agnostic — billing accounts map to any Wildo scope (org, user)\n *\n * @see billing-and-features-system.md §7.1 (Standard Billing Interface)\n */\n\n// ===============================================================\n// Billing Interface Enums (canonical source, re-exported by saas-models)\n// ===============================================================\n\n/**\n * Pricing model for a price entry.\n */\nexport enum PricingModel {\n  FLAT = 'flat',\n  PER_UNIT = 'per_unit',\n  /** Volume pricing (all units at tier price) */\n  TIERED = 'tiered',\n  /** Incremental (each tier priced independently) */\n  GRADUATED = 'graduated',\n  /** Price per package of N units */\n  PACKAGE = 'package',\n}\n\n/**\n * Billing interval for recurring prices.\n */\nexport enum BillingInterval {\n  MONTH = 'month',\n  YEAR = 'year',\n}\n\n/**\n * Tax display mode: how prices are displayed (HT vs TTC).\n */\nexport enum TaxDisplayMode {\n  /** Price amounts are HT (tax added at checkout) */\n  EXCLUSIVE = 'exclusive',\n  /** Price amounts are TTC (tax embedded) */\n  INCLUSIVE = 'inclusive',\n}\n\n/**\n * How a mid-cycle subscription change is settled.\n *\n * A PROTOCOL vocabulary, and it lives here for the same reason {@link TaxDisplayMode} does: these three\n * values are the wire values a billing provider accepts. It was declared in `@wildo-ai/saas-models`\n * until 2026-09-08 and re-exported the other way round, which is why an authored proration could be\n * resolved by the engine and had no field on the request to travel in — the request contract could not\n * name the type without a package cycle, so the resolved value was sent as provider METADATA and\n * ignored (#516).\n *\n * `@wildo-ai/saas-models` re-exports it, so every existing consumer is unchanged.\n */\nexport enum ProrationBehavior {\n  /** Credit the unused time and charge the new price pro rata, settled on the next invoice. */\n  CREATE_PRORATIONS = 'create_prorations',\n  /** No proration: the change takes effect and the next invoice is the new price in full. */\n  NONE = 'none',\n  /** Prorate and invoice the difference IMMEDIATELY rather than at the next cycle. */\n  ALWAYS_INVOICE = 'always_invoice',\n}\n\n/**\n * How the provider treats a subscription change whose resulting payment does not succeed (#535, decision D6).\n *\n * Wildo applies a confirmed plan change IMMEDIATELY: entitlements move at local completion, and a failed proration\n * payment moves the subscription to `past_due` through the webhook projection, where dunning owns what happens next.\n * The value is DECLARED on every engine-issued change rather than left to the provider's default, so a change of that\n * default can never silently change the semantics.\n *\n * Deliberately a one-member vocabulary. `pending_if_incomplete` (apply only after payment, expire after 23 h) was\n * weighed and rejected in #535; add a member only with a decision that changes D6.\n *\n * spec-cite: https://docs.stripe.com/api/subscriptions/update — `payment_behavior`; the value equals Stripe's wire value,\n * so the Stripe adapter passes it untranslated, as it does `ProrationBehavior`.\n */\nexport enum StandardBilling_SubscriptionPaymentBehavior {\n  /** Apply the change now; an unpaid resulting invoice leaves the subscription `past_due`. */\n  ALLOW_INCOMPLETE = 'allow_incomplete',\n}\n\n/**\n * What a FAILED provider mutation tells the caller about whether the change took effect (#535, decision D3).\n *\n * The distinction that matters is not the HTTP status but what may be recorded next: a conclusive refusal and a request\n * that never executed may both be recorded as \"no effect\", while an indeterminate outcome must NEVER be — the provider\n * may have applied it, or may still apply it. Only the adapter can read its vendor's error shape, so each adapter\n * classifies (`StandardBilling_Interface.classifyMutationError`) and the engine decides on the class alone.\n *\n * spec-cite: https://docs.stripe.com/error-low-level — \"Network errors\", \"Server errors\", \"Content errors\" (the\n * source of the classes for the Stripe adapter; other adapters map their own vendor's equivalents).\n */\nexport enum StandardBilling_MutationErrorClass {\n  /** The provider evaluated the request and refused it (e.g. a declined card, a missing object). No effect. */\n  CONCLUSIVE_REJECTION = 'conclusive_rejection',\n  /** Refused before execution (rate limit, authentication). No effect; a later attempt must use a NEW idempotency key. */\n  NOT_EXECUTED = 'not_executed',\n  /** Another request with the same idempotency key is still being processed. The outcome is not known yet. */\n  IN_FLIGHT_CONFLICT = 'in_flight_conflict',\n  /** Timeout, connection loss, server error, or a failure after the provider answered. The change may have applied. */\n  INDETERMINATE = 'indeterminate',\n}\n\n/**\n * Subscription status values (maps to Stripe subscription statuses).\n */\nexport enum SubscriptionStatus {\n  ACTIVE = 'active',\n  PAST_DUE = 'past_due',\n  UNPAID = 'unpaid',\n  CANCELLED = 'cancelled',\n  /** Stripe: first payment never completed within 23h window */\n  INCOMPLETE = 'incomplete',\n  INCOMPLETE_EXPIRED = 'incomplete_expired',\n  TRIALING = 'trialing',\n  PAUSED = 'paused',\n}\n\n/**\n * Invoice lifecycle status, as the PROVIDER reports it.\n *\n * A PROTOCOL vocabulary for the same reason {@link SubscriptionStatus} is one: these are the states\n * a billing provider puts an invoice in, and the adapter's job is to map its own wire values onto\n * them. It was declared in `@wildo-ai/saas-models` until 2026-09-09 and could not be named by this\n * package at all, so `listInvoices` — the read the reconciliation sweep needs — had no way to type\n * the one field the sweep compares.\n *\n * Moved rather than duplicated: a second enum with the same five members would be two sources for\n * one closed vocabulary, which is what `CLAUDE.md` forbids. `@wildo-ai/saas-models` re-exports it\n * exactly as it already re-exports `SubscriptionStatus`, `TaxDisplayMode` and `ProrationBehavior`,\n * so every existing consumer — including the `invoiceRefs` schema, the badge palette and the\n * documentation catalogue — imports the same specifier it always did.\n */\nexport enum InvoiceStatus {\n  /** Not finalized: the provider has not issued it for collection and it may still change. */\n  DRAFT = 'draft',\n  /** Finalized and awaiting payment. */\n  OPEN = 'open',\n  /** Settled. */\n  PAID = 'paid',\n  /** Cancelled by the provider or the merchant; never collectable. */\n  VOID = 'void',\n  /** Written off — payment was attempted and abandoned. */\n  UNCOLLECTIBLE = 'uncollectible',\n}\n\n// ===============================================================\n// Standard Billing Event Types\n// ===============================================================\n\n/**\n * Canonical billing events the system cares about.\n * Provider-specific events are mapped to these types by the transformer.\n * Only events that affect local state (features, status) need to be handled.\n */\nexport enum StandardBilling_EventType {\n  // Subscription lifecycle (→ feature sync)\n  SUBSCRIPTION_CREATED = 'subscription.created',\n  SUBSCRIPTION_UPDATED = 'subscription.updated',\n  SUBSCRIPTION_DELETED = 'subscription.deleted',\n  SUBSCRIPTION_TRIAL_WILL_END = 'subscription.trial_will_end',\n\n  // Invoice status (→ billing status tracking, past_due detection)\n  INVOICE_PAID = 'invoice.paid',\n  INVOICE_PAYMENT_FAILED = 'invoice.payment_failed',\n  INVOICE_FINALIZED = 'invoice.finalized',\n\n  // Checkout (→ one-off purchase completion for ONE_TIME, CREDIT_PACK, ITEM products)\n  CHECKOUT_SESSION_COMPLETED = 'checkout.session.completed',\n\n  // Customer (→ billing account sync)\n  CUSTOMER_UPDATED = 'customer.updated',\n  CUSTOMER_DELETED = 'customer.deleted',\n\n  // Coupon (→ no local action; coupons are managed through Wildo's promotion system.\n  // Included for logging/audit in case coupons are modified directly on the provider.)\n  COUPON_CREATED = 'coupon.created',\n  COUPON_UPDATED = 'coupon.updated',\n  COUPON_DELETED = 'coupon.deleted',\n\n  // Customer discount (→ subscription re-sync to pick up discount changes)\n  CUSTOMER_DISCOUNT_CREATED = 'customer.discount.created',\n  CUSTOMER_DISCOUNT_UPDATED = 'customer.discount.updated',\n  CUSTOMER_DISCOUNT_DELETED = 'customer.discount.deleted',\n\n  // Payment method (→ no local action needed; provider manages via Customer Portal.\n  // Included for completeness: apps can optionally log these events for audit trails.)\n  PAYMENT_METHOD_ATTACHED = 'payment_method.attached',\n  PAYMENT_METHOD_DETACHED = 'payment_method.detached',\n}\n\n// ===============================================================\n// Standard Billing Webhook Event\n// ===============================================================\n\n/**\n * Canonical webhook event representation.\n * Provider transformers parse raw webhook payloads into this shape.\n */\nexport interface StandardBilling_WebhookEvent {\n  /** Canonical event type */\n  type: StandardBilling_EventType;\n  /** Provider-assigned event ID (for idempotency) */\n  providerEventId: string;\n  /** Event payload — shape varies by event type */\n  data: Record<string, unknown>;\n  /** When the event occurred at the provider */\n  createdAt: Date;\n}\n\n// ===============================================================\n// Request/Response Types\n// ===============================================================\n\n// ── Customer ────────────────────────────────────────────────────\n\nexport interface StandardBilling_CreateCustomerRequest {\n  /**\n   * Descriptive name — the organisation's name for an org-scoped account, the person's display name\n   * for a user-scoped one.\n   *\n   * OPTIONAL, and that is the point (issue #486). It was required, and a caller that could not\n   * resolve one therefore had to INVENT it: the engine sent the literal `'Unknown'` for every\n   * customer it ever created. A contract that cannot express \"we do not know\" forces every caller to\n   * lie, and a fabricated value is worse than an absent one — an operator reading the provider\n   * dashboard cannot tell it from a real answer.\n   */\n  name?: string;\n  /**\n   * Contact email for invoices and receipts.\n   *\n   * OPTIONAL for the same reason as `name`, and additionally because **an organisation frequently has\n   * no billing email at all**. Sending a natural person's address for an ORGANISATION's customer\n   * record would put personal data on a record that is not about a person — the opposite of data\n   * minimisation, which asks that personal data be \"adequate, relevant and limited to what is\n   * necessary\".\n   * spec-cite: GDPR Art. 5(1)(c) — https://gdpr-info.eu/art-5-gdpr/\n   *\n   * It also makes the later erasure story cheap: an organisation record carrying no individual's\n   * identity never has to be visited when that individual exercises their right to erasure, so the\n   * obligation to inform recipients of an erasure does not reach it.\n   * spec-cite: GDPR Art. 17(2) — https://gdpr-info.eu/art-17-gdpr/\n   *\n   * Absent is a legitimate value at the provider: Stripe's own customer `email` is optional.\n   * spec-cite: N/A — describes the Stripe Customer object's declared optionality in this\n   * repository's own words (https://docs.stripe.com/api/customers/object).\n   */\n  email?: string;\n  /** Arbitrary key-value metadata stored on the provider customer */\n  metadata?: Record<string, string>;\n}\n\nexport interface StandardBilling_CreateCustomerResponse {\n  providerCustomerId: string;\n}\n\n/**\n * Postal address on a provider customer record.\n *\n * Every field is independently clearable (`null`) rather than merely omittable: `undefined` means\n * \"leave whatever the provider already has\", `null` means \"blank it\". Subject erasure needs the\n * second meaning — an address that is silently preserved because the request could only express\n * \"no change\" is personal data surviving an erasure.\n */\nexport interface StandardBilling_CustomerAddress {\n  line1?: string | null;\n  line2?: string | null;\n  city?: string | null;\n  state?: string | null;\n  postalCode?: string | null;\n  /** ISO 3166-1 alpha-2 country code. */\n  country?: string | null;\n}\n\nexport interface StandardBilling_UpdateCustomerRequest {\n  name?: string;\n  email?: string;\n  metadata?: Record<string, string>;\n  /**\n   * Contact phone. `null` clears it at the provider — see {@link StandardBilling_CustomerAddress}\n   * for why clearability is expressed separately from omission.\n   */\n  phone?: string | null;\n  /**\n   * Billing address. `null` clears the whole address; a partial object clears only the fields it\n   * sets to `null` and leaves the rest untouched.\n   */\n  address?: StandardBilling_CustomerAddress | null;\n}\n\n/**\n * A stored payment instrument attached to a provider customer.\n *\n * Deliberately thin: enough to identify an instrument for detachment and to render a\n * \"•••• 4242\"-style hint, and nothing more. Wildo never handles raw instrument data — that is the\n * whole point of routing users through the provider-hosted portal — so this carries no PAN, no\n * expiry, and no billing details.\n */\nexport interface StandardBilling_PaymentMethodSummary {\n  providerPaymentMethodId: string;\n  /**\n   * Instrument kind as the provider names it (`'card'`, `'sepa_debit'`, `'us_bank_account'`, …).\n   * Intentionally an OPEN provider identifier, not a closed Wildo vocabulary: the set differs per\n   * provider and grows without our involvement, and nothing in the framework branches on it — it\n   * is carried for display and diagnostics only.\n   */\n  type: string;\n  /** Last four digits, when the instrument exposes them. */\n  last4?: string;\n}\n\n// ── Product/Price Sync ──────────────────────────────────────────\n\nexport interface StandardBilling_SyncProductRequest {\n  /** Internal Wildo product key (stored in metadata for reverse lookup) */\n  productKey: string;\n  name: string;\n  description?: string;\n  /** If set, updates existing provider product instead of creating new */\n  providerProductId?: string;\n  metadata?: Record<string, string>;\n}\n\nexport interface StandardBilling_SyncProductResponse {\n  providerProductId: string;\n}\n\nexport interface StandardBilling_SyncPriceRequest {\n  providerProductId: string;\n  model: PricingModel;\n  /** Amount in smallest currency unit (cents) */\n  amount: number;\n  currency: string;\n  interval?: BillingInterval;\n  /** Multiplier of the recurring interval (3 months = quarterly). Omitted means 1; ignored for one-time prices. */\n  intervalCount?: number;\n  /** For TIERED/VOLUME pricing models */\n  tiers?: Array<{\n    upTo: number | null;\n    unitAmount: number;\n    flatAmount?: number;\n  }>;\n  /** For PACKAGE pricing */\n  packageSize?: number;\n  /** Tax behavior */\n  taxBehavior?: TaxDisplayMode;\n  /** If set, updates existing provider price instead of creating new */\n  providerPriceId?: string;\n  metadata?: Record<string, string>;\n}\n\nexport interface StandardBilling_SyncPriceResponse {\n  providerPriceId: string;\n}\n\n// ── Subscription Lifecycle ──────────────────────────────────────\n\nexport interface StandardBilling_CreateSubscriptionRequest {\n  providerCustomerId: string;\n  items: Array<{\n    providerPriceId: string;\n    quantity?: number;\n  }>;\n  trialPeriodDays?: number;\n  /** Provider promotion code to apply */\n  providerPromotionCodeId?: string;\n  /**\n   * Ask the provider to compute tax on this purchase (#408, 2026-09-08).\n   *\n   * Set from the application's `billing.tax.calculationMode`, which is PROVIDER_MANAGED or\n   * DISABLED — Wildo never calculates tax locally, so the only question a provider is asked is\n   * whether to calculate at all. A provider that cannot compute tax ignores this; one that can and\n   * is not configured for the customer's jurisdiction will say so at the call, which is the right\n   * place for that failure.\n   *\n   * Distinct from a price's `taxBehavior`, which says whether a displayed amount INCLUDES tax.\n   * That one has always reached the provider; this one decides whether tax is computed.\n   */\n  automaticTax?: boolean;\n  /**\n   * Require a payment method up front for a trial (#408, 2026-09-08).\n   *\n   * Set from the product's `behaviorPolicy.trial.requirePaymentMethod`, which was declared,\n   * labelled, rendered on billing screens and passed to no provider call — so a trial declared as\n   * requiring a card behaved identically to one that did not. Wonder Todos' enterprise plan\n   * (`true`) and professional plan (`false`) were indistinguishable at the provider.\n   *\n   * Two provider-side consequences follow and a connector should honour both: collect the payment\n   * method during checkout, and decide what happens if the trial ends without one.\n   */\n  requirePaymentMethodForTrial?: boolean;\n  metadata?: Record<string, string>;\n}\n\nexport interface StandardBilling_CreateSubscriptionResponse {\n  providerSubscriptionId: string;\n  status: string;\n}\n\n/** Provider-confirmed identities of correlated additions from the same update operation. */\nexport interface StandardBilling_UpdateSubscriptionResponse {\n  createdItems: Array<{ clientItemKey: string; providerSubscriptionItemId: string }>;\n}\n\nexport interface StandardBilling_UpdateSubscriptionRequest {\n  /**\n   * Server-owned identity of one attempted change, reused with the SAME subscription and payload\n   * when recovering a lost response. Never generate a new key for a retry. Provider retention is\n   * bounded: this does not replace confirmation consumption, freshness checks or reconciliation.\n   * This is request transport metadata, not subscription metadata or a browser authoring field.\n   */\n  idempotencyKey?: string;\n  /** Item patches: omitted existing items are retained; an item without an ID is added. */\n  items?: Array<{\n    /** Provider-side subscription item ID to update. Omit only when adding a new item. */\n    providerSubscriptionItemId?: string;\n    /** Backend-generated correlation key for an intentional new item; echoed with its created provider ID. */\n    clientItemKey?: string;\n    providerPriceId: string;\n    quantity?: number;\n  }>;\n  /** Explicit provider-side item IDs to remove. Omitting an item from `items` never removes it. */\n  removedProviderSubscriptionItemIds?: string[];\n  /** Provider promotion code to apply */\n  providerPromotionCodeId?: string;\n  /**\n   * How the provider settles this mid-cycle change (#516).\n   *\n   * The engine resolves it from the target product's `upgrade`/`downgrade` behaviour policy and it\n   * had nowhere to travel: it was put in `metadata`, a free-form bag the provider does not read, so a\n   * product declaring `NONE` for a downgrade was still prorated by the provider's own default. Absent\n   * means \"do not send one\" — the provider applies its account default, which is what every\n   * subscription update did before this field existed.\n   */\n  prorationBehavior?: ProrationBehavior;\n  /**\n   * How the provider treats an unpaid resulting invoice (#535, D6). Absent sends none, so the provider's default\n   * applies; the engine's own plan-change dispatch always declares it.\n   */\n  paymentBehavior?: StandardBilling_SubscriptionPaymentBehavior;\n  /** Unix seconds used for proration. Reuse the preview instant when confirming the same change. */\n  prorationDate?: number;\n  metadata?: Record<string, string>;\n}\n\n/**\n * Hypothetical item patch for an upcoming invoice. Item identity, quantity and proration must match\n * the eventual update; selecting the first provider item can accidentally preview an addon change.\n * Omitted items remain on the subscription. This request never changes the subscription itself.\n */\nexport type StandardBilling_SubscriptionPreviewRequest = Pick<StandardBilling_UpdateSubscriptionRequest,\n  'items' | 'removedProviderSubscriptionItemIds' | 'prorationBehavior' | 'prorationDate'>;\n\n/**\n * Request transport options shared by the subscription mutations that carry no payload of their own.\n *\n * `idempotencyKey` has the same contract as on {@link StandardBilling_UpdateSubscriptionRequest}: a server-owned\n * identity of ONE attempted change, reused with the same subscription and options only to recover a lost response.\n */\nexport interface StandardBilling_SubscriptionMutationOptions {\n  idempotencyKey?: string;\n}\n\nexport interface StandardBilling_CancelSubscriptionOptions extends StandardBilling_SubscriptionMutationOptions {\n  /** If true, subscription remains active until current period ends */\n  atPeriodEnd?: boolean;\n}\n\n// ── Read/Sync (Reconciliation) ──────────────────────────────────\n\n/**\n * StandardBilling_SubscriptionData: canonical subscription representation\n * returned by the provider adapter's retrieveSubscription().\n * Used for reconciliation when webhooks may have been missed.\n */\nexport interface StandardBilling_SubscriptionData {\n  providerSubscriptionId: string;\n  status: SubscriptionStatus;\n  currentPeriodStart: Date;\n  currentPeriodEnd: Date;\n  cancelAtPeriodEnd: boolean;\n  trialEnd?: Date;\n  items: Array<{\n    providerSubscriptionItemId: string;\n    providerProductId: string;\n    providerPriceId: string;\n    quantity: number;\n  }>;\n  /** Active discount on this subscription (from coupon/promotion code) */\n  discount?: {\n    providerCouponId: string;\n    percentOff?: number;\n    amountOff?: number;\n    currency?: string;\n    duration: string;\n    durationInMonths?: number;\n    end?: Date;\n  };\n}\n\n/**\n * StandardBilling_InvoicePreview: canonical upcoming invoice from provider.\n * Returned by retrieveUpcomingInvoice() for plan change previews.\n */\nexport interface StandardBilling_InvoicePreview {\n  /** Upcoming invoice amount due, in currency minor units; not a promise of an immediate charge. */\n  amount: number;\n  currency: string;\n  lineItems: Array<{\n    description: string;\n    amount: number;\n    quantity: number;\n    providerPriceId?: string;\n  }>;\n  periodStart: Date;\n  periodEnd: Date;\n}\n\n/**\n * StandardBilling_InvoiceData: an invoice the provider ALREADY holds.\n *\n * Distinct from {@link StandardBilling_InvoicePreview}, and the distinction is the point: a preview\n * is a hypothetical the provider computes on request and never stores, while this is a record that\n * exists at the provider whether or not Wildo ever heard about it. The second is what a\n * reconciliation sweep needs — a webhook that was never delivered leaves an invoice that exists\n * there and nowhere here, and no amount of previewing finds it.\n *\n * Deliberately thin. It carries what `invoiceRefs` stores and nothing else: line items, tax\n * breakdowns and payment attempts live at the provider, and the customer reaches them through the\n * provider-hosted portal.\n */\nexport interface StandardBilling_InvoiceData {\n  providerInvoiceId: string;\n  /** The customer the invoice was billed to — the key that maps it back to a local billing account. */\n  providerCustomerId: string;\n  status: InvoiceStatus;\n  /**\n   * The invoice TOTAL, in the CURRENCY's smallest unit.\n   *\n   * The total, not the amount PAID: an invoice's value does not depend on whether it has been\n   * settled, and an unpaid invoice recorded at zero is indistinguishable from a zero invoice.\n   */\n  total: number;\n  currency: string;\n  hostedInvoiceUrl?: string;\n  invoicePdfUrl?: string;\n  /** When the provider created the invoice — used to bound how far back a sweep looks. */\n  createdAt: Date;\n}\n\n// ── Checkout / Portal (Provider-Hosted UI) ──────────────────────\n\nexport interface StandardBilling_CreateCheckoutSessionRequest {\n  providerCustomerId: string;\n  lineItems: Array<{\n    providerPriceId: string;\n    quantity?: number;\n  }>;\n  /** Checkout mode: 'subscription' for recurring, 'payment' for one-time */\n  mode: 'subscription' | 'payment';\n  successUrl: string;\n  cancelUrl: string;\n  /** Allow promotion codes in checkout */\n  allowPromotionCodes?: boolean;\n  /** Pre-fill promotion code */\n  providerPromotionCodeId?: string;\n  /** Trial period for subscriptions */\n  trialPeriodDays?: number;\n  /**\n   * Ask the provider to compute tax on this purchase (#408, 2026-09-08).\n   *\n   * Set from the application's `billing.tax.calculationMode`, which is PROVIDER_MANAGED or\n   * DISABLED — Wildo never calculates tax locally, so the only question a provider is asked is\n   * whether to calculate at all. A provider that cannot compute tax ignores this; one that can and\n   * is not configured for the customer's jurisdiction will say so at the call, which is the right\n   * place for that failure.\n   *\n   * Distinct from a price's `taxBehavior`, which says whether a displayed amount INCLUDES tax.\n   * That one has always reached the provider; this one decides whether tax is computed.\n   */\n  automaticTax?: boolean;\n  /**\n   * Require a payment method up front for a trial (#408, 2026-09-08).\n   *\n   * Set from the product's `behaviorPolicy.trial.requirePaymentMethod`, which was declared,\n   * labelled, rendered on billing screens and passed to no provider call — so a trial declared as\n   * requiring a card behaved identically to one that did not. Wonder Todos' enterprise plan\n   * (`true`) and professional plan (`false`) were indistinguishable at the provider.\n   *\n   * Two provider-side consequences follow and a connector should honour both: collect the payment\n   * method during checkout, and decide what happens if the trial ends without one.\n   */\n  requirePaymentMethodForTrial?: boolean;\n  metadata?: Record<string, string>;\n}\n\nexport interface StandardBilling_CreateCheckoutSessionResponse {\n  /** Redirect URL for the hosted checkout page */\n  url: string;\n  sessionId: string;\n}\n\nexport interface StandardBilling_CreateCustomerPortalSessionResponse {\n  /** Redirect URL for the customer portal */\n  url: string;\n}\n\n// ── Usage Reporting (METERED products via Billing Meter Events) ─\n\nexport interface StandardBilling_ReportUsageRequest {\n  /** Meter event name (corresponds to the meter's event_name) */\n  meterEventName: string;\n  /** Provider customer ID (maps to payload.stripe_customer_id in Stripe) */\n  providerCustomerId: string;\n  /** Usage value to report */\n  value: number;\n  /** Optional event timestamp */\n  timestamp?: Date;\n  /** Optional unique event identifier (for idempotency) */\n  identifier?: string;\n}\n\n// ── Promotions ──────────────────────────────────────────────────\n\nexport interface StandardBilling_CreateCouponRequest {\n  /** Discount amount in smallest currency unit (for fixed discounts) */\n  amountOff?: number;\n  /** Discount percentage (for percentage discounts) */\n  percentOff?: number;\n  currency?: string;\n  duration: 'once' | 'repeating' | 'forever';\n  durationInMonths?: number;\n  maxRedemptions?: number;\n  metadata?: Record<string, string>;\n}\n\nexport interface StandardBilling_CreateCouponResponse {\n  providerCouponId: string;\n}\n\nexport interface StandardBilling_CreatePromotionCodeResponse {\n  providerPromotionId: string;\n}\n\n// ===============================================================\n// Standard Billing Interface\n// ===============================================================\n\n/**\n * Provider-agnostic billing interface.\n * Each billing provider (Stripe, Paddle, etc.) implements this interface\n * through a transformer that maps canonical operations to provider SDK calls.\n */\nexport interface StandardBilling_Interface {\n  // ── Customer (maps to BillingAccount) ──\n  createCustomer(request: StandardBilling_CreateCustomerRequest): Promise<StandardBilling_CreateCustomerResponse>;\n  updateCustomer(providerCustomerId: string, request: StandardBilling_UpdateCustomerRequest): Promise<void>;\n  /**\n   * Hard-delete the provider customer.\n   *\n   * ⚠️ NOT the subject-erasure path. Erasing a subject ANONYMIZES this customer (blank the personal\n   * fields, keep the record) because the financial history hanging off it — invoices, subscriptions,\n   * usage — is retained under a legal obligation and must stay attributable to its provider record.\n   * Deleting the customer would strand exactly the audit trail retention exists to preserve.\n   * Reserve this for a genuine account teardown with no retained history.\n   */\n  deleteCustomer(providerCustomerId: string): Promise<void>;\n\n  // ── Payment instruments ──\n  /**\n   * Stored payment instruments for a customer. Used by subject erasure to enumerate what must be\n   * detached; day-to-day management belongs in the provider-hosted portal.\n   */\n  listPaymentMethods(providerCustomerId: string): Promise<StandardBilling_PaymentMethodSummary[]>;\n  /**\n   * Detach an instrument from its customer. Detaching does NOT delete the instrument's transaction\n   * history at the provider — it stops future charges and unlinks it from the customer, which is\n   * what erasure needs and what the retained invoice record requires.\n   */\n  detachPaymentMethod(providerPaymentMethodId: string): Promise<void>;\n\n  // ── Product/Price sync (Wildo → Provider) ──\n  syncProduct(request: StandardBilling_SyncProductRequest): Promise<StandardBilling_SyncProductResponse>;\n  syncPrice(request: StandardBilling_SyncPriceRequest): Promise<StandardBilling_SyncPriceResponse>;\n\n  // ── Subscription lifecycle ──\n  // NOTE: User-initiated plan changes, cancellation, and payment method management\n  // should use createCustomerPortalSession() instead of calling these directly.\n  // These methods are for: initial checkout completion, backend-driven upgrades,\n  // admin-triggered changes, and webhook-driven updates.\n  createSubscription(request: StandardBilling_CreateSubscriptionRequest): Promise<StandardBilling_CreateSubscriptionResponse>;\n  updateSubscription(providerSubscriptionId: string, request: StandardBilling_UpdateSubscriptionRequest): Promise<StandardBilling_UpdateSubscriptionResponse>;\n  cancelSubscription(providerSubscriptionId: string, options?: StandardBilling_CancelSubscriptionOptions): Promise<void>;\n  pauseSubscription(providerSubscriptionId: string): Promise<void>;\n  /** Resume paused payment collection; does not undo a scheduled cancellation. */\n  resumeSubscription(providerSubscriptionId: string): Promise<void>;\n  /** Remove a pending period-end cancellation without changing collection or lifecycle status. */\n  removeScheduledCancellation(providerSubscriptionId: string, options?: StandardBilling_SubscriptionMutationOptions): Promise<void>;\n  /**\n   * Classify an error thrown by `updateSubscription`, `cancelSubscription` or `removeScheduledCancellation` (#535, D3).\n   *\n   * Must answer {@link StandardBilling_MutationErrorClass.INDETERMINATE} for anything the adapter cannot positively place\n   * — including an error the adapter itself threw AFTER the provider answered — because every other class licenses the\n   * caller to record that the change did not happen.\n   */\n  classifyMutationError(error: unknown): StandardBilling_MutationErrorClass;\n\n  // ── Read/sync (for reconciliation and upcoming cost preview) ──\n  /** On-demand retrieval for reconciliation (if webhook missed) */\n  retrieveSubscription(providerSubscriptionId: string): Promise<StandardBilling_SubscriptionData>;\n  /** Preview the upcoming invoice for an optional item change; the amount is not necessarily charged immediately. */\n  retrieveUpcomingInvoice(providerSubscriptionId: string, request?: StandardBilling_SubscriptionPreviewRequest): Promise<StandardBilling_InvoicePreview>;\n  /**\n   * Invoices the provider holds for one customer, newest first.\n   *\n   * The RECOVERY read for {@link StandardBilling_EventType.INVOICE_PAID} and its siblings. Wildo\n   * never creates an invoice — every local `invoiceRefs` row exists because a webhook arrived — so a\n   * delivery that is lost, or that arrives while the application is down and exhausts the provider's\n   * retries, leaves an invoice with no local trace and nothing that could notice. This is the only\n   * call that can find one.\n   *\n   * `limit` bounds one page and an adapter may cap it lower; the sweep asks for a recent window\n   * rather than the whole history, because an invoice older than the window has either been\n   * reconciled already or is a backlog no single tick should try to drain.\n   */\n  listInvoices(providerCustomerId: string, options?: { limit?: number }): Promise<StandardBilling_InvoiceData[]>;\n\n  // ── Provider-hosted UI (primary user-facing interactions) ──\n  /** Hosted checkout page — NO Stripe Elements needed, no PCI scope */\n  createCheckoutSession(request: StandardBilling_CreateCheckoutSessionRequest): Promise<StandardBilling_CreateCheckoutSessionResponse>;\n  /** Customer portal for: invoices, payment methods, billing address, cancel */\n  createCustomerPortalSession(providerCustomerId: string, returnUrl: string): Promise<StandardBilling_CreateCustomerPortalSessionResponse>;\n\n  // ── Usage reporting (for METERED products) ──\n  reportUsage(request: StandardBilling_ReportUsageRequest): Promise<void>;\n\n  // ── Webhooks ──\n  /** HTTP header name that carries the webhook signature (e.g., 'stripe-signature') */\n  readonly webhookSignatureHeaderName: string;\n  verifyWebhookSignature(payload: string | Uint8Array, signature: string, secret: string): boolean;\n  /** Parse a raw webhook payload into a canonical event. Returns null for unknown/unhandled event types. */\n  parseWebhookEvent(payload: string | Uint8Array): StandardBilling_WebhookEvent | null;\n\n  // ── Promotions (synced to provider) ──\n  createCoupon(request: StandardBilling_CreateCouponRequest): Promise<StandardBilling_CreateCouponResponse>;\n  createPromotionCode(providerCouponId: string, code: string): Promise<StandardBilling_CreatePromotionCodeResponse>;\n}\n"]}

package/dist/esm/protocols/document-extraction.external-connectors-models.schemas.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { ExternalProvider_ExchangeProtocol_Configuration_Base, ExternalProvider_ExchangeProtocol_Kind, ExternalProvider_ExchangeProtocol_Profile_Base } from "../core/commons.external-connectors-models.schemas";
+import { ExternalProvider_ExchangeProtocol_Kind } from "../core/commons.external-connectors-models.schemas";
 /**
  * Concrete document-extraction model ids the framework knows.
  *
@@ -103,14 +103,6 @@ export declare const resolveDocumentExtractionModelForApplicability: (input: {
     applicability: DocumentExtraction_Applicability;
     providerRef: string;
 }, catalog?: Record<DocumentExtractionProvider_Model, DocumentExtraction_ModelCatalogEntry>) => DocumentExtraction_ModelResolution;
-export type DocumentExtractionProvider_Profile = ExternalProvider_ExchangeProtocol_Profile_Base & {
-    baseURL?: string;
-    /** Model ids this provider serves (advertised for validation/UX). */
-    supportedModels?: string[];
-};
-export type DocumentExtractionProvider_Configuration = ExternalProvider_ExchangeProtocol_Configuration_Base & {
-    customLocation?: string;
-};
 /**
  * Usage of one extraction call.
  *
@@ -241,11 +233,4 @@ export type DocumentExtraction_ProviderExtraction = {
  *   - 5xx is the provider's fault, never the document's.
  */
 export declare const classifyDocumentExtractionHttpStatus: (status: number) => DocumentExtraction_FailureClass;
-export declare const DocumentExtractionProvider_StatusSchema: z.ZodObject<{
-    status: z.ZodEnum<typeof import("..").ExternalProvider_Status>;
-    lastCheckedAt: z.ZodString;
-    errorReason: z.ZodOptional<z.ZodString>;
-    protocolKind: z.ZodLiteral<ExternalProvider_ExchangeProtocol_Kind.DOCUMENT_EXTRACTION_PROVIDER>;
-}, z.core.$strip>;
-export type DocumentExtractionProvider_Status = z.infer<typeof DocumentExtractionProvider_StatusSchema>;
 //# sourceMappingURL=document-extraction.external-connectors-models.schemas.d.ts.map

package/dist/esm/protocols/document-extraction.external-connectors-models.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document-extraction.external-connectors-models.schemas.d.ts","sourceRoot":"","sources":["../../../src/protocols/document-extraction.external-connectors-models.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EACL,oDAAoD,EACpD,sCAAsC,EACtC,8CAA8C,EAE/C,MAAM,oDAAoD,CAAA;AAmC3D;;;;GAIG;AACH,oBAAY,gCAAgC;IAC1C;;;;;;OAMG;IACH,kBAAkB,uBAAuB;CAC1C;AAED;;;;;;;GAOG;AACH,oBAAY,uCAAuC;IACjD,qDAAqD;IACrD,qBAAqB,2CAA2C;CACjE;AAED;;;;;;;;;;;GAWG;AACH,oBAAY,gCAAgC;IAC1C,+FAA+F;IAC/F,qBAAqB,0BAA0B;CAChD;AACD,uFAAuF;AAEvF;;;GAGG;AACH,MAAM,MAAM,oCAAoC,GAAG;IACjD,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,sFAAsF;IACtF,eAAe,EAAE,SAAS,gCAAgC,EAAE,CAAC;CAC9D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,EAAE,MAAM,CACpD,gCAAgC,EAChC,oCAAoC,CAmBrC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,kDAAkD,EAAE,MAAM,CACrE,gCAAgC,EAChC,SAAS,gCAAgC,EAAE,CAK5C,CAAC;AAEF,8HAA8H;AAC9H,oBAAY,yCAAyC;IACnD,mEAAmE;IACnE,yBAAyB,8BAA8B;CACxD;AAED,MAAM,MAAM,kCAAkC,GAC1C;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,gCAAgC,CAAC;IAAC,KAAK,EAAE,oCAAoC,CAAA;CAAE,GACxG;IACE,QAAQ,EAAE,KAAK,CAAC;IAChB,OAAO,EAAE,yCAAyC,CAAC;IACnD,gBAAgB,EAAE,SAAS,gCAAgC,EAAE,CAAC;CAC/D,CAAC;AAEN;;;;;GAKG;AACH,eAAO,MAAM,8CAA8C,GACzD,OAAO;IAAE,aAAa,EAAE,gCAAgC,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAC/E,UAAS,MAAM,CAAC,gCAAgC,EAAE,oCAAoC,CAAqC,KAC1H,kCAeF,CAAC;AAOF,MAAM,MAAM,kCAAkC,GAAG,8CAA8C,GAAG;IAChG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B,CAAA;AAED,MAAM,MAAM,wCAAwC,GAAG,oDAAoD,GAAG;IAC5G,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAA;AAMD;;;;;;;GAOG;AACH,eAAO,MAAM,sCAAsC;;;iBAWjD,CAAC;AACH,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC;AAEtG,eAAO,MAAM,2DAA2D;;;;iBAItE,CAAC;AACH,MAAM,MAAM,qDAAqD,GAAG,CAAC,CAAC,KAAK,CACzE,OAAO,2DAA2D,CACnE,CAAC;AAMF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,yDAAyD;;;iBAKpE,CAAC;AACH,MAAM,MAAM,mDAAmD,GAAG,CAAC,CAAC,KAAK,CACvE,OAAO,yDAAyD,CACjE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,0DAA0D;;;;;;;;iBAOrE,CAAC;AACH,MAAM,MAAM,oDAAoD,GAAG,CAAC,CAAC,KAAK,CACxE,OAAO,0DAA0D,CAClE,CAAC;AAmBF;;;;;;;;;;;;;GAaG;AACH,oBAAY,+BAA+B;IACzC;;;;OAIG;IACH,mBAAmB,wBAAwB;IAC3C;;;;OAIG;IACH,oBAAoB,yBAAyB;CAC9C;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,qCAAqC,GAC7C;IACE,SAAS,EAAE,IAAI,CAAC;IAChB,6FAA6F;IAC7F,IAAI,EAAE,MAAM,CAAC;IACb,gGAAgG;IAChG,SAAS,EAAE,MAAM,CAAC;IAClB,wFAAwF;IACxF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,gCAAgC,CAAC;CAC1C,GACD;IACE,SAAS,EAAE,KAAK,CAAC;IACjB,YAAY,EAAE,+BAA+B,CAAC;IAC9C;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,oCAAoC,GAAI,QAAQ,MAAM,KAAG,+BAOrE,CAAC;AAMF,eAAO,MAAM,uCAAuC;;;;;iBAElD,CAAC;AACH,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uCAAuC,CAAC,CAAC"}
+{"version":3,"file":"document-extraction.external-connectors-models.schemas.d.ts","sourceRoot":"","sources":["../../../../src/protocols/document-extraction.external-connectors-models.schemas.ts"],"names":[],"mappings":"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"}

package/dist/esm/protocols/document-extraction.external-connectors-models.schemas.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { ExternalProvider_ExchangeProtocol_Kind, ExternalProvider_ExchangeProtocol_Status_BaseSchema, } from "../core/commons.external-connectors-models.schemas.js";
+import { ExternalProvider_ExchangeProtocol_Kind, } from "../core/commons.external-connectors-models.schemas.js";
 //===============================================================
 // Document Extraction Provider
 // --------
@@ -283,10 +283,4 @@ export const classifyDocumentExtractionHttpStatus = (status) => {
         ? DocumentExtraction_FailureClass.PROVIDER_UNAVAILABLE
         : DocumentExtraction_FailureClass.UNREADABLE_DOCUMENT;
 };
-// ===============================================================
-// STATUS
-// ===============================================================
-export const DocumentExtractionProvider_StatusSchema = ExternalProvider_ExchangeProtocol_Status_BaseSchema.extend({
-    protocolKind: z.literal(ExternalProvider_ExchangeProtocol_Kind.DOCUMENT_EXTRACTION_PROVIDER),
-});
 //# sourceMappingURL=document-extraction.external-connectors-models.schemas.js.map