@redocly/redoc 0.137.0-next.1 → 0.137.0-next.11

package/dist/api-schemas/otel-traces.js

@@ -0,0 +1 @@
+import{z as r}from"zod";const a=r.object({key:r.string(),value:r.record(r.unknown())}).passthrough(),t=r.object({name:r.string(),attributes:r.array(a)}).passthrough(),s=r.object({resource:r.object({attributes:r.array(a)}).passthrough(),scopeSpans:r.array(r.object({spans:r.array(t)}).passthrough())}).passthrough(),o=r.object({resourceSpans:r.array(s).optional()}).passthrough();export{o as otelTracesRequestSchema};

package/dist/cli/stats/collectors/asyncapi/index.d.ts

@@ -0,0 +1,3 @@
+import type { LifecycleContext } from '../../../../server/types';
+export declare function collectAsyncapiDocumentsStatistics(lifecycleContext: LifecycleContext, telemetryEnabled: boolean): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/stats/collectors/asyncapi/index.js

@@ -0,0 +1 @@
+import{normalizeVisitors as l,StatsAsync2 as m,StatsAsync3 as p,walkDocument as y}from"@redocly/openapi-core";import{telemetry as u}from"../../../telemetry/index.js";import{createExtensionsVisitor as x,toCollectedExtensions as f}from"../extension-sampling.js";import{prepareStatsWalk as S}from"../prepare-stats-walk.js";import{runStatsCollector as h}from"../run-stats-collector.js";function w(){return{refs:{metric:"References",total:0,color:"red",items:new Set},externalDocs:{metric:"External Documents",total:0,color:"magenta"},schemas:{metric:"Schemas",total:0,color:"white"},parameters:{metric:"Parameters",total:0,color:"yellow",items:new Set},channels:{metric:"Channels",total:0,color:"green"},operations:{metric:"Operations",total:0,color:"yellow"},tags:{metric:"Tags",total:0,color:"white",items:new Set},xExtensions:{metric:"Vendor Extensions",total:0,color:"cyan"}}}async function V(s,e){await h(s,e,{type:"asyncapi",label:"AsyncAPI",event:"com.redocly.stats.asyncapi",object:"asyncapiDefinition",computeStats:d,send:(o,a)=>u.sendStatsAsyncapiCollectedMessage([{...a,...o}])})}async function d(s){const{specVersion:e,types:o,rootType:a,document:n,resolvedRefMap:c}=await S(s.document),t=w(),r={},i={problems:[],specVersion:e,visitorsData:{}};return y({rootType:a,normalizedVisitors:l([{severity:"warn",ruleId:"asyncapi_stats",visitor:e==="async2"?m(t):p(t)},{severity:"warn",ruleId:"extension_usage",visitor:x(r)}],o),resolvedRefMap:c,document:n,ctx:i}),{path:s.relativePath,refs:t.refs.total,externalDocs:t.externalDocs.total,schemas:t.schemas.total,parameters:t.parameters.total,channels:t.channels.total,operations:t.operations.total,tags:t.tags.total,version:e,xExtensions:f(r)}}export{V as collectAsyncapiDocumentsStatistics};

package/dist/cli/stats/collectors/extension-sampling.d.ts

@@ -0,0 +1,44 @@
+import type { UserContext } from '@redocly/openapi-core';
+export type ExtensionAccumulator = {
+    count: number;
+    props: Record<string, Set<string>>;
+};
+export type ExtensionsAccumulator = Record<string, ExtensionAccumulator>;
+export type CollectedExtension = {
+    count: number;
+    props: Record<string, string>;
+};
+export declare function createExtensionsVisitor(accumulator: ExtensionsAccumulator): {
+    any: {
+        enter(node: unknown): void;
+    };
+    SpecExtension: {
+        enter(value: unknown, ctx: UserContext): void;
+    };
+    XCodeSampleList: {
+        enter(value: unknown, ctx: UserContext): void;
+    };
+    ExamplesMap: {
+        enter(value: unknown, ctx: UserContext): void;
+    };
+    EnumDescriptions: {
+        enter(value: unknown, ctx: UserContext): void;
+    };
+    TagGroups: {
+        enter(value: unknown, ctx: UserContext): void;
+    };
+    Logo: {
+        enter(value: unknown, ctx: UserContext): void;
+    };
+    XServerList: {
+        enter(value: unknown, ctx: UserContext): void;
+    };
+    XUsePkce: {
+        enter(value: unknown, ctx: UserContext): void;
+    };
+    WebhooksMap: {
+        enter(value: unknown, ctx: UserContext): void;
+    };
+};
+export declare function toCollectedExtensions(accumulator: ExtensionsAccumulator): Record<string, CollectedExtension> | undefined;
+//# sourceMappingURL=extension-sampling.d.ts.map

package/dist/cli/stats/collectors/extension-sampling.js

@@ -0,0 +1 @@
+import{isRedocExtension as S}from"@redocly/api-docs/lib/utils/extract-extensions.js";import{REDOCLY_TEAMS_RBAC as O}from"@redocly/config";import{isRef as m}from"@redocly/openapi-core";const u=40,g=20,R=20,f="$value",h="$keys",E="<truncated>",a="<masked>",x=new Set(["x-metadata","x-enumDescriptions","x-webhooks","x-examples"]),d="x-rbac",P=/key|token|secret|password|credential|session|bearer|auth|email|phone|contact|url|uri|host|domain|address|location/i,j=/^(?=.*\d)[A-Za-z0-9+/=_-]{16,}$/,_=/\S@\S+\.\S/,y=/:\/\//;function K(t){const n={enter(r,o){if(m(o.parent))return;const s=o.key.toString();S(s)&&A(t,s,r)}};return{any:{enter(r){if(!i(r))return;const o=r[O];o!==void 0&&A(t,d,o)}},SpecExtension:n,XCodeSampleList:n,ExamplesMap:n,EnumDescriptions:n,TagGroups:n,Logo:n,XServerList:n,XUsePkce:n,WebhooksMap:n}}function w(t){const n=Object.fromEntries(Object.entries(t).map(([e,{count:r,props:o}])=>[e,{count:r,props:Object.fromEntries(Object.entries(o).map(([s,c])=>[s,[...c].sort().join(", ")]))}]));return Object.keys(n).length>0?n:void 0}function A(t,n,e){const r=t[n]??={count:0,props:{}};if(r.count++,n===d){L(r.props,e);return}if(x.has(n)){l(r.props,e);return}for(const[o,s]of k(e)){const c=P.test(o)?a:b(s);p(r.props,T(o),c)}}function l(t,n){if(i(n))for(const[e,r]of Object.entries(n))p(t,h,`${N(e)}:${X(r)}`)}function L(t,n){if(i(n))for(const e of Object.values(n))p(t,f,b(e))}function X(t){return t===null?"null":Array.isArray(t)?"array":typeof t}function k(t){return i(t)?Object.entries(t):Array.isArray(t)?t.flatMap(n=>i(n)?Object.entries(n):[[f,n]]):[[f,t]]}function b(t){return t===null?"<null>":typeof t=="boolean"||typeof t=="number"?String(t):typeof t=="string"?j.test(t)||_.test(t)||y.test(t)?a:t.length<=u?t:`<string:${t.length}>`:Array.isArray(t)?`<array:${t.length}>`:i(t)?"$ref"in t?"<ref>":"<object>":"<unknown>"}function N(t){return _.test(t)||y.test(t)?a:t.length<=u?t:`<string:${t.length}>`}function p(t,n,e){!(n in t)&&Object.keys(t).length>=R&&(n=E),M(t[n]??=new Set,e)}function M(t,n){t.has(n)||t.has(E)||t.add(t.size>=g?E:n)}function T(t){return t.replace(/\./g,"_").replace(/([a-z0-9])([A-Z])/g,"$1_$2").toLowerCase()}function i(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)}export{K as createExtensionsVisitor,w as toCollectedExtensions};

package/dist/cli/stats/collectors/openapi/index.js

