@wix/headless-stores 0.0.9 → 0.0.11

package/cjs/dist/services/social-sharing-service.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SocialSharingService = exports.SocialSharingServiceDefinition = void 0;
+exports.loadSocialSharingServiceConfig = loadSocialSharingServiceConfig;
+const services_definitions_1 = require("@wix/services-definitions");
+const signals_1 = require("@wix/services-definitions/core-services/signals");
+const social_platform_enums_1 = require("../enums/social-platform-enums");
+exports.SocialSharingServiceDefinition = (0, services_definitions_1.defineService)('socialSharing');
+exports.SocialSharingService = services_definitions_1.implementService.withConfig()(exports.SocialSharingServiceDefinition, ({ getService }) => {
+    const signalsService = getService(signals_1.SignalsServiceDefinition);
+    // Platform metadata is handled in components layer, only business logic here
+    const availablePlatforms = signalsService.signal([
+        {
+            name: 'Facebook',
+            icon: 'facebook',
+            color: '#1877F2',
+            shareUrl: social_platform_enums_1.SocialPlatformShareUrl.FACEBOOK,
+        },
+        {
+            name: 'Twitter',
+            icon: 'twitter',
+            color: '#1DA1F2',
+            shareUrl: social_platform_enums_1.SocialPlatformShareUrl.TWITTER,
+        },
+        {
+            name: 'LinkedIn',
+            icon: 'linkedin',
+            color: '#0A66C2',
+            shareUrl: social_platform_enums_1.SocialPlatformShareUrl.LINKEDIN,
+        },
+        {
+            name: 'WhatsApp',
+            icon: 'whatsapp',
+            color: '#25D366',
+            shareUrl: social_platform_enums_1.SocialPlatformShareUrl.WHATSAPP,
+        },
+        {
+            name: 'Email',
+            icon: 'mail',
+            color: '#EA4335',
+            shareUrl: social_platform_enums_1.SocialPlatformShareUrl.EMAIL,
+        },
+    ]);
+    const shareCount = signalsService.signal(0);
+    const lastSharedPlatform = signalsService.signal(null);
+    const openShareWindow = (url, platform) => {
+        const width = 600;
+        const height = 400;
+        const left = (window.screen.width - width) / 2;
+        const top = (window.screen.height - height) / 2;
+        window.open(url, `share-${platform}`, `width=${width},height=${height},left=${left},top=${top},scrollbars=yes,resizable=yes`);
+        trackShare(platform);
+    };
+    const shareToFacebook = (url, title, description) => {
+        const shareUrl = new URL(social_platform_enums_1.SocialPlatformShareUrl.FACEBOOK);
+        shareUrl.searchParams.set('u', url);
+        shareUrl.searchParams.set('quote', `${title}${description ? ` - ${description}` : ''}`);
+        openShareWindow(shareUrl.toString(), social_platform_enums_1.SocialPlatform.FACEBOOK);
+    };
+    const shareToTwitter = (url, text, hashtags) => {
+        const shareUrl = new URL(social_platform_enums_1.SocialPlatformShareUrl.TWITTER);
+        shareUrl.searchParams.set('url', url);
+        shareUrl.searchParams.set('text', text);
+        if (hashtags && hashtags.length > 0) {
+            shareUrl.searchParams.set('hashtags', hashtags.join(','));
+        }
+        openShareWindow(shareUrl.toString(), social_platform_enums_1.SocialPlatform.TWITTER);
+    };
+    const shareToLinkedIn = (url, title, summary) => {
+        const shareUrl = new URL(social_platform_enums_1.SocialPlatformShareUrl.LINKEDIN);
+        shareUrl.searchParams.set('url', url);
+        shareUrl.searchParams.set('title', title);
+        if (summary) {
+            shareUrl.searchParams.set('summary', summary);
+        }
+        openShareWindow(shareUrl.toString(), social_platform_enums_1.SocialPlatform.LINKEDIN);
+    };
+    const shareToWhatsApp = (url, text) => {
+        const message = `${text} ${url}`;
+        const shareUrl = `${social_platform_enums_1.SocialPlatformShareUrl.WHATSAPP}?text=${encodeURIComponent(message)}`;
+        openShareWindow(shareUrl, social_platform_enums_1.SocialPlatform.WHATSAPP);
+    };
+    const shareToEmail = (url, subject, body) => {
+        const emailBody = `${body}\n\n${url}`;
+        const mailtoUrl = `${social_platform_enums_1.SocialPlatformShareUrl.EMAIL}?subject=${encodeURIComponent(subject)}&body=${encodeURIComponent(emailBody)}`;
+        window.location.href = mailtoUrl;
+        trackShare(social_platform_enums_1.SocialPlatform.EMAIL);
+    };
+    const copyToClipboard = async (url) => {
+        try {
+            await navigator.clipboard.writeText(url);
+            trackShare(social_platform_enums_1.SocialPlatform.CLIPBOARD);
+            return true;
+        }
+        catch (err) {
+            console.error('Failed to copy to clipboard:', err);
+            return false;
+        }
+    };
+    const shareNative = async (data) => {
+        try {
+            if (navigator.share) {
+                await navigator.share(data);
+                trackShare(social_platform_enums_1.SocialPlatform.NATIVE);
+                return true;
+            }
+            return false;
+        }
+        catch (err) {
+            console.error('Failed to share natively:', err);
+            return false;
+        }
+    };
+    const trackShare = (platform) => {
+        const currentCount = shareCount.get();
+        shareCount.set(currentCount + 1);
+        lastSharedPlatform.set(platform);
+        console.log(`Shared to ${platform} - Total shares: ${currentCount + 1}`);
+    };
+    return {
+        availablePlatforms,
+        shareCount,
+        lastSharedPlatform,
+        shareToFacebook,
+        shareToTwitter,
+        shareToLinkedIn,
+        shareToWhatsApp,
+        shareToEmail,
+        copyToClipboard,
+        shareNative,
+        trackShare,
+    };
+});
+async function loadSocialSharingServiceConfig(productName, productUrl, productDescription, productImage) {
+    return {
+        productName,
+        productUrl,
+        productDescription,
+        productImage,
+    };
+}

