ag-grid-url-sync 0.1.1 → 0.2.2

package/dist/core/grid-integration.js

@@ -0,0 +1,156 @@
+import { AG_GRID_OPERATION_NAMES, REVERSE_AG_GRID_OPERATION_NAMES, TEXT_FILTER_OPERATIONS, NUMBER_FILTER_OPERATIONS } from './types.js';
+/**
+ * Type predicate to check if an operation is a valid text filter operation
+ */
+function isTextFilterOperation(operation) {
+    return TEXT_FILTER_OPERATIONS.includes(operation);
+}
+/**
+ * Type predicate to check if an operation is a valid number filter operation
+ */
+function isNumberFilterOperation(operation) {
+    return NUMBER_FILTER_OPERATIONS.includes(operation);
+}
+/**
+ * Detects the expected filter type for a column based on AG Grid configuration
+ */
+export function detectColumnFilterType(gridApi, columnId) {
+    try {
+        const column = gridApi.getColumn(columnId);
+        if (!column)
+            return null;
+        const colDef = column.getColDef();
+        // 1. Explicit filter configuration takes priority
+        if (colDef.filter === 'agNumberColumnFilter')
+            return 'number';
+        if (colDef.filter === 'agTextColumnFilter')
+            return 'text';
+        // 2. Cell data type configuration
+        if (colDef.cellDataType === 'number')
+            return 'number';
+        if (colDef.cellDataType === 'text')
+            return 'text';
+        // 3. Default to text for backward compatibility
+        return 'text';
+    }
+    catch {
+        return 'text'; // Safe fallback
+    }
+}
+/**
+ * Gets the current filter model from AG Grid
+ */
+export function getFilterModel(config) {
+    try {
+        const model = config.gridApi.getFilterModel();
+        const filterState = {};
+        if (!model || typeof model !== 'object') {
+            return filterState;
+        }
+        for (const [column, filter] of Object.entries(model)) {
+            if (!filter || typeof filter !== 'object')
+                continue;
+            const { filterType, type, filter: value, filterTo } = filter;
+            // Handle both text and number filters
+            if (filterType === 'text') {
+                // Map AG Grid operations back to our internal operations using centralized mapping
+                const internalOperation = REVERSE_AG_GRID_OPERATION_NAMES[type];
+                // Use type predicate to validate and narrow the type
+                if (internalOperation && isTextFilterOperation(internalOperation)) {
+                    filterState[column] = {
+                        filterType: 'text',
+                        type: internalOperation, // Now properly typed as TextFilterOperation
+                        filter: value || ''
+                    };
+                }
+            }
+            else if (filterType === 'number') {
+                // Map AG Grid number operations back to our internal operations
+                const internalOperation = REVERSE_AG_GRID_OPERATION_NAMES[type];
+                // Use type predicate to validate and narrow the type
+                if (internalOperation && isNumberFilterOperation(internalOperation)) {
+                    const numberFilter = {
+                        filterType: 'number',
+                        type: internalOperation, // Now properly typed as NumberFilterOperation
+                        filter: typeof value === 'number' ? value : 0
+                    };
+                    // Handle range operations
+                    if (internalOperation === 'inRange' && typeof filterTo === 'number') {
+                        ;
+                        numberFilter.filterTo = filterTo;
+                    }
+                    filterState[column] = numberFilter;
+                }
+            }
+        }
+        return filterState;
+    }
+    catch (error) {
+        if (config.onParseError) {
+            config.onParseError(error);
+        }
+        return {};
+    }
+}
+/**
+ * Converts internal filter to AG Grid filter format
+ */
+function convertToAGGridFilter(filter) {
+    if (filter.filterType === 'number') {
+        const agGridOperation = AG_GRID_OPERATION_NAMES[filter.type];
+        if (filter.type === 'inRange') {
+            const baseFilter = {
+                filterType: 'number',
+                type: agGridOperation,
+                filter: filter.filter
+            };
+            // Only include filterTo if it's defined
+            return filter.filterTo !== undefined
+                ? { ...baseFilter, filterTo: filter.filterTo }
+                : baseFilter;
+        }
+        return {
+            filterType: 'number',
+            type: agGridOperation,
+            filter: filter.filter
+        };
+    }
+    // Text filter handling
+    const agGridOperation = AG_GRID_OPERATION_NAMES[filter.type];
+    return {
+        filterType: 'text',
+        type: agGridOperation,
+        filter: filter.filter
+    };
+}
+/**
+ * Applies a filter state to AG Grid
+ */
+export function applyFilterModel(filterState, config) {
+    try {
+        const model = {};
+        for (const [column, filter] of Object.entries(filterState)) {
+            if (!filter || typeof filter !== 'object')
+                continue;
+            // Detect expected filter type for this column
+            const expectedType = detectColumnFilterType(config.gridApi, column);
+            // Validate filter type compatibility
+            if (filter.filterType === 'number' && expectedType !== 'number') {
+                console.warn(`Column '${column}' expects a text filter but received a number filter. This may indicate a configuration mismatch in the column definition or filter application.`);
+                continue;
+            }
+            // Convert to AG Grid filter model
+            const agGridFilter = convertToAGGridFilter(filter);
+            if (agGridFilter) {
+                model[column] = agGridFilter;
+            }
+        }
+        config.gridApi.setFilterModel(model);
+    }
+    catch (error) {
+        if (config.onParseError) {
+            config.onParseError(error);
+        }
+    }
+}
+//# sourceMappingURL=grid-integration.js.map

