@wix/headless-stores 0.0.4 → 0.0.6

package/dist/astro/actions/custom-checkout.d.ts

@@ -0,0 +1,50 @@
+import { type CustomLineItemCheckoutOptions } from '@wix/headless-stores/server-actions';
+/**
+ * Creates an Astro action factory for custom checkout functionality with line items.
+ *
+ * This factory function generates an Astro action that can be used to create custom
+ * checkout URLs with specific line items. It wraps the Wix headless stores server
+ * action functionality in an Astro-compatible action format.
+ *
+ * @param {CustomLineItemCheckoutOptions} factoryOpts - Configuration options for the custom checkout
+ * @param {string} factoryOpts.productName - The name of the product for the custom line item
+ * @param {string} [factoryOpts.priceDescription] - A description for the price, which will be displayed to the customer
+ * @param {Array<{content: string, title: string}>} [factoryOpts.policies] - An array of policies related to this custom item
+ * @param {string} [factoryOpts.postFlowUrl] - The URL to redirect the user to after the checkout is successfully completed
+ * @param {number} [factoryOpts.quantity=1] - The quantity of the product
+ * @param {string} factoryOpts.price - The price of the product
+ *
+ * @returns {ReturnType<typeof defineAction>} An Astro action that when invoked returns checkout URL
+ *
+ * @example
+ * ```typescript
+ * // Define the action with your configuration
+ * const customCheckoutAction = customCheckoutActionFactory({
+ *   productName: "Premium Subscription",
+ *   price: "29.99",
+ *   priceDescription: "per month",
+ *   quantity: 1,
+ *   postFlowUrl: "https://yoursite.com/thank-you",
+ *   policies: [
+ *     {
+ *       title: "Refund Policy",
+ *       content: "30-day money back guarantee"
+ *     }
+ *   ]
+ * });
+ *
+ * export const server = {
+ *   checkout: customCheckoutAction
+ * };
+ *
+ * // Use in your Astro component or API route
+ * import { actions } from "astro:actions";
+ * const checkoutUrl = await actions.customCheckoutAction();
+ * ```
+ *
+ * @see {@link https://docs.astro.build/en/guides/actions/} Astro Actions Documentation
+ * @see {@link https://dev.wix.com/docs/sdk/headless/api-reference/stores/checkout} Wix Stores Checkout API
+ */
+export declare const customCheckoutActionFactory: (factoryOpts: CustomLineItemCheckoutOptions) => ((input?: any) => Promise<import("astro:actions").SafeResult<never, string>>) & {
+    orThrow: (input?: any) => Promise<string>;
+} & string;

package/dist/astro/actions/custom-checkout.js

@@ -0,0 +1,52 @@
+/// <reference types="astro/client" />
+import { defineAction } from 'astro:actions';
+import { getCustomLineItemCheckoutURLFactory } from '@wix/headless-stores/server-actions';
+/**
+ * Creates an Astro action factory for custom checkout functionality with line items.
+ *
+ * This factory function generates an Astro action that can be used to create custom
+ * checkout URLs with specific line items. It wraps the Wix headless stores server
+ * action functionality in an Astro-compatible action format.
+ *
+ * @param {CustomLineItemCheckoutOptions} factoryOpts - Configuration options for the custom checkout
+ * @param {string} factoryOpts.productName - The name of the product for the custom line item
+ * @param {string} [factoryOpts.priceDescription] - A description for the price, which will be displayed to the customer
+ * @param {Array<{content: string, title: string}>} [factoryOpts.policies] - An array of policies related to this custom item
+ * @param {string} [factoryOpts.postFlowUrl] - The URL to redirect the user to after the checkout is successfully completed
+ * @param {number} [factoryOpts.quantity=1] - The quantity of the product
+ * @param {string} factoryOpts.price - The price of the product
+ *
+ * @returns {ReturnType<typeof defineAction>} An Astro action that when invoked returns checkout URL
+ *
+ * @example
+ * ```typescript
+ * // Define the action with your configuration
+ * const customCheckoutAction = customCheckoutActionFactory({
+ *   productName: "Premium Subscription",
+ *   price: "29.99",
+ *   priceDescription: "per month",
+ *   quantity: 1,
+ *   postFlowUrl: "https://yoursite.com/thank-you",
+ *   policies: [
+ *     {
+ *       title: "Refund Policy",
+ *       content: "30-day money back guarantee"
+ *     }
+ *   ]
+ * });
+ *
+ * export const server = {
+ *   checkout: customCheckoutAction
+ * };
+ *
+ * // Use in your Astro component or API route
+ * import { actions } from "astro:actions";
+ * const checkoutUrl = await actions.customCheckoutAction();
+ * ```
+ *
+ * @see {@link https://docs.astro.build/en/guides/actions/} Astro Actions Documentation
+ * @see {@link https://dev.wix.com/docs/sdk/headless/api-reference/stores/checkout} Wix Stores Checkout API
+ */
+export const customCheckoutActionFactory = (factoryOpts) => defineAction({
+    handler: () => getCustomLineItemCheckoutURLFactory(factoryOpts)(),
+});

