Changes:

- copied files from test branch: https://github.com/AnimeshKumar923/asyncapi-spec/tree/embedded-examples-jsonPath-test/scripts/validation

- copied because merge conflict and older files in the previous branch
- files required for validation of embedded examples
- still a WIP, more modification and refinement will be made in future

mistakenly added this file

Changes:

- added comments in the file as suggested by Sergio here: asyncapi#957 (comment)
- more comments to be adjusted according to the json format

Changes:

- modified the script so that it can handle component object example
- the script as of now add the fields and sub-fields in the updated-doc
  so that the other references remain unaffected
- the earlier version was removinga and adding the whole part of the
  document altogether which affected the references and dependencies in
  the entire document

Changes:

- updated the spec file to correctly match the json format and for
  further parsing
- updated the base document to support more of the examples
- added missing json version for some of the examples

Changes:

- removed the examples added through 4529772
- applied suggestion from: asyncapi#1059 (comment)

Changes:

- created new base doc removing additional fields under
  'securitySchemes'. This is because we have to individuallly validate
  each examples under the Security Scheme Object. The additional fields
  were giving error during validation of those examples.
- changes the object's name from `test` to `name`.
- updated the script according to the changed object's name

Changes:

- update script to determine the base doc, whether the 'server scheme
  object' is present or not
- updated both the base docs with more missing fields

Changes:

- modified script which now creates an array of extracted examples along
  with the metadatas of it

Changes:

- updated the script to make new documents for each examples
  in the asyncapi.md, and then store them into a new file for
  further vaidation process
- remove an extra character in asyncapi.md

Changes:

- function to validate files using asyncapi-parser
- function to validate files using asyncapi-cli

Changes:

- made the creation, updation and deletion of file dynamic
- made the functions asynchronous for faster execution

Changes:

- modified the comment due to error while processing the slash ('/')
  character in the code

Changes:

- merging the changes which I was testing separately to not affect this
  current branch

Changes:

- cleared out the unnecessary files
- move files to appropriate location
- rename files to be more meaningful

Changes:

- updated base doc to support more examples
- update script to handle arrays, and cleared the clutter
- fixed incorrect comment in the spec file
- adding updated files temporarily for debugging purpose

Changes:
- similar change to: asyncapi#1059 (comment)

Changes:
- removed cli validation
- improved regex expression
- improved extraction process
- added `process.exit(1) at appropriate location, commented out for now,
  will be included in the final version
- applied suggestions from: asyncapi#1059 (comment)

Changes:
- modified script to parse and validate YAML versions of the examples
- update package.json and package-lock.json with new dependencies

Changes:
- make script to validate the scripts in the memory itself instead of
  writing it to disk
- applied suggestion from: asyncapi#1059

Changes:
- update script to be suited for json-merge-patch,
- suggested by Sergio via Slack DM
  more details about merge-patch here: https://datatracker.ietf.org/doc/html/rfc7396
- update spec file with comments suited for json-merge-patch
- update dependencies

Changes:
- update script to match the json_pointer object
- add check for the root doc

Changes:
- update json pointer in spec that support the arrays merge in the base doc
- update json pointer to support root doc

Changes:
- modify examples in Operation Object

Changes:
- after removing the section the code was still working fine
- for inserting examples inside an array we only need to add the `/0`
  trailing end in the json_pointer object where deemed necessary

Changes:
- change json pointer from String Reperesentation to
  URI Fragment Identifier Representation
- more info here: https://datatracker.ietf.org/doc/html/rfc6901#section-6
- suggested by Sergio for consistency

Changes:
- deleted temporary files which were added to see the changes happening
  when the files were being constructed
- remove example markdown file which simulated the spec doc for testing
  purposes
- applied suggestions from: asyncapi#1059 (comment)

Changes:
- modify example to match the correct format of the spec
- add new sub-heading to denote what kind of OAuth Flow is
- applied suggestion from: asyncapi#1059 (comment)

Changes:
- preparing a combined docs as per suggestion: asyncapi#1059 (comment)
- update script to match the new combined document
- delete separate security scheme document

This PR contains spec example fixes identified during the validation script's testing.

Changes:
- added a file to track down the issues encountered and their fixes
  in one place.
- Taken from: https://github.com/AnimeshKumar923/test-repo/blob/4d1269490a3a12a7c3363ba9efa2527ac40aeb4d/embedded-examples-error-resolution.md

Changes:
- add more missing example parameters which were identified during the
  testing of the script

Changes:
- added external avro schema file: 'user-create.avsc'
- change the reference in the spec to point to the location of the avsc
  file

Changes:
- add process.exit(1) at appropriate locations
- workflow should fail

Changes:
- workflow should be passed

Changes:
- trying to maintain the consistency of the single quotes
  and double quotes

Changes:
- the heading was mistakenly deleted during the addition of comments in
  the spec file

Changes:
- applied suggestion from: asyncapi#1059 (comment)
- applied suggestion from: asyncapi#1059 (comment)

Changes:
- modify yaml example which was failing due to not properly formatted
  structure
- update json pointer at one location

Changes:
- https://github.com/asyncapi/spec/pull/1059/files/b24f71d751db6f0ad9d29dc4b6adbef44693c12d#r1666936370

Changes:
- The json pointer library doesn't supports the URI representation,
  so to reduce the extra work this change was made

Changes:
- asyncapi#1059 (comment)
- asyncapi#1059 (comment)
- asyncapi#1059 (comment)

apply suggestion: asyncapi#1059 (comment)

Co-authored-by: Sergio Moya <[email protected]>

Changes:
- adjust script according to suggestion: asyncapi#1059 (comment)