@cloudpdf/sdk 3.0.0-next.1 → 3.0.0-next.10

package/dist/esm/Client.mjs

@@ -11,6 +11,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import { DeploymentClient } from "./api/resources/deployment/client/Client.mjs";
 import { DocClient } from "./api/resources/doc/client/Client.mjs";
 import { DocumentsClient } from "./api/resources/documents/client/Client.mjs";
+import { SharesClient } from "./api/resources/shares/client/Client.mjs";
 import { TenantsClient } from "./api/resources/tenants/client/Client.mjs";
 import { TokensClient } from "./api/resources/tokens/client/Client.mjs";
 import { normalizeClientOptionsWithAuth } from "./BaseClient.mjs";
@@ -27,6 +28,10 @@ export class CloudPDFClient {
         var _a;
         return ((_a = this._doc) !== null && _a !== void 0 ? _a : (this._doc = new DocClient(this._options)));
     }
+    get shares() {
+        var _a;
+        return ((_a = this._shares) !== null && _a !== void 0 ? _a : (this._shares = new SharesClient(this._options)));
+    }
     get tenants() {
         var _a;
         return ((_a = this._tenants) !== null && _a !== void 0 ? _a : (this._tenants = new TenantsClient(this._options)));

package/dist/esm/CloudPDFClient.d.mts

@@ -0,0 +1,20 @@
+import { CloudPDFClient as GeneratedCloudPDFClient } from "./Client.mjs";
+import type * as CloudPDF from "./api/index.mjs";
+import { Uploads } from "./uploads/Uploads.mjs";
+export declare namespace CloudPDFClient {
+    type GeneratedOptions = GeneratedCloudPDFClient.Options;
+    type Endpoint = GeneratedOptions["environment"];
+    type Options = Omit<GeneratedOptions, "environment" | "baseUrl"> & ({
+        baseUrl: NonNullable<GeneratedOptions["baseUrl"]>;
+        environment?: Endpoint;
+    } | {
+        environment: Endpoint;
+        baseUrl?: GeneratedOptions["baseUrl"];
+    });
+    type RequestOptions = GeneratedCloudPDFClient.RequestOptions;
+}
+/** Generated protocol client plus CloudPDF's handwritten workflow layer. */
+export declare class CloudPDFClient extends GeneratedCloudPDFClient {
+    readonly uploads: Uploads<CloudPDF.DocumentsCommit200Response.Document>;
+    constructor(options: CloudPDFClient.Options);
+}

package/dist/esm/CloudPDFClient.mjs

@@ -0,0 +1,35 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { CloudPDFClient as GeneratedCloudPDFClient } from "./Client.mjs";
+import { Uploads } from "./uploads/Uploads.mjs";
+/** Generated protocol client plus CloudPDF's handwritten workflow layer. */
+export class CloudPDFClient extends GeneratedCloudPDFClient {
+    constructor(options) {
+        var _a, _b, _c;
+        // Self-hosted CloudPDF has no universal environment URL. Let callers
+        // provide the familiar `baseUrl` alone while still satisfying Fern's
+        // generated client's internal environment slot.
+        super(Object.assign(Object.assign({}, options), { environment: (_a = options.environment) !== null && _a !== void 0 ? _a : options.baseUrl }));
+        const rawFetch = (_b = options.fetch) !== null && _b !== void 0 ? _b : (_c = globalThis.fetch) === null || _c === void 0 ? void 0 : _c.bind(globalThis);
+        if (!rawFetch)
+            throw new Error("CloudPDFClient requires a fetch implementation");
+        this.uploads = new Uploads({
+            init: (request, requestOptions) => __awaiter(this, void 0, void 0, function* () { return this.documents.init(request, requestOptions); }),
+            commit: (request, requestOptions) => __awaiter(this, void 0, void 0, function* () { return this.documents.commit(request, requestOptions); }),
+            proxy: (url, form, requestOptions) => __awaiter(this, void 0, void 0, function* () {
+                return this.fetch(url, { method: "POST", body: form }, {
+                    abortSignal: requestOptions.abortSignal,
+                    maxRetries: requestOptions.maxRetries,
+                });
+            }),
+            presigned: (url, init) => __awaiter(this, void 0, void 0, function* () { return rawFetch(url, init); }),
+        });
+    }
+}

package/dist/esm/api/errors/BadGatewayError.d.mts

@@ -0,0 +1,7 @@
+import type * as core from "../../core/index.mjs";
+import * as errors from "../../errors/index.mjs";
+import type * as CloudPDF from "../index.mjs";
+export declare class BadGatewayError extends errors.CloudPDFError {
+    readonly body: CloudPDF.DocumentsImportFrom502Response;
+    constructor(body: CloudPDF.DocumentsImportFrom502Response, rawResponse?: core.RawResponse);
+}

package/dist/esm/api/errors/BadGatewayError.mjs

@@ -0,0 +1,17 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as errors from "../../errors/index.mjs";
+export class BadGatewayError extends errors.CloudPDFError {
+    constructor(body, rawResponse) {
+        super({
+            message: "BadGatewayError",
+            statusCode: 502,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        this.name = "BadGatewayError";
+    }
+}

package/dist/esm/api/errors/ConflictError.d.mts

@@ -0,0 +1,5 @@
+import type * as core from "../../core/index.mjs";
+import * as errors from "../../errors/index.mjs";
+export declare class ConflictError extends errors.CloudPDFError {
+    constructor(body?: unknown, rawResponse?: core.RawResponse);
+}

package/dist/esm/api/errors/ConflictError.mjs

@@ -0,0 +1,17 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as errors from "../../errors/index.mjs";
+export class ConflictError extends errors.CloudPDFError {
+    constructor(body, rawResponse) {
+        super({
+            message: "ConflictError",
+            statusCode: 409,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        this.name = "ConflictError";
+    }
+}

package/dist/esm/api/errors/GoneError.d.mts

@@ -0,0 +1,7 @@
+import type * as core from "../../core/index.mjs";
+import * as errors from "../../errors/index.mjs";
+import type * as CloudPDF from "../index.mjs";
+export declare class GoneError extends errors.CloudPDFError {
+    readonly body: CloudPDF.SharesExchange410Response;
+    constructor(body: CloudPDF.SharesExchange410Response, rawResponse?: core.RawResponse);
+}

package/dist/esm/api/errors/GoneError.mjs

@@ -0,0 +1,17 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as errors from "../../errors/index.mjs";
+export class GoneError extends errors.CloudPDFError {
+    constructor(body, rawResponse) {
+        super({
+            message: "GoneError",
+            statusCode: 410,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        this.name = "GoneError";
+    }
+}

package/dist/esm/api/errors/UnprocessableEntityError.d.mts

@@ -0,0 +1,7 @@
+import type * as core from "../../core/index.mjs";
+import * as errors from "../../errors/index.mjs";
+import type * as CloudPDF from "../index.mjs";
+export declare class UnprocessableEntityError extends errors.CloudPDFError {
+    readonly body: CloudPDF.SharesExchange422Response;
+    constructor(body: CloudPDF.SharesExchange422Response, rawResponse?: core.RawResponse);
+}

package/dist/esm/api/errors/UnprocessableEntityError.mjs

@@ -0,0 +1,17 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as errors from "../../errors/index.mjs";
+export class UnprocessableEntityError extends errors.CloudPDFError {
+    constructor(body, rawResponse) {
+        super({
+            message: "UnprocessableEntityError",
+            statusCode: 422,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        this.name = "UnprocessableEntityError";
+    }
+}

package/dist/esm/api/errors/index.d.mts

@@ -1,3 +1,7 @@
+export * from "./BadGatewayError.mjs";
 export * from "./BadRequestError.mjs";
+export * from "./ConflictError.mjs";
 export * from "./ForbiddenError.mjs";
+export * from "./GoneError.mjs";
 export * from "./NotFoundError.mjs";
+export * from "./UnprocessableEntityError.mjs";

package/dist/esm/api/errors/index.mjs

@@ -1,3 +1,7 @@
+export * from "./BadGatewayError.mjs";
 export * from "./BadRequestError.mjs";
+export * from "./ConflictError.mjs";
 export * from "./ForbiddenError.mjs";
+export * from "./GoneError.mjs";
 export * from "./NotFoundError.mjs";
+export * from "./UnprocessableEntityError.mjs";

package/dist/esm/api/resources/doc/resources/annotations/client/Client.d.mts

@@ -10,6 +10,25 @@ export declare namespace AnnotationsClient {
 export declare class AnnotationsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<AnnotationsClient.Options>;
     constructor(options: AnnotationsClient.Options);
+    /**
+     * Returns one entry per page plus the audit-log cursor for reconciling subsequent document events. Page order is unspecified; join by `pageState.pageObjectNumber` when display order matters.
+     *
+     * @param {CloudPDF.doc.ListAllAnnotationsRequest} request
+     * @param {AnnotationsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link CloudPDF.NotFoundError}
+     * @throws {@link CloudPDF.ConflictError}
+     * @throws {@link errors.CloudPDFError}
+     * @throws {@link errors.CloudPDFTimeoutError}
+     *
+     * @example
+     *     await client.doc.annotations.listAll({
+     *         docId: "docId",
+     *         layerName: "layerName"
+     *     })
+     */
+    listAll(request: CloudPDF.doc.ListAllAnnotationsRequest, requestOptions?: AnnotationsClient.RequestOptions): core.HttpResponsePromise<CloudPDF.DocAnnotationsListAll200Response>;
+    private __listAll;
     /**
      * @param {CloudPDF.doc.ListAnnotationsRequest} request
      * @param {AnnotationsClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/esm/api/resources/doc/resources/annotations/client/Client.mjs

@@ -19,6 +19,66 @@ export class AnnotationsClient {
     constructor(options) {
         this._options = normalizeClientOptionsWithAuth(options);
     }
+    /**
+     * Returns one entry per page plus the audit-log cursor for reconciling subsequent document events. Page order is unspecified; join by `pageState.pageObjectNumber` when display order matters.
+     *
+     * @param {CloudPDF.doc.ListAllAnnotationsRequest} request
+     * @param {AnnotationsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link CloudPDF.NotFoundError}
+     * @throws {@link CloudPDF.ConflictError}
+     * @throws {@link errors.CloudPDFError}
+     * @throws {@link errors.CloudPDFTimeoutError}
+     *
+     * @example
+     *     await client.doc.annotations.listAll({
+     *         docId: "docId",
+     *         layerName: "layerName"
+     *     })
+     */
+    listAll(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listAll(request, requestOptions));
+    }
+    __listAll(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const { docId, layerName, "X-Document-Password": documentPassword } = request;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "X-Document-Password": documentPassword }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment)), `v1/docs/${core.url.encodePathParam(docId)}/layers/${core.url.encodePathParam(layerName)}/annotations/items`),
+                method: "GET",
+                headers: _headers,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                timeoutMs: ((_e = (_c = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _c !== void 0 ? _c : (_d = this._options) === null || _d === void 0 ? void 0 : _d.timeoutInSeconds) !== null && _e !== void 0 ? _e : 60) * 1000,
+                maxRetries: (_f = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _f !== void 0 ? _f : (_g = this._options) === null || _g === void 0 ? void 0 : _g.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_h = this._options) === null || _h === void 0 ? void 0 : _h.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 404:
+                        throw new CloudPDF.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 409:
+                        throw new CloudPDF.ConflictError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.CloudPDFError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v1/docs/{docId}/layers/{layerName}/annotations/items");
+        });
+    }
     /**
      * @param {CloudPDF.doc.ListAnnotationsRequest} request
      * @param {AnnotationsClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/esm/api/resources/doc/resources/annotations/client/requests/ListAllAnnotationsRequest.d.mts

@@ -0,0 +1,13 @@
+/**
+ * @example
+ *     {
+ *         docId: "docId",
+ *         layerName: "layerName"
+ *     }
+ */
+export interface ListAllAnnotationsRequest {
+    docId: string;
+    layerName: string;
+    /** Base64-encoded password for an encrypted document. Valid only with the API token (403 anywhere else). An encrypted document answers 422 DocPasswordRequired when the header is absent. Viewer doc JWTs use the SDK password-session flow instead. */
+    "X-Document-Password"?: string;
+}

package/dist/esm/api/resources/doc/resources/annotations/client/requests/index.d.mts

@@ -1,4 +1,5 @@
 export type { CreateAnnotationsRequest } from "./CreateAnnotationsRequest.mjs";
 export type { DeleteAnnotationsRequest } from "./DeleteAnnotationsRequest.mjs";
+export type { ListAllAnnotationsRequest } from "./ListAllAnnotationsRequest.mjs";
 export type { ListAnnotationsRequest } from "./ListAnnotationsRequest.mjs";
 export type { UpdateAnnotationsRequest } from "./UpdateAnnotationsRequest.mjs";

package/dist/esm/api/resources/doc/resources/pages/client/Client.d.mts

@@ -30,6 +30,16 @@ export declare class PagesClient {
      */
     delete(request: CloudPDF.doc.DeletePagesRequest, requestOptions?: PagesClient.RequestOptions): core.HttpResponsePromise<CloudPDF.DocPagesDelete200Response>;
     private __delete;
+    /**
+     * A read, not a mutation: the source document is untouched and no event is published. Body is `{"pageObjectNumbers": number[]}`; the response body is the new PDF.
+     *
+     * @throws {@link CloudPDF.BadRequestError}
+     * @throws {@link CloudPDF.NotFoundError}
+     * @throws {@link errors.CloudPDFError}
+     * @throws {@link errors.CloudPDFTimeoutError}
+     */
+    extract(request: CloudPDF.doc.ExtractPagesRequest, requestOptions?: PagesClient.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
+    private __extract;
     /**
      * @param {CloudPDF.doc.FlattenPagesRequest} request
      * @param {PagesClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -50,6 +60,49 @@ export declare class PagesClient {
      */
     flatten(request: CloudPDF.doc.FlattenPagesRequest, requestOptions?: PagesClient.RequestOptions): core.HttpResponsePromise<CloudPDF.DocPagesFlatten200Response>;
     private __flatten;
+    /**
+     * Multipart mutation envelope: a `body` field holding `{"destIndex"?: number}` (omitted → append) plus a `resource:source` file part carrying the standalone PDF whose pages are copied in. The inserted copies get fresh page object numbers, returned in insertion order.
+     *
+     * @param {CloudPDF.doc.InsertPagesRequest} request
+     * @param {PagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link CloudPDF.BadRequestError}
+     * @throws {@link CloudPDF.NotFoundError}
+     * @throws {@link errors.CloudPDFError}
+     * @throws {@link errors.CloudPDFTimeoutError}
+     *
+     * @example
+     *     import { createReadStream } from "fs";
+     *     await client.doc.pages.insert({
+     *         file: fs.createReadStream("/path/to/your/file"),
+     *         docId: "docId",
+     *         layerName: "layerName"
+     *     })
+     */
+    insert(request: CloudPDF.doc.InsertPagesRequest, requestOptions?: PagesClient.RequestOptions): core.HttpResponsePromise<CloudPDF.DocPagesInsert200Response>;
+    private __insert;
+    /**
+     * Body is `{"size": {"width", "height"}, "count"?, "destIndex"?}` — size in PDF points, count in [1, 100], destIndex omitted → append.
+     *
+     * @param {CloudPDF.doc.InsertBlankPagesRequest} request
+     * @param {PagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link CloudPDF.BadRequestError}
+     * @throws {@link CloudPDF.NotFoundError}
+     * @throws {@link errors.CloudPDFError}
+     * @throws {@link errors.CloudPDFTimeoutError}
+     *
+     * @example
+     *     await client.doc.pages.insertBlank({
+     *         docId: "docId",
+     *         layerName: "layerName",
+     *         body: {
+     *             "key": "value"
+     *         }
+     *     })
+     */
+    insertBlank(request: CloudPDF.doc.InsertBlankPagesRequest, requestOptions?: PagesClient.RequestOptions): core.HttpResponsePromise<CloudPDF.DocPagesInsertBlank200Response>;
+    private __insertBlank;
     /**
      * @param {CloudPDF.doc.MovePagesRequest} request
      * @param {PagesClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/esm/api/resources/doc/resources/pages/client/Client.mjs

@@ -80,6 +80,58 @@ export class PagesClient {
             return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v1/docs/{docId}/layers/{layerName}/pages/delete");
         });
     }
+    /**
+     * A read, not a mutation: the source document is untouched and no event is published. Body is `{"pageObjectNumbers": number[]}`; the response body is the new PDF.
+     *
+     * @throws {@link CloudPDF.BadRequestError}
+     * @throws {@link CloudPDF.NotFoundError}
+     * @throws {@link errors.CloudPDFError}
+     * @throws {@link errors.CloudPDFTimeoutError}
+     */
+    extract(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__extract(request, requestOptions));
+    }
+    __extract(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const { docId, layerName, "X-Document-Password": documentPassword, body: _body } = request;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "X-Document-Password": documentPassword }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment)), `v1/docs/${core.url.encodePathParam(docId)}/layers/${core.url.encodePathParam(layerName)}/pages/extract`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                requestType: "json",
+                body: mergeAdditionalBodyParameters(_body, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.additionalBodyParameters),
+                responseType: "binary-response",
+                timeoutMs: ((_e = (_c = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _c !== void 0 ? _c : (_d = this._options) === null || _d === void 0 ? void 0 : _d.timeoutInSeconds) !== null && _e !== void 0 ? _e : 60) * 1000,
+                maxRetries: (_f = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _f !== void 0 ? _f : (_g = this._options) === null || _g === void 0 ? void 0 : _g.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_h = this._options) === null || _h === void 0 ? void 0 : _h.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new CloudPDF.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new CloudPDF.NotFoundError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.CloudPDFError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v1/docs/{docId}/layers/{layerName}/pages/extract");
+        });
+    }
     /**
      * @param {CloudPDF.doc.FlattenPagesRequest} request
      * @param {PagesClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -141,6 +193,136 @@ export class PagesClient {
             return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v1/docs/{docId}/layers/{layerName}/pages/flatten");
         });
     }
+    /**
+     * Multipart mutation envelope: a `body` field holding `{"destIndex"?: number}` (omitted → append) plus a `resource:source` file part carrying the standalone PDF whose pages are copied in. The inserted copies get fresh page object numbers, returned in insertion order.
+     *
+     * @param {CloudPDF.doc.InsertPagesRequest} request
+     * @param {PagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link CloudPDF.BadRequestError}
+     * @throws {@link CloudPDF.NotFoundError}
+     * @throws {@link errors.CloudPDFError}
+     * @throws {@link errors.CloudPDFTimeoutError}
+     *
+     * @example
+     *     import { createReadStream } from "fs";
+     *     await client.doc.pages.insert({
+     *         file: fs.createReadStream("/path/to/your/file"),
+     *         docId: "docId",
+     *         layerName: "layerName"
+     *     })
+     */
+    insert(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__insert(request, requestOptions));
+    }
+    __insert(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const _body = yield core.newFormData();
+            yield _body.appendFile("file", request.file);
+            const _maybeEncodedRequest = yield _body.getRequest();
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders(Object.assign({ "X-Document-Password": request["X-Document-Password"] }, _maybeEncodedRequest.headers)), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment)), `v1/docs/${core.url.encodePathParam(request.docId)}/layers/${core.url.encodePathParam(request.layerName)}/pages/insert`),
+                method: "POST",
+                headers: _headers,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                requestType: "file",
+                duplex: _maybeEncodedRequest.duplex,
+                body: _maybeEncodedRequest.body,
+                timeoutMs: ((_e = (_c = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _c !== void 0 ? _c : (_d = this._options) === null || _d === void 0 ? void 0 : _d.timeoutInSeconds) !== null && _e !== void 0 ? _e : 60) * 1000,
+                maxRetries: (_f = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _f !== void 0 ? _f : (_g = this._options) === null || _g === void 0 ? void 0 : _g.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_h = this._options) === null || _h === void 0 ? void 0 : _h.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new CloudPDF.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new CloudPDF.NotFoundError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.CloudPDFError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v1/docs/{docId}/layers/{layerName}/pages/insert");
+        });
+    }
+    /**
+     * Body is `{"size": {"width", "height"}, "count"?, "destIndex"?}` — size in PDF points, count in [1, 100], destIndex omitted → append.
+     *
+     * @param {CloudPDF.doc.InsertBlankPagesRequest} request
+     * @param {PagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link CloudPDF.BadRequestError}
+     * @throws {@link CloudPDF.NotFoundError}
+     * @throws {@link errors.CloudPDFError}
+     * @throws {@link errors.CloudPDFTimeoutError}
+     *
+     * @example
+     *     await client.doc.pages.insertBlank({
+     *         docId: "docId",
+     *         layerName: "layerName",
+     *         body: {
+     *             "key": "value"
+     *         }
+     *     })
+     */
+    insertBlank(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__insertBlank(request, requestOptions));
+    }
+    __insertBlank(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const { docId, layerName, "X-Document-Password": documentPassword, body: _body } = request;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "X-Document-Password": documentPassword }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment)), `v1/docs/${core.url.encodePathParam(docId)}/layers/${core.url.encodePathParam(layerName)}/pages/insert-blank`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                requestType: "json",
+                body: mergeAdditionalBodyParameters(_body, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.additionalBodyParameters),
+                timeoutMs: ((_e = (_c = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _c !== void 0 ? _c : (_d = this._options) === null || _d === void 0 ? void 0 : _d.timeoutInSeconds) !== null && _e !== void 0 ? _e : 60) * 1000,
+                maxRetries: (_f = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _f !== void 0 ? _f : (_g = this._options) === null || _g === void 0 ? void 0 : _g.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_h = this._options) === null || _h === void 0 ? void 0 : _h.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new CloudPDF.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new CloudPDF.NotFoundError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.CloudPDFError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v1/docs/{docId}/layers/{layerName}/pages/insert-blank");
+        });
+    }
     /**
      * @param {CloudPDF.doc.MovePagesRequest} request
      * @param {PagesClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/esm/api/resources/doc/resources/pages/client/requests/ExtractPagesRequest.d.mts

@@ -0,0 +1,20 @@
+import type * as CloudPDF from "../../../../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         docId: "docId",
+ *         layerName: "layerName",
+ *         body: {
+ *             "string": {
+ *                 "key": "value"
+ *             }
+ *         }
+ *     }
+ */
+export interface ExtractPagesRequest {
+    docId: string;
+    layerName: string;
+    /** Base64-encoded password for an encrypted document. Valid only with the API token (403 anywhere else). An encrypted document answers 422 DocPasswordRequired when the header is absent. Viewer doc JWTs use the SDK password-session flow instead. */
+    "X-Document-Password"?: string;
+    body: CloudPDF.DocPagesExtractRequest;
+}