package/dist/astro/actions/index.d.ts

@@ -0,0 +1 @@
+export * from "./custom-checkout";

package/dist/astro/actions/index.js

@@ -0,0 +1 @@
+export * from "./custom-checkout";

package/dist/react/PayNow.d.ts

@@ -0,0 +1,18 @@
+export type PayNowRedirectToCheckout = () => void;
+/**
+ * Props passed to the render function of the PayNow component
+ */
+export interface PayNowRenderProps {
+    /** Whether the buy now operation is currently loading */
+    isLoading: boolean;
+    /** Function to redirect the user to the checkout page */
+    redirectToCheckout: PayNowRedirectToCheckout;
+    /** The error message if the buy now operation fails */
+    error: string | null;
+}
+export type PayNowChildren = (props: PayNowRenderProps) => React.ReactNode;
+export interface PayNowProps {
+    /** Render function that receives buy now state and actions */
+    children: PayNowChildren;
+}
+export declare function PayNow(props: PayNowProps): import("react").ReactNode;

package/dist/react/PayNow.js

@@ -0,0 +1,12 @@
+import { useService } from "@wix/services-manager-react";
+import { PayNowServiceDefinition } from "../services/pay-now-service";
+;
+;
+export function PayNow(props) {
+    const { redirectToCheckout, loadingSignal, errorSignal, } = useService(PayNowServiceDefinition);
+    return props.children({
+        isLoading: loadingSignal.get(),
+        error: errorSignal.get(),
+        redirectToCheckout,
+    });
+}

package/dist/react/index.d.ts

@@ -1 +1,2 @@
 export * from "./BuyNow";
+export * from "./PayNow";

package/dist/react/index.js

@@ -1 +1,2 @@
 export * from "./BuyNow";
+export * from "./PayNow";

package/dist/server-actions/custom-checkout-action.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Options for creating a checkout with a custom line item.
+ */
+export interface CustomLineItemCheckoutOptions {
+    /**
+     * The name of the product for the custom line item.
+     * @example "My Custom Product"
+     */
+    productName: string;
+    /**
+     * A description for the price, which will be displayed to the customer.
+     * @example "per month"
+     */
+    priceDescription?: string;
+    /**
+     * An array of policies related to this custom item.
+     * Each policy should have a title and content.
+     */
+    policies?: {
+        content: string;
+        title: string;
+    }[];
+    /**
+     * The URL to redirect the user to after the checkout is successfully completed.
+     */
+    postFlowUrl?: string;
+    /**
+     * The quantity of the product.
+     * @default 1
+     */
+    quantity?: number;
+    /**
+     * The price of the product.
+     */
+    price: string;
+}
+/**
+ * Creates a factory function to generate checkout URLs for custom line items with a fixed price.
+ * This is useful when you have a single product or service with a known price,
+ * and you want to dynamically create checkout sessions for it.
+ *
+ * @param factoryOpts - The options for the factory, including the price.
+ * @returns A function that takes `CustomLineItemCheckoutOptions` and returns a checkout URL.
+ */
+export declare function getCustomLineItemCheckoutURLFactory(factoryOpts: CustomLineItemCheckoutOptions): () => Promise<string>;

package/dist/server-actions/custom-checkout-action.js

