cloudpdf 3.0.0.alpha.5 → 3.0.0.alpha.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f7fdb77742ceeaefd0a0ac71e28438252a6dbfa2689eaa1eb8abbb9b28d55b04
-  data.tar.gz: f5c6113005f71a826485beca4913918964b4c1ae4467898ad2e2fd0cbbfa6329
+  metadata.gz: 3b5d667e02d713992d73f05628e284f88296a6ba5074f4a7a3ba39973a508bd4
+  data.tar.gz: 31ca047a8eb76373d2364fef4849a249f88734866c5c42b40ed3bc02177b0973
 SHA512:
-  metadata.gz: 15bcadf646b92f03162188b682a9954d8526934cc03f071f541b725243e9e02159852e4a6bd889770998699f44c1ec1b72c58a9ea216cac62fd5665d8955b210
-  data.tar.gz: d3d4ba66658252c98ba21f90ed485c782fbaffffe0a1a60bfa201452b1fc0e65aa9b6cdfd91c82e6b5226399aea5cc26d548ebf930354df1ee586dbb826409d4
+  metadata.gz: f7dc2d0efc8f66899706f4d643d87efeefd2115d3114bde0f672a2f3bd4a9fe5fa35cc2655e9e6e18cfd67bf8bf308d7ce51255a2a06b028a2d20de4490ec91e
+  data.tar.gz: 12477c22fa854372c21584dbfb83931e2e318497ee761988c0f8e5baef7aad6a098e59baf465bb5da433475713dea1fd831c68df79dcdb7c04a803f2105d9665

data/.fern/metadata.json

@@ -5,9 +5,9 @@
   "generatorConfig": {
     "moduleName": "CloudPDF"
   },
-  "originGitCommit": "81e6a2097d2997ef713a3013668e5eae0e748575",
+  "originGitCommit": "1345fb7a45ee660a352774d29decce25cb54b8ea",
   "originGitCommitIsDirty": false,
   "invokedBy": "ci",
-  "requestedVersion": "3.0.0.alpha.5",
+  "requestedVersion": "3.0.0.alpha.7",
   "ciProvider": "github"
 }

data/lib/CloudPDF/documents/client.rb

@@ -299,6 +299,55 @@ module CloudPDF
         end
       end
 
+      # 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 request_options [Hash]
+      # @param params [CloudPDF::Documents::Types::DocumentsImportFromRequest]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [String] :tenant_id
+      #
+      # @example
+      #   client.documents.import_from(tenant_id: "tenantId")
+      #
+      # @return [CloudPDF::Types::DocumentsImportFrom200Response]
+      def import_from(request_options: {}, **params)
+        params = CloudPDF::Internal::Types::Utils.normalize_keys(params)
+        request_data = CloudPDF::Documents::Types::DocumentsImportFromRequest.new(params).to_h
+        non_body_param_names = %w[tenantId]
+        body = request_data.except(*non_body_param_names)
+
+        request = CloudPDF::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "v1/tenants/#{URI.encode_uri_component(params[:tenant_id].to_s)}/documents/import",
+          body: body,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise CloudPDF::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          CloudPDF::Types::DocumentsImportFrom200Response.load(response.body)
+        else
+          error_class = CloudPDF::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
       # @param request_options [Hash]
       # @param params [CloudPDF::Documents::Types::DocumentsInitRequest]
       # @option request_options [String] :base_url

