ag-grid-url-sync 0.1.1 → 0.2.2

package/dist/core/url-parser.js

@@ -0,0 +1,164 @@
+import { InvalidFilterError, InvalidURLError, OPERATION_MAP } from './types.js';
+import { validateFilterValue, validateAndParseNumber, validateNumberRange, validateNumberFilter, DEFAULT_CONFIG } from './validation.js';
+/**
+ * Detects if an operation is number-specific
+ */
+function isNumberOperation(operation) {
+    return [
+        'lessThan',
+        'lessThanOrEqual',
+        'greaterThan',
+        'greaterThanOrEqual',
+        'inRange'
+    ].includes(operation);
+}
+/**
+ * Detects if an operation works with both text and number filters
+ */
+function isSharedOperation(operation) {
+    return ['eq', 'notEqual', 'blank', 'notBlank'].includes(operation);
+}
+/**
+ * Extracts column name and operation from a filter parameter
+ */
+function extractColumnAndOperation(param, expectedPrefix) {
+    const ensureTrailingUnderscore = (prefix) => prefix.endsWith('_') ? prefix : prefix + '_';
+    const sanitizedPrefix = expectedPrefix
+        ? ensureTrailingUnderscore(expectedPrefix)
+        : ensureTrailingUnderscore(DEFAULT_CONFIG.paramPrefix);
+    const prefixToCheck = sanitizedPrefix.slice(0, -1);
+    if (!param.startsWith(prefixToCheck + '_')) {
+        throw new InvalidFilterError(`Invalid filter prefix in parameter: ${param}`);
+    }
+    // Remove prefix and find the last underscore to separate column from operation
+    const withoutPrefix = param.substring(prefixToCheck.length + 1);
+    const lastUnderscoreIndex = withoutPrefix.lastIndexOf('_');
+    if (lastUnderscoreIndex === -1) {
+        throw new InvalidFilterError(`Invalid filter parameter format: ${param}`);
+    }
+    const column = withoutPrefix.substring(0, lastUnderscoreIndex);
+    const operation = withoutPrefix.substring(lastUnderscoreIndex + 1);
+    if (!column.trim()) {
+        throw new InvalidFilterError(`Empty column name in parameter: ${param}`);
+    }
+    return { column, operation };
+}
+/**
+ * Parses a URL parameter into a column filter
+ */
+export function parseFilterParam(param, value, expectedPrefix) {
+    const { operation } = extractColumnAndOperation(param, expectedPrefix);
+    const filterOp = OPERATION_MAP[operation];
+    if (!filterOp) {
+        throw new InvalidFilterError(`Unsupported filter operation: ${operation}`);
+    }
+    // Handle range operations
+    if (filterOp === 'inRange') {
+        const rangeParts = value.split(',');
+        if (rangeParts.length !== 2) {
+            throw new InvalidFilterError('Range operation requires exactly two values separated by comma');
+        }
+        const min = validateAndParseNumber(rangeParts[0] || '');
+        const max = validateAndParseNumber(rangeParts[1] || '');
+        const rangeValidation = validateNumberRange(min, max);
+        if (!rangeValidation.valid) {
+            throw new InvalidFilterError(rangeValidation.error || 'Invalid range values');
+        }
+        return {
+            filterType: 'number',
+            type: filterOp,
+            filter: min,
+            filterTo: max
+        };
+    }
+    // Handle number operations
+    if (isNumberOperation(filterOp)) {
+        const numValue = validateAndParseNumber(value);
+        return {
+            filterType: 'number',
+            type: filterOp,
+            filter: numValue
+        };
+    }
+    // Handle blank operations first (work for both text and number but default to text)
+    if (filterOp === 'blank' || filterOp === 'notBlank') {
+        return {
+            filterType: 'text',
+            type: filterOp,
+            filter: '' // Blank operations don't use the value
+        };
+    }
+    // Handle shared operations (eq, notEqual) - detect if they should be number based on value
+    if (isSharedOperation(filterOp)) {
+        // Try to parse as number first
+        try {
+            const numValue = parseFloat(value);
+            if (!isNaN(numValue) && Number.isFinite(numValue)) {
+                const validation = validateNumberFilter(numValue);
+                if (validation.valid) {
+                    return {
+                        filterType: 'number',
+                        type: filterOp,
+                        filter: numValue
+                    };
+                }
+            }
+        }
+        catch {
+            // Fall through to text handling
+        }
+        return {
+            filterType: 'text',
+            type: filterOp,
+            filter: value || ''
+        };
+    }
+    // Handle text operations (existing logic)
+    return {
+        filterType: 'text',
+        type: filterOp,
+        filter: value || ''
+    };
+}
+/**
+ * Converts URL search params into a filter state object
+ */
+export function parseUrlFilters(url, config) {
+    try {
+        const urlObj = new URL(url);
+        const filterState = {};
+        for (const [param, value] of urlObj.searchParams.entries()) {
+            if (!param.startsWith(config.paramPrefix))
+                continue;
+            try {
+                // Extract column name and parse the filter parameter
+                const { column: columnName } = extractColumnAndOperation(param, config.paramPrefix);
+                const filterParam = parseFilterParam(param, value, config.paramPrefix);
+                // Apply validation based on filter type
+                if (filterParam.filterType === 'text') {
+                    const validatedValue = validateFilterValue(value, config, filterParam.type);
+                    filterState[columnName] = {
+                        ...filterParam,
+                        filter: validatedValue
+                    };
+                }
+                else {
+                    // Number filters are already validated in parseFilterParam
+                    filterState[columnName] = filterParam;
+                }
+            }
+            catch (err) {
+                if (config.onParseError) {
+                    config.onParseError(err);
+                }
+                // Skip invalid filters but continue processing
+                continue;
+            }
+        }
+        return filterState;
+    }
+    catch (err) {
+        throw new InvalidURLError(`Failed to parse URL: ${err.message}`);
+    }
+}
+//# sourceMappingURL=url-parser.js.map

