@internetarchive/collection-browser 0.4.1 → 0.4.3-alpha.1

package/dist/src/restoration-state-handler.d.ts

@@ -1,45 +1,46 @@
-import { SearchType, SortDirection, SortParam } from '@internetarchive/search-service';
-import { CollectionBrowserContext, CollectionDisplayMode, SelectedFacets, SortField } from './models';
-export interface RestorationState {
-    displayMode?: CollectionDisplayMode;
-    searchType?: SearchType;
-    sortParam?: SortParam;
-    selectedSort?: SortField;
-    sortDirection?: SortDirection;
-    selectedFacets: SelectedFacets;
-    baseQuery?: string;
-    currentPage?: number;
-    titleQuery?: string;
-    creatorQuery?: string;
-    minSelectedDate?: string;
-    maxSelectedDate?: string;
-    selectedTitleFilter?: string;
-    selectedCreatorFilter?: string;
-}
-export interface RestorationStateHandlerInterface {
-    persistState(state: RestorationState): void;
-    getRestorationState(): RestorationState;
-}
-export declare class RestorationStateHandler implements RestorationStateHandlerInterface {
-    private context;
-    private cookieDomain;
-    private cookieExpiration;
-    private cookiePath;
-    constructor(options: {
-        context: CollectionBrowserContext;
-    });
-    persistState(state: RestorationState): void;
-    getRestorationState(): RestorationState;
-    private persistViewStateToCookies;
-    private loadTileViewStateFromCookies;
-    private persistQueryStateToUrl;
-    private loadQueryStateFromUrl;
-    private stripQuotes;
-    /**
-     * Sets the facet state for the given field & value to the given state,
-     * creating any previously-undefined buckets as needed.
-     */
-    private setSelectedFacetState;
-    /** Returns a default bucket with the given key, count of 0, and state 'none'. */
-    private getDefaultBucket;
-}
+import { SearchType, SortDirection, SortParam } from '@internetarchive/search-service';
+import { CollectionBrowserContext, CollectionDisplayMode, SelectedFacets, SortField } from './models';
+export interface RestorationState {
+    displayMode?: CollectionDisplayMode;
+    searchType?: SearchType;
+    sortParam?: SortParam;
+    selectedSort?: SortField;
+    sortDirection?: SortDirection;
+    selectedFacets: SelectedFacets;
+    baseQuery?: string;
+    currentPage?: number;
+    titleQuery?: string;
+    creatorQuery?: string;
+    minSelectedDate?: string;
+    maxSelectedDate?: string;
+    selectedTitleFilter?: string;
+    selectedCreatorFilter?: string;
+}
+export interface RestorationStateHandlerInterface {
+    persistState(state: RestorationState): void;
+    getRestorationState(): RestorationState;
+}
+export declare class RestorationStateHandler implements RestorationStateHandlerInterface {
+    private context;
+    private cookieDomain;
+    private cookieExpiration;
+    private cookiePath;
+    constructor(options: {
+        context: CollectionBrowserContext;
+    });
+    persistState(state: RestorationState): void;
+    getRestorationState(): RestorationState;
+    private persistViewStateToCookies;
+    private loadTileViewStateFromCookies;
+    private persistQueryStateToUrl;
+    private loadQueryStateFromUrl;
+    private stripQuotes;
+    private selectedFacetStatesEqual;
+    /**
+     * Sets the facet state for the given field & value to the given state,
+     * creating any previously-undefined buckets as needed.
+     */
+    private setSelectedFacetState;
+    /** Returns a default bucket with the given key, count of 0, and state 'none'. */
+    private getDefaultBucket;
+}

package/dist/src/restoration-state-handler.js

