@wix/headless-stores 0.0.25 → 0.0.26

package/cjs/dist/react/ProductsList.d.ts

@@ -0,0 +1,110 @@
+import { type ProductsListServiceConfig } from "../services/products-list-service.js";
+import type { PropsWithChildren, ReactNode } from "react";
+import { productsV3 } from "@wix/stores";
+/**
+ * Root component that provides the ProductsList service context to its children.
+ * This component sets up the necessary services for managing products list state.
+ *
+ * @component
+ * @param props - Component props
+ * @param props.children - Child components that will have access to the ProductsList service
+ * @param props.productsListConfig - Configuration for the ProductsList service
+ * @returns JSX element wrapping children with ProductsList service context
+ */
+declare function Root(props: PropsWithChildren<{
+    productsListConfig: ProductsListServiceConfig;
+}>): import("react/jsx-runtime").JSX.Element;
+export type EmptyStateProps = {
+    children: ((props: EmptyStateRenderProps) => ReactNode) | ReactNode;
+};
+export type EmptyStateRenderProps = {};
+/**
+ * Component that renders content when the products list is empty.
+ * Only displays its children when there are no products, no loading state, and no errors.
+ *
+ * @component
+ * @param props - Component props
+ * @param props.children - Content to display when products list is empty (can be a render function or ReactNode)
+ * @returns JSX element or null based on products list state
+ */
+declare function EmptyState(props: EmptyStateProps): ReactNode;
+export type LoadingProps = {
+    children: ((props: LoadingRenderProps) => ReactNode) | ReactNode;
+};
+export type LoadingRenderProps = {};
+/**
+ * Component that renders content during loading state.
+ * Only displays its children when the products list is currently loading.
+ *
+ * @component
+ * @param props - Component props
+ * @param props.children - Content to display during loading (can be a render function or ReactNode)
+ * @returns JSX element or null based on loading state
+ */
+declare function Loading(props: LoadingProps): ReactNode;
+export type ErrorProps = {
+    children: ((props: ErrorRenderProps) => ReactNode) | ReactNode;
+};
+export type ErrorRenderProps = {
+    error: string | null;
+};
+/**
+ * Component that renders content when there's an error loading products.
+ * Only displays its children when an error has occurred.
+ *
+ * @component
+ * @param props - Component props
+ * @param props.children - Content to display during error state (can be a render function or ReactNode)
+ * @returns JSX element or null based on error state
+ */
+declare function Error(props: ErrorProps): ReactNode;
+export type ItemContentRenderProps = {
+    product: productsV3.V3Product;
+};
+export type ItemContentProps = {
+    children: ((props: ItemContentRenderProps) => ReactNode) | ReactNode;
+};
+/**
+ * Component that renders content for each product in the list.
+ * Maps over all products and provides each product through a service context.
+ * Only renders when products are successfully loaded (not loading, no error, and has products).
+ *
+ * @component
+ * @param props - Component props
+ * @param props.children - Content to display for each product (can be a render function receiving product data or ReactNode)
+ * @returns Array of JSX elements for each product or null if no products to display
+ */
+declare function ItemContent(props: ItemContentProps): import("react/jsx-runtime").JSX.Element[] | null;
+/**
+ * ProductsList component collection providing a complete solution for displaying products.
+ *
+ * Includes components for different states:
+ * - Root: Service provider component
+ * - EmptyState: Displays when no products are available
+ * - Loading: Displays during loading state
+ * - Error: Displays when an error occurs
+ * - ItemContent: Renders individual product items
+ *
+ * @component
+ * @example
+ * ```jsx
+ * <ProductsList.Root productsListConfig={config}>
+ *   <ProductsList.Loading>Loading products...</ProductsList.Loading>
+ *   <ProductsList.Error>
+ *     {({ error }) => <div>Error: {error}</div>}
+ *   </ProductsList.Error>
+ *   <ProductsList.EmptyState>No products found</ProductsList.EmptyState>
+ *   <ProductsList.ItemContent>
+ *     {({ product }) => <div>{product.name}</div>}
+ *   </ProductsList.ItemContent>
+ * </ProductsList.Root>
+ * ```
+ */
+export declare const ProductsList: {
+    Root: typeof Root;
+    EmptyState: typeof EmptyState;
+    Loading: typeof Loading;
+    Error: typeof Error;
+    ItemContent: typeof ItemContent;
+};
+export {};

