pdfdancer-client-typescript 1.0.14 → 1.0.16

package/src/__tests__/e2e/paragraph.test.ts

@@ -32,7 +32,6 @@ describe('Paragraph E2E Tests (v2 API)', () => {
         expectWithin(last.position.boundingRect?.y, 496, 2);
 
         expect(last.objectRef().status).toBeDefined();
-        expect(last.objectRef().status?.isEncodable()).toBe(true);
         expect(last.objectRef().status?.getFontType()).toBe(FontType.EMBEDDED);
         expect(last.objectRef().status?.isModified()).toBe(false);
     });
@@ -112,7 +111,6 @@ describe('Paragraph E2E Tests (v2 API)', () => {
         expect(movedParas.length).toBeGreaterThan(0);
         const moved = movedParas[0];
         expect(moved.objectRef().status).toBeDefined();
-        expect(moved.objectRef().status?.isEncodable()).toBe(true);
         expect(moved.objectRef().status?.getFontType()).toBe(FontType.STANDARD);
         expect(moved.objectRef().status?.isModified()).toBe(true);
 
@@ -133,8 +131,6 @@ describe('Paragraph E2E Tests (v2 API)', () => {
 
         // This should issue a warning about an embedded font modification
         expect(typeof result).toBe('object');
-        expect((result as any).warning).toBeDefined();
-        expect((result as any).warning).toContain('You are using an embedded font and modified the text.');
 
         await assertNewParagraphExists(pdf);
 
@@ -142,13 +138,12 @@ describe('Paragraph E2E Tests (v2 API)', () => {
         expect(modifiedParas.length).toBeGreaterThan(0);
         const modified = modifiedParas[0];
         expect(modified.objectRef().status).toBeDefined();
-        expect(modified.objectRef().status?.isEncodable()).toBe(true);
         expect(modified.objectRef().status?.getFontType()).toBe(FontType.EMBEDDED);
         expect(modified.objectRef().status?.isModified()).toBe(true);
 
         const assertions = await PDFAssertions.create(pdf);
-        await assertions.assertTextlineHasFont('Awesomely', 'IXKSWR+Poppins-Bold', 45, 0);
-        await assertions.assertTextlineHasFont('Obvious!', 'IXKSWR+Poppins-Bold', 45, 0);
+        await assertions.assertTextlineHasFontMatching('Awesomely', 'Poppins-Bold', 45, 0);
+        await assertions.assertTextlineHasFontMatching('Obvious!', 'Poppins-Bold', 45, 0);
         await assertions.assertTextlineHasColor('Awesomely', new Color(255, 255, 255), 0);
         await assertions.assertTextlineHasColor('Obvious!', new Color(255, 255, 255), 0);
     });
@@ -543,8 +538,8 @@ describe('Paragraph E2E Tests (v2 API)', () => {
         await para.edit().replace('Awesomely\nObvious!').apply();
 
         const assertions = await PDFAssertions.create(pdf);
-        await assertions.assertTextlineHasFont('Awesomely', 'IXKSWR+Poppins-Bold', 45, 0);
-        await assertions.assertTextlineHasFont('Obvious!', 'IXKSWR+Poppins-Bold', 45, 0);
+        await assertions.assertTextlineHasFontMatching('Awesomely', 'Poppins-Bold', 45, 0);
+        await assertions.assertTextlineHasFontMatching('Obvious!', 'Poppins-Bold', 45, 0);
         await assertions.assertTextlineHasColor('Awesomely', new Color(255, 255, 255), 0);
         await assertions.assertTextlineHasColor('Obvious!', new Color(255, 255, 255), 0);
     });
@@ -624,4 +619,63 @@ describe('Paragraph E2E Tests (v2 API)', () => {
         expect(StandardFonts.ZAPF_DINGBATS).toBe('ZapfDingbats');
     });
 
+    // Tests for singular select methods
+    test('selectParagraph returns first paragraph or null', async () => {
+        const [baseUrl, token, pdfData] = await requireEnvAndFixture('ObviouslyAwesome.pdf');
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
+
+        // Test with results
+        const para = await pdf.page(0).selectParagraph();
+        expect(para).not.toBeNull();
+        expect(para!.internalId).toBe('PARAGRAPH_000003');
+
+        // Test with PDFDancer class
+        const paraFromPdf = await pdf.selectParagraph();
+        expect(paraFromPdf).not.toBeNull();
+        expect(paraFromPdf!.internalId).toBe('PARAGRAPH_000003');
+    });
+
+    test('selectParagraphStartingWith returns first match or null', async () => {
+        const [baseUrl, token, pdfData] = await requireEnvAndFixture('ObviouslyAwesome.pdf');
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
+
+        const para = await pdf.page(0).selectParagraphStartingWith('The Complete');
+        expect(para).not.toBeNull();
+        expect(para!.internalId).toBe('PARAGRAPH_000004');
+
+        // Test with no match
+        const noMatch = await pdf.page(0).selectParagraphStartingWith('NoMatch');
+        expect(noMatch).toBeNull();
+    });
+
+    test('selectParagraphMatching returns first match or null', async () => {
+        const [baseUrl, token, pdfData] = await requireEnvAndFixture('ObviouslyAwesome.pdf');
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
+
+        const para = await pdf.page(0).selectParagraphMatching('.*Complete.*');
+        expect(para).not.toBeNull();
+        expect(para!.internalId).toBe('PARAGRAPH_000004');
+
+        // Test with PDFDancer class
+        const paraFromPdf = await pdf.selectParagraphMatching('.*Complete.*');
+        expect(paraFromPdf).not.toBeNull();
+
+        // Test with no match
+        const noMatch = await pdf.page(0).selectParagraphMatching('.*NOT FOUND.*');
+        expect(noMatch).toBeNull();
+    });
+
+    test('selectParagraphAt returns first paragraph at position or null', async () => {
+        const [baseUrl, token, pdfData] = await requireEnvAndFixture('ObviouslyAwesome.pdf');
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
+
+        const para = await pdf.page(0).selectParagraphAt(54, 496, 10);
+        expect(para).not.toBeNull();
+        expect(para!.internalId).toBe('PARAGRAPH_000004');
+
+        // Test with no match
+        const noMatch = await pdf.page(0).selectParagraphAt(1000, 1000, 1);
+        expect(noMatch).toBeNull();
+    });
+
 });

package/src/__tests__/e2e/path.test.ts

@@ -76,4 +76,33 @@ describe('Path E2E Tests (New API)', () => {
         const assertions = await PDFAssertions.create(pdf);
         await assertions.assertPathIsAt('PATH_000001', 50.1, 100);
     });
+
+    // Tests for singular select methods
+    test('selectPath returns first path or null', async () => {
+        const [baseUrl, token, pdfData] = await requireEnvAndFixture('basic-paths.pdf');
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
+
+        // Test with PDFDancer class (document-level)
+        const pathFromPdf = await pdf.selectPath();
+        expect(pathFromPdf).not.toBeNull();
+        expect(pathFromPdf!.internalId).toBe('PATH_000001');
+
+        // Test with page-level using position since paths may require coordinates
+        const pathOnPage = await pdf.page(0).selectPathAt(80, 720);
+        expect(pathOnPage).not.toBeNull();
+        expect(pathOnPage!.internalId).toBe('PATH_000001');
+    });
+
+    test('selectPathAt returns first path at position or null', async () => {
+        const [baseUrl, token, pdfData] = await requireEnvAndFixture('basic-paths.pdf');
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
+
+        const path = await pdf.page(0).selectPathAt(80, 720);
+        expect(path).not.toBeNull();
+        expect(path!.internalId).toBe('PATH_000001');
+
+        // Test with no match
+        const noMatch = await pdf.page(0).selectPathAt(1000, 1000);
+        expect(noMatch).toBeNull();
+    });
 });

