@redocly/redoc-reef 0.138.0-next.13 → 0.138.0-next.14

package/dist/server/utils/async/promise-map-limit-with-status.js

@@ -1 +0,0 @@
-import{promiseMapLimit as f}from"./promise-map-limit.js";async function m(s,i,n,a){const t=await f(s,i,async r=>{try{return await n(r),{status:"ok"}}catch(o){const e=o instanceof Error?o:new Error(String(o));return a?.error("Processing failed for item:",e),{status:"error",error:e}}}),c=t.filter(r=>r.status==="ok").length,u=t.filter(r=>r.status==="error").length;return{result:t,count:{ok:c,failed:u}}}export{m as promiseMapLimitWithStatus};

package/dist/server/utils/async/promise-map-limit.d.ts

@@ -1,15 +0,0 @@
-/**
- * Executes an asynchronous iterator function over an array with limited concurrency.
- *
- * This utility ensures that no more than `poolLimit` promises run at the same time.
- * Once a promise resolves, the next item in the array is processed.
- *
- * @template T - Type of the input array items.
- * @template P - Type of the resolved values.
- * @param array - The array of items to iterate over.
- * @param poolLimit - Maximum number of concurrent promises.
- * @param iteratorFn - Async function applied to each item.
- * @returns Promise that resolves to an array of results, preserving input order.
- */
-export declare function promiseMapLimit<T, P>(array: T[], poolLimit: number, iteratorFn: (arg: T, array: T[]) => Promise<P>): Promise<P[]>;
-//# sourceMappingURL=promise-map-limit.d.ts.map

package/dist/server/utils/async/promise-map-limit.js

@@ -1 +0,0 @@
-async function f(t,n,c){const s=[],e=[];for(const r of t){const i=Promise.resolve().then(()=>c(r,t));if(s.push(i),n<=t.length){const o=i.then(()=>e.splice(e.indexOf(o),1));e.push(o),e.length>=n&&await Promise.race(e)}}return Promise.all(s)}export{f as promiseMapLimit};

package/dist/server/utils/attribute-parser.d.ts

@@ -1,2 +0,0 @@
-export declare function parseSrcSet(srcSet: string): Map<string, string>;
-//# sourceMappingURL=attribute-parser.d.ts.map

package/dist/server/utils/attribute-parser.js

@@ -1 +0,0 @@
-function p(r){const t=new Map,s=r.split(", ");for(const e of s){const[n,o]=e.split(" ");t.set(o,n)}return t}export{p as parseSrcSet};

package/dist/server/utils/billing.d.ts

@@ -1,9 +0,0 @@
-/**
- * Counts the number of billable pages by filtering out ignored paths
- * @param routes Array of routes from store.getAllRoutes()
- * @returns Number of billable pages
- */
-export declare function getBilledPagesCount(routes: Array<{
-    slug: string;
-}>): number;
-//# sourceMappingURL=billing.d.ts.map

package/dist/server/utils/billing.js

@@ -1 +0,0 @@
-import{isSystemRouteSlug as l}from"./system-routes.js";function r(t){return t.filter(e=>!l(e.slug)).length}export{r as getBilledPagesCount};

package/dist/server/utils/catalog-classic/get-catalog-shared-data-id.d.ts

@@ -1,3 +0,0 @@
-/** Id of the shared data that holds a classic catalog's resolved items; `localeIdSuffix` is empty for the default locale. */
-export declare function getCatalogSharedDataId(catalogId: string, localeIdSuffix?: string): string;
-//# sourceMappingURL=get-catalog-shared-data-id.d.ts.map

package/dist/server/utils/catalog-classic/get-catalog-shared-data-id.js

@@ -1 +0,0 @@
-function e(a,t=""){return`catalog-${a}${t}`}export{e as getCatalogSharedDataId};

package/dist/server/utils/catalog-classic/get-route-slug-to-catalog-slug-map.d.ts

@@ -1,19 +0,0 @@
-import type { CatalogConfig } from '@redocly/config';
-import type { AfterRoutesCreatedActions, LifecycleContext } from '../../types';
-/**
- * Builds a mapping from route slugs to their corresponding catalog slugs.
- *
- * Iterates through all provided catalog configs, resolves their navigation items,
- * and collects route slugs from the resolved items to create a map that
- * associates each route slug with its parent catalog slug.
- *
- * @param actions - Actions available after routes have been created, providing
- *   access to content directory and route resolution utilities
- * @param context - Lifecycle context containing filesystem, cache, and logger
- *   utilities needed for resolving navigation items
- * @param catalogConfigs - Record of catalog configuration objects
- * @returns Promise that resolves to a Map where keys are route slugs and values
- *   are the corresponding catalog slugs
- */
-export declare function getRouteSlugToCatalogSlugMap(actions: AfterRoutesCreatedActions, context: LifecycleContext, catalogConfigs: Record<string, CatalogConfig>): Promise<Map<string, string>>;
-//# sourceMappingURL=get-route-slug-to-catalog-slug-map.d.ts.map

package/dist/server/utils/catalog-classic/get-route-slug-to-catalog-slug-map.js

@@ -1 +0,0 @@
-import{resolveItems as g}from"../../plugins/nav-utils.js";import{collectPropValueDeep as n}from"../../../utils/tree/collect-prop-value-deep.js";async function i(o,r,u){const t=new Map;for(const e of Object.values(u)){const l=await g(e.items,o.contentDir,o,r,{navFile:""});if(l){const s=n(l,"routeSlug");for(const a of s)t.set(a,e.slug)}}return t}export{i as getRouteSlugToCatalogSlugMap};

package/dist/server/utils/catalog-classic/get-route-slug-to-catalog-slug-map.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=get-route-slug-to-catalog-slug-map.test.d.ts.map

package/dist/server/utils/catalog-classic/get-route-slug-to-catalog-slug-map.test.js

