@wix/headless-stores 0.0.36 → 0.0.37

package/cjs/dist/services/category-service.js

@@ -1,156 +1,147 @@
 import { defineService, implementService } from "@wix/services-definitions";
+import { categories } from "@wix/categories";
 import { SignalsServiceDefinition, } from "@wix/services-definitions/core-services/signals";
-import * as categories from "@wix/auto_sdk_categories_categories";
-export const CategoryServiceDefinition = defineService("category-service");
+/**
+ * Service definition for the Category service.
+ * This defines the reactive API contract for managing a single product category.
+ *
+ * @constant
+ */
+export const CategoryServiceDefinition = defineService("category");
+/**
+ * Implementation of the Category service that manages reactive category data.
+ * This service provides a signal for category data and maintains it in a reactive state.
+ * The service is initialized with pre-loaded category data.
+ *
+ * @example
+ * ```tsx
+ * import { CategoryService, CategoryServiceDefinition } from '@wix/stores/services';
+ * import { useService } from '@wix/services-manager-react';
+ *
+ * function CategoryComponent({ categoryConfig }) {
+ *   return (
+ *     <ServiceProvider services={createServicesMap([
+ *       [CategoryServiceDefinition, CategoryService.withConfig(categoryConfig)]
+ *     ])}>
+ *       <CategoryDisplay />
+ *     </ServiceProvider>
+ *   );
+ * }
+ *
+ * function CategoryDisplay() {
+ *   const categoryService = useService(CategoryServiceDefinition);
+ *   const category = categoryService.category.get();
+ *
+ *   return (
+ *     <div>
+ *       <h1>{category.name}</h1>
+ *       <p>{category.description}</p>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
 export const CategoryService = implementService.withConfig()(CategoryServiceDefinition, ({ getService, config }) => {
     const signalsService = getService(SignalsServiceDefinition);
-    const selectedCategory = signalsService.signal((config?.initialCategoryId || null));
-    const categories = signalsService.signal(config?.categories);
-    const loadCategories = async () => {
-        const { categories: loadedCategories } = await loadCategoriesConfig();
-        categories.set(loadedCategories);
-    };
-    // Track if this is the initial load to prevent navigation on service creation
-    let isInitialLoad = true;
-    const setSelectedCategory = (categoryId) => {
-        selectedCategory.set(categoryId);
-    };
-    // Subscribe to category changes and handle navigation as a side effect
-    signalsService.effect(() => {
-        const categoryId = selectedCategory.get();
-        // Skip navigation on initial load (when service is first created)
-        if (isInitialLoad) {
-            isInitialLoad = false;
-            return;
-        }
-        // If a navigation handler is provided, use it
-        if (config?.onCategoryChange) {
-            const category = categoryId
-                ? config?.categories.find((cat) => cat._id === categoryId) || null
-                : null;
-            config.onCategoryChange(categoryId, category);
-        }
-    });
+    const categorySignal = signalsService.signal(config.category);
     return {
-        selectedCategory,
-        categories,
-        setSelectedCategory,
-        loadCategories,
+        category: categorySignal,
     };
 });
 /**
- * Loads categories configuration from the Wix Categories API for SSR initialization.
+ * Loads category service configuration from the Wix Categories API for SSR initialization.
  * This function is designed to be used during Server-Side Rendering (SSR) to preload
- * initial categories data that will be passed to the Category.Root component.
- * Fetches all visible categories and sorts them with "all-products" category first.
+ * a specific category by slug that will be used to configure the CategoryService.
  *
- * @returns Promise that resolves to an object containing categories array
+ * @param {string} slug - The category slug to load
+ * @returns {Promise} Promise that resolves to either success with config or not-found result
  *
  * @example
  * ```astro
  * ---
- * // Astro page example - pages/categories.astro
- * import { loadCategoriesConfig } from '@wix/stores/services';
+ * // Astro page example - pages/category/[slug].astro
+ * import { loadCategoryServiceConfig } from '@wix/stores/services';
  * import { Category } from '@wix/stores/components';
  *
- * // Load categories data during SSR
- * const categoryConfig = await loadCategoriesConfig();
+ * // Get category slug from URL params
+ * const { slug } = Astro.params;
+ *
+ * // Load category data during SSR
+ * const categoryResult = await loadCategoryServiceConfig(slug);
+ *
+ * // Handle not found case
+ * if (categoryResult.type === 'not-found') {
+ *   return Astro.redirect('/404');
+ * }
  * ---
  *
- * <Category.Root categoryConfig={categoryConfig}>
- *   <Category.List>
- *     {({ categories, selectedCategory, setSelectedCategory }) => (
- *       <nav className="category-nav">
- *         <h2>Shop by Category</h2>
- *         {categories.map(category => (
- *           <button
- *             key={category.id}
- *             onClick={() => setSelectedCategory(category.id)}
- *             className={selectedCategory === category.id ? 'active' : ''}
- *           >
- *             {category.name}
- *           </button>
- *         ))}
- *       </nav>
- *     )}
- *   </Category.List>
+ * <Category.Root categoryConfig={categoryResult.config}>
+ *   <Category.Name>
+ *     {({ name }) => <h1>{name}</h1>}
+ *   </Category.Name>
  * </Category.Root>
  * ```
  *
  * @example
  * ```tsx
- * // Next.js page example - pages/categories.tsx
+ * // Next.js page example - pages/category/[slug].tsx
  * import { GetServerSideProps } from 'next';
- * import { loadCategoriesConfig } from '@wix/stores/services';
+ * import { loadCategoryServiceConfig } from '@wix/stores/services';
  * import { Category } from '@wix/stores/components';
  *
  * interface CategoryPageProps {
- *   categoryConfig: Awaited<ReturnType<typeof loadCategoriesConfig>>;
+ *   categoryConfig: Awaited<ReturnType<typeof loadCategoryServiceConfig>>['config'];
  * }
  *
- * export const getServerSideProps: GetServerSideProps<CategoryPageProps> = async () => {
- *   // Load categories data during SSR
- *   const categoryConfig = await loadCategoriesConfig();
+ * export const getServerSideProps: GetServerSideProps<CategoryPageProps> = async ({ params }) => {
+ *   const slug = params?.slug as string;
+ *
+ *   // Load category data during SSR
+ *   const categoryResult = await loadCategoryServiceConfig(slug);
+ *
+ *   // Handle not found case
+ *   if (categoryResult.type === 'not-found') {
+ *     return {
+ *       notFound: true,
+ *     };
+ *   }
  *
  *   return {
  *     props: {
- *       categoryConfig,
+ *       categoryConfig: categoryResult.config,
  *     },
  *   };
  * };
  *
  * export default function CategoryPage({ categoryConfig }: CategoryPageProps) {
  *   return (
- *     <div>
- *       <h1>Product Categories</h1>
- *       <Category.Root categoryConfig={categoryConfig}>
- *         <Category.List>
- *           {({ categories, selectedCategory, setSelectedCategory }) => (
- *             <nav className="category-nav">
- *               {categories.map(category => (
- *                 <button
- *                   key={category.id}
- *                   onClick={() => setSelectedCategory(category.id)}
- *                   className={`category-btn ${selectedCategory === category.id ? 'active' : ''}`}
- *                 >
- *                   {category.name}
- *                 </button>
- *               ))}
- *             </nav>
- *           )}
- *         </Category.List>
- *       </Category.Root>
- *     </div>
+ *     <Category.Root categoryConfig={categoryConfig}>
+ *       <Category.Name>
+ *         {({ name }) => <h1>{name}</h1>}
+ *       </Category.Name>
+ *     </Category.Root>
  *   );
  * }
  * ```
  */
