chore: add lintEntityFile method

Author: kamil1094

packages/core/src/index.ts

@@ -106,7 +106,14 @@ export {
 } from './walk.js';
 export { getAstNodeByPointer, getLineColLocation, getCodeframe } from './format/codeframes.js';
 export { formatProblems, getTotals, type OutputFormat, type Totals } from './format/format.js';
-export { lint, lint as validate, lintDocument, lintFromString, lintConfig } from './lint.js';
+export {
+  lint,
+  lint as validate,
+  lintDocument,
+  lintFromString,
+  lintConfig,
+  lintEntityFile,
+} from './lint.js';
 export {
   bundle,
   bundleDocument,

packages/core/src/lint.ts

@@ -192,3 +192,61 @@ export async function lintConfig(opts: {
 
   return ctx.problems;
 }
+
+export async function lintEntityFile(opts: {
+  document: Document;
+  entityTypes: Record<string, NodeType>;
+  severity?: ProblemSeverity;
+  externalRefResolver?: BaseResolver;
+}) {
+  const { document, entityTypes, severity, externalRefResolver = new BaseResolver() } = opts;
+
+  const ctx: WalkContext = {
+    problems: [],
+    specVersion: 'oas3_0', // Not used for entity validation but required by context
+    visitorsData: {},
+  };
+
+  const types = normalizeTypes(entityTypes);
+
+  const rules: (RuleInstanceConfig & {
+    visitor: NestedVisitObject<
+      unknown,
+      | Oas3Visitor
+      | Oas3Visitor[]
+      | Oas2Visitor
+      | Oas2Visitor[]
+      | Async2Visitor
+      | Async2Visitor[]
+      | Async3Visitor
+      | Async3Visitor[]
+      | Arazzo1Visitor
+      | Arazzo1Visitor[]
+      | Overlay1Visitor
+      | Overlay1Visitor[]
+    >;
+  })[] = [
+    {
+      severity: severity || 'error',
+      ruleId: 'entity struct',
+      visitor: Struct({ severity: 'error' }),
+    },
+  ];
+
+  const normalizedVisitors = normalizeVisitors(rules, types);
+  const resolvedRefMap = await resolveDocument({
+    rootDocument: document,
+    rootType: types.EntityFileTypes,
+    externalRefResolver,
+  });
+
+  walkDocument({
+    document,
+    rootType: types.EntityFileTypes,
+    normalizedVisitors,
+    resolvedRefMap,
+    ctx,
+  });
+
+  return ctx.problems;
+}

packages/core/src/types/entity-yaml.ts

@@ -5,15 +5,18 @@ import type { JSONSchema } from 'json-schema-to-ts';
 import type { NodeType } from './index.js';
 
 export function createEntityTypes(entityFileSchema: JSONSchema) {
-  const entitySchemaTypes = getNodeTypesFromJSONSchema('entityFileSchema', entityFileSchema);
-  const entitiesSchemaTypes = getNodeTypesFromJSONSchema('entitiesFilesSchema', {
-    type: 'array',
-    items: entityFileSchema,
+  const entityFileSchemaTypes = getNodeTypesFromJSONSchema('entityFileSchema', {
+    oneOf: [
+      entityFileSchema,
+      {
+        type: 'array',
+        items: entityFileSchema,
+      },
+    ],
   });
 
   return {
-    EntityFileTypes: entitySchemaTypes.entityFileSchema,
-    EntitiesFileTypes: entitiesSchemaTypes.entitiesFilesSchema,
+    EntityFileTypes: entityFileSchemaTypes.entityFileSchema,
   };
 }