@embedpdf/engine-services 3.0.0-next.7 → 3.0.0-next.8

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { PdfFunctions, PdfRuntimeMemory, PdfRuntimeModule, Ptr } from "@embedpdf/engine-runtime";
-import { ActionReadBudget, AnnotationActor, AnnotationAppearanceRenderOptions, AnnotationAppearancesResult, AnnotationCreateResult, AnnotationDeleteResult, AnnotationListMutationMeta, AnnotationListPageSnapshot, AnnotationListSnapshotAllPages, AnnotationMoveResult, AnnotationMutationKind, AnnotationRef, AnnotationStableId, AnnotationUpdateResult, AttachmentCreateResult, AttachmentDeleteResult, AttachmentFileInfo, AttachmentFileWorkerPayload, DocumentActionsSnapshot, DocumentEvent, DocumentEventInit, DocumentEventStream, DocumentMetadata, DocumentSecurityProbeInfo, EmbeddedFileItem, EmbeddedFileRef, FormDataFormat, FormEffect, FormEffectsResult, FormFieldDTO, FormFieldDraft, FormFieldPatch, FormFieldRef, FormFieldValue, FormImportResult, FormRepairResult, FormSetValueResult, FormSnapshot, FormWidgetRef, MetadataPatch, MetadataUpdateResult, PageDeleteResult, PageFlattenResult, PageFlattenUsage, PageGeometryRun, PageGeometrySnapshot, PageInsertResult, PageListSnapshot, PageMoveResult, PageObjectNumber, PageRenderOptions, PageRotateResult, PageRotation, PageState, PageTextSnapshot, PdfActionTree, PdfQuad, PdfRect, PdfSaveMode, RedactionApplyResult, RedactionApplyScope, RevisionToken, SearchRequest, SearchSlice, WeakAnnotationState, WireAnnotationDraft, WireAnnotationPatch, WireAttachmentFile, WirePack, WireResource, WireResourceMap, WorkerRequest, WorkerResponse } from "@embedpdf/engine-core/runtime";
+import { ActionReadBudget, AnnotationActor, AnnotationAppearanceRenderOptions, AnnotationAppearancesResult, AnnotationCreateResult, AnnotationDeleteResult, AnnotationListMutationMeta, AnnotationListPageSnapshot, AnnotationListSnapshotAllPages, AnnotationMoveResult, AnnotationMutationKind, AnnotationRef, AnnotationStableId, AnnotationUpdateResult, AttachmentCreateResult, AttachmentDeleteResult, AttachmentFileInfo, AttachmentFileWorkerPayload, DocumentActionsSnapshot, DocumentEvent, DocumentEventInit, DocumentEventStream, DocumentMetadata, DocumentSecurityProbeInfo, EmbeddedFileItem, EmbeddedFileRef, FormDataFormat, FormEffect, FormEffectsResult, FormFieldDTO, FormFieldDraft, FormFieldPatch, FormFieldRef, FormFieldValue, FormImportResult, FormRepairResult, FormSetValueResult, FormSnapshot, FormWidgetRef, MetadataPatch, MetadataUpdateResult, PageDeleteResult, PageFlattenResult, PageFlattenUsage, PageGeometryRun, PageGeometrySnapshot, PageInsertResult, PageListSnapshot, PageMoveResult, PageNetworkRenderFormat, PageObjectNumber, PageRaster, PageRenderOptions, PageRotateResult, PageRotation, PageState, PageTextSnapshot, PdfActionTree, PdfQuad, PdfRect, PdfSaveMode, RedactionApplyResult, RedactionApplyScope, RevisionToken, SearchRequest, SearchSlice, WeakAnnotationState, WireAnnotationDraft, WireAnnotationPatch, WireAttachmentFile, WirePack, WireResource, WireResourceMap, WorkerRequest, WorkerResponse } from "@embedpdf/engine-core/runtime";
 //#region src/runtime/lifecycle/bootstrap.d.ts
 /**
  * Initialize the thread-confined PDFium runtime for the calling thread. Each
@@ -1414,6 +1414,29 @@ declare class DocumentActionsReader {
 }
 //#endregion
 //#region src/worker-host/WorkerHost.d.ts
+/** The image a {@link WorkerImageEncoder} produced. `bytes` must OWN its
+ *  buffer (a fresh allocation, not a pooled `Buffer` slab view) — it is
+ *  placed on the transfer manifest and moved zero-copy. */
+interface WorkerEncodedImage {
+  contentType: string;
+  bytes: Uint8Array;
+}
+/**
+ * Injected image-encode capability for the `*.renderEncoded` wire kinds.
+ * Dependency inversion keeps the native encoder OUT of this shared
+ * package: the cloud server's worker entry injects a sharp/libvips
+ * implementation; browser/local entries inject nothing (they encode via
+ * canvas) and the encoded kinds reject with `NotImplemented`.
+ */
+interface WorkerImageEncoder {
+  encode(raster: PageRaster, opts: {
+    format: PageNetworkRenderFormat;
+    quality?: number;
+  }): Promise<WorkerEncodedImage>;
+}
+interface WorkerHostOptions {
+  imageEncoder?: WorkerImageEncoder;
+}
 /**
  * The piece that runs "inside the worker": owns runtime, manages document
  * sessions, dispatches requests to the engine-services synchronous code.
@@ -1435,6 +1458,8 @@ declare class WorkerHost {
    * runs in.
    */
   private readonly post;
