@wix/headless-stores 0.0.0

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

@@ -0,0 +1,73 @@
+/**
+ * Utility class for managing URL parameters in web applications.
+ * Provides methods to parse, update, and retrieve URL search parameters with support for multiple values.
+ *
+ * @class URLParamsUtils
+ */
+export declare class URLParamsUtils {
+    /**
+     * Parses URLSearchParams into a more convenient format that supports multiple values for the same key.
+     * Converts multiple parameters with the same key into an array.
+     *
+     * @static
+     * @param {URLSearchParams} searchParams - The URLSearchParams object to parse
+     * @returns {Record<string, string | string[]>} Object with parameter names as keys and values as strings or arrays
+     *
+     * @example
+     * ```typescript
+     * // URL: ?color=red&color=blue&size=large
+     * const params = new URLSearchParams('color=red&color=blue&size=large');
+     * const parsed = URLParamsUtils.parseSearchParams(params);
+     * // Result: { color: ['red', 'blue'], size: 'large' }
+     * ```
+     */
+    static parseSearchParams(searchParams: URLSearchParams): Record<string, string | string[]>;
+    /**
+     * Updates the current page URL with new parameters without causing a page reload.
+     * Supports multiple values for the same parameter key.
+     *
+     * @static
+     * @param {Record<string, string | string[]>} params - Object with parameter names and values to set
+     *
+     * @example
+     * ```typescript
+     * // Update URL with single and multiple values
+     * URLParamsUtils.updateURL({
+     *   category: 'electronics',
+     *   color: ['red', 'blue'],
+     *   price: '100'
+     * });
+     * // URL becomes: ?category=electronics&color=red&color=blue&price=100
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Clear all parameters by passing empty object
+     * URLParamsUtils.updateURL({});
+     * // URL becomes: current-path (no query string)
+     * ```
+     */
+    static updateURL(params: Record<string, string | string[]>): void;
+    /**
+     * Gets the current URL parameters parsed into a convenient format.
+     * Returns an empty object when running in server-side environment.
+     *
+     * @static
+     * @returns {Record<string, string | string[]>} Object with current URL parameters
+     *
+     * @example
+     * ```typescript
+     * // Current URL: ?category=electronics&color=red&color=blue
+     * const params = URLParamsUtils.getURLParams();
+     * // Result: { category: 'electronics', color: ['red', 'blue'] }
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Server-side usage
+     * const params = URLParamsUtils.getURLParams();
+     * // Result: {} (empty object)
+     * ```
+     */
+    static getURLParams(): Record<string, string | string[]>;
+}

package/dist/utils/url-params.js

