trek 2.4.0 → 2.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (217) hide show
  1. checksums.yaml +4 -4
  2. data/.node-version +1 -1
  3. data/AGENTS.md +12 -8
  4. data/CHANGELOG.md +62 -0
  5. data/Gemfile +5 -0
  6. data/Gemfile.lock +205 -171
  7. data/Makefile +28 -1
  8. data/README.md +2 -2
  9. data/app/components/trek/dashboard/tile_component/tile_component.css +9 -0
  10. data/app/components/trek/dashboard/tile_component/tile_component.html.slim +4 -2
  11. data/app/components/trek/dashboard/tile_component.rb +12 -2
  12. data/app/components/trek/form/content_editor_component/content_editor_component.css +5 -0
  13. data/app/components/trek/form/content_editor_component/content_editor_component.html.slim +19 -93
  14. data/app/components/trek/form/content_editor_component/content_editor_component.js +94 -251
  15. data/app/components/trek/form/content_editor_component/extensions/block_view.js +40 -0
  16. data/app/components/trek/form/content_editor_component/extensions/image_block.js +28 -26
  17. data/app/components/trek/form/content_editor_component/extensions/prompts_block.js +15 -26
  18. data/app/components/trek/form/content_editor_component/extensions/table_of_contents.js +1 -3
  19. data/app/components/trek/form/content_editor_component.rb +15 -0
  20. data/app/components/trek/form/image_field_component/image_field_component.css +40 -1
  21. data/app/components/trek/form/image_field_component/image_field_component.html.slim +0 -9
  22. data/app/components/trek/form/image_field_component.rb +37 -14
  23. data/app/components/trek/list/item_component.rb +1 -1
  24. data/app/components/trek/list/tree/item_component.rb +2 -2
  25. data/app/components/trek/search_component/search_component.html.slim +2 -1
  26. data/app/components/trek/search_component.rb +9 -1
  27. data/app/content/trek/content/bullet_list.rb +10 -0
  28. data/app/content/trek/content/cleaner.rb +53 -0
  29. data/app/content/trek/content/document.rb +33 -0
  30. data/app/content/trek/content/image_block.rb +52 -0
  31. data/app/content/trek/content/link_resolver.rb +33 -0
  32. data/app/content/trek/content/list_item.rb +19 -0
  33. data/app/content/trek/content/ordered_list.rb +10 -0
  34. data/app/content/trek/content/paragraph.rb +10 -0
  35. data/app/content/trek/content/prompts_block.rb +21 -0
  36. data/app/content/trek/content.rb +38 -0
  37. data/app/controllers/concerns/trek/reorderable.rb +32 -3
  38. data/app/controllers/trek/csp_reports_controller.rb +17 -7
  39. data/app/controllers/trek/panels/base_controller.rb +3 -0
  40. data/app/controllers/trek/panels/links_controller.rb +1 -1
  41. data/app/controllers/trek/panels/prompts_controller.rb +2 -2
  42. data/app/controllers/trek/resource_controller.rb +5 -5
  43. data/app/helpers/trek/thumbnail_helper.rb +11 -0
  44. data/app/jobs/trek/purge_expired_sessions_job.rb +4 -3
  45. data/app/models/concerns/trek/contentable.rb +19 -10
  46. data/app/models/concerns/trek/pageable.rb +10 -1
  47. data/app/models/concerns/trek/users/sign_in_code.rb +70 -0
  48. data/app/models/concerns/trek/users/sign_in_lockout.rb +4 -2
  49. data/app/views/trek/panels/images/_form.html.slim +1 -1
  50. data/app/views/trek/panels/images/create.turbo_stream.slim +1 -1
  51. data/app/views/trek/panels/links/_form.html.slim +3 -5
  52. data/app/views/trek/panels/prompts/_form.html.slim +1 -1
  53. data/app/views/trek/panels/prompts/create.turbo_stream.slim +0 -1
  54. data/config/locales/trek.en.yml +40 -2
  55. data/config/locales/trek.fr.yml +40 -2
  56. data/docs/.vitepress/config.mjs +4 -1
  57. data/docs/background-jobs.md +69 -0
  58. data/docs/content-editor.md +219 -0
  59. data/docs/customize.md +2 -0
  60. data/docs/deploy.md +2 -2
  61. data/docs/getting-started.md +4 -4
  62. data/docs/index.md +1 -1
  63. data/docs/reference/components.md +2 -2
  64. data/docs/reference/concerns/contentable.md +11 -4
  65. data/docs/reference/concerns/formattable.md +1 -1
  66. data/docs/reference/controllers.md +1 -1
  67. data/docs/reference/environment-variables.md +1 -0
  68. data/docs/reference/formatters.md +4 -9
  69. data/docs/reference/forms.md +1 -1
  70. data/docs/reference/generators/audit-log.md +2 -2
  71. data/docs/reference/generators/install.md +3 -2
  72. data/docs/reference/generators/public-accounts.md +141 -0
  73. data/docs/reference/generators/security-headers.md +1 -1
  74. data/docs/reference/index.md +2 -1
  75. data/docs/reference/models/fragment.md +1 -0
  76. data/docs/reference/models/user.md +3 -1
  77. data/docs/what-is-trek.md +5 -5
  78. data/lib/generators/trek/audit_log_generator.rb +54 -0
  79. data/lib/generators/trek/helpers.rb +13 -5
  80. data/lib/generators/trek/install/admin/users_generator.rb +6 -1
  81. data/lib/generators/trek/install/admin_generator.rb +8 -0
  82. data/lib/generators/trek/install/appsignal_generator.rb +1 -1
  83. data/lib/generators/trek/install/audit_log_generator.rb +9 -45
  84. data/lib/generators/trek/install/authentication_generator.rb +1 -1
  85. data/lib/generators/trek/install/authorization_generator.rb +1 -1
  86. data/lib/generators/trek/install/good_job_generator.rb +161 -0
  87. data/lib/generators/trek/install/model_specs_generator.rb +3 -3
  88. data/lib/generators/trek/install/postmark_generator.rb +2 -2
  89. data/lib/generators/trek/install/ruby_generator.rb +1 -1
  90. data/lib/generators/trek/install/scalingo_generator.rb +7 -45
  91. data/lib/generators/trek/install/specs_generator.rb +11 -0
  92. data/lib/generators/trek/install/user_generator.rb +1 -1
  93. data/lib/generators/trek/install_generator.rb +15 -0
  94. data/lib/generators/trek/public_accounts_generator.rb +267 -0
  95. data/lib/generators/trek/scaffold_generator.rb +13 -5
  96. data/lib/generators/trek/scalingo_generator.rb +55 -0
  97. data/lib/generators/trek/templates/.gitlab-ci.yml +1 -1
  98. data/lib/generators/trek/templates/Makefile +1 -1
  99. data/lib/generators/trek/templates/controllers/admin/fragments_controller.rb +7 -0
  100. data/lib/generators/trek/templates/controllers/admin/panels/images_controller.rb +8 -0
  101. data/lib/generators/trek/templates/controllers/admin/panels/links_controller.rb +8 -0
  102. data/lib/generators/trek/templates/controllers/admin/panels/prompts_controller.rb +8 -0
  103. data/lib/generators/trek/templates/controllers/admin/password_renewals_controller.rb +11 -0
  104. data/lib/generators/trek/templates/controllers/admin/user_sessions_controller.rb +1 -1
  105. data/lib/generators/trek/templates/controllers/admin/users_controller.rb +0 -8
  106. data/lib/generators/trek/templates/initializers/content_security_policy.rb +3 -2
  107. data/lib/generators/trek/templates/initializers/good_job.rb.tt +38 -0
  108. data/lib/generators/trek/templates/jobs/mail_delivery_job.rb +6 -0
  109. data/lib/generators/trek/templates/layouts/admin.html.slim +5 -0
  110. data/lib/generators/trek/templates/mailers/admin_mailer.rb +4 -2
  111. data/lib/generators/trek/templates/models/fragment.rb +14 -0
  112. data/lib/generators/trek/templates/package.json.tt +1 -1
  113. data/lib/generators/trek/templates/public_accounts/api/authentication.rb.tt +76 -0
  114. data/lib/generators/trek/templates/public_accounts/api/controllers/accounts_controller.rb.tt +22 -0
  115. data/lib/generators/trek/templates/public_accounts/api/controllers/active_sessions_controller.rb.tt +21 -0
  116. data/lib/generators/trek/templates/public_accounts/api/controllers/base_controller.rb.tt +71 -0
  117. data/lib/generators/trek/templates/public_accounts/api/controllers/email_changes_controller.rb.tt +55 -0
  118. data/lib/generators/trek/templates/public_accounts/api/controllers/email_confirmations_controller.rb.tt +19 -0
  119. data/lib/generators/trek/templates/public_accounts/api/controllers/password_resets_controller.rb.tt +28 -0
  120. data/lib/generators/trek/templates/public_accounts/api/controllers/passwords_controller.rb.tt +17 -0
  121. data/lib/generators/trek/templates/public_accounts/api/controllers/registrations_controller.rb.tt +17 -0
  122. data/lib/generators/trek/templates/public_accounts/api/controllers/sessions_controller.rb.tt +45 -0
  123. data/lib/generators/trek/templates/public_accounts/api/controllers/sign_in_codes_controller.rb.tt +15 -0
  124. data/lib/generators/trek/templates/public_accounts/jobs/sign_in_code_job.rb.tt +13 -0
  125. data/lib/generators/trek/templates/public_accounts/locales/accounts.en.yml.tt +205 -0
  126. data/lib/generators/trek/templates/public_accounts/locales/accounts.fr.yml.tt +205 -0
  127. data/lib/generators/trek/templates/public_accounts/mailers/account_mailer.rb.tt +85 -0
  128. data/lib/generators/trek/templates/public_accounts/migrations/create_accounts.rb.tt +46 -0
  129. data/lib/generators/trek/templates/public_accounts/models/account/session.rb.tt +47 -0
  130. data/lib/generators/trek/templates/public_accounts/models/account/sign_in_code.rb.tt +8 -0
  131. data/lib/generators/trek/templates/public_accounts/models/account.rb.tt +73 -0
  132. data/lib/generators/trek/templates/public_accounts/spec/api/accounts_spec.rb.tt +90 -0
  133. data/lib/generators/trek/templates/public_accounts/spec/api/sign_ins_spec.rb.tt +158 -0
  134. data/lib/generators/trek/templates/public_accounts/spec/models/account/sign_in_code_spec.rb.tt +56 -0
  135. data/lib/generators/trek/templates/public_accounts/spec/models/account_spec.rb.tt +109 -0
  136. data/lib/generators/trek/templates/public_accounts/spec/web/accounts_spec.rb.tt +126 -0
  137. data/lib/generators/trek/templates/public_accounts/spec/web/authentication_spec.rb.tt +43 -0
  138. data/lib/generators/trek/templates/public_accounts/spec/web/sign_ins_spec.rb.tt +215 -0
  139. data/lib/generators/trek/templates/public_accounts/views/mailer/email_change.en.html.slim.tt +10 -0
  140. data/lib/generators/trek/templates/public_accounts/views/mailer/email_change.en.text.erb.tt +8 -0
  141. data/lib/generators/trek/templates/public_accounts/views/mailer/email_change.fr.html.slim.tt +13 -0
  142. data/lib/generators/trek/templates/public_accounts/views/mailer/email_change.fr.text.erb.tt +8 -0
  143. data/lib/generators/trek/templates/public_accounts/views/mailer/email_change_code.en.html.slim.tt +9 -0
  144. data/lib/generators/trek/templates/public_accounts/views/mailer/email_change_code.en.text.erb.tt +11 -0
  145. data/lib/generators/trek/templates/public_accounts/views/mailer/email_change_code.fr.html.slim.tt +11 -0
  146. data/lib/generators/trek/templates/public_accounts/views/mailer/email_change_code.fr.text.erb.tt +11 -0
  147. data/lib/generators/trek/templates/public_accounts/views/mailer/email_confirmation.en.html.slim.tt +10 -0
  148. data/lib/generators/trek/templates/public_accounts/views/mailer/email_confirmation.en.text.erb.tt +8 -0
  149. data/lib/generators/trek/templates/public_accounts/views/mailer/email_confirmation.fr.html.slim.tt +10 -0
  150. data/lib/generators/trek/templates/public_accounts/views/mailer/email_confirmation.fr.text.erb.tt +8 -0
  151. data/lib/generators/trek/templates/public_accounts/views/mailer/password_reset.en.html.slim.tt +10 -0
  152. data/lib/generators/trek/templates/public_accounts/views/mailer/password_reset.en.text.erb.tt +8 -0
  153. data/lib/generators/trek/templates/public_accounts/views/mailer/password_reset.fr.html.slim.tt +13 -0
  154. data/lib/generators/trek/templates/public_accounts/views/mailer/password_reset.fr.text.erb.tt +8 -0
  155. data/lib/generators/trek/templates/public_accounts/views/mailer/sign_in_code.en.html.slim.tt +9 -0
  156. data/lib/generators/trek/templates/public_accounts/views/mailer/sign_in_code.en.text.erb.tt +11 -0
  157. data/lib/generators/trek/templates/public_accounts/views/mailer/sign_in_code.fr.html.slim.tt +9 -0
  158. data/lib/generators/trek/templates/public_accounts/views/mailer/sign_in_code.fr.text.erb.tt +11 -0
  159. data/lib/generators/trek/templates/public_accounts/views/mailer/sign_in_locked.en.html.slim.tt +23 -0
  160. data/lib/generators/trek/templates/public_accounts/views/mailer/sign_in_locked.en.text.erb.tt +14 -0
  161. data/lib/generators/trek/templates/public_accounts/views/mailer/sign_in_locked.fr.html.slim.tt +24 -0
  162. data/lib/generators/trek/templates/public_accounts/views/mailer/sign_in_locked.fr.text.erb.tt +14 -0
  163. data/lib/generators/trek/templates/public_accounts/web/authentication.rb.tt +97 -0
  164. data/lib/generators/trek/templates/public_accounts/web/controllers/accounts_controller.rb.tt +33 -0
  165. data/lib/generators/trek/templates/public_accounts/web/controllers/active_sessions_controller.rb.tt +15 -0
  166. data/lib/generators/trek/templates/public_accounts/web/controllers/base_controller.rb.tt +52 -0
  167. data/lib/generators/trek/templates/public_accounts/web/controllers/email_changes_controller.rb.tt +85 -0
  168. data/lib/generators/trek/templates/public_accounts/web/controllers/email_confirmations_controller.rb.tt +19 -0
  169. data/lib/generators/trek/templates/public_accounts/web/controllers/password_resets_controller.rb.tt +41 -0
  170. data/lib/generators/trek/templates/public_accounts/web/controllers/passwords_controller.rb.tt +23 -0
  171. data/lib/generators/trek/templates/public_accounts/web/controllers/registrations_controller.rb.tt +24 -0
  172. data/lib/generators/trek/templates/public_accounts/web/controllers/sessions_controller.rb.tt +78 -0
  173. data/lib/generators/trek/templates/public_accounts/web/controllers/sign_in_codes_controller.rb.tt +27 -0
  174. data/lib/generators/trek/templates/public_accounts/web/views/_flash.html.slim.tt +5 -0
  175. data/lib/generators/trek/templates/public_accounts/web/views/accounts/show.html.slim.tt +52 -0
  176. data/lib/generators/trek/templates/public_accounts/web/views/email_changes/edit.html.slim.tt +17 -0
  177. data/lib/generators/trek/templates/public_accounts/web/views/email_changes/new.html.slim.tt +15 -0
  178. data/lib/generators/trek/templates/public_accounts/web/views/password_resets/edit.html.slim.tt +26 -0
  179. data/lib/generators/trek/templates/public_accounts/web/views/password_resets/new.html.slim.tt +15 -0
  180. data/lib/generators/trek/templates/public_accounts/web/views/passwords/edit.html.slim.tt +25 -0
  181. data/lib/generators/trek/templates/public_accounts/web/views/registrations/new.html.slim.tt +28 -0
  182. data/lib/generators/trek/templates/public_accounts/web/views/sessions/new.html.slim.tt +38 -0
  183. data/lib/generators/trek/templates/public_accounts/web/views/sign_in_codes/new.html.slim.tt +17 -0
  184. data/lib/generators/trek/templates/spec/jobs/mail_delivery_job_spec.rb +11 -0
  185. data/lib/generators/trek/templates/spec/mailers/admin_mailer_spec.rb +12 -1
  186. data/lib/generators/trek/templates/spec/requests/admin/active_sessions_spec.rb +1 -0
  187. data/lib/generators/trek/templates/spec/requests/admin/fragments_spec.rb +27 -3
  188. data/lib/generators/trek/templates/spec/requests/admin/good_job_spec.rb +34 -0
  189. data/lib/generators/trek/templates/spec/requests/admin/pages_spec.rb +9 -1
  190. data/lib/generators/trek/templates/spec/requests/admin/panels_spec.rb +70 -0
  191. data/lib/generators/trek/templates/spec/requests/admin/password_renewal_spec.rb +2 -2
  192. data/lib/generators/trek/templates/spec/requests/admin/sign_in_lockout_spec.rb +1 -1
  193. data/lib/generators/trek/templates/spec/requests/admin/sign_in_notices_spec.rb +5 -3
  194. data/lib/generators/trek/templates/spec/requests/admin/user_sessions_spec.rb +2 -2
  195. data/lib/generators/trek/templates/views/admin/fragments/index.html.slim +14 -3
  196. data/lib/generators/trek/templates/views/admin/users/index.html.slim +1 -1
  197. data/lib/generators/trek/templates/views/admin_mailer/new_sign_in.en.html.slim +1 -1
  198. data/lib/generators/trek/templates/views/admin_mailer/new_sign_in.en.text.erb +1 -1
  199. data/lib/generators/trek/templates/views/admin_mailer/new_sign_in.fr.html.slim +1 -1
  200. data/lib/generators/trek/templates/views/admin_mailer/new_sign_in.fr.text.erb +1 -1
  201. data/lib/trek/csp_reports.rb +22 -4
  202. data/lib/trek/engine.rb +8 -3
  203. data/lib/trek/saved_attachments_reload.rb +2 -1
  204. data/lib/trek/typography_formatter.rb +35 -4
  205. data/lib/trek/version.rb +1 -1
  206. data/lib/trek.rb +1 -1
  207. data/package.json +12 -8
  208. data/renovate.json +1 -0
  209. data/trek.gemspec +3 -3
  210. data/vitest.config.mjs +24 -0
  211. data/yarn.lock +1706 -1028
  212. metadata +116 -14
  213. data/app/formatters/prosemirror_to_html/global_id_to_links_formatter.rb +0 -19
  214. data/app/formatters/prosemirror_to_html/nodes/image_block.rb +0 -44
  215. data/app/formatters/prosemirror_to_html/nodes/prompts_block.rb +0 -28
  216. data/app/formatters/prosemirror_to_html/remove_empty_paragraphs_formatter.rb +0 -11
  217. data/app/models/prosemirror.rb +0 -23
