@01.software/sdk 0.46.1 → 0.49.0

package/dist/{payload-types-3WNyC0gk.d.cts → payload-types-MKbx5MuJ.d.cts}

@@ -71,6 +71,10 @@ interface Config {
         'payment-kernel-operations': PaymentKernelOperation;
         'payment-kernel-operation-attempts': PaymentKernelOperationAttempt;
         'payment-kernel-financial-movements': PaymentKernelFinancialMovement;
+        'payment-kernel-provider-receipts': PaymentKernelProviderReceipt;
+        'payment-kernel-reconciliation-cases': PaymentKernelReconciliationCase;
+        'payment-kernel-results': PaymentKernelResult;
+        'payment-kernel-owner-commits': PaymentKernelOwnerCommit;
         'order-status-logs': OrderStatusLog;
         'inventory-reservations': InventoryReservation;
         'fulfillment-orders': FulfillmentOrder;
@@ -302,6 +306,10 @@ interface Config {
         'payment-kernel-operations': PaymentKernelOperationsSelect<false> | PaymentKernelOperationsSelect<true>;
         'payment-kernel-operation-attempts': PaymentKernelOperationAttemptsSelect<false> | PaymentKernelOperationAttemptsSelect<true>;
         'payment-kernel-financial-movements': PaymentKernelFinancialMovementsSelect<false> | PaymentKernelFinancialMovementsSelect<true>;
+        'payment-kernel-provider-receipts': PaymentKernelProviderReceiptsSelect<false> | PaymentKernelProviderReceiptsSelect<true>;
+        'payment-kernel-reconciliation-cases': PaymentKernelReconciliationCasesSelect<false> | PaymentKernelReconciliationCasesSelect<true>;
+        'payment-kernel-results': PaymentKernelResultsSelect<false> | PaymentKernelResultsSelect<true>;
+        'payment-kernel-owner-commits': PaymentKernelOwnerCommitsSelect<false> | PaymentKernelOwnerCommitsSelect<true>;
         'order-status-logs': OrderStatusLogsSelect<false> | OrderStatusLogsSelect<true>;
         'inventory-reservations': InventoryReservationsSelect<false> | InventoryReservationsSelect<true>;
         'fulfillment-orders': FulfillmentOrdersSelect<false> | FulfillmentOrdersSelect<true>;
@@ -606,6 +614,14 @@ interface Tenant {
     id: string;
     webhookPurgeFencedAt?: string | null;
     name: string;
+    /**
+     * TEST is a time-limited space with separate data and keys and no external effects.
+     */
+    tenantPurpose?: ('production' | 'test') | null;
+    /**
+     * A TEST tenant can be used for at most 30 days from creation.
+     */
+    testExpiresAt?: string | null;
     /**
      * URL-safe identifier (auto-generated)
      */
@@ -2933,7 +2949,7 @@ interface ShippingPolicy {
      */
     baseAmount?: number | null;
     /**
-     * Read-only rollout field. Edit the shipping rates array instead.
+     * Read-only rollout field. Set up free shipping with an order-amount rate row priced at 0, or with an automatic free_shipping discount that sets a minimum order amount. When you use a rate row, cap the existing paid row with Max Amount so both rows never apply together.
      */
     freeShippingMinAmount?: number | null;
     rates?: {
@@ -2975,7 +2991,13 @@ interface ShippingPolicy {
      * Estimated delivery days
      */
     estimatedDays?: number | null;
+    /**
+     * When off, this policy is skipped and orders price against the default shipping policy.
+     */
     isActive?: boolean | null;
+    /**
+     * Checking this clears the current default policy. Orders without an explicit policy and newly created products follow this one.
+     */
     isDefault?: boolean | null;
     metadata?: {
         [k: string]: unknown;
@@ -3395,14 +3417,26 @@ interface Discount {
      * Amount in KRW (won)
      */
     maxDiscountAmount?: number | null;
+    /**
+     * Start of the validity window (empty = starts immediately)
+     */
     startsAt?: string | null;
+    /**
+     * End of the validity window. Must be after the start; empty = never ends.
+     */
     endsAt?: string | null;
     customerSelection?: {
+        /**
+         * Choosing Included or Excluded requires at least one target below.
+         */
         type?: ('all' | 'included' | 'excluded') | null;
         customers?: (string | Customer)[] | null;
         customerGroups?: (string | CustomerGroup)[] | null;
     };
     productSelection?: {
+        /**
+         * Choosing Included or Excluded requires at least one target below.
+         */
         type?: ('all' | 'included' | 'excluded') | null;
         products?: (string | Product)[] | null;
         collections?: (string | ProductCollection)[] | null;
@@ -3416,7 +3450,7 @@ interface Discount {
      */
     pricingMarket?: (string | null) | Market;
     /**
-     * Total usage limit (empty = unlimited)
+     * Total usage limit (1 or more, empty = unlimited)
      */
     maxUses?: number | null;
     /**
@@ -3424,7 +3458,7 @@ interface Discount {
      */
     usesCount?: number | null;
     /**
-     * Usage limit per customer (empty = unlimited)
+     * Usage limit per customer (1 or more, empty = unlimited)
      */
     maxUsesPerCustomer?: number | null;
     /**
@@ -3435,6 +3469,9 @@ interface Discount {
      * Allow combining with other discounts
      */
     isCombinable?: boolean | null;
+    /**
+     * Only across-order allocation is supported. Each-line-item is always rejected at checkout and cannot be saved.
+     */
     allocationMethod?: ('across' | 'each') | null;
     /**
      * Discount priority (higher = first)
@@ -3510,6 +3547,16 @@ interface PaymentSession {
      */
     sessionOrigin?: ('managed_adapter' | 'custom_bridge') | null;
     providerSessionId: string;
+    /**
+     * Provider Hosted URL exposed only through an ownership-checked PaymentSession response.
+     */
+    providerActionUrl?: string | null;
+    /**
+     * Versioned provider browser action projected only after ownership checks.
+     */
+    providerAction?: {
+        [k: string]: unknown;
+    } | unknown[] | string | number | boolean | null;
     providerAccount?: (string | null) | CommercePaymentAccount;
     credentialVersion?: number | null;
     environment?: string | null;
@@ -3565,6 +3612,8 @@ interface PaymentSession {
     deletedAt?: string | null;
 }
 /**
+ * Connect a Toss Payments or PortOne account and register its payment credentials.
+ *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "commerce-payment-accounts".
  */
@@ -3577,26 +3626,58 @@ interface CommercePaymentAccount {
      */
     profileName: string;
     /**
-     * Immutable provider account identity (Toss mId / PortOne storeId).
+     * Provider account identity, immutable after registration (Toss mId / PortOne storeId).
      */
     providerAccountKey: string;
     environment: 'test' | 'live';
     markets: (string | Market)[];
     tossConfiguration?: {
+        /**
+         * Toss client key. Must use the test_ / live_ prefix matching the registered environment.
+         */
         clientKey: string;
         secretKey?: string | null;
+        /**
+         * Encrypted on save and never shown again. Leave blank to keep the registered key.
+         */
+        secretKeyInput?: string | null;
+        /**
+         * Toss payment widget payment-method UI key (e.g. DEFAULT).
+         */
         paymentMethodVariantKey: string;
+        /**
+         * Toss payment widget agreement UI key (e.g. AGREEMENT).
+         */
         agreementVariantKey: string;
         paymentMethodPolicy: 'instant_only';
     };
     portOneConfiguration?: {
         apiSecret?: string | null;
-        profileKey: string;
+        /**
+         * Encrypted on save and never shown again. Leave blank to keep the registered secret.
+         */
+        apiSecretInput?: string | null;
+        webhookSecret?: string | null;
+        /**
+         * Encrypted on save and never shown again. Leave blank to keep the registered secret.
+         */
+        webhookSecretInput?: string | null;
+        /**
+         * PortOne channel/store profile key.
+         */
+        profileKey?: string | null;
         /**
          * Hosted Payment Session country (ISO 3166-1 alpha-2 uppercase).
          */
-        country: string;
-        allowedPaymentMethods: ('CARD_KR' | 'N_PAY' | 'KAKAO_PAY' | 'TOSS_PAY')[];
+        country?: string | null;
+        allowedPaymentMethods?: ('CARD_KR' | 'N_PAY' | 'KAKAO_PAY' | 'TOSS_PAY' | 'CARD_INTERNATIONAL' | 'PAY_PAL' | 'UNION_PAY' | 'ALIPAY_CN' | 'ALIPAY_HK' | 'TRUE_MONEY' | 'DANA' | 'TOUCH_N_GO' | 'G_CASH' | 'WE_CHAT_PAY' | 'KLARNA' | 'E_CONTEXT' | 'GRAB_PAY_MY' | 'GRAB_PAY_SG' | 'SHOPEE_PAY_TH' | 'PAY_PAY' | 'BPI' | 'RABBIT_LINE_PAY' | 'CONVENIENCE_STORE_JP' | 'AMAZON_PAY' | 'RAKUTEN_PAY' | 'D_BARAI' | 'AU_PAY' | 'MERPAY')[] | null;
+        /**
+         * Currently supports only PortOne Standard V2 Toss Payments (new module) CARD channels. A redirect URL is required for mobile checkout.
+         */
+        standardV2?: {
+            channelKey?: string | null;
+            redirectUrl?: string | null;
+        };
     };
     /**
      * When enabled, this connection is eligible for new PaymentSessions.
@@ -5841,17 +5922,113 @@ interface PaymentKernelFinancialMovement {
     tenant?: (string | null) | Tenant;
     operation: string | PaymentKernelOperation;
     providerObjectIdentity: string | PaymentKernelProviderObjectIdentity;
-    movementKind: 'capture_confirmed' | 'refund_reservation' | 'refund_confirmed' | 'refund_reservation_release';
+    movementKind: 'capture_confirmed' | 'refund_reservation' | 'refund_confirmed' | 'refund_reservation_release' | 'dispute_loss' | 'reversal' | 'fee' | 'adjustment' | 'settled';
     movementIdentity: string;
     reservationMovement?: (string | null) | PaymentKernelFinancialMovement;
     terminalAttempt?: (string | null) | PaymentKernelOperationAttempt;
     definitivelyFailedAttempt?: (string | null) | PaymentKernelOperationAttempt;
+    providerReceipt?: (string | null) | PaymentKernelProviderReceipt;
     amount: number;
     currency: string;
     effectiveAt: string;
     updatedAt: string;
     createdAt: string;
 }
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "payment-kernel-provider-receipts".
+ */
+interface PaymentKernelProviderReceipt {
+    id: string;
+    tenant?: (string | null) | Tenant;
+    provider: string;
+    providerAccountKey: string;
+    environment: 'test' | 'live';
+    providerConnection: string | PaymentKernelProviderConnection;
+    credentialGeneration: string | PaymentKernelCredentialGeneration;
+    providerObjectIdentity?: (string | null) | PaymentKernelProviderObjectIdentity;
+    eventKind: string;
+    eventId: string;
+    bodyHash: string;
+    rawPayload?: string | null;
+    authenticatedAt: string;
+    rawPayloadRetainedUntil: string;
+    rawPayloadRedactedAt?: string | null;
+    state: 'authenticated' | 'conflicting';
+    updatedAt: string;
+    createdAt: string;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "payment-kernel-reconciliation-cases".
+ */
+interface PaymentKernelReconciliationCase {
+    id: string;
+    tenant?: (string | null) | Tenant;
+    provider: string;
+    providerAccountKey: string;
+    environment: 'test' | 'live';
+    providerConnection: string | PaymentKernelProviderConnection;
+    currency: string;
+    periodStart: string;
+    periodEnd: string;
+    exceptionIdentity: string;
+    capturedPrincipal: number;
+    refundedPrincipal: number;
+    disputeLoss: number;
+    adjustments: number;
+    fees: number;
+    expectedSettledNet: number;
+    reportedSettledNet: number;
+    state: 'open' | 'reconciled';
+    updatedAt: string;
+    createdAt: string;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "payment-kernel-results".
+ */
+interface PaymentKernelResult {
+    id: string;
+    tenant?: (string | null) | Tenant;
+    operation: string | PaymentKernelOperation;
+    obligation: string | PaymentKernelObligation;
+    ownerIdentity: string | PaymentKernelOwnerIdentity;
+    ownerKind: 'commerce_checkout' | 'event_ticket_purchase';
+    ownerId: string;
+    operationKind: 'capture' | 'refund' | 'void' | 'lookup' | 'dispute' | 'reconciliation';
+    outcome: 'succeeded' | 'definitively_failed';
+    providerObjectIdentity: string | PaymentKernelProviderObjectIdentity;
+    provider: string;
+    providerAccountKey: string;
+    environment: 'test' | 'live';
+    objectKind: string;
+    objectId: string;
+    terminalAttempt: string | PaymentKernelOperationAttempt;
+    sourceMovement?: (string | null) | PaymentKernelFinancialMovement;
+    sourceMovementKind?: ('capture_confirmed' | 'refund_reservation' | 'refund_confirmed' | 'refund_reservation_release' | 'dispute_loss' | 'reversal' | 'fee' | 'adjustment' | 'settled') | null;
+    sourceProviderReceipt?: (string | null) | PaymentKernelProviderReceipt;
+    amount: number;
+    currency: string;
+    providerOutcomeAt: string;
+    updatedAt: string;
+    createdAt: string;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "payment-kernel-owner-commits".
+ */
+interface PaymentKernelOwnerCommit {
+    id: string;
+    tenant?: (string | null) | Tenant;
+    kernelResult: string | PaymentKernelResult;
+    ownerIdentity: string | PaymentKernelOwnerIdentity;
+    ownerKind: 'commerce_checkout' | 'event_ticket_purchase';
+    ownerId: string;
+    committedAt: string;
+    updatedAt: string;
+    createdAt: string;
+}
 /**
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "order-status-logs".
@@ -8157,6 +8334,22 @@ interface CustomerMembership {
     currency: 'KRW' | 'USD' | 'EUR' | 'JPY';
     billingInterval: 'month' | 'year';
     intervalCount: number;
+    /**
+     * Trial-day snapshot captured when the subscribe intent is created
+     */
+    trialDaysSnapshot?: number | null;
+    /**
+     * Immutable original period start for the subscribe intent
+     */
+    subscribePeriodStart?: string | null;
+    /**
+     * Immutable original period end for the subscribe intent
+     */
+    subscribePeriodEnd?: string | null;
+    /**
+     * Immutable SHA-256 digest of historical paid-admission recovery basis
+     */
+    historicalPaidRecoveryEvidence?: string | null;
     currentPeriodStart?: string | null;
     currentPeriodEnd?: string | null;
     nextBillingAt?: string | null;
@@ -8401,9 +8594,6 @@ interface Form {
         blockType: 'textarea';
     })[] | null;
     submitButtonLabel?: string | null;
-    /**
-     * Choose whether to display an on-page message or redirect to a different page after they submit the form.
-     */
     confirmationType?: ('message' | 'redirect') | null;
     confirmationMessage?: {
         root: {
@@ -8423,9 +8613,6 @@ interface Form {
     redirect?: {
         url: string;
     };
-    /**
-     * Send custom emails when the form submits. Use comma separated lists to send the same email to multiple recipients. To reference a value from this form, wrap that field's name with double curly brackets, i.e. {{firstName}}. You can use a wildcard {{*}} to output all data and {{*:table}} to format it as an HTML table in the email.
-     */
     emails?: {
         emailTo?: string | null;
         cc?: string | null;
@@ -8433,9 +8620,6 @@ interface Form {
         replyTo?: string | null;
         emailFrom?: string | null;
         subject: string;
-        /**
-         * Enter the message that should be sent in this email.
-         */
         message?: {
             root: {
                 type: string;
@@ -8901,6 +9085,8 @@ interface WebhookOutboxDeliveriesSelect<T extends boolean = true> {
 interface TenantsSelect<T extends boolean = true> {
     webhookPurgeFencedAt?: T;
     name?: T;
+    tenantPurpose?: T;
+    testExpiresAt?: T;
     slug?: T;
     previewDestinations?: T | {
         origin?: T;
@@ -10229,6 +10415,8 @@ interface PaymentSessionsSelect<T extends boolean = true> {
     provider?: T;
     sessionOrigin?: T;
     providerSessionId?: T;
+    providerActionUrl?: T;
+    providerAction?: T;
     providerAccount?: T;
     credentialVersion?: T;
     environment?: T;
@@ -10524,12 +10712,104 @@ interface PaymentKernelFinancialMovementsSelect<T extends boolean = true> {
     reservationMovement?: T;
     terminalAttempt?: T;
     definitivelyFailedAttempt?: T;
+    providerReceipt?: T;
     amount?: T;
     currency?: T;
     effectiveAt?: T;
     updatedAt?: T;
     createdAt?: T;
 }
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "payment-kernel-provider-receipts_select".
+ */
+interface PaymentKernelProviderReceiptsSelect<T extends boolean = true> {
+    tenant?: T;
+    provider?: T;
+    providerAccountKey?: T;
+    environment?: T;
+    providerConnection?: T;
+    credentialGeneration?: T;
+    providerObjectIdentity?: T;
+    eventKind?: T;
+    eventId?: T;
+    bodyHash?: T;
+    rawPayload?: T;
+    authenticatedAt?: T;
+    rawPayloadRetainedUntil?: T;
+    rawPayloadRedactedAt?: T;
+    state?: T;
+    updatedAt?: T;
+    createdAt?: T;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "payment-kernel-reconciliation-cases_select".
+ */
+interface PaymentKernelReconciliationCasesSelect<T extends boolean = true> {
+    tenant?: T;
+    provider?: T;
+    providerAccountKey?: T;
+    environment?: T;
+    providerConnection?: T;
+    currency?: T;
+    periodStart?: T;
+    periodEnd?: T;
+    exceptionIdentity?: T;
+    capturedPrincipal?: T;
+    refundedPrincipal?: T;
+    disputeLoss?: T;
+    adjustments?: T;
+    fees?: T;
+    expectedSettledNet?: T;
+    reportedSettledNet?: T;
+    state?: T;
+    updatedAt?: T;
+    createdAt?: T;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "payment-kernel-results_select".
+ */
+interface PaymentKernelResultsSelect<T extends boolean = true> {
+    tenant?: T;
+    operation?: T;
+    obligation?: T;
+    ownerIdentity?: T;
+    ownerKind?: T;
+    ownerId?: T;
+    operationKind?: T;
+    outcome?: T;
+    providerObjectIdentity?: T;
+    provider?: T;
+    providerAccountKey?: T;
+    environment?: T;
+    objectKind?: T;
+    objectId?: T;
+    terminalAttempt?: T;
+    sourceMovement?: T;
+    sourceMovementKind?: T;
+    sourceProviderReceipt?: T;
+    amount?: T;
+    currency?: T;
+    providerOutcomeAt?: T;
+    updatedAt?: T;
+    createdAt?: T;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "payment-kernel-owner-commits_select".
+ */
+interface PaymentKernelOwnerCommitsSelect<T extends boolean = true> {
+    tenant?: T;
+    kernelResult?: T;
+    ownerIdentity?: T;
+    ownerKind?: T;
+    ownerId?: T;
+    committedAt?: T;
+    updatedAt?: T;
+    createdAt?: T;
+}
 /**
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "order-status-logs_select".
@@ -12773,6 +13053,10 @@ interface CustomerMembershipsSelect<T extends boolean = true> {
     currency?: T;
     billingInterval?: T;
     intervalCount?: T;
+    trialDaysSnapshot?: T;
+    subscribePeriodStart?: T;
+    subscribePeriodEnd?: T;
+    historicalPaidRecoveryEvidence?: T;
     currentPeriodStart?: T;
     currentPeriodEnd?: T;
     nextBillingAt?: T;
@@ -12848,15 +13132,23 @@ interface CommercePaymentAccountsSelect<T extends boolean = true> {
     tossConfiguration?: T | {
         clientKey?: T;
         secretKey?: T;
+        secretKeyInput?: T;
         paymentMethodVariantKey?: T;
         agreementVariantKey?: T;
         paymentMethodPolicy?: T;
     };
     portOneConfiguration?: T | {
         apiSecret?: T;
+        apiSecretInput?: T;
+        webhookSecret?: T;
+        webhookSecretInput?: T;
         profileKey?: T;
         country?: T;
         allowedPaymentMethods?: T;
+        standardV2?: T | {
+            channelKey?: T;
+            redirectUrl?: T;
+        };
     };
     isActive?: T;
     credentialVersion?: T;