trailblazer-endpoint 0.0.2 → 0.0.7

data/test/rails-app/app/concepts/auth/operation/authenticate.rb

@@ -0,0 +1,32 @@
+# FIXME: this is not final, yet!
+class Auth::Operation::Authenticate < Trailblazer::Activity::Railway
+  step :verify_token
+  step :is_token_expired?
+  step :set_current_user
+
+  def verify_token(ctx, request:, **)
+    auth_header = request.headers['Authorization'] || ""
+    jwt_encoded_token = auth_header.split(' ').last
+    ctx[:encoded_jwt_token] = jwt_encoded_token
+
+      # FIXME
+    #raise StandardError if JwtService.expired?(jwt_encoded_token)
+    ctx[:decoded_jwt_token] = Auth::Jwt.decode(jwt_encoded_token)
+  end
+
+  def is_token_expired?(ctx, decoded_jwt_token:, **)
+    expiration_integer = decoded_jwt_token.first['exp']
+    return false if expiration_integer.nil?
+    return false if (expiration_integer - DateTime.now.to_i) <= 0
+    return true
+  end
+
+  def set_current_user(ctx, decoded_jwt_token:, **)
+    user_id = decoded_jwt_token.first['user_id']
+
+    ctx[:current_user] = User.find_by(
+      id: user_id
+    )
+    true # FIXME
+  end
+end

data/test/rails-app/app/concepts/auth/operation/policy.rb

@@ -0,0 +1,9 @@
+module Auth
+  module Operation
+    class Policy
+      def self.call(ctx, domain_ctx:, **)
+        domain_ctx[:params][:policy] == false ? false : true
+      end
+    end
+  end
+end

data/test/rails-app/app/concepts/song/cell/create.rb

@@ -0,0 +1,4 @@
+module Song::Cell
+  class Create < Trailblazer::Cell
+  end
+end

data/test/rails-app/app/concepts/song/cell/new.rb

@@ -0,0 +1,4 @@
+module Song::Cell
+  class New < Trailblazer::Cell
+  end
+end

data/test/rails-app/app/concepts/song/operation/create.rb

@@ -0,0 +1,17 @@
+module Song::Operation
+  class Create < Trailblazer::Operation
+    step :contract
+    step :model
+    # step :validate
+    # step :save
+
+    def model(ctx, params:, **)
+      return unless params[:id]
+      ctx[:model] = Song.new(params[:id])
+    end
+
+    def contract(ctx, **)
+      ctx[:contract] = Struct.new(:errors).new()
+    end
+  end
+end

data/test/rails-app/app/concepts/song/operation/show.rb

@@ -0,0 +1,10 @@
+module Song::Operation
+  class Show < Trailblazer::Operation
+    step :model, Output(:failure) => End(:not_found)
+
+    def model(ctx, params:, **)
+      return unless params[:id] == "1"
+      ctx[:model] = Song.new(params[:id])
+    end
+  end
+end

data/test/rails-app/app/concepts/song/representer.rb

@@ -0,0 +1,5 @@
+class Song::Representer < Representable::Decorator
+  include Representable::JSON
+
+  property :id
+end

data/test/rails-app/app/concepts/song/view/create.erb

@@ -0,0 +1 @@
+<div><%= model %><%= options[:current_user] %></div>

data/test/rails-app/app/concepts/song/view/new.erb

@@ -0,0 +1 @@
+<div><%= model %></div>

data/test/rails-app/app/controllers/api/v1/songs_controller.rb

