@redocly/realm 0.134.0-next.1 → 0.134.0-next.3

package/dist/constants/common.d.ts

@@ -1,4 +1,5 @@
 import { type RedoclyConfig, type UiAccessibleConfig } from '@redocly/config';
+export declare const AUTH_SEGMENT = "_auth";
 export declare const OPENAPI_DOCS_TEMPLATE_ID = "openapi_docs";
 export declare const ASYNC_API_DOCS_TEMPLATE_ID = "asyncapi_docs";
 export declare const GRAPHQL_TEMPLATE_ID = "graphql_docs";

package/dist/constants/common.js

@@ -1 +1 @@
-const E="openapi_docs",n="asyncapi_docs",A="graphql_docs",T="/_spec-gql",i="markdoc",O="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",g="/eject-component";var o;(function(t){t.BUILD="build",t.DEVELOP="develop",t.PREPARE="prepare"})(o||(o={}));var e;(function(t){t.RATING="rating",t.SENTIMENT="sentiment",t.COMMENT="comment",t.MOOD="mood",t.PROBLEM="problem",t.SCALE="scale"})(e||(e={}));const a="entityKey",_="entityId",c="entityRelationId",x={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/:${a}?`,BFF_CATALOG_RELATED_ENTITIES:`/bff/catalog-related-entities/:${a}`,BFF_CATALOG_REVISIONS:"/bff/catalog-revisions",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 m="/login",U="/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","palette","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",kvStorageLimit:"kvStorageLimit",mcp:"mcp",banner:"banner"};export{n as ASYNC_API_DOCS_TEMPLATE_ID,y as BRANCH_ENV_PREFIX,_ as CATALOG_ENTITY_ID,a as CATALOG_ENTITY_KEY,c as CATALOG_ENTITY_RELATION_ID,u as CONFIG_FILE_NAME,i as CUSTOM_MARKDOC_OPTIONS_PATH,O 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,m as DEV_LOGIN_SLUG,g as EJECT_COMPONENT_URL,M as ExternalRoutes,V as FEATURE,e as FEEDBACK_TYPES,b as FsErrors,h as GLOBAL_DATA_URL,T as GRAPHQL_SPEC_SLUG,A as GRAPHQL_TEMPLATE_ID,U 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,x as ServerRoutes,N as TRANSLATIONS_FILE_NAME,B as UI_ACCESSIBLE_CONFIG_PROPS,D as USER_THEME_ALIAS,o as cliCommandNames};
+const t="_auth",n="openapi_docs",A="asyncapi_docs",T="graphql_docs",i="/_spec-gql",p="markdoc",O="tags",L="*",C={"*":"read"},R=["openid","email"],I=1440*60,l="anonymous",S="authenticated",d="**",N="Reunite",P="translations.yaml",u="redocly.yaml",D="@redocly/theme",x="@theme",g="/app-data.json",U="/eject-component";var e;(function(o){o.BUILD="build",o.DEVELOP="develop",o.PREPARE="prepare"})(e||(e={}));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 a="entityKey",c="entityId",s="entityRelationId",m={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:`/${t}/oidc`,SAML_CALLBACK:`/${t}/saml2`,REDOCLY_CALLBACK:`/${t}/redocly`,REPLAY_OAUTH2_CALLBACK:`/${t}/replay-oauth2`,REDOCLY_LOGIN_CALLBACK:`/${t}/redocly/redocly-login`,REDOCLY_TOKEN_LOGIN:`/${t}/redocly-token-login`,SEARCH:"/_search",SEARCH_FACETS:"/_search-facets",SEMANTIC_SEARCH:"/_semantic-search",LOGOUT:"/logout",POST_LOGOUT:"/post-logout",LOGIN:"/login",IDP_LOGIN:`/${t}/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/:${c}?`,CATALOG_ENTITIES_RELATIONS:`/catalog-entities-relations/:${s}?`,BFF_CATALOG_ENTITIES:`/bff/catalog-entities/:${a}?`,BFF_CATALOG_RELATED_ENTITIES:`/bff/catalog-related-entities/:${a}`,BFF_CATALOG_REVISIONS:"/bff/catalog-revisions",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 _;(function(o){o.AI_SEARCH="aiSearch"})(_||(_={}));const h="/login",M="/invite",G={AUTH0_PASS:"/auth/auth0-pass"},H={NotExist:"ENOENT"},b="default_locale",F="sidebar-",y="PUBLIC_",v="branch.",B=["BROKEN_LINK","MARKDOC","RESOLVE"],k=["logo","navbar","products","footer","sidebar","scripts","links","feedback","search","aiAssistant","colorMode","palette","navigation","codeSnippet","markdown","openapi","graphql","analytics","userMenu","versionPicker","breadcrumbs","catalog","entitiesCatalog","scorecard","scorecards","scorecardClassic","mcp","banner"],E="redocly_category",f="redocly_product",K="redocly_version",Y="redocly_teams",V=E,$={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",kvStorageLimit:"kvStorageLimit",mcp:"mcp",banner:"banner"};export{A as ASYNC_API_DOCS_TEMPLATE_ID,t as AUTH_SEGMENT,v as BRANCH_ENV_PREFIX,c as CATALOG_ENTITY_ID,a as CATALOG_ENTITY_KEY,s as CATALOG_ENTITY_RELATION_ID,u as CONFIG_FILE_NAME,p as CUSTOM_MARKDOC_OPTIONS_PATH,O as CUSTOM_MARKDOC_TAGS_PATH,l as DEFAULT_ANONYMOUS_VISITOR_TEAM,S as DEFAULT_AUTHENTICATED_TEAM,I as DEFAULT_COOKIE_EXPIRATION,b as DEFAULT_LOCALE_PLACEHOLDER,d as DEFAULT_RBAC_SCOPE,N as DEFAULT_SSO_IDP_TITLE,D as DEFAULT_THEME_NAME,h as DEV_LOGIN_SLUG,U as EJECT_COMPONENT_URL,G as ExternalRoutes,$ as FEATURE,r as FEEDBACK_TYPES,H as FsErrors,g as GLOBAL_DATA_URL,i as GRAPHQL_SPEC_SLUG,T as GRAPHQL_TEMPLATE_ID,M as INVITE_SLUG,B as MARKDOC_ERROR_TYPES,n as OPENAPI_DOCS_TEMPLATE_ID,y as PUBLIC_ENV_PREFIX,C as PUBLIC_RBAC_SCOPE_ITEM,L as RBAC_ALL_OTHER_TEAMS,R as REQUIRED_OIDC_SCOPES,_ as RbacFeatures,E as SEARCH_CATEGORY_FIELD,V as SEARCH_GROUP_FACET_FIELD,f as SEARCH_PRODUCT_FIELD,Y as SEARCH_RBAC_FIELD,K as SEARCH_VERSION_FIELD,F as SIDEBAR_PREFIX,m as ServerRoutes,P as TRANSLATIONS_FILE_NAME,k as UI_ACCESSIBLE_CONFIG_PROPS,x as USER_THEME_ALIAS,e as cliCommandNames};

package/dist/markdoc/tags/index.d.ts

@@ -6,21 +6,51 @@ import { openApiResponseSample } from './openapi-response-sample.js';
 import { jsonExample } from './json-example.js';
 declare const _default: {
     [jsonSchema.tagName]: import("@markdoc/markdoc").Schema & {
+        attributes?: Record<string, import("@markdoc/markdoc").SchemaAttribute & {
+            resolver?: string;
+        }>;
+        renderForLlms?: import("@redocly/theme/markdoc/tags/types").RenderForLlmsFn;
+    } & {
         dynamicComponentLib?: string;
     };
     [openApiCodeSample.tagName]: import("@markdoc/markdoc").Schema & {
+        attributes?: Record<string, import("@markdoc/markdoc").SchemaAttribute & {
+            resolver?: string;
+        }>;
+        renderForLlms?: import("@redocly/theme/markdoc/tags/types").RenderForLlmsFn;
+    } & {
         dynamicComponentLib?: string;
     };
     [openApiExample.tagName]: import("@markdoc/markdoc").Schema & {
+        attributes?: Record<string, import("@markdoc/markdoc").SchemaAttribute & {
+            resolver?: string;
+        }>;
+        renderForLlms?: import("@redocly/theme/markdoc/tags/types").RenderForLlmsFn;
+    } & {
         dynamicComponentLib?: string;
     };
     [replayOpenApi.tagName]: import("@markdoc/markdoc").Schema & {
+        attributes?: Record<string, import("@markdoc/markdoc").SchemaAttribute & {
+            resolver?: string;
+        }>;
+        renderForLlms?: import("@redocly/theme/markdoc/tags/types").RenderForLlmsFn;
+    } & {
         dynamicComponentLib?: string;
     };
     [openApiResponseSample.tagName]: import("@markdoc/markdoc").Schema & {
+        attributes?: Record<string, import("@markdoc/markdoc").SchemaAttribute & {
+            resolver?: string;
+        }>;
+        renderForLlms?: import("@redocly/theme/markdoc/tags/types").RenderForLlmsFn;
+    } & {
         dynamicComponentLib?: string;
     };
     [jsonExample.tagName]: import("@markdoc/markdoc").Schema & {
+        attributes?: Record<string, import("@markdoc/markdoc").SchemaAttribute & {
+            resolver?: string;
+        }>;
+        renderForLlms?: import("@redocly/theme/markdoc/tags/types").RenderForLlmsFn;
+    } & {
         dynamicComponentLib?: string;
     };
 };

package/dist/markdoc/types.d.ts

@@ -1,6 +1,6 @@
-import type { Schema } from '@markdoc/markdoc';
+import type { MarkdocTagSchema } from '@redocly/theme/markdoc/tags/types';
 export type CustomMarkdocTag = {
-    schema: Schema & {
+    schema: MarkdocTagSchema & {
         dynamicComponentLib?: string;
     };
     tagName: string;

package/dist/server/api-routes/run-api-routes-worker.js

@@ -1 +1 @@
-import*as p from"workerpool";import{withPathPrefix as f}from"@redocly/theme/core/utils";import{envConfig as u}from"../config/env-config.js";import{telemetry as a}from"../telemetry/index.js";import{TimeoutExceededError as E}from"./errors/timeout-exceeded.js";import{serializeRequest as _}from"./helpers/serialize-request.js";import{apiRoutesWorkers as A,API_ROUTES_WORKER_KEY as T}from"../workers/api-routes-worker-pool.js";import{API_FUNCTIONS_REQUEST_HANDLER_ID as d}from"../plugins/api-functions/index.js";const g=1e4,h=15;async function U(e,r,t){a.initialize();const s=r.get("auth"),i=await t.resolveRouteStaticData(e)||{},n=f(e.slug);try{const{status:o,headers:l,body:c}=await A.exec(T,[{serverOutDir:t.serverOutDir,slug:n,requestHandlerId:e.requestHandlerId,maxResponseSizeMB:h,ctxData:{user:{teams:s.teams,email:s.claims.email,claims:s.claims,idpAccessToken:s.idpAccessToken,idpId:s.claims.idpId,isAuthenticated:s.isAuthenticated},config:t.config,outdir:t.outdir,baseUrl:new URL(r.req.url).origin},staticData:{...i,props:{...i.props,routeSlug:n,outdir:t.outdir}},req:await _(r.req.raw),sqldRemoteDatabaseUrl:u.SQLD_REMOTE_DATABASE_URL,sqldRemoteDatabaseAuthToken:u.SQLD_REMOTE_DATABASE_AUTH_TOKEN}],{timeout:g});R({requestHandlerId:e.requestHandlerId,body:c,headers:l,status:o,ctx:r});const m=c.data?Buffer.from(c.data):null;return new Response(m,{status:o,headers:l})}catch(o){throw M({requestHandlerId:e.requestHandlerId,error:o}),o instanceof p.Promise.TimeoutError?new E("Timeout exceeded"):o}}function R({requestHandlerId:e,body:r,headers:t,status:s,ctx:i}){e.startsWith(d)?a.sendApiFunctionCalledMessage([{object:"api_function",error:null,handler:e,body:r,headers:t,status:s}]):a.sendMockServerCalledMessage([{object:"mock_server",error:null,handler:e,body:r,headers:{"user-agent":i.req.header("user-agent")??""},status:s}])}function M({requestHandlerId:e,error:r}){const t={handler:e,message:r?.message??null,stack:r?.stack??null};e.startsWith(d)?a.sendApiFunctionErrorMessage([{object:"api_function",...t}]):a.sendMockServerErrorMessage([{object:"mock_server",...t}])}export{U as runApiRoutesWorker,M as sendTelemetryErrorMessage};
+import*as p from"workerpool";import{withPathPrefix as f}from"@redocly/theme/core/utils";import{envConfig as l}from"../config/env-config.js";import{telemetry as a}from"../telemetry/index.js";import{TimeoutExceededError as E}from"./errors/timeout-exceeded.js";import{serializeRequest as _}from"./helpers/serialize-request.js";import{apiRoutesWorkers as A,API_ROUTES_WORKER_KEY as T}from"../workers/api-routes-worker-pool.js";import{API_FUNCTIONS_REQUEST_HANDLER_ID as u}from"../plugins/api-functions/index.js";const g=1e4,h=15;async function U(e,r,t){a.initialize();const s=r.get("auth"),i=await t.resolveRouteStaticData(e)||{},n=f(e.slug);try{const{status:o,headers:d,body:c}=await A.exec(T,[{serverOutDir:t.serverOutDir,slug:n,requestHandlerId:e.requestHandlerId,maxResponseSizeMB:h,ctxData:{user:{teams:s.teams,email:s.claims.email,claims:s.claims,idpAccessToken:s.idpAccessToken,idpId:s.claims.idpId,isAuthenticated:s.isAuthenticated},config:t.config,outdir:t.outdir,baseUrl:new URL(r.req.url).origin},staticData:{...i,props:{...i.props,routeSlug:n,outdir:t.outdir}},req:await _(r.req.raw),sqldRemoteDatabaseUrl:l.SQLD_REMOTE_DATABASE_URL,sqldRemoteDatabaseAuthToken:l.SQLD_REMOTE_DATABASE_AUTH_TOKEN}],{timeout:g});R({requestHandlerId:e.requestHandlerId,status:o,ctx:r});const m=c.data?Buffer.from(c.data):null;return new Response(m,{status:o,headers:d})}catch(o){throw M({requestHandlerId:e.requestHandlerId,error:o}),o instanceof p.Promise.TimeoutError?new E("Timeout exceeded"):o}}function R({requestHandlerId:e,status:r,ctx:t}){e.startsWith(u)?a.sendApiFunctionCalledMessage([{object:"api_function",error:null,handler:e,status:r}]):a.sendMockServerCalledMessage([{object:"mock_server",error:null,handler:e,headers:{"user-agent":t.req.header("user-agent")??null},status:r}])}function M({requestHandlerId:e,error:r}){const t={handler:e,message:r?.message??null,stack:r?.stack??null};e.startsWith(u)?a.sendApiFunctionErrorMessage([{object:"api_function",...t}]):a.sendMockServerErrorMessage([{object:"mock_server",...t}])}export{U as runApiRoutesWorker,M as sendTelemetryErrorMessage};

package/dist/server/config/env-config.d.ts

@@ -57,6 +57,9 @@ declare function loadEnvConfig(): {
     REDOCLY_EXP_DISABLE_MD_VALIDATION?: boolean | undefined;
     ENABLE_SOURCE_MAPS?: boolean | undefined;
     PLAN_GATES?: string | undefined;
+    REDOCLY_EXP_LLMSTXT_AGENT_FEEDBACK_ENABLED?: boolean | undefined;
+    REDOCLY_EXP_LLMSTXT_AGENT_FEEDBACK_URL?: string | undefined;
+    REDOCLY_EXP_LLMSTXT_AGENT_ENDPOINT?: string | undefined;
     SEARCH_DEV_REINIT?: string | undefined;
     TYPESENSE_API_URL?: string | undefined;
     TYPESENSE_API_KEY?: string | undefined;
@@ -133,6 +136,9 @@ export declare const envConfig: {
     REDOCLY_EXP_DISABLE_MD_VALIDATION?: boolean | undefined;
     ENABLE_SOURCE_MAPS?: boolean | undefined;
     PLAN_GATES?: string | undefined;
+    REDOCLY_EXP_LLMSTXT_AGENT_FEEDBACK_ENABLED?: boolean | undefined;
+    REDOCLY_EXP_LLMSTXT_AGENT_FEEDBACK_URL?: string | undefined;
+    REDOCLY_EXP_LLMSTXT_AGENT_ENDPOINT?: string | undefined;
     SEARCH_DEV_REINIT?: string | undefined;
     TYPESENSE_API_URL?: string | undefined;
     TYPESENSE_API_KEY?: string | undefined;

package/dist/server/config/env-schema.d.ts

@@ -1,5 +1,5 @@
-import type { z } from 'zod';
-export declare const envSchema: z.ZodObject<{
+import { z } from 'zod';
+export declare const envSchema: z.ZodEffects<z.ZodObject<{
     NODE_ENV: z.ZodOptional<z.ZodEnum<["development", "production"]>>;
     REDOCLY_ENV: z.ZodDefault<z.ZodEnum<["production", "preview", "development"]>>;
     REDOCLY_EXECUTION_MODE: z.ZodDefault<z.ZodEnum<["build", "develop", "runtime"]>>;
@@ -54,6 +54,9 @@ export declare const envSchema: z.ZodObject<{
     REDOCLY_EXP_DISABLE_MD_VALIDATION: z.ZodEffects<z.ZodOptional<z.ZodEnum<["true", "false"]>>, boolean | undefined, "true" | "false" | undefined>;
     ENABLE_SOURCE_MAPS: z.ZodEffects<z.ZodOptional<z.ZodEnum<["true", "false"]>>, boolean | undefined, "true" | "false" | undefined>;
     PLAN_GATES: z.ZodOptional<z.ZodString>;
+    REDOCLY_EXP_LLMSTXT_AGENT_FEEDBACK_ENABLED: z.ZodEffects<z.ZodOptional<z.ZodEnum<["true", "false"]>>, boolean | undefined, "true" | "false" | undefined>;
+    REDOCLY_EXP_LLMSTXT_AGENT_FEEDBACK_URL: z.ZodOptional<z.ZodString>;
+    REDOCLY_EXP_LLMSTXT_AGENT_ENDPOINT: z.ZodOptional<z.ZodString>;
 } & {
     SEARCH_DEV_REINIT: z.ZodOptional<z.ZodString>;
     SEARCH_DEV_DEBUG: z.ZodEffects<z.ZodDefault<z.ZodEnum<["true", "false"]>>, boolean, "true" | "false" | undefined>;
@@ -128,6 +131,9 @@ export declare const envSchema: z.ZodObject<{
     REDOCLY_EXP_DISABLE_MD_VALIDATION?: boolean | undefined;
     ENABLE_SOURCE_MAPS?: boolean | undefined;
     PLAN_GATES?: string | undefined;
+    REDOCLY_EXP_LLMSTXT_AGENT_FEEDBACK_ENABLED?: boolean | undefined;
+    REDOCLY_EXP_LLMSTXT_AGENT_FEEDBACK_URL?: string | undefined;
+    REDOCLY_EXP_LLMSTXT_AGENT_ENDPOINT?: string | undefined;
     SEARCH_DEV_REINIT?: string | undefined;
     TYPESENSE_API_URL?: string | undefined;
     TYPESENSE_API_KEY?: string | undefined;
@@ -193,6 +199,147 @@ export declare const envSchema: z.ZodObject<{
     REDOCLY_EXP_DISABLE_MD_VALIDATION?: "true" | "false" | undefined;
     ENABLE_SOURCE_MAPS?: "true" | "false" | undefined;
     PLAN_GATES?: string | undefined;
+    REDOCLY_EXP_LLMSTXT_AGENT_FEEDBACK_ENABLED?: "true" | "false" | undefined;
+    REDOCLY_EXP_LLMSTXT_AGENT_FEEDBACK_URL?: string | undefined;
+    REDOCLY_EXP_LLMSTXT_AGENT_ENDPOINT?: string | undefined;
+    SEARCH_DEV_REINIT?: string | undefined;
+    SEARCH_DEV_DEBUG?: "true" | "false" | undefined;
+    TYPESENSE_API_URL?: string | undefined;
+    TYPESENSE_API_KEY?: string | undefined;
+    MAIN_API_URL?: string | undefined;
+    SERVER_EDITOR_APP_URL?: string | undefined;
+    REDOCLY_PUBLIC_URL?: string | undefined;
+    REDOCLY_DIAGRAM_MICROSERVICE_URL?: string | undefined;
+    REDOCLY_CORS_ORIGINS?: string | undefined;
+    SQLD_REMOTE_DATABASE_URL?: string | undefined;
+    SQLD_REMOTE_DATABASE_AUTH_TOKEN?: string | undefined;
+    FORCE_CATALOG_CACHE_REVALIDATE?: "true" | "false" | undefined;
+    SCORECARDS_POLLING_INTERVAL_MS?: string | undefined;
+    OTEL_TRACES_URL?: string | undefined;
+    REQUEST_ID?: string | undefined;
+    SITE_URL?: string | undefined;
+}>, {
+    REDOCLY_EXECUTION_MODE: "build" | "develop" | "runtime";
+    REDOCLY_ENV: "development" | "production" | "preview";
+    SEARCH_DEV_DEBUG: boolean;
+    NODE_ENV?: "development" | "production" | undefined;
+    REDOCLY_INTERNAL_DEV?: boolean | undefined;
+    CI?: boolean | undefined;
+    PORT?: number | undefined;
+    REDOCLY_LOG_FORMAT?: string | undefined;
+    REDOCLY_LOG_LEVEL?: string | undefined;
+    TERM?: string | undefined;
+    INSPECT_MODE?: string | undefined;
+    REDOCLY_PREFIX_PATHS?: string | undefined;
+    REDOCLY_CONTENT_DIR?: string | undefined;
+    REDOCLY_PORTAL_VERSION?: string | undefined;
+    REDOCLY_TELEMETRY?: string | undefined;
+    REDOCLY_TELEMETRY_ENDPOINT?: string | undefined;
+    TELEMETRY_DEV_DEBUG?: boolean | undefined;
+    WEB_SERVER_IDLE_TIMEOUT?: string | undefined;
+    REDOCLY_PROBLEMS_OUTPUT_FILE?: string | undefined;
+    REDOCLY_METADATA_OUTPUT_FOLDER?: string | undefined;
+    ORGANIZATION_ID?: string | undefined;
+    ORGANIZATION_SLUG?: string | undefined;
+    ORG_SLUG?: string | undefined;
+    PROJECT_ID?: string | undefined;
+    PROJECT_SLUG?: string | undefined;
+    PROJECT_URL?: string | undefined;
+    PROJECT_BUILD_ID?: string | undefined;
+    PUBLIC_REDOCLY_BRANCH_NAME?: string | undefined;
+    JWT_SECRET_KEY?: string | undefined;
+    AUTH_URL?: string | undefined;
+    BH_API_URL?: string | undefined;
+    ENTITLEMENTS_JWKS_CDN_URL?: string | undefined;
+    OAUTH_CLIENT_ID?: string | undefined;
+    OAUTH_CLIENT_SECRET?: string | undefined;
+    OIDC_CLIENT_ID?: string | undefined;
+    OIDC_CLIENT_SECRET?: string | undefined;
+    OIDC_ISSUER_URL?: string | undefined;
+    LOCALHOST_LOGIN?: boolean | undefined;
+    REDOCLY_OAUTH_USE_INTROSPECT?: string | undefined;
+    REDOCLY_ENFORCE_LOGIN?: boolean | undefined;
+    REDOCLY_ENFORCE_RESIDENCY?: string | undefined;
+    REDOCLY_SSR_RENDER_MODE?: "main" | "worker" | undefined;
+    REDOCLY_SSR_WORKERS_MIN?: number | undefined;
+    REDOCLY_SSR_WORKERS_MAX?: number | undefined;
+    NEW_CATALOG_ENABLED?: boolean | undefined;
+    NEW_SCORECARDS_ENABLED?: boolean | undefined;
+    ENABLE_COMMENTS?: string | undefined;
+    REDOCLY_EXP_DISABLE_MD_VALIDATION?: boolean | undefined;
+    ENABLE_SOURCE_MAPS?: boolean | undefined;
+    PLAN_GATES?: string | undefined;
+    REDOCLY_EXP_LLMSTXT_AGENT_FEEDBACK_ENABLED?: boolean | undefined;
+    REDOCLY_EXP_LLMSTXT_AGENT_FEEDBACK_URL?: string | undefined;
+    REDOCLY_EXP_LLMSTXT_AGENT_ENDPOINT?: string | undefined;
+    SEARCH_DEV_REINIT?: string | undefined;
+    TYPESENSE_API_URL?: string | undefined;
+    TYPESENSE_API_KEY?: string | undefined;
+    MAIN_API_URL?: string | undefined;
+    SERVER_EDITOR_APP_URL?: string | undefined;
+    REDOCLY_PUBLIC_URL?: string | undefined;
+    REDOCLY_DIAGRAM_MICROSERVICE_URL?: string | undefined;
+    REDOCLY_CORS_ORIGINS?: string | undefined;
+    SQLD_REMOTE_DATABASE_URL?: string | undefined;
+    SQLD_REMOTE_DATABASE_AUTH_TOKEN?: string | undefined;
+    FORCE_CATALOG_CACHE_REVALIDATE?: boolean | undefined;
+    SCORECARDS_POLLING_INTERVAL_MS?: string | undefined;
+    OTEL_TRACES_URL?: string | undefined;
+    REQUEST_ID?: string | undefined;
+    SITE_URL?: string | undefined;
+}, {
+    REDOCLY_EXECUTION_MODE?: "build" | "develop" | "runtime" | undefined;
+    NODE_ENV?: "development" | "production" | undefined;
+    REDOCLY_ENV?: "development" | "production" | "preview" | undefined;
+    REDOCLY_INTERNAL_DEV?: "true" | "false" | undefined;
+    CI?: "1" | "true" | "false" | undefined;
+    PORT?: number | undefined;
+    REDOCLY_LOG_FORMAT?: string | undefined;
+    REDOCLY_LOG_LEVEL?: string | undefined;
+    TERM?: string | undefined;
+    INSPECT_MODE?: string | undefined;
+    REDOCLY_PREFIX_PATHS?: string | undefined;
+    REDOCLY_CONTENT_DIR?: string | undefined;
+    REDOCLY_PORTAL_VERSION?: string | undefined;
+    REDOCLY_TELEMETRY?: string | undefined;
+    REDOCLY_TELEMETRY_ENDPOINT?: string | undefined;
+    TELEMETRY_DEV_DEBUG?: "true" | "false" | undefined;
+    WEB_SERVER_IDLE_TIMEOUT?: string | undefined;
+    REDOCLY_PROBLEMS_OUTPUT_FILE?: string | undefined;
+    REDOCLY_METADATA_OUTPUT_FOLDER?: string | undefined;
+    ORGANIZATION_ID?: string | undefined;
+    ORGANIZATION_SLUG?: string | undefined;
+    ORG_SLUG?: string | undefined;
+    PROJECT_ID?: string | undefined;
+    PROJECT_SLUG?: string | undefined;
+    PROJECT_URL?: string | undefined;
+    PROJECT_BUILD_ID?: string | undefined;
+    PUBLIC_REDOCLY_BRANCH_NAME?: string | undefined;
+    JWT_SECRET_KEY?: string | undefined;
+    AUTH_URL?: string | undefined;
+    BH_API_URL?: string | undefined;
+    ENTITLEMENTS_JWKS_CDN_URL?: string | undefined;
+    OAUTH_CLIENT_ID?: string | undefined;
+    OAUTH_CLIENT_SECRET?: string | undefined;
+    OIDC_CLIENT_ID?: string | undefined;
+    OIDC_CLIENT_SECRET?: string | undefined;
+    OIDC_ISSUER_URL?: string | undefined;
+    LOCALHOST_LOGIN?: "true" | "false" | undefined;
+    REDOCLY_OAUTH_USE_INTROSPECT?: string | undefined;
+    REDOCLY_ENFORCE_LOGIN?: "true" | "false" | undefined;
+    REDOCLY_ENFORCE_RESIDENCY?: string | undefined;
+    REDOCLY_SSR_RENDER_MODE?: "main" | "worker" | undefined;
+    REDOCLY_SSR_WORKERS_MIN?: number | undefined;
+    REDOCLY_SSR_WORKERS_MAX?: number | undefined;
+    NEW_CATALOG_ENABLED?: "true" | "false" | undefined;
+    NEW_SCORECARDS_ENABLED?: "true" | "false" | undefined;
+    ENABLE_COMMENTS?: string | undefined;
+    REDOCLY_EXP_DISABLE_MD_VALIDATION?: "true" | "false" | undefined;
+    ENABLE_SOURCE_MAPS?: "true" | "false" | undefined;
+    PLAN_GATES?: string | undefined;
+    REDOCLY_EXP_LLMSTXT_AGENT_FEEDBACK_ENABLED?: "true" | "false" | undefined;
+    REDOCLY_EXP_LLMSTXT_AGENT_FEEDBACK_URL?: string | undefined;
+    REDOCLY_EXP_LLMSTXT_AGENT_ENDPOINT?: string | undefined;
     SEARCH_DEV_REINIT?: string | undefined;
     SEARCH_DEV_DEBUG?: "true" | "false" | undefined;
     TYPESENSE_API_URL?: string | undefined;

package/dist/server/config/env-schema.js

@@ -1 +1 @@
-import{environmentDetectionSchema as e}from"./env-schemas/environment-detection.js";import{serverConfigSchema as m}from"./env-schemas/server-config.js";import{organizationProjectSchema as r}from"./env-schemas/organization-project.js";import{authSchema as o}from"./env-schemas/auth.js";import{ssrSchema as t}from"./env-schemas/ssr.js";import{featureFlagsSchema as a}from"./env-schemas/feature-flags.js";import{searchSchema as c}from"./env-schemas/search.js";import{apiUrlsSchema as i}from"./env-schemas/api-urls.js";import{databaseSchema as g}from"./env-schemas/database.js";import{catalogSchema as h}from"./env-schemas/catalog.js";import{scorecardsSchema as p}from"./env-schemas/scorecards.js";import{telemetrySchema as f}from"./env-schemas/telemetry.js";import{siteSchema as S}from"./env-schemas/site.js";const F=e.merge(m).merge(r).merge(o).merge(t).merge(a).merge(c).merge(i).merge(g).merge(h).merge(p).merge(f).merge(S).strip();export{F as envSchema};
+import{z as r}from"zod";import{environmentDetectionSchema as o}from"./env-schemas/environment-detection.js";import{serverConfigSchema as t}from"./env-schemas/server-config.js";import{organizationProjectSchema as a}from"./env-schemas/organization-project.js";import{authSchema as i}from"./env-schemas/auth.js";import{ssrSchema as E}from"./env-schemas/ssr.js";import{featureFlagsSchema as c}from"./env-schemas/feature-flags.js";import{searchSchema as s}from"./env-schemas/search.js";import{apiUrlsSchema as _}from"./env-schemas/api-urls.js";import{databaseSchema as S}from"./env-schemas/database.js";import{catalogSchema as h}from"./env-schemas/catalog.js";import{scorecardsSchema as p}from"./env-schemas/scorecards.js";import{telemetrySchema as f}from"./env-schemas/telemetry.js";import{siteSchema as T}from"./env-schemas/site.js";const g=o.merge(t).merge(a).merge(i).merge(E).merge(c).merge(s).merge(_).merge(S).merge(h).merge(p).merge(f).merge(T).strip(),M=g.superRefine((e,m)=>{e.REDOCLY_EXP_LLMSTXT_AGENT_FEEDBACK_ENABLED===!0&&!e.REDOCLY_EXP_LLMSTXT_AGENT_ENDPOINT?.trim()&&m.addIssue({code:r.ZodIssueCode.custom,path:["REDOCLY_EXP_LLMSTXT_AGENT_ENDPOINT"],message:"REDOCLY_EXP_LLMSTXT_AGENT_ENDPOINT is required when REDOCLY_EXP_LLMSTXT_AGENT_FEEDBACK_ENABLED=true"})});export{M as envSchema};

package/dist/server/config/env-schemas/feature-flags.d.ts

@@ -9,6 +9,12 @@ export declare const featureFlagsSchema: z.ZodObject<{
     REDOCLY_EXP_DISABLE_MD_VALIDATION: z.ZodEffects<z.ZodOptional<z.ZodEnum<["true", "false"]>>, boolean | undefined, "true" | "false" | undefined>;
     ENABLE_SOURCE_MAPS: z.ZodEffects<z.ZodOptional<z.ZodEnum<["true", "false"]>>, boolean | undefined, "true" | "false" | undefined>;
     PLAN_GATES: z.ZodOptional<z.ZodString>;
+    /** Experimental: append agent feedback instructions to llms.txt Markdown chunks. */
+    REDOCLY_EXP_LLMSTXT_AGENT_FEEDBACK_ENABLED: z.ZodEffects<z.ZodOptional<z.ZodEnum<["true", "false"]>>, boolean | undefined, "true" | "false" | undefined>;
+    /** Optional POST URL for the agent feedback footer; defaults to `{seo.siteUrl|REDOCLY_PUBLIC_URL}/api/agent-feedback`, or `/api/agent-feedback` on the same origin. */
+    REDOCLY_EXP_LLMSTXT_AGENT_FEEDBACK_URL: z.ZodOptional<z.ZodString>;
+    /** (Optional) API endpoint for the agent feedback endpoint;**/
+    REDOCLY_EXP_LLMSTXT_AGENT_ENDPOINT: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     NEW_CATALOG_ENABLED?: boolean | undefined;
     NEW_SCORECARDS_ENABLED?: boolean | undefined;
@@ -16,6 +22,9 @@ export declare const featureFlagsSchema: z.ZodObject<{
     REDOCLY_EXP_DISABLE_MD_VALIDATION?: boolean | undefined;
     ENABLE_SOURCE_MAPS?: boolean | undefined;
     PLAN_GATES?: string | undefined;
+    REDOCLY_EXP_LLMSTXT_AGENT_FEEDBACK_ENABLED?: boolean | undefined;
+    REDOCLY_EXP_LLMSTXT_AGENT_FEEDBACK_URL?: string | undefined;
+    REDOCLY_EXP_LLMSTXT_AGENT_ENDPOINT?: string | undefined;
 }, {
     NEW_CATALOG_ENABLED?: "true" | "false" | undefined;
     NEW_SCORECARDS_ENABLED?: "true" | "false" | undefined;
@@ -23,5 +32,8 @@ export declare const featureFlagsSchema: z.ZodObject<{
     REDOCLY_EXP_DISABLE_MD_VALIDATION?: "true" | "false" | undefined;
     ENABLE_SOURCE_MAPS?: "true" | "false" | undefined;
     PLAN_GATES?: string | undefined;
+    REDOCLY_EXP_LLMSTXT_AGENT_FEEDBACK_ENABLED?: "true" | "false" | undefined;
+    REDOCLY_EXP_LLMSTXT_AGENT_FEEDBACK_URL?: string | undefined;
+    REDOCLY_EXP_LLMSTXT_AGENT_ENDPOINT?: string | undefined;
 }>;
 //# sourceMappingURL=feature-flags.d.ts.map

package/dist/server/config/env-schemas/feature-flags.js

@@ -1 +1 @@
-import{z as o}from"zod";import{envBooleanStringOptional as E}from"../../utils/envs/env-boolean-string.js";const _=o.object({NEW_CATALOG_ENABLED:E(),NEW_SCORECARDS_ENABLED:E(),ENABLE_COMMENTS:o.string().optional(),REDOCLY_EXP_DISABLE_MD_VALIDATION:E(),ENABLE_SOURCE_MAPS:E(),PLAN_GATES:o.string().optional()});export{_ as featureFlagsSchema};
+import{z as E}from"zod";import{envBooleanStringOptional as _}from"../../utils/envs/env-boolean-string.js";const o=E.object({NEW_CATALOG_ENABLED:_(),NEW_SCORECARDS_ENABLED:_(),ENABLE_COMMENTS:E.string().optional(),REDOCLY_EXP_DISABLE_MD_VALIDATION:_(),ENABLE_SOURCE_MAPS:_(),PLAN_GATES:E.string().optional(),REDOCLY_EXP_LLMSTXT_AGENT_FEEDBACK_ENABLED:_(),REDOCLY_EXP_LLMSTXT_AGENT_FEEDBACK_URL:E.string().optional(),REDOCLY_EXP_LLMSTXT_AGENT_ENDPOINT:E.string().optional()});export{o as featureFlagsSchema};

package/dist/server/constants/feedback.d.ts

@@ -3,4 +3,6 @@ export declare const MAX_REASONS_COUNT = 10;
 export declare const MAX_PATH_LENGTH = 1000;
 export declare const MAX_LANG_LENGTH = 20;
 export declare const MAX_EMAIL_LENGTH = 254;
+export declare const MAX_AGENT_LENGTH = 200;
+export declare const MAX_TARGET_FEATURE_LENGTH = 500;
 //# sourceMappingURL=feedback.d.ts.map

package/dist/server/constants/feedback.js

@@ -1 +1 @@
-const o=5e3,t=10,_=1e3,A=20,N=254;export{o as MAX_CONTEXT_LENGTH,N as MAX_EMAIL_LENGTH,A as MAX_LANG_LENGTH,_ as MAX_PATH_LENGTH,t as MAX_REASONS_COUNT};
+const _=5e3,o=10,t=1e3,A=20,T=254,E=200,N=500;export{E as MAX_AGENT_LENGTH,_ as MAX_CONTEXT_LENGTH,T as MAX_EMAIL_LENGTH,A as MAX_LANG_LENGTH,t as MAX_PATH_LENGTH,o as MAX_REASONS_COUNT,N as MAX_TARGET_FEATURE_LENGTH};

package/dist/server/node-bundle-entry.js

@@ -1 +1 @@
-import{resolve as n,dirname as f}from"node:path";import{fileURLToPath as l}from"node:url";import{readFile as u}from"fs/promises";import{createReadStream as d}from"fs";import{envConfig as v}from"./config/env-config.js";import{telemetry as g}from"./telemetry/index.js";import{createRouter as S}from"./web-server/router.js";import{installProdRoutes as E}from"./web-server/routes/index.js";import{Store as w}from"./store.js";import{loadEnvVariables as D}from"./utils/envs/load-env-variables.js";import{startHttpServer as P}from"./web-server/http.js";import{readStaticData as x}from"./utils/static-data.js";import{startIdleTimeout as R}from"./web-server/middleware/idleTimeoutMiddleware.js";import{reporter as b}from"./tools/notifiers/reporter.js";import{EntitlementsProvider as y}from"./entitlements/entitlements-provider.js";import{DatabasePreconnectService as I}from"./providers/database/database-preconnect-service.js";import{KvService as h}from"./persistence/kv/services/kv-service.js";import{runScorecardsWorker as N}from"./plugins/scorecards/workers/run-scorecards-worker.js";import{isCatalogEntitiesEnabled as O}from"./utils/is-catalog-entities-enabled.js";import{isScorecardsEnabled as T}from"./utils/is-scorecards-enabled.js";import{renderPage as tr}from"./ssr/index.js";const k=new URL(import.meta.url),A=k.searchParams.get("only-exports")==="true";if(!A){let p=function(){const r=process.argv.findIndex(i=>i==="--port"||i==="-p");if(r===-1)return null;const o=process.argv[r+1];if(o.startsWith("-"))return null;const e=parseInt(o,10);return isNaN(e)?null:e};const t=f(l(import.meta.url));await D(t);const s=JSON.parse(await u(n(t,"./store.json"),"utf-8")),m=w.fromJson(s,{outdir:n(t,"../client"),serverOutDir:t,serverMode:!0,contentDir:""});if(await y.instance().init({ignoreTokenExpiration:!0}),O()){await I.init(t);const r=await h.getInstance({baseDbDir:t});setInterval(()=>r.clearExpired(),300*1e3)}c(m).catch(r=>{console.error(r)});async function c(r){g.initialize();const o=await S();E(o,r,{readStaticAsset:async a=>d(a),resolveRouteData:async a=>x(a.slug,r.outdir)}),b.printErrors();const e=p(),i=v.PORT;return await P(o,e??i??4e3),R(),T(r.config)&&N(r.serverOutDir,r.config.scorecards),o}}export{tr as renderPage};
+import{resolve as n,dirname as f}from"node:path";import{fileURLToPath as l}from"node:url";import{readFile as u}from"fs/promises";import{createReadStream as d}from"fs";import{envConfig as v}from"./config/env-config.js";import{telemetry as g}from"./telemetry/index.js";import{createRouter as S}from"./web-server/router.js";import{installProdRoutes as R}from"./web-server/routes/index.js";import{Store as w}from"./store.js";import{loadEnvVariables as x}from"./utils/envs/load-env-variables.js";import{startHttpServer as D}from"./web-server/http.js";import{readStaticData as P}from"./utils/static-data.js";import{startIdleTimeout as E}from"./web-server/middleware/idleTimeoutMiddleware.js";import{reporter as y}from"./tools/notifiers/reporter.js";import{logger as b}from"./tools/notifiers/logger.js";import{EntitlementsProvider as h}from"./entitlements/entitlements-provider.js";import{DatabasePreconnectService as I}from"./providers/database/database-preconnect-service.js";import{KvService as O}from"./persistence/kv/services/kv-service.js";import{runScorecardsWorker as N}from"./plugins/scorecards/workers/run-scorecards-worker.js";import{isScorecardsEnabled as T}from"./utils/is-scorecards-enabled.js";import{isRealmOrReef as k}from"./utils/is-realm-or-reef.js";import{renderPage as or}from"./ssr/index.js";const A=new URL(import.meta.url),F=A.searchParams.get("only-exports")==="true";if(!F){let p=function(){const r=process.argv.findIndex(i=>i==="--port"||i==="-p");if(r===-1)return null;const t=process.argv[r+1];if(t.startsWith("-"))return null;const o=parseInt(t,10);return isNaN(o)?null:o};const e=f(l(import.meta.url));await x(e);const s=JSON.parse(await u(n(e,"./store.json"),"utf-8")),m=w.fromJson(s,{outdir:n(e,"../client"),serverOutDir:e,serverMode:!0,contentDir:""});if(await h.instance().init({ignoreTokenExpiration:!0}),k()){await I.init(e);const r=await O.getInstance({baseDbDir:e});setInterval(()=>{r.clearExpired().catch(t=>{b.error("Failed to clear expired KV entries",t)})},300*1e3)}c(m).catch(r=>{console.error(r)});async function c(r){g.initialize();const t=await S();R(t,r,{readStaticAsset:async a=>d(a),resolveRouteData:async a=>P(a.slug,r.outdir)}),y.printErrors();const o=p(),i=v.PORT;return await D(t,o??i??4e3),E(),T(r.config)&&N(r.serverOutDir,r.config.scorecards),t}}export{or as renderPage};

package/dist/server/persistence/cache/repositories/cache-repository.js

@@ -1 +1 @@
-import{and as l,eq as a}from"drizzle-orm";import{isTtlExpired as d}from"../../../utils/is-ttl-expired.js";import{logger as o}from"../../../tools/notifiers/logger.js";import{DatabaseConnectionFactory as m}from"../../../providers/database/database-connection-factory.js";import{cacheTable as r}from"../../../providers/database/databases/sqlite-db/schemas/cache-table.js";import{createCacheDbRecord as u}from"../mappers/create-cache-db-record.js";import{createCacheReadModel as h}from"../mappers/create-cache-read-model.js";class c{static#t;#e;constructor(t){this.#e=t.client}static async getInstance(t){if(!c.#t){const e=await m.create(t);if(!e)throw new Error("Failed to create db connection for cache repository");c.#t=new c(e)}return c.#t}async get(t,e){const n=[a(r.key,t)];e&&n.push(a(r.namespace,e));const i=await this.#e.client.select().from(r).where(l(...n)).get();if(!i)return null;const s=h(i);return d(s.ttlInSeconds,s.createdAt)?(await this.delete(t,e),null):s}async set(t){try{const e=u(t);return await this.#e.client.insert(r).values(e).onConflictDoUpdate({target:[r.key],set:{value:e.value,namespace:e.namespace,ttl:e.ttl,updatedAt:e.updatedAt}}),e.key}catch(e){return o.error("Error setting cache: "+e.message),null}}async delete(t,e){try{return await this.#e.client.delete(r).where(l(a(r.key,t),a(r.namespace,e))),!0}catch(n){return o.error("Error deleting cache: "+n.message),!1}}async deleteByNamespace(t){try{return await this.#e.client.delete(r).where(a(r.namespace,t)),!0}catch(e){return o.error("Error deleting cache by namespace: "+e.message),!1}}async clearAll(){try{return await this.#e.client.delete(r),!0}catch(t){return o.error("Error clearing all cache: "+t.message),!1}}}export{c as CacheRepository};
+import{and as i,eq as a}from"drizzle-orm";import{isTtlExpired as m}from"../../../utils/is-ttl-expired.js";import{logger as n}from"../../../tools/notifiers/logger.js";import{cacheTable as r}from"../../../providers/database/databases/sqlite-db/schemas/cache-table.js";import{createDatabaseRepositoryInstance as d,InstanceCacheResolver as h}from"../../../providers/database/instance-cache-resolver.js";import{createCacheDbRecord as u}from"../mappers/create-cache-db-record.js";import{createCacheReadModel as p}from"../mappers/create-cache-read-model.js";class l{static#t=new h(e=>d(e,"cache",l));#e;constructor(e){this.#e=e.client}static async getInstance(e){return l.#t.get(e)}async get(e,t){const c=[a(r.key,e)];t&&c.push(a(r.namespace,t));const o=await this.#e.client.select().from(r).where(i(...c)).get();if(!o)return null;const s=p(o);return m(s.ttlInSeconds,s.createdAt)?(await this.delete(e,t),null):s}async set(e){try{const t=u(e);return await this.#e.client.insert(r).values(t).onConflictDoUpdate({target:[r.key],set:{value:t.value,namespace:t.namespace,ttl:t.ttl,updatedAt:t.updatedAt}}),t.key}catch(t){return n.error("Error setting cache: "+t.message),null}}async delete(e,t){try{return await this.#e.client.delete(r).where(i(a(r.key,e),a(r.namespace,t))),!0}catch(c){return n.error("Error deleting cache: "+c.message),!1}}async deleteByNamespace(e){try{return await this.#e.client.delete(r).where(a(r.namespace,e)),!0}catch(t){return n.error("Error deleting cache by namespace: "+t.message),!1}}async clearAll(){try{return await this.#e.client.delete(r),!0}catch(e){return n.error("Error clearing all cache: "+e.message),!1}}}export{l as CacheRepository};

package/dist/server/persistence/file-hashes/repositories/file-hashes-repository.js

@@ -1 +1 @@
-import{DatabaseConnectionFactory as a}from"../../../providers/database/database-connection-factory.js";import{BaseRepository as r}from"../../../providers/database/base-repository.js";import{FileHashesWriteRepository as i}from"./file-hashes-write-repository.js";import{FileHashesReadRepository as n}from"./file-hashes-read-repository.js";class e extends r{static#s;#t;#e;constructor(t){super(t),this.#t=new n(this.databaseClient),this.#e=new i(this.databaseClient)}static async getInstance(t){if(!e.#s){const s=await a.create(t);if(!s)throw new Error("Failed to create db connection for file hashes repository");e.#s=new e(s)}return e.#s}async getByPath(t){return this.#t.getByPath(t)}async getAllOutdated(t){return this.#t.getAllOutdated(t)}async getAllByFileType(t){return this.#t.getAllByFileType(t)}async upsertFileHash(t){return await this.#e.upsertFileHash(t)}async updateFileHashesStatus(t,s){return this.#e.updateFileHashes(t,s)}async deleteFileHashes(t){return this.#e.deleteFileHashes(t)}}export{e as FileHashesRepository};
+import{BaseRepository as a}from"../../../providers/database/base-repository.js";import{createDatabaseRepositoryInstance as r,InstanceCacheResolver as i}from"../../../providers/database/instance-cache-resolver.js";import{FileHashesWriteRepository as n}from"./file-hashes-write-repository.js";import{FileHashesReadRepository as l}from"./file-hashes-read-repository.js";class t extends a{static#s=new i(e=>r(e,"file hashes",t));#e;#t;constructor(e){super(e),this.#e=new l(this.databaseClient),this.#t=new n(this.databaseClient)}static async getInstance(e){return t.#s.get(e)}async getByPath(e){return this.#e.getByPath(e)}async getAllOutdated(e){return this.#e.getAllOutdated(e)}async getAllByFileType(e){return this.#e.getAllByFileType(e)}async upsertFileHash(e){return await this.#t.upsertFileHash(e)}async updateFileHashesStatus(e,s){return this.#t.updateFileHashes(e,s)}async deleteFileHashes(e){return this.#t.deleteFileHashes(e)}}export{t as FileHashesRepository};

package/dist/server/persistence/kv/repositories/kv-repository.d.ts

@@ -5,7 +5,7 @@ export declare const KV_KEY_END_BOUNDARY = "\u0002";
 export declare class KvRepository extends BaseRepository {
     #private;
     constructor(dbConnection: DatabaseConnection);
-    static getInstance(options: RepositoryInstanceOptions): Promise<KvRepository | null>;
+    static create(options: RepositoryInstanceOptions): Promise<KvRepository>;
     sync(): Promise<void>;
     get<T extends KvValue = KvValue>(key: KvKey): Promise<T | null>;
     getMany<T extends KvValue = KvValue>(keys: KvKey[]): Promise<(KvListEntry<T> | null)[]>;

package/dist/server/persistence/kv/repositories/kv-repository.js

@@ -1,2 +1,2 @@
-import{eq as K,and as h,gte as u,gt as B,lt as f,asc as S,desc as L,or as w,isNull as b,sql as s,inArray as M,count as N}from"drizzle-orm";import{logger as i}from"../../../tools/notifiers/logger.js";import{kvTable as t}from"../../../providers/database/databases/sqlite-db/schemas/kv-table.js";import{BaseRepository as T}from"../../../providers/database/base-repository.js";import{DatabaseConnectionFactory as $}from"../../../providers/database/database-connection-factory.js";import{createKvValue as D}from"../mappers/create-kv-value.js";import{createKvDbRecord as I,encodeKvKey as l}from"../mappers/create-kv-db-record.js";import{decodeCursor as O}from"../helpers/decode-cursor.js";import{encodeCursor as q}from"../helpers/encode-cursor.js";import{createKvListEntry as E}from"../mappers/create-kv-list-entry.js";const z="";class y extends T{static#e;#t=!1;constructor(e){super(e)}static async getInstance(e){if(!y.#e)try{const r=await $.create(e);if(!r)return y.#e=null,null;y.#e=new y(r)}catch(r){return i.error("Error creating kv remote repository",r),y.#e=null,null}return y.#e}async sync(){if(this.isNonRemoteDatabaseMode()){this.#t||(i.warn(`KV database is currently operating in local mode: not connected to the remote database.
-       All changes and data will only persist locally and will not be synced remotely.`),this.#t=!0);return}await this.databaseClient.sync()}async get(e){try{const r=l(e),n=await this.databaseClient.client.select().from(t).where(h(K(t.encodedKey,r),w(b(t.expiresAt),u(s`datetime(${t.expiresAt})`,s`datetime('now')`)))).get();return n?D(n):null}catch(r){return i.error("Error getting kv entry by key",r),null}}async getMany(e){try{if(e.length===0)return[];const r=e.map(d=>l(d)),n=w(b(t.expiresAt),u(s`datetime(${t.expiresAt})`,s`datetime('now')`)),o=await this.databaseClient.client.select().from(t).where(h(M(t.encodedKey,r),n)).all(),a=new Map(o.map(d=>[d.encodedKey,d]));return e.map((d,C)=>{const g=r[C],x=a.get(g);return x?E(x):null})}catch(r){return i.error("Error getting multiple kv entries",r),[]}}async list(e,r){try{const n=r?.limit??100,o=r?.reverse??!1,a=[],A=w(b(t.expiresAt),u(s`datetime(${t.expiresAt})`,s`datetime('now')`));if(a.push(A),"prefix"in e){const c=l(e.prefix),m="start"in e?l(e.start):c,k="end"in e?l(e.end):c+z;a.push(u(t.encodedKey,m)),a.push(f(t.encodedKey,k))}else if("start"in e&&"end"in e){const c=l(e.start),m=l(e.end);a.push(u(t.encodedKey,c)),a.push(f(t.encodedKey,m))}if(r?.cursor){const c=O(r.cursor),m=o?f(t.encodedKey,c):B(t.encodedKey,c);a.push(m)}const d=this.databaseClient.client.select().from(t),C=a.length>0?d.where(h(...a)):d,g=this.databaseClient.client.select({count:N()}).from(t),v=(await(a.length>0?g.where(h(...a)):g).get())?.count??0,p=await C.orderBy(o?L(t.encodedKey):S(t.encodedKey)).limit(n).all();return{items:p.map(c=>E(c)),total:v,cursor:v>p.length?q(p[p.length-1]?.encodedKey):null}}catch(n){return i.error("Error listing kv entries",n),{items:[],total:0,cursor:null}}}async set(e,r,n){try{const o=I({key:e,value:r,ttlInSeconds:n?.ttlInSeconds});return await this.databaseClient.client.insert(t).values(o).onConflictDoUpdate({target:[t.encodedKey],set:{value:o.value,expiresAt:o.expiresAt,updatedAt:o.updatedAt}}),E(o)}catch(o){return i.error("Error saving kv entry",o),null}}async delete(e){try{const r=l(e);await this.databaseClient.client.delete(t).where(K(t.encodedKey,r))}catch(r){i.error("Error deleting kv entry by key",r)}}async clearExpired(){try{await this.databaseClient.client.delete(t).where(f(s`datetime(${t.expiresAt})`,s`datetime('now')`))}catch(e){i.error("Error clearing expired kv entries",e)}}async transaction(e){return this.databaseClient.transactionsManager.transaction(async()=>e({get:async n=>this.get(n),getMany:async n=>this.getMany(n),set:async(n,o,a)=>this.set(n,o,a),delete:async n=>this.delete(n)}))}async getTotalStoredEntryBytes(){try{return await this.getTableSizeInBytes("kv")}catch(e){return i.error("Error getting total kv stored entry bytes",e),0}}async getStoredEntrySizeByEncodedKey(e){try{const r=w(b(t.expiresAt),u(s`datetime(${t.expiresAt})`,s`datetime('now')`)),n=await this.databaseClient.client.select({bytes:s`COALESCE(LENGTH(CAST(${t.encodedKey} AS BLOB)) + LENGTH(CAST(${t.value} AS BLOB)), 0)`}).from(t).where(h(K(t.encodedKey,e),r)).get();return Number(n?.bytes??0)}catch(r){return i.error("Error getting kv entry size by encoded key",r),0}}}export{z as KV_KEY_END_BOUNDARY,y as KvRepository};
+import{eq as b,and as m,gte as l,gt as B,lt as g,asc as S,desc as R,or as f,isNull as K,sql as o,inArray as L,count as M}from"drizzle-orm";import{logger as C}from"../../../tools/notifiers/logger.js";import{kvTable as e}from"../../../providers/database/databases/sqlite-db/schemas/kv-table.js";import{BaseRepository as N}from"../../../providers/database/base-repository.js";import{createDatabaseRepositoryInstance as T}from"../../../providers/database/instance-cache-resolver.js";import{createKvValue as $}from"../mappers/create-kv-value.js";import{createKvDbRecord as D,encodeKvKey as c}from"../mappers/create-kv-db-record.js";import{decodeCursor as k}from"../helpers/decode-cursor.js";import{encodeCursor as I}from"../helpers/encode-cursor.js";import{createKvListEntry as x}from"../mappers/create-kv-list-entry.js";const O="";class v extends N{#e=!1;constructor(t){super(t)}static create(t){return T(t,"kv",v)}async sync(){if(this.isNonRemoteDatabaseMode()){this.#e||(C.warn(`KV database is currently operating in local mode: not connected to the remote database.
+       All changes and data will only persist locally and will not be synced remotely.`),this.#e=!0);return}await this.databaseClient.sync()}async get(t){const n=c(t),r=await this.databaseClient.client.select().from(e).where(m(b(e.encodedKey,n),f(K(e.expiresAt),l(o`datetime(${e.expiresAt})`,o`datetime('now')`)))).get();return r?$(r):null}async getMany(t){if(t.length===0)return[];const n=t.map(d=>c(d)),r=f(K(e.expiresAt),l(o`datetime(${e.expiresAt})`,o`datetime('now')`)),a=await this.databaseClient.client.select().from(e).where(m(L(e.encodedKey,n),r)).all(),s=new Map(a.map(d=>[d.encodedKey,d]));return t.map((d,p)=>{const w=n[p],y=s.get(w);return y?x(y):null})}async list(t,n){const r=n?.limit??100,a=n?.reverse??!1,s=[],d=f(K(e.expiresAt),l(o`datetime(${e.expiresAt})`,o`datetime('now')`));if(s.push(d),"prefix"in t){const i=c(t.prefix),u="start"in t?c(t.start):i,E="end"in t?c(t.end):i+O;s.push(l(e.encodedKey,u)),s.push(g(e.encodedKey,E))}else if("start"in t&&"end"in t){const i=c(t.start),u=c(t.end);s.push(l(e.encodedKey,i)),s.push(g(e.encodedKey,u))}if(n?.cursor){const i=k(n.cursor),u=a?g(e.encodedKey,i):B(e.encodedKey,i);s.push(u)}const p=this.databaseClient.client.select().from(e),w=s.length>0?p.where(m(...s)):p,y=this.databaseClient.client.select({count:M()}).from(e),A=(await(s.length>0?y.where(m(...s)):y).get())?.count??0,h=await w.orderBy(a?R(e.encodedKey):S(e.encodedKey)).limit(r).all();return{items:h.map(i=>x(i)),total:A,cursor:A>h.length?I(h[h.length-1]?.encodedKey):null}}async set(t,n,r){const a=D({key:t,value:n,ttlInSeconds:r?.ttlInSeconds});return await this.databaseClient.client.insert(e).values(a).onConflictDoUpdate({target:[e.encodedKey],set:{value:a.value,expiresAt:a.expiresAt,updatedAt:a.updatedAt}}),x(a)}async delete(t){const n=c(t);await this.databaseClient.client.delete(e).where(b(e.encodedKey,n))}async clearExpired(){await this.databaseClient.client.delete(e).where(g(o`datetime(${e.expiresAt})`,o`datetime('now')`))}async transaction(t){return this.databaseClient.transactionsManager.transaction(async()=>t({get:async r=>this.get(r),getMany:async r=>this.getMany(r),set:async(r,a,s)=>this.set(r,a,s),delete:async r=>this.delete(r)}))}async getTotalStoredEntryBytes(){try{return await this.getTableSizeInBytes("kv")}catch(t){return C.error("Error getting total kv stored entry bytes",t),0}}async getStoredEntrySizeByEncodedKey(t){try{const n=f(K(e.expiresAt),l(o`datetime(${e.expiresAt})`,o`datetime('now')`)),r=await this.databaseClient.client.select({bytes:o`COALESCE(LENGTH(CAST(${e.encodedKey} AS BLOB)) + LENGTH(CAST(${e.value} AS BLOB)), 0)`}).from(e).where(m(b(e.encodedKey,t),n)).get();return Number(r?.bytes??0)}catch(n){return C.error("Error getting kv entry size by encoded key",n),0}}}export{O as KV_KEY_END_BOUNDARY,v as KvRepository};

package/dist/server/persistence/kv/services/kv-service.d.ts

@@ -1,9 +1,10 @@
 import type { KvValue, KvKey, KvListEntry, KvSetOptions, KvListOptions, KvListResponse, KvListSelector, KvTransaction } from '@redocly/config';
 import type { ServiceInstanceOptions } from '../../../providers/database/types.js';
+import { BaseService } from '../../../providers/database/base-service.js';
 import { KvRepository } from '../repositories/kv-repository.js';
-export declare class KvService {
+export declare class KvService extends BaseService<KvRepository> {
     #private;
-    constructor(repository: KvRepository | null);
+    constructor(repository: KvRepository, options?: ServiceInstanceOptions);
     static getInstance(options: ServiceInstanceOptions): Promise<KvService>;
     /**
      * Get a kv entry by key

package/dist/server/persistence/kv/services/kv-service.js

@@ -1 +1 @@
-import{PLAN_GATES_DEFAULTS as u}from"../../../constants/entitlements.js";import{EntitlementsProvider as d}from"../../../entitlements/entitlements-provider.js";import{StorageLimitValidator as h}from"../../../providers/database/utils/storage-limit-validator.js";import{KvRepository as m}from"../repositories/kv-repository.js";import{encodeKvKey as g}from"../mappers/create-kv-db-record.js";import{kvKeyValidator as a,kvListOptionsValidator as f,kvListSelectorValidator as w,kvSetOptionsValidator as l}from"../schemas/kv-schemas.js";const E=100*1024*1024;class o{static#e;#t;#s;constructor(t){this.#t=t,this.#s=new h}static async#a(t){const e=await m.getInstance(t),s=new o(e);o.#e=s}static async getInstance(t){return o.#e||await o.#a(t),o.#e}async get(t){const e=a.parse(t);return await this.#t?.sync(),await this.#t?.get(e)??null}async getMany(t){if(t.length===0)return[];const e=t.map(s=>a.parse(s));return await this.#t?.sync(),await this.#t?.getMany(e)??[]}async list(t,e){const s=w.parse(t),r=f.parse(e??{});return await this.#t?.sync(),await this.#t?.list(s,r)??{items:[],total:0,cursor:null}}async set(t,e,s){const r=a.parse(t),n=l.parse(s??{});this.#r(e);const i=JSON.stringify(e);return this.#n(i),await this.#i(r,i),await this.#t?.set(r,e,n)??null}async delete(t){const e=a.parse(t);return this.#t?.delete(e)}async clearExpired(){return await this.#t?.clearExpired()}async transaction(t){if(!this.#t)throw new Error("Remote repository not available for transactions");return await this.#t.sync(),this.#t.transaction(async e=>t({get:async r=>{const n=a.parse(r);return e.get(n)},getMany:async r=>{const n=r.map(i=>a.parse(i));return e.getMany(n)},set:async(r,n,i)=>{const c=a.parse(r),p=l.parse(i??{});this.#r(n);const y=JSON.stringify(n);return this.#n(y),await this.#i(c,y),e.set(c,n,p)},delete:async r=>{const n=a.parse(r);return e.delete(n)}}))}#r(t){try{JSON.stringify(t)}catch(e){const s=e instanceof Error?e.message:"Unknown error";throw new Error(`Value is not JSON serializable: ${s}`)}}#n(t){const s=Buffer.byteLength(t,"utf8");if(s>1048576){const r=(s/1024).toFixed(2);throw new Error(`Value size (${r} KB) exceeds the maximum allowed size of 1 MB (1024 KB)`)}}async#i(t,e){if(!this.#t)return;const s=g(t),r=await this.#t.getTotalStoredEntryBytes(),n=Math.max(0,r-E),i=await this.#t.getStoredEntrySizeByEncodedKey(s),c=Buffer.byteLength(s,"utf8")+Buffer.byteLength(e,"utf8");this.#s.validate({storageLimitGb:this.#o(),currentTotalBytes:n,existingEntryBytes:i,incomingEntryBytes:c,errorMessagePrefix:"KV storage limit"})}#o(){const t=d.instance().entitlements?.kvStorageLimit;return typeof t=="number"&&t>0?t:u.pro.kvStorageLimit}}export{o as KvService};
+import{PLAN_GATES_DEFAULTS as g}from"../../../constants/entitlements.js";import{EntitlementsProvider as m}from"../../../entitlements/entitlements-provider.js";import{BaseService as S}from"../../../providers/database/base-service.js";import{InstanceCacheResolver as f}from"../../../providers/database/instance-cache-resolver.js";import{StorageLimitValidator as h}from"../../../providers/database/utils/storage-limit-validator.js";import{KvRepository as p}from"../repositories/kv-repository.js";import{encodeKvKey as E}from"../mappers/create-kv-db-record.js";import{kvKeyValidator as i,kvListOptionsValidator as B,kvListSelectorValidator as w,kvSetOptionsValidator as d}from"../schemas/kv-schemas.js";const k=100*1024*1024;class l extends S{static#n=new f(async t=>new l(await p.create(t),t));#t;constructor(t,e){super(e,{repository:t,createRepository:p.create}),this.#t=new h}static async getInstance(t){return l.#n.get(t)}async get(t){const e=i.parse(t);return this.runRead(r=>r.get(e))}async getMany(t){if(t.length===0)return[];const e=t.map(r=>i.parse(r));return this.runRead(r=>r.getMany(e))}async list(t,e){const r=w.parse(t),s=B.parse(e??{});return this.runRead(n=>n.list(r,s))}async set(t,e,r){const s=i.parse(t),n=d.parse(r??{});this.#e(e);const a=JSON.stringify(e);return this.#r(a),await this.#s(s,a),this.runWrite(o=>o.set(s,e,n))}async delete(t){const e=i.parse(t);await this.runWrite(r=>r.delete(e))}async clearExpired(){await this.runWrite(t=>t.clearExpired())}async transaction(t){return await this.syncRepositoryIfNeeded(),this.getRepository().transaction(async e=>t({get:async s=>{const n=i.parse(s);return e.get(n)},getMany:async s=>{const n=s.map(a=>i.parse(a));return e.getMany(n)},set:async(s,n,a)=>{const o=i.parse(s),c=d.parse(a??{});this.#e(n);const y=JSON.stringify(n);return this.#r(y),await this.#s(o,y,{skipSync:!0}),e.set(o,n,c)},delete:async s=>{const n=i.parse(s);return e.delete(n)}}))}#e(t){try{JSON.stringify(t)}catch(e){const r=e instanceof Error?e.message:"Unknown error";throw new Error(`Value is not JSON serializable: ${r}`)}}#r(t){const r=Buffer.byteLength(t,"utf8");if(r>1048576){const s=(r/1024).toFixed(2);throw new Error(`Value size (${s} KB) exceeds the maximum allowed size of 1 MB (1024 KB)`)}}async#s(t,e,r){const s=E(t),n=await this.runRead(async c=>{const y=await c.getTotalStoredEntryBytes(),u=await c.getStoredEntrySizeByEncodedKey(s);return{currentTotalStoredEntryBytes:y,existingEntryBytes:u}},{onRepositoryMissing:()=>null,skipSync:r?.skipSync??!1});if(!n)return;const a=Math.max(0,n.currentTotalStoredEntryBytes-k),o=Buffer.byteLength(s,"utf8")+Buffer.byteLength(e,"utf8");this.#t.validate({storageLimitGb:this.#a(),currentTotalBytes:a,existingEntryBytes:n.existingEntryBytes,incomingEntryBytes:o,errorMessagePrefix:"KV storage limit"})}#a(){const t=m.instance().entitlements?.kvStorageLimit;return typeof t=="number"&&t>0?t:g.pro.kvStorageLimit}}export{l as KvService};

package/dist/server/plugins/catalog-entities/database/catalog-entities-service.d.ts

@@ -8,10 +8,11 @@ import type { Filter } from '../../../providers/database/pagination/types.js';
 import type { ScorecardsStatus } from '../entities/types.js';
 import type { GetEntityByIdParams } from '../types/params.js';
 import type { BulkSyncResult } from './types.js';
+import { BaseService } from '../../../providers/database/base-service.js';
 import { type EntityDtoSchema, type EntityRelationDtoSchema } from '../schemas/dto-schemas.js';
 import { CatalogEntitiesRepository } from './repositories/catalog-entities-repository.js';
 import { type ListResponseResult } from '../../../web-server/utils/prepare-list-response.js';
-export declare class CatalogEntitiesService {
+export declare class CatalogEntitiesService extends BaseService<CatalogEntitiesRepository> {
     #private;
     constructor(catalogEntitiesRepository: CatalogEntitiesRepository, options?: ServiceInstanceOptions);
     static getInstance(options: ServiceInstanceOptions): Promise<CatalogEntitiesService>;

package/dist/server/plugins/catalog-entities/database/catalog-entities-service.js

@@ -1 +1 @@
-import{promiseMapLimit as h}from"../../../utils/async/promise-map-limit.js";import{logger as g}from"../../../tools/notifiers/logger.js";import{envConfig as y}from"../../../config/env-config.js";import{HTTP_TRANSIENT_RETRY as l,describeTransientError as m,isTransientSqldError as w,withTransientErrorRetry as d}from"../../../providers/database/transient-sqld-error.js";import{CatalogEntitiesRepository as E}from"./repositories/catalog-entities-repository.js";import{prepareListResponse as u}from"../../../web-server/utils/prepare-list-response.js";import{ENTITY_RELATION_FROM_DATABASE as R}from"./mappers/field-transformations.js";import{hasOptionsChanged as W}from"../utils/has-options-changed.js";const p=15;class s{static#s;static#n;#i;#r;#a={};constructor(t,e){this.#i=t,this.#r=e?.databaseType==="local"}static async#c(t){const e=await E.getInstance(t),i=new s(e,t);return s.#s=i,s.#n=t,i}static async getInstance(t){const e={...t,removeExisting:t.removeExisting??!1};return s.#s&&!W(s.#n,e)?s.#s:s.#c(e)}async sync(){await this.#o()}async transaction(...t){return this.#i.transactionsManager.transaction(...t)}async getEntities({paginationParams:t,rbacTeams:e,excludedTypes:i,excludedEntities:n}){return this.#e(async r=>{const{items:a,total:o,hasMore:c}=await r.entitiesRead.getEntities({paginationParams:t,rbacTeams:e,excludedTypes:i,excludedEntities:n});return u({data:a,params:t,totalCount:o,hasMore:c})})}async getEntityById(t,e){return this.#e(async i=>await i.entitiesRead.getEntityById(t,e)??null)}async getEntityKeysAndVersionsBySourceFile(t){return this.#e(e=>e.entitiesRead.getEntityKeysAndVersionsBySourceFile(t))}async getEntitiesCountByTypes(){return this.#e(t=>t.entitiesRead.getEntitiesCountByTypes())}async getCatalogFilters(t){return this.#e(e=>e.filters.getCatalogFilters(t))}async getEntityRelationById(t){return this.#e(async e=>await e.relationsRead.getEntityRelationById(t)??null)}async getEntitiesRelations(t={}){return this.#e(async e=>{const{items:i,total:n,hasMore:r}=await e.relationsRead.getEntitiesRelations(t);return u({data:i,params:t,totalCount:n,nameTransformationsFromDatabase:R,hasMore:r})})}async getEntitiesWithRelations({paginationParams:t,rbacTeams:e,excludedTypes:i,excludedEntities:n}){return this.#e(async r=>{const{items:a,total:o,hasMore:c}=await r.bffEntitiesRead.getEntitiesWithRelations({paginationParams:t,rbacTeams:e,excludedTypes:i,excludedEntities:n});return u({data:a,params:t,totalCount:o,hasMore:c})})}async getEntityWithRelationsByKey({entityKey:t,filter:e,rbacTeams:i,excludedTypes:n,excludedEntities:r}){return this.#e(a=>a.bffEntitiesRead.getEntityWithRelationsByKey({entityKey:t,filter:e,rbacTeams:i,excludedTypes:n,excludedEntities:r}))}async getRelatedEntities({entityKey:t,paginationParams:e,rbacTeams:i,excludedTypes:n,excludedEntities:r}){return this.#e(async a=>{const{items:o,total:c,hasMore:f}=await a.relationsRead.getRelatedEntities({key:t,paginationParams:e,rbacTeams:i,excludedTypes:n,excludedEntities:r});return u({data:o,params:e,totalCount:c,nameTransformationsFromDatabase:R,hasMore:f})})}async listEntityRevisions(t,e){return this.#e(i=>i.revisions.listEntityRevisions(t,e))}async getOutdatedEntities(t){return this.#e(e=>e.entitiesRead.getOutdatedEntities(t))}async getEntitiesCount(t,e,i){return this.#e(n=>n.entitiesRead.getEntitiesCount(t,e,i))}async createEntity(t){if(y.isDevelopMode&&t.source==="remote")throw new Error("API based entity creation is not supported in the develop mode");return t.isRootEntity&&t.sourceFile&&(this.#a[t.sourceFile]={key:t.entity.key,version:t.entity.version??void 0}),this.#t(e=>e.entitiesWrite.createEntity(t))}async createEntities(t,e){if(y.isDevelopMode&&e==="remote")throw new Error("API based entity creation is not supported in the develop mode");return await h(t,p,async i=>this.#t(n=>n.entitiesWrite.createEntity({entity:i,source:e})).then(n=>({status:"ok",resource:n})).catch(n=>({key:i.key,status:"error",error:n})))}getEntitySources(){return this.#a}async createEntityRelations(t){await this.#t(e=>e.relationsWrite.createEntityRelations(t))}async updateEntity(t,e){if(y.isDevelopMode&&e.source==="remote")throw new Error("Entity update is not supported in the develop mode");return this.#t(i=>i.transactionsManager.transaction(()=>i.entitiesWrite.updateEntity(t,e)))}async deleteEntity(t){if(y.isDevelopMode&&t.source==="remote")throw new Error("Entity deletion is not supported in the develop mode");return this.#t(e=>e.entitiesWrite.deleteEntity(t))}async deleteEntities(t){await this.#t(async e=>{await e.entitiesWrite.deleteEntities(t)})}async createEntityRelation(t){return this.#t(e=>e.relationsWrite.createEntityRelation(t))}async createEntitiesRelations(t){return await h(t,p,async e=>this.#t(i=>i.relationsWrite.createEntityRelation(e)).then(i=>({status:"ok",resource:i})).catch(i=>({key:e.sourceKey,status:"error",error:i})))}async updateEntityRelation(t,e){const i={...e,...t,type:t.type??e.type};return this.#t(n=>n.relationsWrite.createEntityRelation(i))}async deleteEntityRelation(t){return this.#t(e=>e.relationsWrite.deleteEntityRelation(t))}async softDeleteEntitiesWithRelations({filter:t,revision:e,fileHash:i}){return this.#t(n=>n.entitiesWrite.softDeleteEntitiesWithRelations({filter:t,revision:e,fileHash:i}))}async updateEntityScorecardsStatus(t,e){return this.#t(i=>i.entitiesWrite.updateEntityScorecardsStatus(t,e))}async updateEntityScorecardsStatusIfCalculating(t,e){return this.#t(i=>i.entitiesWrite.updateEntityScorecardsStatusIfCalculating(t,e))}async setEntitiesAsOutdated(t){await this.#t(async e=>{await e.entitiesWrite.setEntitiesAsOutdated(t)})}async#o(){if(this.#r)return;const t=this.#i;await d(()=>t.sync(),l)}async#e(t){return await this.#o(),d(()=>t(this.#i),l)}async#t(t){return this.#r?t(this.#i):d(async()=>{try{return await t(this.#i)}catch(e){throw await this.#y(e),e}},l)}async#y(t){if(!(!w(t)||!s.#n))try{this.#i=await E.recreateInstance(s.#n)}catch(e){g.warn(`Reconnect attempt failed, letting original error propagate: ${m(e)}`)}}}export{s as CatalogEntitiesService};
+import{promiseMapLimit as d}from"../../../utils/async/promise-map-limit.js";import{envConfig as u}from"../../../config/env-config.js";import{BaseService as p}from"../../../providers/database/base-service.js";import{InstanceCacheResolver as W}from"../../../providers/database/instance-cache-resolver.js";import{CatalogEntitiesRepository as l}from"./repositories/catalog-entities-repository.js";import{prepareListResponse as y}from"../../../web-server/utils/prepare-list-response.js";import{ENTITY_RELATION_FROM_DATABASE as E}from"./mappers/field-transformations.js";const R=15;class c extends p{static#e=new W(async t=>new c(await l.create(t),t));#t={};constructor(t,e){super(e,{repository:t,createRepository:l.create})}static async getInstance(t){return c.#e.get(t)}async sync(){await this.syncRepositoryIfNeeded()}async transaction(...t){return this.getRepository().transactionsManager.transaction(...t)}async getEntities({paginationParams:t,rbacTeams:e,excludedTypes:i,excludedEntities:n}){return this.runRead(async s=>{const{items:r,total:a,hasMore:o}=await s.entitiesRead.getEntities({paginationParams:t,rbacTeams:e,excludedTypes:i,excludedEntities:n});return y({data:r,params:t,totalCount:a,hasMore:o})})}async getEntityById(t,e){return this.runRead(async i=>await i.entitiesRead.getEntityById(t,e)??null)}async getEntityKeysAndVersionsBySourceFile(t){return this.runRead(e=>e.entitiesRead.getEntityKeysAndVersionsBySourceFile(t))}async getEntitiesCountByTypes(){return this.runRead(t=>t.entitiesRead.getEntitiesCountByTypes())}async getCatalogFilters(t){return this.runRead(e=>e.filters.getCatalogFilters(t))}async getEntityRelationById(t){return this.runRead(async e=>await e.relationsRead.getEntityRelationById(t)??null)}async getEntitiesRelations(t={}){return this.runRead(async e=>{const{items:i,total:n,hasMore:s}=await e.relationsRead.getEntitiesRelations(t);return y({data:i,params:t,totalCount:n,nameTransformationsFromDatabase:E,hasMore:s})})}async getEntitiesWithRelations({paginationParams:t,rbacTeams:e,excludedTypes:i,excludedEntities:n}){return this.runRead(async s=>{const{items:r,total:a,hasMore:o}=await s.bffEntitiesRead.getEntitiesWithRelations({paginationParams:t,rbacTeams:e,excludedTypes:i,excludedEntities:n});return y({data:r,params:t,totalCount:a,hasMore:o})})}async getEntityWithRelationsByKey({entityKey:t,filter:e,rbacTeams:i,excludedTypes:n,excludedEntities:s}){return this.runRead(r=>r.bffEntitiesRead.getEntityWithRelationsByKey({entityKey:t,filter:e,rbacTeams:i,excludedTypes:n,excludedEntities:s}))}async getRelatedEntities({entityKey:t,paginationParams:e,rbacTeams:i,excludedTypes:n,excludedEntities:s}){return this.runRead(async r=>{const{items:a,total:o,hasMore:h}=await r.relationsRead.getRelatedEntities({key:t,paginationParams:e,rbacTeams:i,excludedTypes:n,excludedEntities:s});return y({data:a,params:e,totalCount:o,nameTransformationsFromDatabase:E,hasMore:h})})}async listEntityRevisions(t,e){return this.runRead(i=>i.revisions.listEntityRevisions(t,e))}async getOutdatedEntities(t){return this.runRead(e=>e.entitiesRead.getOutdatedEntities(t))}async getEntitiesCount(t,e,i){return this.runRead(n=>n.entitiesRead.getEntitiesCount(t,e,i))}async createEntity(t){if(u.isDevelopMode&&t.source==="remote")throw new Error("API based entity creation is not supported in the develop mode");return t.isRootEntity&&t.sourceFile&&(this.#t[t.sourceFile]={key:t.entity.key,version:t.entity.version??void 0}),this.runWrite(e=>e.entitiesWrite.createEntity(t))}async createEntities(t,e){if(u.isDevelopMode&&e==="remote")throw new Error("API based entity creation is not supported in the develop mode");return await d(t,R,async i=>this.runWrite(n=>n.entitiesWrite.createEntity({entity:i,source:e})).then(n=>({status:"ok",resource:n})).catch(n=>({key:i.key,status:"error",error:n})))}getEntitySources(){return this.#t}async createEntityRelations(t){await this.runWrite(e=>e.relationsWrite.createEntityRelations(t))}async updateEntity(t,e){if(u.isDevelopMode&&e.source==="remote")throw new Error("Entity update is not supported in the develop mode");return this.runWrite(i=>i.transactionsManager.transaction(()=>i.entitiesWrite.updateEntity(t,e)))}async deleteEntity(t){if(u.isDevelopMode&&t.source==="remote")throw new Error("Entity deletion is not supported in the develop mode");return this.runWrite(e=>e.entitiesWrite.deleteEntity(t))}async deleteEntities(t){await this.runWrite(async e=>{await e.entitiesWrite.deleteEntities(t)})}async createEntityRelation(t){return this.runWrite(e=>e.relationsWrite.createEntityRelation(t))}async createEntitiesRelations(t){return await d(t,R,async e=>this.runWrite(i=>i.relationsWrite.createEntityRelation(e)).then(i=>({status:"ok",resource:i})).catch(i=>({key:e.sourceKey,status:"error",error:i})))}async updateEntityRelation(t,e){const i={...e,...t,type:t.type??e.type};return this.runWrite(n=>n.relationsWrite.createEntityRelation(i))}async deleteEntityRelation(t){return this.runWrite(e=>e.relationsWrite.deleteEntityRelation(t))}async softDeleteEntitiesWithRelations({filter:t,revision:e,fileHash:i}){return this.runWrite(n=>n.entitiesWrite.softDeleteEntitiesWithRelations({filter:t,revision:e,fileHash:i}))}async updateEntityScorecardsStatus(t,e){return this.runWrite(i=>i.entitiesWrite.updateEntityScorecardsStatus(t,e))}async updateEntityScorecardsStatusIfCalculating(t,e){return this.runWrite(i=>i.entitiesWrite.updateEntityScorecardsStatusIfCalculating(t,e))}async setEntitiesAsOutdated(t){await this.runWrite(async e=>{await e.entitiesWrite.setEntitiesAsOutdated(t)})}}export{c as CatalogEntitiesService};

package/dist/server/plugins/catalog-entities/database/repositories/catalog-entities-repository.d.ts

@@ -8,7 +8,6 @@ import { EntitiesWriteRepository } from './entities/entities-write-repository.js
 import { RelationsWriteRepository } from './relations/relations-write-repository.js';
 import { FiltersRepository } from './common/filters-repository.js';
 export declare class CatalogEntitiesRepository extends BaseRepository {
-    #private;
     readonly entitiesRead: EntitiesReadRepository;
     readonly entitiesWrite: EntitiesWriteRepository;
     readonly relationsRead: RelationsReadRepository;
@@ -19,8 +18,6 @@ export declare class CatalogEntitiesRepository extends BaseRepository {
     get transactionsManager(): import("../../../../providers/database/transactions-manager.js").TransactionsManager;
     constructor(dbConnection: DatabaseConnection);
     sync(): Promise<void>;
-    static getInstance(options: RepositoryInstanceOptions): Promise<CatalogEntitiesRepository>;
-    static recreateInstance(options: RepositoryInstanceOptions): Promise<CatalogEntitiesRepository>;
-    static resetInstance(): Promise<void>;
+    static create(options: RepositoryInstanceOptions): Promise<CatalogEntitiesRepository>;
 }
 //# sourceMappingURL=catalog-entities-repository.d.ts.map

package/dist/server/plugins/catalog-entities/database/repositories/catalog-entities-repository.js

@@ -1 +1 @@
-import{logger as n}from"../../../../tools/notifiers/logger.js";import{telemetryTraceStep as s}from"../../../../telemetry/helpers/trace-step.js";import{BaseRepository as a}from"../../../../providers/database/base-repository.js";import{DatabaseConnectionFactory as c}from"../../../../providers/database/database-connection-factory.js";import{RelationsReadRepository as o}from"./relations/relations-read-repository.js";import{RevisionRepository as f}from"./common/revision-repository.js";import{BffEntitiesReadRepository as m}from"./bffEntities/bff-entities-read-repository.js";import{EntitiesReadRepository as l}from"./entities/entities-read-repository.js";import{EntitiesWriteRepository as p}from"./entities/entities-write-repository.js";import{RelationsWriteRepository as w}from"./relations/relations-write-repository.js";import{FiltersRepository as h}from"./common/filters-repository.js";class e extends a{static#t;entitiesRead;entitiesWrite;relationsRead;relationsWrite;bffEntitiesRead;filters;revisions;get transactionsManager(){return this.databaseClient.transactionsManager}constructor(t){super(t),this.revisions=new f(t.client),this.bffEntitiesRead=new m(t.client),this.relationsRead=new o(t.client),this.entitiesRead=new l(t.client),this.entitiesWrite=new p(t.client,this.organizationId,this.projectId),this.relationsWrite=new w(t.client,this.organizationId,this.projectId),this.filters=new h(t.client)}async sync(){return s("catalog_entities.repository.sync",async()=>{await this.databaseClient.sync()})}static async#e(t){const r=await c.create(t);if(!r)throw new Error("Failed to create db connection for catalog entities repository");return new e(r)}static async getInstance(t){return await s("catalog_entities.repository.get_instance",async r=>{if(e.#t)return e.#t;try{return e.#t=await e.#e(t),e.#t}catch(i){throw n.error("Error creating db connection for catalog entities repository",i),r?.error(i),e.#t=null,i}})}static async recreateInstance(t){const r=e.#t,i=await e.#e(t);return e.#t=i,r&&await r.close(),i}static async resetInstance(){const t=e.#t;e.#t=null,t&&await t.close()}}export{e as CatalogEntitiesRepository};
+import{logger as o}from"../../../../tools/notifiers/logger.js";import{telemetryTraceStep as i}from"../../../../telemetry/helpers/trace-step.js";import{BaseRepository as a}from"../../../../providers/database/base-repository.js";import{createDatabaseRepositoryInstance as n}from"../../../../providers/database/instance-cache-resolver.js";import{RelationsReadRepository as c}from"./relations/relations-read-repository.js";import{RevisionRepository as p}from"./common/revision-repository.js";import{BffEntitiesReadRepository as l}from"./bffEntities/bff-entities-read-repository.js";import{EntitiesReadRepository as m}from"./entities/entities-read-repository.js";import{EntitiesWriteRepository as y}from"./entities/entities-write-repository.js";import{RelationsWriteRepository as R}from"./relations/relations-write-repository.js";import{FiltersRepository as f}from"./common/filters-repository.js";class r extends a{entitiesRead;entitiesWrite;relationsRead;relationsWrite;bffEntitiesRead;filters;revisions;get transactionsManager(){return this.databaseClient.transactionsManager}constructor(t){super(t),this.revisions=new p(t.client),this.bffEntitiesRead=new l(t.client),this.relationsRead=new c(t.client),this.entitiesRead=new m(t.client),this.entitiesWrite=new y(t.client,this.organizationId,this.projectId),this.relationsWrite=new R(t.client,this.organizationId,this.projectId),this.filters=new f(t.client)}async sync(){return i("catalog_entities.repository.sync",async()=>{await this.databaseClient.sync()})}static async create(t){return await i("catalog_entities.repository.get_instance",async s=>{try{return await n(t,"catalog entities",r)}catch(e){throw o.error("Error creating db connection for catalog entities repository",e),s?.error(e),e}})}}export{r as CatalogEntitiesRepository};