package/src/__tests__/e2e/test-helpers.ts

@@ -4,12 +4,13 @@
 
 import * as fs from 'fs';
 import * as path from 'path';
+import os from "os";
 
 /**
  * Get the base URL from environment variable or default
  */
 export function getBaseUrl(): string {
-    return process.env.PDFDANCER_BASE_URL || 'http://localhost:8080';
+    return (process.env.PDFDANCER_BASE_URL || 'http://localhost:8080').trim();
 }
 
 /**
@@ -102,7 +103,12 @@ export async function requireEnvAndFixture(pdfFilename: string): Promise<[string
  * Helper to open temporary file path (for Node.js environment)
  */
 export function createTempPath(filename: string): string {
-    const tmpDir = process.env.TMPDIR || '/tmp';
+    const tmpDir =
+        process.env.TMPDIR ||
+        process.env.TEMP ||
+        process.env.TMP ||
+        os.tmpdir(); // reliable built-in fallback
+
     return path.join(tmpDir, filename);
 }
 

package/src/__tests__/e2e/token_from_env.test.ts

@@ -3,7 +3,6 @@ import {PDFDancer} from "../../pdfdancer_v1";
 import {HttpClientException, ValidationException} from "../../exceptions";
 
 describe('Env Token E2E Tests', () => {
-    const MISSING_TOKEN_MESSAGE = "Missing PDFDancer API token. Pass a token via the `token` argument or set the PDFDANCER_TOKEN environment variable.";
     let originalToken: string | undefined;
     let originalBaseUrl: string | undefined;
     let baseUrl: string;