@nocobase/plugin-mcp-server 2.1.0-alpha.15 → 2.1.0-alpha.17

package/dist/node_modules/openapi-mcp-generator/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/options.d.ts

@@ -0,0 +1,387 @@
+import type { HTTPResolverOptions, JSONSchema, JSONSchemaObject, Plugin, ResolverOptions } from "./types/index.js";
+export type DeepPartial<T> = T extends object ? {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;
+export interface DereferenceOptions {
+    /**
+     * Determines whether circular `$ref` pointers are handled.
+     *
+     * If set to `false`, then a `ReferenceError` will be thrown if the schema contains any circular references.
+     *
+     * If set to `"ignore"`, then circular references will simply be ignored. No error will be thrown, but the `$Refs.circular` property will still be set to `true`.
+     */
+    circular?: boolean | "ignore";
+    /**
+     * A function, called for each path, which can return true to stop this path and all
+     * subpaths from being dereferenced further. This is useful in schemas where some
+     * subpaths contain literal $ref keys that should not be dereferenced.
+     */
+    excludedPathMatcher?(path: string): boolean;
+    /**
+     * Callback invoked during dereferencing.
+     *
+     * @argument {string} path - The path being dereferenced (ie. the `$ref` string)
+     * @argument {JSONSchemaObject} value - The JSON-Schema that the `$ref` resolved to
+     * @argument {JSONSchemaObject} parent - The parent of the dereferenced object
+     * @argument {string} parentPropName - The prop name of the parent object whose value was dereferenced
+     */
+    onDereference?(path: string, value: JSONSchemaObject, parent?: JSONSchemaObject, parentPropName?: string): void;
+    /**
+     * Whether a reference should resolve relative to its directory/path, or from the cwd
+     *
+     * Default: `relative`
+     */
+    externalReferenceResolution?: "relative" | "root";
+}
+/**
+ * Options that determine how JSON schemas are parsed, resolved, and dereferenced.
+ *
+ * @param [options] - Overridden options
+ * @class
+ */
+export interface $RefParserOptions<S extends object = JSONSchema> {
+    /**
+     * The `parse` options determine how different types of files will be parsed.
+     *
+     * JSON Schema `$Ref` Parser comes with built-in JSON, YAML, plain-text, and binary parsers, any of which you can configure or disable. You can also add your own custom parsers if you want.
+     */
+    parse: {
+        json?: Plugin | boolean;
+        yaml?: Plugin | boolean;
+        binary?: Plugin | boolean;
+        text?: Plugin | boolean;
+        [key: string]: Plugin | boolean | undefined;
+    };
+    /**
+     * The `resolve` options control how JSON Schema $Ref Parser will resolve file paths and URLs, and how those files will be read/downloaded.
+     *
+     * JSON Schema `$Ref` Parser comes with built-in support for HTTP and HTTPS, as well as support for local files (when running in Node.js). You can configure or disable either of these built-in resolvers. You can also add your own custom resolvers if you want.
+     */
+    resolve: {
+        /**
+         * Determines whether external $ref pointers will be resolved. If this option is disabled, then external `$ref` pointers will simply be ignored.
+         */
+        external?: boolean;
+        file?: Partial<ResolverOptions<S>> | boolean;
+        http?: HTTPResolverOptions<S> | boolean;
+    } & {
+        [key: string]: Partial<ResolverOptions<S>> | HTTPResolverOptions<S> | boolean | undefined;
+    };
+    /**
+     * By default, JSON Schema $Ref Parser throws the first error it encounters. Setting `continueOnError` to `true`
+     * causes it to keep processing as much as possible and then throw a single error that contains all errors
+     * that were encountered.
+     */
+    continueOnError: boolean;
+    /**
+     * The `dereference` options control how JSON Schema `$Ref` Parser will dereference `$ref` pointers within the JSON schema.
+     */
+    dereference: DereferenceOptions;
+    /**
+     * Whether to clone the schema before dereferencing it.
+     * This is useful when you want to dereference the same schema multiple times, but you don't want to modify the original schema.
+     * Default: `true` due to mutating the input being the default behavior historically
+     */
+    mutateInputSchema?: boolean;
+    /**
+     * The maximum amount of time (in milliseconds) that JSON Schema $Ref Parser will spend dereferencing a single schema.
+     * It will throw a timeout error if the operation takes longer than this.
+     */
+    timeoutMs?: number;
+}
+export declare const getJsonSchemaRefParserDefaultOptions: () => $RefParserOptions<JSONSchema>;
+export declare const getNewOptions: <S extends object = JSONSchema, O extends ParserOptions<S> = {
+    parse?: {
+        [x: string]: boolean | {
+            name?: string | undefined;
+            order?: number | undefined;
+            allowEmpty?: boolean | undefined;
+            allowBOM?: boolean | undefined;
+            encoding?: BufferEncoding | undefined;
+            canParse?: string | boolean | {
+                exec?: {} | undefined;
+                test?: {} | undefined;
+                readonly source?: string | undefined;
+                readonly global?: boolean | undefined;
+                readonly ignoreCase?: boolean | undefined;
+                readonly multiline?: boolean | undefined;
+                lastIndex?: number | undefined;
+                compile?: {} | undefined;
+                readonly flags?: string | undefined;
+                readonly sticky?: boolean | undefined;
+                readonly unicode?: boolean | undefined;
+                readonly dotAll?: boolean | undefined;
+                readonly hasIndices?: boolean | undefined;
+                readonly unicodeSets?: boolean | undefined;
+                [Symbol.match]?: {} | undefined;
+                [Symbol.replace]?: {} | undefined;
+                [Symbol.search]?: {} | undefined;
+                [Symbol.split]?: {} | undefined;
+                [Symbol.matchAll]?: {} | undefined;
+            } | (string | undefined)[] | {} | undefined;
+            parse?: string | number | {} | undefined;
+        } | undefined;
+        json?: boolean | {
+            name?: string | undefined;
+            order?: number | undefined;
+            allowEmpty?: boolean | undefined;
+            allowBOM?: boolean | undefined;
+            encoding?: BufferEncoding | undefined;
+            canParse?: string | boolean | {
+                exec?: {} | undefined;
+                test?: {} | undefined;
+                readonly source?: string | undefined;
+                readonly global?: boolean | undefined;
+                readonly ignoreCase?: boolean | undefined;
+                readonly multiline?: boolean | undefined;
+                lastIndex?: number | undefined;
+                compile?: {} | undefined;
+                readonly flags?: string | undefined;
+                readonly sticky?: boolean | undefined;
+                readonly unicode?: boolean | undefined;
+                readonly dotAll?: boolean | undefined;
+                readonly hasIndices?: boolean | undefined;
+                readonly unicodeSets?: boolean | undefined;
+                [Symbol.match]?: {} | undefined;
+                [Symbol.replace]?: {} | undefined;
+                [Symbol.search]?: {} | undefined;
+                [Symbol.split]?: {} | undefined;
+                [Symbol.matchAll]?: {} | undefined;
+            } | (string | undefined)[] | {} | undefined;
+            parse?: string | number | {} | undefined;
+        } | undefined;
+        yaml?: boolean | {
+            name?: string | undefined;
+            order?: number | undefined;
+            allowEmpty?: boolean | undefined;
+            allowBOM?: boolean | undefined;
+            encoding?: BufferEncoding | undefined;
+            canParse?: string | boolean | {
+                exec?: {} | undefined;
+                test?: {} | undefined;
+                readonly source?: string | undefined;
+                readonly global?: boolean | undefined;
+                readonly ignoreCase?: boolean | undefined;
+                readonly multiline?: boolean | undefined;
+                lastIndex?: number | undefined;
+                compile?: {} | undefined;
+                readonly flags?: string | undefined;
+                readonly sticky?: boolean | undefined;
+                readonly unicode?: boolean | undefined;
+                readonly dotAll?: boolean | undefined;
+                readonly hasIndices?: boolean | undefined;
+                readonly unicodeSets?: boolean | undefined;
+                [Symbol.match]?: {} | undefined;
+                [Symbol.replace]?: {} | undefined;
+                [Symbol.search]?: {} | undefined;
+                [Symbol.split]?: {} | undefined;
+                [Symbol.matchAll]?: {} | undefined;
+            } | (string | undefined)[] | {} | undefined;
+            parse?: string | number | {} | undefined;
+        } | undefined;
+        binary?: boolean | {
+            name?: string | undefined;
+            order?: number | undefined;
+            allowEmpty?: boolean | undefined;
+            allowBOM?: boolean | undefined;
+            encoding?: BufferEncoding | undefined;
+            canParse?: string | boolean | {
+                exec?: {} | undefined;
+                test?: {} | undefined;
+                readonly source?: string | undefined;
+                readonly global?: boolean | undefined;
+                readonly ignoreCase?: boolean | undefined;
+                readonly multiline?: boolean | undefined;
+                lastIndex?: number | undefined;
+                compile?: {} | undefined;
+                readonly flags?: string | undefined;
+                readonly sticky?: boolean | undefined;
+                readonly unicode?: boolean | undefined;
+                readonly dotAll?: boolean | undefined;
+                readonly hasIndices?: boolean | undefined;
+                readonly unicodeSets?: boolean | undefined;
+                [Symbol.match]?: {} | undefined;
+                [Symbol.replace]?: {} | undefined;
+                [Symbol.search]?: {} | undefined;
+                [Symbol.split]?: {} | undefined;
+                [Symbol.matchAll]?: {} | undefined;
+            } | (string | undefined)[] | {} | undefined;
+            parse?: string | number | {} | undefined;
+        } | undefined;
+        text?: boolean | {
+            name?: string | undefined;
+            order?: number | undefined;
+            allowEmpty?: boolean | undefined;
+            allowBOM?: boolean | undefined;
+            encoding?: BufferEncoding | undefined;
+            canParse?: string | boolean | {
+                exec?: {} | undefined;
+                test?: {} | undefined;
+                readonly source?: string | undefined;
+                readonly global?: boolean | undefined;
+                readonly ignoreCase?: boolean | undefined;
+                readonly multiline?: boolean | undefined;
+                lastIndex?: number | undefined;
+                compile?: {} | undefined;
+                readonly flags?: string | undefined;
+                readonly sticky?: boolean | undefined;
+                readonly unicode?: boolean | undefined;
+                readonly dotAll?: boolean | undefined;
+                readonly hasIndices?: boolean | undefined;
+                readonly unicodeSets?: boolean | undefined;
+                [Symbol.match]?: {} | undefined;
+                [Symbol.replace]?: {} | undefined;
+                [Symbol.search]?: {} | undefined;
+                [Symbol.split]?: {} | undefined;
+                [Symbol.matchAll]?: {} | undefined;
+            } | (string | undefined)[] | {} | undefined;
+            parse?: string | number | {} | undefined;
+        } | undefined;
+    } | undefined;
+    resolve?: {
+        [x: string]: boolean | {
+            name?: string | undefined;
+            order?: number | undefined;
+            canRead?: string | boolean | {
+                exec?: {} | undefined;
+                test?: {} | undefined;
+                readonly source?: string | undefined;
+                readonly global?: boolean | undefined;
+                readonly ignoreCase?: boolean | undefined;
+                readonly multiline?: boolean | undefined;
+                lastIndex?: number | undefined;
+                compile?: {} | undefined;
+                readonly flags?: string | undefined;
+                readonly sticky?: boolean | undefined;
+                readonly unicode?: boolean | undefined;
+                readonly dotAll?: boolean | undefined;
+                readonly hasIndices?: boolean | undefined;
+                readonly unicodeSets?: boolean | undefined;
+                [Symbol.match]?: {} | undefined;
+                [Symbol.replace]?: {} | undefined;
+                [Symbol.search]?: {} | undefined;
+                [Symbol.split]?: {} | undefined;
+                [Symbol.matchAll]?: {} | undefined;
+            } | (string | undefined)[] | {} | undefined;
+            read?: string | object | {} | undefined;
+        } | {
+            headers?: ([(string | undefined)?, (string | undefined)?] | undefined)[] | {
+                [x: string]: string | undefined;
+            } | {
+                append?: {} | undefined;
+                delete?: {} | undefined;
+                get?: {} | undefined;
+                getSetCookie?: {} | undefined;
+                has?: {} | undefined;
+                set?: {} | undefined;
+                forEach?: {} | undefined;
+            } | null | undefined;
+            timeout?: number | undefined;
+            redirects?: number | undefined;
+            withCredentials?: boolean | undefined;
+            name?: string | undefined;
+            order?: number | undefined;
+            canRead?: string | boolean | {
+                exec?: {} | undefined;
+                test?: {} | undefined;
+                readonly source?: string | undefined;
+                readonly global?: boolean | undefined;
+                readonly ignoreCase?: boolean | undefined;
+                readonly multiline?: boolean | undefined;
+                lastIndex?: number | undefined;
+                compile?: {} | undefined;
+                readonly flags?: string | undefined;
+                readonly sticky?: boolean | undefined;
+                readonly unicode?: boolean | undefined;
+                readonly dotAll?: boolean | undefined;
+                readonly hasIndices?: boolean | undefined;
+                readonly unicodeSets?: boolean | undefined;
+                [Symbol.match]?: {} | undefined;
+                [Symbol.replace]?: {} | undefined;
+                [Symbol.search]?: {} | undefined;
+                [Symbol.split]?: {} | undefined;
+                [Symbol.matchAll]?: {} | undefined;
+            } | (string | undefined)[] | {} | undefined;
+            read?: string | object | {} | undefined;
+        } | undefined;
+        external?: boolean | undefined;
+        file?: boolean | {
+            name?: string | undefined;
+            order?: number | undefined;
+            canRead?: string | boolean | {
+                exec?: {} | undefined;
+                test?: {} | undefined;
+                readonly source?: string | undefined;
+                readonly global?: boolean | undefined;
+                readonly ignoreCase?: boolean | undefined;
+                readonly multiline?: boolean | undefined;
+                lastIndex?: number | undefined;
+                compile?: {} | undefined;
+                readonly flags?: string | undefined;
+                readonly sticky?: boolean | undefined;
+                readonly unicode?: boolean | undefined;
+                readonly dotAll?: boolean | undefined;
+                readonly hasIndices?: boolean | undefined;
+                readonly unicodeSets?: boolean | undefined;
+                [Symbol.match]?: {} | undefined;
+                [Symbol.replace]?: {} | undefined;
+                [Symbol.search]?: {} | undefined;
+                [Symbol.split]?: {} | undefined;
+                [Symbol.matchAll]?: {} | undefined;
+            } | (string | undefined)[] | {} | undefined;
+            read?: string | object | {} | undefined;
+        } | undefined;
+        http?: boolean | {
+            headers?: ([(string | undefined)?, (string | undefined)?] | undefined)[] | {
+                [x: string]: string | undefined;
+            } | {
+                append?: {} | undefined;
+                delete?: {} | undefined;
+                get?: {} | undefined;
+                getSetCookie?: {} | undefined;
+                has?: {} | undefined;
+                set?: {} | undefined;
+                forEach?: {} | undefined;
+            } | null | undefined;
+            timeout?: number | undefined;
+            redirects?: number | undefined;
+            withCredentials?: boolean | undefined;
+            name?: string | undefined;
+            order?: number | undefined;
+            canRead?: string | boolean | {
+                exec?: {} | undefined;
+                test?: {} | undefined;
+                readonly source?: string | undefined;
+                readonly global?: boolean | undefined;
+                readonly ignoreCase?: boolean | undefined;
+                readonly multiline?: boolean | undefined;
+                lastIndex?: number | undefined;
+                compile?: {} | undefined;
+                readonly flags?: string | undefined;
+                readonly sticky?: boolean | undefined;
+                readonly unicode?: boolean | undefined;
+                readonly dotAll?: boolean | undefined;
+                readonly hasIndices?: boolean | undefined;
+                readonly unicodeSets?: boolean | undefined;
+                [Symbol.match]?: {} | undefined;
+                [Symbol.replace]?: {} | undefined;
+                [Symbol.search]?: {} | undefined;
+                [Symbol.split]?: {} | undefined;
+                [Symbol.matchAll]?: {} | undefined;
+            } | (string | undefined)[] | {} | undefined;
+            read?: string | object | {} | undefined;
+        } | undefined;
+    } | undefined;
+    continueOnError?: boolean | undefined;
+    dereference?: {
+        circular?: (boolean | "ignore") | undefined;
+        excludedPathMatcher?: {} | undefined;
+        onDereference?: {} | undefined;
+        externalReferenceResolution?: ("relative" | "root") | undefined;
+    } | undefined;
+    mutateInputSchema?: boolean | undefined;
+    timeoutMs?: number | undefined;
+}>(options: O | undefined) => O & $RefParserOptions<S>;
+export type Options<S extends object = JSONSchema> = $RefParserOptions<S>;
+export type ParserOptions<S extends object = JSONSchema> = DeepPartial<$RefParserOptions<S>>;
+export default $RefParserOptions;

package/dist/node_modules/openapi-mcp-generator/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/options.js

@@ -0,0 +1,122 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNewOptions = exports.getJsonSchemaRefParserDefaultOptions = void 0;
+const json_js_1 = __importDefault(require("./parsers/json.js"));
+const yaml_js_1 = __importDefault(require("./parsers/yaml.js"));
+const text_js_1 = __importDefault(require("./parsers/text.js"));
+const binary_js_1 = __importDefault(require("./parsers/binary.js"));
+const file_js_1 = __importDefault(require("./resolvers/file.js"));
+const http_js_1 = __importDefault(require("./resolvers/http.js"));
+const getJsonSchemaRefParserDefaultOptions = () => {
+    const defaults = {
+        /**
+         * Determines how different types of files will be parsed.
+         *
+         * You can add additional parsers of your own, replace an existing one with
+         * your own implementation, or disable any parser by setting it to false.
+         */
+        parse: {
+            json: { ...json_js_1.default },
+            yaml: { ...yaml_js_1.default },
+            text: { ...text_js_1.default },
+            binary: { ...binary_js_1.default },
+        },
+        /**
+         * Determines how JSON References will be resolved.
+         *
+         * You can add additional resolvers of your own, replace an existing one with
+         * your own implementation, or disable any resolver by setting it to false.
+         */
+        resolve: {
+            file: { ...file_js_1.default },
+            http: { ...http_js_1.default },
+            /**
+             * Determines whether external $ref pointers will be resolved.
+             * If this option is disabled, then none of above resolvers will be called.
+             * Instead, external $ref pointers will simply be ignored.
+             *
+             * @type {boolean}
+             */
+            external: true,
+        },
+        /**
+         * By default, JSON Schema $Ref Parser throws the first error it encounters. Setting `continueOnError` to `true`
+         * causes it to keep processing as much as possible and then throw a single error that contains all errors
+         * that were encountered.
+         */
+        continueOnError: false,
+        /**
+         * Determines the types of JSON references that are allowed.
+         */
+        dereference: {
+            /**
+             * Dereference circular (recursive) JSON references?
+             * If false, then a {@link ReferenceError} will be thrown if a circular reference is found.
+             * If "ignore", then circular references will not be dereferenced.
+             *
+             * @type {boolean|string}
+             */
+            circular: true,
+            /**
+             * A function, called for each path, which can return true to stop this path and all
+             * subpaths from being dereferenced further. This is useful in schemas where some
+             * subpaths contain literal $ref keys that should not be dereferenced.
+             *
+             * @type {function}
+             */
+            excludedPathMatcher: () => false,
+            referenceResolution: "relative",
+        },
+        mutateInputSchema: true,
+    };
+    return defaults;
+};
+exports.getJsonSchemaRefParserDefaultOptions = getJsonSchemaRefParserDefaultOptions;
+const getNewOptions = (options) => {
+    const newOptions = (0, exports.getJsonSchemaRefParserDefaultOptions)();
+    if (options) {
+        merge(newOptions, options);
+    }
+    return newOptions;
+};
+exports.getNewOptions = getNewOptions;
+/**
+ * Merges the properties of the source object into the target object.
+ *
+ * @param target - The object that we're populating
+ * @param source - The options that are being merged
+ * @returns
+ */
+function merge(target, source) {
+    if (isMergeable(source)) {
+        // prevent prototype pollution
+        const keys = Object.keys(source).filter((key) => !["__proto__", "constructor", "prototype"].includes(key));
+        for (let i = 0; i < keys.length; i++) {
+            const key = keys[i];
+            const sourceSetting = source[key];
+            const targetSetting = target[key];
+            if (isMergeable(sourceSetting)) {
+                // It's a nested object, so merge it recursively
+                target[key] = merge(targetSetting || {}, sourceSetting);
+            }
+            else if (sourceSetting !== undefined) {
+                // It's a scalar value, function, or array. No merging necessary. Just overwrite the target value.
+                target[key] = sourceSetting;
+            }
+        }
+    }
+    return target;
+}
+/**
+ * Determines whether the given value can be merged,
+ * or if it is a scalar value that should just override the target value.
+ *
+ * @param val
+ * @returns
+ */
+function isMergeable(val) {
+    return val && typeof val === "object" && !Array.isArray(val) && !(val instanceof RegExp) && !(val instanceof Date);
+}

package/dist/node_modules/openapi-mcp-generator/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/parse.d.ts

@@ -0,0 +1,8 @@
+import type $Refs from "./refs.js";
+import type { ParserOptions } from "./options.js";
+import type { JSONSchema } from "./types/index.js";
+/**
+ * Reads and parses the specified file path or URL.
+ */
+declare function parse<S extends object = JSONSchema, O extends ParserOptions<S> = ParserOptions<S>>(path: string, $refs: $Refs<S, O>, options: O): Promise<string | Buffer | S | undefined>;
+export default parse;

package/dist/node_modules/openapi-mcp-generator/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/parse.js

@@ -0,0 +1,169 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const ono_1 = require("@jsdevtools/ono");
+const url = __importStar(require("./util/url.js"));
+const plugins = __importStar(require("./util/plugins.js"));
+const errors_js_1 = require("./util/errors.js");
+/**
+ * Reads and parses the specified file path or URL.
+ */
+async function parse(path, $refs, options) {
+    // Remove the URL fragment, if any
+    const hashIndex = path.indexOf("#");
+    let hash = "";
+    if (hashIndex >= 0) {
+        hash = path.substring(hashIndex);
+        // Remove the URL fragment, if any
+        path = path.substring(0, hashIndex);
+    }
+    // Add a new $Ref for this file, even though we don't have the value yet.
+    // This ensures that we don't simultaneously read & parse the same file multiple times
+    const $ref = $refs._add(path);
+    // This "file object" will be passed to all resolvers and parsers.
+    const file = {
+        url: path,
+        hash,
+        extension: url.getExtension(path),
+    };
+    // Read the file and then parse the data
+    try {
+        const resolver = await readFile(file, options, $refs);
+        $ref.pathType = resolver.plugin.name;
+        file.data = resolver.result;
+        const parser = await parseFile(file, options, $refs);
+        $ref.value = parser.result;
+        return parser.result;
+    }
+    catch (err) {
+        if ((0, errors_js_1.isHandledError)(err)) {
+            $ref.value = err;
+        }
+        throw err;
+    }
+}
+/**
+ * Reads the given file, using the configured resolver plugins
+ *
+ * @param file           - An object containing information about the referenced file
+ * @param file.url       - The full URL of the referenced file
+ * @param file.extension - The lowercased file extension (e.g. ".txt", ".html", etc.)
+ * @param options
+ * @param $refs
+ * @returns
+ * The promise resolves with the raw file contents and the resolver that was used.
+ */
+async function readFile(file, options, $refs) {
+    // console.log('Reading %s', file.url);
+    // Find the resolvers that can read this file
+    let resolvers = plugins.all(options.resolve);
+    resolvers = plugins.filter(resolvers, "canRead", file);
+    // Run the resolvers, in order, until one of them succeeds
+    plugins.sort(resolvers);
+    try {
+        const data = await plugins.run(resolvers, "read", file, $refs);
+        return data;
+    }
+    catch (err) {
+        if (!err && options.continueOnError) {
+            // No resolver could be matched
+            throw new errors_js_1.UnmatchedResolverError(file.url);
+        }
+        else if (!err || !("error" in err)) {
+            // Throw a generic, friendly error.
+            throw ono_1.ono.syntax(`Unable to resolve $ref pointer "${file.url}"`);
+        }
+        // Throw the original error, if it's one of our own (user-friendly) errors.
+        else if (err.error instanceof errors_js_1.ResolverError) {
+            throw err.error;
+        }
+        else {
+            throw new errors_js_1.ResolverError(err, file.url);
+        }
+    }
+}
+/**
+ * Parses the given file's contents, using the configured parser plugins.
+ *
+ * @param file           - An object containing information about the referenced file
+ * @param file.url       - The full URL of the referenced file
+ * @param file.extension - The lowercased file extension (e.g. ".txt", ".html", etc.)
+ * @param file.data      - The file contents. This will be whatever data type was returned by the resolver
+ * @param options
+ * @param $refs
+ *
+ * @returns
+ * The promise resolves with the parsed file contents and the parser that was used.
+ */
+async function parseFile(file, options, $refs) {
+    // Find the parsers that can read this file type.
+    // If none of the parsers are an exact match for this file, then we'll try ALL of them.
+    // This handles situations where the file IS a supported type, just with an unknown extension.
+    const allParsers = plugins.all(options.parse);
+    const filteredParsers = plugins.filter(allParsers, "canParse", file);
+    const parsers = filteredParsers.length > 0 ? filteredParsers : allParsers;
+    // Run the parsers, in order, until one of them succeeds
+    plugins.sort(parsers);
+    try {
+        const parser = await plugins.run(parsers, "parse", file, $refs);
+        if (!parser.plugin.allowEmpty && isEmpty(parser.result)) {
+            throw ono_1.ono.syntax(`Error parsing "${file.url}" as ${parser.plugin.name}. \nParsed value is empty`);
+        }
+        else {
+            return parser;
+        }
+    }
+    catch (err) {
+        if (!err && options.continueOnError) {
+            // No resolver could be matched
+            throw new errors_js_1.UnmatchedParserError(file.url);
+        }
+        else if (err && err.message && err.message.startsWith("Error parsing")) {
+            throw err;
+        }
+        else if (!err || !("error" in err)) {
+            throw ono_1.ono.syntax(`Unable to parse ${file.url}`);
+        }
+        else if (err.error instanceof errors_js_1.ParserError) {
+            throw err.error;
+        }
+        else {
+            throw new errors_js_1.ParserError(err.error.message, file.url);
+        }
+    }
+}
+/**
+ * Determines whether the parsed value is "empty".
+ *
+ * @param value
+ * @returns
+ */
+function isEmpty(value) {
+    return (value === undefined ||
+        (typeof value === "object" && Object.keys(value).length === 0) ||
+        (typeof value === "string" && value.trim().length === 0) ||
+        (Buffer.isBuffer(value) && value.length === 0));
+}
+exports.default = parse;