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

package/dist/cjs/core/form-data-utils/FormDataWrapper.d.ts

@@ -0,0 +1,15 @@
+import { type Uploadable } from "../../core/file/index.js";
+interface FormDataRequest<Body> {
+    body: Body;
+    headers: Record<string, string>;
+    duplex?: "half";
+}
+export declare function newFormData(): Promise<FormDataWrapper>;
+export declare class FormDataWrapper {
+    private fd;
+    setup(): Promise<void>;
+    append(key: string, value: unknown): void;
+    appendFile(key: string, value: Uploadable): Promise<void>;
+    getRequest(): FormDataRequest<FormData>;
+}
+export {};

package/dist/cjs/core/form-data-utils/FormDataWrapper.js

@@ -0,0 +1,188 @@
+"use strict";
+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;
+    };
+})();
+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());
+    });
+};
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FormDataWrapper = void 0;
+exports.newFormData = newFormData;
+const index_js_1 = require("../../core/file/index.js");
+const json_js_1 = require("../../core/json.js");
+const index_js_2 = require("../runtime/index.js");
+function newFormData() {
+    return __awaiter(this, void 0, void 0, function* () {
+        return new FormDataWrapper();
+    });
+}
+class FormDataWrapper {
+    constructor() {
+        this.fd = new FormData();
+    }
+    setup() {
+        return __awaiter(this, void 0, void 0, function* () {
+            // noop
+        });
+    }
+    append(key, value) {
+        this.fd.append(key, String(value));
+    }
+    appendFile(key, value) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (value == null) {
+                throw new Error(`File upload for "${key}" received ${value === null ? "null" : "undefined"}. The generated code should not call appendFile with null/undefined — check that optional file fields are guarded before this call.`);
+            }
+            const { data, filename, contentType } = yield (0, index_js_1.toMultipartDataPart)(value);
+            const blob = yield convertToBlob(data, contentType);
+            if (filename) {
+                this.fd.append(key, blob, filename);
+            }
+            else {
+                this.fd.append(key, blob);
+            }
+        });
+    }
+    getRequest() {
+        return {
+            body: this.fd,
+            headers: {},
+            duplex: "half",
+        };
+    }
+}
+exports.FormDataWrapper = FormDataWrapper;
+function isStreamLike(value) {
+    return typeof value === "object" && value != null && ("read" in value || "pipe" in value);
+}
+function isReadableStream(value) {
+    return typeof value === "object" && value != null && "getReader" in value;
+}
+function isBuffer(value) {
+    return typeof Buffer !== "undefined" && Buffer.isBuffer && Buffer.isBuffer(value);
+}
+function isArrayBufferView(value) {
+    return ArrayBuffer.isView(value);
+}
+function streamToBuffer(stream) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, stream_1, stream_1_1;
+        var _b, e_1, _c, _d;
+        if (index_js_2.RUNTIME.type === "node") {
+            const { Readable } = yield Promise.resolve().then(() => __importStar(require("stream")));
+            if (stream instanceof Readable) {
+                const chunks = [];
+                try {
+                    for (_a = true, stream_1 = __asyncValues(stream); stream_1_1 = yield stream_1.next(), _b = stream_1_1.done, !_b; _a = true) {
+                        _d = stream_1_1.value;
+                        _a = false;
+                        const chunk = _d;
+                        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+                    }
+                }
+                catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                finally {
+                    try {
+                        if (!_a && !_b && (_c = stream_1.return)) yield _c.call(stream_1);
+                    }
+                    finally { if (e_1) throw e_1.error; }
+                }
+                return Buffer.concat(chunks);
+            }
+        }
+        if (isReadableStream(stream)) {
+            const reader = stream.getReader();
+            const chunks = [];
+            try {
+                while (true) {
+                    const { done, value } = yield reader.read();
+                    if (done)
+                        break;
+                    chunks.push(value);
+                }
+            }
+            finally {
+                reader.releaseLock();
+            }
+            const totalLength = chunks.reduce((sum, chunk) => sum + chunk.length, 0);
+            const result = new Uint8Array(totalLength);
+            let offset = 0;
+            for (const chunk of chunks) {
+                result.set(chunk, offset);
+                offset += chunk.length;
+            }
+            return Buffer.from(result);
+        }
+        throw new Error(`Unsupported stream type: ${typeof stream}. Expected Node.js Readable stream or Web ReadableStream.`);
+    });
+}
+function convertToBlob(value, contentType) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (isStreamLike(value) || isReadableStream(value)) {
+            const buffer = yield streamToBuffer(value);
+            return new Blob([buffer], { type: contentType });
+        }
+        if (value instanceof Blob) {
+            return value;
+        }
+        if (isBuffer(value)) {
+            return new Blob([value], { type: contentType });
+        }
+        if (value instanceof ArrayBuffer) {
+            return new Blob([value], { type: contentType });
+        }
+        if (isArrayBufferView(value)) {
+            return new Blob([value], { type: contentType });
+        }
+        if (typeof value === "string") {
+            return new Blob([value], { type: contentType });
+        }
+        if (typeof value === "object" && value !== null) {
+            return new Blob([(0, json_js_1.toJson)(value)], { type: contentType !== null && contentType !== void 0 ? contentType : "application/json" });
+        }
+        return new Blob([String(value)], { type: contentType });
+    });
+}

