@cloudpdf/sdk 3.0.0-next.4 → 3.0.0-next.6

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.4",
-        "User-Agent": "@cloudpdf/sdk/3.0.0-next.4",
+        "X-Fern-SDK-Version": "3.0.0-next.6",
+        "User-Agent": "@cloudpdf/sdk/3.0.0-next.6",
         "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/api/errors/BadGatewayError.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 BadGatewayError extends errors.CloudPDFError {
+    readonly body: CloudPDF.DocumentsImportFrom502Response;
+    constructor(body: CloudPDF.DocumentsImportFrom502Response, rawResponse?: core.RawResponse);
+}

package/dist/cjs/api/errors/BadGatewayError.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.BadGatewayError = void 0;
+const errors = __importStar(require("../../errors/index.js"));
+class BadGatewayError extends errors.CloudPDFError {
+    constructor(body, rawResponse) {
+        super({
+            message: "BadGatewayError",
+            statusCode: 502,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        this.name = "BadGatewayError";
+    }
+}
+exports.BadGatewayError = BadGatewayError;

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

@@ -1,3 +1,4 @@
+export * from "./BadGatewayError.js";
 export * from "./BadRequestError.js";
 export * from "./ConflictError.js";
 export * from "./ForbiddenError.js";

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

@@ -14,6 +14,7 @@ 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 });
+__exportStar(require("./BadGatewayError.js"), exports);
 __exportStar(require("./BadRequestError.js"), exports);
 __exportStar(require("./ConflictError.js"), exports);
 __exportStar(require("./ForbiddenError.js"), exports);

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

@@ -113,6 +113,29 @@ export declare class DocumentsClient {
      */
     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"
+     *         }
+     *     })
+     */
+    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

