pdf-oxide 0.3.24

package/src/tests/foundation.test.ts

@@ -0,0 +1,315 @@
+/**
+ * Comprehensive test suite for Phase 1 Foundation.
+ * Tests: ResultAccessorsManager, FormFieldManager
+ */
+
+import { describe, it, expect, beforeEach } from '@jest/globals';
+
+import FormFieldManager from '../managers/form-field-manager';
+import ResultAccessorsManager from '../managers/result-accessors-manager';
+
+describe('Phase 1 Foundation', () => {
+  describe('ResultAccessorsManager', () => {
+    let manager: ResultAccessorsManager;
+
+    beforeEach(() => {
+      manager = new ResultAccessorsManager();
+    });
+
+    it('should get result status as string or null', () => {
+      const result = manager.getResultStatus();
+      expect(result === null || typeof result === 'string').toBe(true);
+    });
+
+    it('should check result success and return boolean', () => {
+      const result = manager.isResultSuccess();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should check result error and return boolean', () => {
+      const result = manager.isResultError();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get error message as string or null', () => {
+      const result = manager.getErrorMessage();
+      expect(result === null || typeof result === 'string').toBe(true);
+    });
+
+    it('should get error code as int/string or null', () => {
+      const result = manager.getErrorCode();
+      expect(result === null || typeof result === 'number' || typeof result === 'string').toBe(true);
+    });
+
+    it('should check if has error details', () => {
+      const result = manager.hasErrorDetails();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get error details as object or null', () => {
+      const result = manager.getErrorDetails();
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should get result data of various types', () => {
+      const result = manager.getResultData();
+      expect(result === null || typeof result === 'object' || typeof result === 'string' ||
+              typeof result === 'number').toBe(true);
+    });
+
+    it('should get result metadata as object or null', () => {
+      const result = manager.getResultMetadata();
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should check if result cached', () => {
+      const result = manager.isResultCached();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get cache time as number or null', () => {
+      const result = manager.getCacheTime();
+      expect(result === null || typeof result === 'number').toBe(true);
+    });
+
+    it('should get execution time as non-negative number', () => {
+      const result = manager.getExecutionTime();
+      expect(typeof result).toBe('number');
+      expect(result).toBeGreaterThanOrEqual(0);
+    });
+
+    it('should get result size as non-negative integer', () => {
+      const result = manager.getResultSize();
+      expect(typeof result).toBe('number');
+      expect(result).toBeGreaterThanOrEqual(0);
+    });
+
+    it('should check if result empty', () => {
+      const result = manager.isResultEmpty();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should clear result and return boolean', () => {
+      const result = manager.clearResult();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should clone result as object or null', () => {
+      const result = manager.cloneResult();
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should merge results and return boolean', () => {
+      const result = manager.mergeResults({});
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should validate result and return boolean', () => {
+      const result = manager.validateResult();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should format result as string or null', () => {
+      const result = manager.formatResult('json');
+      expect(result === null || typeof result === 'string').toBe(true);
+    });
+
+    it('should export result and return boolean', () => {
+      const result = manager.exportResult('/output.json');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should import result and return boolean', () => {
+      const result = manager.importResult('/input.json');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get result type as string or null', () => {
+      const result = manager.getResultType();
+      expect(result === null || typeof result === 'string').toBe(true);
+    });
+
+    it('should cast result to various types', () => {
+      const result = manager.castResult('int');
+      expect(result === null || typeof result === 'number' || typeof result === 'string' ||
+              typeof result === 'boolean').toBe(true);
+    });
+
+    it('should get result hash as string', () => {
+      const result = manager.getResultHash();
+      expect(typeof result).toBe('string');
+    });
+
+    it('should compare results and return boolean', () => {
+      const result = manager.compareResults({});
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get result summary as string or null', () => {
+      const result = manager.getResultSummary();
+      expect(result === null || typeof result === 'string').toBe(true);
+    });
+
+    it('should convert result to format as string or null', () => {
+      const result = manager.convertResult('xml');
+      expect(result === null || typeof result === 'string').toBe(true);
+    });
+
+    it('should serialize result as string or null', () => {
+      const result = manager.serializeResult();
+      expect(result === null || typeof result === 'string').toBe(true);
+    });
+
+    it('should deserialize result and return boolean', () => {
+      const result = manager.deserializeResult('');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should compress result and return boolean', () => {
+      const result = manager.compressResult();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should decompress result and return boolean', () => {
+      const result = manager.decompressResult();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should encrypt result and return boolean', () => {
+      const result = manager.encryptResult('password');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should decrypt result and return boolean', () => {
+      const result = manager.decryptResult('password');
+      expect(typeof result).toBe('boolean');
+    });
+  });
+
+  describe('FormFieldManager', () => {
+    let manager: FormFieldManager;
+
+    beforeEach(() => {
+      manager = new FormFieldManager();
+    });
+
+    it('should get form fields as array', () => {
+      const result = manager.getFormFields();
+      expect(Array.isArray(result)).toBe(true);
+    });
+
+    it('should get field by name as object or null', () => {
+      const result = manager.getFieldByName('test_field');
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should get field value of various types', () => {
+      const result = manager.getFieldValue('field_1');
+      expect(result === null || typeof result === 'string' || typeof result === 'number' ||
+              typeof result === 'boolean').toBe(true);
+    });
+
+    it('should set field value and return boolean', () => {
+      const result = manager.setFieldValue('field_1', 'value');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get field type as string or null', () => {
+      const result = manager.getFieldType('field_1');
+      expect(result === null || typeof result === 'string').toBe(true);
+    });
+
+    it('should check if field required', () => {
+      const result = manager.isFieldRequired('field_1');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should check if field readonly', () => {
+      const result = manager.isFieldReadOnly('field_1');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should set field readonly and return boolean', () => {
+      const result = manager.setFieldReadOnly('field_1', true);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should clear field value and return boolean', () => {
+      const result = manager.clearFieldValue('field_1');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should validate field value and return boolean', () => {
+      const result = manager.validateFieldValue('field_1', 'value');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get field options as array or null', () => {
+      const result = manager.getFieldOptions('field_1');
+      expect(result === null || Array.isArray(result)).toBe(true);
+    });
+
+    it('should set field options and return boolean', () => {
+      const result = manager.setFieldOptions('field_1', ['opt1', 'opt2']);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should flatten form and return boolean', () => {
+      const result = manager.flattenForm();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should reset form and return boolean', () => {
+      const result = manager.resetForm();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should export form data and return boolean', () => {
+      const result = manager.exportFormData('/output.fdf');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should import form data and return boolean', () => {
+      const result = manager.importFormData('/input.fdf');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get form fields count as non-negative integer', () => {
+      const result = manager.getFormFieldsCount();
+      expect(typeof result).toBe('number');
+      expect(result).toBeGreaterThanOrEqual(0);
+    });
+
+    it('should calculate field positions and return boolean', () => {
+      const result = manager.calculateFieldPositions();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should auto size fields and return boolean', () => {
+      const result = manager.autoSizeFields();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should set field format and return boolean', () => {
+      const result = manager.setFieldFormat('field_1', 'text');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should validate all fields and return boolean', () => {
+      const result = manager.validateAllFields();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should complete form field lifecycle', () => {
+      const fields = manager.getFormFields();
+      expect(Array.isArray(fields)).toBe(true);
+
+      manager.setFieldValue('field_1', 'test_value');
+      const value = manager.getFieldValue('field_1');
+      expect(value !== undefined).toBe(true);
+
+      manager.validateAllFields();
+      manager.resetForm();
+    });
+  });
+});

