@unispechq/unispec-core 0.2.9 → 0.2.10

package/dist/cjs/index.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./types/index.js"), exports);
 __exportStar(require("./loader/index.js"), exports);
 __exportStar(require("./validator/index.js"), exports);
+__exportStar(require("./schemas/index.js"), exports);
 __exportStar(require("./normalizer/index.js"), exports);
 __exportStar(require("./diff/index.js"), exports);
 __exportStar(require("./converters/index.js"), exports);

package/dist/cjs/schemas/index.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSchemaRef = resolveSchemaRef;
+exports.registerSchema = registerSchema;
+exports.dedupeSchemas = dedupeSchemas;
+function normalizeSchemaRef(ref) {
+    const trimmed = ref.trim();
+    if (trimmed.length === 0)
+        return "";
+    const withoutHash = trimmed.startsWith("#") ? trimmed.slice(1) : trimmed;
+    const parts = withoutHash.split("/").filter(Boolean);
+    return parts.length > 0 ? parts[parts.length - 1] : withoutHash;
+}
+function stableStringify(value) {
+    if (value === null)
+        return "null";
+    const t = typeof value;
+    if (t === "number" || t === "boolean")
+        return JSON.stringify(value);
+    if (t === "string")
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return `[${value.map(stableStringify).join(",")}]`;
+    if (t !== "object")
+        return JSON.stringify(value);
+    const obj = value;
+    const keys = Object.keys(obj).sort();
+    const entries = keys.map((k) => `${JSON.stringify(k)}:${stableStringify(obj[k])}`);
+    return `{${entries.join(",")}}`;
+}
+function resolveSchemaRef(doc, ref) {
+    const name = normalizeSchemaRef(ref);
+    if (!name)
+        return undefined;
+    return doc.schemas?.[name];
+}
+function registerSchema(doc, name, jsonSchema) {
+    if (!doc.schemas) {
+        doc.schemas = {};
+    }
+    const definition = {
+        jsonSchema,
+    };
+    doc.schemas[name] = definition;
+    return definition;
+}
+function updateSchemaRefs(doc, mapping) {
+    const rest = doc.protocols?.rest;
+    const websocket = doc.protocols?.websocket;
+    if (rest?.routes) {
+        for (const route of rest.routes) {
+            for (const params of [route.pathParams, route.queryParams, route.headers]) {
+                if (!params)
+                    continue;
+                for (const p of params) {
+                    if (!p.schemaRef)
+                        continue;
+                    const key = normalizeSchemaRef(p.schemaRef);
+                    const next = mapping[key];
+                    if (next && next !== key)
+                        p.schemaRef = next;
+                }
+            }
+            const requestContent = route.requestBody?.content;
+            if (requestContent) {
+                for (const media of Object.values(requestContent)) {
+                    if (!media.schemaRef)
+                        continue;
+                    const key = normalizeSchemaRef(media.schemaRef);
+                    const next = mapping[key];
+                    if (next && next !== key)
+                        media.schemaRef = next;
+                }
+            }
+            const responses = route.responses;
+            if (responses) {
+                for (const resp of Object.values(responses)) {
+                    const respContent = resp.content;
+                    if (!respContent)
+                        continue;
+                    for (const media of Object.values(respContent)) {
+                        if (!media.schemaRef)
+                            continue;
+                        const key = normalizeSchemaRef(media.schemaRef);
+                        const next = mapping[key];
+                        if (next && next !== key)
+                            media.schemaRef = next;
+                    }
+                }
+            }
+        }
+    }
+    if (websocket?.channels) {
+        for (const channel of websocket.channels) {
+            if (!channel.messages)
+                continue;
+            for (const message of channel.messages) {
+                if (!message.schemaRef)
+                    continue;
+                const key = normalizeSchemaRef(message.schemaRef);
+                const next = mapping[key];
+                if (next && next !== key)
+                    message.schemaRef = next;
+            }
+        }
+    }
+}
+function dedupeSchemas(doc) {
+    if (!doc.schemas)
+        return;
+    const names = Object.keys(doc.schemas);
+    const hashToName = new Map();
+    const renameMap = {};
+    for (const name of names) {
+        const schema = doc.schemas[name];
+        const hash = stableStringify(schema?.jsonSchema ?? null);
+        const existing = hashToName.get(hash);
+        if (!existing) {
+            hashToName.set(hash, name);
+            continue;
+        }
+        renameMap[name] = existing;
+    }
+    const duplicates = Object.keys(renameMap);
+    if (duplicates.length === 0)
+        return;
+    updateSchemaRefs(doc, renameMap);
+    for (const dup of duplicates) {
+        delete doc.schemas[dup];
+    }
+}

package/dist/index.cjs

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./types/index.js"), exports);
 __exportStar(require("./loader/index.js"), exports);
 __exportStar(require("./validator/index.js"), exports);
+__exportStar(require("./schemas/index.js"), exports);
 __exportStar(require("./normalizer/index.js"), exports);
 __exportStar(require("./diff/index.js"), exports);
 __exportStar(require("./converters/index.js"), exports);

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export * from "./types/index.js";
 export * from "./loader/index.js";
 export * from "./validator/index.js";
+export * from "./schemas/index.js";
 export * from "./normalizer/index.js";
 export * from "./diff/index.js";
 export * from "./converters/index.js";

package/dist/index.js

