@doswiftly/storefront-sdk 4.0.0

package/dist/core/index.js

@@ -0,0 +1,68 @@
+/**
+ * @doswiftly/storefront-sdk — Core (framework-agnostic)
+ *
+ * 100% framework-agnostic, 0 runtime dependencies.
+ * Works in Node.js, Edge Workers, Deno, Bun, CLI scripts — without React.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   createStorefrontClient,
+ *   authMiddleware,
+ *   currencyMiddleware,
+ *   retryMiddleware,
+ *   timeoutMiddleware,
+ *   errorMiddleware,
+ *   CartClient,
+ *   AuthClient,
+ * } from '@doswiftly/storefront-sdk';
+ *
+ * const client = createStorefrontClient({
+ *   apiUrl: 'https://api.doswiftly.pl',
+ *   shopSlug: 'my-shop',
+ *   middleware: [
+ *     authMiddleware(() => getToken()),
+ *     currencyMiddleware(() => getCurrency()),
+ *     retryMiddleware({ maxRetries: 2 }),
+ *     timeoutMiddleware({ timeout: 5000 }),
+ *     errorMiddleware(),
+ *   ],
+ * });
+ *
+ * const cartClient = new CartClient(client);
+ * const cart = await cartClient.create();
+ * ```
+ */
+// Client factory
+export { createStorefrontClient } from './client/create-client';
+// Middleware
+export { authMiddleware } from './middleware/auth';
+export { currencyMiddleware } from './middleware/currency';
+export { retryMiddleware } from './middleware/retry';
+export { timeoutMiddleware } from './middleware/timeout';
+export { errorMiddleware } from './middleware/errors';
+// Errors
+export { StorefrontError, ErrorCodes } from './errors';
+// Cache strategies
+export { cacheNone, cacheShort, cacheLong, cachePrivate, cacheCustom, generateCacheControlHeader, } from './cache';
+// Cart client
+export { CartClient } from './cart/cart-client';
+// Auth client
+export { AuthClient } from './auth/auth-client';
+// Helpers
+export { assertNoUserErrors } from './helpers/assert-no-user-errors';
+export { sanitizeHtml } from './helpers/sanitize-html';
+export { normalizeConnection, } from './helpers/normalize-connection';
+// Format utilities
+export { formatPrice, formatPriceRange, formatAmount, formatDate, formatDateTime, formatNumber, formatPercentage, getCurrencySymbol, CURRENCY_SYMBOLS, CURRENCY_LOCALES, } from './format';
+// Auth cookie config (platform contract)
+export { AUTH_COOKIE_NAME, AUTH_COOKIE_DEFAULTS, } from './auth/cookie-config';
+// Auth route matching
+export { matchesRoute } from './auth/routes';
+// Auth cookie handlers (API route factories)
+export { createSetTokenHandler, createClearTokenHandler } from './auth/handlers';
+// Auth token client (client-side fetch helpers)
+export { createAuthTokenClient } from './auth/token-client';
+// Utilities
+export { getOperationName } from './client/operation-name';
+export { hashQuery } from './client/hash';

package/dist/core/middleware/auth.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Auth middleware — adds Authorization header from token getter.
+ *
+ * Token is resolved lazily (on each request) so it picks up
+ * store changes, token renewals, etc.
+ *
+ * @example
+ * ```typescript
+ * import { authMiddleware } from '@doswiftly/storefront-sdk';
+ *
+ * client.use(authMiddleware(() => authStore.getState().accessToken));
+ * ```
+ */
+import type { Middleware } from '../client/types';
+export declare function authMiddleware(getToken: () => string | null | undefined): Middleware;
+//# sourceMappingURL=auth.d.ts.map

package/dist/core/middleware/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/core/middleware/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,GACxC,UAAU,CAQZ"}

package/dist/core/middleware/auth.js

@@ -0,0 +1,22 @@
+/**
+ * Auth middleware — adds Authorization header from token getter.
+ *
+ * Token is resolved lazily (on each request) so it picks up
+ * store changes, token renewals, etc.
+ *
+ * @example
+ * ```typescript
+ * import { authMiddleware } from '@doswiftly/storefront-sdk';
+ *
+ * client.use(authMiddleware(() => authStore.getState().accessToken));
+ * ```
+ */
+export function authMiddleware(getToken) {
+    return (request, next) => {
+        const token = getToken();
+        if (token) {
+            request.headers['Authorization'] = `Bearer ${token}`;
+        }
+        return next(request);
+    };
+}

