@cedros/pay-react 1.0.4 → 1.1.0

package/dist/types/componentOptions.d.ts

@@ -3,11 +3,11 @@ import { CartItem } from './index';
 /**
  * Payment method types (extensible)
  */
-export type PaymentMethod = 'stripe' | 'crypto';
+export type PaymentMethod = 'stripe' | 'crypto' | 'credits';
 /**
  * Future payment methods (for type-safe extensibility)
  */
-export type FuturePaymentMethod = PaymentMethod | 'ach' | 'sepa' | 'bank-transfer';
+export type FuturePaymentMethod = PaymentMethod | 'credits' | 'ach' | 'sepa' | 'bank-transfer';
 /**
  * Payment success result (extensible for future data)
  */
@@ -39,6 +39,8 @@ export interface CheckoutOptions {
     cancelUrl?: string;
     /** Metadata for tracking (e.g., userId, sessionId, orderId) */
     metadata?: Record<string, string>;
+    /** JWT token from cedros-login for credits payment authentication */
+    authToken?: string;
 }
 /**
  * Display/UI-related options
@@ -55,6 +57,10 @@ export interface DisplayOptions {
     showCard?: boolean;
     /** Show crypto payment option */
     showCrypto?: boolean;
+    /** Label for credits payment button */
+    creditsLabel?: string;
+    /** Show credits payment option (requires credits to be enabled on backend) */
+    showCredits?: boolean;
     /** Show unified purchase button instead of separate buttons */
     showPurchaseButton?: boolean;
     /** Layout direction for dual payment buttons */
