@usethrottle/quotes 0.5.0 → 0.7.0

package/dist/index.d.cts

@@ -27,6 +27,16 @@ interface QuoteItemRecurring {
     totalPayments: number | null;
     /** 0 when there is no free trial. A free-trial line charges nothing at acceptance. */
     trialDays: number;
+    /**
+     * Custom installment schedule: payments that differ in amount (per unit, minor
+     * units) and in the gap before each one. Present only on a schedule line, where
+     * `totalPayments` equals its length. Row 0 has no gap.
+     */
+    schedule?: Array<{
+        amount: number;
+        intervalUnit: string | null;
+        intervalCount: number | null;
+    }>;
 }
 interface QuoteItem {
     id: string;
@@ -123,6 +133,8 @@ interface RequestFormConfig {
     fields: {
         companyName?: boolean;
         phone?: boolean;
+        /** Show an optional shipping address section. */
+        shippingAddress?: boolean;
         buyerReference?: boolean;
         lineItems?: boolean;
         targetPrice?: boolean;
@@ -164,6 +176,19 @@ interface SubmitQuoteRequestInput {
     companyName?: string | null;
     phone?: string | null;
     buyerReference?: string | null;
+    /**
+     * Optional. All blank = no address; otherwise `addressLine1`, `city` and a
+     * 2-letter `countryCode` are required. Stored on the quote and prefilled
+     * into checkout when the buyer accepts.
+     */
+    shippingAddress?: {
+        addressLine1?: string | null;
+        addressLine2?: string | null;
+        city?: string | null;
+        stateProvince?: string | null;
+        postalCode?: string | null;
+        countryCode?: string | null;
+    } | null;
     /** Honeypot — leave empty. The component wires this for you. */
     website?: string | null;
     /** Client mount time in ms; the API enforces a minimum fill duration. */

package/dist/index.d.ts

@@ -27,6 +27,16 @@ interface QuoteItemRecurring {
     totalPayments: number | null;
     /** 0 when there is no free trial. A free-trial line charges nothing at acceptance. */
     trialDays: number;
+    /**
+     * Custom installment schedule: payments that differ in amount (per unit, minor
+     * units) and in the gap before each one. Present only on a schedule line, where
+     * `totalPayments` equals its length. Row 0 has no gap.
+     */
+    schedule?: Array<{
+        amount: number;
+        intervalUnit: string | null;
+        intervalCount: number | null;
+    }>;
 }
 interface QuoteItem {
     id: string;
@@ -123,6 +133,8 @@ interface RequestFormConfig {
     fields: {
         companyName?: boolean;
         phone?: boolean;
+        /** Show an optional shipping address section. */
+        shippingAddress?: boolean;
         buyerReference?: boolean;
         lineItems?: boolean;
         targetPrice?: boolean;
@@ -164,6 +176,19 @@ interface SubmitQuoteRequestInput {
     companyName?: string | null;
     phone?: string | null;
     buyerReference?: string | null;
+    /**
+     * Optional. All blank = no address; otherwise `addressLine1`, `city` and a
+     * 2-letter `countryCode` are required. Stored on the quote and prefilled
+     * into checkout when the buyer accepts.
+     */
+    shippingAddress?: {
+        addressLine1?: string | null;
+        addressLine2?: string | null;
+        city?: string | null;
+        stateProvince?: string | null;
+        postalCode?: string | null;
+        countryCode?: string | null;
+    } | null;
     /** Honeypot — leave empty. The component wires this for you. */
     website?: string | null;
     /** Client mount time in ms; the API enforces a minimum fill duration. */

package/dist/index.js

@@ -543,6 +543,11 @@ function isIntervalUnit(value) {
   return typeof value === "string" && INTERVAL_UNITS.includes(value);
 }
 
+// ../core-cadence/src/schedule.ts
+function scheduleUnitTotal(schedule) {
+  return schedule.reduce((sum, row2) => sum + row2.amount, 0);
+}
+
 // ../core-cadence/src/labels.ts
 var NAMED_NOUN = {
   weekly: "week",
@@ -558,7 +563,12 @@ function cadenceNoun(cadence) {
   }
   return cadence.interval;
 }
-function recurringTermsLabel(terms, each) {
+function recurringTermsLabel(terms, price, money) {
+  const quantity = price.quantity ?? 1;
+  if (terms.schedule && terms.schedule.length > 0) {
+    return `${money(scheduleUnitTotal(terms.schedule) * quantity)} total \xB7 ${terms.schedule.length} payments`;
+  }
+  const each = money(price.unitPrice * quantity);
   const noun = cadenceNoun(terms);
   const trialDays = terms.trialDays ?? 0;
   if (trialDays > 0) return `Free for ${trialDays} day${trialDays === 1 ? "" : "s"}, then ${each} / ${noun}`;
@@ -647,7 +657,7 @@ function QuoteView({ token, options, onCheckout, loadingFallback, className }) {
             item.description ? /* @__PURE__ */ jsx("div", { style: muted, children: item.description }) : null,
             item.recurring ? /* @__PURE__ */ jsxs("div", { style: muted, children: [
               "Subscription \xB7 ",
-              recurringTermsLabel(item.recurring, formatMoney(item.unitPrice * state.quantity, currency))
+              recurringTermsLabel(item.recurring, { unitPrice: item.unitPrice, quantity: state.quantity }, (m) => formatMoney(m, currency))
             ] }) : null
           ] }),
           /* @__PURE__ */ jsx("td", { align: "right", children: formatMoney(item.unitPrice, currency) }),
@@ -677,7 +687,7 @@ function QuoteView({ token, options, onCheckout, loadingFallback, className }) {
         recurringKept.map((i) => /* @__PURE__ */ jsxs("p", { style: muted, children: [
           i.name,
           ": ",
-          recurringTermsLabel(i.recurring, formatMoney(i.unitPrice * (q.selections[i.id]?.quantity ?? i.quantity), currency))
+          recurringTermsLabel(i.recurring, { unitPrice: i.unitPrice, quantity: q.selections[i.id]?.quantity ?? i.quantity }, (m) => formatMoney(m, currency))
         ] }, i.id))
       ] }) : null,
       /* @__PURE__ */ jsx("p", { style: muted, children: termsLabel(rev.paymentTerms, rev.depositAmount, currency) }),
@@ -842,6 +852,12 @@ function QuoteRequestForm({
     companyName: "",
     phone: "",
     buyerReference: "",
+    addressLine1: "",
+    addressLine2: "",
+    city: "",
+    stateProvince: "",
+    postalCode: "",
+    countryCode: "",
     message: "",
     website: ""
     // honeypot
@@ -871,6 +887,16 @@ function QuoteRequestForm({
           companyName: fields.companyName ? values.companyName || null : null,
           phone: fields.phone ? values.phone || null : null,
           buyerReference: fields.buyerReference ? values.buyerReference || null : null,
+          ...fields.shippingAddress ? {
+            shippingAddress: {
+              addressLine1: values.addressLine1 || null,
+              addressLine2: values.addressLine2 || null,
+              city: values.city || null,
+              stateProvince: values.stateProvince || null,
+              postalCode: values.postalCode || null,
+              countryCode: values.countryCode || null
+            }
+          } : {},
           website: values.website || null,
           ...turnstileToken ? { turnstileToken } : {}
         }).then(() => onSubmitted?.()).catch(() => {
@@ -896,6 +922,33 @@ function QuoteRequestForm({
           "Phone",
           /* @__PURE__ */ jsx2("input", { value: values.phone, onChange: set("phone") })
         ] }) : null,
+        fields.shippingAddress ? /* @__PURE__ */ jsxs2("fieldset", { children: [
+          /* @__PURE__ */ jsx2("legend", { children: "Shipping address (optional)" }),
+          /* @__PURE__ */ jsxs2("label", { children: [
+            "Address line 1",
+            /* @__PURE__ */ jsx2("input", { value: values.addressLine1, onChange: set("addressLine1") })
+          ] }),
+          /* @__PURE__ */ jsxs2("label", { children: [
+            "Address line 2",
+            /* @__PURE__ */ jsx2("input", { value: values.addressLine2, onChange: set("addressLine2") })
+          ] }),
+          /* @__PURE__ */ jsxs2("label", { children: [
+            "City",
+            /* @__PURE__ */ jsx2("input", { value: values.city, onChange: set("city") })
+          ] }),
+          /* @__PURE__ */ jsxs2("label", { children: [
+            "State / province",
+            /* @__PURE__ */ jsx2("input", { value: values.stateProvince, onChange: set("stateProvince") })
+          ] }),
+          /* @__PURE__ */ jsxs2("label", { children: [
+            "Postal code",
+            /* @__PURE__ */ jsx2("input", { value: values.postalCode, onChange: set("postalCode") })
+          ] }),
+          /* @__PURE__ */ jsxs2("label", { children: [
+            "Country code (e.g. US)",
+            /* @__PURE__ */ jsx2("input", { value: values.countryCode, onChange: set("countryCode"), maxLength: 2 })
+          ] })
+        ] }) : null,
         fields.buyerReference ? /* @__PURE__ */ jsxs2("label", { children: [
           "Your reference #",
           /* @__PURE__ */ jsx2("input", { value: values.buyerReference, onChange: set("buyerReference") })