@@ -0,0 +1,55 @@
+import { checkout } from "@wix/ecom";
+import { redirects } from "@wix/redirects";
+import { auth } from "@wix/essentials";
+/**
+ * Creates a factory function to generate checkout URLs for custom line items with a fixed price.
+ * This is useful when you have a single product or service with a known price,
+ * and you want to dynamically create checkout sessions for it.
+ *
+ * @param factoryOpts - The options for the factory, including the price.
+ * @returns A function that takes `CustomLineItemCheckoutOptions` and returns a checkout URL.
+ */
+export function getCustomLineItemCheckoutURLFactory(factoryOpts) {
+    /**
+     * Generates a checkout URL for a custom line item.
+     * @param opts - The options for the custom line item checkout.
+     * @returns A promise that resolves to the full URL for the redirect session to the checkout.
+     * @throws Will throw an error if the checkout creation or redirect session fails.
+     */
+    return async function getCustomLineItemCheckoutURL() {
+        try {
+            const checkoutResult = await auth.elevate(checkout.createCheckout)({
+                customLineItems: [
+                    {
+                        productName: {
+                            original: factoryOpts.productName,
+                        },
+                        price: factoryOpts.price,
+                        quantity: factoryOpts.quantity || 1,
+                        itemType: {
+                            preset: checkout.ItemTypeItemType.PHYSICAL,
+                        },
+                        priceDescription: {
+                            original: factoryOpts.priceDescription
+                        },
+                        policies: factoryOpts.policies || [],
+                    }
+                ],
+                channelType: checkout.ChannelType.WEB,
+            });
+            if (!checkoutResult._id) {
+                throw new Error(`Failed to create checkout for custom line item ${factoryOpts.productName}`);
+            }
+            const { redirectSession } = await redirects.createRedirectSession({
+                ecomCheckout: { checkoutId: checkoutResult._id },
+                callbacks: {
+                    ...(factoryOpts.postFlowUrl ? { postFlowUrl: factoryOpts.postFlowUrl } : {})
+                },
+            });
+            return redirectSession?.fullUrl;
+        }
+        catch (error) {
+            throw error;
+        }
+    };
+}

package/dist/server-actions/index.d.ts

@@ -0,0 +1 @@
+export * from "./custom-checkout-action";

package/dist/server-actions/index.js

@@ -0,0 +1 @@
+export * from "./custom-checkout-action";

package/dist/services/buy-now-service.d.ts