+  /** Optional capabilities. See {@link WorkerHostOptions}. */
+  private readonly options;
   private readonly sessions;
   private readonly baseDocuments;
   private readonly aborts;
@@ -1456,7 +1481,9 @@ declare class WorkerHost {
    * pack.transfer)` — the host doesn't know which environment it
    * runs in.
    */
-  post: (pack: WirePack<WorkerResponse>) => void);
+  post: (pack: WirePack<WorkerResponse>) => void,
+  /** Optional capabilities. See {@link WorkerHostOptions}. */
+  options?: WorkerHostOptions);
   /**
    * Register deployment-owned fonts on this worker thread, after init and
    * before serving requests. Server-only: the cloud engine never exposes font
@@ -1499,6 +1526,11 @@ declare class WorkerHost {
   private handlePagesGeometry;
   private handleSearchQuery;
   private handlePagesRender;
+  private receiveEncoded;
+  private encodeRaster;
+  private handlePagesRenderEncoded;
+  private handleDocumentRenderPageFileEncoded;
+  private handleAnnotationsRenderAppearancesEncoded;
   private handleDocumentSaveBuffer;
   private handleDocumentSaveFile;
   private handleDocumentSaveLayerBuffer;
@@ -1553,5 +1585,5 @@ declare class WorkerHost {
   private saveLayerArtifact;
 }
 //#endregion
-export { ALL_STANDARD_SECURITY_PERMISSIONS, type AcquiredBaseDocument, ActionReadBudgetTracker, AnnotationAppearanceReader, AnnotationMutator, AnnotationReader, AttachmentMutator, AttachmentReader, BaseDocumentRegistry, CloseStack, DocumentActionsReader, PagesMutator as DocumentPagesMutator, PagesMutator, DocumentSaver, DocumentSession, EPDF_CHAR_GEOMETRY_LAYOUT, EventHub, FontRegistrar, FormMutator, FormReader, FormsEffectsApplier, type ImpactInputs, type LayerSource, LocalRevisionAuthority, MetadataMutator, MetadataReader, type MutationKind, type OpenedPdfDocument, type OpenedPdfDocumentKind, PageGeometryReader, PagesReader as PageLayoutReader, PagesReader, PagePtrPool, PageRenderReader as PageRasterReader, PageRenderReader, type PageRecord, PageTextReader, PagesExtractor, PagesFlattener, PagesInserter, RawAnnotationReader, type RawGeometryGlyphRecord, RedactionApplier, type RevisionAuthority, SearchReader, SecurityReader, SessionEventPublisher, type StartupFontSpec, WorkerHost, buildRunsFromRawGlyphs, computeMutationImpact, destroyLibrary, disposeFormModel, ensureInitialized, formatPdfDate, generateUuid, hasAllStandardSecurityPermissions, normalizeU32, openFatMemoryDocument, openLayerDocument, pdfDateToIso, readActionModel, readAttachmentFileInfo, throwIfAborted, writeAttachmentFilePayload };
+export { ALL_STANDARD_SECURITY_PERMISSIONS, type AcquiredBaseDocument, ActionReadBudgetTracker, AnnotationAppearanceReader, AnnotationMutator, AnnotationReader, AttachmentMutator, AttachmentReader, BaseDocumentRegistry, CloseStack, DocumentActionsReader, PagesMutator as DocumentPagesMutator, PagesMutator, DocumentSaver, DocumentSession, EPDF_CHAR_GEOMETRY_LAYOUT, EventHub, FontRegistrar, FormMutator, FormReader, FormsEffectsApplier, type ImpactInputs, type LayerSource, LocalRevisionAuthority, MetadataMutator, MetadataReader, type MutationKind, type OpenedPdfDocument, type OpenedPdfDocumentKind, PageGeometryReader, PagesReader as PageLayoutReader, PagesReader, PagePtrPool, PageRenderReader as PageRasterReader, PageRenderReader, type PageRecord, PageTextReader, PagesExtractor, PagesFlattener, PagesInserter, RawAnnotationReader, type RawGeometryGlyphRecord, RedactionApplier, type RevisionAuthority, SearchReader, SecurityReader, SessionEventPublisher, type StartupFontSpec, type WorkerEncodedImage, WorkerHost, type WorkerHostOptions, type WorkerImageEncoder, buildRunsFromRawGlyphs, computeMutationImpact, destroyLibrary, disposeFormModel, ensureInitialized, formatPdfDate, generateUuid, hasAllStandardSecurityPermissions, normalizeU32, openFatMemoryDocument, openLayerDocument, pdfDateToIso, readActionModel, readAttachmentFileInfo, throwIfAborted, writeAttachmentFilePayload };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ActionReadBudget, AnnotationActor, AnnotationAppearanceRenderOptions, AnnotationAppearancesResult, AnnotationCreateResult, AnnotationDeleteResult, AnnotationListMutationMeta, AnnotationListPageSnapshot, AnnotationListSnapshotAllPages, AnnotationMoveResult, AnnotationMutationKind, AnnotationRef, AnnotationStableId, AnnotationUpdateResult, AttachmentCreateResult, AttachmentDeleteResult, AttachmentFileInfo, AttachmentFileWorkerPayload, DocumentActionsSnapshot, DocumentEvent, DocumentEventInit, DocumentEventStream, DocumentMetadata, DocumentSecurityProbeInfo, EmbeddedFileItem, EmbeddedFileRef, FormDataFormat, FormEffect, FormEffectsResult, FormFieldDTO, FormFieldDraft, FormFieldPatch, FormFieldRef, FormFieldValue, FormImportResult, FormRepairResult, FormSetValueResult, FormSnapshot, FormWidgetRef, MetadataPatch, MetadataUpdateResult, PageDeleteResult, PageFlattenResult, PageFlattenUsage, PageGeometryRun, PageGeometrySnapshot, PageInsertResult, PageListSnapshot, PageMoveResult, PageObjectNumber, PageRenderOptions, PageRotateResult, PageRotation, PageState, PageTextSnapshot, PdfActionTree, PdfQuad, PdfRect, PdfSaveMode, RedactionApplyResult, RedactionApplyScope, RevisionToken, SearchRequest, SearchSlice, WeakAnnotationState, WireAnnotationDraft, WireAnnotationPatch, WireAttachmentFile, WirePack, WireResource, WireResourceMap, WorkerRequest, WorkerResponse } from "@embedpdf/engine-core/runtime";
+import { ActionReadBudget, AnnotationActor, AnnotationAppearanceRenderOptions, AnnotationAppearancesResult, AnnotationCreateResult, AnnotationDeleteResult, AnnotationListMutationMeta, AnnotationListPageSnapshot, AnnotationListSnapshotAllPages, AnnotationMoveResult, AnnotationMutationKind, AnnotationRef, AnnotationStableId, AnnotationUpdateResult, AttachmentCreateResult, AttachmentDeleteResult, AttachmentFileInfo, AttachmentFileWorkerPayload, DocumentActionsSnapshot, DocumentEvent, DocumentEventInit, DocumentEventStream, DocumentMetadata, DocumentSecurityProbeInfo, EmbeddedFileItem, EmbeddedFileRef, FormDataFormat, FormEffect, FormEffectsResult, FormFieldDTO, FormFieldDraft, FormFieldPatch, FormFieldRef, FormFieldValue, FormImportResult, FormRepairResult, FormSetValueResult, FormSnapshot, FormWidgetRef, MetadataPatch, MetadataUpdateResult, PageDeleteResult, PageFlattenResult, PageFlattenUsage, PageGeometryRun, PageGeometrySnapshot, PageInsertResult, PageListSnapshot, PageMoveResult, PageNetworkRenderFormat, PageObjectNumber, PageRaster, PageRenderOptions, PageRotateResult, PageRotation, PageState, PageTextSnapshot, PdfActionTree, PdfQuad, PdfRect, PdfSaveMode, RedactionApplyResult, RedactionApplyScope, RevisionToken, SearchRequest, SearchSlice, WeakAnnotationState, WireAnnotationDraft, WireAnnotationPatch, WireAttachmentFile, WirePack, WireResource, WireResourceMap, WorkerRequest, WorkerResponse } from "@embedpdf/engine-core/runtime";
 import { PdfFunctions, PdfRuntimeMemory, PdfRuntimeModule, Ptr } from "@embedpdf/engine-runtime";
 //#region src/runtime/lifecycle/bootstrap.d.ts
 /**
@@ -1414,6 +1414,29 @@ declare class DocumentActionsReader {
 }
 //#endregion
 //#region src/worker-host/WorkerHost.d.ts
+/** The image a {@link WorkerImageEncoder} produced. `bytes` must OWN its
+ *  buffer (a fresh allocation, not a pooled `Buffer` slab view) — it is
+ *  placed on the transfer manifest and moved zero-copy. */
+interface WorkerEncodedImage {
+  contentType: string;
+  bytes: Uint8Array;
+}
+/**
+ * Injected image-encode capability for the `*.renderEncoded` wire kinds.
+ * Dependency inversion keeps the native encoder OUT of this shared
+ * package: the cloud server's worker entry injects a sharp/libvips
+ * implementation; browser/local entries inject nothing (they encode via
+ * canvas) and the encoded kinds reject with `NotImplemented`.
+ */
+interface WorkerImageEncoder {
+  encode(raster: PageRaster, opts: {
+    format: PageNetworkRenderFormat;
+    quality?: number;
+  }): Promise<WorkerEncodedImage>;
+}
+interface WorkerHostOptions {
+  imageEncoder?: WorkerImageEncoder;
+}
 /**
  * The piece that runs "inside the worker": owns runtime, manages document
  * sessions, dispatches requests to the engine-services synchronous code.
@@ -1435,6 +1458,8 @@ declare class WorkerHost {
    * runs in.
    */
   private readonly post;
+  /** Optional capabilities. See {@link WorkerHostOptions}. */
+  private readonly options;
   private readonly sessions;
   private readonly baseDocuments;
   private readonly aborts;
@@ -1456,7 +1481,9 @@ declare class WorkerHost {
    * pack.transfer)` — the host doesn't know which environment it
    * runs in.
    */