@@ -453,6 +453,75 @@ class DocumentsClient {
             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"
+     *         }
+     *     })
+     */
+    importFrom(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__importFrom(request, requestOptions));
+    }
+    __importFrom(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            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, 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/import`),
+                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 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,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v1/tenants/{tenantId}/documents/import");
+        });
+    }
     /**
      * @param {CloudPDF.DocumentsInitRequest} request
      * @param {DocumentsClient.RequestOptions} requestOptions - Request-specific configuration.

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

@@ -0,0 +1,37 @@
+import type * as CloudPDF from "../../../../index.js";
+/**
+ * @example
+ *     {
+ *         tenantId: "tenantId",
+ *         source: {
+ *             kind: "url",
+ *             url: "url"
+ *         }
+ *     }
+ */
+export interface DocumentsImportFromRequest {
+    tenantId: string;
+    source: CloudPDF.DocumentsImportFromRequestSource;
+    expected?: DocumentsImportFromRequest.Expected;
+    metadata?: Record<string, unknown>;
+    idempotencyKey?: string;
+    dedupMode?: DocumentsImportFromRequest.DedupMode;
+    docId?: string;
+    mode?: DocumentsImportFromRequest.Mode;
+}
+export declare namespace DocumentsImportFromRequest {
+    interface Expected {
+        sizeBytes?: number | undefined;
+        sha256?: string | undefined;
+    }
+    const DedupMode: {
+        readonly AlwaysCreate: "always-create";
+        readonly ReuseExisting: "reuse-existing";
+    };
+    type DedupMode = (typeof DedupMode)[keyof typeof DedupMode];
+    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,15 @@
+"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) {
+    DocumentsImportFromRequest.DedupMode = {
+        AlwaysCreate: "always-create",
+        ReuseExisting: "reuse-existing",
+    };
+    DocumentsImportFromRequest.Mode = {
+        Sync: "sync",
+        Async: "async",
+    };
+})(DocumentsImportFromRequest || (exports.DocumentsImportFromRequest = DocumentsImportFromRequest = {}));

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

@@ -1,5 +1,6 @@
 export type { DeleteDocumentsRequest } from "./DeleteDocumentsRequest.js";
 export type { DocumentsCommitRequest } from "./DocumentsCommitRequest.js";
+export { DocumentsImportFromRequest } from "./DocumentsImportFromRequest.js";
 export { DocumentsInitRequest } from "./DocumentsInitRequest.js";
 export type { DownloadDocumentsRequest } from "./DownloadDocumentsRequest.js";
 export type { GetDocumentsRequest } from "./GetDocumentsRequest.js";

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

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

package/dist/cjs/api/resources/documents/types/DocumentsImportFromRequestSource.d.ts

@@ -0,0 +1,14 @@
+import type * as CloudPDF from "../../../index.js";
+export type DocumentsImportFromRequestSource = CloudPDF.DocumentsImportFromRequestSource.Url | CloudPDF.DocumentsImportFromRequestSource.Connection;
+export declare namespace DocumentsImportFromRequestSource {
+    interface Url {
+        kind: "url";
+        url: string;
+    }
+    interface Connection {
+        kind: "connection";
+        connectionId: string;
+        key: string;
+        revision?: string | undefined;
+    }
+}

package/dist/cjs/api/resources/documents/types/DocumentsImportFromRequestSource.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/documents/types/index.d.ts

@@ -1 +1,2 @@
+export * from "./DocumentsImportFromRequestSource.js";
 export * from "./ListDocumentsRequestState.js";

package/dist/cjs/api/resources/documents/types/index.js

@@ -14,4 +14,5 @@ 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 });
+__exportStar(require("./DocumentsImportFromRequestSource.js"), exports);
 __exportStar(require("./ListDocumentsRequestState.js"), exports);

package/dist/cjs/api/types/DocText200Response.d.ts

@@ -1,4 +1,5 @@
 export interface DocText200Response {
     text: string;
     charCount: number;
+    charMap?: unknown[][] | undefined;
 }

package/dist/cjs/api/types/DocumentsImportFrom200Response.d.ts

@@ -0,0 +1,43 @@
+export interface DocumentsImportFrom200Response {
+    tag: DocumentsImportFrom200Response.Tag;
+    document: DocumentsImportFrom200Response.Document;
+}
+export declare namespace DocumentsImportFrom200Response {
+    const Tag: {
+        readonly Imported: "imported";
+        readonly Deduped: "deduped";
+        readonly Accepted: "accepted";
+    };
+    type Tag = (typeof Tag)[keyof typeof Tag];
+    interface Document {
+        id: string;
+        tenantId: string;
+        state: Document.State;
+        baseSha: string | null;
+        storageSizeBytes: number | null;
+        metadata: Record<string, unknown> | null;
+        idempotencyKey: string | null;
+        failureReason: string | null;
+        thumbnailState?: Document.ThumbnailState | undefined;
+        thumbnailUrl?: (string | null) | undefined;
+        createdAt: number;
+        updatedAt: number;
+        createdBy: string | null;
+    }
+    namespace Document {
+        const State: {
+            readonly Pending: "pending";
+            readonly Ready: "ready";
+            readonly Failed: "failed";
+            readonly Deleting: "deleting";
+        };
+        type State = (typeof State)[keyof typeof State];
+        const ThumbnailState: {
+            readonly Pending: "pending";
+            readonly Ready: "ready";
+            readonly Locked: "locked";
+            readonly Failed: "failed";
+        };
+        type ThumbnailState = (typeof ThumbnailState)[keyof typeof ThumbnailState];
+    }
+}

package/dist/cjs/api/types/DocumentsImportFrom200Response.js

@@ -0,0 +1,27 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentsImportFrom200Response = void 0;
+var DocumentsImportFrom200Response;
+(function (DocumentsImportFrom200Response) {
+    DocumentsImportFrom200Response.Tag = {
+        Imported: "imported",
+        Deduped: "deduped",
+        Accepted: "accepted",
+    };
+    let Document;
+    (function (Document) {
+        Document.State = {
+            Pending: "pending",
+            Ready: "ready",
+            Failed: "failed",
+            Deleting: "deleting",
+        };
+        Document.ThumbnailState = {
+            Pending: "pending",
+            Ready: "ready",
+            Locked: "locked",
+            Failed: "failed",
+        };
+    })(Document = DocumentsImportFrom200Response.Document || (DocumentsImportFrom200Response.Document = {}));
+})(DocumentsImportFrom200Response || (exports.DocumentsImportFrom200Response = DocumentsImportFrom200Response = {}));

package/dist/cjs/api/types/DocumentsImportFrom202Response.d.ts

@@ -0,0 +1,43 @@
+export interface DocumentsImportFrom202Response {
+    tag: DocumentsImportFrom202Response.Tag;
+    document: DocumentsImportFrom202Response.Document;
+}
+export declare namespace DocumentsImportFrom202Response {
+    const Tag: {
+        readonly Imported: "imported";
+        readonly Deduped: "deduped";
+        readonly Accepted: "accepted";
+    };
+    type Tag = (typeof Tag)[keyof typeof Tag];
+    interface Document {
+        id: string;
+        tenantId: string;
+        state: Document.State;
+        baseSha: string | null;
+        storageSizeBytes: number | null;
+        metadata: Record<string, unknown> | null;
+        idempotencyKey: string | null;
+        failureReason: string | null;
+        thumbnailState?: Document.ThumbnailState | undefined;
+        thumbnailUrl?: (string | null) | undefined;
+        createdAt: number;
+        updatedAt: number;
+        createdBy: string | null;
+    }
+    namespace Document {
+        const State: {
+            readonly Pending: "pending";
+            readonly Ready: "ready";
+            readonly Failed: "failed";
+            readonly Deleting: "deleting";
+        };
+        type State = (typeof State)[keyof typeof State];
+        const ThumbnailState: {
+            readonly Pending: "pending";
+            readonly Ready: "ready";
+            readonly Locked: "locked";
+            readonly Failed: "failed";
+        };
+        type ThumbnailState = (typeof ThumbnailState)[keyof typeof ThumbnailState];
+    }
+}

package/dist/cjs/api/types/DocumentsImportFrom202Response.js

@@ -0,0 +1,27 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentsImportFrom202Response = void 0;
+var DocumentsImportFrom202Response;
+(function (DocumentsImportFrom202Response) {
+    DocumentsImportFrom202Response.Tag = {
+        Imported: "imported",
+        Deduped: "deduped",
+        Accepted: "accepted",
+    };
+    let Document;
+    (function (Document) {
+        Document.State = {
+            Pending: "pending",
+            Ready: "ready",
+            Failed: "failed",
+            Deleting: "deleting",
+        };
+        Document.ThumbnailState = {
+            Pending: "pending",
+            Ready: "ready",
+            Locked: "locked",
+            Failed: "failed",
+        };
+    })(Document = DocumentsImportFrom202Response.Document || (DocumentsImportFrom202Response.Document = {}));
+})(DocumentsImportFrom202Response || (exports.DocumentsImportFrom202Response = DocumentsImportFrom202Response = {}));

package/dist/cjs/api/types/DocumentsImportFrom400Response.d.ts

@@ -0,0 +1,9 @@
+export interface DocumentsImportFrom400Response {
+    error: DocumentsImportFrom400Response.Error_;
+}
+export declare namespace DocumentsImportFrom400Response {
+    interface Error_ {
+        code: string;
+        message: string;
+    }
+}

package/dist/cjs/api/types/DocumentsImportFrom400Response.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/types/DocumentsImportFrom403Response.d.ts

@@ -0,0 +1,9 @@
+export interface DocumentsImportFrom403Response {
+    error: DocumentsImportFrom403Response.Error_;
+}
+export declare namespace DocumentsImportFrom403Response {
+    interface Error_ {
+        code: string;
+        message: string;
+    }
+}

package/dist/cjs/api/types/DocumentsImportFrom403Response.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/types/DocumentsImportFrom502Response.d.ts

@@ -0,0 +1,9 @@
+export interface DocumentsImportFrom502Response {
+    error: DocumentsImportFrom502Response.Error_;
+}
+export declare namespace DocumentsImportFrom502Response {
+    interface Error_ {
+        code: string;
+        message: string;
+    }
+}

package/dist/cjs/api/types/DocumentsImportFrom502Response.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/types/index.d.ts

@@ -145,6 +145,11 @@ export * from "./DocumentsDownload404Response.js";
 export * from "./DocumentsGet200Response.js";
 export * from "./DocumentsGet403Response.js";
 export * from "./DocumentsGet404Response.js";
+export * from "./DocumentsImportFrom200Response.js";
+export * from "./DocumentsImportFrom202Response.js";
+export * from "./DocumentsImportFrom400Response.js";
+export * from "./DocumentsImportFrom403Response.js";
+export * from "./DocumentsImportFrom502Response.js";
 export * from "./DocumentsInit200Response.js";
 export * from "./DocumentsInit200ResponseCreatedUpload.js";
 export * from "./DocumentsInit200ResponseResumedUpload.js";

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

@@ -161,6 +161,11 @@ __exportStar(require("./DocumentsDownload404Response.js"), exports);
 __exportStar(require("./DocumentsGet200Response.js"), exports);
 __exportStar(require("./DocumentsGet403Response.js"), exports);
 __exportStar(require("./DocumentsGet404Response.js"), exports);
+__exportStar(require("./DocumentsImportFrom200Response.js"), exports);
+__exportStar(require("./DocumentsImportFrom202Response.js"), exports);
+__exportStar(require("./DocumentsImportFrom400Response.js"), exports);
+__exportStar(require("./DocumentsImportFrom403Response.js"), exports);
+__exportStar(require("./DocumentsImportFrom502Response.js"), exports);
 __exportStar(require("./DocumentsInit200Response.js"), exports);
 __exportStar(require("./DocumentsInit200ResponseCreatedUpload.js"), exports);
 __exportStar(require("./DocumentsInit200ResponseResumedUpload.js"), exports);

package/dist/cjs/version.d.ts

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

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.4";
+exports.SDK_VERSION = "3.0.0-next.6";

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.4",
-        "User-Agent": "@cloudpdf/sdk/3.0.0-next.4",
+        "X-Fern-SDK-Version": "3.0.0-next.6",
+        "User-Agent": "@cloudpdf/sdk/3.0.0-next.6",
         "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/api/errors/BadGatewayError.d.mts

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

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

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

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

@@ -1,3 +1,4 @@
+export * from "./BadGatewayError.mjs";
 export * from "./BadRequestError.mjs";
 export * from "./ConflictError.mjs";
 export * from "./ForbiddenError.mjs";

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

@@ -1,3 +1,4 @@
+export * from "./BadGatewayError.mjs";
 export * from "./BadRequestError.mjs";
 export * from "./ConflictError.mjs";
 export * from "./ForbiddenError.mjs";

package/dist/esm/api/resources/documents/client/Client.d.mts

@@ -113,6 +113,29 @@ export declare class DocumentsClient {
      */
     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"
+     *         }
+     *     })
+     */
+    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/esm/api/resources/documents/client/Client.mjs

@@ -417,6 +417,75 @@ export class DocumentsClient {
             return 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"
+     *         }
+     *     })
+     */
+    importFrom(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__importFrom(request, requestOptions));
+    }
+    __importFrom(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const { tenantId } = request, _body = __rest(request, ["tenantId"]);
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = 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/import`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                requestType: "json",
+                body: mergeAdditionalBodyParameters(_body, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.additionalBodyParameters),
+                timeoutMs: ((_e = (_c = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _c !== void 0 ? _c : (_d = this._options) === null || _d === void 0 ? void 0 : _d.timeoutInSeconds) !== null && _e !== void 0 ? _e : 60) * 1000,
+                maxRetries: (_f = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _f !== void 0 ? _f : (_g = this._options) === null || _g === void 0 ? void 0 : _g.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_h = this._options) === null || _h === void 0 ? void 0 : _h.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new CloudPDF.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 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,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v1/tenants/{tenantId}/documents/import");
+        });
+    }
     /**
      * @param {CloudPDF.DocumentsInitRequest} request
      * @param {DocumentsClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/esm/api/resources/documents/client/requests/DocumentsImportFromRequest.d.mts

@@ -0,0 +1,37 @@
+import type * as CloudPDF from "../../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         tenantId: "tenantId",
+ *         source: {
+ *             kind: "url",
+ *             url: "url"
+ *         }
+ *     }
+ */
+export interface DocumentsImportFromRequest {
+    tenantId: string;
+    source: CloudPDF.DocumentsImportFromRequestSource;
+    expected?: DocumentsImportFromRequest.Expected;
+    metadata?: Record<string, unknown>;
+    idempotencyKey?: string;
+    dedupMode?: DocumentsImportFromRequest.DedupMode;
+    docId?: string;
+    mode?: DocumentsImportFromRequest.Mode;
+}
+export declare namespace DocumentsImportFromRequest {
+    interface Expected {
+        sizeBytes?: number | undefined;
+        sha256?: string | undefined;
+    }
+    const DedupMode: {
+        readonly AlwaysCreate: "always-create";
+        readonly ReuseExisting: "reuse-existing";
+    };
+    type DedupMode = (typeof DedupMode)[keyof typeof DedupMode];
+    const Mode: {
+        readonly Sync: "sync";
+        readonly Async: "async";
+    };
+    type Mode = (typeof Mode)[keyof typeof Mode];
+}

