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

package/dist/cjs/api/resources/doc/resources/annotations/client/requests/index.d.ts

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

package/dist/cjs/api/resources/doc/resources/pages/client/Client.d.ts

@@ -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/cjs/api/resources/doc/resources/pages/client/Client.js

@@ -116,6 +116,58 @@ class PagesClient {
             return (0, handleNonStatusCodeError_js_1.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 = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.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: (0, requestBody_js_1.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 (0, handleNonStatusCodeError_js_1.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.
@@ -177,6 +229,136 @@ class PagesClient {
             return (0, handleNonStatusCodeError_js_1.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 = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.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 (0, handleNonStatusCodeError_js_1.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 = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.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: (0, requestBody_js_1.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 (0, handleNonStatusCodeError_js_1.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/cjs/api/resources/doc/resources/pages/client/requests/ExtractPagesRequest.d.ts

@@ -0,0 +1,20 @@
+import type * as CloudPDF from "../../../../../../index.js";
+/**
+ * @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/cjs/api/resources/doc/resources/pages/client/requests/InsertBlankPagesRequest.d.ts

@@ -0,0 +1,18 @@
+import type * as CloudPDF from "../../../../../../index.js";
+/**
+ * @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/cjs/api/resources/doc/resources/pages/client/requests/InsertBlankPagesRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/doc/resources/pages/client/requests/InsertPagesRequest.d.ts

@@ -0,0 +1,16 @@
+import type * as core from "../../../../../../../core/index.js";
+/**
+ * @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;
+}

package/dist/cjs/api/resources/doc/resources/pages/client/requests/InsertPagesRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/doc/resources/pages/client/requests/index.d.ts

@@ -1,4 +1,7 @@
 export type { DeletePagesRequest } from "./DeletePagesRequest.js";
+export type { ExtractPagesRequest } from "./ExtractPagesRequest.js";
 export type { FlattenPagesRequest } from "./FlattenPagesRequest.js";
+export type { InsertBlankPagesRequest } from "./InsertBlankPagesRequest.js";
+export type { InsertPagesRequest } from "./InsertPagesRequest.js";
 export type { MovePagesRequest } from "./MovePagesRequest.js";
 export type { RotatePagesRequest } from "./RotatePagesRequest.js";

package/dist/cjs/api/resources/documents/client/Client.d.ts

@@ -93,17 +93,49 @@ export declare class DocumentsClient {
     thumbnail(request: CloudPDF.ThumbnailDocumentsRequest, requestOptions?: DocumentsClient.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
     private __thumbnail;
     /**
-     * @param {core.file.Uploadable} uploadable
-     * @param {string} tenantId
-     * @param {string} id
+     * This bounded origin-mediated fallback must only be used after documents.init returns upload.kind=proxy. Auto mode prefers a presigned object-store PUT whenever available.
+     *
+     * @param {CloudPDF.UploadProxyDocumentsRequest} request
      * @param {DocumentsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link CloudPDF.BadRequestError}
+     * @throws {@link CloudPDF.ConflictError}
      * @throws {@link errors.CloudPDFError}
      * @throws {@link errors.CloudPDFTimeoutError}
+     *
+     * @example
+     *     import { createReadStream } from "fs";
+     *     await client.documents.uploadProxy({
+     *         file: fs.createReadStream("/path/to/your/file"),
+     *         tenantId: "tenantId",
+     *         id: "id"
+     *     })
+     */
+    uploadProxy(request: CloudPDF.UploadProxyDocumentsRequest, requestOptions?: DocumentsClient.RequestOptions): core.HttpResponsePromise<CloudPDF.DocumentsUploadProxy200Response>;
+    private __uploadProxy;
+    /**
+     * Default mode is synchronous and bounded: the response returns only after the transfer verified and committed (or failed). mode=async (connection sources only) answers 202 immediately and an in-process worker performs the transfer with leased, fenced retries; poll the document until ready/failed. The deployment import policy gates scheme, network range, and size; sources must declare a length. CloudPDF copies and owns the bytes — the source is never referenced in place. A 502 marks a retryable upstream failure: retry with the same idempotencyKey to resume the same document. URL sources are capabilities and never echoed back. Connection sources name operator-registered storage (bucket/prefix scope, allowed credential classes, and tenant bindings are deployment configuration); `revision` is provider-interpreted (S3 VersionId, GCS generation, Azure version id).
+     *
+     * @param {CloudPDF.DocumentsImportFromRequest} request
+     * @param {DocumentsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link CloudPDF.BadRequestError}
+     * @throws {@link CloudPDF.ForbiddenError}
+     * @throws {@link CloudPDF.BadGatewayError}
+     * @throws {@link errors.CloudPDFError}
+     * @throws {@link errors.CloudPDFTimeoutError}
+     *
+     * @example
+     *     await client.documents.importFrom({
+     *         tenantId: "tenantId",
+     *         source: {
+     *             kind: "url",
+     *             url: "url"
+     *         }
+     *     })
      */
-    uploadDirect(uploadable: core.file.Uploadable, tenantId: string, id: string, requestOptions?: DocumentsClient.RequestOptions): core.HttpResponsePromise<CloudPDF.DocumentsUploadDirect200Response>;
-    private __uploadDirect;
+    importFrom(request: CloudPDF.DocumentsImportFromRequest, requestOptions?: DocumentsClient.RequestOptions): core.HttpResponsePromise<CloudPDF.DocumentsImportFrom200Response>;
+    private __importFrom;
     /**
      * @param {CloudPDF.DocumentsInitRequest} request
      * @param {DocumentsClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/cjs/api/resources/documents/client/Client.js

@@ -387,33 +387,110 @@ class DocumentsClient {
         });
     }
     /**
-     * @param {core.file.Uploadable} uploadable
-     * @param {string} tenantId
-     * @param {string} id
+     * This bounded origin-mediated fallback must only be used after documents.init returns upload.kind=proxy. Auto mode prefers a presigned object-store PUT whenever available.
+     *
+     * @param {CloudPDF.UploadProxyDocumentsRequest} request
+     * @param {DocumentsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link CloudPDF.BadRequestError}
+     * @throws {@link CloudPDF.ConflictError}
+     * @throws {@link errors.CloudPDFError}
+     * @throws {@link errors.CloudPDFTimeoutError}
+     *
+     * @example
+     *     import { createReadStream } from "fs";
+     *     await client.documents.uploadProxy({
+     *         file: fs.createReadStream("/path/to/your/file"),
+     *         tenantId: "tenantId",
+     *         id: "id"
+     *     })
+     */
+    uploadProxy(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__uploadProxy(request, requestOptions));
+    }
+    __uploadProxy(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 = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({}, _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/tenants/${core.url.encodePathParam(request.tenantId)}/documents/${core.url.encodePathParam(request.id)}/upload-proxy`),
+                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 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 (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v1/tenants/{tenantId}/documents/{id}/upload-proxy");
+        });
+    }
+    /**
+     * Default mode is synchronous and bounded: the response returns only after the transfer verified and committed (or failed). mode=async (connection sources only) answers 202 immediately and an in-process worker performs the transfer with leased, fenced retries; poll the document until ready/failed. The deployment import policy gates scheme, network range, and size; sources must declare a length. CloudPDF copies and owns the bytes — the source is never referenced in place. A 502 marks a retryable upstream failure: retry with the same idempotencyKey to resume the same document. URL sources are capabilities and never echoed back. Connection sources name operator-registered storage (bucket/prefix scope, allowed credential classes, and tenant bindings are deployment configuration); `revision` is provider-interpreted (S3 VersionId, GCS generation, Azure version id).
+     *
+     * @param {CloudPDF.DocumentsImportFromRequest} request
      * @param {DocumentsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link CloudPDF.BadRequestError}
+     * @throws {@link CloudPDF.ForbiddenError}
+     * @throws {@link CloudPDF.BadGatewayError}
      * @throws {@link errors.CloudPDFError}
      * @throws {@link errors.CloudPDFTimeoutError}
+     *
+     * @example
+     *     await client.documents.importFrom({
+     *         tenantId: "tenantId",
+     *         source: {
+     *             kind: "url",
+     *             url: "url"
+     *         }
+     *     })
      */
-    uploadDirect(uploadable, tenantId, id, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__uploadDirect(uploadable, tenantId, id, requestOptions));
+    importFrom(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__importFrom(request, requestOptions));
     }
-    __uploadDirect(uploadable, tenantId, id, requestOptions) {
+    __importFrom(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h;
-            const _binaryUploadRequest = yield core.file.toBinaryUploadRequest(uploadable);
+            const { tenantId } = request, _body = __rest(request, ["tenantId"]);
             const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, _binaryUploadRequest.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.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/tenants/${core.url.encodePathParam(tenantId)}/documents/${core.url.encodePathParam(id)}/upload-direct`),
+                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/tenants/${core.url.encodePathParam(tenantId)}/documents/import`),
                 method: "POST",
                 headers: _headers,
-                contentType: "application/pdf",
+                contentType: "application/json",
                 queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
-                requestType: "bytes",
-                duplex: "half",
-                body: _binaryUploadRequest.body,
+                requestType: "json",
+                body: (0, requestBody_js_1.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,
@@ -430,6 +507,10 @@ class DocumentsClient {
                 switch (_response.error.statusCode) {
                     case 400:
                         throw new CloudPDF.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new CloudPDF.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 502:
+                        throw new CloudPDF.BadGatewayError(_response.error.body, _response.rawResponse);
                     default:
                         throw new errors.CloudPDFError({
                             statusCode: _response.error.statusCode,
@@ -438,7 +519,7 @@ class DocumentsClient {
                         });
                 }
             }
-            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v1/tenants/{tenantId}/documents/{id}/upload-direct");
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v1/tenants/{tenantId}/documents/import");
         });
     }
     /**

package/dist/cjs/api/resources/documents/client/requests/DocumentsImportFromRequest.d.ts

@@ -0,0 +1,49 @@
+import type * as CloudPDF from "../../../../index.js";
+/**
+ * @example
+ *     {
+ *         tenantId: "tenantId",
+ *         source: {
+ *             kind: "url",
+ *             url: "url"
+ *         }
+ *     }
+ */
+export interface DocumentsImportFromRequest {
+    tenantId: string;
+    /** Where CloudPDF pulls the bytes from. The two shapes differ in WHO supplies the authority to read, not in which storage vendor holds the file. */
+    source: CloudPDF.DocumentsImportFromRequestSource;
+    /** Integrity pins, enforced when present. When absent, the server-observed values become authoritative. */
+    expected?: DocumentsImportFromRequest.Expected;
+    metadata?: Record<string, unknown>;
+    /** Retrying with the same key resumes the same document rather than importing a second copy — including after a 502. */
+    idempotencyKey?: string;
+    /** always-create (default) creates a new document every time. reuse-existing returns a document that already holds the same content instead of storing it twice. */
+    dedupMode?: DocumentsImportFromRequest.DedupMode;
+    docId?: string;
+    /** sync (default) holds the response open for the whole transfer. async answers 202 with the document pending and transfers in the background; it requires a connection source, and filesystem connections additionally require expected.sha256. */
+    mode?: DocumentsImportFromRequest.Mode;
+}
+export declare namespace DocumentsImportFromRequest {
+    /**
+     * Integrity pins, enforced when present. When absent, the server-observed values become authoritative.
+     */
+    interface Expected {
+        /** Checked against the source's declared Content-Length before the transfer. */
+        sizeBytes?: number | undefined;
+        /** Checked against the server-observed digest after the transfer. Required when dedupMode is reuse-existing. */
+        sha256?: string | undefined;
+    }
+    /** always-create (default) creates a new document every time. reuse-existing returns a document that already holds the same content instead of storing it twice. */
+    const DedupMode: {
+        readonly AlwaysCreate: "always-create";
+        readonly ReuseExisting: "reuse-existing";
+    };
+    type DedupMode = (typeof DedupMode)[keyof typeof DedupMode];
+    /** sync (default) holds the response open for the whole transfer. async answers 202 with the document pending and transfers in the background; it requires a connection source, and filesystem connections additionally require expected.sha256. */
+    const Mode: {
+        readonly Sync: "sync";
+        readonly Async: "async";
+    };
+    type Mode = (typeof Mode)[keyof typeof Mode];
+}

package/dist/cjs/api/resources/documents/client/requests/DocumentsImportFromRequest.js

@@ -0,0 +1,17 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentsImportFromRequest = void 0;
+var DocumentsImportFromRequest;
+(function (DocumentsImportFromRequest) {
+    /** always-create (default) creates a new document every time. reuse-existing returns a document that already holds the same content instead of storing it twice. */
+    DocumentsImportFromRequest.DedupMode = {
+        AlwaysCreate: "always-create",
+        ReuseExisting: "reuse-existing",
+    };
+    /** sync (default) holds the response open for the whole transfer. async answers 202 with the document pending and transfers in the background; it requires a connection source, and filesystem connections additionally require expected.sha256. */
+    DocumentsImportFromRequest.Mode = {
+        Sync: "sync",
+        Async: "async",
+    };
+})(DocumentsImportFromRequest || (exports.DocumentsImportFromRequest = DocumentsImportFromRequest = {}));

package/dist/cjs/api/resources/documents/client/requests/DocumentsInitRequest.d.ts

@@ -12,14 +12,23 @@ export interface DocumentsInitRequest {
     contentSha256: string;
     metadata?: Record<string, unknown>;
     idempotencyKey?: string;
+    /** always-create (default) creates a new document every time. reuse-existing returns a document that already holds the same content instead of storing it twice. */
     dedupMode?: DocumentsInitRequest.DedupMode;
     docId?: string;
     uploadTtlSec?: number;
+    uploadPreference?: DocumentsInitRequest.UploadPreference;
 }
 export declare namespace DocumentsInitRequest {
+    /** always-create (default) creates a new document every time. reuse-existing returns a document that already holds the same content instead of storing it twice. */
     const DedupMode: {
         readonly AlwaysCreate: "always-create";
         readonly ReuseExisting: "reuse-existing";
     };
     type DedupMode = (typeof DedupMode)[keyof typeof DedupMode];
+    const UploadPreference: {
+        readonly Auto: "auto";
+        readonly Presigned: "presigned";
+        readonly Proxy: "proxy";
+    };
+    type UploadPreference = (typeof UploadPreference)[keyof typeof UploadPreference];
 }