@usethrottle/cart 3.14.0 → 3.15.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

@@ -316,12 +316,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

@@ -316,12 +316,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.15.0",
   "description": "Typed REST client for the Throttle Cart API.",
   "type": "module",
   "main": "./dist/index.cjs",