ag-grid-url-sync 0.4.1 → 0.5.0

package/README.md

@@ -196,12 +196,11 @@ import type {
 ```typescript
 import { parseUrlFilters } from 'ag-grid-url-sync/url-parser'
 import { DEFAULT_CONFIG } from 'ag-grid-url-sync/validation'
-import type { FilterState } from 'ag-grid-url-sync/types'
+import type { FilterState, ParseConfig } from 'ag-grid-url-sync/types'
 
 function getFiltersFromUrl(url: string): FilterState {
-  const config = {
-    gridApi: null, // Not needed for parsing
-    ...DEFAULT_CONFIG,
+  const config: ParseConfig = {
+    ...DEFAULT_CONFIG, // gridApi is not needed for parsing
     onParseError: error => console.error('Parse error:', error)
   }
 
@@ -209,18 +208,32 @@ function getFiltersFromUrl(url: string): FilterState {
 }
 ```
 
+`parseUrlFilters` reads the input with these rules, in this order:
+
+| #   | Input                       | Result                   | Example                                   |
+| --- | --------------------------- | ------------------------ | ----------------------------------------- |
+| 1   | A host with no scheme       | Throws `InvalidURLError` | `example.com?…`, `localhost:3000?…`       |
+| 2   | Starts with a scheme        | Absolute URL             | `https://example.com/users?f_name_eq=bob` |
+| 3   | Starts with `/`, `?` or `#` | Relative URL             | `/users?f_name_eq=bob`, `?f_name_eq=bob`  |
+| 4   | Anything else               | Raw query string         | `f_name_eq=bob`                           |
+
+- A relative path must start with `/`. `users?f_name_eq=bob` matches rule 4, so it gives no filters.
+- A bare `localhost?…` with no port cannot be told apart from a raw query, so it matches rule 4.
+- In a raw query string, a `?` or `#` is part of a param name or value.
+
+`InvalidURLError` is thrown for rule 1, and for any input that the `URL` constructor rejects under rules 2 and 3 (for example `http://` or `//[`). A param that is not valid is skipped and sent to `onParseError`.
+
 #### Example: Custom URL Generator
 
 ```typescript
-import { generateUrl, serializeFilters } from 'ag-grid-url-sync/url-generator'
-import type { FilterState } from 'ag-grid-url-sync/types'
+import { generateUrl } from 'ag-grid-url-sync/url-generator'
+import { DEFAULT_CONFIG } from 'ag-grid-url-sync/validation'
+import type { FilterState, ParseConfig } from 'ag-grid-url-sync/types'
 
 function createShareableUrl(filters: FilterState, baseUrl: string): string {
-  const config = {
-    gridApi: null, // Not needed for generation
-    paramPrefix: 'f_',
-    maxValueLength: 200,
-    onParseError: () => {}
+  const config: ParseConfig = {
+    ...DEFAULT_CONFIG, // gridApi is not needed for generation
+    maxValueLength: 500
   }
 
   return generateUrl(baseUrl, filters, config)
@@ -300,6 +313,10 @@ interface AGGridUrlSyncConfig {
 }
 ```
 
+When the library reads a URL, it reads only the `groupedParam` name and decodes it with the configured `format`. It does not guess the format. This works in both modes, so a grouped link opens in an app in individual mode when the name and format match. If the param is present and not empty, the prefixed params are not read.
+
+> **Note:** A URL written with a different `groupedParam` or `format` does not decode. If you change either option, links that were shared before the change stop working.
+
 ### Format Options
 
 #### QueryString Format (Default)
@@ -420,7 +437,7 @@ import {
 
 ### Error Handling for Grouped Serialization
 
-You can provide a custom error handler to gracefully handle malformed grouped parameters or serialization errors. The library will throw an `InvalidSerializationError` for invalid formats:
+You can provide a custom error handler to gracefully handle malformed grouped parameters or serialization errors. In grouped mode, `onParseError` receives an `InvalidSerializationError` for invalid formats:
 
 ```typescript
 import { InvalidSerializationError } from 'ag-grid-url-sync/types'
@@ -440,6 +457,18 @@ const urlSync = createUrlSync(gridApi, {
 })
 ```
 
+In every grouped format (`querystring`, `json`, `base64`), a text value over `maxValueLength` (default 200) is dropped and reported through `onParseError`, both when the URL is generated and when it is parsed.
+
+In grouped mode, an error that comes from the grouped URL value is an `InvalidSerializationError`. This includes an error for one bad parameter inside a grouped querystring value, such as a value over `maxValueLength`. The original error is in `error.cause`. In individual mode, the same failure arrives as the original error, with no wrapper. To handle a specific error in both modes, check the error and its cause:
+
+```typescript
+import { InvalidFilterError } from 'ag-grid-url-sync/types'
+
+const isFilterError = (error: Error) =>
+  error instanceof InvalidFilterError ||
+  error.cause instanceof InvalidFilterError
+```
+
 ### Exports
 
 The package supports granular subpath exports for advanced usage and optimal bundle size:
@@ -594,7 +623,7 @@ interface UseAGGridUrlSyncOptions {
 | `clearFilters`       | `() => void`                     | Clear all text filters                          |
 | `isReady`            | `boolean`                        | Whether grid API is available and hook is ready |
 | `currentUrl`         | `string`                         | Current URL with filters applied                |
-| `hasFilters`         | `boolean`                        | Whether grid has any active text filters        |
+| `hasFilters`         | `boolean`                        | Whether the grid has supported filters          |
 | `parseUrlFilters`    | `(url: string) => FilterState`   | Parse filters from URL without applying         |
 | `applyFilters`       | `(filters: FilterState) => void` | Apply filter state object to grid               |
 | `getFiltersAsFormat` | `(format: 'querystring'          | 'json'                                          | 'base64') => string`                                       | Serialize filters to any supported format (for sharing/export) |
@@ -889,6 +918,15 @@ const url = urlSync.generateUrl('https://app.com/page')
 // https://app.com/page?f_name_contains=john
 ```
 
+##### `getUrlState(baseUrl?: string): { url: string; hasFilters: boolean }`
+
+Generates the same URL as `generateUrl`, and tells if the grid has filters that the library supports. It reads the grid one time for both values. `hasFilters` comes from the filter state, not from the URL, because the URL also keeps the page's own params.
+
+```typescript
+const { url, hasFilters } = urlSync.getUrlState('https://app.com/page?tab=1')
+// url: https://app.com/page?tab=1 (no filters), hasFilters: false
+```
+
 ##### `getQueryParams(): string`
 
 Gets the current filter state as URL query parameters.

package/dist/core/ag-grid-url-sync.d.ts

@@ -17,6 +17,19 @@ export declare class AGGridUrlSync {
      * @returns URL string with filter parameters
      */
     generateUrl(baseUrl?: string): string;
+    /**
+     * Generates a URL with the current filter state, and tells if the grid has
+     * filters that the library supports.
+     *
+     * Reads the grid filter model one time, so an error in it is reported one
+     * time. `hasFilters` comes from the filter state, not from the URL: the URL
+     * also keeps the page's own params (#215).
+     * @param baseUrl - Optional base URL (defaults to current URL)
+     */
+    getUrlState(baseUrl?: string): {
+        url: string;
+        hasFilters: boolean;
+    };
     /**
      * Gets the current filter state as URL query parameters
      * @returns Query parameter string

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

@@ -6,16 +6,23 @@ import { serializeGrouped } from './serialization/grouped.js';
 export class AGGridUrlSync {
     config;
     constructor(gridApi, config = {}) {
+        const definedConfig = Object.fromEntries(Object.entries(config).filter(([, value]) => value !== undefined));
         this.config = {
             gridApi,
             ...DEFAULT_CONFIG,
-            ...config
+            ...definedConfig
         };
     }
     generateUrl(baseUrl) {
+        return this.getUrlState(baseUrl).url;
+    }
+    getUrlState(baseUrl) {
         const filterState = getFilterModel(this.config);
         const url = baseUrl ?? window.location.href;
-        return generateUrl(url, filterState, this.config);
+        return {
+            url: generateUrl(url, filterState, this.config),
+            hasFilters: Object.keys(filterState).length > 0
+        };
     }
     getQueryParams() {
         const url = this.generateUrl();

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

@@ -1 +1 @@
-{"version":3,"file":"ag-grid-url-sync.js","sourceRoot":"","sources":["../../src/core/ag-grid-url-sync.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAK7D,MAAM,OAAO,aAAa;IAChB,MAAM,CAAgB;IAO9B,YAAY,OAAgB,EAAE,MAAM,GAAwB,EAAE;QAC5D,IAAI,CAAC,MAAM,GAAG;YACZ,OAAO;YACP,GAAG,cAAc;YACjB,GAAG,MAAM;SACV,CAAA;IACH,CAAC;IAOD,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;IAMD,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;IAMD,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;IAMD,YAAY,CAAC,WAAwB;QACnC,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;IAC5C,CAAC;IAKD,YAAY;QACV,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAA;IACvB,CAAC;IAKD,OAAO;IAEP,CAAC;IAMD,oBAAoB;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAA;IAClC,CAAC;IAMD,gBAAgB;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAA;IAC3B,CAAC;IAKD,kBAAkB,CAAC,MAA2B;QAC5C,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAG/C,MAAM,UAAU,GAAG;YACjB,GAAG,IAAI,CAAC,MAAM;YACd,MAAM;YACN,aAAa,EAAE,SAAkB;SAClC,CAAA;QAGD,MAAM,MAAM,GAAG,gBAAgB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAA;QAExD,OAAO,MAAM,CAAC,KAAK,CAAA;IACrB,CAAC;CACF;AAQD,MAAM,UAAU,aAAa,CAC3B,OAAgB,EAChB,MAA4B;IAE5B,OAAO,IAAI,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;AAC3C,CAAC"}
+{"version":3,"file":"ag-grid-url-sync.js","sourceRoot":"","sources":["../../src/core/ag-grid-url-sync.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAK7D,MAAM,OAAO,aAAa;IAChB,MAAM,CAAgB;IAO9B,YAAY,OAAgB,EAAE,MAAM,GAAwB,EAAE;QAI5D,MAAM,aAAa,GAAG,MAAM,CAAC,WAAW,CACtC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAC3C,CAAA;QAExB,IAAI,CAAC,MAAM,GAAG;YACZ,OAAO;YACP,GAAG,cAAc;YACjB,GAAG,aAAa;SACjB,CAAA;IACH,CAAC;IAOD,WAAW,CAAC,OAAgB;QAC1B,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,CAAA;IACtC,CAAC;IAWD,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;YACL,GAAG,EAAE,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC;YAC/C,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC;SAChD,CAAA;IACH,CAAC;IAMD,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;IAMD,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;IAMD,YAAY,CAAC,WAAwB;QACnC,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;IAC5C,CAAC;IAKD,YAAY;QACV,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAA;IACvB,CAAC;IAKD,OAAO;IAEP,CAAC;IAMD,oBAAoB;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAA;IAClC,CAAC;IAMD,gBAAgB;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAA;IAC3B,CAAC;IAKD,kBAAkB,CAAC,MAA2B;QAC5C,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAG/C,MAAM,UAAU,GAAG;YACjB,GAAG,IAAI,CAAC,MAAM;YACd,MAAM;YACN,aAAa,EAAE,SAAkB;SAClC,CAAA;QAGD,MAAM,MAAM,GAAG,gBAAgB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAA;QAExD,OAAO,MAAM,CAAC,KAAK,CAAA;IACrB,CAAC;CACF;AAQD,MAAM,UAAU,aAAa,CAC3B,OAAgB,EAChB,MAA4B;IAE5B,OAAO,IAAI,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;AAC3C,CAAC"}

package/dist/core/individual-params.d.ts

@@ -0,0 +1,19 @@
+import type { FilterState, ColumnFilter, ParseConfig } from './types.js';
+/**
+ * Converts a filter state object into URL search parameters.
+ * This function does not require a GridApi instance: leave `config.gridApi` out
+ * (or set it to `null`) when you only need to serialize filters without a grid.
+ * A text value over `config.maxValueLength` is reported through
+ * `config.onParseError` and skipped. The other filters are kept.
+ */
+export declare function serializeFilters(filterState: FilterState, config: ParseConfig): URLSearchParams;
+/**
+ * Parses a URL parameter into a column filter
+ */
+export declare function parseFilterParam(param: string, value: string, expectedPrefix?: string): ColumnFilter;
+/**
+ * Parses prefixed filter parameters into a filter state object.
+ * Parameters without the configured prefix are skipped. A parameter that fails
+ * to parse is reported through `config.onParseError` and skipped.
+ */
+export declare function parseIndividualParams(searchParams: URLSearchParams, config: ParseConfig): FilterState;

package/dist/core/individual-params.js

@@ -0,0 +1,260 @@
+import { InvalidFilterError, OPERATION_MAP, INTERNAL_TO_URL_OPERATION_MAP } from './types.js';
+import { validateFilterValue, validateAndParseNumber, validateNumberRange, validateAndParseDate, validateAndParseDateRange, validateDateFilter, DEFAULT_CONFIG } from './validation.js';
+const FILTER_TYPES = {
+    TEXT: 'text',
+    NUMBER: 'number',
+    DATE: 'date'
+};
+function serializeColumnFilter(columnName, filter, paramPrefix) {
+    const urlOperation = INTERNAL_TO_URL_OPERATION_MAP[filter.type];
+    if (!urlOperation)
+        return null;
+    const paramName = `${paramPrefix}${columnName}_${urlOperation}`;
+    if (filter.type === 'dateRange' || filter.type === 'inRange') {
+        return 'filterTo' in filter && filter.filterTo !== undefined
+            ? [paramName, `${filter.filter},${filter.filterTo}`]
+            : null;
+    }
+    if (filter.type === 'blank' || filter.type === 'notBlank') {
+        return [paramName, 'true'];
+    }
+    if (filter.filterType === FILTER_TYPES.NUMBER ||
+        filter.filterType === FILTER_TYPES.DATE) {
+        const value = String(filter.filter);
+        return value ? [paramName, value] : null;
+    }
+    if (filter.filterType === FILTER_TYPES.TEXT && filter.filter) {
+        return [paramName, filter.filter];
+    }
+    return null;
+}
+export function serializeFilters(filterState, config) {
+    const params = new URLSearchParams();
+    for (const [column, filter] of Object.entries(filterState)) {
+        if (filter.filterType !== FILTER_TYPES.TEXT &&
+            filter.filterType !== FILTER_TYPES.NUMBER &&
+            filter.filterType !== FILTER_TYPES.DATE)
+            continue;
+        let checkedFilter = filter;
+        if (filter.filterType === FILTER_TYPES.TEXT) {
+            try {
+                checkedFilter = {
+                    ...filter,
+                    filter: validateFilterValue(filter.filter, config, filter.type)
+                };
+            }
+            catch (error) {
+                config.onParseError?.(error);
+                continue;
+            }
+        }
+        const param = serializeColumnFilter(column, checkedFilter, config.paramPrefix);
+        if (param) {
+            params.append(...param);
+        }
+    }
+    return params;
+}
+function isNumberOperation(operation) {
+    return [
+        'lessThan',
+        'lessThanOrEqual',
+        'greaterThan',
+        'greaterThanOrEqual',
+        'inRange'
+    ].includes(operation);
+}
+function isDateOperation(operation) {
+    return [
+        'dateBefore',
+        'dateBeforeOrEqual',
+        'dateAfter',
+        'dateAfterOrEqual',
+        'dateRange'
+    ].includes(operation);
+}
+function isSharedOperation(operation) {
+    return ['eq', 'notEqual', 'blank', 'notBlank'].includes(operation);
+}
+function tryParseAsDate(value) {
+    try {
+        validateAndParseDate(value);
+        return 'date';
+    }
+    catch {
+        return null;
+    }
+}
+function tryParseNumber(value) {
+    try {
+        return validateAndParseNumber(value);
+    }
+    catch {
+        return null;
+    }
+}
+function detectFilterTypeForSharedOperation(operation, value) {
+    if (operation === 'blank' || operation === 'notBlank') {
+        return 'text';
+    }
+    if (operation === 'eq' || operation === 'notEqual') {
+        if (tryParseAsDate(value) === 'date') {
+            return 'date';
+        }
+        if (tryParseNumber(value) !== null) {
+            return 'number';
+        }
+        return 'text';
+    }
+    return 'text';
+}
+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}`);
+    }
+    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 };
+}
+export function parseFilterParam(param, value, expectedPrefix) {
+    const { operation } = extractColumnAndOperation(param, expectedPrefix);
+    return parseFilterOperation(operation, value);
+}
+function parseFilterOperation(operation, value) {
+    const filterOp = OPERATION_MAP[operation];
+    if (!filterOp) {
+        throw new InvalidFilterError(`Unsupported filter operation: ${operation}`);
+    }
+    if (filterOp === 'dateRange') {
+        try {
+            const [startDate, endDate] = validateAndParseDateRange(value);
+            return {
+                filterType: 'date',
+                type: filterOp,
+                filter: startDate,
+                filterTo: endDate
+            };
+        }
+        catch (error) {
+            throw new InvalidFilterError(error instanceof Error ? error.message : 'Invalid date range');
+        }
+    }
+    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
+        };
+    }
+    if (isDateOperation(filterOp)) {
+        try {
+            const dateValue = validateAndParseDate(value);
+            const validation = validateDateFilter(dateValue, filterOp);
+            if (!validation.valid) {
+                throw new InvalidFilterError(validation.error || 'Invalid date filter');
+            }
+            return {
+                filterType: 'date',
+                type: filterOp,
+                filter: dateValue
+            };
+        }
+        catch (error) {
+            throw new InvalidFilterError(error instanceof Error ? error.message : 'Invalid date filter');
+        }
+    }
+    if (isNumberOperation(filterOp)) {
+        const numValue = validateAndParseNumber(value);
+        return {
+            filterType: 'number',
+            type: filterOp,
+            filter: numValue
+        };
+    }
+    if (isSharedOperation(filterOp)) {
+        const detectedType = detectFilterTypeForSharedOperation(filterOp, value);
+        if (detectedType === 'date') {
+            try {
+                const dateValue = validateAndParseDate(value);
+                return {
+                    filterType: 'date',
+                    type: filterOp,
+                    filter: dateValue
+                };
+            }
+            catch {
+            }
+        }
+        if (detectedType === 'number') {
+            const numValue = tryParseNumber(value);
+            if (numValue !== null) {
+                return {
+                    filterType: 'number',
+                    type: filterOp,
+                    filter: numValue
+                };
+            }
+        }
+        return {
+            filterType: 'text',
+            type: filterOp,
+            filter: filterOp === 'blank' || filterOp === 'notBlank' ? '' : value || ''
+        };
+    }
+    return {
+        filterType: 'text',
+        type: filterOp,
+        filter: value || ''
+    };
+}
+export function parseIndividualParams(searchParams, config) {
+    const filterState = {};
+    for (const [param, value] of searchParams.entries()) {
+        if (!param.startsWith(config.paramPrefix))
+            continue;
+        try {
+            const { column: columnName, operation } = extractColumnAndOperation(param, config.paramPrefix);
+            const filterParam = parseFilterOperation(operation, value);
+            if (filterParam.filterType === 'text') {
+                const validatedValue = validateFilterValue(value, config, filterParam.type);
+                filterState[columnName] = {
+                    ...filterParam,
+                    filter: validatedValue
+                };
+            }
+            else {
+                filterState[columnName] = filterParam;
+            }
+        }
+        catch (error) {
+            config.onParseError?.(error);
+            continue;
+        }
+    }
+    return filterState;
+}
+//# sourceMappingURL=individual-params.js.map

