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

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, PageInsertBlankSpec, 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
@@ -580,6 +580,15 @@ declare class PagesInserter {
   private readonly session;
   constructor(runtime: PdfRuntimeModule, session: DocumentSession);
   insert(bytes: ArrayBuffer, destIndex: number | undefined, signal: AbortSignal): PageInsertResult;
+  /**
+   * Create `count` blank pages of `size` at `destIndex`. Same mutation
+   * contract as `insert`, but native creation (`FPDFPage_New`) instead of a
+   * deep copy: no source document, so none of the retain-until-close
+   * lifetime hazard above. Each page gets an empty content stream
+   * (`FPDFPage_GenerateContent`) so the saved PDF renders identically in
+   * third-party viewers.
+   */
+  insertBlank(spec: PageInsertBlankSpec, destIndex: number | undefined, signal: AbortSignal): PageInsertResult;
 }
 //#endregion
 //#region src/features/pages/PagesFlattener.d.ts
@@ -1414,6 +1423,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 +1467,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 +1490,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
@@ -1486,6 +1522,7 @@ declare class WorkerHost {
   private handleRedactionApply;
   private handlePagesExtract;
   private handlePagesInsert;
+  private handlePagesInsertBlank;
   private handleAttachmentsList;
   private handleAttachmentsReadFile;
   private handleAttachmentsCreate;
@@ -1499,6 +1536,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 +1595,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, PageInsertBlankSpec, 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
 /**
@@ -580,6 +580,15 @@ declare class PagesInserter {
   private readonly session;
   constructor(runtime: PdfRuntimeModule, session: DocumentSession);
   insert(bytes: ArrayBuffer, destIndex: number | undefined, signal: AbortSignal): PageInsertResult;
+  /**
+   * Create `count` blank pages of `size` at `destIndex`. Same mutation
+   * contract as `insert`, but native creation (`FPDFPage_New`) instead of a
+   * deep copy: no source document, so none of the retain-until-close
+   * lifetime hazard above. Each page gets an empty content stream
+   * (`FPDFPage_GenerateContent`) so the saved PDF renders identically in
+   * third-party viewers.
+   */
+  insertBlank(spec: PageInsertBlankSpec, destIndex: number | undefined, signal: AbortSignal): PageInsertResult;
 }
 //#endregion
 //#region src/features/pages/PagesFlattener.d.ts
@@ -1414,6 +1423,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 +1467,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 +1490,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
@@ -1486,6 +1522,7 @@ declare class WorkerHost {
   private handleRedactionApply;
   private handlePagesExtract;
   private handlePagesInsert;
+  private handlePagesInsertBlank;
   private handleAttachmentsList;
   private handleAttachmentsReadFile;
   private handleAttachmentsCreate;
@@ -1499,6 +1536,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 +1595,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

@@ -1,4 +1,4 @@
-import { AbortError, EMPTY_TRANSFER, EngineError, EngineErrorCode, NO_ANNOTATION_FLAGS, PDF_SUBTYPE_TO_CODE, PdfAnnotationSubtypeCode, UNKNOWN_WEAK_ANNOTATION_STATE, appearanceImpactOf, buildPageTextLayout, buildSnippet, charMapViolation, charRangeForTextOffsets, foldOptionsFor, foldText, invalidatesWeakIndexRefs, isValidPageObjectNumber, knownWeakAnnotationState, matchLiteral, matchRegex, normalizePdfRect, pdfQuadBounds, revisionTokensEqual, serializeError, shiftsExistingAnnotationIndices, sniffBinaryMetadata, subtypeFromCode, textSegmentsForRange, validateSearchQuery, wirePack } from "@embedpdf/engine-core/runtime";
+import { AbortError, EMPTY_TRANSFER, EngineError, EngineErrorCode, NO_ANNOTATION_FLAGS, PAGE_INSERT_BLANK_MAX_COUNT, PDF_SUBTYPE_TO_CODE, PdfAnnotationSubtypeCode, UNKNOWN_WEAK_ANNOTATION_STATE, appearanceImpactOf, buildPageTextLayout, buildSnippet, charMapViolation, charRangeForTextOffsets, foldOptionsFor, foldText, invalidatesWeakIndexRefs, isValidPageObjectNumber, knownWeakAnnotationState, matchLiteral, matchRegex, normalizePdfRect, pdfQuadBounds, revisionTokensEqual, serializeError, shiftsExistingAnnotationIndices, sniffBinaryMetadata, subtypeFromCode, textSegmentsForRange, validateSearchQuery, wirePack } from "@embedpdf/engine-core/runtime";
 import { NULL_PTR } from "@embedpdf/engine-runtime";
 //#region src/runtime/lifecycle/bootstrap.ts
 const initialized = /* @__PURE__ */ new WeakSet();
@@ -1726,6 +1726,42 @@ var PagesInserter = class {
 			cache: null
 		};
 	}