package/dist/core/grid-integration.js.map

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

package/dist/core/index.d.ts

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

package/dist/core/index.js

@@ -0,0 +1,11 @@
+export { AGGridUrlSync, createUrlSync } from './ag-grid-url-sync.js';
+export * from './types.js';
+// Validation utilities
+export { validateFilterValue, DEFAULT_CONFIG } from './validation.js';
+// URL parsing utilities
+export { parseUrlFilters, parseFilterParam } from './url-parser.js';
+// URL generation utilities
+export { serializeFilters, generateUrl } from './url-generator.js';
+// AG Grid integration utilities
+export { getFilterModel, applyFilterModel } from './grid-integration.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAEpE,cAAc,YAAY,CAAA;AAE1B,uBAAuB;AACvB,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErE,wBAAwB;AACxB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEnE,2BAA2B;AAC3B,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAElE,gCAAgC;AAChC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/core/types.d.ts

@@ -0,0 +1,107 @@
+import type { GridApi as AGGridApi, TextFilterModel, NumberFilterModel } 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 for both text and number filters
+ */
+export type FilterOperation = 'contains' | 'eq' | 'notContains' | 'notEqual' | 'startsWith' | 'endsWith' | 'blank' | 'notBlank' | 'lessThan' | 'lessThanOrEqual' | 'greaterThan' | 'greaterThanOrEqual' | 'inRange';
+/**
+ * Valid text filter operations as const array
+ */
+export declare const TEXT_FILTER_OPERATIONS: readonly ["contains", "eq", "notContains", "notEqual", "startsWith", "endsWith", "blank", "notBlank"];
+/**
+ * Valid number filter operations as const array
+ */
+export declare const NUMBER_FILTER_OPERATIONS: readonly ["eq", "notEqual", "lessThan", "lessThanOrEqual", "greaterThan", "greaterThanOrEqual", "inRange", "blank", "notBlank"];
+/**
+ * Text-specific filter operations
+ */
+export type TextFilterOperation = (typeof TEXT_FILTER_OPERATIONS)[number];
+/**
+ * Number-specific filter operations
+ */
+export type NumberFilterOperation = (typeof NUMBER_FILTER_OPERATIONS)[number];
+/**
+ * Base interface for column filters
+ */
+interface BaseColumnFilter {
+    type: FilterOperation;
+}
+/**
+ * Text filter configuration
+ */
+export interface TextColumnFilter extends BaseColumnFilter {
+    filterType: 'text';
+    type: TextFilterOperation;
+    filter: string;
+}
+/**
+ * Number filter configuration
+ */
+export interface NumberColumnFilter extends BaseColumnFilter {
+    filterType: 'number';
+    type: NumberFilterOperation;
+    filter: number;
+    filterTo?: number;
+}
+/**
+ * Filter state for a single column (union of text and number filters)
+ */
+export type ColumnFilter = TextColumnFilter | NumberColumnFilter;
+/**
+ * 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: FilterOperation;
+    filterType: 'text' | 'number' | 'auto';
+    value: string | number;
+    filterTo?: number;
+    action: 'apply' | 'remove';
+};
+export type GridApi = AGGridApi;
+/**
+ * Union type for AG Grid filters using official AG Grid types
+ */
+export type AGGridFilter = TextFilterModel | NumberFilterModel;
+export declare const OPERATION_MAP: Record<string, FilterOperation>;
+export declare const INTERNAL_TO_URL_OPERATION_MAP: Record<FilterOperation, string>;
+export declare const AG_GRID_OPERATION_NAMES: Record<FilterOperation, string>;
+export declare const REVERSE_AG_GRID_OPERATION_NAMES: Record<string, FilterOperation>;
+export {};