@@ -1 +0,0 @@
-import{describe as d,it as u,expect as t,vi as e,beforeEach as m}from"vitest";import{getRouteSlugToCatalogSlugMap as r}from"./get-route-slug-to-catalog-slug-map.js";import{resolveItems as s}from"../../plugins/nav-utils.js";import{collectPropValueDeep as n}from"../../../utils/tree/collect-prop-value-deep.js";e.mock("~/server/plugins/nav-utils.js"),e.mock("~/shared/utils/tree/collect-prop-value-deep.js"),d("getRouteSlugToCatalogSlugMap",()=>{let g,c;m(()=>{e.clearAllMocks(),g={contentDir:"/content",outdir:"/out",serverOutDir:"/server-out",hasSitemap:!1,createSharedData:e.fn(),addRouteSharedData:e.fn(),getRouteByFsPath:e.fn(),getRouteBySlug:e.fn(),getConfig:e.fn(),getGlobalConfig:e.fn(),getAllRoutes:e.fn(),getAllRoutesForLocale:e.fn(),getAllApiRoutes:e.fn(),setGlobalData:e.fn(),getGlobalData:e.fn(),setGlobalConfig:e.fn(),parseMarkdoc:e.fn(),setSearchFacets:e.fn(),getSearchFacets:e.fn(),setSearchEngine:e.fn(),addRedirect:e.fn(),addBrowserPlugin:e.fn(),addSsrComponents:e.fn(),addApiRoute:e.fn(),loadApiDocuments:e.fn(),getRouteSharedDataByFsPath:e.fn()},c={fs:{},cache:{},getConfig:e.fn(),isPathIgnored:e.fn(),withPathPrefix:e.fn(),logger:{}}}),u("should return empty map when catalogs object is empty",async()=>{const a=await r(g,c,{});t(a).toBeInstanceOf(Map),t(a.size).toBe(0),t(s).not.toHaveBeenCalled()}),u("should return empty map when catalog has no resolved items",async()=>{const o={catalog1:{slug:"catalog1",items:[]}};e.mocked(s).mockResolvedValue(void 0);const a=await r(g,c,o);t(a).toBeInstanceOf(Map),t(a.size).toBe(0),t(s).toHaveBeenCalledTimes(1),t(n).not.toHaveBeenCalled()}),u("should map route slugs to catalog slug for single catalog with items",async()=>{const o={catalog1:{slug:"catalog1",items:[]}},a=[{routeSlug:"/page1",label:"Page 1"},{routeSlug:"/page2",label:"Page 2"}];e.mocked(s).mockResolvedValue(a),e.mocked(n).mockReturnValue(["/page1","/page2"]);const l=await r(g,c,o);t(l.size).toBe(2),t(l.get("/page1")).toBe("catalog1"),t(l.get("/page2")).toBe("catalog1"),t(s).toHaveBeenCalledWith(o.catalog1.items,g.contentDir,g,c,{navFile:""}),t(n).toHaveBeenCalledWith(a,"routeSlug")}),u("should map route slugs to catalog slug for multiple catalogs",async()=>{const o={catalog1:{slug:"catalog1",items:[]},catalog2:{slug:"catalog2",items:[]}},a=[{routeSlug:"/page1",label:"Page 1"}],l=[{routeSlug:"/page2",label:"Page 2"},{routeSlug:"/page3",label:"Page 3"}];e.mocked(s).mockResolvedValueOnce(a).mockResolvedValueOnce(l),e.mocked(n).mockReturnValueOnce(["/page1"]).mockReturnValueOnce(["/page2","/page3"]);const i=await r(g,c,o);t(i.size).toBe(3),t(i.get("/page1")).toBe("catalog1"),t(i.get("/page2")).toBe("catalog2"),t(i.get("/page3")).toBe("catalog2"),t(s).toHaveBeenCalledTimes(2),t(n).toHaveBeenCalledTimes(2)}),u("should handle catalog with empty resolved items array",async()=>{const o={catalog1:{slug:"catalog1",items:[]}};e.mocked(s).mockResolvedValue([]),e.mocked(n).mockReturnValue([]);const a=await r(g,c,o);t(a.size).toBe(0),t(s).toHaveBeenCalledTimes(1),t(n).toHaveBeenCalledWith([],"routeSlug")}),u("should handle nested items with route slugs",async()=>{const o={catalog1:{slug:"catalog1",items:[]}},a=[{routeSlug:"/parent",label:"Parent",items:[{routeSlug:"/parent/child1",label:"Child 1"},{routeSlug:"/parent/child2",label:"Child 2"}]}];e.mocked(s).mockResolvedValue(a),e.mocked(n).mockReturnValue(["/parent","/parent/child1","/parent/child2"]);const l=await r(g,c,o);t(l.size).toBe(3),t(l.get("/parent")).toBe("catalog1"),t(l.get("/parent/child1")).toBe("catalog1"),t(l.get("/parent/child2")).toBe("catalog1")}),u("should handle items without routeSlug property",async()=>{const o={catalog1:{slug:"catalog1",items:[]}},a=[{label:"Page without route slug"},{routeSlug:"/page-with-slug",label:"Page with slug"}];e.mocked(s).mockResolvedValue(a),e.mocked(n).mockReturnValue(["/page-with-slug"]);const l=await r(g,c,o);t(l.size).toBe(1),t(l.get("/page-with-slug")).toBe("catalog1")}),u("should overwrite route slug mapping when same route slug appears in multiple catalogs",async()=>{const o={catalog1:{slug:"catalog1",items:[]},catalog2:{slug:"catalog2",items:[]}},a=[{routeSlug:"/shared-page",label:"Shared Page"}],l=[{routeSlug:"/shared-page",label:"Shared Page"}];e.mocked(s).mockResolvedValueOnce(a).mockResolvedValueOnce(l),e.mocked(n).mockReturnValueOnce(["/shared-page"]).mockReturnValueOnce(["/shared-page"]);const i=await r(g,c,o);t(i.size).toBe(1),t(i.get("/shared-page")).toBe("catalog2")})});

package/dist/server/utils/codeframes/codeframes.d.ts

@@ -1,7 +0,0 @@
-import type { LocationEdge } from '@markdoc/markdoc';
-import type { NormalizedLocation } from '../../plugins/markdown/errors';
-export declare function getCodeframe(location: NormalizedLocation, color: boolean, indent?: string): {
-    frame: string;
-    start: LocationEdge;
-};
-//# sourceMappingURL=codeframes.d.ts.map