data/lib/CloudPDF/documents/types/documents_import_from_request.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Documents
+    module Types
+      class DocumentsImportFromRequest < Internal::Types::Model
+        field :tenant_id, -> { String }, optional: false, nullable: false, api_name: "tenantId"
+
+        field :source, -> { CloudPDF::Documents::Types::DocumentsImportFromRequestSource }, optional: false, nullable: false
+
+        field :expected, -> { CloudPDF::Documents::Types::DocumentsImportFromRequestExpected }, optional: true, nullable: false
+
+        field :metadata, -> { Internal::Types::Hash[String, Object] }, optional: true, nullable: false
+
+        field :idempotency_key, -> { String }, optional: true, nullable: false, api_name: "idempotencyKey"
+
+        field :dedup_mode, -> { CloudPDF::Documents::Types::DocumentsImportFromRequestDedupMode }, optional: true, nullable: false, api_name: "dedupMode"
+
+        field :doc_id, -> { String }, optional: true, nullable: false, api_name: "docId"
+
+        field :mode, -> { CloudPDF::Documents::Types::DocumentsImportFromRequestMode }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/CloudPDF/documents/types/documents_import_from_request_dedup_mode.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Documents
+    module Types
+      module DocumentsImportFromRequestDedupMode
+        extend CloudPDF::Internal::Types::Enum
+
+        ALWAYS_CREATE = "always-create"
+        REUSE_EXISTING = "reuse-existing"
+      end
+    end
+  end
+end

data/lib/CloudPDF/documents/types/documents_import_from_request_expected.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Documents
+    module Types
+      # Integrity pins, enforced when present. When absent, the server-observed values become authoritative.
+      class DocumentsImportFromRequestExpected < Internal::Types::Model
+        field :size_bytes, -> { Integer }, optional: true, nullable: false, api_name: "sizeBytes"
+
+        field :sha256, -> { String }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/CloudPDF/documents/types/documents_import_from_request_mode.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Documents
+    module Types
+      module DocumentsImportFromRequestMode
+        extend CloudPDF::Internal::Types::Enum
+
+        SYNC = "sync"
+        ASYNC = "async"
+      end
+    end
+  end
+end

data/lib/CloudPDF/documents/types/documents_import_from_request_source.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Documents
+    module Types
+      # Where CloudPDF pulls the bytes from. The two shapes differ in WHO supplies the authority to read, not in which
+      # storage vendor holds the file.
+      class DocumentsImportFromRequestSource < Internal::Types::Model
+        extend CloudPDF::Internal::Types::Union
+
+        discriminant :kind
+
+        member -> { CloudPDF::Documents::Types::DocumentsImportFromRequestSourceURL }, key: "URL"
+
+        member -> { CloudPDF::Documents::Types::DocumentsImportFromRequestSourceConnection }, key: "CONNECTION"
+      end
+    end
+  end
+end

data/lib/CloudPDF/documents/types/documents_import_from_request_source_connection.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Documents
+    module Types
+      # The operator pre-registered the authority: the request names a connection and a key inside it. Which provider
+      # backs the connection (S3, GCS, Azure Blob, filesystem, ...) is deployment configuration, never wire surface.
+      class DocumentsImportFromRequestSourceConnection < Internal::Types::Model
+        field :connection_id, -> { String }, optional: false, nullable: false, api_name: "connectionId"
+
+        field :key, -> { String }, optional: false, nullable: false
+
+        field :revision, -> { String }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/CloudPDF/documents/types/documents_import_from_request_source_url.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Documents
+    module Types
+      # The caller supplies the authority: a presigned S3/GCS/Azure/R2/MinIO GET, or any HTTPS endpoint the deployment
+      # import policy allows. The URL is a capability — treat it as a secret. CloudPDF never echoes its query string
+      # back in errors, logs, or stored failure reasons.
+      class DocumentsImportFromRequestSourceURL < Internal::Types::Model
+        field :url, -> { String }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/CloudPDF/types/documents_import_from200response.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Types
+    class DocumentsImportFrom200Response < Internal::Types::Model
+      field :tag, -> { CloudPDF::Types::DocumentsImportFrom200ResponseTag }, optional: false, nullable: false
+
+      field :document, -> { CloudPDF::Types::DocumentsImportFrom200ResponseDocument }, optional: false, nullable: false
+    end
+  end
+end

