cloudpdf 3.0.0.alpha.15 → 3.0.0.alpha.17

data/lib/CloudPDF/doc/pages/client.rb

@@ -110,61 +110,13 @@ module CloudPDF
           end
         end
 
-        # @param request_options [Hash]
-        # @param params [CloudPDF::Types::DocPagesDeleteRequest]
-        # @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
-        # @option params [String, nil] :idempotency_key
-        #
-        # @example
-        #   client.doc.pages.delete(
-        #     doc_id: "docId",
-        #     layer_name: "layerName",
-        #     request: {
-        #       key: "value"
-        #     }
-        #   )
-        #
-        # @return [CloudPDF::Types::DocPagesDelete200Response]
-        def delete(request_options: {}, **params)
-          params = CloudPDF::Internal::Types::Utils.normalize_keys(params)
-          path_param_names = %i[doc_id layer_name]
-          body_params = params.except(*path_param_names)
-
-          headers = {}
-          headers["X-Document-Password"] = params[:document_password] if params[:document_password]
-          headers["Idempotency-Key"] = params[:idempotency_key] if params[:idempotency_key]
-
-          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)}/pages/delete",
-            headers: headers,
-            body: body_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::DocPagesDelete200Response.load(response.body))
-          else
-            error_class = CloudPDF::Errors::ResponseError.subclass_for_code(code)
-            raise error_class.new(response.body, code: code)
-          end
-        end
-
         # A read, not a mutation: the source document is untouched and no event is published. Body is `{"pages":
-        # PageRef[]}`; the response body is the new PDF.
+        # PageRef[], "flatten"?: {"usage"?: "display" | "print"}, "includeAnnotations"?: boolean, "includeFormFields"?:
+        # boolean}`; the response body is the new PDF. With `flatten` the copy is the pages as they draw for `usage`
+        # (`"print"`: a print copy): the annotations and form fields painted in, nothing interactive left, layers in
+        # their state for the usage. A flattened copy takes `doc.download` or `doc.download.flattened`, and paints only
+        # what the caller may read; `includeAnnotations` and `includeFormFields` choose what it paints, and are refused
+        # without `flatten`.
         #
         # @param request_options [Hash]
         # @param params [CloudPDF::Types::DocPagesExtractRequest]
@@ -270,117 +222,6 @@ module CloudPDF
           end
         end
 
-        # Multipart: a JSON `body` part `{"position"?: PagePosition, "resources": {"source": "<key>"}}` (position
-        # omitted → the end), and the standalone PDF whose pages are copied in as the part `resource:<key>`. The
-        # inserted copies get fresh page object numbers, returned in insertion order.
-        #
-        # @param request_options [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
-        # @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
-        # @option params [String, nil] :idempotency_key
-        #
-        # @example
-        #   client.doc.pages.insert(
-        #     doc_id: "docId",
-        #     layer_name: "layerName"
-        #   )
-        #
-        # @return [CloudPDF::Types::DocPagesInsert200Response]
-        def insert(request_options: {}, **params)
-          params = CloudPDF::Internal::Types::Utils.normalize_keys(params)
-          body = Internal::Multipart::FormData.new
-
-          if params[:file]
-            body.add_file(
-              name: "file",
-              file: params[:file]
-            )
-          end
-
-          request = CloudPDF::Internal::Multipart::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)}/pages/insert",
-            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::DocPagesInsert200Response.load(response.body))
-          else
-            error_class = CloudPDF::Errors::ResponseError.subclass_for_code(code)
-            raise error_class.new(response.body, code: code)
-          end
-        end
-
-        # Body is `{"size": {"width", "height"}, "count"?, "position"?}` — size in PDF points, count in [1, 100],
-        # `position` a `PagePosition` (omitted → the end).
-        #
-        # @param request_options [Hash]
-        # @param params [CloudPDF::Types::DocPagesInsertBlankRequest]
-        # @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
-        # @option params [String, nil] :idempotency_key
-        #
-        # @example
-        #   client.doc.pages.insert_blank(
-        #     doc_id: "docId",
-        #     layer_name: "layerName",
-        #     request: {
-        #       key: "value"
-        #     }
-        #   )
-        #
-        # @return [CloudPDF::Types::DocPagesInsertBlank200Response]
-        def insert_blank(request_options: {}, **params)
-          params = CloudPDF::Internal::Types::Utils.normalize_keys(params)
-          path_param_names = %i[doc_id layer_name]
-          body_params = params.except(*path_param_names)
-
-          headers = {}
-          headers["X-Document-Password"] = params[:document_password] if params[:document_password]
-          headers["Idempotency-Key"] = params[:idempotency_key] if params[:idempotency_key]
-
-          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)}/pages/insert-blank",
-            headers: headers,
-            body: body_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::DocPagesInsertBlank200Response.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::Types::DocPagesSetNameRequest]
         # @option request_options [String] :base_url
@@ -486,115 +327,6 @@ module CloudPDF
             raise error_class.new(response.body, code: code)
           end
         end
-
-        # @param request_options [Hash]
-        # @param params [CloudPDF::Doc::Pages::Types::DocPagesReorderRequest]
-        # @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
-        # @option params [String, nil] :idempotency_key
-        #
-        # @example
-        #   client.doc.pages.reorder(
-        #     doc_id: "docId",
-        #     layer_name: "layerName",
-        #     pages: [{
-        #       kind: "objectNumber",
-        #       object_number: 1
-        #     }],
-        #     position: "start"
-        #   )
-        #
-        # @return [CloudPDF::Types::DocPagesReorder200Response]
-        def reorder(request_options: {}, **params)
-          params = CloudPDF::Internal::Types::Utils.normalize_keys(params)
-          request_data = CloudPDF::Doc::Pages::Types::DocPagesReorderRequest.new(params).to_h
-          non_body_param_names = %w[docId layerName X-Document-Password Idempotency-Key]
-          body = request_data.except(*non_body_param_names)
-
-          headers = {}
-          headers["X-Document-Password"] = params[:document_password] if params[:document_password]
-          headers["Idempotency-Key"] = params[:idempotency_key] if params[:idempotency_key]
-
-          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)}/pages/reorder",
-            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::DocPagesReorder200Response.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::Types::DocPagesRotateRequest]
-        # @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
-        # @option params [String, nil] :idempotency_key
-        #
-        # @example
-        #   client.doc.pages.rotate(
-        #     doc_id: "docId",
-        #     layer_name: "layerName",
-        #     request: {
-        #       key: "value"
-        #     }
-        #   )
-        #
-        # @return [CloudPDF::Types::DocPagesRotate200Response]
-        def rotate(request_options: {}, **params)
-          params = CloudPDF::Internal::Types::Utils.normalize_keys(params)
-          path_param_names = %i[doc_id layer_name]
-          body_params = params.except(*path_param_names)
-
-          headers = {}
-          headers["X-Document-Password"] = params[:document_password] if params[:document_password]
-          headers["Idempotency-Key"] = params[:idempotency_key] if params[:idempotency_key]
-
-          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)}/pages/rotate",
-            headers: headers,
-            body: body_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::DocPagesRotate200Response.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/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