+	/**
+	* Create `count` blank pages of `size` at `destIndex`. Same mutation
+	* contract as `insert`, but native creation (`FPDFPage_New`) instead of a
+	* deep copy: no source document, so none of the retain-until-close
+	* lifetime hazard above. Each page gets an empty content stream
+	* (`FPDFPage_GenerateContent`) so the saved PDF renders identically in
+	* third-party viewers.
+	*/
+	insertBlank(spec, destIndex, signal) {
+		throwIfAborted(signal);
+		const { size } = spec;
+		const count = spec.count ?? 1;
+		if (!Number.isFinite(size?.width) || !Number.isFinite(size?.height) || size.width <= 0 || size.height <= 0) throw new EngineError(EngineErrorCode.InvalidArg, `pages.insertBlank size must have positive finite dimensions, got ${size?.width}x${size?.height}`);
+		if (!Number.isInteger(count) || count < 1 || count > PAGE_INSERT_BLANK_MAX_COUNT) throw new EngineError(EngineErrorCode.InvalidArg, `pages.insertBlank count ${count} out of range [1, ${PAGE_INSERT_BLANK_MAX_COUNT}]`);
+		const { fn } = this.runtime;
+		const destPtr = this.session.requireDocPtr();
+		const beforeCount = fn.FPDF_GetPageCount(destPtr);
+		const at = destIndex ?? beforeCount;
+		if (!Number.isInteger(at) || at < 0 || at > beforeCount) throw new EngineError(EngineErrorCode.InvalidArg, `pages.insertBlank destIndex ${at} out of range [0, ${beforeCount}]`);
+		for (let i = 0; i < count; i++) {
+			const pagePtr = fn.FPDFPage_New(destPtr, at + i, size.width, size.height);
+			if (!pagePtr) {
+				for (let j = 0; j < i; j++) fn.FPDFPage_Delete(destPtr, at);
+				throw new EngineError(EngineErrorCode.Unknown, `FPDFPage_New rejected page ${i + 1}/${count} at index ${at + i}`);
+			}
+			fn.FPDFPage_GenerateContent(pagePtr);
+			fn.FPDF_ClosePage(pagePtr);
+		}
+		this.session.refreshPageRegistry();
+		const layout = new PagesReader(this.runtime, this.session).read(signal);
+		return {
+			insertedPageObjectNumbers: layout.pages.slice(at, at + count).map((page) => page.pageObjectNumber),
+			layout,
+			cache: null
+		};
+	}
 };
 //#endregion
 //#region src/features/annotations/internal/read/annotationReadContext.ts
@@ -9250,9 +9286,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 +9315,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;
@@ -9381,6 +9422,9 @@ var WorkerHost = class {
 				case "pages.insert":
 					resultPack = this.handlePagesInsert(msg, ctrl.signal);
 					break;
+				case "pages.insertBlank":
+					resultPack = this.handlePagesInsertBlank(msg, ctrl.signal);
+					break;
 				case "attachments.list":
 					resultPack = this.handleAttachmentsList(msg, ctrl.signal);
 					break;
@@ -9673,6 +9717,17 @@ var WorkerHost = class {
 			result
 		}, req.artifactPath);
 	}
+	handlePagesInsertBlank(req, signal) {
+		const session = this.requireSession(req);
+		const result = new PagesInserter(this.runtime, session).insertBlank({
+			size: req.size,
+			count: req.count
+		}, req.destIndex, signal);
+		return this.finishMutation(session, {
+			tag: "pages.insertBlank",
+			result
+		}, req.artifactPath);
+	}
 	handleAttachmentsList(req, signal) {
 		const session = this.requireSession(req);
 		return wirePack({
@@ -9765,6 +9820,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);