@@ -74,9 +80,11 @@ export interface DisplayOptions {
         items?: CartItem[];
         cardLabel?: string;
         cryptoLabel?: string;
+        creditsLabel?: string;
         showCard?: boolean;
         showCrypto?: boolean;
-        onPaymentAttempt?: (method: PaymentMethod) => void;
+        showCredits?: boolean;
+        onPaymentAttempt?: (method: PaymentMethod | 'credits') => void;
         onPaymentSuccess?: (txId: string) => void;
         onPaymentError?: (error: string) => void;
         customerEmail?: string;
@@ -98,9 +106,11 @@ export interface ModalRenderProps {
     items?: CartItem[];
     cardLabel?: string;
     cryptoLabel?: string;
+    creditsLabel?: string;
     showCard?: boolean;
     showCrypto?: boolean;
-    onPaymentAttempt?: (method: PaymentMethod) => void;
+    showCredits?: boolean;
+    onPaymentAttempt?: (method: PaymentMethod | 'credits') => void;
     onPaymentSuccess?: (result: PaymentSuccessResult) => void;
     onPaymentError?: (error: PaymentErrorDetail) => void;
     customerEmail?: string;

package/dist/types/componentOptions.d.ts.map

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

package/dist/types/errors.d.ts

@@ -120,10 +120,25 @@ export declare enum PaymentErrorCode {
     /** Database operation failed */
     DATABASE_ERROR = "database_error",
     /** Server configuration error */
-    CONFIG_ERROR = "config_error"
+    CONFIG_ERROR = "config_error",
+    /** User doesn't have enough credits for purchase */
+    INSUFFICIENT_CREDITS = "insufficient_credits",
+    /** Credits hold expired before authorization */
+    CREDITS_HOLD_EXPIRED = "credits_hold_expired",
+    /** Credits hold not found */
+    CREDITS_HOLD_NOT_FOUND = "credits_hold_not_found",
+    /** Redirect URL blocked by SSRF protection */
+    INVALID_REDIRECT_URL = "invalid_redirect_url",
+    /** Rate limit exceeded */
+    RATE_LIMIT_EXCEEDED = "rate_limit_exceeded",
+    /** Admin nonce already used (replay protection) */
+    NONCE_ALREADY_USED = "nonce_already_used"
 }
 /**
  * Structured error response from backend API
+ *
+ * NOTE: The Rust server does not include a `retryable` field.
+ * Retryability is inferred from error codes using ERROR_CATEGORIES.RETRYABLE.
  */
 export interface ErrorResponse {
     error: {
@@ -131,8 +146,8 @@ export interface ErrorResponse {
         code: PaymentErrorCode;
         /** Human-readable error message for display */
         message: string;
-        /** Whether the operation can be safely retried */
-        retryable: boolean;
+        /** Whether the operation can be safely retried (optional - legacy Go server only) */
+        retryable?: boolean;
         /** Additional context (resourceId, amounts, etc.) */
         details?: Record<string, unknown>;
     };
@@ -185,6 +200,9 @@ export declare class PaymentError extends Error {
     private getErrorInfo;
     /**
      * Create PaymentError from API error response
+     *
+     * If `retryable` field is not present (Rust server), infers retryability
+     * from error codes using ERROR_CATEGORIES.RETRYABLE.
      */
     static fromErrorResponse(response: ErrorResponse, httpStatus?: number): PaymentError;
     /**
@@ -208,6 +226,10 @@ export declare const ERROR_CATEGORIES: {
     /** Retryable errors (temporary failures) */
     readonly RETRYABLE: readonly [PaymentErrorCode.TRANSACTION_NOT_CONFIRMED, PaymentErrorCode.RPC_ERROR, PaymentErrorCode.NETWORK_ERROR, PaymentErrorCode.STRIPE_ERROR];
     /** Resource not found errors */
-    readonly NOT_FOUND: readonly [PaymentErrorCode.RESOURCE_NOT_FOUND, PaymentErrorCode.CART_NOT_FOUND, PaymentErrorCode.REFUND_NOT_FOUND, PaymentErrorCode.PRODUCT_NOT_FOUND, PaymentErrorCode.COUPON_NOT_FOUND, PaymentErrorCode.SESSION_NOT_FOUND];
+    readonly NOT_FOUND: readonly [PaymentErrorCode.RESOURCE_NOT_FOUND, PaymentErrorCode.CART_NOT_FOUND, PaymentErrorCode.REFUND_NOT_FOUND, PaymentErrorCode.PRODUCT_NOT_FOUND, PaymentErrorCode.COUPON_NOT_FOUND, PaymentErrorCode.SESSION_NOT_FOUND, PaymentErrorCode.CREDITS_HOLD_NOT_FOUND];
+    /** Credits-related errors */
+    readonly CREDITS: readonly [PaymentErrorCode.INSUFFICIENT_CREDITS, PaymentErrorCode.CREDITS_HOLD_EXPIRED, PaymentErrorCode.CREDITS_HOLD_NOT_FOUND];
+    /** Security/rate limit errors */
+    readonly SECURITY: readonly [PaymentErrorCode.INVALID_REDIRECT_URL, PaymentErrorCode.RATE_LIMIT_EXCEEDED, PaymentErrorCode.NONCE_ALREADY_USED];
 };
 //# sourceMappingURL=errors.d.ts.map

package/dist/types/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH;;;;;;;;;;GAUG;AACH,oBAAY,gBAAgB;IAI1B,gDAAgD;IAChD,qBAAqB,0BAA0B;IAC/C,oCAAoC;IACpC,iBAAiB,sBAAsB;IACvC,oCAAoC;IACpC,mBAAmB,wBAAwB;IAC3C,0CAA0C;IAC1C,qBAAqB,0BAA0B;IAC/C,gDAAgD;IAChD,yBAAyB,8BAA8B;IACvD,kCAAkC;IAClC,kBAAkB,uBAAuB;IACzC,4BAA4B;IAC5B,mBAAmB,wBAAwB;IAC3C,oCAAoC;IACpC,iBAAiB,sBAAsB;IACvC,4BAA4B;IAC5B,cAAc,mBAAmB;IACjC,gDAAgD;IAChD,0BAA0B,+BAA+B;IACzD,wCAAwC;IACxC,oBAAoB,yBAAyB;IAC7C,yCAAyC;IACzC,eAAe,oBAAoB;IACnC,4CAA4C;IAC5C,sBAAsB,2BAA2B;IACjD,iCAAiC;IACjC,wBAAwB,6BAA6B;IACrD,mCAAmC;IACnC,kBAAkB,uBAAuB;IACzC,oDAAoD;IACpD,gBAAgB,qBAAqB;IACrC,8BAA8B;IAC9B,qBAAqB,0BAA0B;IAC/C,4BAA4B;IAC5B,qBAAqB,0BAA0B;IAC/C,6CAA6C;IAC7C,YAAY,iBAAiB;IAC7B,0BAA0B;IAC1B,YAAY,iBAAiB;IAC7B,yDAAyD;IACzD,oBAAoB,yBAAyB;IAC7C,mCAAmC;IACnC,gBAAgB,qBAAqB;IACrC,gCAAgC;IAChC,aAAa,kBAAkB;IAK/B,6BAA6B;IAC7B,aAAa,kBAAkB;IAC/B,2BAA2B;IAC3B,aAAa,kBAAkB;IAC/B,iCAAiC;IACjC,cAAc,mBAAmB;IACjC,6BAA6B;IAC7B,cAAc,mBAAmB;IACjC,0BAA0B;IAC1B,gBAAgB,qBAAqB;IACrC,0BAA0B;IAC1B,cAAc,mBAAmB;IACjC,wBAAwB;IACxB,iBAAiB,sBAAsB;IACvC,oBAAoB;IACpB,UAAU,eAAe;IAKzB,iCAAiC;IACjC,kBAAkB,uBAAuB;IACzC,qBAAqB;IACrB,cAAc,mBAAmB;IACjC,uBAAuB;IACvB,gBAAgB,qBAAqB;IACrC,wBAAwB;IACxB,iBAAiB,sBAAsB;IACvC,uBAAuB;IACvB,gBAAgB,qBAAqB;IACrC,wBAAwB;IACxB,iBAAiB,sBAAsB;IACvC,wBAAwB;IACxB,iBAAiB,sBAAsB;IACvC,+BAA+B;IAC/B,wBAAwB,6BAA6B;IAKrD,yBAAyB;IACzB,cAAc,mBAAmB;IACjC,iCAAiC;IACjC,0BAA0B,+BAA+B;IACzD,6CAA6C;IAC7C,qBAAqB,0BAA0B;IAC/C,0CAA0C;IAC1C,2BAA2B,gCAAgC;IAK3D,mCAAmC;IACnC,YAAY,iBAAiB;IAC7B,mCAAmC;IACnC,SAAS,cAAc;IACvB,8CAA8C;IAC9C,aAAa,kBAAkB;IAK/B,4BAA4B;IAC5B,cAAc,mBAAmB;IACjC,gCAAgC;IAChC,cAAc,mBAAmB;IACjC,iCAAiC;IACjC,YAAY,iBAAiB;IAK7B,oDAAoD;IACpD,oBAAoB,yBAAyB;IAC7C,gDAAgD;IAChD,oBAAoB,yBAAyB;IAC7C,6BAA6B;IAC7B,sBAAsB,2BAA2B;IAKjD,8CAA8C;IAC9C,oBAAoB,yBAAyB;IAC7C,0BAA0B;IAC1B,mBAAmB,wBAAwB;IAC3C,mDAAmD;IACnD,kBAAkB,uBAAuB;CAC1C;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE;QACL,kCAAkC;QAClC,IAAI,EAAE,gBAAgB,CAAC;QACvB,+CAA+C;QAC/C,OAAO,EAAE,MAAM,CAAC;QAChB,qFAAqF;QACrF,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,qDAAqD;QACrD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;CACH;AAED;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,uCAAuC;IACvC,SAAgB,IAAI,EAAE,gBAAgB,CAAC;IAEvC,+CAA+C;IAC/C,SAAgB,SAAS,EAAE,OAAO,CAAC;IAEnC,+BAA+B;IAC/B,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElD,8CAA8C;IAC9C,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAGlC,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,OAAe,EAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,UAAU,CAAC,EAAE,MAAM;IAarB;;OAEG;IACI,QAAQ,IAAI,OAAO;IAI1B;;OAEG;IACI,EAAE,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO;IAI1C;;OAEG;IACI,YAAY,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,GAAG,OAAO;IAIhE;;;OAGG;IACI,cAAc,IAAI,MAAM;IAW/B;;OAEG;IACI,eAAe,IAAI,MAAM;IAIhC;;OAEG;IACI,SAAS,IAAI,MAAM,GAAG,SAAS;IAItC;;;OAGG;IACH,OAAO,CAAC,YAAY;IAKpB;;;;;OAKG;WACW,iBAAiB,CAC7B,QAAQ,EAAE,aAAa,EACvB,UAAU,CAAC,EAAE,MAAM,GAClB,YAAY;IAef;;;OAGG;WACW,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY;CAmBxD;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B,4DAA4D;;IAM5D,0DAA0D;;IAM1D,mDAAmD;;IAWnD,4BAA4B;;IAU5B,4CAA4C;;IAQ5C,gCAAgC;;IAWhC,6BAA6B;;IAO7B,iCAAiC;;CAMzB,CAAC"}

package/dist/types/index.d.ts

@@ -219,6 +219,113 @@ export declare namespace v1 {
         cryptoCouponCode: string;
         stripeDiscountPercent: number;
         cryptoDiscountPercent: number;
+        creditsAmount?: number;
+        effectiveCreditsAmount?: number;
+        hasCreditsDiscount?: boolean;
+        creditsDiscountPercent?: number;
+    }
+    /**
+     * Credits payment requirement
+     * Returned in quote response when credits payment is available
+     */
+    interface CreditsRequirement {
+        /** Credits amount required (in cents/smallest currency unit) */
+        amount: number;
+        /** Currency for display (e.g., "USD") */
+        currency: string;
+        /** Human-readable description */
+        description: string;
+        /** Resource being purchased */
+        resource: string;
+    }
+    /**
+     * Credits payment payload for cart quotes
+     */
+    interface CartCreditsQuote {
+        /** Total credits amount for cart */
+        amount: number;
+        /** Currency for display */
+        currency: string;
+        /** Description of cart purchase */
+        description: string;
+    }
+    /**
+     * Extended quote response that includes credits option
+     * Used by discovery endpoint and quote responses
+     */
+    interface QuoteWithCredits {
+        /** Resource identifier */
+        resource: string;
+        /** Quote expiration time (ISO 8601) */
+        expiresAt: string;
+        /** Stripe payment option (if available) */
+        stripe?: {
+            priceId: string;
+            amountCents: number;
+            currency: string;
+        };
+        /** x402 crypto payment option (if available) */
+        crypto?: X402Requirement;
+        /** Credits payment option (if available) */
+        credits?: CreditsRequirement;
+    }
+    /**
+     * Discovery response with available payment methods
+     */
+    interface DiscoveryResponse {
+        /** Available payment methods for this tenant */
+        methods: Array<'stripe' | 'x402-solana-spl-transfer' | 'credits'>;
+    }
+    /**
+     * Credits hold creation request
+     * Used to create a hold on user's credits before authorization
+     */
+    interface CreditsHoldRequest {
+        /** Resource being purchased */
+        resource: string;
+        /** Amount to hold (in cents) */
+        amount: number;
+        /** Optional metadata */
+        metadata?: Record<string, string>;
+    }
+    /**
+     * Credits hold response
+     */
+    interface CreditsHoldResponse {
+        /** Unique hold ID for authorization */
+        holdId: string;
+        /** Whether this is a new hold (false if reusing existing) */
+        isNew: boolean;
+        /** Amount held in lamports (smallest currency unit) */
+        amountLamports: number;
+        /** Expiration time of the hold (ISO 8601) */
+        expiresAt: string;
+        /** Currency of the hold (e.g., "USD") */
+        currency: string;
+    }
+    /**
+     * Credits authorization request
+     */
+    interface CreditsAuthorizeRequest {
+        /** Hold ID from credits hold creation */
+        creditsHoldId: string;
+        /** Resource being purchased */
+        resource: string;
+        /** Optional metadata */
+        metadata?: Record<string, string>;
+    }
+    /**
+     * Credits payment result
+     */
+    interface CreditsPaymentResult {
+        /** Whether payment was successful */
+        success: boolean;
+        /** Transaction/authorization ID on success */
+        transactionId?: string;
+        /** Error message on failure */
+        error?: string;
+        /** Error code for programmatic handling */
+        errorCode?: string;
     }
 }
 /**
@@ -243,6 +350,15 @@ export type PaymentResult = v1.PaymentResult;
 export type PaymentMetadata = v1.PaymentMetadata;
 export type PaymentState = v1.PaymentState;
 export type Product = v1.Product;
+export type CreditsRequirement = v1.CreditsRequirement;
+export type CartCreditsQuote = v1.CartCreditsQuote;
+export type QuoteWithCredits = v1.QuoteWithCredits;
+export type DiscoveryResponse = v1.DiscoveryResponse;
+export type CreditsHoldRequest = v1.CreditsHoldRequest;
+export type CreditsHoldResponse = v1.CreditsHoldResponse;
+export type CreditsAuthorizeRequest = v1.CreditsAuthorizeRequest;
+export type CreditsPaymentResult = v1.CreditsPaymentResult;
 export { PaymentErrorCode, PaymentError, ERROR_CATEGORIES, type ErrorResponse } from './errors';
 export type { PaymentMethod, FuturePaymentMethod, PaymentSuccessResult, PaymentErrorDetail, CheckoutOptions, DisplayOptions, ModalRenderProps, CallbackOptions, AdvancedOptions, } from './componentOptions';
+export type { BillingInterval, SubscriptionStatus, SubscriptionSessionRequest, SubscriptionSessionResponse, SubscriptionStatusRequest, SubscriptionStatusResponse, SubscriptionQuote, SubscriptionState, SubscriptionPaymentResult, CancelSubscriptionRequest, CancelSubscriptionResponse, BillingPortalRequest, BillingPortalResponse, ActivateX402SubscriptionRequest, ActivateX402SubscriptionResponse, ProrationBehavior, ChangeSubscriptionRequest, ChangeSubscriptionResponse, ChangePreviewRequest, ChangePreviewResponse, SubscriptionDetails, } from './subscription';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/subscription.d.ts

@@ -0,0 +1,300 @@
+import { X402Requirement, PaymentResult } from './index';
+/**
+ * Subscription billing interval
+ */
+export type BillingInterval = 'weekly' | 'monthly' | 'yearly' | 'custom';
+/**
+ * Subscription status
+ */
+export type SubscriptionStatus = 'active' | 'trialing' | 'past_due' | 'canceled' | 'unpaid' | 'expired';
+/**
+ * Request to create a Stripe subscription session
+ */
+export interface SubscriptionSessionRequest {
+    /** Resource/plan ID for the subscription */
+    resource: string;
+    /** Billing interval */
+    interval: BillingInterval;
+    /** Custom interval in days (only used when interval is 'custom') */
+    intervalDays?: number;
+    /** Number of trial days (0 for no trial) */
+    trialDays?: number;
+    /** Customer email (pre-fills Stripe checkout) */
+    customerEmail?: string;
+    /** Metadata for tracking */
+    metadata?: Record<string, string>;
+    /** Coupon code for discount */
+    couponCode?: string;
+    /** URL to redirect on success */
+    successUrl?: string;
+    /** URL to redirect on cancel */
+    cancelUrl?: string;
+}
+/**
+ * Response from subscription session creation
+ */
+export interface SubscriptionSessionResponse {
+    /** Stripe checkout session ID */
+    sessionId: string;
+    /** Stripe checkout URL */
+    url: string;
+}
+/**
+ * Request to check subscription status
+ */
+export interface SubscriptionStatusRequest {
+    /** Resource/plan ID */
+    resource: string;
+    /** User identifier (wallet address for crypto, email/customer ID for Stripe) */
+    userId: string;
+}
+/**
+ * Response from subscription status check
+ */
+export interface SubscriptionStatusResponse {
+    /** Whether subscription is currently active */
+    active: boolean;
+    /** Current subscription status */
+    status: SubscriptionStatus;
+    /** Subscription expiry timestamp (ISO 8601) */
+    expiresAt?: string;
+    /** Current billing period end timestamp (ISO 8601) */
+    currentPeriodEnd?: string;
+    /** Billing interval */
+    interval?: BillingInterval;
+    /** Whether subscription will cancel at period end */
+    cancelAtPeriodEnd?: boolean;
+}
+/**
+ * x402 subscription quote
+ * Extends standard X402Requirement with subscription-specific details
+ */
+export interface SubscriptionQuote {
+    /** Standard x402 payment requirement */
+    requirement: X402Requirement;
+    /** Subscription-specific details */
+    subscription: {
+        /** Billing interval */
+        interval: BillingInterval;
+        /** Custom interval in days (for 'custom' interval) */
+        intervalDays?: number;
+        /** Duration in seconds this payment covers */
+        durationSeconds: number;
+        /** When the subscription period starts (ISO 8601) */
+        periodStart: string;
+        /** When the subscription period ends (ISO 8601) */
+        periodEnd: string;
+    };
+}
+/**
+ * Subscription payment state
+ */
+export interface SubscriptionState {
+    /** Current state of the subscription flow */
+    status: 'idle' | 'loading' | 'checking' | 'success' | 'error';
+    /** Error message if status is 'error' */
+    error: string | null;
+    /** Stripe checkout session ID (for redirect flow) */
+    sessionId: string | null;
+    /** Subscription status after verification */
+    subscriptionStatus: SubscriptionStatus | null;
+    /** When subscription expires (ISO 8601) */
+    expiresAt: string | null;
+}
+/**
+ * Subscription payment result
+ * Extends PaymentResult with subscription-specific fields
+ */
+export interface SubscriptionPaymentResult extends PaymentResult {
+    /** Subscription status after payment */
+    subscriptionStatus?: SubscriptionStatus;
+    /** New expiry date after payment (ISO 8601) */
+    expiresAt?: string;
+    /** Current billing period end (ISO 8601) */
+    currentPeriodEnd?: string;
+}
+/**
+ * Request to cancel a subscription
+ */
+export interface CancelSubscriptionRequest {
+    /** Resource/plan ID */
+    resource: string;
+    /** User identifier (wallet address for crypto, email/customer ID for Stripe) */
+    userId: string;
+    /** Whether to cancel immediately or at period end (default: at period end) */
+    immediate?: boolean;
+}
+/**
+ * Response from subscription cancellation
+ */
+export interface CancelSubscriptionResponse {
+    /** Whether cancellation was successful */
+    success: boolean;
+    /** Updated subscription status */
+    status: SubscriptionStatus;
+    /** When the subscription will end (ISO 8601) */
+    endsAt?: string;
+    /** Error message if cancellation failed */
+    error?: string;
+}
+/**
+ * Request for Stripe billing portal
+ */
+export interface BillingPortalRequest {
+    /** User identifier (email or Stripe customer ID) */
+    userId: string;
+    /** URL to return to after portal session */
+    returnUrl?: string;
+}
+/**
+ * Response from billing portal request
+ */
+export interface BillingPortalResponse {
+    /** Stripe billing portal URL */
+    url: string;
+}
+/**
+ * Request to activate x402 subscription after payment verification
+ */
+export interface ActivateX402SubscriptionRequest {
+    /** Resource/plan ID */
+    resource: string;
+    /** User wallet address (base58) */
+    walletAddress: string;
+    /** Transaction signature from x402 payment */
+    transactionSignature: string;
+    /** Billing interval */
+    interval: BillingInterval;
+    /** Custom interval in days (for 'custom' interval) */
+    intervalDays?: number;
+}
+/**
+ * Response from x402 subscription activation
+ */
+export interface ActivateX402SubscriptionResponse {
+    /** Whether activation was successful */
+    success: boolean;
+    /** Subscription status after activation */
+    status: SubscriptionStatus;
+    /** When subscription period starts (ISO 8601) */
+    periodStart: string;
+    /** When subscription period ends (ISO 8601) */
+    periodEnd: string;
+    /** Error message if activation failed */
+    error?: string;
+}
+/**
+ * Proration behavior when changing subscriptions
+ */
+export type ProrationBehavior = 'create_prorations' | 'none' | 'always_invoice';
+/**
+ * Request to change subscription plan (upgrade/downgrade)
+ */
+export interface ChangeSubscriptionRequest {
+    /** Current resource/plan ID */
+    currentResource: string;
+    /** New resource/plan ID to change to */
+    newResource: string;
+    /** User identifier (wallet address for crypto, email/customer ID for Stripe) */
+    userId: string;
+    /** New billing interval (if changing interval) */
+    newInterval?: BillingInterval;
+    /** How to handle proration (Stripe only) */
+    prorationBehavior?: ProrationBehavior;
+    /** Whether to apply change immediately or at period end */
+    immediate?: boolean;
+}
+/**
+ * Response from subscription change
+ */
+export interface ChangeSubscriptionResponse {
+    /** Whether change was successful */
+    success: boolean;
+    /** Updated subscription status */
+    status: SubscriptionStatus;
+    /** New resource/plan ID */
+    newResource: string;
+    /** New billing interval */
+    newInterval: BillingInterval;
+    /** Amount credited/debited for proration (in cents) */
+    prorationAmount?: number;
+    /** Next billing date (ISO 8601) */
+    nextBillingDate?: string;
+    /** When the new plan becomes effective (ISO 8601) */
+    effectiveDate: string;
+    /** Error message if change failed */
+    error?: string;
+}
+/**
+ * Request for subscription change preview (proration calculation)
+ */
+export interface ChangePreviewRequest {
+    /** Current resource/plan ID */
+    currentResource: string;
+    /** New resource/plan ID to preview */
+    newResource: string;
+    /** User identifier */
+    userId: string;
+    /** New billing interval (if changing interval) */
+    newInterval?: BillingInterval;
+}
+/**
+ * Response from subscription change preview
+ */
+export interface ChangePreviewResponse {
+    /** Whether preview was successful */
+    success: boolean;
+    /** Amount to be charged immediately (positive) or credited (negative) in cents */
+    immediateAmount: number;
+    /** Currency for the amounts */
+    currency: string;
+    /** Current plan price per period (in cents) */
+    currentPlanPrice: number;
+    /** New plan price per period (in cents) */
+    newPlanPrice: number;
+    /** Days remaining in current period */
+    daysRemaining: number;
+    /** When the new plan would become effective (ISO 8601) */
+    effectiveDate: string;
+    /** Breakdown of proration calculation */
+    prorationDetails?: {
+        /** Credit for unused time on current plan (in cents) */
+        unusedCredit: number;
+        /** Cost for remaining time on new plan (in cents) */
+        newPlanCost: number;
+    };
+    /** Error message if preview failed */
+    error?: string;
+}
+/**
+ * Full subscription details (for management UI)
+ */
+export interface SubscriptionDetails {
+    /** Unique subscription ID */
+    id: string;
+    /** Resource/plan ID */
+    resource: string;
+    /** Current status */
+    status: SubscriptionStatus;
+    /** Billing interval */
+    interval: BillingInterval;
+    /** Custom interval in days (for 'custom' interval) */
+    intervalDays?: number;
+    /** Price per period (in cents for fiat, atomic units for crypto) */
+    pricePerPeriod: number;
+    /** Currency (e.g., "USD", "USDC") */
+    currency: string;
+    /** Whether subscription will cancel at period end */
+    cancelAtPeriodEnd: boolean;
+    /** Current period start (ISO 8601) */
+    currentPeriodStart: string;
+    /** Current period end (ISO 8601) */
+    currentPeriodEnd: string;
+    /** When subscription was created (ISO 8601) */
+    createdAt: string;
+    /** Payment method type */
+    paymentMethod: 'stripe' | 'x402';
+    /** Trial end date if in trial (ISO 8601) */
+    trialEnd?: string;
+}
+//# sourceMappingURL=subscription.d.ts.map

package/dist/types/subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../src/types/subscription.ts"],"names":[],"mappings":"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"}

package/dist/utils/cartHelpers.d.ts

@@ -7,6 +7,8 @@
 export interface NormalizedCartItem {
     resource: string;
     quantity: number;
+    /** Variant ID for variant-level inventory tracking */
+    variantId?: string;
     metadata?: Record<string, string>;
 }
 /**
@@ -39,6 +41,7 @@ export interface NormalizedCartItem {
 export declare function normalizeCartItems(items: Array<{
     resource: string;
     quantity?: number;
+    variantId?: string;
     metadata?: Record<string, string>;
 }>): NormalizedCartItem[];
 /**

package/dist/utils/cartHelpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cartHelpers.d.ts","sourceRoot":"","sources":["../../src/utils/cartHelpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AA4BD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,GACvF,kBAAkB,EAAE,CAMtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,CAE5E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,OAAO,CAO5E"}
+{"version":3,"file":"cartHelpers.d.ts","sourceRoot":"","sources":["../../src/utils/cartHelpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AA4BD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,GAC3G,kBAAkB,EAAE,CAOtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,CAE5E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,OAAO,CAO5E"}