@@ -0,0 +1,41 @@
+#:controller
+module Api
+  module V1
+    #:endpoint
+    class SongsController < ApplicationController::Api
+      endpoint Song::Operation::Create
+      endpoint Song::Operation::Show do
+        {Output(:not_found) => Track(:not_found)}  # add additional wiring to {domain_activity}
+      end
+    #:endpoint end
+
+      #:create
+      def create
+        endpoint Song::Operation::Create, representer_class: Song::Representer
+      end
+      #:create end
+
+      #~empty
+      def show
+        endpoint Song::Operation::Show, representer_class: Song::Representer
+      end
+
+      def show_with_options
+        endpoint Song::Operation::Show, representer_class: Song::Representer, protocol_failure_block: ->(ctx, endpoint_ctx:, **) { head endpoint_ctx[:status] + 1 }
+      end
+
+      class WithOptionsController < ApplicationController::Api
+        endpoint Song::Operation::Show do {Output(:not_found) => Track(:not_found)} end
+
+        #:show-options
+        def show
+          endpoint Song::Operation::Show, representer_class: Song::Representer,
+            protocol_failure_block: ->(ctx, endpoint_ctx:, **) { head endpoint_ctx[:status] + 1 }
+        end
+        #:show-options end
+      end
+      #~empty end
+    end
+  end
+end
+#:controller end

data/test/rails-app/app/controllers/application_controller.rb

@@ -1,3 +1,10 @@
+require "trailblazer/endpoint/controller"
+
 class ApplicationController < ActionController::Base
-  protect_from_forgery with: :exception
+  def self.current_user_in_domain_ctx
+    ->(_ctx, ((ctx, a), b)) { ctx[:domain_ctx][:current_user] = ctx[:current_user]; [_ctx, [[ctx, a], b]] } # FIXME: extract to lib?
+  end
 end
+
+
+# directive

data/test/rails-app/app/controllers/application_controller/api.rb

@@ -0,0 +1,107 @@
+#:app-controller
+#:app-include
+class ApplicationController::Api < ApplicationController
+  include Trailblazer::Endpoint::Controller.module(api: true, application_controller: true)
+#:app-include end
+
+  def self.options_for_block_options(ctx, controller:, **)
+    response_block = ->(ctx, endpoint_ctx:, **) do
+      controller.render json: endpoint_ctx[:representer], status: endpoint_ctx[:status]
+    end
+
+    {
+      success_block:          response_block,
+      failure_block:          response_block,
+      protocol_failure_block: response_block
+    }
+  end
+
+  directive :options_for_block_options, method(:options_for_block_options)
+#:app-controller end
+
+#:options_for_endpoint
+  def self.options_for_endpoint(ctx, controller:, **)
+    {
+      request: controller.request,
+      errors_representer_class: App::Api::V1::Representer::Errors,
+      errors: Trailblazer::Endpoint::Adapter::API::Errors.new,
+    }
+  end
+
+  directive :options_for_endpoint, method(:options_for_endpoint)
+#:options_for_endpoint end
+
+#:options_for_domain_ctx
+  def self.options_for_domain_ctx(ctx, controller:, **) # TODO: move to ApplicationController
+    {
+      params: controller.params,
+    }
+  end
+
+  directive :options_for_domain_ctx,    method(:options_for_domain_ctx)
+#:options_for_domain_ctx end
+
+  #:protocol
+  class Protocol < Trailblazer::Endpoint::Protocol
+    step Auth::Operation::Policy, inherit: true, id: :policy, replace: :policy
+    step Subprocess(Auth::Operation::Authenticate), inherit: true, id: :authenticate, replace: :authenticate
+  end
+  #:protocol end
+
+  #:adapter
+  module Adapter
+    class Representable < Trailblazer::Endpoint::Adapter::API
+      step :render # added before End.success
+      step :render_errors, after: :_422_status, magnetic_to: :failure, Output(:success) => Track(:failure)
+      step :render_errors, after: :protocol_failure, magnetic_to: :fail_fast, Output(:success) => Track(:fail_fast), id: :render_protocol_failure_errors
+
+      def render(ctx, domain_ctx:, representer_class:, **) # this is what usually happens in your {Responder}.
+        ctx[:representer] = representer_class.new(domain_ctx[:model] || raise("no model found!"))
+      end
+
+      def render_errors(ctx, errors:, errors_representer_class:, **) # TODO: extract with {render}
+        ctx[:representer] = errors_representer_class.new(errors)
+      end
+
+      Trailblazer::Endpoint::Adapter::API.insert_error_handler_steps!(self)
+      include Trailblazer::Endpoint::Adapter::API::Errors::Handlers # handler methods to set an error message.
+    end # Representable
+  end
+  #:adapter end
+
+puts Trailblazer::Developer.render(Adapter::Representable)
+
+  #:endpoint
+  # app/controllers/application_controller/api.rb
+  endpoint protocol: Protocol, adapter: Adapter::Representable do
+    # {Output(:not_found) => Track(:not_found)}
+    {}
+  end
+  #:endpoint end
+end
+
+
+# header 'Authorization', "Bearer #{result['jwt_token']}" if result['jwt_token']
+
+
+# ΓΞΞ Protocol ΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞ˥
+# | (Start)--->[Authenticate]-->[Policy]-->[Show]----------->((success))  |
+# |                 |            |          | L------------->((failure))  |
+# |                 |            |          L------------->((not_found))  |
+# |                 |            L------------------->((not_authorized))  |
+# |                 L----------------------------->((not_authenticated))  |
+# |                                                     ((invalid_data))  |
+# LΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞ˩
+#--˥˩   ˪
+
+# ΓΞΞ Adapter::Representable ΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞ˥
+# |                                                                                                                                                                                                |
+# | (Start)---> ΓΞΞ Protocol ΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞ˥                                                                                                          |
+#               | (Start)--->[Authenticate]-->[Policy]-->[Show]----------->((success))  |--->[_200_status]--->[render]---------------------------------------------------------------->((success)) |
+#               |                 |            |          | L------------->((failure))  |-˥                                                                                                        |
+#               |                 |            |          L------------->((not_found))  |-|------------------------------->[_404_status]-----------v                                               |
+#               |                 |            L------------------->((not_authorized))  |-|->[handle_not_authorized]------>[_403_status]--->[protocol_failure]--->[render_errors]--->((fail_fast)) |
+#               |                 L----------------------------->((not_authenticated))  |-|->[handle_not_authenticated]--->[_401_status]-----------^                                               |
+#               |                                                     ((invalid_data))  |-┴->[handle_invalid_data]-------->[_422_status]--->[render_errors]--------------------------->((failure)) |
+#               LΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞ˩                                                                                                          |
+# LΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞΞ˩

