pdfdancer-client-typescript 1.0.1 → 1.0.2

package/.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, staging, develop, development, dev ]
+  pull_request:
+    branches: [ main, staging, develop, development, dev ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [ 18.x, 20.x, 22.x, 24.x ]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run linter
+        run: npm run lint
+
+      - name: Build
+        run: npm run build
+
+      - name: Run tests
+        run: npm run test:unit
+

package/README.md

@@ -1,6 +1,7 @@
 # PDFDancer TypeScript Client
 
-A TypeScript client library for the PDFDancer PDF manipulation API. This client provides a clean, TypeScript interface for PDF operations that closely mirrors the Python client structure and functionality.
+A TypeScript client library for the PDFDancer PDF manipulation API. This client provides a clean, TypeScript interface
+for PDF operations that closely mirrors the Python client structure and functionality.
 
 ## Features
 
@@ -21,35 +22,32 @@ npm install pdfdancer-client-typescript
 ## Basic Usage
 
 ```typescript
-import { ClientV1, Position, Color, Font } from 'pdfdancer-client-typescript';
+import {ClientV1, Position, Color, Font} from 'pdfdancer-client-typescript';
 
 async function example() {
-  // Load PDF data (from file upload, fetch, etc.)
-  const pdfData = new Uint8Array(/* your PDF data */);
+    // Load PDF data (from file upload, fetch, etc.)
+    const pdfData = new Uint8Array(/* your PDF data */);
 
-  // Create client with authentication token
-  const client = new ClientV1('your-auth-token', pdfData);
+    // Create client with authentication token
+    const client = await ClientV1.create('your-auth-token', pdfData, undefined, 30000);
 
-  // Initialize session (required before using the client)
-  await client.init();
+    // Find all paragraphs on page 1
+    const paragraphs = await client.findParagraphs(Position.atPage(1));
 
-  // Find all paragraphs on page 1
-  const paragraphs = await client.findParagraphs(Position.fromPageIndex(1));
+    // Add a new paragraph
+    const newParagraph = client.paragraphBuilder()
+        .fromString('Hello, PDFDancer!', new Color(255, 0, 0))
+        .withFont(new Font('Arial', 12))
+        .withPosition(Position.atPageCoordinates(1, 100, 200))
+        .build();
 
-  // Add a new paragraph
-  const newParagraph = client.paragraphBuilder()
-    .fromString('Hello, PDFDancer!', new Color(255, 0, 0))
-    .withFont(new Font('Arial', 12))
-    .withPosition(Position.onPageCoordinates(1, 100, 200))
-    .build();
-
-  await client.addParagraph(newParagraph);
+    await client.addParagraph(newParagraph);
 
-  // Get the modified PDF
-  const modifiedPdf = await client.getPdfFile();
+    // Get the modified PDF
+    const modifiedPdf = await client.getPdfFile();
 
-  // Save PDF (browser environment)
-  await client.savePdf('modified-document.pdf');
+    // Save PDF (browser environment)
+    await client.savePdf('modified-document.pdf');
 }
 ```
 
@@ -58,14 +56,12 @@ async function example() {
 ### Client Initialization
 
 ```typescript
-const client = new ClientV1(
-  token,        // Authentication token
-  pdfData,      // PDF data as Uint8Array, File, or ArrayBuffer
-  baseUrl,      // Optional: API server URL (default: http://localhost:8080)
-  readTimeout   // Optional: Request timeout in ms (default: 30000)
+const client = await ClientV1.create(
+    token,        // Authentication token
+    pdfData,      // PDF data as Uint8Array, File, or ArrayBuffer
+    baseUrl,      // Optional: API server URL (default: http://localhost:8080)
+    readTimeout   // Optional: Request timeout in ms (default: 30000)
 );
-
-await client.init(); // Required before using the client
 ```
 
 ### Search Operations
@@ -90,10 +86,10 @@ const page = await client.getPage(1); // 1-based index
 
 ```typescript
 // Page-based position
-const pagePosition = Position.fromPageIndex(1);
+const pagePosition = Position.atPage(1);
 
 // Coordinate-based position
-const coordPosition = Position.onPageCoordinates(1, 100, 200);
+const coordPosition = Position.atPageCoordinates(1, 100, 200);
 
 // Position with movement
 const movedPosition = coordPosition.copy().moveX(50).moveY(30);
@@ -104,12 +100,12 @@ const movedPosition = coordPosition.copy().moveX(50).moveY(30);
 ```typescript
 // Add paragraph using builder pattern
 const paragraph = client.paragraphBuilder()
-  .fromString('Your text here')
-  .withFont(new Font('Arial', 12))
-  .withColor(new Color(0, 0, 0))
-  .withPosition(Position.onPageCoordinates(1, 100, 200))
-  .withLineSpacing(1.2)
-  .build();
+    .fromString('Your text here')
+    .withFont(new Font('Arial', 12))
+    .withColor(new Color(0, 0, 0))
+    .withPosition(Position.atPageCoordinates(1, 100, 200))
+    .withLineSpacing(1.2)
+    .build();
 
 await client.addParagraph(paragraph);
 
@@ -167,43 +163,46 @@ The client provides specific exception types for different error scenarios:
 
 ```typescript
 import {
-  ValidationException,
-  HttpClientException,
-  SessionException,
-  FontNotFoundException,
-  PdfDancerException
+    ValidationException,
+    HttpClientException,
+    SessionException,
+    FontNotFoundException,
+    PdfDancerException
 } from 'pdfdancer-client-typescript';
 
 try {
-  await client.addParagraph(paragraph);
+    await client.addParagraph(paragraph);
 } catch (error) {
-  if (error instanceof ValidationException) {
-    console.error('Invalid input:', error.message);
-  } else if (error instanceof HttpClientException) {
-    console.error('API error:', error.message, 'Status:', error.statusCode);
-  } else if (error instanceof FontNotFoundException) {
-    console.error('Font not found:', error.message);
-  } else if (error instanceof SessionException) {
-    console.error('Session error:', error.message);
-  }
+    if (error instanceof ValidationException) {
+        console.error('Invalid input:', error.message);
+    } else if (error instanceof HttpClientException) {
+        console.error('API error:', error.message, 'Status:', error.statusCode);
+    } else if (error instanceof FontNotFoundException) {
+        console.error('Font not found:', error.message);
+    } else if (error instanceof SessionException) {
+        console.error('Session error:', error.message);
+    }
 }
 ```
 
 ## Types and Enums
 
 ### ObjectType
+
 - `IMAGE` - Image objects
-- `FORM` - Form field objects
+- `FORM_X_OBJECT` - Form field objects
 - `PATH` - Vector path objects
 - `PARAGRAPH` - Paragraph objects
 - `TEXT_LINE` - Text line objects
 - `PAGE` - Page objects
 
 ### PositionMode
+
 - `INTERSECT` - Objects that intersect with the specified area
 - `CONTAINS` - Objects completely contained within the specified area
 
 ### ShapeType
+
 - `POINT` - Single point coordinate
 - `LINE` - Linear shape between two points
 - `CIRCLE` - Circular area with radius
@@ -238,19 +237,20 @@ The project includes comprehensive end-to-end tests that mirror the Python clien
 1. **Start PDFDancer server** at `http://localhost:8080` (or set `PDFDANCER_BASE_URL`)
 
 2. **Set authentication token**:
-   - Environment variable: `export PDFDANCER_TOKEN=your-token`
-   - Or place a `jwt-token-*.txt` file in the project root
+    - Environment variable: `export PDFDANCER_TOKEN=your-token`
+    - Or place a `jwt-token-*.txt` file in the project root
 
 3. **Add test fixtures** in the `fixtures/` directory:
-   - `ObviouslyAwesome.pdf` - Main test document
-   - `mixed-form-types.pdf` - Document with form fields
-   - `basic-paths.pdf` - Document with vector paths
-   - `logo-80.png` - Test image file
-   - `DancingScript-Regular.ttf` - Test font file
+    - `ObviouslyAwesome.pdf` - Main test document
+    - `mixed-form-types.pdf` - Document with form fields
+    - `basic-paths.pdf` - Document with vector paths
+    - `logo-80.png` - Test image file
+    - `DancingScript-Regular.ttf` - Test font file
 
 4. **Run e2e tests**: `npm run test:e2e`
 
 The e2e tests cover:
+
 - **Paragraph operations**: Find, add, modify, delete paragraphs with custom fonts
 - **Page operations**: Get pages, delete pages
 - **Text line operations**: Find, modify, move, delete text lines
@@ -258,10 +258,6 @@ The e2e tests cover:
 - **Form operations**: Find and delete form fields
 - **Path operations**: Find, move, delete vector paths
 
-## Compatibility
-
-This TypeScript client is designed to be functionally equivalent to the PDFDancer Python client, providing the same API patterns and capabilities with TypeScript type safety and modern JavaScript features.
-
 ## License
 
 MIT

package/dist/__tests__/assertions.d.ts

@@ -0,0 +1,2 @@
+export declare function expectWithin(actual: number | undefined, expected: number, tolerance: number): void;
+//# sourceMappingURL=assertions.d.ts.map

package/dist/__tests__/assertions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.d.ts","sourceRoot":"","sources":["../../src/__tests__/assertions.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CACxB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAClB,IAAI,CAON"}

package/dist/__tests__/assertions.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.expectWithin = expectWithin;
+function expectWithin(actual, expected, tolerance) {
+    if (actual === undefined) {
+        throw new Error(`Expected a number but got undefined`);
+    }
+    const diff = Math.abs(actual - expected);
+    expect(diff).toBeLessThanOrEqual(tolerance);
+}
+//# sourceMappingURL=assertions.js.map

package/dist/__tests__/assertions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.js","sourceRoot":"","sources":["../../src/__tests__/assertions.ts"],"names":[],"mappings":";;AAAA,oCAWC;AAXD,SAAgB,YAAY,CACxB,MAA0B,EAC1B,QAAgB,EAChB,SAAiB;IAEjB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC;IACzC,MAAM,CAAC,IAAI,CAAC,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;AAChD,CAAC"}

package/dist/client-v1.d.ts

@@ -4,7 +4,7 @@
  * A TypeScript client that closely mirrors the Python Client class structure and functionality.
  * Provides session-based PDF manipulation operations with strict validation.
  */
-import { ObjectRef, Position, ObjectType, Font, Image, Paragraph } from './models';
+import { Font, Image, ObjectRef, ObjectType, Paragraph, Position } from './models';
 import { ParagraphBuilder } from './paragraph-builder';
 /**
  * REST API client for interacting with the PDFDancer PDF manipulation service.
@@ -30,10 +30,10 @@ export declare class ClientV1 {
      * Initialize the client by creating a session.
      * Must be called after constructor before using the client.
      */
-    init(): Promise<void>;
+    private init;
+    static create(token: string, pdfData: Uint8Array, baseUrl: string, timeout?: number): Promise<ClientV1>;
     /**
      * Process PDF data from various input types with strict validation.
-     * Equivalent to readFile() method in Python client.
      */
     private _processPdfData;
     /**
@@ -43,12 +43,10 @@ export declare class ClientV1 {
     private _extractErrorMessage;
     /**
      * Creates a new PDF processing session by uploading the PDF data.
-     * Equivalent to createSession() method in Python client.
      */
     private _createSession;
     /**
      * Make HTTP request with session headers and error handling.
-     * Equivalent to retrieve() method pattern in Python client.
      */
     private _makeRequest;
     /**
@@ -59,92 +57,74 @@ export declare class ClientV1 {
     find(objectType?: ObjectType, position?: Position): Promise<ObjectRef[]>;
     /**
      * Searches for paragraph objects at the specified position.
-     * Equivalent to findParagraphs() in Python client.
      */
     findParagraphs(position?: Position): Promise<ObjectRef[]>;
     /**
      * Searches for image objects at the specified position.
-     * Equivalent to findImages() in Python client.
      */
     findImages(position?: Position): Promise<ObjectRef[]>;
     /**
      * Searches for form field objects at the specified position.
-     * Equivalent to findForms() in Python client.
      */
     findForms(position?: Position): Promise<ObjectRef[]>;
     /**
      * Searches for vector path objects at the specified position.
-     * Equivalent to findPaths() in Python client.
      */
     findPaths(position?: Position): Promise<ObjectRef[]>;
     /**
      * Searches for text line objects at the specified position.
-     * Equivalent to findTextLines() in Python client.
      */
     findTextLines(position?: Position): Promise<ObjectRef[]>;
     /**
      * Retrieves references to all pages in the PDF document.
-     * Equivalent to getPages() in Python client.
      */
     getPages(): Promise<ObjectRef[]>;
     /**
      * Retrieves a reference to a specific page by its page index.
-     * Equivalent to getPage() in Python client.
      */
     getPage(pageIndex: number): Promise<ObjectRef | null>;
     /**
      * Deletes a page from the PDF document.
-     * Equivalent to deletePage() in Python client.
      */
     deletePage(pageRef: ObjectRef): Promise<boolean>;
     /**
      * Deletes the specified PDF object from the document.
-     * Equivalent to delete() in Python client.
      */
     delete(objectRef: ObjectRef): Promise<boolean>;
     /**
      * Moves a PDF object to a new position within the document.
-     * Equivalent to move() in Python client.
      */
     move(objectRef: ObjectRef, position: Position): Promise<boolean>;
     /**
      * Adds an image to the PDF document.
-     * Equivalent to addImage() methods in Python client.
      */
     addImage(image: Image, position?: Position): Promise<boolean>;
     /**
      * Adds a paragraph to the PDF document.
-     * Equivalent to addParagraph() in Python client with validation.
      */
     addParagraph(paragraph: Paragraph): Promise<boolean>;
     /**
      * Internal method to add any PDF object.
-     * Equivalent to addObject() in Python client.
      */
     private _addObject;
     /**
      * Modifies a paragraph object or its text content.
-     * Equivalent to modifyParagraph() methods in Python client.
      */
     modifyParagraph(objectRef: ObjectRef, newParagraph: Paragraph | string): Promise<boolean>;
     /**
      * Modifies a text line object.
-     * Equivalent to modifyTextLine() in Python client.
      */
     modifyTextLine(objectRef: ObjectRef, newText: string): Promise<boolean>;
     /**
      * Finds available fonts matching the specified name and size.
-     * Equivalent to findFonts() in Python client.
      */
     findFonts(fontName: string, fontSize: number): Promise<Font[]>;
     /**
      * Registers a custom font for use in PDF operations.
-     * Equivalent to registerFont() in Python client.
      */
     registerFont(ttfFile: Uint8Array | File): Promise<string>;
     /**
      * Downloads the current state of the PDF document with all modifications applied.
-     * Equivalent to getPDFFile() in Python client.
      */
     getPdfFile(): Promise<Uint8Array>;
     /**
@@ -162,7 +142,6 @@ export declare class ClientV1 {
     private _parsePosition;
     /**
      * Creates a new ParagraphBuilder for fluent paragraph construction.
-     * Equivalent to paragraphBuilder() in Python client.
      */
     paragraphBuilder(): ParagraphBuilder;
 }

package/dist/client-v1.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client-v1.d.ts","sourceRoot":"","sources":["../src/client-v1.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client-v1.d.ts","sourceRoot":"","sources":["../src/client-v1.ts"],"names":[],"mappings":"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"}

package/dist/client-v1.js

@@ -41,10 +41,14 @@ class ClientV1 {
      */
     async init() {
         this._sessionId = await this._createSession();
+        return this;
+    }
+    static async create(token, pdfData, baseUrl, timeout = 0) {
+        const client = new ClientV1(token, pdfData, baseUrl, timeout);
+        return await client.init();
     }
     /**
      * Process PDF data from various input types with strict validation.
-     * Equivalent to readFile() method in Python client.
      */
     _processPdfData(pdfData) {
         if (!pdfData) {
@@ -120,7 +124,6 @@ class ClientV1 {
     }
     /**
      * Creates a new PDF processing session by uploading the PDF data.
-     * Equivalent to createSession() method in Python client.
      */
     async _createSession() {
         try {
@@ -161,7 +164,6 @@ class ClientV1 {
     }
     /**
      * Make HTTP request with session headers and error handling.
-     * Equivalent to retrieve() method pattern in Python client.
      */
     async _makeRequest(method, path, data, params) {
         const url = new URL(`${this._baseUrl}${path}`);
@@ -225,35 +227,30 @@ class ClientV1 {
     }
     /**
      * Searches for paragraph objects at the specified position.
-     * Equivalent to findParagraphs() in Python client.
      */
     async findParagraphs(position) {
         return this.find(models_1.ObjectType.PARAGRAPH, position);
     }
     /**
      * Searches for image objects at the specified position.
-     * Equivalent to findImages() in Python client.
      */
     async findImages(position) {
         return this.find(models_1.ObjectType.IMAGE, position);
     }
     /**
      * Searches for form field objects at the specified position.
-     * Equivalent to findForms() in Python client.
      */
     async findForms(position) {
-        return this.find(models_1.ObjectType.FORM, position);
+        return this.find(models_1.ObjectType.FORM_X_OBJECT, position);
     }
     /**
      * Searches for vector path objects at the specified position.
-     * Equivalent to findPaths() in Python client.
      */
     async findPaths(position) {
         return this.find(models_1.ObjectType.PATH, position);
     }
     /**
      * Searches for text line objects at the specified position.
-     * Equivalent to findTextLines() in Python client.
      */
     async findTextLines(position) {
         return this.find(models_1.ObjectType.TEXT_LINE, position);
@@ -261,7 +258,6 @@ class ClientV1 {
     // Page Operations
     /**
      * Retrieves references to all pages in the PDF document.
-     * Equivalent to getPages() in Python client.
      */
     async getPages() {
         const response = await this._makeRequest('POST', '/pdf/page/find');
@@ -270,7 +266,6 @@ class ClientV1 {
     }
     /**
      * Retrieves a reference to a specific page by its page index.
-     * Equivalent to getPage() in Python client.
      */
     async getPage(pageIndex) {
         if (pageIndex < 0) {
@@ -286,7 +281,6 @@ class ClientV1 {
     }
     /**
      * Deletes a page from the PDF document.
-     * Equivalent to deletePage() in Python client.
      */
     async deletePage(pageRef) {
         if (!pageRef) {
@@ -299,7 +293,6 @@ class ClientV1 {
     // Manipulation Operations
     /**
      * Deletes the specified PDF object from the document.
-     * Equivalent to delete() in Python client.
      */
     async delete(objectRef) {
         if (!objectRef) {
@@ -311,7 +304,6 @@ class ClientV1 {
     }
     /**
      * Moves a PDF object to a new position within the document.
-     * Equivalent to move() in Python client.
      */
     async move(objectRef, position) {
         if (!objectRef) {
@@ -327,7 +319,6 @@ class ClientV1 {
     // Add Operations
     /**
      * Adds an image to the PDF document.
-     * Equivalent to addImage() methods in Python client.
      */
     async addImage(image, position) {
         if (!image) {
@@ -343,7 +334,6 @@ class ClientV1 {
     }
     /**
      * Adds a paragraph to the PDF document.
-     * Equivalent to addParagraph() in Python client with validation.
      */
     async addParagraph(paragraph) {
         if (!paragraph) {
@@ -362,7 +352,6 @@ class ClientV1 {
     }
     /**
      * Internal method to add any PDF object.
-     * Equivalent to addObject() in Python client.
      */
     async _addObject(pdfObject) {
         const requestData = new models_1.AddRequest(pdfObject).toDict();
@@ -372,7 +361,6 @@ class ClientV1 {
     // Modify Operations
     /**
      * Modifies a paragraph object or its text content.
-     * Equivalent to modifyParagraph() methods in Python client.
      */
     async modifyParagraph(objectRef, newParagraph) {
         if (!objectRef) {
@@ -396,7 +384,6 @@ class ClientV1 {
     }
     /**
      * Modifies a text line object.
-     * Equivalent to modifyTextLine() in Python client.
      */
     async modifyTextLine(objectRef, newText) {
         if (!objectRef) {
@@ -412,7 +399,6 @@ class ClientV1 {
     // Font Operations
     /**
      * Finds available fonts matching the specified name and size.
-     * Equivalent to findFonts() in Python client.
      */
     async findFonts(fontName, fontSize) {
         if (!fontName || !fontName.trim()) {
@@ -428,7 +414,6 @@ class ClientV1 {
     }
     /**
      * Registers a custom font for use in PDF operations.
-     * Equivalent to registerFont() in Python client.
      */
     async registerFont(ttfFile) {
         if (!ttfFile) {
@@ -484,7 +469,6 @@ class ClientV1 {
     // Document Operations
     /**
      * Downloads the current state of the PDF document with all modifications applied.
-     * Equivalent to getPDFFile() in Python client.
      */
     async getPdfFile() {
         const response = await this._makeRequest('GET', `/session/${this._sessionId}/pdf`);
@@ -548,7 +532,6 @@ class ClientV1 {
     // Builder Pattern Support
     /**
      * Creates a new ParagraphBuilder for fluent paragraph construction.
-     * Equivalent to paragraphBuilder() in Python client.
      */
     paragraphBuilder() {
         return new paragraph_builder_1.ParagraphBuilder(this);