cloudpdf 3.0.0.alpha.16 → 3.0.0.alpha.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 81871e1f5897ccc38465c834a4bd5760587c0d528e3c283861ebdd853c3c5dfc
-  data.tar.gz: 0626e99109220d23d6c09b34bdbd5971619b33f06e7eb629612a3e0ff75aa1a2
+  metadata.gz: 6e95ed59ffc794a7e8f609249f54ae8776c826a6fa0b9ab2924339ff7021c5ca
+  data.tar.gz: b029d01ffb43183c13b30f52c9a854e0ee8ae4796bf922a722fc43a695eabba8
 SHA512:
-  metadata.gz: 8ea2ffa790ad659239c9989b945b2a774a5ce5c2a1d645c4e4f02eb35b30aa9fcb4fc0a8e3eb1059f6adf3bdba5542c75f01bd71efecae8364e04fb9e3661fe6
-  data.tar.gz: 66240f643173f35416e00bacacae4ff2a2f839ac615ac26e629420b2be871d8076025a58d17cbdb99e3230297548eef06a6f3f14578806d601f1bf1a68d95f65
+  metadata.gz: 47c9670feae8fd960afb50c873552be12bd6698666f384a36ec4e1ebe8415ea97f6e714e4a630dd0c8694e75578122520f8adf983842b5e2b453a6db2dbf2845
+  data.tar.gz: 05e5c4076118baa3cba478feb0f59a0d088b142e795ecb80e02e112adb25c97ed9fb9161886982f4b0884351a4511101cafba8e1c5ccfd8b102b5d8f63ede18d

data/.fern/metadata.json

@@ -5,9 +5,9 @@
   "generatorConfig": {
     "moduleName": "CloudPDF"
   },
-  "originGitCommit": "7ded7de29f4cc0dc9da18042fca6afd5c9557bfc",
+  "originGitCommit": "07aa3f26c82243b36a5ec94f7072130c7298d977",
   "originGitCommitIsDirty": false,
   "invokedBy": "ci",
-  "requestedVersion": "3.0.0.alpha.16",
+  "requestedVersion": "3.0.0.alpha.17",
   "ciProvider": "github"
 }

data/lib/CloudPDF/doc/client.rb

@@ -157,6 +157,61 @@ module CloudPDF
         raise error_class.new(response.body, code: code)
       end
 
