@blocklet/payment-types 1.24.3 → 1.25.0

package/lib/auto-recharge-config.d.ts

@@ -22,6 +22,13 @@ export declare class AutoRechargeConfig extends Model<InferAttributes<AutoRechar
         attempt_count: number;
         total_amount: string;
     };
+    slippage_config?: {
+        mode?: 'percent' | 'rate';
+        percent?: number;
+        min_acceptable_rate?: string;
+        base_currency?: string;
+        updated_at_ms?: number;
+    } | null;
     metadata?: Record<string, any>;
     created_at: CreationOptional<Date>;
     updated_at: CreationOptional<Date>;
@@ -106,6 +113,10 @@ export declare class AutoRechargeConfig extends Model<InferAttributes<AutoRechar
                 total_amount: string;
             };
         };
+        slippage_config: {
+            type: DataTypes.AbstractDataTypeConstructor;
+            allowNull: boolean;
+        };
         metadata: {
             type: DataTypes.AbstractDataTypeConstructor;
             allowNull: boolean;

package/lib/checkout-session.d.ts

@@ -24,6 +24,7 @@ export declare class CheckoutSession extends Model<InferAttributes<CheckoutSessi
     line_items: LineItem[];
     amount_subtotal: string;
     amount_total: string;
+    slippage_percent?: number;
     total_details?: {
         amount_discount?: string;
         amount_shipping?: string;
@@ -207,6 +208,11 @@ export declare class CheckoutSession extends Model<InferAttributes<CheckoutSessi
             type: DataTypes.StringDataType;
             allowNull: boolean;
         };
+        slippage_percent: {
+            type: DataTypes.DecimalDataType;
+            allowNull: boolean;
+            defaultValue: number;
+        };
         total_details: {
             type: DataTypes.AbstractDataTypeConstructor;
             allowNull: boolean;

package/lib/exchange-rate-provider.d.ts

@@ -0,0 +1,38 @@
+import { CreationOptional, InferAttributes, InferCreationAttributes, Model } from 'sequelize';
+import type { LiteralUnion } from 'type-fest';
+export declare const nextExchangeRateProviderId: (size?: number) => string;
+export declare class ExchangeRateProvider extends Model<InferAttributes<ExchangeRateProvider>, InferCreationAttributes<ExchangeRateProvider>> {
+    id: CreationOptional<string>;
+    name: string;
+    type: CreationOptional<LiteralUnion<'token-data' | 'coingecko' | 'coinmarketcap', string>>;
+    enabled: CreationOptional<boolean>;
+    priority: CreationOptional<number>;
+    status: CreationOptional<LiteralUnion<'active' | 'degraded' | 'paused' | 'inactive', string>>;
+    paused_reason: string | null;
+    config: Record<string, any> | null;
+    last_success_at: Date | null;
+    last_failure_at: Date | null;
+    failure_count: CreationOptional<number>;
+    created_at: CreationOptional<Date>;
+    updated_at: CreationOptional<Date>;
+    static initialize(sequelize: any): void;
+    static getActiveProviders(): Promise<ExchangeRateProvider[]>;
+    recordSuccess(): Promise<void>;
+    recordFailure(reason?: string): Promise<void>;
+    /**
+     * Encrypt sensitive config data (API keys)
+     * Should be called before saving to database
+     */
+    static encryptConfig(config: Record<string, any> | null): Record<string, any> | null;
+    /**
+     * Decrypt sensitive config data (API keys)
+     * Should be called after reading from database
+     */
+    static decryptConfig(config: Record<string, any> | null): Record<string, any> | null;
+    /**
+     * Mask sensitive config data for display
+     * Returns config with API key partially masked
+     */
+    static maskConfig(config: Record<string, any> | null): Record<string, any> | null;
+}
+export type TExchangeRateProvider = InferAttributes<ExchangeRateProvider>;

package/lib/index.d.ts

@@ -34,6 +34,8 @@ import { MeterEvent, TMeterEvent } from './meter-event';
 import { AutoRechargeConfig } from './auto-recharge-config';
 import { ProductVendor } from './product-vendor';
 import { TaxRate } from './tax-rate';
+import { ExchangeRateProvider } from './exchange-rate-provider';
+import { PriceQuote } from './price-quote';
 declare const models: {
     CheckoutSession: typeof CheckoutSession;
     Coupon: typeof Coupon;
@@ -70,6 +72,8 @@ declare const models: {
     AutoRechargeConfig: typeof AutoRechargeConfig;
     ProductVendor: typeof ProductVendor;
     TaxRate: typeof TaxRate;
+    ExchangeRateProvider: typeof ExchangeRateProvider;
+    PriceQuote: typeof PriceQuote;
 };
 export declare function initialize(sequelize: any): void;
 export default models;
@@ -109,6 +113,8 @@ export * from './meter-event';
 export * from './auto-recharge-config';
 export * from './product-vendor';
 export * from './tax-rate';
+export * from './exchange-rate-provider';
+export * from './price-quote';
 export type TPriceExpanded = TPrice & {
     object: 'price';
     product: TProduct;

package/lib/payment-intent.d.ts

@@ -31,6 +31,7 @@ export declare class PaymentIntent extends Model<InferAttributes<PaymentIntent>,
     review?: string;
     payment_details?: PaymentDetails;
     setup_future_usage?: LiteralUnion<'off_session' | 'on_session', string>;
+    quote_locked_at?: Date;
     beneficiaries?: PaymentBeneficiary[];
     created_at: CreationOptional<Date>;
     updated_at: CreationOptional<Date>;
@@ -141,6 +142,10 @@ export declare class PaymentIntent extends Model<InferAttributes<PaymentIntent>,
             type: DataTypes.EnumDataType<"off_session" | "on_session">;
             allowNull: boolean;
         };
+        quote_locked_at: {
+            type: DataTypes.DateDataTypeConstructor;
+            allowNull: boolean;
+        };
         created_at: {
             type: DataTypes.DateDataTypeConstructor;
             defaultValue: DataTypes.AbstractDataTypeConstructor;

package/lib/price-quote.d.ts

@@ -0,0 +1,87 @@
+import { CreationOptional, InferAttributes, InferCreationAttributes, Model, Transaction } from 'sequelize';
+import type { LiteralUnion } from 'type-fest';
+import { QuoteMetadata, QuoteStatus } from './types';
+export declare const nextPriceQuoteId: (size?: number) => string;
+/**
+ * Create Quote Input (Final Freeze Architecture)
+ *
+ * Quote is created only at Submit time, directly as 'used' status.
+ * @see Intent: blocklets/core/ai/intent/20260112-dynamic-price.md
+ */
+export interface CreateQuoteInput {
+    price_id: string;
+    session_id?: string;
+    invoice_id?: string;
+    idempotency_key: string;
+    base_currency?: string;
+    base_amount: string;
+    target_currency_id: string;
+    rate_currency_symbol: string;
+    exchange_rate: string;
+    quoted_amount: string;
+    rate_provider_id: string;
+    rate_provider_name: string;
+    rate_timestamp_ms: number;
+    slippage_percent?: number;
+    max_payable_token?: string;
+    min_acceptable_rate?: string;
+    metadata?: QuoteMetadata;
+}
+export declare class PriceQuote extends Model<InferAttributes<PriceQuote>, InferCreationAttributes<PriceQuote>> {
+    id: CreationOptional<string>;
+    price_id: string;
+    session_id?: string;
+    invoice_id?: string;
+    idempotency_key: string;
+    base_currency: string;
+    base_amount: string;
+    target_currency_id: string;
+    rate_currency_symbol: string;
+    exchange_rate: string;
+    quoted_amount: string;
+    rate_provider_id: string;
+    rate_provider_name: string;
+    rate_timestamp_ms: number;
+    expires_at: number;
+    status: CreationOptional<LiteralUnion<QuoteStatus, string>>;
+    metadata: QuoteMetadata | null;
+    slippage_percent?: number;
+    max_payable_token?: string;
+    min_acceptable_rate?: string;
+    slippage_derived_at_ms?: number;
+    created_at: CreationOptional<Date>;
+    static initialize(sequelize: any): void;
+    static associate(models: any): void;
+    /**
+     * Check if Quote is usable for payment
+     * Final Freeze: 'used' status means Quote is ready for payment
+     */
+    isUsable(): boolean;
+    /**
+     * Check if Quote can be retried (payment_failed can be retried)
+     */
+    canRetry(): boolean;
+    /**
+     * Find Quote by idempotency key (for idempotent Submit)
+     * Returns any Quote with the given key regardless of status
+     */
+    static findByIdempotencyKey(idempotencyKey: string): Promise<PriceQuote | null>;
+    /**
+     * Create Quote directly as 'used' (Final Freeze architecture)
+     *
+     * This is the ONLY way to create Quotes in the new architecture.
+     * Quotes are created at Submit time, never during Preview.
+     */
+    static createUsedQuote(input: CreateQuoteInput, transaction?: Transaction): Promise<PriceQuote>;
+    /**
+     * Mark Quote as paid (payment completed successfully)
+     * Idempotent: if already paid, returns silently
+     */
+    markAsPaid(transaction?: any): Promise<void>;
+    /**
+     * Mark Quote as payment_failed
+     * Note: payment_failed does NOT mean Quote is invalid, can be retried
+     */
+    markAsPaymentFailed(transaction?: any): Promise<void>;
+}
+export type TPriceQuote = InferAttributes<PriceQuote>;

package/lib/price.d.ts

@@ -47,6 +47,12 @@ export declare class Price extends Model<InferAttributes<Price>, InferCreationAt
     quantity_sold: number;
     quantity_limit_per_checkout: number;
     tax_behavior?: LiteralUnion<'inclusive' | 'exclusive', string>;
+    pricing_type: LiteralUnion<'fixed' | 'dynamic', string>;
+    base_currency: string | null;
+    base_amount: string | null;
+    dynamic_pricing_config: {
+        lock_duration?: number;
+    } | null;
     static readonly GENESIS_ATTRIBUTES: {
         id: {
             type: DataTypes.StringDataType;

package/lib/subscription.d.ts

@@ -59,6 +59,13 @@ export declare class Subscription extends Model<InferAttributes<Subscription>, I
         };
     };
     payment_details?: PaymentDetails;
+    slippage_config?: {
+        mode?: 'percent' | 'rate';
+        percent?: number;
+        min_acceptable_rate?: string;
+        base_currency?: string;
+        updated_at_ms?: number;
+    } | null;
     proration_behavior?: LiteralUnion<'always_invoice' | 'create_prorations' | 'none', string>;
     payment_behavior?: LiteralUnion<'allow_incomplete' | 'error_if_incomplete' | 'pending_if_incomplete', string>;
     service_actions?: ServiceAction[];
@@ -150,6 +157,10 @@ export declare class Subscription extends Model<InferAttributes<Subscription>, I
             type: DataTypes.EnumDataType<"charge_automatically" | "send_invoice">;
             allowNull: boolean;
         };
+        slippage_config: {
+            type: DataTypes.AbstractDataTypeConstructor;
+            allowNull: boolean;
+        };
         days_until_due: {
             type: DataTypes.NumberDataTypeConstructor;
             allowNull: boolean;

package/lib/types.d.ts

@@ -426,7 +426,7 @@ export type SubscriptionUpdateItem = {
     price_id?: string;
     quantity?: number;
 };
-export type EventType = LiteralUnion<'account.application.authorized' | 'account.application.deauthorized' | 'account.external_account.created' | 'account.external_account.deleted' | 'account.external_account.updated' | 'account.updated' | 'application_fee.created' | 'application_fee.refund.updated' | 'application_fee.refunded' | 'balance.available' | 'billing_portal.configuration.created' | 'billing_portal.configuration.updated' | 'billing_portal.session.created' | 'capability.updated' | 'cash_balance.funds_available' | 'charge.captured' | 'charge.dispute.closed' | 'charge.dispute.created' | 'charge.dispute.funds_reinstated' | 'charge.dispute.funds_withdrawn' | 'charge.dispute.updated' | 'charge.expired' | 'charge.failed' | 'charge.pending' | 'charge.refund.updated' | 'charge.refunded' | 'charge.succeeded' | 'charge.updated' | 'checkout.session.async_payment_failed' | 'checkout.session.async_payment_succeeded' | 'checkout.session.nft_minted' | 'checkout.session.completed' | 'checkout.session.expired' | 'checkout.session.created' | 'coupon.created' | 'coupon.deleted' | 'coupon.updated' | 'credit_note.created' | 'credit_note.updated' | 'credit_note.voided' | 'customer_cash_balance_transaction.created' | 'customer.created' | 'customer.deleted' | 'customer.discount.created' | 'customer.discount.deleted' | 'customer.discount.updated' | 'customer.source.created' | 'customer.source.deleted' | 'customer.source.expiring' | 'customer.source.updated' | 'customer.subscription.created' | 'customer.subscription.deleted' | 'customer.subscription.paused' | 'customer.subscription.past_due' | 'customer.subscription.pending_update_applied' | 'customer.subscription.pending_update_expired' | 'customer.subscription.resumed' | 'customer.subscription.renewed' | 'customer.subscription.recovered' | 'customer.subscription.upgraded' | 'customer.subscription.renew_failed' | 'customer.subscription.trial_start' | 'customer.subscription.trial_will_end' | 'customer.subscription.trial_end' | 'customer.subscription.started' | 'customer.subscription.updated' | 'customer.tax_id.created' | 'customer.tax_id.deleted' | 'customer.tax_id.updated' | 'customer.updated' | 'file.created' | 'financial_connections.account.created' | 'financial_connections.account.deactivated' | 'financial_connections.account.disconnected' | 'financial_connections.account.reactivated' | 'financial_connections.account.refreshed_balance' | 'identity.verification_session.canceled' | 'identity.verification_session.created' | 'identity.verification_session.processing' | 'identity.verification_session.redacted' | 'identity.verification_session.requires_input' | 'identity.verification_session.verified' | 'invoice.created' | 'invoice.deleted' | 'invoice.finalization_failed' | 'invoice.finalized' | 'invoice.marked_uncollectible' | 'invoice.paid' | 'invoice.payment_action_required' | 'invoice.payment_failed' | 'invoice.payment_succeeded' | 'invoice.sent' | 'invoice.upcoming' | 'invoice.updated' | 'invoice.voided' | 'invoiceitem.created' | 'invoiceitem.deleted' | 'issuing_authorization.created' | 'issuing_authorization.request' | 'issuing_authorization.updated' | 'issuing_card.created' | 'issuing_card.updated' | 'issuing_cardholder.created' | 'issuing_cardholder.updated' | 'issuing_dispute.closed' | 'issuing_dispute.created' | 'issuing_dispute.funds_reinstated' | 'issuing_dispute.submitted' | 'issuing_dispute.updated' | 'issuing_transaction.created' | 'issuing_transaction.updated' | 'mandate.updated' | 'order.created' | 'payment_intent.amount_capturable_updated' | 'payment_intent.canceled' | 'payment_intent.created' | 'payment_intent.partially_funded' | 'payment_intent.payment_failed' | 'payment_intent.processing' | 'payment_intent.requires_action' | 'payment_intent.succeeded' | 'payment_link.created' | 'payment_link.updated' | 'payment_method.attached' | 'payment_method.automatically_updated' | 'payment_method.detached' | 'payment_method.updated' | 'payout.canceled' | 'payout.created' | 'payout.failed' | 'payout.paid' | 'payout.reconciliation_completed' | 'payout.updated' | 'person.created' | 'person.deleted' | 'person.updated' | 'plan.created' | 'plan.deleted' | 'plan.updated' | 'price.created' | 'price.deleted' | 'price.updated' | 'product.created' | 'product.deleted' | 'product.updated' | 'promotion_code.created' | 'promotion_code.updated' | 'quote.accepted' | 'quote.canceled' | 'quote.created' | 'quote.finalized' | 'radar.early_fraud_warning.created' | 'radar.early_fraud_warning.updated' | 'recipient.created' | 'recipient.deleted' | 'recipient.updated' | 'refund.created' | 'refund.updated' | 'refund.succeeded' | 'refund.canceled' | 'reporting.report_run.failed' | 'reporting.report_run.succeeded' | 'reporting.report_type.updated' | 'review.closed' | 'review.opened' | 'setup_intent.canceled' | 'setup_intent.created' | 'setup_intent.requires_action' | 'setup_intent.setup_failed' | 'setup_intent.succeeded' | 'sigma.scheduled_query_run.created' | 'sku.created' | 'sku.deleted' | 'sku.updated' | 'source.canceled' | 'source.chargeable' | 'source.failed' | 'source.mandate_notification' | 'source.refund_attributes_required' | 'source.transaction.created' | 'source.transaction.updated' | 'subscription_schedule.aborted' | 'subscription_schedule.canceled' | 'subscription_schedule.completed' | 'subscription_schedule.created' | 'subscription_schedule.expiring' | 'subscription_schedule.released' | 'subscription_schedule.updated' | 'tax_rate.created' | 'tax_rate.updated' | 'tax.settings.updated' | 'terminal.reader.action_failed' | 'terminal.reader.action_succeeded' | 'test_helpers.test_clock.advancing' | 'test_helpers.test_clock.created' | 'test_helpers.test_clock.deleted' | 'test_helpers.test_clock.internal_failure' | 'test_helpers.test_clock.ready' | 'topup.canceled' | 'topup.created' | 'topup.failed' | 'topup.reversed' | 'topup.succeeded' | 'transfer.created' | 'transfer.reversed' | 'transfer.updated' | 'billing.discrepancy' | 'usage.report.empty' | 'customer.credit.insufficient' | 'customer.credit.low_balance' | 'customer.credit_grant.granted' | 'customer.credit_grant.depleted', string>;
+export type EventType = LiteralUnion<'account.application.authorized' | 'account.application.deauthorized' | 'account.external_account.created' | 'account.external_account.deleted' | 'account.external_account.updated' | 'account.updated' | 'application_fee.created' | 'application_fee.refund.updated' | 'application_fee.refunded' | 'balance.available' | 'billing_portal.configuration.created' | 'billing_portal.configuration.updated' | 'billing_portal.session.created' | 'capability.updated' | 'cash_balance.funds_available' | 'charge.captured' | 'charge.dispute.closed' | 'charge.dispute.created' | 'charge.dispute.funds_reinstated' | 'charge.dispute.funds_withdrawn' | 'charge.dispute.updated' | 'charge.expired' | 'charge.failed' | 'charge.pending' | 'charge.refund.updated' | 'charge.refunded' | 'charge.succeeded' | 'charge.updated' | 'checkout.session.async_payment_failed' | 'checkout.session.async_payment_succeeded' | 'checkout.session.nft_minted' | 'checkout.session.completed' | 'checkout.session.expired' | 'checkout.session.created' | 'coupon.created' | 'coupon.deleted' | 'coupon.updated' | 'credit_note.created' | 'credit_note.updated' | 'credit_note.voided' | 'customer_cash_balance_transaction.created' | 'customer.created' | 'customer.deleted' | 'customer.discount.created' | 'customer.discount.deleted' | 'customer.discount.updated' | 'customer.source.created' | 'customer.source.deleted' | 'customer.source.expiring' | 'customer.source.updated' | 'customer.subscription.created' | 'customer.subscription.deleted' | 'customer.subscription.paused' | 'customer.subscription.past_due' | 'customer.subscription.pending_update_applied' | 'customer.subscription.pending_update_expired' | 'customer.subscription.resumed' | 'customer.subscription.renewed' | 'customer.subscription.recovered' | 'customer.subscription.upgraded' | 'customer.subscription.renew_failed' | 'customer.subscription.trial_start' | 'customer.subscription.trial_will_end' | 'customer.subscription.trial_end' | 'customer.subscription.started' | 'customer.subscription.updated' | 'customer.tax_id.created' | 'customer.tax_id.deleted' | 'customer.tax_id.updated' | 'customer.updated' | 'file.created' | 'financial_connections.account.created' | 'financial_connections.account.deactivated' | 'financial_connections.account.disconnected' | 'financial_connections.account.reactivated' | 'financial_connections.account.refreshed_balance' | 'identity.verification_session.canceled' | 'identity.verification_session.created' | 'identity.verification_session.processing' | 'identity.verification_session.redacted' | 'identity.verification_session.requires_input' | 'identity.verification_session.verified' | 'invoice.created' | 'invoice.deleted' | 'invoice.finalization_failed' | 'invoice.finalized' | 'invoice.marked_uncollectible' | 'invoice.paid' | 'invoice.payment_action_required' | 'invoice.payment_failed' | 'invoice.payment_succeeded' | 'invoice.sent' | 'invoice.upcoming' | 'invoice.updated' | 'invoice.voided' | 'invoiceitem.created' | 'invoiceitem.deleted' | 'issuing_authorization.created' | 'issuing_authorization.request' | 'issuing_authorization.updated' | 'issuing_card.created' | 'issuing_card.updated' | 'issuing_cardholder.created' | 'issuing_cardholder.updated' | 'issuing_dispute.closed' | 'issuing_dispute.created' | 'issuing_dispute.funds_reinstated' | 'issuing_dispute.submitted' | 'issuing_dispute.updated' | 'issuing_transaction.created' | 'issuing_transaction.updated' | 'mandate.updated' | 'order.created' | 'payment_intent.amount_capturable_updated' | 'payment_intent.canceled' | 'payment_intent.created' | 'payment_intent.partially_funded' | 'payment_intent.payment_failed' | 'payment_intent.processing' | 'payment_intent.requires_action' | 'payment_intent.succeeded' | 'payment_link.created' | 'payment_link.updated' | 'payment_method.attached' | 'payment_method.automatically_updated' | 'payment_method.detached' | 'payment_method.updated' | 'payout.canceled' | 'payout.created' | 'payout.failed' | 'payout.paid' | 'payout.reconciliation_completed' | 'payout.updated' | 'person.created' | 'person.deleted' | 'person.updated' | 'plan.created' | 'plan.deleted' | 'plan.updated' | 'price.created' | 'price.deleted' | 'price.updated' | 'product.created' | 'product.deleted' | 'product.updated' | 'promotion_code.created' | 'promotion_code.updated' | 'quote.accepted' | 'quote.canceled' | 'quote.created' | 'quote.finalized' | 'radar.early_fraud_warning.created' | 'radar.early_fraud_warning.updated' | 'recipient.created' | 'recipient.deleted' | 'recipient.updated' | 'refund.created' | 'refund.updated' | 'refund.succeeded' | 'refund.canceled' | 'reporting.report_run.failed' | 'reporting.report_run.succeeded' | 'reporting.report_type.updated' | 'review.closed' | 'review.opened' | 'setup_intent.canceled' | 'setup_intent.created' | 'setup_intent.requires_action' | 'setup_intent.setup_failed' | 'setup_intent.succeeded' | 'sigma.scheduled_query_run.created' | 'sku.created' | 'sku.deleted' | 'sku.updated' | 'source.canceled' | 'source.chargeable' | 'source.failed' | 'source.mandate_notification' | 'source.refund_attributes_required' | 'source.transaction.created' | 'source.transaction.updated' | 'subscription_schedule.aborted' | 'subscription_schedule.canceled' | 'subscription_schedule.completed' | 'subscription_schedule.created' | 'subscription_schedule.expiring' | 'subscription_schedule.released' | 'subscription_schedule.updated' | 'tax_rate.created' | 'tax_rate.updated' | 'tax.settings.updated' | 'terminal.reader.action_failed' | 'terminal.reader.action_succeeded' | 'test_helpers.test_clock.advancing' | 'test_helpers.test_clock.created' | 'test_helpers.test_clock.deleted' | 'test_helpers.test_clock.internal_failure' | 'test_helpers.test_clock.ready' | 'topup.canceled' | 'topup.created' | 'topup.failed' | 'topup.reversed' | 'topup.succeeded' | 'transfer.created' | 'transfer.reversed' | 'transfer.updated' | 'billing.discrepancy' | 'usage.report.empty' | 'customer.credit.insufficient' | 'customer.credit.low_balance' | 'customer.credit_grant.granted' | 'customer.credit_grant.depleted' | 'exchange_rate.providers_unavailable' | 'exchange_rate.spread_exceeded', string>;
 export type StripeRefundReason = 'duplicate' | 'fraudulent' | 'requested_by_customer';
 export type SettingType = LiteralUnion<'donate' | 'notification', string>;
 export type NotificationFrequency = 'default' | 'daily' | 'weekly' | 'monthly';
@@ -563,4 +563,60 @@ export type CreditGrantChainDetail = {
     };
     voided_reason?: 'refund' | 'expired' | 'manual';
 };
+/**
+ * Quote Status (Final Freeze)
+ *
+ * - used: Quote created and consumed at Submit
+ * - paid: Payment completed successfully
+ * - payment_failed: Payment flow failed (does NOT mean Quote is invalid)
+ *
+ * Legacy statuses (deprecated, for backward compatibility only):
+ * - active, expired, cancelled, failed
+ *
+ * @see Intent: blocklets/core/ai/intent/20260112-dynamic-price.md
+ */
+/**
+ * Final Freeze: Quote only has 3 statuses
+ * - used: Quote created at Submit, ready for payment
+ * - paid: Payment completed successfully
+ * - payment_failed: Payment process failed (Quote still valid for retry)
+ */
+export type QuoteStatus = 'used' | 'paid' | 'payment_failed';
+export interface QuoteMetadata {
+    calculation?: {
+        token_amount_raw?: string;
+        unit_amount_raw?: string;
+        total_base_amount_scaled?: string;
+        rate_scaled?: string;
+        quoted_amount_unit?: string;
+    };
+    rounding?: {
+        mode?: string;
+        token_decimals?: number;
+    };
+    risk?: {
+        anomaly_detected?: boolean;
+        deviation_percent?: number;
+        degraded?: boolean;
+        degraded_reason?: string | null;
+    };
+    rate?: {
+        consensus_method?: string;
+        providers?: Array<{
+            id?: string;
+            name?: string;
+            rate?: string;
+            timestamp_ms?: number;
+            degraded?: boolean;
+            degraded_reason?: string;
+        }>;
+    };
+    slippage?: {
+        percent?: number;
+        max_payable_token?: string;
+        min_acceptable_rate?: string;
+        derived_at_ms?: number;
+    };
+    context?: Record<string, any>;
+}
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blocklet/payment-types",
-  "version": "1.24.3",
+  "version": "1.25.0",
   "description": "Typings for Payment Kit SDK",
   "keywords": [
     "types",
@@ -48,5 +48,5 @@
     "sequelize": "^6.37.7",
     "type-fest": "^4.41.0"
   },
-  "gitHead": "6f2a963875ed4aced1db11f1c3a044c7f5deedd6"
+  "gitHead": "00a94943fea21487c042a7b484f4649add502bc9"
 }