ag-grid-url-sync 0.1.1 → 0.2.1

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

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

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

package/package.json

@@ -1,9 +1,72 @@
 {
   "name": "ag-grid-url-sync",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "AG Grid URL Sync - Synchronize AG Grid text filters with URL parameters",
   "main": "dist/index.js",
   "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js",
+      "require": "./dist/react/index.js"
+    },
+    "./validation": {
+      "types": "./dist/core/validation.d.ts",
+      "import": "./dist/core/validation.js",
+      "require": "./dist/core/validation.js"
+    },
+    "./url-parser": {
+      "types": "./dist/core/url-parser.d.ts",
+      "import": "./dist/core/url-parser.js",
+      "require": "./dist/core/url-parser.js"
+    },
+    "./url-generator": {
+      "types": "./dist/core/url-generator.d.ts",
+      "import": "./dist/core/url-generator.js",
+      "require": "./dist/core/url-generator.js"
+    },
+    "./grid-integration": {
+      "types": "./dist/core/grid-integration.d.ts",
+      "import": "./dist/core/grid-integration.js",
+      "require": "./dist/core/grid-integration.js"
+    },
+    "./types": {
+      "types": "./dist/core/types.d.ts",
+      "import": "./dist/core/types.js",
+      "require": "./dist/core/types.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      ".": [
+        "dist/index.d.ts"
+      ],
+      "react": [
+        "dist/react/index.d.ts"
+      ],
+      "validation": [
+        "dist/core/validation.d.ts"
+      ],
+      "url-parser": [
+        "dist/core/url-parser.d.ts"
+      ],
+      "url-generator": [
+        "dist/core/url-generator.d.ts"
+      ],
+      "grid-integration": [
+        "dist/core/grid-integration.d.ts"
+      ],
+      "types": [
+        "dist/core/types.d.ts"
+      ]
+    }
+  },
   "scripts": {
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
@@ -31,7 +94,8 @@
     "sync",
     "filter",
     "share",
-    "typescript"
+    "typescript",
+    "react"
   ],
   "author": "NearForm",
   "license": "ISC",
@@ -47,7 +111,9 @@
     "@commitlint/cli": "^19.8.1",
     "@commitlint/config-conventional": "^19.8.1",
     "@eslint/js": "^9.29.0",
+    "@testing-library/react": "^14.0.0",
     "@types/jsdom": "^21.1.7",
+    "@types/react": "^18.0.0",
     "@vitest/coverage-v8": "^3.2.4",
     "ag-grid-community": "^33.3.2",
     "bundlesize": "^0.18.2",
@@ -59,12 +125,19 @@
     "jsdom": "^26.1.0",
     "lint-staged": "^16.1.2",
     "prettier": "^3.6.0",
+    "react": "^18.0.0",
     "rimraf": "^6.0.1",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4"
   },
   "peerDependencies": {
-    "ag-grid-community": ">=28.0.0"
+    "ag-grid-community": ">=28.0.0",
+    "react": ">=16.8.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
   },
   "lint-staged": {
     "*.{js,jsx,ts,tsx}": "eslint --cache --fix"
@@ -75,12 +148,28 @@
       "maxSize": "5KB"
     },
     {
-      "path": "./dist/ag-grid-url-sync.js",
+      "path": "./dist/core/ag-grid-url-sync.js",
       "maxSize": "4KB"
     },
     {
-      "path": "./dist/utils.js",
-      "maxSize": "4KB"
+      "path": "./dist/core/validation.js",
+      "maxSize": "2KB"
+    },
+    {
+      "path": "./dist/core/url-parser.js",
+      "maxSize": "3KB"
+    },
+    {
+      "path": "./dist/core/url-generator.js",
+      "maxSize": "2KB"
+    },
+    {
+      "path": "./dist/core/grid-integration.js",
+      "maxSize": "2KB"
+    },
+    {
+      "path": "./dist/react/index.js",
+      "maxSize": "7KB"
     }
   ]
 }

package/dist/ag-grid-url-sync.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ag-grid-url-sync.js","sourceRoot":"","sources":["../src/ag-grid-url-sync.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EACL,eAAe,EACf,WAAW,EACX,cAAc,EACd,gBAAgB,EACjB,MAAM,YAAY,CAAA;AAEnB;;GAEG;AACH,MAAM,OAAO,aAAa;IAChB,MAAM,CAAgB;IAE9B;;;;OAIG;IACH,YAAY,OAAgB,EAAE,SAA8B,EAAE;QAC5D,IAAI,CAAC,MAAM,GAAG;YACZ,OAAO;YACP,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,cAAc,CAAC,WAAW;YAC7D,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,cAAc,CAAC,cAAc;YACtE,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;SAChD,CAAA;IACH,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,OAAgB;QAC1B,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC/C,MAAM,GAAG,GAAG,OAAO,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAA;QAC3C,OAAO,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;IACnD,CAAC;IAED;;;OAGG;IACH,cAAc;QACZ,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;QAC9B,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;QAC3B,OAAO,MAAM,CAAC,MAAM,CAAA;IACtB,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,GAAY;QACvB,MAAM,UAAU,GAAG,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAA;QAC9C,MAAM,WAAW,GAAG,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QAC5D,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,CAAA;IAChC,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,WAAwB;QACnC,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;IAC5C,CAAC;IAED;;OAEG;IACH,YAAY;QACV,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAA;IACvB,CAAC;IAED;;OAEG;IACH,OAAO;QACL,2DAA2D;IAC7D,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAgB,EAChB,MAA4B;IAE5B,OAAO,IAAI,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;AAC3C,CAAC"}