-export async function loadCategoriesConfig() {
-    try {
-        const categoriesResponse = await categories
-            .queryCategories({
-            treeReference: {
-                appNamespace: "@wix/stores",
-                treeKey: null,
-            },
-        })
-            .eq("visible", true)
-            .find();
-        const fetchedCategories = categoriesResponse.items || [];
-        // Sort categories to put "all-products" first, keep the rest in original order
-        const allProductsCategory = fetchedCategories.find((cat) => cat.slug === "all-products");
-        const otherCategories = fetchedCategories.filter((cat) => cat.slug !== "all-products");
-        const allCategories = allProductsCategory
-            ? [allProductsCategory, ...otherCategories]
-            : fetchedCategories;
-        return {
-            categories: allCategories,
-        };
-    }
-    catch (error) {
-        console.warn("Failed to load categories:", error);
+export async function loadCategoryServiceConfig(slug) {
+    const category = await categories
+        .queryCategories({
+        treeReference: {
+            appNamespace: "@wix/stores",
+        },
+    })
+        .eq("slug", slug)
+        .find();
+    if (category.items.length === 0) {
         return {
-            categories: [],
+            type: "not-found",
         };
     }
+    return {
+        type: "success",
+        config: {
+            category: category.items[0],
+        },
+    };
 }

package/cjs/dist/services/index.d.ts

@@ -1,10 +1,9 @@
-export { CatalogService, CatalogServiceDefinition, } from "./catalog-service.js";
-export { CategoryService, CategoryServiceDefinition, loadCategoriesConfig, } from "./category-service.js";
-export { CollectionService, CollectionServiceDefinition, loadCollectionServiceConfig, } from "./collection-service.js";
-export { FilterService, FilterServiceDefinition, Filter, AvailableOptions, } from "./filter-service.js";
+export { CategoryService, CategoryServiceDefinition, loadCategoryServiceConfig, CategoryServiceConfig, } from "./category-service.js";
+export { CategoriesListService, CategoriesListServiceDefinition, loadCategoriesListServiceConfig, CategoriesListServiceConfig, } from "./categories-list-service.js";
 export { ProductModifiersService, ProductModifiersServiceDefinition, } from "./product-modifiers-service.js";
 export { ProductService, ProductServiceDefinition, loadProductServiceConfig, } from "./product-service.js";
-export { RelatedProductsService, RelatedProductsServiceDefinition, loadRelatedProductsServiceConfig, } from "./related-products-service.js";
 export { SelectedVariantService, SelectedVariantServiceDefinition, } from "./selected-variant-service.js";
-export { ProductListService, ProductsListServiceDefinition, loadProductsListServiceConfig, } from "./products-list-service.js";
-export { SortService, SortServiceDefinition, SortBy } from "./sort-service.js";
+export { ProductListService, ProductsListServiceDefinition, loadProductsListServiceConfig, ProductsListServiceConfig, } from "./products-list-service.js";
+export { SortType, ProductsListSortService, ProductsListSortServiceDefinition, } from "./products-list-sort-service.js";
+export { InventoryStatusType, ProductsListFiltersService, ProductsListFiltersServiceDefinition, loadProductsListFiltersServiceConfig, ProductsListFiltersServiceConfig, } from "./products-list-filters-service.js";
+export { ProductsListPaginationService, ProductsListPaginationServiceDefinition, } from "./products-list-pagination-service.js";

package/cjs/dist/services/index.js

@@ -1,20 +1,9 @@
-// export {
-//   buyNowServiceBinding,
-//   loadBuyNowServiceInitialData,
-// } from "./buy-now-service.js";
-// export {
-//   payNowServiceBinding,
-//   loadPayNowServiceInitialData,
-// } from "./pay-now-service.js";
-export { CatalogService, CatalogServiceDefinition,
-// loadCatalogServiceConfig,
- } from "./catalog-service.js";
-export { CategoryService, CategoryServiceDefinition, loadCategoriesConfig, } from "./category-service.js";
-export { CollectionService, CollectionServiceDefinition, loadCollectionServiceConfig, } from "./collection-service.js";
-export { FilterService, FilterServiceDefinition, } from "./filter-service.js";
+export { CategoryService, CategoryServiceDefinition, loadCategoryServiceConfig, } from "./category-service.js";
+export { CategoriesListService, CategoriesListServiceDefinition, loadCategoriesListServiceConfig, } from "./categories-list-service.js";
 export { ProductModifiersService, ProductModifiersServiceDefinition, } from "./product-modifiers-service.js";
 export { ProductService, ProductServiceDefinition, loadProductServiceConfig, } from "./product-service.js";
-export { RelatedProductsService, RelatedProductsServiceDefinition, loadRelatedProductsServiceConfig, } from "./related-products-service.js";
 export { SelectedVariantService, SelectedVariantServiceDefinition, } from "./selected-variant-service.js";
 export { ProductListService, ProductsListServiceDefinition, loadProductsListServiceConfig, } from "./products-list-service.js";
-export { SortService, SortServiceDefinition } from "./sort-service.js";
+export { SortType, ProductsListSortService, ProductsListSortServiceDefinition, } from "./products-list-sort-service.js";
+export { InventoryStatusType, ProductsListFiltersService, ProductsListFiltersServiceDefinition, loadProductsListFiltersServiceConfig, } from "./products-list-filters-service.js";
+export { ProductsListPaginationService, ProductsListPaginationServiceDefinition, } from "./products-list-pagination-service.js";

package/cjs/dist/services/pay-now-service.d.ts

@@ -1,68 +1,214 @@
 import { type Signal } from "@wix/services-definitions/core-services/signals";
+/**
+ * Service definition for the Pay Now service.
+ * This defines the reactive API contract for managing custom payment checkout functionality.
+ *
+ * @constant
+ */
 export declare const PayNowServiceDefinition: string & {
     __api: {
+        /** Function to redirect to checkout using custom checkout action */
         redirectToCheckout: () => Promise<void>;
+        /** Reactive signal indicating if a checkout redirect is in progress */
         loadingSignal: Signal<boolean>;
+        /** Reactive signal containing any error message, or null if no error */
         errorSignal: Signal<string | null>;
     };
     __config: {};
     isServiceDefinition?: boolean;
 } & {
+    /** Function to redirect to checkout using custom checkout action */
     redirectToCheckout: () => Promise<void>;
+    /** Reactive signal indicating if a checkout redirect is in progress */
     loadingSignal: Signal<boolean>;
+    /** Reactive signal containing any error message, or null if no error */
     errorSignal: Signal<string | null>;
 };
+/**
+ * Configuration interface for the Pay Now service.
+ * Contains an optional custom checkout action function.
+ *
+ * @interface PayNowServiceConfig
+ */
 export interface PayNowServiceConfig {
+    /** Optional custom checkout action that returns a checkout URL or error */
     customCheckoutAction?: () => Promise<{
+        /** The checkout URL to redirect to */
         data: string | undefined;
+        /** Any error that occurred during checkout creation */
         error: unknown;
     }>;
 }
+/**
+ * Implementation of the Pay Now service that manages custom payment checkout functionality.
+ * This service provides signals for loading state and error handling, along with a method
+ * to redirect to checkout using a custom checkout action.
+ *
+ * @example
+ * ```tsx
+ * import { PayNowServiceImplementation, PayNowServiceDefinition } from '@wix/stores/services';
+ * import { useService } from '@wix/services-manager-react';
+ *
+ * function PayNowComponent({ payNowConfig }) {
+ *   return (
+ *     <ServiceProvider services={createServicesMap([
+ *       [PayNowServiceDefinition, PayNowServiceImplementation.withConfig(payNowConfig)]
+ *     ])}>
+ *       <PayNowButton />
+ *     </ServiceProvider>
+ *   );
+ * }
+ *
+ * function PayNowButton() {
+ *   const payNowService = useService(PayNowServiceDefinition);
+ *   const isLoading = payNowService.loadingSignal.get();
+ *   const error = payNowService.errorSignal.get();
+ *
+ *   const handlePayNow = async () => {
+ *     await payNowService.redirectToCheckout();
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       {error && <div className="error">{error}</div>}
+ *       <button
+ *         onClick={handlePayNow}
+ *         disabled={isLoading}
+ *         className="pay-now-btn"
+ *       >
+ *         {isLoading ? 'Processing...' : 'Pay Now'}
+ *       </button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
 export declare const PayNowServiceImplementation: import("@wix/services-definitions").ServiceFactory<string & {
     __api: {
+        /** Function to redirect to checkout using custom checkout action */
         redirectToCheckout: () => Promise<void>;
+        /** Reactive signal indicating if a checkout redirect is in progress */
         loadingSignal: Signal<boolean>;
+        /** Reactive signal containing any error message, or null if no error */
         errorSignal: Signal<string | null>;
     };
     __config: {};
     isServiceDefinition?: boolean;
 } & {
+    /** Function to redirect to checkout using custom checkout action */
     redirectToCheckout: () => Promise<void>;
+    /** Reactive signal indicating if a checkout redirect is in progress */
     loadingSignal: Signal<boolean>;
+    /** Reactive signal containing any error message, or null if no error */
     errorSignal: Signal<string | null>;
 }, PayNowServiceConfig>;
