@lunora/payment 1.0.0-alpha.26 → 1.0.0-alpha.28

package/dist/packem_shared/{adapter.d-BOheUepr.d.ts → adapter.d-CMjjkTGB.d.ts}

@@ -1,34 +1,34 @@
 /**
-* Core domain types for `@lunora/payment`.
-*
-* The provider is a stateless translator; the store owns all state. These types are the
-* provider-agnostic vocabulary every adapter normalizes onto.
-*/
-/**
-* ISO-4217 currency code (uppercase, 3 letters). Not enumerated — provider coverage varies.
-* @experimental
-*/
+ * Core domain types for `@lunora/payment`.
+ *
+ * The provider is a stateless translator; the store owns all state. These types are the
+ * provider-agnostic vocabulary every adapter normalizes onto.
+ */
+/**
+ * ISO-4217 currency code (uppercase, 3 letters). Not enumerated — provider coverage varies.
+ * @experimental
+ */
 type CurrencyCode = string;
 /**
-* Money as integer minor units + currency. Always carry the two together.
-*
-* `minorUnits` is a `bigint`, which is **not** JSON-serializable — cross the RPC/wire boundary
-* with the `toMoneyJSON` / `fromMoneyJSON` helpers (see `./money`).
-* @experimental
-*/
+ * Money as integer minor units + currency. Always carry the two together.
+ *
+ * `minorUnits` is a `bigint`, which is **not** JSON-serializable — cross the RPC/wire boundary
+ * with the `toMoneyJSON` / `fromMoneyJSON` helpers (see `./money`).
+ * @experimental
+ */
 interface Money {
   readonly currency: CurrencyCode;
   readonly minorUnits: bigint;
 }
 /**
-* Stable provider identifier (Medusa-style). Ships Stripe/Polar/Autumn/Dodo plus Creem, an EU-friendly MoR.
-* @experimental
-*/
+ * Stable provider identifier (Medusa-style). Ships Stripe/Polar/Autumn/Dodo plus Creem, an EU-friendly MoR.
+ * @experimental
+ */
 type ProviderId = "autumn" | "creem" | "dodopayments" | "polar" | "stripe";
 /**
-* What a provider can do — encoded in types so tax/UX assumptions aren't tribal knowledge.
-* @experimental
-*/
+ * What a provider can do — encoded in types so tax/UX assumptions aren't tribal knowledge.
+ * @experimental
+ */
 interface ProviderCapabilities {
   /** True for Polar / Lemon Squeezy / Paddle; false for Stripe (PSP) and Autumn (runs on your own Stripe). Drives tax/invoice ownership. */
   readonly merchantOfRecord: boolean;
@@ -38,19 +38,19 @@ interface ProviderCapabilities {
   readonly usageMetering: boolean;
 }
 /**
-* Lifecycle state of a one-time payment session.
-* @experimental
-*/
+ * Lifecycle state of a one-time payment session.
+ * @experimental
+ */
 type PaymentState = "authorized" | "canceled" | "captured" | "failed" | "initiated" | "partially_refunded" | "refunded";
 /**
-* Lifecycle state of a subscription.
-* @experimental
-*/
+ * Lifecycle state of a subscription.
+ * @experimental
+ */
 type SubscriptionState = "active" | "canceled" | "past_due" | "paused" | "trialing";
 /**
-* `Customer` is part of the experimental `@lunora/payment` API and may change without a major version bump.
-* @experimental
-*/
+ * `Customer` is part of the experimental `@lunora/payment` API and may change without a major version bump.
+ * @experimental
+ */
 interface Customer {
   readonly createdAt: number;
   readonly email?: string;
@@ -61,9 +61,9 @@ interface Customer {
   readonly referenceId: string;
 }
 /**
-* `PaymentSession` is part of the experimental `@lunora/payment` API and may change without a major version bump.
-* @experimental
-*/
+ * `PaymentSession` is part of the experimental `@lunora/payment` API and may change without a major version bump.
+ * @experimental
+ */
 interface PaymentSession {
   readonly amount: Money;
   readonly capturedAmount: Money;
@@ -77,9 +77,9 @@ interface PaymentSession {
   readonly updatedAt: number;
 }
 /**
-* `Subscription` is part of the experimental `@lunora/payment` API and may change without a major version bump.
-* @experimental
-*/
+ * `Subscription` is part of the experimental `@lunora/payment` API and may change without a major version bump.
+ * @experimental
+ */
 interface Subscription {
   readonly cancelAtPeriodEnd: boolean;
   readonly createdAt: number;
@@ -95,30 +95,30 @@ interface Subscription {
   readonly updatedAt: number;
 }
 /**
-* `CustomerRef` is part of the experimental `@lunora/payment` API and may change without a major version bump.
-* @experimental
-*/
+ * `CustomerRef` is part of the experimental `@lunora/payment` API and may change without a major version bump.
+ * @experimental
+ */
 interface CustomerRef {
   readonly email?: string;
   readonly metadata?: Record<string, string>;
   readonly referenceId: string;
 }
 /**
-* `CheckoutInput` is part of the experimental `@lunora/payment` API and may change without a major version bump.
-* @experimental
-*/
+ * `CheckoutInput` is part of the experimental `@lunora/payment` API and may change without a major version bump.
+ * @experimental
+ */
 interface CheckoutInput {
   readonly cancelUrl: string;
   /**
-  * Ignored at runtime (kept for backward-compat). The provider customer is always derived from the store for the
-  * authorized `referenceId` (never caller-supplied) to prevent cross-tenant checkout attachment (IDOR).
-  * Retained on the type only for backward compatibility; setting it has no effect.
-  */
+   * Ignored at runtime (kept for backward-compat). The provider customer is always derived from the store for the
+   * authorized `referenceId` (never caller-supplied) to prevent cross-tenant checkout attachment (IDOR).
+   * Retained on the type only for backward compatibility; setting it has no effect.
+   */
   readonly customerId?: string;
   /**
-  * Customer email, used when the reference has no provider customer yet. Some Merchant-of-Record
-  * providers (e.g. Dodo Payments) require an email to mint a customer, so pass it on first checkout.
-  */
+   * Customer email, used when the reference has no provider customer yet. Some Merchant-of-Record
+   * providers (e.g. Dodo Payments) require an email to mint a customer, so pass it on first checkout.
+   */
   readonly email?: string;
   /** Outbound idempotency key for the provider call; auto-derived when omitted. */
   readonly idempotencyKey?: string;
@@ -130,35 +130,35 @@ interface CheckoutInput {
   readonly successUrl: string;
 }
 /**
-* `CheckoutResult` is part of the experimental `@lunora/payment` API and may change without a major version bump.
-* @experimental
-*/
+ * `CheckoutResult` is part of the experimental `@lunora/payment` API and may change without a major version bump.
+ * @experimental
+ */
 interface CheckoutResult {
   readonly id: string;
   readonly provider: ProviderId;
   readonly url: string;
 }
 /**
-* `attach` input — subscribe a reference to a plan. A thin, plan-oriented skin over
-* {@link CheckoutInput}: `mode` defaults to `"subscription"` (the common case), so callers pass
-* just `{ referenceId, priceId, successUrl, cancelUrl }`.
-* @experimental
-*/
+ * `attach` input — subscribe a reference to a plan. A thin, plan-oriented skin over
+ * {@link CheckoutInput}: `mode` defaults to `"subscription"` (the common case), so callers pass
+ * just `{ referenceId, priceId, successUrl, cancelUrl }`.
+ * @experimental
+ */
 interface AttachInput extends Omit<CheckoutInput, "mode"> {
   readonly mode?: CheckoutInput["mode"];
 }
 /**
-* `PortalInput` is part of the experimental `@lunora/payment` API and may change without a major version bump.
-* @experimental
-*/
+ * `PortalInput` is part of the experimental `@lunora/payment` API and may change without a major version bump.
+ * @experimental
+ */
 interface PortalInput {
   readonly customerId: string;
   readonly returnUrl: string;
 }
 /**
-* A single durable usage record — one metered event for a `(referenceId, featureId)` pair.
-* @experimental
-*/
+ * A single durable usage record — one metered event for a `(referenceId, featureId)` pair.
+ * @experimental
+ */
 interface UsageEvent {
   readonly createdAt: number;
   readonly featureId: string;
@@ -171,28 +171,28 @@ interface UsageEvent {
   readonly reportedToProvider: boolean;
 }
 /**
-* `track` input — record metered usage for a reference's feature.
-* @experimental
-*/
+ * `track` input — record metered usage for a reference's feature.
+ * @experimental
+ */
 interface TrackInput {
   readonly featureId: string;
   /** Caller-supplied dedupe key; a fresh one is generated when omitted (so each call records). */
   readonly idempotencyKey?: string;
   /**
-  * `"add"` (default) increments usage by `quantity`; `"set"` reconciles the period total to `quantity`.
-  * `"set"` is a non-atomic read-modify-write (it reads the current total, then appends the delta), so
-  * concurrent `"set"` calls for the same reference can over- or under-count — call it only from a
-  * serialized context (a single Durable Object or per-reference lock). `"add"` is always safe.
-  */
+   * `"add"` (default) increments usage by `quantity`; `"set"` reconciles the period total to `quantity`.
+   * `"set"` is a non-atomic read-modify-write (it reads the current total, then appends the delta), so
+   * concurrent `"set"` calls for the same reference can over- or under-count — call it only from a
+   * serialized context (a single Durable Object or per-reference lock). `"add"` is always safe.
+   */
   readonly mode?: "add" | "set";
   /** Usage amount to add, or the absolute period total when `mode` is `"set"` (defaults to `1`). */
   readonly quantity?: number;
   readonly referenceId: string;
 }
 /**
-* Result of a `track` call.
-* @experimental
-*/
+ * Result of a `track` call.
+ * @experimental
+ */
 interface TrackResult {
   /** True when this call inserted a new usage event; false when deduplicated by idempotency key. */
   readonly recorded: boolean;
@@ -200,10 +200,10 @@ interface TrackResult {
   readonly reportedToProvider: boolean;
 }
 /**
-* `check` input — is a reference allowed something right now? Pass `featureId` to check a feature
-* grant/allowance, or `priceId` to check active access to a product (one of the two is required).
-* @experimental
-*/
+ * `check` input — is a reference allowed something right now? Pass `featureId` to check a feature
+ * grant/allowance, or `priceId` to check active access to a product (one of the two is required).
+ * @experimental
+ */
 interface CheckInput {
   /** Feature to check a grant/allowance for. Provide this **or** `priceId`. */
   readonly featureId?: string;
@@ -214,9 +214,9 @@ interface CheckInput {
   readonly referenceId: string;
 }
 /**
-* Result of a `check` call.
-* @experimental
-*/
+ * Result of a `check` call.
+ * @experimental
+ */
 interface CheckResult {
   /** Whether the reference may consume `quantity` units of the feature right now. */
   readonly allowed: boolean;
@@ -230,16 +230,16 @@ interface CheckResult {
   readonly used?: number;
 }
 /**
-* One feature's resolved allowance for a reference — a {@link CheckResult} tagged with its feature.
-* @experimental
-*/
+ * One feature's resolved allowance for a reference — a {@link CheckResult} tagged with its feature.
+ * @experimental
+ */
 interface FeatureBalance extends CheckResult {
   readonly featureId: string;
 }
 /**
-* Input the adapter forwards to the provider's metering API (Stripe Meter Events / Polar ingestion).
-* @experimental
-*/
+ * Input the adapter forwards to the provider's metering API (Stripe Meter Events / Polar ingestion).
+ * @experimental
+ */
 interface ReportUsageInput {
   /** Provider customer id, when known (Stripe meter events key on it). */
   readonly customerId?: string;
@@ -251,9 +251,9 @@ interface ReportUsageInput {
   readonly timestamp?: number;
 }
 /**
-* `CaptureInput` is part of the experimental `@lunora/payment` API and may change without a major version bump.
-* @experimental
-*/
+ * `CaptureInput` is part of the experimental `@lunora/payment` API and may change without a major version bump.
+ * @experimental
+ */
 interface CaptureInput {
   /** Partial capture amount; full capture when omitted. */
   readonly amount?: Money;
@@ -261,9 +261,9 @@ interface CaptureInput {
   readonly sessionId: string;
 }
 /**
-* `RefundInput` is part of the experimental `@lunora/payment` API and may change without a major version bump.
-* @experimental
-*/
+ * `RefundInput` is part of the experimental `@lunora/payment` API and may change without a major version bump.
+ * @experimental
+ */
 interface RefundInput {
   /** Partial refund amount; full refund when omitted. */
   readonly amount?: Money;
@@ -272,50 +272,50 @@ interface RefundInput {
   readonly sessionId: string;
 }
 /**
-* `CancelSubscriptionOptions` is part of the experimental `@lunora/payment` API and may change without a major version bump.
-* @experimental
-*/
+ * `CancelSubscriptionOptions` is part of the experimental `@lunora/payment` API and may change without a major version bump.
+ * @experimental
+ */
 interface CancelSubscriptionOptions {
   /** Cancel at period end instead of immediately. */
   readonly atPeriodEnd?: boolean;
   readonly idempotencyKey?: string;
 }
 /**
-* `SubscriptionPatch` is part of the experimental `@lunora/payment` API and may change without a major version bump.
-* @experimental
-*/
+ * `SubscriptionPatch` is part of the experimental `@lunora/payment` API and may change without a major version bump.
+ * @experimental
+ */
 interface SubscriptionPatch {
   readonly priceId?: string;
   readonly quantity?: number;
 }
 /**
-* Normalized webhook outcome — the *core state transition* a provider event implies.
-* @experimental
-*/
+ * Normalized webhook outcome — the *core state transition* a provider event implies.
+ * @experimental
+ */
 type WebhookActionType = "payment.authorized" | "payment.captured" | "payment.failed" | "payment.refunded" | "subscription.active" | "subscription.canceled" | "subscription.past_due" | "subscription.paused" | "subscription.updated" | "unhandled";
 /**
-* How a refund action's {@link WebhookAction.amount} should be interpreted by the sync layer.
-*
-* `"delta"` is an incremental amount added to the running refunded total (Polar `refund.created`,
-* and the historical default), so multiple events accumulate. `"absolute"` is the provider's
-* cumulative refunded-to-date total (Stripe `charge.refunded` carries `amount_refunded`, which
-* already sums all prior partial refunds); the sync layer sets the refunded total to this value
-* rather than adding, so repeated partial-refund events do not over-count.
-*
-* Omitted means `"delta"`, preserving the original behavior for callers that predate this field.
-* @experimental
-*/
+ * How a refund action's {@link WebhookAction.amount} should be interpreted by the sync layer.
+ *
+ * `"delta"` is an incremental amount added to the running refunded total (Polar `refund.created`,
+ * and the historical default), so multiple events accumulate. `"absolute"` is the provider's
+ * cumulative refunded-to-date total (Stripe `charge.refunded` carries `amount_refunded`, which
+ * already sums all prior partial refunds); the sync layer sets the refunded total to this value
+ * rather than adding, so repeated partial-refund events do not over-count.
+ *
+ * Omitted means `"delta"`, preserving the original behavior for callers that predate this field.
+ * @experimental
+ */
 type RefundAmountKind = "absolute" | "delta";
 /**
-* `WebhookAction` is part of the experimental `@lunora/payment` API and may change without a major version bump.
-* @experimental
-*/
+ * `WebhookAction` is part of the experimental `@lunora/payment` API and may change without a major version bump.
+ * @experimental
+ */
 interface WebhookAction {
   readonly amount?: Money;
   /**
-  * Interpretation of {@link WebhookAction.amount} for refund actions (`payment.refunded`).
-  * Defaults to `"delta"` when omitted. Ignored for non-refund actions.
-  */
+   * Interpretation of {@link WebhookAction.amount} for refund actions (`payment.refunded`).
+   * Defaults to `"delta"` when omitted. Ignored for non-refund actions.
+   */
   readonly amountKind?: RefundAmountKind;
   readonly cancelAtPeriodEnd?: boolean;
   readonly currentPeriodEnd?: number;
@@ -334,24 +334,24 @@ interface WebhookAction {
   readonly type: WebhookActionType;
 }
 /**
-* Result of applying a webhook action to the store.
-* @experimental
-*/
+ * Result of applying a webhook action to the store.
+ * @experimental
+ */
 interface ApplyResult {
   readonly applied: boolean;
   readonly reason?: "duplicate" | "illegal_transition" | "invalid_refund_amount" | "ok" | "unhandled";
 }
 /**
-* A read-only header bag; the platform `Headers` object satisfies it.
-* @experimental
-*/
+ * A read-only header bag; the platform `Headers` object satisfies it.
+ * @experimental
+ */
 interface WebhookHeaders {
   get: (name: string) => null | string;
 }
 /**
-* `WebhookInput` is part of the experimental `@lunora/payment` API and may change without a major version bump.
-* @experimental
-*/
+ * `WebhookInput` is part of the experimental `@lunora/payment` API and may change without a major version bump.
+ * @experimental
+ */
 interface WebhookInput {
   /** Request headers (signature schemes read provider-specific headers from here). */
   readonly headers: WebhookHeaders;
@@ -359,12 +359,12 @@ interface WebhookInput {
   readonly payload: string;
 }
 /**
-* A stateless translator between the provider API and Lunora's normalized vocabulary.
-*
-* Adapters never own state — they make provider calls and normalize provider events into a
-* `WebhookAction`. All durable state lives in the payment store.
-* @experimental
-*/
+ * A stateless translator between the provider API and Lunora's normalized vocabulary.
+ *
+ * Adapters never own state — they make provider calls and normalize provider events into a
+ * `WebhookAction`. All durable state lives in the payment store.
+ * @experimental
+ */
 interface PaymentAdapter {
   cancelPayment: (sessionId: string, options?: {
     idempotencyKey?: string;
@@ -373,23 +373,23 @@ interface PaymentAdapter {
   readonly capabilities: ProviderCapabilities;
   capturePayment: (input: CaptureInput) => Promise<PaymentSession>;
   /**
-  * Ask the provider whether a reference may consume `quantity` units of a feature (or holds active
-  * access to a product) right now — for providers that own entitlement truth themselves (e.g.
-  * Autumn computes balances, credits, and limits from its plan config). Optional: when absent, the
-  * facade's `check` evaluates locally from the synced store + the app's `entitlements` config. When
-  * present, the facade delegates `check` to it, so `entitlements` need not be configured.
-  */
+   * Ask the provider whether a reference may consume `quantity` units of a feature (or holds active
+   * access to a product) right now — for providers that own entitlement truth themselves (e.g.
+   * Autumn computes balances, credits, and limits from its plan config). Optional: when absent, the
+   * facade's `check` evaluates locally from the synced store + the app's `entitlements` config. When
+   * present, the facade delegates `check` to it, so `entitlements` need not be configured.
+   */
   checkEntitlement?: (input: CheckInput) => Promise<CheckResult>;
   createCheckout: (input: CheckoutInput) => Promise<CheckoutResult>;
   createPortalSession: (input: PortalInput) => Promise<{
     url: string;
   }>;
   /**
-  * Resolve every feature allowance for a reference straight from the provider — the optional
-  * companion to `checkEntitlement` that powers `listBalances`. Present only on providers that
-  * own entitlement truth; when absent, the facade evaluates balances locally from the store + the
-  * app's `entitlements` config.
-  */
+   * Resolve every feature allowance for a reference straight from the provider — the optional
+   * companion to `checkEntitlement` that powers `listBalances`. Present only on providers that
+   * own entitlement truth; when absent, the facade evaluates balances locally from the store + the
+   * app's `entitlements` config.
+   */
   getBalances?: (referenceId: string) => Promise<FeatureBalance[]>;
   getOrCreateCustomer: (ref: CustomerRef) => Promise<Customer>;
   /** Fetch the provider's current truth for a payment session — the basis for reconciliation. */
@@ -402,26 +402,26 @@ interface PaymentAdapter {
   parseWebhook: (input: WebhookInput) => Promise<WebhookAction>;
   refundPayment: (input: RefundInput) => Promise<PaymentSession>;
   /**
-  * Forward metered usage to the provider's billing API. Optional — present only on providers
-  * whose `capabilities.usageMetering` is `true` and that expose an ingestion endpoint. When
-  * absent, `track` still records usage durably and `check` enforces limits locally.
-  */
+   * Forward metered usage to the provider's billing API. Optional — present only on providers
+   * whose `capabilities.usageMetering` is `true` and that expose an ingestion endpoint. When
+   * absent, `track` still records usage durably and `check` enforces limits locally.
+   */
   reportUsage?: (input: ReportUsageInput) => Promise<void>;
   resumeSubscription: (subscriptionId: string) => Promise<Subscription>;
   updateSubscription: (subscriptionId: string, patch: SubscriptionPatch) => Promise<Subscription>;
 }
 /**
-* Registry of adapters keyed by provider id — supports dual-register during provider migration.
-* @experimental
-*/
+ * Registry of adapters keyed by provider id — supports dual-register during provider migration.
+ * @experimental
+ */
 interface AdapterRegistry {
   all: () => PaymentAdapter[];
   get: (provider: ProviderId) => PaymentAdapter;
   has: (provider: ProviderId) => boolean;
 }
 /**
-* `createAdapterRegistry` is part of the experimental `@lunora/payment` API and may change without a major version bump.
-* @experimental
-*/
+ * `createAdapterRegistry` is part of the experimental `@lunora/payment` API and may change without a major version bump.
+ * @experimental
+ */
 declare const createAdapterRegistry: (adapters: ReadonlyArray<PaymentAdapter>) => AdapterRegistry;
 export { ApplyResult as A, Customer as C, FeatureBalance as F, Money as M, PaymentAdapter as P, RefundAmountKind as R, Subscription as S, TrackInput as T, UsageEvent as U, WebhookActionType as W, ProviderId as a, PaymentSession as b, AttachInput as c, CheckoutResult as d, CancelSubscriptionOptions as e, CheckInput as f, CheckResult as g, CheckoutInput as h, TrackResult as i, CurrencyCode as j, PaymentState as k, SubscriptionState as l, WebhookAction as m, AdapterRegistry as n, CaptureInput as o, CustomerRef as p, PortalInput as q, ProviderCapabilities as r, RefundInput as s, ReportUsageInput as t, SubscriptionPatch as u, WebhookHeaders as v, WebhookInput as w, createAdapterRegistry as x };

package/dist/providers/autumn-features.d.mts

@@ -1,7 +1,7 @@
 /**
-* A per-seat / per-workspace sub-customer with its own feature balances.
-* @experimental
-*/
+ * A per-seat / per-workspace sub-customer with its own feature balances.
+ * @experimental
+ */
 interface AutumnEntity {
   readonly featureId?: string;
   readonly id: string;
@@ -10,9 +10,9 @@ interface AutumnEntity {
   readonly raw: Record<string, unknown>;
 }
 /**
-* `CreateEntityInput` is part of the experimental `@lunora/payment` API and may change without a major version bump.
-* @experimental
-*/
+ * `CreateEntityInput` is part of the experimental `@lunora/payment` API and may change without a major version bump.
+ * @experimental
+ */
 interface CreateEntityInput {
   /** The feature the entity consumes a seat/allowance of (e.g. `"seats"`). */
   readonly featureId: string;
@@ -21,49 +21,49 @@ interface CreateEntityInput {
   readonly name?: string;
 }
 /**
-* One point in a usage-events aggregation.
-* @experimental
-*/
+ * One point in a usage-events aggregation.
+ * @experimental
+ */
 interface UsageEventPoint {
   readonly count: number;
   readonly period?: string;
   readonly raw: Record<string, unknown>;
 }
 /**
-* `EventsListInput` is part of the experimental `@lunora/payment` API and may change without a major version bump.
-* @experimental
-*/
+ * `EventsListInput` is part of the experimental `@lunora/payment` API and may change without a major version bump.
+ * @experimental
+ */
 interface EventsListInput {
   /** Feature(s) to report on. */
   readonly featureId: ReadonlyArray<string> | string;
 }
 /**
-* `EventsAggregateInput` is part of the experimental `@lunora/payment` API and may change without a major version bump.
-* @experimental
-*/
+ * `EventsAggregateInput` is part of the experimental `@lunora/payment` API and may change without a major version bump.
+ * @experimental
+ */
 interface EventsAggregateInput extends EventsListInput {
   /** Time window to aggregate over (aggregate only — `list` ignores it, so it isn't accepted there). */
   readonly range?: "7d" | "24h" | "30d" | "90d" | "last_cycle";
 }
 /**
-* A prepaid feature quantity purchased at checkout (e.g. buy 5 seats up front).
-* @experimental
-*/
+ * A prepaid feature quantity purchased at checkout (e.g. buy 5 seats up front).
+ * @experimental
+ */
 interface PrepaidOption {
   readonly featureId: string;
   readonly quantity: number;
 }
 /**
-* Autumn-native checkout — richer than the generic `createCheckout` (trials, prepaid, entities, rewards).
-* @experimental
-*/
+ * Autumn-native checkout — richer than the generic `createCheckout` (trials, prepaid, entities, rewards).
+ * @experimental
+ */
 interface AutumnCheckoutInput {
   /** Scope the checkout to a specific entity (seat/workspace) rather than the top-level customer. */
   readonly entityId?: string;
   /**
-  * Autumn applies a plan's configured free trial automatically. Pass `false` to opt out of that
-  * trial for this checkout; leave unset (or `true`) to keep the plan default.
-  */
+   * Autumn applies a plan's configured free trial automatically. Pass `false` to opt out of that
+   * trial for this checkout; leave unset (or `true`) to keep the plan default.
+   */
   readonly freeTrial?: boolean;
   /** Prepaid feature quantities to purchase up front. */
   readonly options?: ReadonlyArray<PrepaidOption>;
@@ -74,9 +74,9 @@ interface AutumnCheckoutInput {
   readonly successUrl?: string;
 }
 /**
-* The subset of the Autumn SDK surface the native facade calls. A real `Autumn` instance satisfies it.
-* @experimental
-*/
+ * The subset of the Autumn SDK surface the native facade calls. A real `Autumn` instance satisfies it.
+ * @experimental
+ */
 interface AutumnFeaturesClientLike {
   readonly billing: unknown;
   readonly entities: unknown;
@@ -85,16 +85,16 @@ interface AutumnFeaturesClientLike {
   readonly referrals: unknown;
 }
 /**
-* `AutumnFeaturesOptions` is part of the experimental `@lunora/payment` API and may change without a major version bump.
-* @experimental
-*/
+ * `AutumnFeaturesOptions` is part of the experimental `@lunora/payment` API and may change without a major version bump.
+ * @experimental
+ */
 interface AutumnFeaturesOptions {
   readonly client: AutumnFeaturesClientLike;
 }
 /**
-* The Autumn-native feature facade returned by {@link createAutumnFeatures}.
-* @experimental
-*/
+ * The Autumn-native feature facade returned by {@link createAutumnFeatures}.
+ * @experimental
+ */
 interface AutumnFeatures {
   readonly checkout: (referenceId: string, input: AutumnCheckoutInput) => Promise<{
     raw: Record<string, unknown>;
@@ -121,9 +121,9 @@ interface AutumnFeatures {
   };
 }
 /**
-* Build the Autumn-native feature facade over an injected client. Companion to `createAutumnAdapter`;
-* share the same underlying `autumn-js` `Autumn` client between them.
-* @experimental
-*/
+ * Build the Autumn-native feature facade over an injected client. Companion to `createAutumnAdapter`;
+ * share the same underlying `autumn-js` `Autumn` client between them.
+ * @experimental
+ */
 declare const createAutumnFeatures: (options: AutumnFeaturesOptions) => AutumnFeatures;
 export { type AutumnCheckoutInput, type AutumnEntity, type AutumnFeatures, type AutumnFeaturesClientLike, type AutumnFeaturesOptions, type CreateEntityInput, type EventsAggregateInput, type EventsListInput, type PrepaidOption, type UsageEventPoint, createAutumnFeatures };