@fluid-topics/ft-reader-context 2.2.17 → 2.2.19

package/build/store/FtReaderStateManager.d.ts

@@ -3,7 +3,7 @@ import { ClusteringHelper, Optional } from "@fluid-topics/ft-wc-utils";
 import { FtReaderReduxStore } from "./redux";
 import type { FtReaderService } from "./utils/FtReaderService";
 import { FtAnalyticsEventsService } from "@fluid-topics/ft-app-context";
-import { FtTranslationLocale, FtTranslationSettings } from "@fluid-topics/public-api";
+import { FtMetadataFilter, FtTranslationLocale, FtTranslationSettings } from "@fluid-topics/public-api";
 export declare class FtReaderStateManager {
     store: FtReaderReduxStore;
     private clusteringHelperProvider?;
@@ -20,8 +20,10 @@ export declare class FtReaderStateManager {
     setMapId(mapId?: string): Promise<void>;
     setRenderedTopics(tocIds: string[]): void;
     setVisibleTopics(tocIds: string[]): void;
+    setFilters(filters: FtMetadataFilter[]): Promise<void>;
     awaitService(): Promise<FtReaderService>;
     navigateToTopic(tocId?: string, section?: string, pageNumber?: number): Promise<void>;
+    private resolvePage;
     private resolveValidNonRootTocId;
     navigateToPage(pageNumber: number): Promise<void>;
     scrollDone(): void;
@@ -29,6 +31,9 @@ export declare class FtReaderStateManager {
     load(): Promise<void>;
     clear(): void;
     reload(): Promise<void>;
+    clearFromFilter(): void;
+    reloadFromFilter(section?: string, page?: number): Promise<void>;
+    private fetchDataFromFilter;
     private fetchData;
     private loadConfiguration;
     reloadConfiguration(): Promise<{

package/build/store/FtReaderStateManager.js

@@ -1,5 +1,5 @@
-import { FtReaderStoreEvents, } from "./model";
-import { accessResultUrl, CanceledPromiseError, ClusteringHelper, Debouncer, waitFor, waitUntil, } from "@fluid-topics/ft-wc-utils";
+import { FtReaderStoreEvents, FtRequestedTopicFilteredEvent, } from "./model";
+import { accessResultUrl, CanceledPromiseError, ClusteringHelper, Debouncer, deepEqual, waitFor, waitUntil, } from "@fluid-topics/ft-wc-utils";
 import { createReaderStore, } from "./redux";
 import { FtOfficialReaderService } from "./utils/FtOfficialReaderService";
 import { FtAnalyticsEventsService, ftAppInfoStore, } from "@fluid-topics/ft-app-context";
@@ -23,7 +23,9 @@ export class FtReaderStateManager {
     }
     async initService(serviceProvider) {
         this.service = await serviceProvider();
-        this.service.mapId = this.store.getState().mapId;
+        const { mapId, metadataFilters } = this.store.getState();
+        this.service.mapId = mapId;
+        this.service.metadataFilters = metadataFilters;
         return this.reload();
     }
     async setMapId(mapId) {
@@ -41,15 +43,20 @@ export class FtReaderStateManager {
     setVisibleTopics(tocIds) {
         this.store.actions.visibleTopics(tocIds);
     }
+    async setFilters(filters) {
+        if (!deepEqual(filters, this.store.getState().metadataFilters)) {
+            this.store.actions.metadataFilters(filters);
+            if (this.service) {
+                this.service.metadataFilters = filters;
+            }
+        }
+    }
     async awaitService() {
         return waitFor(() => this.service);
     }
     async navigateToTopic(tocId, section, pageNumber) {
         await this.loaded();
-        const service = await this.awaitService();
-        const page = await (pageNumber != null
-            ? service.getPage(pageNumber, this.getTranslationSettings())
-            : service.getPageByTocId(tocId !== null && tocId !== void 0 ? tocId : "root", this.getTranslationSettings()));
+        const page = await this.resolvePage(tocId, pageNumber);
         this.store.actions.currentPage(page);
         const nonRootTocId = this.resolveValidNonRootTocId(tocId, page);
         this.store.actions.scrollTarget({ tocId: nonRootTocId, section });
@@ -62,16 +69,45 @@ export class FtReaderStateManager {
             this.store.commands.add({ type: `focus-topic-${tocId}` });
         }
     }
+    async resolvePage(tocId, pageNumber) {
+        var _a;
+        var _b;
+        const service = await this.awaitService();
+        if (pageNumber) {
+            return service.getPage(pageNumber, this.getTranslationSettings());
+        }
+        if (!tocId) {
+            return service.getPageByTocId("root", this.getTranslationSettings());
+        }
+        const maybeFilteredTopic = this.store.getState().filteredTocNodes[tocId];
+        const nodeIsInToc = ((_a = this.service) === null || _a === void 0 ? void 0 : _a.getTocNodeNow(tocId)) != null;
+        if (maybeFilteredTopic && maybeFilteredTopic.reason !== "ACCESS_RIGHTS_FILTER" && !nodeIsInToc) {
+            return service.getPageByTocId((_b = maybeFilteredTopic.closestParent) !== null && _b !== void 0 ? _b : "root", this.getTranslationSettings());
+        }
+        return service.getPageByTocId(tocId, this.getTranslationSettings());
+    }
     resolveValidNonRootTocId(tocId, page) {
-        var _a, _b, _c;
-        const nonRootTocId = (_a = (tocId === "root" ? undefined : tocId)) !== null && _a !== void 0 ? _a : page.rootTocId;
+        var _a;
+        var _b, _c, _d, _e;
+        const nonRootTocId = (_b = (tocId === "root" ? undefined : tocId)) !== null && _b !== void 0 ? _b : page.rootTocId;
         if (!page.topics.includes(nonRootTocId)) {
             if (tocId != "root" && !page.hiddenTopics.includes(nonRootTocId)) {
                 // The redirection is expected when tocId = root or when landing from an "only in toc" topic, don't send the event.
                 // Pass the requested tocId as event detail so consumers can probe access rights.
-                this.store.dispatchEvent(new CustomEvent(FtReaderStoreEvents.requestedTopicNotFound, { detail: { tocId: nonRootTocId } }));
+                const maybeFilteredTopic = this.store.getState().filteredTocNodes[nonRootTocId];
+                if (maybeFilteredTopic) {
+                    this.store.dispatchEvent(new FtRequestedTopicFilteredEvent(maybeFilteredTopic));
+                    const nodeIsInToc = ((_a = this.service) === null || _a === void 0 ? void 0 : _a.getTocNodeNow(maybeFilteredTopic.tocId)) != null;
+                    if (maybeFilteredTopic.reason === "ACCESS_RIGHTS_FILTER" || nodeIsInToc) {
+                        return maybeFilteredTopic.tocId;
+                    }
+                    else {
+                        return (_c = maybeFilteredTopic.closestParent) !== null && _c !== void 0 ? _c : "root";
+                    }
+                }
+                this.store.dispatchEvent(new CustomEvent(FtReaderStoreEvents.requestedTopicNotFound));
             }
-            return (_c = (_b = page.topics[0]) !== null && _b !== void 0 ? _b : page.hiddenTopics[0]) !== null && _c !== void 0 ? _c : "root";
+            return (_e = (_d = page.topics[0]) !== null && _d !== void 0 ? _d : page.hiddenTopics[0]) !== null && _e !== void 0 ? _e : "root";
         }
         return nonRootTocId;
     }
@@ -87,7 +123,7 @@ export class FtReaderStateManager {
     async load() {
         var _a;
         if (((_a = this.service) === null || _a === void 0 ? void 0 : _a.mapId) && this.store.getState().map == null) {
-            await this.loadDebouncer.run(() => this.fetchData(this.getTranslationSettings()));
+            await this.loadDebouncer.run(() => this.fetchData());
         }
     }
     clear() {
@@ -117,25 +153,55 @@ export class FtReaderStateManager {
         this.clear();
         return this.load();
     }
-    async fetchData(translationSettings) {
-        var _a, _b, _c, _d, _e;
+    clearFromFilter() {
+        this._loaded = false;
+        this.store.actions.toc(undefined);
+        this.store.actions.pagesToc(undefined);
+    }
+    async reloadFromFilter(section, page) {
+        var _a, _b, _c;
+        this.clearFromFilter();
+        const { scrollTarget, visibleTopics, currentPage } = this.store.getState();
+        const tocId = (_c = (_b = (_a = scrollTarget === null || scrollTarget === void 0 ? void 0 : scrollTarget.tocId) !== null && _a !== void 0 ? _a : visibleTopics === null || visibleTopics === void 0 ? void 0 : visibleTopics[0]) !== null && _b !== void 0 ? _b : currentPage === null || currentPage === void 0 ? void 0 : currentPage.rootTocId) !== null && _c !== void 0 ? _c : "root";
+        await this.fetchDataFromFilter();
+        this.navigateToTopic(tocId, section, page);
+    }
+    async fetchDataFromFilter() {
+        var _a, _b, _c, _d;
+        const translationSettings = this.getTranslationSettings();
         try {
-            if (translationSettings) {
-                this.setTranslationLoading(true);
-            }
-            const handleTranslationError = (e) => {
+            await Promise.all([
+                (_a = this.service) === null || _a === void 0 ? void 0 : _a.getToc(translationSettings).then((toc) => this.store.actions.toc(toc)),
+                (_b = this.service) === null || _b === void 0 ? void 0 : _b.getPagesToc(translationSettings).then((pagesToc) => this.store.actions.pagesToc(pagesToc)),
+                (_c = this.service) === null || _c === void 0 ? void 0 : _c.getFilteredTocNodes(translationSettings).then((filteredTocNodes) => this.store.actions.filteredTocNodes(filteredTocNodes)),
+            ]);
+            this._loaded = true;
+        }
+        catch (e) {
+            if (!(e instanceof CanceledPromiseError)) {
                 if (translationSettings) {
                     this.setTranslationError(true);
                 }
+                (_d = this.errorHandler) === null || _d === void 0 ? void 0 : _d.call(this, e);
                 throw e;
-            };
+            }
+        }
+    }
+    async fetchData() {
+        var _a, _b, _c, _d, _e, _f, _g;
+        const translationSettings = this.getTranslationSettings();
+        try {
+            if (translationSettings) {
+                this.setTranslationLoading(true);
+            }
             await Promise.all([
                 this.loadConfiguration(),
-                (_a = this.service) === null || _a === void 0 ? void 0 : _a.getMap(translationSettings).then((map) => this.store.actions.map(map)).catch(handleTranslationError),
-                (_b = this.service) === null || _b === void 0 ? void 0 : _b.getToc(translationSettings).then((toc) => this.store.actions.toc(toc)).catch(handleTranslationError),
-                (_c = this.service) === null || _c === void 0 ? void 0 : _c.getPagesToc(translationSettings).then((pagesToc) => this.store.actions.pagesToc(pagesToc)).catch(handleTranslationError),
-                (_d = this.service) === null || _d === void 0 ? void 0 : _d.getPaginationConfiguration().then((conf) => this.store.actions.paginationConfiguration(conf)).catch(handleTranslationError),
-                (_e = this.service) === null || _e === void 0 ? void 0 : _e.getTranslationError(translationSettings).then((translationError) => this.setTranslationError(translationError)),
+                (_a = this.service) === null || _a === void 0 ? void 0 : _a.getMap(translationSettings).then((map) => this.store.actions.map(map)),
+                (_b = this.service) === null || _b === void 0 ? void 0 : _b.getToc(translationSettings).then((toc) => this.store.actions.toc(toc)),
+                (_c = this.service) === null || _c === void 0 ? void 0 : _c.getPagesToc(translationSettings).then((pagesToc) => this.store.actions.pagesToc(pagesToc)),
+                (_d = this.service) === null || _d === void 0 ? void 0 : _d.getPaginationConfiguration().then((conf) => this.store.actions.paginationConfiguration(conf)),
+                (_e = this.service) === null || _e === void 0 ? void 0 : _e.getFilteredTocNodes(translationSettings).then((filteredTocNodes) => this.store.actions.filteredTocNodes(filteredTocNodes)),
+                (_f = this.service) === null || _f === void 0 ? void 0 : _f.getTranslationError(translationSettings).then((translationError) => this.setTranslationError(translationError)),
             ]);
             if (this.metadataForSwitchToRelatives.size > 0) {
                 this.fetchRelatives();
@@ -146,8 +212,12 @@ export class FtReaderStateManager {
             }
         }
         catch (e) {
-            if (this.errorHandler && !(e instanceof CanceledPromiseError)) {
-                this.errorHandler(e);
+            if (!(e instanceof CanceledPromiseError)) {
+                if (translationSettings) {
+                    this.setTranslationError(true);
+                }
+                (_g = this.errorHandler) === null || _g === void 0 ? void 0 : _g.call(this, e);
+                throw e;
             }
         }
     }
@@ -177,7 +247,8 @@ export class FtReaderStateManager {
         }
     }
     createClusteringHelper() {
-        var _a, _b;
+        var _a;
+        var _b;
         if (this.clusteringHelperProvider) {
             return this.clusteringHelperProvider();
         }
@@ -214,11 +285,11 @@ export class FtReaderStateManager {
         if (destinationLanguage) {
             this.sendDocumentOnDemandTranslateEvent(destinationLanguage);
         }
-        await this.loadDebouncer.run(() => this.fetchData(this.getTranslationSettings()));
+        await this.loadDebouncer.run(() => this.fetchData());
     }
     async setTranslationSourceLanguage(sourceLanguage) {
         this.store.actions.setTranslationSourceLanguage(sourceLanguage);
-        await this.loadDebouncer.run(() => this.fetchData(this.getTranslationSettings()));
+        await this.loadDebouncer.run(() => this.fetchData());
     }
     async setTranslationProfileId(profileId) {
         this.store.actions.setTranslationProfileId(profileId);
@@ -265,7 +336,8 @@ export class FtReaderStateManager {
         this.metadataForSwitchToRelatives.delete(id);
         this.updateClusteringHelper();
     }
-    getAccurateNavigationData(tocId, currentPage, oldScrollTarget) {
+    async getAccurateNavigationData(tocId, currentPage, oldScrollTarget) {
+        await this.awaitService();
         return this.service.getAccurateNavigationData(tocId, currentPage === null || currentPage === void 0 ? void 0 : currentPage.number, oldScrollTarget === null || oldScrollTarget === void 0 ? void 0 : oldScrollTarget.section, this.getTranslationSettings());
     }
     buildBreadcrumb(tocId) {
@@ -300,17 +372,18 @@ export class FtReaderStateManager {
         this.store.dispatchEvent(new Event(FtReaderStoreEvents.mapAttachmentsUpdate));
     }
     async getRelativeDocumentUrlForLocale(uiLocale) {
-        var _a, _b, _c;
+        var _a, _b;
+        var _c;
         if (this.store.getState().relatives == undefined) {
             await this.fetchRelatives();
         }
-        const maybeRelativeResultMap = ClusteringHelper.findResultWithMetadataValue((_a = this.store.getState().relatives) !== null && _a !== void 0 ? _a : [], "ft:locale", uiLocale);
+        const maybeRelativeResultMap = ClusteringHelper.findResultWithMetadataValue((_c = this.store.getState().relatives) !== null && _c !== void 0 ? _c : [], "ft:locale", uiLocale);
         let targetUrl = accessResultUrl(maybeRelativeResultMap);
         if (targetUrl) {
             const currentTocId = this.store.getState().visibleTopics[0];
-            const metadataKey = (_b = this.store.getState().configuration) === null || _b === void 0 ? void 0 : _b.relativeTopicPivotMetadata;
+            const metadataKey = (_a = this.store.getState().configuration) === null || _a === void 0 ? void 0 : _a.relativeTopicPivotMetadata;
             if (metadataKey && currentTocId) {
-                const maybePivot = await ((_c = this.service) === null || _c === void 0 ? void 0 : _c.getTopicMetadataValue(currentTocId, metadataKey));
+                const maybePivot = await ((_b = this.service) === null || _b === void 0 ? void 0 : _b.getTopicMetadataValue(currentTocId, metadataKey));
                 targetUrl = addPivotQueryParam(targetUrl, maybePivot);
             }
         }
@@ -376,13 +449,10 @@ export class FtReaderStateManager {
                 appVersion: apiIntegrationAppVersion,
                 sourceLanguage: this.parseLanguageToAnalyticsFormat(map.lang),
                 destinationLanguage: this.parseLanguageToAnalyticsFormat(destinationLanguage),
-                breadcrumb: breadcrumb.map((item) => {
-                    var _a;
-                    return ({
-                        tocId: item.tocId,
-                        title: (_a = item.untranslatedTitle) !== null && _a !== void 0 ? _a : item.title,
-                    });
-                }),
+                breadcrumb: breadcrumb.map((item) => { var _a; return ({
+                    tocId: item.tocId,
+                    title: (_a = item.untranslatedTitle) !== null && _a !== void 0 ? _a : item.title,
+                }); }),
                 document: documentWithOriginalTitle,
                 profileId,
             });

package/build/store/model.d.ts

@@ -1,10 +1,14 @@
-import { FtMap, FtPaginationConfiguration, FtPublicationRatingSummary, FtRatingType, FtRatingTypeKeys, FtReaderConfiguration, FtSearchResultClusterEntry, FtSession, FtTocNode, FtTopic, FtTopicRating, FtTranslationLocale } from "@fluid-topics/public-api";
+import { FtMap, FtMetadataFilter, FtPaginationConfiguration, FtPublicationRatingSummary, FtRatingType, FtRatingTypeKeys, FtReaderConfiguration, FtSearchResultClusterEntry, FtSession, FtTocNode, FtTocNodeFiltered, FtTopic, FtTopicRating, FtTranslationLocale } from "@fluid-topics/public-api";
 import { Optional } from "@fluid-topics/ft-wc-utils";
 export declare enum FtReaderStoreEvents {
     clusteringHelperCreated = "clustering-helper-created",
     mapAttachmentsUpdate = "map-attachments-update",
     visibleTopicChange = "visible-topic-change",
-    requestedTopicNotFound = "requested-topic-not-found"
+    requestedTopicNotFound = "requested-topic-not-found",
+    requestedTopicFiltered = "requested-topic-filtered"
+}
+export declare class FtRequestedTopicFilteredEvent extends CustomEvent<FtTocNodeFiltered> {
+    constructor(filteredNode: FtTocNodeFiltered);
 }
 export interface FtPagesTocNode {
     depth: number;
@@ -44,6 +48,7 @@ export interface FtReaderState {
     toc: Optional<Array<FtReaderTocNode>>;
     pagesToc: Optional<Array<FtPagesTocNode>>;
     paginationConfiguration: Optional<FtPaginationConfiguration>;
+    filteredTocNodes: Record<string, FtTocNodeFiltered>;
     currentPage: Optional<FtReaderPage>;
     scrollTarget: Optional<FtReaderScrollTarget>;
     renderedTopics: string[];
@@ -63,6 +68,7 @@ export interface FtReaderState {
         isError: boolean;
     };
     linkPreviewDialogId: Optional<string>;
+    metadataFilters: Array<FtMetadataFilter>;
 }
 export interface FtReaderNavigationData {
     mapId: string;
@@ -73,6 +79,7 @@ export interface FtReaderNavigationData {
     page?: number;
     prettyUrl?: string;
     prettyUrlDuplicated: boolean;
+    metadataFilters?: Array<FtMetadataFilter>;
 }
 export interface FtTopicRatingSummary {
     rating?: FtTopicRating;

package/build/store/model.js

@@ -4,7 +4,13 @@ export var FtReaderStoreEvents;
     FtReaderStoreEvents["mapAttachmentsUpdate"] = "map-attachments-update";
     FtReaderStoreEvents["visibleTopicChange"] = "visible-topic-change";
     FtReaderStoreEvents["requestedTopicNotFound"] = "requested-topic-not-found";
+    FtReaderStoreEvents["requestedTopicFiltered"] = "requested-topic-filtered";
 })(FtReaderStoreEvents || (FtReaderStoreEvents = {}));
+export class FtRequestedTopicFilteredEvent extends CustomEvent {
+    constructor(filteredNode) {
+        super(FtReaderStoreEvents.requestedTopicFiltered, { detail: filteredNode });
+    }
+}
 export var FtReaderFeatures;
 (function (FtReaderFeatures) {
     FtReaderFeatures["FEEDBACK"] = "FEEDBACK";

package/build/store/redux.js

@@ -30,6 +30,7 @@ export const createReaderStore = (id) => FtReduxStore.get({
         map: undefined,
         toc: undefined,
         pagesToc: undefined,
+        filteredTocNodes: {},
         paginationConfiguration: undefined,
         currentPage: undefined,
         scrollTarget: undefined,
@@ -46,6 +47,7 @@ export const createReaderStore = (id) => FtReduxStore.get({
             isError: false,
         },
         linkPreviewDialogId: undefined,
+        metadataFilters: [],
     },
     reducers: readerStoreStateReducers,
 });

package/build/store/utils/FtOfficialReaderService.d.ts

@@ -1,4 +1,4 @@
-import type { FtMap, FtMapAttachment, FtPaginatedToc, FtRatingSummary, FtRatingType, FtRatingTypeKeys, FtSearchResults, FtTocNode, FtTopic, FtTranslationContent, FtTranslationSettings } from "@fluid-topics/public-api";
+import type { FtMap, FtMapAttachment, FtMetadataFilter, FtPaginatedToc, FtRatingSummary, FtRatingType, FtRatingTypeKeys, FtSearchResults, FtTocNode, FtTopic, FtTranslationContent, FtTranslationSettings } from "@fluid-topics/public-api";
 import { FtReaderService } from "./FtReaderService";
 import { FtReaderFeatures } from "../model";
 export declare class FtOfficialReaderService extends FtReaderService {
@@ -7,7 +7,7 @@ export declare class FtOfficialReaderService extends FtReaderService {
     clear(): void;
     protected fetchMap(mapId: string, translationSettings?: FtTranslationSettings): Promise<FtMap>;
     protected fetchMapRating(mapId: string): Promise<FtRatingSummary>;
-    protected fetchPages(mapId: string, translationSettings?: FtTranslationSettings): Promise<FtPaginatedToc>;
+    protected fetchPages(mapId: string, metadataFilters?: FtMetadataFilter[], translationSettings?: FtTranslationSettings): Promise<FtPaginatedToc>;
     protected fetchTopicHTMLContent(tocNode: FtTocNode): Promise<string>;
     protected fetchTranslatedTopicHTMLContent(tocNode: FtTocNode, translationSettings: FtTranslationSettings): Promise<FtTranslationContent>;
     protected fetchTopicMetadata(tocNode: FtTocNode): Promise<FtTopic>;

package/build/store/utils/FtOfficialReaderService.js

@@ -16,9 +16,11 @@ export class FtOfficialReaderService extends FtReaderService {
     fetchMapRating(mapId) {
         return this.api.getMapRating(mapId);
     }
-    async fetchPages(mapId, translationSettings) {
+    async fetchPages(mapId, metadataFilters, translationSettings) {
         await this.getMap(translationSettings);
-        return this.api.getPages(mapId, this.fingerprint, translationSettings);
+        return (metadataFilters === null || metadataFilters === void 0 ? void 0 : metadataFilters.length)
+            ? this.api.getFilteredPages(mapId, translationSettings, metadataFilters)
+            : this.api.getPages(mapId, this.fingerprint, translationSettings);
     }
     fetchTopicHTMLContent(tocNode) {
         return this.api.getTopicHTMLContent(this.mapId, tocNode.contentId, "DESIGNED_READER", this.fingerprint);

package/build/store/utils/FtReaderConverter.d.ts

@@ -1,4 +1,4 @@
-import { FtPaginatedToc, FtPaginationConfiguration } from "@fluid-topics/public-api";
+import { FtPaginatedToc, FtPaginationConfiguration, FtTocNodeFiltered } from "@fluid-topics/public-api";
 import { FtPagesTocNode, FtReaderPage, FtReaderTocNode } from "../model";
 export type EnrichedToc = {
     paginationConfiguration: FtPaginationConfiguration;
@@ -10,6 +10,7 @@ export type EnrichedToc = {
     pages: Array<FtReaderPage>;
     pageByTocId: Record<string, FtReaderPage>;
     translationError: boolean;
+    filteredTocNodes: Record<string, FtTocNodeFiltered>;
 };
 export declare class FtReaderConverter {
     convertPaginatedToc(mapId: string, paginatedToc: FtPaginatedToc): EnrichedToc;

package/build/store/utils/FtReaderConverter.js

@@ -19,6 +19,7 @@ class EnrichedTocBuilder {
             pages: this.pages,
             pageByTocId: this.pageByTocId,
             translationError: this.paginatedToc.translationError,
+            filteredTocNodes: this.paginatedToc.filteredTocNodes,
         };
     }
     extractPagesToc(nodes, depth, parentTocId) {
@@ -45,14 +46,15 @@ class EnrichedTocBuilder {
     }
     convertNodes(nodes, depth, parentTocId) {
         return nodes.flatMap((node) => {
-            var _a, _b, _c;
+            var _a;
+            var _b, _c;
             if (node.tocId == null) {
                 return [
-                    ...this.convertSectionNodes((_a = node.pageToc) !== null && _a !== void 0 ? _a : [], depth, node.tocId),
+                    ...this.convertSectionNodes((_b = node.pageToc) !== null && _b !== void 0 ? _b : [], depth, node.tocId),
                     ...this.convertNodes(node.children, depth, node.tocId),
                 ];
             }
-            const prettyUrl = (_b = node.prettyUrl) === null || _b === void 0 ? void 0 : _b.replace(/^\//, "");
+            const prettyUrl = (_a = node.prettyUrl) === null || _a === void 0 ? void 0 : _a.replace(/^\//, "");
             const enrichedNode = {
                 tocId: node.tocId,
                 contentId: node.contentId,
@@ -94,21 +96,22 @@ class EnrichedTocBuilder {
         });
     }
     buildPage(node, parentTocId) {
-        var _a, _b, _c, _d, _e, _f, _g, _h;
-        const rootTocId = (_a = node.tocId) !== null && _a !== void 0 ? _a : (_c = (_b = node.pageToc) === null || _b === void 0 ? void 0 : _b[0]) === null || _c === void 0 ? void 0 : _c.tocId;
+        var _a, _b, _c;
+        var _d, _e, _f, _g, _h;
+        const rootTocId = (_d = node.tocId) !== null && _d !== void 0 ? _d : (_b = (_a = node.pageToc) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.tocId;
         const page = {
             number: this.pages.length + 1,
-            title: (_d = node.title) !== null && _d !== void 0 ? _d : "",
+            title: (_e = node.title) !== null && _e !== void 0 ? _e : "",
             untranslatedTitle: node.untranslatedTitle,
             rootTocId: rootTocId !== null && rootTocId !== void 0 ? rootTocId : "root",
-            toc: ((_e = node.pageToc) !== null && _e !== void 0 ? _e : []).map((n) => this.nodeByTocId[n.tocId]),
+            toc: ((_f = node.pageToc) !== null && _f !== void 0 ? _f : []).map((n) => this.nodeByTocId[n.tocId]),
             topics: [],
             hiddenTopics: [],
             rootDepth: rootTocId ? this.nodeByTocId[rootTocId].depth : 1,
             breadcrumb: parentTocId ? this.buildBreadcrumb(this.nodeByTocId[parentTocId]) : [],
         };
         const add = (tocId, visible) => (visible ? page.topics : page.hiddenTopics).push(tocId);
-        const parentsVisibility = (_g = (_f = node.pageConfiguration) === null || _f === void 0 ? void 0 : _f.parentsVisibility) !== null && _g !== void 0 ? _g : [];
+        const parentsVisibility = (_g = (_c = node.pageConfiguration) === null || _c === void 0 ? void 0 : _c.parentsVisibility) !== null && _g !== void 0 ? _g : [];
         page.breadcrumb.forEach((tocId, index) => {
             add(tocId, parentsVisibility[index]);
         });

package/build/store/utils/FtReaderService.d.ts

@@ -1,4 +1,4 @@
-import type { FluidTopicsApi, FtMap, FtMapAttachment, FtMetadata, FtPaginatedToc, FtPaginationConfiguration, FtPublicationRatingSummary, FtRatingSummary, FtRatingTypeKeys, FtReaderConfiguration, FtTocNode, FtTopic, FtTranslationContent, FtTranslationSettings } from "@fluid-topics/public-api";
+import type { FluidTopicsApi, FtMap, FtMapAttachment, FtMetadata, FtMetadataFilter, FtPaginatedToc, FtPaginationConfiguration, FtPublicationRatingSummary, FtRatingSummary, FtRatingTypeKeys, FtReaderConfiguration, FtTocNode, FtTocNodeFiltered, FtTopic, FtTranslationContent, FtTranslationSettings } from "@fluid-topics/public-api";
 import { FtRatingType, FtSearchResults } from "@fluid-topics/public-api";
 import { FtPagesTocNode, FtReaderFeatureAccessData, FtReaderFeatures, FtReaderNavigationData, FtReaderPage, FtReaderTocNode, FtTopicRatingSummary } from "../model";
 import { FtReaderConverter } from "./FtReaderConverter";
@@ -7,7 +7,7 @@ import { FtReaderBreadcrumb } from "../../models";
 export declare abstract class FtReaderService extends FtServiceWithCache {
     protected converter: FtReaderConverter;
     protected abstract fetchMap(mapId: string, translationSettings?: FtTranslationSettings): Promise<FtMap>;
-    protected abstract fetchPages(mapId: string, translationSettings?: FtTranslationSettings): Promise<FtPaginatedToc>;
+    protected abstract fetchPages(mapId: string, metadataFilters?: FtMetadataFilter[], translationSettings?: FtTranslationSettings): Promise<FtPaginatedToc>;
     protected abstract fetchMapRating(mapId: string): Promise<FtRatingSummary>;
     protected abstract fetchTopicMetadata(tocNode: FtTocNode): Promise<FtTopic>;
     protected abstract fetchTopicHTMLContent(tocNode: FtTocNode): Promise<string>;
@@ -24,9 +24,12 @@ export declare abstract class FtReaderService extends FtServiceWithCache {
     protected abstract getReaderLinkPrefix(): string;
     protected abstract isFeatureAvailable(feature: FtReaderFeatures): boolean;
     private _mapId;
+    private _metadataFilters;
+    get metadataFilters(): FtMetadataFilter[];
+    set metadataFilters(value: FtMetadataFilter[] | undefined);
     get mapId(): string;
     set mapId(value: string | undefined);
-    constructor(converter: FtReaderConverter, overrideApi?: FluidTopicsApi, mapId?: string);
+    constructor(converter: FtReaderConverter, overrideApi?: FluidTopicsApi, mapId?: string, metadataFilters?: FtMetadataFilter[]);
     private withMapId;
     private initCache;
     clear(): void;
@@ -41,6 +44,7 @@ export declare abstract class FtReaderService extends FtServiceWithCache {
     getToc(translationSettings?: FtTranslationSettings): Promise<Array<FtReaderTocNode>>;
     getPagesToc(translationSettings?: FtTranslationSettings): Promise<Array<FtPagesTocNode>>;
     getTranslationError(translationSettings?: FtTranslationSettings): Promise<boolean>;
+    getFilteredTocNodes(translationSettings?: FtTranslationSettings): Promise<Record<string, FtTocNodeFiltered>>;
     getTocNode(tocId: string, translationSettings?: FtTranslationSettings): Promise<FtReaderTocNode>;
     getTocNodeNow(tocId: string, translationInput?: FtTranslationSettings): FtReaderTocNode | undefined;
     getTocNodeNowByUrl(prettyUrlOrMapIdTocId: string, translationInput?: FtTranslationSettings): FtReaderTocNode | undefined;
@@ -55,7 +59,8 @@ export declare abstract class FtReaderService extends FtServiceWithCache {
     getRelativesForDocument(metadataPivotKey: string, metadataPivotValues: string[]): Promise<FtSearchResults>;
     getRelativesForTopicInMap(mapId: string, metadataPivotKey: string, metadataPivotValues: string[]): Promise<FtSearchResults>;
     getAttachmentDownloadLink(id: string): string;
-    getLink(tocId?: string, pageNumber?: number, section?: string): string;
+    getLink(tocId?: string, pageNumber?: number, section?: string, withMetadataFilter?: boolean): string;
+    getLinkWithFilter(tocId?: string, pageNumber?: number, section?: string): string;
     getNavigationData(tocId?: string, pageNumber?: number, section?: string, translationInput?: FtTranslationSettings): FtReaderNavigationData;
     getAccurateNavigationData(tocId?: string, pageNumber?: number, section?: string, translationInput?: FtTranslationSettings): Promise<FtReaderNavigationData>;
     private getRatingSummary;