package/dist/server/utils/codeframes/codeframes.js

@@ -1,2 +0,0 @@
-import{createColors as d}from"colorette";import*as _ from"../../tools/notifiers/helpers/colors.js";let{gray:g,red:M,colorsAreEnabled:y}=_;const A=120,k=3;function X(e,t,i=""){const f=!t||!y;t||({gray:g,red:M}=d({useColor:!1}));const{start:c,end:o,lines:n}=e;if(c.line===0)return{frame:"",start:{line:1,character:1}};const u=c.line,s=Math.max(Math.min(o.line??1,n.length),c.line);let l=Math.max(s-u-k+1,0);l<2&&(l=0);const m=[];let b=0;for(let r=u;r<=s&&!(l>0&&r>=s-l);r++){const a=n[r-1]||"";a!==""&&(b=$(a));let h=r===u?c.character-1:b,L=r===s?o.character-1:a.length;m.push([`${r}`,p(a,h,L,M)]),f&&m.push(["",C(a,h,L)])}l>0&&(m.push(["\u2026",`${E(b)}${g(`< ${l} more lines >`)}`]),m.push([`${s}`,p(n[s-1],-1,o.character-1,M)]),f&&m.push(["",C(n[s-1],-1,o.character-1)]));const N=P([[`${u-2}`,p(n[u-1-2])],[`${u-1}`,p(n[u-1-1])],...m,[`${s+1}`,p(n[s-1+1])],[`${s+2}`,p(n[s-1+2])]],i);return{gray:g,red:M}=_,{frame:N,start:c};function p(r,a=-1,h=1/0,L=g){return f||!r?r:(a===-1&&(a=$(r)),h=Math.min(h,r.length),r.substr(0,a)+L(r.substring(a,h))+r.substr(h))}}function P(e,t=""){const i=e.filter(([o,n])=>n!==void 0),f=Math.max(...i.map(([o])=>o.length)),c=Math.min(...i.map(([o,n])=>n===""?1/0:$(n)));return i.map(([o,n])=>t+g(w(f,o)+" |")+(n?" "+S(n.substring(c)):"")).join(`
-`)}function w(e,t){return E(e-t.length)+t}function $(e){for(let t=0;t<e.length;t++)if(e[t]!==" ")return t;return e.length}function E(e){return" ".repeat(e)}function S(e,t=A){const i=e.length-t;if(i>0){const f=g(`...<${i} chars>`);return e.substring(0,t-f.length)+f}else return e}function C(e,t=-1,i=1/0){return t===-1&&(t=$(e)),i=Math.min(i,e.length),E(t)+"^".repeat(Math.max(i-t,1))}export{X as getCodeframe};

package/dist/server/utils/codeframes/yaml-ast.d.ts

@@ -1,6 +0,0 @@
-import type { LocationEdge } from '@markdoc/markdoc';
-export declare function getYamlLocationByPointer(source: string, pointer: (string | number)[], reportOnKey?: boolean): {
-    start: Required<LocationEdge>;
-    end: Required<LocationEdge>;
-} | undefined;
-//# sourceMappingURL=yaml-ast.d.ts.map

package/dist/server/utils/codeframes/yaml-ast.js

@@ -1,2 +0,0 @@
-import*as f from"yaml-ast-parser";function l(r,t,a){const n=d(r),e=c(n,t,a);if(e)return u(r,e.startPosition,e.endPosition)}function c(r,t,a){if(r===void 0)return;let n=r;for(const e of t)if(n.kind===f.Kind.MAP){const i=n.mappings.find(s=>s.key.value===e);if(!i||(n=i,!i?.value))break;n=i.value}else if(n.kind===f.Kind.SEQ){const i=n.items[parseInt(e.toString(),10)];if(!i)break;n=i}if(a){const e=n.parent;return!e||e.kind===f.Kind.SEQ?n:e.kind===f.Kind.MAPPING?e.key:n}else return n}function d(r){const t=f.safeLoad(r)??void 0;return t&&t.kind===0&&t.value===""&&t.startPosition!==1&&(t.startPosition=1,t.endPosition=1),t}function u(r,t,a){let n=1,e=1,i={line:1,character:1};for(let o=0;o<a-1;o++){if(o===t-1&&(i={line:n,character:e+1}),r[o]===`
-`){n++,e=1,o===t-1&&(i={line:n,character:e}),r[o+1]==="\r"&&o++;continue}e++}const s=t===a?{...i}:{line:n,character:e+1};return{start:i,end:s}}export{l as getYamlLocationByPointer};

package/dist/server/utils/content/is-react-page.d.ts

@@ -1,13 +0,0 @@
-/**
- * Determines whether the given relative file path represents
- * a React page file
- *
- * Examples:
- *   isReactPage("docs/index.page.tsx") → true
- *   isReactPage("readme.md") → false
- *
- * @param relativePath - Path relative to the content root
- * @returns `true` if the file matches the React page pattern, otherwise `false`
- */
-export declare const isReactPage: (relativePath: string) => boolean;
-//# sourceMappingURL=is-react-page.d.ts.map

package/dist/server/utils/content/is-react-page.js

@@ -1 +0,0 @@
-const t=e=>e?/\.page\.tsx?$/i.test(e):!1;export{t as isReactPage};

package/dist/server/utils/cookie.d.ts

@@ -1,11 +0,0 @@
-import type { Context } from 'hono';
-export declare function clearAuthCookies(ctx: Context): void;
-export declare function setPostLogoutCookie(ctx: Context): void;
-export declare function clearPostLogoutCookie(ctx: Context): void;
-export declare function hasPostLogoutCookie(ctx: Context): boolean;
-export declare function safeDecodeURIComponent(value: string): string;
-/**
- * Parses cookie header string according to RFC 6265
- */
-export declare function parseCookieHeader(ctx: Context): Map<string, string>;
-//# sourceMappingURL=cookie.d.ts.map

package/dist/server/utils/cookie.js

