pdf-oxide-fips 0.3.47

package/lib/managers/xfa-manager.js

@@ -0,0 +1,539 @@
+/**
+ * XfaManager - Canonical XFA Manager (merged from 3 implementations)
+ *
+ * Consolidates:
+ * - src/xfa-manager.ts XfaManager (detection + parsing + basic conversion)
+ * - src/managers/advanced-features.ts XFAManager (field operations + data import/export)
+ * - src/managers/xfa-creation-manager.ts XfaCreationManager (form creation + scripting)
+ *
+ * Provides complete XFA form operations.
+ */
+import { EventEmitter } from 'events';
+// =============================================================================
+// Type Definitions (merged from all 3 sources)
+// =============================================================================
+export var XfaFormType;
+(function (XfaFormType) {
+    XfaFormType["STATIC"] = "static";
+    XfaFormType["DYNAMIC"] = "dynamic";
+})(XfaFormType || (XfaFormType = {}));
+export var XfaFieldType;
+(function (XfaFieldType) {
+    XfaFieldType["TEXT"] = "text";
+    XfaFieldType["NUMERIC"] = "numeric";
+    XfaFieldType["DATE"] = "date";
+    XfaFieldType["TIME"] = "time";
+    XfaFieldType["DATETIME"] = "datetime";
+    XfaFieldType["CHECKBOX"] = "checkbox";
+    XfaFieldType["RADIO"] = "radio";
+    XfaFieldType["DROPDOWN"] = "dropdown";
+    XfaFieldType["LISTBOX"] = "listbox";
+    XfaFieldType["BUTTON"] = "button";
+    XfaFieldType["SIGNATURE"] = "signature";
+    XfaFieldType["IMAGE"] = "image";
+    XfaFieldType["BARCODE"] = "barcode";
+    XfaFieldType["PASSWORD"] = "password";
+})(XfaFieldType || (XfaFieldType = {}));
+export var XfaValidationType;
+(function (XfaValidationType) {
+    XfaValidationType["NONE"] = "none";
+    XfaValidationType["REQUIRED"] = "required";
+    XfaValidationType["PATTERN"] = "pattern";
+    XfaValidationType["RANGE"] = "range";
+    XfaValidationType["CUSTOM"] = "custom";
+})(XfaValidationType || (XfaValidationType = {}));
+export var XfaBindingType;
+(function (XfaBindingType) {
+    XfaBindingType["NORMAL"] = "normal";
+    XfaBindingType["NONE"] = "none";
+    XfaBindingType["GLOBAL"] = "global";
+})(XfaBindingType || (XfaBindingType = {}));
+// =============================================================================
+// Canonical XfaManager
+// =============================================================================
+/**
+ * Canonical XFA Manager - all XFA operations in one class.
+ */
+export class XfaManager extends EventEmitter {
+    constructor(document) {
+        super();
+        this.cache = new Map();
+        this.maxCacheSize = 100;
+        this.createdFields = new Map();
+        this.formCreated = false;
+        this.currentFormId = null;
+        if (!document)
+            throw new Error('Document cannot be null or undefined');
+        this.document = document;
+    }
+    // ===========================================================================
+    // Detection & Parsing (from root XfaManager)
+    // ===========================================================================
+    hasXfa() {
+        const cacheKey = 'has_xfa';
+        if (this.cache.has(cacheKey))
+            return this.cache.get(cacheKey);
+        try {
+            const result = this.document?.hasXfa?.() ?? false;
+            this.updateCache(cacheKey, result);
+            return result;
+        }
+        catch {
+            return false;
+        }
+    }
+    parseXfaForm() {
+        if (!this.hasXfa())
+            throw new Error('Document does not contain XFA forms');
+        try {
+            const fields = this.document?.getXfaFields?.() ?? [];
+            return { type: 'xfa_form', document: this.document, fields };
+        }
+        catch {
+            return { type: 'xfa_form', document: this.document, fields: [] };
+        }
+    }
+    extractFieldData() {
+        const form = this.parseXfaForm();
+        const result = {};
+        if (form.fields && Array.isArray(form.fields)) {
+            for (const field of form.fields) {
+                result[field.name || ''] = field.value;
+            }
+        }
+        return result;
+    }
+    getDatasetXml() {
+        try {
+            return this.document?.getXfaDatasetXml?.() ?? '';
+        }
+        catch {
+            return '';
+        }
+    }
+    convertToAcroForm() {
+        if (!this.hasXfa())
+            return false;
+        try {
+            return this.document?.convertXfaToAcroform?.() ?? false;
+        }
+        catch {
+            return false;
+        }
+    }
+    // ===========================================================================
+    // Field Operations (from XFAManager in advanced-features.ts)
+    // ===========================================================================
+    async getFieldCount() {
+        try {
+            return 0;
+        }
+        catch {
+            return 0;
+        }
+    }
+    async getFieldByIndex(index) {
+        try {
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async getFieldValue(fieldName) {
+        try {
+            return (await this.document?.getXfaFieldValue?.(fieldName)) ?? null;
+        }
+        catch (error) {
+            this.emit('error', error);
+            return null;
+        }
+    }
+    async setFieldValue(fieldName, value) {
+        try {
+            const result = await this.document?.setXfaFieldValue?.(fieldName, value);
+            this.emit('field-value-set', { fieldName, value });
+            return !!result;
+        }
+        catch (error) {
+            this.emit('error', error);
+            return false;
+        }
+    }
+    async getFieldType(fieldName) {
+        try {
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async isFieldReadOnly(fieldName) {
+        try {
+            return false;
+        }
+        catch {
+            return false;
+        }
+    }
+    async getFieldBounds(fieldName) {
+        try {
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async getFormState() {
+        try {
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async exportData(filePath) {
+        try {
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async importData(filePath) {
+        try {
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async flattenForm() {
+        try {
+            const result = await this.document?.flattenXfaForm?.();
+            this.emit('form-flattened');
+            return !!result;
+        }
+        catch (error) {
+            this.emit('error', error);
+            return false;
+        }
+    }
+    // ===========================================================================
+    // Form Creation (from XfaCreationManager)
+    // ===========================================================================
+    async createXfaForm(config) {
+        try {
+            if (this.formCreated)
+                return { success: false, error: 'XFA form already exists in document' };
+            const formId = `xfa_form_${Date.now()}`;
+            await this.document?.createXfaForm?.(config.name, config.formType, config.pageWidth ?? 612, config.pageHeight ?? 792, config.locale ?? 'en_US', config.version ?? '3.0');
+            this.formCreated = true;
+            this.currentFormId = formId;
+            this.emit('form-created', { formId, config });
+            return { success: true, formId, fieldCount: 0 };
+        }
+        catch (error) {
+            this.emit('error', error);
+            return { success: false, error: error instanceof Error ? error.message : 'Unknown error' };
+        }
+    }
+    async createFromXdpTemplate(xdpContent) {
+        try {
+            const result = await this.document?.createXfaFromXdp?.(xdpContent);
+            if (result) {
+                this.formCreated = true;
+                this.currentFormId = `xfa_xdp_${Date.now()}`;
+            }
+            return { success: !!result, formId: this.currentFormId ?? undefined };
+        }
+        catch (error) {
+            this.emit('error', error);
+            return { success: false, error: error instanceof Error ? error.message : 'Unknown error' };
+        }
+    }
+    async createFromXmlTemplate(xmlTemplate) {
+        try {
+            const result = await this.document?.createXfaFromXml?.(xmlTemplate);
+            if (result) {
+                this.formCreated = true;
+                this.currentFormId = `xfa_xml_${Date.now()}`;
+            }
+            return { success: !!result, formId: this.currentFormId ?? undefined };
+        }
+        catch (error) {
+            this.emit('error', error);
+            return { success: false, error: error instanceof Error ? error.message : 'Unknown error' };
+        }
+    }
+    async addSubform(parentPath, config) {
+        try {
+            if (!this.formCreated)
+                throw new Error('No XFA form created');
+            const result = await this.document?.addXfaSubform?.(parentPath, config.name, config.layout ?? 'position', config.x ?? 0, config.y ?? 0, config.width, config.height);
+            this.emit('subform-added', { parentPath, name: config.name });
+            return !!result;
+        }
+        catch (error) {
+            this.emit('error', error);
+            return false;
+        }
+    }
+    async removeXfaForm() {
+        try {
+            if (!this.formCreated)
+                return false;
+            const result = await this.document?.removeXfaForm?.();
+            if (result) {
+                this.formCreated = false;
+                this.currentFormId = null;
+                this.createdFields.clear();
+                this.emit('form-removed');
+            }
+            return !!result;
+        }
+        catch (error) {
+            this.emit('error', error);
+            return false;
+        }
+    }
+    // ===========================================================================
+    // Field Creation (from XfaCreationManager)
+    // ===========================================================================
+    async addTextField(pageIndex, config) {
+        return this.addField(pageIndex, { ...config, fieldType: XfaFieldType.TEXT });
+    }
+    async addNumericField(pageIndex, config) {
+        return this.addField(pageIndex, { ...config, fieldType: XfaFieldType.NUMERIC });
+    }
+    async addDateField(pageIndex, config) {
+        return this.addField(pageIndex, { ...config, fieldType: XfaFieldType.DATE });
+    }
+    async addCheckboxField(pageIndex, config) {
+        return this.addField(pageIndex, { ...config, fieldType: XfaFieldType.CHECKBOX });
+    }
+    async addRadioGroup(pageIndex, config) {
+        return this.addField(pageIndex, { ...config, fieldType: XfaFieldType.RADIO });
+    }
+    async addDropdownField(pageIndex, config) {
+        return this.addField(pageIndex, { ...config, fieldType: XfaFieldType.DROPDOWN });
+    }
+    async addSignatureField(pageIndex, config) {
+        return this.addField(pageIndex, { ...config, fieldType: XfaFieldType.SIGNATURE });
+    }
+    async addButton(pageIndex, config) {
+        return this.addField(pageIndex, { ...config, fieldType: XfaFieldType.BUTTON });
+    }
+    async addField(pageIndex, config) {
+        try {
+            if (!this.formCreated)
+                throw new Error('No XFA form created');
+            const fieldId = `xfa_field_${config.name}_${Date.now()}`;
+            await this.document?.addXfaField?.(pageIndex, config.name, config.fieldType, config.x, config.y, config.width, config.height, {
+                caption: config.caption,
+                defaultValue: config.defaultValue,
+                tooltip: config.tooltip,
+                isRequired: config.isRequired,
+                isReadOnly: config.isReadOnly,
+                isHidden: config.isHidden,
+                maxLength: config.maxLength,
+                options: config.options,
+                font: config.font,
+                border: config.border,
+                margin: config.margin,
+                bindingType: config.bindingType,
+                bindingPath: config.bindingPath,
+            });
+            const handle = {
+                fieldId,
+                name: config.name,
+                fieldType: config.fieldType,
+                pageIndex,
+            };
+            this.createdFields.set(fieldId, handle);
+            this.emit('field-added', handle);
+            return handle;
+        }
+        catch (error) {
+            this.emit('error', error);
+            return null;
+        }
+    }
+    // ===========================================================================
+    // Field Manipulation (from XfaCreationManager)
+    // ===========================================================================
+    async updateField(fieldId, updates) {
+        try {
+            const field = this.createdFields.get(fieldId);
+            if (!field)
+                throw new Error(`Field not found: ${fieldId}`);
+            const result = await this.document?.updateXfaField?.(field.name, updates);
+            this.emit('field-updated', { fieldId, updates });
+            return !!result;
+        }
+        catch (error) {
+            this.emit('error', error);
+            return false;
+        }
+    }
+    async removeField(fieldId) {
+        try {
+            const field = this.createdFields.get(fieldId);
+            if (!field)
+                throw new Error(`Field not found: ${fieldId}`);
+            const result = await this.document?.removeXfaField?.(field.name);
+            if (result) {
+                this.createdFields.delete(fieldId);
+                this.emit('field-removed', { fieldId });
+            }
+            return !!result;
+        }
+        catch (error) {
+            this.emit('error', error);
+            return false;
+        }
+    }
+    async addFieldValidation(fieldName, validationType, options) {
+        try {
+            const result = await this.document?.addXfaFieldValidation?.(fieldName, validationType, options);
+            this.emit('validation-added', { fieldName, validationType });
+            return !!result;
+        }
+        catch (error) {
+            this.emit('error', error);
+            return false;
+        }
+    }
+    // ===========================================================================
+    // Data Operations (from XfaCreationManager)
+    // ===========================================================================
+    async importXfaData(data, options) {
+        try {
+            const result = await this.document?.importXfaData?.(data, options.format, {
+                validate: options.validateOnImport,
+            });
+            this.emit('data-imported', { format: options.format });
+            return !!result;
+        }
+        catch (error) {
+            this.emit('error', error);
+            return false;
+        }
+    }
+    async exportXfaData(options) {
+        try {
+            const result = await this.document?.exportXfaData?.(options.format, {
+                includeEmpty: options.includeEmptyFields,
+                includeCalculated: options.includeCalculatedFields,
+            });
+            this.emit('data-exported', { format: options.format });
+            return result ?? null;
+        }
+        catch (error) {
+            this.emit('error', error);
+            return null;
+        }
+    }
+    async exportAsXdp() {
+        try {
+            return (await this.document?.exportXfaAsXdp?.()) ?? null;
+        }
+        catch (error) {
+            this.emit('error', error);
+            return null;
+        }
+    }
+    async mergeXfaData(sourceData, options) {
+        try {
+            const result = await this.document?.mergeXfaData?.(sourceData, options?.overwrite ?? false);
+            this.emit('data-merged');
+            return !!result;
+        }
+        catch (error) {
+            this.emit('error', error);
+            return false;
+        }
+    }
+    // ===========================================================================
+    // Script Operations (from XfaCreationManager)
+    // ===========================================================================
+    async addFieldScript(fieldName, script) {
+        try {
+            const result = await this.document?.addXfaFieldScript?.(fieldName, script.event, script.code, script.language, script.runAt);
+            this.emit('script-added', { fieldName, event: script.event });
+            return !!result;
+        }
+        catch (error) {
+            this.emit('error', error);
+            return false;
+        }
+    }
+    async addFormScript(script) {
+        try {
+            const result = await this.document?.addXfaFormScript?.(script.event, script.code, script.language, script.runAt);
+            this.emit('form-script-added', { event: script.event });
+            return !!result;
+        }
+        catch (error) {
+            this.emit('error', error);
+            return false;
+        }
+    }
+    async removeFieldScript(fieldName, event) {
+        try {
+            const result = await this.document?.removeXfaFieldScript?.(fieldName, event);
+            this.emit('script-removed', { fieldName, event });
+            return !!result;
+        }
+        catch (error) {
+            this.emit('error', error);
+            return false;
+        }
+    }
+    // ===========================================================================
+    // Utilities
+    // ===========================================================================
+    async validateForm() {
+        try {
+            return (await this.document?.validateXfaForm?.()) ?? { valid: true, issues: [] };
+        }
+        catch (error) {
+            this.emit('error', error);
+            return { valid: false, issues: [error instanceof Error ? error.message : 'Unknown error'] };
+        }
+    }
+    getCreatedFields() {
+        return Array.from(this.createdFields.values());
+    }
+    hasForm() {
+        return this.formCreated || this.hasXfa();
+    }
+    clearCache() {
+        this.cache.clear();
+    }
+    getCacheStats() {
+        return {
+            cacheSize: this.cache.size,
+            maxCacheSize: this.maxCacheSize,
+            entries: Array.from(this.cache.keys()),
+        };
+    }
+    destroy() {
+        this.createdFields.clear();
+        this.formCreated = false;
+        this.currentFormId = null;
+        this.cache.clear();
+        this.removeAllListeners();
+    }
+    updateCache(key, value) {
+        this.cache.set(key, value);
+        if (this.cache.size > this.maxCacheSize) {
+            const firstKey = this.cache.keys().next().value;
+            if (firstKey !== undefined)
+                this.cache.delete(firstKey);
+        }
+    }
+}
+/** @deprecated Use XfaManager instead */
+export const XFAManager = XfaManager;
+export default XfaManager;

package/lib/native-loader.d.ts

@@ -0,0 +1,7 @@
+type NativeModule = Record<string, any>;
+/**
+ * Returns the loaded native module, loading it on first call. Throws if the
+ * prebuilt .node is missing and the development fallback also fails.
+ */
+export declare function getNative(): NativeModule;
+export {};

package/lib/native-loader.js

@@ -0,0 +1,62 @@
+// Shared loader for the pdf-oxide native N-API module.
+//
+// The top-level index.ts owns the primary load, but standalone classes like
+// Timestamp and TsaClient need access too. Rather than plumb the module
+// object through every constructor, both files import `getNative()` here.
+//
+// The loader resolves the prebuilt .node via the same prebuilds/<triple>
+// layout index.ts uses, with fallbacks for development builds.
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { arch, platform } from 'node:process';
+import { fileURLToPath } from 'node:url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const require = createRequire(import.meta.url);
+let cached = null;
+function prebuildPath() {
+    const paths = {
+        darwin: {
+            x64: '../prebuilds/darwin-x64/pdf_oxide.node',
+            arm64: '../prebuilds/darwin-arm64/pdf_oxide.node',
+        },
+        linux: {
+            x64: '../prebuilds/linux-x64/pdf_oxide.node',
+            arm64: '../prebuilds/linux-arm64/pdf_oxide.node',
+        },
+        win32: {
+            x64: '../prebuilds/win32-x64/pdf_oxide.node',
+        },
+    };
+    const plat = paths[platform];
+    const rel = plat?.[arch];
+    if (!rel) {
+        throw new Error(`Unsupported platform: ${platform}/${arch}`);
+    }
+    return join(__dirname, rel);
+}
+/**
+ * Returns the loaded native module, loading it on first call. Throws if the
+ * prebuilt .node is missing and the development fallback also fails.
+ */
+export function getNative() {
+    if (cached)
+        return cached;
+    try {
+        cached = require(prebuildPath());
+    }
+    catch (e) {
+        if (process.env.NODE_ENV === 'development' || process.env.NAPI_DEV) {
+            try {
+                cached = require('../build/Release/pdf_oxide.node');
+            }
+            catch {
+                throw e;
+            }
+        }
+        else {
+            throw e;
+        }
+    }
+    return cached;
+}

package/lib/native.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared loader for the pdf-oxide N-API addon.
+ *
+ * Extracted so that modules which can't import from `./index.ts`
+ * (due to the index ↔ editor / builder cycle) can still reach the
+ * addon through the same prebuild-aware resolver. The published
+ * package ships a platform-specific `.node` file under
+ * `prebuilds/<triple>/`; loading the addon through this helper is
+ * what makes `DocumentEditor` / `DocumentBuilder` work for consumers
+ * installed from npm (where `build/Release/` does not exist).
+ *
+ * In development mode (`NODE_ENV=development` or `NAPI_DEV` set), we
+ * fall back to `../build/Release/pdf_oxide.node` — the node-gyp
+ * output that in-tree tests run against.
+ */
+export declare function loadNative(): any;

package/lib/native.js

@@ -0,0 +1,69 @@
+/**
+ * Shared loader for the pdf-oxide N-API addon.
+ *
+ * Extracted so that modules which can't import from `./index.ts`
+ * (due to the index ↔ editor / builder cycle) can still reach the
+ * addon through the same prebuild-aware resolver. The published
+ * package ships a platform-specific `.node` file under
+ * `prebuilds/<triple>/`; loading the addon through this helper is
+ * what makes `DocumentEditor` / `DocumentBuilder` work for consumers
+ * installed from npm (where `build/Release/` does not exist).
+ *
+ * In development mode (`NODE_ENV=development` or `NAPI_DEV` set), we
+ * fall back to `../build/Release/pdf_oxide.node` — the node-gyp
+ * output that in-tree tests run against.
+ */
+import { createRequire } from 'node:module';
+import { arch, platform } from 'node:os';
+const require = createRequire(import.meta.url);
+// Prebuild paths are relative to the *compiled* `lib/native.js` — at
+// runtime the file lives at `js/lib/native.js`, so `../prebuilds/`
+// resolves to `js/prebuilds/`.
+const PLATFORMS = {
+    darwin: {
+        x64: '../prebuilds/darwin-x64/pdf_oxide.node',
+        arm64: '../prebuilds/darwin-arm64/pdf_oxide.node',
+    },
+    linux: {
+        x64: '../prebuilds/linux-x64/pdf_oxide.node',
+        arm64: '../prebuilds/linux-arm64/pdf_oxide.node',
+    },
+    win32: {
+        x64: '../prebuilds/win32-x64/pdf_oxide.node',
+    },
+};
+function getPrebuildPath() {
+    const os = platform();
+    const cpu = arch();
+    const osPaths = PLATFORMS[os];
+    if (!osPaths) {
+        throw new Error(`Unsupported platform: ${os}. Supported: ${Object.keys(PLATFORMS).join(', ')}`);
+    }
+    const prebuildPath = osPaths[cpu];
+    if (!prebuildPath) {
+        throw new Error(`Unsupported architecture: ${cpu} for ${os}. Supported: ${Object.keys(osPaths).join(', ')}`);
+    }
+    return prebuildPath;
+}
+let cached;
+export function loadNative() {
+    if (cached)
+        return cached;
+    try {
+        cached = require(getPrebuildPath());
+        return cached;
+    }
+    catch (e) {
+        // Dev fallback — in-tree `node-gyp rebuild` output.
+        if (process.env.NODE_ENV === 'development' || process.env.NAPI_DEV) {
+            try {
+                cached = require('../build/Release/pdf_oxide.node');
+                return cached;
+            }
+            catch {
+                /* fall through to rethrow the original error */
+            }
+        }
+        throw new Error(`Failed to load pdf-oxide native addon: ${e.message}`);
+    }
+}