@c-rex/utils 0.3.0-build.24 → 0.3.0-build.26

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { AvailableVersionsInterface, TreeOfContent, RenditionModel, LanguageAndCountries, LiteralModel, ObjectRefModel } from '@c-rex/interfaces';
+import { AvailableVersionsInterface, TreeOfContent, RenditionModel, LanguageAndCountries, LiteralModel, ObjectRefModel, CommonItemsModel } from '@c-rex/interfaces';
 import { ClassValue } from 'clsx';
 import { QueryParams, DocumentsType, articleInfoItemType, ResultTypes } from '@c-rex/types';
 import { Metadata } from 'next';
@@ -52,6 +52,24 @@ declare const createParams: (fieldsList: string[], key?: string) => {
  */
 declare const generateQueryParams: (params: QueryParams[]) => string;
 
+type FileRenditionActionItem = {
+    label: string;
+    downloadUrl: string;
+    viewUrl?: string;
+};
+type FileRenditionActionGroup = {
+    format: string;
+    displayLabel: string;
+    iconFormat: string;
+    iconLabel: string;
+    items: FileRenditionActionItem[];
+    hasMultiple: boolean;
+    supportsOpen: boolean;
+};
+declare const getFileRenditionGroups: ({ renditions, ignoreFormats, }: {
+    renditions?: RenditionModel[] | null;
+    ignoreFormats?: string[];
+}) => FileRenditionActionGroup[];
 declare const getFileRenditions: ({ renditions }: {
     renditions: RenditionModel[];
 }) => DocumentsType;
@@ -60,9 +78,12 @@ declare const getFileRenditions: ({ renditions }: {
  * Makes an asynchronous RPC API call to the server.
  * @param method - The RPC method name to call
  * @param params - Optional parameters to pass to the method
+ * @param options - Optional fetch controls (for example AbortSignal)
  * @returns A Promise resolving to the response data of type T
  */
-declare const call: <T>(method: string, params?: any) => Promise<T>;
+declare const call: <T>(method: string, params?: any, options?: {
+    signal?: AbortSignal;
+}) => Promise<T>;
 
 declare const normalizeLanguageCode: (value: string) => string;
 declare const sortAndDeduplicateLanguages: (languages: Array<string | null | undefined>) => string[];
@@ -76,7 +97,8 @@ declare const transformLanguageData: (data: {
 declare const isDate: (value: string) => boolean;
 declare const isLanguage: (label: string) => boolean;
 declare const filteredItems: (items: articleInfoItemType[]) => articleInfoItemType[];
-declare const getType: (classObj?: ObjectRefModel) => ResultTypes;
+declare const resolveLabelByLanguage: (labels?: LiteralModel[] | null, lang?: string) => string | undefined;
+declare const getType: (classObj?: ObjectRefModel, lang?: string) => ResultTypes | undefined;
 declare const getTitle: (titles?: LiteralModel[] | null, labels?: LiteralModel[] | null) => string;
 declare const getLabelByLang: (labels?: LiteralModel[] | null, lang?: string) => string;
 declare const getLanguage: (languages?: string[] | null) => string;
@@ -94,4 +116,16 @@ declare const parseHtmlContent: (html: string) => ParsedHtmlContent;
 declare const getHtmlRenditionViewUrl: (renditions: RenditionModel[] | null | undefined, htmlFormats?: string[]) => string | undefined;
 declare const metaTagsToMetadata: (metaTags: HtmlMetaTag[]) => Pick<Metadata, "description" | "keywords" | "other">;
 
-export { type HtmlMetaTag, type ParsedHtmlContent, call, cn, createAvailableVersionList, createParams, extractCountryCodeFromLanguage, filteredItems, formatDateToLocale, generateBreadcrumbItems, generateQueryParams, getCountryCodeByLang, getFileRenditions, getHtmlRenditionViewUrl, getLabelByLang, getLanguage, getTitle, getType, getVersions, isDate, isLanguage, metaTagsToMetadata, normalizeLanguageCode, parseHtmlContent, processDataToLabelValuePairs, replacePathParams, resolvePreferredLanguage, sortAndDeduplicateLanguages, transformLanguageData };
+type RelatedFragmentLike = ObjectRefModel & {
+    informationSubjects?: ObjectRefModel[] | null;
+};
+interface FindRelatedFragmentOptions {
+    item?: CommonItemsModel | {
+        informationUnits?: RelatedFragmentLike[] | null;
+    } | null;
+    informationSubjectIds?: string[];
+}
+declare const findRelatedFragment: ({ item, informationSubjectIds, }: FindRelatedFragmentOptions) => RelatedFragmentLike | undefined;
+declare const findRelatedFragmentShortId: (options: FindRelatedFragmentOptions) => string | undefined;
+
+export { type FileRenditionActionGroup, type FileRenditionActionItem, type HtmlMetaTag, type ParsedHtmlContent, call, cn, createAvailableVersionList, createParams, extractCountryCodeFromLanguage, filteredItems, findRelatedFragment, findRelatedFragmentShortId, formatDateToLocale, generateBreadcrumbItems, generateQueryParams, getCountryCodeByLang, getFileRenditionGroups, getFileRenditions, getHtmlRenditionViewUrl, getLabelByLang, getLanguage, getTitle, getType, getVersions, isDate, isLanguage, metaTagsToMetadata, normalizeLanguageCode, parseHtmlContent, processDataToLabelValuePairs, replacePathParams, resolveLabelByLanguage, resolvePreferredLanguage, sortAndDeduplicateLanguages, transformLanguageData };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { AvailableVersionsInterface, TreeOfContent, RenditionModel, LanguageAndCountries, LiteralModel, ObjectRefModel } from '@c-rex/interfaces';
+import { AvailableVersionsInterface, TreeOfContent, RenditionModel, LanguageAndCountries, LiteralModel, ObjectRefModel, CommonItemsModel } from '@c-rex/interfaces';
 import { ClassValue } from 'clsx';
 import { QueryParams, DocumentsType, articleInfoItemType, ResultTypes } from '@c-rex/types';
 import { Metadata } from 'next';
@@ -52,6 +52,24 @@ declare const createParams: (fieldsList: string[], key?: string) => {
  */
 declare const generateQueryParams: (params: QueryParams[]) => string;
 
+type FileRenditionActionItem = {
+    label: string;
+    downloadUrl: string;
+    viewUrl?: string;
+};
+type FileRenditionActionGroup = {
+    format: string;
+    displayLabel: string;
+    iconFormat: string;
+    iconLabel: string;
+    items: FileRenditionActionItem[];
+    hasMultiple: boolean;
+    supportsOpen: boolean;
+};
+declare const getFileRenditionGroups: ({ renditions, ignoreFormats, }: {
+    renditions?: RenditionModel[] | null;
+    ignoreFormats?: string[];
+}) => FileRenditionActionGroup[];
 declare const getFileRenditions: ({ renditions }: {
     renditions: RenditionModel[];
 }) => DocumentsType;
@@ -60,9 +78,12 @@ declare const getFileRenditions: ({ renditions }: {
  * Makes an asynchronous RPC API call to the server.
  * @param method - The RPC method name to call
  * @param params - Optional parameters to pass to the method
+ * @param options - Optional fetch controls (for example AbortSignal)
  * @returns A Promise resolving to the response data of type T
  */
-declare const call: <T>(method: string, params?: any) => Promise<T>;
+declare const call: <T>(method: string, params?: any, options?: {
+    signal?: AbortSignal;
+}) => Promise<T>;
 
 declare const normalizeLanguageCode: (value: string) => string;
 declare const sortAndDeduplicateLanguages: (languages: Array<string | null | undefined>) => string[];
@@ -76,7 +97,8 @@ declare const transformLanguageData: (data: {
 declare const isDate: (value: string) => boolean;
 declare const isLanguage: (label: string) => boolean;
 declare const filteredItems: (items: articleInfoItemType[]) => articleInfoItemType[];
-declare const getType: (classObj?: ObjectRefModel) => ResultTypes;
+declare const resolveLabelByLanguage: (labels?: LiteralModel[] | null, lang?: string) => string | undefined;
+declare const getType: (classObj?: ObjectRefModel, lang?: string) => ResultTypes | undefined;
 declare const getTitle: (titles?: LiteralModel[] | null, labels?: LiteralModel[] | null) => string;
 declare const getLabelByLang: (labels?: LiteralModel[] | null, lang?: string) => string;
 declare const getLanguage: (languages?: string[] | null) => string;
@@ -94,4 +116,16 @@ declare const parseHtmlContent: (html: string) => ParsedHtmlContent;
 declare const getHtmlRenditionViewUrl: (renditions: RenditionModel[] | null | undefined, htmlFormats?: string[]) => string | undefined;
 declare const metaTagsToMetadata: (metaTags: HtmlMetaTag[]) => Pick<Metadata, "description" | "keywords" | "other">;
 
-export { type HtmlMetaTag, type ParsedHtmlContent, call, cn, createAvailableVersionList, createParams, extractCountryCodeFromLanguage, filteredItems, formatDateToLocale, generateBreadcrumbItems, generateQueryParams, getCountryCodeByLang, getFileRenditions, getHtmlRenditionViewUrl, getLabelByLang, getLanguage, getTitle, getType, getVersions, isDate, isLanguage, metaTagsToMetadata, normalizeLanguageCode, parseHtmlContent, processDataToLabelValuePairs, replacePathParams, resolvePreferredLanguage, sortAndDeduplicateLanguages, transformLanguageData };
+type RelatedFragmentLike = ObjectRefModel & {
+    informationSubjects?: ObjectRefModel[] | null;
+};
+interface FindRelatedFragmentOptions {
+    item?: CommonItemsModel | {
+        informationUnits?: RelatedFragmentLike[] | null;
+    } | null;
+    informationSubjectIds?: string[];
+}
+declare const findRelatedFragment: ({ item, informationSubjectIds, }: FindRelatedFragmentOptions) => RelatedFragmentLike | undefined;
+declare const findRelatedFragmentShortId: (options: FindRelatedFragmentOptions) => string | undefined;
+
+export { type FileRenditionActionGroup, type FileRenditionActionItem, type HtmlMetaTag, type ParsedHtmlContent, call, cn, createAvailableVersionList, createParams, extractCountryCodeFromLanguage, filteredItems, findRelatedFragment, findRelatedFragmentShortId, formatDateToLocale, generateBreadcrumbItems, generateQueryParams, getCountryCodeByLang, getFileRenditionGroups, getFileRenditions, getHtmlRenditionViewUrl, getLabelByLang, getLanguage, getTitle, getType, getVersions, isDate, isLanguage, metaTagsToMetadata, normalizeLanguageCode, parseHtmlContent, processDataToLabelValuePairs, replacePathParams, resolveLabelByLanguage, resolvePreferredLanguage, sortAndDeduplicateLanguages, transformLanguageData };

package/dist/index.js

@@ -36,10 +36,13 @@ __export(index_exports, {
   createParams: () => createParams,
   extractCountryCodeFromLanguage: () => extractCountryCodeFromLanguage,
   filteredItems: () => filteredItems,
+  findRelatedFragment: () => findRelatedFragment,
+  findRelatedFragmentShortId: () => findRelatedFragmentShortId,
   formatDateToLocale: () => formatDateToLocale,
   generateBreadcrumbItems: () => generateBreadcrumbItems,
   generateQueryParams: () => generateQueryParams,
   getCountryCodeByLang: () => getCountryCodeByLang,
+  getFileRenditionGroups: () => getFileRenditionGroups,
   getFileRenditions: () => getFileRenditions,
   getHtmlRenditionViewUrl: () => getHtmlRenditionViewUrl,
   getLabelByLang: () => getLabelByLang,
@@ -54,6 +57,7 @@ __export(index_exports, {
   parseHtmlContent: () => parseHtmlContent,
   processDataToLabelValuePairs: () => processDataToLabelValuePairs,
   replacePathParams: () => replacePathParams,
+  resolveLabelByLanguage: () => resolveLabelByLanguage,
   resolvePreferredLanguage: () => resolvePreferredLanguage,
   sortAndDeduplicateLanguages: () => sortAndDeduplicateLanguages,
   transformLanguageData: () => transformLanguageData
@@ -1559,44 +1563,127 @@ var generateQueryParams = (params) => {
 };
 
 // src/renditions.ts
-var getFileRenditions = ({ renditions }) => {
-  if (renditions == void 0 || renditions.length == 0) {
-    return {};
-  }
-  const filteredRenditions = renditions.filter(
-    (item) => item.format != "application/xhtml+xml" && item.format != "application/json" && item.format != "application/llm+xml"
-  );
-  if (filteredRenditions.length == 0 || filteredRenditions[0] == void 0) {
-    return {};
+var DEFAULT_IGNORED_FORMATS = [
+  "application/xhtml+xml",
+  "application/json",
+  "application/llm+xml",
+  "text/html"
+];
+var isZipLikeFormat = (format) => {
+  const normalized = format.toLowerCase();
+  return normalized === "application/zip" || normalized.startsWith("application/") && normalized.endsWith("+zip");
+};
+var getArchiveDisplayCode = (format) => {
+  const normalized = format.toLowerCase();
+  if (normalized === "application/zip") {
+    return "ZIP";
   }
-  const result = {};
-  filteredRenditions.forEach((item) => {
-    const key = item.format;
-    if (result[key] == void 0) {
-      result[key] = {
-        view: "",
-        download: ""
-      };
+  if (normalized.startsWith("application/") && normalized.endsWith("+zip")) {
+    const subtype = normalized.slice("application/".length, -"+zip".length);
+    const parts = subtype.split(".");
+    const lastPart = parts[parts.length - 1]?.trim();
+    const token = lastPart && lastPart.length > 0 ? lastPart : subtype.trim();
+    if (token && token.length > 0 && token !== "vnd") {
+      return token.replace(/[^a-z0-9]/gi, "").slice(0, 4).toUpperCase() || "ZIP";
     }
-    const download = item.links?.filter((link) => link.rel == "download")[0]?.href;
-    const view = item.links?.filter((link) => link.rel == "view")[0]?.href;
-    if (download != null && download != void 0) {
-      result[key].download = download;
-    }
-    if (view != null && view != void 0) {
-      result[key].view = view;
+  }
+  return null;
+};
+var getDisplayLabel = (format) => {
+  if (format === "application/pdf") return "PDF";
+  if (isZipLikeFormat(format)) return "ZIP";
+  const subtype = format.split("/")[1] || format;
+  return subtype.replace(/\+.*/, "").toUpperCase();
+};
+var getIconFormat = (format) => {
+  if (format === "application/pdf") return "application/pdf";
+  if (format === "application/zip") return "application/zip";
+  if (isZipLikeFormat(format)) return format;
+  return format;
+};
+var getIconLabel = (format) => {
+  if (format === "application/pdf") return "PDF";
+  const archiveCode = getArchiveDisplayCode(format);
+  if (archiveCode) return archiveCode;
+  return getDisplayLabel(format);
+};
+var getFirstLinkByRel = (item, rel) => item.links?.find((link) => link.rel === rel)?.href;
+var getRenditionFileName = (item, fallbackFormat) => {
+  const rawSource = item.source?.split("/").pop();
+  if (rawSource && rawSource.length > 0) {
+    return decodeURIComponent(rawSource);
+  }
+  const urlCandidate = getFirstLinkByRel(item, "download") || getFirstLinkByRel(item, "view");
+  if (urlCandidate) {
+    try {
+      const url = new URL(urlCandidate);
+      const lastSegment = url.pathname.split("/").pop();
+      if (lastSegment && lastSegment.length > 0) {
+        return decodeURIComponent(lastSegment);
+      }
+    } catch {
+      const lastSegment = urlCandidate.split("/").pop();
+      if (lastSegment && lastSegment.length > 0) {
+        return decodeURIComponent(lastSegment);
+      }
     }
+  }
+  return getDisplayLabel(fallbackFormat);
+};
+var getFileRenditionGroups = ({
+  renditions,
+  ignoreFormats = DEFAULT_IGNORED_FORMATS
+}) => {
+  if (!renditions || renditions.length === 0) return [];
+  const grouped = /* @__PURE__ */ new Map();
+  renditions.filter((item) => item.format && !ignoreFormats.includes(item.format)).forEach((item) => {
+    const format = item.format;
+    const downloadUrl = getFirstLinkByRel(item, "download");
+    const viewUrl = getFirstLinkByRel(item, "view");
+    if (!downloadUrl && !viewUrl) return;
+    const current = grouped.get(format) || [];
+    current.push({
+      label: getRenditionFileName(item, format),
+      downloadUrl: downloadUrl || viewUrl || "",
+      viewUrl: viewUrl || void 0
+    });
+    grouped.set(format, current);
   });
-  return result;
+  return Array.from(grouped.entries()).map(([format, items]) => {
+    const deduplicatedItems = items.filter((item) => item.downloadUrl);
+    const hasMultiple = deduplicatedItems.length > 1;
+    const isPdf = format === "application/pdf";
+    return {
+      format,
+      displayLabel: getDisplayLabel(format),
+      iconFormat: getIconFormat(format),
+      iconLabel: getIconLabel(format),
+      items: deduplicatedItems,
+      hasMultiple,
+      supportsOpen: isPdf && !hasMultiple && !!deduplicatedItems[0]?.viewUrl
+    };
+  }).filter((group) => group.items.length > 0);
+};
+var getFileRenditions = ({ renditions }) => {
+  return getFileRenditionGroups({ renditions }).reduce((acc, group) => {
+    const first = group.items[0];
+    if (!first) return acc;
+    acc[group.format] = {
+      view: first.viewUrl || "",
+      download: first.downloadUrl || ""
+    };
+    return acc;
+  }, {});
 };
 
 // src/call.ts
-var call = async (method, params) => {
+var call = async (method, params, options) => {
   const res = await fetch(`/api/rpc`, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify({ method, params }),
-    credentials: "include"
+    credentials: "include",
+    signal: options?.signal
   });
   const json = await res.json();
   if (!res.ok) throw new Error(json.error || "Unknown error");
@@ -1665,8 +1752,31 @@ var filteredItems = (items) => {
   const hasTitle = items.some((item) => item.label === "titles");
   return items.filter((item) => hasTitle ? item.label !== "labels" : true);
 };
-var getType = (classObj) => {
-  const type = classObj?.labels?.find((item) => item.language === EN_LANG)?.value?.toUpperCase();
+var resolveLabelByLanguage = (labels, lang = EN_LANG) => {
+  if (!labels || labels.length === 0) {
+    return void 0;
+  }
+  const normalizedLanguage = normalizeLanguageCode(lang || EN_LANG).toLowerCase();
+  const baseLanguage = normalizedLanguage.split("-")[0];
+  const normalizedLabels = labels.map((item) => ({
+    language: normalizeLanguageCode(item.language || "").toLowerCase(),
+    value: item.value?.trim() || ""
+  })).filter((item) => item.value.length > 0);
+  if (normalizedLabels.length === 0) {
+    return void 0;
+  }
+  const exact = normalizedLabels.find((item) => item.language === normalizedLanguage)?.value;
+  if (exact) return exact;
+  const base = normalizedLabels.find((item) => item.language === baseLanguage)?.value || normalizedLabels.find((item) => item.language.startsWith(`${baseLanguage}-`))?.value;
+  if (base) return base;
+  const english = normalizedLabels.find((item) => item.language === "en-us")?.value || normalizedLabels.find((item) => item.language === "en")?.value || normalizedLabels.find((item) => item.language.startsWith("en-"))?.value;
+  if (english) return english;
+  const noLanguage = normalizedLabels.find((item) => item.language.length === 0)?.value;
+  if (noLanguage) return noLanguage;
+  return normalizedLabels[0]?.value;
+};
+var getType = (classObj, lang = EN_LANG) => {
+  const type = resolveLabelByLanguage(classObj?.labels, lang)?.toUpperCase();
   return type;
 };
 var getTitle = (titles, labels) => {
@@ -1679,18 +1789,7 @@ var getTitle = (titles, labels) => {
   return "NO TITLE";
 };
 var getLabelByLang = (labels, lang = EN_LANG) => {
-  if (!labels) {
-    return "NO TITLE";
-  }
-  const preferred = labels.find((item) => item.language === lang);
-  if (preferred) {
-    return preferred.value;
-  }
-  const fallback = labels.find((item) => item.language === EN_LANG);
-  if (fallback) {
-    return fallback.value;
-  }
-  return "NO TITLE";
+  return resolveLabelByLanguage(labels, lang) || "NO TITLE";
 };
 var getLanguage = (languages) => {
   if (languages && languages.length > 0) {
@@ -1741,6 +1840,29 @@ var metaTagsToMetadata = (metaTags) => {
     other: Object.keys(other).length > 0 ? other : void 0
   };
 };
+
+// src/related-fragments.ts
+var matchesSubject = (fragment, informationSubjectIds) => {
+  if (informationSubjectIds.length === 0) return true;
+  const fragmentSubjects = fragment.informationSubjects || [];
+  return fragmentSubjects.some((subject) => {
+    const id = subject.id || subject.shortId;
+    return !!id && informationSubjectIds.includes(id);
+  });
+};
+var findRelatedFragment = ({
+  item,
+  informationSubjectIds = []
+}) => {
+  const relatedItems = item?.informationUnits || [];
+  return relatedItems.find((relatedItem) => {
+    if (!relatedItem?.shortId) return false;
+    return matchesSubject(relatedItem, informationSubjectIds);
+  });
+};
+var findRelatedFragmentShortId = (options) => {
+  return findRelatedFragment(options)?.shortId || void 0;
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   call,
@@ -1749,10 +1871,13 @@ var metaTagsToMetadata = (metaTags) => {
   createParams,
   extractCountryCodeFromLanguage,
   filteredItems,
+  findRelatedFragment,
+  findRelatedFragmentShortId,
   formatDateToLocale,
   generateBreadcrumbItems,
   generateQueryParams,
   getCountryCodeByLang,
+  getFileRenditionGroups,
   getFileRenditions,
   getHtmlRenditionViewUrl,
   getLabelByLang,
@@ -1767,6 +1892,7 @@ var metaTagsToMetadata = (metaTags) => {
   parseHtmlContent,
   processDataToLabelValuePairs,
   replacePathParams,
+  resolveLabelByLanguage,
   resolvePreferredLanguage,
   sortAndDeduplicateLanguages,
   transformLanguageData