zudoku 0.0.2-dev.0

package/dist/app/oas/parser/dereference/index.js

@@ -0,0 +1,43 @@
+import { resolveLocalRef } from "./resolveRef.js";
+const cache = new Map();
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const isIndexableObject = (obj) => obj !== null && typeof obj === "object";
+// Taken and inspired from `dereference-json-schema` package.
+export const dereference = async (schema, resolvers = []) => {
+    if (cache.has(schema)) {
+        return cache.get(schema);
+    }
+    const cloned = structuredClone(schema);
+    const visited = new Set();
+    const resolve = async (current, path) => {
+        if (isIndexableObject(current)) {
+            if (visited.has(current)) {
+                return current;
+            }
+            visited.add(current);
+            if (Array.isArray(current)) {
+                for (let index = 0; index < current.length; index++) {
+                    current[index] = await resolve(current[index], `${path}/${index}`);
+                }
+            }
+            else {
+                if ("$ref" in current && typeof current.$ref === "string") {
+                    for (const resolver of resolvers) {
+                        const resolved = await resolver(current.$ref);
+                        if (resolved)
+                            return resolved;
+                    }
+                    return await resolveLocalRef(cloned, current.$ref);
+                }
+                for (const key in current) {
+                    current[key] = await resolve(current[key], `${path}/${key}`);
+                }
+            }
+        }
+        return current;
+    };
+    const result = (await resolve(cloned, "#"));
+    cache.set(schema, result);
+    return result;
+};
+//# sourceMappingURL=index.js.map

package/dist/app/oas/parser/dereference/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/app/oas/parser/dereference/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAMlD,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;AAEhD,8DAA8D;AAC9D,MAAM,iBAAiB,GAAG,CAAC,GAAQ,EAA8B,EAAE,CACjE,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAC;AAE1C,6DAA6D;AAC7D,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAC9B,MAAkB,EAClB,YAA8B,EAAE,EAChC,EAAE;IACF,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC;IAC5B,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;IAE1B,MAAM,OAAO,GAAG,KAAK,EAAE,OAAgB,EAAE,IAAY,EAAE,EAAE;QACvD,IAAI,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBACzB,OAAO,OAAO,CAAC;YACjB,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAErB,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;oBACpD,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC;gBACrE,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,IAAI,MAAM,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC1D,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;wBACjC,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;wBAC9C,IAAI,QAAQ;4BAAE,OAAO,QAAQ,CAAC;oBAChC,CAAC;oBACD,OAAO,MAAM,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBACrD,CAAC;gBAED,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;oBAC1B,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC;gBAC/D,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAe,CAAC;IAC1D,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/dist/app/oas/parser/dereference/resolveRef.d.ts

@@ -0,0 +1,5 @@
+import type { JSONSchema } from "./index.js";
+/**
+ * Resolves a $ref pointer in a schema and returns the referenced value.
+ */
+export declare const resolveLocalRef: (schema: JSONSchema, ref: string) => unknown;

package/dist/app/oas/parser/dereference/resolveRef.js

@@ -0,0 +1,26 @@
+const cache = new Map();
+/**
+ * Resolves a $ref pointer in a schema and returns the referenced value.
+ */
+export const resolveLocalRef = (schema, ref) => {
+    if (!cache.has(schema)) {
+        cache.set(schema, new Map());
+    }
+    const schemaCache = cache.get(schema);
+    if (schemaCache.has(ref)) {
+        return schemaCache.get(ref);
+    }
+    const path = ref.split("/").slice(1);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let current = schema;
+    for (const segment of path) {
+        if (!current || typeof current !== "object") {
+            // we've reached a dead end
+            current = null;
+        }
+        current = current[segment] ?? null;
+    }
+    schemaCache.set(ref, current);
+    return current;
+};
+//# sourceMappingURL=resolveRef.js.map

package/dist/app/oas/parser/dereference/resolveRef.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveRef.js","sourceRoot":"","sources":["../../../../../src/app/oas/parser/dereference/resolveRef.ts"],"names":[],"mappings":"AAEA,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoC,CAAC;AAE1D;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAkB,EAAE,GAAW,EAAW,EAAE;IAC1E,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,GAAG,EAAmB,CAAC,CAAC;IAChD,CAAC;IACD,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAEtC,IAAI,WAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,WAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAErC,8DAA8D;IAC9D,IAAI,OAAO,GAAQ,MAAM,CAAC;IAC1B,KAAK,MAAM,OAAO,IAAI,IAAI,EAAE,CAAC;QAC3B,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC5C,2BAA2B;YAC3B,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IACrC,CAAC;IAED,WAAY,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/dist/app/oas/parser/index.d.ts