@@ -1 +1 @@
-import{detectSpec as u,getTypes as d,normalizeTypes as h,normalizeVisitors as w,resolveDocument as y,BaseResolver as D,StatsOAS as S,walkDocument as g}from"@redocly/openapi-core";import{logger as m}from"../../../../server/tools/notifiers/logger.js";import{envConfig as I}from"../../../../server/config/env-config.js";import{telemetryTraceStep as O}from"../../../telemetry/helpers/trace-step.js";import{telemetry as b}from"../../../telemetry/index.js";import{computeOas32Stats as v}from"./oas32.js";const t={refs:{metric:"References",total:0,color:"red",items:new Set},externalDocs:{metric:"External Documents",total:0,color:"magenta"},schemas:{metric:"Schemas",total:0,color:"white"},parameters:{metric:"Parameters",total:0,color:"yellow",items:new Set},links:{metric:"Links",total:0,color:"cyan",items:new Set},pathItems:{metric:"Path Items",total:0,color:"green"},webhooks:{metric:"Webhooks",total:0,color:"green"},operations:{metric:"Operations",total:0,color:"yellow"},tags:{metric:"Tags",total:0,color:"white",items:new Set}};async function _(n,s){await O("com.redocly.stats.openapi",async()=>{m.info("OpenAPI collector: start processing documents...");const e=(await n.cache.load(".","api-docs")).data,a=[];for(const r of e){if(r.type!=="openapi"||r.isVirtual)continue;const o=await k(r);a.push(o),b.sendStatsOpenapiCollectedMessage([{id:o.path,object:"openapiDefinition",uri:`urn:redocly:realm:cli:openapiDefinition:${o.path}`,...o,projectBuildId:I.PROJECT_BUILD_ID||""}])}s||console.table(a),m.info("OpenAPI collector: openapi documents processing completed.")})}async function k(n){const s=n.document,e=u(s),a=h(d(e)),r=w([{severity:"warn",ruleId:"openapi_stats",visitor:S(t)}],a),o={problems:[],specVersion:e,visitorsData:{}},c={source:{absoluteRef:""},parsed:s},i=a.Root;if(!i)throw new Error("Root type not found in OpenAPI spec types");const f=await y({rootDocument:c,rootType:i,externalRefResolver:new D});g({rootType:i,normalizedVisitors:r,resolvedRefMap:f,document:c,ctx:o});const l={path:n.relativePath,refs:t.refs.total,externalDocs:t.externalDocs.total,schemas:t.schemas.total,parameters:t.parameters.total,links:t.links.total,pathItems:t.pathItems.total,webhooks:t.webhooks.total,operations:t.operations.total,tags:t.tags.total,version:e};if(e==="oas3_2"){const p=v(s);p&&Object.assign(l,p)}return l}export{_ as collectOpenapiDocumentsStatistics};
+import{normalizeVisitors as p,StatsOAS as u,walkDocument as h}from"@redocly/openapi-core";import{telemetry as w}from"../../../telemetry/index.js";import{createExtensionsVisitor as f,toCollectedExtensions as x}from"../extension-sampling.js";import{prepareStatsWalk as S}from"../prepare-stats-walk.js";import{runStatsCollector as y}from"../run-stats-collector.js";import{computeOas32Stats as d}from"./oas32.js";function g(){return{refs:{metric:"References",total:0,color:"red",items:new Set},externalDocs:{metric:"External Documents",total:0,color:"magenta"},schemas:{metric:"Schemas",total:0,color:"white"},parameters:{metric:"Parameters",total:0,color:"yellow",items:new Set},links:{metric:"Links",total:0,color:"cyan",items:new Set},pathItems:{metric:"Path Items",total:0,color:"green"},webhooks:{metric:"Webhooks",total:0,color:"green"},operations:{metric:"Operations",total:0,color:"yellow"},tags:{metric:"Tags",total:0,color:"white",items:new Set},xExtensions:{metric:"Vendor Extensions",total:0,color:"cyan"}}}async function A(e,o){await y(e,o,{type:"openapi",label:"OpenAPI",event:"com.redocly.stats.openapi",object:"openapiDefinition",computeStats:k,send:(s,a)=>w.sendStatsOpenapiCollectedMessage([{...a,...s}])})}async function k(e){const{specVersion:o,types:s,rootType:a,document:i,resolvedRefMap:l}=await S(e.document),t=g(),r={},m={problems:[],specVersion:o,visitorsData:{}};h({rootType:a,normalizedVisitors:p([{severity:"warn",ruleId:"openapi_stats",visitor:u(t)},{severity:"warn",ruleId:"extension_usage",visitor:f(r)}],s),resolvedRefMap:l,document:i,ctx:m});const n={path:e.relativePath,refs:t.refs.total,externalDocs:t.externalDocs.total,schemas:t.schemas.total,parameters:t.parameters.total,links:t.links.total,pathItems:t.pathItems.total,webhooks:t.webhooks.total,operations:t.operations.total,tags:t.tags.total,version:o,xExtensions:x(r)};if(o==="oas3_2"){const c=d(e.document);c&&Object.assign(n,c)}return n}export{A as collectOpenapiDocumentsStatistics};

package/dist/cli/stats/collectors/prepare-stats-walk.d.ts

@@ -0,0 +1,10 @@
+import type { Document, NormalizedNodeType, ResolvedRefMap, SpecVersion } from '@redocly/openapi-core';
+export type PreparedStatsWalk = {
+    specVersion: SpecVersion;
+    types: Record<string, NormalizedNodeType>;
+    rootType: NormalizedNodeType;
+    document: Document;
+    resolvedRefMap: ResolvedRefMap;
+};
+export declare function prepareStatsWalk(parsed: unknown): Promise<PreparedStatsWalk>;
+//# sourceMappingURL=prepare-stats-walk.d.ts.map

package/dist/cli/stats/collectors/prepare-stats-walk.js

@@ -0,0 +1 @@
+import{BaseResolver as c,detectSpec as p,getTypes as a,normalizeTypes as u,resolveDocument as i,Source as l}from"@redocly/openapi-core";async function f(t){const e=p(t),n=u(a(e)),o=n.Root;if(!o)throw new Error(`Root type not found in ${e} spec types`);const r={source:new l("",""),parsed:t},s=await i({rootDocument:r,rootType:o,externalRefResolver:new c});return{specVersion:e,types:n,rootType:o,document:r,resolvedRefMap:s}}export{f as prepareStatsWalk};

package/dist/cli/stats/collectors/run-stats-collector.d.ts

@@ -0,0 +1,24 @@
+import type { EventType } from '@redocly/realm-asyncapi-sdk/cli-telemetry';
+import type { CollectedExtension } from './extension-sampling.js';
+import type { BundledApiDefinition } from '../../../server/plugins/api-docs/loader.js';
+import type { LifecycleContext } from '../../../server/types';
+export type CollectedDefinitionBase<TObject extends string = string> = {
+    id: string;
+    uri: string;
+    projectBuildId: string;
+    object: TObject;
+};
+export type CollectedStats = {
+    path: string;
+    xExtensions?: Record<string, CollectedExtension>;
+};
+export type StatsCollector<TStats extends CollectedStats, TObject extends string = string> = {
+    type: BundledApiDefinition['type'];
+    label: string;
+    event: EventType;
+    object: TObject;
+    computeStats: (definition: BundledApiDefinition) => Promise<TStats>;
+    send: (stats: TStats, base: CollectedDefinitionBase<TObject>) => void;
+};
+export declare function runStatsCollector<TStats extends CollectedStats, TObject extends string>(lifecycleContext: LifecycleContext, telemetryEnabled: boolean, { type, label, event, object, computeStats, send }: StatsCollector<TStats, TObject>): Promise<void>;
+//# sourceMappingURL=run-stats-collector.d.ts.map

package/dist/cli/stats/collectors/run-stats-collector.js

@@ -0,0 +1 @@
+import{logger as u}from"../../../server/tools/notifiers/logger.js";import{envConfig as d}from"../../../server/config/env-config.js";import{telemetryTraceStep as g}from"../../telemetry/helpers/trace-step.js";async function C(o,s,{type:t,label:e,event:c,object:r,computeStats:p,send:a}){await g(c,async()=>{u.info(`${e} collector: start processing documents...`);const f=(await o.cache.load(".","api-docs")).data.filter(n=>n.type===t&&!n.isVirtual),l=[];for(const n of f){let i;try{i=await p(n)}catch(m){u.warn(`${e} collector: skipped ${n.relativePath}: ${m instanceof Error?m.message:String(m)}`);continue}l.push(i),a(i,{id:i.path,uri:`urn:redocly:realm:cli:${r}:${i.path}`,projectBuildId:d.PROJECT_BUILD_ID||"",object:r})}s||h(l),u.info(`${e} collector: ${t} documents processing completed.`)})}function h(o){if(o.length===0)return;console.table(o.map(({xExtensions:t,...e})=>({...e,xExtensions:Object.keys(t||{}).length})));const s=o.flatMap(({path:t,xExtensions:e})=>Object.entries(e||{}).flatMap(([c,{count:r,props:p}])=>{const a=Object.entries(p);return a.length>0?a.map(([f,l])=>({path:t,extension:c,count:r,prop:f,values:l})):[{path:t,extension:c,count:r,prop:"",values:""}]}));s.length>0&&console.table(s)}export{C as runStatsCollector};

