@favish/staffbase-utils 0.9.0 → 0.11.0

package/README.md

@@ -23,9 +23,11 @@ minimumReleaseAgeExclude:
 
 | Subpath | Exports |
 | --- | --- |
+| `@favish/staffbase-utils/api` | `fetchJson`, `fetchAllPaginated`, `ApiError` |
+| `@favish/staffbase-utils/content` | `resolveLocalizedContent`, `resolveActiveLanguage`, `detectEditorLanguage`, `detectPreviewLanguage` |
 | `@favish/staffbase-utils/log` | `logError`, `logWarn`, `logDebug`, `setLoggingEnabled` |
 | `@favish/staffbase-utils/dom` | `getDynamicClasses` |
-| `@favish/staffbase-utils/types` | `Channel`, `ChannelLink`, `ChannelLinkParameter`, `DropdownOption` (type-only) |
+| `@favish/staffbase-utils/types` | `Channel`, `ChannelLink`, `ChannelLinkParameter`, `DropdownOption`, `LocalizedContent`, `ArticleImage`, `ArticleImageVariant` (type-only) |
 
 More modules (`/env`, `/device`, `/html`, `/links`, `/widgets`) are added per the
 delivery roadmap; each is its own subpath so consumers only bundle what they import.

package/dist/api.cjs.js

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=class extends Error{status;constructor(e,t){super(t),this.name=`ApiError`,this.status=e}},t=async(t,n)=>{let r=await fetch(t,{credentials:`include`,...n});if(!r.ok)throw new e(r.status,`API request failed with status: ${r.status}`);return await r.json()},n=50,r=1e3,i=async(e,i={})=>{let{mapItem:a,limit:o=n,includeDrafts:s=!1,maxPages:c=r,onError:l}=i,u=[],d=0,f=0;for(;f<c;){let n=(await t(`${e}${e.includes(`?`)?`&`:`?`}limit=${o}&offset=${d}${s?`&includeDrafts=true`:``}`)).data??[];if(n.length===0)break;let r=a?n.map(a).filter(e=>e!==null):n;if(u.push(...r),n.length<o)break;d+=o,f+=1}return f>=c&&l?.(`Pagination cap (${c} pages) reached for ${e}; results may be truncated.`),u};exports.ApiError=e,exports.fetchAllPaginated=i,exports.fetchJson=t;
+//# sourceMappingURL=api.cjs.js.map