package/dist/esm/api/resources/documents/client/requests/DocumentsImportFromRequest.mjs

@@ -0,0 +1,12 @@
+// This file was auto-generated by Fern from our API Definition.
+export var DocumentsImportFromRequest;
+(function (DocumentsImportFromRequest) {
+    DocumentsImportFromRequest.DedupMode = {
+        AlwaysCreate: "always-create",
+        ReuseExisting: "reuse-existing",
+    };
+    DocumentsImportFromRequest.Mode = {
+        Sync: "sync",
+        Async: "async",
+    };
+})(DocumentsImportFromRequest || (DocumentsImportFromRequest = {}));

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

@@ -1,5 +1,6 @@
 export type { DeleteDocumentsRequest } from "./DeleteDocumentsRequest.mjs";
 export type { DocumentsCommitRequest } from "./DocumentsCommitRequest.mjs";
+export { DocumentsImportFromRequest } from "./DocumentsImportFromRequest.mjs";
 export { DocumentsInitRequest } from "./DocumentsInitRequest.mjs";
 export type { DownloadDocumentsRequest } from "./DownloadDocumentsRequest.mjs";
 export type { GetDocumentsRequest } from "./GetDocumentsRequest.mjs";

package/dist/esm/api/resources/documents/client/requests/index.mjs