data/test/rails-app/app/controllers/application_controller/web.rb

@@ -0,0 +1,45 @@
+#:app-include
+#:options
+#:protocol
+#:generic
+class ApplicationController::Web < ApplicationController
+#~pskip
+#~gskip
+  include Trailblazer::Endpoint::Controller.module(dsl: true, application_controller: true)
+#:app-include end
+
+  def self.options_for_endpoint(ctx, controller:, **)
+    {
+      session: controller.session,
+    }
+  end
+
+  directive :options_for_endpoint, method(:options_for_endpoint)
+#:options end
+
+  # directive :options_for_flow_options, method(:options_for_flow_options)
+  # directive :options_for_block_options, method(:options_for_block_options)
+#~pskip end
+  class Protocol < Trailblazer::Endpoint::Protocol
+    # provide method for {step :authenticate}
+    def authenticate(ctx, session:, **)
+      ctx[:current_user] = User.find_by(id: session[:user_id])
+    end
+
+    # provide method for {step :policy}
+    def policy(ctx, domain_ctx:, **)
+      Policy.(domain_ctx)
+    end
+
+    Trailblazer::Endpoint::Protocol::Controller.insert_copy_to_domain_ctx!(self, :current_user => :current_user)
+  end
+#:protocol end
+  Policy = ->(domain_ctx) { domain_ctx[:params][:policy] == "false" ? false : true }
+#~gskip end
+  endpoint protocol: Protocol, adapter: Trailblazer::Endpoint::Adapter::Web
+end
+#:generic end
+
+# do
+#   {Output(:not_found) => Track(:not_found)}
+# end

data/test/rails-app/app/controllers/auth_controller.rb

