@base44-preview/sdk 0.8.56-pr.352.b15ea38 → 0.8.56-pr.353.5c12c6c

package/dist/index.d.ts

@@ -14,7 +14,7 @@ export type { AppLogsModule } from "./modules/app-logs.types.js";
 export type { AppModule, AppPublicSettings, AppPublicSettingsResponse, } from "./modules/app.types.js";
 export type { ActorsModule, ActorClient, ActorRef, Connection, ActorSubscription, ActorConnectOptions, ActorNameRegistry, ActorRegistry, } from "./modules/actors.types.js";
 export type { SsoModule, SsoAccessTokenResponse } from "./modules/sso.types.js";
-export type { PaymentsModule, ServiceRolePaymentsModule, PaymentsErrorCode, PaymentsRecurringFrequency, CheckoutBuyer, CheckoutFreeTrial, CheckoutItem, CheckoutItemRecurring, CheckoutPresentation, CheckoutElement, CheckoutMount, MountableCheckout, CreateCheckoutParams, CreateCheckoutResult, CompleteCheckoutResult, EmbeddedCheckout, PayPalEmbeddedCheckout, StripeEmbeddedCheckout, MountCheckoutOptions, ListPurchasesParams, ServiceRoleListPurchasesParams, ListPurchasesResult, Purchase, PurchaseItem, PurchaseStatus, RefundParams, RefundResult, CancelSubscriptionOptions, SubscriptionResult, } from "./modules/payments.types.js";
+export type { PaymentsModule, ServiceRolePaymentsModule, PaymentsErrorCode, PaymentsRecurringFrequency, CheckoutBuyer, CheckoutFreeTrial, CheckoutItem, CheckoutItemRecurring, CheckoutPresentation, CheckoutShipping, CheckoutElement, CheckoutMount, MountableCheckout, CreateCheckoutParams, CreateCheckoutResult, CompleteCheckoutResult, EmbeddedCheckout, PayPalEmbeddedCheckout, StripeEmbeddedCheckout, MountCheckoutOptions, ListPurchasesParams, ServiceRoleListPurchasesParams, ListPurchasesResult, Purchase, PurchaseItem, PurchaseStatus, RefundParams, ShippingAddress, RefundResult, CancelSubscriptionOptions, SubscriptionResult, } from "./modules/payments.types.js";
 export type { BrowserModule, BrowserSession, BrowserSessionOptions, } from "./modules/browser.types.js";
 export { Actor, type Conn } from "./actor.js";
 export type { ConnectorsModule, UserConnectorsModule, ConnectorApiRequest, ConnectorApiResponse, ConnectorApiResponsePhase, } from "./modules/connectors.types.js";

package/dist/modules/connectors.types.d.ts

@@ -81,7 +81,7 @@ export interface ConnectorApiRequest {
 export interface ConnectorApiResponse<T = unknown> {
     /** `true` only when the upstream API returned a 2xx status. Proxy and upstream errors are `false`. */
     success: boolean;
-    /** How far the call progressed. Only `not_sent` proves the provider did not execute it. */
+    /** How far the call progressed. */
     phase: ConnectorApiResponsePhase;
     /** The upstream HTTP status code, or `null` when no response was received. */
     status: number | null;

package/dist/modules/payments.types.d.ts

@@ -40,7 +40,7 @@ export interface CheckoutItem {
     amount: number;
     /** Number of units, from 1 to 1,000,000. Defaults to `1`. */
     quantity?: number;
-    /** Whether the item ships, so the provider collects a shipping address. */
+    /** Whether the item ships. The provider then collects a shipping address, unless you pass one in `shipping.address`. */
     shippable?: boolean;
     /** Billing terms. Set this to sell the item as a subscription. PayPal and Wix Payments allow one recurring item per checkout, and PayPal allows no other items with it. */
     recurring?: CheckoutItemRecurring;
@@ -58,6 +58,36 @@ export interface CheckoutBuyer {
     /** Buyer's phone number. */
     phone?: string;
 }
+/**
+ * A shipping address. Returned on a purchase whether your app or the provider collected it.
+ */
+export interface ShippingAddress {
+    /** Recipient's full name, 1 to 300 characters. */
+    name: string;
+    /** Street address, 1 to 300 characters. */
+    line1: string;
+    /** Apartment, suite or building, up to 300 characters. */
+    line2?: string | null;
+    /** City, up to 120 characters. Some countries address by region and postal code alone. */
+    city?: string | null;
+    /** State, province or region, up to 300 characters. */
+    region?: string | null;
+    /** Postal or ZIP code, up to 60 characters. */
+    postal_code?: string | null;
+    /** Two-letter ISO 3166-1 country code, such as `'US'`. */
+    country: string;
+}
+/**
+ * Shipping for a checkout with at least one `shippable` item. Supported for PayPal one-time checkouts only.
+ *
+ * Compute the fee on your server, never in the browser. When the fee depends on the address, such as by distance or zone, collect the address in your app and pass it in `address`: PayPal shows it to the buyer locked, so the order ships where the fee was computed for. When the fee doesn't depend on the address, pass only `amount` and PayPal asks the buyer for the address.
+ */
+export interface CheckoutShipping {
+    /** Address your app collected. Omit it to let the provider ask the buyer. */
+    address?: ShippingAddress;
+    /** Shipping fee in minor units, shown to the buyer as its own shipping line. Omit it for free shipping. */
+    amount?: number;
+}
 /**
  * How the buyer pays.
  *
@@ -85,6 +115,8 @@ export interface CreateCheckoutParams {
     idempotency_key?: string;
     /** How the buyer pays. Defaults to `'redirect'`. PayPal apps must pass `'embedded'`, and Wix Payments supports only `'redirect'`. */
     presentation?: CheckoutPresentation;
+    /** Shipping address and fee. Allowed only when at least one item is `shippable`. Supported for PayPal one-time checkouts only; other providers and subscriptions reject it with `invalid_request`. */
+    shipping?: CheckoutShipping;
 }
 /**
  * Data that Stripe Embedded Checkout needs to render.
@@ -184,6 +216,10 @@ export interface Purchase {
     metadata?: Record<string, string> | null;
     /** ID of the subscription, for recurring purchases. */
     subscription_id?: string | null;
+    /** Where the order ships, whether your app or the provider collected the address. Always `null` unless you call with the service role. Save it on your order record. */
+    shipping_address?: ShippingAddress | null;
+    /** Shipping fee in minor units, when the checkout charged one. */
+    shipping_amount?: number | null;
     /** ID of the payment to pass to [`refund()`](/developers/references/sdk/docs/interfaces/service-role-payments#refund). For a PayPal subscription it's the latest charge, returned only with the service role: read it when you start a refund and reuse it on retries. It's `null` where the provider doesn't name a payment, such as a PayPal subscription whose latest charge is already refunded. */
     payment_id?: string | null;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.56-pr.352.b15ea38",
+  "version": "0.8.56-pr.353.5c12c6c",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",