data/lib/CloudPDF/types/documents_import_from200response_document.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Types
+    class DocumentsImportFrom200ResponseDocument < Internal::Types::Model
+      field :id, -> { String }, optional: false, nullable: false
+
+      field :tenant_id, -> { String }, optional: false, nullable: false, api_name: "tenantId"
+
+      field :state, -> { CloudPDF::Types::DocumentsImportFrom200ResponseDocumentState }, optional: false, nullable: false
+
+      field :base_sha, -> { String }, optional: false, nullable: true, api_name: "baseSha"
+
+      field :storage_size_bytes, -> { Integer }, optional: false, nullable: true, api_name: "storageSizeBytes"
+
+      field :metadata, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: true
+
+      field :idempotency_key, -> { String }, optional: false, nullable: true, api_name: "idempotencyKey"
+
+      field :failure_reason, -> { String }, optional: false, nullable: true, api_name: "failureReason"
+
+      field :thumbnail_state, -> { CloudPDF::Types::DocumentsImportFrom200ResponseDocumentThumbnailState }, optional: true, nullable: false, api_name: "thumbnailState"
+
+      field :thumbnail_url, -> { String }, optional: true, nullable: false, api_name: "thumbnailUrl"
+
+      field :created_at, -> { Integer }, optional: false, nullable: false, api_name: "createdAt"
+
+      field :updated_at, -> { Integer }, optional: false, nullable: false, api_name: "updatedAt"
+
+      field :created_by, -> { String }, optional: false, nullable: true, api_name: "createdBy"
+    end
+  end
+end

data/lib/CloudPDF/types/documents_import_from200response_document_state.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Types
+    module DocumentsImportFrom200ResponseDocumentState
+      extend CloudPDF::Internal::Types::Enum
+
+      PENDING = "pending"
+      READY = "ready"
+      FAILED = "failed"
+      DELETING = "deleting"
+    end
+  end
+end

data/lib/CloudPDF/types/documents_import_from200response_document_thumbnail_state.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Types
+    module DocumentsImportFrom200ResponseDocumentThumbnailState
+      extend CloudPDF::Internal::Types::Enum
+
+      PENDING = "pending"
+      READY = "ready"
+      LOCKED = "locked"
+      FAILED = "failed"
+    end
+  end
+end

data/lib/CloudPDF/types/documents_import_from200response_tag.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Types
+    module DocumentsImportFrom200ResponseTag
+      extend CloudPDF::Internal::Types::Enum
+
+      IMPORTED = "imported"
+      DEDUPED = "deduped"
+      ACCEPTED = "accepted"
+    end
+  end
+end

data/lib/CloudPDF/types/documents_import_from202response.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Types
+    class DocumentsImportFrom202Response < Internal::Types::Model
+      field :tag, -> { CloudPDF::Types::DocumentsImportFrom202ResponseTag }, optional: false, nullable: false
+
+      field :document, -> { CloudPDF::Types::DocumentsImportFrom202ResponseDocument }, optional: false, nullable: false
+    end
+  end
+end

data/lib/CloudPDF/types/documents_import_from202response_document.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Types
+    class DocumentsImportFrom202ResponseDocument < Internal::Types::Model
+      field :id, -> { String }, optional: false, nullable: false
+
+      field :tenant_id, -> { String }, optional: false, nullable: false, api_name: "tenantId"
+
+      field :state, -> { CloudPDF::Types::DocumentsImportFrom202ResponseDocumentState }, optional: false, nullable: false
+
+      field :base_sha, -> { String }, optional: false, nullable: true, api_name: "baseSha"
+
+      field :storage_size_bytes, -> { Integer }, optional: false, nullable: true, api_name: "storageSizeBytes"
+
+      field :metadata, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: true
+
+      field :idempotency_key, -> { String }, optional: false, nullable: true, api_name: "idempotencyKey"
+
+      field :failure_reason, -> { String }, optional: false, nullable: true, api_name: "failureReason"
+
+      field :thumbnail_state, -> { CloudPDF::Types::DocumentsImportFrom202ResponseDocumentThumbnailState }, optional: true, nullable: false, api_name: "thumbnailState"
+
+      field :thumbnail_url, -> { String }, optional: true, nullable: false, api_name: "thumbnailUrl"
+
+      field :created_at, -> { Integer }, optional: false, nullable: false, api_name: "createdAt"
+
+      field :updated_at, -> { Integer }, optional: false, nullable: false, api_name: "updatedAt"
+
+      field :created_by, -> { String }, optional: false, nullable: true, api_name: "createdBy"
+    end
+  end
+end