@@ -0,0 +1,114 @@
+/**
+ * Utility class for managing URL parameters in web applications.
+ * Provides methods to parse, update, and retrieve URL search parameters with support for multiple values.
+ *
+ * @class URLParamsUtils
+ */
+export class URLParamsUtils {
+    /**
+     * Parses URLSearchParams into a more convenient format that supports multiple values for the same key.
+     * Converts multiple parameters with the same key into an array.
+     *
+     * @static
+     * @param {URLSearchParams} searchParams - The URLSearchParams object to parse
+     * @returns {Record<string, string | string[]>} Object with parameter names as keys and values as strings or arrays
+     *
+     * @example
+     * ```typescript
+     * // URL: ?color=red&color=blue&size=large
+     * const params = new URLSearchParams('color=red&color=blue&size=large');
+     * const parsed = URLParamsUtils.parseSearchParams(params);
+     * // Result: { color: ['red', 'blue'], size: 'large' }
+     * ```
+     */
+    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;
+    }
+    /**
+     * Updates the current page URL with new parameters without causing a page reload.
+     * Supports multiple values for the same parameter key.
+     *
+     * @static
+     * @param {Record<string, string | string[]>} params - Object with parameter names and values to set
+     *
+     * @example
+     * ```typescript
+     * // Update URL with single and multiple values
+     * URLParamsUtils.updateURL({
+     *   category: 'electronics',
+     *   color: ['red', 'blue'],
+     *   price: '100'
+     * });
+     * // URL becomes: ?category=electronics&color=red&color=blue&price=100
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Clear all parameters by passing empty object
+     * URLParamsUtils.updateURL({});
+     * // URL becomes: current-path (no query string)
+     * ```
+     */
+    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);
+    }
+    /**
+     * Gets the current URL parameters parsed into a convenient format.
+     * Returns an empty object when running in server-side environment.
+     *
+     * @static
+     * @returns {Record<string, string | string[]>} Object with current URL parameters
+     *
+     * @example
+     * ```typescript
+     * // Current URL: ?category=electronics&color=red&color=blue
+     * const params = URLParamsUtils.getURLParams();
+     * // Result: { category: 'electronics', color: ['red', 'blue'] }
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Server-side usage
+     * const params = URLParamsUtils.getURLParams();
+     * // Result: {} (empty object)
+     * ```
+     */
+    static getURLParams() {
+        if (typeof window === 'undefined')
+            return {};
+        return this.parseSearchParams(new URLSearchParams(window.location.search));
+    }
+}

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "@wix/headless-stores",
+  "version": "0.0.0",
+  "license": "MIT",
+  "type": "module",
+  "scripts": {
+    "prebuild": "cd ../media && yarn build && cd ../ecom && yarn build",
+    "build": "npm run build:esm && npm run build:cjs",
+    "build:esm": "tsc -p tsconfig.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "test": "vitest",
+    "lint:fix": "prettier --write \"src/**/*.{ts,tsx,js,jsx,json,md}\"",
+    "lint:check": "prettier --check \"src/**/*.{ts,tsx,js,jsx,json,md}\""
+  },
+  "files": [
+    "dist",
+    "cjs",
+    "react",
+    "services",
+    "server-actions",
+    "astro"
+  ],
+  "exports": {
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js",
+      "require": "./cjs/dist/react/index.js"
+    },
+    "./services": {
+      "types": "./dist/services/index.d.ts",
+      "import": "./dist/services/index.js",
+      "require": "./cjs/dist/services/index.js"
+    },
+    "./server-actions": {
+      "types": "./dist/server-actions/index.d.ts",
+      "import": "./dist/server-actions/index.js",
+      "require": "./cjs/dist/server-actions/index.js"
+    },
+    "./astro/actions": {
+      "types": "./dist/astro/actions/index.d.ts",
+      "import": "./dist/astro/actions/index.js",
+      "require": "./cjs/dist/astro/actions/index.js"
+    }
+  },
+  "devDependencies": {
+    "@testing-library/dom": "^10.4.0",
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/react": "^16.3.0",
+    "@types/node": "^20.9.0",
+    "@vitest/ui": "^3.1.4",
+    "@wix/categories": "^1.0.133",
+    "@wix/stores": "^1.0.551",
+    "jsdom": "^26.1.0",
+    "prettier": "^3.4.2",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.4"
+  },
+  "dependencies": {
+    "@radix-ui/react-slot": "^1.2.3",
+    "@wix/auto_sdk_bookings_availability-calendar": "^1.0.155",
+    "@wix/auto_sdk_categories_categories": "^1.0.62",
+    "@wix/auto_sdk_stores_customizations-v-3": "^1.0.26",
+    "@wix/auto_sdk_stores_inventory-items-v-3": "^1.0.26",
+    "@wix/auto_sdk_stores_products-v-3": "^1.0.53",
+    "@wix/auto_sdk_stores_read-only-variants-v-3": "^1.0.23",
+    "@wix/ecom": "^1.0.1461",
+    "@wix/essentials": "^0.1.24",
+    "@wix/headless-ecom": "0.0.0",
+    "@wix/headless-media": "0.0.0",
+    "@wix/headless-utils": "0.0.0",
+    "@wix/redirects": "^1.0.83",
+    "@wix/services-definitions": "^0.1.4",
+    "@wix/services-manager-react": "^0.1.26"
+  },
+  "peerDependencies": {
+    "@wix/headless-components": "workspace:*"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "wix": {
+    "artifact": {
+      "artifactId": "headless-stores",
+      "groupId": "com.wixpress.headless-components"
+    }
+  },
+  "falconPackageHash": "7653948b615ac703ee86eb8d5519ffba34d7becae41c1e3fe7a33c8e"
+}

package/react/package.json

@@ -0,0 +1,4 @@
+{
+  "main": "../cjs/dist/react/index.js",
+  "types": "../dist/react/index.d.ts"
+}

package/server-actions/package.json

@@ -0,0 +1,4 @@
+{
+  "main": "../cjs/dist/server-actions/index.js",
+  "types": "../dist/server-actions/index.d.ts"
+}

package/services/package.json

@@ -0,0 +1,4 @@
+{
+  "main": "../cjs/dist/services/index.js",
+  "types": "../dist/services/index.d.ts"
+}