pdfdancer-client-typescript 1.0.17 → 1.0.19

package/dist/path-builder.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PathBuilder = void 0;
+const models_1 = require("./models");
+/**
+ * Builder for creating vector paths in PDF documents.
+ *
+ * Supports creating paths with:
+ * - Lines
+ * - Bezier curves
+ * - Custom stroke and fill colors
+ * - Stroke width and dash patterns
+ *
+ * @example
+ * ```typescript
+ * // Create a simple line
+ * await pdf.newPath()
+ *   .moveTo(100, 100)
+ *   .lineTo(200, 200)
+ *   .strokeColor(new Color(0, 0, 0))
+ *   .strokeWidth(2)
+ *   .at(0, 0, 0)
+ *   .add();
+ *
+ * // Create a bezier curve
+ * await pdf.newPath()
+ *   .moveTo(100, 100)
+ *   .bezierTo(150, 50, 250, 150, 300, 100)
+ *   .strokeColor(new Color(255, 0, 0))
+ *   .at(0, 0, 0)
+ *   .add();
+ * ```
+ */
+class PathBuilder {
+    constructor(_client, _defaultPageIndex) {
+        this._client = _client;
+        this._defaultPageIndex = _defaultPageIndex;
+        this._segments = [];
+        // Cast to the internal interface to get access
+        this._internals = this._client;
+    }
+    /**
+     * Move to a point without drawing.
+     * Sets the current point for subsequent drawing operations.
+     */
+    moveTo(x, y) {
+        this._currentPoint = { x, y };
+        return this;
+    }
+    /**
+     * Draw a line from the current point to the specified point.
+     */
+    lineTo(x, y) {
+        if (!this._currentPoint) {
+            throw new Error("No current point set. Call moveTo() first.");
+        }
+        const line = new models_1.Line(this._currentPoint, { x, y }, undefined, // position will be set in add()
+        this._strokeColor, this._fillColor, this._strokeWidth, this._dashArray, this._dashPhase);
+        this._segments.push(line);
+        this._currentPoint = { x, y };
+        return this;
+    }
+    /**
+     * Draw a cubic Bezier curve from the current point.
+     * @param cp1x First control point X
+     * @param cp1y First control point Y
+     * @param cp2x Second control point X
+     * @param cp2y Second control point Y
+     * @param x End point X
+     * @param y End point Y
+     */
+    bezierTo(cp1x, cp1y, cp2x, cp2y, x, y) {
+        if (!this._currentPoint) {
+            throw new Error("No current point set. Call moveTo() first.");
+        }
+        const bezier = new models_1.Bezier(this._currentPoint, { x: cp1x, y: cp1y }, { x: cp2x, y: cp2y }, { x, y }, undefined, // position will be set in add()
+        this._strokeColor, this._fillColor, this._strokeWidth, this._dashArray, this._dashPhase);
+        this._segments.push(bezier);
+        this._currentPoint = { x, y };
+        return this;
+    }
+    /**
+     * Add a custom path segment.
+     */
+    addSegment(segment) {
+        this._segments.push(segment);
+        return this;
+    }
+    /**
+     * Set the stroke color for subsequent path segments.
+     */
+    strokeColor(color) {
+        this._strokeColor = color;
+        return this;
+    }
+    /**
+     * Set the fill color for subsequent path segments.
+     */
+    fillColor(color) {
+        this._fillColor = color;
+        return this;
+    }
+    /**
+     * Set the stroke width for subsequent path segments.
+     */
+    strokeWidth(width) {
+        this._strokeWidth = width;
+        return this;
+    }
+    /**
+     * Set the dash pattern for subsequent path segments.
+     * @param dashArray Array of numbers specifying dash pattern (on/off lengths)
+     * @param dashPhase Offset into the dash pattern
+     */
+    dashPattern(dashArray, dashPhase = 0) {
+        this._dashArray = dashArray;
+        this._dashPhase = dashPhase;
+        return this;
+    }
+    /**
+     * Set whether to use even-odd fill rule (true) or nonzero winding rule (false).
+     */
+    evenOddFill(useEvenOdd) {
+        this._evenOddFill = useEvenOdd;
+        return this;
+    }
+    at(pageIndexOrX, xOrY, maybeY) {
+        if (maybeY === undefined) {
+            if (this._defaultPageIndex === undefined) {
+                throw new Error('Page index must be provided when adding a path');
+            }
+            this._position = models_1.Position.atPageCoordinates(this._defaultPageIndex, pageIndexOrX, xOrY);
+        }
+        else {
+            this._position = models_1.Position.atPageCoordinates(pageIndexOrX, xOrY, maybeY);
+        }
+        return this;
+    }
+    /**
+     * Set the position using a Position object.
+     */
+    atPosition(position) {
+        this._position = position;
+        return this;
+    }
+    /**
+     * Add the path to the PDF document.
+     */
+    async add() {
+        if (this._segments.length === 0) {
+            throw new Error("No path segments defined. Use moveTo(), lineTo(), or bezierTo() to create path segments.");
+        }
+        if (!this._position) {
+            throw new Error("Position is not set. Use at() or atPosition() to set the position.");
+        }
+        // Apply current styling and position to all segments
+        for (const segment of this._segments) {
+            // All segments share the same position as the path
+            segment.position = this._position;
+            segment.strokeColor = this._strokeColor;
+            segment.fillColor = this._fillColor;
+            segment.strokeWidth = this._strokeWidth;
+            segment.dashArray = this._dashArray;
+            segment.dashPhase = this._dashPhase;
+        }
+        const path = new models_1.Path(this._position, this._segments, this._evenOddFill);
+        return await this._internals.addPath(path);
+    }
+    /**
+     * Alias for add(). Adds the path to the PDF document.
+     */
+    async apply() {
+        return await this.add();
+    }
+}
+exports.PathBuilder = PathBuilder;
+//# sourceMappingURL=path-builder.js.map