package/dist/core/individual-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"individual-params.js","sourceRoot":"","sources":["../../src/core/individual-params.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,6BAA6B,EAC9B,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,kBAAkB,EAClB,cAAc,EACf,MAAM,iBAAiB,CAAA;AAQxB,MAAM,YAAY,GAAG;IACnB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;CACJ,CAAA;AAQV,SAAS,qBAAqB,CAC5B,UAAkB,EAClB,MAAoB,EACpB,WAAmB;IAEnB,MAAM,YAAY,GAChB,6BAA6B,CAC3B,MAAM,CAAC,IAAkD,CAC1D,CAAA;IACH,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAA;IAE9B,MAAM,SAAS,GAAG,GAAG,WAAW,GAAG,UAAU,IAAI,YAAY,EAAE,CAAA;IAG/D,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7D,OAAO,UAAU,IAAI,MAAM,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;YAC1D,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpD,CAAC,CAAC,IAAI,CAAA;IACV,CAAC;IAGD,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC1D,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;IAC5B,CAAC;IAID,IACE,MAAM,CAAC,UAAU,KAAK,YAAY,CAAC,MAAM;QACzC,MAAM,CAAC,UAAU,KAAK,YAAY,CAAC,IAAI,EACvC,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QACnC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAC1C,CAAC;IAGD,IAAI,MAAM,CAAC,UAAU,KAAK,YAAY,CAAC,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAC7D,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;IACnC,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AASD,MAAM,UAAU,gBAAgB,CAC9B,WAAwB,EACxB,MAAmB;IAEnB,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;IAEpC,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAE3D,IACE,MAAM,CAAC,UAAU,KAAK,YAAY,CAAC,IAAI;YACvC,MAAM,CAAC,UAAU,KAAK,YAAY,CAAC,MAAM;YACzC,MAAM,CAAC,UAAU,KAAK,YAAY,CAAC,IAAI;YAEvC,SAAQ;QAIV,IAAI,aAAa,GAAiB,MAAM,CAAA;QACxC,IAAI,MAAM,CAAC,UAAU,KAAK,YAAY,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,CAAC;gBACH,aAAa,GAAG;oBACd,GAAG,MAAM;oBACT,MAAM,EAAE,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC;iBAChE,CAAA;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAEf,MAAM,CAAC,YAAY,EAAE,CAAC,KAAc,CAAC,CAAA;gBACrC,SAAQ;YACV,CAAC;QACH,CAAC;QAED,MAAM,KAAK,GAAG,qBAAqB,CACjC,MAAM,EACN,aAAa,EACb,MAAM,CAAC,WAAW,CACnB,CAAA;QACD,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAA;QACzB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAKD,SAAS,iBAAiB,CAAC,SAAiB;IAC1C,OAAO;QACL,UAAU;QACV,iBAAiB;QACjB,aAAa;QACb,oBAAoB;QACpB,SAAS;KACV,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;AACvB,CAAC;AAKD,SAAS,eAAe,CAAC,SAAiB;IACxC,OAAO;QACL,YAAY;QACZ,mBAAmB;QACnB,WAAW;QACX,kBAAkB;QAClB,WAAW;KACZ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;AACvB,CAAC;AAKD,SAAS,iBAAiB,CAAC,SAAiB;IAC1C,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;AACpE,CAAC;AAMD,SAAS,cAAc,CAAC,KAAa;IACnC,IAAI,CAAC;QACH,oBAAoB,CAAC,KAAK,CAAC,CAAA;QAC3B,OAAO,MAAM,CAAA;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAOD,SAAS,cAAc,CAAC,KAAa;IACnC,IAAI,CAAC;QACH,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAA;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAMD,SAAS,kCAAkC,CACzC,SAAiB,EACjB,KAAa;IAGb,IAAI,SAAS,KAAK,OAAO,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QACtD,OAAO,MAAM,CAAA;IACf,CAAC;IAGD,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QAEnD,IAAI,cAAc,CAAC,KAAK,CAAC,KAAK,MAAM,EAAE,CAAC;YACrC,OAAO,MAAM,CAAA;QACf,CAAC;QAGD,IAAI,cAAc,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;YACnC,OAAO,QAAQ,CAAA;QACjB,CAAC;QAGD,OAAO,MAAM,CAAA;IACf,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAKD,SAAS,yBAAyB,CAChC,KAAa,EACb,cAAuB;IAEvB,MAAM,wBAAwB,GAAG,CAAC,MAAc,EAAU,EAAE,CAC1D,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAA;IAE9C,MAAM,eAAe,GAAG,cAAc;QACpC,CAAC,CAAC,wBAAwB,CAAC,cAAc,CAAC;QAC1C,CAAC,CAAC,wBAAwB,CAAC,cAAc,CAAC,WAAW,CAAC,CAAA;IAExD,MAAM,aAAa,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAClD,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,aAAa,GAAG,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,kBAAkB,CAAC,uCAAuC,KAAK,EAAE,CAAC,CAAA;IAC9E,CAAC;IAGD,MAAM,aAAa,GAAG,KAAK,CAAC,SAAS,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC/D,MAAM,mBAAmB,GAAG,aAAa,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IAE1D,IAAI,mBAAmB,KAAK,CAAC,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,kBAAkB,CAAC,oCAAoC,KAAK,EAAE,CAAC,CAAA;IAC3E,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAA;IAC9D,MAAM,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC,mBAAmB,GAAG,CAAC,CAAC,CAAA;IAElE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACnB,MAAM,IAAI,kBAAkB,CAAC,mCAAmC,KAAK,EAAE,CAAC,CAAA;IAC1E,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;AAC9B,CAAC;AAKD,MAAM,UAAU,gBAAgB,CAC9B,KAAa,EACb,KAAa,EACb,cAAuB;IAEvB,MAAM,EAAE,SAAS,EAAE,GAAG,yBAAyB,CAAC,KAAK,EAAE,cAAc,CAAC,CAAA;IACtE,OAAO,oBAAoB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;AAC/C,CAAC;AAMD,SAAS,oBAAoB,CAAC,SAAiB,EAAE,KAAa;IAC5D,MAAM,QAAQ,GAAG,aAAa,CAAC,SAAuC,CAAC,CAAA;IACvE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,kBAAkB,CAAC,iCAAiC,SAAS,EAAE,CAAC,CAAA;IAC5E,CAAC;IAGD,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAA;YAE7D,OAAO;gBACL,UAAU,EAAE,MAAM;gBAClB,IAAI,EAAE,QAAe;gBACrB,MAAM,EAAE,SAAS;gBACjB,QAAQ,EAAE,OAAO;aAClB,CAAA;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,kBAAkB,CAC1B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,oBAAoB,CAC9D,CAAA;QACH,CAAC;IACH,CAAC;IAGD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACnC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,kBAAkB,CAC1B,gEAAgE,CACjE,CAAA;QACH,CAAC;QAED,MAAM,GAAG,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;QACvD,MAAM,GAAG,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;QAEvD,MAAM,eAAe,GAAG,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;QACrD,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;YAC3B,MAAM,IAAI,kBAAkB,CAC1B,eAAe,CAAC,KAAK,IAAI,sBAAsB,CAChD,CAAA;QACH,CAAC;QAED,OAAO;YACL,UAAU,EAAE,QAAQ;YACpB,IAAI,EAAE,QAAe;YACrB,MAAM,EAAE,GAAG;YACX,QAAQ,EAAE,GAAG;SACd,CAAA;IACH,CAAC;IAGD,IAAI,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAA;YAC7C,MAAM,UAAU,GAAG,kBAAkB,CAAC,SAAS,EAAE,QAAe,CAAC,CAAA;YAEjE,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;gBACtB,MAAM,IAAI,kBAAkB,CAAC,UAAU,CAAC,KAAK,IAAI,qBAAqB,CAAC,CAAA;YACzE,CAAC;YAED,OAAO;gBACL,UAAU,EAAE,MAAM;gBAClB,IAAI,EAAE,QAAe;gBACrB,MAAM,EAAE,SAAS;aAClB,CAAA;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,kBAAkB,CAC1B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB,CAC/D,CAAA;QACH,CAAC;IACH,CAAC;IAGD,IAAI,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAA;QAE9C,OAAO;YACL,UAAU,EAAE,QAAQ;YACpB,IAAI,EAAE,QAAe;YACrB,MAAM,EAAE,QAAQ;SACjB,CAAA;IACH,CAAC;IAGD,IAAI,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChC,MAAM,YAAY,GAAG,kCAAkC,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;QAExE,IAAI,YAAY,KAAK,MAAM,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAA;gBAC7C,OAAO;oBACL,UAAU,EAAE,MAAM;oBAClB,IAAI,EAAE,QAAe;oBACrB,MAAM,EAAE,SAAS;iBAClB,CAAA;YACH,CAAC;YAAC,MAAM,CAAC;YAET,CAAC;QACH,CAAC;QAED,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;YACtC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACtB,OAAO;oBACL,UAAU,EAAE,QAAQ;oBACpB,IAAI,EAAE,QAAe;oBACrB,MAAM,EAAE,QAAQ;iBACjB,CAAA;YACH,CAAC;QACH,CAAC;QAGD,OAAO;YACL,UAAU,EAAE,MAAM;YAClB,IAAI,EAAE,QAAe;YACrB,MAAM,EAAE,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE;SAC3E,CAAA;IACH,CAAC;IAGD,OAAO;QACL,UAAU,EAAE,MAAM;QAClB,IAAI,EAAE,QAAe;QACrB,MAAM,EAAE,KAAK,IAAI,EAAE;KACpB,CAAA;AACH,CAAC;AAOD,MAAM,UAAU,qBAAqB,CACnC,YAA6B,EAC7B,MAAmB;IAEnB,MAAM,WAAW,GAAgB,EAAE,CAAA;IAEnC,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC;QACpD,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC;YAAE,SAAQ;QAEnD,IAAI,CAAC;YAEH,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,yBAAyB,CACjE,KAAK,EACL,MAAM,CAAC,WAAW,CACnB,CAAA;YACD,MAAM,WAAW,GAAG,oBAAoB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;YAG1D,IAAI,WAAW,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC;gBACtC,MAAM,cAAc,GAAG,mBAAmB,CACxC,KAAK,EACL,MAAM,EACN,WAAW,CAAC,IAAI,CACjB,CAAA;gBACD,WAAW,CAAC,UAAU,CAAC,GAAG;oBACxB,GAAG,WAAW;oBACd,MAAM,EAAE,cAAc;iBACvB,CAAA;YACH,CAAC;iBAAM,CAAC;gBAEN,WAAW,CAAC,UAAU,CAAC,GAAG,WAAW,CAAA;YACvC,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAEf,MAAM,CAAC,YAAY,EAAE,CAAC,KAAc,CAAC,CAAA;YAErC,SAAQ;QACV,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAA;AACpB,CAAC"}

