cloudpdf 3.0.0.alpha.1 → 3.0.0.alpha.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7488b5cf7308ffa096afde5f8fa0bd6219ec8f4dbf2fe8cca1700671b7b83cb4
-  data.tar.gz: afd57c62439ba51d770e0c122e0b0ef94031dd134e055ab3b8776097f033a3a5
+  metadata.gz: b5ec1e3dcbab2e8a86b62c6b12abf143cb910cd761c7a84a79f0dd08f29742d4
+  data.tar.gz: 6dd84973a69330b662550ab141cd9fdacd402b897719acae2ec646ce8e7d1c17
 SHA512:
-  metadata.gz: 7724b409b0a4fd39048a65c15d05305786bb36cd5c78138459bb3e118c70cac1a915a8fcb5c67120d594165b803414903a4015069cec85313c3733c1099dd73f
-  data.tar.gz: 890779b93a00d59f7768c812ffe75f4aa0adb6c0d4bf556455b73051540ddb36d6b4eee77b6537f97e776eb5cd4034c4e74fcbcbde31525e7b8847d1b67f2ed8
+  metadata.gz: 7f60322255839de8146968d7606a00509e4450ab4b155792c1da310abe26b7663eebdce558b044f112d7eb2edfd1457f786b8a36997e5d27127cb2fc0a21704f
+  data.tar.gz: 988f29c2e2dd314c287372ff7b84bd21f8ffa8cab5254c50ef2081f74a521214b48975232b0583abce87e1d79addccbb1ce6b8202228696542a28e9c52c77835

data/.fern/metadata.json

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

data/README.md

@@ -30,7 +30,7 @@ require "cloudpdf"
 
 client = CloudPDF::Client.new(token: "<token>")
 
-client.tenants.create(id: "id")
+client.shares.exchange(share_token: "shareToken")
 ```
 
 ## Environments
@@ -58,7 +58,7 @@ client = CloudPDF::Client.new(
 )
 
 begin
-    result = client.tenants.create
+    result = client.shares.exchange
 rescue CloudPDF::Errors::TimeoutError
     puts "API didn't respond before our timeout elapsed"
 rescue CloudPDF::Errors::ServiceUnavailableError
@@ -108,7 +108,7 @@ The SDK defaults to a 60 second timeout. Use the `timeout` option to configure t
 ```ruby
 require "cloudpdf"
 