@@ -1,6 +1,7 @@
 export * from "./types/index.js";
 export * from "./loader/index.js";
 export * from "./validator/index.js";
+export * from "./schemas/index.js";
 export * from "./normalizer/index.js";
 export * from "./diff/index.js";
 export * from "./converters/index.js";

package/dist/schemas/index.d.ts

@@ -0,0 +1,4 @@
+import { UniSpecDocument, UniSpecSchemaDefinition } from "../types/index.js";
+export declare function resolveSchemaRef(doc: UniSpecDocument, ref: string): UniSpecSchemaDefinition | undefined;
+export declare function registerSchema(doc: UniSpecDocument, name: string, jsonSchema: Record<string, unknown>): UniSpecSchemaDefinition;
+export declare function dedupeSchemas(doc: UniSpecDocument): void;

package/dist/schemas/index.js

@@ -0,0 +1,126 @@
+function normalizeSchemaRef(ref) {
+    const trimmed = ref.trim();
+    if (trimmed.length === 0)
+        return "";
+    const withoutHash = trimmed.startsWith("#") ? trimmed.slice(1) : trimmed;
+    const parts = withoutHash.split("/").filter(Boolean);
+    return parts.length > 0 ? parts[parts.length - 1] : withoutHash;
+}
+function stableStringify(value) {
+    if (value === null)
+        return "null";
+    const t = typeof value;
+    if (t === "number" || t === "boolean")
+        return JSON.stringify(value);
+    if (t === "string")
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return `[${value.map(stableStringify).join(",")}]`;
+    if (t !== "object")
+        return JSON.stringify(value);
+    const obj = value;
+    const keys = Object.keys(obj).sort();
+    const entries = keys.map((k) => `${JSON.stringify(k)}:${stableStringify(obj[k])}`);
+    return `{${entries.join(",")}}`;
+}
+export function resolveSchemaRef(doc, ref) {
+    const name = normalizeSchemaRef(ref);
+    if (!name)
+        return undefined;
+    return doc.schemas?.[name];
+}
+export function registerSchema(doc, name, jsonSchema) {
+    if (!doc.schemas) {
+        doc.schemas = {};
+    }
+    const definition = {
+        jsonSchema,
+    };
+    doc.schemas[name] = definition;
+    return definition;
+}
+function updateSchemaRefs(doc, mapping) {
+    const rest = doc.protocols?.rest;
+    const websocket = doc.protocols?.websocket;
+    if (rest?.routes) {
+        for (const route of rest.routes) {
+            for (const params of [route.pathParams, route.queryParams, route.headers]) {
+                if (!params)
+                    continue;
+                for (const p of params) {
+                    if (!p.schemaRef)
+                        continue;
+                    const key = normalizeSchemaRef(p.schemaRef);
+                    const next = mapping[key];
+                    if (next && next !== key)
+                        p.schemaRef = next;
+                }
+            }
+            const requestContent = route.requestBody?.content;
+            if (requestContent) {
+                for (const media of Object.values(requestContent)) {
+                    if (!media.schemaRef)
+                        continue;
+                    const key = normalizeSchemaRef(media.schemaRef);
+                    const next = mapping[key];
+                    if (next && next !== key)
+                        media.schemaRef = next;
+                }
+            }
+            const responses = route.responses;
+            if (responses) {
+                for (const resp of Object.values(responses)) {
+                    const respContent = resp.content;
+                    if (!respContent)
+                        continue;
+                    for (const media of Object.values(respContent)) {
+                        if (!media.schemaRef)
+                            continue;
+                        const key = normalizeSchemaRef(media.schemaRef);
+                        const next = mapping[key];
+                        if (next && next !== key)
+                            media.schemaRef = next;
+                    }
+                }
+            }
+        }
+    }
+    if (websocket?.channels) {
+        for (const channel of websocket.channels) {
+            if (!channel.messages)
+                continue;
+            for (const message of channel.messages) {
+                if (!message.schemaRef)
+                    continue;
+                const key = normalizeSchemaRef(message.schemaRef);
+                const next = mapping[key];
+                if (next && next !== key)
+                    message.schemaRef = next;
+            }
+        }
+    }
+}
+export function dedupeSchemas(doc) {
+    if (!doc.schemas)
+        return;
+    const names = Object.keys(doc.schemas);
+    const hashToName = new Map();
+    const renameMap = {};
+    for (const name of names) {
+        const schema = doc.schemas[name];
+        const hash = stableStringify(schema?.jsonSchema ?? null);
+        const existing = hashToName.get(hash);
+        if (!existing) {
+            hashToName.set(hash, name);
+            continue;
+        }
+        renameMap[name] = existing;
+    }
+    const duplicates = Object.keys(renameMap);
+    if (duplicates.length === 0)
+        return;
+    updateSchemaRefs(doc, renameMap);
+    for (const dup of duplicates) {
+        delete doc.schemas[dup];
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unispechq/unispec-core",
-  "version": "0.2.9",
+  "version": "0.2.10",
   "description": "Central UniSpec Core Engine providing parsing, validation, normalization, diffing, and conversion of UniSpec specs.",
   "license": "MIT",
   "repository": {
@@ -48,7 +48,7 @@
     "release:major": "node scripts/release.js major"
   },
   "dependencies": {
-    "@unispechq/unispec-schema": "^0.3.3",
+    "@unispechq/unispec-schema": "^0.3.4",
     "ajv": "^8.12.0"
   },
   "devDependencies": {