@@ -0,0 +1,44 @@
+class AuthController < ApplicationController::Web
+  # We could use a fully-fledged operation here, with a contract and whatnot.
+  def self.authenticate(ctx, request:, params:, **)
+    if params[:username] == "yogi@trb.to" && params[:password] == "secret"
+      ctx[:current_user] = User.find_by(email: params[:username])
+
+      return true
+    else
+      return false # let's be extra explicit!
+    end
+  end
+
+  endpoint("sign_in", domain_activity: Class.new(Trailblazer::Activity::Railway)) do
+    # step nil, delete: :domain_activity
+    step nil, delete: :policy
+    step AuthController.method(:authenticate), replace: :authenticate, inherit: true, id: :authenticate
+
+    {}
+  end
+
+  def self.options_for_endpoint(ctx, controller:, **)
+    {
+      params: controller.params,
+      request: controller.request,
+    }
+  end
+
+  directive :options_for_endpoint, method(:options_for_endpoint)
+
+  def sign_in
+    endpoint "sign_in" do |ctx, current_user:, **|
+      session[:user_id] = current_user.id # Working on {session} is HTTP-specific and done in the controller.
+
+      redirect_to dashboard_path
+      # render html: "Yes!"
+    end
+  end
+
+private
+
+  def dashboard_path
+    "/"
+  end
+end

data/test/rails-app/app/controllers/home_controller.rb

@@ -0,0 +1,5 @@
+class HomeController < ApplicationController
+  def dashboard
+    render html: "Yo!"
+  end
+end

data/test/rails-app/app/controllers/songs_controller.rb

@@ -1,26 +1,258 @@
-class SongsController < ApplicationController
-  require "trailblazer/endpoint/rails"
-  include Trailblazer::Endpoint::Controller
+#:endpoint
+#:or
+#:create
+class SongsController < ApplicationController::Web
+  endpoint Song::Operation::Create
 
+#:endpoint end
   def create
-    endpoint Create, path: songs_path, args: [ params, { "user.current" => ::Module } ]
+    endpoint Song::Operation::Create do |ctx, current_user:, model:, **|
+      render html: cell(Song::Cell::Create, model, current_user: current_user)
+    end.Or do |ctx, contract:, **| # validation failure
+      render html: cell(Song::Cell::New, contract)
+    end
+  end
+#:create end
+
+#~oskip
+  class CreateOrController < SongsController
+#~oskip end
+  def create
+    endpoint Song::Operation::Create do |ctx, current_user:, model:, **|
+      render html: cell(Song::Cell::Create, model, current_user: current_user)
+    end.Or do |ctx, contract:, **| # validation failure
+      render json: contract.errors, status: 422
+    end
+  end
+end
+#:or end
+
+  def create_without_block
+    endpoint Song::Operation::Create
+  end
+
+  class CreateWithOptionsController < SongsController
+    #:create-options
+    def create
+      endpoint Song::Operation::Create, session: {user_id: 2} do |ctx, current_user:, model:, **|
+        render html: cell(Song::Cell::Create, model, current_user: current_user)
+      end
+    end
+    #:create-options end
   end
 
-  def update
-    endpoint Update, path: songs_path, args: [params]
+
+  class CreateWithOptionsForDomainCtxController < SongsController
+    #:domain_ctx
+    def create
+      endpoint Song::Operation::Create, options_for_domain_ctx: {params: {id: 999}} do |ctx, model:, **|
+        render html: cell(Song::Cell::Create, model)
+      end
+    end
+    #:domain_ctx end
   end
 
-  def update_with_user
-    endpoint Update, path: songs_path, args: [ params, { "user.current" => ::Module } ]
+  class CreateEndpointCtxController < SongsController
+    #:endpoint_ctx
+    def create
+      endpoint Song::Operation::Create do |ctx, endpoint_ctx:, **|
+        render html: "Created", status: endpoint_ctx[:status]
+      end.Or do |ctx, **| # validation failure
+        #~empty
+        #~empty end
+      end
+    end
+    #:endpoint_ctx end
   end
 