@@ -0,0 +1,21 @@
+import { OpenAPIV3, type OpenAPIV3_1 } from "openapi-types";
+type ReferenceObject = OpenAPIV3_1.ReferenceObject;
+type DeepOmitReference<T> = T extends ReferenceObject ? never : T extends object ? {
+    [K in keyof T]: DeepOmitReference<T[K]>;
+} : T;
+export type OpenAPIDocument = DeepOmitReference<OpenAPIV3_1.Document>;
+export type ResponseObject = DeepOmitReference<OpenAPIV3_1.ResponseObject>;
+export type OperationObject = DeepOmitReference<OpenAPIV3_1.OperationObject>;
+export type PathsObject = DeepOmitReference<OpenAPIV3_1.PathsObject>;
+export type PathItemObject = DeepOmitReference<OpenAPIV3_1.PathItemObject>;
+export type ParameterObject = DeepOmitReference<OpenAPIV3_1.ParameterObject>;
+export type TagObject = DeepOmitReference<OpenAPIV3_1.TagObject>;
+export type ExampleObject = DeepOmitReference<OpenAPIV3_1.ExampleObject>;
+export type EncodingObject = DeepOmitReference<OpenAPIV3_1.EncodingObject>;
+export type SchemaObject = DeepOmitReference<OpenAPIV3_1.SchemaObject>;
+export declare const HttpMethods: OpenAPIV3.HttpMethods[];
+/**
+ * Validates, dereferences and upgrades the OpenAPI schema (to v3.1) if necessary.
+ */
+export declare const validate: (schemaInput: any) => Promise<OpenAPIDocument>;
+export {};

package/dist/app/oas/parser/index.js

@@ -0,0 +1,58 @@
+import { OpenAPIV3 } from "openapi-types";
+import { dereference } from "./dereference/index.js";
+import { upgradeSchema } from "./upgrade/index.js";
+export const HttpMethods = Object.values(OpenAPIV3.HttpMethods);
+// class ValidationError extends Error {
+//   constructor(public errors: OutputUnit[]) {
+//     super("Validation error");
+//   }
+// }
+// const getValidator = async (openApiVersion: string) => {
+//   if (openApiVersion.startsWith("3.0")) {
+//     const schema = (await import("./schemas/v3.0.json")) as any;
+//     return new Validator(schema, "4");
+//   }
+//   if (openApiVersion.startsWith("3.1")) {
+//     const schema = (await import("./schemas/v3.1.json")) as any;
+//     return new Validator(schema as any, "2020-12");
+//   }
+//   throw new Error(`Unsupported OpenAPI version: ${openApiVersion}`);
+// };
+const parseSchemaInput = async (
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+schemaInput) => {
+    if (typeof schemaInput === "string") {
+        if (schemaInput.trim().startsWith("{")) {
+            return JSON.parse(schemaInput);
+        }
+        if (schemaInput.includes("://")) {
+            const response = await fetch(schemaInput);
+            return (await response.json());
+        }
+        const yaml = await import("yaml");
+        return yaml.parse(schemaInput);
+    }
+    if (typeof schemaInput === "object")
+        return schemaInput;
+    throw new Error("Unsupported schema input");
+};
+/**
+ * Validates, dereferences and upgrades the OpenAPI schema (to v3.1) if necessary.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const validate = async (schemaInput) => {
+    const schema = await parseSchemaInput(schemaInput);
+    if (!schema.openapi) {
+        throw new Error("OpenAPI version is not defined");
+    }
+    // const validator = await getValidator(schema.openapi);
+    // const result = validator.validate(schema);
+    //
+    // if (!result.valid) {
+    //   throw new ValidationError(result.errors);
+    // }
+    const dereferenced = await dereference(schema);
+    const upgraded = upgradeSchema(dereferenced);
+    return upgraded;
+};
+//# sourceMappingURL=index.js.map

package/dist/app/oas/parser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/app/oas/parser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAoB,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAmB,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAwBnD,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;AAEhE,wCAAwC;AACxC,+CAA+C;AAC/C,iCAAiC;AACjC,MAAM;AACN,IAAI;AAEJ,2DAA2D;AAC3D,4CAA4C;AAC5C,mEAAmE;AACnE,yCAAyC;AACzC,MAAM;AACN,4CAA4C;AAC5C,mEAAmE;AACnE,sDAAsD;AACtD,MAAM;AAEN,uEAAuE;AACvE,KAAK;AAEL,MAAM,gBAAgB,GAAG,KAAK;AAC5B,8DAA8D;AAC9D,WAAgB,EAC4B,EAAE;IAC9C,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACpC,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,CAAC;YAC1C,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAe,CAAC;QAC/C,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,OAAO,WAAW,KAAK,QAAQ;QAAE,OAAO,WAAW,CAAC;IAExD,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;AAC9C,CAAC,CAAC;AAEF;;GAEG;AACH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAAE,WAAgB,EAAE,EAAE;IACjD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAEnD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,wDAAwD;IACxD,6CAA6C;IAC7C,EAAE;IACF,uBAAuB;IACvB,8CAA8C;IAC9C,IAAI;IAEJ,MAAM,YAAY,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;IAE/C,MAAM,QAAQ,GAAG,aAAa,CAC5B,YAAyD,CAC1D,CAAC;IAEF,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC"}