@redocly/config 0.40.0 → 0.41.1

package/lib/scorecards-config-schema.js

@@ -0,0 +1,240 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scorecardsConfigSchema = exports.scorecardSchema = void 0;
+const operatorSchema = {
+    type: 'string',
+    enum: [
+        'eq',
+        'in',
+        'gt',
+        'gte',
+        'lt',
+        'lte',
+        'contains',
+        'startsWith',
+        'endsWith',
+        'exists',
+        'isEmpty',
+        'between',
+        'matches',
+        'some',
+        'every',
+        'none',
+        'and',
+        'or',
+        'not',
+    ],
+};
+// Base condition schema with field, operator, value, and match properties
+const conditionSchema = {
+    type: 'object',
+    properties: {
+        field: { type: 'string' },
+        operator: operatorSchema,
+        value: {
+            oneOf: [{ type: 'boolean' }, { type: 'string' }, { type: 'number' }],
+        },
+        match: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    field: { type: 'string' },
+                    operator: operatorSchema,
+                    value: {
+                        oneOf: [{ type: 'boolean' }, { type: 'string' }, { type: 'number' }],
+                    },
+                },
+            },
+        },
+    },
+};
+// Schema for a logical operator with conditions (used for nesting)
+const logicalOperatorConditionSchema = {
+    type: 'object',
+    properties: {
+        operator: operatorSchema,
+        conditions: {
+            type: 'array',
+            items: conditionSchema, // At the deepest level, only simple conditions
+        },
+    },
+    required: ['operator', 'conditions'],
+    additionalProperties: false,
+};
+// Conditions schema allowing nested conditions with up to 2 levels of recursion
+const conditionsSchema = {
+    type: 'array',
+    items: {
+        oneOf: [
+            conditionSchema,
+            {
+                type: 'object',
+                properties: {
+                    operator: operatorSchema,
+                    conditions: {
+                        type: 'array',
+                        items: {
+                            oneOf: [conditionSchema, logicalOperatorConditionSchema],
+                        },
+                    },
+                },
+                required: ['operator', 'conditions'],
+                additionalProperties: false,
+            },
+        ],
+    },
+};
+const entityRuleAssertionSchema = {
+    type: 'object',
+    properties: {
+        defined: { type: 'boolean' },
+        nonEmpty: { type: 'boolean' },
+        eq: {},
+        gt: { type: 'number' },
+        gte: { type: 'number' },
+        lt: { type: 'number' },
+        lte: { type: 'number' },
+        const: {},
+    },
+    additionalProperties: false,
+};
+const entityRuleWhereSchema = {
+    type: 'array',
+    items: {
+        type: 'object',
+        properties: {
+            subject: {
+                type: 'object',
+                properties: {
+                    type: {
+                        type: 'string',
+                        enum: ['Entity', 'EntityMetadata', 'EntityRelations', 'EntityRelation'],
+                    },
+                    property: { type: 'string' },
+                },
+                required: ['type', 'property'],
+                additionalProperties: false,
+            },
+            assertions: entityRuleAssertionSchema,
+        },
+        required: ['subject', 'assertions'],
+        additionalProperties: false,
+    },
+};
+const entityRuleSchema = {
+    type: 'object',
+    properties: {
+        title: { type: 'string' },
+        subject: {
+            type: 'object',
+            properties: {
+                type: {
+                    type: 'string',
+                    enum: ['Entity', 'EntityMetadata', 'EntityRelations', 'EntityRelation'],
+                },
+                property: { type: 'string' },
+            },
+            required: ['type', 'property'],
+            additionalProperties: false,
+        },
+        severity: {
+            type: 'string',
+            enum: ['error', 'warn', 'off'],
+        },
+        message: { type: 'string' },
+        assertions: entityRuleAssertionSchema,
+        where: entityRuleWhereSchema,
+        weight: { type: 'number', default: 1 },
+    },
+    required: ['subject', 'assertions'],
+    additionalProperties: false,
+};
+// Supports both OpenAPI/AsyncAPI rules (backward compatibility) and entity rules
+const levelRulesSchema = {
+    type: 'object',
+    additionalProperties: {
+        oneOf: [
+            { type: 'string' },
+            {
+                type: 'object',
+                properties: {
+                    severity: {
+                        type: 'string',
+                        enum: ['error', 'warn', 'off'],
+                    },
+                    weight: { type: 'number', default: 1 },
+                },
+                additionalProperties: true,
+            },
+            entityRuleSchema,
+        ],
+    },
+};
+const levelSchema = {
+    type: 'object',
+    properties: {
+        name: { type: 'string' },
+        extends: {
+            type: 'array',
+            items: { type: 'string' },
+        },
+        rules: levelRulesSchema,
+    },
+    required: ['name'],
+    additionalProperties: false,
+};
+const triggerEventSchema = {
+    type: 'object',
+    properties: {
+        event: {
+            type: 'string',
+            enum: ['runtime', 'manual'],
+        },
+    },
+    required: ['event'],
+    additionalProperties: false,
+};
+const triggerSchema = {
+    oneOf: [
+        triggerEventSchema,
+        {
+            type: 'array',
+            items: triggerEventSchema,
+        },
+    ],
+};
+exports.scorecardSchema = {
+    type: 'object',
+    properties: {
+        name: { type: 'string' },
+        description: { type: 'string' },
+        entities: {
+            oneOf: [
+                conditionsSchema,
+                {
+                    type: 'object',
+                    properties: {
+                        operator: operatorSchema,
+                        conditions: conditionsSchema,
+                    },
+                    required: ['operator', 'conditions'],
+                    additionalProperties: false,
+                },
+            ],
+        },
+        levels: {
+            type: 'array',
+            items: levelSchema,
+            minItems: 1,
+        },
+        trigger: triggerSchema,
+    },
+    required: ['name', 'entities', 'levels'],
+    additionalProperties: false,
+};
+exports.scorecardsConfigSchema = {
+    type: 'array',
+    items: exports.scorecardSchema,
+};
+//# sourceMappingURL=scorecards-config-schema.js.map

