@cloudpdf/contract 3.0.0-next.10 → 3.0.0-next.11

package/dist/openapi.js

@@ -1,7 +1,7 @@
 // src/openapi.ts
-import { EngineErrorPayloadSchema as EngineErrorPayloadSchema2 } from "@embedpdf/engine-core/wire";
+import { EngineErrorPayloadSchema as EngineErrorPayloadSchema2, PdfActionWireComponents } from "@embedpdf/engine-core/wire";
 import { z as z2 } from "zod";
-import { zodToJsonSchema } from "zod-to-json-schema";
+import { ignoreOverride, zodToJsonSchema } from "zod-to-json-schema";
 
 // src/index.ts
 import {
@@ -1325,11 +1325,21 @@ var SECURITY_SCHEME = {
 };
 var ADMIN_ERROR_REF = "#/components/schemas/AdminErrorPayload";
 var ENGINE_ERROR_REF = "#/components/schemas/EngineErrorPayload";
+var SHARED_COMPONENT_SCHEMAS = PdfActionWireComponents;
+var SHARED_COMPONENT_BY_DEFINITION = new Map(
+  Object.entries(SHARED_COMPONENT_SCHEMAS).map(([name, schema]) => [schema._def, name])
+);
+var SHARED_COMPONENT_REFS = new Set(
+  Object.keys(SHARED_COMPONENT_SCHEMAS).map((name) => `#/components/schemas/${name}`)
+);
 function buildAdminOpenApiDocument(opts) {
   const paths = {};
   const schemas = {};
   registerSchema(schemas, "AdminErrorPayload", AdminErrorPayloadSchema);
   registerSchema(schemas, "EngineErrorPayload", EngineErrorPayloadSchema2);
+  for (const [name, schema] of Object.entries(SHARED_COMPONENT_SCHEMAS)) {
+    registerSchema(schemas, name, schema);
+  }
   for (const op of Object.values(allOperations)) {
     assertDocsGroupsCover(op);
     const openApiPath = toOpenApiPath(op.path);
@@ -1545,11 +1555,50 @@ function registerSchema(schemas, name, schema) {
   const referenced = zodToJsonSchema(schema, {
     target: "openApi3",
     $refStrategy: "root",
-    basePath: ["#", ...componentPath]
+    basePath: ["#", ...componentPath],
+    override: (definition) => {
+      const sharedName = SHARED_COMPONENT_BY_DEFINITION.get(definition);
+      if (!sharedName || sharedName === name) return ignoreOverride;
+      return { $ref: `#/components/schemas/${sharedName}` };
+    }
   });
-  schemas[name] = breakAncestorReferences(referenced, componentPath);
+  const canonical = collapseSharedReferenceAliases(referenced, referenced, componentPath);
+  schemas[name] = breakAncestorReferences(canonical, componentPath);
   return { $ref: `#/components/schemas/${name}` };
 }
+function collapseSharedReferenceAliases(value, component, componentPath) {
+  if (Array.isArray(value)) {
+    return value.map((child) => collapseSharedReferenceAliases(child, component, componentPath));
+  }
+  if (!value || typeof value !== "object") return value;
+  const record = value;
+  if (Object.keys(record).length === 1 && typeof record.$ref === "string") {
+    const target = resolveComponentReference(component, record.$ref, componentPath);
+    if (target && typeof target === "object" && !Array.isArray(target)) {
+      const targetRecord = target;
+      if (Object.keys(targetRecord).length === 1 && typeof targetRecord.$ref === "string" && SHARED_COMPONENT_REFS.has(targetRecord.$ref)) {
+        return { $ref: targetRecord.$ref };
+      }
+    }
+  }
+  return Object.fromEntries(
+    Object.entries(record).map(([key, child]) => [
+      key,
+      collapseSharedReferenceAliases(child, component, componentPath)
+    ])
+  );
+}
+function resolveComponentReference(component, reference, componentPath) {
+  if (!reference.startsWith("#/")) return void 0;
+  const target = reference.slice(2).split("/").map((segment) => segment.replaceAll("~1", "/").replaceAll("~0", "~"));
+  if (target.length < componentPath.length || !componentPath.every((segment, index) => target[index] === segment)) {
+    return void 0;
+  }
+  return target.slice(componentPath.length).reduce((current, segment) => {
+    if (!current || typeof current !== "object") return void 0;
+    return current[segment];
+  }, component);
+}
 function breakAncestorReferences(value, path) {
   if (Array.isArray(value)) {
     return value.map((child, index) => breakAncestorReferences(child, [...path, String(index)]));