+      # The link opens the layer as it is when created: once the layer changes, it answers 404, so create it right
+      # before handing it over. It downloads that one file and nothing else, and a password-protected document is
+      # checked when the link is created. Deployments that verify tokens with their own keys (JWKS) mint links on their
+      # backend: a doc token with `layer_name`, a `download: { docVersion, mode: "incremental" }` claim and a short
+      # `exp`, passed as `link` on the versioned download URL.
+      #
+      # @param request_options [Hash]
+      # @param params [CloudPDF::Doc::Types::DocDownloadLinkRequest]
+      # @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] :doc_id
+      # @option params [String] :layer_name
+      # @option params [String, nil] :document_password
+      #
+      # @example
+      #   client.doc.download_link(
+      #     doc_id: "docId",
+      #     layer_name: "layerName"
+      #   )
+      #
+      # @return [CloudPDF::Types::DocDownloadLink200Response]
+      def download_link(request_options: {}, **params)
+        params = CloudPDF::Internal::Types::Utils.normalize_keys(params)
+        request_data = CloudPDF::Doc::Types::DocDownloadLinkRequest.new(params).to_h
+        non_body_param_names = %w[docId layerName X-Document-Password]
+        body = request_data.except(*non_body_param_names)
+
+        headers = {}
+        headers["X-Document-Password"] = params[:document_password] if params[:document_password]
+
+        request = CloudPDF::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "v1/docs/#{URI.encode_uri_component(params[:doc_id].to_s)}/layers/#{URI.encode_uri_component(params[:layer_name].to_s)}/download-link",
+          headers: headers,
+          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)
+          (response.body.to_s.empty? ? nil : CloudPDF::Types::DocDownloadLink200Response.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

data/lib/CloudPDF/doc/types/doc_download_link_request.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Doc
+    module Types
+      class DocDownloadLinkRequest < Internal::Types::Model
+        field :doc_id, -> { String }, optional: false, nullable: false, api_name: "docId"
+
+        field :layer_name, -> { String }, optional: false, nullable: false, api_name: "layerName"
+
+        field :document_password, -> { String }, optional: true, nullable: false, api_name: "X-Document-Password"
+
+        field :expires_in, -> { Integer }, optional: true, nullable: false, api_name: "expiresIn"
+      end
+    end
+  end
+end

data/lib/CloudPDF/documents/client.rb

@@ -392,6 +392,11 @@ module CloudPDF
           raise error_class.new(response.body, code: code)
         end
       end
+
+      # @return [CloudPDF::Layers::Client]
+      def layers
+        @layers ||= CloudPDF::Documents::Layers::Client.new(client: @client)
+      end
     end
   end
 end

data/lib/CloudPDF/documents/layers/client.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Documents
+    module Layers
+      class Client
+        # @param client [CloudPDF::Internal::Http::RawClient]
+        #
+        # @return [void]
+        def initialize(client:)
+          @client = client
+        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] :id
+        # @option params [Integer, nil] :limit
+        # @option params [String, nil] :cursor
+        # @option params [String, nil] :share_id
+        #
+        # @example
+        #   client.documents.layers.list(
+        #     tenant_id: "tenantId",
+        #     id: "id"
+        #   )
+        #
+        # @return [CloudPDF::Types::DocumentsLayersList200Response]
+        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["shareId"] = params[:share_id] if params.key?(:share_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)}/documents/#{URI.encode_uri_component(params[:id].to_s)}/layers",
+            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)
+            (response.body.to_s.empty? ? nil : CloudPDF::Types::DocumentsLayersList200Response.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] :id
+        # @option params [String] :layer_name
+        #
+        # @example
+        #   client.documents.layers.delete(
+        #     tenant_id: "tenantId",
+        #     id: "id",
+        #     layer_name: "layerName"
+        #   )
+        #
+        # @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)}/documents/#{URI.encode_uri_component(params[:id].to_s)}/layers/#{URI.encode_uri_component(params[:layer_name].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
+      end
+    end
+  end
+end

data/lib/CloudPDF/documents/layers/types/delete_layers_request.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Documents
+    module Layers
+      module Types
+        class DeleteLayersRequest < Internal::Types::Model
+          field :tenant_id, -> { String }, optional: false, nullable: false, api_name: "tenantId"
+
+          field :id, -> { String }, optional: false, nullable: false
+
+          field :layer_name, -> { String }, optional: false, nullable: false, api_name: "layerName"
+        end
+      end
+    end
+  end
+end

data/lib/CloudPDF/documents/layers/types/list_layers_request.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Documents
+    module Layers
+      module Types
+        class ListLayersRequest < Internal::Types::Model
+          field :tenant_id, -> { String }, optional: false, nullable: false, api_name: "tenantId"
+
+          field :id, -> { String }, optional: false, nullable: false
+
+          field :limit, -> { Integer }, optional: true, nullable: false
+
+          field :cursor, -> { String }, optional: true, nullable: false
+
+          field :share_id, -> { String }, optional: true, nullable: false, api_name: "shareId"
+        end
+      end
+    end
+  end
+end

data/lib/CloudPDF/shares/client.rb

@@ -12,7 +12,12 @@ module CloudPDF
 
       # 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).
