@insureco/docman 1.0.0

package/dist/index.d.cts

@@ -0,0 +1,103 @@
+import { D as DocmanClientConfig, C as CreateHtmlTemplateOptions, H as HtmlTemplate, a as HtmlTemplateListQuery, L as ListResult, U as UpdateHtmlTemplateOptions, b as CreatePdfTemplateOptions, P as PdfTemplate, c as PdfTemplateListQuery, d as PdfField, e as UpdatePdfTemplateOptions, f as CreateTemplateGroupOptions, T as TemplateGroup, g as ListQuery, h as UpdateTemplateGroupOptions, G as GenerateOptions, i as GenerateResult, j as DocmanDocument, k as DocumentVersion, l as PageRange, S as SplitPart } from './types-xbeSIrNB.cjs';
+export { m as ListMeta, n as SourceTemplate, o as TemplateCoordinates, p as TemplateGroupItem } from './types-xbeSIrNB.cjs';
+
+declare class DocmanClient {
+    private readonly baseUrl;
+    private readonly accessTokenFn?;
+    private readonly internalKey?;
+    private readonly retries;
+    private readonly timeoutMs;
+    private cachedToken;
+    constructor(config: DocmanClientConfig);
+    /**
+     * Create a client from environment variables.
+     *
+     * Reads DOCMAN_URL (injected automatically when you declare docman as an
+     * internalDependency in catalog-info.yaml). Auth priority:
+     *   1. BIO_CLIENT_ID + BIO_CLIENT_SECRET  → client_credentials token
+     *   2. INTERNAL_SERVICE_KEY               → internal key header
+     *   3. No auth                            → local dev / testing
+     *
+     * catalog-info.yaml:
+     *   spec:
+     *     internalDependencies:
+     *       - service: docman
+     *         port: 3000
+     */
+    static fromEnv(): DocmanClient;
+    private authHeaders;
+    private rawFetch;
+    private fetchData;
+    private fetchList;
+    private buildQuery;
+    /** Fetch with FormData body (multipart), return raw binary buffer. */
+    private fetchBinary;
+    /** POST multipart form and parse the JSON response envelope. */
+    private fetchMultipartJson;
+    /** PUT multipart form and parse the JSON response envelope. */
+    private putMultipartJson;
+    createHtmlTemplate(options: CreateHtmlTemplateOptions): Promise<HtmlTemplate>;
+    listHtmlTemplates(query?: HtmlTemplateListQuery): Promise<ListResult<HtmlTemplate>>;
+    getHtmlTemplate(id: string): Promise<HtmlTemplate>;
+    updateHtmlTemplate(id: string, options: UpdateHtmlTemplateOptions): Promise<HtmlTemplate>;
+    deleteHtmlTemplate(id: string): Promise<HtmlTemplate>;
+    /**
+     * Upload a PDF form template.
+     * @param file  Raw PDF bytes (Buffer or Uint8Array)
+     * @param options  Name, description, and optional coordinates/isSystem flags
+     */
+    uploadPdfTemplate(file: Buffer | Uint8Array, options?: CreatePdfTemplateOptions): Promise<PdfTemplate>;
+    listPdfTemplates(query?: PdfTemplateListQuery): Promise<ListResult<PdfTemplate>>;
+    getPdfTemplate(id: string): Promise<PdfTemplate>;
+    getPdfTemplateFields(id: string): Promise<readonly PdfField[]>;
+    getPdfTemplateDownloadUrl(id: string): Promise<string>;
+    /**
+     * Update a PDF template's metadata, and optionally replace the PDF file.
+     * @param file  If provided, replaces the stored PDF and re-extracts form fields
+     */
+    updatePdfTemplate(id: string, options: UpdatePdfTemplateOptions, file?: Buffer | Uint8Array): Promise<PdfTemplate>;
+    deletePdfTemplate(id: string): Promise<PdfTemplate>;
+    createTemplateGroup(options: CreateTemplateGroupOptions): Promise<TemplateGroup>;
+    listTemplateGroups(query?: ListQuery): Promise<ListResult<TemplateGroup>>;
+    getTemplateGroup(id: string): Promise<TemplateGroup>;
+    updateTemplateGroup(id: string, options: UpdateTemplateGroupOptions): Promise<TemplateGroup>;
+    deleteTemplateGroup(id: string): Promise<void>;
+    /**
+     * Generate a document and store it in S3.
+     * Returns a presigned download URL and a public share URL.
+     */
+    generate(options: GenerateOptions): Promise<GenerateResult>;
+    /**
+     * Generate a document and stream the PDF buffer directly.
+     * Nothing is stored — useful for previews or on-the-fly delivery.
+     */
+    generatePassthrough(options: GenerateOptions): Promise<Buffer>;
+    listDocuments(query?: ListQuery): Promise<ListResult<DocmanDocument>>;
+    getDocument(id: string): Promise<DocmanDocument>;
+    /** Get a presigned S3 download URL for a stored document (1-hour TTL). */
+    downloadUrl(id: string): Promise<string>;
+    getVersions(id: string): Promise<readonly DocumentVersion[]>;
+    /** Re-render a stored document using the original template data. */
+    regenerate(id: string): Promise<GenerateResult>;
+    /**
+     * Merge two or more PDF buffers into a single PDF.
+     * Returns the merged PDF as a Buffer.
+     */
+    merge(buffers: readonly (Buffer | Uint8Array)[]): Promise<Buffer>;
+    /**
+     * Split a PDF into parts by page ranges.
+     * Returns an array of SplitPart with buffer, range, and size info.
+     */
+    split(buffer: Buffer | Uint8Array, ranges: readonly PageRange[]): Promise<readonly SplitPart[]>;
+    /** Get the page count of a PDF buffer. */
+    pageCount(buffer: Buffer | Uint8Array): Promise<number>;
+}
+
+declare class DocmanError extends Error {
+    readonly statusCode: number;
+    readonly code?: string | undefined;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(message: string, statusCode: number, code?: string | undefined, details?: Record<string, unknown> | undefined);
+}
+
+export { CreateHtmlTemplateOptions, CreatePdfTemplateOptions, CreateTemplateGroupOptions, DocmanClient, DocmanClientConfig, DocmanDocument, DocmanError, DocumentVersion, GenerateOptions, GenerateResult, HtmlTemplate, HtmlTemplateListQuery, ListQuery, ListResult, PageRange, PdfField, PdfTemplate, PdfTemplateListQuery, SplitPart, TemplateGroup, UpdateHtmlTemplateOptions, UpdatePdfTemplateOptions, UpdateTemplateGroupOptions };

