@jay-framework/wix-cart 0.18.4 → 0.19.1

package/README.md

@@ -0,0 +1,113 @@
+# @jay-framework/wix-cart
+
+Shared cart and checkout package for Jay Framework Wix integrations. Provides headless cart components with server-side rendering and client-side interactivity, plus checkout redirect to Wix's hosted checkout.
+
+## Features
+
+- **Cart page** — Full cart with line items, quantity controls, coupon codes, and estimated totals
+- **Cart indicator** — Reactive badge showing item count (updates automatically on add/remove)
+- **Mini cart** — Compact cart drawer/modal
+- **Checkout redirect** — Creates a checkout from the current cart and redirects to Wix's hosted checkout page
+- **Three-phase rendering** — Slow (build), Fast (request/SSR), Interactive (client)
+- **Shared across stores packages** — Used by both `@jay-framework/wix-stores` and `@jay-framework/wix-stores-v1`
+
+## Configuration
+
+### `config/.wix-cart.yaml`
+
+Optional configuration file. Created automatically by `jay-stack-cli setup` if missing.
+
+```yaml
+# Checkout callback URLs
+urls:
+  thankYou: '/thank-you' # Where Wix redirects after successful checkout (default: /thank-you)
+```
+
+## Headless Components
+
+### Cart Page (`cart-page`)
+
+Full shopping cart with line item management and checkout.
+
+- **Slow phase**: Cart ID, empty cart message
+- **Fast phase**: Loading state
+- **Interactive**: Line items (quantity, remove), coupon input, checkout button
+
+Key interactions:
+
+- `checkoutButton` — Creates a Wix checkout and redirects to hosted checkout
+- `continueShoppingLink` — Link back to products
+- `clearCartButton` — Remove all items
+- Quantity increment/decrement per line item
+- Coupon apply/remove
+
+### Cart Indicator (`cart-indicator`)
+
+Header badge showing cart item count.
+
+- **Fast+Interactive**: `itemCount`, `hasItems`, `isLoading`, `justAdded`
+- Reactive — updates automatically when items are added/removed from any page
+
+### Mini Cart (`mini-cart`)
+
+Compact cart for drawer/modal display. Same data as cart-page in a condensed format.
+
+## Checkout Flow
+
+The checkout button triggers a redirect to Wix's hosted checkout:
+
+1. `createCheckoutFromCurrentCart()` — creates a Wix checkout from the current cart
+2. `createRedirectSession({ ecomCheckout: { checkoutId } })` — gets a redirect URL
+3. Browser navigates to Wix checkout — payment, shipping, order review
+4. After completion, Wix redirects to the configured `thankYou` URL
+
+No PCI compliance or payment integration needed — Wix handles everything.
+
+## Services & Contexts
+
+### `WIX_CART_SERVICE` (server)
+
+Server-side cart operations using API key authentication.
+
+```typescript
+import { WIX_CART_SERVICE } from '@jay-framework/wix-cart';
+
+// Available in .withServices(WIX_CART_SERVICE)
+interface WixCartService {
+  cart: CurrentCartClient; // @wix/ecom currentCart
+  redirects: RedirectsClient; // @wix/redirects
+  urls: { thankYou: string }; // Configured URLs
+}
+```
+
+### `WIX_CART_CONTEXT` (client)
+
+Client-side cart operations using OAuth authentication.
+
+```typescript
+import { WIX_CART_CONTEXT } from '@jay-framework/wix-cart';
+
+// Available in useContext(WIX_CART_CONTEXT)
+interface WixCartContext {
+  cartIndicator: { itemCount: Getter<number>; hasItems: Getter<boolean> };
+  refreshCartIndicator(): Promise<void>;
+  getEstimatedCart(): Promise<CartState>;
+  addToCart(
+    productId: string,
+    quantity?: number,
+    options?: AddToCartOptions,
+  ): Promise<CartOperationResult>;
+  removeLineItems(lineItemIds: string[]): Promise<CartOperationResult>;
+  updateLineItemQuantity(lineItemId: string, quantity: number): Promise<CartOperationResult>;
+  clearCart(): Promise<void>;
+  applyCoupon(couponCode: string): Promise<CartOperationResult>;
+  removeCoupon(): Promise<CartOperationResult>;
+  checkout(): Promise<string>; // Returns Wix checkout redirect URL
+}
+```
+
+## Dependencies
+
+- `@wix/ecom` — Cart operations (currentCart)
+- `@wix/redirects` — Checkout redirect sessions
+- `@jay-framework/wix-server-client` — Wix SDK client and authentication

package/dist/contracts/cart-page.jay-contract

@@ -74,6 +74,7 @@ tags:
             type: data
             dataType: string
             description: Image URL
+            meta: {mediaType: wix-image}
             
           - tag: altText
             type: data

package/dist/{index.client-DWB0MOQ0.d.ts → index.client-C7UwcsSn.d.ts}

@@ -7,6 +7,7 @@ import { BuildDescriptors } from '@wix/sdk-types';
 import * as _jay_framework_fullstack_component from '@jay-framework/fullstack-component';
 import { Signals, PageProps } from '@jay-framework/fullstack-component';
 import * as _jay_framework_component from '@jay-framework/component';
+import { redirects } from '@wix/redirects';
 
 /**
  * Cart Helper Types and Functions
@@ -138,6 +139,8 @@ declare function mapEstimateTotalsToState(estimate: EstimateTotalsResult | null)
 interface WixCartInitData {
     /** Enable client-side cart operations */
     enableClientCart: boolean;
+    /** URL path for post-checkout redirect (default: /thank-you) */
+    thankYouUrl: string;
 }
 /**
  * Reactive cart indicator state.
@@ -239,6 +242,11 @@ interface WixCartContext {
      * @returns Updated cart state
      */
     removeCoupon(): Promise<CartOperationResult>;
+    /**
+     * Create a Wix checkout redirect session and return the URL.
+     * Redirects the user to Wix's hosted checkout page.
+     */
+    checkout(): Promise<string>;
     onItemAddedToCart: EventEmitter<void, any>;
 }
 /**
@@ -253,7 +261,7 @@ declare const WIX_CART_CONTEXT: _jay_framework_runtime.ContextMarker<WixCartCont
  *
  * @returns The created context for immediate use (e.g., to call refreshCartIndicator)
  */