-response = client.tenants.create(
+response = client.shares.exchange(
     ...,
     timeout: 30  # 30 second timeout
 )
@@ -121,7 +121,7 @@ If you would like to send additional headers as part of the request, use the `ad
 ```ruby
 require "cloudpdf"
 
-response = client.tenants.create(
+response = client.shares.exchange(
     ...,
     request_options: {
         additional_headers: {
@@ -138,7 +138,7 @@ If you would like to send additional query parameters as part of the request, us
 ```ruby
 require "cloudpdf"
 
-response = client.tenants.create(
+response = client.shares.exchange(
     ...,
     request_options: {
         additional_query_parameters: {

data/lib/CloudPDF/client.rb

@@ -28,6 +28,11 @@ module CloudPDF
       @doc ||= CloudPDF::Doc::Client.new(client: @raw_client)
     end
 
+    # @return [CloudPDF::Shares::Client]
+    def shares
+      @shares ||= CloudPDF::Shares::Client.new(client: @raw_client)
+    end
+
     # @return [CloudPDF::Tenants::Client]
     def tenants
       @tenants ||= CloudPDF::Tenants::Client.new(client: @raw_client)

data/lib/CloudPDF/documents/client.rb

@@ -249,8 +249,11 @@ module CloudPDF
         raise error_class.new(response.body, code: code)
       end
 
+      # This bounded origin-mediated fallback must only be used after documents.init returns upload.kind=proxy. Auto
+      # mode prefers a presigned object-store PUT whenever available.
+      #
       # @param request_options [Hash]
-      # @param params [Hash]
+      # @param params [void]
       # @option request_options [String] :base_url
       # @option request_options [Hash{String => Object}] :additional_headers
       # @option request_options [Hash{String => Object}] :additional_query_parameters
@@ -258,14 +261,77 @@ module CloudPDF
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :tenant_id
       # @option params [String] :id
+      # @option params [#read] :file
       #
-      # @return [CloudPDF::Types::DocumentsUploadDirect200Response]
-      def upload_direct(request_options: {}, **params)
+      # @example
+      #   client.documents.upload_proxy(
+      #     tenant_id: "tenantId",
+      #     id: "id",
+      #     file: File.open("document.pdf", "rb")
+      #   )
+      #
+      # @return [CloudPDF::Types::DocumentsUploadProxy200Response]
+      def upload_proxy(request_options: {}, **params)
         params = CloudPDF::Internal::Types::Utils.normalize_keys(params)
+        body = Internal::Multipart::FormData.new
+
+        raise ArgumentError, "file is required" unless params[:file]
+        body.add_file(name: "file", file: params[:file], content_type: "application/pdf")
+
+        request = CloudPDF::Internal::Multipart::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "v1/tenants/#{URI.encode_uri_component(params[:tenant_id].to_s)}/documents/#{URI.encode_uri_component(params[:id].to_s)}/upload-proxy",
+          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::DocumentsUploadProxy200Response.load(response.body)
+        else
+          error_class = CloudPDF::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        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/#{URI.encode_uri_component(params[:id].to_s)}/upload-direct",
+          path: "v1/tenants/#{URI.encode_uri_component(params[:tenant_id].to_s)}/documents/import",
+          body: body,
           request_options: request_options
         )
         begin
@@ -275,7 +341,7 @@ module CloudPDF
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          CloudPDF::Types::DocumentsUploadDirect200Response.load(response.body)
+          CloudPDF::Types::DocumentsImportFrom200Response.load(response.body)
         else
           error_class = CloudPDF::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)

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,13 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Documents
+    module Types
+      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,17 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Documents
+    module Types
+      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,15 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Documents
+    module Types
+      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,11 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Documents
+    module Types
+      class DocumentsImportFromRequestSourceURL < Internal::Types::Model
+        field :url, -> { String }, optional: false, nullable: false
+      end
+    end
+  end
+end

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

@@ -19,6 +19,8 @@ module CloudPDF
         field :doc_id, -> { String }, optional: true, nullable: false, api_name: "docId"
 
         field :upload_ttl_sec, -> { Integer }, optional: true, nullable: false, api_name: "uploadTtlSec"
+
+        field :upload_preference, -> { CloudPDF::Documents::Types::DocumentsInitRequestUploadPreference }, optional: true, nullable: false, api_name: "uploadPreference"
       end
     end
   end

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

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Documents
+    module Types
+      module DocumentsInitRequestUploadPreference
+        extend CloudPDF::Internal::Types::Enum
+
+        AUTO = "auto"
+        PRESIGNED = "presigned"
+        PROXY = "proxy"
+      end
+    end
+  end
+end

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

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Documents
+    module Types
+      class UploadProxyDocumentsRequest < Internal::Types::Model
+        field :tenant_id, -> { String }, optional: false, nullable: false, api_name: "tenantId"
+
+        field :id, -> { String }, optional: false, nullable: false
+
+        field :file, -> { Object }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/CloudPDF/shares/client.rb

@@ -0,0 +1,264 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Shares
+    class Client
+      # @param client [CloudPDF::Internal::Http::RawClient]
+      #
+      # @return [void]
+      def initialize(client:)
+        @client = client
+      end
+
+      # Unauthenticated, but requires a browser Origin header, checked against the grant allowlist. Unknown, revoked,
+      # and disabled tokens are indistinguishable (404). Passphrase-protected grants return 422 SharePasswordRequired
+      # until `password` is supplied. Mounted only when the deployment can sign (HS256 mode).
+      #
+      # @param request_options [Hash]
+      # @param params [CloudPDF::Shares::Types::SharesExchangeRequest]
+      # @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
+      #
+      # @example
+      #   client.shares.exchange(share_token: "shareToken")
+      #
+      # @return [CloudPDF::Types::SharesExchange200Response]
+      def exchange(request_options: {}, **params)
+        params = CloudPDF::Internal::Types::Utils.normalize_keys(params)
+        request = CloudPDF::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "v1/share-sessions",
+          body: CloudPDF::Shares::Types::SharesExchangeRequest.new(params).to_h,
+          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::SharesExchange200Response.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 [Hash]
+      # @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
+      # @option params [Integer, nil] :limit
+      # @option params [String, nil] :cursor
+      # @option params [String, nil] :doc_id
+      #
+      # @example
+      #   client.shares.list(tenant_id: "tenantId")
+      #
+      # @return [CloudPDF::Types::SharesList200Response]
+      def list(request_options: {}, **params)
+        params = CloudPDF::Internal::Types::Utils.normalize_keys(params)
+        query_params = {}
+        query_params["limit"] = params[:limit] if params.key?(:limit)
+        query_params["cursor"] = params[:cursor] if params.key?(:cursor)
+        query_params["docId"] = params[:doc_id] if params.key?(:doc_id)
+
+        request = CloudPDF::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "GET",
+          path: "v1/tenants/#{URI.encode_uri_component(params[:tenant_id].to_s)}/shares",
+          query: query_params,
+          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::SharesList200Response.load(response.body)
+        else
+          error_class = CloudPDF::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # The returned share id IS the public share token. Mounted only when the deployment can sign (HS256 mode) —
+      # exchange mints session JWTs, so grants exist only where minting does.
+      #
+      # @param request_options [Hash]
+      # @param params [CloudPDF::Shares::Types::SharesCreateRequest]
+      # @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.shares.create(
+      #     tenant_id: "tenantId",
+      #     doc_id: "docId",
+      #     scope: ["scope"]
+      #   )
+      #
+      # @return [CloudPDF::Types::SharesCreate200Response]
+      def create(request_options: {}, **params)
+        params = CloudPDF::Internal::Types::Utils.normalize_keys(params)
+        request_data = CloudPDF::Shares::Types::SharesCreateRequest.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)}/shares",
+          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::SharesCreate200Response.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 [Hash]
+      # @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
+      # @option params [String] :share_id
+      #
+      # @example
+      #   client.shares.get(
+      #     tenant_id: "tenantId",
+      #     share_id: "shareId"
+      #   )
+      #
+      # @return [CloudPDF::Types::SharesGet200Response]
+      def get(request_options: {}, **params)
+        params = CloudPDF::Internal::Types::Utils.normalize_keys(params)
+        request = CloudPDF::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "GET",
+          path: "v1/tenants/#{URI.encode_uri_component(params[:tenant_id].to_s)}/shares/#{URI.encode_uri_component(params[:share_id].to_s)}",
+          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::SharesGet200Response.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 [Hash]
+      # @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
+      # @option params [String] :share_id
+      #
+      # @example
+      #   client.shares.delete(
+      #     tenant_id: "tenantId",
+      #     share_id: "shareId"
+      #   )
+      #
+      # @return [untyped]
+      def delete(request_options: {}, **params)
+        params = CloudPDF::Internal::Types::Utils.normalize_keys(params)
+        request = CloudPDF::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "DELETE",
+          path: "v1/tenants/#{URI.encode_uri_component(params[:tenant_id].to_s)}/shares/#{URI.encode_uri_component(params[:share_id].to_s)}",
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise CloudPDF::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        return if code.between?(200, 299)
+
+        error_class = CloudPDF::Errors::ResponseError.subclass_for_code(code)
+        raise error_class.new(response.body, code: code)
+      end
+
+      # @param request_options [Hash]
+      # @param params [CloudPDF::Shares::Types::SharesUpdateRequest]
+      # @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
+      # @option params [String] :share_id
+      #
+      # @example
+      #   client.shares.update(
+      #     tenant_id: "tenantId",
+      #     share_id: "shareId"
+      #   )
+      #
+      # @return [CloudPDF::Types::SharesUpdate200Response]
+      def update(request_options: {}, **params)
+        params = CloudPDF::Internal::Types::Utils.normalize_keys(params)
+        request_data = CloudPDF::Shares::Types::SharesUpdateRequest.new(params).to_h
+        non_body_param_names = %w[tenantId shareId]
+        body = request_data.except(*non_body_param_names)
+
+        request = CloudPDF::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "PATCH",
+          path: "v1/tenants/#{URI.encode_uri_component(params[:tenant_id].to_s)}/shares/#{URI.encode_uri_component(params[:share_id].to_s)}",
+          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::SharesUpdate200Response.load(response.body)
+        else
+          error_class = CloudPDF::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+    end
+  end
+end

data/lib/CloudPDF/shares/types/delete_shares_request.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Shares
+    module Types
+      class DeleteSharesRequest < Internal::Types::Model
+        field :tenant_id, -> { String }, optional: false, nullable: false, api_name: "tenantId"
+
+        field :share_id, -> { String }, optional: false, nullable: false, api_name: "shareId"
+      end
+    end
+  end
+end

data/lib/CloudPDF/shares/types/get_shares_request.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Shares
+    module Types
+      class GetSharesRequest < Internal::Types::Model
+        field :tenant_id, -> { String }, optional: false, nullable: false, api_name: "tenantId"
+
+        field :share_id, -> { String }, optional: false, nullable: false, api_name: "shareId"
+      end
+    end
+  end
+end

data/lib/CloudPDF/shares/types/list_shares_request.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Shares
+    module Types
+      class ListSharesRequest < Internal::Types::Model
+        field :tenant_id, -> { String }, optional: false, nullable: false, api_name: "tenantId"
+
+        field :limit, -> { Integer }, optional: true, nullable: false
+
+        field :cursor, -> { String }, optional: true, nullable: false
+
+        field :doc_id, -> { String }, optional: true, nullable: false, api_name: "docId"
+      end
+    end
+  end
+end