@ekomerc/storefront 0.1.0

package/README.md

@@ -0,0 +1,452 @@
+# @ekomerc/storefront
+
+TypeScript SDK for building headless storefronts with ekomerc. Provides typed helpers for products, collections, cart, and checkout operations.
+
+## Installation
+
+```bash
+pnpm add @ekomerc/storefront
+# or
+npm install @ekomerc/storefront
+```
+
+## Quick Start
+
+```typescript
+import { createStorefrontClient } from "@ekomerc/storefront";
+
+const client = createStorefrontClient({
+  endpoint: "https://api.yourstore.com/graphql",
+  apiKey: "sfk_your_api_key",
+});
+
+// Fetch products
+const result = await client.products.list({ first: 10, filter: { search: "shirt" } });
+if (result.isOk()) {
+  console.log(result.value.items);
+}
+
+// Add to cart (variantId is the GID from product queries, e.g. variant.id)
+await client.cart.create();
+const addResult = await client.cart.addItem(variant.id, 1);
+if (addResult.isOk()) {
+  console.log("Added to cart:", addResult.value);
+}
+```
+
+## Configuration
+
+```typescript
+interface StorefrontClientConfig {
+  endpoint: string;           // Full Storefront GraphQL URL (absolute)
+  apiKey: string;             // API key (sfk_...)
+  storage?: StorageAdapter;   // Cart token storage (default: auto-detect)
+  cacheTTL?: number;          // Query cache TTL in ms (default: 5 minutes)
+}
+```
+
+### Custom Endpoint URLs
+
+`endpoint` is used exactly as provided. The SDK sends `POST` requests directly to that URL and does not rewrite hosts or paths.
+
+```typescript
+const client = createStorefrontClient({
+  endpoint: "https://edge.example.com/custom/storefront/v1/graphql",
+  apiKey: "sfk_test_placeholder",
+});
+```
+
+Supported examples:
+- `https://api.example.com/graphql`
+- `https://edge.example.com/custom/storefront/v1/graphql`
+- `https://staging.example.net/gql/storefront`
+
+### Auth And Request Headers
+
+For each request the SDK sends:
+- `content-type: application/json`
+- `x-storefront-key: <apiKey>` (always)
+- `x-cart-token: <cartToken>` (when cart token exists)
+- `authorization: Bearer <customerToken>` (when customer token exists)
+
+### Storage Adapters
+
+The SDK stores the cart token to persist the cart across page loads.
+
+```typescript
+import {
+  createStorefrontClient,
+  createLocalStorageAdapter,  // Browser localStorage
+  createMemoryAdapter,        // In-memory (SSR/testing)
+  createDefaultAdapter,       // Auto-detects environment
+} from "@ekomerc/storefront";
+
+// Browser (default)
+const client = createStorefrontClient({
+  endpoint: "https://api.yourstore.com/graphql",
+  apiKey: "sfk_...",
+  // Uses localStorage by default in browser
+});
+
+// SSR / Server-side
+const client = createStorefrontClient({
+  endpoint: "https://api.yourstore.com/graphql",
+  apiKey: "sfk_...",
+  storage: createMemoryAdapter(),
+});
+
+// Custom storage
+const client = createStorefrontClient({
+  endpoint: "https://api.yourstore.com/graphql",
+  apiKey: "sfk_...",
+  storage: {
+    get: (key) => sessionStorage.getItem(key),
+    set: (key, value) => sessionStorage.setItem(key, value),
+    remove: (key) => sessionStorage.removeItem(key),
+  },
+});
+```
+
+## API Reference
+
+All methods return `Promise<Result<T, StorefrontError>>` from [neverthrow](https://github.com/supermacro/neverthrow).
+
+### Products
+
+```typescript
+// List products with pagination
+const result = await client.products.list({
+  first: 10,      // Number of products (default: 20)
+  after: cursor,  // Pagination cursor
+  filter: { search: "shirt" }, // Search query
+  sort: "BEST_SELLING"
+});
+// Returns: { items: Product[], pageInfo: PageInfo }
+
+// Get single product by handle or ID
+const result = await client.products.get("blue-shirt");
+const result = await client.products.get("UHJvZHVjdDoxMjM="); // Global ID
+
+// Batch fetch by handles
+const result = await client.products.getByHandles(["shirt-1", "shirt-2"]);
+// Returns: (Product | null)[]
+```
+
+### Collections
+
+```typescript
+// List collections
+const result = await client.collections.list({
+  first: 10,
+  after: cursor,
+  search: "summer"
+});
+// Returns: { items: Collection[], pageInfo: PageInfo }
+
+// Get single collection
+const result = await client.collections.get("summer-collection");
+
+// Get products in a collection
+const result = await client.collections.getProducts("summer-collection", {
+  first: 20,
+  after: cursor,
+});
+// Returns: { items: Product[], pageInfo: PageInfo }
+```
+
+### Cart
+
+```typescript
+// Get current cart (from stored token)
+const result = await client.cart.get();
+// Returns: Cart | null
+
+// Create new cart
+const result = await client.cart.create();
+// Returns: Cart
+
+// Add item to cart
+// variantId must be a Global ID (GID) — use variant.id from product queries
+const result = await client.cart.addItem(variantId, quantity);
+// Returns: Cart
+
+// Update item quantity
+// variantId must be a Global ID (GID) — use variant.id from product queries
+const result = await client.cart.updateItem(variantId, newQuantity);
+// Returns: Cart
+
+// Remove item from cart
+// variantId must be a Global ID (GID) — use variant.id from product queries
+const result = await client.cart.removeItem(variantId);
+// Returns: Cart
+
+// Clear all items
+const result = await client.cart.clear();
+// Returns: Cart
+
+// Apply a promo code
+const result = await client.cart.applyPromoCode("SAVE10");
+if (result.isErr()) {
+  // ValidationError with reason (e.g. "Invalid or expired code")
+}
+// Returns: Cart (with appliedPromoCode populated)
+
+// Remove applied promo code
+const result = await client.cart.removePromoCode();
+// Returns: Cart (with appliedPromoCode cleared)
+```
+
+Note: `variantId` in `cart.addItem`, `cart.updateItem`, and `cart.removeItem` must be a GraphQL Global ID (GID), not a raw UUID. Use variant IDs returned by product queries.
+
+### Pricing Display
+
+Product variants include sale and quantity pricing information:
+
+```typescript
+const result = await client.products.get("my-product");
+if (result.isOk()) {
+  const variant = result.value.variants[0];
+
+  // Sale price detection
+  if (variant.isOnSale) {
+    console.log(`Was: ${variant.compareAtPrice}, Now: ${variant.price}`);
+  }
+
+  // Quantity tier pricing
+  for (const tier of variant.quantityPricing) {
+    console.log(`Buy ${tier.minQuantity}+ at ${tier.price}/unit`);
+  }
+}
+```
+
+Cart items expose the resolved effective unit price (considering sale + quantity tier):
+
+```typescript
+const cart = (await client.cart.get()).unwrapOr(null);
+if (cart) {
+  for (const item of cart.items) {
+    console.log(`Base price: ${item.price.amount}`);
+    console.log(`Effective price: ${item.effectiveUnitPrice.amount}`);
+    console.log(`Line total: ${item.totalPrice.amount}`);
+  }
+
+  // Discount information
+  console.log(`Discount: ${cart.discountTotal.amount}`);
+  if (cart.appliedPromoCode) {
+    console.log(`Promo: ${cart.appliedPromoCode.code} (-${cart.appliedPromoCode.discountAmount})`);
+  }
+  for (const discount of cart.appliedDiscounts) {
+    console.log(`${discount.description}: -${discount.discountAmount}`);
+  }
+}
+```
+
+### Checkout
+
+```typescript
+// Start checkout (transitions cart to checkout state)
+const result = await client.checkout.start();
+// Returns: Cart (with status: "checkout")
+
+// Update checkout info
+const result = await client.checkout.update({
+  email: "customer@example.com",
+  phone: "+381...",
+  shippingAddress: {
+    firstName: "John",
+    lastName: "Doe",
+    address1: "123 Main St",
+    city: "Belgrade",
+    country: "Serbia",
+    countryCode: "RS",
+    zip: "11000",
+  },
+  billingAddress: { ... },
+  notes: "Leave at door",
+  emailMarketingConsent: true,
+});
+// Returns: Cart
+
+// Complete checkout (creates order)
+const result = await client.checkout.complete();
+// Returns: Order
+
+// Abandon checkout (returns cart to active state)
+const result = await client.checkout.abandon();
+// Returns: Cart
+```
+
+### Cache
+
+```typescript
+// Clear the query cache
+client.cache.clear();
+```
+
+### Cart Token Management
+
+```typescript
+// Get current cart token
+const token = client.getCartToken();
+
+// Set cart token manually
+client.setCartToken("cart-token-uuid");
+
+// Clear cart token
+client.clearCartToken();
+```
+
+## Error Handling
+
+The SDK uses Result types for error handling. Errors are typed and categorized:
+
+```typescript
+import {
+  StorefrontError,  // Base error class
+  NetworkError,     // Network/fetch failures
+  AuthError,        // Invalid/revoked API key
+  ValidationError,  // Validation errors from mutations
+  NotFoundError,    // Resource not found
+  StateError,       // Invalid cart state transition
+  GraphQLError,     // Unexpected GraphQL errors
+} from "@ekomerc/storefront";
+
+const result = await client.products.get("nonexistent");
+
+if (result.isErr()) {
+  const error = result.error;
+
+  if (error instanceof NotFoundError) {
+    console.log("Product not found");
+  } else if (error instanceof AuthError) {
+    console.log("Invalid API key");
+  } else if (error instanceof StateError) {
+    console.log(`Cart state error: ${error.state}`);
+  } else if (error instanceof ValidationError) {
+    console.log("Validation errors:", error.userErrors);
+  }
+}
+
+// Or use pattern matching
+result.match(
+  (product) => console.log("Found:", product.title),
+  (error) => console.error("Error:", error.message)
+);
+```
+
+### Troubleshooting Endpoint/Auth Issues
+
+1. `AuthError` (`401`/`403`)
+`x-storefront-key` is missing, invalid, revoked, or scoped for a different store. Rotate/regenerate the key and verify the exact value loaded in your runtime env.
+
+2. Browser CORS failure
+If browser console shows CORS errors, your API origin must allow your storefront origin and headers:
+`content-type, x-storefront-key, x-cart-token, authorization`.
+
+3. Malformed endpoint URL
+Always use a full absolute URL like `https://api.example.com/storefront`. The SDK does not validate the URL at initialization — requests will fail at runtime if the endpoint is malformed.
+
+### Cart State Errors
+
+Cart operations are only allowed when the cart is in `active` state. Attempting to modify a cart in `checkout`, `converted`, `abandoned`, or `expired` state returns a `StateError`:
+
+```typescript
+// Cart is in checkout state
+const result = await client.cart.addItem(variantId, 1);
+
+if (result.isErr() && result.error instanceof StateError) {
+  console.log(`Cannot modify cart: ${result.error.message}`);
+  // "Cannot modify cart in 'checkout' state. Cart operations are only allowed when cart is in 'active' state."
+}
+```
+
+## Types
+
+All types are exported for TypeScript users:
+
+```typescript
+import type {
+  // Client
+  StorefrontClient,
+  StorefrontClientConfig,
+  StorageAdapter,
+
+  // Products
+  Product,
+  ProductVariant,
+  ProductOption,
+  ProductImage,
+  QuantityPricingTier,
+
+  // Collections
+  Collection,
+
+  // Cart
+  Cart,
+  CartItem,
+  CartStatus,
+  AppliedPromoCode,
+  AppliedDiscount,
+
+  // Checkout
+  CheckoutData,
+  Address,
+  Order,
+
+  // Pagination
+  PageInfo,
+  PaginatedResult,
+
+  // Common
+  Money,
+  Store,
+} from "@ekomerc/storefront";
+```
+
+## SSR / Server-Side Rendering
+
+For SSR frameworks (Next.js, Remix, etc.), use the memory adapter on the server:
+
+```typescript
+import {
+  createStorefrontClient,
+  createMemoryAdapter,
+  createLocalStorageAdapter,
+} from "@ekomerc/storefront";
+
+const client = createStorefrontClient({
+  endpoint: process.env.STOREFRONT_API_URL,
+  apiKey: process.env.STOREFRONT_API_KEY,
+  storage: typeof window === "undefined"
+    ? createMemoryAdapter()
+    : createLocalStorageAdapter(),
+});
+```
+
+## React Integration
+
+For React applications, use the `@ekomerc/storefront-react` package which provides hooks and context:
+
+```typescript
+import { StorefrontProvider, useProducts, useCart } from "@ekomerc/storefront-react";
+
+function App() {
+  return (
+    <StorefrontProvider client={client}>
+      <Shop />
+    </StorefrontProvider>
+  );
+}
+
+function Shop() {
+  const { products, loading, error } = useProducts();
+  const { cart, addItem } = useCart();
+  // ...
+}
+```
+
+See the `@ekomerc/storefront-react` package for full documentation.
+
+## License
+
+MIT

package/dist/errors.cjs

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+class StorefrontError extends Error {
+  code;
+  constructor(message, code, options) {
+    super(message, options);
+    this.name = "StorefrontError";
+    this.code = code;
+  }
+}
+class NetworkError extends StorefrontError {
+  constructor(message, options) {
+    super(message, "NETWORK_ERROR", options);
+    this.name = "NetworkError";
+  }
+}
+class AuthError extends StorefrontError {
+  constructor(message, options) {
+    super(message, "AUTH_ERROR", options);
+    this.name = "AuthError";
+  }
+}
+class ValidationError extends StorefrontError {
+  userErrors;
+  constructor(message, userErrors, options) {
+    super(message, "VALIDATION_ERROR", options);
+    this.name = "ValidationError";
+    this.userErrors = userErrors;
+  }
+}
+class NotFoundError extends StorefrontError {
+  constructor(message, options) {
+    super(message, "NOT_FOUND", options);
+    this.name = "NotFoundError";
+  }
+}
+class StateError extends StorefrontError {
+  state;
+  constructor(message, state, options) {
+    super(message, "STATE_ERROR", options);
+    this.name = "StateError";
+    this.state = state;
+  }
+}
+class GraphQLError extends StorefrontError {
+  graphqlErrors;
+  constructor(message, graphqlErrors, options) {
+    super(message, "GRAPHQL_ERROR", options);
+    this.name = "GraphQLError";
+    this.graphqlErrors = graphqlErrors;
+  }
+}
+exports.AuthError = AuthError;
+exports.GraphQLError = GraphQLError;
+exports.NetworkError = NetworkError;
+exports.NotFoundError = NotFoundError;
+exports.StateError = StateError;
+exports.StorefrontError = StorefrontError;
+exports.ValidationError = ValidationError;
+//# sourceMappingURL=errors.cjs.map

package/dist/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.cjs","sources":["../src/errors.ts"],"sourcesContent":["/**\n * Base class for all Storefront SDK errors\n */\nexport class StorefrontError extends Error {\n  readonly code: string;\n\n  constructor(message: string, code: string, options?: { cause?: Error }) {\n    super(message, options);\n    this.name = \"StorefrontError\";\n    this.code = code;\n  }\n}\n\n/**\n * Network error - fetch failed, connection issues\n */\nexport class NetworkError extends StorefrontError {\n  constructor(message: string, options?: { cause?: Error }) {\n    super(message, \"NETWORK_ERROR\", options);\n    this.name = \"NetworkError\";\n  }\n}\n\n/**\n * Authentication error - invalid/revoked API key, 401/403 responses\n */\nexport class AuthError extends StorefrontError {\n  constructor(message: string, options?: { cause?: Error }) {\n    super(message, \"AUTH_ERROR\", options);\n    this.name = \"AuthError\";\n  }\n}\n\n/**\n * Validation error - userErrors from mutations\n */\nexport class ValidationError extends StorefrontError {\n  readonly userErrors: Array<{ field: string | null; message: string }>;\n\n  constructor(\n    message: string,\n    userErrors: Array<{ field: string | null; message: string }>,\n    options?: { cause?: Error },\n  ) {\n    super(message, \"VALIDATION_ERROR\", options);\n    this.name = \"ValidationError\";\n    this.userErrors = userErrors;\n  }\n}\n\n/**\n * Not found error - resource doesn't exist\n */\nexport class NotFoundError extends StorefrontError {\n  constructor(message: string, options?: { cause?: Error }) {\n    super(message, \"NOT_FOUND\", options);\n    this.name = \"NotFoundError\";\n  }\n}\n\n/**\n * State error - invalid cart state transition\n */\nexport class StateError extends StorefrontError {\n  readonly state: string;\n\n  constructor(message: string, state: string, options?: { cause?: Error }) {\n    super(message, \"STATE_ERROR\", options);\n    this.name = \"StateError\";\n    this.state = state;\n  }\n}\n\n/**\n * GraphQL error - unexpected GraphQL errors\n */\nexport class GraphQLError extends StorefrontError {\n  readonly graphqlErrors: Array<{ message: string; path?: readonly (string | number)[] }>;\n\n  constructor(\n    message: string,\n    graphqlErrors: Array<{ message: string; path?: readonly (string | number)[] }>,\n    options?: { cause?: Error },\n  ) {\n    super(message, \"GRAPHQL_ERROR\", options);\n    this.name = \"GraphQLError\";\n    this.graphqlErrors = graphqlErrors;\n  }\n}\n"],"names":[],"mappings":";;AAGO,MAAM,wBAAwB,MAAM;AAAA,EAChC;AAAA,EAET,YAAY,SAAiB,MAAc,SAA6B;AACtE,UAAM,SAAS,OAAO;AACtB,SAAK,OAAO;AACZ,SAAK,OAAO;AAAA,EACd;AACF;AAKO,MAAM,qBAAqB,gBAAgB;AAAA,EAChD,YAAY,SAAiB,SAA6B;AACxD,UAAM,SAAS,iBAAiB,OAAO;AACvC,SAAK,OAAO;AAAA,EACd;AACF;AAKO,MAAM,kBAAkB,gBAAgB;AAAA,EAC7C,YAAY,SAAiB,SAA6B;AACxD,UAAM,SAAS,cAAc,OAAO;AACpC,SAAK,OAAO;AAAA,EACd;AACF;AAKO,MAAM,wBAAwB,gBAAgB;AAAA,EAC1C;AAAA,EAET,YACE,SACA,YACA,SACA;AACA,UAAM,SAAS,oBAAoB,OAAO;AAC1C,SAAK,OAAO;AACZ,SAAK,aAAa;AAAA,EACpB;AACF;AAKO,MAAM,sBAAsB,gBAAgB;AAAA,EACjD,YAAY,SAAiB,SAA6B;AACxD,UAAM,SAAS,aAAa,OAAO;AACnC,SAAK,OAAO;AAAA,EACd;AACF;AAKO,MAAM,mBAAmB,gBAAgB;AAAA,EACrC;AAAA,EAET,YAAY,SAAiB,OAAe,SAA6B;AACvE,UAAM,SAAS,eAAe,OAAO;AACrC,SAAK,OAAO;AACZ,SAAK,QAAQ;AAAA,EACf;AACF;AAKO,MAAM,qBAAqB,gBAAgB;AAAA,EACvC;AAAA,EAET,YACE,SACA,eACA,SACA;AACA,UAAM,SAAS,iBAAiB,OAAO;AACvC,SAAK,OAAO;AACZ,SAAK,gBAAgB;AAAA,EACvB;AACF;;;;;;;;"}

package/dist/errors.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Authentication error - invalid/revoked API key, 401/403 responses
+ */
+export declare class AuthError extends StorefrontError {
+    constructor(message: string, options?: {
+        cause?: Error;
+    });
+}
+
+/**
+ * GraphQL error - unexpected GraphQL errors
+ */
+export declare class GraphQLError extends StorefrontError {
+    readonly graphqlErrors: Array<{
+        message: string;
+        path?: readonly (string | number)[];
+    }>;
+    constructor(message: string, graphqlErrors: Array<{
+        message: string;
+        path?: readonly (string | number)[];
+    }>, options?: {
+        cause?: Error;
+    });
+}
+
+/**
+ * Network error - fetch failed, connection issues
+ */
+export declare class NetworkError extends StorefrontError {
+    constructor(message: string, options?: {
+        cause?: Error;
+    });
+}
+
+/**
+ * Not found error - resource doesn't exist
+ */
+export declare class NotFoundError extends StorefrontError {
+    constructor(message: string, options?: {
+        cause?: Error;
+    });
+}
+
+/**
+ * State error - invalid cart state transition
+ */
+export declare class StateError extends StorefrontError {
+    readonly state: string;
+    constructor(message: string, state: string, options?: {
+        cause?: Error;
+    });
+}
+
+/**
+ * Base class for all Storefront SDK errors
+ */
+export declare class StorefrontError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string, options?: {
+        cause?: Error;
+    });
+}
+
+/**
+ * Validation error - userErrors from mutations
+ */
+export declare class ValidationError extends StorefrontError {
+    readonly userErrors: Array<{
+        field: string | null;
+        message: string;
+    }>;
+    constructor(message: string, userErrors: Array<{
+        field: string | null;
+        message: string;
+    }>, options?: {
+        cause?: Error;
+    });
+}
+
+export { }