@@ -1 +1,2 @@
+export { DocumentsImportFromRequest } from "./DocumentsImportFromRequest.mjs";
 export { DocumentsInitRequest } from "./DocumentsInitRequest.mjs";

package/dist/esm/api/resources/documents/types/DocumentsImportFromRequestSource.d.mts

@@ -0,0 +1,14 @@
+import type * as CloudPDF from "../../../index.mjs";
+export type DocumentsImportFromRequestSource = CloudPDF.DocumentsImportFromRequestSource.Url | CloudPDF.DocumentsImportFromRequestSource.Connection;
+export declare namespace DocumentsImportFromRequestSource {
+    interface Url {
+        kind: "url";
+        url: string;
+    }
+    interface Connection {
+        kind: "connection";
+        connectionId: string;
+        key: string;
+        revision?: string | undefined;
+    }
+}

package/dist/esm/api/resources/documents/types/DocumentsImportFromRequestSource.mjs

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

package/dist/esm/api/resources/documents/types/index.d.mts

@@ -1 +1,2 @@
+export * from "./DocumentsImportFromRequestSource.mjs";
 export * from "./ListDocumentsRequestState.mjs";

package/dist/esm/api/resources/documents/types/index.mjs

@@ -1 +1,2 @@
+export * from "./DocumentsImportFromRequestSource.mjs";
 export * from "./ListDocumentsRequestState.mjs";