@@ -1 +0,0 @@
-import{deleteCookie as a,getCookie as m,setCookie as C}from"hono/cookie";import{getPathPrefix as n}from"@redocly/theme/core/utils";import{AuthCookieNames as O,POST_LOGOUT_COOKIE_EXPIRATION as h,POST_LOGOUT_COOKIE_NAME as i}from"../../constants/common.js";function x(o){const e=n()||"/";for(const t of Object.values(O))a(o,t,{path:e})}function I(o){C(o,i,"1",{path:n()||"/",httpOnly:!0,maxAge:h})}function _(o){l(o)&&a(o,i,{path:n()||"/"})}function l(o){return o.get("cookies")?.[i]==="1"}function c(o){try{return decodeURIComponent(o)}catch{return o}}function A(o){const e=new Map,t=o.req.header("cookie")||"";return t&&t.split(";").forEach(u=>{const[p,...f]=u.split("="),r=p?.trim();if(!r)return;const k=f.join("=").trim();try{const s=m(o,r);if(!s)return;e.set(c(r),s)}catch{e.set(c(r),c(k))}}),e}export{x as clearAuthCookies,_ as clearPostLogoutCookie,l as hasPostLogoutCookie,A as parseCookieHeader,c as safeDecodeURIComponent,I as setPostLogoutCookie};

package/dist/server/utils/crypto/constants.d.ts

@@ -1,5 +0,0 @@
-export declare const IV_LENGTH_BYTES = 12;
-export declare const AUTH_TAG_LENGTH_BYTES = 16;
-/** Marks a JWT claim value as encrypted; unprefixed values are legacy plaintext. */
-export declare const ENCRYPTED_CLAIM_PREFIX = "enc.v1.";
-//# sourceMappingURL=constants.d.ts.map

package/dist/server/utils/crypto/constants.js

@@ -1 +0,0 @@
-const E=12,T=16,_="enc.v1.";export{T as AUTH_TAG_LENGTH_BYTES,_ as ENCRYPTED_CLAIM_PREFIX,E as IV_LENGTH_BYTES};

package/dist/server/utils/crypto/decrypt-aes-gcm.d.ts

@@ -1,6 +0,0 @@
-/**
- * Decrypts a payload produced by `encryptAesGcm`.
- * Throws when the payload is tampered with or the secret is wrong.
- */
-export declare function decryptAesGcm(payload: string, secret: string): string;
-//# sourceMappingURL=decrypt-aes-gcm.d.ts.map

package/dist/server/utils/crypto/decrypt-aes-gcm.js

@@ -1 +0,0 @@
-import{createDecipheriv as u}from"node:crypto";import{AUTH_TAG_LENGTH_BYTES as e,IV_LENGTH_BYTES as a}from"./constants.js";import{deriveKey as f}from"./derive-key.js";function h(o,c){const r=Buffer.from(o,"base64url"),n=r.subarray(0,a),i=r.subarray(r.length-e),s=r.subarray(a,r.length-e),t=u("aes-256-gcm",f(c),n);return t.setAuthTag(i),Buffer.concat([t.update(s),t.final()]).toString("utf8")}export{h as decryptAesGcm};

package/dist/server/utils/crypto/decrypt-claim-value.d.ts

@@ -1,6 +0,0 @@
-/**
- * Returns the decrypted claim value, the value itself when it is legacy
- * plaintext, or undefined when it is missing or fails to decrypt.
- */
-export declare function decryptClaimValue(value: unknown, secret: string): string | undefined;
-//# sourceMappingURL=decrypt-claim-value.d.ts.map

package/dist/server/utils/crypto/decrypt-claim-value.js

@@ -1 +0,0 @@
-import{ENCRYPTED_CLAIM_PREFIX as t}from"./constants.js";import{decryptAesGcm as n}from"./decrypt-aes-gcm.js";function c(r,e){if(!(typeof r!="string"||!r)){if(!r.startsWith(t))return r;try{return n(r.slice(t.length),e)}catch{return}}}export{c as decryptClaimValue};

package/dist/server/utils/crypto/derive-key.d.ts

@@ -1,5 +0,0 @@
-/**
- * Derives the AES-256-GCM key for a secret via HKDF-SHA256, cached per secret.
- */
-export declare function deriveKey(secret: string): Buffer;
-//# sourceMappingURL=derive-key.d.ts.map

package/dist/server/utils/crypto/derive-key.js

@@ -1 +0,0 @@
-import{hkdfSync as t}from"node:crypto";const r=32,c="redocly-portal",f="claim-encryption",n=new Map;function y(o){let e=n.get(o);return e||(e=Buffer.from(t("sha256",o,c,f,r)),n.set(o,e)),e}export{y as deriveKey};

package/dist/server/utils/crypto/encrypt-aes-gcm.d.ts

@@ -1,6 +0,0 @@
-/**
- * Encrypts with AES-256-GCM using a key derived from the secret.
- * Output layout: base64url(iv | ciphertext | authTag).
- */
-export declare function encryptAesGcm(plaintext: string, secret: string): string;
-//# sourceMappingURL=encrypt-aes-gcm.d.ts.map

package/dist/server/utils/crypto/encrypt-aes-gcm.js

@@ -1 +0,0 @@
-import{createCipheriv as i,randomBytes as n}from"node:crypto";import{IV_LENGTH_BYTES as f}from"./constants.js";import{deriveKey as a}from"./derive-key.js";function s(r,o){const e=n(f),t=i("aes-256-gcm",a(o),e),c=Buffer.concat([t.update(r,"utf8"),t.final()]);return Buffer.concat([e,c,t.getAuthTag()]).toString("base64url")}export{s as encryptAesGcm};

package/dist/server/utils/crypto/encrypt-claim-value.d.ts

@@ -1,6 +0,0 @@
-/**
- * Encrypts a JWT claim value and prefixes it so `decryptClaimValue` can tell
- * encrypted values apart from legacy plaintext ones.
- */
-export declare function encryptClaimValue(value: string, secret: string): string;
-//# sourceMappingURL=encrypt-claim-value.d.ts.map

package/dist/server/utils/crypto/encrypt-claim-value.js