package/dist/cli/stats/index.js

@@ -1 +1 @@
-import{initPlugins as m}from"../../server/plugins/lifecycle.js";import{configParserPlugin as c}from"../../server/plugins/config-parser/index.js";import{apiDocsPlugin as s}from"../../server/plugins/api-docs/index.js";import{shutdowner as n}from"../../server/tools/shutdowner.js";import{PORTAL_VERSION as l}from"../../server/version.js";import{collectOpenapiDocumentsStatistics as p}from"./collectors/openapi/index.js";import{collectPageSlugsStatistics as f}from"./collectors/page-slugs/index.js";import{telemetry as y}from"../telemetry/index.js";import{telemetryTraceStep as u}from"../telemetry/helpers/trace-step.js";async function h(o){const{"project-dir":e,telemetry:t,verbose:r}=o;y.initialize(l,t,r),await u("com.redocly.stats.started",async()=>{const a=[c,s],{lifecycleContext:i}=await m({contentDir:e},a);await p(i,t),await f(i,t)}),await n.exitWithCode(0)}export{h as stats};
+import{initPlugins as c}from"../../server/plugins/lifecycle.js";import{configParserPlugin as m}from"../../server/plugins/config-parser/index.js";import{apiDocsPlugin as s}from"../../server/plugins/api-docs/index.js";import{shutdowner as n}from"../../server/tools/shutdowner.js";import{PORTAL_VERSION as l}from"../../server/version.js";import{collectAsyncapiDocumentsStatistics as p}from"./collectors/asyncapi/index.js";import{collectOpenapiDocumentsStatistics as f}from"./collectors/openapi/index.js";import{collectPageSlugsStatistics as y}from"./collectors/page-slugs/index.js";import{telemetry as u}from"../telemetry/index.js";import{telemetryTraceStep as w}from"../telemetry/helpers/trace-step.js";async function A(o){const{"project-dir":e,telemetry:t,verbose:r}=o;u.initialize(l,t,r),await w("com.redocly.stats.started",async()=>{const a=[m,s],{lifecycleContext:i}=await c({contentDir:e},a);await f(i,t),await p(i,t),await y(i,t)}),await n.exitWithCode(0)}export{A as stats};

package/dist/client/app/hooks/useMcpData.d.ts

@@ -2,6 +2,7 @@ export declare function useMcpData(): {
     docs: {
         enabled: boolean;
         name: string | undefined;
+        publicEndpoint: boolean;
     };
 };
 //# sourceMappingURL=useMcpData.d.ts.map

package/dist/client/app/hooks/useMcpData.js

@@ -1 +1 @@
-import{useGlobalData as e}from"../hooks";function n(){const{mcpData:a}=e();return{docs:{enabled:!!a?.docs?.enabled,name:a?.docs?.name}}}export{n as useMcpData};
+import{useGlobalData as n}from"../hooks";function e(){const{mcpData:o}=n();return{docs:{enabled:!!o?.docs?.enabled,name:o?.docs?.name,publicEndpoint:!!o?.docs?.publicEndpoint}}}export{e as useMcpData};

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

@@ -1 +1 @@
-import{MarkdownAdapterProvider as l,RedocSchema as h,StoreProvider as f,createMarkdocAdapter as k,markdocParser as u}from"@redocly/api-docs";import*as e from"react";import{Admonition as E}from"@redocly/theme/markdoc/components/Admonition/Admonition";import{MarkdownLink as v}from"@redocly/theme/markdoc/components/MarkdownLink/MarkdownLink";import{link as A}from"../../../../../markdoc/nodes/index.js";import{OpenApiComponentWrap as P}from"../styled.elements";const a={nodes:{link:A},components:{MarkdownLink:v}};function S(m){const{options:s,title:t,schemaResolved:o,schemaResolvedErrors:n,schema:r}=m,i=e.useMemo(()=>k(a),[]);if(r||o){const c={openapi:"3.0.0",info:{version:"1",description:"test",title:"test"},paths:{},"x-root":o?.components?.schemas?.__root||r,components:{schemas:{...o?.components?.schemas}}};return e.createElement(P,{"data-testid":"json-schema"},t?e.createElement("h3",null,t):null,e.createElement(f,{options:{...s,markdocOptions:a,markdownParser:u},definition:c},e.createElement(l,{value:i},n?.length?e.createElement(E,{name:"Problem in json-schema tag",type:"danger"},n.map((p,d)=>e.createElement("div",{key:d},p))):null,e.createElement(h,{pointer:"#/x-root",disableDeepLinks:!0}))))}}export{S as JsonSchema};
+import{MarkdownAdapterProvider as d,RedocSchema as l,StoreProvider as h,markdocParser as f}from"@redocly/api-docs";import*as e from"react";import{Admonition as k}from"@redocly/theme/markdoc/components/Admonition/Admonition";import{OpenApiComponentWrap as u}from"../styled.elements";import{markdocOptions as E,usePortalMarkdownAdapter as v}from"./use-markdown-adapter";function g(a){const{options:m,title:o,schemaResolved:t,schemaResolvedErrors:r,schema:n}=a,s=v();if(n||t){const i={openapi:"3.0.0",info:{version:"1",description:"test",title:"test"},paths:{},"x-root":t?.components?.schemas?.__root||n,components:{schemas:{...t?.components?.schemas}}};return e.createElement(u,{"data-testid":"json-schema"},o?e.createElement("h3",null,o):null,e.createElement(h,{options:{...m,markdocOptions:E,markdownParser:f},definition:i},e.createElement(d,{value:s},r?.length?e.createElement(k,{name:"Problem in json-schema tag",type:"danger"},r.map((c,p)=>e.createElement("div",{key:p},c))):null,e.createElement(l,{pointer:"#/x-root",disableDeepLinks:!0}))))}}export{g as JsonSchema};

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

@@ -1 +1 @@
-import*as o from"react";import{StoreProvider as h,RedocCodeSample as k,appendUndeclaredConfigureParameters as C,excludeMockServers as i,markdocParser as E}from"@redocly/api-docs";import{ErrorMessage as P,OpenApiComponentWrap as q}from"../styled.elements";import{useStore as x}from"../../hooks/use-store";import{findCodeSamplePanel as I}from"../../utils/find-code-sample-panel.js";function B(m){const{descriptionFile:d,operationId:s,pointer:a,exampleKey:c,mimeType:u,language:t,requestBody:l,parameters:e,environment:f,environments:v}=m,{store:r,error:y}=x(d),g=o.useMemo(()=>({specType:"openapi",...r?.options,...t&&{codeSamples:{languages:[{lang:t??""}]}},markdownParser:E}),[t,r?.options]),p=o.useMemo(()=>{if(!r?.items?.length)return;const n=I(r.items,{pointer:a,sourceId:s});if(!n)return;const S=C({...n.source,servers:i(n.source.servers)},{...e?.path&&{path:e.path},...e?.query&&{query:e.query},...e?.header&&{headers:e.header},...e?.cookie&&{cookie:e.cookie}});return{...n,...n.servers&&{servers:i(n.servers)},source:S}},[r?.items,a,s,e]);return r?p?o.createElement(q,{"data-testid":"openapi-code-sample"},o.createElement(h,{options:g,apiStore:r.store},o.createElement(k,{node:p,mimeType:u,exampleKey:c,requestBody:l,parameters:e,environment:f,environments:v}))):o.createElement("pre",{style:{color:"red"}},"Cannot find OpenAPI operation (use pointer or operationId)"):o.createElement(P,null,y)}export{B as OpenApiCodeSample};
+import*as r from"react";import{MarkdownAdapterProvider as P,StoreProvider as h,RedocCodeSample as E,appendUndeclaredConfigureParameters as A,excludeMockServers as i,markdocParser as C}from"@redocly/api-docs";import{ErrorMessage as M,OpenApiComponentWrap as q}from"../styled.elements";import{useStore as w}from"../../hooks/use-store";import{findCodeSamplePanel as x}from"../../utils/find-code-sample-panel.js";import{usePortalMarkdownAdapter as I}from"./use-markdown-adapter";function F(m){const{descriptionFile:d,operationId:a,pointer:s,exampleKey:c,mimeType:u,language:n,requestBody:l,parameters:e,environment:f,environments:v}=m,{store:o,error:y}=w(d),g=I(),k=r.useMemo(()=>({specType:"openapi",...o?.options,...n&&{codeSamples:{languages:[{lang:n??""}]}},markdownParser:C}),[n,o?.options]),p=r.useMemo(()=>{if(!o?.items?.length)return;const t=x(o.items,{pointer:s,sourceId:a});if(!t)return;const S=A({...t.source,servers:i(t.source.servers)},{...e?.path&&{path:e.path},...e?.query&&{query:e.query},...e?.header&&{headers:e.header},...e?.cookie&&{cookie:e.cookie}});return{...t,...t.servers&&{servers:i(t.servers)},source:S}},[o?.items,s,a,e]);return o?p?r.createElement(q,{"data-testid":"openapi-code-sample"},r.createElement(h,{options:k,apiStore:o.store},r.createElement(P,{value:g},r.createElement(E,{node:p,mimeType:u,exampleKey:c,requestBody:l,parameters:e,environment:f,environments:v})))):r.createElement("pre",{style:{color:"red"}},"Cannot find OpenAPI operation (use pointer or operationId)"):r.createElement(M,null,y)}export{F as OpenApiCodeSample};

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

