@redocly/openapi-core/src/rules/common/__tests__/spec-strict-refs.test.ts

See https://github.com/Redocly/redocly-cli

import { makeConfig, parseYamlToDocument, replaceSourceWithRef } from '../../../../__tests__/utils';
import { outdent } from 'outdent';
import { lintDocument } from '../../../lint';
import { BaseResolver } from '../../../resolve';

describe('Oas3 spec-strict-refs', () => {
  it('should report about invalid usage of $ref', async () => {
    const document = parseYamlToDocument(
      outdent`
      openapi: "3.1.0"
      info:
        $ref: '#/components/schemas/test'
      paths:
        /store/subscribe:
          post:
            responses:
              '201':
                content:
                  application/json:
                    schema:
                      type: object
                      properties:
                        $ref: '#/components/schemas/test'
                        subscriptionId:
                          type: string
                          example: AAA-123-BBB-456
      components:
        schemas:
          test:
            type: object                    
		`
    );
    const results = await lintDocument({
      externalRefResolver: new BaseResolver(),
      document,
      config: await makeConfig({ rules: { 'spec-strict-refs': 'error' } }),
    });
    expect(replaceSourceWithRef(results)).toMatchInlineSnapshot(`
      [
        {
          "location": [
            {
              "pointer": "#/info/$ref",
              "reportOnKey": true,
              "source": "",
            },
          ],
          "message": "Field $ref is not expected here.",
          "ruleId": "spec-strict-refs",
          "severity": "error",
          "suggest": [],
        },
        {
          "location": [
            {
              "pointer": "#/paths/~1store~1subscribe/post/responses/201/content/application~1json/schema/properties/$ref",
              "reportOnKey": true,
              "source": "",
            },
          ],
          "message": "Field $ref is not expected here.",
          "ruleId": "spec-strict-refs",
          "severity": "error",
          "suggest": [],
        },
      ]
    `);
  });
});