package/dist/core/serialization/formats.d.ts

@@ -1,12 +1,12 @@
-import type { FilterState, SerializationFormat, FormatSerializer } from '../types.js';
+import type { FilterState, SerializationFormat, FormatSerializer, ParseConfig } from '../types.js';
 /**
  * QueryString format serializer
- * Reuses existing URL generation logic but groups into single parameter
+ * Writes the individual filter parameters as one query string value
  */
 export declare class QueryStringSerializer implements FormatSerializer {
     readonly format: SerializationFormat;
-    serialize(filterState: FilterState): string;
-    deserialize(value: string): FilterState;
+    serialize(filterState: FilterState, config?: ParseConfig): string;
+    deserialize(value: string, config?: ParseConfig): FilterState;
 }
 /**
  * JSON format serializer
@@ -14,8 +14,8 @@ export declare class QueryStringSerializer implements FormatSerializer {
  */
 export declare class JsonSerializer implements FormatSerializer {
     readonly format: SerializationFormat;
-    serialize(filterState: FilterState): string;
-    deserialize(value: string): FilterState;
+    serialize(filterState: FilterState, config?: ParseConfig): string;
+    deserialize(value: string, config?: ParseConfig): FilterState;
 }
 /**
  * Base64 format serializer
@@ -23,7 +23,6 @@ export declare class JsonSerializer implements FormatSerializer {
  */
 export declare class Base64Serializer implements FormatSerializer {
     readonly format: SerializationFormat;
-    private jsonSerializer;
-    serialize(filterState: FilterState): string;
-    deserialize(value: string): FilterState;
+    serialize(filterState: FilterState, config?: ParseConfig): string;
+    deserialize(value: string, config?: ParseConfig): FilterState;
 }