data/lib/CloudPDF/types/documents_import_from202response_document_state.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Types
+    module DocumentsImportFrom202ResponseDocumentState
+      extend CloudPDF::Internal::Types::Enum
+
+      PENDING = "pending"
+      READY = "ready"
+      FAILED = "failed"
+      DELETING = "deleting"
+    end
+  end
+end

data/lib/CloudPDF/types/documents_import_from202response_document_thumbnail_state.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Types
+    module DocumentsImportFrom202ResponseDocumentThumbnailState
+      extend CloudPDF::Internal::Types::Enum
+
+      PENDING = "pending"
+      READY = "ready"
+      LOCKED = "locked"
+      FAILED = "failed"
+    end
+  end
+end

data/lib/CloudPDF/types/documents_import_from202response_tag.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Types
+    module DocumentsImportFrom202ResponseTag
+      extend CloudPDF::Internal::Types::Enum
+
+      IMPORTED = "imported"
+      DEDUPED = "deduped"
+      ACCEPTED = "accepted"
+    end
+  end
+end

data/lib/CloudPDF/types/documents_import_from400response.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Types
+    class DocumentsImportFrom400Response < Internal::Types::Model
+      field :error, -> { CloudPDF::Types::DocumentsImportFrom400ResponseError }, optional: false, nullable: false
+    end
+  end
+end

data/lib/CloudPDF/types/documents_import_from400response_error.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Types
+    class DocumentsImportFrom400ResponseError < Internal::Types::Model
+      field :code, -> { String }, optional: false, nullable: false
+
+      field :message, -> { String }, optional: false, nullable: false
+    end
+  end
+end

data/lib/CloudPDF/types/documents_import_from403response.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Types
+    class DocumentsImportFrom403Response < Internal::Types::Model
+      field :error, -> { CloudPDF::Types::DocumentsImportFrom403ResponseError }, optional: false, nullable: false
+    end
+  end
+end

data/lib/CloudPDF/types/documents_import_from403response_error.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Types
+    class DocumentsImportFrom403ResponseError < Internal::Types::Model
+      field :code, -> { String }, optional: false, nullable: false
+
+      field :message, -> { String }, optional: false, nullable: false
+    end
+  end
+end

data/lib/CloudPDF/types/documents_import_from502response.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Types
+    class DocumentsImportFrom502Response < Internal::Types::Model
+      field :error, -> { CloudPDF::Types::DocumentsImportFrom502ResponseError }, optional: false, nullable: false
+    end
+  end
+end

data/lib/CloudPDF/types/documents_import_from502response_error.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Types
+    class DocumentsImportFrom502ResponseError < Internal::Types::Model
+      field :code, -> { String }, optional: false, nullable: false
+
+      field :message, -> { String }, optional: false, nullable: false
+    end
+  end
+end

data/lib/CloudPDF/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module CloudPDF
-  VERSION = "3.0.0.alpha.5"
+  VERSION = "3.0.0.alpha.7"
 end

data/lib/cloudpdf.rb

@@ -36,6 +36,12 @@ require_relative "CloudPDF/internal/iterators/offset_item_iterator"
 require_relative "CloudPDF/internal/iterators/cursor_page_iterator"
 require_relative "CloudPDF/internal/iterators/offset_page_iterator"
 require_relative "CloudPDF/documents/types/list_documents_request_state"