package/dist/types.d.ts

@@ -1,69 +0,0 @@
-import type { GridApi as AGGridApi } from 'ag-grid-community';
-/**
- * Configuration options for AG Grid URL Sync
- */
-export interface AGGridUrlSyncConfig {
-    /**
-     * Prefix for URL parameters. Default: 'f_'
-     */
-    paramPrefix?: string;
-    /**
-     * Maximum length for filter values. Default: 200
-     */
-    maxValueLength?: number;
-    /**
-     * Optional error handler for parsing errors
-     */
-    onParseError?: (error: Error) => void;
-}
-/**
- * Supported filter operations
- */
-export type FilterOperation = 'contains' | 'eq';
-/**
- * Filter state for a single column
- */
-export interface ColumnFilter {
-    filterType: 'text';
-    type: FilterOperation;
-    filter: string;
-}
-/**
- * Complete filter state mapping
- */
-export interface FilterState {
-    [columnId: string]: ColumnFilter;
-}
-/**
- * Internal configuration with defaults
- */
-export interface InternalConfig extends Required<AGGridUrlSyncConfig> {
-    gridApi: AGGridApi;
-}
-/**
- * Error types for URL sync operations
- */
-export declare class URLSyncError extends Error {
-    constructor(message: string);
-}
-export declare class InvalidFilterError extends URLSyncError {
-    constructor(message: string);
-}
-export declare class InvalidURLError extends URLSyncError {
-    constructor(message: string);
-}
-export type ParsedFilterParam = {
-    columnName: string;
-    operation: 'contains' | 'equals';
-    value: string;
-    action: 'apply' | 'remove';
-};
-export type GridApi = AGGridApi;
-export declare const OPERATION_MAP: {
-    readonly contains: "contains";
-    readonly eq: "equals";
-};
-export declare const REVERSE_OPERATION_MAP: {
-    readonly contains: "contains";
-    readonly equals: "eq";
-};

package/dist/types.js

@@ -1,31 +0,0 @@
-/**
- * Error types for URL sync operations
- */
-export class URLSyncError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'URLSyncError';
-    }
-}
-export class InvalidFilterError extends URLSyncError {
-    constructor(message) {
-        super(message);
-        this.name = 'InvalidFilterError';
-    }
-}
-export class InvalidURLError extends URLSyncError {
-    constructor(message) {
-        super(message);
-        this.name = 'InvalidURLError';
-    }
-}
-// Internal operation mapping
-export const OPERATION_MAP = {
-    contains: 'contains',
-    eq: 'equals'
-};
-export const REVERSE_OPERATION_MAP = {
-    contains: 'contains',
-    equals: 'eq'
-};
-//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAkDA;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,cAAc,CAAA;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAClD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;IAClC,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,YAAY;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;IAC/B,CAAC;CACF;AAYD,6BAA6B;AAC7B,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,QAAQ,EAAE,UAAU;IACpB,EAAE,EAAE,QAAQ;CACJ,CAAA;AAEV,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,IAAI;CACJ,CAAA"}

package/dist/utils.d.ts

@@ -1,36 +0,0 @@
-import type { FilterState, ColumnFilter, InternalConfig } from './types.js';
-/**
- * Default configuration values
- */
-export declare const DEFAULT_CONFIG: {
-    readonly paramPrefix: "f_";
-    readonly maxValueLength: 200;
-};
-/**
- * Validates a filter value against configuration constraints
- */
-export declare function validateFilterValue(value: string, config: InternalConfig): string;
-/**
- * Parses a URL parameter into a column filter
- */
-export declare function parseFilterParam(param: string, value: string, expectedPrefix?: string): ColumnFilter;
-/**
- * Converts URL search params into a filter state object
- */
-export declare function parseUrlFilters(url: string, config: InternalConfig): FilterState;
-/**
- * Converts a filter state object into URL search parameters
- */
-export declare function serializeFilters(filterState: FilterState, config: InternalConfig): URLSearchParams;
-/**
- * Generates a URL with the current filter state
- */
-export declare function generateUrl(baseUrl: string, filterState: FilterState, config: InternalConfig): string;
-/**
- * Gets the current filter model from AG Grid
- */
-export declare function getFilterModel(config: InternalConfig): FilterState;
-/**
- * Applies a filter state to AG Grid
- */
-export declare function applyFilterModel(filterState: FilterState, config: InternalConfig): void;