@@ -1 +1 @@
-import*as e from"react";import{RedocExample as m,StoreProvider as s,markdocParser as c}from"@redocly/api-docs";import{ErrorMessage as l,OpenApiComponentWrap as d}from"../styled.elements";import{useStore as E}from"../../hooks/use-store";function y(o){const{descriptionFile:t,pointer:p,options:n,mimeType:i}=o,{store:r,error:a}=E(t);return r?e.createElement(d,{"data-testid":"openapi-example"},e.createElement(s,{options:{specType:"openapi",...r.options,...n,markdownParser:c},apiStore:r.store},e.createElement(m,{pointer:p,mimeType:i||"application/json"}))):e.createElement(l,null,a)}export{y as OpenApiExample};
+import*as e from"react";import{MarkdownAdapterProvider as s,RedocExample as c,StoreProvider as d,markdocParser as l}from"@redocly/api-docs";import{ErrorMessage as E,OpenApiComponentWrap as f}from"../styled.elements";import{useStore as u}from"../../hooks/use-store";import{usePortalMarkdownAdapter as k}from"./use-markdown-adapter";function v(o){const{descriptionFile:t,pointer:p,options:a,mimeType:n}=o,{store:r,error:i}=u(t),m=k();return r?e.createElement(f,{"data-testid":"openapi-example"},e.createElement(d,{options:{specType:"openapi",...r.options,...a,markdownParser:l},apiStore:r.store},e.createElement(s,{value:m},e.createElement(c,{pointer:p,mimeType:n||"application/json"})))):e.createElement(E,null,i)}export{v as OpenApiExample};

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

@@ -1 +1 @@
-import*as o from"react";import{StoreProvider as l,RedocResponseSamples as d,markdocParser as c}from"@redocly/api-docs";import{ErrorMessage as n,OpenApiComponentWrap as f}from"../styled.elements";import{useStore as u}from"../../hooks/use-store";import{findResponseSamples as S}from"../../utils/find-openapi-response-samples.js";function g(s){const{descriptionFile:t,operationId:p,pointer:a,exampleKey:i}=s,{store:e,error:m}=u(t);if(!e)return o.createElement(n,null,m);const r=e.items?.length?S(e.items,{pointer:a,sourceId:p}):void 0;return r?.responseCodes.length?o.createElement(f,{"data-testid":"openapi-response-sample"},o.createElement(l,{options:{...e.options,specType:"openapi",markdownParser:c},apiStore:e.store},o.createElement(d,{responseCodes:r.responseCodes,exampleKey:i,schemaId:r.schemaId}))):o.createElement(n,null,"Cannot find response samples for the given operation")}export{g as OpenApiResponseSample};
+import*as e from"react";import{MarkdownAdapterProvider as l,RedocResponseSamples as c,StoreProvider as f,markdocParser as u}from"@redocly/api-docs";import{ErrorMessage as t,OpenApiComponentWrap as E}from"../styled.elements";import{useStore as S}from"../../hooks/use-store";import{findResponseSamples as P}from"../../utils/find-openapi-response-samples.js";import{usePortalMarkdownAdapter as h}from"./use-markdown-adapter";function v(n){const{descriptionFile:s,operationId:p,pointer:a,exampleKey:m}=n,{store:r,error:i}=S(s),d=h();if(!r)return e.createElement(t,null,i);const o=r.items?.length?P(r.items,{pointer:a,sourceId:p}):void 0;return o?.responseCodes.length?e.createElement(E,{"data-testid":"openapi-response-sample"},e.createElement(f,{options:{...r.options,specType:"openapi",markdownParser:u},apiStore:r.store},e.createElement(l,{value:d},e.createElement(c,{responseCodes:o.responseCodes,exampleKey:m,schemaId:o.schemaId})))):e.createElement(t,null,"Cannot find response samples for the given operation")}export{v as OpenApiResponseSample};

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

@@ -1 +1 @@
-import o from"react";import{useLocation as g}from"react-router";import{EmbeddedReplay as k,StoreProvider as I,buildReplayPredefinedEnvValues as P,mergeEnvData as b,useOpenApiDefinition as h,withReplayPrefetch as R,markdocParser as w}from"@redocly/api-docs";import{Admonition as V}from"@redocly/theme/markdoc/components/Admonition/Admonition";import{ErrorMessage as C,OpenApiComponentWrap as D}from"../styled.elements.js";import{useStore as v}from"../../hooks/use-store.js";import{getMockServerDocsConfig as E}from"../../../../templates/openapi-docs/mock-server-config.js";import{buildReplayOperationSourceMap as $}from"../../utils/build-replay-operation-source-map.js";import{findApiItem as x}from"../../utils/find-api-item.js";const q=R(function({descriptionFile:p,operationId:r,pointer:n,exampleKey:a,mimeType:e,requestBody:u,parameters:c,environment:s,environments:i,hideOtherSecuritySchemes:d}){const f=g(),{store:t,baseSlug:S}=v(p),m=h(),O=o.useMemo(()=>{if(!m)return{};const M=E(t?.options?.mockServer,S??""),A=P(m,M);return b(A,i??{})},[m,t?.options?.mockServer,S,i]),y=o.useMemo(()=>t?.items?$(t.items,{pointer:n,sourceId:r},{mimeType:e,exampleKey:a},t.store?.exampleStore??{}):new Map,[t?.items,t?.store?.exampleStore,n,r,e,a]);return!m||!t?null:o.createElement(k,{key:`${f.pathname}-${p}-${r||n}`,activeOperationId:r,fullOpenApi:m,pointer:n,operationSourceMap:y,hideOtherSecuritySchemes:d,predefinedEnvValues:O,allowedEnvironments:s?[s]:void 0,requestValues:{body:u,...c},activeMimeName:e})}),J=l=>{const{descriptionFile:p,operationId:r,pointer:n,options:a}=l,{store:e,error:u,baseSlug:c}=v(p),s=o.useMemo(()=>({...e?.options,...a}),[a,e?.options]),i=o.useMemo(()=>e?.items?.length?x(e.items,{pointer:n,sourceId:r}):void 0,[e?.items,n,r]);if(!e)return o.createElement(C,null,u);if(!i?.content?.meta?.pointer)return o.createElement(V,{type:"danger"},"Cannot find OpenAPI operation by operationId or pointer in ",p);const d=i.content.meta.pointer,f=i.content.meta.sourceId??"";return o.createElement(D,{"data-testid":"replay-openapi"},o.createElement(I,{apiStore:e.store,options:{specType:"openapi",...s,mockServer:E(s.mockServer,c??""),basePath:c,markdownParser:w}},o.createElement(q,{...l,pointer:d,operationId:f})))};export{J as ReplayOpenApi};
+import o from"react";import{useLocation as g}from"react-router";import{EmbeddedReplay as k,StoreProvider as I,buildReplayPredefinedEnvValues as P,mergeEnvData as b,useOpenApiDefinition as h,withReplayPrefetch as R,markdocParser as w}from"@redocly/api-docs";import{Admonition as V}from"@redocly/theme/markdoc/components/Admonition/Admonition";import{ErrorMessage as C,OpenApiComponentWrap as D}from"../styled.elements.js";import{useStore as v}from"../../hooks/use-store.js";import{getMockServerDocsConfig as E}from"../../../../templates/api-docs/mock-server-config.js";import{buildReplayOperationSourceMap as $}from"../../utils/build-replay-operation-source-map.js";import{findApiItem as x}from"../../utils/find-api-item.js";const q=R(function({descriptionFile:p,operationId:r,pointer:n,exampleKey:a,mimeType:e,requestBody:u,parameters:c,environment:s,environments:i,hideOtherSecuritySchemes:d}){const f=g(),{store:t,baseSlug:S}=v(p),m=h(),O=o.useMemo(()=>{if(!m)return{};const M=E(t?.options?.mockServer,S??""),A=P(m,M);return b(A,i??{})},[m,t?.options?.mockServer,S,i]),y=o.useMemo(()=>t?.items?$(t.items,{pointer:n,sourceId:r},{mimeType:e,exampleKey:a},t.store?.exampleStore??{}):new Map,[t?.items,t?.store?.exampleStore,n,r,e,a]);return!m||!t?null:o.createElement(k,{key:`${f.pathname}-${p}-${r||n}`,activeOperationId:r,fullOpenApi:m,pointer:n,operationSourceMap:y,hideOtherSecuritySchemes:d,predefinedEnvValues:O,allowedEnvironments:s?[s]:void 0,requestValues:{body:u,...c},activeMimeName:e})}),J=l=>{const{descriptionFile:p,operationId:r,pointer:n,options:a}=l,{store:e,error:u,baseSlug:c}=v(p),s=o.useMemo(()=>({...e?.options,...a}),[a,e?.options]),i=o.useMemo(()=>e?.items?.length?x(e.items,{pointer:n,sourceId:r}):void 0,[e?.items,n,r]);if(!e)return o.createElement(C,null,u);if(!i?.content?.meta?.pointer)return o.createElement(V,{type:"danger"},"Cannot find OpenAPI operation by operationId or pointer in ",p);const d=i.content.meta.pointer,f=i.content.meta.sourceId??"";return o.createElement(D,{"data-testid":"replay-openapi"},o.createElement(I,{apiStore:e.store,options:{specType:"openapi",...s,mockServer:E(s.mockServer,c??""),basePath:c,markdownParser:w}},o.createElement(q,{...l,pointer:d,operationId:f})))};export{J as ReplayOpenApi};

