@cobrastyle/adapter-magento2 1.1.0 → 1.2.0

package/dist/adapter.js

@@ -232,6 +232,16 @@ export const magento2Adapter = {
                 return mapCartWithUrls(data.cart);
             }
             catch (error) {
+                // An ownership refusal means the id is unusable for this session (e.g. a
+                // guest cart id left in the cookie after login). Reporting it as `null`
+                // would render an empty cart while the quote still exists and leave the bad
+                // id in place, so let it propagate; callers can drop the id and start over.
+                if (error instanceof Error &&
+                    error.message.toLowerCase().includes('cannot perform operations on cart')) {
+                    throw error;
+                }
+                // Anything else (missing cart, transport failure) stays soft: the cart is
+                // simply unavailable and the page must still render.
                 return null;
             }
         },

package/dist/client.js

@@ -254,10 +254,15 @@ export async function graphqlFetch(query, variables, options = {}) {
                     }
                 }
                 logger.error(operationName, new Error(`HTTP ${response.status}: ${text}`), duration);
+                // Carry the backend's reason, not just the status: callers need it to tell
+                // an expired cart from an ownership problem, and without it a failure can
+                // only be diagnosed by reproducing the request by hand.
+                const reason = extractErrorReason(text);
+                const detail = reason ? `: ${reason}` : '';
                 if (response.status === 401) {
-                    throw new GraphQLAuthError(`GraphQL request failed: 401 ${response.statusText} [${requestId}]`);
+                    throw new GraphQLAuthError(`GraphQL request failed: 401 ${response.statusText}${detail} [${requestId}]`.replace(/ +/g, ' '));
                 }
-                throw new Error(`GraphQL request failed: ${response.status} ${response.statusText} [${requestId}]`);
+                throw new Error(`GraphQL request failed: ${response.status} ${response.statusText}${detail} [${requestId}]`.replace(/ +/g, ' '));
             }
             const text = await response.text();
             // Check if response is HTML (likely an error page)
@@ -324,6 +329,26 @@ export async function graphqlFetch(query, variables, options = {}) {
         ? lastError
         : new Error(`GraphQL request failed after ${maxAttempts} attempts for ${operationName} [${requestId}]`);
 }