@@ -1 +0,0 @@
-import{ENCRYPTED_CLAIM_PREFIX as e}from"./constants.js";import{encryptAesGcm as m}from"./encrypt-aes-gcm.js";function p(r,t){return`${e}${m(r,t)}`}export{p as encryptClaimValue};

package/dist/server/utils/crypto/random-string.d.ts

@@ -1,12 +0,0 @@
-/**
- * Generates a cryptographically secure random string of the specified length.
- *
- * @param {number} len - Desired length of the resulting string.
- * @returns {string} A random Base64-encoded string truncated to the given length.
- *
- * @example
- * randomString(8); // "q3RfB2sZ"
- *
- */
-export declare function randomString(len: number): string;
-//# sourceMappingURL=random-string.d.ts.map

package/dist/server/utils/crypto/random-string.js

@@ -1 +0,0 @@
-import{randomBytes as t}from"crypto";function n(r){return t(r).toString("base64").slice(0,r)}export{n as randomString};

package/dist/server/utils/crypto/random-uuid.d.ts

@@ -1,12 +0,0 @@
-/**
- * Generates a cryptographically secure random UUID (version 4).
- *
- * @returns {string} A UUID v4 string, e.g. `"550e8400-e29b-41d4-a716-446655440000"`.
- *
- * @example
- * const id = randomUUID();
- * console.log(id); // "ddeb27fb-d9a0-4624-be4d-4615062daed4"
- *
- */
-export declare function randomUUID(): `${string}-${string}-${string}-${string}-${string}`;
-//# sourceMappingURL=random-uuid.d.ts.map

package/dist/server/utils/crypto/random-uuid.js

@@ -1 +0,0 @@
-function r(){return crypto.randomUUID()}export{r as randomUUID};

package/dist/server/utils/crypto/sha-dir-path-short.d.ts

@@ -1,12 +0,0 @@
-/**
- * Generates a short, deterministic hash for a directory path.
- *
- * @param {string} dirRelativePath - The relative path to the directory.
- * @returns {string} An 8-character hexadecimal hash representing the normalized path.
- *
- * @example
- * shaDirPathShort('src/utils'); // "a3c9b712"
- *
- */
-export declare function shaDirPathShort(dirRelativePath: string): string;
-//# sourceMappingURL=sha-dir-path-short.d.ts.map

package/dist/server/utils/crypto/sha-dir-path-short.js

@@ -1 +0,0 @@
-import{normalizePathPrefix as t}from"@redocly/theme/core/utils";import{shaHexShort as h}from"./sha-hex-short.js";function n(r){const o=r==="."?"/":t(r);return h(o)}export{n as shaDirPathShort};

package/dist/server/utils/crypto/sha-file-base64.d.ts

@@ -1,11 +0,0 @@
-/**
- * Computes the SHA-256 hash of a file’s contents and returns it as a Base64 string.
- *
- * @param {string} fileName - Path to the file whose contents will be hashed.
- * @returns {string} The Base64-encoded SHA-256 hash of the file contents.
- *
- * @example
- * shaFile('data.txt'); // e.g. "X48E9qOokqqrvdts8nOJRJN3OWDUoyWxBf7kbu9DBPE="
- */
-export declare function shaFileBase64(fileName: string): string;
-//# sourceMappingURL=sha-file-base64.d.ts.map

package/dist/server/utils/crypto/sha-file-base64.js

@@ -1 +0,0 @@
-import{createHash as r}from"crypto";import{readFileSync as a}from"node:fs";function o(e){return r("sha256").update(a(e)).digest("base64")}export{o as shaFileBase64};

package/dist/server/utils/crypto/sha-file-hex.d.ts

@@ -1,12 +0,0 @@
-/**
- * Computes the SHA-256 hash of a file’s contents and returns it as a hexadecimal string.
- *
- * @param {string} fileName - Path to the file whose contents will be hashed.
- * @returns {string} The SHA-256 hash of the file contents, encoded as a hex string.
- *
- * @example
- * shaFileForUrl('data.txt'); // "a591a6d40bf420404a011733cfb7b190..."
- *
- */
-export declare function shaFileHex(fileName: string): string;
-//# sourceMappingURL=sha-file-hex.d.ts.map

package/dist/server/utils/crypto/sha-file-hex.js

@@ -1 +0,0 @@
-import{createHash as r}from"crypto";import{readFileSync as t}from"fs";function o(e){return r("sha256").update(t(e)).digest("hex")}export{o as shaFileHex};

package/dist/server/utils/crypto/sha-hex-short.d.ts

@@ -1,11 +0,0 @@
-/**
- * Generates a short SHA-256 hash from the given string content.
- *
- * @param {string} content - The input string to hash.
- * @returns {string} The first 8 hexadecimal characters of the SHA-256 hash.
- *
- * @example
- * shaHexShort("hello"); // "2cf24dba"
- */
-export declare function shaHexShort(content: string): string;
-//# sourceMappingURL=sha-hex-short.d.ts.map

package/dist/server/utils/crypto/sha-hex-short.js

@@ -1 +0,0 @@
-import{createHash as e}from"crypto";function s(t){return e("sha256").update(t).digest("hex").substring(0,8)}export{s as shaHexShort};

package/dist/server/utils/crypto/sha-hex.d.ts

@@ -1,17 +0,0 @@
-/**
- * Generates a SHA-256 hash of a given string and returns it as a hexadecimal string.
- *
- * Unlike `sha()` which returns Base64, this function outputs a lowercase hexadecimal digest.
- * It’s suitable for checksums, integrity validation, or deterministic cache keys.
- *
- * Uses SHA-256 — a cryptographically secure algorithm.
- *
- * @param content - The input string to hash.
- * @returns The SHA-256 hash as a hexadecimal string.
- *
- * @example
- * shaHex('hello');
- * // returns '2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7901e9c6629e7a4bce9a3'
- */
-export declare function shaHex(content: string): string;
-//# sourceMappingURL=sha-hex.d.ts.map

package/dist/server/utils/crypto/sha-hex.js

@@ -1 +0,0 @@
-import{createHash as t}from"crypto";function a(e){return t("sha256").update(e).digest("hex")}export{a as shaHex};