-  post: (pack: WirePack<WorkerResponse>) => void);
+  post: (pack: WirePack<WorkerResponse>) => void,
+  /** Optional capabilities. See {@link WorkerHostOptions}. */
+  options?: WorkerHostOptions);
   /**
    * Register deployment-owned fonts on this worker thread, after init and
    * before serving requests. Server-only: the cloud engine never exposes font
@@ -1499,6 +1526,11 @@ declare class WorkerHost {
   private handlePagesGeometry;
   private handleSearchQuery;
   private handlePagesRender;
+  private receiveEncoded;
+  private encodeRaster;
+  private handlePagesRenderEncoded;
+  private handleDocumentRenderPageFileEncoded;
+  private handleAnnotationsRenderAppearancesEncoded;
   private handleDocumentSaveBuffer;
   private handleDocumentSaveFile;
   private handleDocumentSaveLayerBuffer;
@@ -1553,5 +1585,5 @@ declare class WorkerHost {
   private saveLayerArtifact;
 }
 //#endregion
-export { ALL_STANDARD_SECURITY_PERMISSIONS, type AcquiredBaseDocument, ActionReadBudgetTracker, AnnotationAppearanceReader, AnnotationMutator, AnnotationReader, AttachmentMutator, AttachmentReader, BaseDocumentRegistry, CloseStack, DocumentActionsReader, PagesMutator as DocumentPagesMutator, PagesMutator, DocumentSaver, DocumentSession, EPDF_CHAR_GEOMETRY_LAYOUT, EventHub, FontRegistrar, FormMutator, FormReader, FormsEffectsApplier, type ImpactInputs, type LayerSource, LocalRevisionAuthority, MetadataMutator, MetadataReader, type MutationKind, type OpenedPdfDocument, type OpenedPdfDocumentKind, PageGeometryReader, PagesReader as PageLayoutReader, PagesReader, PagePtrPool, PageRenderReader as PageRasterReader, PageRenderReader, type PageRecord, PageTextReader, PagesExtractor, PagesFlattener, PagesInserter, RawAnnotationReader, type RawGeometryGlyphRecord, RedactionApplier, type RevisionAuthority, SearchReader, SecurityReader, SessionEventPublisher, type StartupFontSpec, WorkerHost, buildRunsFromRawGlyphs, computeMutationImpact, destroyLibrary, disposeFormModel, ensureInitialized, formatPdfDate, generateUuid, hasAllStandardSecurityPermissions, normalizeU32, openFatMemoryDocument, openLayerDocument, pdfDateToIso, readActionModel, readAttachmentFileInfo, throwIfAborted, writeAttachmentFilePayload };
+export { ALL_STANDARD_SECURITY_PERMISSIONS, type AcquiredBaseDocument, ActionReadBudgetTracker, AnnotationAppearanceReader, AnnotationMutator, AnnotationReader, AttachmentMutator, AttachmentReader, BaseDocumentRegistry, CloseStack, DocumentActionsReader, PagesMutator as DocumentPagesMutator, PagesMutator, DocumentSaver, DocumentSession, EPDF_CHAR_GEOMETRY_LAYOUT, EventHub, FontRegistrar, FormMutator, FormReader, FormsEffectsApplier, type ImpactInputs, type LayerSource, LocalRevisionAuthority, MetadataMutator, MetadataReader, type MutationKind, type OpenedPdfDocument, type OpenedPdfDocumentKind, PageGeometryReader, PagesReader as PageLayoutReader, PagesReader, PagePtrPool, PageRenderReader as PageRasterReader, PageRenderReader, type PageRecord, PageTextReader, PagesExtractor, PagesFlattener, PagesInserter, RawAnnotationReader, type RawGeometryGlyphRecord, RedactionApplier, type RevisionAuthority, SearchReader, SecurityReader, SessionEventPublisher, type StartupFontSpec, type WorkerEncodedImage, WorkerHost, type WorkerHostOptions, type WorkerImageEncoder, buildRunsFromRawGlyphs, computeMutationImpact, destroyLibrary, disposeFormModel, ensureInitialized, formatPdfDate, generateUuid, hasAllStandardSecurityPermissions, normalizeU32, openFatMemoryDocument, openLayerDocument, pdfDateToIso, readActionModel, readAttachmentFileInfo, throwIfAborted, writeAttachmentFilePayload };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -9250,9 +9250,10 @@ function validatePatchValue(key, value) {
 * worker wire shape from @embedpdf/engine-core.
 */
 var WorkerHost = class {
-	constructor(runtime, post) {
+	constructor(runtime, post, options = {}) {
 		this.runtime = runtime;
 		this.post = post;
+		this.options = options;
 		_defineProperty(this, "sessions", /* @__PURE__ */ new Map());
 		_defineProperty(this, "baseDocuments", void 0);
 		_defineProperty(this, "aborts", /* @__PURE__ */ new Map());
@@ -9278,6 +9279,10 @@ var WorkerHost = class {
 			this.aborts.get(msg.jobId)?.abort();
 			return;
 		}
+		if (msg.kind === "pages.renderEncoded" || msg.kind === "document.renderPageFileEncoded" || msg.kind === "annotations.renderAppearancesEncoded") {
+			this.receiveEncoded(msg);
+			return;
+		}
 		const ctrl = new AbortController();
 		this.aborts.set(msg.jobId, ctrl);
 		let resultPack;
@@ -9765,6 +9770,105 @@ var WorkerHost = class {
 			raster
 		}, [raster.data]);
 	}
+	async receiveEncoded(msg) {
+		if (!this.options.imageEncoder) {
+			this.post(wirePack({
+				kind: "reject",
+				jobId: msg.jobId,
+				error: serializeError(new EngineError(EngineErrorCode.NotImplemented, "this engine has no image encoder (the *.renderEncoded kinds are cloud-server surface)"))
+			}, EMPTY_TRANSFER));
+			return;
+		}
+		const ctrl = new AbortController();
+		this.aborts.set(msg.jobId, ctrl);
+		try {
+			let resultPack;
+			switch (msg.kind) {
+				case "pages.renderEncoded":
+					resultPack = await this.handlePagesRenderEncoded(msg, ctrl.signal);
+					break;
+				case "document.renderPageFileEncoded":
+					resultPack = await this.handleDocumentRenderPageFileEncoded(msg, ctrl.signal);
+					break;
+				case "annotations.renderAppearancesEncoded":
+					resultPack = await this.handleAnnotationsRenderAppearancesEncoded(msg, ctrl.signal);
+					break;
+			}
+			this.post(wirePack({
+				kind: "resolve",
+				jobId: msg.jobId,
+				result: resultPack.payload
+			}, resultPack.transfer));
+		} catch (err) {
+			this.post(wirePack({
+				kind: "reject",
+				jobId: msg.jobId,
+				error: serializeError(err)
+			}, EMPTY_TRANSFER));
+		} finally {
+			this.aborts.delete(msg.jobId);
+		}
+	}
+	async encodeRaster(raster, encode, signal) {
+		const encoder = this.options.imageEncoder;
+		if (!encoder) throw new EngineError(EngineErrorCode.NotImplemented, "this engine has no image encoder (the *.renderEncoded kinds are cloud-server surface)");
+		const { bytes, contentType } = await encoder.encode(raster, encode);
+		if (signal.aborted) throw new EngineError(EngineErrorCode.Aborted, "aborted during image encode");
+		return {
+			contentType,
+			width: raster.width,
+			height: raster.height,
+			bytes
+		};
+	}
+	async handlePagesRenderEncoded(req, signal) {
+		const inner = this.handlePagesRender({
+			...req,
+			kind: "pages.render"
+		}, signal);
+		if (inner.payload.tag !== "pages.render") throw new EngineError(EngineErrorCode.WireFormat, `unexpected ${inner.payload.tag}`);
+		const image = await this.encodeRaster(inner.payload.raster, req.encode, signal);
+		return wirePack({
+			tag: "pages.renderEncoded",
+			image
+		}, [image.bytes.buffer]);
+	}
+	async handleDocumentRenderPageFileEncoded(req, signal) {
+		const inner = this.handleDocumentRenderPageFile({
+			...req,
+			kind: "document.renderPageFile"
+		}, signal);
+		if (inner.payload.tag !== "document.renderPageFile") throw new EngineError(EngineErrorCode.WireFormat, `unexpected ${inner.payload.tag}`);
+		const image = await this.encodeRaster(inner.payload.raster, req.encode, signal);
+		return wirePack({
+			tag: "document.renderPageFileEncoded",
+			pageObjectNumber: inner.payload.pageObjectNumber,
+			pageCount: inner.payload.pageCount,
+			image
+		}, [image.bytes.buffer]);
+	}
+	async handleAnnotationsRenderAppearancesEncoded(req, signal) {
+		const inner = this.handleAnnotationsRenderAppearances({
+			...req,
+			kind: "annotations.renderAppearances"
+		}, signal);
+		if (inner.payload.tag !== "annotations.renderAppearances") throw new EngineError(EngineErrorCode.WireFormat, `unexpected ${inner.payload.tag}`);
+		const { pageState, appearances } = inner.payload.result;
+		const encoded = [];
+		for (const a of appearances) encoded.push({
+			ref: a.ref,
+			mode: a.mode,
+			rect: a.rect,
+			image: await this.encodeRaster(a.raster, req.encode, signal)
+		});
+		return wirePack({
+			tag: "annotations.renderAppearancesEncoded",
+			result: {
+				pageState,
+				appearances: encoded
+			}
+		}, encoded.map((e) => e.image.bytes.buffer));
+	}
 	handleDocumentSaveBuffer(req) {
 		const session = this.requireSession(req);
 		const saved = new DocumentSaver(this.runtime, session).saveStandaloneToBuffer(req.mode);