package/cjs/dist/services/sort-service.d.ts

@@ -0,0 +1,20 @@
+import type { Signal } from '../../Signal';
+import { SortType } from '../enums/sort-enums';
+export type SortBy = SortType;
+export interface SortServiceAPI {
+    currentSort: Signal<SortBy>;
+    setSortBy: (sortBy: SortBy) => Promise<void>;
+}
+export declare const SortServiceDefinition: string & {
+    __api: SortServiceAPI;
+    __config: {};
+    isServiceDefinition?: boolean;
+} & SortServiceAPI;
+export declare const defaultSort: SortBy;
+export declare const SortService: import("@wix/services-definitions").ServiceFactory<string & {
+    __api: SortServiceAPI;
+    __config: {};
+    isServiceDefinition?: boolean;
+} & SortServiceAPI, {
+    initialSort?: SortBy;
+}, import("@wix/services-definitions").ThreadMode.MAIN>;

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

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SortService = exports.defaultSort = exports.SortServiceDefinition = void 0;
+const services_definitions_1 = require("@wix/services-definitions");
+const signals_1 = require("@wix/services-definitions/core-services/signals");
+const url_params_1 = require("../utils/url-params");
+const sort_enums_1 = require("../enums/sort-enums");
+exports.SortServiceDefinition = (0, services_definitions_1.defineService)('sort');
+exports.defaultSort = sort_enums_1.DEFAULT_SORT_TYPE;
+exports.SortService = services_definitions_1.implementService.withConfig()(exports.SortServiceDefinition, ({ getService, config }) => {
+    const signalsService = getService(signals_1.SignalsServiceDefinition);
+    const currentSort = signalsService.signal((config.initialSort || exports.defaultSort));
+    const setSortBy = async (sortBy) => {
+        currentSort.set(sortBy);
+        // Update URL with sort parameter
+        const currentParams = url_params_1.URLParamsUtils.getURLParams();
+        const urlParams = { ...currentParams };
+        if (sortBy !== sort_enums_1.SortType.NEWEST) {
+            // @ts-ignore
+            urlParams.sort = sortBy;
+        }
+        else {
+            // @ts-ignore
+            delete urlParams.sort;
+        }
+        url_params_1.URLParamsUtils.updateURL(urlParams);
+    };
+    return {
+        currentSort,
+        setSortBy,
+    };
+});