package/dist/cjs/core/form-data-utils/encodeAsFormParameter.d.ts

@@ -0,0 +1 @@
+export declare function encodeAsFormParameter(value: unknown): Record<string, string>;

package/dist/cjs/core/form-data-utils/encodeAsFormParameter.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeAsFormParameter = encodeAsFormParameter;
+const qs_js_1 = require("../url/qs.js");
+function encodeAsFormParameter(value) {
+    const stringified = (0, qs_js_1.toQueryString)(value, { encode: false });
+    const keyValuePairs = stringified.split("&").map((pair) => {
+        const [key, value] = pair.split("=");
+        return [key, value];
+    });
+    return Object.fromEntries(keyValuePairs);
+}

package/dist/cjs/core/form-data-utils/index.d.ts

@@ -0,0 +1,2 @@
+export { encodeAsFormParameter } from "./encodeAsFormParameter.js";
+export * from "./FormDataWrapper.js";

package/dist/cjs/core/form-data-utils/index.js

@@ -0,0 +1,20 @@
+"use strict";
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeAsFormParameter = void 0;
+var encodeAsFormParameter_js_1 = require("./encodeAsFormParameter.js");
+Object.defineProperty(exports, "encodeAsFormParameter", { enumerable: true, get: function () { return encodeAsFormParameter_js_1.encodeAsFormParameter; } });
+__exportStar(require("./FormDataWrapper.js"), exports);

package/dist/cjs/core/index.d.ts

@@ -2,6 +2,7 @@ export * from "./auth/index.js";
 export * from "./base64.js";
 export * from "./fetcher/index.js";
 export * as file from "./file/index.js";
+export * from "./form-data-utils/index.js";
 export * as logging from "./logging/index.js";
 export * from "./runtime/index.js";
 export * as url from "./url/index.js";

package/dist/cjs/core/index.js

@@ -41,6 +41,7 @@ __exportStar(require("./auth/index.js"), exports);
 __exportStar(require("./base64.js"), exports);
 __exportStar(require("./fetcher/index.js"), exports);
 exports.file = __importStar(require("./file/index.js"));
+__exportStar(require("./form-data-utils/index.js"), exports);
 exports.logging = __importStar(require("./logging/index.js"));
 __exportStar(require("./runtime/index.js"), exports);
 exports.url = __importStar(require("./url/index.js"));

package/dist/cjs/index.d.ts

@@ -1,5 +1,7 @@
 export * as CloudPDF from "./api/index.js";
 export type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.js";
-export { CloudPDFClient } from "./Client.js";
+export { CloudPDFClient } from "./CloudPDFClient.js";
+export { CloudPDFClient as GeneratedCloudPDFClient } from "./Client.js";
 export { CloudPDFError, CloudPDFTimeoutError } from "./errors/index.js";
 export * from "./exports.js";
+export * from "./uploads/index.js";

package/dist/cjs/index.js

