@embedpdf/plugin-actions 3.0.0-next.11 → 3.0.0-next.13

package/dist/index.js

@@ -1,7 +1,39 @@
 import { n as eventOf, r as originOf, t as ActionsToken } from "./types-DgBMy5nE.js";
 import { n as createHoverPump, t as submitEntriesToUrlEncoded } from "./contract-DAem-EST.js";
 import { DocumentsToken, createEventHook, createSerialQueue, definePlugin } from "@embedpdf/core";
-import { createScriptHost, javaScriptProgramFromActionTree, resolveScriptIdentity, scriptFieldsFromSnapshot, seedFrom } from "@embedpdf/core-acrojs";
+import { DEFAULT_SCRIPT_BUDGET, createScriptHost, javaScriptProgramFromActionTree, resolveScriptIdentity, scriptFieldsFromSnapshot, seedFrom } from "@embedpdf/core-acrojs";
+//#region src/script-environment.ts
+function createScriptRealmFactory(js, identityDoc) {
+	const sandboxFactory = js.sandboxFactory ?? (() => import("@embedpdf/core-js-sandbox").then(({ createQuickJsSandbox }) => createQuickJsSandbox()));
+	const budget = js.budget ?? DEFAULT_SCRIPT_BUDGET;
+	return {
+		budget,
+		realmFor: (target) => createScriptHost({
+			sandboxFactory,
+			document: () => {
+				const meta = target.document();
+				return {
+					id: target.doc.id,
+					fileName: js.fileName?.() ?? meta?.name ?? "document.pdf",
+					pageCount: meta?.pageCount ?? 0,
+					pageNumber: 0
+				};
+			},
+			identity: () => resolveScriptIdentity(identityDoc, js.identity),
+			environment: (sequence) => {
+				const nowMs = js.now?.() ?? Date.now();
+				return {
+					nowMs,
+					utcOffsetMinutes: js.utcOffsetMinutes?.() ?? -new Date(nowMs).getTimezoneOffset(),
+					randomSeed: js.randomSeed?.() ?? seedFrom(target.doc.id, sequence)
+				};
+			},
+			bootSources: target.bootSources,
+			budget
+		})
+	};
+}
+//#endregion
 //#region src/capability.ts
 const ALLOW_ALL = {
 	user: "allow",
@@ -225,35 +257,13 @@ function createActionsCapability(ctx, config = {}) {
 		};
 	};
 	const js = config.javascript;
-	const scriptHost = js?.enabled && ctx.doc ? createScriptHost({
-		sandboxFactory: js.sandboxFactory ?? (() => import("@embedpdf/core-js-sandbox").then(({ createQuickJsSandbox }) => createQuickJsSandbox())),
-		document: () => {
-			const meta = ctx.document();
-			return {
-				id: ctx.documentId ?? "document",
-				fileName: js.fileName?.() ?? meta?.name ?? "document.pdf",
-				pageCount: meta?.pageCount ?? 0,
-				pageNumber: 0
-			};
-		},
-		identity: () => ctx.doc ? resolveScriptIdentity(ctx.doc, js.identity) : {
-			name: "",
-			loginName: "",
-			corporation: "",
-			email: ""
-		},
-		environment: (sequence) => {
-			const nowMs = js.now?.() ?? Date.now();
-			return {
-				nowMs,
-				utcOffsetMinutes: js.utcOffsetMinutes?.() ?? -new Date(nowMs).getTimezoneOffset(),
-				randomSeed: js.randomSeed?.() ?? seedFrom(ctx.documentId ?? "document", sequence)
-			};
-		},
+	const realms = js?.enabled && ctx.doc ? createScriptRealmFactory(js, ctx.doc) : null;
+	const scriptHost = realms && ctx.doc ? realms.realmFor({
+		doc: ctx.doc,
+		document: () => ctx.document(),
 		bootSources: async () => {
 			return ((await readDocumentActions())?.nameTreeScripts ?? []).map(({ action }) => javaScriptProgramFromActionTree(action));
-		},
-		...js.budget ? { budget: js.budget } : {}
+		}
 	}) : null;
 	if (scriptHost) ctx.cleanup(() => scriptHost.dispose());
 	const surfaceScriptResult = (result) => {
@@ -262,6 +272,13 @@ function createActionsCapability(ctx, config = {}) {
 			phase: result.phase
 		};
 		for (const effect of result.uiEffects) {
+			if (result.realm === "detached" && effect.kind !== "alert") {
+				scriptDiagnosticHook.emit({
+					code: "ui-effect-suppressed",
+					message: `script ${effect.kind} request from a detached realm suppressed: no document surface`
+				});
+				continue;
+			}
 			if (effect.kind === "submitForm") {
 				performSubmit(intentOfSubmitEffect(effect), {
 					origin: result.origin,
@@ -302,6 +319,23 @@ function createActionsCapability(ctx, config = {}) {
 		for (const diagnostic of result.diagnostics) scriptDiagnosticHook.emit(diagnostic);
 		if (result.error) scriptErrorHook.emit(result.error);
 	};
+	/** A K/V/C/F commit surfaces as up to two results: the boot phase (only
+	*  when it produced effects) and the user phase (always — it carries the
+	*  diagnostics and the error). */
+	const surfaceScriptCommit = (commit, context) => {
+		for (const phase of ["boot", "user"]) {
+			const uiEffects = commit.uiEffects.filter((effect) => effect.phase === phase);
+			if (uiEffects.length === 0 && phase === "boot") continue;
+			surfaceScriptResult({
+				uiEffects,
+				diagnostics: phase === "user" ? commit.diagnostics : [],
+				...phase === "user" && commit.error ? { error: commit.error } : {},
+				origin: context.origin,
+				phase,
+				realm: context.realm
+			});
+		}
+	};
 	/** Script `doc.submitForm(...)` → the one normalized intent. Script field
 	*  names are include-mode by definition (Acrobat's aFields). */
 	const intentOfSubmitEffect = (effect) => {
@@ -498,7 +532,8 @@ function createActionsCapability(ctx, config = {}) {
 						diagnostics: boot.diagnostics,
 						...boot.error ? { error: boot.error } : {},
 						origin: actionCtx.origin,
-						phase: "boot"
+						phase: "boot",
+						realm: "document"
 					});
 					if (boot.formEffects.length || boot.annotEffects.length) built = await scriptWorldFor(pon);
 				}
@@ -511,7 +546,8 @@ function createActionsCapability(ctx, config = {}) {
 					diagnostics: output.diagnostics,
 					...output.error ? { error: output.error } : {},
 					origin: actionCtx.origin,
-					phase: "user"
+					phase: "user",
+					realm: "document"
 				});
 				if (output.error) return {
 					status: "failed",
@@ -1335,8 +1371,22 @@ function createActionsCapability(ctx, config = {}) {
 				if (formCommitSink === sink) formCommitSink = null;
 			};
 		},
-		...scriptHost ? { scriptTransaction: (body) => scriptHost.transaction(body) } : {},
+		...scriptHost && realms ? {
+			scriptRealm: {
+				transaction: (body) => scriptHost.transaction(body),
+				budget: realms.budget
+			},
+			createDetachedScriptRealm: (target) => {
+				const host = realms.realmFor(target);
+				return {
+					transaction: (body) => host.transaction(body),
+					budget: realms.budget,
+					dispose: () => host.dispose()
+				};
+			}
+		} : {},
 		surfaceScriptResult,
+		surfaceScriptCommit,
 		reportPageState,
 		registerSubmitResolver: (resolver) => {
 			submitResolver = resolver;