cloudpdf 3.0.0.alpha.6 → 3.0.0.alpha.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b5ec1e3dcbab2e8a86b62c6b12abf143cb910cd761c7a84a79f0dd08f29742d4
-  data.tar.gz: 6dd84973a69330b662550ab141cd9fdacd402b897719acae2ec646ce8e7d1c17
+  metadata.gz: 3b5d667e02d713992d73f05628e284f88296a6ba5074f4a7a3ba39973a508bd4
+  data.tar.gz: 31ca047a8eb76373d2364fef4849a249f88734866c5c42b40ed3bc02177b0973
 SHA512:
-  metadata.gz: 7f60322255839de8146968d7606a00509e4450ab4b155792c1da310abe26b7663eebdce558b044f112d7eb2edfd1457f786b8a36997e5d27127cb2fc0a21704f
-  data.tar.gz: 988f29c2e2dd314c287372ff7b84bd21f8ffa8cab5254c50ef2081f74a521214b48975232b0583abce87e1d79addccbb1ce6b8202228696542a28e9c52c77835
+  metadata.gz: f7dc2d0efc8f66899706f4d643d87efeefd2115d3114bde0f672a2f3bd4a9fe5fa35cc2655e9e6e18cfd67bf8bf308d7ce51255a2a06b028a2d20de4490ec91e
+  data.tar.gz: 12477c22fa854372c21584dbfb83931e2e318497ee761988c0f8e5baef7aad6a098e59baf465bb5da433475713dea1fd831c68df79dcdb7c04a803f2105d9665

data/.fern/metadata.json

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

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

@@ -3,6 +3,7 @@
 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"
 

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

@@ -3,6 +3,8 @@
 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
 

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

@@ -3,6 +3,8 @@
 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"
 

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

@@ -3,6 +3,9 @@
 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

data/lib/CloudPDF/version.rb

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

data/reference.md

@@ -1801,7 +1801,7 @@ client.documents.import_from(tenant_id: "tenantId")
 <dl>
 <dd>
 
-**source:** `CloudPDF::Documents::Types::DocumentsImportFromRequestSource` 
+**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>
@@ -1809,7 +1809,7 @@ client.documents.import_from(tenant_id: "tenantId")
 <dl>
 <dd>
 
-**expected:** `CloudPDF::Documents::Types::DocumentsImportFromRequestExpected` 
+**expected:** `CloudPDF::Documents::Types::DocumentsImportFromRequestExpected` — Integrity pins, enforced when present. When absent, the server-observed values become authoritative.
     
 </dd>
 </dl>
@@ -1825,7 +1825,7 @@ client.documents.import_from(tenant_id: "tenantId")
 <dl>
 <dd>
 
-**idempotency_key:** `String` 
+**idempotency_key:** `String` — Retrying with the same key resumes the same document rather than importing a second copy — including after a 502.
     
 </dd>
 </dl>
@@ -1833,7 +1833,7 @@ client.documents.import_from(tenant_id: "tenantId")
 <dl>
 <dd>
 
-**dedup_mode:** `CloudPDF::Documents::Types::DocumentsImportFromRequestDedupMode` 
+**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>
@@ -1849,7 +1849,7 @@ client.documents.import_from(tenant_id: "tenantId")
 <dl>
 <dd>
 
-**mode:** `CloudPDF::Documents::Types::DocumentsImportFromRequestMode` 
+**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>
@@ -1941,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.6
+  version: 3.0.0.alpha.7
 platform: ruby
 authors:
 - CloudPDF
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-20 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.