package/dist/client/app/markdoc/custom-components/openapi/use-markdown-adapter.d.ts

@@ -0,0 +1,45 @@
+import type { MarkdownAdapter } from '@redocly/api-docs';
+import { MarkdownLink } from '@redocly/theme/markdoc/components/MarkdownLink/MarkdownLink';
+/** Routes description links through portal `Link` (path prefix, locale, etc.). */
+export declare const markdocOptions: {
+    nodes: {
+        link: {
+            attributes?: Record<string, import("@markdoc/markdoc").SchemaAttribute>;
+            slots?: Record<string, import("@markdoc/markdoc").SchemaSlot>;
+            selfClosing?: boolean;
+            inline?: boolean;
+            transform?(node: import("@markdoc/markdoc").Node, config: 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>;
+                functions: Record<string, import("@markdoc/markdoc").ConfigFunction>;
+                partials: Record<string, any>;
+                validation?: {
+                    parents?: import("@markdoc/markdoc").Node[];
+                    validateFunctions?: boolean;
+                    environment?: string;
+                };
+            }>>): import("@markdoc/markdoc").MaybePromise<import("@markdoc/markdoc").RenderableTreeNodes>;
+            validate?(node: import("@markdoc/markdoc").Node, config: 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>;
+                functions: Record<string, import("@markdoc/markdoc").ConfigFunction>;
+                partials: Record<string, any>;
+                validation?: {
+                    parents?: import("@markdoc/markdoc").Node[];
+                    validateFunctions?: boolean;
+                    environment?: string;
+                };
+            }>>): import("@markdoc/markdoc").MaybePromise<import("@markdoc/markdoc").ValidationError[]>;
+            description?: string;
+            render: string;
+            children: string[];
+        };
+    };
+    components: {
+        MarkdownLink: typeof MarkdownLink;
+    };
+};
+export declare function usePortalMarkdownAdapter(): MarkdownAdapter;
+//# sourceMappingURL=use-markdown-adapter.d.ts.map

package/dist/client/app/markdoc/custom-components/openapi/use-markdown-adapter.js

@@ -0,0 +1 @@
+import*as o from"react";import{createMarkdocAdapter as r}from"@redocly/api-docs";import{MarkdownLink as t}from"@redocly/theme/markdoc/components/MarkdownLink/MarkdownLink";import{link as e}from"../../../../../markdoc/nodes/index.js";const n={nodes:{link:e},components:{MarkdownLink:t}};function i(){return o.useMemo(()=>r(n),[])}export{n as markdocOptions,i as usePortalMarkdownAdapter};

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

@@ -1 +1 @@
-import{useCallback as y,useEffect as u,useState as n}from"react";import{withPathPrefix as S}from"@redocly/theme/core/utils";import{ServerRoutes as d}from"../../../constants/api";import{useI18nConfig as b}from"../hooks";function h(e){const[o,c]=n([]),[s,a]=n(null),[t,r]=n(null),[p,i]=n(!1),{currentLocale:f}=b();u(()=>{i(!0),m()},[t]);const m=y(async()=>{if(e&&t===null){i(!1);return}let l={locale:f,field:e};t&&(l={...l,...t});const F=await(await fetch(S(d.SEARCH_FACETS),{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify(l)})).json();e?a(F):c(F),i(!1)},[f,t,e]);return{initialFacets:o,searchFacets:s,isFacetsLoading:p,setSearchFacetQuery:r}}function E(e){const[o,c]=n(null),{searchFacets:s,setSearchFacetQuery:a}=h(e);return u(()=>{const t=s?s.find(r=>r.field===e)??null:null;c(t)},[s,e]),{searchFacet:o,setSearchFacet:c,setSearchFacetQuery:a}}const L=e=>{const[o,c]=n([]),{initialFacets:s}=h();return u(()=>{if(e&&Object.keys(e).length){const a=[];for(const t of s)a.push({...t,values:e[t.field]?.map(r=>({...r,isCounterVisible:!0}))||[]});c(a)}else c(s)},[s,e]),{facets:o}};export{E as useFacetQuery,L as useFacets};
+import{useCallback as y,useEffect as f,useMemo as S,useState as r}from"react";import{withPathPrefix as b}from"@redocly/theme/core/utils";import{ServerRoutes as d}from"../../../constants/api";import{useI18nConfig as g}from"../hooks";function h(e){const[s,a]=r([]),[t,n]=r(null),[c,o]=r(null),[p,i]=r(!1),{currentLocale:l}=g();f(()=>{i(!0),m()},[c]);const m=y(async()=>{if(e&&c===null){i(!1);return}let u={locale:l,field:e};c&&(u={...u,...c});const F=await(await fetch(b(d.SEARCH_FACETS),{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify(u)})).json();e?n(F):a(F),i(!1)},[l,c,e]);return{initialFacets:s,searchFacets:t,isFacetsLoading:p,setSearchFacetQuery:o}}function L(e){const[s,a]=r(null),{searchFacets:t,setSearchFacetQuery:n}=h(e);return f(()=>{const c=t?t.find(o=>o.field===e)??null:null;a(c)},[t,e]),{searchFacet:s,setSearchFacet:a,setSearchFacetQuery:n}}const O=e=>{const{initialFacets:s}=h();return{facets:S(()=>!e||!Object.keys(e).length?s:s.map(t=>({...t,values:e[t.field]?.map(n=>({...n,isCounterVisible:!0}))||[]})),[s,e])}};export{L as useFacetQuery,O as useFacets};

package/dist/client/app/utils/loadAndNavigate.js