package/cjs/dist/react/ProductsList.js

@@ -0,0 +1,129 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useService, WixServices } from "@wix/services-manager-react";
+import { createServicesMap } from "@wix/services-manager";
+import { ProductListService, ProductsListServiceDefinition, } from "../services/products-list-service.js";
+import { ProductService, ProductServiceDefinition, } from "@wix/headless-stores/services";
+/**
+ * Root component that provides the ProductsList service context to its children.
+ * This component sets up the necessary services for managing products list state.
+ *
+ * @component
+ * @param props - Component props
+ * @param props.children - Child components that will have access to the ProductsList service
+ * @param props.productsListConfig - Configuration for the ProductsList service
+ * @returns JSX element wrapping children with ProductsList service context
+ */
+function Root(props) {
+    return (_jsx(WixServices, { servicesMap: createServicesMap().addService(ProductsListServiceDefinition, ProductListService, props.productsListConfig), children: props.children }));
+}
+/**
+ * Component that renders content when the products list is empty.
+ * Only displays its children when there are no products, no loading state, and no errors.
+ *
+ * @component
+ * @param props - Component props
+ * @param props.children - Content to display when products list is empty (can be a render function or ReactNode)
+ * @returns JSX element or null based on products list state
+ */
+function EmptyState(props) {
+    const { isLoading, error, products } = useService(ProductsListServiceDefinition);
+    const isLoadingValue = isLoading.get();
+    const errorValue = error.get();
+    const productsValue = products.get();
+    if (!isLoadingValue && !errorValue && productsValue.length === 0) {
+        return typeof props.children === "function"
+            ? props.children({})
+            : props.children;
+    }
+    return null;
+}
+/**
+ * Component that renders content during loading state.
+ * Only displays its children when the products list is currently loading.
+ *
+ * @component
+ * @param props - Component props
+ * @param props.children - Content to display during loading (can be a render function or ReactNode)
+ * @returns JSX element or null based on loading state
+ */
+function Loading(props) {
+    const { isLoading } = useService(ProductsListServiceDefinition);
+    const isLoadingValue = isLoading.get();
+    if (isLoadingValue) {
+        return typeof props.children === "function"
+            ? props.children({})
+            : props.children;
+    }
+    return null;
+}
+/**
+ * Component that renders content when there's an error loading products.
+ * Only displays its children when an error has occurred.
+ *
+ * @component
+ * @param props - Component props
+ * @param props.children - Content to display during error state (can be a render function or ReactNode)
+ * @returns JSX element or null based on error state
+ */
+function Error(props) {
+    const { error } = useService(ProductsListServiceDefinition);
+    const errorValue = error.get();
+    if (errorValue) {
+        return typeof props.children === "function"
+            ? props.children({ error: errorValue })
+            : props.children;
+    }
+    return null;
+}
+/**
+ * Component that renders content for each product in the list.
+ * Maps over all products and provides each product through a service context.
+ * Only renders when products are successfully loaded (not loading, no error, and has products).
+ *
+ * @component
+ * @param props - Component props
+ * @param props.children - Content to display for each product (can be a render function receiving product data or ReactNode)
+ * @returns Array of JSX elements for each product or null if no products to display
+ */
+function ItemContent(props) {
+    const { products, isLoading, error } = useService(ProductsListServiceDefinition);
+    const productsValue = products.get();
+    if (isLoading.get() || error.get() || productsValue.length === 0) {
+        return null;
+    }
+    return productsValue.map((product) => (_jsx(WixServices, { servicesMap: createServicesMap().addService(ProductServiceDefinition, ProductService, { product }), children: typeof props.children === "function"
+            ? props.children({ product })
+            : props.children }, product._id)));
+}
+/**
+ * ProductsList component collection providing a complete solution for displaying products.
+ *
+ * Includes components for different states:
+ * - Root: Service provider component
+ * - EmptyState: Displays when no products are available
+ * - Loading: Displays during loading state
+ * - Error: Displays when an error occurs
+ * - ItemContent: Renders individual product items
+ *
+ * @component
+ * @example
+ * ```jsx
+ * <ProductsList.Root productsListConfig={config}>
+ *   <ProductsList.Loading>Loading products...</ProductsList.Loading>
+ *   <ProductsList.Error>
+ *     {({ error }) => <div>Error: {error}</div>}
+ *   </ProductsList.Error>
+ *   <ProductsList.EmptyState>No products found</ProductsList.EmptyState>
+ *   <ProductsList.ItemContent>
+ *     {({ product }) => <div>{product.name}</div>}
+ *   </ProductsList.ItemContent>
+ * </ProductsList.Root>
+ * ```
+ */
+export const ProductsList = {
+    Root,
+    EmptyState,
+    Loading,
+    Error,
+    ItemContent,
+};

