cope-sdk 0.1.0 → 0.1.1

package/dist/mcp.js

@@ -180,7 +180,7 @@ var CHECKOUT_MOUNT_MAX_ATTEMPTS = 20;
 var CHECKOUT_READY_TIMEOUT_MS = 8e3;
 var SUPPORTED_ONE_CLICK_CHARGE_TERMS_VERSIONS = /* @__PURE__ */ new Set(["oto-v1"]);
 function seg(id) {
-  return encodeURIComponent(id);
+  return encodeURIComponent(String(id));
 }
 function isRecord2(value) {
   return typeof value === "object" && value !== null;
@@ -212,10 +212,28 @@ function parseErrorBody(body) {
 function isApiErrorEntry(value) {
   return isRecord2(value) && typeof value.code === "string" && typeof value.message === "string";
 }
+var MONTHS = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
+var ASCTIME = /^[A-Z][a-z]{2} ([A-Z][a-z]{2}) ([ \d]\d) (\d{2}):(\d{2}):(\d{2}) (\d{4})$/;
+function asctimeToUtc([, monthName, day, hh, mm, ss, year]) {
+  const fields = [Number(year), MONTHS.indexOf(monthName ?? ""), Number((day ?? "").trim()), Number(hh), Number(mm), Number(ss)];
+  const at = Date.UTC(fields[0], fields[1], fields[2], fields[3], fields[4], fields[5]);
+  const back = new Date(at);
+  const roundTrip = [
+    back.getUTCFullYear(),
+    back.getUTCMonth(),
+    back.getUTCDate(),
+    back.getUTCHours(),
+    back.getUTCMinutes(),
+    back.getUTCSeconds()
+  ];
+  return roundTrip.every((value, i) => value === fields[i]) ? at : Number.NaN;
+}
 function parseRetryAfter(value) {
-  if (value === null || value.trim() === "") return null;
-  if (/^\d+$/.test(value.trim())) return Number(value.trim());
-  const at = Date.parse(value);
+  if (value === null) return null;
+  const trimmed = value.trim();
+  if (/^\d+$/.test(trimmed)) return Number(trimmed);
+  const asctime = ASCTIME.exec(trimmed);
+  const at = asctime ? asctimeToUtc(asctime) : / GMT$/.test(trimmed) ? Date.parse(trimmed) : Number.NaN;
   return Number.isNaN(at) ? null : Math.max(0, Math.ceil((at - Date.now()) / 1e3));
 }
 function bodyRequestId(body) {
@@ -386,7 +404,7 @@ function parseCheckoutEmbedEvent(data) {
   }
   return null;
 }
-var CopeCart = class {
+var Cope = class {
   publishableKey;
   baseUrl;
   checkoutBaseUrl;
@@ -404,7 +422,7 @@ var CopeCart = class {
       throw new CopeError('Invalid publishableKey. Must start with "cope_pk_".');
     }
     if (typeof window !== "undefined" && window.location?.protocol === "http:" && window.location.hostname !== "localhost") {
-      throw new CopeError("CopeCart SDK requires HTTPS. Refusing to operate on an insecure page.");
+      throw new CopeError("COPE SDK requires HTTPS. Refusing to operate on an insecure page.");
     }
     this.publishableKey = options.publishableKey;
     const baseOrigin = originOnly(options.baseUrl ?? DEFAULT_BASE_URL);
@@ -442,9 +460,11 @@ var CopeCart = class {
   async addLine(cartId, payload) {
     return normalizeCart(await this.post(`/carts/${seg(cartId)}/lines`, payload));
   }
+  /** `lineId` is the line's `id`, an integer; a string of its digits is accepted too. */
   async updateLine(cartId, lineId2, payload) {
     return normalizeCart(await this.patch(`/carts/${seg(cartId)}/lines/${seg(lineId2)}`, payload));
   }
+  /** `lineId` is the line's `id`, an integer; a string of its digits is accepted too. */
   async removeLine(cartId, lineId2) {
     return normalizeCart(await this.del(`/carts/${seg(cartId)}/lines/${seg(lineId2)}`));
   }
@@ -476,6 +496,7 @@ var CopeCart = class {
       ...input.attribution ? { attribution: input.attribution } : {},
       ...input.intendedPaymentMethod != null ? { intended_payment_method: input.intendedPaymentMethod } : {},
       ...input.metadata ? { metadata: input.metadata } : {},
+      ...input.collectBuyerIdentityAtCheckout != null ? { collect_buyer_identity_at_checkout: input.collectBuyerIdentityAtCheckout } : {},
       lines: lines.map((line) => ({
         product_id: line.productId,
         ...line.planId !== void 0 ? { plan_id: line.planId } : {},
@@ -499,7 +520,8 @@ var CopeCart = class {
       status: checkout.status,
       expiresAt: checkout.expiresAt,
       totals: checkout.totals,
-      ...input.intendedPaymentMethod != null ? { intendedPaymentMethod: input.intendedPaymentMethod } : {}
+      ...input.intendedPaymentMethod != null ? { intendedPaymentMethod: input.intendedPaymentMethod } : {},
+      ...raw.field_errors?.length ? { fieldErrors: raw.field_errors } : {}
     };
   }
   async cancelCheckout(checkoutId) {
@@ -982,15 +1004,20 @@ function projectLine(line) {
     unitPriceMinorUnits: line.price_snapshot?.unit_price_minor_units ?? null
   };
 }
-function projectCheckout(checkout) {
+function projectCheckout(checkout, lines) {
   return {
     checkoutUrl: checkout.checkoutUrl,
     status: checkout.status,
     expiresAt: checkout.expiresAt,
     totalMinorUnits: checkout.totals.total_minor_units,
-    currency: checkout.totals.currency
+    currency: checkout.totals.currency,
+    buyerNext: buyerNextFor(lines)
   };
 }
+function buyerNextFor(lines) {
+  const waiver = lines.some((line) => line.requires_shipping === false) ? ", waive their right of withdrawal (a product in this cart does not ship)" : lines.some((line) => line.requires_shipping === void 0) ? ", waive their right of withdrawal if a product in the cart does not ship" : "";
+  return `Send the buyer to checkoutUrl. There they accept the terms${waiver}, and pay. You cannot do any of these for them.`;
+}
 var GUIDANCE = {
   invalid_cart_ref: "The cartRef is not valid here. Start again with create_cart.",
   cart_expired: "This cart is finished: ordered (the buyer has paid), expired or abandoned. For a new purchase, start again with create_cart.",
@@ -1004,6 +1031,7 @@ var GUIDANCE = {
   offer_sourced_no_promo: "This cart comes from a negotiated offer; promo codes do not apply.",
   checkout_expired: "The checkout expired. Call start_checkout again.",
   tax_address_invalid: "The buyer address is incomplete or invalid for tax. Ask the buyer and call set_buyer_identity.",
+  missing_tax_location: "Totals need the buyer's country and postal code. Ask the buyer and call set_buyer_identity, then get_cart.",
   tax_service_unavailable: "Tax could not be calculated right now. Retry shortly.",
   business_checkout_hold: "This store cannot take orders right now. Tell the buyer to try later.",
   rate_limited: "Too many requests. Wait retryAfter seconds, then retry.",
@@ -1054,7 +1082,7 @@ var CONFLICT_WAITS_MS = [500, 1e3, 2e3];
 var cartRef = z.string().min(1).max(2048).describe("The cartRef returned by create_cart. Pass it back unchanged.");
 var ID = /^[A-Za-z0-9_-]{1,100}$/;
 var productId = z.string().regex(ID).describe("The product id, e.g. from the store page");
-var lineId = z.string().regex(ID).describe("A lineId from the cart");
+var lineId = z.union([z.number().int().positive(), z.string().regex(/^\d{1,19}$/)]).describe("A lineId from the cart, as get_cart returned it");
 var address = z.object({
   line1: z.string(),
   line2: z.string().optional(),
@@ -1071,10 +1099,10 @@ function registerCheckoutTools(server, ctx) {
       return refusal(error) ?? fail(error);
     }
   };
-  const newClient = () => new CopeCart({ ...ctx.clientOptions, persistence: "none" });
+  const newClient = () => new Cope({ ...ctx.clientOptions, persistence: "none" });
   const openCart = async (ref) => {
     const creds = await ctx.codec.decode(ref);
-    return { creds, cope: new CopeCart({ ...ctx.clientOptions, cart: creds }) };
+    return { creds, cope: new Cope({ ...ctx.clientOptions, cart: creds }) };
   };
   server.registerTool("get_product", {
     description: "Look up a product the store sells: name, plans and prices. Prices are in minor units (cents).",
@@ -1101,8 +1129,14 @@ function registerCheckoutTools(server, ctx) {
     try {
       return { cart: projectCart(await cope.reprice(creds.id)) };
     } catch (error) {
-      if (!hasCode(error, "cart_not_repriceable")) throw error;
-      return { cart: projectCart(await cope.getCart(creds.id)) };
+      if (hasCode(error, "cart_not_repriceable")) return { cart: projectCart(await cope.getCart(creds.id)) };
+      if (hasCode(error, "missing_tax_location")) {
+        return {
+          cart: projectCart(await cope.getCart(creds.id)),
+          totalsPending: "Totals need the buyer's country and postal code. Call set_buyer_identity when the buyer gives them."
+        };
+      }
+      throw error;
     }
   }));
   server.registerTool("add_line", {
@@ -1215,17 +1249,19 @@ function registerCheckoutTools(server, ctx) {
     return { cart: projectCart(cart) };
   }));
   server.registerTool("start_checkout", {
-    description: "Create the checkout and return the URL where the buyer reviews, accepts the terms and pays. Calling it again returns the same checkout while it is open.",
+    description: "Create the checkout and return the URL where the buyer reviews, gives the consents the cart needs and pays; buyerNext in the result says which. Calling it again returns the same checkout while it is open.",
     inputSchema: z.object({ cartRef }),
     annotations: { idempotentHint: true }
   }, ({ cartRef: ref }) => run(async () => {
     const { creds, cope } = await openCart(ref);
     const payload = { success_url: ctx.checkout.successUrl, cancel_url: ctx.checkout.cancelUrl, consents: [] };
-    return projectCheckout(await startCheckout(cope, creds, payload));
+    const { checkout, cart } = await startCheckout(cope, creds, payload);
+    return projectCheckout(checkout, cart.lines);
   }));
 }
 async function startCheckout(cope, creds, payload) {
-  const inCheckout = (await cope.getCart(creds.id)).state === "checkout_in_progress";
+  const cart = await cope.getCart(creds.id);
+  const inCheckout = cart.state === "checkout_in_progress";
   let open = null;
   for (let n = 0; n < MAX_CHECKOUT_KEYS; n++) {
     let result;
@@ -1241,9 +1277,9 @@ async function startCheckout(cope, creds, payload) {
       if (Date.parse(result.expiresAt) > Date.now()) open = result;
       continue;
     }
-    if ((await cope.getCart(creds.id)).state !== "active") return result;
+    if ((await cope.getCart(creds.id)).state !== "active") return { checkout: result, cart };
   }
-  if (open) return open;
+  if (open) return { checkout: open, cart };
   if (inCheckout) {
     throw new CopeApiError(409, [{ code: "checkout_not_recoverable", message: "The open checkout expired or cannot be recovered" }]);
   }
@@ -1265,8 +1301,11 @@ function hasCode(error, code) {
   return error instanceof CopeApiError && error.code === code;
 }
 
+// package.json
+var version = "0.1.1";
+
 // src/mcp/handler.ts
-var SERVER_INFO = { name: "cope-checkout", version: "0.1.0" };
+var SERVER_INFO = { name: "cope-checkout", version };
 function createCopeMcpHandler(options) {
   if (options.allowedHosts.length === 0) throw new Error("allowedHosts must name at least one host");
   parseCartRefKeys(options.cartRefKeys);