@unispechq/unispec-core 0.2.2 → 0.2.4

package/dist/cjs/converters/index.js

@@ -4,23 +4,16 @@ exports.toOpenAPI = toOpenAPI;
 exports.toGraphQLSDL = toGraphQLSDL;
 exports.toWebSocketModel = toWebSocketModel;
 function toOpenAPI(doc) {
-    const service = doc.service;
-    const rest = (service.protocols?.rest ?? {});
+    const rest = (doc.protocols?.rest ?? {});
     const info = {
-        title: service.title ?? service.name,
-        description: service.description,
+        title: doc.name,
+        description: doc.description,
     };
-    // Derive OpenAPI servers from UniSpec environments when available.
-    const servers = Array.isArray(service.environments)
-        ? service.environments.map((env) => ({
-            url: env.baseUrl,
-            description: env.name,
-        }))
-        : [];
+    const servers = [];
     const paths = {};
     const components = {};
-    // Map service.schemas into OpenAPI components.schemas
-    const schemas = (service.schemas ?? {});
+    // Map doc.schemas into OpenAPI components.schemas
+    const schemas = (doc.schemas ?? {});
     const componentsSchemas = {};
     for (const [name, def] of Object.entries(schemas)) {
         componentsSchemas[name] = def.jsonSchema;
@@ -145,14 +138,13 @@ function toGraphQLSDL(doc) {
     // via a Query field. This does not attempt to interpret the full GraphQL
     // protocol structure yet, but provides a stable, deterministic SDL shape
     // based on top-level UniSpec document fields.
-    const graphql = doc.service.protocols?.graphql;
+    const graphql = doc.protocols?.graphql;
     const customSDL = graphql?.schema;
     if (typeof customSDL === "string" && customSDL.trim()) {
         return { sdl: customSDL };
     }
-    const service = doc.service;
-    const title = service.title ?? service.name;
-    const description = service.description ?? "";
+    const title = doc.name;
+    const description = doc.description ?? "";
     const lines = [];
     if (title || description) {
         lines.push("\"\"");
@@ -180,8 +172,7 @@ function toWebSocketModel(doc) {
     // It exposes service metadata, a normalized list of channels and the raw
     // websocket protocol object, while also embedding the original UniSpec
     // document under a technical key for debugging and introspection.
-    const service = doc.service;
-    const websocket = (service.protocols?.websocket ?? {});
+    const websocket = (doc.protocols?.websocket ?? {});
     const channelsArray = Array.isArray(websocket.channels) ? websocket.channels : [];
     const channels = [...channelsArray]
         .sort((a, b) => (a.name ?? "").localeCompare(b.name ?? ""))
@@ -195,9 +186,9 @@ function toWebSocketModel(doc) {
     }));
     return {
         service: {
-            name: service.name,
-            title: service.title,
-            description: service.description,
+            name: doc.name,
+            title: undefined,
+            description: doc.description,
         },
         channels,
         rawProtocol: websocket,

package/dist/cjs/diff/index.js

@@ -40,11 +40,11 @@ function diffValues(oldVal, newVal, basePath, out) {
     // Arrays
     if (Array.isArray(oldVal) && Array.isArray(newVal)) {
         // Special handling for UniSpec collections identified by "name"
-        const isNamedCollection = basePath === "/service/protocols/rest/routes" ||
-            basePath === "/service/protocols/websocket/channels" ||
-            basePath === "/service/protocols/graphql/queries" ||
-            basePath === "/service/protocols/graphql/mutations" ||
-            basePath === "/service/protocols/graphql/subscriptions";
+        const isNamedCollection = basePath === "/protocols/rest/routes" ||
+            basePath === "/protocols/websocket/channels" ||
+            basePath === "/protocols/graphql/queries" ||
+            basePath === "/protocols/graphql/mutations" ||
+            basePath === "/protocols/graphql/subscriptions";
         if (isNamedCollection) {
             const oldByName = new Map();
             const newByName = new Map();
@@ -116,15 +116,15 @@ function diffValues(oldVal, newVal, basePath, out) {
     });
 }
 function annotateRestChange(change) {
-    if (!change.path.startsWith("/service/protocols/rest/routes/")) {
+    if (!change.path.startsWith("/protocols/rest/routes/")) {
         return change;
     }
     const segments = change.path.split("/").filter(Boolean);
-    // Expected shape: ["service", "protocols", "rest", "routes", index]
-    if (segments[0] !== "service" || segments[1] !== "protocols" || segments[2] !== "rest" || segments[3] !== "routes") {
+    // Expected shape: ["protocols", "rest", "routes", index]
+    if (segments[0] !== "protocols" || segments[1] !== "rest" || segments[2] !== "routes") {
         return change;
     }
-    const index = segments[4];
+    const index = segments[3];
     if (typeof index === "undefined") {
         return change;
     }
@@ -143,16 +143,16 @@ function annotateRestChange(change) {
     return annotated;
 }
 function annotateWebSocketChange(change) {
-    if (!change.path.startsWith("/service/protocols/websocket/channels/")) {
+    if (!change.path.startsWith("/protocols/websocket/channels/")) {
         return change;
     }
     const segments = change.path.split("/").filter(Boolean);
-    // Expected base: ["service","protocols","websocket","channels", channelIndex, ...]
-    if (segments[0] !== "service" || segments[1] !== "protocols" || segments[2] !== "websocket" || segments[3] !== "channels") {
+    // Expected base: ["protocols","websocket","channels", channelIndex, ...]
+    if (segments[0] !== "protocols" || segments[1] !== "websocket" || segments[2] !== "channels") {
         return change;
     }
-    const channelIndex = segments[4];
-    const next = segments[5];
+    const channelIndex = segments[3];
+    const next = segments[4];
     const annotated = {
         ...change,
         protocol: "websocket",
@@ -160,7 +160,7 @@ function annotateWebSocketChange(change) {
     if (typeof channelIndex === "undefined") {
         return annotated;
     }
-    // Channel-level changes: /service/protocols/websocket/channels/{index}
+    // Channel-level changes: /protocols/websocket/channels/{index}
     if (!next) {
         if (change.description === "Item removed" || change.description === "Field removed") {
             annotated.kind = "websocket.channel.removed";
@@ -172,9 +172,9 @@ function annotateWebSocketChange(change) {
         }
         return annotated;
     }
-    // Message-level changes: /service/protocols/websocket/channels/{index}/messages/{msgIndex}
+    // Message-level changes: /protocols/websocket/channels/{index}/messages/{msgIndex}
     if (next === "messages") {
-        const messageIndex = segments[6];
+        const messageIndex = segments[5];
         if (typeof messageIndex === "undefined") {
             return annotated;
         }
@@ -190,16 +190,16 @@ function annotateWebSocketChange(change) {
     return annotated;
 }
 function annotateGraphQLChange(change) {
-    if (!change.path.startsWith("/service/protocols/graphql/")) {
+    if (!change.path.startsWith("/protocols/graphql/")) {
         return change;
     }
     const segments = change.path.split("/").filter(Boolean);
-    // Expected: ["service","protocols","graphql", kind, index, ...]
-    if (segments[0] !== "service" || segments[1] !== "protocols" || segments[2] !== "graphql") {
+    // Expected: ["protocols","graphql", kind, index, ...]
+    if (segments[0] !== "protocols" || segments[1] !== "graphql") {
         return change;
     }
-    const opKind = segments[3];
-    const index = segments[4];
+    const opKind = segments[2];
+    const index = segments[3];
     if (!opKind || typeof index === "undefined") {
         return change;
     }

package/dist/cjs/normalizer/index.js

@@ -19,10 +19,10 @@ function normalizeValue(value) {
     return value;
 }
 function normalizeRestRoutes(doc) {
-    if (!doc || !doc.service || !doc.service.protocols) {
+    if (!doc || !doc.protocols) {
         return doc;
     }
-    const protocols = doc.service.protocols;
+    const protocols = doc.protocols;
     const rest = protocols.rest;
     if (!rest || !Array.isArray(rest.routes)) {
         return doc;
@@ -37,10 +37,10 @@ function normalizeRestRoutes(doc) {
     return doc;
 }
 function normalizeWebSocket(doc) {
-    if (!doc || !doc.service || !doc.service.protocols) {
+    if (!doc || !doc.protocols) {
         return doc;
     }
-    const protocols = doc.service.protocols;
+    const protocols = doc.protocols;
     const websocket = protocols.websocket;
     if (!websocket || !Array.isArray(websocket.channels)) {
         return doc;
@@ -68,10 +68,10 @@ function normalizeWebSocket(doc) {
     return doc;
 }
 function normalizeGraphqlOperations(doc) {
-    if (!doc || !doc.service || !doc.service.protocols) {
+    if (!doc || !doc.protocols) {
         return doc;
     }
-    const protocols = doc.service.protocols;
+    const protocols = doc.protocols;
     const graphql = protocols.graphql;
     if (!graphql) {
         return doc;

package/dist/cjs/validator/index.js

@@ -8,6 +8,7 @@ exports.validateUniSpecTests = validateUniSpecTests;
 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 unispec_schema_1 = require("@unispechq/unispec-schema");
 const ajv = new _2020_js_1.default({
     allErrors: true,
@@ -15,16 +16,53 @@ const ajv = new _2020_js_1.default({
 });
 // Register minimal URI format to satisfy UniSpec schemas (service.environments[*].baseUrl)
 ajv.addFormat("uri", true);
+function findPackageRoot(startFilePath) {
+    let dir = path_1.default.dirname(startFilePath);
+    for (let i = 0; i < 50; i++) {
+        const pkgJsonPath = path_1.default.join(dir, "package.json");
+        if (fs_1.default.existsSync(pkgJsonPath)) {
+            return dir;
+        }
+        const parent = path_1.default.dirname(dir);
+        if (parent === dir) {
+            break;
+        }
+        dir = parent;
+    }
+    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"));
+    try {
+        const pkgJsonPath = localRequire.resolve("@unispechq/unispec-schema/package.json");
+        return path_1.default.join(path_1.default.dirname(pkgJsonPath), "schema");
+    }
+    catch {
+        const entryPath = localRequire.resolve("@unispechq/unispec-schema");
+        const pkgRoot = findPackageRoot(entryPath);
+        return path_1.default.join(pkgRoot, "schema");
+    }
+}
 // Register all UniSpec subschemas so that Ajv can resolve internal $ref links
 try {
-    const schemaDir = path_1.default.join(process.cwd(), "node_modules", "@unispechq", "unispec-schema", "schema");
+    const schemaDir = getUniSpecSchemaDir();
     const types = unispec_schema_1.manifest?.types ?? {};
     const typeSchemaPaths = Object.values(types).map((rel) => String(rel));
-    const loadedTypeSchemas = typeSchemaPaths
-        .map((relPath) => path_1.default.join(schemaDir, relPath))
-        .filter((filePath) => fs_1.default.existsSync(filePath))
-        .map((filePath) => JSON.parse(fs_1.default.readFileSync(filePath, "utf8")));
-    ajv.addSchema(loadedTypeSchemas);
+    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.
+        }
+    }
 }
 catch {
     // If subschemas cannot be loaded for some reason, validation will still work for
@@ -45,7 +83,18 @@ function mapAjvErrors(errors) {
  * Validate a UniSpec document against the UniSpec JSON Schema.
  */
 async function validateUniSpec(doc, _options = {}) {
-    const valid = validateFn(doc);
+    const docForValidation = {
+        unispecVersion: "0.0.0",
+        service: {
+            name: doc.name,
+            description: doc.description,
+            version: doc.version,
+            protocols: doc.protocols,
+            schemas: doc.schemas,
+        },
+        extensions: doc.extensions,
+    };
+    const valid = validateFn(docForValidation);
     if (valid) {
         return {
             valid: true,
@@ -62,7 +111,7 @@ async function validateUniSpec(doc, _options = {}) {
  */
 async function validateUniSpecTests(doc, _options = {}) {
     if (!validateTestsFn) {
-        const schemaDir = path_1.default.join(process.cwd(), "node_modules", "@unispechq", "unispec-schema", "schema");
+        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);

package/dist/converters/index.js

@@ -1,21 +1,14 @@
 export function toOpenAPI(doc) {
-    const service = doc.service;
-    const rest = (service.protocols?.rest ?? {});
+    const rest = (doc.protocols?.rest ?? {});
     const info = {
-        title: service.title ?? service.name,
-        description: service.description,
+        title: doc.name,
+        description: doc.description,
     };
-    // Derive OpenAPI servers from UniSpec environments when available.
-    const servers = Array.isArray(service.environments)
-        ? service.environments.map((env) => ({
-            url: env.baseUrl,
-            description: env.name,
-        }))
-        : [];
+    const servers = [];
     const paths = {};
     const components = {};
-    // Map service.schemas into OpenAPI components.schemas
-    const schemas = (service.schemas ?? {});
+    // Map doc.schemas into OpenAPI components.schemas
+    const schemas = (doc.schemas ?? {});
     const componentsSchemas = {};
     for (const [name, def] of Object.entries(schemas)) {
         componentsSchemas[name] = def.jsonSchema;
@@ -140,14 +133,13 @@ export function toGraphQLSDL(doc) {
     // via a Query field. This does not attempt to interpret the full GraphQL
     // protocol structure yet, but provides a stable, deterministic SDL shape
     // based on top-level UniSpec document fields.
-    const graphql = doc.service.protocols?.graphql;
+    const graphql = doc.protocols?.graphql;
     const customSDL = graphql?.schema;
     if (typeof customSDL === "string" && customSDL.trim()) {
         return { sdl: customSDL };
     }
-    const service = doc.service;
-    const title = service.title ?? service.name;
-    const description = service.description ?? "";
+    const title = doc.name;
+    const description = doc.description ?? "";
     const lines = [];
     if (title || description) {
         lines.push("\"\"");
@@ -175,8 +167,7 @@ export function toWebSocketModel(doc) {
     // It exposes service metadata, a normalized list of channels and the raw
     // websocket protocol object, while also embedding the original UniSpec
     // document under a technical key for debugging and introspection.
-    const service = doc.service;
-    const websocket = (service.protocols?.websocket ?? {});
+    const websocket = (doc.protocols?.websocket ?? {});
     const channelsArray = Array.isArray(websocket.channels) ? websocket.channels : [];
     const channels = [...channelsArray]
         .sort((a, b) => (a.name ?? "").localeCompare(b.name ?? ""))
@@ -190,9 +181,9 @@ export function toWebSocketModel(doc) {
     }));
     return {
         service: {
-            name: service.name,
-            title: service.title,
-            description: service.description,
+            name: doc.name,
+            title: undefined,
+            description: doc.description,
         },
         channels,
         rawProtocol: websocket,

package/dist/diff/index.js

@@ -37,11 +37,11 @@ function diffValues(oldVal, newVal, basePath, out) {
     // Arrays
     if (Array.isArray(oldVal) && Array.isArray(newVal)) {
         // Special handling for UniSpec collections identified by "name"
-        const isNamedCollection = basePath === "/service/protocols/rest/routes" ||
-            basePath === "/service/protocols/websocket/channels" ||
-            basePath === "/service/protocols/graphql/queries" ||
-            basePath === "/service/protocols/graphql/mutations" ||
-            basePath === "/service/protocols/graphql/subscriptions";
+        const isNamedCollection = basePath === "/protocols/rest/routes" ||
+            basePath === "/protocols/websocket/channels" ||
+            basePath === "/protocols/graphql/queries" ||
+            basePath === "/protocols/graphql/mutations" ||
+            basePath === "/protocols/graphql/subscriptions";
         if (isNamedCollection) {
             const oldByName = new Map();
             const newByName = new Map();
@@ -113,15 +113,15 @@ function diffValues(oldVal, newVal, basePath, out) {
     });
 }
 function annotateRestChange(change) {
-    if (!change.path.startsWith("/service/protocols/rest/routes/")) {
+    if (!change.path.startsWith("/protocols/rest/routes/")) {
         return change;
     }
     const segments = change.path.split("/").filter(Boolean);
-    // Expected shape: ["service", "protocols", "rest", "routes", index]
-    if (segments[0] !== "service" || segments[1] !== "protocols" || segments[2] !== "rest" || segments[3] !== "routes") {
+    // Expected shape: ["protocols", "rest", "routes", index]
+    if (segments[0] !== "protocols" || segments[1] !== "rest" || segments[2] !== "routes") {
         return change;
     }
-    const index = segments[4];
+    const index = segments[3];
     if (typeof index === "undefined") {
         return change;
     }
@@ -140,16 +140,16 @@ function annotateRestChange(change) {
     return annotated;
 }
 function annotateWebSocketChange(change) {
-    if (!change.path.startsWith("/service/protocols/websocket/channels/")) {
+    if (!change.path.startsWith("/protocols/websocket/channels/")) {
         return change;
     }
     const segments = change.path.split("/").filter(Boolean);
-    // Expected base: ["service","protocols","websocket","channels", channelIndex, ...]
-    if (segments[0] !== "service" || segments[1] !== "protocols" || segments[2] !== "websocket" || segments[3] !== "channels") {
+    // Expected base: ["protocols","websocket","channels", channelIndex, ...]
+    if (segments[0] !== "protocols" || segments[1] !== "websocket" || segments[2] !== "channels") {
         return change;
     }
-    const channelIndex = segments[4];
-    const next = segments[5];
+    const channelIndex = segments[3];
+    const next = segments[4];
     const annotated = {
         ...change,
         protocol: "websocket",
@@ -157,7 +157,7 @@ function annotateWebSocketChange(change) {
     if (typeof channelIndex === "undefined") {
         return annotated;
     }
-    // Channel-level changes: /service/protocols/websocket/channels/{index}
+    // Channel-level changes: /protocols/websocket/channels/{index}
     if (!next) {
         if (change.description === "Item removed" || change.description === "Field removed") {
             annotated.kind = "websocket.channel.removed";
@@ -169,9 +169,9 @@ function annotateWebSocketChange(change) {
         }
         return annotated;
     }
-    // Message-level changes: /service/protocols/websocket/channels/{index}/messages/{msgIndex}
+    // Message-level changes: /protocols/websocket/channels/{index}/messages/{msgIndex}
     if (next === "messages") {
-        const messageIndex = segments[6];
+        const messageIndex = segments[5];
         if (typeof messageIndex === "undefined") {
             return annotated;
         }
@@ -187,16 +187,16 @@ function annotateWebSocketChange(change) {
     return annotated;
 }
 function annotateGraphQLChange(change) {
-    if (!change.path.startsWith("/service/protocols/graphql/")) {
+    if (!change.path.startsWith("/protocols/graphql/")) {
         return change;
     }
     const segments = change.path.split("/").filter(Boolean);
-    // Expected: ["service","protocols","graphql", kind, index, ...]
-    if (segments[0] !== "service" || segments[1] !== "protocols" || segments[2] !== "graphql") {
+    // Expected: ["protocols","graphql", kind, index, ...]
+    if (segments[0] !== "protocols" || segments[1] !== "graphql") {
         return change;
     }
-    const opKind = segments[3];
-    const index = segments[4];
+    const opKind = segments[2];
+    const index = segments[3];
     if (!opKind || typeof index === "undefined") {
         return change;
     }

package/dist/normalizer/index.js

@@ -16,10 +16,10 @@ function normalizeValue(value) {
     return value;
 }
 function normalizeRestRoutes(doc) {
-    if (!doc || !doc.service || !doc.service.protocols) {
+    if (!doc || !doc.protocols) {
         return doc;
     }
-    const protocols = doc.service.protocols;
+    const protocols = doc.protocols;
     const rest = protocols.rest;
     if (!rest || !Array.isArray(rest.routes)) {
         return doc;
@@ -34,10 +34,10 @@ function normalizeRestRoutes(doc) {
     return doc;
 }
 function normalizeWebSocket(doc) {
-    if (!doc || !doc.service || !doc.service.protocols) {
+    if (!doc || !doc.protocols) {
         return doc;
     }
-    const protocols = doc.service.protocols;
+    const protocols = doc.protocols;
     const websocket = protocols.websocket;
     if (!websocket || !Array.isArray(websocket.channels)) {
         return doc;
@@ -65,10 +65,10 @@ function normalizeWebSocket(doc) {
     return doc;
 }
 function normalizeGraphqlOperations(doc) {
-    if (!doc || !doc.service || !doc.service.protocols) {
+    if (!doc || !doc.protocols) {
         return doc;
     }
-    const protocols = doc.service.protocols;
+    const protocols = doc.protocols;
     const graphql = protocols.graphql;
     if (!graphql) {
         return doc;

package/dist/types/index.d.ts

@@ -85,21 +85,12 @@ export interface UniSpecServiceProtocols {
     graphql?: UniSpecGraphQLProtocol;
     websocket?: UniSpecWebSocketProtocol;
 }
-export interface UniSpecService {
+export interface UniSpecDocument {
     name: string;
-    title?: string;
     description?: string;
     version?: string;
-    owner?: string;
-    tags?: string[];
-    links?: Record<string, string>;
     protocols?: UniSpecServiceProtocols;
     schemas?: UniSpecSchemas;
-    environments?: UniSpecEnvironment[];
-}
-export interface UniSpecDocument {
-    unispecVersion: string;
-    service: UniSpecService;
     extensions?: Record<string, unknown>;
 }
 export interface ValidationError {

package/dist/validator/index.js

@@ -1,6 +1,7 @@
 import Ajv2020 from "ajv/dist/2020.js";
 import fs from "fs";
 import path from "path";
+import { createRequire } from "module";
 import { unispec as unispecSchema, manifest as unispecManifest } from "@unispechq/unispec-schema";
 const ajv = new Ajv2020({
     allErrors: true,
@@ -8,16 +9,53 @@ const ajv = new Ajv2020({
 });
 // Register minimal URI format to satisfy UniSpec schemas (service.environments[*].baseUrl)
 ajv.addFormat("uri", true);
+function findPackageRoot(startFilePath) {
+    let dir = path.dirname(startFilePath);
+    for (let i = 0; i < 50; i++) {
+        const pkgJsonPath = path.join(dir, "package.json");
+        if (fs.existsSync(pkgJsonPath)) {
+            return dir;
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir) {
+            break;
+        }
+        dir = parent;
+    }
+    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"));
+    try {
+        const pkgJsonPath = localRequire.resolve("@unispechq/unispec-schema/package.json");
+        return path.join(path.dirname(pkgJsonPath), "schema");
+    }
+    catch {
+        const entryPath = localRequire.resolve("@unispechq/unispec-schema");
+        const pkgRoot = findPackageRoot(entryPath);
+        return path.join(pkgRoot, "schema");
+    }
+}
 // Register all UniSpec subschemas so that Ajv can resolve internal $ref links
 try {
-    const schemaDir = path.join(process.cwd(), "node_modules", "@unispechq", "unispec-schema", "schema");
+    const schemaDir = getUniSpecSchemaDir();
     const types = unispecManifest?.types ?? {};
     const typeSchemaPaths = Object.values(types).map((rel) => String(rel));
-    const loadedTypeSchemas = typeSchemaPaths
-        .map((relPath) => path.join(schemaDir, relPath))
-        .filter((filePath) => fs.existsSync(filePath))
-        .map((filePath) => JSON.parse(fs.readFileSync(filePath, "utf8")));
-    ajv.addSchema(loadedTypeSchemas);
+    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.
+        }
+    }
 }
 catch {
     // If subschemas cannot be loaded for some reason, validation will still work for
@@ -38,7 +76,18 @@ function mapAjvErrors(errors) {
  * Validate a UniSpec document against the UniSpec JSON Schema.
  */
 export async function validateUniSpec(doc, _options = {}) {
-    const valid = validateFn(doc);
+    const docForValidation = {
+        unispecVersion: "0.0.0",
+        service: {
+            name: doc.name,
+            description: doc.description,
+            version: doc.version,
+            protocols: doc.protocols,
+            schemas: doc.schemas,
+        },
+        extensions: doc.extensions,
+    };
+    const valid = validateFn(docForValidation);
     if (valid) {
         return {
             valid: true,
@@ -55,7 +104,7 @@ export async function validateUniSpec(doc, _options = {}) {
  */
 export async function validateUniSpecTests(doc, _options = {}) {
     if (!validateTestsFn) {
-        const schemaDir = path.join(process.cwd(), "node_modules", "@unispechq", "unispec-schema", "schema");
+        const schemaDir = getUniSpecSchemaDir();
         const testsSchemaPath = path.join(schemaDir, "unispec-tests.schema.json");
         const testsSchema = JSON.parse(fs.readFileSync(testsSchemaPath, "utf8"));
         validateTestsFn = ajv.compile(testsSchema);

package/package.json

@@ -1,8 +1,28 @@
 {
   "name": "@unispechq/unispec-core",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Central UniSpec Core Engine providing parsing, validation, normalization, diffing, and conversion of UniSpec specs.",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/unispec/unispec-core.git"
+  },
+  "bugs": {
+    "url": "https://github.com/unispec/unispec-core/issues"
+  },
+  "homepage": "https://github.com/unispec/unispec-core#readme",
+  "keywords": [
+    "unispec",
+    "specification",
+    "schema",
+    "validator",
+    "normalizer",
+    "diff",
+    "converter"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -28,7 +48,7 @@
     "release:major": "node scripts/release.js major"
   },
   "dependencies": {
-    "@unispechq/unispec-schema": "^0.3.1",
+    "@unispechq/unispec-schema": "^0.3.3",
     "ajv": "^8.12.0"
   },
   "devDependencies": {