package/cjs/dist/utils/url-params.d.ts

@@ -0,0 +1,5 @@
+export declare class URLParamsUtils {
+    static parseSearchParams(searchParams: URLSearchParams): Record<string, string | string[]>;
+    static updateURL(params: Record<string, string | string[]>): void;
+    static getURLParams(): Record<string, string | string[]>;
+}

package/cjs/dist/utils/url-params.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.URLParamsUtils = void 0;
+class URLParamsUtils {
+    static parseSearchParams(searchParams) {
+        const params = {};
+        // Parse all parameters
+        for (const [key, value] of searchParams.entries()) {
+            if (params[key]) {
+                // Convert to array if multiple values
+                if (Array.isArray(params[key])) {
+                    params[key].push(value);
+                }
+                else {
+                    params[key] = [params[key], value];
+                }
+            }
+            else {
+                params[key] = value;
+            }
+        }
+        return params;
+    }
+    static updateURL(params) {
+        if (typeof window === "undefined")
+            return;
+        const url = new URL(window.location.href);
+        const urlParams = new URLSearchParams();
+        // Add all parameters
+        Object.entries(params).forEach(([key, value]) => {
+            if (Array.isArray(value)) {
+                value.forEach((v) => urlParams.append(key, v));
+            }
+            else if (value) {
+                urlParams.set(key, value);
+            }
+        });
+        // Update URL without page reload
+        const newURL = urlParams.toString()
+            ? `${url.pathname}?${urlParams.toString()}`
+            : url.pathname;
+        window.history.replaceState({}, "", newURL);
+    }
+    static getURLParams() {
+        if (typeof window === "undefined")
+            return {};
+        return this.parseSearchParams(new URLSearchParams(window.location.search));
+    }
+}
+exports.URLParamsUtils = URLParamsUtils;

package/dist/enums/index.d.ts

@@ -0,0 +1,2 @@
+export * from './sort-enums';
+export * from './social-platform-enums';

package/dist/enums/index.js

@@ -0,0 +1,2 @@
+export * from './sort-enums';
+export * from './social-platform-enums';

package/dist/enums/social-platform-enums.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Business logic enums for social sharing platforms (headless layer)
+ */
+/**
+ * Enum for social sharing platforms (business identifiers)
+ */
+export declare enum SocialPlatform {
+    FACEBOOK = "facebook",
+    TWITTER = "twitter",
+    LINKEDIN = "linkedin",
+    WHATSAPP = "whatsapp",
+    EMAIL = "email",
+    CLIPBOARD = "clipboard",
+    NATIVE = "native"
+}
+/**
+ * Enum for social platform share URLs (business logic)
+ */
+export declare enum SocialPlatformShareUrl {
+    FACEBOOK = "https://www.facebook.com/sharer/sharer.php",
+    TWITTER = "https://twitter.com/intent/tweet",
+    LINKEDIN = "https://www.linkedin.com/sharing/share-offsite/",
+    WHATSAPP = "https://wa.me/",
+    EMAIL = "mailto:"
+}

package/dist/enums/social-platform-enums.js

@@ -0,0 +1,27 @@
+/**
+ * Business logic enums for social sharing platforms (headless layer)
+ */
+/**
+ * Enum for social sharing platforms (business identifiers)
+ */
+export var SocialPlatform;
+(function (SocialPlatform) {
+    SocialPlatform["FACEBOOK"] = "facebook";
+    SocialPlatform["TWITTER"] = "twitter";
+    SocialPlatform["LINKEDIN"] = "linkedin";
+    SocialPlatform["WHATSAPP"] = "whatsapp";
+    SocialPlatform["EMAIL"] = "email";
+    SocialPlatform["CLIPBOARD"] = "clipboard";
+    SocialPlatform["NATIVE"] = "native";
+})(SocialPlatform || (SocialPlatform = {}));
+/**
+ * Enum for social platform share URLs (business logic)
+ */
+export var SocialPlatformShareUrl;
+(function (SocialPlatformShareUrl) {
+    SocialPlatformShareUrl["FACEBOOK"] = "https://www.facebook.com/sharer/sharer.php";
+    SocialPlatformShareUrl["TWITTER"] = "https://twitter.com/intent/tweet";
+    SocialPlatformShareUrl["LINKEDIN"] = "https://www.linkedin.com/sharing/share-offsite/";
+    SocialPlatformShareUrl["WHATSAPP"] = "https://wa.me/";
+    SocialPlatformShareUrl["EMAIL"] = "mailto:";
+})(SocialPlatformShareUrl || (SocialPlatformShareUrl = {}));