package/dist/errors.js

@@ -0,0 +1,60 @@
+class StorefrontError extends Error {
+  code;
+  constructor(message, code, options) {
+    super(message, options);
+    this.name = "StorefrontError";
+    this.code = code;
+  }
+}
+class NetworkError extends StorefrontError {
+  constructor(message, options) {
+    super(message, "NETWORK_ERROR", options);
+    this.name = "NetworkError";
+  }
+}
+class AuthError extends StorefrontError {
+  constructor(message, options) {
+    super(message, "AUTH_ERROR", options);
+    this.name = "AuthError";
+  }
+}
+class ValidationError extends StorefrontError {
+  userErrors;
+  constructor(message, userErrors, options) {
+    super(message, "VALIDATION_ERROR", options);
+    this.name = "ValidationError";
+    this.userErrors = userErrors;
+  }
+}
+class NotFoundError extends StorefrontError {
+  constructor(message, options) {
+    super(message, "NOT_FOUND", options);
+    this.name = "NotFoundError";
+  }
+}
+class StateError extends StorefrontError {
+  state;
+  constructor(message, state, options) {
+    super(message, "STATE_ERROR", options);
+    this.name = "StateError";
+    this.state = state;
+  }
+}
+class GraphQLError extends StorefrontError {
+  graphqlErrors;
+  constructor(message, graphqlErrors, options) {
+    super(message, "GRAPHQL_ERROR", options);
+    this.name = "GraphQLError";
+    this.graphqlErrors = graphqlErrors;
+  }
+}
+export {
+  AuthError,
+  GraphQLError,
+  NetworkError,
+  NotFoundError,
+  StateError,
+  StorefrontError,
+  ValidationError
+};
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sources":["../src/errors.ts"],"sourcesContent":["/**\n * Base class for all Storefront SDK errors\n */\nexport class StorefrontError extends Error {\n  readonly code: string;\n\n  constructor(message: string, code: string, options?: { cause?: Error }) {\n    super(message, options);\n    this.name = \"StorefrontError\";\n    this.code = code;\n  }\n}\n\n/**\n * Network error - fetch failed, connection issues\n */\nexport class NetworkError extends StorefrontError {\n  constructor(message: string, options?: { cause?: Error }) {\n    super(message, \"NETWORK_ERROR\", options);\n    this.name = \"NetworkError\";\n  }\n}\n\n/**\n * Authentication error - invalid/revoked API key, 401/403 responses\n */\nexport class AuthError extends StorefrontError {\n  constructor(message: string, options?: { cause?: Error }) {\n    super(message, \"AUTH_ERROR\", options);\n    this.name = \"AuthError\";\n  }\n}\n\n/**\n * Validation error - userErrors from mutations\n */\nexport class ValidationError extends StorefrontError {\n  readonly userErrors: Array<{ field: string | null; message: string }>;\n\n  constructor(\n    message: string,\n    userErrors: Array<{ field: string | null; message: string }>,\n    options?: { cause?: Error },\n  ) {\n    super(message, \"VALIDATION_ERROR\", options);\n    this.name = \"ValidationError\";\n    this.userErrors = userErrors;\n  }\n}\n\n/**\n * Not found error - resource doesn't exist\n */\nexport class NotFoundError extends StorefrontError {\n  constructor(message: string, options?: { cause?: Error }) {\n    super(message, \"NOT_FOUND\", options);\n    this.name = \"NotFoundError\";\n  }\n}\n\n/**\n * State error - invalid cart state transition\n */\nexport class StateError extends StorefrontError {\n  readonly state: string;\n\n  constructor(message: string, state: string, options?: { cause?: Error }) {\n    super(message, \"STATE_ERROR\", options);\n    this.name = \"StateError\";\n    this.state = state;\n  }\n}\n\n/**\n * GraphQL error - unexpected GraphQL errors\n */\nexport class GraphQLError extends StorefrontError {\n  readonly graphqlErrors: Array<{ message: string; path?: readonly (string | number)[] }>;\n\n  constructor(\n    message: string,\n    graphqlErrors: Array<{ message: string; path?: readonly (string | number)[] }>,\n    options?: { cause?: Error },\n  ) {\n    super(message, \"GRAPHQL_ERROR\", options);\n    this.name = \"GraphQLError\";\n    this.graphqlErrors = graphqlErrors;\n  }\n}\n"],"names":[],"mappings":"AAGO,MAAM,wBAAwB,MAAM;AAAA,EAChC;AAAA,EAET,YAAY,SAAiB,MAAc,SAA6B;AACtE,UAAM,SAAS,OAAO;AACtB,SAAK,OAAO;AACZ,SAAK,OAAO;AAAA,EACd;AACF;AAKO,MAAM,qBAAqB,gBAAgB;AAAA,EAChD,YAAY,SAAiB,SAA6B;AACxD,UAAM,SAAS,iBAAiB,OAAO;AACvC,SAAK,OAAO;AAAA,EACd;AACF;AAKO,MAAM,kBAAkB,gBAAgB;AAAA,EAC7C,YAAY,SAAiB,SAA6B;AACxD,UAAM,SAAS,cAAc,OAAO;AACpC,SAAK,OAAO;AAAA,EACd;AACF;AAKO,MAAM,wBAAwB,gBAAgB;AAAA,EAC1C;AAAA,EAET,YACE,SACA,YACA,SACA;AACA,UAAM,SAAS,oBAAoB,OAAO;AAC1C,SAAK,OAAO;AACZ,SAAK,aAAa;AAAA,EACpB;AACF;AAKO,MAAM,sBAAsB,gBAAgB;AAAA,EACjD,YAAY,SAAiB,SAA6B;AACxD,UAAM,SAAS,aAAa,OAAO;AACnC,SAAK,OAAO;AAAA,EACd;AACF;AAKO,MAAM,mBAAmB,gBAAgB;AAAA,EACrC;AAAA,EAET,YAAY,SAAiB,OAAe,SAA6B;AACvE,UAAM,SAAS,eAAe,OAAO;AACrC,SAAK,OAAO;AACZ,SAAK,QAAQ;AAAA,EACf;AACF;AAKO,MAAM,qBAAqB,gBAAgB;AAAA,EACvC;AAAA,EAET,YACE,SACA,eACA,SACA;AACA,UAAM,SAAS,iBAAiB,OAAO;AACvC,SAAK,OAAO;AACZ,SAAK,gBAAgB;AAAA,EACvB;AACF;"}