package/dist/core/middleware/currency.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Currency middleware — adds X-Preferred-Currency header.
+ *
+ * Currency is resolved lazily so currency switches are reflected immediately.
+ *
+ * @example
+ * ```typescript
+ * import { currencyMiddleware } from '@doswiftly/storefront-sdk';
+ *
+ * client.use(currencyMiddleware(() => currencyStore.getState().currency));
+ * ```
+ */
+import type { Middleware } from '../client/types';
+export declare function currencyMiddleware(getCurrency: () => string | null | undefined): Middleware;
+//# sourceMappingURL=currency.d.ts.map

package/dist/core/middleware/currency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency.d.ts","sourceRoot":"","sources":["../../../src/core/middleware/currency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,GAC3C,UAAU,CAQZ"}

package/dist/core/middleware/currency.js

@@ -0,0 +1,21 @@
+/**
+ * Currency middleware — adds X-Preferred-Currency header.
+ *
+ * Currency is resolved lazily so currency switches are reflected immediately.
+ *
+ * @example
+ * ```typescript
+ * import { currencyMiddleware } from '@doswiftly/storefront-sdk';
+ *
+ * client.use(currencyMiddleware(() => currencyStore.getState().currency));
+ * ```
+ */
+export function currencyMiddleware(getCurrency) {
+    return (request, next) => {
+        const currency = getCurrency();
+        if (currency) {
+            request.headers['X-Preferred-Currency'] = currency;
+        }
+        return next(request);
+    };
+}

package/dist/core/middleware/errors.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Error normalization middleware — ALWAYS LAST in the pipeline.
+ *
+ * Catches all errors from downstream middleware and the transport,
+ * normalizes them into StorefrontError instances.
+ *
+ * Handles:
+ * - Network errors (fetch failures)
+ * - HTTP errors (non-200 responses)
+ * - GraphQL errors (errors array in response)
+ * - Abort/timeout errors
+ * - Missing data in response
+ *
+ * @example
+ * ```typescript
+ * import { errorMiddleware } from '@doswiftly/storefront-sdk';
+ *
+ * // Always add as the LAST middleware
+ * client.use(errorMiddleware());
+ * ```
+ */
+import type { Middleware } from '../client/types';
+export declare function errorMiddleware(): Middleware;
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/middleware/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/core/middleware/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlD,wBAAgB,eAAe,IAAI,UAAU,CA4D5C"}

package/dist/core/middleware/errors.js

@@ -0,0 +1,77 @@
+/**
+ * Error normalization middleware — ALWAYS LAST in the pipeline.
+ *
+ * Catches all errors from downstream middleware and the transport,
+ * normalizes them into StorefrontError instances.
+ *
+ * Handles:
+ * - Network errors (fetch failures)
+ * - HTTP errors (non-200 responses)
+ * - GraphQL errors (errors array in response)
+ * - Abort/timeout errors
+ * - Missing data in response
+ *
+ * @example
+ * ```typescript
+ * import { errorMiddleware } from '@doswiftly/storefront-sdk';
+ *
+ * // Always add as the LAST middleware
+ * client.use(errorMiddleware());
+ * ```
+ */
+import { StorefrontError, ErrorCodes } from '../errors';
+export function errorMiddleware() {
+    return async (request, next) => {
+        let response;
+        try {
+            response = await next(request);
+        }
+        catch (error) {
+            // Already a StorefrontError — re-throw as-is
+            if (error instanceof StorefrontError) {
+                throw error;
+            }
+            // AbortError (timeout handled by timeout middleware, manual abort here)
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new StorefrontError({
+                    code: ErrorCodes.TIMEOUT,
+                    message: 'Request was aborted',
+                    cause: error,
+                });
+            }
+            // Network error (fetch failed — DNS, connection refused, etc.)
+            throw new StorefrontError({
+                code: ErrorCodes.NETWORK_ERROR,
+                message: error instanceof Error ? error.message : 'Network request failed',
+                cause: error,
+            });
+        }
+        // HTTP error (non-2xx response)
+        if (response.status >= 400) {
+            throw new StorefrontError({
+                code: ErrorCodes.HTTP_ERROR,
+                message: `HTTP ${response.status}`,
+                status: response.status,
+                graphqlErrors: response.errors ?? [],
+            });
+        }
+        // GraphQL errors in the response
+        if (response.errors?.length) {
+            throw new StorefrontError({
+                code: ErrorCodes.GRAPHQL_ERROR,
+                message: response.errors[0].message,
+                status: response.status,
+                graphqlErrors: response.errors,
+            });
+        }
+        // No data returned
+        if (response.data === undefined || response.data === null) {
+            throw new StorefrontError({
+                code: ErrorCodes.NO_DATA,
+                message: 'No data returned from GraphQL',
+                status: response.status,
+            });
+        }
+        return response;
+    };
+}