package/dist/index.d.ts

@@ -0,0 +1,103 @@
+import { D as DocmanClientConfig, C as CreateHtmlTemplateOptions, H as HtmlTemplate, a as HtmlTemplateListQuery, L as ListResult, U as UpdateHtmlTemplateOptions, b as CreatePdfTemplateOptions, P as PdfTemplate, c as PdfTemplateListQuery, d as PdfField, e as UpdatePdfTemplateOptions, f as CreateTemplateGroupOptions, T as TemplateGroup, g as ListQuery, h as UpdateTemplateGroupOptions, G as GenerateOptions, i as GenerateResult, j as DocmanDocument, k as DocumentVersion, l as PageRange, S as SplitPart } from './types-xbeSIrNB.js';
+export { m as ListMeta, n as SourceTemplate, o as TemplateCoordinates, p as TemplateGroupItem } from './types-xbeSIrNB.js';
+
+declare class DocmanClient {
+    private readonly baseUrl;
+    private readonly accessTokenFn?;
+    private readonly internalKey?;
+    private readonly retries;
+    private readonly timeoutMs;
+    private cachedToken;
+    constructor(config: DocmanClientConfig);
+    /**
+     * Create a client from environment variables.
+     *
+     * Reads DOCMAN_URL (injected automatically when you declare docman as an
+     * internalDependency in catalog-info.yaml). Auth priority:
+     *   1. BIO_CLIENT_ID + BIO_CLIENT_SECRET  → client_credentials token
+     *   2. INTERNAL_SERVICE_KEY               → internal key header
+     *   3. No auth                            → local dev / testing
+     *
+     * catalog-info.yaml:
+     *   spec:
+     *     internalDependencies:
+     *       - service: docman
+     *         port: 3000
+     */
+    static fromEnv(): DocmanClient;
+    private authHeaders;
+    private rawFetch;
+    private fetchData;
+    private fetchList;
+    private buildQuery;
+    /** Fetch with FormData body (multipart), return raw binary buffer. */
+    private fetchBinary;
+    /** POST multipart form and parse the JSON response envelope. */
+    private fetchMultipartJson;
+    /** PUT multipart form and parse the JSON response envelope. */
+    private putMultipartJson;
+    createHtmlTemplate(options: CreateHtmlTemplateOptions): Promise<HtmlTemplate>;
+    listHtmlTemplates(query?: HtmlTemplateListQuery): Promise<ListResult<HtmlTemplate>>;
+    getHtmlTemplate(id: string): Promise<HtmlTemplate>;
+    updateHtmlTemplate(id: string, options: UpdateHtmlTemplateOptions): Promise<HtmlTemplate>;
+    deleteHtmlTemplate(id: string): Promise<HtmlTemplate>;
+    /**
+     * Upload a PDF form template.
+     * @param file  Raw PDF bytes (Buffer or Uint8Array)
+     * @param options  Name, description, and optional coordinates/isSystem flags
+     */
+    uploadPdfTemplate(file: Buffer | Uint8Array, options?: CreatePdfTemplateOptions): Promise<PdfTemplate>;
+    listPdfTemplates(query?: PdfTemplateListQuery): Promise<ListResult<PdfTemplate>>;
+    getPdfTemplate(id: string): Promise<PdfTemplate>;
+    getPdfTemplateFields(id: string): Promise<readonly PdfField[]>;
+    getPdfTemplateDownloadUrl(id: string): Promise<string>;
+    /**
+     * Update a PDF template's metadata, and optionally replace the PDF file.
+     * @param file  If provided, replaces the stored PDF and re-extracts form fields
+     */
+    updatePdfTemplate(id: string, options: UpdatePdfTemplateOptions, file?: Buffer | Uint8Array): Promise<PdfTemplate>;
+    deletePdfTemplate(id: string): Promise<PdfTemplate>;
+    createTemplateGroup(options: CreateTemplateGroupOptions): Promise<TemplateGroup>;
+    listTemplateGroups(query?: ListQuery): Promise<ListResult<TemplateGroup>>;
+    getTemplateGroup(id: string): Promise<TemplateGroup>;
+    updateTemplateGroup(id: string, options: UpdateTemplateGroupOptions): Promise<TemplateGroup>;
+    deleteTemplateGroup(id: string): Promise<void>;
+    /**
+     * Generate a document and store it in S3.
+     * Returns a presigned download URL and a public share URL.
+     */
+    generate(options: GenerateOptions): Promise<GenerateResult>;
+    /**
+     * Generate a document and stream the PDF buffer directly.
+     * Nothing is stored — useful for previews or on-the-fly delivery.
+     */
+    generatePassthrough(options: GenerateOptions): Promise<Buffer>;
+    listDocuments(query?: ListQuery): Promise<ListResult<DocmanDocument>>;
+    getDocument(id: string): Promise<DocmanDocument>;
+    /** Get a presigned S3 download URL for a stored document (1-hour TTL). */
+    downloadUrl(id: string): Promise<string>;
+    getVersions(id: string): Promise<readonly DocumentVersion[]>;
+    /** Re-render a stored document using the original template data. */
+    regenerate(id: string): Promise<GenerateResult>;
+    /**
+     * Merge two or more PDF buffers into a single PDF.
+     * Returns the merged PDF as a Buffer.
+     */
+    merge(buffers: readonly (Buffer | Uint8Array)[]): Promise<Buffer>;
+    /**
+     * Split a PDF into parts by page ranges.
+     * Returns an array of SplitPart with buffer, range, and size info.
+     */
+    split(buffer: Buffer | Uint8Array, ranges: readonly PageRange[]): Promise<readonly SplitPart[]>;
+    /** Get the page count of a PDF buffer. */
+    pageCount(buffer: Buffer | Uint8Array): Promise<number>;
+}
+
+declare class DocmanError extends Error {
+    readonly statusCode: number;
+    readonly code?: string | undefined;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(message: string, statusCode: number, code?: string | undefined, details?: Record<string, unknown> | undefined);
+}
+
+export { CreateHtmlTemplateOptions, CreatePdfTemplateOptions, CreateTemplateGroupOptions, DocmanClient, DocmanClientConfig, DocmanDocument, DocmanError, DocumentVersion, GenerateOptions, GenerateResult, HtmlTemplate, HtmlTemplateListQuery, ListQuery, ListResult, PageRange, PdfField, PdfTemplate, PdfTemplateListQuery, SplitPart, TemplateGroup, UpdateHtmlTemplateOptions, UpdatePdfTemplateOptions, UpdateTemplateGroupOptions };