package/dist/enums/sort-enums.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Enum for sort types used in the store
+ * Note: Cannot use SDK SortType as it's for aggregations (COUNT/VALUE)
+ * while this enum represents user-facing sort options
+ */
+export declare enum SortType {
+    NEWEST = "newest",
+    NAME_ASC = "name_asc",
+    NAME_DESC = "name_desc",
+    PRICE_ASC = "price_asc",
+    PRICE_DESC = "price_desc",
+    RECOMMENDED = "recommended"
+}
+/**
+ * Default sort type
+ */
+export declare const DEFAULT_SORT_TYPE = SortType.NEWEST;

package/dist/enums/sort-enums.js

@@ -0,0 +1,18 @@
+/**
+ * Enum for sort types used in the store
+ * Note: Cannot use SDK SortType as it's for aggregations (COUNT/VALUE)
+ * while this enum represents user-facing sort options
+ */
+export var SortType;
+(function (SortType) {
+    SortType["NEWEST"] = "newest";
+    SortType["NAME_ASC"] = "name_asc";
+    SortType["NAME_DESC"] = "name_desc";
+    SortType["PRICE_ASC"] = "price_asc";
+    SortType["PRICE_DESC"] = "price_desc";
+    SortType["RECOMMENDED"] = "recommended";
+})(SortType || (SortType = {}));
+/**
+ * Default sort type
+ */
+export const DEFAULT_SORT_TYPE = SortType.NEWEST;

package/dist/react/BuyNow.d.ts

@@ -1,4 +1,3 @@
-export type RedirectToCheckout = () => void;
 /**
  * Props passed to the render function of the BuyNow component
  */