@@ -36,11 +36,14 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CloudPDFTimeoutError = exports.CloudPDFError = exports.CloudPDFClient = exports.CloudPDF = void 0;
+exports.CloudPDFTimeoutError = exports.CloudPDFError = exports.GeneratedCloudPDFClient = exports.CloudPDFClient = exports.CloudPDF = void 0;
 exports.CloudPDF = __importStar(require("./api/index.js"));
+var CloudPDFClient_js_1 = require("./CloudPDFClient.js");
+Object.defineProperty(exports, "CloudPDFClient", { enumerable: true, get: function () { return CloudPDFClient_js_1.CloudPDFClient; } });
 var Client_js_1 = require("./Client.js");
-Object.defineProperty(exports, "CloudPDFClient", { enumerable: true, get: function () { return Client_js_1.CloudPDFClient; } });
+Object.defineProperty(exports, "GeneratedCloudPDFClient", { enumerable: true, get: function () { return Client_js_1.CloudPDFClient; } });
 var index_js_1 = require("./errors/index.js");
 Object.defineProperty(exports, "CloudPDFError", { enumerable: true, get: function () { return index_js_1.CloudPDFError; } });
 Object.defineProperty(exports, "CloudPDFTimeoutError", { enumerable: true, get: function () { return index_js_1.CloudPDFTimeoutError; } });
 __exportStar(require("./exports.js"), exports);
+__exportStar(require("./uploads/index.js"), exports);

package/dist/cjs/uploads/Uploads.d.ts

@@ -0,0 +1,7 @@
+import type { UploadCreateInput, UploadCreateResult, UploadProtocol } from "./types.js";
+/** High-level, integrity-pinned `init -> transfer -> commit` workflow. */
+export declare class Uploads<Document = unknown> {
+    private readonly protocol;
+    constructor(protocol: UploadProtocol);
+    create(input: UploadCreateInput): Promise<UploadCreateResult<Document>>;
+}

package/dist/cjs/uploads/Uploads.js

@@ -0,0 +1,78 @@
+"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.Uploads = void 0;
+const source_js_1 = require("./source.js");
+/** High-level, integrity-pinned `init -> transfer -> commit` workflow. */
+class Uploads {
+    constructor(protocol) {
+        this.protocol = protocol;
+    }
+    create(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            const source = yield (0, source_js_1.prepareUploadSource)(input.source);
+            const requestOptions = { abortSignal: input.signal };
+            const init = (yield this.protocol.init({
+                tenantId: input.tenantId,
+                contentLength: source.size,
+                contentSha256: source.sha256,
+                metadata: input.metadata,
+                idempotencyKey: input.idempotencyKey,
+                dedupMode: input.dedupMode,
+                docId: input.docId,
+                uploadTtlSec: input.uploadTtlSec,
+                uploadPreference: input.uploadPreference,
+            }, requestOptions));
+            if (init.tag === "deduped") {
+                (_a = input.onProgress) === null || _a === void 0 ? void 0 : _a.call(input, source.size, source.size);
+                return { tag: init.tag, document: init.document };
+            }
+            if (!init.upload)
+                throw new Error("CloudPDF init response omitted upload access");
+            (_b = input.onProgress) === null || _b === void 0 ? void 0 : _b.call(input, 0, source.size);
+            if (init.upload.kind === "presigned") {
+                const body = yield source.open();
+                const response = yield this.protocol.presigned(init.upload.presigned.url, Object.assign({ method: init.upload.presigned.method, 
+                    // These are the exact signed headers. In particular, no SDK
+                    // Authorization header is added to an object-store request.
+                    headers: init.upload.presigned.headers, body, signal: input.signal }, (isStreamBody(body) ? { duplex: "half" } : {})));
+                if (!response.ok) {
+                    const detail = yield response.text().catch(() => "");
+                    throw new Error(`presigned upload failed: ${response.status} ${response.statusText} ${detail}`.trim());
+                }
+            }
+            else {
+                const form = new FormData();
+                form.append("file", yield source.openProxyBlob(), source.filename);
+                const response = yield this.protocol.proxy(init.upload.url, form, {
+                    abortSignal: input.signal,
+                    maxRetries: 0,
+                });
+                if (!response.ok) {
+                    const detail = yield response.text().catch(() => "");
+                    throw new Error(`proxy upload failed: ${response.status} ${response.statusText} ${detail}`.trim());
+                }
+            }
+            (_c = input.onProgress) === null || _c === void 0 ? void 0 : _c.call(input, source.size, source.size);
+            const committed = (yield this.protocol.commit({
+                tenantId: input.tenantId,
+                id: init.document.id,
+                sha256: source.sha256,
+            }, requestOptions));
+            return { tag: init.tag, document: committed.document };
+        });
+    }
+}
+exports.Uploads = Uploads;
+function isStreamBody(body) {
+    return typeof body === "object" && body !== null && ("pipe" in body || "getReader" in body);
+}