@@ -1 +1 @@
-import{isLocalLink as f}from"../../../utils/path/is-local-link.js";import{isAuthRoutePath as m}from"../../../utils/auth/is-auth-route-path.js";import{withLoadProgress as u}from"./withLoadProgress";import{scrollToAnchor as p}from"./scroll-to-anchor";let s;async function A({navigate:t,to:o,origin:a="browser",options:c}){o===""&&(o="/"),s=o;const{pathname:e,hash:d,search:i}=new URL(o,window.location.origin+window.location.pathname),n=decodeURIComponent(d),l=decodeURIComponent(window.location.hash);if(m(e)){window.location.href=o;return}const w=window.__LOADER,r=await u(w.tryLoad(e,void 0,i));if(r?.redirectTo){if(!f(r.redirectTo)){window.location.href=r.redirectTo;return}return A({navigate:t,to:r.redirectTo,origin:a,options:c})}if(r&&s===o){if((e!==window.location.pathname||i!==window.location.search||n!==l)&&t({pathname:e,search:i,hash:n},{...c,state:{origin:a},flushSync:!0}),r.props?.disableAutoScroll)return;requestAnimationFrame(()=>{if(n){const h=n.slice(1);p(h)}else window.scrollTo(0,0)})}}export{A as loadAndNavigate};
+import{isLocalLink as f}from"../../../utils/path/is-local-link.js";import{isAuthRoutePath as m}from"../../../utils/auth/is-auth-route-path.js";import{withLoadProgress as u}from"./withLoadProgress";import{scrollToAnchor as p}from"./scroll-to-anchor";let s;async function A({navigate:r,to:o,origin:a="browser",options:c}){o===""&&(o="/"),s=o;const{pathname:i,hash:d,search:t}=new URL(o,window.location.origin+window.location.pathname),n=decodeURIComponent(d),h=decodeURIComponent(window.location.hash);if(m(i)){window.location.href=o;return}const w=window.__LOADER,e=await u(w.tryLoad(i,void 0,t));if(e?.redirectTo){if(!f(e.redirectTo)){window.location.href=e.redirectTo;return}return A({navigate:r,to:e.redirectTo,origin:a,options:c})}if(e&&s===o){if(i!==window.location.pathname||t!==window.location.search||n!==h?r({pathname:i,search:t,hash:n},{...c,state:{origin:a},flushSync:!0}):n&&window.dispatchEvent(new HashChangeEvent("hashchange")),e.props?.disableAutoScroll)return;requestAnimationFrame(()=>{if(n){const l=n.slice(1);p(l)}else window.scrollTo(0,0)})}}export{A as loadAndNavigate};

package/dist/client/providers/hooks.js

@@ -1 +1 @@
-import{useEffect as c,useState as s}from"react";import{useNavigate as l}from"react-router";import{isLocalLink as u}from"../../utils/path/is-local-link.js";import{isJsProtocolLink as a}from"../../utils/path/is-js-protocol-link.js";import{isAssetsLink as m}from"../../utils/path/is-assets-link.js";import{isHostnameOnDomain as f}from"../app/utils/isHostnameOnDomain.js";import{loadAndNavigate as d}from"../app/utils/loadAndNavigate.js";import{isForcedNavigationLinkClick as p}from"../utils/utils.js";export*from"./page-data/hooks.js";function E(){const o=l();c(()=>{const r=t=>{if(t.defaultPrevented)return;const i=t.target;if(i.tagName!=="A"||p(t,i.getAttribute("target")||""))return;const n=i.getAttribute("href");!u(n)||m(n)||a(n)||(t.preventDefault(),d({navigate:o,to:n||""}))};return document.addEventListener("click",r),()=>{document.removeEventListener("click",r)}},[o])}function b(){const[o,r]=s(null);return c(()=>{if(process.env.NODE_ENV==="development"&&typeof window<"u"&&!e("localhost")&&!e("127.0.0.1")&&!e("")&&!e("redocly-local.com")&&!e("editor.redocly.xyz")&&!e("apps.codespaces.githubusercontent.com")&&!e("blueharvest.cloud")&&!e("bhstage.cloud")&&!e("cloud.redocly.com")&&!e("cloud.eu.redocly.com")&&!e("cba.au.redocly.com"))return r("Development mode is only allowed in localhost")},[typeof window]),o}function e(o){return f(window.location.hostname,o)}export{E as useRouterForLocalLinks,b as useRunningEnvironmentCheck};
+import{useEffect as c,useState as s}from"react";import{useNavigate as l}from"react-router";import{isLocalLink as u}from"../../utils/path/is-local-link.js";import{isJsProtocolLink as m}from"../../utils/path/is-js-protocol-link.js";import{isAssetsLink as a}from"../../utils/path/is-assets-link.js";import{isHostnameOnDomain as f}from"../app/utils/isHostnameOnDomain.js";import{loadAndNavigate as d}from"../app/utils/loadAndNavigate.js";import{isForcedNavigationLinkClick as p}from"../utils/utils.js";export*from"./page-data/hooks.js";function E(){const o=l();c(()=>{const r=t=>{if(t.defaultPrevented)return;const i=t.target;if(i.tagName!=="A"||p(t,i.getAttribute("target")||""))return;const n=i.getAttribute("href");!u(n)||a(n)||m(n)||(t.preventDefault(),d({navigate:o,to:n||""}))};return document.addEventListener("click",r),()=>{document.removeEventListener("click",r)}},[o])}function N(){const[o,r]=s(null);return c(()=>{if(process.env.NODE_ENV==="development"&&typeof window<"u"&&!e("localhost")&&!e("127.0.0.1")&&!e("")&&!e("redocly-local.com")&&!e("editor.redocly.xyz")&&!e("apps.codespaces.githubusercontent.com")&&!e("blueharvest.cloud")&&!e("bhstage.cloud")&&!e("cloud.redocly.com")&&!e("cloud.eu.redocly.com"))return r("Development mode is only allowed in localhost")},[typeof window]),o}function e(o){return f(window.location.hostname,o)}export{E as useRouterForLocalLinks,N as useRunningEnvironmentCheck};

package/dist/client/providers/post-message/PostMessageProvider.js