@@ -42,7 +42,7 @@ export declare const loadBuyNowServiceInitialData: (productSlug: string, variant
 }>;
 export declare const buyNowServiceBinding: <T extends {
     [key: string]: Awaited<ReturnType<typeof loadBuyNowServiceInitialData>>[typeof BuyNowServiceDefinition];
-}>(servicesConfigs: T) => readonly [string & {
+}>(servicesConfigs: T, additionalConfig?: Partial<ServiceFactoryConfig<typeof BuyNowServiceImplementation>>) => readonly [string & {
     __api: {
         redirectToCheckout: () => Promise<void>;
         loadingSignal: Signal<boolean>;

package/dist/services/buy-now-service.js

@@ -15,7 +15,7 @@ export const BuyNowServiceImplementation = implementService.withConfig()(BuyNowS
                 window.location.href = checkoutUrl;
             }
             catch (error) {
-                errorSignal.set(error);
+                errorSignal.set(error.toString());
                 loadingSignal.set(false);
             }
         },
@@ -49,10 +49,13 @@ export const loadBuyNowServiceInitialData = async (productSlug, variantId) => {
         },
     };
 };
-export const buyNowServiceBinding = (servicesConfigs) => {
+export const buyNowServiceBinding = (servicesConfigs, additionalConfig = {}) => {
     return [
         BuyNowServiceDefinition,
         BuyNowServiceImplementation,
-        servicesConfigs[BuyNowServiceDefinition],
+        {
+            ...servicesConfigs[BuyNowServiceDefinition],
+            ...additionalConfig,
+        },
     ];
 };

package/dist/services/index.d.ts

@@ -1 +1,2 @@
 export { buyNowServiceBinding, loadBuyNowServiceInitialData, } from "./buy-now-service";
+export { payNowServiceBinding, loadPayNowServiceInitialData, } from "./pay-now-service";

package/dist/services/index.js

@@ -1 +1,2 @@
 export { buyNowServiceBinding, loadBuyNowServiceInitialData, } from "./buy-now-service";
+export { payNowServiceBinding, loadPayNowServiceInitialData, } from "./pay-now-service";

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

@@ -0,0 +1,72 @@
+import { ServiceFactoryConfig, Signal } from "@wix/services-definitions";
+export declare const PayNowServiceDefinition: string & {
+    __api: {
+        redirectToCheckout: () => Promise<void>;
+        loadingSignal: Signal<boolean>;
+        errorSignal: Signal<string | null>;
+    };
+    __config: {};
+    isServiceDefinition?: boolean;
+} & {
+    redirectToCheckout: () => Promise<void>;
+    loadingSignal: Signal<boolean>;
+    errorSignal: Signal<string | null>;
+};
+export declare const PayNowServiceImplementation: import("@wix/services-definitions").ServiceFactory<string & {
+    __api: {
+        redirectToCheckout: () => Promise<void>;
+        loadingSignal: Signal<boolean>;
+        errorSignal: Signal<string | null>;
+    };
+    __config: {};
+    isServiceDefinition?: boolean;
+} & {
+    redirectToCheckout: () => Promise<void>;
+    loadingSignal: Signal<boolean>;
+    errorSignal: Signal<string | null>;
+}, {
+    customCheckoutAction?: () => Promise<{
+        data: string | undefined;
+        error: unknown;
+    }>;
+}, import("@wix/services-definitions").ThreadMode.MAIN>;
+export declare const loadPayNowServiceInitialData: () => Promise<{
+    [PayNowServiceDefinition]: {};
+}>;
+export declare const payNowServiceBinding: <T extends {
+    [key: string]: Awaited<ReturnType<typeof loadPayNowServiceInitialData>>[typeof PayNowServiceDefinition];
+}>(servicesConfigs: T, additionalConfig?: Partial<ServiceFactoryConfig<typeof PayNowServiceImplementation>>) => readonly [string & {
+    __api: {
+        redirectToCheckout: () => Promise<void>;
+        loadingSignal: Signal<boolean>;
+        errorSignal: Signal<string | null>;
+    };
+    __config: {};
+    isServiceDefinition?: boolean;
+} & {
+    redirectToCheckout: () => Promise<void>;
+    loadingSignal: Signal<boolean>;
+    errorSignal: Signal<string | null>;
+}, import("@wix/services-definitions").ServiceFactory<string & {
+    __api: {
+        redirectToCheckout: () => Promise<void>;
+        loadingSignal: Signal<boolean>;
+        errorSignal: Signal<string | null>;
+    };
+    __config: {};
+    isServiceDefinition?: boolean;
+} & {
+    redirectToCheckout: () => Promise<void>;
+    loadingSignal: Signal<boolean>;
+    errorSignal: Signal<string | null>;
+}, {
+    customCheckoutAction?: () => Promise<{
+        data: string | undefined;
+        error: unknown;
+    }>;
+}, import("@wix/services-definitions").ThreadMode.MAIN>, {
+    customCheckoutAction?: () => Promise<{
+        data: string | undefined;
+        error: unknown;
+    }>;
+}];

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

@@ -0,0 +1,45 @@
+import { defineService, implementService, } from "@wix/services-definitions";
+import { SignalsServiceDefinition } from "@wix/services-definitions/core-services/signals";
+export const PayNowServiceDefinition = defineService("PayNow");
+export const PayNowServiceImplementation = implementService.withConfig()(PayNowServiceDefinition, ({ getService, config }) => {
+    const signalsService = getService(SignalsServiceDefinition);
+    const loadingSignal = signalsService.signal(false);
+    const errorSignal = signalsService.signal(null);
+    return {
+        redirectToCheckout: async () => {
+            loadingSignal.set(true);
+            try {
+                if (config.customCheckoutAction) {
+                    const result = await config.customCheckoutAction();
+                    if (result && result.data) {
+                        window.location.href = result.data;
+                    }
+                    else {
+                        throw new Error("Failed to create checkout" + result?.error);
+                    }
+                }
+            }
+            catch (error) {
+                errorSignal.set(error.toString());
+                loadingSignal.set(false);
+            }
+        },
+        loadingSignal,
+        errorSignal,
+    };
+});
+export const loadPayNowServiceInitialData = async () => {
+    return {
+        [PayNowServiceDefinition]: {},
+    };
+};
+export const payNowServiceBinding = (servicesConfigs, additionalConfig = {}) => {
+    return [
+        PayNowServiceDefinition,
+        PayNowServiceImplementation,
+        {
+            ...servicesConfigs[PayNowServiceDefinition],
+            ...additionalConfig,
+        },
+    ];
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/headless-stores",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "scripts": {
     "build": "tsc",
     "test": "vitest"
@@ -10,7 +10,9 @@
   ],
   "exports": {
     "./react": "./dist/react/index.js",
-    "./services": "./dist/services/index.js"
+    "./services": "./dist/services/index.js",
+    "./server-actions": "./dist/server-actions/index.js",
+    "./astro/actions": "./dist/astro/actions/index.js"
   },
   "devDependencies": {
     "@testing-library/dom": "^10.4.0",
@@ -24,6 +26,7 @@
   },
   "dependencies": {
     "@wix/ecom": "^1.0.1169",
+    "@wix/essentials": "^0.1.22",
     "@wix/redirects": "^1.0.79",
     "@wix/services-definitions": "^0.1.2",
     "@wix/services-manager-react": "^0.1.9"

package/dist/react/CurrentCartServiceProvider.d.ts

@@ -1,5 +0,0 @@
-import React from "react";
-export declare const CurrentCartServiceContext: React.Context<unknown>;
-export declare function CurrentCartServiceProvider(props: {
-    children: React.ReactNode;
-}): import("react/jsx-runtime").JSX.Element;

package/dist/react/CurrentCartServiceProvider.js

@@ -1,12 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import React from "react";
-import { CurrentCartService } from "../services/CurrentCartService";
-export const CurrentCartServiceContext = React.createContext(null);
-export function CurrentCartServiceProvider(props) {
-    const theService = CurrentCartService({
-        // @ts-expect-error
-        getService: () => { },
-        config: {},
-    });
-    return (_jsx(CurrentCartServiceContext.Provider, { value: theService, children: props.children }));
-}

package/dist/react/VariantSelectorServiceProvider.d.ts

@@ -1,7 +0,0 @@
-import React from "react";
-import { productsV3 } from "@wix/stores";
-export declare const VariantSelectorContext: React.Context<unknown>;
-export declare function VariantSelectorServiceProvider(props: {
-    product: productsV3.V3Product;
-    children: React.ReactNode;
-}): import("react/jsx-runtime").JSX.Element;

package/dist/react/VariantSelectorServiceProvider.js

@@ -1,22 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import React, { useContext } from "react";
-import { VariantSelectorService } from "../services/VariantSelectorServices";
-import { CurrentCartServiceContext } from "./CurrentCartServiceProvider";
-import { CurrentCartServiceDefinition } from "../services/CurrentCartService";
-export const VariantSelectorContext = React.createContext(null);
-export function VariantSelectorServiceProvider(props) {
-    const currentCartService = useContext(CurrentCartServiceContext);
-    const theService = VariantSelectorService({
-        // @ts-expect-error
-        getService: (id) => {
-            if (id === CurrentCartServiceDefinition) {
-                return currentCartService;
-            }
-            throw new Error(`Unknown service: ${id}`);
-        },
-        config: {
-            product: props.product,
-        },
-    });
-    return (_jsx(VariantSelectorContext.Provider, { value: theService, children: props.children }));
-}

package/dist/services/CurrentCartService.d.ts

@@ -1,18 +0,0 @@
-export declare const CurrentCartServiceDefinition: string & {
-    __api: {
-        addItem: () => void;
-    };
-    __config: {};
-    isServiceDefinition?: boolean;
-} & {
-    addItem: () => void;
-};
-export declare const CurrentCartService: import("@wix/services-definitions").ServiceFactory<string & {
-    __api: {
-        addItem: () => void;
-    };
-    __config: {};
-    isServiceDefinition?: boolean;
-} & {
-    addItem: () => void;
-}, {}, import("@wix/services-definitions").ThreadMode.MAIN>;

package/dist/services/CurrentCartService.js

@@ -1,9 +0,0 @@
-import { defineService, implementService } from "@wix/services-definitions";
-export const CurrentCartServiceDefinition = defineService("kaki2");
-export const CurrentCartService = implementService.withConfig()(CurrentCartServiceDefinition, () => {
-    return {
-        addItem: () => {
-            alert("addItem");
-        },
-    };
-});

package/dist/services/VariantSelectorServices.d.ts

@@ -1,8 +0,0 @@
-import { productsV3 } from "@wix/stores";
-export declare const VariantSelectorService: import("@wix/services-definitions").ServiceFactory<string & {
-    __api: {};
-    __config: {};
-    isServiceDefinition?: boolean;
-}, {
-    product: productsV3.V3Product;
-}, import("@wix/services-definitions").ThreadMode.MAIN>;

package/dist/services/VariantSelectorServices.js

@@ -1,20 +0,0 @@
-import { defineService, implementService, } from "@wix/services-definitions";
-import { SignalsServiceDefinition } from "@wix/services-definitions/core-services/signals";
-import { CurrentCartServiceDefinition } from "./CurrentCartService";
-const VariantSelectorServiceDefinition = defineService("kaki");
-export const VariantSelectorService = implementService.withConfig()(VariantSelectorServiceDefinition, ({ getService, config }) => {
-    const cartService = getService(CurrentCartServiceDefinition);
-    const signalsService = getService(SignalsServiceDefinition);
-    const selectedVariant = signalsService.signal((config.product.variantsInfo?.variants ?? []).length > 0
-        ? config.product.variantsInfo.variants[0]._id
-        : null);
-    return {
-        selectedVariant,
-        setSelectedVariant: (variant) => {
-            selectedVariant.set(variant);
-        },
-        addToCart: async () => {
-            await cartService.addItem();
-        },
-    };
-});