@fluid-topics/public-api 1.0.75 → 1.0.76

package/build/mjs/index.js

@@ -1,432 +0,0 @@
-import fetch from "cross-fetch";
-import { GenAIChunkReader } from "./helpers/GenAIChunkReader";
-const wnd = (typeof window === "undefined" ? globalThis : window);
-export * from "./types/ft-common/public";
-export * from "./types/ft-server/public";
-export * from "./roles/roles";
-export * from "./preferences/unauthenticated-preferences";
-function toBase64(s) {
-    return typeof Buffer !== "undefined" ? Buffer.from(s).toString("base64") : btoa(s);
-}
-export class HttpError extends Error {
-    method;
-    endpoint;
-    status;
-    statusText;
-    body;
-    constructor(method, endpoint, status, statusText, body) {
-        super(`${method} ${endpoint} -> ${status} - ${statusText}: ${body}`);
-        this.method = method;
-        this.endpoint = endpoint;
-        this.status = status;
-        this.statusText = statusText;
-        this.body = body;
-    }
-}
-export class HttpErrorEvent extends CustomEvent {
-    constructor(e) {
-        super("ft-api-http-error", { detail: e });
-    }
-}
-async function handleError(method, endpoint, response) {
-    if (!response.ok) {
-        let details = {
-            method,
-            endpoint,
-            status: response.status,
-            statusText: response.statusText,
-            body: await response.text()
-        };
-        if (typeof wnd.dispatchEvent === "function") {
-            wnd.dispatchEvent(new HttpErrorEvent(details));
-        }
-        throw new HttpError(details.method, details.endpoint, details.status, details.statusText, details.body);
-    }
-    return response;
-}
-function getBody(response) {
-    return response.headers.get("Content-Type") === "application/json" ? response.json() : response.text();
-}
-export class FluidTopicsApi {
-    tenantBaseUrl;
-    tenantBaseUrlNoTrailingSlash;
-    ftCallingApp;
-    authorization;
-    searchLabel;
-    endpoints = {
-        authentication: {
-            login: `api/authentication/login`,
-            logout: `api/authentication/logout`,
-            currentSession: `api/authentication/current-session`,
-        },
-        khub: {
-            maps: {
-                mapId: (mapId) => ({
-                    info: `api/khub/maps/${mapId}`,
-                    toc: `api/khub/maps/${mapId}/toc`,
-                    pages: `api/khub/maps/${mapId}/pages`,
-                    feedback: `api/khub/maps/${mapId}/feedback`,
-                    rating: `api/khub/maps/${mapId}/rating`,
-                    attachments: {
-                        list: `api/khub/maps/${mapId}/attachments`,
-                        attachmentId: (attachmentId) => ({
-                            content: `api/khub/maps/${mapId}/attachments/${attachmentId}/content`,
-                        })
-                    },
-                    resources: {
-                        list: `api/khub/maps/${mapId}/resources`,
-                        resourceId: (resourceId) => ({
-                            content: `api/khub/maps/${mapId}/resources/${resourceId}/content`,
-                        })
-                    },
-                    topics: {
-                        contentId: (contentId) => ({
-                            info: `api/khub/maps/${mapId}/topics/${contentId}`,
-                            content: `api/khub/maps/${mapId}/topics/${contentId}/content`,
-                        }),
-                        tocId: (tocId) => ({
-                            feedback: `api/khub/maps/${mapId}/topics/${tocId}/feedback`,
-                            rating: `api/khub/maps/${mapId}/topics/${tocId}/rating`,
-                        })
-                    },
-                })
-            },
-            documents: {
-                documentId: (documentId) => ({
-                    info: `api/khub/documents/${documentId}`,
-                    content: `api/khub/documents/${documentId}/content`,
-                    text: `api/khub/documents/${documentId}/content/text`,
-                    feedback: `api/khub/documents/${documentId}/feedback`,
-                    rating: `api/khub/documents/${documentId}/rating`,
-                })
-            },
-            semantic: {
-                search: `api/khub/semantic/search`,
-                clusteredSearch: `api/khub/semantic/clustered-search`
-            },
-            suggest: `api/khub/suggest`,
-            clusteredSearch: `api/khub/clustered-search`,
-            locales: `api/khub/locales`,
-        },
-        users: {
-            userId: (userId) => ({
-                collections: {
-                    collectionId: (collectionId) => ({
-                        documents: `api/users/${userId}/collections/${collectionId}/documents`,
-                    })
-                },
-                searches: {
-                    list: `api/users/${userId}/searches`
-                },
-                bookmarks: {
-                    list: `api/users/${userId}/bookmarks`
-                }
-            }),
-        },
-        stylesheets: {
-            fonts: `stylesheets/fonts.css`,
-            theme: `stylesheets/theme.css`,
-            content: {
-                title: `stylesheets/content/title.css`,
-                topic: `stylesheets/content/topic.css`,
-            },
-        },
-        configuration: {
-            reader: `api/configuration/reader`,
-            metadata: `api/configuration/metadata`
-        },
-        locales: {
-            ui: `api/locales/ui`
-        },
-        messages: {
-            locale: (locale) => ({
-                fluidTopics: {
-                    contextName: (contextName) => ({
-                        endpoint: `api/messages/${locale}/fluid-topics/${contextName}`,
-                    })
-                },
-                custom: {
-                    contextName: (contextName) => ({
-                        endpoint: `api/messages/${locale}/custom/${contextName}`,
-                    })
-                }
-            })
-        },
-        ai: {
-            generate: `api/ai/generate`,
-            sendFeedback: `api/ai/rate`,
-            chat: `/api/ai/rag/chat`
-        }
-    };
-    get defaultHeaders() {
-        return {
-            ...this.authorization,
-            ...this.searchLabel,
-            "Ft-Calling-App": this.ftCallingApp
-        };
-    }
-    constructor(tenantBaseUrl, integrationIdentifier, overrideIdentifierIfOnTenant) {
-        //@ts-ignore
-        tenantBaseUrl = (tenantBaseUrl ?? wnd.fluidTopicsBaseUrl ?? wnd.__gwt_ft_moduleBase ?? "").trim();
-        this.tenantBaseUrl = tenantBaseUrl.endsWith("/") ? tenantBaseUrl : tenantBaseUrl + "/";
-        this.tenantBaseUrlNoTrailingSlash = this.tenantBaseUrl.replace(/\/$/, "");
-        if (overrideIdentifierIfOnTenant && typeof wnd.location !== "undefined" && wnd.location.href.startsWith(this.tenantBaseUrl)) {
-            this.ftCallingApp = integrationIdentifier;
-        }
-        else {
-            this.ftCallingApp = `ft-public-api/${integrationIdentifier}`;
-        }
-    }
-    setApiKey(apiKey) {
-        this.authorization = { "Authorization": "Bearer " + apiKey };
-    }
-    setCredentials(login, password) {
-        this.authorization = { "Authorization": "Basic " + toBase64(`${login}:${password}`) };
-    }
-    clearAuthentication() {
-        this.authorization = undefined;
-    }
-    setSearchLabel(searchLabel) {
-        this.searchLabel = { "FT-search-label": searchLabel };
-    }
-    clearSearchLabel() {
-        this.searchLabel = undefined;
-    }
-    login(login, password) {
-        let credentials = {
-            login: login,
-            password: password,
-            rememberMe: true
-        };
-        return this.post(this.endpoints.authentication.login, credentials)
-            .then(result => {
-            this.setCredentials(login, password);
-            return result;
-        });
-    }
-    logout() {
-        return this.post(this.endpoints.authentication.logout)
-            .then(() => this.clearAuthentication());
-    }
-    getCurrentSession() {
-        return this.get(this.endpoints.authentication.currentSession);
-    }
-    getReaderConfiguration() {
-        return this.get(this.endpoints.configuration.reader);
-    }
-    getMap(mapId, v) {
-        return this.get(this.endpoints.khub.maps.mapId(mapId).info, v);
-    }
-    getTableOfContent(mapId, v) {
-        return this.get(this.endpoints.khub.maps.mapId(mapId).toc, v);
-    }
-    getPages(mapId, v) {
-        return this.get(this.endpoints.khub.maps.mapId(mapId).pages, v);
-    }
-    getTopic(mapId, topicContentId, v) {
-        return this.get(this.endpoints.khub.maps.mapId(mapId).topics.contentId(topicContentId).info, v);
-    }
-    getTopicHTMLContent(mapId, topicContentId, target, v) {
-        return this.get(this.endpoints.khub.maps.mapId(mapId).topics.contentId(topicContentId).content + (target ? "?target=" + target : ""), v);
-    }
-    getMapAttachments(mapId, v) {
-        return this.get(this.endpoints.khub.maps.mapId(mapId).attachments.list, v);
-    }
-    getMapAttachmentContent(mapId, attachmentId, v) {
-        return this.fetchRawData(this.endpoints.khub.maps.mapId(mapId).attachments.attachmentId(attachmentId).content, v);
-    }
-    getMapResources(mapId, v) {
-        return this.get(this.endpoints.khub.maps.mapId(mapId).resources.list, v);
-    }
-    getMapResourceContent(mapId, resourceId, v) {
-        return this.fetchRawData(this.endpoints.khub.maps.mapId(mapId).resources.resourceId(resourceId).content, v);
-    }
-    getUnstructuredDocument(documentId, v) {
-        return this.get(this.endpoints.khub.documents.documentId(documentId).info, v);
-    }
-    getUnstructuredDocumentContent(documentId, v) {
-        return this.fetchRawData(this.endpoints.khub.documents.documentId(documentId).content, v);
-    }
-    getUnstructuredDocumentTextContent(documentId, v) {
-        return this.get(this.endpoints.khub.documents.documentId(documentId).text, v);
-    }
-    getCollectionDocuments(userId, collectionId) {
-        return this.get(this.endpoints.users.userId(userId).collections.collectionId(collectionId).documents);
-    }
-    getSuggestions(request) {
-        return this.post(this.endpoints.khub.suggest, request);
-    }
-    search(request) {
-        return this.post(this.endpoints.khub.clusteredSearch, request);
-    }
-    getAvailableSearchLocales() {
-        return this.get(this.endpoints.khub.locales);
-    }
-    getAvailableUiLocales() {
-        return this.get(this.endpoints.locales.ui);
-    }
-    getMetadataConfiguration() {
-        return this.get(this.endpoints.configuration.metadata);
-    }
-    getMapRating(mapId) {
-        return this.get(this.endpoints.khub.maps.mapId(mapId).rating);
-    }
-    rateMap(mapId, type, value) {
-        return this.post(this.endpoints.khub.maps.mapId(mapId).rating, { type, value });
-    }
-    unrateMap(mapId) {
-        return this.delete(this.endpoints.khub.maps.mapId(mapId).rating);
-    }
-    sendMapFeedback(mapId, message, from) {
-        return this.post(this.endpoints.khub.maps.mapId(mapId).feedback, { message, from });
-    }
-    rateTopic(mapId, tocId, type, value) {
-        return this.post(this.endpoints.khub.maps.mapId(mapId).topics.tocId(tocId).rating, {
-            type, value
-        });
-    }
-    unrateTopic(mapId, tocId) {
-        return this.delete(this.endpoints.khub.maps.mapId(mapId).topics.tocId(tocId).rating);
-    }
-    sendTopicFeedback(mapId, tocId, message, from) {
-        return this.post(this.endpoints.khub.maps.mapId(mapId).topics.tocId(tocId).feedback, { message, from });
-    }
-    getDocumentRating(docId) {
-        return this.get(this.endpoints.khub.documents.documentId(docId).rating);
-    }
-    rateDocument(docId, type, value) {
-        return this.post(this.endpoints.khub.documents.documentId(docId).rating, { type, value });
-    }
-    unrateDocument(docId) {
-        return this.delete(this.endpoints.khub.documents.documentId(docId).rating);
-    }
-    sendDocumentFeedback(docId, message, from) {
-        return this.post(this.endpoints.khub.documents.documentId(docId).feedback, { message, from });
-    }
-    semanticSearch(request) {
-        return this.post(this.endpoints.khub.semantic.search, { request });
-    }
-    clusteredSemanticSearch(request) {
-        return this.post(this.endpoints.khub.semantic.clusteredSearch, { request });
-    }
-    getFluidTopicsMessageContext(locale, name) {
-        return this.get(this.endpoints.messages.locale(locale).fluidTopics.contextName(name).endpoint);
-    }
-    getCustomMessageContext(locale, name) {
-        return this.get(this.endpoints.messages.locale(locale).custom.contextName(name).endpoint);
-    }
-    listMySearches(userId) {
-        return this.get(this.endpoints.users.userId(userId).searches.list);
-    }
-    listMyBookmarks(userId) {
-        return this.get(this.endpoints.users.userId(userId).bookmarks.list);
-    }
-    async *generate(profileId, parameters) {
-        const response = await this.fetch(this.endpoints.ai.generate, {
-            method: "POST",
-            headers: {
-                "Content-Type": "application/json",
-            },
-            body: JSON.stringify({ profileId, parameters }),
-            credentials: this.authorization == null ? "include" : undefined
-        });
-        await handleError("POST", this.endpoints.ai.generate, response);
-        const reader = new GenAIChunkReader(response.body.getReader());
-        yield* reader.read();
-    }
-    async *chat(input) {
-        const response = await this.fetch(this.endpoints.ai.chat, {
-            method: "POST",
-            headers: {
-                "Content-Type": "application/json",
-            },
-            body: JSON.stringify(input),
-            credentials: this.authorization == null ? "include" : undefined
-        });
-        await handleError("POST", this.endpoints.ai.chat, response);
-        const reader = new GenAIChunkReader(response.body.getReader());
-        yield* reader.read();
-    }
-    sendFeedback(rating) {
-        return this.post(this.endpoints.ai.sendFeedback, rating);
-    }
-    get(endpoint, v) {
-        return this.makeRequest("GET", this.withVersion(endpoint, v));
-    }
-    post(endpoint, data) {
-        return this.makeRequest("POST", endpoint, data);
-    }
-    put(endpoint, data) {
-        return this.makeRequest("PUT", endpoint, data);
-    }
-    delete(endpoint) {
-        return this.makeRequest("DELETE", endpoint);
-    }
-    makeAbsolute(endpoint) {
-        return endpoint.startsWith(this.tenantBaseUrl) || endpoint === this.tenantBaseUrlNoTrailingSlash
-            ? endpoint
-            : (this.tenantBaseUrl + endpoint.replace(/^\//, ""));
-    }
-    async fetch(endpoint, init) {
-        const requestInit = init;
-        return await fetch(this.makeAbsolute(endpoint), {
-            ...(requestInit ?? {}),
-            headers: {
-                ...this.defaultHeaders,
-                ...(requestInit?.headers ?? {})
-            }
-        });
-    }
-    upload(method, endpoint, body, onProgress = () => undefined) {
-        if (typeof XMLHttpRequest !== "undefined") {
-            return new Promise((resolve, reject) => {
-                let xhr = new XMLHttpRequest();
-                xhr.onload = () => {
-                    if (xhr.status >= 200 && xhr.status < 300) {
-                        let data = xhr.getResponseHeader("Content-Type") === "application/json" ? JSON.parse(xhr.responseText) : xhr.responseText;
-                        resolve(data);
-                    }
-                    else {
-                        reject(new HttpError("GET", endpoint, xhr.status, xhr.statusText, xhr.responseText));
-                    }
-                };
-                xhr.upload.onprogress = (e) => onProgress(e);
-                xhr.open(method, this.makeAbsolute(endpoint), true);
-                xhr.send(body);
-            });
-        }
-        else {
-            return this.fetch(endpoint, { method, body })
-                .then((r) => handleError(method, endpoint, r))
-                .then(getBody);
-        }
-    }
-    makeRequest(method, endpoint, data) {
-        return this.fetch(endpoint, {
-            method: method,
-            headers: {
-                ...(data != null ? { "Content-Type": "application/json" } : {})
-            },
-            body: data != null ? JSON.stringify(data) : undefined,
-            credentials: this.authorization == null ? "include" : undefined
-        })
-            .then((r) => handleError(method, endpoint, r))
-            .then(getBody);
-    }
-    fetchRawData(endpoint, v) {
-        return fetch(this.withVersion(endpoint, v), {
-            headers: this.defaultHeaders,
-            credentials: this.authorization == null ? "include" : undefined
-        })
-            .then((r) => handleError("GET", endpoint, r))
-            .then(response => response.arrayBuffer());
-    }
-    withVersion(endpoint, v) {
-        let url = new URL(this.makeAbsolute(endpoint));
-        if (v) {
-            url.searchParams.append("v", v);
-        }
-        return url.toString();
-    }
-}
-export default FluidTopicsApi;

package/build/mjs/preferences/unauthenticated-preferences.d.ts

@@ -1,9 +0,0 @@
-import { FtMetadataPreferenceConfiguration, FtSearchPreferencesConfiguration } from "../types/ft-common/public";
-export declare function setUnauthenticatedUserSearchPreferences(tenantBaseUrl: string, input: FtSearchPreferencesConfiguration): {
-    metadata: Record<string, FtMetadataPreferenceConfiguration>;
-};
-export declare function getUnauthenticatedUserSearchPreferences(tenantBaseUrl: string): FtSearchPreferencesConfiguration;
-export type HandlerRegistration = {
-    removeHandler: () => void;
-};
-export declare function addUnauthenticatedUserSearchPreferencesChangeHandler(tenantBaseUrl: string, handler: (newValue: FtSearchPreferencesConfiguration) => void): HandlerRegistration;

package/build/mjs/preferences/unauthenticated-preferences.js

@@ -1,61 +0,0 @@
-const wnd = (typeof window === "undefined" ? globalThis : window);
-function normalizeMetadataPreferences(metadata) {
-    let normalized = {};
-    for (let key in metadata) {
-        let values = metadata[key];
-        if (typeof values !== "object" || Array.isArray(values)) {
-            values = { prior: values };
-        }
-        for (let property of ["prior", "filter"]) {
-            values[property] = Array.isArray(values[property]) ? values[property] : [values[property]];
-            values[property] = values[property]
-                .map(v => v != null ? "" + v : "")
-                .filter(v => v !== "");
-        }
-        normalized[key] = values;
-    }
-    return normalized;
-}
-function getStorageKey(tenantBaseUrl) {
-    return `${tenantBaseUrl}-FluidTopicsUnauthenticatedUserSearchPreferences`;
-}
-export function setUnauthenticatedUserSearchPreferences(tenantBaseUrl, input) {
-    if (wnd.localStorage) {
-        let preferences = {
-            ...input,
-            metadata: normalizeMetadataPreferences(input.metadata ?? {})
-        };
-        const key = getStorageKey(tenantBaseUrl);
-        const newValue = JSON.stringify(preferences);
-        wnd.localStorage.setItem(key, newValue);
-        wnd.dispatchEvent(new StorageEvent("storage", {
-            key,
-            newValue,
-            storageArea: wnd.localStorage,
-            url: wnd.location.href
-        }));
-        return preferences;
-    }
-    console.error("Cannot set unauthenticated preferences: local storage is unavailable.");
-}
-export function getUnauthenticatedUserSearchPreferences(tenantBaseUrl) {
-    if (wnd.localStorage) {
-        return JSON.parse(wnd.localStorage.getItem(getStorageKey(tenantBaseUrl)) ?? "{}");
-    }
-    console.error("Cannot get unauthenticated preferences: local storage is unavailable.");
-}
-export function addUnauthenticatedUserSearchPreferencesChangeHandler(tenantBaseUrl, handler) {
-    if (wnd.localStorage) {
-        const key = getStorageKey(tenantBaseUrl);
-        const eventListener = (event) => {
-            if (event.storageArea === wnd.localStorage && event.key === key) {
-                handler(JSON.parse(event.newValue ?? "{}"));
-            }
-        };
-        wnd.addEventListener("storage", eventListener);
-        return {
-            removeHandler: () => wnd.removeEventListener("storage", eventListener)
-        };
-    }
-    console.error("Cannot handle unauthenticated preferences: local storage is unavailable.");
-}

package/build/mjs/roles/roles.d.ts

@@ -1,2 +0,0 @@
-import { FtSession, FtUserProfile, FtUserRole, FtUserRoleKeys } from "../types/ft-common/public";
-export declare function userHasRole(sessionOrProfileOrRoles: FtSession | FtUserProfile | Array<FtUserRole | FtUserRoleKeys> | undefined, expectedRole: FtUserRole | FtUserRoleKeys): boolean;

package/build/mjs/roles/roles.js

@@ -1,25 +0,0 @@
-import { FtUserRole } from "../types/ft-common/public";
-const rolesInheritance = {
-    [FtUserRole.PERSONAL_BOOK_SHARE_USER]: [FtUserRole.PERSONAL_BOOK_USER],
-    [FtUserRole.HTML_EXPORT_USER]: [FtUserRole.PERSONAL_BOOK_USER],
-    [FtUserRole.PDF_EXPORT_USER]: [FtUserRole.PERSONAL_BOOK_USER],
-    [FtUserRole.KHUB_ADMIN]: [FtUserRole.CONTENT_PUBLISHER],
-    [FtUserRole.ADMIN]: [FtUserRole.KHUB_ADMIN, FtUserRole.USERS_ADMIN, FtUserRole.PORTAL_ADMIN],
-    [FtUserRole.DEVELOPER]: [FtUserRole.BETA_USER, FtUserRole.DEBUG_USER],
-};
-function roleMatches(actual, expected) {
-    return actual === expected || (rolesInheritance[actual] ?? []).some((inherited) => roleMatches(inherited, expected));
-}
-export function userHasRole(sessionOrProfileOrRoles, expectedRole) {
-    if (sessionOrProfileOrRoles == null) {
-        return false;
-    }
-    const roles = Array.isArray(sessionOrProfileOrRoles)
-        ? sessionOrProfileOrRoles
-        : Array.isArray(sessionOrProfileOrRoles.roles)
-            ? sessionOrProfileOrRoles.roles
-            : Array.isArray(sessionOrProfileOrRoles.profile?.roles)
-                ? sessionOrProfileOrRoles.profile.roles
-                : [];
-    return roles.some(role => roleMatches(role, expectedRole));
-}