package/dist/esm/api/types/DocText200Response.d.mts

@@ -1,4 +1,5 @@
 export interface DocText200Response {
     text: string;
     charCount: number;
+    charMap?: unknown[][] | undefined;
 }

package/dist/esm/api/types/DocumentsImportFrom200Response.d.mts

@@ -0,0 +1,43 @@
+export interface DocumentsImportFrom200Response {
+    tag: DocumentsImportFrom200Response.Tag;
+    document: DocumentsImportFrom200Response.Document;
+}
+export declare namespace DocumentsImportFrom200Response {
+    const Tag: {
+        readonly Imported: "imported";
+        readonly Deduped: "deduped";
+        readonly Accepted: "accepted";
+    };
+    type Tag = (typeof Tag)[keyof typeof Tag];
+    interface Document {
+        id: string;
+        tenantId: string;
+        state: Document.State;
+        baseSha: string | null;
+        storageSizeBytes: number | null;
+        metadata: Record<string, unknown> | null;
+        idempotencyKey: string | null;
+        failureReason: string | null;
+        thumbnailState?: Document.ThumbnailState | undefined;
+        thumbnailUrl?: (string | null) | undefined;
+        createdAt: number;
+        updatedAt: number;
+        createdBy: string | null;
+    }
+    namespace Document {
+        const State: {
+            readonly Pending: "pending";
+            readonly Ready: "ready";
+            readonly Failed: "failed";
+            readonly Deleting: "deleting";
+        };
+        type State = (typeof State)[keyof typeof State];
+        const ThumbnailState: {
+            readonly Pending: "pending";
+            readonly Ready: "ready";
+            readonly Locked: "locked";
+            readonly Failed: "failed";
+        };
+        type ThumbnailState = (typeof ThumbnailState)[keyof typeof ThumbnailState];
+    }
+}