package/src/tests/high-demand.test.ts

@@ -0,0 +1,257 @@
+/**
+ * Comprehensive test suite for Phase 2 High-Demand Features.
+ * Tests: BarcodesManager, SignaturesManager, RenderingManager
+ */
+
+import { describe, it, expect, beforeEach } from '@jest/globals';
+
+import BarcodesManager from '../managers/barcodes-manager';
+import SignaturesManager from '../managers/signatures-manager';
+import RenderingManager from '../managers/rendering-manager';
+
+describe('Phase 2 High-Demand Features', () => {
+  describe('BarcodesManager', () => {
+    let manager: BarcodesManager;
+
+    beforeEach(() => {
+      manager = new BarcodesManager();
+    });
+
+    it('should generate QR code and return boolean', () => {
+      const result = manager.generateQRCode('test_data');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should generate 1D barcode and return boolean', () => {
+      const result = manager.generateBarcode1D('CODE128', '123456');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should generate 2D barcode and return boolean', () => {
+      const result = manager.generateBarcode2D('DATAMATRIX', 'test_data');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should export barcode and return boolean', () => {
+      const result = manager.exportBarcode('/output.png');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should export barcode as SVG and return boolean', () => {
+      const result = manager.exportBarcodeSVG('/output.svg');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get barcode data as string or null', () => {
+      const result = manager.getBarcodeData();
+      expect(result === null || typeof result === 'string').toBe(true);
+    });
+
+    it('should validate barcode and return boolean', () => {
+      const result = manager.validateBarcode('123456');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get barcode size as object or null', () => {
+      const result = manager.getBarcodeSize();
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should set barcode properties and return boolean', () => {
+      const result = manager.setBarcodeProperties({ width: 100 });
+      expect(typeof result).toBe('boolean');
+    });
+  });
+
+  describe('SignaturesManager', () => {
+    let manager: SignaturesManager;
+
+    beforeEach(() => {
+      manager = new SignaturesManager();
+    });
+
+    it('should sign document and return boolean', () => {
+      const result = manager.signDocument('/cert.pfx', 'password');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should verify signature and return boolean', () => {
+      const result = manager.verifySignature();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get signature info as object or null', () => {
+      const result = manager.getSignatureInfo();
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should get certificate as object or null', () => {
+      const result = manager.getCertificate();
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should get certificate chain as array or null', () => {
+      const result = manager.getCertificateChain();
+      expect(result === null || Array.isArray(result)).toBe(true);
+    });
+
+    it('should validate certificate and return boolean', () => {
+      const result = manager.validateCertificate();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get signature count as non-negative number', () => {
+      const result = manager.getSignatureCount();
+      expect(typeof result).toBe('number');
+      expect(result).toBeGreaterThanOrEqual(0);
+    });
+
+    it('should get signature timestamp as number or null', () => {
+      const result = manager.getSignatureTimestamp();
+      expect(result === null || typeof result === 'number').toBe(true);
+    });
+
+    it('should remove signature and return boolean', () => {
+      const result = manager.removeSignature(0);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should clear all signatures and return boolean', () => {
+      const result = manager.clearAllSignatures();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should export signature and return boolean', () => {
+      const result = manager.exportSignature(0, '/output.p7s');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should import signature and return boolean', () => {
+      const result = manager.importSignature('/input.p7s');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get signature algorithm as string or null', () => {
+      const result = manager.getSignatureAlgorithm();
+      expect(result === null || typeof result === 'string').toBe(true);
+    });
+
+    it('should set signature properties and return boolean', () => {
+      const result = manager.setSignatureProperties({ reason: 'Approval' });
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should add timestamp and return boolean', () => {
+      const result = manager.addTimestamp('http://timestamp.server.com');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should verify timestamp and return boolean', () => {
+      const result = manager.verifyTimestamp();
+      expect(typeof result).toBe('boolean');
+    });
+  });
+
+  describe('RenderingManager', () => {
+    let manager: RenderingManager;
+
+    beforeEach(() => {
+      manager = new RenderingManager();
+    });
+
+    it('should render page and return boolean', () => {
+      const result = manager.renderPage(0, 150);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should render page to file and return boolean', () => {
+      const result = manager.renderPageToFile(0, '/output.png', 150);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should render region and return boolean', () => {
+      const result = manager.renderRegion(0, 0, 0, 100, 100);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should render thumbnail and return boolean', () => {
+      const result = manager.renderThumbnail(0, 150);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should set render quality and return boolean', () => {
+      const result = manager.setRenderQuality('high');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get rendered image as object or null', () => {
+      const result = manager.getRenderedImage();
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should render fit page and return boolean', () => {
+      const result = manager.renderFitPage(0);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should render fit width and return boolean', () => {
+      const result = manager.renderFitWidth(0);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should render fit height and return boolean', () => {
+      const result = manager.renderFitHeight(0);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should render with zoom and return boolean', () => {
+      const result = manager.renderWithZoom(0, 1.5);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should render rotated and return boolean', () => {
+      const result = manager.renderRotated(0, 90);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should export as image and return boolean', () => {
+      const result = manager.exportAsImage(0, '/output.png', 'png');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should export as JPEG and return boolean', () => {
+      const result = manager.exportAsJPEG(0, '/output.jpg', 85);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should export as PNG and return boolean', () => {
+      const result = manager.exportAsPNG(0, '/output.png');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get render metrics as object or null', () => {
+      const result = manager.getRenderMetrics();
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should render all pages and return boolean', () => {
+      const result = manager.renderAllPages('/output_dir', 150);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should cancel rendering and return boolean', () => {
+      const result = manager.cancelRendering();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should set render timeout and return boolean', () => {
+      const result = manager.setRenderTimeout(30);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should render with options and return boolean', () => {
+      const result = manager.renderWithOptions(0, { quality: 'high' });
+      expect(typeof result).toBe('boolean');
+    });
+  });
+});

