@pageweaver/sdk 0.1.0

package/dist/http.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpClient = void 0;
+const errors_1 = require("./errors");
+const DEFAULT_BASE_URL = "https://api.pageweaver.io";
+const DEFAULT_TIMEOUT_MS = 30_000;
+/**
+ * Thin fetch wrapper: attaches the API key, serializes JSON, applies a timeout, and maps
+ * non-2xx responses to {@link PageWeaverApiError} and transport failures to
+ * {@link PageWeaverConnectionError}. Every resource is built on this.
+ */
+class HttpClient {
+    apiKey;
+    baseUrl;
+    timeoutMs;
+    fetchImpl;
+    constructor(opts) {
+        if (!opts.apiKey)
+            throw new errors_1.PageWeaverConnectionError("An `apiKey` is required.");
+        this.apiKey = opts.apiKey;
+        this.baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+        this.timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        const globalFetch = globalThis.fetch;
+        const resolved = opts.fetch ?? globalFetch;
+        if (!resolved) {
+            throw new errors_1.PageWeaverConnectionError("No global `fetch` is available. Use Node 18+ or pass a `fetch` implementation.");
+        }
+        this.fetchImpl = resolved;
+    }
+    /** Perform a request and parse a JSON response into `T`. */
+    async json(method, path, init = {}) {
+        const res = await this.send(method, path, init);
+        if (res.status === 204)
+            return undefined;
+        const text = await res.text();
+        return (text ? JSON.parse(text) : undefined);
+    }
+    /** Perform a request and return the raw response body as bytes (for PDF downloads). */
+    async bytes(method, path, init = {}) {
+        const res = await this.send(method, path, init);
+        const buf = await res.arrayBuffer();
+        return new Uint8Array(buf);
+    }
+    /** Fetch an absolute URL (e.g. a signed download URL) and return its bytes. */
+    async fetchUrlBytes(url, signal) {
+        const { controller, done } = this.withTimeout(signal);
+        try {
+            const res = await this.fetchImpl(url, { method: "GET", signal: controller.signal });
+            if (!res.ok) {
+                throw new errors_1.PageWeaverApiError({
+                    status: res.status,
+                    message: `Failed to download from ${url}: ${res.status}`,
+                    body: await safeText(res),
+                });
+            }
+            return new Uint8Array(await res.arrayBuffer());
+        }
+        catch (err) {
+            throw this.wrapTransport(err);
+        }
+        finally {
+            done();
+        }
+    }
+    async send(method, path, init) {
+        const url = this.baseUrl + path + buildQuery(init.query);
+        const headers = { accept: "application/json", ...init.headers };
+        if (!init.noAuth)
+            headers["x-api-key"] = this.apiKey;
+        let body;
+        if (init.body !== undefined) {
+            headers["content-type"] = "application/json";
+            body = JSON.stringify(init.body);
+        }
+        const { controller, done } = this.withTimeout(init.signal);
+        let res;
+        try {
+            res = await this.fetchImpl(url, { method, headers, body, signal: controller.signal });
+        }
+        catch (err) {
+            throw this.wrapTransport(err);
+        }
+        finally {
+            done();
+        }
+        if (!res.ok)
+            throw await toApiError(res);
+        return res;
+    }
+    /** Compose a timeout AbortController with an optional caller-supplied signal. */
+    withTimeout(signal) {
+        const controller = new AbortController();
+        const onAbort = () => controller.abort();
+        if (signal) {
+            if (signal.aborted)
+                controller.abort();
+            else
+                signal.addEventListener("abort", onAbort, { once: true });
+        }
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        return {
+            controller,
+            done: () => {
+                clearTimeout(timer);
+                signal?.removeEventListener("abort", onAbort);
+            },
+        };
+    }
+    wrapTransport(err) {
+        if (err instanceof errors_1.PageWeaverApiError)
+            throw err;
+        const aborted = err instanceof Error && err.name === "AbortError";
+        return new errors_1.PageWeaverConnectionError(aborted ? `Request timed out after ${this.timeoutMs}ms.` : `Request failed: ${describe(err)}`, err);
+    }
+}
+exports.HttpClient = HttpClient;
+function buildQuery(query) {
+    if (!query)
+        return "";
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+        if (value !== undefined && value !== "")
+            params.set(key, String(value));
+    }
+    const qs = params.toString();
+    return qs ? `?${qs}` : "";
+}
+async function toApiError(res) {
+    const raw = await safeText(res);
+    let body = raw;
+    try {
+        body = raw ? JSON.parse(raw) : undefined;
+    }
+    catch {
+        // Non-JSON body: keep the raw text.
+    }
+    const record = (body ?? {});
+    const message = (typeof record.message === "string" && record.message) ||
+        (Array.isArray(record.message) && record.message.join(", ")) ||
+        `Request failed with status ${res.status}`;
+    return new errors_1.PageWeaverApiError({
+        status: res.status,
+        message,
+        code: typeof record.code === "string" ? record.code : undefined,
+        errors: record.errors,
+        body,
+    });
+}
+async function safeText(res) {
+    try {
+        return await res.text();
+    }
+    catch {
+        return "";
+    }
+}
+function describe(err) {
+    if (err instanceof Error)
+        return err.message;
+    return String(err);
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { PageWeaver, type PageWeaverOptions } from "./client";
+export type { FetchLike } from "./http";
+export { DocumentsResource, type WaitOptions, type DownloadOptions } from "./documents";
+export { TemplatesResource } from "./templates";
+export { SchemasResource } from "./schemas";
+export { UsageResource } from "./usage";
+export { PageWeaverError, PageWeaverApiError, PageWeaverConnectionError, PageWeaverTimeoutError, PageWeaverDocumentFailedError, } from "./errors";
+export { verifyWebhook, verifyWebhookSignature, signWebhookBody, isDocumentEvent, isBatchEvent, PageWeaverWebhookSignatureError, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_EVENT_HEADER, WEBHOOK_TIMESTAMP_HEADER, type VerifyWebhookOptions, type WebhookPayload, type DocumentWebhookPayload, type BatchWebhookPayload, type WebhookEventName, type DocumentWebhookEventName, type BatchWebhookEventName, } from "./webhooks";
+export type { DocumentStatus, RenderOptions, PageOptions, RenderingOptions, MetadataOptions, BandOptions, WatermarkOptions, StructureOptions, LocalizationOptions, SecurityOptions, PdfSecurityOptions, PdfPermissions, DownloadSecurityOptions, CreateDocumentParams, CreateFromTemplateParams, CreateFromInlineParams, CreateDocumentResult, DownloadInfo, Document, DocumentListItem, ListDocumentsParams, DocumentPage, TemplateSummary, Template, TemplateVersionSummary, SchemaSummary, Schema, SchemaVersionSummary, Usage, } from "./types";

package/dist/index.js

@@ -0,0 +1,32 @@
+"use strict";
+// @pageweaver/sdk — official TypeScript client for the PageWeaver PDF generation API.
+// Server-side (Node 18+): uses the global `fetch` and `node:crypto` for webhook verification.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WEBHOOK_TIMESTAMP_HEADER = exports.WEBHOOK_EVENT_HEADER = exports.WEBHOOK_SIGNATURE_HEADER = exports.PageWeaverWebhookSignatureError = exports.isBatchEvent = exports.isDocumentEvent = exports.signWebhookBody = exports.verifyWebhookSignature = exports.verifyWebhook = exports.PageWeaverDocumentFailedError = exports.PageWeaverTimeoutError = exports.PageWeaverConnectionError = exports.PageWeaverApiError = exports.PageWeaverError = exports.UsageResource = exports.SchemasResource = exports.TemplatesResource = exports.DocumentsResource = exports.PageWeaver = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "PageWeaver", { enumerable: true, get: function () { return client_1.PageWeaver; } });
+var documents_1 = require("./documents");
+Object.defineProperty(exports, "DocumentsResource", { enumerable: true, get: function () { return documents_1.DocumentsResource; } });
+var templates_1 = require("./templates");
+Object.defineProperty(exports, "TemplatesResource", { enumerable: true, get: function () { return templates_1.TemplatesResource; } });
+var schemas_1 = require("./schemas");
+Object.defineProperty(exports, "SchemasResource", { enumerable: true, get: function () { return schemas_1.SchemasResource; } });
+var usage_1 = require("./usage");
+Object.defineProperty(exports, "UsageResource", { enumerable: true, get: function () { return usage_1.UsageResource; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "PageWeaverError", { enumerable: true, get: function () { return errors_1.PageWeaverError; } });
+Object.defineProperty(exports, "PageWeaverApiError", { enumerable: true, get: function () { return errors_1.PageWeaverApiError; } });
+Object.defineProperty(exports, "PageWeaverConnectionError", { enumerable: true, get: function () { return errors_1.PageWeaverConnectionError; } });
+Object.defineProperty(exports, "PageWeaverTimeoutError", { enumerable: true, get: function () { return errors_1.PageWeaverTimeoutError; } });
+Object.defineProperty(exports, "PageWeaverDocumentFailedError", { enumerable: true, get: function () { return errors_1.PageWeaverDocumentFailedError; } });
+var webhooks_1 = require("./webhooks");
+Object.defineProperty(exports, "verifyWebhook", { enumerable: true, get: function () { return webhooks_1.verifyWebhook; } });
+Object.defineProperty(exports, "verifyWebhookSignature", { enumerable: true, get: function () { return webhooks_1.verifyWebhookSignature; } });
+Object.defineProperty(exports, "signWebhookBody", { enumerable: true, get: function () { return webhooks_1.signWebhookBody; } });
+Object.defineProperty(exports, "isDocumentEvent", { enumerable: true, get: function () { return webhooks_1.isDocumentEvent; } });
+Object.defineProperty(exports, "isBatchEvent", { enumerable: true, get: function () { return webhooks_1.isBatchEvent; } });
+Object.defineProperty(exports, "PageWeaverWebhookSignatureError", { enumerable: true, get: function () { return webhooks_1.PageWeaverWebhookSignatureError; } });
+Object.defineProperty(exports, "WEBHOOK_SIGNATURE_HEADER", { enumerable: true, get: function () { return webhooks_1.WEBHOOK_SIGNATURE_HEADER; } });
+Object.defineProperty(exports, "WEBHOOK_EVENT_HEADER", { enumerable: true, get: function () { return webhooks_1.WEBHOOK_EVENT_HEADER; } });
+Object.defineProperty(exports, "WEBHOOK_TIMESTAMP_HEADER", { enumerable: true, get: function () { return webhooks_1.WEBHOOK_TIMESTAMP_HEADER; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;AACtF,8FAA8F;;;AAE9F,mCAA8D;AAArD,oGAAA,UAAU,OAAA;AAGnB,yCAAwF;AAA/E,8GAAA,iBAAiB,OAAA;AAC1B,yCAAgD;AAAvC,8GAAA,iBAAiB,OAAA;AAC1B,qCAA4C;AAAnC,0GAAA,eAAe,OAAA;AACxB,iCAAwC;AAA/B,sGAAA,aAAa,OAAA;AAEtB,mCAMkB;AALhB,yGAAA,eAAe,OAAA;AACf,4GAAA,kBAAkB,OAAA;AAClB,mHAAA,yBAAyB,OAAA;AACzB,gHAAA,sBAAsB,OAAA;AACtB,uHAAA,6BAA6B,OAAA;AAG/B,uCAiBoB;AAhBlB,yGAAA,aAAa,OAAA;AACb,kHAAA,sBAAsB,OAAA;AACtB,2GAAA,eAAe,OAAA;AACf,2GAAA,eAAe,OAAA;AACf,wGAAA,YAAY,OAAA;AACZ,2HAAA,+BAA+B,OAAA;AAC/B,oHAAA,wBAAwB,OAAA;AACxB,gHAAA,oBAAoB,OAAA;AACpB,oHAAA,wBAAwB,OAAA"}

package/dist/schemas.d.ts

@@ -0,0 +1,19 @@
+import type { HttpClient } from "./http";
+import type { Schema, SchemaSummary, SchemaVersionSummary } from "./types";
+/** Read-only discovery of the JSON Schemas your payloads validate against. */
+export declare class SchemasResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** All schemas owned by the key's account, newest-updated first. */
+    list(signal?: AbortSignal): Promise<SchemaSummary[]>;
+    /**
+     * A schema's published JSON Schema plus a derived sample, for the latest published version or a
+     * specific `version`.
+     */
+    get(id: string, opts?: {
+        version?: number;
+        signal?: AbortSignal;
+    }): Promise<Schema>;
+    /** A schema's published version history (newest first). Pin any via `schemaVersion` on create. */
+    versions(id: string, signal?: AbortSignal): Promise<SchemaVersionSummary[]>;
+}

package/dist/schemas.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchemasResource = void 0;
+/** Read-only discovery of the JSON Schemas your payloads validate against. */
+class SchemasResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** All schemas owned by the key's account, newest-updated first. */
+    list(signal) {
+        return this.http.json("GET", "/v1/schemas", { signal });
+    }
+    /**
+     * A schema's published JSON Schema plus a derived sample, for the latest published version or a
+     * specific `version`.
+     */
+    get(id, opts = {}) {
+        return this.http.json("GET", `/v1/schemas/${encodeURIComponent(id)}`, {
+            query: { version: opts.version },
+            signal: opts.signal,
+        });
+    }
+    /** A schema's published version history (newest first). Pin any via `schemaVersion` on create. */
+    versions(id, signal) {
+        return this.http.json("GET", `/v1/schemas/${encodeURIComponent(id)}/versions`, { signal });
+    }
+}
+exports.SchemasResource = SchemasResource;
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":";;;AAGA,8EAA8E;AAC9E,MAAa,eAAe;IACG;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,oEAAoE;IACpE,IAAI,CAAC,MAAoB;QACvB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAkB,KAAK,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,EAAU,EAAE,OAAmD,EAAE;QACnE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAS,KAAK,EAAE,eAAe,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE;YAC5E,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;YAChC,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;IACL,CAAC;IAED,kGAAkG;IAClG,QAAQ,CAAC,EAAU,EAAE,MAAoB;QACvC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,KAAK,EACL,eAAe,kBAAkB,CAAC,EAAE,CAAC,WAAW,EAChD,EAAE,MAAM,EAAE,CACX,CAAC;IACJ,CAAC;CACF;AA3BD,0CA2BC"}

package/dist/templates.d.ts

@@ -0,0 +1,13 @@
+import type { HttpClient } from "./http";
+import type { Template, TemplateSummary, TemplateVersionSummary } from "./types";
+/** Read-only discovery of your published templates and their pinnable versions. */
+export declare class TemplatesResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** All templates owned by the key's account, newest-updated first. */
+    list(signal?: AbortSignal): Promise<TemplateSummary[]>;
+    /** One template's metadata (name, current version, associated schema, authoring mode). */
+    get(id: string, signal?: AbortSignal): Promise<Template>;
+    /** A template's published version history (newest first). Pin any via `version` on create. */
+    versions(id: string, signal?: AbortSignal): Promise<TemplateVersionSummary[]>;
+}

package/dist/templates.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemplatesResource = void 0;
+/** Read-only discovery of your published templates and their pinnable versions. */
+class TemplatesResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** All templates owned by the key's account, newest-updated first. */
+    list(signal) {
+        return this.http.json("GET", "/v1/templates", { signal });
+    }
+    /** One template's metadata (name, current version, associated schema, authoring mode). */
+    get(id, signal) {
+        return this.http.json("GET", `/v1/templates/${encodeURIComponent(id)}`, { signal });
+    }
+    /** A template's published version history (newest first). Pin any via `version` on create. */
+    versions(id, signal) {
+        return this.http.json("GET", `/v1/templates/${encodeURIComponent(id)}/versions`, { signal });
+    }
+}
+exports.TemplatesResource = TemplatesResource;
+//# sourceMappingURL=templates.js.map

package/dist/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":";;;AAGA,mFAAmF;AACnF,MAAa,iBAAiB;IACC;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,sEAAsE;IACtE,IAAI,CAAC,MAAoB;QACvB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAoB,KAAK,EAAE,eAAe,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,0FAA0F;IAC1F,GAAG,CAAC,EAAU,EAAE,MAAoB;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAW,KAAK,EAAE,iBAAiB,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAChG,CAAC;IAED,8FAA8F;IAC9F,QAAQ,CAAC,EAAU,EAAE,MAAoB;QACvC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,KAAK,EACL,iBAAiB,kBAAkB,CAAC,EAAE,CAAC,WAAW,EAClD,EAAE,MAAM,EAAE,CACX,CAAC;IACJ,CAAC;CACF;AArBD,8CAqBC"}

package/dist/types.d.ts

@@ -0,0 +1,270 @@
+/** A terminal or in-flight document status. */
+export type DocumentStatus = "queued" | "rendering" | "done" | "failed";
+export interface PageOptions {
+    /** Standard paper size, e.g. "A4" or "Letter". */
+    size?: string;
+    /** Page orientation (requires `size`). */
+    orientation?: "portrait" | "landscape";
+    /** CSS margin shorthand: 1-4 space-separated lengths (mm/cm/in/px/pt), e.g. "18mm". */
+    margin?: string;
+    /** Render scale, 0.1 to 2.0. */
+    scale?: number;
+}
+export interface RenderingOptions {
+    /** CSS media type Chromium emulates. */
+    media?: "screen" | "print";
+    /** Print background graphics/colours. */
+    printBackground?: boolean;
+    /** Transparent background (implies printBackground). */
+    omitBackground?: boolean;
+    /** Collapse the whole document onto one tall page. */
+    singlePage?: boolean;
+    /** Honour the document's CSS @page size over the API paper params. */
+    preferCssPageSize?: boolean;
+    /** Pages to print, e.g. "1-3,5". Empty means all. */
+    pageRanges?: string;
+}
+export interface MetadataOptions {
+    /** PDF Title (also the header/footer {{title}}). Liquid tokens resolve. */
+    title?: string;
+    author?: string;
+    subject?: string;
+    keywords?: string;
+    creator?: string;
+}
+/** A running header or footer band. Slots accept literal text plus {{field}} / {{@page}} tokens. */
+export interface BandOptions {
+    /** Show the band. Omitting it while any slot has text auto-enables it. */
+    enabled?: boolean;
+    left?: string;
+    /** e.g. "Page {{@page}} of {{@pages}}". */
+    center?: string;
+    right?: string;
+    fontSizePt?: number;
+    /** Hex or CSS colour name. */
+    color?: string;
+}
+export interface WatermarkOptions {
+    /** Watermark text (empty means off). Tokens resolve. */
+    text?: string;
+    /** Pages to mark, e.g. "1-3". Empty means all. */
+    pages?: string;
+    fontSizePt?: number;
+    color?: string;
+    /** Opacity 0 to 1. */
+    opacity?: number;
+    /** Rotation in degrees, 0 to 360. */
+    rotation?: number;
+}
+export interface StructureOptions {
+    /** Emit PDF bookmarks/outline from the document headings. */
+    outline?: boolean;
+    /** Emit a tagged (accessible) PDF structure. */
+    taggedPdf?: boolean;
+}
+export interface LocalizationOptions {
+    /** BCP-47 locale for date/number/currency formatting, e.g. "de-DE". */
+    locale?: string;
+    /** IANA time zone, e.g. "Europe/Berlin". */
+    timeZone?: string;
+    /** ISO 4217 currency, e.g. "EUR". */
+    currency?: string;
+}
+export interface PdfPermissions {
+    printing?: boolean;
+    copying?: boolean;
+    modifying?: boolean;
+    annotating?: boolean;
+    fillingForms?: boolean;
+    assembling?: boolean;
+}
+export interface PdfSecurityOptions {
+    /** Password required to open the PDF (PDF-level encryption). */
+    userPassword?: string;
+    /** Owner password for full permissions. */
+    ownerPassword?: string;
+    permissions?: PdfPermissions;
+}
+/**
+ * Download protection: a password that gates streaming the document from the PageWeaver
+ * download endpoint, separate from the PDF's own open-password.
+ */
+export interface DownloadSecurityOptions {
+    /** Enable the download password. */
+    enabled?: boolean;
+    /** The password recipients must supply to fetch the PDF. */
+    password?: string;
+    /** Generate a strong random download password (returned in the response). */
+    generate?: boolean;
+}
+export interface SecurityOptions {
+    pdf?: PdfSecurityOptions;
+    download?: DownloadSecurityOptions;
+}
+/**
+ * The single nested per-render `options` block. Every field is layered on the template
+ * version's frozen settings for this render only. Unknown keys are rejected by the API (400).
+ */
+export interface RenderOptions {
+    page?: PageOptions;
+    rendering?: RenderingOptions;
+    metadata?: MetadataOptions;
+    header?: BandOptions;
+    footer?: BandOptions;
+    watermark?: WatermarkOptions;
+    structure?: StructureOptions;
+    localization?: LocalizationOptions;
+    security?: SecurityOptions;
+}
+interface CreateDocumentCommon {
+    /** Data merged into the template/HTML via Liquid. */
+    payload?: Record<string, unknown>;
+    /** Per-render option overrides, nested under this one key. */
+    options?: RenderOptions;
+    /**
+     * A unique token you generate per document so a retried request returns the original
+     * document instead of creating a duplicate. Sent as the `Idempotency-Key` header.
+     */
+    idempotencyKey?: string;
+    /** HTTPS URL to receive a signed webhook POST when the document reaches a terminal state. */
+    callbackUrl?: string;
+}
+/** Render a published template. */
+export interface CreateFromTemplateParams extends CreateDocumentCommon {
+    /** Template id (or the built-in "sample-invoice"). */
+    templateId: string;
+    /** Data merged into the template. Required and validated against the template's schema. */
+    payload: Record<string, unknown>;
+    /** Pin a published template version; defaults to the template's latest. */
+    version?: number;
+    /** Validate against this schema instead of the one the template pins (account-owned). */
+    schemaId?: string;
+    /** Pin a published schema version (requires `schemaId`); defaults to that schema's latest. */
+    schemaVersion?: number;
+    html?: never;
+    css?: never;
+}
+/** Render raw inline HTML with no template. No external images, stylesheets, or JavaScript. */
+export interface CreateFromInlineParams extends CreateDocumentCommon {
+    /** Raw HTML to convert. May use Liquid tokens and reference account image assets by name. */
+    html: string;
+    /** CSS applied to the inline HTML (injected as a <style>). */
+    css?: string;
+    templateId?: never;
+    version?: never;
+    schemaId?: never;
+    schemaVersion?: never;
+}
+export type CreateDocumentParams = CreateFromTemplateParams | CreateFromInlineParams;
+/** The owner-visible download block, present when a document is download-protected. */
+export interface DownloadInfo {
+    protected: boolean;
+    requiresPassword: boolean;
+    /** The plaintext download password, returned only to the authenticated owner. */
+    password?: string;
+    /** A short-lived signed URL (unprotected), or the content endpoint URL (protected). */
+    url?: string;
+}
+/** The `202` body from creating (or idempotently returning) a document. */
+export interface CreateDocumentResult {
+    id: string;
+    status: DocumentStatus;
+    /** Null for an inline render (it had no template). */
+    version: number | null;
+    download?: DownloadInfo;
+}
+/** The `GET /v1/documents/:id` body. */
+export interface Document {
+    id: string;
+    status: DocumentStatus;
+    version: number | null;
+    download?: DownloadInfo;
+    /** Present when `status` is "failed". */
+    error?: string;
+    /** The per-render options the document was created with; null if none. */
+    appliedOptions?: Record<string, unknown> | null;
+}
+/** One row in the document history list. */
+export interface DocumentListItem {
+    id: string;
+    templateId: string | null;
+    version: number | null;
+    status: DocumentStatus;
+    source: string;
+    pages: number | null;
+    bytes: number | null;
+    /** ISO 8601 timestamp. */
+    createdAt: string;
+    finishedAt: string | null;
+    pdfAvailable: boolean;
+    pdfExpiresAt: string | null;
+    error: string | null;
+}
+export interface ListDocumentsParams {
+    status?: DocumentStatus;
+    templateId?: string;
+    cursor?: string;
+    /** 1 to 100, default 25. */
+    limit?: number;
+}
+export interface DocumentPage {
+    items: DocumentListItem[];
+    /** Pass to the next `list` call to fetch the following page; null when there are no more. */
+    nextCursor: string | null;
+}
+export interface TemplateSummary {
+    id: string;
+    name: string;
+    description: string | null;
+    /** 0 for a template that has never been published (not yet renderable). */
+    currentVersion: number;
+    /** ISO 8601 timestamp. */
+    updatedAt: string;
+}
+export interface Template extends TemplateSummary {
+    editorMode: string;
+    schemaId: string | null;
+    schemaVersion: number | null;
+}
+export interface TemplateVersionSummary {
+    version: number;
+    note: string | null;
+    /** ISO 8601 timestamp. */
+    publishedAt: string;
+    derivedFromVersion: number | null;
+}
+export interface SchemaSummary {
+    id: string;
+    name: string;
+    description: string | null;
+    /** ISO 8601 timestamp. */
+    updatedAt: string;
+}
+export interface Schema {
+    id: string;
+    name: string;
+    description: string | null;
+    version: number;
+    /** The published JSON Schema (as a JSON value). */
+    schema: unknown;
+    /** A derived sample payload conforming to the schema. */
+    sample: unknown;
+}
+export interface SchemaVersionSummary {
+    version: number;
+    note: string | null;
+    /** ISO 8601 timestamp. */
+    publishedAt: string;
+}
+export interface Usage {
+    /** The billing period label, e.g. "2026-08". */
+    period: string;
+    /** Billable API document pages consumed this period. */
+    pages: number;
+    /** Monthly page allowance for the plan. */
+    limit: number;
+    /** Editor PDF-preview pages consumed this period (a separate budget). */
+    previewPages: number;
+    previewLimit: number;
+}
+export {};

package/dist/types.js

@@ -0,0 +1,11 @@
+"use strict";
+// Request/response shapes for the PageWeaver public API (`/v1/*`), hand-mirrored from the
+// server DTOs so the SDK stays self-contained (no dependency on the internal workspace
+// packages, which are private and unpublishable). Keep these in sync with:
+//   apps/api/src/renders/dto/create-render.dto.ts   (RenderOptions + CreateRenderDto)
+//   apps/api/src/renders/renders.service.ts          (Create/Document/List result shapes)
+//   apps/api/src/templates/templates.service.ts      (discovery shapes)
+//   apps/api/src/schemas/schemas.service.ts
+// A drift-guard test against a captured openapi.json is a good future addition.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,0FAA0F;AAC1F,uFAAuF;AACvF,2EAA2E;AAC3E,sFAAsF;AACtF,0FAA0F;AAC1F,wEAAwE;AACxE,4CAA4C;AAC5C,gFAAgF"}

package/dist/usage.d.ts

@@ -0,0 +1,9 @@
+import type { HttpClient } from "./http";
+import type { Usage } from "./types";
+/** Your page consumption against the plan quota for the current billing period. */
+export declare class UsageResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Current-period usage: billable document pages and editor preview pages, with their limits. */
+    get(signal?: AbortSignal): Promise<Usage>;
+}

package/dist/usage.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UsageResource = void 0;
+/** Your page consumption against the plan quota for the current billing period. */
+class UsageResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Current-period usage: billable document pages and editor preview pages, with their limits. */
+    get(signal) {
+        return this.http.json("GET", "/v1/usage", { signal });
+    }
+}
+exports.UsageResource = UsageResource;
+//# sourceMappingURL=usage.js.map

package/dist/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":";;;AAGA,mFAAmF;AACnF,MAAa,aAAa;IACK;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,iGAAiG;IACjG,GAAG,CAAC,MAAoB;QACtB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAQ,KAAK,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/D,CAAC;CACF;AAPD,sCAOC"}