package/cjs/dist/services/products-list-service.d.ts

@@ -0,0 +1,51 @@
+import { type Signal } from "@wix/services-definitions/core-services/signals";
+import { productsV3 } from "@wix/stores";
+export type ProductsListServiceConfig = {
+    products: productsV3.V3Product[];
+    searchOptions: Parameters<typeof productsV3.searchProducts>[0];
+    pagingMetadata: productsV3.CommonCursorPagingMetadata;
+    aggregations: productsV3.AggregationData;
+};
+export declare function loadProductsListServiceConfig(searchOptions: Parameters<typeof productsV3.searchProducts>[0]): Promise<ProductsListServiceConfig>;
+export declare const ProductsListServiceDefinition: string & {
+    __api: {
+        products: Signal<productsV3.V3Product[]>;
+        aggregations: Signal<productsV3.AggregationData>;
+        pagingMetadata: Signal<productsV3.CommonCursorPagingMetadata>;
+        searchOptions: Signal<Parameters<typeof productsV3.searchProducts>[0]>;
+        isLoading: Signal<boolean>;
+        error: Signal<string | null>;
+        setSearchOptions: (searchOptions: Parameters<typeof productsV3.searchProducts>[0]) => void;
+    };
+    __config: ProductsListServiceConfig;
+    isServiceDefinition?: boolean;
+} & {
+    products: Signal<productsV3.V3Product[]>;
+    aggregations: Signal<productsV3.AggregationData>;
+    pagingMetadata: Signal<productsV3.CommonCursorPagingMetadata>;
+    searchOptions: Signal<Parameters<typeof productsV3.searchProducts>[0]>;
+    isLoading: Signal<boolean>;
+    error: Signal<string | null>;
+    setSearchOptions: (searchOptions: Parameters<typeof productsV3.searchProducts>[0]) => void;
+};
+export declare const ProductListService: import("@wix/services-definitions").ServiceFactory<string & {
+    __api: {
+        products: Signal<productsV3.V3Product[]>;
+        aggregations: Signal<productsV3.AggregationData>;
+        pagingMetadata: Signal<productsV3.CommonCursorPagingMetadata>;
+        searchOptions: Signal<Parameters<typeof productsV3.searchProducts>[0]>;
+        isLoading: Signal<boolean>;
+        error: Signal<string | null>;
+        setSearchOptions: (searchOptions: Parameters<typeof productsV3.searchProducts>[0]) => void;
+    };
+    __config: ProductsListServiceConfig;
+    isServiceDefinition?: boolean;
+} & {
+    products: Signal<productsV3.V3Product[]>;
+    aggregations: Signal<productsV3.AggregationData>;
+    pagingMetadata: Signal<productsV3.CommonCursorPagingMetadata>;
+    searchOptions: Signal<Parameters<typeof productsV3.searchProducts>[0]>;
+    isLoading: Signal<boolean>;
+    error: Signal<string | null>;
+    setSearchOptions: (searchOptions: Parameters<typeof productsV3.searchProducts>[0]) => void;
+}, ProductsListServiceConfig>;

package/cjs/dist/services/products-list-service.js