package/dist/core/serialization/formats.js

@@ -1,68 +1,85 @@
-import { DEFAULT_CONFIG } from '../index.js';
-import { generateUrl } from '../url-generator.js';
-import { parseUrlFilters } from '../url-parser.js';
-import { isValidColumnFilter } from '../validation.js';
+import { InvalidSerializationError } from '../types.js';
+import { parseIndividualParams, serializeFilters } from '../individual-params.js';
+import { DEFAULT_CONFIG, isValidColumnFilter, validateFilterValue } from '../validation.js';
+function dropOverLengthTextValues(filterState, config, format) {
+    const cfg = config ?? DEFAULT_CONFIG;
+    const result = {};
+    for (const [column, filter] of Object.entries(filterState)) {
+        if (filter.filterType === 'text') {
+            try {
+                validateFilterValue(filter.filter, cfg, filter.type);
+            }
+            catch (error) {
+                cfg.onParseError?.(new InvalidSerializationError(format, error));
+                continue;
+            }
+        }
+        result[column] = filter;
+    }
+    return result;
+}
+function parseAndValidateJson(value) {
+    try {
+        const parsed = JSON.parse(value);
+        if (typeof parsed !== 'object' || parsed === null) {
+            throw new Error('Invalid JSON: must be an object');
+        }
+        for (const [columnId, filter] of Object.entries(parsed)) {
+            if (!isValidColumnFilter(filter)) {
+                throw new Error(`Invalid JSON: filter for column ${columnId} is not a valid filter object`);
+            }
+        }
+        return parsed;
+    }
+    catch (error) {
+        throw new Error(`JSON parsing failed: ${error.message}`);
+    }
+}
 export class QueryStringSerializer {
     format = 'querystring';
-    serialize(filterState) {
-        const tempConfig = {
-            gridApi: null,
-            ...DEFAULT_CONFIG
-        };
-        const tempUrl = generateUrl('http://example.com', filterState, tempConfig);
-        const urlObj = new URL(tempUrl);
-        return urlObj.search.slice(1);
+    serialize(filterState, config) {
+        return serializeFilters(filterState, innerConfig(config)).toString();
     }
-    deserialize(value) {
-        const tempUrl = `http://example.com?${value}`;
-        const tempConfig = {
-            gridApi: null,
-            ...DEFAULT_CONFIG
-        };
-        return parseUrlFilters(tempUrl, tempConfig);
+    deserialize(value, config) {
+        return parseIndividualParams(new URLSearchParams(value), innerConfig(config));
     }
 }
+function innerConfig(config) {
+    if (!config)
+        return DEFAULT_CONFIG;
+    const onParseError = config.onParseError ?? DEFAULT_CONFIG.onParseError;
+    return {
+        ...DEFAULT_CONFIG,
+        maxValueLength: config.maxValueLength ?? DEFAULT_CONFIG.maxValueLength,
+        onParseError: error => onParseError(new InvalidSerializationError('querystring', error))
+    };
+}
 export class JsonSerializer {
     format = 'json';
-    serialize(filterState) {
-        return JSON.stringify(filterState);
+    serialize(filterState, config) {
+        return JSON.stringify(dropOverLengthTextValues(filterState, config, 'json'));
     }
-    deserialize(value) {
-        try {
-            const parsed = JSON.parse(value);
-            if (typeof parsed !== 'object' || parsed === null) {
-                throw new Error('Invalid JSON: must be an object');
-            }
-            for (const [columnId, filter] of Object.entries(parsed)) {
-                if (typeof columnId !== 'string') {
-                    throw new Error('Invalid JSON: column IDs must be strings');
-                }
-                if (!isValidColumnFilter(filter)) {
-                    throw new Error(`Invalid JSON: filter for column ${columnId} is not a valid filter object`);
-                }
-            }
-            return parsed;
-        }
-        catch (error) {
-            throw new Error(`JSON parsing failed: ${error.message}`);
-        }
+    deserialize(value, config) {
+        return dropOverLengthTextValues(parseAndValidateJson(value), config, 'json');
     }
 }
 export class Base64Serializer {
     format = 'base64';
-    jsonSerializer = new JsonSerializer();
-    serialize(filterState) {
-        const jsonString = this.jsonSerializer.serialize(filterState);
-        return btoa(jsonString);
+    serialize(filterState, config) {
+        const filtered = dropOverLengthTextValues(filterState, config, 'base64');
+        return btoa(escapeNonAscii(JSON.stringify(filtered)));
     }
-    deserialize(value) {
+    deserialize(value, config) {
         try {
             const decoded = atob(value);
-            return this.jsonSerializer.deserialize(decoded);
+            return dropOverLengthTextValues(parseAndValidateJson(decoded), config, 'base64');
         }
         catch (error) {
             throw new Error(`Base64 decoding failed: ${error.message}`);
         }
     }
 }
+function escapeNonAscii(json) {
+    return json.replace(/[\u0080-\uffff]/g, char => `\\u${char.charCodeAt(0).toString(16).padStart(4, '0')}`);
+}
 //# sourceMappingURL=formats.js.map