@redocly/realm 0.129.2 → 0.130.0-custom.10

package/dist/client/app/markdoc/custom-components/openapi/openapi-response-sample.js

@@ -0,0 +1 @@
+import*as e from"react";import{StoreProvider as S,ResponseSamples as v,normalizeOptions as g}from"@redocly/openapi-docs";import{ErrorMessage as b,OpenApiComponentWrap as E}from"../styled.elements";import{useStore as R}from"../../hooks/use-store";import{getOperation as C}from"./get-operation/index";import{getMockServerDocsConfig as O}from"../../../../templates/openapi-docs/mock-server-config.js";function x(a){const{descriptionFile:m,operationId:i,pointer:p,exampleKey:t}=a,{store:o,error:c,baseSlug:s}=R(m),[l,f]=e.useState(),r=e.useMemo(()=>({...o?.options,mockServer:O(o?.options?.mockServer,s||"")}),[o?.options,s]),n=e.useMemo(()=>{if(o)return C(o,{operationId:i,pointer:p},g(r),{exampleKey:t})},[t,r,i,p,o]),d=e.useCallback(u=>{f(u)},[]);return o?n?e.createElement(E,{"data-testid":"openapi-response-sample"},e.createElement(S,{options:r,definition:o.definition,withState:{operation:{pointer:n.pointer,state:{activeExampleName:t}}}},e.createElement(v,{operation:n,activeResponseTab:l,onTabChange:d}))):e.createElement("pre",{style:{color:"red"}},"Cannot find OpenAPI operation by operationId or pointer"):e.createElement(b,null,c)}export{x as OpenApiResponseSample};

package/dist/client/app/markdoc/custom-components/openapi/replay-openapi.js

@@ -0,0 +1 @@
+import o from"react";import{EmbeddedReplay as E,StoreProvider as M}from"@redocly/openapi-docs";import{useLocation as b}from"react-router-dom";import{Admonition as k}from"@redocly/theme/markdoc/components/Admonition/Admonition";import{ErrorMessage as A,OpenApiComponentWrap as I}from"../styled.elements.js";import{useStore as P}from"../../hooks/use-store.js";import{getOperation as x}from"./get-operation/index.js";import{getMockServerDocsConfig as R}from"../../../../templates/openapi-docs/mock-server-config.js";const L=y=>{const{descriptionFile:n,operationId:i,pointer:p,exampleKey:d,mimeType:l,requestBody:a,parameters:S,options:m,environment:t,environments:s,hideOtherSecuritySchemes:O}=y,h=b(),{store:e,error:v,baseSlug:u}=P(n),c=o.useMemo(()=>({...e?.options,...m}),[m,e?.options]),f=o.useMemo(()=>{const{mockServer:C,...g}=c;return g},[c]),r=o.useMemo(()=>{if(e)return x(e,{operationId:i,pointer:p},f,{exampleKey:d,mimeType:l,environments:s,environment:t,requestBody:a})},[d,f,l,i,p,e,s,t,a]);return e?r?o.createElement(I,{"data-testid":"replay-openapi"},o.createElement(M,{key:`${h.pathname}-${n}-${i||p}`,options:{...m,disableRouter:!0,routingBasePath:u,mockServer:R(c.mockServer,u)},definition:e.definition,withState:{environments:s,allowedEnvironments:t?[t]:void 0,operation:{pointer:r.pointer,state:{requestValues:{body:a,...S}}}}},o.createElement(E,{activeOperationId:r.operationId||"",fullOpenApi:e.definition,corsProxyUrl:e.options.corsProxyUrl,pointer:r.pointer,hideOtherSecuritySchemes:O}))):o.createElement(k,{type:"danger"},"Cannot find OpenAPI operation by operationId or pointer in ",n):o.createElement(A,null,v)};export{L as ReplayOpenApi};

package/dist/client/app/markdoc/hooks/use-store.js

@@ -0,0 +1 @@
+import{usePageSharedData as t}from"../../../providers/page-data/hooks";function n(r){const e=t(r||"");return e?{store:e,error:null,baseSlug:e.baseSlug}:{store:void 0,error:"Incorrect OpenAPI file path"}}export{n as useStore};

package/dist/client/app/pages/DevLogin/DevLogin.js

@@ -1 +1 @@
-import t,{useEffect as g,useState as s}from"react";import{useNavigate as h}from"react-router-dom";import{Button as y}from"@redocly/theme/components/Button/Button";import{H3 as S}from"@redocly/theme/components/Typography/H3";import{H4 as v}from"@redocly/theme/components/Typography/H4";import{Admonition as w}from"@redocly/theme/components/Admonition/Admonition";import{getPathnameForLocale as E,withPathPrefix as P}from"@redocly/theme/core/utils";import{ServerRoutes as L}from"../../../../constants/common";import{telemetry as k}from"../../telemetry/index.js";import{buildLoginUrl as O}from"../../../../utils/auth/build-login-url";import{usePageProps as T}from"../../../providers/page-data/hooks";import{Wrapper as b,HeadingSection as C}from"./styled";import{DevLoginForm as R}from"./DevLoginForm";import{useL10nConfig as F}from"../../hooks";async function x(r){try{const{status:o}=await fetch(P(L.AUTHORIZATION),{method:"POST",body:JSON.stringify(r)});return o}catch(o){console.error(o)}}function G(){const{defaultLocale:r,locales:o,currentLocale:c}=F(),l=h(),[a,d]=s({values:{teams:[],email:"example@example.com"}}),[n,u]=s();g(()=>{const e=new URLSearchParams(window.location.search);u(e.get("redirectTo")||void 0)},[]);const i=T(),m=i?.authIdps,p=(i.rbac?.teams||[]).filter(e=>e!=="*"),f=async()=>{await x(a.values)===200&&(l(n||"/"),window.location.reload())};return t.createElement(b,null,t.createElement(C,null,t.createElement(S,{"data-cy":"login-title"},"Dev-mode login"),t.createElement(w,{type:"warning",name:"This is dev mode login simulator."},"Any email works and password is not checked.")),t.createElement(t.Fragment,null,t.createElement(R,{teams:p,formState:a,setFormState:d,onSubmit:f}),Object.keys(m||{}).length>0&&t.createElement(v,null,"Use SSO:"),Object.values(m||{}).map(e=>t.createElement("div",{key:e.idpId},t.createElement(y,{fullWidth:!0,size:"large","data-cy":"idp-login",to:O(e.idpId,E("",r,c,o),n),onClick:()=>k.sendLoginProviderButtonClickedMessage({provider:e.type})},e.title||e.type)))))}export{G as default};
+import t,{useEffect as g,useState as s}from"react";import{useNavigate as h}from"react-router-dom";import{Button as y}from"@redocly/theme/components/Button/Button";import{H3 as S}from"@redocly/theme/components/Typography/H3";import{H4 as v}from"@redocly/theme/components/Typography/H4";import{Admonition as w}from"@redocly/theme/components/Admonition/Admonition";import{getPathnameForLocale as E,withPathPrefix as P}from"@redocly/theme/core/utils";import{ServerRoutes as L}from"../../../../constants/common";import{telemetry as b}from"../../telemetry/index.js";import{buildLoginUrl as k}from"../../../../utils/auth/build-login-url";import{usePageProps as O}from"../../../providers/page-data/hooks";import{Wrapper as T,HeadingSection as C}from"./styled";import{DevLoginForm as R}from"./DevLoginForm";import{useL10nConfig as F}from"../../hooks";async function x(r){try{const{status:o}=await fetch(P(L.AUTHORIZATION),{method:"POST",body:JSON.stringify(r)});return o}catch(o){console.error(o)}}function G(){const{defaultLocale:r,locales:o,currentLocale:c}=F(),l=h(),[a,d]=s({values:{teams:[],email:"example@example.com"}}),[n,u]=s();g(()=>{const e=new URLSearchParams(window.location.search);u(e.get("redirectTo")||void 0)},[]);const i=O(),m=i?.authIdps,p=(i.rbac?.teams||[]).filter(e=>e!=="*"),f=async()=>{await x(a.values)===200&&(l(n||"/"),window.location.reload())};return t.createElement(T,null,t.createElement(C,null,t.createElement(S,{"data-cy":"login-title"},"Dev-mode login"),t.createElement(w,{type:"warning",name:"This is dev mode login simulator."},"Any email works and password is not checked.")),t.createElement(t.Fragment,null,t.createElement(R,{teams:p,formState:a,setFormState:d,onSubmit:f}),Object.keys(m||{}).length>0&&t.createElement(v,null,"Use SSO:"),Object.values(m||{}).map(e=>t.createElement("div",{key:e.idpId},t.createElement(y,{fullWidth:!0,size:"large","data-cy":"idp-login",to:k(e.idpId,E("",r,c,o),n),onClick:()=>b.sendLoginProviderButtonClickedMessage([{object:"button",provider:e.type}])},e.title||e.type)))))}export{G as default};

package/dist/client/app/search/message-handlers.d.ts