package/dist/server/utils/crypto/sha.d.ts

@@ -1,18 +0,0 @@
-/**
- * Generates a SHA-256 hash of a given string or Buffer and returns it as a Base64-encoded string.
- *
- * Useful for generating secure checksums, file fingerprints, or deterministic cache keys.
- *
- * SHA-256 is cryptographically strong and preferred for integrity and security checks.
- *
- * @param content - The input content (string or Buffer) to hash.
- * @returns The Base64-encoded SHA-256 hash string.
- *
- * @example
- * sha('hello'); // returns 'LPJNul+wow4m6DsqxbninhsWHlwfp0JecwQzYpOLmCQ='
- *
- * @example
- * sha(Buffer.from('hello')); // also returns the same value
- */
-export declare function sha(content: string | Buffer): string;
-//# sourceMappingURL=sha.d.ts.map

package/dist/server/utils/crypto/sha.js

@@ -1 +0,0 @@
-import{createHash as t}from"crypto";function r(e){return t("sha256").update(e).digest("base64")}export{r as sha};

package/dist/server/utils/crypto/sha1.d.ts

@@ -1,19 +0,0 @@
-/**
- * Generates a SHA-1 hash of a given string or Buffer and returns it as a Base64-encoded string.
- *
- * Useful for checksum validation, content fingerprinting, or creating short deterministic identifiers.
- *
- * SHA-1 is considered **cryptographically weak** and should not be used for security-sensitive
- * operations (like password hashing or digital signatures). For those, prefer SHA-256.
- *
- * @param content - The input content (string or Buffer) to hash.
- * @returns The Base64-encoded SHA-1 hash string.
- *
- * @example
- * sha1('hello'); // returns 'qvTGHdzF6KLavt4PO0gs2a6pQ00='
- *
- * @example
- * sha1(Buffer.from('hello')); // also returns 'qvTGHdzF6KLavt4PO0gs2a6pQ00='
- */
-export declare function sha1(content: string | Buffer): string;
-//# sourceMappingURL=sha1.d.ts.map

package/dist/server/utils/crypto/sha1.js

@@ -1 +0,0 @@
-import{createHash as t}from"crypto";function r(e){return t("sha1").update(e).digest("base64")}export{r as sha1};

package/dist/server/utils/entitlements/can-access-feature.d.ts

@@ -1,6 +0,0 @@
-import type { Feature } from '../../../types/index.js';
-/**
- * Check if a feature is available based on entitlements
- */
-export declare function canAccessFeature(feature: Feature): boolean;
-//# sourceMappingURL=can-access-feature.d.ts.map

package/dist/server/utils/entitlements/can-access-feature.js

@@ -1 +0,0 @@
-import{EntitlementsProvider as t}from"../../entitlements/entitlements-provider.js";function r(e){return!!t.instance().canAccessFeature(e)}export{r as canAccessFeature};

package/dist/server/utils/envs/env-boolean-string.d.ts

@@ -1,12 +0,0 @@
-import { z } from 'zod';
-/**
- * Env vars that are set as the strings `"true"` or `"false"`, parsed to booleans.
- * Any other value fails validation.
- */
-export declare function envBooleanStringOptional(): z.ZodEffects<z.ZodOptional<z.ZodEnum<["true", "false"]>>, boolean | undefined, "false" | "true" | undefined>;
-export declare function envBooleanStringDefaultFalse(): z.ZodEffects<z.ZodDefault<z.ZodEnum<["true", "false"]>>, boolean, "false" | "true" | undefined>;
-/**
- * Like {@link envBooleanStringOptional}, but also accepts `"1"` as true (common for `CI`).
- */
-export declare function envCiBooleanOptional(): z.ZodEffects<z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"true">, z.ZodLiteral<"false">, z.ZodLiteral<"1">]>>, boolean | undefined, "1" | "false" | "true" | undefined>;
-//# sourceMappingURL=env-boolean-string.d.ts.map

package/dist/server/utils/envs/env-boolean-string.js

@@ -1 +0,0 @@
-import{z as n}from"zod";const t=n.enum(["true","false"]);function o(){return t.optional().transform(e=>e===void 0?void 0:e==="true")}function a(){return t.default("false").transform(e=>e==="true")}function l(){return n.union([n.literal("true"),n.literal("false"),n.literal("1")]).optional().transform(e=>e===void 0?void 0:e==="true"||e==="1")}export{a as envBooleanStringDefaultFalse,o as envBooleanStringOptional,l as envCiBooleanOptional};

package/dist/server/utils/envs/get-api-route-allowed-env-variables.d.ts

@@ -1,3 +0,0 @@
-export declare const EXCLUDED_ENV_VARS: string[];
-export declare function getAllowedEnvs(): Record<string, string | undefined>;
-//# sourceMappingURL=get-api-route-allowed-env-variables.d.ts.map

package/dist/server/utils/envs/get-api-route-allowed-env-variables.js

@@ -1 +0,0 @@
-const e=["AUTH_URL","BH_API_URL","HOME","HOSTNAME","INSPECT_MODE","INTERNAL_API_USERNAME","JWT_SECRET_KEY","METRICS_API_PORT","NODE","NODE_OPTIONS","NODE_VERSION","OAUTH_CLIENT_ID","OAUTH_CLIENT_SECRET","PATH","PLAN_GATES","PORTAL_ID","PWD","SERVER_EDITOR_APP_URL","SHLVL","SUBSCRIPTION_IN_TRIAL","TERM","TYPESENSE_API_URL","UV_USE_IO_URING","VAULT_TOKEN","WEB_SERVER_IDLE_TIMEOUT","YARN_VERSION","npm_config_cache","npm_config_local_prefix","npm_config_user_agent","npm_execpath","npm_node_execpath","npm_package_json","npm_package_name","npm_package_version"],n=["NOMAD_"];function T(){return Object.fromEntries(Object.entries(process.env).filter(([_])=>!e.includes(_)&&!n.some(E=>_.startsWith(E))))}export{e as EXCLUDED_ENV_VARS,T as getAllowedEnvs};