@@ -1 +1 @@
-import n,{createContext as v,useEffect as P}from"react";import{useLocation as S,useNavigate as C}from"react-router";import{useColorSwitcher as M}from"@redocly/theme/core/hooks";import{withPathPrefix as E}from"@redocly/theme/core/utils";import{ServerRoutes as U}from"../../../constants/api";import{removeTrailingSlash as L}from"../../../utils/url/remove-trailing-slash";import{loadAndNavigate as x}from"../../app/utils/loadAndNavigate";import{resolveRouteBySlug as O}from"../../app/utils/resolveRouteBySlug";import{isSameResolvedRoute as T}from"../../app/utils/same-resolved-route";import{syncScrollWithEditor as D}from"../../app/utils/syncScrollWithEditor";import{PostMessageConnection as I}from"./PostMessageConnection";import{isHostnameOnDomain as c}from"../../app/utils/isHostnameOnDomain";import{usePageData as N}from"../../app/hooks/usePageData";const z=v({sendMessage:()=>{}});function Z({children:l,enabled:t}){const R=C(),i=S(),s=n.useRef(null),{switchColorMode:h}=M(),p=N()?.templateId,u=n.useCallback(e=>{s.current?.send(e)},[]),f=n.useCallback(async e=>{console.info("[PM] connection initialized."),s.current=new I(e.source,e.origin);const a=await O(i.pathname+i.hash,p).catch(o=>{console.error("Initial route resolve failed with error: ",o.message)});u({type:"initialized",initialRoute:a})},[u,i.pathname,i.hash,p]),w=n.useCallback(async e=>{const{path:a="/",line:o=1,url:d}=e;let r=d;if(!d)try{const m=await fetch(E(U.RESOLVE_ROUTE_BY_PATH),{method:"POST",body:JSON.stringify(a+(o?`:${o}`:""))}),{route:y}=await m.json();r=y?.slug??y?.url??void 0}catch(m){console.error(m)}if(!r)return;r=r==="/"?"/":L(r),T(r,i,!!d)||(console.info("[PM] Update route to: ",r),await x({navigate:R,to:r,origin:"pm"}))},[i]),g=n.useCallback(async e=>{const{action:a}=e;switch(a){case"back":window.history.back();break;case"forward":window.history.forward();break;case"reload":window.location.reload();break}},[]),b=n.useCallback(e=>{window.scrollTo({top:e.position.absolute,behavior:"instant"})},[]),k=n.useCallback(e=>{h(e.colorSchema)},[h]);return P(()=>{if(!t)return;const e=async a=>{if(!A(a.origin))return;const o=a.data;switch(o.type){case"initialize":f(a);break;case"route-update":if(!s.current)return;w(o);break;case"location-update":if(!s.current)return;g(o);break;case"scroll-update":if(!s.current)return;b(o);break;case"editor-scroll-update":if(!s.current)return;D(o.percentScrolled,o.sequenceNumber);break;case"color-schema-update":if(!s.current)return;k(o);break}};return window.addEventListener("message",e),()=>{window.removeEventListener("message",e)}},[t,f,w,g,b,k]),n.createElement(z.Provider,{value:{sendMessage:u}},l)}function A(l){const t=new URL(l);return c(t.hostname,"localhost")||c(t.hostname,"127.0.0.1")||c(t.hostname,"blueharvest.cloud")||c(t.hostname,"bhstage.cloud")||c(t.hostname,"cloud.redocly.com")||c(t.hostname,"cloud.eu.redocly.com")||c(t.hostname,"cba.au.redocly.com")}export{z as PostMessageContext,Z as PostMessageProvider};
+import n,{createContext as v,useEffect as P}from"react";import{useLocation as S,useNavigate as C}from"react-router";import{useColorSwitcher as M}from"@redocly/theme/core/hooks";import{withPathPrefix as E}from"@redocly/theme/core/utils";import{ServerRoutes as U}from"../../../constants/api";import{removeTrailingSlash as L}from"../../../utils/url/remove-trailing-slash";import{loadAndNavigate as x}from"../../app/utils/loadAndNavigate";import{resolveRouteBySlug as O}from"../../app/utils/resolveRouteBySlug";import{isSameResolvedRoute as T}from"../../app/utils/same-resolved-route";import{syncScrollWithEditor as D}from"../../app/utils/syncScrollWithEditor";import{PostMessageConnection as I}from"./PostMessageConnection";import{isHostnameOnDomain as c}from"../../app/utils/isHostnameOnDomain";import{usePageData as N}from"../../app/hooks/usePageData";const z=v({sendMessage:()=>{}});function Z({children:l,enabled:t}){const R=C(),i=S(),s=n.useRef(null),{switchColorMode:h}=M(),p=N()?.templateId,u=n.useCallback(e=>{s.current?.send(e)},[]),f=n.useCallback(async e=>{console.info("[PM] connection initialized."),s.current=new I(e.source,e.origin);const a=await O(i.pathname+i.hash,p).catch(o=>{console.error("Initial route resolve failed with error: ",o.message)});u({type:"initialized",initialRoute:a})},[u,i.pathname,i.hash,p]),w=n.useCallback(async e=>{const{path:a="/",line:o=1,url:d}=e;let r=d;if(!d)try{const m=await fetch(E(U.RESOLVE_ROUTE_BY_PATH),{method:"POST",body:JSON.stringify(a+(o?`:${o}`:""))}),{route:y}=await m.json();r=y?.slug??y?.url??void 0}catch(m){console.error(m)}if(!r)return;r=r==="/"?"/":L(r),T(r,i,!!d)||(console.info("[PM] Update route to: ",r),await x({navigate:R,to:r,origin:"pm"}))},[i]),g=n.useCallback(async e=>{const{action:a}=e;switch(a){case"back":window.history.back();break;case"forward":window.history.forward();break;case"reload":window.location.reload();break}},[]),b=n.useCallback(e=>{window.scrollTo({top:e.position.absolute,behavior:"instant"})},[]),k=n.useCallback(e=>{h(e.colorSchema)},[h]);return P(()=>{if(!t)return;const e=async a=>{if(!A(a.origin))return;const o=a.data;switch(o.type){case"initialize":f(a);break;case"route-update":if(!s.current)return;w(o);break;case"location-update":if(!s.current)return;g(o);break;case"scroll-update":if(!s.current)return;b(o);break;case"editor-scroll-update":if(!s.current)return;D(o.percentScrolled,o.sequenceNumber);break;case"color-schema-update":if(!s.current)return;k(o);break}};return window.addEventListener("message",e),()=>{window.removeEventListener("message",e)}},[t,f,w,g,b,k]),n.createElement(z.Provider,{value:{sendMessage:u}},l)}function A(l){const t=new URL(l);return c(t.hostname,"localhost")||c(t.hostname,"127.0.0.1")||c(t.hostname,"blueharvest.cloud")||c(t.hostname,"bhstage.cloud")||c(t.hostname,"cloud.redocly.com")||c(t.hostname,"cloud.eu.redocly.com")}export{z as PostMessageContext,Z as PostMessageProvider};

package/dist/client/templates/api-docs/helpers.d.ts

@@ -1,5 +1,5 @@
 import type { PageProps } from '@redocly/config';
-import type { ApiItem, MarkdocOptions } from '@redocly/api-docs';
+import type { ApiItem, EventType, MarkdocOptions } from '@redocly/api-docs';
 /**
  * Prefix the store's absolute routing fields (`link`, `routeSlug`) so the api-docs
  * client router matches `location.pathname`, which carries the path prefix. Relative
@@ -7,4 +7,7 @@ import type { ApiItem, MarkdocOptions } from '@redocly/api-docs';
  */
 export declare function applyPathPrefixToApiItems(items: ApiItem[]): ApiItem[];
 export declare function useCollectMarkdocOptions(markdown: PageProps['markdown'], markdocOptions?: MarkdocOptions): MarkdocOptions;
+type EventFunctionInput = string | ((event: EventType) => void) | undefined;
+export declare function safeParseFunction(fnInput: EventFunctionInput): ((event: EventType) => void) | null;
+export {};
 //# sourceMappingURL=helpers.d.ts.map

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

@@ -1 +1,5 @@
-import{useMemo as a,useRef as p}from"react";import{components as u}from"@redocly-markdoc/components";import{schema as e}from"@redocly-markdoc/schema";import{withPathPrefix as n}from"@redocly/theme/core/utils";import{tags as f,components as c}from"@redocly/theme/markdoc/default";import*as l from"../../app/markdoc/custom-components/index.js";import{parsePartials as g}from"../../templates/openapi-docs/helpers.js";import*as d from"../../../markdoc/nodes/index.js";import h from"../../../markdoc/tags/index.js";import{normalizeCustomTags as k}from"../../../markdoc/helpers/normalize-custom-tags.js";import{deepEqual as C}from"../../../utils/object/deep-equal.js";function T(t){return t.map(r=>{const o={...r};return typeof o.link=="string"&&(o.link=n(o.link)),typeof o.routeSlug=="string"&&(o.routeSlug=n(o.routeSlug)),Array.isArray(o.items)&&(o.items=T(o.items)),o})}function m(t){const r=p(t);return C(r.current,t)||(r.current=t),r.current}function w(t,r){const o=m(t),s=m(r);return a(()=>{const i=globalThis.__LOADER?.markdocComponents??{};return{...s,...o,tags:{...s?.tags??{},...h,...f,...k(e?.tags??{})},nodes:{...s?.nodes??{},...d,...e?.nodes??{}},functions:{...e?.functions??{}},components:{...s?.components??{},...l,...c,...u,...i},partials:g(o?.partials)}},[o,s])}export{T as applyPathPrefixToApiItems,w as useCollectMarkdocOptions};
+import{useMemo as u,useRef as m}from"react";import{components as c}from"@redocly-markdoc/components";import{schema as s}from"@redocly-markdoc/schema";import{withPathPrefix as i}from"@redocly/theme/core/utils";import{tags as p,components as f}from"@redocly/theme/markdoc/default";import*as l from"../../app/markdoc/custom-components/index.js";import{parsePartials as d}from"../../../markdoc/helpers/parse-partials.js";import*as g from"../../../markdoc/nodes/index.js";import w from"../../../markdoc/tags/index.js";import{normalizeCustomTags as h}from"../../../markdoc/helpers/normalize-custom-tags.js";import{deepEqual as y}from"../../../utils/object/deep-equal.js";function b(t){return t.map(r=>{const o={...r};return typeof o.link=="string"&&(o.link=i(o.link)),typeof o.routeSlug=="string"&&(o.routeSlug=i(o.routeSlug)),Array.isArray(o.items)&&(o.items=b(o.items)),o})}function a(t){const r=m(t);return y(r.current,t)||(r.current=t),r.current}function E(t,r){const o=a(t),n=a(r);return u(()=>{const e=globalThis.__LOADER?.markdocComponents??{};return{...n,...o,tags:{...n?.tags??{},...w,...p,...h(s?.tags??{})},nodes:{...n?.nodes??{},...g,...s?.nodes??{}},functions:{...s?.functions??{}},components:{...n?.components??{},...l,...f,...c,...e},partials:d(o?.partials)}},[o,n])}function M(t){if(typeof window>"u")return null;if(typeof t=="function")return t;if(typeof t!="string")return null;try{const r=t.trim();if(!r.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(e=>r.includes(e)))throw new Error("Function contains prohibited keywords");return new Function("event",`
+      'use strict';
+      const userFn = ${r};
+      return userFn(event);
+    `)}catch(r){return console.error("Function parsing error:",r),null}}export{b as applyPathPrefixToApiItems,M as safeParseFunction,E as useCollectMarkdocOptions};

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