package/dist/index.js

@@ -0,0 +1,443 @@
+import {
+  DocmanError
+} from "./chunk-7DJVMOS3.js";
+
+// src/client.ts
+var DEFAULT_RETRIES = 2;
+var DEFAULT_TIMEOUT_MS = 15e3;
+var TOKEN_BUFFER_SECONDS = 30;
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function backoff(attempt) {
+  const base = Math.min(1e3 * 2 ** attempt, 5e3);
+  return base * (0.5 + Math.random() * 0.5);
+}
+function isTokenExpired(token, bufferSeconds = TOKEN_BUFFER_SECONDS) {
+  try {
+    const parts = token.split(".");
+    if (parts.length !== 3) return true;
+    const payload = JSON.parse(Buffer.from(parts[1], "base64url").toString());
+    const now = Math.floor(Date.now() / 1e3);
+    return (payload.exp ?? 0) <= now + bufferSeconds;
+  } catch {
+    return true;
+  }
+}
+function extractError(envelope) {
+  const err = envelope.error;
+  if (typeof err === "object" && err !== null) return err;
+  return { code: "REQUEST_ERROR", message: err ?? "Request failed" };
+}
+var DocmanClient = class _DocmanClient {
+  baseUrl;
+  accessTokenFn;
+  internalKey;
+  retries;
+  timeoutMs;
+  cachedToken = null;
+  constructor(config) {
+    this.baseUrl = config.baseUrl.replace(/\/$/, "");
+    this.accessTokenFn = config.accessTokenFn;
+    this.internalKey = config.internalKey;
+    this.retries = config.retries ?? DEFAULT_RETRIES;
+    this.timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  }
+  /**
+   * Create a client from environment variables.
+   *
+   * Reads DOCMAN_URL (injected automatically when you declare docman as an
+   * internalDependency in catalog-info.yaml). Auth priority:
+   *   1. BIO_CLIENT_ID + BIO_CLIENT_SECRET  → client_credentials token
+   *   2. INTERNAL_SERVICE_KEY               → internal key header
+   *   3. No auth                            → local dev / testing
+   *
+   * catalog-info.yaml:
+   *   spec:
+   *     internalDependencies:
+   *       - service: docman
+   *         port: 3000
+   */
+  static fromEnv() {
+    const baseUrl = process.env.DOCMAN_URL;
+    if (!baseUrl) {
+      throw new DocmanError(
+        "DOCMAN_URL is not set. Add docman as an internalDependency in catalog-info.yaml",
+        500,
+        "CONFIG_ERROR"
+      );
+    }
+    const clientId = process.env.BIO_CLIENT_ID;
+    const clientSecret = process.env.BIO_CLIENT_SECRET;
+    const bioIdUrl = process.env.BIO_ID_URL ?? "https://bio.tawa.insureco.io";
+    if (clientId && clientSecret) {
+      return new _DocmanClient({
+        baseUrl,
+        accessTokenFn: async () => {
+          const res = await fetch(`${bioIdUrl}/api/oauth/token`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+              grant_type: "client_credentials",
+              client_id: clientId,
+              client_secret: clientSecret
+            })
+          });
+          if (!res.ok) {
+            throw new DocmanError("Failed to obtain Bio-ID access token", res.status, "AUTH_ERROR");
+          }
+          const data = await res.json();
+          return data.access_token;
+        }
+      });
+    }
+    const internalKey = process.env.INTERNAL_SERVICE_KEY;
+    if (internalKey) {
+      return new _DocmanClient({ baseUrl, internalKey });
+    }
+    return new _DocmanClient({ baseUrl });
+  }
+  // ─── Auth ────────────────────────────────────────────────
+  async authHeaders() {
+    if (this.accessTokenFn) {
+      if (!this.cachedToken || isTokenExpired(this.cachedToken)) {
+        this.cachedToken = await this.accessTokenFn();
+      }
+      return { Authorization: `Bearer ${this.cachedToken}` };
+    }
+    if (this.internalKey) {
+      return { "X-Internal-Key": this.internalKey };
+    }
+    return {};
+  }
+  // ─── Core fetch ──────────────────────────────────────────
+  async rawFetch(method, path, body, attempt = 0) {
+    const headers = await this.authHeaders();
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+    let response;
+    try {
+      response = await fetch(`${this.baseUrl}${path}`, {
+        method,
+        headers: body !== void 0 ? { ...headers, "Content-Type": "application/json" } : headers,
+        body: body !== void 0 ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+    } catch (err) {
+      clearTimeout(timer);
+      if (attempt < this.retries) {
+        await sleep(backoff(attempt));
+        return this.rawFetch(method, path, body, attempt + 1);
+      }
+      throw new DocmanError(`Network error: ${err.message}`, 0, "NETWORK_ERROR");
+    } finally {
+      clearTimeout(timer);
+    }
+    if (response.status >= 500 && attempt < this.retries) {
+      await sleep(backoff(attempt));
+      return this.rawFetch(method, path, body, attempt + 1);
+    }
+    const envelope = await response.json();
+    if (!response.ok || !envelope.success) {
+      const { code, message } = extractError(envelope);
+      throw new DocmanError(message, response.status, code);
+    }
+    return envelope;
+  }
+  async fetchData(method, path, body) {
+    const envelope = await this.rawFetch(method, path, body);
+    return envelope.data;
+  }
+  async fetchList(path) {
+    const envelope = await this.rawFetch("GET", path);
+    return {
+      data: envelope.data ?? [],
+      meta: envelope.meta ?? { total: 0, page: 1, limit: 20 }
+    };
+  }
+  buildQuery(params) {
+    const pairs = Object.entries(params).filter(([, v]) => v !== void 0).map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`);
+    return pairs.length > 0 ? `?${pairs.join("&")}` : "";
+  }
+  /** Fetch with FormData body (multipart), return raw binary buffer. */
+  async fetchBinary(method, path, formData, attempt = 0) {
+    const headers = await this.authHeaders();
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+    let response;
+    try {
+      response = await fetch(`${this.baseUrl}${path}`, {
+        method,
+        headers,
+        body: formData,
+        signal: controller.signal
+      });
+    } catch (err) {
+      clearTimeout(timer);
+      if (attempt < this.retries) {
+        await sleep(backoff(attempt));
+        return this.fetchBinary(method, path, formData, attempt + 1);
+      }
+      throw new DocmanError(`Network error: ${err.message}`, 0, "NETWORK_ERROR");
+    } finally {
+      clearTimeout(timer);
+    }
+    if (response.status >= 500 && attempt < this.retries) {
+      await sleep(backoff(attempt));
+      return this.fetchBinary(method, path, formData, attempt + 1);
+    }
+    if (!response.ok) {
+      const envelope = await response.json();
+      const { code, message } = extractError(envelope);
+      throw new DocmanError(message, response.status, code);
+    }
+    return Buffer.from(await response.arrayBuffer());
+  }
+  /** POST multipart form and parse the JSON response envelope. */
+  async fetchMultipartJson(path, formData) {
+    const headers = await this.authHeaders();
+    const response = await fetch(`${this.baseUrl}${path}`, {
+      method: "POST",
+      headers,
+      body: formData
+    });
+    const envelope = await response.json();
+    if (!response.ok || !envelope.success) {
+      const { code, message } = extractError(envelope);
+      throw new DocmanError(message, response.status, code);
+    }
+    return envelope.data;
+  }
+  /** PUT multipart form and parse the JSON response envelope. */
+  async putMultipartJson(path, formData) {
+    const headers = await this.authHeaders();
+    const response = await fetch(`${this.baseUrl}${path}`, {
+      method: "PUT",
+      headers,
+      body: formData
+    });
+    const envelope = await response.json();
+    if (!response.ok || !envelope.success) {
+      const { code, message } = extractError(envelope);
+      throw new DocmanError(message, response.status, code);
+    }
+    return envelope.data;
+  }
+  // ─── HTML Templates ──────────────────────────────────────
+  async createHtmlTemplate(options) {
+    return this.fetchData("POST", "/templates/html", options);
+  }
+  async listHtmlTemplates(query = {}) {
+    return this.fetchList(`/templates/html${this.buildQuery(query)}`);
+  }
+  async getHtmlTemplate(id) {
+    return this.fetchData("GET", `/templates/html/${encodeURIComponent(id)}`);
+  }
+  async updateHtmlTemplate(id, options) {
+    return this.fetchData("PUT", `/templates/html/${encodeURIComponent(id)}`, options);
+  }
+  async deleteHtmlTemplate(id) {
+    return this.fetchData("DELETE", `/templates/html/${encodeURIComponent(id)}`);
+  }
+  // ─── PDF Templates ───────────────────────────────────────
+  /**
+   * Upload a PDF form template.
+   * @param file  Raw PDF bytes (Buffer or Uint8Array)
+   * @param options  Name, description, and optional coordinates/isSystem flags
+   */
+  async uploadPdfTemplate(file, options = {}) {
+    const form = new FormData();
+    const filename = options.name ?? "template.pdf";
+    form.append("file", new Blob([file], { type: "application/pdf" }), filename);
+    if (options.name) form.append("name", options.name);
+    if (options.description) form.append("description", options.description);
+    if (options.coordinates) form.append("coordinates", JSON.stringify(options.coordinates));
+    if (options.isSystem !== void 0) form.append("isSystem", String(options.isSystem));
+    return this.fetchMultipartJson("/templates/pdf", form);
+  }
+  async listPdfTemplates(query = {}) {
+    return this.fetchList(`/templates/pdf${this.buildQuery(query)}`);
+  }
+  async getPdfTemplate(id) {
+    return this.fetchData("GET", `/templates/pdf/${encodeURIComponent(id)}`);
+  }
+  async getPdfTemplateFields(id) {
+    return this.fetchData("GET", `/templates/pdf/${encodeURIComponent(id)}/fields`);
+  }
+  async getPdfTemplateDownloadUrl(id) {
+    const data = await this.fetchData("GET", `/templates/pdf/${encodeURIComponent(id)}/download`);
+    return data.url;
+  }
+  /**
+   * Update a PDF template's metadata, and optionally replace the PDF file.
+   * @param file  If provided, replaces the stored PDF and re-extracts form fields
+   */
+  async updatePdfTemplate(id, options, file) {
+    if (file) {
+      const form = new FormData();
+      form.append("file", new Blob([file], { type: "application/pdf" }), "template.pdf");
+      if (options.name) form.append("name", options.name);
+      if (options.description) form.append("description", options.description);
+      if (options.coordinates) form.append("coordinates", JSON.stringify(options.coordinates));
+      return this.putMultipartJson(`/templates/pdf/${encodeURIComponent(id)}`, form);
+    }
+    return this.fetchData("PUT", `/templates/pdf/${encodeURIComponent(id)}`, options);
+  }
+  async deletePdfTemplate(id) {
+    return this.fetchData("DELETE", `/templates/pdf/${encodeURIComponent(id)}`);
+  }
+  // ─── Template Groups ─────────────────────────────────────
+  async createTemplateGroup(options) {
+    return this.fetchData("POST", "/template-groups", options);
+  }
+  async listTemplateGroups(query = {}) {
+    return this.fetchList(`/template-groups${this.buildQuery(query)}`);
+  }
+  async getTemplateGroup(id) {
+    return this.fetchData("GET", `/template-groups/${encodeURIComponent(id)}`);
+  }
+  async updateTemplateGroup(id, options) {
+    return this.fetchData("PUT", `/template-groups/${encodeURIComponent(id)}`, options);
+  }
+  async deleteTemplateGroup(id) {
+    await this.fetchData("DELETE", `/template-groups/${encodeURIComponent(id)}`);
+  }
+  // ─── Document Generation ─────────────────────────────────
+  /**
+   * Generate a document and store it in S3.
+   * Returns a presigned download URL and a public share URL.
+   */
+  async generate(options) {
+    return this.fetchData("POST", "/documents/generate", {
+      templateIds: options.templateIds,
+      templateData: options.data,
+      name: options.name,
+      description: options.description
+    });
+  }
+  /**
+   * Generate a document and stream the PDF buffer directly.
+   * Nothing is stored — useful for previews or on-the-fly delivery.
+   */
+  async generatePassthrough(options) {
+    const headers = await this.authHeaders();
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+    let response;
+    try {
+      response = await fetch(`${this.baseUrl}/documents/generate/passthrough`, {
+        method: "POST",
+        headers: { ...headers, "Content-Type": "application/json" },
+        body: JSON.stringify({
+          templateIds: options.templateIds,
+          templateData: options.data,
+          name: options.name,
+          description: options.description
+        }),
+        signal: controller.signal
+      });
+    } catch (err) {
+      clearTimeout(timer);
+      throw new DocmanError(`Network error: ${err.message}`, 0, "NETWORK_ERROR");
+    } finally {
+      clearTimeout(timer);
+    }
+    if (!response.ok) {
+      const envelope = await response.json();
+      const { code, message } = extractError(envelope);
+      throw new DocmanError(message, response.status, code);
+    }
+    return Buffer.from(await response.arrayBuffer());
+  }
+  async listDocuments(query = {}) {
+    return this.fetchList(`/documents${this.buildQuery(query)}`);
+  }
+  async getDocument(id) {
+    return this.fetchData("GET", `/documents/${encodeURIComponent(id)}`);
+  }
+  /** Get a presigned S3 download URL for a stored document (1-hour TTL). */
+  async downloadUrl(id) {
+    const data = await this.fetchData("GET", `/documents/${encodeURIComponent(id)}/download`);
+    return data.url;
+  }
+  async getVersions(id) {
+    return this.fetchData("GET", `/documents/${encodeURIComponent(id)}/versions`);
+  }
+  /** Re-render a stored document using the original template data. */
+  async regenerate(id) {
+    return this.fetchData("POST", `/documents/${encodeURIComponent(id)}/regenerate`);
+  }
+  // ─── PDF Operations ──────────────────────────────────────
+  /**
+   * Merge two or more PDF buffers into a single PDF.
+   * Returns the merged PDF as a Buffer.
+   */
+  async merge(buffers) {
+    if (buffers.length < 2) {
+      throw new DocmanError("At least 2 PDF buffers are required for merge", 400, "VALIDATION_ERROR");
+    }
+    const form = new FormData();
+    for (const buf of buffers) {
+      form.append("files", new Blob([buf], { type: "application/pdf" }), "file.pdf");
+    }
+    return this.fetchBinary("POST", "/operations/merge", form);
+  }
+  /**
+   * Split a PDF into parts by page ranges.
+   * Returns an array of SplitPart with buffer, range, and size info.
+   */
+  async split(buffer, ranges) {
+    if (ranges.length === 0) {
+      throw new DocmanError("At least 1 page range is required", 400, "VALIDATION_ERROR");
+    }
+    const form = new FormData();
+    form.append("file", new Blob([buffer], { type: "application/pdf" }), "file.pdf");
+    form.append("ranges", JSON.stringify(ranges));
+    const headers = await this.authHeaders();
+    const response = await fetch(`${this.baseUrl}/operations/split`, {
+      method: "POST",
+      headers,
+      body: form
+    });
+    if (!response.ok) {
+      const envelope = await response.json();
+      const { code, message } = extractError(envelope);
+      throw new DocmanError(message, response.status, code);
+    }
+    const contentType = response.headers.get("content-type") ?? "";
+    if (contentType.includes("application/json")) {
+      const json = await response.json();
+      return json.data.map((part) => ({
+        index: part.index,
+        range: part.range,
+        buffer: Buffer.from(part.base64, "base64"),
+        sizeBytes: part.sizeBytes
+      }));
+    }
+    const buf = Buffer.from(await response.arrayBuffer());
+    return [{ index: 0, range: ranges[0], buffer: buf, sizeBytes: buf.length }];
+  }
+  /** Get the page count of a PDF buffer. */
+  async pageCount(buffer) {
+    const form = new FormData();
+    form.append("file", new Blob([buffer], { type: "application/pdf" }), "file.pdf");
+    const headers = await this.authHeaders();
+    const response = await fetch(`${this.baseUrl}/operations/page-count`, {
+      method: "POST",
+      headers,
+      body: form
+    });
+    if (!response.ok) {
+      const envelope = await response.json();
+      const { code, message } = extractError(envelope);
+      throw new DocmanError(message, response.status, code);
+    }
+    const json = await response.json();
+    return json.data.pages;
+  }
+};
+export {
+  DocmanClient,
+  DocmanError
+};
+//# sourceMappingURL=index.js.map