package/dist/esm/api/types/DocumentsImportFrom200Response.mjs

@@ -0,0 +1,24 @@
+// This file was auto-generated by Fern from our API Definition.
+export var DocumentsImportFrom200Response;
+(function (DocumentsImportFrom200Response) {
+    DocumentsImportFrom200Response.Tag = {
+        Imported: "imported",
+        Deduped: "deduped",
+        Accepted: "accepted",
+    };
+    let Document;
+    (function (Document) {
+        Document.State = {
+            Pending: "pending",
+            Ready: "ready",
+            Failed: "failed",
+            Deleting: "deleting",
+        };
+        Document.ThumbnailState = {
+            Pending: "pending",
+            Ready: "ready",
+            Locked: "locked",
+            Failed: "failed",
+        };
+    })(Document = DocumentsImportFrom200Response.Document || (DocumentsImportFrom200Response.Document = {}));
+})(DocumentsImportFrom200Response || (DocumentsImportFrom200Response = {}));

package/dist/esm/api/types/DocumentsImportFrom202Response.d.mts

@@ -0,0 +1,43 @@
+export interface DocumentsImportFrom202Response {
+    tag: DocumentsImportFrom202Response.Tag;
+    document: DocumentsImportFrom202Response.Document;
+}
+export declare namespace DocumentsImportFrom202Response {
+    const Tag: {
+        readonly Imported: "imported";
+        readonly Deduped: "deduped";
+        readonly Accepted: "accepted";
+    };
+    type Tag = (typeof Tag)[keyof typeof Tag];
+    interface Document {
+        id: string;
+        tenantId: string;
+        state: Document.State;
+        baseSha: string | null;
+        storageSizeBytes: number | null;
+        metadata: Record<string, unknown> | null;
+        idempotencyKey: string | null;
+        failureReason: string | null;
+        thumbnailState?: Document.ThumbnailState | undefined;
+        thumbnailUrl?: (string | null) | undefined;
+        createdAt: number;
+        updatedAt: number;
+        createdBy: string | null;
+    }
+    namespace Document {
+        const State: {
+            readonly Pending: "pending";
+            readonly Ready: "ready";
+            readonly Failed: "failed";
+            readonly Deleting: "deleting";
+        };
+        type State = (typeof State)[keyof typeof State];
+        const ThumbnailState: {
+            readonly Pending: "pending";
+            readonly Ready: "ready";
+            readonly Locked: "locked";
+            readonly Failed: "failed";
+        };
+        type ThumbnailState = (typeof ThumbnailState)[keyof typeof ThumbnailState];
+    }
+}

package/dist/esm/api/types/DocumentsImportFrom202Response.mjs

