shopoflex-types 1.0.59 → 1.0.60

package/dist/filters.d.ts

@@ -45,12 +45,12 @@ export interface ProductFilters extends BaseFilters {
     minQuantityRange?: [number, number] | string;
 }
 export interface OrderFilters extends BaseFilters {
-    status?: 'pending' | 'confirmed' | 'preparing' | 'ready' | 'delivered' | 'cancelled' | 'completed' | string;
+    status?: string;
     paid?: boolean;
     vendorId?: string;
     customerId?: string;
     branchId?: string;
-    paymentMethod?: 'cash' | 'card' | 'transfer' | 'wallet' | 'cod' | string;
+    paymentMethod?: string;
     orderNumber?: string;
     customerPhone?: string;
     customerDialCode?: string;
@@ -74,7 +74,7 @@ export interface CustomerFilters extends BaseFilters {
     registeredBefore?: Date | string;
 }
 export interface DiscountFilters extends BaseFilters {
-    status?: 'active' | 'paused' | 'expired' | 'exhausted' | string;
+    status?: string;
     type?: 'fixed' | 'percentage' | string;
     vendorId?: string;
     isAutomatic?: boolean;
@@ -88,159 +88,7 @@ export interface DiscountFilters extends BaseFilters {
     expired?: boolean;
     expiringSoon?: boolean;
 }
-/**
- * Parse URL query string back to filter object
- * @param queryString - URL query string
- * @returns Parsed filter object
- */
-export declare const parseQuery: (queryString: string) => Record<string, any>;
-/**
- * Validate and clean filter object
- * Removes undefined/null values and validates types
- */
-export declare const cleanFilters: <T extends Record<string, any>>(filters: T) => Partial<T>;
-/**
- * Merge multiple filter objects
- * Later objects override earlier ones
- */
-export declare const mergeFilters: <T extends Record<string, any>>(...filterObjects: Partial<T>[]) => Partial<T>;
-/**
- * Build query string for any filter object
- * @param filters - Any filter object
- * @returns URL query string
- */
-export declare const buildQuery: (filters: Record<string, any>) => string;
-/**
- * Build query string for product filtering
- * @param filters - Typed product filter object
- * @returns URL query string
- */
 export declare const buildProductQuery: (filters: ProductFilters) => string;
-/**
- * Build query string for order filtering
- * @param filters - Typed order filter object
- * @returns URL query string
- */
 export declare const buildOrderQuery: (filters: OrderFilters) => string;
-/**
- * Build query string for customer filtering
- * @param filters - Typed customer filter object
- * @returns URL query string
- */
 export declare const buildCustomerQuery: (filters: CustomerFilters) => string;
-/**
- * Build query string for discount filtering
- * @param filters - Typed discount filter object
- * @returns URL query string
- */
 export declare const buildDiscountQuery: (filters: DiscountFilters) => string;
-/**
- * Create a complete API URL with typed filters
- * @param baseUrl - Base API URL
- * @param filters - Typed filter object
- * @returns Complete URL with query string
- */
-export declare const buildUrl: (baseUrl: string, filters: Record<string, any>) => string;
-/**
- * Create product API URL
- * @param baseUrl - Base API URL
- * @param filters - Product filters
- * @returns Complete URL
- */
-export declare const buildProductUrl: (baseUrl: string, filters: ProductFilters) => string;
-/**
- * Create order API URL
- * @param baseUrl - Base API URL
- * @param filters - Order filters
- * @returns Complete URL
- */
-export declare const buildOrderUrl: (baseUrl: string, filters: OrderFilters) => string;
-/**
- * Create customer API URL
- * @param baseUrl - Base API URL
- * @param filters - Customer filters
- * @returns Complete URL
- */
-export declare const buildCustomerUrl: (baseUrl: string, filters: CustomerFilters) => string;
-/**
- * Create discount API URL
- * @param baseUrl - Base API URL
- * @param filters - Discount filters
- * @returns Complete URL
- */
-export declare const buildDiscountUrl: (baseUrl: string, filters: DiscountFilters) => string;
-export declare const QueryBuilder: {
-    readonly build: (filters: Record<string, any>) => string;
-    readonly buildProduct: (filters: ProductFilters) => string;
-    readonly buildOrder: (filters: OrderFilters) => string;
-    readonly buildCustomer: (filters: CustomerFilters) => string;
-    readonly buildDiscount: (filters: DiscountFilters) => string;
-    readonly parse: (queryString: string) => Record<string, any>;
-};
-export declare const UrlBuilder: {
-    readonly build: (baseUrl: string, filters: Record<string, any>) => string;
-    readonly buildProduct: (baseUrl: string, filters: ProductFilters) => string;
-    readonly buildOrder: (baseUrl: string, filters: OrderFilters) => string;
-    readonly buildCustomer: (baseUrl: string, filters: CustomerFilters) => string;
-    readonly buildDiscount: (baseUrl: string, filters: DiscountFilters) => string;
-};
-export declare const FilterUtils: {
-    readonly clean: <T extends Record<string, any>>(filters: T) => Partial<T>;
-    readonly merge: <T extends Record<string, any>>(...filterObjects: Partial<T>[]) => Partial<T>;
-};
-export declare const FilterAPI: {
-    readonly QueryBuilder: {
-        readonly build: (filters: Record<string, any>) => string;
-        readonly buildProduct: (filters: ProductFilters) => string;
-        readonly buildOrder: (filters: OrderFilters) => string;
-        readonly buildCustomer: (filters: CustomerFilters) => string;
-        readonly buildDiscount: (filters: DiscountFilters) => string;
-        readonly parse: (queryString: string) => Record<string, any>;
-    };
-    readonly UrlBuilder: {
-        readonly build: (baseUrl: string, filters: Record<string, any>) => string;
-        readonly buildProduct: (baseUrl: string, filters: ProductFilters) => string;
-        readonly buildOrder: (baseUrl: string, filters: OrderFilters) => string;
-        readonly buildCustomer: (baseUrl: string, filters: CustomerFilters) => string;
-        readonly buildDiscount: (baseUrl: string, filters: DiscountFilters) => string;
-    };
-    readonly FilterUtils: {
-        readonly clean: <T extends Record<string, any>>(filters: T) => Partial<T>;
-        readonly merge: <T extends Record<string, any>>(...filterObjects: Partial<T>[]) => Partial<T>;
-    };
-};
-declare const _default: {
-    buildQuery: (filters: Record<string, any>) => string;
-    buildProductQuery: (filters: ProductFilters) => string;
-    buildOrderQuery: (filters: OrderFilters) => string;
-    buildCustomerQuery: (filters: CustomerFilters) => string;
-    buildDiscountQuery: (filters: DiscountFilters) => string;
-    buildUrl: (baseUrl: string, filters: Record<string, any>) => string;
-    buildProductUrl: (baseUrl: string, filters: ProductFilters) => string;
-    buildOrderUrl: (baseUrl: string, filters: OrderFilters) => string;
-    buildCustomerUrl: (baseUrl: string, filters: CustomerFilters) => string;
-    buildDiscountUrl: (baseUrl: string, filters: DiscountFilters) => string;
-    parseQuery: (queryString: string) => Record<string, any>;
-    cleanFilters: <T extends Record<string, any>>(filters: T) => Partial<T>;
-    mergeFilters: <T extends Record<string, any>>(...filterObjects: Partial<T>[]) => Partial<T>;
-    QueryBuilder: {
-        readonly build: (filters: Record<string, any>) => string;
-        readonly buildProduct: (filters: ProductFilters) => string;
-        readonly buildOrder: (filters: OrderFilters) => string;
-        readonly buildCustomer: (filters: CustomerFilters) => string;
-        readonly buildDiscount: (filters: DiscountFilters) => string;
-        readonly parse: (queryString: string) => Record<string, any>;
-    };
-    UrlBuilder: {
-        readonly build: (baseUrl: string, filters: Record<string, any>) => string;
-        readonly buildProduct: (baseUrl: string, filters: ProductFilters) => string;
-        readonly buildOrder: (baseUrl: string, filters: OrderFilters) => string;
-        readonly buildCustomer: (baseUrl: string, filters: CustomerFilters) => string;
-        readonly buildDiscount: (baseUrl: string, filters: DiscountFilters) => string;
-    };
-    FilterUtils: {
-        readonly clean: <T extends Record<string, any>>(filters: T) => Partial<T>;
-        readonly merge: <T extends Record<string, any>>(...filterObjects: Partial<T>[]) => Partial<T>;
-    };
-};
-export default _default;

package/dist/filters.js

@@ -1,17 +1,18 @@
 "use strict";
 // =====================================================
-// TYPE DEFINITIONS
+// FILTER INTERFACES - Clean & Minimal
 // =====================================================
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FilterAPI = exports.FilterUtils = exports.UrlBuilder = exports.QueryBuilder = exports.buildDiscountUrl = exports.buildCustomerUrl = exports.buildOrderUrl = exports.buildProductUrl = exports.buildUrl = exports.buildDiscountQuery = exports.buildCustomerQuery = exports.buildOrderQuery = exports.buildProductQuery = exports.buildQuery = exports.mergeFilters = exports.cleanFilters = exports.parseQuery = void 0;
+exports.buildDiscountQuery = exports.buildCustomerQuery = exports.buildOrderQuery = exports.buildProductQuery = void 0;
 // =====================================================
-// CORE UTILITIES
+// SINGLE QUERY BUILDER FUNCTION
 // =====================================================
 /**
- * Converts filter object to URL query string
- * Handles arrays, dates, and nested values automatically
+ * Convert any filter object to URL query parameters string
+ * @param filters - Any filter object
+ * @returns Query parameters string (without ?)
  */
-const buildQueryString = (filters) => {
+const buildQuery = (filters) => {
     const parts = [];
     Object.entries(filters).forEach(([key, value]) => {
         if (value === undefined || value === null || value === '')
@@ -34,285 +35,43 @@ const buildQueryString = (filters) => {
         }
         // Handle primitives
         else {
-            parts.push(`${key}=${value}`);
+            parts.push(`${key}=${encodeURIComponent(value)}`);
         }
     });
     return parts.join('&');
 };
-/**
- * Parse URL query string back to filter object
- * @param queryString - URL query string
- * @returns Parsed filter object
- */
-const parseQuery = (queryString) => {
-    const result = {};
-    if (!queryString)
-        return result;
-    // Remove leading ? if present
-    const cleanQuery = queryString.startsWith('?') ? queryString.slice(1) : queryString;
-    // Split by & to get key=value pairs
-    const pairs = cleanQuery.split('&');
-    pairs.forEach(pair => {
-        const [key, value] = pair.split('=');
-        if (!key || value === undefined)
-            return;
-        // Handle comma-separated values
-        if (value.includes(',')) {
-            const parts = value.split(',');
-            // Check if it's a range (2 items) or array (multiple items)
-            if (parts.length === 2 && (key.includes('Range') || key.includes('range'))) {
-                // Try to parse as numbers for ranges
-                const [first, second] = parts;
-                const firstNum = parseFloat(first);
-                const secondNum = parseFloat(second);
-                if (!isNaN(firstNum) && !isNaN(secondNum)) {
-                    result[key] = [firstNum, secondNum];
-                }
-                else {
-                    // Date range or string range
-                    result[key] = parts;
-                }
-            }
-            else {
-                // Regular array
-                result[key] = parts;
-            }
-        }
-        // Handle boolean strings
-        else if (value === 'true' || value === 'false') {
-            result[key] = value === 'true';
-        }
-        // Handle numbers
-        else if (!isNaN(Number(value)) && value !== '') {
-            result[key] = Number(value);
-        }
-        // Handle strings
-        else {
-            result[key] = value;
-        }
-    });
-    return result;
-};
-exports.parseQuery = parseQuery;
-/**
- * Validate and clean filter object
- * Removes undefined/null values and validates types
- */
-const cleanFilters = (filters) => {
-    const cleaned = {};
-    Object.entries(filters).forEach(([key, value]) => {
-        if (value !== undefined && value !== null && value !== '') {
-            // Handle arrays - remove empty values
-            if (Array.isArray(value)) {
-                const cleanedArray = value.filter(v => v !== undefined && v !== null && v !== '');
-                if (cleanedArray.length > 0) {
-                    cleaned[key] = cleanedArray;
-                }
-            }
-            else {
-                cleaned[key] = value;
-            }
-        }
-    });
-    return cleaned;
-};
-exports.cleanFilters = cleanFilters;
-/**
- * Merge multiple filter objects
- * Later objects override earlier ones
- */
-const mergeFilters = (...filterObjects) => {
-    return Object.assign({}, ...filterObjects.map(exports.cleanFilters));
-};
-exports.mergeFilters = mergeFilters;
 // =====================================================
-// QUERY BUILDERS - Main Functions
+// TYPE-SAFE ALIASES (Optional - for convenience)
 // =====================================================
-/**
- * Build query string for any filter object
- * @param filters - Any filter object
- * @returns URL query string
- */
-const buildQuery = (filters) => {
-    return buildQueryString(filters);
-};
-exports.buildQuery = buildQuery;
-/**
- * Build query string for product filtering
- * @param filters - Typed product filter object
- * @returns URL query string
- */
-const buildProductQuery = (filters) => {
-    return buildQueryString(filters);
-};
+const buildProductQuery = (filters) => buildQuery(filters);
 exports.buildProductQuery = buildProductQuery;
-/**
- * Build query string for order filtering
- * @param filters - Typed order filter object
- * @returns URL query string
- */
-const buildOrderQuery = (filters) => {
-    return buildQueryString(filters);
-};
+const buildOrderQuery = (filters) => buildQuery(filters);
 exports.buildOrderQuery = buildOrderQuery;
-/**
- * Build query string for customer filtering
- * @param filters - Typed customer filter object
- * @returns URL query string
- */
-const buildCustomerQuery = (filters) => {
-    return buildQueryString(filters);
-};
+const buildCustomerQuery = (filters) => buildQuery(filters);
 exports.buildCustomerQuery = buildCustomerQuery;
-/**
- * Build query string for discount filtering
- * @param filters - Typed discount filter object
- * @returns URL query string
- */
-const buildDiscountQuery = (filters) => {
-    return buildQueryString(filters);
-};
+const buildDiscountQuery = (filters) => buildQuery(filters);
 exports.buildDiscountQuery = buildDiscountQuery;
 // =====================================================
-// URL BUILDERS - Convenience Functions
+// USAGE EXAMPLES
 // =====================================================
-/**
- * Create a complete API URL with typed filters
- * @param baseUrl - Base API URL
- * @param filters - Typed filter object
- * @returns Complete URL with query string
- */
-const buildUrl = (baseUrl, filters) => {
-    const queryString = (0, exports.buildQuery)(filters);
-    return queryString ? `${baseUrl}?${queryString}` : baseUrl;
-};
-exports.buildUrl = buildUrl;
-/**
- * Create product API URL
- * @param baseUrl - Base API URL
- * @param filters - Product filters
- * @returns Complete URL
- */
-const buildProductUrl = (baseUrl, filters) => {
-    return (0, exports.buildUrl)(baseUrl, filters);
-};
-exports.buildProductUrl = buildProductUrl;
-/**
- * Create order API URL
- * @param baseUrl - Base API URL
- * @param filters - Order filters
- * @returns Complete URL
- */
-const buildOrderUrl = (baseUrl, filters) => {
-    return (0, exports.buildUrl)(baseUrl, filters);
-};
-exports.buildOrderUrl = buildOrderUrl;
-/**
- * Create customer API URL
- * @param baseUrl - Base API URL
- * @param filters - Customer filters
- * @returns Complete URL
- */
-const buildCustomerUrl = (baseUrl, filters) => {
-    return (0, exports.buildUrl)(baseUrl, filters);
-};
-exports.buildCustomerUrl = buildCustomerUrl;
-/**
- * Create discount API URL
- * @param baseUrl - Base API URL
- * @param filters - Discount filters
- * @returns Complete URL
- */
-const buildDiscountUrl = (baseUrl, filters) => {
-    return (0, exports.buildUrl)(baseUrl, filters);
-};
-exports.buildDiscountUrl = buildDiscountUrl;
-// =====================================================
-// GROUPED EXPORTS - For Better DX
-// =====================================================
-// Main query builders (most commonly used)
-exports.QueryBuilder = {
-    build: exports.buildQuery,
-    buildProduct: exports.buildProductQuery,
-    buildOrder: exports.buildOrderQuery,
-    buildCustomer: exports.buildCustomerQuery,
-    buildDiscount: exports.buildDiscountQuery,
-    parse: exports.parseQuery
-};
-// URL builders
-exports.UrlBuilder = {
-    build: exports.buildUrl,
-    buildProduct: exports.buildProductUrl,
-    buildOrder: exports.buildOrderUrl,
-    buildCustomer: exports.buildCustomerUrl,
-    buildDiscount: exports.buildDiscountUrl
-};
-// Filter utilities
-exports.FilterUtils = {
-    clean: exports.cleanFilters,
-    merge: exports.mergeFilters
-};
-// All-in-one object for comprehensive access
-exports.FilterAPI = {
-    QueryBuilder: exports.QueryBuilder,
-    UrlBuilder: exports.UrlBuilder,
-    FilterUtils: exports.FilterUtils
-};
-// =====================================================
-// DEFAULT EXPORT - Most Common Use Case
-// =====================================================
-exports.default = {
-    // Types (re-exported for convenience)
-    buildQuery: exports.buildQuery,
-    buildProductQuery: exports.buildProductQuery,
-    buildOrderQuery: exports.buildOrderQuery,
-    buildCustomerQuery: exports.buildCustomerQuery,
-    buildDiscountQuery: exports.buildDiscountQuery,
-    buildUrl: exports.buildUrl,
-    buildProductUrl: exports.buildProductUrl,
-    buildOrderUrl: exports.buildOrderUrl,
-    buildCustomerUrl: exports.buildCustomerUrl,
-    buildDiscountUrl: exports.buildDiscountUrl,
-    parseQuery: exports.parseQuery,
-    cleanFilters: exports.cleanFilters,
-    mergeFilters: exports.mergeFilters,
-    // Grouped objects
-    QueryBuilder: exports.QueryBuilder,
-    UrlBuilder: exports.UrlBuilder,
-    FilterUtils: exports.FilterUtils
-};
 /*
-==============================================
-USAGE EXAMPLES - Multiple Import Patterns
-==============================================
-
-// 1. Import specific functions (tree-shakable)
-import { buildProductQuery, ProductFilters } from 'your-package';
-
-// 2. Import grouped objects
-import { QueryBuilder, UrlBuilder } from 'your-package';
-
-// 3. Import default (all-in-one)
-import FilterAPI from 'your-package';
-
-// 4. Import everything
-import * as Filters from 'your-package';
-
-// Usage examples:
-
-// Method 1: Direct imports
-const filters: ProductFilters = { minStock: 10, isActive: true };
-const query = buildProductQuery(filters);
+// Simple usage:
+const filters: ProductFilters = {
+  minStock: 10,
+  variantColor: 'red',
+  priceRange: [50, 200],
+  isActive: true,
+  page: 1,
+  limit: 50
+};
 
-// Method 2: Grouped objects
-const query2 = QueryBuilder.buildProduct(filters);
-const url = UrlBuilder.buildProduct('/api/products', filters);
+const queryString = buildQuery(filters);
+// Result: "minStock=10&variantColor=red&priceRange=50,200&isActive=true&page=1&limit=50"
 
-// Method 3: Default import
-const query3 = FilterAPI.QueryBuilder.buildProduct(filters);
-const url2 = FilterAPI.UrlBuilder.buildProduct('/api/products', filters);
+// Use with API:
+const url = `/api/products?${buildQuery(filters)}`;
+fetch(url).then(res => res.json());
 
-// Method 4: Namespace import
-const query4 = Filters.buildProductQuery(filters);
-const url3 = Filters.buildProductUrl('/api/products', filters);
+// Or with type-safe alias:
+const queryString = buildProductQuery(filters);
 */ 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shopoflex-types",
-  "version": "1.0.59",
+  "version": "1.0.60",
   "description": "Shared TypeScript types for Shopoflex applications",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",