hookwright 1.7.0 → 1.8.0

package/dist/cli.js

@@ -24,7 +24,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "hookwright",
-      version: "1.7.0",
+      version: "1.8.0",
       description: "Build real, signed e-commerce webhooks from a live Shopify catalogue \u2014 interactive terminal UI, no backend",
       keywords: [
         "webhook",
@@ -163,6 +163,9 @@ var DEFAULT_CONFIG = {
   shopify: {
     domain: "",
     accessToken: "",
+    // Storefront API token. Creating a checkout needs one: the admin checkout API
+    // was removed, so a fresh checkout can only be minted through the storefront.
+    storefrontAccessToken: "",
     apiVersion: "2024-10",
     // cached from the last successful connection, for display only
     shop: null
@@ -2493,6 +2496,33 @@ var ShopifyClient = class {
     const { json } = await this.request("/checkouts.json", { query: { limit } });
     return json?.checkouts ?? [];
   }
+  /**
+   * Creates a real checkout through the storefront API and returns its recovery
+   * link. The admin checkout API was removed, so this is the only way to mint a
+   * new one; it needs a storefront token, which is separate from the admin one.
+   */
+  async createCheckout({ storefrontAccessToken, lineItems, email }) {
+    if (!storefrontAccessToken) throw new ShopifyError("Storefront access token missing", { hint: "run `hookwright configure` and add it, or the checkout event reuses an existing checkout" });
+    const mutation = `mutation checkoutCreate($input: CheckoutCreateInput!) {
+      checkoutCreate(input: $input) {
+        checkout { id webUrl totalPrice { amount currencyCode } }
+        checkoutUserErrors { field message }
+      }
+    }`;
+    const input = { lineItems: lineItems.map(({ variantId, quantity }) => ({ variantId: `gid://shopify/ProductVariant/${variantId}`, quantity })) };
+    if (email) input.email = email;
+    const res = await fetch(`https://${this.domain}/api/2024-01/graphql.json`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Shopify-Storefront-Access-Token": storefrontAccessToken },
+      body: JSON.stringify({ query: mutation, variables: { input } })
+    });
+    const body = await res.json();
+    const errors = body.errors ?? body.data?.checkoutCreate?.checkoutUserErrors;
+    if (errors?.length) throw new ShopifyError(`Shopify rejected the checkout: ${errors.map((e) => e.message).join("; ")}`, { hint: "the storefront token needs unauthenticated_write_checkouts" });
+    const checkout = body.data?.checkoutCreate?.checkout;
+    if (!checkout) throw new ShopifyError("Shopify returned no checkout", { hint: "check the storefront token and api version" });
+    return checkout;
+  }
   /** Orders, newest first. */
   async orders({ limit = 10, status = "any" } = {}) {
     const { json } = await this.request("/orders.json", { query: { limit, status } });
@@ -2991,6 +3021,19 @@ function clientFor(config) {
   });
 }
 async function liveCheckout({ config, items = [], client = clientFor(config) }) {
+  const storefrontAccessToken = config.shopify?.storefrontAccessToken;
+  const lineItems = items.map(({ variant, product, quantity }) => ({ variantId: Number(variant?.id ?? product?.id), quantity: Number(quantity) || 1 })).filter((l) => Number.isFinite(l.variantId) && l.variantId > 0);
+  if (storefrontAccessToken && lineItems.length) {
+    const checkout2 = await client.createCheckout({ storefrontAccessToken, lineItems, email: config.customer?.email || void 0 });
+    return {
+      kind: "checkout",
+      created: true,
+      url: checkout2.webUrl,
+      cartValue: money2(checkout2.totalPrice?.amount ?? 0).toFixed(2),
+      cartToken: /\/checkouts\/([^/?]+)/.exec(checkout2.webUrl ?? "")?.[1],
+      lineItems: []
+    };
+  }
   const checkouts = await client.abandonedCheckouts({ limit: 20 });
   if (checkouts.length === 0) return null;
   const wanted = new Set(items.map(({ variant }) => Number(variant?.id)).filter(Boolean));
@@ -2998,6 +3041,7 @@ async function liveCheckout({ config, items = [], client = clientFor(config) })
   const checkout = matching ?? checkouts[0];
   return {
     kind: "checkout",
+    created: false,
     url: checkout.abandoned_checkout_url,
     cartValue: money2(checkout.total_price ?? 0).toFixed(2),
     cartToken: checkout.cart_token,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hookwright",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "Build real, signed e-commerce webhooks from a live Shopify catalogue — interactive terminal UI, no backend",
   "keywords": [
     "webhook",