@insureco/docman 1.0.0 → 1.0.1

package/dist/chunk-DBVEE4WX.js

@@ -0,0 +1,457 @@
+import {
+  DocmanError
+} from "./chunk-7DJVMOS3.js";
+
+// src/client.ts
+function toUint8(b) {
+  return b;
+}
+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([toUint8(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([toUint8(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([toUint8(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([toUint8(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 }];
+  }
+  /**
+   * Batch-introspect PDF form fields for multiple templates.
+   * Returns a map of templateId → field list.
+   */
+  async introspectFields(templateIds) {
+    return this.fetchData(
+      "POST",
+      "/templates/pdf/fields",
+      { templateIds }
+    );
+  }
+  /** Get the page count of a PDF buffer. */
+  async pageCount(buffer) {
+    const form = new FormData();
+    form.append("file", new Blob([toUint8(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
+};
+//# sourceMappingURL=chunk-DBVEE4WX.js.map

package/dist/chunk-DBVEE4WX.js.map

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

package/dist/client-CdjgCtrw.d.cts

@@ -0,0 +1,100 @@
+import { D as DocmanClientConfig, C as CreateHtmlTemplateOptions, H as HtmlTemplate, f as HtmlTemplateListQuery, h as ListResult, U as UpdateHtmlTemplateOptions, a as CreatePdfTemplateOptions, j as PdfTemplate, k as PdfTemplateListQuery, i as PdfField, o as UpdatePdfTemplateOptions, b as CreateTemplateGroupOptions, m as TemplateGroup, g as ListQuery, p as UpdateTemplateGroupOptions, G as GenerateOptions, e as GenerateResult, c as DocmanDocument, d as DocumentVersion, P as PageRange, l as SplitPart } from './types-DvQ8gX3k.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[]>;
+    /**
+     * Batch-introspect PDF form fields for multiple templates.
+     * Returns a map of templateId → field list.
+     */
+    introspectFields(templateIds: readonly string[]): Promise<Record<string, readonly PdfField[]>>;
+    /** Get the page count of a PDF buffer. */
+    pageCount(buffer: Buffer | Uint8Array): Promise<number>;
+}
+
+export { DocmanClient as D };