package/dist/core/types.js

@@ -0,0 +1,117 @@
+/**
+ * Valid text filter operations as const array
+ */
+export const TEXT_FILTER_OPERATIONS = [
+    'contains',
+    'eq',
+    'notContains',
+    'notEqual',
+    'startsWith',
+    'endsWith',
+    'blank',
+    'notBlank'
+];
+/**
+ * Valid number filter operations as const array
+ */
+export const NUMBER_FILTER_OPERATIONS = [
+    'eq',
+    'notEqual',
+    'lessThan',
+    'lessThanOrEqual',
+    'greaterThan',
+    'greaterThanOrEqual',
+    'inRange',
+    'blank',
+    'notBlank'
+];
+/**
+ * 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';
+    }
+}
+/**
+ * Operation Mapping Strategy:
+ *
+ * We use three different naming conventions for better user experience:
+ *
+ * 1. URL Parameters: Short, clean names for URLs (e.g., 'eq', 'neq', 'lt', 'gt')
+ * 2. Internal Types: Consistent naming for our FilterOperation type
+ * 3. AG Grid Operations: Exact names expected by AG Grid API (e.g., 'equals', 'notEqual')
+ *
+ * This approach keeps URLs readable while maintaining compatibility with AG Grid.
+ */
+/**
+ * Define special URL shorthand mappings (internal -> URL)
+ * Operations not listed here use their internal name as URL param
+ */
+const URL_SHORTHAND_MAPPINGS = {
+    notEqual: 'neq',
+    lessThan: 'lt',
+    lessThanOrEqual: 'lte',
+    greaterThan: 'gt',
+    greaterThanOrEqual: 'gte',
+    inRange: 'range'
+};
+/**
+ * Define special AG Grid name mappings (internal -> AG Grid)
+ * Operations not listed here use their internal name for AG Grid
+ */
+const AG_GRID_NAME_MAPPINGS = {
+    eq: 'equals'
+};
+/**
+ * Helper function to create operation mappings dynamically
+ */
+function createOperationMaps() {
+    const allOperations = [...TEXT_FILTER_OPERATIONS, ...NUMBER_FILTER_OPERATIONS];
+    // Remove duplicates (like 'eq', 'blank', etc. that appear in both arrays)
+    const uniqueOperations = [...new Set(allOperations)];
+    // Generate URL mappings
+    const operationMap = {};
+    const internalToUrlMap = {};
+    uniqueOperations.forEach(operation => {
+        const urlName = URL_SHORTHAND_MAPPINGS[operation] || operation;
+        operationMap[urlName] = operation;
+        internalToUrlMap[operation] = urlName;
+    });
+    // Generate AG Grid mappings
+    const agGridMap = {};
+    const reverseAgGridMap = {};
+    uniqueOperations.forEach(operation => {
+        const agGridName = AG_GRID_NAME_MAPPINGS[operation] ||
+            operation;
+        agGridMap[operation] = agGridName;
+        reverseAgGridMap[agGridName] = operation;
+    });
+    return {
+        operationMap,
+        internalToUrlMap,
+        agGridMap,
+        reverseAgGridMap
+    };
+}
+// Generate all mappings dynamically
+const { operationMap, internalToUrlMap, agGridMap, reverseAgGridMap } = createOperationMaps();
+// Export the dynamically generated maps
+export const OPERATION_MAP = operationMap;
+export const INTERNAL_TO_URL_OPERATION_MAP = internalToUrlMap;
+export const AG_GRID_OPERATION_NAMES = agGridMap;
+export const REVERSE_AG_GRID_OPERATION_NAMES = reverseAgGridMap;
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

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