+require_relative "CloudPDF/documents/types/documents_import_from_request_source_url"
+require_relative "CloudPDF/documents/types/documents_import_from_request_source_connection"
+require_relative "CloudPDF/documents/types/documents_import_from_request_source"
+require_relative "CloudPDF/documents/types/documents_import_from_request_expected"
+require_relative "CloudPDF/documents/types/documents_import_from_request_dedup_mode"
+require_relative "CloudPDF/documents/types/documents_import_from_request_mode"
 require_relative "CloudPDF/documents/types/documents_init_request_dedup_mode"
 require_relative "CloudPDF/documents/types/documents_init_request_upload_preference"
 require_relative "CloudPDF/doc/forms/types/export_data_forms_request_format"
@@ -99,6 +105,22 @@ require_relative "CloudPDF/types/documents_upload_proxy400response_error"
 require_relative "CloudPDF/types/documents_upload_proxy400response"
 require_relative "CloudPDF/types/documents_upload_proxy409response_error"
 require_relative "CloudPDF/types/documents_upload_proxy409response"
+require_relative "CloudPDF/types/documents_import_from200response_tag"
+require_relative "CloudPDF/types/documents_import_from200response_document_state"
+require_relative "CloudPDF/types/documents_import_from200response_document_thumbnail_state"
+require_relative "CloudPDF/types/documents_import_from200response_document"
+require_relative "CloudPDF/types/documents_import_from200response"
+require_relative "CloudPDF/types/documents_import_from202response_tag"
+require_relative "CloudPDF/types/documents_import_from202response_document_state"
+require_relative "CloudPDF/types/documents_import_from202response_document_thumbnail_state"
+require_relative "CloudPDF/types/documents_import_from202response_document"
+require_relative "CloudPDF/types/documents_import_from202response"
+require_relative "CloudPDF/types/documents_import_from400response_error"
+require_relative "CloudPDF/types/documents_import_from400response"
+require_relative "CloudPDF/types/documents_import_from403response_error"
+require_relative "CloudPDF/types/documents_import_from403response"
+require_relative "CloudPDF/types/documents_import_from502response_error"
+require_relative "CloudPDF/types/documents_import_from502response"
 require_relative "CloudPDF/types/documents_list200response_documents_item_state"
 require_relative "CloudPDF/types/documents_list200response_documents_item_thumbnail_state"
 require_relative "CloudPDF/types/documents_list200response_documents_item"
@@ -2006,6 +2028,7 @@ require_relative "CloudPDF/documents/types/documents_commit_request"
 require_relative "CloudPDF/documents/types/download_documents_request"
 require_relative "CloudPDF/documents/types/thumbnail_documents_request"
 require_relative "CloudPDF/documents/types/upload_proxy_documents_request"
+require_relative "CloudPDF/documents/types/documents_import_from_request"
 require_relative "CloudPDF/documents/types/documents_init_request"
 require_relative "CloudPDF/tokens/client"
 require_relative "CloudPDF/tokens/types/issue_tokens_request"

data/reference.md