-  def show
-    endpoint Show, path: songs_path, args: [ params, { "user.current" => ::Module } ]
+  # end.Or do |ctx, endpoint_ctx:, **| # validation failure
+  #       render json: endpoint_ctx.keys, status: 422
+  #     end
+
+
+  class CreateWithProtocolFailureController < SongsController
+  #:protocol_failure
+  def create_with_protocol_failure
+    endpoint Song::Operation::Create do |ctx, **|
+      redirect_to dashboard_path
+    end.protocol_failure do |ctx, **|
+      render html: "wrong login, app crashed", status: 500
+    end
+  end
+  #:protocol_failure end
   end
 
-  def create_with_custom_handlers
-    endpoint Create, path: songs_path, args: [ params, { "user.current" => ::Module } ] do |m|
-      m.created { |result| render json: result["representer.serializer.class"].new(result["model"]), status: 999 }
+
+  # endpoint_ctx
+  #   :resume_data
+  #   domain_ctx
+  #     :resume_data (copy)
+
+
+  # authenticate
+
+  # deserialize ==> {resume_data: {id: 1}}
+  # deserialize_process_model_id_from_resume_data
+
+  # find_process_model
+  # policy
+  # domain_activity
+
+  # serialize suspend_data and deserialize resume_data
+  class SerializeController < SongsController
+    endpoint Song::Operation::Create,
+      protocol: ApplicationController::Web::Protocol
+            # serialize: true
+
+    def self.options_for_block_options(ctx, **)
+      {
+        invoke: Trailblazer::Developer.method(:wtf?) # FIXME
+      }
+    end
+
+
+    def self.options_for_endpoint(ctx, controller:, **)
+      {
+        cipher_key: Rails.application.config.cipher_key,
+
+        encrypted_resume_data: controller.params[:encrypted_resume_data],
+      }
+    end
+
+    directive :options_for_block_options, method(:options_for_block_options)
+    directive :options_for_endpoint, method(:options_for_endpoint)
+
+    def create
+      encrypted_value = Trailblazer::Workflow::Cipher.encrypt_value({}, cipher_key: cipher_key, value: JSON.dump({id: "findings received", class: Object}))
+
+      endpoint Song::Operation::Create, encrypted_resume_data: encrypted_value, process_model_from_resume_data: false do |ctx, current_user:, endpoint_ctx:, **|
+        render html: cell(Song::Cell::Create, model, current_user: current_user)
+      end.Or do |ctx, contract:, **| # validation failure
+        render html: cell(Song::Cell::New, contract)
+      end
+    end
+  end
+
+  # TODO: not really a doc test.
+# the entire deserialize cycle is skipped since we only use {:serialize}
+  class Serialize1Controller < SerializeController
+    class Create < Trailblazer::Operation
+      pass ->(ctx, **) { ctx[:model] = ctx.key?(:model) ? ctx[:model] : false }
+    end
+
+    endpoint "Create",
+      domain_activity: Create,
+      serialize: true,
+      deserialize: true
+
+    def create
+      # {:model} and {:memory} are from the domain_ctx.
+      # {:encrypted_suspend_data} from endpoint.
+      endpoint "Create" do |ctx, model:, endpoint_ctx:, **|
+        render html: "#{model.inspect}/#{ctx[:memory].inspect}/#{endpoint_ctx[:encrypted_suspend_data]}".html_safe
+      end.Or do |ctx, **| # validation failure
+        render html: "xxx", status: 500
+      end
+    end
+  end
+
+    # TODO: not really a doc test.
+# ---------deserialize cycle is skipped.
+# we serialize {:remember}.
+  class Serialize2Controller < Serialize1Controller # "render confirm page"
+    class Create < Trailblazer::Operation
+      pass ->(ctx, **) { ctx[:model] = ctx.key?(:model) ? ctx[:model] : false }
+      step ->(ctx, **) { ctx[:suspend_data] = {remember: OpenStruct.new(id: 1), id: 9} }   # write to domain_ctx[:suspend_data]
+    end
+
+    endpoint "Create",
+      domain_activity: Create,
+      serialize: true
+  end
+
+  # we can read from {:resume_data}
+  class Serialize3Controller < Serialize1Controller # "process submitted confirm page"
+    class Create < Trailblazer::Operation
+      pass ->(ctx, **) { ctx[:model] = ctx.key?(:model) ? ctx[:model] : false }
+      pass ->(ctx, **) { ctx[:memory] = ctx[:resume_data] }                           # read/process the suspended data
+    end
+
+    endpoint "Create",
+      domain_activity: Create,
+      deserialize: true
+  end
+
+# find process_model via id in suspend/resume data (used to be called {process_model_from_resume_data})
+  class Serialize4Controller < Serialize1Controller
+    class Create < Trailblazer::Operation
+      pass ->(ctx, **) { ctx[:model] = ctx.key?(:model) ? ctx[:model] : false }
+      pass ->(ctx, **) { ctx[:memory] = ctx[:resume_data] }                           # read/process the suspended data
+    end
+
+    endpoint "Create",
+      domain_activity: Create,
+      deserialize: true,
+      find_process_model: true,
+      deserialize_process_model_id_from_resume_data: true
+
+    def create
+      endpoint "Create", process_model_class: Song do |ctx, endpoint_ctx:, **|
+        render html: "#{endpoint_ctx[:process_model_id].inspect}/#{ctx[:memory].inspect}/#{endpoint_ctx[:encrypted_suspend_data]}".html_safe
+      end
+    end
+  end
+
+  # find process_model from resume
+  # FIXME: what is the diff to Controller4?
+  class Serialize5Controller < Serialize1Controller
+    endpoint "Create",
+      domain_activity: Serialize4Controller::Create,
+      deserialize: true,
+      find_process_model: true,
+      deserialize_process_model_id_from_resume_data: true
+
+    def create
+      endpoint "Create", find_process_model: true, process_model_class: Song, process_model_id: params[:id] do |ctx, model:, endpoint_ctx:, **|
+        render html: "#{model.inspect}/#{ctx[:memory].inspect}/#{endpoint_ctx[:encrypted_suspend_data]}".html_safe
+      end
+    end
+  end
+
+  # find process_model from action_options
+  class Serialize6Controller < Serialize1Controller
+    endpoint "Create",
+      domain_activity: Serialize4Controller::Create,
+      protocol: ApplicationController::Web::Protocol,
+      find_process_model: true
+
+    def create
+      endpoint "Create", find_process_model: true, process_model_class: Song, process_model_id: params[:id] do |ctx, model:, endpoint_ctx:, **|
+        render html: "#{model.inspect}/#{endpoint_ctx[:process_model].inspect}/#{endpoint_ctx[:encrypted_suspend_data]}".html_safe
+      end
+    end
+  end
+
+# Configure only {:find_process_model} and {:protocol}.
+  class Serialize7Controller < Serialize1Controller
+    endpoint find_process_model: true # generic setting for all endpoints in this controller.
+
+    endpoint "Create", # no need to specify {:find_process_model}
+      domain_activity: Serialize4Controller::Create
+
+    endpoint "New",
+      find_process_model: false,
+      domain_activity: Serialize4Controller::Create
+
+    def create
+      endpoint "Create", process_model_class: Song, process_model_id: params[:id] do |ctx, model:, endpoint_ctx:, **|
+        render html: "#{model.inspect}/#{endpoint_ctx[:process_model].inspect}/#{endpoint_ctx[:encrypted_suspend_data]}".html_safe
+      end
+    end
+
+    def new
+      endpoint "New", process_model_class: Song, process_model_id: params[:id] do |ctx, model:, endpoint_ctx:, **|
+        render html: "#{model.inspect}/#{endpoint_ctx[:process_model].inspect}/#{endpoint_ctx[:encrypted_suspend_data]}".html_safe
+      end
     end
   end
 end