package/lib/types/api-functions-types.d.ts

@@ -30,7 +30,7 @@ export type ApiFunctionsContext = {
     params: Record<string, string | string[]>;
     query: Record<string, string | string[]>;
     cookies: Record<string, string>;
-    getStorage: () => Promise<KvService>;
+    getKv: () => Promise<KvService>;
     /**
      * @deprecated `telemetry` is deprecated.
      */
@@ -41,12 +41,11 @@ export type ApiFunctionsContext = {
     };
 } & ApiFunctionsContextMethods;
 export type KvService = {
-    get: <T extends KvValue = KvValue>(key: KvKey) => Promise<KvReadSchema<T> | null>;
-    getMany: <T extends KvValue = KvValue>(keys: KvKey[]) => Promise<(KvReadSchema<T> | null)[]>;
+    get: <T extends KvValue = KvValue>(key: KvKey) => Promise<T | null>;
+    getMany: <T extends KvValue = KvValue>(keys: KvKey[]) => Promise<(KvListEntry<T> | null)[]>;
     list: <T extends KvValue = KvValue>(selector: KvListSelector, options?: KvListOptions) => Promise<KvListResponse<T>>;
-    set: <T extends KvValue = KvValue>(key: KvKey, value: T, options?: KvSetOptions) => Promise<string | null>;
-    delete: (key: KvKey) => Promise<boolean>;
-    clearExpired: () => Promise<void>;
+    set: <T extends KvValue = KvValue>(key: KvKey, value: T, options?: KvSetOptions) => Promise<KvListEntry<T> | null>;
+    delete: (key: KvKey) => Promise<void>;
     transaction: <T>(operation: (tx: KvTransaction) => Promise<T>) => Promise<T>;
 };
 export type KvValue = Record<string, unknown> | unknown[] | unknown;