@@ -1747,6 +1747,124 @@ end
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.documents.<a href="/lib/CloudPDF/documents/client.rb">import_from</a>(tenant_id:, request) -> CloudPDF::Types::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>
+
+```ruby
+client.documents.import_from(tenant_id: "tenantId")
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**tenant_id:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**source:** `CloudPDF::Documents::Types::DocumentsImportFromRequestSource` — Where CloudPDF pulls the bytes from. The two shapes differ in WHO supplies the authority to read, not in which storage vendor holds the file.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**expected:** `CloudPDF::Documents::Types::DocumentsImportFromRequestExpected` — Integrity pins, enforced when present. When absent, the server-observed values become authoritative.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**metadata:** `Internal::Types::Hash[String, Object]` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**idempotency_key:** `String` — Retrying with the same key resumes the same document rather than importing a second copy — including after a 502.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**dedup_mode:** `CloudPDF::Documents::Types::DocumentsImportFromRequestDedupMode` — always-create (default) creates a new document every time. reuse-existing returns a document that already holds the same content instead of storing it twice.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**doc_id:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**mode:** `CloudPDF::Documents::Types::DocumentsImportFromRequestMode` — sync (default) holds the response open for the whole transfer. async answers 202 with the document pending and transfers in the background; it requires a connection source, and filesystem connections additionally require expected.sha256.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `CloudPDF::Documents::RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -1823,7 +1941,7 @@ client.documents.init(
 <dl>
 <dd>
 
-**dedup_mode:** `CloudPDF::Documents::Types::DocumentsInitRequestDedupMode` 
+**dedup_mode:** `CloudPDF::Documents::Types::DocumentsInitRequestDedupMode` — always-create (default) creates a new document every time. reuse-existing returns a document that already holds the same content instead of storing it twice.
     
 </dd>
 </dl>

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cloudpdf
 version: !ruby/object:Gem::Version
-  version: 3.0.0.alpha.5
+  version: 3.0.0.alpha.7
 platform: ruby
 authors:
 - CloudPDF
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-18 00:00:00.000000000 Z
+date: 2026-08-23 00:00:00.000000000 Z
 dependencies: []
 description: A typed Ruby client for deployment, tenant, and document operations in
   the CloudPDF API.
@@ -57,6 +57,13 @@ files:
 - lib/CloudPDF/documents/client.rb
 - lib/CloudPDF/documents/types/delete_documents_request.rb
 - lib/CloudPDF/documents/types/documents_commit_request.rb
+- lib/CloudPDF/documents/types/documents_import_from_request.rb
+- lib/CloudPDF/documents/types/documents_import_from_request_dedup_mode.rb
+- lib/CloudPDF/documents/types/documents_import_from_request_expected.rb
+- lib/CloudPDF/documents/types/documents_import_from_request_mode.rb
+- lib/CloudPDF/documents/types/documents_import_from_request_source.rb
+- lib/CloudPDF/documents/types/documents_import_from_request_source_connection.rb
+- lib/CloudPDF/documents/types/documents_import_from_request_source_url.rb
 - lib/CloudPDF/documents/types/documents_init_request.rb
 - lib/CloudPDF/documents/types/documents_init_request_dedup_mode.rb
 - lib/CloudPDF/documents/types/documents_init_request_upload_preference.rb
@@ -1933,6 +1940,22 @@ files:
 - lib/CloudPDF/types/documents_get403response_error.rb
 - lib/CloudPDF/types/documents_get404response.rb
 - lib/CloudPDF/types/documents_get404response_error.rb
+- lib/CloudPDF/types/documents_import_from200response.rb
+- lib/CloudPDF/types/documents_import_from200response_document.rb
+- lib/CloudPDF/types/documents_import_from200response_document_state.rb
+- lib/CloudPDF/types/documents_import_from200response_document_thumbnail_state.rb
+- lib/CloudPDF/types/documents_import_from200response_tag.rb
+- lib/CloudPDF/types/documents_import_from202response.rb
+- lib/CloudPDF/types/documents_import_from202response_document.rb
+- lib/CloudPDF/types/documents_import_from202response_document_state.rb
+- lib/CloudPDF/types/documents_import_from202response_document_thumbnail_state.rb
+- lib/CloudPDF/types/documents_import_from202response_tag.rb
+- lib/CloudPDF/types/documents_import_from400response.rb
+- lib/CloudPDF/types/documents_import_from400response_error.rb
+- lib/CloudPDF/types/documents_import_from403response.rb
+- lib/CloudPDF/types/documents_import_from403response_error.rb
+- lib/CloudPDF/types/documents_import_from502response.rb
+- lib/CloudPDF/types/documents_import_from502response_error.rb
 - lib/CloudPDF/types/documents_init200response.rb
 - lib/CloudPDF/types/documents_init200response_created.rb
 - lib/CloudPDF/types/documents_init200response_created_document.rb