@base44-preview/sdk 0.8.56-pr.347.bba12e2 → 0.8.56-pr.349.170ad04

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, 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 { 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 { 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/entities.types.d.ts

@@ -702,6 +702,10 @@ export interface EntityHandler<T = any> {
      *
      * Permanently removes all records that match the provided query.
      *
+     * This isn't a transaction. Each record is deleted on its own, so if the call
+     * fails partway, the records already deleted stay deleted. Learn more about
+     * [concurrent updates](/developers/backend/resources/entities/entity-schemas#concurrent-updates).
+     *
      * @param query - Query matching {@linkcode EntityFilterQuery}. Every matching record is deleted.
      * @returns Promise resolving to the deletion result.
      *
@@ -722,6 +726,10 @@ export interface EntityHandler<T = any> {
      * Efficiently creates multiple records at once. This is faster
      * than creating them individually.
      *
+     * This isn't a transaction. Each record is written on its own, so if the call
+     * fails partway, the records already written stay written. Learn more about
+     * [concurrent updates](/developers/backend/resources/entities/entity-schemas#concurrent-updates).
+     *
      * @param data - Array of record data objects.
      * @returns Promise resolving to an array of created records.
      *
@@ -749,6 +757,15 @@ export interface EntityHandler<T = any> {
      * so you don't re-process the same entities on each iteration. For
      * example, filter by `status: 'pending'` when setting status to `'processed'`.
      *
+     * Each matching record is updated on its own, and the call isn't a transaction.
+     * To claim one record safely, so that only one of 2 users acting at the same
+     * time succeeds, pass that record's `id` as a plain value plus the conditions
+     * that must still be true, then check `updated` in the response. The conditions
+     * are only checked again at write time when the query names a single `id`. Any
+     * other query, including several IDs in `$in` or `$or`, finds the matching
+     * records first and then updates them. Learn more about
+     * [concurrent updates](/developers/backend/resources/entities/entity-schemas#concurrent-updates).
+     *
      * To update a single record by ID, use {@linkcode update | update()} instead. To update
      * multiple specific records with different data each, use {@linkcode bulkUpdate | bulkUpdate()}.
      *
@@ -808,6 +825,21 @@ export interface EntityHandler<T = any> {
      *   hasMore = result.has_more;
      * }
      * ```
+     *
+     * @example
+     * ```typescript
+     * // Claim a record
+     * // Only one user can claim the task, even if several try at the same time
+     * const result = await base44.entities.Task.updateMany(
+     *   { id: taskId, status: 'open' },
+     *   { $set: { status: 'claimed', claimed_by: user.email } }
+     * );
+     * if (result.updated === 1) {
+     *   // This user claimed the task
+     * } else {
+     *   // Someone else claimed it first, or it was no longer open
+     * }
+     * ```
      */
     updateMany(query: Partial<T>, data: Record<string, Record<string, any>>): Promise<UpdateManyResult>;
     /**
@@ -919,6 +951,11 @@ export interface EntityHandler<T = any> {
      * key, the last one wins. Updates merge the given fields into the existing record, like
      * {@linkcode update | update()}.
      *
+     * This isn't a transaction. Each record is written on its own, so if the call
+     * fails partway, the records already written stay written. Concurrent calls with
+     * the same key can also create duplicate records. Learn more about
+     * [concurrent updates](/developers/backend/resources/entities/entity-schemas#concurrent-updates).
+     *
      * @param records - Array of record data objects. Each must carry a value, not an object or
      * array, for every field named in `options.key`, to find or create by. Other fields are
      * optional, and only the ones you include are merged into a matched record, like `update()`.
@@ -955,6 +992,10 @@ export interface EntityHandler<T = any> {
      *
      * You can update up to 500 records per request.
      *
+     * This isn't a transaction. Each record is written on its own, so if the call
+     * fails partway, the records already written stay written. Learn more about
+     * [concurrent updates](/developers/backend/resources/entities/entity-schemas#concurrent-updates).
+     *
      * To apply the same update to all records matching a query, use
      * {@linkcode updateMany | updateMany()}. To update a single record by ID, use
      * {@linkcode update | update()}.

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

@@ -58,36 +58,6 @@ 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.
  *
@@ -115,8 +85,6 @@ 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.
@@ -216,10 +184,6 @@ 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.347.bba12e2",
+  "version": "0.8.56-pr.349.170ad04",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",