-declare function provideWixCartContext(): WixCartContext;
+declare function provideWixCartContext(thankYouUrl?: string): WixCartContext;
 
 interface CartIndicatorViewState {
   itemCount: number,
@@ -276,6 +284,10 @@ interface CartIndicatorRefs {
 
 interface WixCartService {
     cart: BuildDescriptors<typeof currentCart, {}>;
+    redirects: BuildDescriptors<typeof redirects, {}>;
+    urls: {
+        thankYou: string;
+    };
 }
 /**
  * Server service marker for Wix Cart.

package/dist/index.client.d.ts

@@ -1,4 +1,4 @@
-export { A as AddToCartOptions, q as CartIndicatorState, n as CartLineItem, C as CartOperationResult, l as CartState, o as CartSummary, R as ReactiveCartIndicator, b as WIX_CART_CONTEXT, c as WixCartContext, r as cartIndicator, s as cartPage, u as init, t as miniCart } from './index.client-DWB0MOQ0.js';
+export { A as AddToCartOptions, q as CartIndicatorState, n as CartLineItem, C as CartOperationResult, l as CartState, o as CartSummary, R as ReactiveCartIndicator, b as WIX_CART_CONTEXT, c as WixCartContext, r as cartIndicator, s as cartPage, u as init, t as miniCart } from './index.client-C7UwcsSn.js';
 import '@jay-framework/runtime';
 import '@jay-framework/reactive';
 import '@wix/ecom';
@@ -6,3 +6,4 @@ import '@wix/auto_sdk_ecom_current-cart';
 import '@wix/sdk-types';
 import '@jay-framework/fullstack-component';
 import '@jay-framework/component';
+import '@wix/redirects';

package/dist/index.client.js

@@ -11,6 +11,666 @@ function getCurrentCartClient(wixClient) {
   }
   return currentCartInstance;
 }
+const SDKRequestToRESTRequestRenameMap = {
+  _id: "id",
+  _createdDate: "createdDate",
+  _updatedDate: "updatedDate"
+};
+const RESTResponseToSDKResponseRenameMap = {
+  id: "_id",
+  createdDate: "_createdDate",
+  updatedDate: "_updatedDate"
+};
+function renameAllNestedKeys(payload, renameMap, ignorePaths) {
+  const isIgnored = (path) => ignorePaths.includes(path);
+  const traverse = (obj, path) => {
+    if (Array.isArray(obj)) {
+      obj.forEach((item) => {
+        traverse(item, path);
+      });
+    } else if (typeof obj === "object" && obj !== null) {
+      const objAsRecord = obj;
+      Object.keys(objAsRecord).forEach((key) => {
+        const newPath = path === "" ? key : `${path}.${key}`;
+        if (isIgnored(newPath)) {
+          return;
+        }
+        const transformedKey = renameKey(key, renameMap);
+        if (transformedKey !== key && !(transformedKey in objAsRecord)) {
+          objAsRecord[transformedKey] = objAsRecord[key];
+          delete objAsRecord[key];
+        }
+        traverse(objAsRecord[transformedKey], newPath);
+      });
+    }
+  };
+  traverse(payload, "");
+  return payload;
+}
+function renameKey(key, renameMap) {
+  let transformedKey;
+  if (key.includes(".")) {
+    const parts = key.split(".");
+    const transformedParts = parts.map((part) => renameMap[part] ?? part);
+    transformedKey = transformedParts.join(".");
+  } else {
+    transformedKey = renameMap[key] ?? key;
+  }
+  return transformedKey;
+}
+function renameKeysFromSDKRequestToRESTRequest(payload, ignorePaths = []) {
+  return renameAllNestedKeys(payload, SDKRequestToRESTRequestRenameMap, ignorePaths);
+}
+function renameKeysFromRESTResponseToSDKResponse(payload, ignorePaths = []) {
+  return renameAllNestedKeys(payload, RESTResponseToSDKResponseRenameMap, ignorePaths);
+}
+function transformRESTTimestampToSDKTimestamp(val) {
+  return val ? new Date(val) : void 0;
+}
+function transformPath(obj, { path, isRepeated, isMap }, transformFn) {
+  const pathParts = path.split(".");
+  if (pathParts.length === 1 && path in obj) {
+    obj[path] = isRepeated ? obj[path].map(transformFn) : isMap ? Object.fromEntries(Object.entries(obj[path]).map(([key, value]) => [key, transformFn(value)])) : transformFn(obj[path]);
+    return obj;
+  }
+  const [first, ...rest] = pathParts;
+  if (first.endsWith("{}")) {
+    const cleanPath = first.slice(0, -2);
+    obj[cleanPath] = Object.fromEntries(Object.entries(obj[cleanPath]).map(([key, value]) => [
+      key,
+      transformPath(value, { path: rest.join("."), isRepeated, isMap }, transformFn)
+    ]));
+  } else if (Array.isArray(obj[first])) {
+    obj[first] = obj[first].map((item) => transformPath(item, { path: rest.join("."), isRepeated, isMap }, transformFn));
+  } else if (first in obj && typeof obj[first] === "object" && obj[first] !== null) {
+    obj[first] = transformPath(obj[first], { path: rest.join("."), isRepeated, isMap }, transformFn);
+  } else if (first === "*") {
+    Object.keys(obj).reduce((acc, curr) => {
+      acc[curr] = transformPath(obj[curr], { path: rest.join("."), isRepeated, isMap }, transformFn);
+      return acc;
+    }, obj);
+  }
+  return obj;
+}
+function transformPaths(obj, transformations) {
+  return transformations.reduce((acc, { paths, transformFn }) => paths.reduce((transformerAcc, path) => transformPath(transformerAcc, path, transformFn), acc), obj);
+}
+function EventDefinition(type, isDomainEvent = false, transformations = (x) => x) {
+  return () => ({
+    __type: "event-definition",
+    type,
+    isDomainEvent,
+    transformations
+  });
+}
+function constantCase(input) {
+  return split(input).map((part) => part.toLocaleUpperCase()).join("_");
+}
+const SPLIT_LOWER_UPPER_RE = /([\p{Ll}\d])(\p{Lu})/gu;
+const SPLIT_UPPER_UPPER_RE = /(\p{Lu})([\p{Lu}][\p{Ll}])/gu;
+const SPLIT_REPLACE_VALUE = "$1\0$2";
+const DEFAULT_STRIP_REGEXP = /[^\p{L}\d]+/giu;
+function split(value) {
+  let result = value.trim();
+  result = result.replace(SPLIT_LOWER_UPPER_RE, SPLIT_REPLACE_VALUE).replace(SPLIT_UPPER_UPPER_RE, SPLIT_REPLACE_VALUE);
+  result = result.replace(DEFAULT_STRIP_REGEXP, "\0");
+  let start = 0;
+  let end = result.length;
+  while (result.charAt(start) === "\0") {
+    start++;
+  }
+  if (start === end) {
+    return [];
+  }
+  while (result.charAt(end - 1) === "\0") {
+    end--;
+  }
+  return result.slice(start, end).split(/\0/g);
+}
+const isValidationError = (httpClientError) => "validationError" in (httpClientError.response?.data?.details ?? {});
+const isApplicationError = (httpClientError) => "applicationError" in (httpClientError.response?.data?.details ?? {});
+const isClientError = (httpClientError) => (httpClientError.response?.status ?? -1) >= 400 && (httpClientError.response?.status ?? -1) < 500;
+function transformError(httpClientError, pathsToArguments = {
+  explicitPathsToArguments: {},
+  spreadPathsToArguments: {},
+  singleArgumentUnchanged: false
+}, argumentNames = []) {
+  if (typeof httpClientError !== "object" || httpClientError === null) {
+    throw httpClientError;
+  }
+  if (isValidationError(httpClientError)) {
+    return buildValidationError(httpClientError, pathsToArguments, argumentNames);
+  }
+  if (isApplicationError(httpClientError)) {
+    return buildApplicationError(httpClientError);
+  }
+  if (isClientError(httpClientError)) {
+    const status = httpClientError.response?.status;
+    const statusText = httpClientError.response?.statusText ?? "UNKNOWN";
+    const message = httpClientError.response?.data?.message ?? statusText;
+    const details = {
+      applicationError: {
+        description: statusText,
+        code: constantCase(statusText),
+        data: {}
+      },
+      requestId: httpClientError.requestId
+    };
+    return wrapError(httpClientError, {
+      message: JSON.stringify({
+        message,
+        details
+      }, null, 2),
+      extraProperties: {
+        details,
+        status
+      }
+    });
+  }
+  return buildSystemError(httpClientError);
+}
+const buildValidationError = (httpClientError, pathsToArguments, argumentNames) => {
+  const validationErrorResponse = httpClientError.response?.data;
+  const requestId = httpClientError.requestId;
+  const { fieldViolations } = validationErrorResponse.details.validationError;
+  const transformedFieldViolations = violationsWithRenamedFields(pathsToArguments, fieldViolations, argumentNames)?.sort((a, b) => a.field < b.field ? -1 : 1);
+  const message = `INVALID_ARGUMENT: ${transformedFieldViolations?.map(({ field, description }) => `"${field}" ${description}`)?.join(", ")}`;
+  const details = {
+    validationError: { fieldViolations: transformedFieldViolations },
+    requestId
+  };
+  return wrapError(httpClientError, {
+    message: JSON.stringify({ message, details }, null, 2),
+    extraProperties: {
+      details,
+      status: httpClientError.response?.status,
+      requestId
+    }
+  });
+};
+const wrapError = (baseError, { message, extraProperties }) => {
+  return Object.assign(baseError, {
+    ...extraProperties,
+    message
+  });
+};
+const buildApplicationError = (httpClientError) => {
+  const status = httpClientError.response?.status;
+  const statusText = httpClientError.response?.statusText ?? "UNKNOWN";
+  const message = httpClientError.response?.data?.message ?? statusText;
+  const description = httpClientError.response?.data?.details?.applicationError?.description ?? statusText;
+  const code = httpClientError.response?.data?.details?.applicationError?.code ?? constantCase(statusText);
+  const data = httpClientError.response?.data?.details?.applicationError?.data ?? {};
+  const combinedMessage = message === description ? message : `${message}: ${description}`;
+  const details = {
+    applicationError: {
+      description,
+      code,
+      data
+    },
+    requestId: httpClientError.requestId
+  };
+  return wrapError(httpClientError, {
+    message: JSON.stringify({ message: combinedMessage, details }, null, 2),
+    extraProperties: {
+      details,
+      status,
+      requestId: httpClientError.requestId
+    }
+  });
+};
+const buildSystemError = (httpClientError) => {
+  const message = httpClientError.requestId ? `System error occurred, request-id: ${httpClientError.requestId}` : `System error occurred: ${JSON.stringify(httpClientError)}`;
+  return wrapError(httpClientError, {
+    message,
+    extraProperties: {
+      requestId: httpClientError.requestId,
+      status: httpClientError.response?.status,
+      code: constantCase(httpClientError.response?.statusText ?? "UNKNOWN"),
+      ...!httpClientError.response && {
+        runtimeError: httpClientError
+      }
+    }
+  });
+};
+const violationsWithRenamedFields = ({ spreadPathsToArguments, explicitPathsToArguments, singleArgumentUnchanged }, fieldViolations, argumentNames) => {
+  const allPathsToArguments = {
+    ...spreadPathsToArguments,
+    ...explicitPathsToArguments
+  };
+  const allPathsToArgumentsKeys = Object.keys(allPathsToArguments);
+  return fieldViolations?.filter((fieldViolation) => {
+    const containedInAMoreSpecificViolationField = fieldViolations.some((anotherViolation) => anotherViolation.field.length > fieldViolation.field.length && anotherViolation.field.startsWith(fieldViolation.field) && allPathsToArgumentsKeys.includes(anotherViolation.field));
+    return !containedInAMoreSpecificViolationField;
+  }).map((fieldViolation) => {
+    const exactMatchArgumentExpression = explicitPathsToArguments[fieldViolation.field];
+    if (exactMatchArgumentExpression) {
+      return {
+        ...fieldViolation,
+        field: withRenamedArgument(exactMatchArgumentExpression, argumentNames)
+      };
+    }
+    const longestPartialPathMatch = allPathsToArgumentsKeys?.sort((a, b) => b.length - a.length)?.find((path) => fieldViolation.field.startsWith(path));
+    if (longestPartialPathMatch) {
+      const partialMatchArgumentExpression = allPathsToArguments[longestPartialPathMatch];
+      if (partialMatchArgumentExpression) {
+        return {
+          ...fieldViolation,
+          field: fieldViolation.field.replace(longestPartialPathMatch, withRenamedArgument(partialMatchArgumentExpression, argumentNames))
+        };
+      }
+    }
+    if (singleArgumentUnchanged) {
+      return {
+        ...fieldViolation,
+        field: `${argumentNames[0]}.${fieldViolation.field}`
+      };
+    }
+    return fieldViolation;
+  });
+};
+const withRenamedArgument = (fieldValue, argumentNames) => {
+  const argIndex = getArgumentIndex(fieldValue);
+  if (argIndex !== null && typeof argIndex !== "undefined") {
+    return fieldValue.replace(`$[${argIndex}]`, argumentNames[argIndex]);
+  }
+  return fieldValue;
+};
+const getArgumentIndex = (s) => {
+  const match = s.match(/\$\[(?<argIndex>\d+)\]/);
+  return match && match.groups && Number(match.groups.argIndex);
+};
+var wixContext = {};
+function resolveContext() {
+  const oldContext = typeof $wixContext !== "undefined" && $wixContext.initWixModules ? $wixContext.initWixModules : typeof globalThis.__wix_context__ !== "undefined" && globalThis.__wix_context__.initWixModules ? globalThis.__wix_context__.initWixModules : void 0;
+  if (oldContext) {
+    return {
+      // @ts-expect-error
+      initWixModules(modules, elevated) {
+        return runWithoutContext(() => oldContext(modules, elevated));
+      },
+      fetchWithAuth() {
+        throw new Error("fetchWithAuth is not available in this context");
+      },
+      graphql() {
+        throw new Error("graphql is not available in this context");
+      }
+    };
+  }
+  const contextualClient = typeof $wixContext !== "undefined" ? $wixContext.client : typeof wixContext.client !== "undefined" ? wixContext.client : typeof globalThis.__wix_context__ !== "undefined" ? globalThis.__wix_context__.client : void 0;
+  const elevatedClient = typeof $wixContext !== "undefined" ? $wixContext.elevatedClient : typeof wixContext.elevatedClient !== "undefined" ? wixContext.elevatedClient : typeof globalThis.__wix_context__ !== "undefined" ? globalThis.__wix_context__.elevatedClient : void 0;
+  if (!contextualClient && !elevatedClient) {
+    return;
+  }
+  return {
+    initWixModules(wixModules, elevated) {
+      if (elevated) {
+        if (!elevatedClient) {
+          throw new Error("An elevated client is required to use elevated modules. Make sure to initialize the Wix context with an elevated client before using elevated SDK modules");
+        }
+        return runWithoutContext(() => elevatedClient.use(wixModules));
+      }
+      if (!contextualClient) {
+        throw new Error("Wix context is not available. Make sure to initialize the Wix context before using SDK modules");
+      }
+      return runWithoutContext(() => contextualClient.use(wixModules));
+    },
+    fetchWithAuth: (urlOrRequest, requestInit) => {
+      if (!contextualClient) {
+        throw new Error("Wix context is not available. Make sure to initialize the Wix context before using SDK modules");
+      }
+      return contextualClient.fetchWithAuth(urlOrRequest, requestInit);
+    },
+    getAuth() {
+      if (!contextualClient) {
+        throw new Error("Wix context is not available. Make sure to initialize the Wix context before using SDK modules");
+      }
+      return contextualClient.auth;
+    },
+    async graphql(query, variables, opts) {
+      if (!contextualClient) {
+        throw new Error("Wix context is not available. Make sure to initialize the Wix context before using SDK modules");
+      }
+      return contextualClient.graphql(query, variables, opts);
+    }
+  };
+}
+function runWithoutContext(fn) {
+  const globalContext = globalThis.__wix_context__;
+  const moduleContext = {
+    client: wixContext.client,
+    elevatedClient: wixContext.elevatedClient
+  };
+  let closureContext;
+  globalThis.__wix_context__ = void 0;
+  wixContext.client = void 0;
+  wixContext.elevatedClient = void 0;
+  if (typeof $wixContext !== "undefined") {
+    closureContext = {
+      client: $wixContext?.client,
+      elevatedClient: $wixContext?.elevatedClient
+    };
+    delete $wixContext.client;
+    delete $wixContext.elevatedClient;
+  }
+  try {
+    return fn();
+  } finally {
+    globalThis.__wix_context__ = globalContext;
+    wixContext.client = moduleContext.client;
+    wixContext.elevatedClient = moduleContext.elevatedClient;
+    if (typeof $wixContext !== "undefined") {
+      $wixContext.client = closureContext.client;
+      $wixContext.elevatedClient = closureContext.elevatedClient;
+    }
+  }
+}
+function contextualizeRESTModuleV2(restModule, elevated) {
+  return (...args) => {
+    const context = resolveContext();
+    if (!context) {
+      return restModule.apply(void 0, args);
+    }
+    return context.initWixModules(restModule, elevated).apply(void 0, args);
+  };
+}
+function contextualizeEventDefinitionModuleV2(eventDefinition) {
+  const contextualMethod = (...args) => {
+    const context = resolveContext();
+    if (!context) {
+      return () => {
+        return {
+          slug: eventDefinition.type
+        };
+      };
+    }
+    return context.initWixModules(eventDefinition).apply(void 0, args);
+  };
+  contextualMethod.__type = eventDefinition.__type;
+  contextualMethod.type = eventDefinition.type;
+  contextualMethod.isDomainEvent = eventDefinition.isDomainEvent;
+  contextualMethod.transformations = eventDefinition.transformations;
+  return contextualMethod;
+}
+function createRESTModule(descriptor, elevated = false) {
+  return contextualizeRESTModuleV2(descriptor, elevated);
+}
+function resolveUrl(opts) {
+  const domain = resolveDomain(opts.host);
+  const mappings = resolveMappingsByDomain(domain, opts.domainToMappings);
+  const path = injectDataIntoProtoPath(opts.protoPath, opts.data || {});
+  return resolvePathFromMappings(path, mappings);
+}
+const DOMAINS = ["wix.com", "editorx.com"];
+const USER_DOMAIN = "_";
+const REGEX_CAPTURE_DOMAINS = new RegExp(`\\.(${DOMAINS.join("|")})$`);
+const WIX_API_DOMAINS = ["42.wixprod.net", "uw2-edt-1.wixprod.net"];
+const DEV_WIX_CODE_DOMAIN = "dev.wix-code.com";
+const REGEX_CAPTURE_PROTO_FIELD = /{(.*)}/;
+const REGEX_CAPTURE_API_DOMAINS = new RegExp(`\\.(${WIX_API_DOMAINS.join("|")})$`);
+const REGEX_CAPTURE_DEV_WIX_CODE_DOMAIN = new RegExp(`.*\\.${DEV_WIX_CODE_DOMAIN}$`);
+function resolveDomain(host) {
+  const resolvedHost = fixHostExceptions(host);
+  return resolvedHost.replace(REGEX_CAPTURE_DOMAINS, "._base_domain_").replace(REGEX_CAPTURE_API_DOMAINS, "._api_base_domain_").replace(REGEX_CAPTURE_DEV_WIX_CODE_DOMAIN, "*.dev.wix-code.com");
+}
+function fixHostExceptions(host) {
+  return host.replace("create.editorx.com", "editor.editorx.com");
+}
+function resolveMappingsByDomain(domain, domainToMappings) {
+  const mappings = domainToMappings[domain] || domainToMappings[USER_DOMAIN];
+  if (mappings) {
+    return mappings;
+  }
+  const rootDomainMappings = resolveRootDomain(domain, domainToMappings);
+  if (!rootDomainMappings) {
+    if (isBaseDomain(domain)) {
+      return domainToMappings[wwwBaseDomain];
+    }
+  }
+  return rootDomainMappings ?? [];
+}
+function resolveRootDomain(domain, domainToMappings) {
+  return Object.entries(domainToMappings).find(([entryDomain]) => {
+    const [, ...rooDomainSegments] = domain.split(".");
+    return rooDomainSegments.join(".") === entryDomain;
+  })?.[1];
+}
+function isBaseDomain(domain) {
+  return !!domain.match(/\._base_domain_$/);
+}
+const wwwBaseDomain = "www._base_domain_";
+function injectDataIntoProtoPath(protoPath, data) {
+  return protoPath.split("/").map((path) => maybeProtoPathToData(path, data)).join("/");
+}
+function maybeProtoPathToData(protoPath, data) {
+  const protoRegExpMatch = protoPath.match(REGEX_CAPTURE_PROTO_FIELD) || [];
+  const field = protoRegExpMatch[1];
+  if (field) {
+    const suffix = protoPath.replace(protoRegExpMatch[0], "");
+    return findByPath(data, field, protoPath, suffix);
+  }
+  return protoPath;
+}
+function findByPath(obj, path, defaultValue, suffix) {
+  let result = obj;
+  for (const field of path.split(".")) {
+    if (!result) {
+      return defaultValue;
+    }
+    result = result[field];
+  }
+  return `${result}${suffix}`;
+}
+function resolvePathFromMappings(protoPath, mappings) {
+  const mapping = mappings?.find((m) => protoPath.startsWith(m.destPath));
+  if (!mapping) {
+    return protoPath;
+  }
+  return mapping.srcPath + protoPath.slice(mapping.destPath.length);
+}
+function createEventModule(eventDefinition) {
+  return contextualizeEventDefinitionModuleV2(eventDefinition);
+}
+function resolveWixHeadlessV1RedirectSessionServiceUrl(opts) {
+  const domainToMappings = {
+    "www._base_domain_": [
+      {
+        srcPath: "/_api/redirects-api",
+        destPath: ""
+      }
+    ],
+    "www.wixapis.com": [
+      {
+        srcPath: "/_api/redirects-api",
+        destPath: ""
+      },
+      {
+        srcPath: "/redirect-session",
+        destPath: ""
+      },
+      {
+        srcPath: "/headless/v1/redirect-session",
+        destPath: "/v1/redirect-session"
+      }
+    ],
+    "*.dev.wix-code.com": [
+      {
+        srcPath: "/headless/v1/redirect-session",
+        destPath: "/v1/redirect-session"
+      }
+    ],
+    _: [
+      {
+        srcPath: "/headless/v1/redirect-session",
+        destPath: "/v1/redirect-session"
+      }
+    ]
+  };
+  return resolveUrl(Object.assign(opts, { domainToMappings }));
+}
+var PACKAGE_NAME = "@wix/auto_sdk_redirects_redirects";
+function createRedirectSession(payload) {
+  function __createRedirectSession({ host }) {
+    const metadata = {
+      entityFqdn: "wix.headless.v1.redirect_session",
+      method: "POST",
+      methodFqn: "wix.headless.v1.RedirectSessionService.CreateRedirectSession",
+      packageName: PACKAGE_NAME,
+      migrationOptions: {
+        optInTransformResponse: true
+      },
+      url: resolveWixHeadlessV1RedirectSessionServiceUrl({
+        protoPath: "/v1/redirect-session",
+        data: payload,
+        host
+      }),
+      data: payload
+    };
+    return metadata;
+  }
+  return __createRedirectSession;
+}
+var LocationType = /* @__PURE__ */ ((LocationType2) => {
+  LocationType2["UNDEFINED"] = "UNDEFINED";
+  LocationType2["OWNER_BUSINESS"] = "OWNER_BUSINESS";
+  LocationType2["OWNER_CUSTOM"] = "OWNER_CUSTOM";
+  LocationType2["CUSTOM"] = "CUSTOM";
+  return LocationType2;
+})(LocationType || {});
+var Prompt = /* @__PURE__ */ ((Prompt2) => {
+  Prompt2["login"] = "login";
+  Prompt2["none"] = "none";
+  Prompt2["consent"] = "consent";
+  Prompt2["select_account"] = "select_account";
+  return Prompt2;
+})(Prompt || {});
+var MembersAccountSection = /* @__PURE__ */ ((MembersAccountSection2) => {
+  MembersAccountSection2["ACCOUNT_INFO"] = "ACCOUNT_INFO";
+  MembersAccountSection2["BOOKINGS"] = "BOOKINGS";
+  MembersAccountSection2["ORDERS"] = "ORDERS";
+  MembersAccountSection2["SUBSCRIPTIONS"] = "SUBSCRIPTIONS";
+  MembersAccountSection2["EVENTS"] = "EVENTS";
+  return MembersAccountSection2;
+})(MembersAccountSection || {});
+var AttachPagesResponseStatus = /* @__PURE__ */ ((AttachPagesResponseStatus2) => {
+  AttachPagesResponseStatus2["UNKNOWN"] = "UNKNOWN";
+  AttachPagesResponseStatus2["SUCCESS"] = "SUCCESS";
+  AttachPagesResponseStatus2["NO_ACTION"] = "NO_ACTION";
+  AttachPagesResponseStatus2["ERROR"] = "ERROR";
+  return AttachPagesResponseStatus2;
+})(AttachPagesResponseStatus || {});
+var CallbackType = /* @__PURE__ */ ((CallbackType2) => {
+  CallbackType2["UNKNOWN"] = "UNKNOWN";
+  CallbackType2["LOGOUT"] = "LOGOUT";
+  CallbackType2["CHECKOUT"] = "CHECKOUT";
+  CallbackType2["AUTHORIZE"] = "AUTHORIZE";
+  return CallbackType2;
+})(CallbackType || {});
+var Status = /* @__PURE__ */ ((Status2) => {
+  Status2["UNKNOWN"] = "UNKNOWN";
+  Status2["SUCCESS"] = "SUCCESS";
+  Status2["ERROR"] = "ERROR";
+  return Status2;
+})(Status || {});
+var WebhookIdentityType = /* @__PURE__ */ ((WebhookIdentityType2) => {
+  WebhookIdentityType2["UNKNOWN"] = "UNKNOWN";
+  WebhookIdentityType2["ANONYMOUS_VISITOR"] = "ANONYMOUS_VISITOR";
+  WebhookIdentityType2["MEMBER"] = "MEMBER";
+  WebhookIdentityType2["WIX_USER"] = "WIX_USER";
+  WebhookIdentityType2["APP"] = "APP";
+  return WebhookIdentityType2;
+})(WebhookIdentityType || {});
+async function createRedirectSession2(options) {
+  const { httpClient, sideEffects } = arguments[1];
+  const payload = renameKeysFromSDKRequestToRESTRequest({
+    bookingsCheckout: options?.bookingsCheckout,
+    ecomCheckout: options?.ecomCheckout,
+    eventsCheckout: options?.eventsCheckout,
+    paidPlansCheckout: options?.paidPlansCheckout,
+    login: options?.login,
+    logout: options?.logout,
+    auth: options?.auth,
+    storesProduct: options?.storesProduct,
+    bookingsBook: options?.bookingsBook,
+    callbacks: options?.callbacks,
+    preferences: options?.preferences,
+    origin: options?.origin
+  });
+  const reqOpts = createRedirectSession(payload);
+  sideEffects?.onSiteCall?.();
+  try {
+    const result = await httpClient.request(reqOpts);
+    sideEffects?.onSuccess?.(result);
+    return renameKeysFromRESTResponseToSDKResponse(result.data);
+  } catch (err) {
+    const transformedError = transformError(
+      err,
+      {
+        spreadPathsToArguments: {},
+        explicitPathsToArguments: {
+          bookingsCheckout: "$[0].bookingsCheckout",
+          ecomCheckout: "$[0].ecomCheckout",
+          eventsCheckout: "$[0].eventsCheckout",
+          paidPlansCheckout: "$[0].paidPlansCheckout",
+          login: "$[0].login",
+          logout: "$[0].logout",
+          auth: "$[0].auth",
+          storesProduct: "$[0].storesProduct",
+          bookingsBook: "$[0].bookingsBook",
+          callbacks: "$[0].callbacks",
+          preferences: "$[0].preferences",
+          origin: "$[0].origin"
+        },
+        singleArgumentUnchanged: false
+      },
+      ["options"]
+    );
+    sideEffects?.onError?.(err);
+    throw transformedError;
+  }
+}
+function createRedirectSession3(httpClient) {
+  return (options) => createRedirectSession2(
+    options,
+    // @ts-ignore
+    { httpClient }
+  );
+}
+var onRedirectSessionCreated = EventDefinition(
+  "wix.headless.v1.redirect_session_created",
+  true,
+  (event) => renameKeysFromRESTResponseToSDKResponse(
+    transformPaths(event, [
+      {
+        transformFn: transformRESTTimestampToSDKTimestamp,
+        paths: [{ path: "metadata.eventTime" }]
+      }
+    ])
+  )
+)();
+var createRedirectSession4 = /* @__PURE__ */ createRESTModule(createRedirectSession3);
+var onRedirectSessionCreated2 = createEventModule(
+  onRedirectSessionCreated
+);
+const redirects = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  AttachPagesResponseStatus,
+  CallbackType,
+  LocationType,
+  MembersAccountSection,
+  Prompt,
+  Status,
+  WebhookIdentityType,
+  createRedirectSession: createRedirectSession4,
+  onRedirectSessionCreated: onRedirectSessionCreated2
+}, Symbol.toStringTag, { value: "Module" }));
+let redirectsInstance;
+function getRedirectsClient(wixClient) {
+  if (!redirectsInstance) {
+    redirectsInstance = wixClient.use(redirects);
+  }
+  return redirectsInstance;
+}
 function parseWixMediaUrl(url) {
   if (!url) return null;
   const match = url.match(
@@ -252,10 +912,11 @@ function mapEstimateTotalsToState(estimate) {
 }
 const WIX_STORES_APP_ID = "215238eb-22a5-4c36-9e7b-e7c08025e04e";
 const WIX_CART_CONTEXT = createJayContext("wix:cart");
-function provideWixCartContext() {
+function provideWixCartContext(thankYouUrl = "/thank-you") {
   const wixClientContext = useGlobalContext(WIX_CLIENT_CONTEXT);
   const wixClient = wixClientContext.client;
   const cartClient = getCurrentCartClient(wixClient);
+  const redirectsClient = getRedirectsClient(wixClient);
   const cartContext = registerReactiveGlobalContext(WIX_CART_CONTEXT, () => {
     const [itemCount, setItemCount] = createSignal(0);
     const [hasItems, setHasItems] = createSignal(false);
@@ -335,6 +996,19 @@ function provideWixCartContext() {
       updateIndicatorFromCart(result.cart ?? null);
       return { cartState: mapCartToState(result.cart ?? null) };
     }
+    async function checkout() {
+      const { checkoutId } = await cartClient.createCheckoutFromCurrentCart({});
+      if (!checkoutId) throw new Error("Failed to create checkout from cart");
+      const postFlowUrl = window.location.origin + thankYouUrl;
+      const { redirectSession } = await redirectsClient.createRedirectSession({
+        ecomCheckout: { checkoutId },
+        callbacks: { postFlowUrl }
+      });
+      if (!redirectSession?.fullUrl) {
+        throw new Error("Failed to create checkout redirect session");
+      }
+      return redirectSession.fullUrl;
+    }
     return {
       cartIndicator: {
         itemCount,
@@ -348,6 +1022,7 @@ function provideWixCartContext() {
       clearCart,
       applyCoupon,
       removeCoupon,
+      checkout,
       onItemAddedToCart
     };
   });
@@ -507,7 +1182,13 @@ function CartPageInteractive(_props, refs, viewStateSignals, _carryForward, cart
   }
   async function handleCheckout() {
     setIsCheckingOut(true);
-    window.location.href = "/checkout";
+    try {
+      const checkoutUrl = await cartContext.checkout();
+      window.location.href = checkoutUrl;
+    } catch (e) {
+      console.error("[wix-cart] Checkout redirect failed:", e);
+      setIsCheckingOut(false);
+    }
   }
   refs.clearCartButton?.onclick(handleClearCart);
   refs.checkoutButton?.onclick(handleCheckout);
@@ -567,8 +1248,8 @@ function MiniCartInteractive(_props, refs, viewStateSignals, _carryForward, cart
 const miniCart = makeJayStackComponent().withProps().withContexts(WIX_CART_CONTEXT).withInteractive(MiniCartInteractive);
 const init = makeJayInit().withClient(async (data) => {
   console.log("[wix-cart] Initializing client-side cart context...");
-  const { enableClientCart } = data;
-  const cartContext = provideWixCartContext();
+  const { enableClientCart, thankYouUrl } = data;
+  const cartContext = provideWixCartContext(thankYouUrl);
   if (enableClientCart) {
     cartContext.refreshCartIndicator();
   }

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { WixClient } from '@wix/sdk';
-import { W as WixCartService } from './index.client-DWB0MOQ0.js';
-export { A as AddToCartOptions, q as CartIndicatorState, n as CartLineItem, C as CartOperationResult, l as CartState, o as CartSummary, R as ReactiveCartIndicator, b as WIX_CART_CONTEXT, a as WIX_CART_SERVICE, c as WixCartContext, d as WixCartInitData, r as cartIndicator, s as cartPage, j as estimateCurrentCartTotalsOrNull, i as getCurrentCartOrNull, h as getEmptyCartState, u as init, e as mapCartSummary, g as mapCartToIndicator, f as mapCartToState, k as mapEstimateTotalsToState, m as mapLineItem, t as miniCart, p as provideWixCartContext } from './index.client-DWB0MOQ0.js';
+import { W as WixCartService } from './index.client-C7UwcsSn.js';
+export { A as AddToCartOptions, q as CartIndicatorState, n as CartLineItem, C as CartOperationResult, l as CartState, o as CartSummary, R as ReactiveCartIndicator, b as WIX_CART_CONTEXT, a as WIX_CART_SERVICE, c as WixCartContext, d as WixCartInitData, r as cartIndicator, s as cartPage, j as estimateCurrentCartTotalsOrNull, i as getCurrentCartOrNull, h as getEmptyCartState, u as init, e as mapCartSummary, g as mapCartToIndicator, f as mapCartToState, k as mapEstimateTotalsToState, m as mapLineItem, t as miniCart, p as provideWixCartContext } from './index.client-C7UwcsSn.js';
 import { currentCart } from '@wix/ecom';
 import { BuildDescriptors } from '@wix/sdk-types';
 import '@jay-framework/runtime';
@@ -8,6 +8,7 @@ import '@jay-framework/reactive';
 import '@wix/auto_sdk_ecom_current-cart';
 import '@jay-framework/fullstack-component';
 import '@jay-framework/component';
+import '@wix/redirects';
 
 /**
  * Wix Cart Client Factory
@@ -33,10 +34,15 @@ declare function getCurrentCartClient(wixClient: WixClient): BuildDescriptors<ty
  * This file contains server-only code (registerService).
  */
 
+interface WixCartServiceOptions {
+    urls?: {
+        thankYou?: string;
+    };
+}
 /**
  * Creates, registers, and returns a Wix Cart service instance.
  * Called during server initialization.
  */
-declare function provideWixCartService(wixClient: WixClient): WixCartService;
+declare function provideWixCartService(wixClient: WixClient, options?: WixCartServiceOptions): WixCartService;
 
 export { WixCartService, getCurrentCartClient, provideWixCartService };

package/dist/index.js

@@ -1,9 +1,13 @@
 import { registerService, getService } from "@jay-framework/stack-server-runtime";
 import { currentCart } from "@wix/ecom";
+import { redirects } from "@wix/redirects";
 import { createJayService, makeJayStackComponent, RenderPipeline, makeJayInit } from "@jay-framework/fullstack-component";
 import { createJayContext, useGlobalContext } from "@jay-framework/runtime";
 import { registerReactiveGlobalContext, createSignal, useReactive, createEvent } from "@jay-framework/component";
 import { WIX_CLIENT_CONTEXT, WIX_CLIENT_SERVICE } from "@jay-framework/wix-server-client";
+import * as fs from "fs";
+import * as path from "path";
+import * as yaml from "js-yaml";
 let currentCartInstance;
 function getCurrentCartClient(wixClient) {
   if (!currentCartInstance) {
@@ -11,10 +15,19 @@ function getCurrentCartClient(wixClient) {
   }
   return currentCartInstance;
 }
+let redirectsInstance;
+function getRedirectsClient(wixClient) {
+  if (!redirectsInstance) {
+    redirectsInstance = wixClient.use(redirects);
+  }
+  return redirectsInstance;
+}
 const WIX_CART_SERVICE = createJayService("Wix Cart Service");
-function provideWixCartService(wixClient) {
+function provideWixCartService(wixClient, options) {
   const service = {
-    cart: getCurrentCartClient(wixClient)
+    cart: getCurrentCartClient(wixClient),
+    redirects: getRedirectsClient(wixClient),
+    urls: { thankYou: options?.urls?.thankYou || "/thank-you" }
   };
   registerService(WIX_CART_SERVICE, service);
   return service;
@@ -260,10 +273,11 @@ function mapEstimateTotalsToState(estimate) {
 }
 const WIX_STORES_APP_ID = "215238eb-22a5-4c36-9e7b-e7c08025e04e";
 const WIX_CART_CONTEXT = createJayContext("wix:cart");
-function provideWixCartContext() {
+function provideWixCartContext(thankYouUrl = "/thank-you") {
   const wixClientContext = useGlobalContext(WIX_CLIENT_CONTEXT);
   const wixClient = wixClientContext.client;
   const cartClient = getCurrentCartClient(wixClient);
+  const redirectsClient = getRedirectsClient(wixClient);
   const cartContext = registerReactiveGlobalContext(WIX_CART_CONTEXT, () => {
     const [itemCount, setItemCount] = createSignal(0);
     const [hasItems, setHasItems] = createSignal(false);
@@ -343,6 +357,19 @@ function provideWixCartContext() {
       updateIndicatorFromCart(result.cart ?? null);
       return { cartState: mapCartToState(result.cart ?? null) };
     }
+    async function checkout() {
+      const { checkoutId } = await cartClient.createCheckoutFromCurrentCart({});
+      if (!checkoutId) throw new Error("Failed to create checkout from cart");
+      const postFlowUrl = window.location.origin + thankYouUrl;
+      const { redirectSession } = await redirectsClient.createRedirectSession({
+        ecomCheckout: { checkoutId },
+        callbacks: { postFlowUrl }
+      });
+      if (!redirectSession?.fullUrl) {
+        throw new Error("Failed to create checkout redirect session");
+      }
+      return redirectSession.fullUrl;
+    }
     return {
       cartIndicator: {
         itemCount,
@@ -356,6 +383,7 @@ function provideWixCartContext() {
       clearCart,
       applyCoupon,
       removeCoupon,
+      checkout,
       onItemAddedToCart
     };
   });
@@ -429,13 +457,32 @@ async function renderFastChanging(_props, _wixCart) {
   }));
 }
 const miniCart = makeJayStackComponent().withProps().withServices(WIX_CART_SERVICE).withFastRender(renderFastChanging);
+function loadWixCartConfig() {
+  const configPath = path.join(process.cwd(), "config", ".wix-cart.yaml");
+  const defaults = {
+    urls: { thankYou: "/thank-you" }
+  };
+  if (!fs.existsSync(configPath)) return defaults;
+  try {
+    const raw = yaml.load(fs.readFileSync(configPath, "utf-8"));
+    return {
+      urls: {
+        thankYou: raw?.urls?.thankYou || defaults.urls.thankYou
+      }
+    };
+  } catch {
+    return defaults;
+  }
+}
 const init = makeJayInit().withServer(async () => {
   console.log("[wix-cart] Initializing Wix Cart service...");
   const wixClient = getService(WIX_CLIENT_SERVICE);
-  provideWixCartService(wixClient);
+  const config = loadWixCartConfig();
+  provideWixCartService(wixClient, { urls: config.urls });
   console.log("[wix-cart] Server initialization complete");
   return {
-    enableClientCart: true
+    enableClientCart: true,
+    thankYouUrl: config.urls.thankYou
   };
 });
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/wix-cart",
-  "version": "0.18.4",
+  "version": "0.19.1",
   "type": "module",
   "description": "Wix Cart/Ecom shared package for Jay Framework",
   "license": "Apache-2.0",
@@ -37,16 +37,17 @@
     "test": ":"
   },
   "dependencies": {
-    "@jay-framework/component": "^0.18.4",
-    "@jay-framework/fullstack-component": "^0.18.4",
-    "@jay-framework/reactive": "^0.18.4",
-    "@jay-framework/runtime": "^0.18.4",
-    "@jay-framework/secure": "^0.18.4",
-    "@jay-framework/stack-client-runtime": "^0.18.4",
-    "@jay-framework/stack-server-runtime": "^0.18.4",
-    "@jay-framework/wix-server-client": "^0.18.4",
-    "@jay-framework/wix-utils": "^0.18.4",
+    "@jay-framework/component": "^0.19.1",
+    "@jay-framework/fullstack-component": "^0.19.1",
+    "@jay-framework/reactive": "^0.19.1",
+    "@jay-framework/runtime": "^0.19.1",
+    "@jay-framework/secure": "^0.19.1",
+    "@jay-framework/stack-client-runtime": "^0.19.1",
+    "@jay-framework/stack-server-runtime": "^0.19.1",
+    "@jay-framework/wix-server-client": "^0.19.1",
+    "@jay-framework/wix-utils": "^0.19.1",
     "@wix/ecom": "^1.0.1996",
+    "@wix/redirects": "^1.0.77",
     "@wix/sdk": "^1.21.5",
     "@wix/sdk-runtime": "^1.0.11"
   },
@@ -54,9 +55,9 @@
     "@babel/core": "^7.23.7",
     "@babel/preset-env": "^7.23.8",
     "@babel/preset-typescript": "^7.23.3",
-    "@jay-framework/compiler-jay-stack": "^0.18.4",
-    "@jay-framework/jay-cli": "^0.18.4",
-    "@jay-framework/vite-plugin": "^0.18.4",
+    "@jay-framework/compiler-jay-stack": "^0.19.1",
+    "@jay-framework/jay-cli": "^0.19.1",
+    "@jay-framework/vite-plugin": "^0.19.1",
     "@jay-framework/wix-dev-environment": "^0.6.12",
     "nodemon": "^3.0.3",
     "rimraf": "^5.0.5",