package/dist/api.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.cjs.js","names":[],"sources":["../src/api/ApiError.ts","../src/api/fetchJson.ts","../src/api/fetchAllPaginated.ts"],"sourcesContent":["/**\n * Error thrown by the API layer when a request resolves with a non-2xx status.\n * Carries the HTTP status so callers can branch (e.g. distinguish 401/403 from\n * 5xx) instead of collapsing every failure into one generic message.\n */\nexport class ApiError extends Error {\n  public readonly status: number\n\n  /**\n   * Creates an ApiError carrying the failed response status.\n   * @param {number} status - The HTTP status code of the failed response.\n   * @param {string} message - A human-readable error message.\n   */\n  public constructor(status: number, message: string) {\n    super(message)\n    this.name = 'ApiError'\n    this.status = status\n  }\n}\n","import { ApiError } from './ApiError'\n\n/**\n * Fetches JSON from a URL using Staffbase session credentials.\n *\n * Throws {@link ApiError} (carrying the HTTP status) on a non-2xx response so\n * callers can branch on the status. Network/parse errors propagate as-is. This\n * helper does not log; the calling service layer owns error logging.\n * @template T The expected shape of the parsed JSON body.\n * @param {string} url - The API URL to fetch.\n * @param {RequestInit} [init] - Optional fetch overrides (merged after credentials).\n * @returns {Promise<T>} The parsed JSON body.\n * @throws {ApiError} When the response status is not ok.\n */\nexport const fetchJson = async <T>(\n  url: string,\n  init?: RequestInit,\n): Promise<T> => {\n  const response = await fetch(url, { credentials: 'include', ...init })\n\n  if (!response.ok) {\n    throw new ApiError(\n      response.status,\n      `API request failed with status: ${response.status}`,\n    )\n  }\n\n  return (await response.json()) as T\n}\n","import type { FetchAllPaginatedOptions } from '../types/api/FetchAllPaginatedOptions'\nimport { fetchJson } from './fetchJson'\n\nconst DEFAULT_LIMIT = 50\nconst DEFAULT_MAX_PAGES = 1000\n\n/**\n * Fetches every page of a Staffbase `{ data, total }` collection endpoint.\n *\n * Termination is driven by page contents (a short page ends the loop) rather\n * than the API's reported `total`, which avoids under-fetching when `total` is\n * under-reported. A `maxPages` cap bounds worst-case latency/memory; reaching it\n * invokes `onError` so the truncation is never silent.\n * @template TItem The mapped item type returned to the caller.\n * @template TSource The raw item type returned by the API before mapping.\n * @param {string} baseUrl - The base API URL (without limit/offset parameters).\n * @param {FetchAllPaginatedOptions<TItem, TSource>} [options] - Mapping and pagination options.\n * @returns {Promise<TItem[]>} All fetched (and optionally mapped) items.\n */\nexport const fetchAllPaginated = async <TItem, TSource = TItem>(\n  baseUrl: string,\n  options: FetchAllPaginatedOptions<TItem, TSource> = {},\n): Promise<TItem[]> => {\n  const {\n    mapItem,\n    limit = DEFAULT_LIMIT,\n    includeDrafts = false,\n    maxPages = DEFAULT_MAX_PAGES,\n    onError,\n  } = options\n\n  const results: TItem[] = []\n  let offset = 0\n  let page = 0\n\n  while (page < maxPages) {\n    const separator = baseUrl.includes('?') ? '&' : '?'\n    const draftsParam = includeDrafts ? '&includeDrafts=true' : ''\n    const url = `${baseUrl}${separator}limit=${limit}&offset=${offset}${draftsParam}`\n\n    const data = await fetchJson<{ data: TSource[]; total?: number }>(url)\n    const rawItems = data.data ?? []\n\n    if (rawItems.length === 0) break\n\n    const mapped = mapItem\n      ? rawItems.map(mapItem).filter((item): item is TItem => item !== null)\n      : (rawItems as unknown as TItem[])\n\n    results.push(...mapped)\n\n    // A short page means we reached the end of the collection.\n    if (rawItems.length < limit) break\n\n    offset += limit\n    page += 1\n  }\n\n  if (page >= maxPages) {\n    onError?.(\n      `Pagination cap (${maxPages} pages) reached for ${baseUrl}; results may be truncated.`,\n    )\n  }\n\n  return results\n}\n"],"mappings":"mEAKA,IAAa,EAAb,cAA8B,KAAM,CAClC,OAOA,YAAmB,EAAgB,EAAiB,CAClD,MAAM,CAAO,EACb,KAAK,KAAO,WACZ,KAAK,OAAS,CAChB,CACF,ECJa,EAAY,MACvB,EACA,IACe,CACf,IAAM,EAAW,MAAM,MAAM,EAAK,CAAE,YAAa,UAAW,GAAG,CAAK,CAAC,EAErE,GAAI,CAAC,EAAS,GACZ,MAAM,IAAI,EACR,EAAS,OACT,mCAAmC,EAAS,QAC9C,EAGF,OAAQ,MAAM,EAAS,KAAK,CAC9B,ECzBM,EAAgB,GAChB,EAAoB,IAeb,EAAoB,MAC/B,EACA,EAAoD,CAAC,IAChC,CACrB,GAAM,CACJ,UACA,QAAQ,EACR,gBAAgB,GAChB,WAAW,EACX,WACE,EAEE,EAAmB,CAAC,EACtB,EAAS,EACT,EAAO,EAEX,KAAO,EAAO,GAAU,CAMtB,IAAM,GAAW,MADE,EAA+C,GAFnD,IAFG,EAAQ,SAAS,GAAG,EAAI,IAAM,IAEb,QAAQ,EAAM,UAAU,IADvC,EAAgB,sBAAwB,IAGS,GAC/C,MAAQ,CAAC,EAE/B,GAAI,EAAS,SAAW,EAAG,MAE3B,IAAM,EAAS,EACX,EAAS,IAAI,CAAO,EAAE,OAAQ,GAAwB,IAAS,IAAI,EAClE,EAKL,GAHA,EAAQ,KAAK,GAAG,CAAM,EAGlB,EAAS,OAAS,EAAO,MAE7B,GAAU,EACV,GAAQ,CACV,CAQA,OANI,GAAQ,GACV,IACE,mBAAmB,EAAS,sBAAsB,EAAQ,4BAC5D,EAGK,CACT"}

package/dist/api.es.mjs

@@ -0,0 +1,28 @@
+//#region src/api/ApiError.ts
+var e = class extends Error {
+	status;
+	constructor(e, t) {
+		super(t), this.name = "ApiError", this.status = e;
+	}
+}, t = async (t, n) => {
+	let r = await fetch(t, {
+		credentials: "include",
+		...n
+	});
+	if (!r.ok) throw new e(r.status, `API request failed with status: ${r.status}`);
+	return await r.json();
+}, n = 50, r = 1e3, i = async (e, i = {}) => {
+	let { mapItem: a, limit: o = n, includeDrafts: s = !1, maxPages: c = r, onError: l } = i, u = [], d = 0, f = 0;
+	for (; f < c;) {
+		let n = (await t(`${e}${e.includes("?") ? "&" : "?"}limit=${o}&offset=${d}${s ? "&includeDrafts=true" : ""}`)).data ?? [];
+		if (n.length === 0) break;
+		let r = a ? n.map(a).filter((e) => e !== null) : n;
+		if (u.push(...r), n.length < o) break;
+		d += o, f += 1;
+	}
+	return f >= c && l?.(`Pagination cap (${c} pages) reached for ${e}; results may be truncated.`), u;
+};
+//#endregion
+export { e as ApiError, i as fetchAllPaginated, t as fetchJson };
+
+//# sourceMappingURL=api.es.mjs.map

package/dist/api.es.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.es.mjs","names":[],"sources":["../src/api/ApiError.ts","../src/api/fetchJson.ts","../src/api/fetchAllPaginated.ts"],"sourcesContent":["/**\n * Error thrown by the API layer when a request resolves with a non-2xx status.\n * Carries the HTTP status so callers can branch (e.g. distinguish 401/403 from\n * 5xx) instead of collapsing every failure into one generic message.\n */\nexport class ApiError extends Error {\n  public readonly status: number\n\n  /**\n   * Creates an ApiError carrying the failed response status.\n   * @param {number} status - The HTTP status code of the failed response.\n   * @param {string} message - A human-readable error message.\n   */\n  public constructor(status: number, message: string) {\n    super(message)\n    this.name = 'ApiError'\n    this.status = status\n  }\n}\n","import { ApiError } from './ApiError'\n\n/**\n * Fetches JSON from a URL using Staffbase session credentials.\n *\n * Throws {@link ApiError} (carrying the HTTP status) on a non-2xx response so\n * callers can branch on the status. Network/parse errors propagate as-is. This\n * helper does not log; the calling service layer owns error logging.\n * @template T The expected shape of the parsed JSON body.\n * @param {string} url - The API URL to fetch.\n * @param {RequestInit} [init] - Optional fetch overrides (merged after credentials).\n * @returns {Promise<T>} The parsed JSON body.\n * @throws {ApiError} When the response status is not ok.\n */\nexport const fetchJson = async <T>(\n  url: string,\n  init?: RequestInit,\n): Promise<T> => {\n  const response = await fetch(url, { credentials: 'include', ...init })\n\n  if (!response.ok) {\n    throw new ApiError(\n      response.status,\n      `API request failed with status: ${response.status}`,\n    )\n  }\n\n  return (await response.json()) as T\n}\n","import type { FetchAllPaginatedOptions } from '../types/api/FetchAllPaginatedOptions'\nimport { fetchJson } from './fetchJson'\n\nconst DEFAULT_LIMIT = 50\nconst DEFAULT_MAX_PAGES = 1000\n\n/**\n * Fetches every page of a Staffbase `{ data, total }` collection endpoint.\n *\n * Termination is driven by page contents (a short page ends the loop) rather\n * than the API's reported `total`, which avoids under-fetching when `total` is\n * under-reported. A `maxPages` cap bounds worst-case latency/memory; reaching it\n * invokes `onError` so the truncation is never silent.\n * @template TItem The mapped item type returned to the caller.\n * @template TSource The raw item type returned by the API before mapping.\n * @param {string} baseUrl - The base API URL (without limit/offset parameters).\n * @param {FetchAllPaginatedOptions<TItem, TSource>} [options] - Mapping and pagination options.\n * @returns {Promise<TItem[]>} All fetched (and optionally mapped) items.\n */\nexport const fetchAllPaginated = async <TItem, TSource = TItem>(\n  baseUrl: string,\n  options: FetchAllPaginatedOptions<TItem, TSource> = {},\n): Promise<TItem[]> => {\n  const {\n    mapItem,\n    limit = DEFAULT_LIMIT,\n    includeDrafts = false,\n    maxPages = DEFAULT_MAX_PAGES,\n    onError,\n  } = options\n\n  const results: TItem[] = []\n  let offset = 0\n  let page = 0\n\n  while (page < maxPages) {\n    const separator = baseUrl.includes('?') ? '&' : '?'\n    const draftsParam = includeDrafts ? '&includeDrafts=true' : ''\n    const url = `${baseUrl}${separator}limit=${limit}&offset=${offset}${draftsParam}`\n\n    const data = await fetchJson<{ data: TSource[]; total?: number }>(url)\n    const rawItems = data.data ?? []\n\n    if (rawItems.length === 0) break\n\n    const mapped = mapItem\n      ? rawItems.map(mapItem).filter((item): item is TItem => item !== null)\n      : (rawItems as unknown as TItem[])\n\n    results.push(...mapped)\n\n    // A short page means we reached the end of the collection.\n    if (rawItems.length < limit) break\n\n    offset += limit\n    page += 1\n  }\n\n  if (page >= maxPages) {\n    onError?.(\n      `Pagination cap (${maxPages} pages) reached for ${baseUrl}; results may be truncated.`,\n    )\n  }\n\n  return results\n}\n"],"mappings":";AAKA,IAAa,IAAb,cAA8B,MAAM;CAClC;CAOA,YAAmB,GAAgB,GAAiB;EAGlD,AAFA,MAAM,CAAO,GACb,KAAK,OAAO,YACZ,KAAK,SAAS;CAChB;AACF,GCJa,IAAY,OACvB,GACA,MACe;CACf,IAAM,IAAW,MAAM,MAAM,GAAK;EAAE,aAAa;EAAW,GAAG;CAAK,CAAC;CAErE,IAAI,CAAC,EAAS,IACZ,MAAM,IAAI,EACR,EAAS,QACT,mCAAmC,EAAS,QAC9C;CAGF,OAAQ,MAAM,EAAS,KAAK;AAC9B,GCzBM,IAAgB,IAChB,IAAoB,KAeb,IAAoB,OAC/B,GACA,IAAoD,CAAC,MAChC;CACrB,IAAM,EACJ,YACA,WAAQ,GACR,mBAAgB,IAChB,cAAW,GACX,eACE,GAEE,IAAmB,CAAC,GACtB,IAAS,GACT,IAAO;CAEX,OAAO,IAAO,IAAU;EAMtB,IAAM,KAAW,MADE,EAA+C,GAFnD,IAFG,EAAQ,SAAS,GAAG,IAAI,MAAM,IAEb,QAAQ,EAAM,UAAU,IADvC,IAAgB,wBAAwB,IAGS,GAC/C,QAAQ,CAAC;EAE/B,IAAI,EAAS,WAAW,GAAG;EAE3B,IAAM,IAAS,IACX,EAAS,IAAI,CAAO,EAAE,QAAQ,MAAwB,MAAS,IAAI,IAClE;EAKL,IAHA,EAAQ,KAAK,GAAG,CAAM,GAGlB,EAAS,SAAS,GAAO;EAG7B,AADA,KAAU,GACV,KAAQ;CACV;CAQA,OANI,KAAQ,KACV,IACE,mBAAmB,EAAS,sBAAsB,EAAQ,4BAC5D,GAGK;AACT"}

package/dist/content.cjs.js

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=()=>typeof document>`u`?null:(document.querySelector(`[aria-selected="true"]`)?.getAttribute(`data-testid`))?.split(`-`).pop()??null,t=()=>{if(typeof window>`u`)return null;let e=window.App?._urlParameters;return e?new URLSearchParams(e).get(`language`):null},n=n=>{let{contentLanguage:r,defaultLanguage:i,isEditor:a}=n,o=r??i;return a?e()??o:r??t()??o},r=(e,t)=>{let{defaultLanguage:r,onError:i}=t;if(!e)return i?.(`Invalid article data or missing contents`),null;let a=n(t),o=e[a]||e[r]||null;if(!o)return i?.(`Content unavailable for language: ${a} or fallback: ${r}`),null;let s=e[r];return{title:o.title||s?.title||``,teaser:o.teaser||s?.teaser||``,content:o.content||s?.content||``,image:o.image||s?.image||``,feedImage:o.feedImage||s?.feedImage||``}};exports.detectEditorLanguage=e,exports.detectPreviewLanguage=t,exports.resolveActiveLanguage=n,exports.resolveLocalizedContent=r;
+//# sourceMappingURL=content.cjs.js.map

package/dist/content.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.cjs.js","names":[],"sources":["../src/content/detectEditorLanguage.ts","../src/content/detectPreviewLanguage.ts","../src/content/resolveActiveLanguage.ts","../src/content/resolveLocalizedContent.ts"],"sourcesContent":["/**\n * Reads the active language from the Staffbase editor's selected language tab\n * (`[aria-selected=\"true\"]` with a `data-testid` suffixed by the language code).\n * Returns null when no tab is active or there is no DOM, so callers can fall back.\n * @returns {string | null} The detected editor language, or null.\n */\nexport const detectEditorLanguage = (): string | null => {\n  if (typeof document === 'undefined') return null\n\n  const activeTab = document.querySelector('[aria-selected=\"true\"]')\n  const testId = activeTab?.getAttribute('data-testid')\n\n  return testId?.split('-').pop() ?? null\n}\n","/**\n * Reads the `language` URL parameter the Staffbase preview shell exposes on\n * `window.App._urlParameters`. Returns null when the shell or parameter is\n * absent (or there is no DOM), so callers can fall back.\n * @returns {string | null} The preview language, or null.\n */\nexport const detectPreviewLanguage = (): string | null => {\n  if (typeof window === 'undefined') return null\n\n  const appConfig = (window as { App?: { _urlParameters?: string } }).App\n    ?._urlParameters\n  if (!appConfig) return null\n\n  return new URLSearchParams(appConfig).get('language')\n}\n","import type { ResolveLocalizedContentOptions } from '../types/content/ResolveLocalizedContentOptions'\nimport { detectEditorLanguage } from './detectEditorLanguage'\nimport { detectPreviewLanguage } from './detectPreviewLanguage'\n\n/**\n * Resolves the language to render content in.\n *\n * Editor path: the selected language tab wins. Runtime path: the explicit\n * `contentLanguage` is trusted first so the article language matches the rest of\n * the UI, with preview-URL sniffing only as a fallback. Both paths fall back to\n * `contentLanguage ?? defaultLanguage`.\n * @param {ResolveLocalizedContentOptions} options - The resolution options.\n * @returns {string} The resolved active language code.\n */\nexport const resolveActiveLanguage = (\n  options: ResolveLocalizedContentOptions,\n): string => {\n  const { contentLanguage, defaultLanguage, isEditor } = options\n  const fallback = contentLanguage ?? defaultLanguage\n\n  if (isEditor) return detectEditorLanguage() ?? fallback\n\n  return contentLanguage ?? detectPreviewLanguage() ?? fallback\n}\n","import type { LocalizedContent } from '../types/content/LocalizedContent'\nimport type { ResolveLocalizedContentOptions } from '../types/content/ResolveLocalizedContentOptions'\nimport { resolveActiveLanguage } from './resolveActiveLanguage'\n\n/**\n * Selects and field-merges the localized article content for the active language.\n *\n * Resolves the active language (see resolveActiveLanguage), picks that language's\n * content (falling back to the default language), then fills each field from the\n * default-language entry when the active one is empty. Returns null and reports\n * via `onError` when contents are missing or unavailable in both languages.\n * @param {Record<string, LocalizedContent> | undefined} contents - The article's per-language contents.\n * @param {ResolveLocalizedContentOptions} options - Language and diagnostics options.\n * @returns {LocalizedContent | null} The merged localized content, or null.\n */\nexport const resolveLocalizedContent = (\n  contents: Record<string, LocalizedContent> | undefined,\n  options: ResolveLocalizedContentOptions,\n): LocalizedContent | null => {\n  const { defaultLanguage, onError } = options\n\n  if (!contents) {\n    onError?.('Invalid article data or missing contents')\n    return null\n  }\n\n  const language = resolveActiveLanguage(options)\n  const localized = contents[language] || contents[defaultLanguage] || null\n\n  if (!localized) {\n    onError?.(\n      `Content unavailable for language: ${language} or fallback: ${defaultLanguage}`,\n    )\n    return null\n  }\n\n  const fallback = contents[defaultLanguage]\n\n  return {\n    title: localized.title || fallback?.title || '',\n    teaser: localized.teaser || fallback?.teaser || '',\n    content: localized.content || fallback?.content || '',\n    image: localized.image || fallback?.image || '',\n    feedImage: localized.feedImage || fallback?.feedImage || '',\n  }\n}\n"],"mappings":"mEAMA,IAAa,MACP,OAAO,SAAa,IAAoB,MAE1B,SAAS,cAAc,wBAC1B,GAAW,aAAa,aAAa,IAErC,MAAM,GAAG,EAAE,IAAI,GAAK,KCNxB,MAA6C,CACxD,GAAI,OAAO,OAAW,IAAa,OAAO,KAE1C,IAAM,EAAa,OAAiD,KAChE,eAGJ,OAFK,EAEE,IAAI,gBAAgB,CAAS,EAAE,IAAI,UAAU,EAF7B,IAGzB,ECAa,EACX,GACW,CACX,GAAM,CAAE,kBAAiB,kBAAiB,YAAa,EACjD,EAAW,GAAmB,EAIpC,OAFI,EAAiB,EAAqB,GAAK,EAExC,GAAmB,EAAsB,GAAK,CACvD,ECRa,GACX,EACA,IAC4B,CAC5B,GAAM,CAAE,kBAAiB,WAAY,EAErC,GAAI,CAAC,EAEH,OADA,IAAU,0CAA0C,EAC7C,KAGT,IAAM,EAAW,EAAsB,CAAO,EACxC,EAAY,EAAS,IAAa,EAAS,IAAoB,KAErE,GAAI,CAAC,EAIH,OAHA,IACE,qCAAqC,EAAS,gBAAgB,GAChE,EACO,KAGT,IAAM,EAAW,EAAS,GAE1B,MAAO,CACL,MAAO,EAAU,OAAS,GAAU,OAAS,GAC7C,OAAQ,EAAU,QAAU,GAAU,QAAU,GAChD,QAAS,EAAU,SAAW,GAAU,SAAW,GACnD,MAAO,EAAU,OAAS,GAAU,OAAS,GAC7C,UAAW,EAAU,WAAa,GAAU,WAAa,EAC3D,CACF"}

package/dist/content.es.mjs

@@ -0,0 +1,26 @@
+//#region src/content/detectEditorLanguage.ts
+var e = () => typeof document > "u" ? null : (document.querySelector("[aria-selected=\"true\"]")?.getAttribute("data-testid"))?.split("-").pop() ?? null, t = () => {
+	if (typeof window > "u") return null;
+	let e = window.App?._urlParameters;
+	return e ? new URLSearchParams(e).get("language") : null;
+}, n = (n) => {
+	let { contentLanguage: r, defaultLanguage: i, isEditor: a } = n, o = r ?? i;
+	return a ? e() ?? o : r ?? t() ?? o;
+}, r = (e, t) => {
+	let { defaultLanguage: r, onError: i } = t;
+	if (!e) return i?.("Invalid article data or missing contents"), null;
+	let a = n(t), o = e[a] || e[r] || null;
+	if (!o) return i?.(`Content unavailable for language: ${a} or fallback: ${r}`), null;
+	let s = e[r];
+	return {
+		title: o.title || s?.title || "",
+		teaser: o.teaser || s?.teaser || "",
+		content: o.content || s?.content || "",
+		image: o.image || s?.image || "",
+		feedImage: o.feedImage || s?.feedImage || ""
+	};
+};
+//#endregion
+export { e as detectEditorLanguage, t as detectPreviewLanguage, n as resolveActiveLanguage, r as resolveLocalizedContent };
+
+//# sourceMappingURL=content.es.mjs.map

package/dist/content.es.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.es.mjs","names":[],"sources":["../src/content/detectEditorLanguage.ts","../src/content/detectPreviewLanguage.ts","../src/content/resolveActiveLanguage.ts","../src/content/resolveLocalizedContent.ts"],"sourcesContent":["/**\n * Reads the active language from the Staffbase editor's selected language tab\n * (`[aria-selected=\"true\"]` with a `data-testid` suffixed by the language code).\n * Returns null when no tab is active or there is no DOM, so callers can fall back.\n * @returns {string | null} The detected editor language, or null.\n */\nexport const detectEditorLanguage = (): string | null => {\n  if (typeof document === 'undefined') return null\n\n  const activeTab = document.querySelector('[aria-selected=\"true\"]')\n  const testId = activeTab?.getAttribute('data-testid')\n\n  return testId?.split('-').pop() ?? null\n}\n","/**\n * Reads the `language` URL parameter the Staffbase preview shell exposes on\n * `window.App._urlParameters`. Returns null when the shell or parameter is\n * absent (or there is no DOM), so callers can fall back.\n * @returns {string | null} The preview language, or null.\n */\nexport const detectPreviewLanguage = (): string | null => {\n  if (typeof window === 'undefined') return null\n\n  const appConfig = (window as { App?: { _urlParameters?: string } }).App\n    ?._urlParameters\n  if (!appConfig) return null\n\n  return new URLSearchParams(appConfig).get('language')\n}\n","import type { ResolveLocalizedContentOptions } from '../types/content/ResolveLocalizedContentOptions'\nimport { detectEditorLanguage } from './detectEditorLanguage'\nimport { detectPreviewLanguage } from './detectPreviewLanguage'\n\n/**\n * Resolves the language to render content in.\n *\n * Editor path: the selected language tab wins. Runtime path: the explicit\n * `contentLanguage` is trusted first so the article language matches the rest of\n * the UI, with preview-URL sniffing only as a fallback. Both paths fall back to\n * `contentLanguage ?? defaultLanguage`.\n * @param {ResolveLocalizedContentOptions} options - The resolution options.\n * @returns {string} The resolved active language code.\n */\nexport const resolveActiveLanguage = (\n  options: ResolveLocalizedContentOptions,\n): string => {\n  const { contentLanguage, defaultLanguage, isEditor } = options\n  const fallback = contentLanguage ?? defaultLanguage\n\n  if (isEditor) return detectEditorLanguage() ?? fallback\n\n  return contentLanguage ?? detectPreviewLanguage() ?? fallback\n}\n","import type { LocalizedContent } from '../types/content/LocalizedContent'\nimport type { ResolveLocalizedContentOptions } from '../types/content/ResolveLocalizedContentOptions'\nimport { resolveActiveLanguage } from './resolveActiveLanguage'\n\n/**\n * Selects and field-merges the localized article content for the active language.\n *\n * Resolves the active language (see resolveActiveLanguage), picks that language's\n * content (falling back to the default language), then fills each field from the\n * default-language entry when the active one is empty. Returns null and reports\n * via `onError` when contents are missing or unavailable in both languages.\n * @param {Record<string, LocalizedContent> | undefined} contents - The article's per-language contents.\n * @param {ResolveLocalizedContentOptions} options - Language and diagnostics options.\n * @returns {LocalizedContent | null} The merged localized content, or null.\n */\nexport const resolveLocalizedContent = (\n  contents: Record<string, LocalizedContent> | undefined,\n  options: ResolveLocalizedContentOptions,\n): LocalizedContent | null => {\n  const { defaultLanguage, onError } = options\n\n  if (!contents) {\n    onError?.('Invalid article data or missing contents')\n    return null\n  }\n\n  const language = resolveActiveLanguage(options)\n  const localized = contents[language] || contents[defaultLanguage] || null\n\n  if (!localized) {\n    onError?.(\n      `Content unavailable for language: ${language} or fallback: ${defaultLanguage}`,\n    )\n    return null\n  }\n\n  const fallback = contents[defaultLanguage]\n\n  return {\n    title: localized.title || fallback?.title || '',\n    teaser: localized.teaser || fallback?.teaser || '',\n    content: localized.content || fallback?.content || '',\n    image: localized.image || fallback?.image || '',\n    feedImage: localized.feedImage || fallback?.feedImage || '',\n  }\n}\n"],"mappings":";AAMA,IAAa,UACP,OAAO,WAAa,MAAoB,QAE1B,SAAS,cAAc,0BAC1B,GAAW,aAAa,aAAa,IAErC,MAAM,GAAG,EAAE,IAAI,KAAK,MCNxB,UAA6C;CACxD,IAAI,OAAO,SAAW,KAAa,OAAO;CAE1C,IAAM,IAAa,OAAiD,KAChE;CAGJ,OAFK,IAEE,IAAI,gBAAgB,CAAS,EAAE,IAAI,UAAU,IAF7B;AAGzB,GCAa,KACX,MACW;CACX,IAAM,EAAE,oBAAiB,oBAAiB,gBAAa,GACjD,IAAW,KAAmB;CAIpC,OAFI,IAAiB,EAAqB,KAAK,IAExC,KAAmB,EAAsB,KAAK;AACvD,GCRa,KACX,GACA,MAC4B;CAC5B,IAAM,EAAE,oBAAiB,eAAY;CAErC,IAAI,CAAC,GAEH,OADA,IAAU,0CAA0C,GAC7C;CAGT,IAAM,IAAW,EAAsB,CAAO,GACxC,IAAY,EAAS,MAAa,EAAS,MAAoB;CAErE,IAAI,CAAC,GAIH,OAHA,IACE,qCAAqC,EAAS,gBAAgB,GAChE,GACO;CAGT,IAAM,IAAW,EAAS;CAE1B,OAAO;EACL,OAAO,EAAU,SAAS,GAAU,SAAS;EAC7C,QAAQ,EAAU,UAAU,GAAU,UAAU;EAChD,SAAS,EAAU,WAAW,GAAU,WAAW;EACnD,OAAO,EAAU,SAAS,GAAU,SAAS;EAC7C,WAAW,EAAU,aAAa,GAAU,aAAa;CAC3D;AACF"}

package/dist/src/api/ApiError.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Error thrown by the API layer when a request resolves with a non-2xx status.
+ * Carries the HTTP status so callers can branch (e.g. distinguish 401/403 from
+ * 5xx) instead of collapsing every failure into one generic message.
+ */
+export declare class ApiError extends Error {
+    readonly status: number;
+    /**
+     * Creates an ApiError carrying the failed response status.
+     * @param {number} status - The HTTP status code of the failed response.
+     * @param {string} message - A human-readable error message.
+     */
+    constructor(status: number, message: string);
+}
+//# sourceMappingURL=ApiError.d.ts.map

package/dist/src/api/ApiError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiError.d.ts","sourceRoot":"","sources":["../../../src/api/ApiError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,MAAM,EAAE,MAAM,CAAA;IAE9B;;;;OAIG;gBACgB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAKnD"}

package/dist/src/api/fetchAllPaginated.d.ts

@@ -0,0 +1,16 @@
+import { FetchAllPaginatedOptions } from '../types/api/FetchAllPaginatedOptions';
+/**
+ * Fetches every page of a Staffbase `{ data, total }` collection endpoint.
+ *
+ * Termination is driven by page contents (a short page ends the loop) rather
+ * than the API's reported `total`, which avoids under-fetching when `total` is
+ * under-reported. A `maxPages` cap bounds worst-case latency/memory; reaching it
+ * invokes `onError` so the truncation is never silent.
+ * @template TItem The mapped item type returned to the caller.
+ * @template TSource The raw item type returned by the API before mapping.
+ * @param {string} baseUrl - The base API URL (without limit/offset parameters).
+ * @param {FetchAllPaginatedOptions<TItem, TSource>} [options] - Mapping and pagination options.
+ * @returns {Promise<TItem[]>} All fetched (and optionally mapped) items.
+ */
+export declare const fetchAllPaginated: <TItem, TSource = TItem>(baseUrl: string, options?: FetchAllPaginatedOptions<TItem, TSource>) => Promise<TItem[]>;
+//# sourceMappingURL=fetchAllPaginated.d.ts.map

package/dist/src/api/fetchAllPaginated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchAllPaginated.d.ts","sourceRoot":"","sources":["../../../src/api/fetchAllPaginated.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAA;AAMrF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,GAAU,KAAK,EAAE,OAAO,GAAG,KAAK,EAC5D,SAAS,MAAM,EACf,UAAS,wBAAwB,CAAC,KAAK,EAAE,OAAO,CAAM,KACrD,OAAO,CAAC,KAAK,EAAE,CA2CjB,CAAA"}

package/dist/src/api/fetchJson.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Fetches JSON from a URL using Staffbase session credentials.
+ *
+ * Throws {@link ApiError} (carrying the HTTP status) on a non-2xx response so
+ * callers can branch on the status. Network/parse errors propagate as-is. This
+ * helper does not log; the calling service layer owns error logging.
+ * @template T The expected shape of the parsed JSON body.
+ * @param {string} url - The API URL to fetch.
+ * @param {RequestInit} [init] - Optional fetch overrides (merged after credentials).
+ * @returns {Promise<T>} The parsed JSON body.
+ * @throws {ApiError} When the response status is not ok.
+ */
+export declare const fetchJson: <T>(url: string, init?: RequestInit) => Promise<T>;
+//# sourceMappingURL=fetchJson.d.ts.map

package/dist/src/api/fetchJson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchJson.d.ts","sourceRoot":"","sources":["../../../src/api/fetchJson.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,SAAS,GAAU,CAAC,EAC/B,KAAK,MAAM,EACX,OAAO,WAAW,KACjB,OAAO,CAAC,CAAC,CAWX,CAAA"}

package/dist/src/api/index.d.ts

@@ -0,0 +1,4 @@
+export { ApiError } from './ApiError';
+export { fetchAllPaginated } from './fetchAllPaginated';
+export { fetchJson } from './fetchJson';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA"}

package/dist/src/content/detectEditorLanguage.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Reads the active language from the Staffbase editor's selected language tab
+ * (`[aria-selected="true"]` with a `data-testid` suffixed by the language code).
+ * Returns null when no tab is active or there is no DOM, so callers can fall back.
+ * @returns {string | null} The detected editor language, or null.
+ */
+export declare const detectEditorLanguage: () => string | null;
+//# sourceMappingURL=detectEditorLanguage.d.ts.map

package/dist/src/content/detectEditorLanguage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectEditorLanguage.d.ts","sourceRoot":"","sources":["../../../src/content/detectEditorLanguage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,QAAO,MAAM,GAAG,IAOhD,CAAA"}

package/dist/src/content/detectPreviewLanguage.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Reads the `language` URL parameter the Staffbase preview shell exposes on
+ * `window.App._urlParameters`. Returns null when the shell or parameter is
+ * absent (or there is no DOM), so callers can fall back.
+ * @returns {string | null} The preview language, or null.
+ */
+export declare const detectPreviewLanguage: () => string | null;
+//# sourceMappingURL=detectPreviewLanguage.d.ts.map

package/dist/src/content/detectPreviewLanguage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectPreviewLanguage.d.ts","sourceRoot":"","sources":["../../../src/content/detectPreviewLanguage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,QAAO,MAAM,GAAG,IAQjD,CAAA"}

package/dist/src/content/index.d.ts

@@ -0,0 +1,6 @@
+export { detectEditorLanguage } from './detectEditorLanguage';
+export { detectPreviewLanguage } from './detectPreviewLanguage';
+export { resolveActiveLanguage } from './resolveActiveLanguage';
+export { resolveLocalizedContent } from './resolveLocalizedContent';
+export type { ResolveLocalizedContentOptions } from '../types/content/ResolveLocalizedContentOptions';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/content/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/content/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AACnE,YAAY,EAAE,8BAA8B,EAAE,MAAM,iDAAiD,CAAA"}

package/dist/src/content/resolveActiveLanguage.d.ts

@@ -0,0 +1,13 @@
+import { ResolveLocalizedContentOptions } from '../types/content/ResolveLocalizedContentOptions';
+/**
+ * Resolves the language to render content in.
+ *
+ * Editor path: the selected language tab wins. Runtime path: the explicit
+ * `contentLanguage` is trusted first so the article language matches the rest of
+ * the UI, with preview-URL sniffing only as a fallback. Both paths fall back to
+ * `contentLanguage ?? defaultLanguage`.
+ * @param {ResolveLocalizedContentOptions} options - The resolution options.
+ * @returns {string} The resolved active language code.
+ */
+export declare const resolveActiveLanguage: (options: ResolveLocalizedContentOptions) => string;
+//# sourceMappingURL=resolveActiveLanguage.d.ts.map

package/dist/src/content/resolveActiveLanguage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveActiveLanguage.d.ts","sourceRoot":"","sources":["../../../src/content/resolveActiveLanguage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,iDAAiD,CAAA;AAIrG;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,GAChC,SAAS,8BAA8B,KACtC,MAOF,CAAA"}

package/dist/src/content/resolveLocalizedContent.d.ts

@@ -0,0 +1,15 @@
+import { LocalizedContent } from '../types/content/LocalizedContent';
+import { ResolveLocalizedContentOptions } from '../types/content/ResolveLocalizedContentOptions';
+/**
+ * Selects and field-merges the localized article content for the active language.
+ *
+ * Resolves the active language (see resolveActiveLanguage), picks that language's
+ * content (falling back to the default language), then fills each field from the
+ * default-language entry when the active one is empty. Returns null and reports
+ * via `onError` when contents are missing or unavailable in both languages.
+ * @param {Record<string, LocalizedContent> | undefined} contents - The article's per-language contents.
+ * @param {ResolveLocalizedContentOptions} options - Language and diagnostics options.
+ * @returns {LocalizedContent | null} The merged localized content, or null.
+ */
+export declare const resolveLocalizedContent: (contents: Record<string, LocalizedContent> | undefined, options: ResolveLocalizedContentOptions) => LocalizedContent | null;
+//# sourceMappingURL=resolveLocalizedContent.d.ts.map

package/dist/src/content/resolveLocalizedContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveLocalizedContent.d.ts","sourceRoot":"","sources":["../../../src/content/resolveLocalizedContent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAA;AACzE,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,iDAAiD,CAAA;AAGrG;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,SAAS,EACtD,SAAS,8BAA8B,KACtC,gBAAgB,GAAG,IA2BrB,CAAA"}

package/dist/src/types/api/FetchAllPaginatedOptions.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Options for fetchAllPaginated.
+ * @template TItem The mapped item type returned to the caller.
+ * @template TSource The raw item type returned by the API before mapping.
+ */
+export interface FetchAllPaginatedOptions<TItem, TSource = TItem> {
+    /**
+     * Maps/filters each raw API item. Return null to drop an item. When omitted,
+     * raw items are returned unchanged (TSource is assumed assignable to TItem).
+     * @param {TSource} item - The raw item from the API page.
+     * @returns {TItem | null} The mapped item, or null to skip it.
+     */
+    mapItem?: (item: TSource) => TItem | null;
+    /** Page size requested per call (default 50). */
+    limit?: number;
+    /** When true, appends `includeDrafts=true` to each request URL. */
+    includeDrafts?: boolean;
+    /**
+     * Hard cap on the number of pages fetched (default 1000), a runaway backstop.
+     * Lower it to bound first-paint latency on very large collections.
+     */
+    maxPages?: number;
+    /**
+     * Called with a diagnostic message when the maxPages cap is hit (so truncation
+     * is never silent). Injected because the library does not log directly.
+     * @param {string} message - The truncation diagnostic message.
+     * @returns {void} Nothing.
+     */
+    onError?: (message: string) => void;
+}
+//# sourceMappingURL=FetchAllPaginatedOptions.d.ts.map

package/dist/src/types/api/FetchAllPaginatedOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FetchAllPaginatedOptions.d.ts","sourceRoot":"","sources":["../../../../src/types/api/FetchAllPaginatedOptions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK;IAC9D;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,KAAK,GAAG,IAAI,CAAA;IACzC,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mEAAmE;IACnE,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACpC"}

package/dist/src/types/content/ArticleImage.d.ts

@@ -0,0 +1,17 @@
+import { ArticleImageVariant } from './ArticleImageVariant';
+/**
+ * The set of rendition variants the Staffbase media API returns for an article
+ * image. Named `ArticleImage` (not `Image`) to avoid shadowing the DOM global.
+ */
+export interface ArticleImage {
+    original: ArticleImageVariant & {
+        size: number;
+    };
+    original_scaled: ArticleImageVariant;
+    thumb: ArticleImageVariant;
+    wide: ArticleImageVariant;
+    compact: ArticleImageVariant;
+    wide_first: ArticleImageVariant;
+    compact_first: ArticleImageVariant;
+}
+//# sourceMappingURL=ArticleImage.d.ts.map

package/dist/src/types/content/ArticleImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArticleImage.d.ts","sourceRoot":"","sources":["../../../../src/types/content/ArticleImage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAEhE;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,mBAAmB,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAChD,eAAe,EAAE,mBAAmB,CAAA;IACpC,KAAK,EAAE,mBAAmB,CAAA;IAC1B,IAAI,EAAE,mBAAmB,CAAA;IACzB,OAAO,EAAE,mBAAmB,CAAA;IAC5B,UAAU,EAAE,mBAAmB,CAAA;IAC/B,aAAa,EAAE,mBAAmB,CAAA;CACnC"}

package/dist/src/types/content/ArticleImageVariant.d.ts

@@ -0,0 +1,13 @@
+/**
+ * A single rendition of an article image (a size/format variant returned by the
+ * Staffbase media API). `size` is only present on the original variant.
+ */
+export interface ArticleImageVariant {
+    width: number;
+    height: number;
+    size?: number;
+    format: string | null;
+    mimeType: string | null;
+    url: string;
+}
+//# sourceMappingURL=ArticleImageVariant.d.ts.map

package/dist/src/types/content/ArticleImageVariant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArticleImageVariant.d.ts","sourceRoot":"","sources":["../../../../src/types/content/ArticleImageVariant.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,GAAG,EAAE,MAAM,CAAA;CACZ"}

package/dist/src/types/content/LocalizedContent.d.ts

@@ -0,0 +1,16 @@
+import { ArticleImage } from './ArticleImage';
+/**
+ * The per-language content of an article (one entry of `ArticleData.contents`).
+ *
+ * `image` is `ArticleImage | string | null` because the API returns either the
+ * structured rendition set, a bare URL string, or nothing. Shared verbatim by
+ * the alerts and unacknowledged-bulletins widgets.
+ */
+export interface LocalizedContent {
+    title: string;
+    teaser: string;
+    content: string;
+    image: ArticleImage | string | null;
+    feedImage: string | null;
+}
+//# sourceMappingURL=LocalizedContent.d.ts.map

package/dist/src/types/content/LocalizedContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalizedContent.d.ts","sourceRoot":"","sources":["../../../../src/types/content/LocalizedContent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAElD;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAAA;IACnC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB"}

package/dist/src/types/content/ResolveLocalizedContentOptions.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Options for resolveLocalizedContent.
+ */
+export interface ResolveLocalizedContentOptions {
+    /**
+     * Language explicitly requested by the host/widget config. On the runtime path
+     * this is trusted first so the article language matches the rest of the UI;
+     * DOM/URL sniffing is only a fallback.
+     */
+    contentLanguage?: string;
+    /** Fallback language. Injected because the library never reads env. */
+    defaultLanguage: string;
+    /** When true, resolves the active language from the editor's selected tab. */
+    isEditor?: boolean;
+    /**
+     * Called with a diagnostic message when content cannot be resolved (the
+     * library does not log directly).
+     * @param {string} message - The diagnostic message.
+     * @param {...unknown} args - Optional extra context.
+     * @returns {void} Nothing.
+     */
+    onError?: (message: string, ...args: unknown[]) => void;
+}
+//# sourceMappingURL=ResolveLocalizedContentOptions.d.ts.map

package/dist/src/types/content/ResolveLocalizedContentOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResolveLocalizedContentOptions.d.ts","sourceRoot":"","sources":["../../../../src/types/content/ResolveLocalizedContentOptions.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,uEAAuE;IACvE,eAAe,EAAE,MAAM,CAAA;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;CACxD"}

package/dist/src/types/content/index.d.ts

@@ -1,5 +1,8 @@
+export type { ArticleImage } from './ArticleImage';
+export type { ArticleImageVariant } from './ArticleImageVariant';
 export type { Channel } from './Channel';
 export type { ChannelLink } from './ChannelLink';
 export type { ChannelLinkParameter } from './ChannelLinkParameter';
 export type { DropdownOption } from './DropdownOption';
+export type { LocalizedContent } from './LocalizedContent';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/types/content/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/content/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAClE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/content/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAChE,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAClE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@favish/staffbase-utils",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "Shared internal/host utilities for Staffbase widgets",
   "author": "Favish <dev@favish.com>",
   "license": "UNLICENSED",
@@ -8,6 +8,16 @@
     "dist"
   ],
   "exports": {
+    "./api": {
+      "types": "./dist/src/api/index.d.ts",
+      "import": "./dist/api.es.mjs",
+      "require": "./dist/api.cjs.js"
+    },
+    "./content": {
+      "types": "./dist/src/content/index.d.ts",
+      "import": "./dist/content.es.mjs",
+      "require": "./dist/content.cjs.js"
+    },
     "./log": {
       "types": "./dist/src/log/index.d.ts",
       "import": "./dist/log.es.mjs",