package/dist/cjs/uploads/index.d.ts

@@ -0,0 +1,2 @@
+export { Uploads } from "./Uploads.js";
+export type { DedupMode, ReopenableUploadSource, UploadCreateInput, UploadCreateResult, UploadPreference, UploadProtocol, UploadSource, } from "./types.js";

package/dist/cjs/uploads/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Uploads = void 0;
+var Uploads_js_1 = require("./Uploads.js");
+Object.defineProperty(exports, "Uploads", { enumerable: true, get: function () { return Uploads_js_1.Uploads; } });

package/dist/cjs/uploads/source.d.ts

@@ -0,0 +1,10 @@
+import type { UploadSource } from "./types.js";
+export interface PreparedUploadSource {
+    size: number;
+    sha256: string;
+    filename: string;
+    contentType: string;
+    open(): Promise<BodyInit>;
+    openProxyBlob(): Promise<Blob>;
+}
+export declare function prepareUploadSource(source: UploadSource): Promise<PreparedUploadSource>;

package/dist/cjs/uploads/source.js

@@ -0,0 +1,155 @@
+"use strict";
+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;
+    };
+})();
+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());
+    });
+};
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareUploadSource = prepareUploadSource;
+function prepareUploadSource(source) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        if (isReopenable(source)) {
+            return {
+                size: source.size,
+                sha256: normalizeSha(source.sha256),
+                filename: (_a = source.filename) !== null && _a !== void 0 ? _a : "document.pdf",
+                contentType: (_b = source.contentType) !== null && _b !== void 0 ? _b : "application/pdf",
+                open: () => __awaiter(this, void 0, void 0, function* () { return source.open(); }),
+                openProxyBlob: () => __awaiter(this, void 0, void 0, function* () {
+                    if (!source.openProxyBlob) {
+                        throw new Error("the server selected proxy upload, but this reopenable source does not provide openProxyBlob()");
+                    }
+                    return source.openProxyBlob();
+                }),
+            };
+        }
+        if (isPathSource(source))
+            return preparePath(source.path);
+        const blob = toBlob(source);
+        return {
+            size: blob.size,
+            sha256: yield sha256Bytes(new Uint8Array(yield blob.arrayBuffer())),
+            filename: "document.pdf",
+            contentType: blob.type || "application/pdf",
+            open: () => __awaiter(this, void 0, void 0, function* () { return blob; }),
+            openProxyBlob: () => __awaiter(this, void 0, void 0, function* () { return blob; }),
+        };
+    });
+}
+function preparePath(path) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, e_1, _b, _c;
+        const [{ createReadStream }, { readFile, stat }, { createHash }] = yield Promise.all([
+            Promise.resolve().then(() => __importStar(require("node:fs"))),
+            Promise.resolve().then(() => __importStar(require("node:fs/promises"))),
+            Promise.resolve().then(() => __importStar(require("node:crypto"))),
+        ]);
+        const info = yield stat(path);
+        if (!info.isFile())
+            throw new Error(`upload source is not a file: ${path}`);
+        const hash = createHash("sha256");
+        try {
+            for (var _d = true, _e = __asyncValues(createReadStream(path)), _f; _f = yield _e.next(), _a = _f.done, !_a; _d = true) {
+                _c = _f.value;
+                _d = false;
+                const chunk = _c;
+                hash.update(chunk);
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (!_d && !_a && (_b = _e.return)) yield _b.call(_e);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        return {
+            size: info.size,
+            sha256: hash.digest("hex"),
+            filename: path.split(/[\\/]/).pop() || "document.pdf",
+            contentType: "application/pdf",
+            open: () => __awaiter(this, void 0, void 0, function* () { return createReadStream(path); }),
+            // The proxy route is deliberately bounded. Presigned mode remains
+            // streaming; the uncommon filesystem fallback materializes one Blob.
+            openProxyBlob: () => __awaiter(this, void 0, void 0, function* () { return new Blob([new Uint8Array(yield readFile(path))], { type: "application/pdf" }); }),
+        };
+    });
+}
+function sha256Bytes(bytes) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        if ((_a = globalThis.crypto) === null || _a === void 0 ? void 0 : _a.subtle) {
+            const digest = yield globalThis.crypto.subtle.digest("SHA-256", new Uint8Array(bytes));
+            return hex(new Uint8Array(digest));
+        }
+        const { createHash } = yield Promise.resolve().then(() => __importStar(require("node:crypto")));
+        return createHash("sha256").update(bytes).digest("hex");
+    });
+}
+function toBlob(source) {
+    if (source instanceof Blob)
+        return source;
+    const bytes = source instanceof Uint8Array ? new Uint8Array(source) : new Uint8Array(source.slice(0));
+    return new Blob([bytes], { type: "application/pdf" });
+}
+function isPathSource(source) {
+    return typeof source === "object" && source !== null && "path" in source;
+}
+function isReopenable(source) {
+    return typeof source === "object" && source !== null && "open" in source && "size" in source && "sha256" in source;
+}
+function normalizeSha(value) {
+    const normalized = value.toLowerCase();
+    if (!/^[a-f0-9]{64}$/.test(normalized)) {
+        throw new Error("reopenable upload source sha256 must be 64 lowercase or uppercase hex characters");
+    }
+    return normalized;
+}
+function hex(bytes) {
+    return Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
+}