@@ -0,0 +1,76 @@
1
+ # Signs <%= human_name.pluralize.downcase %> in to the API through a JWT the mobile app sends with each request
2
+ # (Authorization: Bearer). The token only names a <%= class_name %>::Session: signing out deletes the session and
3
+ # the token with it, and the session's idle timeout and lifetime apply as on the web. Apart from the
4
+ # admin's users and sessions altogether.
5
+ module <%= accounts_module %>::Authentication
6
+ extend ActiveSupport::Concern
7
+
8
+ included do
9
+ before_action :require_<%= file_name %>
10
+ after_action :track_<%= file_name %>_activity
11
+ end
12
+
13
+ class_methods do
14
+ def allow_unauthenticated_access(**options)
15
+ skip_before_action :require_<%= file_name %>, **options
16
+ end
17
+ end
18
+
19
+ private
20
+
21
+ def require_<%= file_name %>
22
+ render_api_error :unauthorized, :sign_in_needed unless resume_<%= file_name %>_session
23
+ end
24
+
25
+ # Changing the password or deleting the account asks to sign in again when the session isn't recent.
26
+ def require_recent_<%= file_name %>_sign_in
27
+ render_api_error :forbidden, :recent_sign_in_needed unless Current.<%= file_name %>_session.recent?
28
+ end
29
+
30
+ def resume_<%= file_name %>_session
31
+ Current.<%= file_name %>_session ||= find_<%= file_name %>_session_by_token
32
+ end
33
+
34
+ # A session past its idle timeout or lifetime is dropped: the <%= human_name.downcase %> signs in again.
35
+ def find_<%= file_name %>_session_by_token
36
+ token = request.authorization.to_s[/\ABearer (.+)\z/, 1]
37
+ return unless token
38
+
39
+ <%= file_name %>_session = <%= class_name %>::Session.from_token(token)
40
+ return <%= file_name %>_session unless <%= file_name %>_session&.expired?
41
+
42
+ <%= file_name %>_session.destroy
43
+ nil
44
+ end
45
+
46
+ # The session the token of the response will name
47
+ def start_<%= file_name %>_session_for(<%= file_name %>)
48
+ <%= file_name %>.sessions.create!(user_agent: request.user_agent, ip_address: request.remote_ip).tap do |<%= file_name %>_session|
49
+ Current.<%= file_name %>_session = <%= file_name %>_session
50
+ Trek::ResolveSessionHostnameJob.perform_later(<%= file_name %>_session)
51
+ end
52
+ end
53
+
54
+ def terminate_<%= file_name %>_session
55
+ Current.<%= file_name %>_session.destroy
56
+ Current.<%= file_name %>_session = nil
57
+ end
58
+
59
+ # At most once every <%= class_name %>::Session.activity_interval (5 minutes), so using the app doesn't write on
60
+ # every request.
61
+ def track_<%= file_name %>_activity
62
+ <%= file_name %>_session = Current.<%= file_name %>_session
63
+ return unless <%= file_name %>_session&.persisted?
64
+
65
+ <%= file_name %>_session.record_activity
66
+ <%= file_name %> = <%= file_name %>_session.<%= file_name %>
67
+ return if <%= file_name %>.last_activity_at&.after?(<%= class_name %>::Session.activity_interval.ago)
68
+
69
+ <%= file_name %>.update_columns(last_activity_at: Time.current) # rubocop:disable Rails/SkipsModelValidations
70
+ end
71
+
72
+ # An error the app can act on (`error`), with a message it may show (`message`).
73
+ def render_api_error(status, error, **details)
74
+ render json: { error:, message: I18n.t("<%= accounts_path %>.api.errors.#{error}"), **details }, status:
75
+ end
76
+ end
@@ -0,0 +1,22 @@
1
+ # The signed-in <%= human_name.downcase %>'s account: GET, PATCH { name }, and DELETE after a recent sign-in.
2
+ class <%= controllers_module %>::AccountsController < <%= controllers_module %>::BaseController
3
+ before_action :require_recent_<%= file_name %>_sign_in, only: :destroy
4
+
5
+ def show
6
+ render json: <%= file_name %>_json(Current.<%= file_name %>)
7
+ end
8
+
9
+ def update
10
+ if Current.<%= file_name %>.update(params.permit(:name))
11
+ render json: <%= file_name %>_json(Current.<%= file_name %>)
12
+ else
13
+ render_api_error :unprocessable_content, :invalid, errors: Current.<%= file_name %>.errors
14
+ end
15
+ end
16
+
17
+ def destroy
18
+ Current.<%= file_name %>.destroy!
19
+ Current.<%= file_name %>_session = nil
20
+ head :no_content
21
+ end
22
+ end
@@ -0,0 +1,21 @@
1
+ # The devices signed in as the current <%= human_name.downcase %>: GET lists them, DELETE signs one or the others out.
2
+ # Only theirs: every query goes through Current.<%= file_name %>.sessions.
3
+ class <%= controllers_module %>::ActiveSessionsController < <%= controllers_module %>::BaseController
4
+ def index
5
+ sessions = Current.<%= file_name %>.sessions.active.recent_first.map do |<%= file_name %>_session|
6
+ <%= file_name %>_session.as_json(only: %i[id user_agent ip_address ip_hostname created_at last_activity_at])
7
+ .merge("current" => <%= file_name %>_session == Current.<%= file_name %>_session)
8
+ end
9
+ render json: sessions
10
+ end
11
+
12
+ def destroy
13
+ Current.<%= file_name %>.sessions.find(params[:id]).destroy
14
+ head :no_content
15
+ end
16
+
17
+ def destroy_others
18
+ Current.<%= file_name %>.sessions.where.not(id: Current.<%= file_name %>_session.id).destroy_all
19
+ head :no_content
20
+ end
21
+ end
@@ -0,0 +1,71 @@
1
+ # The API's account endpoints: <%= human_name.pluralize.downcase %> only, never the admin's users.
2
+ class <%= controllers_module %>::BaseController < ActionController::API
3
+ include <%= accounts_module %>::Authentication
4
+ # Sign-ins, <% if code? %>code requests<% else %>sign-ups, password resets<% end %> and account changes go to the audit log, when the app has one.
5
+ include Trek::Auditable if defined?(::AuditLog)
6
+
7
+ # Emails sent to one address (<% if code? %>codes<% else %>password resets, confirmations<% end %>), whatever the IP address: rate_limit
8
+ # counts per IP address.
9
+ EMAILS_PER_ADDRESS = 5
10
+ EMAILS_PER_ADDRESS_WINDOW = 1.hour
11
+
12
+ # Failed sign-ins from one IP address, whatever the account, over a longer window than rate_limit's.
13
+ FAILED_SIGN_INS_PER_IP = 20
14
+ FAILED_SIGN_INS_WINDOW = 1.hour
15
+
16
+ private
17
+
18
+ def normalized_email(email)
19
+ <%= class_name %>.normalize_value_for(:email, email.to_s)
20
+ end
21
+
22
+ def valid_email?(email)
23
+ email.match?(URI::MailTo::EMAIL_REGEXP)
24
+ end
25
+
26
+ # Counted in Rails.cache, as rate_limit is, under a digest rather than the email itself.
27
+ def too_many_emails_to?(email)
28
+ key = "<%= accounts_path %>/emails/#{Digest::SHA256.hexdigest(email)}"
29
+ Rails.cache.increment(key, 1, expires_in: EMAILS_PER_ADDRESS_WINDOW).to_i > EMAILS_PER_ADDRESS
30
+ end
31
+
32
+ def too_many_failed_sign_ins_from_ip?
33
+ Rails.cache.read(failed_sign_ins_from_ip_key).to_i >= FAILED_SIGN_INS_PER_IP
34
+ end
35
+
36
+ def count_failed_sign_in_from_ip
37
+ Rails.cache.increment(failed_sign_ins_from_ip_key, 1, expires_in: FAILED_SIGN_INS_WINDOW)
38
+ end
39
+
40
+ def failed_sign_ins_from_ip_key
41
+ "<%= accounts_path %>/failed_sign_ins/#{request.remote_ip}"
42
+ end
43
+
44
+ def render_rate_limited
45
+ render_api_error :too_many_requests, :rate_limited
46
+ end
47
+
48
+ def <%= file_name %>_json(<%= file_name %>)
49
+ <% if password? -%>
50
+ <%= file_name %>.as_json(only: %i[id email unconfirmed_email name confirmed_at created_at])
51
+ <% else -%>
52
+ <%= file_name %>.as_json(only: %i[id email name created_at])
53
+ <% end -%>
54
+ end
55
+
56
+ # A new session, and the token naming it, for the app to send with each request
57
+ def render_new_session(<%= file_name %>, status: :created)
58
+ <%= file_name %>_session = start_<%= file_name %>_session_for(<%= file_name %>)
59
+ render json: { token: <%= file_name %>_session.token, <%= file_name %>: <%= file_name %>_json(<%= file_name %>) }, status:
60
+ end
61
+
62
+ # For the audit log (Trek::Auditable): the signed-in <%= human_name.downcase %>, nil before signing in
63
+ def audit_actor
64
+ Current.<%= file_name %>
65
+ end
66
+
67
+ # The account signed in to, tried, or changed
68
+ def audit_target
69
+ @<%= file_name %> || Current.<%= file_name %>
70
+ end
71
+ end
@@ -0,0 +1,55 @@
1
+ <% if code? -%>
2
+ # Changing the account's email: POST { email } sends a code to the new address, PATCH { email, otp }
3
+ # confirms it's theirs and changes it.
4
+ <% else -%>
5
+ # Changing the account's email: POST { email } sends a link to the new address, PATCH { token } (the
6
+ # link's, which the app opens, possibly signed out) confirms it's theirs and changes it.
7
+ <% end -%>
8
+ class <%= controllers_module %>::EmailChangesController < <%= controllers_module %>::BaseController
9
+ <% if password? -%>
10
+ allow_unauthenticated_access only: :update
11
+ <% end -%>
12
+ rate_limit to: 10, within: 15.minutes, with: -> { render_rate_limited }
13
+
14
+ def create
15
+ email = normalized_email(params[:email])
16
+ return render_api_error :unprocessable_content, :invalid_email unless valid_email?(email) && email != Current.<%= file_name %>.email
17
+ return render_rate_limited if too_many_emails_to?(email)
18
+
19
+ <% if code? -%>
20
+ <%= accounts_module %>::SignInCodeJob.perform_later(email, purpose: "email_change", <%= file_name %>: Current.<%= file_name %>)
21
+ <% else -%>
22
+ Current.<%= file_name %>.update_column(:unconfirmed_email, email) # rubocop:disable Rails/SkipsModelValidations -- checked above
23
+ <%= class_name %>Mailer.email_change(Current.<%= file_name %>).deliver_later
24
+ <% end -%>
25
+ head :accepted
26
+ end
27
+
28
+ # Taken by another account is only told once the <%= code? ? "code" : "link" %> proved the address is theirs.
29
+ def update
30
+ <% if code? -%>
31
+ return render_rate_limited if too_many_failed_sign_ins_from_ip?
32
+
33
+ email = normalized_email(params[:email])
34
+ unless <%= class_name %>::SignInCode.redeem(email, params[:otp], purpose: "email_change", <%= file_name %>: Current.<%= file_name %>)
35
+ count_failed_sign_in_from_ip
36
+ return render_api_error :unprocessable_content, :invalid_code
37
+ end
38
+
39
+ if Current.<%= file_name %>.update(email:)
40
+ render json: <%= file_name %>_json(Current.<%= file_name %>)
41
+ else
42
+ render_api_error :conflict, :email_taken
43
+ end
44
+ <% else -%>
45
+ @<%= file_name %> = <%= class_name %>.find_by_token_for(:email_change, params[:token].to_s)
46
+ return render_api_error :unprocessable_content, :invalid_token unless @<%= file_name %>
47
+
48
+ if @<%= file_name %>.change_email!
49
+ render json: <%= file_name %>_json(@<%= file_name %>)
50
+ else
51
+ render_api_error :conflict, :email_taken
52
+ end
53
+ <% end -%>
54
+ end
55
+ end
@@ -0,0 +1,19 @@
1
+ # POST: sends the link confirming the account's email again. PATCH { token }: the token of the link,
2
+ # which the app opens, possibly signed out: the token is enough.
3
+ class <%= controllers_module %>::EmailConfirmationsController < <%= controllers_module %>::BaseController
4
+ allow_unauthenticated_access only: :update
5
+
6
+ def create
7
+ <%= file_name %> = Current.<%= file_name %>
8
+ <%= class_name %>Mailer.email_confirmation(<%= file_name %>).deliver_later unless <%= file_name %>.confirmed? || too_many_emails_to?(<%= file_name %>.email)
9
+ head :accepted
10
+ end
11
+
12
+ def update
13
+ @<%= file_name %> = <%= class_name %>.find_by_token_for(:email_confirmation, params[:token].to_s)
14
+ return render_api_error :unprocessable_content, :invalid_token unless @<%= file_name %>
15
+
16
+ @<%= file_name %>.confirm_email!
17
+ render json: <%= file_name %>_json(@<%= file_name %>)
18
+ end
19
+ end
@@ -0,0 +1,28 @@
1
+ # POST { email }: emails a link to choose a new password, if the email has an account, with the same
2
+ # answer (202) either way. PATCH { token, password }: the token of the link, which the app opens, and
3
+ # the new password; signs out every session.
4
+ class <%= controllers_module %>::PasswordResetsController < <%= controllers_module %>::BaseController
5
+ allow_unauthenticated_access
6
+ rate_limit to: 10, within: 15.minutes, with: -> { render_rate_limited }
7
+
8
+ def create
9
+ email = normalized_email(params[:email])
10
+ @<%= file_name %> = <%= class_name %>.find_by(email:) if valid_email?(email)
11
+ <%= class_name %>Mailer.password_reset(@<%= file_name %>).deliver_later if @<%= file_name %> && !too_many_emails_to?(email)
12
+
13
+ head :accepted
14
+ end
15
+
16
+ def update
17
+ @<%= file_name %> = <%= class_name %>.find_by_token_for(:password_reset, params[:token].to_s)
18
+ return render_api_error :unprocessable_content, :invalid_token unless @<%= file_name %>
19
+
20
+ @<%= file_name %>.password = params[:password].to_s
21
+ if @<%= file_name %>.save
22
+ @<%= file_name %>.sessions.delete_all
23
+ head :no_content
24
+ else
25
+ render_api_error :unprocessable_content, :invalid, errors: @<%= file_name %>.errors
26
+ end
27
+ end
28
+ end
@@ -0,0 +1,17 @@
1
+ # PATCH { password }: changes the account's password, after a recent sign-in; a forgotten one goes
2
+ # through the password reset. Signs out the account's other sessions.
3
+ class <%= controllers_module %>::PasswordsController < <%= controllers_module %>::BaseController
4
+ before_action :require_recent_<%= file_name %>_sign_in
5
+
6
+ def update
7
+ <%= file_name %> = Current.<%= file_name %>
8
+ <%= file_name %>.password = params[:password].to_s
9
+
10
+ if <%= file_name %>.save
11
+ <%= file_name %>.sessions.where.not(id: Current.<%= file_name %>_session.id).delete_all
12
+ head :no_content
13
+ else
14
+ render_api_error :unprocessable_content, :invalid, errors: <%= file_name %>.errors
15
+ end
16
+ end
17
+ end
@@ -0,0 +1,17 @@
1
+ # POST { email, password, name }: signs up and in, answering with the token; the email is confirmed
2
+ # later by a link (confirmed_at), which the app opens and sends to PATCH /account/confirmation.
3
+ class <%= controllers_module %>::RegistrationsController < <%= controllers_module %>::BaseController
4
+ allow_unauthenticated_access
5
+ rate_limit to: 5, within: 15.minutes, with: -> { render_rate_limited }
6
+
7
+ def create
8
+ @<%= file_name %> = <%= class_name %>.new(params.permit(:email, :name, :password))
9
+
10
+ if @<%= file_name %>.save
11
+ <%= class_name %>Mailer.email_confirmation(@<%= file_name %>).deliver_later
12
+ render_new_session @<%= file_name %>
13
+ else
14
+ render_api_error :unprocessable_content, :invalid, errors: @<%= file_name %>.errors
15
+ end
16
+ end
17
+ end
@@ -0,0 +1,45 @@
1
+ <% if code? -%>
2
+ # POST { email, otp }: signs in with the emailed code, to the email's account, created if it had none;
3
+ # answers with the token for the next requests. DELETE: signs out, ending the token's session.
4
+ <% else -%>
5
+ # POST { email, password }: signs in, and answers with the token for the next requests. DELETE: signs
6
+ # out, ending the token's session.
7
+ <% end -%>
8
+ class <%= controllers_module %>::SessionsController < <%= controllers_module %>::BaseController
9
+ allow_unauthenticated_access only: :create
10
+ rate_limit to: <%= code? ? 10 : 5 %>, within: 3.minutes, only: :create, with: -> { render_rate_limited }
11
+
12
+ def create
13
+ return render_rate_limited if too_many_failed_sign_ins_from_ip?
14
+
15
+ <% if code? -%>
16
+ email = normalized_email(params[:email])
17
+ unless <%= class_name %>::SignInCode.redeem(email, params[:otp])
18
+ count_failed_sign_in_from_ip
19
+ return render_api_error :unauthorized, :invalid_code
20
+ end
21
+
22
+ @<%= file_name %> = <%= class_name %>.for_verified_email!(email)
23
+ render_new_session @<%= file_name %>
24
+ <% else -%>
25
+ # Hashes the password sent even when no account matches, so the response takes as long
26
+ <%= file_name %> = <%= class_name %>.authenticate_by(email: params[:email].to_s, password: params[:password].to_s)
27
+ @<%= file_name %> = <%= file_name %> || <%= class_name %>.find_by(email: params[:email].to_s)
28
+
29
+ # A locked account is refused even with the right password, with the same answer as a wrong one
30
+ if <%= file_name %> && !<%= file_name %>.sign_in_locked?
31
+ <%= file_name %>.record_successful_sign_in!
32
+ render_new_session <%= file_name %>
33
+ else
34
+ @<%= file_name %>&.record_failed_sign_in!
35
+ count_failed_sign_in_from_ip
36
+ render_api_error :unauthorized, :invalid_password
37
+ end
38
+ <% end -%>
39
+ end
40
+
41
+ def destroy
42
+ terminate_<%= file_name %>_session
43
+ head :no_content
44
+ end
45
+ end
@@ -0,0 +1,15 @@
1
+ # POST { email }: emails a code to sign in with. Whether or not the email has an account, the answer
2
+ # is the same (202); the code creates the account on its first use.
3
+ class <%= controllers_module %>::SignInCodesController < <%= controllers_module %>::BaseController
4
+ allow_unauthenticated_access
5
+ rate_limit to: 10, within: 15.minutes, with: -> { render_rate_limited }
6
+
7
+ def create
8
+ email = normalized_email(params[:email])
9
+ return render_api_error :unprocessable_content, :invalid_email unless valid_email?(email)
10
+ return render_rate_limited if too_many_emails_to?(email)
11
+
12
+ <%= accounts_module %>::SignInCodeJob.perform_later(email)
13
+ head :accepted
14
+ end
15
+ end
@@ -0,0 +1,13 @@
1
+ # Issues a code and emails it, in the job rather than the request: the code in clear only exists
2
+ # here, never in the job's arguments, which the queue keeps. Active Job runs it in the request's
3
+ # locale.
4
+ class <%= accounts_module %>::SignInCodeJob < ApplicationJob
5
+ # To sign in to `email`'s account (created on the code's first use), or for `<%= file_name %>` to
6
+ # change its email to `email` (purpose: "email_change").
7
+ def perform(email, purpose: "sign_in", <%= file_name %>: nil)
8
+ sign_in_code = <%= class_name %>::SignInCode.issue(email, purpose:, <%= file_name %>:)
9
+ mail = purpose == "email_change" ? :email_change_code : :sign_in_code
10
+
11
+ <%= class_name %>Mailer.public_send(mail, email, sign_in_code.code).deliver_now
12
+ end
13
+ end
@@ -0,0 +1,205 @@
1
+ en:
2
+ activerecord:
3
+ attributes:
4
+ <%= file_name %>:
5
+ email: Email
6
+ name: Name
7
+ <% if password? -%>
8
+ password: Password
9
+ unconfirmed_email: New email
10
+ errors:
11
+ models:
12
+ <%= file_name %>:
13
+ attributes:
14
+ password:
15
+ common: is among the most common passwords, choose a less predictable one
16
+ digit_and_symbol: must contain a digit and a symbol, unless it is at least %{count} characters long
17
+ personal: must not contain your name or email
18
+ pwned: appears in known data breaches, choose another one
19
+ sequence: must not contain a sequence such as 12345, azerty or aaaaa
20
+ <% end -%>
21
+ models:
22
+ <%= file_name %>:
23
+ one: <%= human_name %>
24
+ other: <%= human_name.pluralize %>
25
+ <%= file_name %>_mailer:
26
+ <% if code? -%>
27
+ email_change_code:
28
+ subject: Confirm your new email address
29
+ sign_in_code:
30
+ subject: Your sign-in code
31
+ <% else -%>
32
+ email_change:
33
+ subject: Confirm your new email address
34
+ email_confirmation:
35
+ subject: Confirm your email address
36
+ password_reset:
37
+ subject: Choose a new password
38
+ sign_in_locked:
39
+ subject: Signing in to your account is paused
40
+ <% end -%>
41
+ <% unless model_only? -%>
42
+ <%= accounts_path %>:
43
+ <% if api? -%>
44
+ api:
45
+ errors:
46
+ email_taken: This email is already used by another account.
47
+ invalid: Some fields are invalid.
48
+ <% if code? -%>
49
+ invalid_code: This code is wrong or expired. Check the last email, or ask for a new code.
50
+ <% end -%>
51
+ invalid_email: Enter a valid email address.
52
+ <% if password? -%>
53
+ invalid_password: Wrong email or password.
54
+ invalid_token: This link is wrong or expired. Ask for a new one.
55
+ <% end -%>
56
+ rate_limited: Too many attempts. Try again in a few minutes.
57
+ recent_sign_in_needed: For your security, sign in again to continue.
58
+ sign_in_needed: Sign in to continue.
59
+ <% else -%>
60
+ accounts:
61
+ destroy:
62
+ success: Your account is deleted.
63
+ show:
64
+ change_email: Change
65
+ <% if password? -%>
66
+ change_password: Change your password
67
+ <% end -%>
68
+ delete: Delete my account
69
+ delete_confirm: Delete your account for good?
70
+ delete_intro: Your account and everything attached to it are deleted for good.
71
+ delete_title: Delete your account
72
+ <% if password? -%>
73
+ pending_email: "%{email} will replace it once you follow the link we sent there."
74
+ resend_confirmation: Send the confirmation link again
75
+ <% end -%>
76
+ save: Save
77
+ sessions: Signed-in browsers
78
+ sign_out: Sign out
79
+ sign_out_others: Sign out of all other browsers
80
+ sign_out_session: Sign out
81
+ signed_in: signed in on %{date}
82
+ this_browser: "(this browser)"
83
+ title: Your account
84
+ <% if password? -%>
85
+ unconfirmed: This email isn't confirmed yet. Follow the link we sent to it.
86
+ <% end -%>
87
+ update:
88
+ success: Your account is saved.
89
+ active_sessions:
90
+ destroy:
91
+ success: The browser is signed out.
92
+ destroy_others:
93
+ success: The other browsers are signed out.
94
+ authentication:
95
+ rate_limited: Too many attempts. Try again in a few minutes.
96
+ recent_sign_in_needed: For your security, sign in again to continue.
97
+ sign_in_needed: Sign in to continue.
98
+ email_changes:
99
+ create:
100
+ invalid_email: Enter a valid email address, other than your current one.
101
+ <% if code? -%>
102
+ sent: We sent a code to %{email}.
103
+ edit:
104
+ back: Back to your account
105
+ code: Code
106
+ intro: Enter the code we sent to %{email}.
107
+ submit: Confirm
108
+ title: Confirm your new email
109
+ <% else -%>
110
+ sent: We sent a link to %{email}. Your email changes once you follow it.
111
+ <% end -%>
112
+ new:
113
+ back: Back to your account
114
+ email: New email
115
+ <% if code? -%>
116
+ intro: We'll send a code to the new address to confirm it's yours.
117
+ submit: Send me a code
118
+ <% else -%>
119
+ intro: We'll send a link to the new address to confirm it's yours.
120
+ submit: Send me a link
121
+ <% end -%>
122
+ title: Change your email
123
+ <% if code? -%>
124
+ update:
125
+ failure: This code is wrong or expired.
126
+ success: Your email is changed.
127
+ taken: This email is already used by another account.
128
+ <% else -%>
129
+ show:
130
+ invalid: This link is wrong or expired. Ask for a new one from your account.
131
+ success: Your email is changed.
132
+ taken: This email is already used by another account.
133
+ email_confirmations:
134
+ create:
135
+ sent: We sent a confirmation link to %{email}.
136
+ show:
137
+ invalid: This link is wrong or expired. Ask for a new one from your account.
138
+ success: Your email is confirmed.
139
+ password_resets:
140
+ create:
141
+ sent: If this email has an account, we sent it a link to choose a new password.
142
+ edit:
143
+ rules: At least %{min} characters, with a digit and a symbol unless it is at least %{passphrase} characters long.
144
+ submit: Save
145
+ title: Choose a new password
146
+ invalid: This link is wrong or expired. Ask for a new one.
147
+ new:
148
+ intro: Enter your email. We'll send you a link to choose a new password.
149
+ sign_in: Back to signing in
150
+ submit: Send me a link
151
+ title: Forgot your password?
152
+ update:
153
+ success: Your password is saved. Sign in with it.
154
+ passwords:
155
+ edit:
156
+ back: Back to your account
157
+ intro: At least %{min} characters, with a digit and a symbol unless it is at least %{passphrase} characters long.
158
+ submit: Save
159
+ title: Your password
160
+ update:
161
+ success: Your password is saved. Your other browsers are signed out.
162
+ registrations:
163
+ create:
164
+ success: Welcome! We sent a link to %{email} to confirm it.
165
+ new:
166
+ rules: At least %{min} characters, with a digit and a symbol unless it is at least %{passphrase} characters long.
167
+ sign_in: I already have an account
168
+ submit: Sign up
169
+ title: Create your account
170
+ <% end -%>
171
+ sessions:
172
+ create:
173
+ <% if code? -%>
174
+ failure: This code is wrong or expired. Check the last email, or ask for a new code.
175
+ <% else -%>
176
+ failure: Wrong email or password.
177
+ <% end -%>
178
+ success: You're signed in.
179
+ destroy:
180
+ success: You're signed out.
181
+ new:
182
+ <% if code? -%>
183
+ code: Code
184
+ intro: We sent a 6-digit code to %{email}. It is valid for %{validity}.
185
+ other_email: Use another email
186
+ submit: Sign in
187
+ title: Enter your code
188
+ <% else -%>
189
+ forgot_password: Forgot your password?
190
+ sign_up: Create an account
191
+ submit: Sign in
192
+ title: Sign in
193
+ <% end -%>
194
+ <% if code? -%>
195
+ sign_in_codes:
196
+ create:
197
+ invalid_email: Enter a valid email address.
198
+ sent: We sent a code to %{email}.
199
+ new:
200
+ intro: Enter your email. We'll send you a code to sign in, or to create your account if you don't have one yet.
201
+ submit: Send me a code
202
+ title: Sign in
203
+ <% end -%>
204
+ <% end -%>
205
+ <% end -%>