+/**
+ * Loads pay now service initial data for SSR initialization.
+ * This function returns an empty configuration as the Pay Now service
+ * is typically configured with custom checkout actions at runtime.
+ *
+ * @returns {Promise} Promise that resolves to an empty pay now service configuration
+ *
+ * @example
+ * ```astro
+ * ---
+ * // Astro page example
+ * import { loadPayNowServiceInitialData } from '@wix/stores/services';
+ * import { PayNow } from '@wix/stores/components';
+ *
+ * // Load initial data (empty for PayNow)
+ * const payNowData = await loadPayNowServiceInitialData();
+ * ---
+ *
+ * <PayNow.PayNow payNowConfig={payNowData.PayNow}>
+ *   {({ redirectToCheckout, isLoading, error }) => (
+ *     <button onClick={redirectToCheckout} disabled={isLoading}>
+ *       {isLoading ? 'Processing...' : 'Pay Now'}
+ *     </button>
+ *   )}
+ * </PayNow.PayNow>
+ * ```
+ */
 export declare const loadPayNowServiceInitialData: () => Promise<{
     [PayNowServiceDefinition]: {};
 }>;
+/**
+ * Helper function to create a pay now service binding with configuration.
+ * This function simplifies the process of binding the pay now service with its configuration
+ * and allows for additional configuration overrides, particularly for custom checkout actions.
+ *
+ * @template T - Type of the services configurations object
+ * @param {T} servicesConfigs - Object containing service configurations
+ * @param {Partial<PayNowServiceConfig>} [additionalConfig={}] - Additional configuration to override defaults
+ * @returns Tuple containing service definition, implementation, and merged configuration
+ *
+ * @example
+ * ```tsx
+ * import { payNowServiceBinding, loadPayNowServiceInitialData } from '@wix/stores/services';
+ * import { actions } from 'astro:actions';
+ *
+ * // Load initial data
+ * const initialData = await loadPayNowServiceInitialData();
+ *
+ * // Create service binding with custom checkout action
+ * const payNowBinding = payNowServiceBinding(initialData, {
+ *   customCheckoutAction: async () => {
+ *     try {
+ *       const result = await actions.customCheckout();
+ *       return { data: result, error: null };
+ *     } catch (error) {
+ *       return { data: undefined, error };
+ *     }
+ *   }
+ * });
+ *
+ * // Use in service provider
+ * const services = createServicesMap([payNowBinding]);
+ * ```
+ */
 export declare const payNowServiceBinding: <T extends {
     [key: string]: Awaited<ReturnType<typeof loadPayNowServiceInitialData>>[typeof PayNowServiceDefinition];
 }>(servicesConfigs: T, additionalConfig?: Partial<PayNowServiceConfig>) => readonly [string & {
     __api: {
+        /** Function to redirect to checkout using custom checkout action */
         redirectToCheckout: () => Promise<void>;
+        /** Reactive signal indicating if a checkout redirect is in progress */
         loadingSignal: Signal<boolean>;
+        /** Reactive signal containing any error message, or null if no error */
         errorSignal: Signal<string | null>;
     };
     __config: {};
     isServiceDefinition?: boolean;
 } & {
+    /** Function to redirect to checkout using custom checkout action */
     redirectToCheckout: () => Promise<void>;
+    /** Reactive signal indicating if a checkout redirect is in progress */
     loadingSignal: Signal<boolean>;
+    /** Reactive signal containing any error message, or null if no error */
     errorSignal: Signal<string | null>;
 }, import("@wix/services-definitions").ServiceFactory<string & {
     __api: {
+        /** Function to redirect to checkout using custom checkout action */
         redirectToCheckout: () => Promise<void>;
+        /** Reactive signal indicating if a checkout redirect is in progress */
         loadingSignal: Signal<boolean>;
+        /** Reactive signal containing any error message, or null if no error */
         errorSignal: Signal<string | null>;
     };
     __config: {};
     isServiceDefinition?: boolean;
 } & {
+    /** Function to redirect to checkout using custom checkout action */
     redirectToCheckout: () => Promise<void>;
+    /** Reactive signal indicating if a checkout redirect is in progress */
     loadingSignal: Signal<boolean>;
+    /** Reactive signal containing any error message, or null if no error */
     errorSignal: Signal<string | null>;
 }, PayNowServiceConfig>, {
     customCheckoutAction?: () => Promise<{
+        /** The checkout URL to redirect to */
         data: string | undefined;
+        /** Any error that occurred during checkout creation */
         error: unknown;
     }>;
 }];

