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

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 {
@@ -1040,6 +1040,42 @@ var docOperations = {
       404: { contentType: "application/json", schema: EngineErrorPayloadSchema }
     }
   },
+  "doc.annotations.flatten": {
+    operationId: "doc.annotations.flatten",
+    title: "Flatten annotations",
+    summary: "Flatten a chosen set of one page's annotations into its content \u2014 pages.flatten for a selection. Painted annotations are removed; ineligible ones report skipped.",
+    method: "POST",
+    path: wireTemplates.layerAnnotationItemsFlatten,
+    credentials: docCredentials,
+    scope: [],
+    docCapabilities: ["doc.pages.modify", "doc.annotate.modify"],
+    requestHeaders: [documentPasswordHeader],
+    params: DocPageParamsSchema,
+    body: { contentType: "application/json", schema: looseJson },
+    responses: {
+      200: { contentType: "application/json", schema: MutationResponseSchema },
+      400: { contentType: "application/json", schema: EngineErrorPayloadSchema },
+      404: { contentType: "application/json", schema: EngineErrorPayloadSchema }
+    }
+  },
+  "doc.annotations.exportAppearance": {
+    operationId: "doc.annotations.exportAppearance",
+    title: "Export annotation appearances",
+    summary: "The chosen annotations' appearances as one single-page PDF sized to their union rect \u2014 vector, positions preserved. A read; the source is untouched.",
+    method: "POST",
+    path: wireTemplates.layerAnnotationItemsAppearance,
+    credentials: docCredentials,
+    scope: [],
+    docCapabilities: ["doc.download"],
+    requestHeaders: [documentPasswordHeader],
+    params: DocPageParamsSchema,
+    body: { contentType: "application/json", schema: looseJson },
+    responses: {
+      200: { contentType: "application/pdf" },
+      400: { contentType: "application/json", schema: EngineErrorPayloadSchema },
+      404: { contentType: "application/json", schema: EngineErrorPayloadSchema }
+    }
+  },
   "doc.forms.get": {
     operationId: "doc.forms.get",
     title: "Get form snapshot",
@@ -1179,6 +1215,42 @@ var docOperations = {
       404: { contentType: "application/json", schema: EngineErrorPayloadSchema }
     }
   },
+  "doc.pages.setName": {
+    operationId: "doc.pages.setName",
+    title: "Set page name",
+    summary: "Register or rename a /Names /Pages entry (a named page). A page-structure mutation: the layout version advances.",
+    method: "POST",
+    path: wireTemplates.layerPagesNames,
+    credentials: docCredentials,
+    scope: [],
+    docCapabilities: ["doc.pages.assemble"],
+    requestHeaders: [documentPasswordHeader],
+    params: DocLayerParamsSchema,
+    body: { contentType: "application/json", schema: looseJson },
+    responses: {
+      200: { contentType: "application/json", schema: MutationResponseSchema },
+      400: { contentType: "application/json", schema: EngineErrorPayloadSchema },
+      404: { contentType: "application/json", schema: EngineErrorPayloadSchema }
+    }
+  },
+  "doc.pages.removeName": {
+    operationId: "doc.pages.removeName",
+    title: "Remove page name",
+    summary: "Remove a /Names /Pages entry; the page itself stays.",
+    method: "POST",
+    path: wireTemplates.layerPagesNamesDelete,
+    credentials: docCredentials,
+    scope: [],
+    docCapabilities: ["doc.pages.assemble"],
+    requestHeaders: [documentPasswordHeader],
+    params: DocLayerParamsSchema,
+    body: { contentType: "application/json", schema: looseJson },
+    responses: {
+      200: { contentType: "application/json", schema: MutationResponseSchema },
+      400: { contentType: "application/json", schema: EngineErrorPayloadSchema },
+      404: { contentType: "application/json", schema: EngineErrorPayloadSchema }
+    }
+  },
   "doc.pages.flatten": {
     operationId: "doc.pages.flatten",
     title: "Flatten pages",
@@ -1325,11 +1397,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 +1627,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)]));