package/dist/core/url-generator.d.ts

@@ -0,0 +1,9 @@
+import type { FilterState, InternalConfig } from './types.js';
+/**
+ * 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;

package/dist/core/url-generator.js

@@ -0,0 +1,88 @@
+import { validateFilterValue } from './validation.js';
+import { INTERNAL_TO_URL_OPERATION_MAP } from './types.js';
+/**
+ * Serializes a single column filter to URL parameter
+ */
+function serializeColumnFilter(columnName, filter, paramPrefix) {
+    const urlOperation = INTERNAL_TO_URL_OPERATION_MAP[filter.type];
+    if (!urlOperation)
+        return '';
+    const paramName = `${paramPrefix}${columnName}_${urlOperation}`;
+    // Handle range operations
+    if (filter.type === 'inRange' && filter.filterType === 'number') {
+        // Type guard: ensure this is a NumberColumnFilter with inRange operation
+        if ('filterTo' in filter && filter.filterTo !== undefined) {
+            // Don't encode the comma for range values - handle this directly
+            return `${paramName}=${filter.filter},${filter.filterTo}`;
+        }
+        return '';
+    }
+    // Handle blank operations
+    if (filter.type === 'blank' || filter.type === 'notBlank') {
+        return `${paramName}=true`;
+    }
+    // Handle number operations
+    if (filter.filterType === 'number') {
+        return `${paramName}=${filter.filter}`;
+    }
+    // Handle text operations (existing logic)
+    if (filter.filterType === 'text' && filter.filter) {
+        // Note: Validation should be done at the serializeFilters level, not here
+        return `${paramName}=${encodeURIComponent(filter.filter.toString())}`;
+    }
+    return '';
+}
+/**
+ * Helper function to append a serialized parameter to URLSearchParams
+ */
+function appendSerializedParam(serialized, params) {
+    const [paramName, paramValue] = serialized.split('=');
+    if (paramName && paramValue) {
+        // Decode the parameter value to handle commas correctly
+        params.append(paramName, decodeURIComponent(paramValue));
+    }
+}
+/**
+ * Converts a filter state object into URL search parameters
+ */
+export function serializeFilters(filterState, config) {
+    const params = new URLSearchParams();
+    for (const [column, filter] of Object.entries(filterState)) {
+        // Support both text and number filters
+        if (filter.filterType !== 'text' && filter.filterType !== 'number')
+            continue;
+        // Apply validation for text filters before serialization
+        if (filter.filterType === 'text') {
+            const validatedValue = validateFilterValue(filter.filter, config, filter.type);
+            const updatedFilter = { ...filter, filter: validatedValue };
+            const serialized = serializeColumnFilter(column, updatedFilter, config.paramPrefix);
+            if (serialized) {
+                appendSerializedParam(serialized, params);
+            }
+        }
+        else {
+            // Number filters don't need additional validation as they're already validated
+            const serialized = serializeColumnFilter(column, filter, config.paramPrefix);
+            if (serialized) {
+                appendSerializedParam(serialized, params);
+            }
+        }
+    }
+    return params;
+}
+/**
+ * Generates a URL with the current filter state
+ */
+export function generateUrl(baseUrl, filterState, config) {
+    const url = new URL(baseUrl);
+    const filterParams = serializeFilters(filterState, config);
+    // Preserve existing non-filter parameters
+    for (const [key, value] of url.searchParams.entries()) {
+        if (!key.startsWith(config.paramPrefix)) {
+            filterParams.append(key, value);
+        }
+    }
+    url.search = filterParams.toString();
+    return url.toString();
+}
+//# sourceMappingURL=url-generator.js.map

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

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

package/dist/core/url-parser.d.ts

@@ -0,0 +1,9 @@
+import type { FilterState, ColumnFilter, InternalConfig } from './types.js';
+/**
+ * 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;