@usethrottle/cart 3.14.0 → 3.16.0

package/README.md

@@ -366,8 +366,10 @@ await client.items.add(cart.id, {
   to 1 year.
 - `totalPayments` (2–60) makes an installment plan; `trialDays` (0–365) a free
   trial. They cannot be combined (`400 invalid_combination`).
-- `type` is forced to `subscription`, and the line never ships:
-  `requiresShipping: true` is rejected with `400 validation_error`.
+- `type` is forced to `subscription`, and the line is never charged shipping.
+  It ships only with `deliveryMethod: 'shipment'`, which makes a physical
+  subscription: every renewal order owes a box. `requiresShipping: true` is
+  rejected with `400 validation_error`.
 - A free-trial line is stored with `unitPrice: 0` and your price on
   `recurring.amount`, and its name gets a "— 14-day free trial" suffix.
 - `PATCH` may change `quantity` (seats) and `metadata` only. Changing

package/dist/index.d.cts

@@ -297,7 +297,8 @@ interface CreateCartInput {
     }>;
 }
 interface UpdateCartInput {
-    customerId?: string;
+    /** Send `null` to detach the customer; omit to keep it. Detaching does not clear `customerEmail`. */
+    customerId?: string | null;
     /** Lightweight email capture; `null` clears a previously-set value. */
     customerEmail?: string | null;
     billingAddress?: CartAddress;
@@ -316,12 +317,20 @@ interface AddLineItemInput {
     taxAmount?: number;
     discountAmount?: number;
     /**
-     * Makes this line a subscription: `type` is forced to `subscription`, and it
-     * never ships (`requiresShipping: true` is rejected with it). A free-trial
-     * line is stored with `unitPrice` 0 and your price on `recurring.amount`.
-     * Terms cannot change later: remove the line and add it again.
+     * Makes this line a subscription: `type` is forced to `subscription`. It
+     * ships only with `deliveryMethod: 'shipment'` (a physical subscription: a
+     * box every cycle, no shipping charge); `requiresShipping: true` is
+     * rejected with it. A free-trial line is stored with `unitPrice` 0 and your
+     * price on `recurring.amount`. Terms cannot change later: remove the line
+     * and add it again.
      */
     recurring?: LineRecurringInput;
+    /**
+     * What the item needs before it counts as delivered. Omit to infer it from
+     * `type` and `metadata`. `digital` and `access_grant` deliver themselves on
+     * payment; `none` means nothing to deliver.
+     */
+    deliveryMethod?: 'shipment' | 'digital' | 'access_grant' | 'service' | 'in_person' | 'custom' | 'none';
     imageUrl?: string;
     /**
      * Whether this item is physically shippable. For external/ad-hoc catalogs

package/dist/index.d.ts

@@ -297,7 +297,8 @@ interface CreateCartInput {
     }>;
 }
 interface UpdateCartInput {
-    customerId?: string;
+    /** Send `null` to detach the customer; omit to keep it. Detaching does not clear `customerEmail`. */
+    customerId?: string | null;
     /** Lightweight email capture; `null` clears a previously-set value. */
     customerEmail?: string | null;
     billingAddress?: CartAddress;
@@ -316,12 +317,20 @@ interface AddLineItemInput {
     taxAmount?: number;
     discountAmount?: number;
     /**
-     * Makes this line a subscription: `type` is forced to `subscription`, and it
-     * never ships (`requiresShipping: true` is rejected with it). A free-trial
-     * line is stored with `unitPrice` 0 and your price on `recurring.amount`.
-     * Terms cannot change later: remove the line and add it again.
+     * Makes this line a subscription: `type` is forced to `subscription`. It
+     * ships only with `deliveryMethod: 'shipment'` (a physical subscription: a
+     * box every cycle, no shipping charge); `requiresShipping: true` is
+     * rejected with it. A free-trial line is stored with `unitPrice` 0 and your
+     * price on `recurring.amount`. Terms cannot change later: remove the line
+     * and add it again.
      */
     recurring?: LineRecurringInput;
+    /**
+     * What the item needs before it counts as delivered. Omit to infer it from
+     * `type` and `metadata`. `digital` and `access_grant` deliver themselves on
+     * payment; `none` means nothing to deliver.
+     */
+    deliveryMethod?: 'shipment' | 'digital' | 'access_grant' | 'service' | 'in_person' | 'custom' | 'none';
     imageUrl?: string;
     /**
      * Whether this item is physically shippable. For external/ad-hoc catalogs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usethrottle/cart",
-  "version": "3.14.0",
+  "version": "3.16.0",
   "description": "Typed REST client for the Throttle Cart API.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -30,7 +30,7 @@
   },
   "scripts": {
     "build": "tsup",
-    "test": "tsc --noEmit --strict --skipLibCheck --target es2022 --lib es2022,dom --module esnext --moduleResolution bundler __tests__/recurring-types.check.ts && vitest run",
+    "test": "tsc --noEmit --strict --skipLibCheck --target es2022 --lib es2022,dom --module esnext --moduleResolution bundler __tests__/recurring-types.check.ts __tests__/cart-customer-detach.check.ts && vitest run",
     "typecheck": "tsc --noEmit"
   }
 }