@@ -55,7 +54,7 @@ export type KvKey = KvKeyPart[];
 export type KvSetOptions = {
     ttlInSeconds?: number;
 };
-export type KvReadSchema<T extends KvValue = KvValue> = {
+export type KvListEntry<T extends KvValue = KvValue> = {
     key: KvKey;
     value: T | null;
 };
@@ -77,15 +76,15 @@ export type KvListOptions = {
     cursor?: string;
 };
 export type KvListResponse<T extends KvValue = KvValue> = {
-    items: KvReadSchema<T>[];
+    items: KvListEntry<T>[];
     total: number;
     cursor: string | null;
 };
 export type KvTransaction = {
-    get: <T extends KvValue = KvValue>(key: KvKey) => Promise<KvReadSchema<T> | null>;
-    getMany: <T extends KvValue = KvValue>(keys: KvKey[]) => Promise<(KvReadSchema<T> | null)[]>;
-    set: <T extends KvValue = KvValue>(key: KvKey, value: T, options?: KvSetOptions) => Promise<string | null>;
-    delete: (key: KvKey) => Promise<boolean>;
+    get: <T extends KvValue = KvValue>(key: KvKey) => Promise<T | null>;
+    getMany: <T extends KvValue = KvValue>(keys: KvKey[]) => Promise<(KvListEntry<T> | null)[]>;
+    set: <T extends KvValue = KvValue>(key: KvKey, value: T, options?: KvSetOptions) => Promise<KvListEntry<T> | null>;
+    delete: (key: KvKey) => Promise<void>;
 };
 export type ApiRoutesHandler = (request: Request, context: ApiFunctionsContext, 
 /**
@@ -102,4 +101,4 @@ export interface CookieOptions {
     signed?: boolean;
     sameSite?: 'Strict' | 'Lax' | 'None';
 }
-export type ServerPropsContext = Omit<ApiFunctionsContext, 'getStorage'>;
+export type ServerPropsContext = Omit<ApiFunctionsContext, 'getKv'>;

package/lib/types/config-types.d.ts

@@ -1,10 +1,11 @@
 import type { FromSchema } from 'json-schema-to-ts';
 import type { themeConfigSchema } from '../default-theme-config-schema';
 import type { productConfigOverrideSchema } from '../product-override-schema';
-import type { apiConfigSchema, apigeeAdapterAuthOauth2Schema, apigeeAdapterAuthServiceAccountSchema, apigeeEdgeAdapterConfigSchema, apigeeXAdapterConfigSchema, authProviderConfigSchema, devOnboardingAdapterConfigSchema, graviteeAdapterConfigSchema, l10nConfigSchema, oidcIssuerMetadataSchema, oidcProviderConfigSchema, rbacConfigSchema, rbacScopeItemsSchema, redirectConfigSchema, redirectsConfigSchema, rootRedoclyConfigSchema, saml2ProviderConfigSchema, seoConfigSchema, ssoDirectConfigSchema } from '../root-config-schema';
+import type { apiConfigSchema, apigeeAdapterAuthOauth2Schema, apigeeAdapterAuthServiceAccountSchema, apigeeEdgeAdapterConfigSchema, apigeeXAdapterConfigSchema, authProviderConfigSchema, devOnboardingAdapterConfigSchema, graviteeAdapterConfigSchema, l10nConfigSchema, oidcIssuerMetadataSchema, oidcProviderConfigSchema, rbacConfigSchema, rbacScopeItemsSchema, redirectConfigSchema, redirectsConfigSchema, rootRedoclyConfigSchema, bannerConfigSchema, bannersConfigSchema, saml2ProviderConfigSchema, seoConfigSchema, ssoDirectConfigSchema } from '../root-config-schema';
 import type { RedocConfigTypes } from './redoc-types';
 import type { GraphQLConfigTypes } from './graphql-types';
-import type { productConfigSchema, productGoogleAnalyticsConfigSchema, markdownConfigSchema, amplitudeAnalyticsConfigSchema, rudderstackAnalyticsConfigSchema, segmentAnalyticsConfigSchema, gtmAnalyticsConfigSchema, googleAnalyticsConfigSchema, scorecardConfigSchema, scorecardsConfigSchema, catalogFilterSchema, catalogSchema, searchFacetsConfigSchema } from '../ex-theme-config-schemas';
+import type { productConfigSchema, productGoogleAnalyticsConfigSchema, markdownConfigSchema, amplitudeAnalyticsConfigSchema, rudderstackAnalyticsConfigSchema, segmentAnalyticsConfigSchema, gtmAnalyticsConfigSchema, googleAnalyticsConfigSchema, scorecardConfigSchema, catalogFilterSchema, catalogSchema, searchFacetsConfigSchema } from '../ex-theme-config-schemas';
+import type { scorecardsConfigSchema } from '../scorecards-config-schema';
 import type { reuniteConfigSchema } from '../reunite-config-schema';
 import type { optionalEmailSettings, reasonsSettings } from '../feedback-config-schema';
 /**
@@ -38,6 +39,8 @@ export type RedoclyConfig = Omit<FromSchema<typeof rootRedoclyConfigSchema>, 'th
 };
 export type RedirectConfig = FromSchema<typeof redirectConfigSchema>;
 export type RedirectsConfig = FromSchema<typeof redirectsConfigSchema>;
+export type BannerConfig = FromSchema<typeof bannerConfigSchema>;
+export type BannersConfig = FromSchema<typeof bannersConfigSchema>;
 export type AuthProviderConfig = FromSchema<typeof authProviderConfigSchema>;
 export type OidcProviderConfig = FromSchema<typeof oidcProviderConfigSchema>;
 export type Saml2ProviderConfig = FromSchema<typeof saml2ProviderConfigSchema>;

package/lib/types/portal-shared-types.d.ts

@@ -3,7 +3,7 @@ import type { LayoutVariant, REDOCLY_ROUTE_RBAC, REDOCLY_TEAMS_RBAC } from '../c
 import type { ProductConfig, ProductGoogleAnalyticsConfig, RbacScopeItems, RedoclyConfig, SeoConfig } from './config-types';
 import type { CatalogEntityConfig } from './catalog-entity-types';
 export * from './code-walkthrough-types';
-export type UiAccessibleConfig = Pick<RedoclyConfig, 'logo' | 'navbar' | 'products' | 'footer' | 'sidebar' | 'scripts' | 'links' | 'feedback' | 'search' | 'aiAssistant' | 'colorMode' | 'navigation' | 'codeSnippet' | 'markdown' | 'openapi' | 'graphql' | 'analytics' | 'userMenu' | 'versionPicker' | 'breadcrumbs' | 'catalog' | 'scorecard' | 'scorecards' | 'scorecardClassic' | 'entitiesCatalog' | 'mcp'> & {
+export type UiAccessibleConfig = Pick<RedoclyConfig, 'logo' | 'navbar' | 'products' | 'footer' | 'sidebar' | 'scripts' | 'links' | 'feedback' | 'search' | 'aiAssistant' | 'colorMode' | 'navigation' | 'codeSnippet' | 'markdown' | 'openapi' | 'graphql' | 'analytics' | 'userMenu' | 'versionPicker' | 'breadcrumbs' | 'catalog' | 'scorecard' | 'scorecards' | 'scorecardClassic' | 'entitiesCatalog' | 'mcp' | 'banner'> & {
     auth?: {
         idpsInfo?: {
             idpId: string;

package/lib-esm/common.d.ts

@@ -8,10 +8,10 @@ export declare const rulesSchema: {
         }];
     };
 };
-export declare const ruleTypes: readonly ["rules", "oas2Rules", "oas3_0Rules", "oas3_1Rules", "oas3_2Rules", "async2Rules", "async3Rules", "arazzo1Rules", "overlay1Rules"];
+export declare const ruleTypes: readonly ["rules", "oas2Rules", "oas3_0Rules", "oas3_1Rules", "oas3_2Rules", "async2Rules", "async3Rules", "arazzo1Rules", "overlay1Rules", "openrpc1Rules"];
 export type RuleTypes = (typeof ruleTypes)[number];
 export declare const ruleSchemas: Record<RuleTypes, typeof rulesSchema>;
-export declare const preprocessorTypes: readonly ["preprocessors", "oas2Preprocessors", "oas3_0Preprocessors", "oas3_1Preprocessors", "oas3_2Preprocessors", "async2Preprocessors", "async3Preprocessors", "arazzo1Preprocessors", "overlay1Preprocessors"];
+export declare const preprocessorTypes: readonly ["preprocessors", "oas2Preprocessors", "oas3_0Preprocessors", "oas3_1Preprocessors", "oas3_2Preprocessors", "async2Preprocessors", "async3Preprocessors", "arazzo1Preprocessors", "overlay1Preprocessors", "openrpc1Preprocessors"];
 export type PreprocessorTypes = (typeof preprocessorTypes)[number];
 declare const preprocessorSchema: {
     readonly type: "object";
@@ -22,7 +22,7 @@ export declare const decoratorsSchema: {
     readonly type: "object";
     readonly additionalProperties: true;
 };
-export declare const decoratorTypes: readonly ["decorators", "oas2Decorators", "oas3_0Decorators", "oas3_1Decorators", "oas3_2Decorators", "async2Decorators", "async3Decorators", "arazzo1Decorators", "overlay1Decorators"];
+export declare const decoratorTypes: readonly ["decorators", "oas2Decorators", "oas3_0Decorators", "oas3_1Decorators", "oas3_2Decorators", "async2Decorators", "async3Decorators", "arazzo1Decorators", "overlay1Decorators", "openrpc1Decorators"];
 export type DecoratorTypes = (typeof decoratorTypes)[number];
 export declare const decoratorsSchemas: Record<DecoratorTypes, typeof decoratorsSchema>;
 export {};

package/lib-esm/common.js

@@ -14,6 +14,7 @@ export const ruleTypes = [
     'async3Rules',
     'arazzo1Rules',
     'overlay1Rules',
+    'openrpc1Rules',
 ];
 export const ruleSchemas = {
     rules: rulesSchema,
@@ -25,6 +26,7 @@ export const ruleSchemas = {
     async3Rules: rulesSchema,
     arazzo1Rules: rulesSchema,
     overlay1Rules: rulesSchema,
+    openrpc1Rules: rulesSchema,
 };
 export const preprocessorTypes = [
     'preprocessors',
@@ -36,6 +38,7 @@ export const preprocessorTypes = [
     'async3Preprocessors',
     'arazzo1Preprocessors',
     'overlay1Preprocessors',
+    'openrpc1Preprocessors',
 ];
 const preprocessorSchema = {
     type: 'object',
@@ -51,6 +54,7 @@ export const preprocessorSchemas = {
     async3Preprocessors: preprocessorSchema,
     arazzo1Preprocessors: preprocessorSchema,
     overlay1Preprocessors: preprocessorSchema,
+    openrpc1Preprocessors: preprocessorSchema,
 };
 export const decoratorsSchema = {
     type: 'object',
@@ -66,6 +70,7 @@ export const decoratorTypes = [
     'async3Decorators',
     'arazzo1Decorators',
     'overlay1Decorators',
+    'openrpc1Decorators',
 ];
 export const decoratorsSchemas = {
     decorators: decoratorsSchema,
@@ -77,5 +82,6 @@ export const decoratorsSchemas = {
     async3Decorators: decoratorsSchema,
     arazzo1Decorators: decoratorsSchema,
     overlay1Decorators: decoratorsSchema,
+    openrpc1Decorators: decoratorsSchema,
 };
 //# sourceMappingURL=common.js.map