@@ -0,0 +1,29 @@
+import type { Dispatch, SetStateAction } from 'react';
+import type { SSEMessage, SearchResource, ToolCallState, AiSearchState } from '../../types';
+import type { AiSearchConversationItem } from '@redocly/theme/core/types';
+/**
+ * Context object passed to message handlers
+ * Contains current values and state setters
+ */
+export type MessageHandlerContext = {
+    messageId: string;
+    resources: SearchResource[];
+    accumulatedResponse: string;
+    setConversation: Dispatch<SetStateAction<AiSearchConversationItem[]>>;
+    setState: Dispatch<SetStateAction<AiSearchState>>;
+    setToolCalls: Dispatch<SetStateAction<ToolCallState[]>>;
+};
+/**
+ * Updates returned by message handlers
+ */
+export type MessageHandlerResult = {
+    messageId?: string;
+    resources?: SearchResource[];
+    accumulatedResponse?: string;
+};
+/**
+ * Main message dispatcher that routes messages to appropriate handlers
+ * Returns updates to be applied to refs
+ */
+export declare function handleSSEMessage(message: SSEMessage, ctx: MessageHandlerContext): MessageHandlerResult;
+//# sourceMappingURL=message-handlers.d.ts.map

package/dist/client/app/search/message-handlers.js

@@ -0,0 +1 @@
+import{AiSearchConversationRole as o,AiSearchError as l}from"@redocly/theme/core/constants";import{SSE_EVENTS as n,MAX_DISPLAYED_RESOURCES as a}from"../../constants";function i(e,r){if(e.length===0)return e;const t=e[e.length-1];return t.role===o.ASSISTANT&&!t.messageId?[...e.slice(0,-1),{...t,messageId:r}]:e}function S(e,r){if(e.length===0)return e;const t=[...e];return t[t.length-1]={...t[t.length-1],result:r},t}function E(e,r){return e.type!==n.MESSAGE_ID?{}:(r.setConversation(t=>i(t,e.messageId)),{messageId:e.messageId})}function c(e,r){if(e.type!==n.SOURCES)return{};const t=e.sources.slice(0,a).map(({url:s,title:u})=>({url:s,title:u}));return r.setState(s=>s.status==="loading"?{...s,resources:t}:s),{resources:t}}function f(e,r){if(e.type!==n.ANSWER)return{};const t=r.accumulatedResponse+e.answer;return r.setState(s=>s.status==="loading"?{...s,response:t}:s),{accumulatedResponse:t}}function d(e,r){return e.type!==n.TOOL_CALL?{}:(r.setToolCalls(t=>[...t,{...e.toolCall,position:r.accumulatedResponse.length}]),{})}function R(e,r){return e.type!==n.TOOL_RESULT?{}:(r.setToolCalls(t=>S(t,e.result)),{})}function h(e,r){return e.type!==n.ERROR?{}:(r.setState(t=>t.status==="loading"?{status:"error",question:t.question,error:l.ErrorProcessingResponse}:t),{})}const A={[n.MESSAGE_ID]:E,[n.SOURCES]:c,[n.ANSWER]:f,[n.TOOL_CALL]:d,[n.TOOL_RESULT]:R,[n.ERROR]:h};function O(e,r){const t=A[e.type];return t?t(e,r):{}}export{O as handleSSEMessage};

package/dist/client/app/search/sse-parser.d.ts

@@ -0,0 +1,10 @@
+import type { SSEMessage } from '../../types/ai-search';
+/**
+ * Parses SSE data lines from a chunk string
+ */
+export declare function parseSSEChunk(chunk: string): SSEMessage[];
+/**
+ * Creates an async generator that reads SSE messages from a ReadableStream
+ */
+export declare function streamSSEMessages(stream: ReadableStream<Uint8Array>, signal?: AbortSignal): AsyncGenerator<SSEMessage>;
+//# sourceMappingURL=sse-parser.d.ts.map

package/dist/client/app/search/sse-parser.js

@@ -0,0 +1,2 @@
+import{SSE_EVENTS as i,SSE_DATA_PREFIX as a}from"../../constants";function d(e){return Object.values(i).includes(e)}function p(e){const s=[],t=e.split(`
+`);for(const n of t){if(!n.startsWith(a))continue;const r=n.slice(a.length);if(r)try{const c=JSON.parse(r),o=S(c);o&&s.push(o)}catch{}}return s}function S(e){return e.type&&typeof e.type=="string"&&d(e.type)?e:"messageId"in e&&typeof e.messageId=="string"?{type:i.MESSAGE_ID,messageId:e.messageId}:"sources"in e&&Array.isArray(e.sources)?{type:i.SOURCES,sources:e.sources}:"answer"in e&&typeof e.answer=="string"?{type:i.ANSWER,answer:e.answer}:null}async function*y(e,s){const t=e.getReader(),n=new TextDecoder;try{for(;!s?.aborted;){const{value:r,done:c}=await t.read();if(c)break;const o=n.decode(r),u=p(o);for(const f of u)yield f}}finally{t.releaseLock()}}export{p as parseSSEChunk,y as streamSSEMessages};

package/dist/client/app/search/useAiSearch.d.ts

@@ -1,21 +1,19 @@
-import type { AiSearchConversationItem, SearchFilterItem } from '@redocly/theme/core/types';
+import type { AiSearchConversationItem, ContentSegment } from '@redocly/theme/core/types';
+import type { AiSearchOptions, SearchResource, ToolCallState } from '../../types/ai-search';
 import { AiSearchError } from '@redocly/theme/core/constants';