package/dist/server/utils/envs/get-public-env-variables.d.ts

@@ -1,11 +0,0 @@
-/**
- * Returns all environment variables that start with the configured public prefix.
- *
- * This is useful for exposing a controlled subset of environment variables
- * (e.g., client-side safe values) while keeping private ones hidden.
- *
- * - It filters `process.env` by keys starting with `PUBLIC_ENV_PREFIX`.
- * - Returns a plain object mapping variable names to their string values.
- */
-export declare function getPublicEnvVariables(): Record<string, string>;
-//# sourceMappingURL=get-public-env-variables.d.ts.map

package/dist/server/utils/envs/get-public-env-variables.js

@@ -1 +0,0 @@
-import{PUBLIC_ENV_PREFIX as n}from"../../../constants/common.js";function s(){const t=process.env,e=Object.entries(t).filter(([r])=>r.startsWith(n));return Object.fromEntries(e)}export{s as getPublicEnvVariables};

package/dist/server/utils/envs/interpolate-env-variables.d.ts

@@ -1,17 +0,0 @@
-/**
- * Interpolates environment variables in a string using the format {{ process.env.VARIABLE_NAME }}.
- * Supports optional quoted default values applied when the variable is not set,
- * e.g. {{ process.env.VARIABLE_NAME || "default" }} (both `|` and `||` separators are accepted).
- *
- * @param value - The string containing environment variable templates to interpolate
- * @returns An object containing:
- *   - interpolatedValue: The string with all environment variables replaced with their values
- *   - unsetVars: Array of environment variable names that were not found and had no default
- *   - interpolatedVars: Array of environment variable names that were successfully resolved
- */
-export declare function interpolateEnvVariables(value: string): {
-    interpolatedValue: string;
-    unsetVars: string[];
-    interpolatedVars: string[];
-};
-//# sourceMappingURL=interpolate-env-variables.d.ts.map

package/dist/server/utils/envs/interpolate-env-variables.js

