@papierapi/sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./client.js";
+export * from "./errors.js";
+export * from "./operations.js";

package/dist/index.js

@@ -0,0 +1,343 @@
+import {
+  ApiErrorSchema,
+  DirectPaymentIdSchema,
+  DispatchIdSchema,
+  DraftIdSchema,
+  IdempotencyKeySchema,
+  papierApiOperations
+} from "./chunk-JDUUPLUG.js";
+
+// src/errors.ts
+var PapierApiError = class extends Error {
+  status;
+  requestId;
+  code;
+  retryable;
+  suggestedAction;
+  fieldPath;
+  constructor(status, response) {
+    super(response.error.message);
+    this.name = "PapierApiError";
+    this.status = status;
+    this.requestId = response.request_id;
+    this.code = response.error.code;
+    this.retryable = response.error.retryable;
+    this.suggestedAction = response.error.suggested_action;
+    this.fieldPath = response.error.field_path;
+  }
+};
+var PapierApiContractError = class extends Error {
+  operationId;
+  status;
+  constructor(message, operationId, status) {
+    super(message);
+    this.name = "PapierApiContractError";
+    this.operationId = operationId;
+    this.status = status;
+  }
+};
+var PapierApiTransportError = class extends Error {
+  reason;
+  retryable = true;
+  constructor(reason) {
+    super(reason === "timeout" ? "Papier API request timed out" : "Papier API is unreachable");
+    this.name = "PapierApiTransportError";
+    this.reason = reason;
+  }
+};
+
+// src/client.ts
+var DEFAULT_TIMEOUT_MS = 3e4;
+var DEFAULT_MAX_RESPONSE_BYTES = 2 * 1024 * 1024;
+var MAX_PDF_BYTES = 20 * 1024 * 1024;
+function boundedInteger(value, fallback, min, max) {
+  const resolved = value ?? fallback;
+  if (!Number.isInteger(resolved) || resolved < min || resolved > max) {
+    throw new TypeError(`Expected an integer between ${min} and ${max}`);
+  }
+  return resolved;
+}
+function normalizeBaseUrl(value) {
+  let parsed;
+  try {
+    parsed = new URL(value);
+  } catch {
+    throw new TypeError("baseUrl must be an absolute URL");
+  }
+  const local = parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1";
+  if (parsed.protocol !== "https:" && !(local && parsed.protocol === "http:")) {
+    throw new TypeError("baseUrl must use HTTPS except for localhost");
+  }
+  if (parsed.username !== "" || parsed.password !== "" || parsed.search !== "" || parsed.hash !== "" || parsed.pathname !== "" && parsed.pathname !== "/") {
+    throw new TypeError("baseUrl must contain only an origin");
+  }
+  return parsed.origin;
+}
+function validateToken(token) {
+  const hasControlOrWhitespace = Array.from(token).some((character) => {
+    const code = character.charCodeAt(0);
+    return code <= 32 || code === 127;
+  });
+  if (token.length < 8 || token.length > 8192 || hasControlOrWhitespace) {
+    throw new TypeError("accessToken is invalid");
+  }
+  return token;
+}
+function pdfBody(document) {
+  const size = document instanceof Blob ? document.size : document.byteLength;
+  if (size < 1 || size > MAX_PDF_BYTES) {
+    throw new TypeError(`PDF must contain between 1 and ${MAX_PDF_BYTES} bytes`);
+  }
+  if (document instanceof Blob) return document;
+  if (document instanceof Uint8Array) {
+    const copy = new Uint8Array(document.byteLength);
+    copy.set(document);
+    return new Blob([copy.buffer], { type: "application/pdf" });
+  }
+  return new Blob([document], { type: "application/pdf" });
+}
+async function boundedResponseText(response, maxBytes, operationId) {
+  const contentLength = response.headers.get("Content-Length");
+  if (contentLength !== null) {
+    const parsed = Number(contentLength);
+    if (Number.isFinite(parsed) && parsed > maxBytes) {
+      throw new PapierApiContractError(
+        "Papier API response exceeded the configured size limit",
+        operationId,
+        response.status
+      );
+    }
+  }
+  if (response.body === null) return "";
+  const reader = response.body.getReader();
+  const decoder = new TextDecoder();
+  let bytesRead = 0;
+  let text = "";
+  while (true) {
+    const chunk = await reader.read();
+    if (chunk.done) break;
+    bytesRead += chunk.value.byteLength;
+    if (bytesRead > maxBytes) {
+      await reader.cancel().catch(() => void 0);
+      throw new PapierApiContractError(
+        "Papier API response exceeded the configured size limit",
+        operationId,
+        response.status
+      );
+    }
+    text += decoder.decode(chunk.value, { stream: true });
+  }
+  return text + decoder.decode();
+}
+function parseJson(text, operationId, status) {
+  try {
+    return JSON.parse(text);
+  } catch {
+    throw new PapierApiContractError("Papier API returned invalid JSON", operationId, status);
+  }
+}
+var PapierApiClient = class {
+  baseUrl;
+  accessToken;
+  fetcher;
+  timeoutMs;
+  maxResponseBytes;
+  constructor(options) {
+    this.baseUrl = normalizeBaseUrl(options.baseUrl);
+    this.accessToken = options.accessToken;
+    const fetcher = options.fetcher ?? globalThis.fetch;
+    if (typeof fetcher !== "function") throw new TypeError("A fetch implementation is required");
+    this.fetcher = fetcher.bind(globalThis);
+    this.timeoutMs = boundedInteger(options.timeoutMs, DEFAULT_TIMEOUT_MS, 1, 12e4);
+    this.maxResponseBytes = boundedInteger(
+      options.maxResponseBytes,
+      DEFAULT_MAX_RESPONSE_BYTES,
+      256,
+      10 * 1024 * 1024
+    );
+  }
+  async token() {
+    const value = typeof this.accessToken === "function" ? await this.accessToken() : this.accessToken;
+    return validateToken(value);
+  }
+  async execute(name, options = {}) {
+    const operation = papierApiOperations[name];
+    let path = operation.path;
+    for (const [parameterName, parameterSchema] of Object.entries(operation.pathParameters)) {
+      const parsed2 = parameterSchema.parse(options.pathParameters?.[parameterName]);
+      path = path.replace(`{${parameterName}}`, encodeURIComponent(String(parsed2)));
+    }
+    if (path.includes("{")) {
+      throw new PapierApiContractError(
+        "REST operation has an unresolved path",
+        operation.operationId
+      );
+    }
+    const url = new URL(`${this.baseUrl}${path}`);
+    for (const [parameterName, parameterSchema] of Object.entries(operation.queryParameters)) {
+      const parsed2 = parameterSchema.parse(options.queryParameters?.[parameterName]);
+      if (parsed2 !== void 0) url.searchParams.set(parameterName, String(parsed2));
+    }
+    const headers = new Headers({
+      Accept: "application/json",
+      Authorization: `Bearer ${await this.token()}`
+    });
+    let body;
+    if (operation.request.kind === "json") {
+      headers.set("Content-Type", "application/json");
+      body = JSON.stringify(operation.request.schema.parse(options.json));
+    } else if (operation.request.kind === "pdf") {
+      headers.set("Content-Type", "application/pdf");
+      if (options.pdf === void 0) throw new TypeError("A PDF document is required");
+      body = pdfBody(options.pdf);
+    }
+    if (operation.requiresIdempotencyKey) {
+      headers.set("Idempotency-Key", IdempotencyKeySchema.parse(options.idempotencyKey));
+    }
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+    let response;
+    try {
+      const requestInit = {
+        method: operation.method,
+        headers,
+        signal: controller.signal,
+        ...body === void 0 ? {} : { body }
+      };
+      response = await this.fetcher(url, requestInit);
+    } catch {
+      throw new PapierApiTransportError(controller.signal.aborted ? "timeout" : "network");
+    } finally {
+      clearTimeout(timeout);
+    }
+    const parsed = parseJson(
+      await boundedResponseText(response, this.maxResponseBytes, operation.operationId),
+      operation.operationId,
+      response.status
+    );
+    if (!response.ok) {
+      const apiError = ApiErrorSchema.safeParse(parsed);
+      if (!apiError.success) {
+        throw new PapierApiContractError(
+          "Papier API returned a malformed error response",
+          operation.operationId,
+          response.status
+        );
+      }
+      throw new PapierApiError(response.status, apiError.data);
+    }
+    const validated = operation.responseSchema.safeParse(parsed);
+    if (!validated.success) {
+      throw new PapierApiContractError(
+        "Papier API response did not match the published contract",
+        operation.operationId,
+        response.status
+      );
+    }
+    return validated.data;
+  }
+  uploadDocument(document) {
+    return this.execute("uploadDocument", { pdf: document });
+  }
+  createLetterDraft(input) {
+    return this.execute("createLetterDraft", { json: input });
+  }
+  createFaxDraft(input) {
+    return this.execute("createFaxDraft", { json: input });
+  }
+  getDraft(draftId) {
+    return this.execute("getDraft", { pathParameters: { draftId: DraftIdSchema.parse(draftId) } });
+  }
+  quoteDraft(draftId) {
+    return this.execute("quoteDraft", {
+      pathParameters: { draftId: DraftIdSchema.parse(draftId) }
+    });
+  }
+  requestApproval(draftId, input) {
+    return this.execute("requestApproval", {
+      pathParameters: { draftId: DraftIdSchema.parse(draftId) },
+      json: input
+    });
+  }
+  /** Wallet-only dispatch after a human approval. Reuse the key only for an identical retry. */
+  createDispatch(draftId, input, idempotencyKey) {
+    return this.execute("createDispatch", {
+      pathParameters: { draftId: DraftIdSchema.parse(draftId) },
+      json: input,
+      idempotencyKey
+    });
+  }
+  /** Creates a user-controlled Checkout after human approval; opening it does not dispatch. */
+  createDirectPaymentSession(draftId, input, idempotencyKey) {
+    return this.execute("createDirectPaymentSession", {
+      pathParameters: { draftId: DraftIdSchema.parse(draftId) },
+      json: input,
+      idempotencyKey
+    });
+  }
+  /** Tracks server-confirmed payment and the resulting dispatch; checkout_open is not paid. */
+  getDirectPayment(directPaymentId) {
+    return this.execute("getDirectPayment", {
+      pathParameters: {
+        directPaymentId: DirectPaymentIdSchema.parse(directPaymentId)
+      }
+    });
+  }
+  listDispatches(limit = 25) {
+    return this.execute("listDispatches", { queryParameters: { limit } });
+  }
+  getDispatch(dispatchId) {
+    return this.execute("getDispatch", {
+      pathParameters: { dispatchId: DispatchIdSchema.parse(dispatchId) }
+    });
+  }
+  getDispatchSummary(dispatchId) {
+    return this.execute("getDispatchSummary", {
+      pathParameters: { dispatchId: DispatchIdSchema.parse(dispatchId) }
+    });
+  }
+  getDispatchEvents(dispatchId) {
+    return this.execute("getDispatchEvents", {
+      pathParameters: { dispatchId: DispatchIdSchema.parse(dispatchId) }
+    });
+  }
+  getDispatchProof(dispatchId) {
+    return this.execute("getDispatchProof", {
+      pathParameters: { dispatchId: DispatchIdSchema.parse(dispatchId) }
+    });
+  }
+  cancelDispatch(dispatchId) {
+    return this.execute("cancelDispatch", {
+      pathParameters: { dispatchId: DispatchIdSchema.parse(dispatchId) }
+    });
+  }
+  getWallet() {
+    return this.execute("getWallet");
+  }
+  async prepareLetterForReview(input, approvalExpiresInSeconds = 3600) {
+    const draft = await this.createLetterDraft(input);
+    const quote = await this.quoteDraft(draft.data.id);
+    const approval = await this.requestApproval(draft.data.id, {
+      quote_id: quote.data.id,
+      expires_in_seconds: approvalExpiresInSeconds
+    });
+    return { draft: draft.data, quote: quote.data, approval: approval.data };
+  }
+  async prepareFaxForReview(input, approvalExpiresInSeconds = 3600) {
+    const draft = await this.createFaxDraft(input);
+    const quote = await this.quoteDraft(draft.data.id);
+    const approval = await this.requestApproval(draft.data.id, {
+      quote_id: quote.data.id,
+      expires_in_seconds: approvalExpiresInSeconds
+    });
+    return { draft: draft.data, quote: quote.data, approval: approval.data };
+  }
+};
+export {
+  PapierApiClient,
+  PapierApiContractError,
+  PapierApiError,
+  PapierApiTransportError,
+  papierApiOperations
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/errors.ts", "../src/client.ts"],
+  "sourcesContent": ["import type { ApiError, ErrorCode } from \"@papierapi/contracts\";\n\nexport class PapierApiError extends Error {\n  readonly status: number;\n  readonly requestId: string;\n  readonly code: ErrorCode;\n  readonly retryable: boolean;\n  readonly suggestedAction: string;\n  readonly fieldPath: string | undefined;\n\n  constructor(status: number, response: ApiError) {\n    super(response.error.message);\n    this.name = \"PapierApiError\";\n    this.status = status;\n    this.requestId = response.request_id;\n    this.code = response.error.code;\n    this.retryable = response.error.retryable;\n    this.suggestedAction = response.error.suggested_action;\n    this.fieldPath = response.error.field_path;\n  }\n}\n\nexport class PapierApiContractError extends Error {\n  readonly operationId: string;\n  readonly status: number | undefined;\n\n  constructor(message: string, operationId: string, status?: number) {\n    super(message);\n    this.name = \"PapierApiContractError\";\n    this.operationId = operationId;\n    this.status = status;\n  }\n}\n\nexport class PapierApiTransportError extends Error {\n  readonly reason: \"network\" | \"timeout\";\n  readonly retryable = true;\n\n  constructor(reason: \"network\" | \"timeout\") {\n    super(reason === \"timeout\" ? \"Papier API request timed out\" : \"Papier API is unreachable\");\n    this.name = \"PapierApiTransportError\";\n    this.reason = reason;\n  }\n}\n", "import {\n  ApiErrorSchema,\n  type ApprovalRequestSchema,\n  type CreateApprovalRequestSchema,\n  type CreateDirectPaymentSessionSchema,\n  type CreateDispatchSchema,\n  type CreateFaxDraftSchema,\n  type CreateLetterDraftSchema,\n  DirectPaymentIdSchema,\n  DispatchIdSchema,\n  type DispatchSchema,\n  DraftIdSchema,\n  type DraftSchema,\n  IdempotencyKeySchema,\n  type QuoteSchema,\n} from \"@papierapi/contracts\";\nimport type { z } from \"zod\";\nimport { PapierApiContractError, PapierApiError, PapierApiTransportError } from \"./errors\";\nimport {\n  type PapierApiOperationName,\n  type PapierApiOperationResponse,\n  papierApiOperations,\n} from \"./operations\";\n\nconst DEFAULT_TIMEOUT_MS = 30_000;\nconst DEFAULT_MAX_RESPONSE_BYTES = 2 * 1024 * 1024;\nconst MAX_PDF_BYTES = 20 * 1024 * 1024;\n\ntype MaybePromise<T> = T | Promise<T>;\n\nexport type PapierApiAccessToken = string | (() => MaybePromise<string>);\nexport type PapierApiFetch = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;\nexport type PdfDocument = Blob | ArrayBuffer | Uint8Array;\n\nexport type CreateLetterDraftInput = z.input<typeof CreateLetterDraftSchema>;\nexport type CreateFaxDraftInput = z.input<typeof CreateFaxDraftSchema>;\nexport type CreateApprovalRequestInput = z.input<typeof CreateApprovalRequestSchema>;\nexport type CreateDispatchInput = z.input<typeof CreateDispatchSchema>;\nexport type CreateDirectPaymentSessionInput = z.input<typeof CreateDirectPaymentSessionSchema>;\n\nexport type ReviewPackage = {\n  draft: z.infer<typeof DraftSchema>;\n  quote: z.infer<typeof QuoteSchema>;\n  approval: z.infer<typeof ApprovalRequestSchema>;\n};\n\nexport type DispatchResult = z.infer<typeof DispatchSchema>;\n\nexport type PapierApiClientOptions = {\n  baseUrl: string;\n  accessToken: PapierApiAccessToken;\n  fetcher?: PapierApiFetch;\n  timeoutMs?: number;\n  maxResponseBytes?: number;\n};\n\ntype ExecuteOptions = {\n  pathParameters?: Record<string, unknown>;\n  queryParameters?: Record<string, unknown>;\n  json?: unknown;\n  pdf?: PdfDocument;\n  idempotencyKey?: string;\n};\n\nfunction boundedInteger(value: number | undefined, fallback: number, min: number, max: number) {\n  const resolved = value ?? fallback;\n  if (!Number.isInteger(resolved) || resolved < min || resolved > max) {\n    throw new TypeError(`Expected an integer between ${min} and ${max}`);\n  }\n  return resolved;\n}\n\nfunction normalizeBaseUrl(value: string): string {\n  let parsed: URL;\n  try {\n    parsed = new URL(value);\n  } catch {\n    throw new TypeError(\"baseUrl must be an absolute URL\");\n  }\n\n  const local = parsed.hostname === \"localhost\" || parsed.hostname === \"127.0.0.1\";\n  if (parsed.protocol !== \"https:\" && !(local && parsed.protocol === \"http:\")) {\n    throw new TypeError(\"baseUrl must use HTTPS except for localhost\");\n  }\n  if (\n    parsed.username !== \"\" ||\n    parsed.password !== \"\" ||\n    parsed.search !== \"\" ||\n    parsed.hash !== \"\" ||\n    (parsed.pathname !== \"\" && parsed.pathname !== \"/\")\n  ) {\n    throw new TypeError(\"baseUrl must contain only an origin\");\n  }\n  return parsed.origin;\n}\n\nfunction validateToken(token: string): string {\n  const hasControlOrWhitespace = Array.from(token).some((character) => {\n    const code = character.charCodeAt(0);\n    return code <= 32 || code === 127;\n  });\n  if (token.length < 8 || token.length > 8_192 || hasControlOrWhitespace) {\n    throw new TypeError(\"accessToken is invalid\");\n  }\n  return token;\n}\n\nfunction pdfBody(document: PdfDocument): Blob {\n  const size = document instanceof Blob ? document.size : document.byteLength;\n  if (size < 1 || size > MAX_PDF_BYTES) {\n    throw new TypeError(`PDF must contain between 1 and ${MAX_PDF_BYTES} bytes`);\n  }\n  if (document instanceof Blob) return document;\n  if (document instanceof Uint8Array) {\n    const copy = new Uint8Array(document.byteLength);\n    copy.set(document);\n    return new Blob([copy.buffer], { type: \"application/pdf\" });\n  }\n  return new Blob([document], { type: \"application/pdf\" });\n}\n\nasync function boundedResponseText(\n  response: Response,\n  maxBytes: number,\n  operationId: string,\n): Promise<string> {\n  const contentLength = response.headers.get(\"Content-Length\");\n  if (contentLength !== null) {\n    const parsed = Number(contentLength);\n    if (Number.isFinite(parsed) && parsed > maxBytes) {\n      throw new PapierApiContractError(\n        \"Papier API response exceeded the configured size limit\",\n        operationId,\n        response.status,\n      );\n    }\n  }\n\n  if (response.body === null) return \"\";\n  const reader = response.body.getReader();\n  const decoder = new TextDecoder();\n  let bytesRead = 0;\n  let text = \"\";\n\n  while (true) {\n    const chunk = await reader.read();\n    if (chunk.done) break;\n    bytesRead += chunk.value.byteLength;\n    if (bytesRead > maxBytes) {\n      await reader.cancel().catch(() => undefined);\n      throw new PapierApiContractError(\n        \"Papier API response exceeded the configured size limit\",\n        operationId,\n        response.status,\n      );\n    }\n    text += decoder.decode(chunk.value, { stream: true });\n  }\n  return text + decoder.decode();\n}\n\nfunction parseJson(text: string, operationId: string, status: number): unknown {\n  try {\n    return JSON.parse(text);\n  } catch {\n    throw new PapierApiContractError(\"Papier API returned invalid JSON\", operationId, status);\n  }\n}\n\nexport class PapierApiClient {\n  readonly baseUrl: string;\n  private readonly accessToken: PapierApiAccessToken;\n  private readonly fetcher: PapierApiFetch;\n  private readonly timeoutMs: number;\n  private readonly maxResponseBytes: number;\n\n  constructor(options: PapierApiClientOptions) {\n    this.baseUrl = normalizeBaseUrl(options.baseUrl);\n    this.accessToken = options.accessToken;\n    const fetcher = options.fetcher ?? globalThis.fetch;\n    if (typeof fetcher !== \"function\") throw new TypeError(\"A fetch implementation is required\");\n    this.fetcher = fetcher.bind(globalThis);\n    this.timeoutMs = boundedInteger(options.timeoutMs, DEFAULT_TIMEOUT_MS, 1, 120_000);\n    this.maxResponseBytes = boundedInteger(\n      options.maxResponseBytes,\n      DEFAULT_MAX_RESPONSE_BYTES,\n      256,\n      10 * 1024 * 1024,\n    );\n  }\n\n  private async token(): Promise<string> {\n    const value =\n      typeof this.accessToken === \"function\" ? await this.accessToken() : this.accessToken;\n    return validateToken(value);\n  }\n\n  private async execute<Name extends PapierApiOperationName>(\n    name: Name,\n    options: ExecuteOptions = {},\n  ): Promise<PapierApiOperationResponse<Name>> {\n    const operation = papierApiOperations[name];\n    let path: string = operation.path;\n    for (const [parameterName, parameterSchema] of Object.entries(operation.pathParameters)) {\n      const parsed = parameterSchema.parse(options.pathParameters?.[parameterName]);\n      path = path.replace(`{${parameterName}}`, encodeURIComponent(String(parsed)));\n    }\n    if (path.includes(\"{\")) {\n      throw new PapierApiContractError(\n        \"REST operation has an unresolved path\",\n        operation.operationId,\n      );\n    }\n\n    const url = new URL(`${this.baseUrl}${path}`);\n    for (const [parameterName, parameterSchema] of Object.entries(operation.queryParameters)) {\n      const parsed = parameterSchema.parse(options.queryParameters?.[parameterName]);\n      if (parsed !== undefined) url.searchParams.set(parameterName, String(parsed));\n    }\n\n    const headers = new Headers({\n      Accept: \"application/json\",\n      Authorization: `Bearer ${await this.token()}`,\n    });\n    let body: BodyInit | undefined;\n    if (operation.request.kind === \"json\") {\n      headers.set(\"Content-Type\", \"application/json\");\n      body = JSON.stringify(operation.request.schema.parse(options.json));\n    } else if (operation.request.kind === \"pdf\") {\n      headers.set(\"Content-Type\", \"application/pdf\");\n      if (options.pdf === undefined) throw new TypeError(\"A PDF document is required\");\n      body = pdfBody(options.pdf);\n    }\n\n    if (operation.requiresIdempotencyKey) {\n      headers.set(\"Idempotency-Key\", IdempotencyKeySchema.parse(options.idempotencyKey));\n    }\n\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);\n    let response: Response;\n    try {\n      const requestInit: RequestInit = {\n        method: operation.method,\n        headers,\n        signal: controller.signal,\n        ...(body === undefined ? {} : { body }),\n      };\n      response = await this.fetcher(url, requestInit);\n    } catch {\n      throw new PapierApiTransportError(controller.signal.aborted ? \"timeout\" : \"network\");\n    } finally {\n      clearTimeout(timeout);\n    }\n\n    const parsed = parseJson(\n      await boundedResponseText(response, this.maxResponseBytes, operation.operationId),\n      operation.operationId,\n      response.status,\n    );\n    if (!response.ok) {\n      const apiError = ApiErrorSchema.safeParse(parsed);\n      if (!apiError.success) {\n        throw new PapierApiContractError(\n          \"Papier API returned a malformed error response\",\n          operation.operationId,\n          response.status,\n        );\n      }\n      throw new PapierApiError(response.status, apiError.data);\n    }\n\n    const validated = operation.responseSchema.safeParse(parsed);\n    if (!validated.success) {\n      throw new PapierApiContractError(\n        \"Papier API response did not match the published contract\",\n        operation.operationId,\n        response.status,\n      );\n    }\n    return validated.data as PapierApiOperationResponse<Name>;\n  }\n\n  uploadDocument(document: PdfDocument) {\n    return this.execute(\"uploadDocument\", { pdf: document });\n  }\n\n  createLetterDraft(input: CreateLetterDraftInput) {\n    return this.execute(\"createLetterDraft\", { json: input });\n  }\n\n  createFaxDraft(input: CreateFaxDraftInput) {\n    return this.execute(\"createFaxDraft\", { json: input });\n  }\n\n  getDraft(draftId: string) {\n    return this.execute(\"getDraft\", { pathParameters: { draftId: DraftIdSchema.parse(draftId) } });\n  }\n\n  quoteDraft(draftId: string) {\n    return this.execute(\"quoteDraft\", {\n      pathParameters: { draftId: DraftIdSchema.parse(draftId) },\n    });\n  }\n\n  requestApproval(draftId: string, input: CreateApprovalRequestInput) {\n    return this.execute(\"requestApproval\", {\n      pathParameters: { draftId: DraftIdSchema.parse(draftId) },\n      json: input,\n    });\n  }\n\n  /** Wallet-only dispatch after a human approval. Reuse the key only for an identical retry. */\n  createDispatch(draftId: string, input: CreateDispatchInput, idempotencyKey: string) {\n    return this.execute(\"createDispatch\", {\n      pathParameters: { draftId: DraftIdSchema.parse(draftId) },\n      json: input,\n      idempotencyKey,\n    });\n  }\n\n  /** Creates a user-controlled Checkout after human approval; opening it does not dispatch. */\n  createDirectPaymentSession(\n    draftId: string,\n    input: CreateDirectPaymentSessionInput,\n    idempotencyKey: string,\n  ) {\n    return this.execute(\"createDirectPaymentSession\", {\n      pathParameters: { draftId: DraftIdSchema.parse(draftId) },\n      json: input,\n      idempotencyKey,\n    });\n  }\n\n  /** Tracks server-confirmed payment and the resulting dispatch; checkout_open is not paid. */\n  getDirectPayment(directPaymentId: string) {\n    return this.execute(\"getDirectPayment\", {\n      pathParameters: {\n        directPaymentId: DirectPaymentIdSchema.parse(directPaymentId),\n      },\n    });\n  }\n\n  listDispatches(limit = 25) {\n    return this.execute(\"listDispatches\", { queryParameters: { limit } });\n  }\n\n  getDispatch(dispatchId: string) {\n    return this.execute(\"getDispatch\", {\n      pathParameters: { dispatchId: DispatchIdSchema.parse(dispatchId) },\n    });\n  }\n\n  getDispatchSummary(dispatchId: string) {\n    return this.execute(\"getDispatchSummary\", {\n      pathParameters: { dispatchId: DispatchIdSchema.parse(dispatchId) },\n    });\n  }\n\n  getDispatchEvents(dispatchId: string) {\n    return this.execute(\"getDispatchEvents\", {\n      pathParameters: { dispatchId: DispatchIdSchema.parse(dispatchId) },\n    });\n  }\n\n  getDispatchProof(dispatchId: string) {\n    return this.execute(\"getDispatchProof\", {\n      pathParameters: { dispatchId: DispatchIdSchema.parse(dispatchId) },\n    });\n  }\n\n  cancelDispatch(dispatchId: string) {\n    return this.execute(\"cancelDispatch\", {\n      pathParameters: { dispatchId: DispatchIdSchema.parse(dispatchId) },\n    });\n  }\n\n  getWallet() {\n    return this.execute(\"getWallet\");\n  }\n\n  async prepareLetterForReview(\n    input: CreateLetterDraftInput,\n    approvalExpiresInSeconds = 3_600,\n  ): Promise<ReviewPackage> {\n    const draft = await this.createLetterDraft(input);\n    const quote = await this.quoteDraft(draft.data.id);\n    const approval = await this.requestApproval(draft.data.id, {\n      quote_id: quote.data.id,\n      expires_in_seconds: approvalExpiresInSeconds,\n    });\n    return { draft: draft.data, quote: quote.data, approval: approval.data };\n  }\n\n  async prepareFaxForReview(\n    input: CreateFaxDraftInput,\n    approvalExpiresInSeconds = 3_600,\n  ): Promise<ReviewPackage> {\n    const draft = await this.createFaxDraft(input);\n    const quote = await this.quoteDraft(draft.data.id);\n    const approval = await this.requestApproval(draft.data.id, {\n      quote_id: quote.data.id,\n      expires_in_seconds: approvalExpiresInSeconds,\n    });\n    return { draft: draft.data, quote: quote.data, approval: approval.data };\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["parsed"]
+}

package/dist/internal/contracts/common.d.ts

@@ -0,0 +1,108 @@
+import { z } from "zod";
+export declare const CurrencySchema: z.ZodLiteral<"EUR">;
+export type Currency = z.infer<typeof CurrencySchema>;
+export declare const IsoDateSchema: z.ZodISODate;
+export declare const IsoDateTimeSchema: z.ZodISODateTime;
+export declare const IdempotencyKeySchema: z.ZodString;
+export declare function prefixedId(prefix: string): z.ZodString;
+export declare const OrganizationIdSchema: z.ZodString;
+export declare const WorkspaceIdSchema: z.ZodString;
+export declare const SenderProfileIdSchema: z.ZodString;
+export declare const DocumentIdSchema: z.ZodString;
+export declare const DraftIdSchema: z.ZodString;
+export declare const VerificationRunIdSchema: z.ZodString;
+export declare const QuoteIdSchema: z.ZodString;
+export declare const ApprovalRequestIdSchema: z.ZodString;
+export declare const ApprovalIdSchema: z.ZodString;
+export declare const DirectPaymentIdSchema: z.ZodString;
+export declare const DispatchIdSchema: z.ZodString;
+export declare const EventIdSchema: z.ZodString;
+export declare const WebhookEndpointIdSchema: z.ZodString;
+export declare const RequestIdSchema: z.ZodString;
+export declare const MoneySchema: z.ZodObject<{
+    amount_cents: z.ZodInt;
+    currency: z.ZodLiteral<"EUR">;
+}, z.core.$strict>;
+export type Money = z.infer<typeof MoneySchema>;
+export declare const MetadataSchema: z.ZodRecord<z.ZodString, z.ZodString>;
+export declare const NextActionSchema: z.ZodObject<{
+    action: z.ZodString;
+    method: z.ZodOptional<z.ZodEnum<{
+        GET: "GET";
+        POST: "POST";
+        PATCH: "PATCH";
+        DELETE: "DELETE";
+    }>>;
+    href: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type NextAction = z.infer<typeof NextActionSchema>;
+export declare const PaginationQuerySchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>;
+export declare const PaginatedMetaSchema: z.ZodObject<{
+    next_cursor: z.ZodNullable<z.ZodString>;
+    has_more: z.ZodBoolean;
+}, z.core.$strict>;
+export declare const Sha256Schema: z.ZodString;
+export declare const VerificationViolationSchema: z.ZodObject<{
+    code: z.ZodString;
+    field_path: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodInt>;
+    rule: z.ZodString;
+    message: z.ZodString;
+    suggested_action: z.ZodString;
+}, z.core.$strict>;
+export type VerificationViolation = z.infer<typeof VerificationViolationSchema>;
+export declare const VerificationCheckSchema: z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodString;
+    status: z.ZodEnum<{
+        passed: "passed";
+        warning: "warning";
+        failed: "failed";
+        skipped: "skipped";
+    }>;
+    rule: z.ZodString;
+    evidence: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    violations: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        field_path: z.ZodOptional<z.ZodString>;
+        page: z.ZodOptional<z.ZodInt>;
+        rule: z.ZodString;
+        message: z.ZodString;
+        suggested_action: z.ZodString;
+    }, z.core.$strict>>;
+    duration_ms: z.ZodInt;
+}, z.core.$strict>;
+export type VerificationCheck = z.infer<typeof VerificationCheckSchema>;
+export declare const VerificationSummarySchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        passed: "passed";
+        warning: "warning";
+        failed: "failed";
+    }>;
+    checks: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodString;
+        status: z.ZodEnum<{
+            passed: "passed";
+            warning: "warning";
+            failed: "failed";
+            skipped: "skipped";
+        }>;
+        rule: z.ZodString;
+        evidence: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        violations: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            field_path: z.ZodOptional<z.ZodString>;
+            page: z.ZodOptional<z.ZodInt>;
+            rule: z.ZodString;
+            message: z.ZodString;
+            suggested_action: z.ZodString;
+        }, z.core.$strict>>;
+        duration_ms: z.ZodInt;
+    }, z.core.$strict>>;
+    verifier_version: z.ZodString;
+}, z.core.$strict>;
+export type VerificationSummary = z.infer<typeof VerificationSummarySchema>;