@@ -1,231 +1,270 @@
-import { SearchType, } from '@internetarchive/search-service';
-import { getCookie, setCookie } from 'typescript-cookie';
-import { MetadataFieldToSortField, } from './models';
-export class RestorationStateHandler {
-    constructor(options) {
-        this.cookieDomain = '.archive.org';
-        this.cookieExpiration = 30;
-        this.cookiePath = '/';
-        this.context = options.context;
-    }
-    persistState(state) {
-        if (state.displayMode)
-            this.persistViewStateToCookies(state.displayMode);
-        this.persistQueryStateToUrl(state);
-    }
-    getRestorationState() {
-        const restorationState = this.loadQueryStateFromUrl();
-        const displayMode = this.loadTileViewStateFromCookies();
-        restorationState.displayMode = displayMode;
-        return restorationState;
-    }
-    persistViewStateToCookies(displayMode) {
-        const gridState = displayMode === 'grid' ? 'tiles' : 'lists';
-        setCookie(`view-${this.context}`, gridState, {
-            domain: this.cookieDomain,
-            expires: this.cookieExpiration,
-            path: this.cookiePath,
-        });
-        const detailsState = displayMode === 'list-detail' ? 'showdetails' : '';
-        setCookie(`showdetails-${this.context}`, detailsState, {
-            domain: this.cookieDomain,
-            expires: this.cookieExpiration,
-            path: this.cookiePath,
-        });
-    }
-    loadTileViewStateFromCookies() {
-        const viewState = getCookie(`view-${this.context}`);
-        const detailsState = getCookie(`showdetails-${this.context}`);
-        if (viewState === 'tiles' || viewState === undefined)
-            return 'grid';
-        if (detailsState === 'showdetails')
-            return 'list-detail';
-        return 'list-compact';
-    }
-    persistQueryStateToUrl(state) {
-        const url = new URL(window.location.href);
-        const { searchParams } = url;
-        searchParams.delete('sin');
-        searchParams.delete('sort');
-        searchParams.delete('query');
-        searchParams.delete('page');
-        searchParams.delete('and[]');
-        searchParams.delete('not[]');
-        if (state.searchType) {
-            searchParams.set('sin', state.searchType === SearchType.FULLTEXT ? 'TXT' : '');
-        }
-        if (state.sortParam) {
-            const prefix = state.sortParam.direction === 'desc' ? '-' : '';
-            searchParams.set('sort', `${prefix}${state.sortParam.field}`);
-        }
-        if (state.baseQuery) {
-            searchParams.set('query', state.baseQuery);
-        }
-        if (state.currentPage) {
-            if (state.currentPage > 1) {
-                searchParams.set('page', state.currentPage.toString());
-            }
-            else {
-                searchParams.delete('page');
-            }
-        }
-        if (state.selectedFacets) {
-            for (const [facetName, facetValues] of Object.entries(state.selectedFacets)) {
-                const facetEntries = Object.entries(facetValues);
-                // eslint-disable-next-line no-continue
-                if (facetEntries.length === 0)
-                    continue;
-                for (const [key, data] of facetEntries) {
-                    const notValue = data.state === 'hidden';
-                    const paramValue = `${facetName}:"${key}"`;
-                    if (notValue) {
-                        searchParams.append('not[]', paramValue);
-                    }
-                    else {
-                        searchParams.append('and[]', paramValue);
-                    }
-                }
-            }
-        }
-        if (state.minSelectedDate && state.maxSelectedDate) {
-            searchParams.append('and[]', `year:[${state.minSelectedDate} TO ${state.maxSelectedDate}]`);
-        }
-        if (state.titleQuery) {
-            searchParams.append('and[]', state.titleQuery);
-        }
-        if (state.creatorQuery) {
-            searchParams.append('and[]', state.creatorQuery);
-        }
-        window.history.pushState({
-            sort: state.sortParam,
-            query: state.baseQuery,
-            page: state.currentPage,
-            and: state.selectedFacets,
-            not: state.selectedFacets,
-            minDate: state.minSelectedDate,
-            maxDate: state.maxSelectedDate,
-        }, '', url);
-    }
-    loadQueryStateFromUrl() {
-        const url = new URL(window.location.href);
-        const searchInside = url.searchParams.get('sin');
-        const pageNumber = url.searchParams.get('page');
-        const searchQuery = url.searchParams.get('query');
-        const sortQuery = url.searchParams.get('sort');
-        const facetAnds = url.searchParams.getAll('and[]');
-        const facetNots = url.searchParams.getAll('not[]');
-        const restorationState = {
-            selectedFacets: {
-                subject: {},
-                lending: {},
-                creator: {},
-                mediatype: {},
-                language: {},
-                collection: {},
-                year: {},
-            },
-        };
-        if (searchInside) {
-            restorationState.searchType =
-                searchInside === 'TXT' ? SearchType.FULLTEXT : SearchType.METADATA;
-        }
-        if (pageNumber) {
-            const parsed = parseInt(pageNumber, 10);
-            restorationState.currentPage = parsed;
-        }
-        else {
-            restorationState.currentPage = 1;
-        }
-        if (searchQuery) {
-            restorationState.baseQuery = searchQuery;
-        }
-        if (sortQuery) {
-            // check for two different sort formats: `date desc` and `-date`
-            const hasSpace = sortQuery.indexOf(' ') > -1;
-            if (hasSpace) {
-                const [field, direction] = sortQuery.split(' ');
-                const metadataField = MetadataFieldToSortField[field];
-                if (metadataField) {
-                    restorationState.selectedSort = metadataField;
-                }
-                if (direction === 'desc' || direction === 'asc') {
-                    restorationState.sortDirection = direction;
-                }
-            }
-            else {
-                const sortDirection = sortQuery.startsWith('-') ? 'desc' : 'asc';
-                const sortField = sortQuery.startsWith('-')
-                    ? sortQuery.slice(1)
-                    : sortQuery;
-                const metadataField = MetadataFieldToSortField[sortField];
-                if (metadataField)
-                    restorationState.selectedSort = metadataField;
-                restorationState.sortDirection = sortDirection;
-            }
-        }
-        if (facetAnds) {
-            facetAnds.forEach(and => {
-                const [field, value] = and.split(':');
-                switch (field) {
-                    case 'year': {
-                        const [minDate, maxDate] = value.split(' TO ');
-                        // we have two potential ways of filtering by date:
-                        // the range with "date TO date" or the single date with "date"
-                        // this is checking for the range case and if we don't have those, fall
-                        // back to the single date case
-                        if (minDate && maxDate) {
-                            restorationState.minSelectedDate = minDate.substring(1, minDate.length);
-                            restorationState.maxSelectedDate = maxDate.substring(0, maxDate.length - 1);
-                        }
-                        else {
-                            this.setSelectedFacetState(restorationState.selectedFacets, field, value, 'selected');
-                        }
-                        break;
-                    }
-                    case 'firstTitle':
-                        restorationState.selectedTitleFilter = value;
-                        break;
-                    case 'firstCreator':
-                        restorationState.selectedCreatorFilter = value;
-                        break;
-                    default:
-                        this.setSelectedFacetState(restorationState.selectedFacets, field, value, 'selected');
-                }
-            });
-        }
-        if (facetNots) {
-            facetNots.forEach(not => {
-                const [field, value] = not.split(':');
-                this.setSelectedFacetState(restorationState.selectedFacets, field, value, 'hidden');
-            });
-        }
-        return restorationState;
-    }
-    // remove optional opening and closing quotes from a string
-    stripQuotes(value) {
-        if (value.startsWith('"') && value.endsWith('"')) {
-            return value.substring(1, value.length - 1);
-        }
-        return value;
-    }
-    /**
-     * Sets the facet state for the given field & value to the given state,
-     * creating any previously-undefined buckets as needed.
-     */
-    setSelectedFacetState(selectedFacets, field, value, state) {
-        var _a;
-        const facet = selectedFacets[field];
-        const unQuotedValue = this.stripQuotes(value);
-        (_a = facet[unQuotedValue]) !== null && _a !== void 0 ? _a : (facet[unQuotedValue] = this.getDefaultBucket(value));
-        facet[unQuotedValue].state = state;
-    }
-    /** Returns a default bucket with the given key, count of 0, and state 'none'. */
-    getDefaultBucket(key) {
-        return {
-            key,
-            count: 0,
-            state: 'none',
-        };
-    }
-}
+import { SearchType, } from '@internetarchive/search-service';
+import { getCookie, setCookie } from 'typescript-cookie';
+import { MetadataFieldToSortField, } from './models';
+export class RestorationStateHandler {
+    constructor(options) {
+        this.cookieDomain = '.archive.org';
+        this.cookieExpiration = 30;
+        this.cookiePath = '/';
+        this.context = options.context;
+    }
+    persistState(state) {
+        if (state.displayMode)
+            this.persistViewStateToCookies(state.displayMode);
+        this.persistQueryStateToUrl(state);
+    }
+    getRestorationState() {
+        const restorationState = this.loadQueryStateFromUrl();
+        const displayMode = this.loadTileViewStateFromCookies();
+        restorationState.displayMode = displayMode;
+        return restorationState;
+    }
+    persistViewStateToCookies(displayMode) {
+        const gridState = displayMode === 'grid' ? 'tiles' : 'lists';
+        setCookie(`view-${this.context}`, gridState, {
+            domain: this.cookieDomain,
+            expires: this.cookieExpiration,
+            path: this.cookiePath,
+        });
+        const detailsState = displayMode === 'list-detail' ? 'showdetails' : '';
+        setCookie(`showdetails-${this.context}`, detailsState, {
+            domain: this.cookieDomain,
+            expires: this.cookieExpiration,
+            path: this.cookiePath,
+        });
+    }
+    loadTileViewStateFromCookies() {
+        const viewState = getCookie(`view-${this.context}`);
+        const detailsState = getCookie(`showdetails-${this.context}`);
+        if (viewState === 'tiles' || viewState === undefined)
+            return 'grid';
+        if (detailsState === 'showdetails')
+            return 'list-detail';
+        return 'list-compact';
+    }
+    persistQueryStateToUrl(state) {
+        var _a, _b, _c, _d;
+        console.log('persistQueryStateToUrl', state);
+        const url = new URL(window.location.href);
+        const { searchParams } = url;
+        searchParams.delete('sin');
+        searchParams.delete('sort');
+        searchParams.delete('query');
+        searchParams.delete('page');
+        searchParams.delete('and[]');
+        searchParams.delete('not[]');
+        if (state.baseQuery) {
+            searchParams.set('query', state.baseQuery);
+        }
+        if (state.searchType) {
+            searchParams.set('sin', state.searchType === SearchType.FULLTEXT ? 'TXT' : '');
+        }
+        if (state.currentPage) {
+            if (state.currentPage > 1) {
+                searchParams.set('page', state.currentPage.toString());
+            }
+            else {
+                searchParams.delete('page');
+            }
+        }
+        if (state.sortParam) {
+            const prefix = state.sortParam.direction === 'desc' ? '-' : '';
+            searchParams.set('sort', `${prefix}${state.sortParam.field}`);
+        }
+        if (state.selectedFacets) {
+            for (const [facetName, facetValues] of Object.entries(state.selectedFacets)) {
+                const facetEntries = Object.entries(facetValues);
+                // eslint-disable-next-line no-continue
+                if (facetEntries.length === 0)
+                    continue;
+                for (const [key, data] of facetEntries) {
+                    const notValue = data.state === 'hidden';
+                    const paramValue = `${facetName}:"${key}"`;
+                    if (notValue) {
+                        searchParams.append('not[]', paramValue);
+                    }
+                    else {
+                        searchParams.append('and[]', paramValue);
+                    }
+                }
+            }
+        }
+        if (state.minSelectedDate && state.maxSelectedDate) {
+            searchParams.append('and[]', `year:[${state.minSelectedDate} TO ${state.maxSelectedDate}]`);
+        }
+        if (state.titleQuery) {
+            searchParams.append('and[]', state.titleQuery);
+        }
+        if (state.creatorQuery) {
+            searchParams.append('and[]', state.creatorQuery);
+        }
+        // Ensure we aren't pushing an identical state to the stack
+        const prevState = window.history.state;
+        if (prevState &&
+            prevState.query === state.baseQuery &&
+            prevState.searchType === state.searchType &&
+            prevState.page === state.currentPage &&
+            ((_a = prevState.sort) === null || _a === void 0 ? void 0 : _a.field) === ((_b = state.sortParam) === null || _b === void 0 ? void 0 : _b.field) &&
+            ((_c = prevState.sort) === null || _c === void 0 ? void 0 : _c.direction) === ((_d = state.sortParam) === null || _d === void 0 ? void 0 : _d.direction) &&
+            prevState.minDate === state.minSelectedDate &&
+            prevState.maxDate === state.maxSelectedDate &&
+            this.selectedFacetStatesEqual(prevState.facets, state.selectedFacets)) {
+            console.log('Ignoring identical history state');
+            return;
+        }
+        window.history.pushState({
+            query: state.baseQuery,
+            searchType: state.searchType,
+            page: state.currentPage,
+            sort: state.sortParam,
+            minDate: state.minSelectedDate,
+            maxDate: state.maxSelectedDate,
+            facets: state.selectedFacets,
+        }, '', url);
+    }
+    loadQueryStateFromUrl() {
+        console.log('loadQueryStateFromUrl', window.location.href);
+        const url = new URL(window.location.href);
+        const searchInside = url.searchParams.get('sin');
+        const pageNumber = url.searchParams.get('page');
+        const searchQuery = url.searchParams.get('query');
+        const sortQuery = url.searchParams.get('sort');
+        const facetAnds = url.searchParams.getAll('and[]');
+        const facetNots = url.searchParams.getAll('not[]');
+        const restorationState = {
+            selectedFacets: {
+                subject: {},
+                lending: {},
+                creator: {},
+                mediatype: {},
+                language: {},
+                collection: {},
+                year: {},
+            },
+        };
+        if (searchInside) {
+            restorationState.searchType =
+                searchInside === 'TXT' ? SearchType.FULLTEXT : SearchType.METADATA;
+        }
+        if (pageNumber) {
+            const parsed = parseInt(pageNumber, 10);
+            restorationState.currentPage = parsed;
+        }
+        else {
+            restorationState.currentPage = 1;
+        }
+        if (searchQuery) {
+            restorationState.baseQuery = searchQuery;
+        }
+        if (sortQuery) {
+            // check for two different sort formats: `date desc` and `-date`
+            const hasSpace = sortQuery.indexOf(' ') > -1;
+            if (hasSpace) {
+                const [field, direction] = sortQuery.split(' ');
+                const metadataField = MetadataFieldToSortField[field];
+                if (metadataField) {
+                    restorationState.selectedSort = metadataField;
+                }
+                if (direction === 'desc' || direction === 'asc') {
+                    restorationState.sortDirection = direction;
+                }
+            }
+            else {
+                const sortDirection = sortQuery.startsWith('-') ? 'desc' : 'asc';
+                const sortField = sortQuery.startsWith('-')
+                    ? sortQuery.slice(1)
+                    : sortQuery;
+                const metadataField = MetadataFieldToSortField[sortField];
+                if (metadataField)
+                    restorationState.selectedSort = metadataField;
+                restorationState.sortDirection = sortDirection;
+            }
+        }
+        if (facetAnds) {
+            facetAnds.forEach(and => {
+                const [field, value] = and.split(':');
+                switch (field) {
+                    case 'year': {
+                        const [minDate, maxDate] = value.split(' TO ');
+                        // we have two potential ways of filtering by date:
+                        // the range with "date TO date" or the single date with "date"
+                        // this is checking for the range case and if we don't have those, fall
+                        // back to the single date case
+                        if (minDate && maxDate) {
+                            restorationState.minSelectedDate = minDate.substring(1, minDate.length);
+                            restorationState.maxSelectedDate = maxDate.substring(0, maxDate.length - 1);
+                        }
+                        else {
+                            this.setSelectedFacetState(restorationState.selectedFacets, field, value, 'selected');
+                        }
+                        break;
+                    }
+                    case 'firstTitle':
+                        restorationState.selectedTitleFilter = value;
+                        break;
+                    case 'firstCreator':
+                        restorationState.selectedCreatorFilter = value;
+                        break;
+                    default:
+                        this.setSelectedFacetState(restorationState.selectedFacets, field, value, 'selected');
+                }
+            });
+        }
+        if (facetNots) {
+            facetNots.forEach(not => {
+                const [field, value] = not.split(':');
+                this.setSelectedFacetState(restorationState.selectedFacets, field, value, 'hidden');
+            });
+        }
+        return restorationState;
+    }
+    // remove optional opening and closing quotes from a string
+    stripQuotes(value) {
+        if (value.startsWith('"') && value.endsWith('"')) {
+            return value.substring(1, value.length - 1);
+        }
+        return value;
+    }
+    selectedFacetStatesEqual(facets1, facets2) {
+        var _a;
+        if (facets1 === facets2)
+            return true;
+        // We can assume they both have the same top-level entries (the allowable facet fields)
+        for (const [key, values] of Object.entries(facets1)) {
+            const facetField = key;
+            // They must have the same number of bucket entries for each field
+            const bucketEntries1 = Object.entries(values);
+            const bucketEntries2 = Object.entries(facets2[facetField]);
+            if (bucketEntries1.length !== bucketEntries2.length)
+                return false;
+            // And since they have the same length, we just ensure every bucket state from the
+            // first object matches a corresponding bucket state in the second object.
+            // If the corresponding bucket doesn't exist or has a different state, we're done.
+            for (const [value, bucket] of bucketEntries1) {
+                if (bucket.state !== ((_a = facets2[facetField][value]) === null || _a === void 0 ? void 0 : _a.state))
+                    return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Sets the facet state for the given field & value to the given state,
+     * creating any previously-undefined buckets as needed.
+     */
+    setSelectedFacetState(selectedFacets, field, value, state) {
+        var _a;
+        const facet = selectedFacets[field];
+        const unQuotedValue = this.stripQuotes(value);
+        (_a = facet[unQuotedValue]) !== null && _a !== void 0 ? _a : (facet[unQuotedValue] = this.getDefaultBucket(value));
+        facet[unQuotedValue].state = state;
+    }
+    /** Returns a default bucket with the given key, count of 0, and state 'none'. */
+    getDefaultBucket(key) {
+        return {
+            key,
+            count: 0,
+            state: 'none',
+        };
+    }
+}
 //# sourceMappingURL=restoration-state-handler.js.map