@@ -0,0 +1,63 @@
+import { defineService, implementService } from "@wix/services-definitions";
+import { SignalsServiceDefinition, } from "@wix/services-definitions/core-services/signals";
+import { productsV3 } from "@wix/stores";
+export async function loadProductsListServiceConfig(searchOptions) {
+    const result = await productsV3.searchProducts(searchOptions);
+    return {
+        products: result.products ?? [],
+        searchOptions,
+        pagingMetadata: result.pagingMetadata,
+        aggregations: result.aggregationData,
+    };
+}
+export const ProductsListServiceDefinition = defineService("products-list");
+export const ProductListService = implementService.withConfig()(ProductsListServiceDefinition, ({ getService, config }) => {
+    let firstRun = true;
+    const signalsService = getService(SignalsServiceDefinition);
+    const productsSignal = signalsService.signal(config.products);
+    const searchOptionsSignal = signalsService.signal(config.searchOptions);
+    const pagingMetadataSignal = signalsService.signal(config.pagingMetadata);
+    const aggregationsSignal = signalsService.signal(config.aggregations);
+    const isLoadingSignal = signalsService.signal(false);
+    const errorSignal = signalsService.signal(null);
+    if (typeof window !== "undefined") {
+        signalsService.effect(async () => {
+            // CRITICAL: Read the signals FIRST to establish dependencies, even on first run
+            const searchOptions = searchOptionsSignal.get();
+            if (firstRun) {
+                firstRun = false;
+                return;
+            }
+            try {
+                isLoadingSignal.set(true);
+                const affectiveSearchOptions = searchOptions.cursorPaging?.cursor
+                    ? {
+                        cursorPaging: {
+                            cursor: searchOptions.cursorPaging.cursor,
+                            limit: searchOptions.cursorPaging.limit,
+                        },
+                    }
+                    : searchOptions;
+                const result = await productsV3.searchProducts(affectiveSearchOptions);
+                productsSignal.set(result.products ?? []);
+                pagingMetadataSignal.set(result.pagingMetadata);
+            }
+            catch (error) {
+                errorSignal.set(error instanceof Error ? error.message : "Unknown error");
+            }
+            finally {
+                isLoadingSignal.set(false);
+            }
+        });
+    }
+    firstRun = false;
+    return {
+        products: productsSignal,
+        searchOptions: searchOptionsSignal,
+        pagingMetadata: pagingMetadataSignal,
+        aggregations: aggregationsSignal,
+        setSearchOptions: (searchOptions) => searchOptionsSignal.set(searchOptions),
+        isLoading: isLoadingSignal,
+        error: errorSignal,
+    };
+});

package/dist/react/ProductsList.d.ts

@@ -0,0 +1,110 @@
+import { type ProductsListServiceConfig } from "../services/products-list-service.js";
+import type { PropsWithChildren, ReactNode } from "react";
+import { productsV3 } from "@wix/stores";
+/**
+ * Root component that provides the ProductsList service context to its children.
+ * This component sets up the necessary services for managing products list state.
+ *
+ * @component
+ * @param props - Component props
+ * @param props.children - Child components that will have access to the ProductsList service
+ * @param props.productsListConfig - Configuration for the ProductsList service
+ * @returns JSX element wrapping children with ProductsList service context
+ */
+declare function Root(props: PropsWithChildren<{
+    productsListConfig: ProductsListServiceConfig;
+}>): import("react/jsx-runtime").JSX.Element;
+export type EmptyStateProps = {
+    children: ((props: EmptyStateRenderProps) => ReactNode) | ReactNode;
+};
+export type EmptyStateRenderProps = {};
+/**
+ * Component that renders content when the products list is empty.
+ * Only displays its children when there are no products, no loading state, and no errors.
+ *
+ * @component
+ * @param props - Component props
+ * @param props.children - Content to display when products list is empty (can be a render function or ReactNode)
+ * @returns JSX element or null based on products list state
+ */
+declare function EmptyState(props: EmptyStateProps): ReactNode;
+export type LoadingProps = {
+    children: ((props: LoadingRenderProps) => ReactNode) | ReactNode;
+};
+export type LoadingRenderProps = {};
+/**
+ * Component that renders content during loading state.
+ * Only displays its children when the products list is currently loading.
+ *
+ * @component
+ * @param props - Component props
+ * @param props.children - Content to display during loading (can be a render function or ReactNode)
+ * @returns JSX element or null based on loading state
+ */
+declare function Loading(props: LoadingProps): ReactNode;
+export type ErrorProps = {
+    children: ((props: ErrorRenderProps) => ReactNode) | ReactNode;
+};
+export type ErrorRenderProps = {
+    error: string | null;
+};
+/**
+ * Component that renders content when there's an error loading products.
+ * Only displays its children when an error has occurred.
+ *
+ * @component
+ * @param props - Component props
+ * @param props.children - Content to display during error state (can be a render function or ReactNode)
+ * @returns JSX element or null based on error state
+ */
+declare function Error(props: ErrorProps): ReactNode;
+export type ItemContentRenderProps = {
+    product: productsV3.V3Product;
+};
+export type ItemContentProps = {
+    children: ((props: ItemContentRenderProps) => ReactNode) | ReactNode;
+};
+/**
+ * Component that renders content for each product in the list.
+ * Maps over all products and provides each product through a service context.
+ * Only renders when products are successfully loaded (not loading, no error, and has products).
+ *
+ * @component
+ * @param props - Component props
+ * @param props.children - Content to display for each product (can be a render function receiving product data or ReactNode)
+ * @returns Array of JSX elements for each product or null if no products to display
+ */
+declare function ItemContent(props: ItemContentProps): import("react/jsx-runtime").JSX.Element[] | null;
+/**
+ * ProductsList component collection providing a complete solution for displaying products.
+ *
+ * Includes components for different states:
+ * - Root: Service provider component
+ * - EmptyState: Displays when no products are available
+ * - Loading: Displays during loading state
+ * - Error: Displays when an error occurs
+ * - ItemContent: Renders individual product items
+ *
+ * @component
+ * @example
+ * ```jsx
+ * <ProductsList.Root productsListConfig={config}>
+ *   <ProductsList.Loading>Loading products...</ProductsList.Loading>
+ *   <ProductsList.Error>
+ *     {({ error }) => <div>Error: {error}</div>}
+ *   </ProductsList.Error>
+ *   <ProductsList.EmptyState>No products found</ProductsList.EmptyState>
+ *   <ProductsList.ItemContent>
+ *     {({ product }) => <div>{product.name}</div>}
+ *   </ProductsList.ItemContent>
+ * </ProductsList.Root>
+ * ```
+ */
+export declare const ProductsList: {
+    Root: typeof Root;
+    EmptyState: typeof EmptyState;
+    Loading: typeof Loading;
+    Error: typeof Error;
+    ItemContent: typeof ItemContent;
+};
+export {};