package/dist/core/middleware/retry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Retry middleware — retries on network errors and 5xx responses.
+ *
+ * ONLY retries queries, NEVER mutations (to prevent double-charges, etc.).
+ * Uses exponential backoff with jitter.
+ *
+ * @example
+ * ```typescript
+ * import { retryMiddleware } from '@doswiftly/storefront-sdk';
+ *
+ * client.use(retryMiddleware({ maxRetries: 2 }));
+ * ```
+ */
+import type { Middleware } from '../client/types';
+export interface RetryOptions {
+    /** Maximum number of retries (default: 2) */
+    maxRetries?: number;
+    /** Initial delay in ms (default: 300) */
+    initialDelay?: number;
+}
+export declare function retryMiddleware(options?: RetryOptions): Middleware;
+//# sourceMappingURL=retry.d.ts.map

package/dist/core/middleware/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/core/middleware/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlD,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,YAAiB,GAAG,UAAU,CA4CtE"}

package/dist/core/middleware/retry.js

@@ -0,0 +1,58 @@
+/**
+ * Retry middleware — retries on network errors and 5xx responses.
+ *
+ * ONLY retries queries, NEVER mutations (to prevent double-charges, etc.).
+ * Uses exponential backoff with jitter.
+ *
+ * @example
+ * ```typescript
+ * import { retryMiddleware } from '@doswiftly/storefront-sdk';
+ *
+ * client.use(retryMiddleware({ maxRetries: 2 }));
+ * ```
+ */
+import { StorefrontError, ErrorCodes } from '../errors';
+export function retryMiddleware(options = {}) {
+    const { maxRetries = 2, initialDelay = 300 } = options;
+    return async (request, next) => {
+        // Never retry mutations
+        if (request.isMutation) {
+            return next(request);
+        }
+        let lastError;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            try {
+                const response = await next(request);
+                // Retry on 5xx server errors
+                if (response.status >= 500 && attempt < maxRetries) {
+                    await delay(initialDelay * Math.pow(2, attempt));
+                    continue;
+                }
+                return response;
+            }
+            catch (error) {
+                lastError = error;
+                // Don't retry on non-retriable errors
+                if (error instanceof StorefrontError) {
+                    if (error.code === ErrorCodes.TIMEOUT) {
+                        // Timeouts are retriable
+                    }
+                    else if (error.status >= 400 && error.status < 500) {
+                        // 4xx errors are not retriable
+                        throw error;
+                    }
+                }
+                if (attempt < maxRetries) {
+                    await delay(initialDelay * Math.pow(2, attempt));
+                    continue;
+                }
+            }
+        }
+        throw lastError;
+    };
+}
+function delay(ms) {
+    // Add jitter: ±25%
+    const jitter = ms * 0.25 * (Math.random() * 2 - 1);
+    return new Promise(resolve => setTimeout(resolve, ms + jitter));
+}

package/dist/core/middleware/timeout.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Timeout middleware — aborts request after timeout via AbortController.
+ *
+ * Edge-safe (no Node.js APIs). Default: 5 seconds.
+ *
+ * @example
+ * ```typescript
+ * import { timeoutMiddleware } from '@doswiftly/storefront-sdk';
+ *
+ * client.use(timeoutMiddleware({ timeout: 10000 })); // 10s
+ * ```
+ */
+import type { Middleware } from '../client/types';
+export interface TimeoutOptions {
+    /** Timeout in milliseconds (default: 5000) */
+    timeout?: number;
+}
+export declare function timeoutMiddleware(options?: TimeoutOptions): Middleware;
+//# sourceMappingURL=timeout.d.ts.map

package/dist/core/middleware/timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.d.ts","sourceRoot":"","sources":["../../../src/core/middleware/timeout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlD,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,cAAmB,GAAG,UAAU,CAuC1E"}

package/dist/core/middleware/timeout.js