@@ -0,0 +1,24 @@
+// This file was auto-generated by Fern from our API Definition.
+export var DocumentsImportFrom202Response;
+(function (DocumentsImportFrom202Response) {
+    DocumentsImportFrom202Response.Tag = {
+        Imported: "imported",
+        Deduped: "deduped",
+        Accepted: "accepted",
+    };
+    let Document;
+    (function (Document) {
+        Document.State = {
+            Pending: "pending",
+            Ready: "ready",
+            Failed: "failed",
+            Deleting: "deleting",
+        };
+        Document.ThumbnailState = {
+            Pending: "pending",
+            Ready: "ready",
+            Locked: "locked",
+            Failed: "failed",
+        };
+    })(Document = DocumentsImportFrom202Response.Document || (DocumentsImportFrom202Response.Document = {}));
+})(DocumentsImportFrom202Response || (DocumentsImportFrom202Response = {}));

package/dist/esm/api/types/DocumentsImportFrom400Response.d.mts

@@ -0,0 +1,9 @@
+export interface DocumentsImportFrom400Response {
+    error: DocumentsImportFrom400Response.Error_;
+}
+export declare namespace DocumentsImportFrom400Response {
+    interface Error_ {
+        code: string;
+        message: string;
+    }
+}

package/dist/esm/api/types/DocumentsImportFrom400Response.mjs

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

package/dist/esm/api/types/DocumentsImportFrom403Response.d.mts

@@ -0,0 +1,9 @@
+export interface DocumentsImportFrom403Response {
+    error: DocumentsImportFrom403Response.Error_;
+}
+export declare namespace DocumentsImportFrom403Response {
+    interface Error_ {
+        code: string;
+        message: string;
+    }
+}

package/dist/esm/api/types/DocumentsImportFrom403Response.mjs

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

package/dist/esm/api/types/DocumentsImportFrom502Response.d.mts

@@ -0,0 +1,9 @@
+export interface DocumentsImportFrom502Response {
+    error: DocumentsImportFrom502Response.Error_;
+}
+export declare namespace DocumentsImportFrom502Response {
+    interface Error_ {
+        code: string;
+        message: string;
+    }
+}

package/dist/esm/api/types/DocumentsImportFrom502Response.mjs

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

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

@@ -145,6 +145,11 @@ export * from "./DocumentsDownload404Response.mjs";
 export * from "./DocumentsGet200Response.mjs";
 export * from "./DocumentsGet403Response.mjs";
 export * from "./DocumentsGet404Response.mjs";
+export * from "./DocumentsImportFrom200Response.mjs";
+export * from "./DocumentsImportFrom202Response.mjs";
+export * from "./DocumentsImportFrom400Response.mjs";
+export * from "./DocumentsImportFrom403Response.mjs";
+export * from "./DocumentsImportFrom502Response.mjs";
 export * from "./DocumentsInit200Response.mjs";
 export * from "./DocumentsInit200ResponseCreatedUpload.mjs";
 export * from "./DocumentsInit200ResponseResumedUpload.mjs";

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

@@ -145,6 +145,11 @@ export * from "./DocumentsDownload404Response.mjs";
 export * from "./DocumentsGet200Response.mjs";
 export * from "./DocumentsGet403Response.mjs";
 export * from "./DocumentsGet404Response.mjs";
+export * from "./DocumentsImportFrom200Response.mjs";
+export * from "./DocumentsImportFrom202Response.mjs";
+export * from "./DocumentsImportFrom400Response.mjs";
+export * from "./DocumentsImportFrom403Response.mjs";
+export * from "./DocumentsImportFrom502Response.mjs";
 export * from "./DocumentsInit200Response.mjs";
 export * from "./DocumentsInit200ResponseCreatedUpload.mjs";
 export * from "./DocumentsInit200ResponseResumedUpload.mjs";

package/dist/esm/version.d.mts

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

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "3.0.0-next.4";
+export const SDK_VERSION = "3.0.0-next.6";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudpdf/sdk",
-  "version": "3.0.0-next.4",
+  "version": "3.0.0-next.6",
   "private": false,
   "license": "Apache-2.0",
   "type": "commonjs",

package/reference.md

@@ -1431,6 +1431,75 @@ await client.documents.uploadProxy({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.documents.<a href="/src/api/resources/documents/client/Client.ts">importFrom</a>({ ...params }) -> CloudPDF.DocumentsImportFrom200Response</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+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).
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.documents.importFrom({
+    tenantId: "tenantId",
+    source: {
+        kind: "url",
+        url: "url"
+    }
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `CloudPDF.DocumentsImportFromRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `DocumentsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>