@@ -1,6 +1,6 @@
-import*as t from"react";import{useMemo as i}from"react";import A from"styled-components";import{RedoclyApiDocs as b,createMarkdocAdapter as k}from"@redocly/api-docs";import{LayoutVariant as T}from"@redocly/theme/components/SidebarActions/SidebarActions";import{ThreePanelLayout as B}from"@redocly/theme/layouts/ThreePanelLayout";import{CatalogClassicInfoBlock as U}from"@redocly/theme/components/CatalogClassic/CatalogClassicInfoBlock";import{Breadcrumbs as x}from"@redocly/theme/components/Breadcrumbs/Breadcrumbs";import{withPathPrefix as s}from"@redocly/theme/core/utils";import{usePageSharedData as D,useUserClaims as I}from"../../app/hooks";import{ServerRoutes as p}from"../../../constants/api.js";import{isBrowser as M}from"../../../utils/env/is-browser.js";import{CLIENT_TELEMETRY_ENABLED as $}from"../../constants/common.js";import{PACKAGE_NAME as N}from"../../../config/product-gates";import{safeParseFunction as Y}from"../../templates/openapi-docs/helpers.js";import{applyPathPrefixToApiItems as H,useCollectMarkdocOptions as V}from"./helpers";function W({pageProps:{markdown:c,apiOptions:f,metadata:R}}){const u=D("apiDocsStore"),{items:l,options:o,store:w,baseSlug:r}=u,n=M(),E=I(),a=V(c,o.markdocOptions),m=i(()=>s(r),[r]),C=i(()=>m===r?l:H(l),[l,r,m]),v=i(()=>k(a),[a]),y=i(()=>{const S=n?`${window.location.origin}${s(p.REPLAY_OAUTH2_CALLBACK)}`:void 0;let d=o.corsProxyUrl;if(d===void 0){const e=s(`${p.CORS_PROXY}/`);d=n?new URL(e,window.location.origin).toString():e}const g=o.events,h=g?Object.entries(g).reduce((e,[O,_])=>{const P=Y(_);return P&&(e[O]=P),e},{}):void 0;return{...o,markdocOptions:a,oAuth2RedirectURI:S,corsProxyUrl:d,userClaims:E,...h&&{events:h},unstable_hooks:{...o.unstable_hooks,MiddlePanelHeader:()=>t.createElement(x,null)}}},[o,a,n,E]);if(!u)return t.createElement("div",null,"Something went wrong");const L=n?{collectorUrl:new URL(s(p.OTEL_TRACES),window.location.origin).toString(),disabled:!$,serviceVersion:`${N}@${process.env.REDOCLY_PORTAL_VERSION}`}:void 0;return t.createElement(K,null,t.createElement(z,{layout:f?.layout},t.createElement(U,{metadata:R})),t.createElement(b,{items:C,store:w,basePath:m,options:y,markdownAdapter:v,layout:f?.layout,telemetryConfig:L}))}const z=A(B)`
+import*as e from"react";import{useMemo as i}from"react";import A from"styled-components";import{RedoclyApiDocs as k,createMarkdocAdapter as T}from"@redocly/api-docs";import{LayoutVariant as B}from"@redocly/theme/components/SidebarActions/SidebarActions";import{ThreePanelLayout as U}from"@redocly/theme/layouts/ThreePanelLayout";import{CatalogClassicInfoBlock as x}from"@redocly/theme/components/CatalogClassic/CatalogClassicInfoBlock";import{Breadcrumbs as D}from"@redocly/theme/components/Breadcrumbs/Breadcrumbs";import{withPathPrefix as s}from"@redocly/theme/core/utils";import{usePageSharedData as I,useUserClaims as $}from"../../app/hooks";import{ServerRoutes as p}from"../../../constants/api.js";import{isBrowser as M}from"../../../utils/env/is-browser.js";import{CLIENT_TELEMETRY_ENABLED as N}from"../../constants/common.js";import{PACKAGE_NAME as H}from"../../../config/product-gates";import{applyPathPrefixToApiItems as Y,safeParseFunction as V,useCollectMarkdocOptions as W}from"./helpers";function z({pageProps:{markdown:c,apiOptions:f,metadata:w}}){const u=I("apiDocsStore"),{items:l,options:o,store:y,baseSlug:r}=u,a=M(),g=$(),n=W(c,o.markdocOptions),d=i(()=>s(r),[r]),C=i(()=>d===r?l:Y(l),[l,r,d]),v=i(()=>T(n),[n]),L=i(()=>{const b=a?`${window.location.origin}${s(p.REPLAY_OAUTH2_CALLBACK)}`:void 0;let m=o.corsProxyUrl;if(m===void 0){const t=s(`${p.CORS_PROXY}/`);m=a?new URL(t,window.location.origin).toString():t}const E=o.events,h=E?Object.entries(E).reduce((t,[O,_])=>{const P=V(_);return P&&(t[O]=P),t},{}):void 0;return{...o,markdocOptions:n,oAuth2RedirectURI:b,corsProxyUrl:m,userClaims:g,...h&&{events:h},unstable_hooks:{...o.unstable_hooks,MiddlePanelHeader:()=>e.createElement(D,null)}}},[o,n,a,g]);if(!u)return e.createElement("div",null,"Something went wrong");const S=a?{collectorUrl:new URL(s(p.OTEL_TRACES),window.location.origin).toString(),disabled:!N,serviceVersion:`${H}@${process.env.REDOCLY_PORTAL_VERSION}`}:void 0;return e.createElement(K,null,e.createElement(R,{layout:f?.layout},e.createElement(x,{metadata:w})),e.createElement(k,{items:C,store:y,basePath:d,options:L,markdownAdapter:v,layout:f?.layout,telemetryConfig:S}))}const R=A(U)`
   && {
-    padding-right: ${({layout:c})=>c===T.THREE_PANEL?"calc(var(--panel-gap-horizontal) * 2)":"var(--panel-gap-horizontal)"};
+    padding-right: ${({layout:c})=>c===B.THREE_PANEL?"calc(var(--panel-gap-horizontal) * 2)":"var(--panel-gap-horizontal)"};
   }
 `,K=A.main`
   div[id],
@@ -11,4 +11,9 @@ import*as t from"react";import{useMemo as i}from"react";import A from"styled-com
   }
 
   --sidebar-width: 0px;
-`;export{W as default};
+
+  /* Hide the catalog info block (scorecard badge) when api-docs renders its 404 or error fallback page. */
+  &:has(.not-found-page, .api-docs-error-page) ${R} {
+    display: none;
+  }
+`;export{z as default};

package/dist/client/utils/catalog/get-next-page-param.d.ts

@@ -3,6 +3,6 @@ export type PaginatedResponse = {
     page: Page;
 };
 export declare function getNextPageParam<T extends PaginatedResponse>(lastPage: T): {
-    after: string | null;
+    after: string;
 } | undefined;
 //# sourceMappingURL=get-next-page-param.d.ts.map

package/dist/client/utils/catalog/get-next-page-param.js

@@ -1 +1 @@
-function r(e){return e?.page?.hasNextPage?{after:e?.page?.endCursor}:void 0}export{r as getNextPageParam};
+function n(e){return e?.page?.nextPage?{after:e.page.nextPage}:void 0}export{n as getNextPageParam};