package/dist/react/ProductsList.js

@@ -0,0 +1,129 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useService, WixServices } from "@wix/services-manager-react";
+import { createServicesMap } from "@wix/services-manager";
+import { ProductListService, ProductsListServiceDefinition, } from "../services/products-list-service.js";
+import { ProductService, ProductServiceDefinition, } from "@wix/headless-stores/services";
+/**
+ * Root component that provides the ProductsList service context to its children.
+ * This component sets up the necessary services for managing products list state.
+ *
+ * @component
+ * @param props - Component props
+ * @param props.children - Child components that will have access to the ProductsList service
+ * @param props.productsListConfig - Configuration for the ProductsList service
+ * @returns JSX element wrapping children with ProductsList service context
+ */
+function Root(props) {
+    return (_jsx(WixServices, { servicesMap: createServicesMap().addService(ProductsListServiceDefinition, ProductListService, props.productsListConfig), children: props.children }));
+}
+/**
+ * Component that renders content when the products list is empty.
+ * Only displays its children when there are no products, no loading state, and no errors.
+ *
+ * @component
+ * @param props - Component props
+ * @param props.children - Content to display when products list is empty (can be a render function or ReactNode)
+ * @returns JSX element or null based on products list state
+ */
+function EmptyState(props) {
+    const { isLoading, error, products } = useService(ProductsListServiceDefinition);
+    const isLoadingValue = isLoading.get();
+    const errorValue = error.get();
+    const productsValue = products.get();
+    if (!isLoadingValue && !errorValue && productsValue.length === 0) {
+        return typeof props.children === "function"
+            ? props.children({})
+            : props.children;
+    }
+    return null;
+}
+/**
+ * Component that renders content during loading state.
+ * Only displays its children when the products list is currently loading.
+ *
+ * @component
+ * @param props - Component props
+ * @param props.children - Content to display during loading (can be a render function or ReactNode)
+ * @returns JSX element or null based on loading state
+ */
+function Loading(props) {
+    const { isLoading } = useService(ProductsListServiceDefinition);
+    const isLoadingValue = isLoading.get();
+    if (isLoadingValue) {
+        return typeof props.children === "function"
+            ? props.children({})
+            : props.children;
+    }
+    return null;
+}
+/**
+ * Component that renders content when there's an error loading products.
+ * Only displays its children when an error has occurred.
+ *
+ * @component
+ * @param props - Component props
+ * @param props.children - Content to display during error state (can be a render function or ReactNode)
+ * @returns JSX element or null based on error state
+ */
+function Error(props) {
+    const { error } = useService(ProductsListServiceDefinition);
+    const errorValue = error.get();
+    if (errorValue) {
+        return typeof props.children === "function"
+            ? props.children({ error: errorValue })
+            : props.children;
+    }
+    return null;
+}
+/**
+ * Component that renders content for each product in the list.
+ * Maps over all products and provides each product through a service context.
+ * Only renders when products are successfully loaded (not loading, no error, and has products).
+ *
+ * @component
+ * @param props - Component props
+ * @param props.children - Content to display for each product (can be a render function receiving product data or ReactNode)
+ * @returns Array of JSX elements for each product or null if no products to display
+ */
+function ItemContent(props) {
+    const { products, isLoading, error } = useService(ProductsListServiceDefinition);
+    const productsValue = products.get();
+    if (isLoading.get() || error.get() || productsValue.length === 0) {
+        return null;
+    }
+    return productsValue.map((product) => (_jsx(WixServices, { servicesMap: createServicesMap().addService(ProductServiceDefinition, ProductService, { product }), children: typeof props.children === "function"
+            ? props.children({ product })
+            : props.children }, product._id)));
+}
+/**
+ * ProductsList component collection providing a complete solution for displaying products.
+ *
+ * Includes components for different states:
+ * - Root: Service provider component
+ * - EmptyState: Displays when no products are available
+ * - Loading: Displays during loading state
+ * - Error: Displays when an error occurs
+ * - ItemContent: Renders individual product items
+ *
+ * @component
+ * @example
+ * ```jsx
+ * <ProductsList.Root productsListConfig={config}>
+ *   <ProductsList.Loading>Loading products...</ProductsList.Loading>
+ *   <ProductsList.Error>
+ *     {({ error }) => <div>Error: {error}</div>}
+ *   </ProductsList.Error>
+ *   <ProductsList.EmptyState>No products found</ProductsList.EmptyState>
+ *   <ProductsList.ItemContent>
+ *     {({ product }) => <div>{product.name}</div>}
+ *   </ProductsList.ItemContent>
+ * </ProductsList.Root>
+ * ```
+ */
+export const ProductsList = {
+    Root,
+    EmptyState,
+    Loading,
+    Error,
+    ItemContent,
+};

