medusa-product-helper 0.0.13 → 0.0.16

package/.medusa/server/src/services/filter-provider-loader.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadFilterProviders = loadFilterProviders;
+const base_filter_provider_1 = require("../providers/filter-providers/base-filter-provider");
+/**
+ * Load filter providers from configuration.
+ *
+ * This function loads custom filter providers from file paths or module references.
+ * Supports both:
+ * - File paths (relative to baseDir or absolute)
+ * - Module references (npm package names)
+ *
+ * @param configs - Array of filter provider configurations
+ * @param options - Loading options
+ * @returns Array of instantiated filter provider instances
+ * @throws Error if provider cannot be loaded or instantiated
+ *
+ * @example
+ * ```ts
+ * // Load from file path
+ * const providers = await loadFilterProviders([
+ *   "./src/providers/margin-provider.ts"
+ * ])
+ *
+ * // Load from module
+ * const providers = await loadFilterProviders([
+ *   "@my-org/custom-filters/margin-provider"
+ * ])
+ *
+ * // Load with options
+ * const providers = await loadFilterProviders([
+ *   { path: "./src/providers/margin-provider.ts", options: { minMargin: 10 } }
+ * ])
+ * ```
+ */
+async function loadFilterProviders(configs, options = {}) {
+    const providers = [];
+    const baseDir = options.baseDir || process.cwd();
+    for (const config of configs) {
+        try {
+            let providerModule;
+            let providerPath;
+            // Resolve config to path
+            if (typeof config === "string") {
+                providerPath = config;
+            }
+            else {
+                providerPath = config.path;
+            }
+            // Try to load as module first (npm package)
+            try {
+                providerModule = await import(providerPath);
+            }
+            catch (moduleError) {
+                // If module import fails, try as file path
+                const path = require("path");
+                const fs = require("fs");
+                // Resolve absolute path
+                const absolutePath = path.isAbsolute(providerPath)
+                    ? providerPath
+                    : path.resolve(baseDir, providerPath);
+                // Check if file exists
+                if (!fs.existsSync(absolutePath)) {
+                    throw new Error(`Filter provider file not found: ${absolutePath}`);
+                }
+                // Try dynamic import with file:// protocol for absolute paths
+                try {
+                    providerModule = await import(absolutePath);
+                }
+                catch (fileError) {
+                    // Try with require for CommonJS modules
+                    try {
+                        providerModule = require(absolutePath);
+                    }
+                    catch (requireError) {
+                        throw new Error(`Failed to load filter provider from ${providerPath}: ${String(moduleError)}`);
+                    }
+                }
+            }
+            // Extract provider class from module
+            // Support both default export and named export
+            let ProviderClass;
+            if (providerModule && typeof providerModule === "object") {
+                // Try default export first
+                if ("default" in providerModule &&
+                    typeof providerModule.default === "function") {
+                    ProviderClass = providerModule.default;
+                }
+                else {
+                    // Try to find a class that extends BaseFilterProvider
+                    // Look for exported classes
+                    for (const [key, value] of Object.entries(providerModule)) {
+                        if (typeof value === "function" &&
+                            value.prototype &&
+                            Object.getPrototypeOf(value.prototype)?.constructor ===
+                                base_filter_provider_1.BaseFilterProvider) {
+                            ProviderClass = value;
+                            break;
+                        }
+                    }
+                }
+            }
+            if (!ProviderClass) {
+                throw new Error(`No filter provider class found in ${providerPath}. ` +
+                    `Expected a class extending BaseFilterProvider as default export or named export.`);
+            }
+            // Validate that it's a BaseFilterProvider subclass
+            // Check for required static properties
+            if (!("identifier" in ProviderClass) ||
+                typeof ProviderClass.identifier !== "string") {
+                throw new Error(`Class in ${providerPath} does not appear to extend BaseFilterProvider. ` +
+                    `Missing static 'identifier' property.`);
+            }
+            // Check for displayName
+            if (!("displayName" in ProviderClass) ||
+                typeof ProviderClass.displayName !== "string") {
+                throw new Error(`Class in ${providerPath} does not appear to extend BaseFilterProvider. ` +
+                    `Missing static 'displayName' property.`);
+            }
+            // Instantiate provider
+            // If config has options, pass them to constructor (if supported)
+            const providerConfig = typeof config === "object" && config.options
+                ? config.options
+                : undefined;
+            // Instantiate provider
+            // We've validated that ProviderClass extends BaseFilterProvider and has required properties
+            // TypeScript sees it as abstract, but at runtime it's a concrete class
+            // Use type assertion to allow instantiation
+            let provider;
+            if (providerConfig) {
+                // Try to instantiate with options
+                try {
+                    // @ts-expect-error - ProviderClass is validated at runtime to be a concrete subclass
+                    provider = new ProviderClass(providerConfig);
+                }
+                catch {
+                    // If constructor doesn't accept options, instantiate without
+                    // @ts-expect-error - ProviderClass is validated at runtime to be a concrete subclass
+                    provider = new ProviderClass();
+                }
+            }
+            else {
+                // @ts-expect-error - ProviderClass is validated at runtime to be a concrete subclass
+                provider = new ProviderClass();
+            }
+            providers.push(provider);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to load filter provider from config ${JSON.stringify(config)}: ${errorMessage}`);
+        }
+    }
+    return providers;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmlsdGVyLXByb3ZpZGVyLWxvYWRlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9zZXJ2aWNlcy9maWx0ZXItcHJvdmlkZXItbG9hZGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBNkNBLGtEQXNKQztBQW5NRCw2RkFBdUY7QUFjdkY7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQThCRztBQUNJLEtBQUssVUFBVSxtQkFBbUIsQ0FDdkMsT0FBK0IsRUFDL0IsVUFBc0MsRUFBRTtJQUV4QyxNQUFNLFNBQVMsR0FBeUIsRUFBRSxDQUFBO0lBQzFDLE1BQU0sT0FBTyxHQUFHLE9BQU8sQ0FBQyxPQUFPLElBQUksT0FBTyxDQUFDLEdBQUcsRUFBRSxDQUFBO0lBRWhELEtBQUssTUFBTSxNQUFNLElBQUksT0FBTyxFQUFFLENBQUM7UUFDN0IsSUFBSSxDQUFDO1lBQ0gsSUFBSSxjQUF1QixDQUFBO1lBQzNCLElBQUksWUFBb0IsQ0FBQTtZQUV4Qix5QkFBeUI7WUFDekIsSUFBSSxPQUFPLE1BQU0sS0FBSyxRQUFRLEVBQUUsQ0FBQztnQkFDL0IsWUFBWSxHQUFHLE1BQU0sQ0FBQTtZQUN2QixDQUFDO2lCQUFNLENBQUM7Z0JBQ04sWUFBWSxHQUFHLE1BQU0sQ0FBQyxJQUFJLENBQUE7WUFDNUIsQ0FBQztZQUVELDRDQUE0QztZQUM1QyxJQUFJLENBQUM7Z0JBQ0gsY0FBYyxHQUFHLE1BQU0sTUFBTSxDQUFDLFlBQVksQ0FBQyxDQUFBO1lBQzdDLENBQUM7WUFBQyxPQUFPLFdBQVcsRUFBRSxDQUFDO2dCQUNyQiwyQ0FBMkM7Z0JBQzNDLE1BQU0sSUFBSSxHQUFHLE9BQU8sQ0FBQyxNQUFNLENBQUMsQ0FBQTtnQkFDNUIsTUFBTSxFQUFFLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFBO2dCQUV4Qix3QkFBd0I7Z0JBQ3hCLE1BQU0sWUFBWSxHQUFHLElBQUksQ0FBQyxVQUFVLENBQUMsWUFBWSxD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

package/.medusa/server/src/services/filter-provider-registry.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilterProviderRegistry = void 0;
+/**
+ * Service for managing filter provider registration and retrieval.
+ *
+ * The registry maintains a map of filter providers keyed by their identifiers,
+ * ensuring uniqueness and providing fast lookup. Providers are registered
+ * at plugin initialization and can be retrieved by their identifier when
+ * applying filters.
+ *
+ * @example
+ * ```ts
+ * const registry = new FilterProviderRegistry()
+ * registry.register(new CategoryFilterProvider())
+ *
+ * const provider = registry.get("category_id")
+ * if (provider) {
+ *   const filters = provider.apply({}, ["cat_123"])
+ * }
+ * ```
+ */
+class FilterProviderRegistry {
+    constructor() {
+        this.providers = new Map();
+    }
+    /**
+     * Register a filter provider.
+     *
+     * Throws an error if a provider with the same identifier is already registered.
+     *
+     * @param provider - Filter provider instance to register
+     * @throws Error if provider identifier is already registered
+     *
+     * @example
+     * ```ts
+     * registry.register(new CategoryFilterProvider())
+     * ```
+     */
+    register(provider) {
+        const identifier = provider.constructor
+            .identifier;
+        if (!identifier) {
+            throw new Error("Filter provider must have a static 'identifier' property");
+        }
+        if (this.providers.has(identifier)) {
+            const existingProvider = this.providers.get(identifier);
+            const existingDisplayName = (existingProvider?.constructor)
+                .displayName || "Unknown";
+            throw new Error(`Filter provider with identifier "${identifier}" (${existingDisplayName}) is already registered. ` +
+                `Cannot register ${provider.constructor.displayName || "Unknown"}.`);
+        }
+        this.providers.set(identifier, provider);
+    }
+    /**
+     * Get a provider by identifier.
+     *
+     * @param identifier - Provider identifier to look up
+     * @returns Provider instance if found, undefined otherwise
+     *
+     * @example
+     * ```ts
+     * const provider = registry.get("category_id")
+     * if (provider) {
+     *   // Use provider
+     * }
+     * ```
+     */
+    get(identifier) {
+        return this.providers.get(identifier);
+    }
+    /**
+     * Check if a provider is registered.
+     *
+     * @param identifier - Provider identifier to check
+     * @returns true if provider is registered, false otherwise
+     *
+     * @example
+     * ```ts
+     * if (registry.has("category_id")) {
+     *   // Provider exists
+     * }
+     * ```
+     */
+    has(identifier) {
+        return this.providers.has(identifier);
+    }
+    /**
+     * Get all registered providers.
+     *
+     * @returns Array of all registered provider instances
+     *
+     * @example
+     * ```ts
+     * const allProviders = registry.getAll()
+     * allProviders.forEach(provider => {
+     *   console.log(provider.constructor.identifier)
+     * })
+     * ```
+     */
+    getAll() {
+        return Array.from(this.providers.values());
+    }
+    /**
+     * Get all provider identifiers.
+     *
+     * @returns Array of all registered provider identifiers
+     *
+     * @example
+     * ```ts
+     * const identifiers = registry.getIdentifiers()
+     * // ["category_id", "collection_id", "price_range", ...]
+     * ```
+     */
+    getIdentifiers() {
+        return Array.from(this.providers.keys());
+    }
+    /**
+     * Clear all registered providers.
+     *
+     * Useful for testing or resetting the registry state.
+     *
+     * @example
+     * ```ts
+     * registry.clear()
+     * // All providers removed
+     * ```
+     */
+    clear() {
+        this.providers.clear();
+    }
+    /**
+     * Get the number of registered providers.
+     *
+     * @returns Number of registered providers
+     */
+    size() {
+        return this.providers.size;
+    }
+}
+exports.FilterProviderRegistry = FilterProviderRegistry;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmlsdGVyLXByb3ZpZGVyLXJlZ2lzdHJ5LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3NlcnZpY2VzL2ZpbHRlci1wcm92aWRlci1yZWdpc3RyeS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFFQTs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBa0JHO0FBQ0gsTUFBYSxzQkFBc0I7SUFBbkM7UUFDVSxjQUFTLEdBQW9DLElBQUksR0FBRyxFQUFFLENBQUE7SUFrSWhFLENBQUM7SUFoSUM7Ozs7Ozs7Ozs7OztPQVlHO0lBQ0gsUUFBUSxDQUFDLFFBQTRCO1FBQ25DLE1BQU0sVUFBVSxHQUFJLFFBQVEsQ0FBQyxXQUF5QzthQUNuRSxVQUFVLENBQUE7UUFFYixJQUFJLENBQUMsVUFBVSxFQUFFLENBQUM7WUFDaEIsTUFBTSxJQUFJLEtBQUssQ0FDYiwwREFBMEQsQ0FDM0QsQ0FBQTtRQUNILENBQUM7UUFFRCxJQUFJLElBQUksQ0FBQyxTQUFTLENBQUMsR0FBRyxDQUFDLFVBQVUsQ0FBQyxFQUFFLENBQUM7WUFDbkMsTUFBTSxnQkFBZ0IsR0FBRyxJQUFJLENBQUMsU0FBUyxDQUFDLEdBQUcsQ0FBQyxVQUFVLENBQUMsQ0FBQTtZQUN2RCxNQUFNLG1CQUFtQixHQUN2QixDQUFDLGdCQUFnQixFQUFFLFdBQXlDLENBQUE7aUJBQ3pELFdBQVcsSUFBSSxTQUFTLENBQUE7WUFFN0IsTUFBTSxJQUFJLEtBQUssQ0FDYixvQ0FBb0MsVUFBVSxNQUFNLG1CQUFtQiwyQkFBMkI7Z0JBQ2hHLG1CQUFvQixRQUFRLENBQUMsV0FBeUMsQ0FBQyxXQUFXLElBQUksU0FBUyxHQUFHLENBQ3JHLENBQUE7UUFDSCxDQUFDO1FBRUQsSUFBSSxDQUFDLFNBQVMsQ0FBQyxHQUFHLENBQUMsVUFBVSxFQUFFLFFBQVEsQ0FBQyxDQUFBO0lBQzFDLENBQUM7SUFFRDs7Ozs7Ozs7Ozs7OztPQWFHO0lBQ0gsR0FBRyxDQUFDLFVBQWtCO1FBQ3BCLE9BQU8sSUFBSSxDQUFDLFNBQVMsQ0FBQyxHQUFHLENBQUMsVUFBVSxDQUFDLENBQUE7SUFDdkMsQ0FBQztJQUVEOzs7Ozs7Ozs7Ozs7T0FZRztJQUNILEdBQUcsQ0FBQyxVQUFrQjtRQUNwQixPQUFPLElBQUksQ0FBQyxTQUFTLENBQUMsR0FBRyxDQUFDLFVBQVUsQ0FBQyxDQUFBO0lBQ3ZDLENBQUM7SUFFRDs7Ozs7Ozs7Ozs7O09BWUc7SUFDSCxNQUFNO1FBQ0osT0FBTyxLQUFLLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxTQUFTLENBQUMsTUFBTSxFQUFFLENBQUMsQ0FBQTtJQUM1QyxDQUFDO0lBRUQ7Ozs7Ozs7Ozs7T0FVRztJQUNILGNBQWM7UUFDWixPQUFPLEtBQUssQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxJQUFJLEVBQUUsQ0FBQyxDQUFBO0lBQzFDLENBQUM7SUFFRDs7Ozs7Ozs7OztPQVVHO0lBQ0gsS0FBSztRQUNILElBQUksQ0FBQyxTQUFTLENBQUMsS0FBSyxFQUFFLENBQUE7SUFDeEIsQ0FBQztJQUVEOzs7O09BSUc7SUFDSCxJQUFJO1FBQ0YsT0FBTyxJQUFJLENBQUMsU0FBUyxDQUFDLElBQUksQ0FBQTtJQUM1QixDQUFDO0NBQ0Y7QUFuSUQsd0RBbUlDIn0=

package/.medusa/server/src/services/product-filter-service.js

@@ -0,0 +1,230 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProductFilterService = void 0;
+const dynamic_filter_service_1 = require("./dynamic-filter-service");
+const index_1 = require("../index");
+/**
+ * Service that integrates DynamicFilterService with the existing ProductFilterPlan structure.
+ *
+ * This service bridges the gap between the legacy filter plan system and the new
+ * provider-based filter system, maintaining backward compatibility while enabling
+ * the new provider architecture.
+ *
+ * @example
+ * ```ts
+ * const service = new ProductFilterService(container)
+ * const result = await service.applyFilterPlan(plan, options)
+ * ```
+ */
+class ProductFilterService {
+    constructor(container) {
+        // Try to resolve DynamicFilterService from container, create if not found
+        try {
+            this.dynamicFilterService = container.resolve(index_1.DYNAMIC_FILTER_SERVICE);
+        }
+        catch {
+            // Service not registered, create new instance
+            this.dynamicFilterService = new dynamic_filter_service_1.DynamicFilterService(container);
+        }
+    }
+    /**
+     * Apply filters using Medusa's request context (queryConfig, filterableFields, pricingContext).
+     *
+     * This method integrates with Medusa's official store products API format,
+     * merging custom filter providers with Medusa's built-in filterableFields.
+     *
+     * @param context - Medusa request context
+     * @param options - Plugin options
+     * @returns Products, count, and metadata matching Medusa's format
+     */
+    async applyFilterPlanWithMedusaContext(context, options) {
+        // Extract custom filter parameters from query (for price_range, etc.)
+        const customFilterParams = {};
+        // Parse price_range from query if present (price_range[min], price_range[max], price_range[currency_code])
+        if (context.query?.price_range && typeof context.query.price_range === "object" && !Array.isArray(context.query.price_range)) {
+            const priceRange = context.query.price_range;
+            const min = typeof priceRange.min === "string" || typeof priceRange.min === "number"
+                ? (typeof priceRange.min === "string" ? Number(priceRange.min) : priceRange.min)
+                : undefined;
+            const max = typeof priceRange.max === "string" || typeof priceRange.max === "number"
+                ? (typeof priceRange.max === "string" ? Number(priceRange.max) : priceRange.max)
+                : undefined;
+            if ((min !== undefined && !Number.isNaN(min)) || (max !== undefined && !Number.isNaN(max))) {
+                customFilterParams.price_range = {
+                    min: min !== undefined && !Number.isNaN(min) ? min : undefined,
+                    max: max !== undefined && !Number.isNaN(max) ? max : undefined,
+                    currency_code: typeof priceRange.currency_code === "string" ? priceRange.currency_code : undefined,
+                };
+            }
+        }
+        // Parse promotion from query if present (promotion[min_discount_percentage], promotion[promotion_type], etc.)
+        if (context.query?.promotion && typeof context.query.promotion === "object" && !Array.isArray(context.query.promotion)) {
+            const promotion = context.query.promotion;
+            const promotionFilter = {};
+            // Parse min_discount_percentage
+            if (promotion.min_discount_percentage !== undefined) {
+                const minDiscount = typeof promotion.min_discount_percentage === "string"
+                    ? Number(promotion.min_discount_percentage)
+                    : typeof promotion.min_discount_percentage === "number"
+                        ? promotion.min_discount_percentage
+                        : undefined;
+                if (minDiscount !== undefined && !Number.isNaN(minDiscount) && minDiscount >= 0 && minDiscount <= 100) {
+                    promotionFilter.min_discount_percentage = minDiscount;
+                }
+            }
+            // Parse promotion_type
+            if (promotion.promotion_type !== undefined && typeof promotion.promotion_type === "string") {
+                promotionFilter.promotion_type = promotion.promotion_type;
+            }
+            // Parse starts_at
+            if (promotion.starts_at !== undefined) {
+                if (promotion.starts_at instanceof Date) {
+                    promotionFilter.starts_at = promotion.starts_at;
+                }
+                else if (typeof promotion.starts_at === "string") {
+                    const startsAt = new Date(promotion.starts_at);
+                    if (!Number.isNaN(startsAt.getTime())) {
+                        promotionFilter.starts_at = startsAt;
+                    }
+                }
+            }
+            // Parse ends_at
+            if (promotion.ends_at !== undefined) {
+                if (promotion.ends_at instanceof Date) {
+                    promotionFilter.ends_at = promotion.ends_at;
+                }
+                else if (typeof promotion.ends_at === "string") {
+                    const endsAt = new Date(promotion.ends_at);
+                    if (!Number.isNaN(endsAt.getTime())) {
+                        promotionFilter.ends_at = endsAt;
+                    }
+                }
+            }
+            // Parse status
+            if (promotion.status !== undefined && typeof promotion.status === "string") {
+                promotionFilter.status = promotion.status;
+            }
+            // Parse include_open_ended
+            if (promotion.include_open_ended !== undefined) {
+                if (typeof promotion.include_open_ended === "boolean") {
+                    promotionFilter.include_open_ended = promotion.include_open_ended;
+                }
+                else if (typeof promotion.include_open_ended === "string") {
+                    promotionFilter.include_open_ended =
+                        promotion.include_open_ended === "true" || promotion.include_open_ended === "1";
+                }
+            }
+            // Only add promotion filter if at least one field is present
+            if (promotionFilter.min_discount_percentage !== undefined ||
+                promotionFilter.promotion_type !== undefined ||
+                promotionFilter.starts_at !== undefined ||
+                promotionFilter.ends_at !== undefined ||
+                promotionFilter.status !== undefined ||
+                promotionFilter.include_open_ended !== undefined) {
+                customFilterParams.promotion = promotionFilter;
+            }
+        }
+        // Merge Medusa's filterableFields with custom filter params
+        // Custom filters take precedence for overlapping keys
+        const filterParams = {
+            ...context.filterableFields,
+            ...customFilterParams,
+        };
+        // Apply filters using DynamicFilterService
+        // Pass fields from queryConfig if available, otherwise undefined (will default to ["*"])
+        // This ensures all relations (variants, options, images, collection, type) are included
+        const applyOptions = {
+            filterParams,
+            options,
+            pagination: context.queryConfig?.pagination ? {
+                offset: context.queryConfig.pagination.skip,
+                limit: context.queryConfig.pagination.take,
+            } : undefined,
+            projection: context.queryConfig?.fields && context.queryConfig.fields.length > 0 ? {
+                fields: context.queryConfig.fields,
+            } : undefined, // undefined will default to ["*"] in DynamicFilterService
+            context: context.pricingContext ? {
+                pricingContext: context.pricingContext,
+            } : undefined,
+        };
+        return await this.dynamicFilterService.applyFilters(applyOptions);
+    }
+    /**
+     * Apply a ProductFilterPlan using the dynamic filter provider system.
+     *
+     * Converts the legacy filter plan structure into provider-compatible
+     * filter parameters and applies them using DynamicFilterService.
+     *
+     * @param plan - Product filter plan from buildProductFilterPlan()
+     * @param options - Plugin options
+     * @returns Products and count matching the filters
+     */
+    async applyFilterPlan(plan, options) {
+        // Convert filter plan to provider-compatible filter parameters
+        const filterParams = {};
+        // Base filters (id, handle, tags, sales_channel_id)
+        if (Object.keys(plan.baseFilters).length > 0) {
+            filterParams.base_product = plan.baseFilters;
+        }
+        // Category filter
+        if (plan.baseFilters.categories) {
+            const categories = plan.baseFilters.categories;
+            if (categories.id && categories.id.length > 0) {
+                filterParams.category_id = categories.id;
+            }
+        }
+        // Collection filter
+        if (plan.baseFilters.collection_id) {
+            filterParams.collection_id = plan.baseFilters.collection_id;
+        }
+        // Metadata filters
+        if (Object.keys(plan.metadataFilters).length > 0) {
+            filterParams.metadata = plan.metadataFilters;
+        }
+        // Price range filter
+        if (plan.priceRange) {
+            filterParams.price_range = {
+                min: plan.priceRange.min,
+                max: plan.priceRange.max,
+                currency_code: plan.priceRange.currency_code,
+            };
+        }
+        // Promotion window filter
+        if (plan.promotionWindow) {
+            filterParams.promotion_window = {
+                start: plan.promotionWindow.range?.start,
+                end: plan.promotionWindow.range?.end,
+                activeOn: plan.promotionWindow.activeOn,
+                includeOpen: plan.promotionWindow.includeOpen,
+            };
+        }
+        // Availability filter
+        if (plan.availability) {
+            filterParams.availability = {
+                statuses: plan.availability.statuses,
+                include_preorder: plan.availability.include_preorder,
+                include_backorder: plan.availability.include_backorder,
+                include_gift_cards: plan.availability.include_gift_cards,
+                publishable_only: plan.availability.publishable_only,
+            };
+        }
+        // Rating filter
+        if (plan.rating && plan.rating.enabled) {
+            filterParams.rating = {
+                min: plan.rating.min,
+                max: plan.rating.max,
+                require_reviews: plan.rating.require_reviews,
+            };
+        }
+        // Apply filters using DynamicFilterService
+        const applyOptions = {
+            filterParams,
+            options,
+            pagination: plan.pagination,
+            projection: plan.projection,
+        };
+        return await this.dynamicFilterService.applyFilters(applyOptions);
+    }
+}
+exports.ProductFilterService = ProductFilterService;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvZHVjdC1maWx0ZXItc2VydmljZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9zZXJ2aWNlcy9wcm9kdWN0LWZpbHRlci1zZXJ2aWNlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUNBLHFFQUF5RjtBQUN6RixvQ0FBaUQ7QUFJakQ7Ozs7Ozs7Ozs7OztHQVlHO0FBQ0gsTUFBYSxvQkFBb0I7SUFHL0IsWUFBWSxTQUEwQjtRQUNwQywwRUFBMEU7UUFDMUUsSUFBSSxDQUFDO1lBQ0gsSUFBSSxDQUFDLG9CQUFvQixHQUFHLFNBQVMsQ0FBQyxPQUFPLENBQzNDLDhCQUFzQixDQUN2QixDQUFBO1FBQ0gsQ0FBQztRQUFDLE1BQU0sQ0FBQztZQUNQLDhDQUE4QztZQUM5QyxJQUFJLENBQUMsb0JBQW9CLEdBQUcsSUFBSSw2Q0FBb0IsQ0FBQyxTQUFTLENBQUMsQ0FBQTtRQUNqRSxDQUFDO0lBQ0gsQ0FBQztJQUVEOzs7Ozs7Ozs7T0FTRztJQUNILEtBQUssQ0FBQyxnQ0FBZ0MsQ0FDcEMsT0FXQyxFQUNELE9BQTZCO1FBRTdCLHNFQUFzRTtRQUN0RSxNQUFNLGtCQUFrQixHQUE0QixFQUFFLENBQUE7UUFFdEQsMkdBQTJHO1FBQzNHLElBQUksT0FBTyxDQUFDLEtBQUssRUFBRSxXQUFXLElBQUksT0FBTyxPQUFPLENBQUMsS0FBSyxDQUFDLFdBQVcsS0FBSyxRQUFRLElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLE9BQU8sQ0FBQyxLQUFLLENBQUMsV0FBVyxDQUFDLEVBQUUsQ0FBQztZQUM3SCxNQUFNLFVBQVUsR0FBRyxPQUFPLENBQUMsS0FBSyxDQUFDLFdBQXVFLENBQUE7WUFDeEcsTUFBTSxHQUFHLEdBQUcsT0FBTyxVQUFVLENBQUMsR0FBRyxLQUFLLFFBQVEsSUFBSSxPQUFPLFVBQVUsQ0FBQyxHQUFHLEtBQUssUUFBUTtnQkFDbEYsQ0FBQyxDQUFDLENBQUMsT0FBTyxVQUFVLENBQUMsR0FB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

package/.medusa/server/src/utils/query-parser.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * Query Parameter Parser Utility
+ *
+ * Normalizes query parameters from both formats:
+ * - Bracketed flat: `price_range[min]=10&price_range[max]=100`
+ * - Nested objects: `{ price_range: { min: 10, max: 100 } }`
+ *
+ * This ensures consistent handling regardless of how the HTTP server
+ * or query parser processes the query string.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeQueryParams = normalizeQueryParams;
+/**
+ * Parse a query parameter key that may be in bracketed format.
+ *
+ * Examples:
+ * - `price_range[min]` → `{ base: "price_range", key: "min" }`
+ * - `promotion[min_discount_percentage]` → `{ base: "promotion", key: "min_discount_percentage" }`
+ * - `category_id` → `{ base: "category_id", key: null }`
+ *
+ * @param key - Query parameter key (may be bracketed or flat)
+ * @returns Object with base key and nested key (if bracketed)
+ */
+function parseBracketedKey(key) {
+    const bracketMatch = key.match(/^(.+)\[([^\]]+)\]$/);
+    if (bracketMatch) {
+        return {
+            base: bracketMatch[1],
+            key: bracketMatch[2],
+        };
+    }
+    return {
+        base: key,
+        key: null,
+    };
+}
+/**
+ * Normalize query parameters to handle both bracketed and nested formats.
+ *
+ * Converts bracketed flat keys like `price_range[min]=10` into nested objects
+ * like `{ price_range: { min: 10 } }`.
+ *
+ * Also handles already-nested objects, preserving them as-is.
+ *
+ * @param query - Raw query object (may contain bracketed keys or nested objects)
+ * @returns Normalized query object with nested structure
+ *
+ * @example
+ * ```ts
+ * // Input: { "price_range[min]": "10", "price_range[max]": "100" }
+ * // Output: { price_range: { min: "10", max: "100" } }
+ *
+ * // Input: { price_range: { min: 10, max: 100 } }
+ * // Output: { price_range: { min: 10, max: 100 } } (unchanged)
+ * ```
+ */
+function normalizeQueryParams(query) {
+    const normalized = {};
+    const nestedKeys = {};
+    // First pass: collect all bracketed keys
+    for (const [key, value] of Object.entries(query)) {
+        const parsed = parseBracketedKey(key);
+        if (parsed.key !== null) {
+            // This is a bracketed key (e.g., price_range[min])
+            if (!nestedKeys[parsed.base]) {
+                nestedKeys[parsed.base] = {};
+            }
+            nestedKeys[parsed.base][parsed.key] = value;
+        }
+        else {
+            // This is a flat key (e.g., category_id)
+            // Check if it's already a nested object
+            if (value !== null &&
+                typeof value === "object" &&
+                !Array.isArray(value) &&
+                Object.getPrototypeOf(value) === Object.prototype) {
+                // Already nested, keep as-is
+                normalized[parsed.base] = value;
+            }
+            else {
+                // Flat value, add directly
+                normalized[parsed.base] = value;
+            }
+        }
+    }
+    // Second pass: merge nested keys (from bracketed format) with existing nested objects
+    for (const [baseKey, nestedValues] of Object.entries(nestedKeys)) {
+        if (baseKey in normalized && typeof normalized[baseKey] === "object" && normalized[baseKey] !== null && !Array.isArray(normalized[baseKey])) {
+            // Merge with existing nested object
+            normalized[baseKey] = {
+                ...normalized[baseKey],
+                ...nestedValues,
+            };
+        }
+        else {
+            // Create new nested object
+            normalized[baseKey] = nestedValues;
+        }
+    }
+    return normalized;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicXVlcnktcGFyc2VyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3V0aWxzL3F1ZXJ5LXBhcnNlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7Ozs7Ozs7OztHQVNHOztBQStDSCxvREFpREM7QUE5RkQ7Ozs7Ozs7Ozs7R0FVRztBQUNILFNBQVMsaUJBQWlCLENBQUMsR0FBVztJQUNwQyxNQUFNLFlBQVksR0FBRyxHQUFHLENBQUMsS0FBSyxDQUFDLG9CQUFvQixDQUFDLENBQUE7SUFDcEQsSUFBSSxZQUFZLEVBQUUsQ0FBQztRQUNqQixPQUFPO1lBQ0wsSUFBSSxFQUFFLFlBQVksQ0FBQyxDQUFDLENBQUM7WUFDckIsR0FBRyxFQUFFLFlBQVksQ0FBQyxDQUFDLENBQUM7U0FDckIsQ0FBQTtJQUNILENBQUM7SUFDRCxPQUFPO1FBQ0wsSUFBSSxFQUFFLEdBQUc7UUFDVCxHQUFHLEVBQUUsSUFBSTtLQUNWLENBQUE7QUFDSCxDQUFDO0FBRUQ7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FtQkc7QUFDSCxTQUFnQixvQkFBb0IsQ0FDbEMsS0FBOEI7SUFFOUIsTUFBTSxVQUFVLEdBQTRCLEVBQUUsQ0FBQTtJQUM5QyxNQUFNLFVBQVUsR0FBNEMsRUFBRSxDQUFBO0lBRTlELHlDQUF5QztJQUN6QyxLQUFLLE1BQU0sQ0FBQyxHQUFHLEVBQUUsS0FBSyxDQUFDLElBQUksTUFBTSxDQUFDLE9BQU8sQ0FBQyxLQUFLLENBQUMsRUFBRSxDQUFDO1FBQ2pELE1BQU0sTUFBTSxHQUFHLGlCQUFpQixDQUFDLEdBQUcsQ0FBQyxDQUFBO1FBRXJDLElBQUksTUFBTSxDQUFDLEdBQUcsS0FBSyxJQUFJLEVBQUUsQ0FBQztZQUN4QixtREFBbUQ7WUFDbkQsSUFBSSxDQUFDLFVBQVUsQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQztnQkFDN0IsVUFBVSxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMsR0FBRyxFQUFFLENBQUE7WUFDOUIsQ0FBQztZQUNELFVBQVUsQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLENBQUMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxHQUFHLEtBQUssQ0FBQTtRQUM3QyxDQUFDO2FBQU0sQ0FBQztZQUNOLHlDQUF5QztZQUN6Qyx3Q0FBd0M7WUFDeEMsSUFDRSxLQUFLLEtBQUssSUFBSTtnQkFDZCxPQUFPLEtBQUssS0FBSyxRQUFRO2dCQUN6QixDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDO2dCQUNyQixNQUFNLENBQUMsY0FBYyxDQUFDLEtBQUssQ0FBQyxLQUFLLE1BQU0sQ0FBQyxTQUFTLEVBQ2pELENBQUM7Z0JBQ0QsNkJBQTZCO2dCQUM3QixVQUFVLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxHQUFHLEtBQUssQ0FBQTtZQUNqQyxDQUFDO2lCQUFNLENBQUM7Z0JBQ04sMkJBQTJCO2dCQUMzQixVQUFVLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxHQUFHLEtBQUssQ0FBQTtZQUNqQyxDQUFDO1FBQ0gsQ0FBQztJQUNILENBQUM7SUFFRCxzRkFBc0Y7SUFDdEYsS0FBSyxNQUFNLENBQUMsT0FBTyxFQUFFLFlBQVksQ0FBQyxJQUFJLE1BQU0sQ0FBQyxPQUFPLENBQUMsVUFBVSxDQUFDLEVBQUUsQ0FBQztRQUNqRSxJQUFJLE9BQU8sSUFBSSxVQUFVLElBQUksT0FBTyxVQUFVLENBQUMsT0FBTyxDQUFDLEtBQUssUUFBUSxJQUFJLFVBQVUsQ0FBQyxPQUFPLENBQUMsS0FBSyxJQUFJLElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLFVBQVUsQ0FBQyxPQUFPLENBQUMsQ0FBQyxFQUFFLENBQUM7WUFDNUksb0NBQW9DO1lBQ3BDLFVBQVUsQ0FBQyxPQUFPLENBQUMsR0FBRztnQkFDcEIsR0FBSSxVQUFVLENBQUMsT0FBTyxDQUE2QjtnQkFDbkQsR0FBRyxZQUFZO2FBQ2hCLENBQUE7UUFDSCxDQUFDO2FBQU0sQ0FBQztZQUNOLDJCQUEyQjtZQUMzQixVQUFVLENBQUMsT0FBTyxDQUFDLEdBQUcsWUFBWSxDQUFBO1FBQ3BDLENBQUM7SUFDSCxDQUFDO0lBRUQsT0FBTyxVQUFVLENBQUE7QUFDbkIsQ0FBQyJ9