package/src/tests/specialized.test.ts

@@ -0,0 +1,97 @@
+/**
+ * Comprehensive test suite for Phase 4 Specialized Features.
+ * Tests: DOMElementsManager, PDFCreatorManager
+ */
+
+import { describe, it, expect, beforeEach } from '@jest/globals';
+
+import DOMElementsManager from '../managers/dom-elements-manager';
+import PDFCreatorManager from '../managers/pdf-creator-manager';
+
+describe('Phase 4 Specialized Features', () => {
+  describe('DOMElementsManager', () => {
+    let manager: DOMElementsManager;
+
+    beforeEach(() => {
+      manager = new DOMElementsManager();
+    });
+
+    it('should get element by ID as object or null', () => {
+      const result = manager.getElementByID('elem_1');
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should get elements by type as array or null', () => {
+      const result = manager.getElementByType('text');
+      expect(result === null || Array.isArray(result)).toBe(true);
+    });
+
+    it('should get element properties as object or null', () => {
+      const result = manager.getElementProperties('elem_1');
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should set element property and return boolean', () => {
+      const result = manager.setElementProperty('elem_1', 'color', '#FF0000');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should remove element and return boolean', () => {
+      const result = manager.removeElement('elem_1');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get element children as array or null', () => {
+      const result = manager.getElementChildren('elem_1');
+      expect(result === null || Array.isArray(result)).toBe(true);
+    });
+
+    it('should get element parent as object or null', () => {
+      const result = manager.getElementParent('elem_1');
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+  });
+
+  describe('PDFCreatorManager', () => {
+    let manager: PDFCreatorManager;
+
+    beforeEach(() => {
+      manager = new PDFCreatorManager();
+    });
+
+    it('should create blank document and return boolean', () => {
+      const result = manager.createBlankDocument(612, 792);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should create from images and return boolean', () => {
+      const result = manager.createFromImages(['/img1.png', '/img2.png']);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should add page from template and return boolean', () => {
+      const result = manager.addPageFromTemplate('template_1');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should create booklet and return boolean', () => {
+      const result = manager.createBooklet();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should create multiple columns and return boolean', () => {
+      const result = manager.createMultipleColumns(2);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should add custom page size and return boolean', () => {
+      const result = manager.addCustomPageSize(400, 600);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should save as template and return boolean', () => {
+      const result = manager.saveAsTemplate('template_2');
+      expect(typeof result).toBe('boolean');
+    });
+  });
+});