package/cjs/dist/services/pay-now-service.js

@@ -1,6 +1,56 @@
-import { defineService, implementService, } from "@wix/services-definitions";
+import { defineService, implementService } from "@wix/services-definitions";
 import { SignalsServiceDefinition, } from "@wix/services-definitions/core-services/signals";
+/**
+ * Service definition for the Pay Now service.
+ * This defines the reactive API contract for managing custom payment checkout functionality.
+ *
+ * @constant
+ */
 export const PayNowServiceDefinition = defineService("PayNow");
+/**
+ * Implementation of the Pay Now service that manages custom payment checkout functionality.
+ * This service provides signals for loading state and error handling, along with a method
+ * to redirect to checkout using a custom checkout action.
+ *
+ * @example
+ * ```tsx
+ * import { PayNowServiceImplementation, PayNowServiceDefinition } from '@wix/stores/services';
+ * import { useService } from '@wix/services-manager-react';
+ *
+ * function PayNowComponent({ payNowConfig }) {
+ *   return (
+ *     <ServiceProvider services={createServicesMap([
+ *       [PayNowServiceDefinition, PayNowServiceImplementation.withConfig(payNowConfig)]
+ *     ])}>
+ *       <PayNowButton />
+ *     </ServiceProvider>
+ *   );
+ * }
+ *
+ * function PayNowButton() {
+ *   const payNowService = useService(PayNowServiceDefinition);
+ *   const isLoading = payNowService.loadingSignal.get();
+ *   const error = payNowService.errorSignal.get();
+ *
+ *   const handlePayNow = async () => {
+ *     await payNowService.redirectToCheckout();
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       {error && <div className="error">{error}</div>}
+ *       <button
+ *         onClick={handlePayNow}
+ *         disabled={isLoading}
+ *         className="pay-now-btn"
+ *       >
+ *         {isLoading ? 'Processing...' : 'Pay Now'}
+ *       </button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
 export const PayNowServiceImplementation = implementService.withConfig()(PayNowServiceDefinition, ({ getService, config }) => {
     const signalsService = getService(SignalsServiceDefinition);
     const loadingSignal = signalsService.signal(false);
@@ -28,11 +78,72 @@ export const PayNowServiceImplementation = implementService.withConfig()(PayNowS
         errorSignal,
     };
 });
+/**
+ * Loads pay now service initial data for SSR initialization.
+ * This function returns an empty configuration as the Pay Now service
+ * is typically configured with custom checkout actions at runtime.
+ *
+ * @returns {Promise} Promise that resolves to an empty pay now service configuration
+ *
+ * @example
+ * ```astro
+ * ---
+ * // Astro page example
+ * import { loadPayNowServiceInitialData } from '@wix/stores/services';
+ * import { PayNow } from '@wix/stores/components';
+ *
+ * // Load initial data (empty for PayNow)
+ * const payNowData = await loadPayNowServiceInitialData();
+ * ---
+ *
+ * <PayNow.PayNow payNowConfig={payNowData.PayNow}>
+ *   {({ redirectToCheckout, isLoading, error }) => (
+ *     <button onClick={redirectToCheckout} disabled={isLoading}>
+ *       {isLoading ? 'Processing...' : 'Pay Now'}
+ *     </button>
+ *   )}
+ * </PayNow.PayNow>
+ * ```
+ */
 export const loadPayNowServiceInitialData = async () => {
     return {
         [PayNowServiceDefinition]: {},
     };
 };