package/dist/core/url-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-parser.js","sourceRoot":"","sources":["../../src/core/url-parser.ts"],"names":[],"mappings":"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"}

package/dist/core/validation.d.ts

@@ -0,0 +1,47 @@
+import type { InternalConfig, FilterOperation } from './types.js';
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_CONFIG: {
+    readonly paramPrefix: "f_";
+    readonly maxValueLength: 200;
+};
+/**
+ * Validation result interface
+ */
+export interface ValidationResult {
+    valid: boolean;
+    error?: string;
+}
+/**
+ * Validates a text filter value against configuration constraints
+ *
+ * @param value - The filter value to validate
+ * @param config - Internal configuration with validation rules
+ * @param operation - Optional filter operation type. Blank operations (blank/notBlank) bypass value validation
+ * @returns The validated filter value (empty string for blank operations)
+ * @throws InvalidFilterError if value exceeds maximum length
+ */
+export declare function validateFilterValue(value: string, config: InternalConfig, operation?: FilterOperation): string;
+/**
+ * Validates a number filter value
+ *
+ * @param value - The number value to validate
+ * @returns Validation result
+ */
+export declare function validateNumberFilter(value: number): ValidationResult;
+/**
+ * Validates a number range filter
+ *
+ * @param min - The minimum value
+ * @param max - The maximum value
+ * @returns Validation result
+ */
+export declare function validateNumberRange(min: number, max: number): ValidationResult;
+/**
+ * Validates a parsed number from string input
+ *
+ * @param value - String representation of number
+ * @returns Parsed number or throws InvalidFilterError
+ */
+export declare function validateAndParseNumber(value: string): number;

package/dist/core/validation.js

