@01.software/sdk 0.46.0 → 0.48.0

package/dist/{payload-types-CJZuXcgF.d.cts → payload-types-B6AZQcB7.d.cts}

@@ -71,6 +71,8 @@ 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;
         'order-status-logs': OrderStatusLog;
         'inventory-reservations': InventoryReservation;
         'fulfillment-orders': FulfillmentOrder;
@@ -302,6 +304,8 @@ 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>;
         'order-status-logs': OrderStatusLogsSelect<false> | OrderStatusLogsSelect<true>;
         'inventory-reservations': InventoryReservationsSelect<false> | InventoryReservationsSelect<true>;
         'fulfillment-orders': FulfillmentOrdersSelect<false> | FulfillmentOrdersSelect<true>;
@@ -606,6 +610,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 +2945,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 +2987,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 +3413,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 +3446,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 +3454,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 +3465,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)
@@ -3505,7 +3538,15 @@ interface PaymentSession {
      */
     slotState: 'held' | 'reconciling' | 'released' | 'spent';
     provider: string;
+    /**
+     * Internal execution provenance for managed adapters and the custom bridge.
+     */
+    sessionOrigin?: ('managed_adapter' | 'custom_bridge') | null;
     providerSessionId: string;
+    /**
+     * Provider Hosted URL exposed only through an ownership-checked PaymentSession response.
+     */
+    providerActionUrl?: string | null;
     providerAccount?: (string | null) | CommercePaymentAccount;
     credentialVersion?: number | null;
     environment?: string | null;
@@ -3561,6 +3602,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".
  */
@@ -3573,26 +3616,51 @@ 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;
+        /**
+         * 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;
         /**
          * Hosted Payment Session country (ISO 3166-1 alpha-2 uppercase).
          */
         country: string;
-        allowedPaymentMethods: ('CARD_KR' | 'N_PAY' | 'KAKAO_PAY' | 'TOSS_PAY')[];
+        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')[];
     };
     /**
      * When enabled, this connection is eligible for new PaymentSessions.
@@ -5837,17 +5905,68 @@ 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` "order-status-logs".
@@ -8397,9 +8516,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: {
@@ -8419,9 +8535,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;
@@ -8429,9 +8542,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;
@@ -8897,6 +9007,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;
@@ -10223,7 +10335,9 @@ interface PaymentSessionsSelect<T extends boolean = true> {
     finalizationStatus?: T;
     slotState?: T;
     provider?: T;
+    sessionOrigin?: T;
     providerSessionId?: T;
+    providerActionUrl?: T;
     providerAccount?: T;
     credentialVersion?: T;
     environment?: T;
@@ -10519,12 +10633,61 @@ 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` "order-status-logs_select".
@@ -12843,12 +13006,16 @@ 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;