+      # until `password` is supplied. A link that asks its visitors who they are on open returns 422
+      # VisitorIdentityRequired until the required answers are given; `error.details` carries `fields` (what the link
+      # asks), `missing`, `invalid`, `purpose` and `privacyUrl`. A link that asks before the first change issues the
+      # session at once with `visitor.identityRequest`, and writes answer 403 VisitorIdentityRequired with the same
+      # details until the visitor exchanges again with their answers. Answers that can not be taken answer 422 on any
+      # link. Mounted only when the deployment can sign (HS256 mode).
       #
       # @param request_options [Hash]
       # @param params [CloudPDF::Shares::Types::SharesExchangeRequest]
@@ -60,6 +65,7 @@ module CloudPDF
       # @option params [Integer, nil] :limit
       # @option params [String, nil] :cursor
       # @option params [String, nil] :doc_id
+      # @option params [Boolean, nil] :archived
       #
       # @example
       #   client.shares.list(tenant_id: "tenantId")
@@ -71,6 +77,7 @@ module CloudPDF
         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)
+        query_params["archived"] = params[:archived] if params.key?(:archived)
 
         request = CloudPDF::Internal::JSON::Request.new(
           base_url: request_options[:base_url],
@@ -259,6 +266,54 @@ module CloudPDF
           raise error_class.new(response.body, code: code)
         end
       end
+
+      # Archiving is final: an archived link never exchanges again, and to share again you create a new link. Pausing
+      # (`disabled`) is the reversible stop. An archived link no longer counts as using its shared layer, so that layer
+      # can be deleted.
+      #
+      # @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.archive(
+      #     tenant_id: "tenantId",
+      #     share_id: "shareId"
+      #   )
+      #
+      # @return [CloudPDF::Types::SharesArchive200Response]
+      def archive(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/tenants/#{URI.encode_uri_component(params[:tenant_id].to_s)}/shares/#{URI.encode_uri_component(params[:share_id].to_s)}/archive",
+          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)
+          (response.body.to_s.empty? ? nil : CloudPDF::Types::SharesArchive200Response.load(response.body))
+        else
+          error_class = CloudPDF::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # @return [CloudPDF::Visitors::Client]
+      def visitors
+        @visitors ||= CloudPDF::Shares::Visitors::Client.new(client: @client)
+      end
     end
   end
 end

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

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Shares
+    module Types
+      class ArchiveSharesRequest < 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

@@ -11,6 +11,8 @@ module CloudPDF
         field :cursor, -> { String }, optional: true, nullable: false
 
         field :doc_id, -> { String }, optional: true, nullable: false, api_name: "docId"
+
+        field :archived, -> { Internal::Types::Boolean }, optional: true, nullable: false
       end
     end
   end

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

@@ -8,8 +8,16 @@ module CloudPDF
 
         field :doc_id, -> { String }, optional: false, nullable: false, api_name: "docId"
 
+        field :layer_mode, -> { CloudPDF::Shares::Types::SharesCreateRequestLayerMode }, optional: true, nullable: false, api_name: "layerMode"
+
         field :layer_name, -> { String }, optional: true, nullable: false, api_name: "layerName"
 
+        field :keep_visitor_layers, -> { Internal::Types::Boolean }, optional: true, nullable: false, api_name: "keepVisitorLayers"
+
+        field :visitor_idle_seconds, -> { Integer }, optional: true, nullable: false, api_name: "visitorIdleSeconds"
+
+        field :visitor_identity, -> { CloudPDF::Shares::Types::SharesCreateRequestVisitorIdentity }, optional: true, nullable: false, api_name: "visitorIdentity"
+
         field :scope, -> { Internal::Types::Array[String] }, optional: false, nullable: false
 
         field :origins, -> { Internal::Types::Array[String] }, optional: true, nullable: false

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

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Shares
+    module Types
+      module SharesCreateRequestLayerMode
+        extend CloudPDF::Internal::Types::Enum
+
+        SHARED = "shared"
+        PER_VISITOR = "per-visitor"
+      end
+    end
+  end
+end

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

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Shares
+    module Types
+      class SharesCreateRequestVisitorIdentity < Internal::Types::Model
+        field :fields, -> { CloudPDF::Shares::Types::SharesCreateRequestVisitorIdentityFields }, optional: false, nullable: false
+
+        field :ask, -> { CloudPDF::Shares::Types::SharesCreateRequestVisitorIdentityAsk }, optional: false, nullable: false
+
+        field :purpose, -> { String }, optional: true, nullable: false
+
+        field :privacy_url, -> { String }, optional: true, nullable: false, api_name: "privacyUrl"
+      end
+    end
+  end
+end

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

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Shares
+    module Types
+      module SharesCreateRequestVisitorIdentityAsk
+        extend CloudPDF::Internal::Types::Enum
+
+        ON_OPEN = "on-open"
+        BEFORE_FIRST_CHANGE = "before-first-change"
+      end
+    end
+  end
+end

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

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Shares
+    module Types
+      class SharesCreateRequestVisitorIdentityFields < Internal::Types::Model
+        field :display_name, -> { CloudPDF::Shares::Types::SharesCreateRequestVisitorIdentityFieldsDisplayName }, optional: true, nullable: false, api_name: "displayName"
+
+        field :email, -> { CloudPDF::Shares::Types::SharesCreateRequestVisitorIdentityFieldsEmail }, optional: true, nullable: false
+
+        field :title, -> { CloudPDF::Shares::Types::SharesCreateRequestVisitorIdentityFieldsTitle }, optional: true, nullable: false
+
+        field :organization, -> { CloudPDF::Shares::Types::SharesCreateRequestVisitorIdentityFieldsOrganization }, optional: true, nullable: false
+
+        field :organizational_unit, -> { CloudPDF::Shares::Types::SharesCreateRequestVisitorIdentityFieldsOrganizationalUnit }, optional: true, nullable: false, api_name: "organizationalUnit"
+      end
+    end
+  end
+end

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

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Shares
+    module Types
+      module SharesCreateRequestVisitorIdentityFieldsDisplayName
+        extend CloudPDF::Internal::Types::Enum
+
+        REQUIRED = "required"
+        OPTIONAL = "optional"
+      end
+    end
+  end
+end

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

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Shares
+    module Types
+      module SharesCreateRequestVisitorIdentityFieldsEmail
+        extend CloudPDF::Internal::Types::Enum
+
+        REQUIRED = "required"
+        OPTIONAL = "optional"
+      end
+    end
+  end
+end

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

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Shares
+    module Types
+      module SharesCreateRequestVisitorIdentityFieldsOrganization
+        extend CloudPDF::Internal::Types::Enum
+
+        REQUIRED = "required"
+        OPTIONAL = "optional"
+      end
+    end
+  end
+end

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

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Shares
+    module Types
+      module SharesCreateRequestVisitorIdentityFieldsOrganizationalUnit
+        extend CloudPDF::Internal::Types::Enum
+
+        REQUIRED = "required"
+        OPTIONAL = "optional"
+      end
+    end
+  end
+end

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

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Shares
+    module Types
+      module SharesCreateRequestVisitorIdentityFieldsTitle
+        extend CloudPDF::Internal::Types::Enum
+
+        REQUIRED = "required"
+        OPTIONAL = "optional"
+      end
+    end
+  end
+end

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

@@ -7,6 +7,12 @@ module CloudPDF
         field :share_token, -> { String }, optional: false, nullable: false, api_name: "shareToken"
 
         field :password, -> { String }, optional: true, nullable: false
+
+        field :visitor_handle, -> { String }, optional: true, nullable: false, api_name: "visitorHandle"
+
+        field :restart, -> { Internal::Types::Boolean }, optional: true, nullable: false
+
+        field :visitor_identity, -> { CloudPDF::Shares::Types::SharesExchangeRequestVisitorIdentity }, optional: true, nullable: false, api_name: "visitorIdentity"
       end
     end
   end

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

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Shares
+    module Types
+      class SharesExchangeRequestVisitorIdentity < Internal::Types::Model
+        field :display_name, -> { String }, optional: true, nullable: false, api_name: "displayName"
+
+        field :email, -> { String }, optional: true, nullable: false
+
+        field :title, -> { String }, optional: true, nullable: false
+
+        field :organization, -> { String }, optional: true, nullable: false
+
+        field :organizational_unit, -> { String }, optional: true, nullable: false, api_name: "organizationalUnit"
+      end
+    end
+  end
+end

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

@@ -8,6 +8,16 @@ module CloudPDF
 
         field :share_id, -> { String }, optional: false, nullable: false, api_name: "shareId"
 
+        field :layer_mode, -> { CloudPDF::Shares::Types::SharesUpdateRequestLayerMode }, optional: true, nullable: false, api_name: "layerMode"
+
+        field :layer_name, -> { String }, optional: true, nullable: false, api_name: "layerName"
+
+        field :keep_visitor_layers, -> { Internal::Types::Boolean }, optional: true, nullable: false, api_name: "keepVisitorLayers"
+
+        field :visitor_idle_seconds, -> { Integer }, optional: true, nullable: false, api_name: "visitorIdleSeconds"
+
+        field :visitor_identity, -> { CloudPDF::Shares::Types::SharesUpdateRequestVisitorIdentity }, optional: true, nullable: false, api_name: "visitorIdentity"
+
         field :scope, -> { Internal::Types::Array[String] }, optional: true, nullable: false
 
         field :origins, -> { Internal::Types::Array[String] }, optional: true, nullable: false

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

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Shares
+    module Types
+      module SharesUpdateRequestLayerMode
+        extend CloudPDF::Internal::Types::Enum
+
+        SHARED = "shared"
+        PER_VISITOR = "per-visitor"
+      end
+    end
+  end
+end

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

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Shares
+    module Types
+      class SharesUpdateRequestVisitorIdentity < Internal::Types::Model
+        field :fields, -> { CloudPDF::Shares::Types::SharesUpdateRequestVisitorIdentityFields }, optional: false, nullable: false
+
+        field :ask, -> { CloudPDF::Shares::Types::SharesUpdateRequestVisitorIdentityAsk }, optional: false, nullable: false
+
+        field :purpose, -> { String }, optional: true, nullable: false
+
+        field :privacy_url, -> { String }, optional: true, nullable: false, api_name: "privacyUrl"
+      end
+    end
+  end
+end

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

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Shares
+    module Types
+      module SharesUpdateRequestVisitorIdentityAsk
+        extend CloudPDF::Internal::Types::Enum
+
+        ON_OPEN = "on-open"
+        BEFORE_FIRST_CHANGE = "before-first-change"
+      end
+    end
+  end
+end

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

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module CloudPDF
+  module Shares
+    module Types
+      class SharesUpdateRequestVisitorIdentityFields < Internal::Types::Model
+        field :display_name, -> { CloudPDF::Shares::Types::SharesUpdateRequestVisitorIdentityFieldsDisplayName }, optional: true, nullable: false, api_name: "displayName"
+
+        field :email, -> { CloudPDF::Shares::Types::SharesUpdateRequestVisitorIdentityFieldsEmail }, optional: true, nullable: false
+
+        field :title, -> { CloudPDF::Shares::Types::SharesUpdateRequestVisitorIdentityFieldsTitle }, optional: true, nullable: false
+
+        field :organization, -> { CloudPDF::Shares::Types::SharesUpdateRequestVisitorIdentityFieldsOrganization }, optional: true, nullable: false
+
+        field :organizational_unit, -> { CloudPDF::Shares::Types::SharesUpdateRequestVisitorIdentityFieldsOrganizationalUnit }, optional: true, nullable: false, api_name: "organizationalUnit"
+      end
+    end
+  end
+end