package/dist/cjs/uploads/types.d.ts

@@ -0,0 +1,46 @@
+export type UploadPreference = "auto" | "presigned" | "proxy";
+export type DedupMode = "always-create" | "reuse-existing";
+/**
+ * A source that can be opened again after its hash is known. This is the
+ * escape hatch for streams: init needs the final SHA before transfer starts,
+ * so a one-shot unknown stream cannot implement the protocol safely.
+ */
+export interface ReopenableUploadSource {
+    size: number;
+    sha256: string;
+    filename?: string;
+    contentType?: string;
+    open(): BodyInit | Promise<BodyInit>;
+    /** Required only if the server selects the multipart proxy fallback. */
+    openProxyBlob?(): Blob | Promise<Blob>;
+}
+export type UploadSource = Uint8Array | ArrayBuffer | Blob | {
+    path: string;
+} | ReopenableUploadSource;
+export interface UploadCreateInput {
+    tenantId: string;
+    source: UploadSource;
+    metadata?: Record<string, unknown>;
+    idempotencyKey?: string;
+    dedupMode?: DedupMode;
+    docId?: string;
+    uploadTtlSec?: number;
+    /** `auto` prefers a presigned object-store PUT and is recommended. */
+    uploadPreference?: UploadPreference;
+    signal?: AbortSignal;
+    onProgress?: (loaded: number, total: number) => void;
+}
+export interface UploadCreateResult<Document = unknown> {
+    tag: "created" | "resumed" | "deduped";
+    document: Document;
+}
+export interface UploadRequestOptions {
+    abortSignal?: AbortSignal;
+    maxRetries?: number;
+}
+export interface UploadProtocol {
+    init(request: Record<string, unknown>, options: UploadRequestOptions): Promise<unknown>;
+    commit(request: Record<string, unknown>, options: UploadRequestOptions): Promise<unknown>;
+    proxy(url: string, form: FormData, options: UploadRequestOptions): Promise<Response>;
+    presigned(url: string, init: RequestInit): Promise<Response>;
+}

package/dist/cjs/uploads/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "3.0.0-next.1";
+export declare const SDK_VERSION = "3.0.0-next.11";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "3.0.0-next.1";
+exports.SDK_VERSION = "3.0.0-next.11";

package/dist/esm/BaseClient.mjs

@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
     const headers = 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.11",
+        "User-Agent": "@cloudpdf/sdk/3.0.0-next.11",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/esm/Client.d.mts

@@ -1,6 +1,7 @@
 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 type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.mjs";
@@ -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;