@cloudpdf/engine 3.0.0-next.8 → 3.0.0-next.9

package/dist/index.cjs

@@ -450,6 +450,13 @@ var CloudDocumentFormsService = class {
 };
 //#endregion
 //#region src/document/CloudDocumentPagesService.ts
+/** Detach a Uint8Array view into a standalone ArrayBuffer (the resource-map
+*  shape) without disturbing a larger buffer the caller still owns. */
+function copyToExactBuffer(view) {
+	const copy = new ArrayBuffer(view.byteLength);
+	new Uint8Array(copy).set(view);
+	return copy;
+}
 /**
 * Cloud-side document pages service. Mirrors `LocalDocumentPagesService`
 * over HTTP: GET /pages for `list`, POST /pages/move for the reorder.
@@ -542,6 +549,46 @@ var CloudDocumentPagesService = class {
 			return result;
 		});
 	}
+	insert(bytes, destIndex) {
+		if (this.isClosed()) return _embedpdf_engine_core_runtime.AbortablePromise.rejectReason(new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.DocNotOpen, `document ${this.docId} is closed`));
+		return _embedpdf_engine_core_runtime.AbortablePromise.run(async (signal) => {
+			const buffer = bytes instanceof ArrayBuffer ? bytes : copyToExactBuffer(bytes);
+			const form = buildMutationForm(destIndex !== void 0 ? { destIndex } : {}, { source: {
+				bytes: buffer,
+				mimeType: "application/pdf",
+				name: "source.pdf"
+			} });
+			const result = await this.http.postMultipartJson(_embedpdf_engine_core_wire.wirePaths.layerPagesInsert(this.docId, this.layerName), form, (raw) => _embedpdf_engine_core_wire.PageInsertResultSchema.parse(raw), signal);
+			if (result.cache) this.manifest.applyPageInsert(result.cache);
+			this.publisher.publishLocal({
+				type: "pages.inserted",
+				destIndex,
+				...result
+			});
+			return result;
+		});
+	}
+	insertBlank(spec, destIndex) {
+		if (this.isClosed()) return _embedpdf_engine_core_runtime.AbortablePromise.rejectReason(new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.DocNotOpen, `document ${this.docId} is closed`));
+		return _embedpdf_engine_core_runtime.AbortablePromise.run(async (signal) => {
+			const result = await this.http.postJson(_embedpdf_engine_core_wire.wirePaths.layerPagesInsertBlank(this.docId, this.layerName), {
+				size: spec.size,
+				...spec.count !== void 0 ? { count: spec.count } : {},
+				...destIndex !== void 0 ? { destIndex } : {}
+			}, (raw) => _embedpdf_engine_core_wire.PageInsertResultSchema.parse(raw), signal);
+			if (result.cache) this.manifest.applyPageInsert(result.cache);
+			this.publisher.publishLocal({
+				type: "pages.inserted",
+				destIndex,
+				...result
+			});
+			return result;
+		});
+	}
+	extract(pageObjectNumbers) {
+		if (this.isClosed()) return _embedpdf_engine_core_runtime.AbortablePromise.rejectReason(new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.DocNotOpen, `document ${this.docId} is closed`));
+		return _embedpdf_engine_core_runtime.AbortablePromise.run(async (signal) => this.http.postJsonBytes(_embedpdf_engine_core_wire.wirePaths.layerPagesExtract(this.docId, this.layerName), { pageObjectNumbers }, signal));
+	}
 	flatten(pageObjectNumbers, usage = "display") {
 		if (this.isClosed()) return _embedpdf_engine_core_runtime.AbortablePromise.rejectReason(new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.DocNotOpen, `document ${this.docId} is closed`));
 		return _embedpdf_engine_core_runtime.AbortablePromise.run(async (signal) => {
@@ -810,8 +857,7 @@ var CloudDocumentSecurityService = class {
 	* and `applyCdnAccess` short-circuits to origin; safe to call always.
 	*/
 	async postAccess(signal, body) {
-		const response = await this.http.postJson(_embedpdf_engine_core_wire.wirePaths.access(this.docId), {
-			layerName: this.layerName,
+		const response = await this.http.postJson(_embedpdf_engine_core_wire.wirePaths.access(this.docId, this.layerName), {
 			...body.password ? { password: body.password } : {},
 			mode: body.mode
 		}, (raw) => _embedpdf_engine_core_wire.AccessResponseSchema.parse(raw), signal);
@@ -1341,6 +1387,12 @@ function auditRowToEvent(row, mySessionId) {
 			origin,
 			...row.payload
 		};
+		case "pages.insert":
+		case "pages.insertBlank": return {
+			type: "pages.inserted",
+			origin,
+			...row.payload
+		};
 		case "pages.flatten": return {
 			type: "pages.flattened",
 			origin,
@@ -1583,6 +1635,7 @@ var CloudDocumentHandle = class {
 			apply: (meta, owns) => this.absorbMutation(meta, owns),
 			applyPageStructure: (cache) => this.absorbPageStructure(cache),
 			applyPageDelete: (cache, deletedPages) => this.absorbPageDelete(cache, deletedPages),
+			applyPageInsert: (cache) => this.absorbPageInsert(cache),
 			applyMetadata: (cache) => this.absorbMetadata(cache),
 			applyAttachments: (cache) => this.absorbAttachments(cache)
 		};
@@ -1748,6 +1801,27 @@ var CloudDocumentHandle = class {
 		};
 	}
 	/**
+	* Patch bookkeeping after a page insert — the mirror of
+	* {@link absorbPageDelete}, with one asymmetry: delete can patch the
+	* cached manifest losslessly (it only REMOVES rows), but an insert needs
+	* manifest rows for the fresh PONs and the result doesn't carry them. So
+	* this absorb flips the planes (insert changes the page SET, so like
+	* delete it owns content + annotations alongside layout), raises the
+	* version floor, and DROPS the cache — the next read refetches a manifest
+	* that includes the new pages' rows. The UI never waits on that refetch:
+	* the mutation result / event already carries the full new layout.
+	*/
+	absorbPageInsert(cache) {
+		this.flipScopes([
+			"layout",
+			"content",
+			"annotations"
+		]);
+		this.manifestFloorVersion = Math.max(this.manifestFloorVersion, cache.docVersion);
+		this.inflightManifest = null;
+		this.manifestCache = null;
+	}
+	/**
 	* Patch the cached manifest after a metadata write. Symmetric with
 	* {@link absorbPageMove}: a metadata edit advances `docVersion` (so leaf
 	* URLs re-resolve) and `metadataVersion` (so the /metadata leaf re-fetches),
@@ -1883,6 +1957,9 @@ var CloudDocumentHandle = class {
 			case "pages.deleted":
 				if (event.cache) this.absorbPageDelete(event.cache, event.pageObjectNumbers);
 				return;
+			case "pages.inserted":
+				if (event.cache) this.absorbPageInsert(event.cache);
+				return;
 			case "metadata.updated":
 				if (event.cache) this.absorbMetadata(event.cache);
 				return;
@@ -1934,7 +2011,7 @@ function fallbackUnknownHead(id) {
 		access: {
 			required: true,
 			reasons: ["permissions-unknown"],
-			endpoint: _embedpdf_engine_core_wire.wirePaths.access(id)
+			endpoint: _embedpdf_engine_core_wire.wirePaths.access(id, _embedpdf_engine_core_wire.DEFAULT_LAYER_NAME)
 		}
 	};
 }
@@ -2051,7 +2128,7 @@ var HttpClient = class HttpClient {
 		this.tokenFn = token === void 0 ? null : typeof token === "function" ? token : () => token;
 		this.sessionId = opts.sessionId ?? null;
 		this.fetchFn = opts.fetch ?? globalThis.fetch.bind(globalThis);
-		this.docAffinityHeader = opts.docAffinityHeader ?? false;
+		this.docAffinityHeader = opts.docAffinityHeader ?? true;
 		this.onRetry = opts.onRetry;
 	}
 	/** Normalized server base URL (no trailing slash). */
@@ -2283,6 +2360,12 @@ var HttpClient = class HttpClient {
 		const res = await this.requestJson(path, "POST", body, signal);
 		return await this.parseJsonResponse(res, parser);
 	}
+	/** POST a JSON body and return the raw binary response (pages.extract). */
+	async postJsonBytes(path, body, signal) {
+		const res = await this.requestJson(path, "POST", body, signal);
+		if (!res.ok) await this.throwFromBody(res);
+		return new Uint8Array(await res.arrayBuffer());
+	}
 	/** POST a raw binary body (FDF/XFDF import) and parse the JSON response. */
 	async postBytesJson(path, bytes, contentType, parser, signal) {
 		const headers = new Headers({ "Content-Type": contentType });