@pdfluent/sdk-wasm 1.0.0-beta.17.2 → 1.0.0-beta.17.4

package/package.json

@@ -1,13 +1,9 @@
 {
   "name": "@pdfluent/sdk-wasm",
   "type": "module",
-  "description": "PDFluent browser SDK — read, edit, annotate, redact, sign, and validate PDFs (including XFA) entirely client-side via WASM.",
-  "version": "1.0.0-beta.17.2",
+  "description": "PDFluent browser SDK — find and replace PDF text programmatically while preserving fonts and layout, plus edit, annotate, redact, sign and validate PDFs (including XFA), entirely client-side via WASM.",
+  "version": "1.0.0-beta.17.4",
   "license": "SEE LICENSE IN LICENSE",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/pdfluent/pdfluent"
-  },
   "files": [
     "xfa_wasm_bg.wasm",
     "xfa_wasm.js",
@@ -26,6 +22,10 @@
     "pdfluent",
     "browser",
     "sdk",
+    "pdf-text-replace",
+    "find-and-replace",
+    "edit-pdf-text",
+    "pdf-editor",
     "xfa",
     "acroform",
     "pades",

package/xfa_wasm.d.ts

@@ -502,6 +502,71 @@ export class PdfDocMut {
     setTextRunStyle(page_num: number, runs_json: string, run_index: number, bold?: boolean | null, italic?: boolean | null): string;
 }
 
+/**
+ * Find-and-replace editor over a PDF document (SDK surface, licensed).
+ */
+export class TextEditor {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Find text occurrences. `query_json` is a JSON object:
+     *
+     * ```json
+     * {
+     *   "text": "Acme B.V.",          // required
+     *   "caseInsensitive": false,      // optional
+     *   "pages": [1, 5],               // optional inclusive 1-based range
+     *   "region": {                    // optional
+     *     "page": 1,
+     *     "rect": [x0, y0, x1, y1],
+     *     "relation": "intersects"     // or "contained"
+     *   },
+     *   "limit": 100                   // optional
+     * }
+     * ```
+     *
+     * Returns a JSON array of matches; each match carries an opaque `id`
+     * token valid until the next applied edit on this document.
+     */
+    findText(query_json: string): string;
+    /**
+     * Open a PDF from raw bytes.
+     */
+    static open(data: Uint8Array): TextEditor;
+    /**
+     * Number of pages.
+     */
+    pageCount(): number;
+    /**
+     * Apply per-match replacements located earlier with `findText`.
+     *
+     * `edits_json` is a JSON array of `{"id": "<match token>", "text":
+     * "<replacement>"}`. All edits commit in one atomic transaction under
+     * `options_json` (see [`TextEditor::replace_text`]); the default is
+     * all-or-nothing. Returns the JSON replacement report.
+     */
+    replaceMatches(edits_json: string, options_json: string): string;
+    /**
+     * Find and replace in one call. Returns the JSON replacement report.
+     *
+     * `options_json` may be empty/`"{}"` for defaults, or:
+     *
+     * ```json
+     * {
+     *   "fontFallback": "deny" | "injectStandard" | {"explicit": "F1"},
+     *   "signaturePolicy": "reject" | "allowPostSignatureChange",
+     *   "commitPolicy": "allOrNothing" | "bestEffort"
+     * }
+     * ```
+     */
+    replaceText(query_json: string, replacement: string, options_json: string): string;
+    /**
+     * Serialize the (possibly edited) document to PDF bytes.
+     */
+    save(): Uint8Array;
+}
+
 /**
  * The main XFA processing engine for WASM.
  *
@@ -647,6 +712,7 @@ export interface InitOutput {
     readonly __wbg_licensestatus_free: (a: number, b: number) => void;
     readonly __wbg_pdfdoc_free: (a: number, b: number) => void;
     readonly __wbg_pdfdocmut_free: (a: number, b: number) => void;
+    readonly __wbg_texteditor_free: (a: number, b: number) => void;
     readonly __wbg_xfaengine_free: (a: number, b: number) => void;
     readonly activateLicenseKey: (a: number, b: number, c: number) => void;
     readonly licenseStatus: () => number;
@@ -711,6 +777,12 @@ export interface InitOutput {
     readonly pdfdocmut_setTextRunStyle: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
     readonly setLicensePayload: (a: number, b: number, c: number) => void;
     readonly setLicensePublicKey: (a: number, b: number, c: number) => void;
+    readonly texteditor_findText: (a: number, b: number, c: number, d: number) => void;
+    readonly texteditor_open: (a: number, b: number, c: number) => void;
+    readonly texteditor_pageCount: (a: number) => number;
+    readonly texteditor_replaceMatches: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly texteditor_replaceText: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
+    readonly texteditor_save: (a: number, b: number) => void;
     readonly xfaengine_exportJson: (a: number, b: number) => void;
     readonly xfaengine_exportSchema: (a: number, b: number) => void;
     readonly xfaengine_fromFields: (a: number, b: number, c: number) => void;

package/xfa_wasm.js

@@ -1,5 +1,5 @@
 /* @ts-self-types="./xfa_wasm.d.ts" */
-import { __pdfluent_error_ctor } from './snippets/xfa-wasm-fee712eeb752192d/inline0.js';
+import { __pdfluent_error_ctor } from './snippets/xfa-wasm-f07fc2bb4f3d6191/inline0.js';
 
 
 /**
@@ -1629,6 +1629,215 @@ export class PdfDocMut {
 }
 if (Symbol.dispose) PdfDocMut.prototype[Symbol.dispose] = PdfDocMut.prototype.free;
 
+/**
+ * Find-and-replace editor over a PDF document (SDK surface, licensed).
+ */
+export class TextEditor {
+    static __wrap(ptr) {
+        const obj = Object.create(TextEditor.prototype);
+        obj.__wbg_ptr = ptr;
+        TextEditorFinalization.register(obj, obj.__wbg_ptr, obj);
+        return obj;
+    }
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        TextEditorFinalization.unregister(this);
+        return ptr;
+    }
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_texteditor_free(ptr, 0);
+    }
+    /**
+     * Find text occurrences. `query_json` is a JSON object:
+     *
+     * ```json
+     * {
+     *   "text": "Acme B.V.",          // required
+     *   "caseInsensitive": false,      // optional
+     *   "pages": [1, 5],               // optional inclusive 1-based range
+     *   "region": {                    // optional
+     *     "page": 1,
+     *     "rect": [x0, y0, x1, y1],
+     *     "relation": "intersects"     // or "contained"
+     *   },
+     *   "limit": 100                   // optional
+     * }
+     * ```
+     *
+     * Returns a JSON array of matches; each match carries an opaque `id`
+     * token valid until the next applied edit on this document.
+     * @param {string} query_json
+     * @returns {string}
+     */
+    findText(query_json) {
+        let deferred3_0;
+        let deferred3_1;
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(query_json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.texteditor_findText(retptr, this.__wbg_ptr, ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            var ptr2 = r0;
+            var len2 = r1;
+            if (r3) {
+                ptr2 = 0; len2 = 0;
+                throw takeObject(r2);
+            }
+            deferred3_0 = ptr2;
+            deferred3_1 = len2;
+            return getStringFromWasm0(ptr2, len2);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+            wasm.__wbindgen_export4(deferred3_0, deferred3_1, 1);
+        }
+    }
+    /**
+     * Open a PDF from raw bytes.
+     * @param {Uint8Array} data
+     * @returns {TextEditor}
+     */
+    static open(data) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passArray8ToWasm0(data, wasm.__wbindgen_export);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.texteditor_open(retptr, ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return TextEditor.__wrap(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Number of pages.
+     * @returns {number}
+     */
+    pageCount() {
+        const ret = wasm.texteditor_pageCount(this.__wbg_ptr);
+        return ret >>> 0;
+    }
+    /**
+     * Apply per-match replacements located earlier with `findText`.
+     *
+     * `edits_json` is a JSON array of `{"id": "<match token>", "text":
+     * "<replacement>"}`. All edits commit in one atomic transaction under
+     * `options_json` (see [`TextEditor::replace_text`]); the default is
+     * all-or-nothing. Returns the JSON replacement report.
+     * @param {string} edits_json
+     * @param {string} options_json
+     * @returns {string}
+     */
+    replaceMatches(edits_json, options_json) {
+        let deferred4_0;
+        let deferred4_1;
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(edits_json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            const ptr1 = passStringToWasm0(options_json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len1 = WASM_VECTOR_LEN;
+            wasm.texteditor_replaceMatches(retptr, this.__wbg_ptr, ptr0, len0, ptr1, len1);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            var ptr3 = r0;
+            var len3 = r1;
+            if (r3) {
+                ptr3 = 0; len3 = 0;
+                throw takeObject(r2);
+            }
+            deferred4_0 = ptr3;
+            deferred4_1 = len3;
+            return getStringFromWasm0(ptr3, len3);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+            wasm.__wbindgen_export4(deferred4_0, deferred4_1, 1);
+        }
+    }
+    /**
+     * Find and replace in one call. Returns the JSON replacement report.
+     *
+     * `options_json` may be empty/`"{}"` for defaults, or:
+     *
+     * ```json
+     * {
+     *   "fontFallback": "deny" | "injectStandard" | {"explicit": "F1"},
+     *   "signaturePolicy": "reject" | "allowPostSignatureChange",
+     *   "commitPolicy": "allOrNothing" | "bestEffort"
+     * }
+     * ```
+     * @param {string} query_json
+     * @param {string} replacement
+     * @param {string} options_json
+     * @returns {string}
+     */
+    replaceText(query_json, replacement, options_json) {
+        let deferred5_0;
+        let deferred5_1;
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(query_json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            const ptr1 = passStringToWasm0(replacement, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len1 = WASM_VECTOR_LEN;
+            const ptr2 = passStringToWasm0(options_json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len2 = WASM_VECTOR_LEN;
+            wasm.texteditor_replaceText(retptr, this.__wbg_ptr, ptr0, len0, ptr1, len1, ptr2, len2);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            var ptr4 = r0;
+            var len4 = r1;
+            if (r3) {
+                ptr4 = 0; len4 = 0;
+                throw takeObject(r2);
+            }
+            deferred5_0 = ptr4;
+            deferred5_1 = len4;
+            return getStringFromWasm0(ptr4, len4);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+            wasm.__wbindgen_export4(deferred5_0, deferred5_1, 1);
+        }
+    }
+    /**
+     * Serialize the (possibly edited) document to PDF bytes.
+     * @returns {Uint8Array}
+     */
+    save() {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.texteditor_save(retptr, this.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            if (r3) {
+                throw takeObject(r2);
+            }
+            var v1 = getArrayU8FromWasm0(r0, r1).slice();
+            wasm.__wbindgen_export4(r0, r1 * 1, 1);
+            return v1;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+}
+if (Symbol.dispose) TextEditor.prototype[Symbol.dispose] = TextEditor.prototype.free;
+
 /**
  * The main XFA processing engine for WASM.
  *
@@ -1992,7 +2201,7 @@ export function setLicensePublicKey(public_key) {
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
-        __wbg___pdfluent_error_ctor_7f2eb55a5d661010: function() {
+        __wbg___pdfluent_error_ctor_13a5495e607abf5c: function() {
             const ret = __pdfluent_error_ctor();
             return addHeapObject(ret);
         },
@@ -2194,6 +2403,9 @@ const PdfDocFinalization = (typeof FinalizationRegistry === 'undefined')
 const PdfDocMutFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_pdfdocmut_free(ptr, 1));
+const TextEditorFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_texteditor_free(ptr, 1));
 const XfaEngineFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_xfaengine_free(ptr, 1));

package/xfa_wasm_bg.wasm.d.ts

@@ -4,6 +4,7 @@ export const memory: WebAssembly.Memory;
 export const __wbg_licensestatus_free: (a: number, b: number) => void;
 export const __wbg_pdfdoc_free: (a: number, b: number) => void;
 export const __wbg_pdfdocmut_free: (a: number, b: number) => void;
+export const __wbg_texteditor_free: (a: number, b: number) => void;
 export const __wbg_xfaengine_free: (a: number, b: number) => void;
 export const activateLicenseKey: (a: number, b: number, c: number) => void;
 export const licenseStatus: () => number;
@@ -68,6 +69,12 @@ export const pdfdocmut_setMultiSelect: (a: number, b: number, c: number, d: numb
 export const pdfdocmut_setTextRunStyle: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
 export const setLicensePayload: (a: number, b: number, c: number) => void;
 export const setLicensePublicKey: (a: number, b: number, c: number) => void;
+export const texteditor_findText: (a: number, b: number, c: number, d: number) => void;
+export const texteditor_open: (a: number, b: number, c: number) => void;
+export const texteditor_pageCount: (a: number) => number;
+export const texteditor_replaceMatches: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+export const texteditor_replaceText: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
+export const texteditor_save: (a: number, b: number) => void;
 export const xfaengine_exportJson: (a: number, b: number) => void;
 export const xfaengine_exportSchema: (a: number, b: number) => void;
 export const xfaengine_fromFields: (a: number, b: number, c: number) => void;

package/snippets/xfa-wasm-24036f6340bfe813/inline0.js

@@ -1,19 +0,0 @@
-
-export function __pdfluent_error_ctor() {
-  if (globalThis.__PdfluentError) {
-    return globalThis.__PdfluentError;
-  }
-  class PdfluentError extends Error {
-    constructor(message, code, operation, help, docsUrl, legacyCode) {
-      super(message);
-      this.name = "PdfluentError";
-      this.code = code;
-      this.operation = operation;
-      this.help = help;
-      this.docsUrl = docsUrl;
-      this.legacyCode = legacyCode;
-    }
-  }
-  globalThis.__PdfluentError = PdfluentError;
-  return PdfluentError;
-}

package/snippets/xfa-wasm-312742e1abcfad9e/inline0.js

@@ -1,19 +0,0 @@
-
-export function __pdfluent_error_ctor() {
-  if (globalThis.__PdfluentError) {
-    return globalThis.__PdfluentError;
-  }
-  class PdfluentError extends Error {
-    constructor(message, code, operation, help, docsUrl, legacyCode) {
-      super(message);
-      this.name = "PdfluentError";
-      this.code = code;
-      this.operation = operation;
-      this.help = help;
-      this.docsUrl = docsUrl;
-      this.legacyCode = legacyCode;
-    }
-  }
-  globalThis.__PdfluentError = PdfluentError;
-  return PdfluentError;
-}

package/snippets/xfa-wasm-fee712eeb752192d/inline0.js

@@ -1,19 +0,0 @@
-
-export function __pdfluent_error_ctor() {
-  if (globalThis.__PdfluentError) {
-    return globalThis.__PdfluentError;
-  }
-  class PdfluentError extends Error {
-    constructor(message, code, operation, help, docsUrl, legacyCode) {
-      super(message);
-      this.name = "PdfluentError";
-      this.code = code;
-      this.operation = operation;
-      this.help = help;
-      this.docsUrl = docsUrl;
-      this.legacyCode = legacyCode;
-    }
-  }
-  globalThis.__PdfluentError = PdfluentError;
-  return PdfluentError;
-}