+/**
+ * Helper function to create a pay now service binding with configuration.
+ * This function simplifies the process of binding the pay now service with its configuration
+ * and allows for additional configuration overrides, particularly for custom checkout actions.
+ *
+ * @template T - Type of the services configurations object
+ * @param {T} servicesConfigs - Object containing service configurations
+ * @param {Partial<PayNowServiceConfig>} [additionalConfig={}] - Additional configuration to override defaults
+ * @returns Tuple containing service definition, implementation, and merged configuration
+ *
+ * @example
+ * ```tsx
+ * import { payNowServiceBinding, loadPayNowServiceInitialData } from '@wix/stores/services';
+ * import { actions } from 'astro:actions';
+ *
+ * // Load initial data
+ * const initialData = await loadPayNowServiceInitialData();
+ *
+ * // Create service binding with custom checkout action
+ * const payNowBinding = payNowServiceBinding(initialData, {
+ *   customCheckoutAction: async () => {
+ *     try {
+ *       const result = await actions.customCheckout();
+ *       return { data: result, error: null };
+ *     } catch (error) {
+ *       return { data: undefined, error };
+ *     }
+ *   }
+ * });
+ *
+ * // Use in service provider
+ * const services = createServicesMap([payNowBinding]);
+ * ```
+ */
 export const payNowServiceBinding = (servicesConfigs, additionalConfig = {}) => {
     return [
         PayNowServiceDefinition,