chore: generate CloudPDF Ruby SDK 3.0.0.alpha.7

.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"
 }

cloudpdf-generation.json

@@ -1,12 +1,12 @@
 {
   "language": "ruby",
-  "canonicalVersion": "3.0.0-next.6",
-  "sdkVersion": "3.0.0.alpha.6",
+  "canonicalVersion": "3.0.0-next.7",
+  "sdkVersion": "3.0.0.alpha.7",
   "source": {
     "repository": "embedpdf/embed-pdf-viewer",
     "openapi": "cloudpdf/contract/openapi.json",
-    "openapiSha256": "b3e236a932673e27e05825352e1bc3675369d7505040bf7d7760e542aae8d38d",
-    "gitCommit": "32635f40577b214f6a6b3189a2271425c3a574fd",
+    "openapiSha256": "f6fc610bfd193f278a7e8ec063d9e96b8fef86bdec7ade5e7bc4b19879673147",
+    "gitCommit": "1345fb7a45ee660a352774d29decce25cb54b8ea",
     "gitCommitIsDirty": false
   },
   "fern": {

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"
 

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
 

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"
 

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

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

reference.md

@@ -1801,15 +1801,15 @@ 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>
 
 <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,15 +1825,15 @@ 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>
 
 <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>