package/dist/path-builder.js.map

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

package/dist/pdfdancer_v1.d.ts

@@ -8,6 +8,7 @@ import { ParagraphBuilder } from './paragraph-builder';
 import { PageBuilder } from './page-builder';
 import { FormFieldObject, FormXObject, ImageObject, ParagraphObject, PathObject, TextLineObject } from "./types";
 import { ImageBuilder } from "./image-builder";
+import { PathBuilder } from "./path-builder";
 /**
  * Configuration for retry mechanism on REST API calls.
  */
@@ -80,6 +81,7 @@ declare class PageClient {
      */
     newParagraph(pageIndex?: number): ParagraphBuilder;
     newImage(pageIndex?: number): ImageBuilder;
+    newPath(pageIndex?: number): PathBuilder;
     selectTextLines(): Promise<TextLineObject[]>;
     selectTextLinesMatching(pattern: string): Promise<TextLineObject[]>;
     selectTextLinesAt(x: number, y: number, tolerance?: number): Promise<TextLineObject[]>;
@@ -311,6 +313,10 @@ export declare class PDFDancer {
      * Adds a paragraph to the PDF document.
      */
     private addParagraph;
+    /**
+     * Adds a path to the PDF document.
+     */
+    private addPath;
     /**
      * Adds a page to the PDF document.
      */
@@ -372,6 +378,7 @@ export declare class PDFDancer {
     private toImageObjects;
     newImage(pageIndex?: number): ImageBuilder;
     newParagraph(pageIndex?: number): ParagraphBuilder;
+    newPath(pageIndex?: number): PathBuilder;
     newPage(): PageBuilder;
     page(pageIndex: number): PageClient;
     pages(): Promise<PageClient[]>;

package/dist/pdfdancer_v1.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pdfdancer_v1.d.ts","sourceRoot":"","sources":["../src/pdfdancer_v1.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pdfdancer_v1.d.ts","sourceRoot":"","sources":["../src/pdfdancer_v1.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,EAUH,gBAAgB,EAEhB,IAAI,EAQJ,SAAS,EACT,UAAU,EACV,WAAW,EACX,OAAO,EACP,QAAQ,EACR,aAAa,EACb,YAAY,EAGZ,QAAQ,EAKX,MAAM,UAAU,CAAC;AAClB,OAAO,EAAC,gBAAgB,EAAC,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAC,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,EAAC,MAAM,SAAS,CAAC;AAC/G,OAAO,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAO3C;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhC;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAqMD,cAAM,UAAU;IAEZ,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAY;IAC3B,IAAI,EAAE,UAAU,CAAmB;IACnC,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,OAAO,CAAC,UAAU,CAAqB;gBAE3B,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;IAW7D,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,GAAE,MAAU;IAIzD,WAAW;IAIX,YAAY;IAIZ,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,GAAE,MAAU;IAI1D,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAI1B,MAAM,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWjD,WAAW;IAIX,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,GAAE,MAAU;IAIzD,gBAAgB;IAIhB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,GAAE,MAAU;IAK9D,sBAAsB,CAAC,SAAS,EAAE,MAAM;IAMxC,gBAAgB;IAIhB,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE;IAKnC,4BAA4B,CAAC,IAAI,EAAE,MAAM;IAMzC,wBAAwB,CAAC,OAAO,EAAE,MAAM;IAMxC,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,GAAE,MAA0B;IAM9E,2BAA2B,CAAC,IAAI,EAAE,MAAM;IAM9C;;OAEG;IACH,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,gBAAgB;IAKlD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM;IAK3B,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM;IAKpB,eAAe;IAKf,uBAAuB,CAAC,OAAO,EAAE,MAAM;IAOvC,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,GAAE,MAA0B;IAMnF;;;OAGG;IACG,WAAW,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAMxD,UAAU;IAKV,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,GAAE,MAAU;IAKxD,WAAW;IAKX,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,GAAE,MAAU;IAKzD,UAAU;IAKV,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,GAAE,MAAU;IAKxD,eAAe;IAKf,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,GAAE,MAAU;IAK7D,qBAAqB,CAAC,SAAS,EAAE,MAAM;IAKvC,eAAe;IAKf,2BAA2B,CAAC,IAAI,EAAE,MAAM;IAKxC,uBAAuB,CAAC,OAAO,EAAE,MAAM;IAKvC,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,GAAE,MAA0B;IAK7E,cAAc;IAKd,0BAA0B,CAAC,IAAI,EAAE,MAAM;IAKvC,sBAAsB,CAAC,OAAO,EAAE,MAAM;IAKtC,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,GAAE,MAA0B;CAIrF;AAGD;;;;;;GAMG;AACH,qBAAa,SAAS;IAClB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,iBAAiB,CAAC,CAAS;IACnC,OAAO,CAAC,YAAY,CAAwB;IAG5C,OAAO,CAAC,sBAAsB,CAAiC;IAC/D,OAAO,CAAC,kBAAkB,CAAwC;IAClE,OAAO,CAAC,WAAW,CAA0B;IAE7C;;;;OAIG;IACH,OAAO;IA6CP;;;OAGG;YACW,IAAI;WAKL,IAAI,CACb,OAAO,EAAE,UAAU,EACnB,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,WAAW,GAC1B,OAAO,CAAC,SAAS,CAAC;IAgBrB;;;;;;;;;;;OAWG;WACU,GAAG,CACZ,OAAO,CAAC,EAAE;QACN,QAAQ,CAAC,EAAE,aAAa,CAAC;QACzB,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC7B,EACD,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,WAAW,GAC1B,OAAO,CAAC,SAAS,CAAC;mBAsFA,qBAAqB;IA6C1C;;OAEG;IACH,OAAO,CAAC,eAAe;IAyCvB;;;OAGG;IACH,OAAO,CAAC,SAAS;IAMjB;;;OAGG;YACW,oBAAoB;IAuClC;;OAEG;YACW,cAAc;IA2D5B;;OAEG;YACW,eAAe;IAO7B;;;OAGG;YACW,eAAe;IAQ7B;;OAEG;YACW,YAAY;IAkE1B;;;;;;OAMG;YACW,IAAI;IAqClB;;OAEG;YACW,cAAc;IAI5B;;OAEG;YACW,WAAW;IAInB,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAI5C;;OAEG;YACW,gBAAgB;IAI9B;;OAEG;YACW,SAAS;IAIjB,WAAW;IAIX,WAAW;IAIX,gBAAgB;IAIhB,kBAAkB,CAAC,SAAS,EAAE,MAAM;IAI1C;;OAEG;YACW,aAAa;IAI3B;;;;;OAKG;YACW,cAAc;IA6B5B;;;OAGG;YACW,QAAQ;IAkBtB;;;OAGG;YACW,QAAQ;IAwBtB;;OAEG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAsB5E;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYrD,OAAO,CAAC,kBAAkB;YASZ,eAAe;IAQ7B;;OAEG;YACW,WAAW;IAYzB;;;;;;OAMG;IACG,mBAAmB,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAY1E;;;;;;;OAOG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAgBrF;;;OAGG;YACW,uBAAuB;IAuBrC;;OAEG;YACW,2BAA2B;IAOzC;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IA6DzB;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAInC,OAAO,CAAC,mBAAmB;IA0B3B;;OAEG;YACW,MAAM;IAepB;;OAEG;YACW,IAAI;IAkBlB;;OAEG;YACW,eAAe;IAiB7B;;OAEG;YACW,QAAQ;IAgBtB;;OAEG;YACW,YAAY;IAiB1B;;OAEG;YACW,OAAO;IAiBrB;;OAEG;YACW,OAAO;IAYrB;;OAEG;YACW,UAAU;IAaxB;;OAEG;YACW,eAAe;IA2B7B;;OAEG;YACW,cAAc;IAoB5B;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAepE;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAsExE;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC;IAKrC;;;OAGG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB3C;;OAEG;IACH,OAAO,CAAC,eAAe;IAiCvB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,mBAAmB;IAmE3B,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,kBAAkB;IAe1B;;OAEG;IACH,OAAO,CAAC,cAAc;IA2BtB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA8B9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA0B1B,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,cAAc;IAItB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM;IAI3B,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM;IAI/B,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM;IAI1B,OAAO;IAIP,IAAI,CAAC,SAAS,EAAE,MAAM;IAOhB,KAAK;IAKX,OAAO,CAAC,YAAY;IAId,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE;IASnC,gBAAgB;IAIhB,wBAAwB,CAAC,OAAO,EAAE,MAAM;IAS9C,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,iBAAiB;IAInB,eAAe;IAIf,WAAW;IAMX,WAAW;IAKX,UAAU;IAKV,UAAU;IAKV,eAAe;IAKf,iBAAiB,CAAC,SAAS,EAAE,MAAM;IAKnC,eAAe;IAKf,uBAAuB,CAAC,OAAO,EAAE,MAAM;IAKvC,cAAc;IAKd,UAAU;CAGnB"}

package/dist/pdfdancer_v1.js

@@ -15,14 +15,11 @@ const paragraph_builder_1 = require("./paragraph-builder");
 const page_builder_1 = require("./page-builder");
 const types_1 = require("./types");
 const image_builder_1 = require("./image-builder");
+const path_builder_1 = require("./path-builder");
 const fingerprint_1 = require("./fingerprint");
 const fs_1 = __importDefault(require("fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const DEFAULT_TOLERANCE = 0.01;
-// Debug flag - set to true to enable timing logs
-const DEBUG = (process.env.PDFDANCER_CLIENT_DEBUG ?? '').toLowerCase() === 'true' ||
-    (process.env.PDFDANCER_CLIENT_DEBUG ?? '') === '1' ||
-    (process.env.PDFDANCER_CLIENT_DEBUG ?? '').toLowerCase() === 'yes';
 /**
  * Default retry configuration
  */
@@ -42,7 +39,7 @@ const DEFAULT_RETRY_CONFIG = {
  */
 async function fetchWithRetry(url, 
 // eslint-disable-next-line no-undef
-options, retryConfig, context = 'request') {
+options, retryConfig) {
     let lastError = null;
     let lastResponse = null;
     for (let attempt = 0; attempt <= retryConfig.maxRetries; attempt++) {
@@ -54,14 +51,12 @@ options, retryConfig, context = 'request') {
                 // If this is not the last attempt, wait and retry
                 if (attempt < retryConfig.maxRetries) {
                     let delay;
-                    let delaySource = 'exponential backoff';
                     // Check for Retry-After header if configured
                     if (retryConfig.respectRetryAfter) {
                         const retryAfterDelay = parseRetryAfter(response);
                         if (retryAfterDelay !== null) {
                             // Use Retry-After header value, but cap at maxDelay
                             delay = Math.min(retryAfterDelay, retryConfig.maxDelay);
-                            delaySource = 'Retry-After header';
                         }
                         else {
                             // Fall back to exponential backoff
@@ -72,9 +67,6 @@ options, retryConfig, context = 'request') {
                         // Use exponential backoff
                         delay = calculateRetryDelay(attempt, retryConfig);
                     }
-                    if (DEBUG) {
-                        console.log(`${Date.now() / 1000}|Retry attempt ${attempt + 1}/${retryConfig.maxRetries} for ${context} after ${delay}ms (status: ${response.status}, source: ${delaySource})`);
-                    }
                     await sleep(delay);
                     continue;
                 }
@@ -87,10 +79,6 @@ options, retryConfig, context = 'request') {
             // Check if this is a network error and we should retry
             if (retryConfig.retryOnNetworkError && attempt < retryConfig.maxRetries) {
                 const delay = calculateRetryDelay(attempt, retryConfig);
-                if (DEBUG) {
-                    const errorMessage = error instanceof Error ? error.message : String(error);
-                    console.log(`${Date.now() / 1000}|Retry attempt ${attempt + 1}/${retryConfig.maxRetries} for ${context} after ${delay}ms (error: ${errorMessage})`);
-                }
                 await sleep(delay);
                 continue;
             }
@@ -176,69 +164,6 @@ function generateTimestamp() {
     const microseconds = milliseconds + '000';
     return `${year}-${month}-${day}T${hours}:${minutes}:${seconds}.${microseconds}Z`;
 }
-/**
- * Parse timestamp string, handling both microseconds and nanoseconds precision.
- * @param timestampStr Timestamp string in format YYYY-MM-DDTHH:MM:SS.fffffffZ (with 6 or 9 fractional digits)
- */
-function parseTimestamp(timestampStr) {
-    // Remove the 'Z' suffix
-    let ts = timestampStr.replace(/Z$/, '');
-    // Handle nanoseconds (9 digits) by truncating to milliseconds (3 digits)
-    // JavaScript's Date only supports millisecond precision
-    if (ts.includes('.')) {
-        const [datePart, fracPart] = ts.split('.');
-        // Truncate to 3 digits (milliseconds)
-        const truncatedFrac = fracPart.substring(0, 3);
-        ts = `${datePart}.${truncatedFrac}`;
-    }
-    return new Date(ts + 'Z');
-}
-/**
- * Check for X-Generated-At and X-Received-At headers and log timing information if DEBUG=true.
- *
- * Expected timestamp formats:
- * - 2025-10-24T08:49:39.161945Z (microseconds - 6 digits)
- * - 2025-10-24T08:58:45.468131265Z (nanoseconds - 9 digits)
- */
-function logGeneratedAtHeader(response, method, path) {
-    if (!DEBUG) {
-        return;
-    }
-    const generatedAt = response.headers.get('X-Generated-At');
-    const receivedAt = response.headers.get('X-Received-At');
-    if (generatedAt || receivedAt) {
-        try {
-            const logParts = [];
-            const currentTime = new Date();
-            // Parse and log X-Received-At
-            let receivedTime = null;
-            if (receivedAt) {
-                receivedTime = parseTimestamp(receivedAt);
-                const timeSinceReceived = (currentTime.getTime() - receivedTime.getTime()) / 1000;
-                logParts.push(`X-Received-At: ${receivedAt}, time since received on backend: ${timeSinceReceived.toFixed(3)}s`);
-            }
-            // Parse and log X-Generated-At
-            let generatedTime = null;
-            if (generatedAt) {
-                generatedTime = parseTimestamp(generatedAt);
-                const timeSinceGenerated = (currentTime.getTime() - generatedTime.getTime()) / 1000;
-                logParts.push(`X-Generated-At: ${generatedAt}, time since generated on backend: ${timeSinceGenerated.toFixed(3)}s`);
-            }
-            // Calculate processing time (X-Generated-At - X-Received-At)
-            if (receivedTime && generatedTime) {
-                const processingTime = (generatedTime.getTime() - receivedTime.getTime()) / 1000;
-                logParts.push(`processing time on backend: ${processingTime.toFixed(3)}s`);
-            }
-            if (logParts.length > 0) {
-                console.log(`${Date.now() / 1000}|${method} ${path} - ${logParts.join(', ')}`);
-            }
-        }
-        catch (e) {
-            const errorMessage = e instanceof Error ? e.message : String(e);
-            console.log(`${Date.now() / 1000}|${method} ${path} - Header parse error: ${errorMessage}`);
-        }
-    }
-}
 class PageClient {
     constructor(client, pageIndex, pageRef) {
         this.type = models_1.ObjectType.PAGE;
@@ -330,6 +255,10 @@ class PageClient {
         const targetIndex = pageIndex ?? this.position.pageIndex;
         return new image_builder_1.ImageBuilder(this._client, targetIndex);
     }
+    newPath(pageIndex) {
+        const targetIndex = pageIndex ?? this.position.pageIndex;
+        return new path_builder_1.PathBuilder(this._client, targetIndex);
+    }
     async selectTextLines() {
         return this._internals.toTextLineObjects(await this._internals.findTextLines(models_1.Position.atPage(this._pageIndex)));
     }
@@ -535,8 +464,7 @@ class PDFDancer {
                 },
                 body: JSON.stringify(createRequest.toDict()),
                 signal: resolvedTimeout > 0 ? AbortSignal.timeout(resolvedTimeout) : undefined
-            }, DEFAULT_RETRY_CONFIG, 'POST /session/new');
-            logGeneratedAtHeader(response, 'POST', '/session/new');
+            }, DEFAULT_RETRY_CONFIG);
             if (!response.ok) {
                 const errorText = await response.text();
                 throw new exceptions_1.HttpClientException(`Failed to create new PDF: ${errorText}`, response);
@@ -583,7 +511,7 @@ class PDFDancer {
                     'X-Generated-At': generateTimestamp()
                 },
                 signal: timeout > 0 ? AbortSignal.timeout(timeout) : undefined
-            }, DEFAULT_RETRY_CONFIG, 'POST /keys/anon');
+            }, DEFAULT_RETRY_CONFIG);
             if (!response.ok) {
                 const errorText = await response.text().catch(() => '');
                 throw new exceptions_1.HttpClientException(`Failed to obtain anonymous token: ${errorText || `HTTP ${response.status}`}`, response);
@@ -722,8 +650,7 @@ class PDFDancer {
                 },
                 body: formData,
                 signal: this._readTimeout > 0 ? AbortSignal.timeout(this._readTimeout) : undefined
-            }, 'POST /session/create');
-            logGeneratedAtHeader(response, 'POST', '/session/create');
+            });
             if (!response.ok) {
                 const errorMessage = await this._extractErrorMessage(response);
                 if (response.status === 401 || response.status === 403) {
@@ -765,8 +692,8 @@ class PDFDancer {
      */
     async _fetchWithRetry(url, 
     // eslint-disable-next-line no-undef
-    options, context = 'request') {
-        return fetchWithRetry(url, options, this._retryConfig, context);
+    options) {
+        return fetchWithRetry(url, options, this._retryConfig);
     }
     /**
      * Make HTTP request with session headers and error handling.
@@ -792,8 +719,7 @@ class PDFDancer {
                 headers,
                 body: data ? JSON.stringify(data) : undefined,
                 signal: this._readTimeout > 0 ? AbortSignal.timeout(this._readTimeout) : undefined
-            }, `${method} ${path}`);
-            logGeneratedAtHeader(response, method, path);
+            });
             // Handle FontNotFoundException
             if (response.status === 404) {
                 try {
@@ -1275,6 +1201,24 @@ class PDFDancer {
         }
         return this._addObject(paragraph);
     }
+    /**
+     * Adds a path to the PDF document.
+     */
+    async addPath(path) {
+        if (!path) {
+            throw new exceptions_1.ValidationException("Path cannot be null");
+        }
+        if (!path.getPosition()) {
+            throw new exceptions_1.ValidationException("Path position is null, you need to specify a position for the new path, using .at(x,y)");
+        }
+        if (path.getPosition().pageIndex === undefined) {
+            throw new exceptions_1.ValidationException("Path position page index is null");
+        }
+        if (path.getPosition().pageIndex < 0) {
+            throw new exceptions_1.ValidationException("Path position page index is less than 0");
+        }
+        return await this._addObject(path);
+    }
     /**
      * Adds a page to the PDF document.
      */
@@ -1408,8 +1352,7 @@ class PDFDancer {
                 },
                 body: formData,
                 signal: AbortSignal.timeout(60000)
-            }, 'POST /font/register');
-            logGeneratedAtHeader(response, 'POST', '/font/register');
+            });
             if (!response.ok) {
                 const errorMessage = await this._extractErrorMessage(response);
                 throw new exceptions_1.HttpClientException(`Font registration failed: ${errorMessage}`, response);
@@ -1640,7 +1583,12 @@ class PDFDancer {
         const elements = [];
         if (Array.isArray(data.elements)) {
             for (const elementData of data.elements) {
-                elements.push(this._parseObjectRef(elementData));
+                const element = this._parseObjectRef(elementData);
+                // If the element's position doesn't have a pageIndex, inherit it from the page
+                if (element.position && element.position.pageIndex === undefined) {
+                    element.position.pageIndex = pageRef.position.pageIndex;
+                }
+                elements.push(element);
             }
         }
         return new models_1.PageSnapshot(pageRef, elements);
@@ -1661,6 +1609,9 @@ class PDFDancer {
     newParagraph(pageIndex) {
         return new paragraph_builder_1.ParagraphBuilder(this, pageIndex);
     }
+    newPath(pageIndex) {
+        return new path_builder_1.PathBuilder(this, pageIndex);
+    }
     newPage() {
         return new page_builder_1.PageBuilder(this);
     }