package/dist/services/products-list-service.d.ts

@@ -0,0 +1,51 @@
+import { type Signal } from "@wix/services-definitions/core-services/signals";
+import { productsV3 } from "@wix/stores";
+export type ProductsListServiceConfig = {
+    products: productsV3.V3Product[];
+    searchOptions: Parameters<typeof productsV3.searchProducts>[0];
+    pagingMetadata: productsV3.CommonCursorPagingMetadata;
+    aggregations: productsV3.AggregationData;
+};
+export declare function loadProductsListServiceConfig(searchOptions: Parameters<typeof productsV3.searchProducts>[0]): Promise<ProductsListServiceConfig>;
+export declare const ProductsListServiceDefinition: string & {
+    __api: {
+        products: Signal<productsV3.V3Product[]>;
+        aggregations: Signal<productsV3.AggregationData>;
+        pagingMetadata: Signal<productsV3.CommonCursorPagingMetadata>;
+        searchOptions: Signal<Parameters<typeof productsV3.searchProducts>[0]>;
+        isLoading: Signal<boolean>;
+        error: Signal<string | null>;
+        setSearchOptions: (searchOptions: Parameters<typeof productsV3.searchProducts>[0]) => void;
+    };
+    __config: ProductsListServiceConfig;
+    isServiceDefinition?: boolean;
+} & {
+    products: Signal<productsV3.V3Product[]>;
+    aggregations: Signal<productsV3.AggregationData>;
+    pagingMetadata: Signal<productsV3.CommonCursorPagingMetadata>;
+    searchOptions: Signal<Parameters<typeof productsV3.searchProducts>[0]>;
+    isLoading: Signal<boolean>;
+    error: Signal<string | null>;
+    setSearchOptions: (searchOptions: Parameters<typeof productsV3.searchProducts>[0]) => void;
+};
+export declare const ProductListService: import("@wix/services-definitions").ServiceFactory<string & {
+    __api: {
+        products: Signal<productsV3.V3Product[]>;
+        aggregations: Signal<productsV3.AggregationData>;
+        pagingMetadata: Signal<productsV3.CommonCursorPagingMetadata>;
+        searchOptions: Signal<Parameters<typeof productsV3.searchProducts>[0]>;
+        isLoading: Signal<boolean>;
+        error: Signal<string | null>;
+        setSearchOptions: (searchOptions: Parameters<typeof productsV3.searchProducts>[0]) => void;
+    };
+    __config: ProductsListServiceConfig;
+    isServiceDefinition?: boolean;
+} & {
+    products: Signal<productsV3.V3Product[]>;
+    aggregations: Signal<productsV3.AggregationData>;
+    pagingMetadata: Signal<productsV3.CommonCursorPagingMetadata>;
+    searchOptions: Signal<Parameters<typeof productsV3.searchProducts>[0]>;
+    isLoading: Signal<boolean>;
+    error: Signal<string | null>;
+    setSearchOptions: (searchOptions: Parameters<typeof productsV3.searchProducts>[0]) => void;
+}, ProductsListServiceConfig>;