@@ -8,7 +7,7 @@ export interface BuyNowRenderProps {
     /** The name of the product being purchased */
     productName: string;
     /** Function to redirect the user to the checkout page */
-    redirectToCheckout: RedirectToCheckout;
+    redirectToCheckout: () => void;
     /** The error message if the buy now operation fails */
     error: string | null;
     /** The price of the product being purchased */
@@ -20,13 +19,12 @@ export interface BuyNowRenderProps {
     /** Whether the product is available for pre-order */
     preOrderAvailable: boolean;
 }
-export type BuyNowChildren = (props: BuyNowRenderProps) => React.ReactNode;
 /**
  * Props for the BuyNow component
  */
 export interface BuyNowProps {
     /** Render function that receives buy now state and actions */
-    children: BuyNowChildren;
+    children: (props: BuyNowRenderProps) => React.ReactNode;
 }
 /**
  * A headless component that provides buy now functionality using the render props pattern.

package/dist/react/Category.d.ts

@@ -0,0 +1,15 @@
+import { type Category } from '@wix/auto_sdk_categories_categories';
+import React, { type ReactNode } from 'react';
+export interface CategoryListProps {
+    children: (data: {
+        categories: Category[];
+        selectedCategory: string | null;
+        setSelectedCategory: (categoryId: string | null) => void;
+    }) => ReactNode;
+}
+/**
+ * Headless component for displaying a list of categories
+ *
+ * @component
+ */
+export declare const List: React.FC<CategoryListProps>;

package/dist/react/Category.js

@@ -0,0 +1,18 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { useService } from '@wix/services-manager-react';
+import { CategoryServiceDefinition } from '../services/category-service';
+/**
+ * Headless component for displaying a list of categories
+ *
+ * @component
+ */
+export const List = ({ children }) => {
+    const service = useService(CategoryServiceDefinition);
+    const categories = service.categories.get();
+    const selectedCategory = service.selectedCategory.get();
+    return (_jsx(_Fragment, { children: children({
+            selectedCategory,
+            categories,
+            setSelectedCategory: service.setSelectedCategory,
+        }) }));
+};

package/dist/react/Collection.d.ts

@@ -0,0 +1,151 @@
+import { type V3Product } from '@wix/auto_sdk_stores_products-v-3';
+/**
+ * Props for Grid headless component
+ */
+export interface GridProps {
+    /** Render prop function that receives product grid data */
+    children: (props: GridRenderProps) => React.ReactNode;
+}
+/**
+ * Render props for Grid component
+ */
+export interface GridRenderProps {
+    /** Array of products */
+    products: V3Product[];
+    /** Whether products are loading */
+    isLoading: boolean;
+    /** Error message if any */
+    error: string | null;
+    /** Whether there are no products */
+    isEmpty: boolean;
+    /** Total number of products */
+    totalProducts: number;
+    /** Whether collection has products */
+    hasProducts: boolean;
+}
+/**
+ * Headless component for product grid
+ *
+ * @component
+ */
+export declare const Grid: (props: GridProps) => import("react").ReactNode;
+/**
+ * Props for Item headless component
+ */
+export interface ItemProps {
+    /** Product data */
+    product: V3Product;
+    /** Render prop function that receives product item data */
+    children: (props: ItemRenderProps) => React.ReactNode;
+}
+/**
+ * Render props for Item component
+ */
+export interface ItemRenderProps {
+    /** Product ID */
+    id: string;
+    /** Product title */
+    title: string;
+    /** Product slug for URL */
+    slug: string;
+    /** Main product image URL */
+    image: string | null;
+    /** Product price */
+    price: string;
+    /** Compare at price (for strikethrough) */
+    compareAtPrice: string | null;
+    /** Product description */
+    description: string;
+    /** Whether product is available */
+    available: boolean;
+    /** Product URL */
+    href: string;
+}
+/**
+ * Headless component for individual product item
+ *
+ * @component
+ */
+export declare const Item: (props: ItemProps) => import("react").ReactNode;
+/**
+ * Props for LoadMore headless component
+ */
+export interface LoadMoreProps {
+    /** Render prop function that receives load more data */
+    children: (props: LoadMoreRenderProps) => React.ReactNode;
+}
+/**
+ * Render props for LoadMore component
+ */
+export interface LoadMoreRenderProps {
+    /** Function to load more products */
+    loadMore: () => Promise<void>;
+    /** Function to refresh products */
+    refresh: () => Promise<void>;
+    /** Whether load more is currently loading */
+    isLoading: boolean;
+    /** Whether there are products */
+    hasProducts: boolean;
+    /** Total number of products currently loaded */
+    totalProducts: number;
+    /** Whether there are more products to load */
+    hasMoreProducts: boolean;
+}
+/**
+ * Headless component for load more products functionality
+ * Note: V3 API uses simplified loading without traditional pagination
+ *
+ * @component
+ */
+export declare const LoadMore: (props: LoadMoreProps) => import("react").ReactNode;
+/**
+ * Props for Header headless component
+ */
+export interface HeaderProps {
+    /** Render prop function that receives collection header data */
+    children: (props: HeaderRenderProps) => React.ReactNode;
+}
+/**
+ * Render props for Header component
+ */
+export interface HeaderRenderProps {
+    /** Total number of products */
+    totalProducts: number;
+    /** Whether collection is loading */
+    isLoading: boolean;
+    /** Whether collection has products */
+    hasProducts: boolean;
+}
+/**
+ * Headless component for collection header with product count
+ *
+ * @component
+ */
+export declare const Header: (props: HeaderProps) => import("react").ReactNode;
+/**
+ * Props for Actions headless component
+ */
+export interface ActionsProps {
+    /** Render prop function that receives collection actions data */
+    children: (props: ActionsRenderProps) => React.ReactNode;
+}
+/**
+ * Render props for Actions component
+ */
+export interface ActionsRenderProps {
+    /** Function to refresh the collection */
+    refresh: () => Promise<void>;
+    /** Function to load more products */
+    loadMore: () => Promise<void>;
+    /** Whether actions are loading */
+    isLoading: boolean;
+    /** Error message if any */
+    error: string | null;
+}
+/**
+ * Headless component for collection actions (refresh, load more)
+ * Replaces traditional pagination for V3 API
+ *
+ * @component
+ */
+export declare const Actions: (props: ActionsProps) => import("react").ReactNode;