pdfdancer-client-typescript 1.0.13 → 1.0.15

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);
 
@@ -134,7 +132,7 @@ 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.');
+        expect((result as any).warning).toBe("Text is not encodable with your current font, we are using 'Poppins-Bold' as a fallback font instead.");
 
         await assertNewParagraphExists(pdf);
 
@@ -142,13 +140,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 +540,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 +621,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

@@ -10,7 +10,7 @@ describe('Path E2E Tests (New API)', () => {
 
     test('select paths', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('basic-paths.pdf');
-        const pdf = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
 
         const paths = await pdf.selectPaths();
         expect(paths).toHaveLength(9);
@@ -25,7 +25,7 @@ describe('Path E2E Tests (New API)', () => {
 
     test('select paths by position', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('basic-paths.pdf');
-        const pdf = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
 
         const paths = await pdf.page(0).selectPathsAt(80, 720);
         expect(paths).toHaveLength(1);
@@ -34,7 +34,7 @@ describe('Path E2E Tests (New API)', () => {
 
     test('delete path', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('basic-paths.pdf');
-        const pdf = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
 
         let paths = await pdf.page(0).selectPathsAt(80, 720);
         expect(paths).toHaveLength(1);
@@ -56,7 +56,7 @@ describe('Path E2E Tests (New API)', () => {
 
     test('move path', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('basic-paths.pdf');
-        const pdf = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
 
         const [path] = await pdf.page(0).selectPathsAt(80, 720);
         const pos = path.position;
@@ -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/snapshot-showcase.test.ts

@@ -4,7 +4,7 @@ import {requireEnvAndFixture} from './test-helpers';
 describe('Snapshot E2E Tests (Showcase)', () => {
     test('page snapshot matches select paragraphs', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('Showcase.pdf');
-        const pdf = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
 
         const snapshot = await pdf.getPageSnapshot(0);
         const snapshotParagraphs = snapshot.elements.filter(e => e.type === ObjectType.PARAGRAPH);
@@ -18,7 +18,7 @@ describe('Snapshot E2E Tests (Showcase)', () => {
 
     test('page snapshot matches select images', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('Showcase.pdf');
-        const pdf = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
 
         const snapshot = await pdf.getPageSnapshot(0);
         const snapshotImages = snapshot.elements.filter(e => e.type === ObjectType.IMAGE);
@@ -34,7 +34,7 @@ describe('Snapshot E2E Tests (Showcase)', () => {
 
     test('page snapshot matches select forms', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('Showcase.pdf');
-        const pdf = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
 
         const snapshot = await pdf.getPageSnapshot(0);
         const snapshotForms = snapshot.elements.filter(e => e.type === ObjectType.FORM_X_OBJECT);
@@ -50,7 +50,7 @@ describe('Snapshot E2E Tests (Showcase)', () => {
 
     test('page snapshot matches select form fields', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('Showcase.pdf');
-        const pdf = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
 
         const snapshot = await pdf.getPageSnapshot(0);
         const snapshotFields = snapshot.elements.filter(e => [
@@ -71,7 +71,7 @@ describe('Snapshot E2E Tests (Showcase)', () => {
 
     test('page snapshot contains all element types', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('Showcase.pdf');
-        const pdf = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
 
         const snapshot = await pdf.getPageSnapshot(0);
         const paragraphCount = snapshot.elements.filter(e => e.type === ObjectType.PARAGRAPH).length;
@@ -87,7 +87,7 @@ describe('Snapshot E2E Tests (Showcase)', () => {
 
     test('document snapshot matches all pages', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('Showcase.pdf');
-        const pdf = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
 
         const docSnapshot = await pdf.getDocumentSnapshot();
         for (let i = 0; i < docSnapshot.pageCount; i++) {
@@ -103,7 +103,7 @@ describe('Snapshot E2E Tests (Showcase)', () => {
 
     test('type filter matches select method', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('Showcase.pdf');
-        const pdf = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
 
         const snapshot = await pdf.getPageSnapshot(0, [ObjectType.PARAGRAPH]);
         const selected = await pdf.page(0).selectParagraphs();
@@ -118,7 +118,7 @@ describe('Snapshot E2E Tests (Showcase)', () => {
 
     test('multiple type filters combined', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('Showcase.pdf');
-        const pdf = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
 
         const snapshot = await pdf.getPageSnapshot(0, [ObjectType.PARAGRAPH, ObjectType.TEXT_LINE]);
         expect(snapshot.elements.every(e => e.type === ObjectType.PARAGRAPH || e.type === ObjectType.TEXT_LINE)).toBe(true);
@@ -130,7 +130,7 @@ describe('Snapshot E2E Tests (Showcase)', () => {
 
     test('total element count matches expected', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('Showcase.pdf');
-        const pdf = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
 
         const elements = await pdf.selectElements();
         expect(elements.length).toBe(99);
@@ -143,7 +143,7 @@ describe('Snapshot E2E Tests (Showcase)', () => {
 
     test('snapshot consistency across multiple pages', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('Showcase.pdf');
-        const pdf = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
 
         const docSnapshot = await pdf.getDocumentSnapshot();
         expect(docSnapshot.pageCount).toBeGreaterThan(1);

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

@@ -9,7 +9,7 @@ describe('Snapshot E2E Tests', () => {
     
     test('get document snapshot', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('ObviouslyAwesome.pdf');
-        const client = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const client = await PDFDancer.open(pdfData, token, baseUrl);
 
         const snapshot = await client.getDocumentSnapshot();
         
@@ -42,7 +42,7 @@ describe('Snapshot E2E Tests', () => {
 
     test('get document snapshot with type filter', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('ObviouslyAwesome.pdf');
-        const client = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const client = await PDFDancer.open(pdfData, token, baseUrl);
 
         // Get snapshot filtered by paragraphs only
         const snapshot = await client.getDocumentSnapshot([ObjectType.PARAGRAPH]);
@@ -59,7 +59,7 @@ describe('Snapshot E2E Tests', () => {
 
     test('get document snapshot with multiple type filters', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('ObviouslyAwesome.pdf');
-        const client = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const client = await PDFDancer.open(pdfData, token, baseUrl);
 
         // Get snapshot filtered by paragraphs and images
         const snapshot = await client.getDocumentSnapshot([ObjectType.PARAGRAPH, ObjectType.IMAGE]);
@@ -75,7 +75,7 @@ describe('Snapshot E2E Tests', () => {
 
     test('get page snapshot', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('ObviouslyAwesome.pdf');
-        const client = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const client = await PDFDancer.open(pdfData, token, baseUrl);
 
         const pageSnapshot = await client.getPageSnapshot(0);
         
@@ -103,7 +103,7 @@ describe('Snapshot E2E Tests', () => {
 
     test('get page snapshot with type filter', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('ObviouslyAwesome.pdf');
-        const client = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const client = await PDFDancer.open(pdfData, token, baseUrl);
 
         // Get page snapshot filtered by images only
         const pageSnapshot = await client.getPageSnapshot(0, [ObjectType.IMAGE]);
@@ -118,7 +118,7 @@ describe('Snapshot E2E Tests', () => {
 
     test('get page snapshot via PageClient', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('ObviouslyAwesome.pdf');
-        const client = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const client = await PDFDancer.open(pdfData, token, baseUrl);
 
         const page = client.page(1);
         const pageSnapshot = await page.getSnapshot();
@@ -132,7 +132,7 @@ describe('Snapshot E2E Tests', () => {
 
     test('get page snapshot via PageClient with type filter', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('ObviouslyAwesome.pdf');
-        const client = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const client = await PDFDancer.open(pdfData, token, baseUrl);
 
         const page = client.page(0);
         const pageSnapshot = await page.getSnapshot([ObjectType.PARAGRAPH]);
@@ -147,7 +147,7 @@ describe('Snapshot E2E Tests', () => {
 
     test('DocumentSnapshot helper methods', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('ObviouslyAwesome.pdf');
-        const client = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const client = await PDFDancer.open(pdfData, token, baseUrl);
 
         const snapshot = await client.getDocumentSnapshot();
         
@@ -179,7 +179,7 @@ describe('Snapshot E2E Tests', () => {
 
     test('PageSnapshot helper methods', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('ObviouslyAwesome.pdf');
-        const client = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const client = await PDFDancer.open(pdfData, token, baseUrl);
 
         const pageSnapshot = await client.getPageSnapshot(0);
         
@@ -200,7 +200,7 @@ describe('Snapshot E2E Tests', () => {
 
     test('snapshot with form fields', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('mixed-form-types.pdf');
-        const client = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const client = await PDFDancer.open(pdfData, token, baseUrl);
 
         // Form fields can be TEXT_FIELD, CHECKBOX, or RADIO_BUTTON
         const snapshot = await client.getDocumentSnapshot([
@@ -224,7 +224,7 @@ describe('Snapshot E2E Tests', () => {
 
     test('snapshot with paths', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('basic-paths.pdf');
-        const client = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const client = await PDFDancer.open(pdfData, token, baseUrl);
 
         const snapshot = await client.getDocumentSnapshot([ObjectType.PATH]);
         
@@ -242,7 +242,7 @@ describe('Snapshot E2E Tests', () => {
 
     test('compare snapshot with individual find operations', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('ObviouslyAwesome.pdf');
-        const client = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const client = await PDFDancer.open(pdfData, token, baseUrl);
 
         // Get snapshot
         const snapshot = await client.getPageSnapshot(0);
@@ -258,7 +258,7 @@ describe('Snapshot E2E Tests', () => {
 
     test('snapshot fonts information', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('ObviouslyAwesome.pdf');
-        const client = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const client = await PDFDancer.open(pdfData, token, baseUrl);
 
         const snapshot = await client.getDocumentSnapshot();
         
@@ -269,16 +269,17 @@ describe('Snapshot E2E Tests', () => {
         // If there are fonts, verify their structure
         if (snapshot.fonts.length > 0) {
             for (const font of snapshot.fonts) {
-                expect(font.fontName).toBeDefined();
-                expect(font.fontType).toBeDefined();
-                expect(typeof font.similarityScore).toBe('number');
+                expect(font.documentFontName).toBeDefined();
+                expect(font.systemFontName).toBeDefined();
+                expect(typeof font.documentFontName).toBe('string');
+                expect(typeof font.systemFontName).toBe('string');
             }
         }
     });
 
     test('snapshot on empty page', async () => {
         const [baseUrl, token, pdfData] = await requireEnvAndFixture('Empty.pdf');
-        const client = await PDFDancer.open(pdfData, token, baseUrl, 30000);
+        const client = await PDFDancer.open(pdfData, token, baseUrl);
 
         const snapshot = await client.getDocumentSnapshot();
         
@@ -293,4 +294,3 @@ describe('Snapshot E2E Tests', () => {
         expect(Array.isArray(page0Snapshot!.elements)).toBe(true);
     });
 });
-

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();
 }
 
 /**
@@ -42,11 +43,16 @@ export function readToken(): string | null {
 export async function serverUp(baseUrl: string): Promise<boolean> {
     try {
         const response = await fetch(`${baseUrl}/ping`, {
-            signal: AbortSignal.timeout(3000)
+            signal: AbortSignal.timeout(60000)
         });
         const text = await response.text();
-        return response.status === 200 && text.includes('Pong');
-    } catch {
+        let pongReceived = response.status === 200 && text.includes('Pong');
+        if (!pongReceived) {
+            console.error(`Server did not respond with Pong. Response: ${text}, status ${response.status}`);
+        }
+        return pongReceived;
+    } catch (e) {
+        console.error("Server down", e)
         return false;
     }
 }
@@ -97,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;
@@ -43,20 +42,6 @@ describe('Env Token E2E Tests', () => {
         restoreEnv();
     });
 
-    test('requires token from env or argument', async () => {
-        delete process.env.PDFDANCER_TOKEN;
-
-        await expect(async () => {
-            try {
-                await PDFDancer.open(pdfData, undefined, baseUrl);
-            } catch (error) {
-                expect(error).toBeInstanceOf(ValidationException);
-                expect((error as Error).message).toBe(MISSING_TOKEN_MESSAGE);
-                throw error;
-            }
-        }).rejects.toThrow(MISSING_TOKEN_MESSAGE);
-    });
-
     test('opens with token from env', async () => {
         process.env.PDFDANCER_TOKEN = validToken;
         const client = await PDFDancer.open(pdfData, undefined, baseUrl);