package/dist/services/products-list-service.js

@@ -0,0 +1,63 @@
+import { defineService, implementService } from "@wix/services-definitions";
+import { SignalsServiceDefinition, } from "@wix/services-definitions/core-services/signals";
+import { productsV3 } from "@wix/stores";
+export async function loadProductsListServiceConfig(searchOptions) {
+    const result = await productsV3.searchProducts(searchOptions);
+    return {
+        products: result.products ?? [],
+        searchOptions,
+        pagingMetadata: result.pagingMetadata,
+        aggregations: result.aggregationData,
+    };
+}
+export const ProductsListServiceDefinition = defineService("products-list");
+export const ProductListService = implementService.withConfig()(ProductsListServiceDefinition, ({ getService, config }) => {
+    let firstRun = true;
+    const signalsService = getService(SignalsServiceDefinition);
+    const productsSignal = signalsService.signal(config.products);
+    const searchOptionsSignal = signalsService.signal(config.searchOptions);
+    const pagingMetadataSignal = signalsService.signal(config.pagingMetadata);
+    const aggregationsSignal = signalsService.signal(config.aggregations);
+    const isLoadingSignal = signalsService.signal(false);
+    const errorSignal = signalsService.signal(null);
+    if (typeof window !== "undefined") {
+        signalsService.effect(async () => {
+            // CRITICAL: Read the signals FIRST to establish dependencies, even on first run
+            const searchOptions = searchOptionsSignal.get();
+            if (firstRun) {
+                firstRun = false;
+                return;
+            }
+            try {
+                isLoadingSignal.set(true);
+                const affectiveSearchOptions = searchOptions.cursorPaging?.cursor
+                    ? {
+                        cursorPaging: {
+                            cursor: searchOptions.cursorPaging.cursor,
+                            limit: searchOptions.cursorPaging.limit,
+                        },
+                    }
+                    : searchOptions;
+                const result = await productsV3.searchProducts(affectiveSearchOptions);
+                productsSignal.set(result.products ?? []);
+                pagingMetadataSignal.set(result.pagingMetadata);
+            }
+            catch (error) {
+                errorSignal.set(error instanceof Error ? error.message : "Unknown error");
+            }
+            finally {
+                isLoadingSignal.set(false);
+            }
+        });
+    }
+    firstRun = false;
+    return {
+        products: productsSignal,
+        searchOptions: searchOptionsSignal,
+        pagingMetadata: pagingMetadataSignal,
+        aggregations: aggregationsSignal,
+        setSearchOptions: (searchOptions) => searchOptionsSignal.set(searchOptions),
+        isLoading: isLoadingSignal,
+        error: errorSignal,
+    };
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/headless-stores",
-  "version": "0.0.25",
+  "version": "0.0.26",
   "type": "module",
   "scripts": {
     "prebuild": "cd ../media && yarn build && cd ../ecom && yarn build",