@@ -0,0 +1,87 @@
+import { InvalidFilterError } from './types.js';
+/**
+ * Default configuration values
+ */
+export const DEFAULT_CONFIG = {
+    paramPrefix: 'f_',
+    maxValueLength: 200
+};
+/**
+ * Validates a text filter value against configuration constraints
+ *
+ * @param value - The filter value to validate
+ * @param config - Internal configuration with validation rules
+ * @param operation - Optional filter operation type. Blank operations (blank/notBlank) bypass value validation
+ * @returns The validated filter value (empty string for blank operations)
+ * @throws InvalidFilterError if value exceeds maximum length
+ */
+export function validateFilterValue(value, config, operation) {
+    // Blank operations don't require value validation
+    if (operation === 'blank' || operation === 'notBlank') {
+        return '';
+    }
+    if (value.length > config.maxValueLength) {
+        throw new InvalidFilterError(`Filter value exceeds maximum length of ${config.maxValueLength} characters`);
+    }
+    return value;
+}
+/**
+ * Validates a number filter value
+ *
+ * @param value - The number value to validate
+ * @returns Validation result
+ */
+export function validateNumberFilter(value) {
+    // Basic number validation
+    if (!Number.isFinite(value)) {
+        return { valid: false, error: 'Filter value must be a finite number' };
+    }
+    // Range validation for precision
+    if (Math.abs(value) > Number.MAX_SAFE_INTEGER) {
+        return { valid: false, error: 'Number value exceeds safe integer range' };
+    }
+    return { valid: true };
+}
+/**
+ * Validates a number range filter
+ *
+ * @param min - The minimum value
+ * @param max - The maximum value
+ * @returns Validation result
+ */
+export function validateNumberRange(min, max) {
+    const minResult = validateNumberFilter(min);
+    if (!minResult.valid)
+        return minResult;
+    const maxResult = validateNumberFilter(max);
+    if (!maxResult.valid)
+        return maxResult;
+    if (min > max) {
+        return {
+            valid: false,
+            error: 'Range minimum must be less than or equal to maximum'
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Validates a parsed number from string input
+ *
+ * @param value - String representation of number
+ * @returns Parsed number or throws InvalidFilterError
+ */
+export function validateAndParseNumber(value) {
+    if (!value || value.trim() === '') {
+        throw new InvalidFilterError('Number filter value cannot be empty');
+    }
+    const numValue = parseFloat(value);
+    if (isNaN(numValue)) {
+        throw new InvalidFilterError(`Invalid number format: ${value}`);
+    }
+    const validation = validateNumberFilter(numValue);
+    if (!validation.valid) {
+        throw new InvalidFilterError(validation.error || 'Invalid number value');
+    }
+    return numValue;
+}
+//# sourceMappingURL=validation.js.map

package/dist/core/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/core/validation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,WAAW,EAAE,IAAI;IACjB,cAAc,EAAE,GAAG;CACX,CAAA;AAUV;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAa,EACb,MAAsB,EACtB,SAA2B;IAE3B,kDAAkD;IAClD,IAAI,SAAS,KAAK,OAAO,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QACtD,OAAO,EAAE,CAAA;IACX,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;QACzC,MAAM,IAAI,kBAAkB,CAC1B,0CAA0C,MAAM,CAAC,cAAc,aAAa,CAC7E,CAAA;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,0BAA0B;IAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAA;IACxE,CAAC;IAED,iCAAiC;IACjC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC9C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAA;IAC3E,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;AACxB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAW,EACX,GAAW;IAEX,MAAM,SAAS,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAA;IAC3C,IAAI,CAAC,SAAS,CAAC,KAAK;QAAE,OAAO,SAAS,CAAA;IAEtC,MAAM,SAAS,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAA;IAC3C,IAAI,CAAC,SAAS,CAAC,KAAK;QAAE,OAAO,SAAS,CAAA;IAEtC,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;QACd,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,qDAAqD;SAC7D,CAAA;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;AACxB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAClC,MAAM,IAAI,kBAAkB,CAAC,qCAAqC,CAAC,CAAA;IACrE,CAAC;IAED,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;IAClC,IAAI,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,kBAAkB,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAA;IACjE,CAAC;IAED,MAAM,UAAU,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAA;IACjD,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,IAAI,kBAAkB,CAAC,UAAU,CAAC,KAAK,IAAI,sBAAsB,CAAC,CAAA;IAC1E,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,6 @@
-export { AGGridUrlSync, createUrlSync } from './ag-grid-url-sync.js';
-export * from './types.js';
-export { parseUrlFilters, serializeFilters, generateUrl, getFilterModel, applyFilterModel, validateFilterValue, parseFilterParam, DEFAULT_CONFIG } from './utils.js';
+export { AGGridUrlSync, createUrlSync } from './core/ag-grid-url-sync.js';
+export * from './core/types.js';
+export { validateFilterValue, DEFAULT_CONFIG } from './core/validation.js';
+export { parseUrlFilters, parseFilterParam } from './core/url-parser.js';
+export { serializeFilters, generateUrl } from './core/url-generator.js';
+export { getFilterModel, applyFilterModel } from './core/grid-integration.js';

package/dist/index.js

@@ -1,4 +1,12 @@
-export { AGGridUrlSync, createUrlSync } from './ag-grid-url-sync.js';
-export * from './types.js';
-export { parseUrlFilters, serializeFilters, generateUrl, getFilterModel, applyFilterModel, validateFilterValue, parseFilterParam, DEFAULT_CONFIG } from './utils.js';
+// Export core functionality (vanilla JS)
+export { AGGridUrlSync, createUrlSync } from './core/ag-grid-url-sync.js';
+export * from './core/types.js';
+// Validation utilities
+export { validateFilterValue, DEFAULT_CONFIG } from './core/validation.js';
+// URL parsing utilities
+export { parseUrlFilters, parseFilterParam } from './core/url-parser.js';
+// URL generation utilities
+export { serializeFilters, generateUrl } from './core/url-generator.js';
+// AG Grid integration utilities
+export { getFilterModel, applyFilterModel } from './core/grid-integration.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAEpE,cAAc,YAAY,CAAA;AAE1B,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACf,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAEzE,cAAc,iBAAiB,CAAA;AAE/B,uBAAuB;AACvB,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1E,wBAAwB;AACxB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAExE,2BAA2B;AAC3B,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAEvE,gCAAgC;AAChC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA"}

package/dist/react/index.d.ts

@@ -0,0 +1,3 @@
+export { useAGGridUrlSync } from './use-ag-grid-url-sync.js';
+export type { UseAGGridUrlSyncOptions, UseAGGridUrlSyncReturn } from './types.js';
+export type { FilterState, ColumnFilter, FilterOperation, AGGridUrlSyncConfig, GridApi } from '../core/types.js';

package/dist/react/index.js

@@ -0,0 +1,2 @@
+export { useAGGridUrlSync } from './use-ag-grid-url-sync.js';
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/react/types.d.ts

@@ -0,0 +1,64 @@
+import type { AGGridUrlSyncConfig, FilterState } from '../core/types.js';
+/**
+ * Configuration options for the React hook
+ */
+export interface UseAGGridUrlSyncOptions extends AGGridUrlSyncConfig {
+    /**
+     * Automatically apply URL filters when the component mounts and grid API becomes ready
+     * Default: false
+     */
+    autoApplyOnMount?: boolean;
+    /**
+     * Whether the hook should be enabled when the grid API is ready
+     * Default: true
+     */
+    enabledWhenReady?: boolean;
+}
+/**
+ * Return type for the useAGGridUrlSync hook
+ */
+export interface UseAGGridUrlSyncReturn {
+    /**
+     * Generate a URL with current filter state
+     * @param baseUrl - Optional base URL (defaults to current URL)
+     * @returns URL string with filter parameters
+     */
+    shareUrl: (baseUrl?: string) => string;
+    /**
+     * Get current filter state as query parameters string
+     * @returns Query parameter string
+     */
+    getQueryParams: () => string;
+    /**
+     * Apply filters from a URL to the grid
+     * @param url - Optional URL to parse (defaults to current URL)
+     */
+    applyUrlFilters: (url?: string) => void;
+    /**
+     * Clear all text filters from the grid
+     */
+    clearFilters: () => void;
+    /**
+     * Whether the grid API is available and hook is ready
+     */
+    isReady: boolean;
+    /**
+     * Current generated URL with filters
+     */
+    currentUrl: string;
+    /**
+     * Whether the grid has any active text filters
+     */
+    hasFilters: boolean;
+    /**
+     * Parse filters from a URL without applying them
+     * @param url - URL to parse
+     * @returns Parsed filter state
+     */
+    parseUrlFilters: (url: string) => FilterState;
+    /**
+     * Apply a filter state object to the grid
+     * @param filters - Filter state to apply
+     */
+    applyFilters: (filters: FilterState) => void;
+}

package/dist/react/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/react/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/react/types.ts"],"names":[],"mappings":""}

package/dist/react/use-ag-grid-url-sync.d.ts

@@ -0,0 +1,10 @@
+import type { GridApi } from 'ag-grid-community';
+import type { UseAGGridUrlSyncOptions, UseAGGridUrlSyncReturn } from './types.js';
+/**
+ * React hook for AG Grid URL synchronization
+ *
+ * @param gridApi - AG Grid API instance (can be null during initialization)
+ * @param options - Configuration options for the hook
+ * @returns Hook API for URL synchronization
+ */
+export declare function useAGGridUrlSync(gridApi: GridApi | null, options?: UseAGGridUrlSyncOptions): UseAGGridUrlSyncReturn;

package/dist/react/use-ag-grid-url-sync.js

@@ -0,0 +1,215 @@
+import { useState, useEffect, useRef, useCallback, useMemo } from 'react';
+import { AGGridUrlSync } from '../core/ag-grid-url-sync.js';
+import { parseUrlFilters as parseFilters } from '../core/url-parser.js';
+import { DEFAULT_CONFIG } from '../core/validation.js';
+/**
+ * React hook for AG Grid URL synchronization
+ *
+ * @param gridApi - AG Grid API instance (can be null during initialization)
+ * @param options - Configuration options for the hook
+ * @returns Hook API for URL synchronization
+ */
+export function useAGGridUrlSync(gridApi, options = {}) {
+    const { autoApplyOnMount = false, enabledWhenReady = true, ...coreOptions } = options;
+    // Internal state
+    const [isReady, setIsReady] = useState(false);
+    const [currentUrl, setCurrentUrl] = useState('');
+    const [hasFilters, setHasFilters] = useState(false);
+    // Refs to track state and prevent memory leaks
+    const urlSyncRef = useRef(null);
+    const autoAppliedRef = useRef(false);
+    const lastGridApiRef = useRef(null);
+    // Initialize or update URL sync instance when grid API changes
+    useEffect(() => {
+        if (gridApi && enabledWhenReady) {
+            // Clean up previous instance if grid API changed
+            if (lastGridApiRef.current && lastGridApiRef.current !== gridApi) {
+                urlSyncRef.current?.destroy();
+                urlSyncRef.current = null;
+                autoAppliedRef.current = false;
+            }
+            // Create new instance if needed
+            if (!urlSyncRef.current) {
+                try {
+                    urlSyncRef.current = new AGGridUrlSync(gridApi, coreOptions);
+                    setIsReady(true);
+                    lastGridApiRef.current = gridApi;
+                }
+                catch (error) {
+                    console.error('Failed to initialize AG Grid URL Sync:', error);
+                    setIsReady(false);
+                }
+            }
+        }
+        else {
+            // Clean up when grid API is null or disabled
+            if (urlSyncRef.current) {
+                urlSyncRef.current.destroy();
+                urlSyncRef.current = null;
+                autoAppliedRef.current = false;
+            }
+            setIsReady(false);
+            lastGridApiRef.current = null;
+        }
+    }, [gridApi, enabledWhenReady, coreOptions]);
+    // Auto-apply URL filters on mount if enabled
+    useEffect(() => {
+        if (isReady &&
+            autoApplyOnMount &&
+            !autoAppliedRef.current &&
+            urlSyncRef.current) {
+            try {
+                urlSyncRef.current.applyFromUrl();
+                autoAppliedRef.current = true;
+            }
+            catch (error) {
+                console.error('Failed to auto-apply URL filters:', error);
+                coreOptions.onParseError?.(error);
+            }
+        }
+    }, [isReady, autoApplyOnMount, coreOptions]);
+    // Update current URL and filter state on filter changes
+    useEffect(() => {
+        if (!isReady || !urlSyncRef.current || !gridApi) {
+            setCurrentUrl('');
+            setHasFilters(false);
+            return;
+        }
+        const updateState = () => {
+            try {
+                const newUrl = urlSyncRef.current.generateUrl();
+                setCurrentUrl(newUrl);
+                // Check if there are active filters by comparing query params
+                const queryParams = urlSyncRef.current.getQueryParams();
+                const searchParams = new URLSearchParams(queryParams);
+                setHasFilters([...searchParams.entries()].length > 0); // Check if there are any query parameters
+            }
+            catch (error) {
+                console.error('Failed to update URL state:', error);
+            }
+        };
+        // Attach event listener for filter changes
+        const onFilterChanged = () => updateState();
+        gridApi.addEventListener('filterChanged', onFilterChanged);
+        // Initial state update
+        updateState();
+        // Cleanup event listener on unmount or gridApi change
+        return () => {
+            gridApi.removeEventListener('filterChanged', onFilterChanged);
+        };
+    }, [isReady, gridApi]);
+    // Cleanup on unmount
+    useEffect(() => {
+        return () => {
+            if (urlSyncRef.current) {
+                urlSyncRef.current.destroy();
+                urlSyncRef.current = null;
+            }
+        };
+    }, []);
+    // Memoized API methods
+    const shareUrl = useCallback((baseUrl) => {
+        if (!urlSyncRef.current) {
+            return (baseUrl || (typeof window !== 'undefined' ? window.location.href : ''));
+        }
+        try {
+            return urlSyncRef.current.generateUrl(baseUrl);
+        }
+        catch (error) {
+            console.error('Failed to generate share URL:', error);
+            return (baseUrl || (typeof window !== 'undefined' ? window.location.href : ''));
+        }
+    }, []);
+    const getQueryParams = useCallback(() => {
+        if (!urlSyncRef.current) {
+            return '';
+        }
+        try {
+            return urlSyncRef.current.getQueryParams();
+        }
+        catch (error) {
+            console.error('Failed to get query params:', error);
+            return '';
+        }
+    }, []);
+    const applyUrlFilters = useCallback((url) => {
+        if (!urlSyncRef.current) {
+            console.warn('AG Grid URL Sync not ready');
+            return;
+        }
+        try {
+            urlSyncRef.current.applyFromUrl(url);
+        }
+        catch (error) {
+            console.error('Failed to apply URL filters:', error);
+            coreOptions.onParseError?.(error);
+        }
+    }, [coreOptions]);
+    const clearFilters = useCallback(() => {
+        if (!urlSyncRef.current) {
+            console.warn('AG Grid URL Sync not ready');
+            return;
+        }
+        try {
+            urlSyncRef.current.clearFilters();
+        }
+        catch (error) {
+            console.error('Failed to clear filters:', error);
+        }
+    }, []);
+    const parseUrlFilters = useCallback((url) => {
+        if (!gridApi) {
+            console.warn('AG Grid API not available');
+            return {};
+        }
+        try {
+            const config = {
+                gridApi,
+                paramPrefix: coreOptions.paramPrefix ?? DEFAULT_CONFIG.paramPrefix,
+                maxValueLength: coreOptions.maxValueLength ?? DEFAULT_CONFIG.maxValueLength,
+                onParseError: coreOptions.onParseError ?? (() => { })
+            };
+            return parseFilters(url, config);
+        }
+        catch (error) {
+            console.error('Failed to parse URL filters:', error);
+            coreOptions.onParseError?.(error);
+            return {};
+        }
+    }, [coreOptions, gridApi]);
+    const applyFilters = useCallback((filters) => {
+        if (!urlSyncRef.current) {
+            console.warn('AG Grid URL Sync not ready');
+            return;
+        }
+        try {
+            urlSyncRef.current.applyFilters(filters);
+        }
+        catch (error) {
+            console.error('Failed to apply filters:', error);
+        }
+    }, []);
+    // Return the hook API
+    return useMemo(() => ({
+        shareUrl,
+        getQueryParams,
+        applyUrlFilters,
+        clearFilters,
+        isReady,
+        currentUrl,
+        hasFilters,
+        parseUrlFilters,
+        applyFilters
+    }), [
+        shareUrl,
+        getQueryParams,
+        applyUrlFilters,
+        clearFilters,
+        isReady,
+        currentUrl,
+        hasFilters,
+        parseUrlFilters,
+        applyFilters
+    ]);
+}
+//# sourceMappingURL=use-ag-grid-url-sync.js.map