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

package/README.md

@@ -45,8 +45,8 @@ Instantiate and use the client with the following:
 import { CloudPDFClient } from "@cloudpdf/sdk";
 
 const client = new CloudPDFClient({ baseUrl: "YOUR_BASE_URL", token: "YOUR_TOKEN" });
-await client.tenants.create({
-    id: "id"
+await client.shares.exchange({
+    shareToken: "shareToken"
 });
 ```
 
@@ -72,7 +72,7 @@ will be thrown.
 import { CloudPDFError } from "@cloudpdf/sdk";
 
 try {
-    await client.tenants.create(...);
+    await client.shares.exchange(...);
 } catch (err) {
     if (err instanceof CloudPDFError) {
         console.log(err.statusCode);
@@ -85,47 +85,24 @@ try {
 
 ## File Uploads
 
-You can upload files using the client:
+Use the high-level upload workflow. It computes the content hash before init,
+prefers a direct presigned object-store upload, and commits only after a
+successful transfer:
 
 ```typescript
-import { createReadStream } from "fs";
-
-await client.documents.uploadDirect(createReadStream("path/to/file"), ...);
-await client.documents.uploadDirect(new ReadableStream(), ...);
-await client.documents.uploadDirect(Buffer.from('binary data'), ...);
-await client.documents.uploadDirect(new Blob(['binary data'], { type: 'audio/mpeg' }), ...);
-await client.documents.uploadDirect(new File(['binary data'], 'file.mp3'), ...);
-await client.documents.uploadDirect(new ArrayBuffer(8), ...);
-await client.documents.uploadDirect(new Uint8Array([0, 1, 2]), ...);
-```
-The client accepts a variety of types for file upload parameters:
-* Stream types: `fs.ReadStream`, `stream.Readable`, and `ReadableStream`
-* Buffered types: `Buffer`, `Blob`, `File`, `ArrayBuffer`, `ArrayBufferView`, and `Uint8Array`
-
-### Metadata
-
-You can configure metadata when uploading a file:
-```typescript
-const file: Uploadable.WithMetadata = {
-    data: createReadStream("path/to/file"),
-    filename: "my-file",       // optional
-    contentType: "audio/mpeg", // optional
-    contentLength: 1949,       // optional
-};
-```
-
-Alternatively, you can upload a file directly from a file path:
-```typescript
-const file : Uploadable.FromPath = {
-    path: "path/to/file",
-    filename: "my-file",        // optional
-    contentType: "audio/mpeg",  // optional
-    contentLength: 1949,        // optional
-};
+const result = await client.uploads.create({
+    tenantId: "tenant_123",
+    source: { path: "invoice.pdf" },
+    uploadPreference: "auto",
+    onProgress: (loaded, total) => console.log(`${loaded}/${total}`),
+});
 ```
 
-The metadata is used to set the `Content-Length`, `Content-Type`, and `Content-Disposition` headers. If not provided, the client will attempt to determine them automatically.
-For example, `fs.ReadStream` has a `path` property which the SDK uses to retrieve the file size from the filesystem without loading it into memory.
+`source` accepts a `Uint8Array`, `ArrayBuffer`, `Blob`, `{ path: string }`, or
+a reopenable source with a known size and SHA-256. An unknown one-shot stream is
+intentionally rejected: the server pins size and hash during init, before any
+bytes are transferred. Set `uploadPreference: "proxy"` only when the server is
+configured to allow its bounded multipart fallback.
 
 
 ## Binary Response
@@ -543,7 +520,7 @@ const client = new CloudPDFClient({
     }
 });
 
-const response = await client.tenants.create(..., {
+const response = await client.shares.exchange(..., {
     headers: {
         'X-Custom-Header': 'custom value'
     }
@@ -555,7 +532,7 @@ const response = await client.tenants.create(..., {
 If you would like to send additional query string parameters as part of the request, use the `queryParams` request option.
 
 ```typescript
-const response = await client.tenants.create(..., {
+const response = await client.shares.exchange(..., {
     queryParams: {
         'customQueryParamKey': 'custom query param value'
     }
@@ -585,7 +562,7 @@ Which status codes are retried depends on the `retryStatusCodes` generator confi
 Use the `maxRetries` request option to configure this behavior.
 
 ```typescript
-const response = await client.tenants.create(..., {
+const response = await client.shares.exchange(..., {
     maxRetries: 0 // override maxRetries at the request level
 });
 ```
@@ -595,7 +572,7 @@ const response = await client.tenants.create(..., {
 The SDK defaults to a 60 second timeout. Use the `timeoutInSeconds` option to configure this behavior.
 
 ```typescript
-const response = await client.tenants.create(..., {
+const response = await client.shares.exchange(..., {
     timeoutInSeconds: 30 // override timeout to 30s
 });
 ```
@@ -606,7 +583,7 @@ The SDK allows users to abort requests at any point by passing in an abort signa
 
 ```typescript
 const controller = new AbortController();
-const response = await client.tenants.create(..., {
+const response = await client.shares.exchange(..., {
     abortSignal: controller.signal
 });
 controller.abort(); // aborts the request
@@ -618,7 +595,7 @@ The SDK provides access to raw response data, including headers, through the `.w
 The `.withRawResponse()` method returns a promise that results to an object with a `data` and a `rawResponse` property.
 
 ```typescript
-const { data, rawResponse } = await client.tenants.create(...).withRawResponse();
+const { data, rawResponse } = await client.shares.exchange(...).withRawResponse();
 
 console.log(data);
 console.log(rawResponse.headers['X-My-Header']);

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@cloudpdf/sdk",
-        "X-Fern-SDK-Version": "3.0.0-next.1",
-        "User-Agent": "@cloudpdf/sdk/3.0.0-next.1",
+        "X-Fern-SDK-Version": "3.0.0-next.2",
+        "User-Agent": "@cloudpdf/sdk/3.0.0-next.2",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/cjs/Client.d.ts

@@ -1,6 +1,7 @@
 import { DeploymentClient } from "./api/resources/deployment/client/Client.js";
 import { DocClient } from "./api/resources/doc/client/Client.js";
 import { DocumentsClient } from "./api/resources/documents/client/Client.js";
+import { SharesClient } from "./api/resources/shares/client/Client.js";
 import { TenantsClient } from "./api/resources/tenants/client/Client.js";
 import { TokensClient } from "./api/resources/tokens/client/Client.js";
 import type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.js";
@@ -15,12 +16,14 @@ export declare class CloudPDFClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<CloudPDFClient.Options>;
     protected _deployment: DeploymentClient | undefined;
     protected _doc: DocClient | undefined;
+    protected _shares: SharesClient | undefined;
     protected _tenants: TenantsClient | undefined;
     protected _documents: DocumentsClient | undefined;
     protected _tokens: TokensClient | undefined;
     constructor(options: CloudPDFClient.Options);
     get deployment(): DeploymentClient;
     get doc(): DocClient;
+    get shares(): SharesClient;
     get tenants(): TenantsClient;
     get documents(): DocumentsClient;
     get tokens(): TokensClient;

package/dist/cjs/Client.js

@@ -47,8 +47,9 @@ exports.CloudPDFClient = void 0;
 const Client_js_1 = require("./api/resources/deployment/client/Client.js");
 const Client_js_2 = require("./api/resources/doc/client/Client.js");
 const Client_js_3 = require("./api/resources/documents/client/Client.js");
-const Client_js_4 = require("./api/resources/tenants/client/Client.js");
-const Client_js_5 = require("./api/resources/tokens/client/Client.js");
+const Client_js_4 = require("./api/resources/shares/client/Client.js");
+const Client_js_5 = require("./api/resources/tenants/client/Client.js");
+const Client_js_6 = require("./api/resources/tokens/client/Client.js");
 const BaseClient_js_1 = require("./BaseClient.js");
 const core = __importStar(require("./core/index.js"));
 class CloudPDFClient {
@@ -63,9 +64,13 @@ class CloudPDFClient {
         var _a;
         return ((_a = this._doc) !== null && _a !== void 0 ? _a : (this._doc = new Client_js_2.DocClient(this._options)));
     }
+    get shares() {
+        var _a;
+        return ((_a = this._shares) !== null && _a !== void 0 ? _a : (this._shares = new Client_js_4.SharesClient(this._options)));
+    }
     get tenants() {
         var _a;
-        return ((_a = this._tenants) !== null && _a !== void 0 ? _a : (this._tenants = new Client_js_4.TenantsClient(this._options)));
+        return ((_a = this._tenants) !== null && _a !== void 0 ? _a : (this._tenants = new Client_js_5.TenantsClient(this._options)));
     }
     get documents() {
         var _a;
@@ -73,7 +78,7 @@ class CloudPDFClient {
     }
     get tokens() {
         var _a;
-        return ((_a = this._tokens) !== null && _a !== void 0 ? _a : (this._tokens = new Client_js_5.TokensClient(this._options)));
+        return ((_a = this._tokens) !== null && _a !== void 0 ? _a : (this._tokens = new Client_js_6.TokensClient(this._options)));
     }
     /**
      * Make a passthrough request using the SDK's configured auth, retry, logging, etc.

package/dist/cjs/CloudPDFClient.d.ts

@@ -0,0 +1,20 @@
+import { CloudPDFClient as GeneratedCloudPDFClient } from "./Client.js";
+import type * as CloudPDF from "./api/index.js";
+import { Uploads } from "./uploads/Uploads.js";
+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/cjs/CloudPDFClient.js

@@ -0,0 +1,39 @@
+"use strict";
+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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CloudPDFClient = void 0;
+const Client_js_1 = require("./Client.js");
+const Uploads_js_1 = require("./uploads/Uploads.js");
+/** Generated protocol client plus CloudPDF's handwritten workflow layer. */
+class CloudPDFClient extends Client_js_1.CloudPDFClient {
+    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_js_1.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); }),
+        });
+    }
+}
+exports.CloudPDFClient = CloudPDFClient;

package/dist/cjs/api/errors/ConflictError.d.ts

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

package/dist/cjs/api/errors/ConflictError.js

@@ -0,0 +1,54 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConflictError = void 0;
+const errors = __importStar(require("../../errors/index.js"));
+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";
+    }
+}
+exports.ConflictError = ConflictError;

package/dist/cjs/api/errors/GoneError.d.ts

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

package/dist/cjs/api/errors/GoneError.js

@@ -0,0 +1,54 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GoneError = void 0;
+const errors = __importStar(require("../../errors/index.js"));
+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";
+    }
+}
+exports.GoneError = GoneError;

package/dist/cjs/api/errors/UnprocessableEntityError.d.ts

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

package/dist/cjs/api/errors/UnprocessableEntityError.js

@@ -0,0 +1,54 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnprocessableEntityError = void 0;
+const errors = __importStar(require("../../errors/index.js"));
+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";
+    }
+}
+exports.UnprocessableEntityError = UnprocessableEntityError;

package/dist/cjs/api/errors/index.d.ts

@@ -1,3 +1,6 @@
 export * from "./BadRequestError.js";
+export * from "./ConflictError.js";
 export * from "./ForbiddenError.js";
+export * from "./GoneError.js";
 export * from "./NotFoundError.js";
+export * from "./UnprocessableEntityError.js";

package/dist/cjs/api/errors/index.js

@@ -15,5 +15,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./BadRequestError.js"), exports);
+__exportStar(require("./ConflictError.js"), exports);
 __exportStar(require("./ForbiddenError.js"), exports);
+__exportStar(require("./GoneError.js"), exports);
 __exportStar(require("./NotFoundError.js"), exports);
+__exportStar(require("./UnprocessableEntityError.js"), exports);

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

@@ -93,17 +93,26 @@ 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"
+     *     })
      */
-    uploadDirect(uploadable: core.file.Uploadable, tenantId: string, id: string, requestOptions?: DocumentsClient.RequestOptions): core.HttpResponsePromise<CloudPDF.DocumentsUploadDirect200Response>;
-    private __uploadDirect;
+    uploadProxy(request: CloudPDF.UploadProxyDocumentsRequest, requestOptions?: DocumentsClient.RequestOptions): core.HttpResponsePromise<CloudPDF.DocumentsUploadProxy200Response>;
+    private __uploadProxy;
     /**
      * @param {CloudPDF.DocumentsInitRequest} request
      * @param {DocumentsClient.RequestOptions} requestOptions - Request-specific configuration.

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

@@ -387,33 +387,43 @@ 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"
+     *     })
      */
-    uploadDirect(uploadable, tenantId, id, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__uploadDirect(uploadable, tenantId, id, requestOptions));
+    uploadProxy(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__uploadProxy(request, requestOptions));
     }
-    __uploadDirect(uploadable, tenantId, id, requestOptions) {
+    __uploadProxy(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 _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, _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, (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(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(request.tenantId)}/documents/${core.url.encodePathParam(request.id)}/upload-proxy`),
                 method: "POST",
                 headers: _headers,
-                contentType: "application/pdf",
                 queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
-                requestType: "bytes",
-                duplex: "half",
-                body: _binaryUploadRequest.body,
+                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,
@@ -430,6 +440,8 @@ class DocumentsClient {
                 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,
@@ -438,7 +450,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/{id}/upload-proxy");
         });
     }
     /**

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

@@ -15,6 +15,7 @@ export interface DocumentsInitRequest {
     dedupMode?: DocumentsInitRequest.DedupMode;
     docId?: string;
     uploadTtlSec?: number;
+    uploadPreference?: DocumentsInitRequest.UploadPreference;
 }
 export declare namespace DocumentsInitRequest {
     const DedupMode: {
@@ -22,4 +23,10 @@ export declare namespace DocumentsInitRequest {
         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];
 }

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

@@ -8,4 +8,9 @@ var DocumentsInitRequest;
         AlwaysCreate: "always-create",
         ReuseExisting: "reuse-existing",
     };
+    DocumentsInitRequest.UploadPreference = {
+        Auto: "auto",
+        Presigned: "presigned",
+        Proxy: "proxy",
+    };
 })(DocumentsInitRequest || (exports.DocumentsInitRequest = DocumentsInitRequest = {}));

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

@@ -0,0 +1,14 @@
+import type * as core from "../../../../../core/index.js";
+/**
+ * @example
+ *     {
+ *         file: fs.createReadStream("/path/to/your/file"),
+ *         tenantId: "tenantId",
+ *         id: "id"
+ *     }
+ */
+export interface UploadProxyDocumentsRequest {
+    tenantId: string;
+    id: string;
+    file: core.file.Uploadable;
+}

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

@@ -5,3 +5,4 @@ export type { DownloadDocumentsRequest } from "./DownloadDocumentsRequest.js";
 export type { GetDocumentsRequest } from "./GetDocumentsRequest.js";
 export type { ListDocumentsRequest } from "./ListDocumentsRequest.js";
 export type { ThumbnailDocumentsRequest } from "./ThumbnailDocumentsRequest.js";
+export type { UploadProxyDocumentsRequest } from "./UploadProxyDocumentsRequest.js";

package/dist/cjs/api/resources/index.d.ts

@@ -4,6 +4,8 @@ export * as doc from "./doc/index.js";
 export * from "./documents/client/requests/index.js";
 export * as documents from "./documents/index.js";
 export * from "./documents/types/index.js";
+export * from "./shares/client/requests/index.js";
+export * as shares from "./shares/index.js";
 export * from "./tenants/client/requests/index.js";
 export * as tenants from "./tenants/index.js";
 export * from "./tokens/client/requests/index.js";