-type AiSearchOptions = {
-    filter?: SearchFilterItem[];
-};
-export declare function useAiSearch(options?: AiSearchOptions): {
-    askQuestion: (question: string, history?: AiSearchConversationItem[]) => Promise<void>;
+type UseAiSearchReturn = {
+    askQuestion: (question: string, history?: AiSearchConversationItem[]) => void;
     isGeneratingResponse: boolean;
     response: string | undefined;
-    resources: {
-        url: string;
-        title: string;
-    }[];
+    resources: SearchResource[];
     question: string;
     error: AiSearchError | null;
     clearConversation: () => void;
     conversation: AiSearchConversationItem[];
-    setConversation: import("react").Dispatch<import("react").SetStateAction<AiSearchConversationItem[]>>;
+    setConversation: React.Dispatch<React.SetStateAction<AiSearchConversationItem[]>>;
+    toolCalls: ToolCallState[];
+    contentSegments: ContentSegment[];
 };
+export declare function useAiSearch(options?: AiSearchOptions): UseAiSearchReturn;
 export {};
 //# sourceMappingURL=useAiSearch.d.ts.map

package/dist/client/app/search/useAiSearch.js

@@ -1 +1 @@
-import{useCallback as w,useState as o}from"react";import{AiSearchError as c}from"@redocly/theme/core/constants";import{withPathPrefix as K}from"@redocly/theme/core/utils";import{ServerRoutes as L}from"../../../constants/common";import{useSearchSession as U}from"@redocly/theme/core/contexts";import{useI18nConfig as _,useCurrentProduct as j,usePageVersions as B}from"../hooks";import{telemetry as W}from"../telemetry/index.js";function re(k){const{searchSessionId:x}=U(),[E,m]=o(),[b,g]=o([]),[M,P]=o(""),[O,i]=o([]),[Q,n]=o(!1),[v,e]=o(null),[I,l]=o(null),{currentLocale:F}=_(),J=j(),{versions:N=[]}=B()||{},h=N.find(t=>t?.active),S=w(()=>{m(""),g([]),n(!1),e(null)},[m,g,e]),G=w(()=>{S(),i([])},[S,i]);return{askQuestion:async(t,H)=>{if(!t)return;I&&I.abort();const A=new AbortController;l(A),S(),n(!0),P(t);let u="";fetch(K(L.ASK_AI),{method:"POST",body:JSON.stringify({text:t,history:H||[],locale:F,product:J?.name,filter:k?.filter,version:h&&{folder:h.folderId,label:h.label}}),signal:A.signal}).then(r=>{if(!r.ok){n(!1),r.status===401?e(c.Unauthorized):r.status===403?e(c.Forbidden):e(c.HttpRequestFailed);return}let f="";const y=r.body;if(!y)return;const T=y.getReader(),C=()=>{T.read().then(({value:d,done:V})=>{if(V){n(!1),l(null),f||e(c.EmptyResponse),t.trim().length>0&&u&&W.sendSearchAIQueryMessage({question:t,answer:f,resources:JSON.stringify(b),searchSessionId:x,messageId:u});return}const z=new TextDecoder().decode(d),D=/data: (.*)/g;let p;for(;(p=D.exec(z))!==null;){if(!p[1])continue;const a=JSON.parse(p[1]);if(a.messageId)u=a.messageId,i(s=>{if(s.length===0)return s;const R=s[s.length-1];return R.role==="assistant"&&!R.messageId?[...s.slice(0,-1),{...R,messageId:u}]:s});else if(a.answer)f+=a.answer,m(f);else if(a.sources){const s=Math.floor(Math.random()*3)+4;g(a.sources.slice(0,s))}}C()}).catch(d=>{d.name!=="AbortError"&&(console.error(d),n(!1),l(null),e(c.ErrorProcessingResponse))})};C()}).catch(r=>{r.name!=="AbortError"&&(console.error(r),n(!1),l(null),e(c.HttpRequestFailed))})},isGeneratingResponse:Q,response:E,resources:b,question:M,error:v,clearConversation:G,conversation:O,setConversation:i}}export{re as useAiSearch};
+import{useCallback as h,useEffect as J,useMemo as N,useRef as f,useState as E}from"react";import{AiSearchError as m}from"@redocly/theme/core/constants";import{withPathPrefix as V,splitContentByToolCalls as j}from"@redocly/theme/core/utils";import{ServerRoutes as B}from"../../../constants/common";import{useSearchSession as D}from"@redocly/theme/core/contexts";import{AI_SEARCH_REQUEST_HEADERS as G,HTTP_ERROR_MAP as K}from"../../constants";import{useI18nConfig as L,useCurrentProduct as U,usePageVersions as z}from"../hooks";import{telemetry as W}from"../telemetry/index.js";import{streamSSEMessages as X}from"./sse-parser";import{handleSSEMessage as Y}from"./message-handlers";function ur(C){const{searchSessionId:d}=D(),[r,s]=E({status:"idle"}),[w,p]=E([]),[g,b]=E([]),t=f(null),u=f(""),o=f(""),a=f([]),{currentLocale:y}=L(),A=U(),{versions:M=[]}=z()||{},i=M.find(e=>e?.active),l=h(()=>{s({status:"idle",response:""}),b([]),u.current="",o.current="",a.current=[]},[]),O=h(()=>{t.current?.abort(),t.current=null,l(),p([])},[l]);J(()=>()=>{t.current?.abort()},[]);const k=h(async(e,F)=>{if(!e)return;t.current?.abort();const R=new AbortController;t.current=R,l(),s({status:"loading",question:e,response:"",resources:[]});try{const n=await fetch(V(B.ASK_AI),{method:"POST",headers:G,body:JSON.stringify({text:e,history:F||[],locale:y,product:A?.name,filter:C?.filter,version:i&&{folder:i.folderId,label:i.label},searchSessionId:d}),signal:R.signal});if(!n.ok){s({status:"error",question:e,error:K[n.status]??m.HttpRequestFailed});return}const I=n.body;if(!I){s({status:"error",question:e,error:m.HttpRequestFailed});return}let v=!1;for await(const c of X(I,R.signal)){const Q={messageId:u.current,resources:a.current,accumulatedResponse:o.current,setConversation:p,setState:s,setToolCalls:b},{messageId:H,resources:P,accumulatedResponse:_}=Y(c,Q);H&&(u.current=H),P&&(a.current=P),_&&(o.current=_),c.type==="error"&&(v=!0)}t.current=null,s(c=>c.status==="error"?c:o.current?{status:"success",question:e,response:o.current,resources:a.current}:{status:"error",question:e,error:m.EmptyResponse}),!v&&o.current&&e.trim()&&u.current&&W.sendSearchAIQueryMessage([{object:"search",question:e,answer:o.current,resources:JSON.stringify(a.current),searchSessionId:d,messageId:u.current}])}catch(n){if(n instanceof Error&&n.name==="AbortError")return;t.current=null,s({status:"error",question:e,error:m.HttpRequestFailed})}},[l,y,A?.name,C?.filter,i,d]),S=r.status==="loading"||r.status==="success"||r.status==="idle"?r.response:void 0,q=N(()=>j(S,g),[S,g]);return{askQuestion:k,isGeneratingResponse:r.status==="loading",response:S,resources:r.status==="loading"||r.status==="success"?r.resources:[],question:r.status!=="idle"?r.question:"",error:r.status==="error"?r.error:null,clearConversation:O,conversation:w,setConversation:p,toolCalls:g,contentSegments:q}}export{ur as useAiSearch};

package/dist/client/app/search/useSearch.js

@@ -1 +1 @@
-import{useCallback as I,useEffect as y,useState as F,useRef as T}from"react";import{SEARCH_DEBOUNCE_TIME_MS as G}from"@redocly/theme/core/constants";import{withPathPrefix as _}from"@redocly/theme/core/utils";import{SEARCH_GROUP_FACET_FIELD as b,SEARCH_PRODUCT_FIELD as N,SEARCH_VERSION_FIELD as k,ServerRoutes as O}from"../../../constants/common";import{debounce as M}from"../../../utils/time/debounce.js";import{useSearchSession as Q}from"@redocly/theme/core/contexts";import{useGlobalData as U,useI18nConfig as P}from"../hooks";import{usePageVersions as x}from"../../providers/page-data/hooks";import{useFacets as J}from"./useFacets";import{telemetry as B}from"../telemetry/index.js";const K=(s,n,e,r,a,c,i,f)=>{const{searchSessionId:d}=Q(),{currentLocale:m}=P(),l=T(""),p=I(M(async(t,h,u,S)=>{if(!t.trim().length&&!h.length){e({}),r({}),a(!1);return}const R={method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({query:t,filter:A(h,S,c),locale:u})};try{const o=await fetch(_(O.SEARCH),R);if(l.current===t){const E=await o.json();r(E.facets),e(E.documents),t.trim().length>1&&B.sendSearchQueryMessage({query:t,resultCount:Object.keys(E.documents).length.toString(),searchSessionId:d})}a(!1)}catch(o){e({}),console.log(o)}},G),[c?.version,c?.folderId,i]);return y(()=>{f||(a(!0),p(s,n,m,i),l.current=s)},[f,n,m,i,s,p,a]),{}},z=(s,n,e,r,a,c,i,f)=>{const{currentLocale:d}=P();y(()=>{m(e,s,n,d,r,a,f)},[r,f]);const m=I(async(l,p,t,h,u,S,R)=>{if(u){const{groupKey:o}=u;i(!0);const v={method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({query:p,filter:(()=>{const g=S.find(C=>C.field===b);return g&&!t.find(L=>L.field===g?.field)?[...t,{field:g.field,values:[o]}]:A(t,R)})(),loadMore:u,locale:h})},D=await(await fetch(_(O.SEARCH),v)).json(),H=l[o]||[],j=D.documents[o],w={...l,[o]:[...H,...j]};c(w),i(!1)}},[]);return{}};function ne(s,n){const{searchFeatures:e}=U(),[r,a]=F(""),[c,i]=F([]),[f,d]=F({}),[m,l]=F({}),[p,t]=F(),[h,u]=F(!1),{facets:S}=J(m),{versions:R=[]}=x()||{},o=R.find(E=>E?.active);return K(r,c,d,l,u,o,s,n),z(r,c,f,p,S,d,u,s),{query:r,setQuery:a,filter:c,setFilter:i,items:f,isSearchLoading:h,facets:S,groupField:b,setLoadMore:t,advancedSearch:e?.advanced?.enabled,askAi:e?.ai?.enabled}}function A(s,n,e){return[...s,...n?[{field:N,values:[n]}]:[],...e?[{field:k,values:[...e.default?["default"]:[e.folderId,e.version]]}]:[]]}export{ne as useSearch};
+import{useCallback as I,useEffect as y,useState as F,useRef as T}from"react";import{SEARCH_DEBOUNCE_TIME_MS as G}from"@redocly/theme/core/constants";import{withPathPrefix as b}from"@redocly/theme/core/utils";import{SEARCH_GROUP_FACET_FIELD as _,SEARCH_PRODUCT_FIELD as N,SEARCH_VERSION_FIELD as k,ServerRoutes as O}from"../../../constants/common";import{debounce as M}from"../../../utils/time/debounce.js";import{useSearchSession as Q}from"@redocly/theme/core/contexts";import{useGlobalData as U,useI18nConfig as P}from"../hooks";import{usePageVersions as x}from"../../providers/page-data/hooks";import{useFacets as J}from"./useFacets";import{telemetry as B}from"../telemetry/index.js";const K=(s,r,e,n,a,c,i,f)=>{const{searchSessionId:d}=Q(),{currentLocale:m}=P(),l=T(""),p=I(M(async(t,h,u,S)=>{if(!t.trim().length&&!h.length){e({}),n({}),a(!1);return}const R={method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({query:t,filter:A(h,S,c),locale:u})};try{const o=await fetch(b(O.SEARCH),R);if(l.current===t){const E=await o.json();n(E.facets),e(E.documents),t.trim().length>1&&B.sendSearchQueryMessage([{object:"search",query:t,resultCount:Object.keys(E.documents).length.toString(),searchSessionId:d}])}a(!1)}catch(o){e({}),console.log(o)}},G),[c?.version,c?.folderId,i]);return y(()=>{f||(a(!0),p(s,r,m,i),l.current=s)},[f,r,m,i,s,p,a]),{}},z=(s,r,e,n,a,c,i,f)=>{const{currentLocale:d}=P();y(()=>{m(e,s,r,d,n,a,f)},[n,f]);const m=I(async(l,p,t,h,u,S,R)=>{if(u){const{groupKey:o}=u;i(!0);const j={method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({query:p,filter:(()=>{const g=S.find(C=>C.field===_);return g&&!t.find(L=>L.field===g?.field)?[...t,{field:g.field,values:[o]}]:A(t,R)})(),loadMore:u,locale:h})},v=await(await fetch(b(O.SEARCH),j)).json(),D=l[o]||[],H=v.documents[o],w={...l,[o]:[...D,...H]};c(w),i(!1)}},[]);return{}};function re(s,r){const{searchFeatures:e}=U(),[n,a]=F(""),[c,i]=F([]),[f,d]=F({}),[m,l]=F({}),[p,t]=F(),[h,u]=F(!1),{facets:S}=J(m),{versions:R=[]}=x()||{},o=R.find(E=>E?.active);return K(n,c,d,l,u,o,s,r),z(n,c,f,p,S,d,u,s),{query:n,setQuery:a,filter:c,setFilter:i,items:f,isSearchLoading:h,facets:S,groupField:_,setLoadMore:t,advancedSearch:e?.advanced?.enabled,askAi:e?.ai?.enabled}}function A(s,r,e){return[...s,...r?[{field:N,values:[r]}]:[],...e?[{field:k,values:[...e.default?["default"]:[e.folderId,e.version]]}]:[]]}export{re as useSearch};

package/dist/client/app/telemetry/index.d.ts

@@ -1,3 +1,13 @@
 import { Telemetry } from '@redocly/realm-asyncapi-sdk/ui-telemetry';
-export declare const telemetry: Telemetry;
+import type { EventPayload, EventType, SendEventParams } from '@redocly/realm-asyncapi-sdk/ui-telemetry';
+declare class UITelemetry extends Telemetry {
+    constructor();
+    send<TEventType extends EventType>(event: TEventType, data?: EventPayload<TEventType>): void;
+    /**
+     * @deprecated Use send(event, data) instead.
+     */
+    send<TEventType extends EventType>(params: SendEventParams<TEventType>): void;
+}
+export declare const telemetry: UITelemetry;
+export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/client/app/telemetry/index.js

@@ -1 +1 @@
-import{Telemetry as e}from"@redocly/realm-asyncapi-sdk/ui-telemetry";const r=new e;export{r as telemetry};
+import{Telemetry as t}from"@redocly/realm-asyncapi-sdk/ui-telemetry";class o extends t{constructor(){super()}send(e,s){typeof e=="string"?super.send(e,s):super.send(e.type,e.payload)}}const r=new o;export{r as telemetry};

package/dist/client/browser-entry.js

@@ -1,7 +1,7 @@
-import{telemetry as l}from"./app/telemetry/index.js";l.init({otel:{isProd:process.env.NODE_ENV==="production",serviceVersion:`${b}@${process.env.REDOCLY_PORTAL_VERSION}`,version:"1.0.0",collectorTraceUrl:new URL(r(D.OTEL_TRACES),location.origin).toString(),serviceName:"realm-ui",tracerName:"client-telemetry",instrumentations:[new u,new R,new E]},disabled:!h});import e from"react";import{hydrateRoot as m}from"react-dom/client";import{RouterProvider as p,createBrowserRouter as f}from"react-router-dom";import{HelmetProvider as d}from"@dr.pogodin/react-helmet";import{DocumentLoadInstrumentation as u}from"@opentelemetry/instrumentation-document-load";import{XMLHttpRequestInstrumentation as E}from"@opentelemetry/instrumentation-xml-http-request";import{FetchInstrumentation as R}from"@opentelemetry/instrumentation-fetch";import{getLocaleFromPathname as L,withoutPathPrefix as O,withPathPrefix as r}from"@redocly/theme/core/utils";import{DEFAULT_LOCALE_PLACEHOLDER as _,ServerRoutes as D}from"../constants/common";import{TELEMETRY_ENABLED as h}from"../server/constants/common.js";import{initL10n as g}from"./app/l10n/initL10n";import{Loader as v,useRefresh as x,globalData as t}from"./runtime/loader";import{App as A,routes as P}from"./App";import{PACKAGE_NAME as b,PRODUCT_NAME as N}from"../config/product-gates";import"./polyfills";import{ServerStyleSheet as j,StyleSheetManager as J}from"styled-components";function T(){return x(),e.createElement(d,{context:{}},e.createElement(A,null))}function w(){t?.removeAttribution&&process.env.REDOCLY_PORTAL_VERSION?console.log(`
+import{telemetry as s}from"./app/telemetry/index.js";s.init({otel:{isProd:process.env.NODE_ENV==="production",serviceVersion:`${_}@${process.env.REDOCLY_PORTAL_VERSION}`,version:"1.0.0",collectorTraceUrl:new URL(r(L.OTEL_TRACES),location.origin).toString(),serviceName:"realm-ui",tracerName:"client-telemetry"},disabled:!O});import e from"react";import{hydrateRoot as p}from"react-dom/client";import{RouterProvider as m,createBrowserRouter as d}from"react-router-dom";import{HelmetProvider as f}from"@dr.pogodin/react-helmet";import{getLocaleFromPathname as u,withoutPathPrefix as E,withPathPrefix as r}from"@redocly/theme/core/utils";import{DEFAULT_LOCALE_PLACEHOLDER as R,ServerRoutes as L}from"../constants/common";import{CLIENT_TELEMETRY_ENABLED as O}from"./constants/common.js";import"./polyfills";import{PACKAGE_NAME as _,PRODUCT_NAME as D}from"../config/product-gates";import{App as g,routes as h}from"./App";import{Loader as v,useRefresh as x,globalData as t}from"./runtime/loader";import{initL10n as A}from"./app/l10n/initL10n";import{ServerStyleSheet as z,StyleSheetManager as G}from"styled-components";function P(){return x(),e.createElement(f,{context:{}},e.createElement(g,null))}function N(){t?.removeAttribution&&process.env.REDOCLY_PORTAL_VERSION?console.log(`
 %c Version: ${process.env.REDOCLY_PORTAL_VERSION} %c
 `,"background:#ffffff ; padding: 1px; border:1px solid #0044D4; border-radius: 3px; color: #0044D4","background:transparent"):process.env.REDOCLY_PORTAL_VERSION&&console.log(`
-%c Redocly ${N} %c ${process.env.REDOCLY_PORTAL_VERSION} %c
+%c Redocly ${D} %c ${process.env.REDOCLY_PORTAL_VERSION} %c
 
 %chttps://redocly.com
-`,"background:#0044D4 ; padding: 1px; border-radius: 3px 0 0 3px;  color: #fff; border:1px solid #0044D4","background:#ffffff ; padding: 1px; border:1px solid #0044D4; border-radius: 0 3px 3px 0; color: #0044D4","background:transparent","font-size: 10px; font-style: italic;")}async function S(){process.env.NODE_ENV!=="production"&&import("./runtime/ws-client").then(s=>s.listenWs()),await v.load(window.location.pathname,void 0,window.location.search),w();const o=t?.l10n,n=o?.locales||[],i=o?.defaultLocale||_,a=L(O(location.pathname),i,n);await g(o,a);const c=f([{Component:T,path:r("/*"),children:P}]);m(document.getElementById("app_root"),e.createElement(p,{future:{v7_startTransition:!1},router:c}))}S();export{j as ServerStyleSheet,J as StyleSheetManager};
+`,"background:#0044D4 ; padding: 1px; border-radius: 3px 0 0 3px;  color: #fff; border:1px solid #0044D4","background:#ffffff ; padding: 1px; border:1px solid #0044D4; border-radius: 0 3px 3px 0; color: #0044D4","background:transparent","font-size: 10px; font-style: italic;")}async function T(){process.env.NODE_ENV!=="production"&&import("./runtime/ws-client").then(l=>l.listenWs()),await v.load(window.location.pathname,void 0,window.location.search),N();const o=t?.l10n,n=o?.locales||[],i=o?.defaultLocale||R,a=u(E(location.pathname),i,n);await A(o,a);const c=d([{Component:P,path:r("/*"),children:h}]);p(document.getElementById("app_root"),e.createElement(m,{future:{v7_startTransition:!1},router:c}))}T();export{z as ServerStyleSheet,G as StyleSheetManager};

package/dist/client/constants/ai-search.d.ts

@@ -0,0 +1,30 @@
+import { AiSearchError } from '@redocly/theme/core/constants';
+/**
+ * SSE protocol prefix used by Server-Sent Events
+ * Following the SSE specification: https://html.spec.whatwg.org/multipage/server-sent-events.html
+ */
+export declare const SSE_DATA_PREFIX = "data: ";
+/**
+ * Maximum number of resources to display in the search results
+ * Limits UI clutter while providing sufficient context
+ */
+export declare const MAX_DISPLAYED_RESOURCES = 5;
+/**
+ * Default headers for AI search API requests
+ */
+export declare const AI_SEARCH_REQUEST_HEADERS: {
+    readonly 'Content-Type': "application/json";
+};
+export declare const SSE_EVENTS: {
+    readonly MESSAGE_ID: "messageId";
+    readonly SOURCES: "sources";
+    readonly ANSWER: "answer";
+    readonly TOOL_CALL: "toolCall";
+    readonly TOOL_RESULT: "toolResult";
+    readonly ERROR: "error";
+};
+/**
+ * Maps HTTP status codes to AI search error types
+ */
+export declare const HTTP_ERROR_MAP: Record<number, AiSearchError>;
+//# sourceMappingURL=ai-search.d.ts.map

package/dist/client/constants/ai-search.js

@@ -0,0 +1 @@
+import{AiSearchError as o}from"@redocly/theme/core/constants";const t="data: ",r=5,S={"Content-Type":"application/json"},e={MESSAGE_ID:"messageId",SOURCES:"sources",ANSWER:"answer",TOOL_CALL:"toolCall",TOOL_RESULT:"toolResult",ERROR:"error"},R={401:o.Unauthorized,403:o.Forbidden};export{S as AI_SEARCH_REQUEST_HEADERS,R as HTTP_ERROR_MAP,r as MAX_DISPLAYED_RESOURCES,t as SSE_DATA_PREFIX,e as SSE_EVENTS};

package/dist/client/constants/common.d.ts

@@ -0,0 +1,2 @@
+export declare const CLIENT_TELEMETRY_ENABLED: boolean;
+//# sourceMappingURL=common.d.ts.map

package/dist/client/constants/common.js

@@ -0,0 +1 @@
+const E=process.env.REDOCLY_TELEMETRY==="on";export{E as CLIENT_TELEMETRY_ENABLED};

package/dist/client/constants/index.d.ts

@@ -0,0 +1,2 @@
+export * from './ai-search';
+//# sourceMappingURL=index.d.ts.map

package/dist/client/constants/index.js

@@ -0,0 +1 @@
+export*from"./ai-search";

package/dist/client/runtime/useSocketMessages.js

@@ -1 +1 @@
-import{useEffect as s}from"react";import{addSocketMessageListener as t}from"./ws-client";function c(e,o){s(()=>t(e,o),[e,o])}export{c as useSocketMessages};
+import{useEffect as o,useRef as c}from"react";import{addSocketMessageListener as f}from"./ws-client";function i(e,r){const t=c(r);t.current=r,o(()=>f(e,s=>t.current(s)),[e])}export{i as useSocketMessages};

package/dist/{server/plugins/asyncapi-docs/template → client/templates/asyncapi-docs}/helpers.d.ts

@@ -3,9 +3,7 @@ export declare function useCollectMarkdocOptions({ markdown }: PageProps): {
     partials: Record<string, import("@markdoc/markdoc").Node | import("@markdoc/markdoc").Node[]> | undefined;
     variables?: Record<string, any>;
     tags: {
-        [x: string]: (import("@markdoc/markdoc").Schema & {
-            dynamicComponentLib: string;
-        }) | (import("@markdoc/markdoc").Schema<Readonly<Partial<{
+        [x: string]: (import("@markdoc/markdoc").Schema<Readonly<Partial<{
             nodes: Partial<Record<import("@markdoc/markdoc").NodeType, import("@markdoc/markdoc").Schema<Partial</*elided*/ any>, string>>>;
             tags: Record<string, import("@markdoc/markdoc").Schema>;
             variables: Record<string, any>;
@@ -20,6 +18,8 @@ export declare function useCollectMarkdocOptions({ markdown }: PageProps): {
             attributes?: Record<string, import("@markdoc/markdoc").SchemaAttribute & {
                 resolver?: string;
             }>;
+        }) | (import("@markdoc/markdoc").Schema & {
+            dynamicComponentLib?: string;
         });
     };
     nodes: {

package/dist/client/templates/asyncapi-docs/helpers.js

@@ -0,0 +1 @@
+import{useMemo as t}from"react";import{components as s}from"@redocly-markdoc/components";import{tags as m,components as r}from"@redocly/theme/markdoc/default";import*as n from"../../app/markdoc/custom-components/index.js";import*as e from"../../../markdoc/nodes/index.js";import p from"../../../markdoc/tags/index.js";import{parsePartials as a}from"../../templates/openapi-docs/helpers.js";function C({markdown:o}){return t(()=>({tags:{...p,...m},nodes:{...e},components:{...n,...r,...s,...globalThis.__LOADER.markdocComponents},...o,partials:a(o?.partials)}),[o])}export{C as useCollectMarkdocOptions};

package/dist/{server/plugins/asyncapi-docs/template/AsyncApiDocs.d.ts → client/templates/asyncapi-docs/template.d.ts}

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import type { LayoutVariant } from '@redocly/theme/components/SidebarActions/SidebarActions';
+import { LayoutVariant } from '@redocly/theme/components/SidebarActions/SidebarActions';
 type TemplateProps = {
     pageProps: {
         apiOptions: {
@@ -8,8 +8,9 @@ type TemplateProps = {
         settings: {
             baseUrlPath: string;
         };
+        metadata?: Record<string, unknown>;
     };
 };
 export default function AsyncApiDocs({ pageProps }: TemplateProps): React.JSX.Element;
 export {};
-//# sourceMappingURL=AsyncApiDocs.d.ts.map
+//# sourceMappingURL=template.d.ts.map

package/dist/client/templates/asyncapi-docs/template.js

@@ -0,0 +1,15 @@
+import o from"styled-components";import*as a from"react";import{RedoclyAsyncAPIDocs as p}from"@redocly/asyncapi-docs";import{LayoutVariant as d}from"@redocly/theme/components/SidebarActions/SidebarActions";import{ThreePanelLayout as f}from"@redocly/theme/layouts/ThreePanelLayout";import{CatalogClassicInfoBlock as h}from"@redocly/theme/components/CatalogClassic/CatalogClassicInfoBlock";import{withPathPrefix as u}from"@redocly/theme/core/utils";import{usePageSharedData as g}from"../../providers/page-data/hooks";import{useCollectMarkdocOptions as y}from"./helpers.js";function v({pageProps:t}){const r=g("AsyncApiDefinition"),{document:e,apiItems:i,protocol:n,downloadUrls:c}=r,l=u(t?.settings?.baseUrlPath),s=y(t),m=t.apiOptions?.layout;return a.createElement(A,null,a.createElement(E,{layout:m},a.createElement(h,{metadata:t.metadata})),a.createElement(p,{pageProps:t,document:e,apiItems:i,routingBasePath:l,protocol:n,downloadUrls:c,markdocOptions:s}))}const A=o.div`
+  a[id],
+  a[data-section-id],
+  div[data-section-id] {
+    scroll-margin-top: calc(
+      var(--navbar-height) + var(--banner-height) + var(--panel-gap-vertical)
+    );
+  }
+
+  --sidebar-width: 0px;
+`,E=o(f)`
+  && {
+    padding-right: ${({layout:t})=>t===d.THREE_PANEL?"calc(var(--panel-gap-horizontal) * 2)":"var(--panel-gap-horizontal)"};
+  }
+`;export{v as default};

package/dist/{server/plugins/openapi-docs/template → client/templates/openapi-docs}/helpers.d.ts

@@ -11,8 +11,8 @@ type OpenAPIDocsStore = {
 };
 export declare function joinWithSeparator(base?: string, path?: string, sep?: string): string;
 export declare function parsePartials(partials?: Record<string, any>): Record<string, Node | Node[]> | undefined;
-export declare function usePatchedStore(storeJs: OpenAPIDocsStore, { markdown, baseSlug }: PageProps): OpenAPIDocsStore;
+export declare function usePatchedStore(storeJs: OpenAPIDocsStore, { markdown, baseSlug, customFields }: PageProps): OpenAPIDocsStore;
 export declare function safeParseFunction(fnInput: EventFunctionInput): ((event: EventType) => void) | null;
-export declare function mergeEvents(userFunction: ((event: EventType) => void) | null, telemetryEvent?: AsyncApiRealmUI.GetEventData<'openapi_docs'>['eventType']): (event: EventType) => void;
+export declare function mergeEvents(userFunction: ((event: EventType) => void) | null, telemetryEvent?: AsyncApiRealmUI.GetEventData<'openapi_docs'>[number]['eventType']): (event: EventType) => void;
 export {};
 //# sourceMappingURL=helpers.d.ts.map

package/dist/client/templates/openapi-docs/helpers.js

@@ -0,0 +1,5 @@
+import{useMemo as v}from"react";import{components as _}from"@redocly-markdoc/components";import{Ast as S}from"@markdoc/markdoc";import{PageNavigation as y}from"@redocly/theme/components/PageNavigation/PageNavigation";import{tags as w,components as P}from"@redocly/theme/markdoc/default";import{Breadcrumbs as O}from"@redocly/theme/components/Breadcrumbs/Breadcrumbs";import{withPathPrefix as u}from"@redocly/theme/core/utils";import{OPENAPI_DOCS_TEMPLATE_ID as b,ServerRoutes as d}from"../../../constants/common.js";import{isBrowser as C}from"../../../utils/env/is-browser.js";import*as x from"../../../markdoc/nodes/index.js";import E from"../../../markdoc/tags/index.js";import*as A from"../../app/markdoc/custom-components/index.js";import{usePageData as R,useSidebarSiblingsData as T}from"../../providers/page-data/hooks";import{telemetry as U}from"../../app/telemetry/index.js";import{getMockServerDocsConfig as $}from"./mock-server-config.js";function K(e="",t="",o="/"){return e.endsWith(o)&&(e=e.slice(0,-o.length)),t.startsWith(o)&&(t=t.slice(o.length)),!e||!t?e+t:e+o+t}function D(e){if(e)return Object.entries(e).reduce((t,[o,s])=>(t[o]=S.fromJSON(JSON.stringify(s)),t),{})}function X(e,{markdown:t,baseSlug:o,customFields:s}){return v(()=>{const a=C();function m(n,i){return n?.replace(/\/$/,"")===i?.replace(/\/$/,"")}function g(n){return e.definition.servers?.find(i=>m(i.url,n.host))?.description||(n.environment?n.environment+" server":null)||"Computed server"}const c=s?.computedServers||e.definition["x-computed-servers"];if(c){const n=e.definition.servers?.filter(r=>!c.some(l=>m(l.host,r.url))),i=c.map(r=>{const l=g(r);return{...r,url:r.host,"x-isLive":!0,description:l,"x-labels":[r.tenant?{label:"Gateway Name",color:"gold",value:r.tenant}:null,r.environment?{label:"Env",color:"blue",value:r.environment}:null,r.version?{label:"Version",color:"green",value:r.version}:null].filter(Boolean)}});e.definition.servers=[...i||[],...n||[]]}if(e.options.oAuth2RedirectURI=a?`${window.location.origin}${u(d.REPLAY_OAUTH2_CALLBACK)}`:null,e.options.routingBasePath=u(o),e.options.mockServer=$(e.options.mockServer,o),!e.options.corsProxyUrl){const n=u(`${d.CORS_PROXY}/`);e.options.corsProxyUrl=a?new URL(n,window.location.origin).toString():n}e.options.scrollYOffset=a?parseInt(getComputedStyle(document.documentElement).getPropertyValue("--navbar-height"),10):0,e.options.markdocOptions={tags:{...E,...w},nodes:{...x},components:{...A,...P,..._,...globalThis.__LOADER.markdocComponents},...t,partials:D(t?.partials)},e.options.unstable_hooks={...e.options.unstable_hooks,MiddlePanelFooter:()=>{const{templateId:n}=R()||{},{nextPage:i,prevPage:r}=T()||{};return n===b?null:y({nextPage:i,prevPage:r})},MiddlePanelHeader:()=>O({})};const h={codeSamplesLanguageSwitch:"samples_language_switch",codeSamplesCopy:"code_samples_copy",panelToggle:"panel_toggle",targetServerSwitch:"target_server_switch",tryItOpen:"try_it_toggle",tryItSent:"try_it_sent"},f={};for(const[n,i]of Object.entries(h)){const r=I(e.options.events?.[n]);f[n]=L(r,i)}return e.options.events=f,e},[e,t,o,s])}function I(e){if(typeof window>"u")return null;if(typeof e=="function")return e;if(typeof e!="string")return null;try{const t=e.trim();if(!t.match(/^(\([^)]*\)\s*=>\s*.+|[a-zA-Z_$][\w$]*\s*=>\s*.+)$/))throw new Error("Invalid function format. Only arrow functions allowed.");if(["eval","Function","constructor","prototype","__proto__","import","require","process","global","window","document"].some(p=>t.includes(p)))throw new Error("Function contains prohibited keywords");return new Function("event",`
+      'use strict';
+      const userFn = ${t};
+      return userFn(event);
+    `)}catch(t){return console.error("Function parsing error:",t),null}}function L(e,t){return o=>{if(e)try{e(o)}catch(s){console.error("User event handler error:",s)}if(t)try{U.sendOpenapiDocsMessage([{object:"openapi_docs",eventType:t,operationHttpVerb:o.operationHttpVerb,operationPath:o.operationPath,lang:"lang"in o?o.lang:void 0,action:o.action,state:"state"in o?o.state:void 0,serverUrl:"serverUrl"in o?o.serverUrl:void 0}])}catch{}}}export{K as joinWithSeparator,L as mergeEvents,D as parsePartials,I as safeParseFunction,X as usePatchedStore};

package/dist/{server/plugins/openapi-docs/template/OpenAPIDocs.d.ts → client/templates/openapi-docs/template.d.ts}

@@ -3,4 +3,4 @@ import { type PageProps } from '@redocly/config';
 export default function OpenAPIDocs({ pageProps }: {
     pageProps: PageProps;
 }): React.JSX.Element | "Something went wrong";
-//# sourceMappingURL=OpenAPIDocs.d.ts.map
+//# sourceMappingURL=template.d.ts.map

package/dist/client/templates/openapi-docs/template.js

@@ -0,0 +1,18 @@
+import*as a from"react";import i from"styled-components";import{RedoclyOpenAPIDocs as c}from"@redocly/openapi-docs";import{LayoutVariant as s}from"@redocly/config";import{ThreePanelLayout as m}from"@redocly/theme/layouts/ThreePanelLayout";import{CatalogClassicInfoBlock as p}from"@redocly/theme/components/CatalogClassic/CatalogClassicInfoBlock";import{useUserClaims as h}from"../../app/hooks";import{usePageSharedData as u}from"../../providers/page-data/hooks";import{usePatchedStore as d}from"./helpers.js";function f({pageProps:t}){const o=h(),e=u("openAPIDocsStore"),n=a.useMemo(()=>({layout:t.apiOptions?.layout,userClaims:o}),[t.apiOptions?.layout,o]),r=d(e,t);if(!e)return"Something went wrong";const l=t.apiOptions?.layout;return a.createElement(g,null,a.createElement(v,{layout:l},a.createElement(p,{metadata:t.metadata})),a.createElement(c,{store:{options:r.options,definition:r.definition,withState:n}}))}const v=i(m)`
+  && {
+    padding-right: ${({layout:t})=>t===s.THREE_PANEL?"calc(var(--panel-gap-horizontal) * 2)":"var(--panel-gap-horizontal)"};
+  }
+`,g=i.div`
+  div[id] {
+    scroll-margin-top: calc(
+      var(--navbar-height) + var(--banner-height) - var(--panel-gap-vertical)
+    );
+  }
+  a[id] {
+    scroll-margin-top: calc(
+      var(--navbar-height) + var(--banner-height) + var(--panel-gap-vertical)
+    );
+  }
+
+  --sidebar-width: 0px;
+`;export{f as default};

package/dist/client/types/ai-search.d.ts

@@ -0,0 +1,73 @@
+import type { SearchFilterItem, ToolCallName } from '@redocly/theme/core/types';
+import type { SSE_EVENTS } from '../constants/ai-search';
+import type { AiSearchError } from '@redocly/theme/core/constants';
+export type SSEMessageType = (typeof SSE_EVENTS)[keyof typeof SSE_EVENTS];
+export type SearchResource = {
+    url: string;
+    title: string;
+};
+export type DocumentSource = SearchResource & {
+    id: string;
+};
+export type SSEMessageId = {
+    type: typeof SSE_EVENTS.MESSAGE_ID;
+    messageId: string;
+};
+export type SSESources = {
+    type: typeof SSE_EVENTS.SOURCES;
+    sources: DocumentSource[];
+};
+export type SSEAnswer = {
+    type: typeof SSE_EVENTS.ANSWER;
+    answer: string;
+};
+export type SSEToolCall = {
+    type: typeof SSE_EVENTS.TOOL_CALL;
+    toolCall: {
+        name: ToolCallName;
+        args: unknown;
+    };
+};
+export type SSEToolResult = {
+    type: typeof SSE_EVENTS.TOOL_RESULT;
+    result: {
+        documentCount: number;
+    };
+};
+export type SSEError = {
+    type: typeof SSE_EVENTS.ERROR;
+    error: {
+        message: string;
+    };
+};
+export type SSEMessage = SSEMessageId | SSESources | SSEAnswer | SSEToolCall | SSEToolResult | SSEError;
+export type ToolCallState = {
+    name: ToolCallName;
+    args: unknown;
+    position: number;
+    result?: {
+        documentCount: number;
+    };
+};
+export type AiSearchOptions = {
+    filter?: SearchFilterItem[];
+};
+export type AiSearchState = {
+    status: 'idle';
+    response?: string;
+} | {
+    status: 'loading';
+    question: string;
+    response: string;
+    resources: SearchResource[];
+} | {
+    status: 'success';
+    question: string;
+    response: string;
+    resources: SearchResource[];
+} | {
+    status: 'error';
+    question: string;
+    error: AiSearchError;
+};
+//# sourceMappingURL=ai-search.d.ts.map

package/dist/client/types/index.d.ts

@@ -2,4 +2,5 @@ export type * from './post-message';
 export type * from './dev-login';
 export * from './sidebar';
 export type * from './catalog';
+export type * from './ai-search';
 //# sourceMappingURL=index.d.ts.map

package/dist/client/utils/catalog/inject-catalog-items.d.ts

@@ -1,6 +1,6 @@
 import type { ResolvedNavItem } from '@redocly/config';
 /**
- * Injects catalog items into the sidebar items.
+ * Injects catalog items into the sidebar items
  */
 export declare function injectCatalogItems(sidebarItems: ResolvedNavItem[], entityId: string, catalogSlug: string | undefined, search: string): ResolvedNavItem[];
 //# sourceMappingURL=inject-catalog-items.d.ts.map

package/dist/client/utils/catalog/inject-catalog-items.js

@@ -1 +1 @@
-import{CATALOG_BASE_SLUG as s,CATALOG_SLUGS as l}from"../../../server/constants/plugins/catalog-entities.js";function c(e){const n=new URLSearchParams(e).get("revision"),t=new URLSearchParams(e).get("version");return n||t?`?${n?`revision=${encodeURIComponent(n)}`:""}${t?`&version=${encodeURIComponent(t)}`:""}`.trim():""}function m(e,n,t=l.ALL,a){const r=`${s}/${t}/entities/${n}`,o=c(a),i=[{type:"link",label:"Overview",link:`${r}${o}`},{type:"link",label:"Relations Graph",link:`${r}/relations-graph${o}`}];return!e||e.length===0?i:[...i,{type:"separator",separatorLine:!0},{type:"group",items:e,label:"Documentation"}]}export{m as injectCatalogItems};
+import{CATALOG_BASE_SLUG as s,CATALOG_SLUGS as l}from"../../../constants/catalog-entities.js";function c(e){const n=new URLSearchParams(e).get("revision"),t=new URLSearchParams(e).get("version");return n||t?`?${n?`revision=${encodeURIComponent(n)}`:""}${t?`&version=${encodeURIComponent(t)}`:""}`.trim():""}function m(e,n,t=l.ALL,a){const r=`${s}/${t}/entities/${n}`,o=c(a),i=[{type:"link",label:"Overview",link:`${r}${o}`},{type:"link",label:"Relations Graph",link:`${r}/relations-graph${o}`}];return!e||e.length===0?i:[...i,{type:"separator",separatorLine:!0},{type:"group",items:e,label:"Documentation"}]}export{m as injectCatalogItems};

package/dist/constants/catalog-entities.d.ts

@@ -0,0 +1,12 @@
+export declare const CATALOG_BASE_SLUG = "/catalogs";
+export declare const CATALOG_SLUGS: {
+    ALL: string;
+    SERVICES: string;
+    DOMAINS: string;
+    TEAMS: string;
+    USERS: string;
+    API_DESCRIPTIONS: string;
+    DATA_SCHEMAS: string;
+    API_OPERATIONS: string;
+};
+//# sourceMappingURL=catalog-entities.d.ts.map

package/dist/constants/catalog-entities.js

@@ -0,0 +1 @@
+const S="/catalogs",s={ALL:"all",SERVICES:"services",DOMAINS:"domains",TEAMS:"teams",USERS:"users",API_DESCRIPTIONS:"api-descriptions",DATA_SCHEMAS:"data-schemas",API_OPERATIONS:"api-operations"};export{S as CATALOG_BASE_SLUG,s as CATALOG_SLUGS};

package/dist/constants/common.d.ts

@@ -21,8 +21,6 @@ export declare const DEFAULT_THEME_NAME = "@redocly/theme";
 export declare const USER_THEME_ALIAS = "@theme";
 export declare const GLOBAL_DATA_URL = "/app-data.json";
 export declare const EJECT_COMPONENT_URL = "/eject-component";
-export declare const SERVER_EDITOR_APP_URL: string;
-export declare const ALLOWED_CORS_ORIGINS: string[];
 export declare enum cliCommandNames {
     BUILD = "build",
     DEVELOP = "develop",
@@ -37,8 +35,10 @@ export declare enum FEEDBACK_TYPES {
     SCALE = "scale"
 }
 export declare const CATALOG_ENTITY_KEY = "entityKey";
+export declare const CATALOG_ENTITY_ID = "entityId";
 export declare const CATALOG_ENTITY_RELATION_ID = "entityRelationId";
 export declare const ServerRoutes: {
+    readonly CORS_PROXY: "/_api/cors";
     readonly INFO: "/_info";
     readonly EJECT_COMPONENT: "/eject-component/:componentName";
     readonly SHARED_PAGE_DATA: "/page-data/shared/*";
@@ -53,6 +53,7 @@ export declare const ServerRoutes: {
     readonly REDOCLY_TOKEN_LOGIN: "/_auth/redocly-token-login";
     readonly SEARCH: "/_search";
     readonly SEARCH_FACETS: "/_search-facets";
+    readonly SEMANTIC_SEARCH: "/_semantic-search";
     readonly LOGOUT: "/logout";
     readonly POST_LOGOUT: "/post-logout";
     readonly LOGIN: "/login";
@@ -67,13 +68,13 @@ export declare const ServerRoutes: {
     readonly OTEL_TRACES: "/_otel/v1/traces";
     readonly HEALTH: "/_health";
     readonly ASK_AI: "/_ask-ai";
-    readonly CATALOG_ENTITIES: "/catalog-entities/:entityKey?";
+    readonly CATALOG_ENTITIES: "/catalog-entities/:entityId?";
     readonly CATALOG_ENTITIES_RELATIONS: "/catalog-entities-relations/:entityRelationId?";
     readonly BFF_CATALOG_ENTITIES: "/bff/catalog-entities/:entityKey?";
     readonly BFF_CATALOG_RELATED_ENTITIES: "/bff/catalog-related-entities/:entityKey";
     readonly BFF_CATALOG_REVISIONS: "/bff/catalog-revisions/:entityKey";
     readonly MCP_OAUTH_AUTHORIZATION_SERVER: "/.well-known/oauth-authorization-server";
-    readonly MCP_OAUTH_PROTECTED_RESOURCE: "/.well-known/oauth-protected-resource/mcp";
+    readonly MCP_OAUTH_PROTECTED_RESOURCE: "/.well-known/oauth-protected-resource";
     readonly MCP_DYNAMIC_CLIENT_REGISTRATION: "/_mcp/register";
     readonly MCP_AUTHORIZATION: "/_mcp/oauth2/auth";
     readonly MCP_TOKEN_PORTAL: "/_mcp/oauth2/token-portal";
@@ -94,6 +95,7 @@ export declare const FsErrors: {
 export declare const DEFAULT_LOCALE_PLACEHOLDER = "default_locale";
 export declare const SIDEBAR_PREFIX = "sidebar-";
 export declare const PUBLIC_ENV_PREFIX = "PUBLIC_";
+export declare const BRANCH_ENV_PREFIX = "branch.";
 export declare const MARKDOC_ERROR_TYPES: readonly ["BROKEN_LINK", "MARKDOC", "RESOLVE"];
 export declare const UI_ACCESSIBLE_CONFIG_PROPS: (keyof UiAccessibleConfig & keyof RedoclyConfig)[];
 export declare const SEARCH_CATEGORY_FIELD = "redocly_category";

package/dist/constants/common.js

@@ -1 +1 @@
-const E="openapi_docs",n="asyncapi_docs",A="graphql_docs",T="/_spec-gql",O="markdoc",p="tags",i="*",R={"*":"read"},L=["openid","email"],I=1440*60,C="anonymous",l="authenticated",S="**",d="Reunite",N="translations.yaml",P="redocly.yaml",u="@redocly/theme",D="@theme",h="/app-data.json",x="/eject-component",e=process.env.SERVER_EDITOR_APP_URL||"http://127.0.0.1:3000",g=process.env.REDOCLY_CORS_ORIGINS?process.env.REDOCLY_CORS_ORIGINS.split(",").map(o=>o.trim()).filter(Boolean).concat(e):[e];var a;(function(o){o.BUILD="build",o.DEVELOP="develop",o.PREPARE="prepare"})(a||(a={}));var r;(function(o){o.RATING="rating",o.SENTIMENT="sentiment",o.COMMENT="comment",o.MOOD="mood",o.PROBLEM="problem",o.SCALE="scale"})(r||(r={}));const t="entityKey",c="entityRelationId",U={INFO:"/_info",EJECT_COMPONENT:"/eject-component/:componentName",SHARED_PAGE_DATA:"/page-data/shared/*",PAGE_DATA:"/page-data/*",APP_DATA:"/app-data.json",AUTHORIZATION:"/authorize",OIDC_CALLBACK:"/_auth/oidc",SAML_CALLBACK:"/_auth/saml2",REDOCLY_CALLBACK:"/_auth/redocly",REPLAY_OAUTH2_CALLBACK:"/_auth/replay-oauth2",REDOCLY_LOGIN_CALLBACK:"/_auth/redocly/redocly-login",REDOCLY_TOKEN_LOGIN:"/_auth/redocly-token-login",SEARCH:"/_search",SEARCH_FACETS:"/_search-facets",LOGOUT:"/logout",POST_LOGOUT:"/post-logout",LOGIN:"/login",IDP_LOGIN:"/_auth/idp-login",INVITE:"/invite/:code",RESOLVE_ROUTE_BY_PATH:"/resolve-route-by-path",RESOLVE_ROUTES_BY_PATHS:"/resolve-routes-by-paths",RESOLVE_ROUTE_BY_SLUG:"/resolve-route-by-slug",GET_ROUTES_BY_LINE:"/get-routes-by-line",FEEDBACK:"/feedback",TELEMETRY:"/_events",OTEL_TRACES:"/_otel/v1/traces",HEALTH:"/_health",ASK_AI:"/_ask-ai",CATALOG_ENTITIES:`/catalog-entities/:${t}?`,CATALOG_ENTITIES_RELATIONS:`/catalog-entities-relations/:${c}?`,BFF_CATALOG_ENTITIES:`/bff/catalog-entities/:${t}?`,BFF_CATALOG_RELATED_ENTITIES:`/bff/catalog-related-entities/:${t}`,BFF_CATALOG_REVISIONS:`/bff/catalog-revisions/:${t}`,MCP_OAUTH_AUTHORIZATION_SERVER:"/.well-known/oauth-authorization-server",MCP_OAUTH_PROTECTED_RESOURCE:"/.well-known/oauth-protected-resource/mcp",MCP_DYNAMIC_CLIENT_REGISTRATION:"/_mcp/register",MCP_AUTHORIZATION:"/_mcp/oauth2/auth",MCP_TOKEN_PORTAL:"/_mcp/oauth2/token-portal",MCP_CALLBACK:"/_mcp/oauth/callback",SCORECARDS:"/scorecards"};var _;(function(o){o.AI_SEARCH="aiSearch"})(_||(_={}));const m="/login",M="/invite",G={AUTH0_PASS:"/auth/auth0-pass"},b={NotExist:"ENOENT"},H="default_locale",v="sidebar-",F="PUBLIC_",y=["BROKEN_LINK","MARKDOC","RESOLVE"],B=["logo","navbar","products","footer","sidebar","scripts","links","feedback","search","aiAssistant","colorMode","navigation","codeSnippet","markdown","openapi","graphql","analytics","userMenu","versionPicker","breadcrumbs","catalog","entitiesCatalog","scorecard","scorecards","scorecardClassic","mcp","banner"],s="redocly_category",k="redocly_product",f="redocly_version",K="redocly_teams",V=s,Y={asyncapi:"asyncapi",apiFunctions:"apiFunctions",reactPages:"reactPages",catalog:"catalog",catalogClassic:"catalogClassic",lint:"lint",scorecard:"scorecard",scorecards:"scorecards",l10n:"l10n",openapi:"openapi",graphql:"graphql",markdown:"markdown",devOnboarding:"devOnboarding",seo:"seo",redirects:"redirects",customPlugins:"customPlugins",themeEjecting:"themeEjecting",products:"products",breadcrumbs:"breadcrumbs",mockServer:"mockServer",sso:"sso",rbac:"rbac",analytics:"analytics",removeAttribution:"removeAttribution",advancedSearch:"advancedSearch",soap:"soap",ssoDirect:"ssoDirect",codeWalkthrough:"codeWalkthrough",aiSearchLimit:"aiSearchLimit",mcp:"mcp",banner:"banner"};export{g as ALLOWED_CORS_ORIGINS,n as ASYNC_API_DOCS_TEMPLATE_ID,t as CATALOG_ENTITY_KEY,c as CATALOG_ENTITY_RELATION_ID,P as CONFIG_FILE_NAME,O as CUSTOM_MARKDOC_OPTIONS_PATH,p as CUSTOM_MARKDOC_TAGS_PATH,C as DEFAULT_ANONYMOUS_VISITOR_TEAM,l as DEFAULT_AUTHENTICATED_TEAM,I as DEFAULT_COOKIE_EXPIRATION,H as DEFAULT_LOCALE_PLACEHOLDER,S as DEFAULT_RBAC_SCOPE,d as DEFAULT_SSO_IDP_TITLE,u as DEFAULT_THEME_NAME,m as DEV_LOGIN_SLUG,x as EJECT_COMPONENT_URL,G as ExternalRoutes,Y as FEATURE,r as FEEDBACK_TYPES,b as FsErrors,h as GLOBAL_DATA_URL,T as GRAPHQL_SPEC_SLUG,A as GRAPHQL_TEMPLATE_ID,M as INVITE_SLUG,y as MARKDOC_ERROR_TYPES,E as OPENAPI_DOCS_TEMPLATE_ID,F as PUBLIC_ENV_PREFIX,R as PUBLIC_RBAC_SCOPE_ITEM,i as RBAC_ALL_OTHER_TEAMS,L as REQUIRED_OIDC_SCOPES,_ as RbacFeatures,s as SEARCH_CATEGORY_FIELD,V as SEARCH_GROUP_FACET_FIELD,k as SEARCH_PRODUCT_FIELD,K as SEARCH_RBAC_FIELD,f as SEARCH_VERSION_FIELD,e as SERVER_EDITOR_APP_URL,v as SIDEBAR_PREFIX,U as ServerRoutes,N as TRANSLATIONS_FILE_NAME,B as UI_ACCESSIBLE_CONFIG_PROPS,D as USER_THEME_ALIAS,a as cliCommandNames};
+const E="openapi_docs",n="asyncapi_docs",A="graphql_docs",T="/_spec-gql",O="markdoc",i="tags",p="*",L={"*":"read"},C=["openid","email"],R=1440*60,I="anonymous",l="authenticated",S="**",d="Reunite",N="translations.yaml",u="redocly.yaml",P="@redocly/theme",D="@theme",h="/app-data.json",x="/eject-component";var e;(function(t){t.BUILD="build",t.DEVELOP="develop",t.PREPARE="prepare"})(e||(e={}));var a;(function(t){t.RATING="rating",t.SENTIMENT="sentiment",t.COMMENT="comment",t.MOOD="mood",t.PROBLEM="problem",t.SCALE="scale"})(a||(a={}));const o="entityKey",_="entityId",c="entityRelationId",g={CORS_PROXY:"/_api/cors",INFO:"/_info",EJECT_COMPONENT:"/eject-component/:componentName",SHARED_PAGE_DATA:"/page-data/shared/*",PAGE_DATA:"/page-data/*",APP_DATA:"/app-data.json",AUTHORIZATION:"/authorize",OIDC_CALLBACK:"/_auth/oidc",SAML_CALLBACK:"/_auth/saml2",REDOCLY_CALLBACK:"/_auth/redocly",REPLAY_OAUTH2_CALLBACK:"/_auth/replay-oauth2",REDOCLY_LOGIN_CALLBACK:"/_auth/redocly/redocly-login",REDOCLY_TOKEN_LOGIN:"/_auth/redocly-token-login",SEARCH:"/_search",SEARCH_FACETS:"/_search-facets",SEMANTIC_SEARCH:"/_semantic-search",LOGOUT:"/logout",POST_LOGOUT:"/post-logout",LOGIN:"/login",IDP_LOGIN:"/_auth/idp-login",INVITE:"/invite/:code",RESOLVE_ROUTE_BY_PATH:"/resolve-route-by-path",RESOLVE_ROUTES_BY_PATHS:"/resolve-routes-by-paths",RESOLVE_ROUTE_BY_SLUG:"/resolve-route-by-slug",GET_ROUTES_BY_LINE:"/get-routes-by-line",FEEDBACK:"/feedback",TELEMETRY:"/_events",OTEL_TRACES:"/_otel/v1/traces",HEALTH:"/_health",ASK_AI:"/_ask-ai",CATALOG_ENTITIES:`/catalog-entities/:${_}?`,CATALOG_ENTITIES_RELATIONS:`/catalog-entities-relations/:${c}?`,BFF_CATALOG_ENTITIES:`/bff/catalog-entities/:${o}?`,BFF_CATALOG_RELATED_ENTITIES:`/bff/catalog-related-entities/:${o}`,BFF_CATALOG_REVISIONS:`/bff/catalog-revisions/:${o}`,MCP_OAUTH_AUTHORIZATION_SERVER:"/.well-known/oauth-authorization-server",MCP_OAUTH_PROTECTED_RESOURCE:"/.well-known/oauth-protected-resource",MCP_DYNAMIC_CLIENT_REGISTRATION:"/_mcp/register",MCP_AUTHORIZATION:"/_mcp/oauth2/auth",MCP_TOKEN_PORTAL:"/_mcp/oauth2/token-portal",MCP_CALLBACK:"/_mcp/oauth/callback",SCORECARDS:"/scorecards"};var r;(function(t){t.AI_SEARCH="aiSearch"})(r||(r={}));const U="/login",m="/invite",M={AUTH0_PASS:"/auth/auth0-pass"},b={NotExist:"ENOENT"},G="default_locale",H="sidebar-",F="PUBLIC_",y="branch.",v=["BROKEN_LINK","MARKDOC","RESOLVE"],B=["logo","navbar","products","footer","sidebar","scripts","links","feedback","search","aiAssistant","colorMode","navigation","codeSnippet","markdown","openapi","graphql","analytics","userMenu","versionPicker","breadcrumbs","catalog","entitiesCatalog","scorecard","scorecards","scorecardClassic","mcp","banner"],s="redocly_category",k="redocly_product",f="redocly_version",K="redocly_teams",Y=s,V={asyncapi:"asyncapi",apiFunctions:"apiFunctions",reactPages:"reactPages",catalog:"catalog",catalogClassic:"catalogClassic",lint:"lint",scorecard:"scorecard",scorecards:"scorecards",l10n:"l10n",openapi:"openapi",graphql:"graphql",markdown:"markdown",devOnboarding:"devOnboarding",seo:"seo",redirects:"redirects",customPlugins:"customPlugins",themeEjecting:"themeEjecting",products:"products",breadcrumbs:"breadcrumbs",mockServer:"mockServer",sso:"sso",rbac:"rbac",analytics:"analytics",removeAttribution:"removeAttribution",advancedSearch:"advancedSearch",soap:"soap",ssoDirect:"ssoDirect",codeWalkthrough:"codeWalkthrough",aiSearchLimit:"aiSearchLimit",mcp:"mcp",banner:"banner"};export{n as ASYNC_API_DOCS_TEMPLATE_ID,y as BRANCH_ENV_PREFIX,_ as CATALOG_ENTITY_ID,o as CATALOG_ENTITY_KEY,c as CATALOG_ENTITY_RELATION_ID,u as CONFIG_FILE_NAME,O as CUSTOM_MARKDOC_OPTIONS_PATH,i as CUSTOM_MARKDOC_TAGS_PATH,I as DEFAULT_ANONYMOUS_VISITOR_TEAM,l as DEFAULT_AUTHENTICATED_TEAM,R as DEFAULT_COOKIE_EXPIRATION,G as DEFAULT_LOCALE_PLACEHOLDER,S as DEFAULT_RBAC_SCOPE,d as DEFAULT_SSO_IDP_TITLE,P as DEFAULT_THEME_NAME,U as DEV_LOGIN_SLUG,x as EJECT_COMPONENT_URL,M as ExternalRoutes,V as FEATURE,a as FEEDBACK_TYPES,b as FsErrors,h as GLOBAL_DATA_URL,T as GRAPHQL_SPEC_SLUG,A as GRAPHQL_TEMPLATE_ID,m as INVITE_SLUG,v as MARKDOC_ERROR_TYPES,E as OPENAPI_DOCS_TEMPLATE_ID,F as PUBLIC_ENV_PREFIX,L as PUBLIC_RBAC_SCOPE_ITEM,p as RBAC_ALL_OTHER_TEAMS,C as REQUIRED_OIDC_SCOPES,r as RbacFeatures,s as SEARCH_CATEGORY_FIELD,Y as SEARCH_GROUP_FACET_FIELD,k as SEARCH_PRODUCT_FIELD,K as SEARCH_RBAC_FIELD,f as SEARCH_VERSION_FIELD,H as SIDEBAR_PREFIX,g as ServerRoutes,N as TRANSLATIONS_FILE_NAME,B as UI_ACCESSIBLE_CONFIG_PROPS,D as USER_THEME_ALIAS,e as cliCommandNames};