npm - @unispechq/unispec-core - Versions diffs - 0.2.4 → 0.2.5 - Mend

@unispechq/unispec-core 0.2.4 → 0.2.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/dist/cjs/validator/index.js +61 -35
package/dist/validator/index.d.ts +1 -0
package/dist/validator/index.js +61 -35
package/package.json +1 -1

package/dist/cjs/validator/index.js CHANGED Viewed

@@ -9,13 +9,29 @@ const _2020_js_1 = __importDefault(require("ajv/dist/2020.js"));
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const module_1 = require("module");
+const url_1 = require("url");
 const unispec_schema_1 = require("@unispechq/unispec-schema");
-const ajv = new _2020_js_1.default({
-    allErrors: true,
-    strict: true,
-});
-// Register minimal URI format to satisfy UniSpec schemas (service.environments[*].baseUrl)
-ajv.addFormat("uri", true);
+function getThisModuleUrl() {
+    if (typeof __filename === "string" && __filename.length > 0) {
+        return (0, url_1.pathToFileURL)(__filename).href;
+    }
+    const stack = new Error().stack ?? "";
+    const fileUrlMatch = stack.match(/file:\/\/\/[^\s)]+/);
+    if (fileUrlMatch?.[0]) {
+        return fileUrlMatch[0];
+    }
+    const winPathMatch = stack.match(/[A-Za-z]:\\[^\s)]+/);
+    if (winPathMatch?.[0]) {
+        return (0, url_1.pathToFileURL)(winPathMatch[0]).href;
+    }
+    throw new Error("Cannot determine current module URL for createRequire()");
+}
+function getLocalRequire() {
+    if (typeof require !== "undefined") {
+        return require;
+    }
+    return (0, module_1.createRequire)(getThisModuleUrl());
+}
 function findPackageRoot(startFilePath) {
     let dir = path_1.default.dirname(startFilePath);
     for (let i = 0; i < 50; i++) {
@@ -31,8 +47,12 @@ function findPackageRoot(startFilePath) {
     }
     throw new Error(`Cannot locate package.json for resolved path: ${startFilePath}`);
 }
-function getUniSpecSchemaDir() {
-    const localRequire = typeof require !== "undefined" ? require : (0, module_1.createRequire)(path_1.default.join(process.cwd(), "package.json"));
+function getUniSpecSchemaDir(options = {}) {
+    const override = options.schemaDir ?? process.env.UNISPEC_SCHEMA_DIR;
+    if (override) {
+        return override;
+    }
+    const localRequire = getLocalRequire();
     try {
         const pkgJsonPath = localRequire.resolve("@unispechq/unispec-schema/package.json");
         return path_1.default.join(path_1.default.dirname(pkgJsonPath), "schema");
@@ -43,33 +63,43 @@ function getUniSpecSchemaDir() {
         return path_1.default.join(pkgRoot, "schema");
     }
 }
-// Register all UniSpec subschemas so that Ajv can resolve internal $ref links
-try {
-    const schemaDir = getUniSpecSchemaDir();
+const validatorCache = new Map();
+function getCompiledValidator(options = {}) {
+    const schemaDir = getUniSpecSchemaDir(options);
+    const cached = validatorCache.get(schemaDir);
+    if (cached) {
+        return cached;
+    }
+    const ajv = new _2020_js_1.default({
+        allErrors: true,
+        strict: true,
+    });
+    // Register minimal URI format to satisfy UniSpec schemas (service.environments[*].baseUrl)
+    ajv.addFormat("uri", true);
+    // Register all UniSpec subschemas so that Ajv can resolve internal $ref links
     const types = unispec_schema_1.manifest?.types ?? {};
     const typeSchemaPaths = Object.values(types).map((rel) => String(rel));
     for (const relPath of typeSchemaPaths) {
-        try {
-            const filePath = path_1.default.join(schemaDir, relPath);
-            if (!fs_1.default.existsSync(filePath)) {
-                continue;
-            }
-            const schema = JSON.parse(fs_1.default.readFileSync(filePath, "utf8"));
-            const normalizedRelPath = String(relPath).replace(/^\.\//, "");
-            const fallbackId = `https://unispec.dev/schema/${normalizedRelPath}`;
-            ajv.addSchema(schema, fallbackId);
-        }
-        catch {
-            // Ignore individual schema registration failures to keep the validator usable.
+        const filePath = path_1.default.join(schemaDir, relPath);
+        if (!fs_1.default.existsSync(filePath)) {
+            continue;
         }
+        const schema = JSON.parse(fs_1.default.readFileSync(filePath, "utf8"));
+        const normalizedRelPath = String(relPath).replace(/^\.\//, "");
+        const fallbackId = `https://unispec.dev/schema/${normalizedRelPath}`;
+        ajv.addSchema(schema, fallbackId);
     }
+    const validateFn = ajv.compile(unispec_schema_1.unispec);
+    const testsSchemaPath = path_1.default.join(schemaDir, "unispec-tests.schema.json");
+    const testsSchema = JSON.parse(fs_1.default.readFileSync(testsSchemaPath, "utf8"));
+    const validateTestsFn = ajv.compile(testsSchema);
+    const compiled = {
+        validateFn,
+        validateTestsFn,
+    };
+    validatorCache.set(schemaDir, compiled);
+    return compiled;
 }
-catch {
-    // If subschemas cannot be loaded for some reason, validation will still work for
-    // parts of the schema that do not rely on those $ref references.
-}
-const validateFn = ajv.compile(unispec_schema_1.unispec);
-let validateTestsFn;
 function mapAjvErrors(errors) {
     if (!errors)
         return [];
@@ -83,6 +113,7 @@ function mapAjvErrors(errors) {
  * Validate a UniSpec document against the UniSpec JSON Schema.
  */
 async function validateUniSpec(doc, _options = {}) {
+    const { validateFn } = getCompiledValidator(_options);
     const docForValidation = {
         unispecVersion: "0.0.0",
         service: {
@@ -110,12 +141,7 @@ async function validateUniSpec(doc, _options = {}) {
  * Validate a UniSpec Tests document against the UniSpec Tests JSON Schema.
  */
 async function validateUniSpecTests(doc, _options = {}) {
-    if (!validateTestsFn) {
-        const schemaDir = getUniSpecSchemaDir();
-        const testsSchemaPath = path_1.default.join(schemaDir, "unispec-tests.schema.json");
-        const testsSchema = JSON.parse(fs_1.default.readFileSync(testsSchemaPath, "utf8"));
-        validateTestsFn = ajv.compile(testsSchema);
-    }
+    const { validateTestsFn } = getCompiledValidator(_options);
     const valid = validateTestsFn(doc);
     if (valid) {
         return {

package/dist/validator/index.d.ts CHANGED Viewed

@@ -1,5 +1,6 @@
 import { UniSpecDocument, UniSpecTestsDocument, ValidationResult } from "../types";
 export interface ValidateOptions {
+    schemaDir?: string;
 }
 /**
  * Validate a UniSpec document against the UniSpec JSON Schema.

package/dist/validator/index.js CHANGED Viewed

@@ -2,13 +2,29 @@ import Ajv2020 from "ajv/dist/2020.js";
 import fs from "fs";
 import path from "path";
 import { createRequire } from "module";
+import { pathToFileURL } from "url";
 import { unispec as unispecSchema, manifest as unispecManifest } from "@unispechq/unispec-schema";
-const ajv = new Ajv2020({
-    allErrors: true,
-    strict: true,
-});
-// Register minimal URI format to satisfy UniSpec schemas (service.environments[*].baseUrl)
-ajv.addFormat("uri", true);
+function getThisModuleUrl() {
+    if (typeof __filename === "string" && __filename.length > 0) {
+        return pathToFileURL(__filename).href;
+    }
+    const stack = new Error().stack ?? "";
+    const fileUrlMatch = stack.match(/file:\/\/\/[^\s)]+/);
+    if (fileUrlMatch?.[0]) {
+        return fileUrlMatch[0];
+    }
+    const winPathMatch = stack.match(/[A-Za-z]:\\[^\s)]+/);
+    if (winPathMatch?.[0]) {
+        return pathToFileURL(winPathMatch[0]).href;
+    }
+    throw new Error("Cannot determine current module URL for createRequire()");
+}
+function getLocalRequire() {
+    if (typeof require !== "undefined") {
+        return require;
+    }
+    return createRequire(getThisModuleUrl());
+}
 function findPackageRoot(startFilePath) {
     let dir = path.dirname(startFilePath);
     for (let i = 0; i < 50; i++) {
@@ -24,8 +40,12 @@ function findPackageRoot(startFilePath) {
     }
     throw new Error(`Cannot locate package.json for resolved path: ${startFilePath}`);
 }
-function getUniSpecSchemaDir() {
-    const localRequire = typeof require !== "undefined" ? require : createRequire(path.join(process.cwd(), "package.json"));
+function getUniSpecSchemaDir(options = {}) {
+    const override = options.schemaDir ?? process.env.UNISPEC_SCHEMA_DIR;
+    if (override) {
+        return override;
+    }
+    const localRequire = getLocalRequire();
     try {
         const pkgJsonPath = localRequire.resolve("@unispechq/unispec-schema/package.json");
         return path.join(path.dirname(pkgJsonPath), "schema");
@@ -36,33 +56,43 @@ function getUniSpecSchemaDir() {
         return path.join(pkgRoot, "schema");
     }
 }
-// Register all UniSpec subschemas so that Ajv can resolve internal $ref links
-try {
-    const schemaDir = getUniSpecSchemaDir();
+const validatorCache = new Map();
+function getCompiledValidator(options = {}) {
+    const schemaDir = getUniSpecSchemaDir(options);
+    const cached = validatorCache.get(schemaDir);
+    if (cached) {
+        return cached;
+    }
+    const ajv = new Ajv2020({
+        allErrors: true,
+        strict: true,
+    });
+    // Register minimal URI format to satisfy UniSpec schemas (service.environments[*].baseUrl)
+    ajv.addFormat("uri", true);
+    // Register all UniSpec subschemas so that Ajv can resolve internal $ref links
     const types = unispecManifest?.types ?? {};
     const typeSchemaPaths = Object.values(types).map((rel) => String(rel));
     for (const relPath of typeSchemaPaths) {
-        try {
-            const filePath = path.join(schemaDir, relPath);
-            if (!fs.existsSync(filePath)) {
-                continue;
-            }
-            const schema = JSON.parse(fs.readFileSync(filePath, "utf8"));
-            const normalizedRelPath = String(relPath).replace(/^\.\//, "");
-            const fallbackId = `https://unispec.dev/schema/${normalizedRelPath}`;
-            ajv.addSchema(schema, fallbackId);
-        }
-        catch {
-            // Ignore individual schema registration failures to keep the validator usable.
+        const filePath = path.join(schemaDir, relPath);
+        if (!fs.existsSync(filePath)) {
+            continue;
         }
+        const schema = JSON.parse(fs.readFileSync(filePath, "utf8"));
+        const normalizedRelPath = String(relPath).replace(/^\.\//, "");
+        const fallbackId = `https://unispec.dev/schema/${normalizedRelPath}`;
+        ajv.addSchema(schema, fallbackId);
     }
+    const validateFn = ajv.compile(unispecSchema);
+    const testsSchemaPath = path.join(schemaDir, "unispec-tests.schema.json");
+    const testsSchema = JSON.parse(fs.readFileSync(testsSchemaPath, "utf8"));
+    const validateTestsFn = ajv.compile(testsSchema);
+    const compiled = {
+        validateFn,
+        validateTestsFn,
+    };
+    validatorCache.set(schemaDir, compiled);
+    return compiled;
 }
-catch {
-    // If subschemas cannot be loaded for some reason, validation will still work for
-    // parts of the schema that do not rely on those $ref references.
-}
-const validateFn = ajv.compile(unispecSchema);
-let validateTestsFn;
 function mapAjvErrors(errors) {
     if (!errors)
         return [];
@@ -76,6 +106,7 @@ function mapAjvErrors(errors) {
  * Validate a UniSpec document against the UniSpec JSON Schema.
  */
 export async function validateUniSpec(doc, _options = {}) {
+    const { validateFn } = getCompiledValidator(_options);
     const docForValidation = {
         unispecVersion: "0.0.0",
         service: {
@@ -103,12 +134,7 @@ export async function validateUniSpec(doc, _options = {}) {
  * Validate a UniSpec Tests document against the UniSpec Tests JSON Schema.
  */
 export async function validateUniSpecTests(doc, _options = {}) {
-    if (!validateTestsFn) {
-        const schemaDir = getUniSpecSchemaDir();
-        const testsSchemaPath = path.join(schemaDir, "unispec-tests.schema.json");
-        const testsSchema = JSON.parse(fs.readFileSync(testsSchemaPath, "utf8"));
-        validateTestsFn = ajv.compile(testsSchema);
-    }
+    const { validateTestsFn } = getCompiledValidator(_options);
     const valid = validateTestsFn(doc);
     if (valid) {
         return {

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@unispechq/unispec-core",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "Central UniSpec Core Engine providing parsing, validation, normalization, diffing, and conversion of UniSpec specs.",
   "license": "MIT",
   "repository": {