package/dist/esm/api/resources/doc/resources/pages/client/requests/InsertBlankPagesRequest.d.mts

@@ -0,0 +1,18 @@
+import type * as CloudPDF from "../../../../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         docId: "docId",
+ *         layerName: "layerName",
+ *         body: {
+ *             "key": "value"
+ *         }
+ *     }
+ */
+export interface InsertBlankPagesRequest {
+    docId: string;
+    layerName: string;
+    /** Base64-encoded password for an encrypted document. Valid only with the API token (403 anywhere else). An encrypted document answers 422 DocPasswordRequired when the header is absent. Viewer doc JWTs use the SDK password-session flow instead. */
+    "X-Document-Password"?: string;
+    body: CloudPDF.DocPagesInsertBlankRequest;
+}

package/dist/esm/api/resources/doc/resources/pages/client/requests/InsertBlankPagesRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/doc/resources/pages/client/requests/InsertPagesRequest.d.mts

@@ -0,0 +1,16 @@
+import type * as core from "../../../../../../../core/index.mjs";
+/**
+ * @example
+ *     {
+ *         file: fs.createReadStream("/path/to/your/file"),
+ *         docId: "docId",
+ *         layerName: "layerName"
+ *     }
+ */
+export interface InsertPagesRequest {
+    docId: string;
+    layerName: string;
+    /** Base64-encoded password for an encrypted document. Valid only with the API token (403 anywhere else). An encrypted document answers 422 DocPasswordRequired when the header is absent. Viewer doc JWTs use the SDK password-session flow instead. */
+    "X-Document-Password"?: string;
+    file: core.file.Uploadable;
+}