@@ -0,0 +1,51 @@
+/**
+ * Timeout middleware — aborts request after timeout via AbortController.
+ *
+ * Edge-safe (no Node.js APIs). Default: 5 seconds.
+ *
+ * @example
+ * ```typescript
+ * import { timeoutMiddleware } from '@doswiftly/storefront-sdk';
+ *
+ * client.use(timeoutMiddleware({ timeout: 10000 })); // 10s
+ * ```
+ */
+import { StorefrontError, ErrorCodes } from '../errors';
+export function timeoutMiddleware(options = {}) {
+    const { timeout = 5000 } = options;
+    return async (request, next) => {
+        const controller = new AbortController();
+        // If request already has a signal, link them
+        if (request.signal) {
+            if (request.signal.aborted) {
+                controller.abort(request.signal.reason);
+            }
+            else {
+                request.signal.addEventListener('abort', () => {
+                    controller.abort(request.signal.reason);
+                }, { once: true });
+            }
+        }
+        request.signal = controller.signal;
+        const timer = setTimeout(() => {
+            controller.abort(new Error(`Request timed out after ${timeout}ms`));
+        }, timeout);
+        try {
+            const response = await next(request);
+            return response;
+        }
+        catch (error) {
+            if (controller.signal.aborted) {
+                throw new StorefrontError({
+                    code: ErrorCodes.TIMEOUT,
+                    message: `Request timed out after ${timeout}ms`,
+                    cause: error,
+                });
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    };
+}

package/dist/core/operations/auth.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Auth/Customer GraphQL operations — manual query strings (no codegen).
+ *
+ * These match the backend storefront-graphql schema exactly.
+ */
+export declare const CUSTOMER_LOGIN = "\n  mutation CustomerLogin($input: CustomerAccessTokenCreateInput!) {\n    customerAccessTokenCreate(input: $input) {\n      customerAccessToken { ...CustomerAccessTokenFields }\n      userErrors { ...UserErrorFields }\n    }\n  }\n  \n  fragment CustomerAccessTokenFields on CustomerAccessToken {\n    accessToken\n    expiresAt\n  }\n\n  \n  fragment UserErrorFields on UserError {\n    message\n    field\n    code\n  }\n\n";
+export declare const CUSTOMER_LOGOUT = "\n  mutation CustomerLogout($customerAccessToken: String!) {\n    customerAccessTokenDelete(customerAccessToken: $customerAccessToken) {\n      deletedAccessToken\n      deletedCustomerAccessTokenId\n      userErrors { ...UserErrorFields }\n    }\n  }\n  \n  fragment UserErrorFields on UserError {\n    message\n    field\n    code\n  }\n\n";
+export declare const CUSTOMER_TOKEN_RENEW = "\n  mutation CustomerTokenRenew($customerAccessToken: String!) {\n    customerAccessTokenRenew(customerAccessToken: $customerAccessToken) {\n      customerAccessToken { ...CustomerAccessTokenFields }\n      userErrors { ...UserErrorFields }\n    }\n  }\n  \n  fragment CustomerAccessTokenFields on CustomerAccessToken {\n    accessToken\n    expiresAt\n  }\n\n  \n  fragment UserErrorFields on UserError {\n    message\n    field\n    code\n  }\n\n";
+export declare const CUSTOMER_CREATE = "\n  mutation CustomerCreate($input: CustomerCreateInput!) {\n    customerCreate(input: $input) {\n      customer { ...CustomerFields }\n      customerAccessToken { ...CustomerAccessTokenFields }\n      userErrors { ...UserErrorFields }\n    }\n  }\n  \n  fragment CustomerFields on Customer {\n    id\n    email\n    firstName\n    lastName\n    displayName\n    phone\n    emailVerified\n    emailMarketingState\n    defaultAddress {\n      id\n      address1\n      address2\n      city\n      company\n      country\n      countryCode\n      firstName\n      lastName\n      phone\n      province\n      provinceCode\n      zip\n      isDefault\n    }\n    ordersCount\n    totalSpent {\n      amount\n      currencyCode\n    }\n    createdAt\n    updatedAt\n  }\n\n  \n  fragment CustomerAccessTokenFields on CustomerAccessToken {\n    accessToken\n    expiresAt\n  }\n\n  \n  fragment UserErrorFields on UserError {\n    message\n    field\n    code\n  }\n\n";
+export declare const CUSTOMER_QUERY = "\n  query Customer($customerAccessToken: String!) {\n    customer(customerAccessToken: $customerAccessToken) {\n      ...CustomerFields\n    }\n  }\n  \n  fragment CustomerFields on Customer {\n    id\n    email\n    firstName\n    lastName\n    displayName\n    phone\n    emailVerified\n    emailMarketingState\n    defaultAddress {\n      id\n      address1\n      address2\n      city\n      company\n      country\n      countryCode\n      firstName\n      lastName\n      phone\n      province\n      provinceCode\n      zip\n      isDefault\n    }\n    ordersCount\n    totalSpent {\n      amount\n      currencyCode\n    }\n    createdAt\n    updatedAt\n  }\n\n";
+//# sourceMappingURL=auth.d.ts.map

package/dist/core/operations/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/core/operations/auth.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA6DH,eAAO,MAAM,cAAc,+aAS1B,CAAC;AAEF,eAAO,MAAM,eAAe,0VAS3B,CAAC;AAEF,eAAO,MAAM,oBAAoB,qcAShC,CAAC;AAEF,eAAO,MAAM,eAAe,w8BAW3B,CAAC;AAMF,eAAO,MAAM,cAAc,kqBAO1B,CAAC"}

package/dist/core/operations/auth.js

@@ -0,0 +1,112 @@
+/**
+ * Auth/Customer GraphQL operations — manual query strings (no codegen).
+ *
+ * These match the backend storefront-graphql schema exactly.
+ */
+// ---------------------------------------------------------------------------
+// Fragments
+// ---------------------------------------------------------------------------
+const CUSTOMER_ACCESS_TOKEN_FRAGMENT = `
+  fragment CustomerAccessTokenFields on CustomerAccessToken {
+    accessToken
+    expiresAt
+  }
+`;
+const USER_ERROR_FRAGMENT = `
+  fragment UserErrorFields on UserError {
+    message
+    field
+    code
+  }
+`;
+const CUSTOMER_FRAGMENT = `
+  fragment CustomerFields on Customer {
+    id
+    email
+    firstName
+    lastName
+    displayName
+    phone
+    emailVerified
+    emailMarketingState
+    defaultAddress {
+      id
+      address1
+      address2
+      city
+      company
+      country
+      countryCode
+      firstName
+      lastName
+      phone
+      province
+      provinceCode
+      zip
+      isDefault
+    }
+    ordersCount
+    totalSpent {
+      amount
+      currencyCode
+    }
+    createdAt
+    updatedAt
+  }
+`;
+// ---------------------------------------------------------------------------
+// Mutations
+// ---------------------------------------------------------------------------
+export const CUSTOMER_LOGIN = `
+  mutation CustomerLogin($input: CustomerAccessTokenCreateInput!) {
+    customerAccessTokenCreate(input: $input) {
+      customerAccessToken { ...CustomerAccessTokenFields }
+      userErrors { ...UserErrorFields }
+    }
+  }
+  ${CUSTOMER_ACCESS_TOKEN_FRAGMENT}
+  ${USER_ERROR_FRAGMENT}
+`;
+export const CUSTOMER_LOGOUT = `
+  mutation CustomerLogout($customerAccessToken: String!) {
+    customerAccessTokenDelete(customerAccessToken: $customerAccessToken) {
+      deletedAccessToken
+      deletedCustomerAccessTokenId
+      userErrors { ...UserErrorFields }
+    }
+  }
+  ${USER_ERROR_FRAGMENT}
+`;
+export const CUSTOMER_TOKEN_RENEW = `
+  mutation CustomerTokenRenew($customerAccessToken: String!) {
+    customerAccessTokenRenew(customerAccessToken: $customerAccessToken) {
+      customerAccessToken { ...CustomerAccessTokenFields }
+      userErrors { ...UserErrorFields }
+    }
+  }
+  ${CUSTOMER_ACCESS_TOKEN_FRAGMENT}
+  ${USER_ERROR_FRAGMENT}
+`;
+export const CUSTOMER_CREATE = `
+  mutation CustomerCreate($input: CustomerCreateInput!) {
+    customerCreate(input: $input) {
+      customer { ...CustomerFields }
+      customerAccessToken { ...CustomerAccessTokenFields }
+      userErrors { ...UserErrorFields }
+    }
+  }
+  ${CUSTOMER_FRAGMENT}
+  ${CUSTOMER_ACCESS_TOKEN_FRAGMENT}
+  ${USER_ERROR_FRAGMENT}
+`;
+// ---------------------------------------------------------------------------
+// Queries
+// ---------------------------------------------------------------------------
+export const CUSTOMER_QUERY = `
+  query Customer($customerAccessToken: String!) {
+    customer(customerAccessToken: $customerAccessToken) {
+      ...CustomerFields
+    }
+  }
+  ${CUSTOMER_FRAGMENT}
+`;

package/dist/core/operations/cart.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Cart GraphQL operations — manual query strings (no codegen).
+ *
+ * These match the backend storefront-graphql schema exactly.
+ * Cart mutations always return full Cart + userErrors.
+ */
+export declare const CART_QUERY = "\n  query Cart($id: ID!) {\n    cart(id: $id) {\n      ...CartFields\n    }\n  }\n  \n  fragment CartFields on Cart {\n    id\n    checkoutUrl\n    totalQuantity\n    note\n    createdAt\n    updatedAt\n    cost { ...CartCost }\n    lines(first: 100) {\n      edges {\n        node { ...CartLineFields }\n      }\n    }\n    buyerIdentity {\n      email\n      phone\n      countryCode\n    }\n    discountCodes {\n      code\n      applicable\n    }\n    discountAllocations {\n      discountedAmount { ...Money }\n    }\n    attributes { key value }\n  }\n  \n  fragment Money on Money {\n    amount\n    currencyCode\n  }\n\n  \n  fragment CartCost on CartCost {\n    totalAmount { ...Money }\n    subtotalAmount { ...Money }\n    totalTaxAmount { ...Money }\n    totalDutyAmount { ...Money }\n  }\n\n  \n  fragment CartLineFields on CartLine {\n    id\n    quantity\n    merchandise {\n      id\n      title\n      sku\n      image { url altText }\n      price { ...Money }\n      compareAtPrice { ...Money }\n    }\n    cost {\n      totalAmount { ...Money }\n      amountPerQuantity { ...Money }\n      compareAtAmountPerQuantity { ...Money }\n    }\n    attributes { key value }\n    productId\n    productTitle\n    productHandle\n  }\n\n\n";
+export declare const CART_CREATE = "\n  mutation CartCreate($input: CartCreateInput) {\n    cartCreate(input: $input) {\n      cart { ...CartFields }\n      userErrors { ...UserErrorFields }\n    }\n  }\n  \n  fragment CartFields on Cart {\n    id\n    checkoutUrl\n    totalQuantity\n    note\n    createdAt\n    updatedAt\n    cost { ...CartCost }\n    lines(first: 100) {\n      edges {\n        node { ...CartLineFields }\n      }\n    }\n    buyerIdentity {\n      email\n      phone\n      countryCode\n    }\n    discountCodes {\n      code\n      applicable\n    }\n    discountAllocations {\n      discountedAmount { ...Money }\n    }\n    attributes { key value }\n  }\n  \n  fragment Money on Money {\n    amount\n    currencyCode\n  }\n\n  \n  fragment CartCost on CartCost {\n    totalAmount { ...Money }\n    subtotalAmount { ...Money }\n    totalTaxAmount { ...Money }\n    totalDutyAmount { ...Money }\n  }\n\n  \n  fragment CartLineFields on CartLine {\n    id\n    quantity\n    merchandise {\n      id\n      title\n      sku\n      image { url altText }\n      price { ...Money }\n      compareAtPrice { ...Money }\n    }\n    cost {\n      totalAmount { ...Money }\n      amountPerQuantity { ...Money }\n      compareAtAmountPerQuantity { ...Money }\n    }\n    attributes { key value }\n    productId\n    productTitle\n    productHandle\n  }\n\n\n  \n  fragment UserErrorFields on UserError {\n    message\n    field\n    code\n  }\n\n";
+export declare const CART_LINES_ADD = "\n  mutation CartLinesAdd($cartId: ID!, $lines: [CartLineInput!]!) {\n    cartLinesAdd(cartId: $cartId, lines: $lines) {\n      cart { ...CartFields }\n      userErrors { ...UserErrorFields }\n    }\n  }\n  \n  fragment CartFields on Cart {\n    id\n    checkoutUrl\n    totalQuantity\n    note\n    createdAt\n    updatedAt\n    cost { ...CartCost }\n    lines(first: 100) {\n      edges {\n        node { ...CartLineFields }\n      }\n    }\n    buyerIdentity {\n      email\n      phone\n      countryCode\n    }\n    discountCodes {\n      code\n      applicable\n    }\n    discountAllocations {\n      discountedAmount { ...Money }\n    }\n    attributes { key value }\n  }\n  \n  fragment Money on Money {\n    amount\n    currencyCode\n  }\n\n  \n  fragment CartCost on CartCost {\n    totalAmount { ...Money }\n    subtotalAmount { ...Money }\n    totalTaxAmount { ...Money }\n    totalDutyAmount { ...Money }\n  }\n\n  \n  fragment CartLineFields on CartLine {\n    id\n    quantity\n    merchandise {\n      id\n      title\n      sku\n      image { url altText }\n      price { ...Money }\n      compareAtPrice { ...Money }\n    }\n    cost {\n      totalAmount { ...Money }\n      amountPerQuantity { ...Money }\n      compareAtAmountPerQuantity { ...Money }\n    }\n    attributes { key value }\n    productId\n    productTitle\n    productHandle\n  }\n\n\n  \n  fragment UserErrorFields on UserError {\n    message\n    field\n    code\n  }\n\n";
+export declare const CART_LINES_UPDATE = "\n  mutation CartLinesUpdate($cartId: ID!, $lines: [CartLineUpdateInput!]!) {\n    cartLinesUpdate(cartId: $cartId, lines: $lines) {\n      cart { ...CartFields }\n      userErrors { ...UserErrorFields }\n    }\n  }\n  \n  fragment CartFields on Cart {\n    id\n    checkoutUrl\n    totalQuantity\n    note\n    createdAt\n    updatedAt\n    cost { ...CartCost }\n    lines(first: 100) {\n      edges {\n        node { ...CartLineFields }\n      }\n    }\n    buyerIdentity {\n      email\n      phone\n      countryCode\n    }\n    discountCodes {\n      code\n      applicable\n    }\n    discountAllocations {\n      discountedAmount { ...Money }\n    }\n    attributes { key value }\n  }\n  \n  fragment Money on Money {\n    amount\n    currencyCode\n  }\n\n  \n  fragment CartCost on CartCost {\n    totalAmount { ...Money }\n    subtotalAmount { ...Money }\n    totalTaxAmount { ...Money }\n    totalDutyAmount { ...Money }\n  }\n\n  \n  fragment CartLineFields on CartLine {\n    id\n    quantity\n    merchandise {\n      id\n      title\n      sku\n      image { url altText }\n      price { ...Money }\n      compareAtPrice { ...Money }\n    }\n    cost {\n      totalAmount { ...Money }\n      amountPerQuantity { ...Money }\n      compareAtAmountPerQuantity { ...Money }\n    }\n    attributes { key value }\n    productId\n    productTitle\n    productHandle\n  }\n\n\n  \n  fragment UserErrorFields on UserError {\n    message\n    field\n    code\n  }\n\n";
+export declare const CART_LINES_REMOVE = "\n  mutation CartLinesRemove($cartId: ID!, $lineIds: [ID!]!) {\n    cartLinesRemove(cartId: $cartId, lineIds: $lineIds) {\n      cart { ...CartFields }\n      userErrors { ...UserErrorFields }\n    }\n  }\n  \n  fragment CartFields on Cart {\n    id\n    checkoutUrl\n    totalQuantity\n    note\n    createdAt\n    updatedAt\n    cost { ...CartCost }\n    lines(first: 100) {\n      edges {\n        node { ...CartLineFields }\n      }\n    }\n    buyerIdentity {\n      email\n      phone\n      countryCode\n    }\n    discountCodes {\n      code\n      applicable\n    }\n    discountAllocations {\n      discountedAmount { ...Money }\n    }\n    attributes { key value }\n  }\n  \n  fragment Money on Money {\n    amount\n    currencyCode\n  }\n\n  \n  fragment CartCost on CartCost {\n    totalAmount { ...Money }\n    subtotalAmount { ...Money }\n    totalTaxAmount { ...Money }\n    totalDutyAmount { ...Money }\n  }\n\n  \n  fragment CartLineFields on CartLine {\n    id\n    quantity\n    merchandise {\n      id\n      title\n      sku\n      image { url altText }\n      price { ...Money }\n      compareAtPrice { ...Money }\n    }\n    cost {\n      totalAmount { ...Money }\n      amountPerQuantity { ...Money }\n      compareAtAmountPerQuantity { ...Money }\n    }\n    attributes { key value }\n    productId\n    productTitle\n    productHandle\n  }\n\n\n  \n  fragment UserErrorFields on UserError {\n    message\n    field\n    code\n  }\n\n";
+export declare const CART_DISCOUNT_CODES_UPDATE = "\n  mutation CartDiscountCodesUpdate($cartId: ID!, $discountCodes: [String!]!) {\n    cartDiscountCodesUpdate(cartId: $cartId, discountCodes: $discountCodes) {\n      cart { ...CartFields }\n      userErrors { ...UserErrorFields }\n    }\n  }\n  \n  fragment CartFields on Cart {\n    id\n    checkoutUrl\n    totalQuantity\n    note\n    createdAt\n    updatedAt\n    cost { ...CartCost }\n    lines(first: 100) {\n      edges {\n        node { ...CartLineFields }\n      }\n    }\n    buyerIdentity {\n      email\n      phone\n      countryCode\n    }\n    discountCodes {\n      code\n      applicable\n    }\n    discountAllocations {\n      discountedAmount { ...Money }\n    }\n    attributes { key value }\n  }\n  \n  fragment Money on Money {\n    amount\n    currencyCode\n  }\n\n  \n  fragment CartCost on CartCost {\n    totalAmount { ...Money }\n    subtotalAmount { ...Money }\n    totalTaxAmount { ...Money }\n    totalDutyAmount { ...Money }\n  }\n\n  \n  fragment CartLineFields on CartLine {\n    id\n    quantity\n    merchandise {\n      id\n      title\n      sku\n      image { url altText }\n      price { ...Money }\n      compareAtPrice { ...Money }\n    }\n    cost {\n      totalAmount { ...Money }\n      amountPerQuantity { ...Money }\n      compareAtAmountPerQuantity { ...Money }\n    }\n    attributes { key value }\n    productId\n    productTitle\n    productHandle\n  }\n\n\n  \n  fragment UserErrorFields on UserError {\n    message\n    field\n    code\n  }\n\n";
+export declare const CART_NOTE_UPDATE = "\n  mutation CartNoteUpdate($cartId: ID!, $note: String!) {\n    cartNoteUpdate(cartId: $cartId, note: $note) {\n      cart { ...CartFields }\n      userErrors { ...UserErrorFields }\n    }\n  }\n  \n  fragment CartFields on Cart {\n    id\n    checkoutUrl\n    totalQuantity\n    note\n    createdAt\n    updatedAt\n    cost { ...CartCost }\n    lines(first: 100) {\n      edges {\n        node { ...CartLineFields }\n      }\n    }\n    buyerIdentity {\n      email\n      phone\n      countryCode\n    }\n    discountCodes {\n      code\n      applicable\n    }\n    discountAllocations {\n      discountedAmount { ...Money }\n    }\n    attributes { key value }\n  }\n  \n  fragment Money on Money {\n    amount\n    currencyCode\n  }\n\n  \n  fragment CartCost on CartCost {\n    totalAmount { ...Money }\n    subtotalAmount { ...Money }\n    totalTaxAmount { ...Money }\n    totalDutyAmount { ...Money }\n  }\n\n  \n  fragment CartLineFields on CartLine {\n    id\n    quantity\n    merchandise {\n      id\n      title\n      sku\n      image { url altText }\n      price { ...Money }\n      compareAtPrice { ...Money }\n    }\n    cost {\n      totalAmount { ...Money }\n      amountPerQuantity { ...Money }\n      compareAtAmountPerQuantity { ...Money }\n    }\n    attributes { key value }\n    productId\n    productTitle\n    productHandle\n  }\n\n\n  \n  fragment UserErrorFields on UserError {\n    message\n    field\n    code\n  }\n\n";
+export declare const CART_BUYER_IDENTITY_UPDATE = "\n  mutation CartBuyerIdentityUpdate($cartId: ID!, $buyerIdentity: CartBuyerIdentityInput!) {\n    cartBuyerIdentityUpdate(cartId: $cartId, buyerIdentity: $buyerIdentity) {\n      cart { ...CartFields }\n      userErrors { ...UserErrorFields }\n    }\n  }\n  \n  fragment CartFields on Cart {\n    id\n    checkoutUrl\n    totalQuantity\n    note\n    createdAt\n    updatedAt\n    cost { ...CartCost }\n    lines(first: 100) {\n      edges {\n        node { ...CartLineFields }\n      }\n    }\n    buyerIdentity {\n      email\n      phone\n      countryCode\n    }\n    discountCodes {\n      code\n      applicable\n    }\n    discountAllocations {\n      discountedAmount { ...Money }\n    }\n    attributes { key value }\n  }\n  \n  fragment Money on Money {\n    amount\n    currencyCode\n  }\n\n  \n  fragment CartCost on CartCost {\n    totalAmount { ...Money }\n    subtotalAmount { ...Money }\n    totalTaxAmount { ...Money }\n    totalDutyAmount { ...Money }\n  }\n\n  \n  fragment CartLineFields on CartLine {\n    id\n    quantity\n    merchandise {\n      id\n      title\n      sku\n      image { url altText }\n      price { ...Money }\n      compareAtPrice { ...Money }\n    }\n    cost {\n      totalAmount { ...Money }\n      amountPerQuantity { ...Money }\n      compareAtAmountPerQuantity { ...Money }\n    }\n    attributes { key value }\n    productId\n    productTitle\n    productHandle\n  }\n\n\n  \n  fragment UserErrorFields on UserError {\n    message\n    field\n    code\n  }\n\n";
+//# sourceMappingURL=cart.d.ts.map

package/dist/core/operations/cart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart.d.ts","sourceRoot":"","sources":["../../../src/core/operations/cart.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2FH,eAAO,MAAM,UAAU,quCAOtB,CAAC;AAMF,eAAO,MAAM,WAAW,m5CASvB,CAAC;AAEF,eAAO,MAAM,cAAc,w7CAS1B,CAAC;AAEF,eAAO,MAAM,iBAAiB,o8CAS7B,CAAC;AAEF,eAAO,MAAM,iBAAiB,y7CAS7B,CAAC;AAEF,eAAO,MAAM,0BAA0B,+9CAStC,CAAC;AAEF,eAAO,MAAM,gBAAgB,+6CAS5B,CAAC;AAEF,eAAO,MAAM,0BAA0B,4+CAStC,CAAC"}