+/**
+ * Pull a human-readable reason out of a non-2xx response body: the first GraphQL
+ * error message when the body is a GraphQL envelope, otherwise a trimmed excerpt
+ * of whatever the server sent (proxy errors, HTML pages, empty bodies).
+ */
+function extractErrorReason(body) {
+    const text = body?.trim();
+    if (!text)
+        return undefined;
+    try {
+        const parsed = JSON.parse(text);
+        const message = parsed.errors?.find((e) => e?.message)?.message;
+        if (message)
+            return message;
+    }
+    catch {
+        // Not JSON — fall through to the excerpt.
+    }
+    return text.slice(0, 200);
+}
 /** Sleep helper for retry backoff. */
 function delay(ms) {
     return ms > 0 ? new Promise((resolve) => setTimeout(resolve, ms)) : Promise.resolve();

package/dist/config.d.ts

@@ -42,6 +42,9 @@ export interface MagentoConfig extends AdapterConfig {
      */
     storeResolver?: () => string | undefined;
 }
+export declare const isConfigured: () => boolean;
+/** Warn once per process that the client is running on defaults only. */
+export declare function warnIfUnconfigured(context: string): void;
 export declare const getConfig: () => MagentoConfig;
 export declare const setConfig: (newConfig: Partial<MagentoConfig>) => void;
 export declare const createConfig: (overrides?: Partial<MagentoConfig>) => MagentoConfig;

package/dist/config.js

@@ -1,5 +1,8 @@
 let config = {
-    baseUrl: process.env.MAGENTO_URL || 'https://magento.example.com/graphql',
+    // Deliberately empty rather than a placeholder host: an unset MAGENTO_URL is a
+    // configuration error, and pointing it at a domain nobody owns turns that into
+    // confusing request failures instead.
+    baseUrl: process.env.MAGENTO_URL || '',
     storeCode: process.env.MAGENTO_STORE || 'default',
     skipSsl: process.env.SKIP_SSL === 'true',
     allowInsecure: process.env.ALLOW_INSECURE === 'true',
@@ -7,9 +10,32 @@ let config = {
     // If not set, will be fetched dynamically from storeConfig
     rootCategoryId: process.env.MAGENTO_ROOT_CATEGORY_ID ? parseInt(process.env.MAGENTO_ROOT_CATEGORY_ID, 10) : undefined,
 };
+/**
+ * Whether the consuming app has supplied its configuration yet.
+ *
+ * The env-derived defaults above make an *unconfigured* client look usable, but
+ * the injected callbacks — `customerTokenGetter`, `tokenRefresher`,
+ * `storeResolver` — have no defaults. Requests then go out unauthenticated and
+ * without per-request store resolution, which surfaces far downstream as an
+ * authorization error on customer-owned data. Consumers of the exported client
+ * (`graphqlFetch`, `withCustomerAuth`) need to be told.
+ */
+let configured = false;
+let warnedUnconfigured = false;
+export const isConfigured = () => configured;
+/** Warn once per process that the client is running on defaults only. */
+export function warnIfUnconfigured(context) {
+    if (configured || warnedUnconfigured)
+        return;
+    warnedUnconfigured = true;
+    console.warn(`[magento2] ${context} before setConfig() ran: requests will be sent unauthenticated ` +
+        'and without per-request store resolution. Call setConfig() (or load the adapter ' +
+        'through configureStorefront/getAdapter) before using the exported GraphQL client.');
+}
 export const getConfig = () => config;
 export const setConfig = (newConfig) => {
     config = { ...config, ...newConfig };
+    configured = true;
 };
 export const createConfig = (overrides = {}) => ({
     ...config,
@@ -20,6 +46,7 @@ export const createConfig = (overrides = {}) => ({
  * Merges with any extra options passed in.
  */
 export async function withCustomerAuth(extra = {}) {
+    warnIfUnconfigured('withCustomerAuth() was called');
     const token = await config.customerTokenGetter?.();
     if (token) {
         return { ...extra, customerToken: token };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { magento2Adapter, magento2Adapter as default } from './adapter';
-export { getConfig, setConfig, createConfig, withCustomerAuth } from './config';
+export { getConfig, setConfig, createConfig, withCustomerAuth, isConfigured } from './config';
 export type { MagentoConfig } from './config';
 export { graphqlFetch, GraphQLAuthError } from './client';
 export { logger, MagentoLogger } from './logger';

package/dist/index.js

@@ -1,5 +1,5 @@
 export { magento2Adapter, magento2Adapter as default } from './adapter';
-export { getConfig, setConfig, createConfig, withCustomerAuth } from './config';
+export { getConfig, setConfig, createConfig, withCustomerAuth, isConfigured } from './config';
 export { graphqlFetch, GraphQLAuthError } from './client';
 export { logger, MagentoLogger } from './logger';
 export * as queries from './queries';

package/dist/queries.d.ts

@@ -1,5 +1,5 @@
 export declare const GET_PRODUCT_BY_URL_KEY = "\n  query GetProductByUrlKey($urlKey: String!) {\n    products(filter: { url_key: { eq: $urlKey } }) {\n      items {\n        __typename\n        id\n        sku\n        name\n        url_key\n        description { html }\n        short_description { html }\n        meta_title\n        meta_description\n        stock_status\n        price_range {\n          minimum_price {\n            regular_price { value currency }\n            final_price { value currency }\n            discount { amount_off percent_off }\n          }\n          maximum_price {\n            final_price { value currency }\n          }\n        }\n        price_tiers {\n          quantity\n          final_price { value currency }\n          discount { amount_off percent_off }\n        }\n        media_gallery {\n          url\n          label\n          position\n        }\n        categories {\n          id\n          name\n          url_key\n          breadcrumbs {\n            category_url_key\n            category_level\n          }\n        }\n        custom_attributesV2(filters: { is_visible_on_front: true }) {\n          items {\n            code\n            __typename\n            ... on AttributeValue {\n              value\n            }\n            ... on AttributeSelectedOptions {\n              selected_options {\n                label\n                value\n              }\n            }\n          }\n          errors {\n            message\n          }\n        }\n        ... on ConfigurableProduct {\n          configurable_options {\n            id\n            attribute_code\n            label\n            values {\n              uid\n              label\n              swatch_data {\n                __typename\n                value\n              }\n            }\n          }\n          variants {\n            product {\n              id\n              sku\n              name\n              stock_status\n              price_range {\n                minimum_price {\n                  regular_price { value currency }\n                  final_price { value currency }\n                }\n              }\n            }\n            attributes {\n              code\n              label\n              value_index\n            }\n          }\n        }\n        ... on GroupedProduct {\n          items {\n            qty\n            position\n            product {\n              ... on ProductInterface {\n                __typename\n                id\n                uid\n                sku\n                name\n                url_key\n                stock_status\n                price_range {\n                  minimum_price {\n                    regular_price { value currency }\n                    final_price { value currency }\n                    discount { amount_off percent_off }\n                  }\n                }\n                thumbnail { url label }\n              }\n            }\n          }\n        }\n        ... on BundleProduct {\n          dynamic_price\n          price_view\n          bundleItems: items {\n            uid\n            option_id\n            title\n            type\n            required\n            position\n            options {\n              uid\n              id\n              label\n              quantity\n              can_change_quantity\n              is_default\n              price\n              price_type\n              product {\n                sku\n                price_range { minimum_price { final_price { value currency } } }\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n";
-export declare const GET_PRODUCT_BY_ID = "\n  query GetProductBySku($sku: String!) {\n    products(filter: { sku: { eq: $sku } }) {\n      items {\n        __typename\n        id\n        sku\n        name\n        url_key\n        description { html }\n        short_description { html }\n        meta_title\n        meta_description\n        stock_status\n        price_range {\n          minimum_price {\n            regular_price { value currency }\n            final_price { value currency }\n            discount { amount_off percent_off }\n          }\n          maximum_price {\n            final_price { value currency }\n          }\n        }\n        price_tiers {\n          quantity\n          final_price { value currency }\n          discount { amount_off percent_off }\n        }\n        media_gallery {\n          url\n          label\n          position\n        }\n        categories {\n          id\n          name\n          url_key\n          breadcrumbs {\n            category_url_key\n            category_level\n          }\n        }\n        custom_attributesV2(filters: { is_visible_on_front: true }) {\n          items {\n            code\n            __typename\n            ... on AttributeValue {\n              value\n            }\n            ... on AttributeSelectedOptions {\n              selected_options {\n                label\n                value\n              }\n            }\n          }\n          errors {\n            message\n          }\n        }\n        ... on BundleProduct {\n          dynamic_price\n          price_view\n          bundleItems: items {\n            uid\n            option_id\n            title\n            type\n            required\n            position\n            options {\n              uid\n              id\n              label\n              quantity\n              can_change_quantity\n              is_default\n              price\n              price_type\n              product {\n                sku\n                price_range { minimum_price { final_price { value currency } } }\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n";
+export declare const GET_PRODUCT_BY_ID = "\n  query GetProductBySku($sku: String!) {\n    products(filter: { sku: { eq: $sku } }) {\n      items {\n        __typename\n        id\n        sku\n        name\n        url_key\n        description { html }\n        short_description { html }\n        meta_title\n        meta_description\n        stock_status\n        price_range {\n          minimum_price {\n            regular_price { value currency }\n            final_price { value currency }\n            discount { amount_off percent_off }\n          }\n          maximum_price {\n            final_price { value currency }\n          }\n        }\n        price_tiers {\n          quantity\n          final_price { value currency }\n          discount { amount_off percent_off }\n        }\n        media_gallery {\n          url\n          label\n          position\n        }\n        categories {\n          id\n          name\n          url_key\n          breadcrumbs {\n            category_url_key\n            category_level\n          }\n        }\n        custom_attributesV2(filters: { is_visible_on_front: true }) {\n          items {\n            code\n            __typename\n            ... on AttributeValue {\n              value\n            }\n            ... on AttributeSelectedOptions {\n              selected_options {\n                label\n                value\n              }\n            }\n          }\n          errors {\n            message\n          }\n        }\n        ... on ConfigurableProduct {\n          configurable_options {\n            id\n            attribute_code\n            label\n            values {\n              uid\n              label\n              swatch_data {\n                __typename\n                value\n              }\n            }\n          }\n          variants {\n            product {\n              id\n              sku\n              name\n              stock_status\n              price_range {\n                minimum_price {\n                  regular_price { value currency }\n                  final_price { value currency }\n                }\n              }\n            }\n            attributes {\n              code\n              label\n              value_index\n            }\n          }\n        }\n        ... on GroupedProduct {\n          items {\n            qty\n            position\n            product {\n              ... on ProductInterface {\n                __typename\n                id\n                uid\n                sku\n                name\n                url_key\n                stock_status\n                price_range {\n                  minimum_price {\n                    regular_price { value currency }\n                    final_price { value currency }\n                    discount { amount_off percent_off }\n                  }\n                }\n                thumbnail { url label }\n              }\n            }\n          }\n        }\n        ... on BundleProduct {\n          dynamic_price\n          price_view\n          bundleItems: items {\n            uid\n            option_id\n            title\n            type\n            required\n            position\n            options {\n              uid\n              id\n              label\n              quantity\n              can_change_quantity\n              is_default\n              price\n              price_type\n              product {\n                sku\n                price_range { minimum_price { final_price { value currency } } }\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n";
 export declare const GET_PRODUCT_ATTRIBUTE_LABELS = "\n  query GetProductAttributeLabels {\n    attributesList(entityType: CATALOG_PRODUCT, filters: { is_visible_on_front: true }) {\n      items {\n        code\n        label\n      }\n      errors {\n        message\n      }\n    }\n  }\n";
 export declare const GET_CATEGORY_BY_URL_KEY = "\n  query GetCategoryByUrlKey($urlKey: String!) {\n    categoryList(filters: { url_path: { eq: $urlKey } }) {\n      id\n      uid\n      name\n      url_key\n      url_path\n      description\n      image\n      meta_title\n      meta_description\n      product_count\n      breadcrumbs {\n        category_id\n        category_uid\n        category_name\n        category_url_key\n        category_url_path\n        category_level\n      }\n      children {\n        id\n        uid\n        name\n        url_key\n        url_path\n        product_count\n      }\n    }\n  }\n";
 export declare const GET_CATEGORY_BY_URL_KEY_SINGLE = "\n  query GetCategoryByUrlKeySingle($urlKey: String!) {\n    categoryList(filters: { url_key: { eq: $urlKey } }) {\n      id\n      uid\n      name\n      url_key\n      url_path\n      description\n      image\n      meta_title\n      meta_description\n      product_count\n      breadcrumbs {\n        category_id\n        category_uid\n        category_name\n        category_url_key\n        category_url_path\n        category_level\n      }\n      children {\n        id\n        uid\n        name\n        url_key\n        url_path\n        product_count\n      }\n    }\n  }\n";

package/dist/queries.js

@@ -210,6 +210,65 @@ export const GET_PRODUCT_BY_ID = `
             message
           }
         }
+        ... on ConfigurableProduct {
+          configurable_options {
+            id
+            attribute_code
+            label
+            values {
+              uid
+              label
+              swatch_data {
+                __typename
+                value
+              }
+            }
+          }
+          variants {
+            product {
+              id
+              sku
+              name
+              stock_status
+              price_range {
+                minimum_price {
+                  regular_price { value currency }
+                  final_price { value currency }
+                }
+              }
+            }
+            attributes {
+              code
+              label
+              value_index
+            }
+          }
+        }
+        ... on GroupedProduct {
+          items {
+            qty
+            position
+            product {
+              ... on ProductInterface {
+                __typename
+                id
+                uid
+                sku
+                name
+                url_key
+                stock_status
+                price_range {
+                  minimum_price {
+                    regular_price { value currency }
+                    final_price { value currency }
+                    discount { amount_off percent_off }
+                  }
+                }
+                thumbnail { url label }
+              }
+            }
+          }
+        }
         ... on BundleProduct {
           dynamic_price
           price_view

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cobrastyle/adapter-magento2",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {