ag-grid-url-sync 0.3.0 → 0.5.0

package/dist/core/validation.js

@@ -1,7 +1,4 @@
 import { InvalidFilterError, InvalidDateError, TEXT_FILTER_OPERATIONS, NUMBER_FILTER_OPERATIONS, DATE_FILTER_OPERATIONS } from './types.js';
-/**
- * Default configuration values
- */
 export const DEFAULT_CONFIG = {
     paramPrefix: 'f_',
     maxValueLength: 200,
@@ -10,17 +7,7 @@ export const DEFAULT_CONFIG = {
     format: 'querystring',
     onParseError: () => { }
 };
-/**
- * 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 '';
     }
@@ -29,30 +16,15 @@ export function validateFilterValue(value, config, operation) {
     }
     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)
@@ -68,19 +40,11 @@ export function validateNumberRange(min, max) {
     }
     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) {
     const trimmedValue = value?.trim();
     if (!trimmedValue) {
         throw new InvalidFilterError('Number filter value cannot be empty');
     }
-    // Use a regex to validate proper number format before parsing
-    // This prevents parseFloat from accepting partial numbers like "42abc" -> 42
     const numberRegex = /^[+-]?(\d+\.?\d*|\.\d+)([eE][+-]?\d+)?$/;
     if (!numberRegex.test(trimmedValue)) {
         throw new InvalidFilterError(`Invalid number format: ${value}`);
@@ -95,30 +59,19 @@ export function validateAndParseNumber(value) {
     }
     return numValue;
 }
-/**
- * Validates and parses a date string in ISO format (YYYY-MM-DD)
- *
- * @param value - String representation of date in ISO format
- * @returns Validated ISO date string
- * @throws InvalidDateError if date format is invalid or date doesn't exist
- */
 export function validateAndParseDate(value) {
     const trimmedValue = value?.trim();
     if (!trimmedValue) {
         throw new InvalidDateError('Date filter value cannot be empty');
     }
-    // Validate ISO date format (YYYY-MM-DD)
     const isoDateRegex = /^\d{4}-\d{2}-\d{2}$/;
     if (!isoDateRegex.test(trimmedValue)) {
         throw new InvalidDateError(`Invalid date format '${value}'. Expected ISO format YYYY-MM-DD (e.g., 2024-01-15)`);
     }
-    // Validate that it's a real date by parsing
-    const date = new Date(trimmedValue + 'T00:00:00.000Z'); // Force UTC to avoid timezone issues
+    const date = new Date(trimmedValue + 'T00:00:00.000Z');
     if (isNaN(date.getTime())) {
         throw new InvalidDateError(`Invalid date '${value}'. Date does not exist in the calendar`);
     }
-    // Additional validation: ensure the parsed date matches the input
-    // This catches edge cases like February 30th that might parse differently
     const [year, month, day] = trimmedValue.split('-').map(Number);
     if (date.getUTCFullYear() !== year ||
         date.getUTCMonth() + 1 !== month ||
@@ -127,15 +80,7 @@ export function validateAndParseDate(value) {
     }
     return trimmedValue;
 }
-/**
- * Validates a date filter value
- *
- * @param value - The date value to validate
- * @param operation - The date filter operation
- * @returns Validation result
- */
 export function validateDateFilter(value, operation) {
-    // Blank operations don't require date validation
     if (operation === 'blank' || operation === 'notBlank') {
         return { valid: true };
     }
@@ -150,18 +95,10 @@ export function validateDateFilter(value, operation) {
         };
     }
 }
-/**
- * Validates a date range filter
- *
- * @param startDate - The start date (ISO format)
- * @param endDate - The end date (ISO format)
- * @returns Validation result
- */
 export function validateDateRange(startDate, endDate) {
     try {
         const validStartDate = validateAndParseDate(startDate);
         const validEndDate = validateAndParseDate(endDate);
-        // Check that start date <= end date
         if (validStartDate > validEndDate) {
             return {
                 valid: false,
@@ -177,12 +114,6 @@ export function validateDateRange(startDate, endDate) {
         };
     }
 }
-/**
- * Validates a date range from comma-separated string input
- *
- * @param rangeValue - Comma-separated date range (e.g., "2024-01-01,2024-12-31")
- * @returns Tuple of [startDate, endDate] or throws InvalidDateError
- */
 export function validateAndParseDateRange(rangeValue) {
     const trimmedValue = rangeValue?.trim();
     if (!trimmedValue) {
@@ -200,25 +131,17 @@ export function validateAndParseDateRange(rangeValue) {
     }
     return [startDate, endDate];
 }
-/**
- * Validates if an object is a valid column filter
- *
- * @param obj - The object to validate
- * @returns Type guard that narrows the type to ColumnFilter
- */
 export function isValidColumnFilter(obj) {
     if (!obj || typeof obj !== 'object') {
         return false;
     }
     const filter = obj;
-    // Check for required properties
     if (!filter.filterType ||
         !filter.type ||
         typeof filter.filterType !== 'string' ||
         typeof filter.type !== 'string') {
         return false;
     }
-    // Validate based on filter type
     if (filter.filterType === 'text') {
         return (typeof filter.filter === 'string' &&
             TEXT_FILTER_OPERATIONS.includes(filter.type));

package/dist/core/validation.js.map

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

package/dist/core/view-storage.d.ts

@@ -0,0 +1,63 @@
+import type { FilterModel } from 'ag-grid-community';
+/**
+ * A saved snapshot of a grid's filters.
+ */
+export interface GridView {
+    /** Stable generated id */
+    id: string;
+    /** User-supplied display name */
+    name: string;
+    /** Epoch millis of the last write */
+    updatedAt: number;
+    /** AG Grid's native filter model, stored as-is */
+    filterModel: FilterModel;
+}
+/**
+ * Read/write access to one grid's saved views.
+ */
+export interface ViewStore {
+    /** All saved views, in save order */
+    listViews(): GridView[];
+    /** Id of the active view, or null */
+    getActiveViewId(): string | null;
+    /**
+     * Records which view is active.
+     *
+     * Named `persist…` rather than `set…` so it cannot be mistaken for a React
+     * state setter: this writes storage and triggers no re-render.
+     *
+     * Writing the value the pointer already holds is a no-op, so callers need not
+     * check first and a redundant call cannot fail on blocked storage.
+     */
+    persistActiveViewId(id: string | null): void;
+    /**
+     * Saves a filter model under a name and makes it active.
+     *
+     * Names are unique and matched exactly after trimming, so saving over an
+     * existing name updates that view in place, keeping its id and its position
+     * in the list, rather than adding a duplicate label. That is what gives
+     * "load, adjust, re-save" its update semantics without a separate method.
+     *
+     * A null or undefined filterModel is stored as an empty model, since that is
+     * what AG Grid means by it and what getFilterModel returns in practice.
+     *
+     * @throws when the name is empty, or when the write fails: storage full,
+     *   blocked by policy, or no DOM present
+     */
+    saveView(name: string, filterModel: FilterModel): GridView;
+    /**
+     * Deletes a view, clearing the active id if it pointed at that view.
+     *
+     * Deleting an id that is not stored is a no-op, so it cannot fail on blocked
+     * storage.
+     */
+    deleteView(id: string): void;
+}
+/**
+ * Creates a store bound to one storage key.
+ *
+ * All reads degrade to an empty store rather than throwing: storage may be
+ * absent (SSR), blocked by policy, or hold a corrupt or foreign blob. Writes do
+ * throw, so callers can tell the user a view wasn't saved.
+ */
+export declare function createViewStore(storageKey: string): ViewStore;

package/dist/core/view-storage.js

@@ -0,0 +1,112 @@
+const SCHEMA_VERSION = 'v1';
+const keyFor = (storageKey) => `ag-grid-url-sync:views:${SCHEMA_VERSION}:${storageKey}`;
+const empty = () => ({ views: [], activeId: null });
+function isGridView(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const candidate = value;
+    return (typeof candidate.id === 'string' &&
+        typeof candidate.name === 'string' &&
+        typeof candidate.updatedAt === 'number' &&
+        typeof candidate.filterModel === 'object' &&
+        candidate.filterModel !== null);
+}
+function createId() {
+    if (typeof crypto !== 'undefined' && 'randomUUID' in crypto) {
+        return crypto.randomUUID();
+    }
+    return `view-${Date.now()}-${Math.floor(Math.random() * 1e6)}`;
+}
+export function createViewStore(storageKey) {
+    const key = keyFor(storageKey);
+    const read = () => {
+        if (typeof window === 'undefined')
+            return empty();
+        let raw = null;
+        try {
+            raw = window.localStorage.getItem(key);
+        }
+        catch {
+            return empty();
+        }
+        if (!raw)
+            return empty();
+        try {
+            const parsed = JSON.parse(raw);
+            if (typeof parsed !== 'object' || parsed === null)
+                return empty();
+            const { views, activeId } = parsed;
+            const validViews = Array.isArray(views) ? views.filter(isGridView) : [];
+            return {
+                views: validViews,
+                activeId: typeof activeId === 'string' &&
+                    validViews.some(view => view.id === activeId)
+                    ? activeId
+                    : null
+            };
+        }
+        catch {
+            return empty();
+        }
+    };
+    const write = (next) => {
+        if (typeof window === 'undefined') {
+            throw new Error('Browser storage is unavailable.');
+        }
+        try {
+            window.localStorage.setItem(key, JSON.stringify(next));
+        }
+        catch (error) {
+            const isQuota = typeof DOMException !== 'undefined' &&
+                error instanceof DOMException &&
+                (error.name === 'QuotaExceededError' ||
+                    error.name === 'NS_ERROR_DOM_QUOTA_REACHED');
+            throw new Error(isQuota
+                ? 'Browser storage is full. Delete a saved view and try again.'
+                : 'Error writing to storage.', { cause: error });
+        }
+    };
+    return {
+        listViews: () => read().views,
+        getActiveViewId: () => read().activeId,
+        persistActiveViewId: (id) => {
+            const current = read();
+            if (current.activeId === id)
+                return;
+            write({ ...current, activeId: id });
+        },
+        saveView: (name, filterModel) => {
+            const trimmedName = name.trim();
+            if (!trimmedName) {
+                throw new Error('A view name is required.');
+            }
+            const current = read();
+            const existing = current.views.find(view => view.name === trimmedName);
+            const view = {
+                id: existing?.id ?? createId(),
+                name: trimmedName,
+                updatedAt: Date.now(),
+                filterModel: structuredClone(filterModel ?? {})
+            };
+            write({
+                views: existing
+                    ? current.views.map(candidate => candidate.id === existing.id ? view : candidate)
+                    : [...current.views, view],
+                activeId: view.id
+            });
+            return view;
+        },
+        deleteView: (id) => {
+            const current = read();
+            const views = current.views.filter(view => view.id !== id);
+            if (views.length === current.views.length && current.activeId !== id) {
+                return;
+            }
+            write({
+                views,
+                activeId: current.activeId === id ? null : current.activeId
+            });
+        }
+    };
+}
+//# sourceMappingURL=view-storage.js.map

package/dist/core/view-storage.js.map

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

package/dist/index.d.ts

@@ -4,5 +4,6 @@ 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';
+export type { GridView, ViewStore } from './core/view-storage.js';
 export { serializeGrouped, deserializeGrouped, detectGroupedSerialization, getAvailableFormats, getFormatSerializer } from './core/serialization/grouped.js';
 export { QueryStringSerializer, JsonSerializer, Base64Serializer } from './core/serialization/formats.js';

package/dist/index.js

@@ -1,15 +1,9 @@
-// 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';
-// Grouped serialization utilities
 export { serializeGrouped, deserializeGrouped, detectGroupedSerialization, getAvailableFormats, getFormatSerializer } from './core/serialization/grouped.js';
 export { QueryStringSerializer, JsonSerializer, Base64Serializer } from './core/serialization/formats.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,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;AAE7E,kCAAkC;AAClC,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,0BAA0B,EAC1B,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,iCAAiC,CAAA;AAExC,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EACjB,MAAM,iCAAiC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAEzE,cAAc,iBAAiB,CAAA;AAG/B,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAG1E,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAGxE,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAGvE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAS7E,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,0BAA0B,EAC1B,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,iCAAiC,CAAA;AAExC,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EACjB,MAAM,iCAAiC,CAAA"}

package/dist/react/index.d.ts

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

package/dist/react/types.d.ts

@@ -1,15 +1,41 @@
 import type { AGGridUrlSyncConfig, FilterState, SerializationFormat, SerializationMode } from '../core/types.js';
+import type { GridView } from '../core/view-storage.js';
 /**
  * Configuration options for the React hook
  */
 export interface UseAGGridUrlSyncOptions extends AGGridUrlSyncConfig {
+    /**
+     * Enables saved views, persisted to localStorage under this key.
+     *
+     * The key both switches the feature on and namespaces the storage, so two
+     * grids on the same origin must use different keys. Omit it and the view
+     * members of the hook's return value are inert.
+     *
+     * @example 'employee-grid'
+     */
+    storageKey?: string;
     /**
      * Automatically apply URL filters when the component mounts and grid API becomes ready
+     *
+     * Also restores the active saved view when `storageKey` is set. URL filters
+     * take precedence: a shared link should show the sender's filters rather than
+     * the recipient's stored view.
+     *
+     * Attempted once per grid. A failed attempt is reported through `onError` and
+     * `onParseError` and is not retried on later renders; pass a new `gridApi`, or
+     * call `applyUrlFilters`, to try again.
+     *
      * Default: false
      */
     autoApplyOnMount?: boolean;
     /**
      * Whether the hook should be enabled when the grid API is ready
+     *
+     * Set to false and every operation goes inert, saved views included: no URL is
+     * generated, no filters are applied, and no view is saved, loaded or deleted.
+     * `views` still reflects what is in storage, since reading it has no effect on
+     * the grid.
+     *
      * Default: true
      */
     enabledWhenReady?: boolean;
@@ -52,7 +78,13 @@ export interface UseAGGridUrlSyncReturn {
      */
     currentUrl: string;
     /**
-     * Whether the grid has any active text filters
+     * Whether the grid has filters that the library supports.
+     *
+     * Comes from the grid's filter state, not from the URL, because the URL also
+     * keeps the page's own params. A filter that the URL cannot carry (for
+     * example a text value over `maxValueLength`) still counts, so a "clear
+     * filters" button stays enabled. The URL leaves that filter out and reports
+     * it through `onParseError`.
      */
     hasFilters: boolean;
     /**
@@ -77,4 +109,74 @@ export interface UseAGGridUrlSyncReturn {
      * @returns The current format
      */
     getCurrentFormat: () => SerializationMode;
+    /**
+     * Saved views for this grid, in save order.
+     * Always an empty array when `storageKey` is not set.
+     */
+    views: GridView[];
+    /**
+     * Id of the view currently applied to the grid, or null when none is.
+     *
+     * This describes the live grid, not what is persisted. A stored view is only
+     * applied on mount when `autoApplyOnMount` is set, so with it off this stays
+     * null until `loadView` or `saveView` is called, even though a previous
+     * session's view is still listed in `views`.
+     *
+     * It goes back to null as soon as the grid stops showing that view, which
+     * includes routes that never mention views: `clearFilters`, `applyFilters`,
+     * `applyUrlFilters`, and the user editing a filter in the grid's own UI. That
+     * also clears the stored pointer, so `autoApplyOnMount` will not restore the
+     * view on the next load either - filtering away from a view is treated as
+     * leaving it, not as a detour back to it.
+     *
+     * "Showing" means the model the grid reported once the view was applied, not
+     * the stored one. A view AG Grid normalises on the way in, such as one naming
+     * a column the grid no longer has, stays loaded and keeps its stored pointer.
+     * A write AG Grid defers is recognised when it lands by the event's
+     * `source: 'api'`. On versions that report no source, a deferred view the
+     * grid also normalises unloads when it lands.
+     *
+     * Replacing `gridApi` clears this too, since nothing has been applied to the
+     * new grid yet, but leaves the stored pointer alone: with `autoApplyOnMount`
+     * the view is restored against the new grid and this becomes non-null again.
+     */
+    activeViewId: string | null;
+    /**
+     * Saves the grid's current filters under a name and makes it active.
+     *
+     * The name is trimmed, and must not be empty. Names are unique: saving over an
+     * existing name updates that view in place, keeping its id and list position,
+     * so "load a view, adjust the filters, save under the same name" is how you
+     * update one.
+     *
+     * @param name - Display name for the view
+     * @returns The saved view, or null if it could not be saved. An empty name, a
+     *   failed write, and being called before the grid is ready are all reported
+     *   through `onError`. Silent when `storageKey` is not set or the hook is
+     *   disabled, since the feature was switched off by configuration rather than
+     *   having failed.
+     */
+    saveView: (name: string) => GridView | null;
+    /**
+     * Applies a saved view's filters to the grid, or clears filters when passed
+     * null. Use `clearFilters` to reset filters independently of saved views.
+     *
+     * Silent when `storageKey` is not set or the hook is disabled; reports through
+     * `onError` when called before the grid is ready, or when the id is not found.
+     *
+     * @param id - Id of the view to load, or null to reset to unfiltered
+     */
+    loadView: (id: string | null) => void;
+    /**
+     * Deletes a saved view. Clears the grid's filters only if the grid still shows
+     * exactly that view's filters, so hand-edited filters survive.
+     *
+     * Unlike `saveView` and `loadView`, this does not need the grid: it works
+     * before the grid API resolves, since deleting only touches storage, so it
+     * never reports a not-ready error. Silent when `storageKey` is not set or the
+     * hook is disabled.
+     *
+     * @param id - Id of the view to delete
+     */
+    deleteView: (id: string) => void;
 }