@@ -1 +0,0 @@
-import{readEnvVariable as d}from"./read-env-variable.js";const i=/{{\s*process\.env\.([A-Z0-9_]+)\s*(?:\|\|?\s*(?:"([^"]*)"|'([^']*)')\s*)?}}/gi;function V(s){let e=s;const t=new Set,r=new Set,c=[...s.matchAll(i)];for(const n of c){const a=n[1].toUpperCase(),o=n[2]??n[3],l=d(a);l!==void 0?(e=e.replace(n[0],l),r.add(a)):o!==void 0?(e=e.replace(n[0],o),r.add(a)):t.add(a)}return{interpolatedValue:e,unsetVars:Array.from(t),interpolatedVars:Array.from(r)}}export{V as interpolateEnvVariables};

package/dist/server/utils/envs/load-env-variables.d.ts

@@ -1,2 +0,0 @@
-export declare function loadEnvVariables(cwd?: string): Promise<void>;
-//# sourceMappingURL=load-env-variables.d.ts.map

package/dist/server/utils/envs/load-env-variables.js

@@ -1 +0,0 @@
-import*as n from"dotenv";import*as a from"path";import{simpleGit as v}from"simple-git";import{envConfig as i,reloadEnvConfig as o}from"../../config/env-config.js";import{sanitizeBranchName as p}from"../../utils/envs/sanitize-branch-name.js";async function m(e){try{return(await v(e??process.cwd()).revparse(["--abbrev-ref","HEAD"])).trim()}catch{return""}}async function d(e){n.config({path:a.resolve(e??"",".env")}),o();const t=i.PUBLIC_REDOCLY_BRANCH_NAME||await m(e);if(t){const s=p(t);n.config({path:a.resolve(e??"",`.env.branch.${s}`),override:!0}),o()}const c=i.REDOCLY_ENV;let r;switch(c){case"production":r=".env.production";break;case"preview":r=".env.preview";break;default:r=".env.development";break}n.config({path:a.resolve(e??"",r),override:!0}),o()}export{d as loadEnvVariables};

package/dist/server/utils/envs/read-env-variable.d.ts

@@ -1,12 +0,0 @@
-/**
- * Reads an environment variable from the current Node.js process.
- *
- * @param name - The name of the environment variable to read.
- * @returns The value of the environment variable if it exists, otherwise `undefined`.
- *
- * @example
- * process.env.API_KEY = "123";
- * const apiKey = readEnvVariable("API_KEY"); // "123"
- */
-export declare function readEnvVariable(name: string): string | undefined;
-//# sourceMappingURL=read-env-variable.d.ts.map

package/dist/server/utils/envs/read-env-variable.js

@@ -1 +0,0 @@
-function r(e){return process.env[e]}export{r as readEnvVariable};

package/dist/server/utils/envs/replace-env-variables-deep.d.ts

@@ -1,26 +0,0 @@
-/**
- * Recursively traverses an object or array and interpolates environment variables in all string values.
- * Keeps track of the path to each modified value and maintains a record of original and replaced values.
- *
- * @param obj - The object or array to process
- * @param currentPath - Array of keys representing current position in object tree
- *
- * @returns An object containing:
- *   - resolvedObj: The processed object with all environment variables replaced
- *   - unsetEnvVars: Array of environment variable names that were not found
- *   - interpolatedEnvVars: Array of environment variable names that were successfully resolved
- *   - replacedValues: Record of paths where values were replaced, with original and new values
- *
- * For usage examples and test cases, see:
- * [unit tests](./__tests__/env.test.ts)
- */
-export declare function replaceEnvVariablesDeep<T extends Record<string, unknown> | Array<unknown>>(obj: T, currentPath?: string[]): {
-    resolvedObj: T;
-    unsetEnvVars: string[];
-    interpolatedEnvVars: string[];
-    replacedValues: Record<string, {
-        original: string;
-        replaced: string;
-    }>;
-};
-//# sourceMappingURL=replace-env-variables-deep.d.ts.map

package/dist/server/utils/envs/replace-env-variables-deep.js

@@ -1 +0,0 @@
-import{isObject as V}from"../../../utils/guards/is-object.js";import{interpolateEnvVariables as E}from"./interpolate-env-variables.js";function u(t,c=[]){const s=new Set,a=new Set,o={};return!V(t)&&!Array.isArray(t)?{resolvedObj:t,unsetEnvVars:Array.from(s),interpolatedEnvVars:Array.from(a),replacedValues:o}:{resolvedObj:Object.entries(t).reduce((i,[d,r])=>{const f=c.concat(d);if(typeof r=="string"){const{interpolatedValue:e,unsetVars:n,interpolatedVars:p}=E(r);i[d]=e;for(const l of n)s.add(l);for(const l of p)a.add(l);p.length>0&&(o[f.join(":")]={original:r,replaced:e})}else if(V(r)||Array.isArray(r)){const e=u(r,f);i[d]=e.resolvedObj;for(const n of e.unsetEnvVars)s.add(n);for(const n of e.interpolatedEnvVars)a.add(n);Object.assign(o,e.replacedValues)}else i[d]=r;return i},Array.isArray(t)?[]:{}),unsetEnvVars:Array.from(s),interpolatedEnvVars:Array.from(a),replacedValues:o}}export{u as replaceEnvVariablesDeep};

package/dist/server/utils/envs/sanitize-branch-name.d.ts

@@ -1,6 +0,0 @@
-/**
- * Sanitizes a branch name for use in env file names and config keys.
- * Replaces `/` with `-` to support branches like `feature/my-branch`.
- */
-export declare function sanitizeBranchName(branchName: string): string;
-//# sourceMappingURL=sanitize-branch-name.d.ts.map

package/dist/server/utils/envs/sanitize-branch-name.js

@@ -1 +0,0 @@
-function n(e){return e.replace(/\//g,"-")}export{n as sanitizeBranchName};

package/dist/server/utils/errors.d.ts

@@ -1,5 +0,0 @@
-export declare class HttpError extends Error {
-    status: number;
-    constructor(status: number, message: string);
-}
-//# sourceMappingURL=errors.d.ts.map

package/dist/server/utils/errors.js

@@ -1 +0,0 @@
-class t extends Error{status;constructor(s,r){super(r),this.status=s,Object.setPrototypeOf(this,t.prototype)}}export{t as HttpError};

package/dist/server/utils/fetch-with-client.d.ts

@@ -1,10 +0,0 @@
-/**
- * `fetch` for requests to Redocly APIs (Reunite main API, feedback, search,
- * Ask AI). Stamps the `x-redocly-client` identification header so portal
- * traffic is attributed correctly — use it instead of bare `fetch` for any
- * Redocly-bound request.
- */
-export declare function fetchWithClient(input: string | URL, init?: Omit<RequestInit, 'headers'> & {
-    headers?: Record<string, string>;
-}): Promise<Response>;
-//# sourceMappingURL=fetch-with-client.d.ts.map

package/dist/server/utils/fetch-with-client.js

@@ -1 +0,0 @@
-import{envConfig as o}from"../config/env-config.js";const r="realm-server",t=o.REDOCLY_PORTAL_VERSION,E=t?`${r}/${t}`:r;function s(n,e={}){return fetch(n,{...e,headers:{...e.headers,"x-redocly-client":E}})}export{s as fetchWithClient};

package/dist/server/utils/fs.d.ts

@@ -1,10 +0,0 @@
-export declare function readFileNames(dir: string): string[];
-export declare function copyStaticFile(cwd: string, fileRelativePath: string, outdir: string): Promise<string | undefined>;
-export declare function copyFolderRecursiveSync(source: string, target: string): void;
-export declare function ensureDir(path: string): string;
-export declare function fileExistsAsync(path: string): Promise<boolean>;
-export declare class FileNotFoundError extends Error {
-    filePath: string;
-    constructor(message: any, filePath: string);
-}
-//# sourceMappingURL=fs.d.ts.map

package/dist/server/utils/fs.js

@@ -1 +0,0 @@
-import{existsSync as c,readdirSync as l,lstatSync as f,mkdirSync as u,copyFileSync as p,lstat as x}from"fs";import{join as s,extname as S,basename as F,dirname as h,resolve as E}from"path";import{withPathPrefix as w}from"@redocly/theme/core/utils";import{PUBLIC_ASSETS_FOLDER as a}from"../constants/common.js";import{reporter as P}from"../tools/notifiers/reporter.js";import{logger as D}from"../tools/notifiers/logger.js";import{shaDirPathShort as b}from"../utils/crypto/sha-dir-path-short.js";import{shaFileHex as N}from"../utils/crypto/sha-file-hex.js";import{slug as $}from"../../utils/slugger.js";function I(r){if(!c(r))return[];const e=[];return o(r),e;function o(t){try{l(t).forEach(n=>{let i=s(t,n);f(i).isDirectory()?o(i):e.push(i)})}catch(n){D.error(`Error reading all file names in ${t}: `+n.message)}}}async function T(r,e,o){const t=E(r,e);if(!c(t))throw new v(`File not found at ${t}`,e);c(s(o,a))||u(s(o,a),{recursive:!0});const n=S(t),i=[$(F(t,n)),N(t),b(h(e))].join(".").concat(n),m=s(o,a,i),y=s(a,i);try{if(p(t,m),!c(m))throw new Error(`Cannot copy file ${e}`);return w(y)}catch(d){await P.panicOnBuild(d.message)}}function g(r,e){let o=[];if(c(r)){if(c(e)||u(e,{recursive:!0}),!f(r).isDirectory())throw new Error(`Source path must be a directory, but ${r} provided`);o=l(r),o.forEach(t=>{const n=s(r,t);if(f(n).isDirectory())g(n,s(e,t));else{const i=s(e,t);p(n,i)}})}}function U(r){return u(h(r),{recursive:!0}),r}async function q(r){return new Promise(e=>{x(r,(o,t)=>{e(o==null&&t.isFile())})})}class v extends Error{filePath;constructor(e,o){super(e),this.name="FileNotFoundError",this.filePath=o}}export{v as FileNotFoundError,g as copyFolderRecursiveSync,T as copyStaticFile,U as ensureDir,q as fileExistsAsync,I as readFileNames};