@aeolus-fleet/core 0.30.1 → 0.32.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 (323) hide show
  1. package/README.md +1 -1
  2. package/dist/adapters/prisma/defined-scopes.d.ts +4 -0
  3. package/dist/adapters/prisma/defined-scopes.js +23 -0
  4. package/dist/adapters/prisma/defined-scopes.js.map +1 -0
  5. package/dist/adapters/prisma/delivery-notices.d.ts +3 -0
  6. package/dist/adapters/prisma/delivery-notices.js +7 -2
  7. package/dist/adapters/prisma/delivery-notices.js.map +1 -1
  8. package/dist/adapters/prisma/fleet-limit-settings.d.ts +6 -0
  9. package/dist/adapters/prisma/fleet-limit-settings.js +17 -0
  10. package/dist/adapters/prisma/fleet-limit-settings.js.map +1 -0
  11. package/dist/adapters/prisma/generated/browser.d.ts +35 -4
  12. package/dist/adapters/prisma/generated/client.d.ts +35 -4
  13. package/dist/adapters/prisma/generated/commonInputTypes.d.ts +226 -46
  14. package/dist/adapters/prisma/generated/enums.d.ts +38 -0
  15. package/dist/adapters/prisma/generated/enums.js +33 -1
  16. package/dist/adapters/prisma/generated/enums.js.map +1 -1
  17. package/dist/adapters/prisma/generated/internal/class.d.ts +55 -0
  18. package/dist/adapters/prisma/generated/internal/class.js +4 -4
  19. package/dist/adapters/prisma/generated/internal/class.js.map +1 -1
  20. package/dist/adapters/prisma/generated/internal/prismaNamespace.d.ts +524 -1
  21. package/dist/adapters/prisma/generated/internal/prismaNamespace.js +96 -1
  22. package/dist/adapters/prisma/generated/internal/prismaNamespace.js.map +1 -1
  23. package/dist/adapters/prisma/generated/internal/prismaNamespaceBrowser.d.ts +100 -0
  24. package/dist/adapters/prisma/generated/internal/prismaNamespaceBrowser.js +96 -1
  25. package/dist/adapters/prisma/generated/internal/prismaNamespaceBrowser.js.map +1 -1
  26. package/dist/adapters/prisma/generated/models/DefinedScope.d.ts +1110 -0
  27. package/dist/adapters/prisma/generated/models/DefinedScope.js +2 -0
  28. package/dist/adapters/prisma/generated/models/DefinedScope.js.map +1 -0
  29. package/dist/adapters/prisma/generated/models/Delivery.d.ts +1 -10
  30. package/dist/adapters/prisma/generated/models/Fleet.d.ts +3291 -100
  31. package/dist/adapters/prisma/generated/models/InstallationSettings.d.ts +108 -4
  32. package/dist/adapters/prisma/generated/models/Meeting.d.ts +2520 -0
  33. package/dist/adapters/prisma/generated/models/Meeting.js +2 -0
  34. package/dist/adapters/prisma/generated/models/Meeting.js.map +1 -0
  35. package/dist/adapters/prisma/generated/models/MeetingMicRequest.d.ts +1398 -0
  36. package/dist/adapters/prisma/generated/models/MeetingMicRequest.js +2 -0
  37. package/dist/adapters/prisma/generated/models/MeetingMicRequest.js.map +1 -0
  38. package/dist/adapters/prisma/generated/models/MeetingParticipant.d.ts +1630 -0
  39. package/dist/adapters/prisma/generated/models/MeetingParticipant.js +2 -0
  40. package/dist/adapters/prisma/generated/models/MeetingParticipant.js.map +1 -0
  41. package/dist/adapters/prisma/generated/models/Message.d.ts +664 -350
  42. package/dist/adapters/prisma/generated/models/Schedule.d.ts +3925 -0
  43. package/dist/adapters/prisma/generated/models/Schedule.js +2 -0
  44. package/dist/adapters/prisma/generated/models/Schedule.js.map +1 -0
  45. package/dist/adapters/prisma/generated/models/Ship.d.ts +2497 -67
  46. package/dist/adapters/prisma/generated/models.d.ts +5 -0
  47. package/dist/adapters/prisma/history-pruner.d.ts +3 -0
  48. package/dist/adapters/prisma/history-pruner.js +232 -0
  49. package/dist/adapters/prisma/history-pruner.js.map +1 -0
  50. package/dist/adapters/prisma/history.js +72 -17
  51. package/dist/adapters/prisma/history.js.map +1 -1
  52. package/dist/adapters/prisma/installation.js +27 -8
  53. package/dist/adapters/prisma/installation.js.map +1 -1
  54. package/dist/adapters/prisma/meetings.d.ts +4 -0
  55. package/dist/adapters/prisma/meetings.js +103 -0
  56. package/dist/adapters/prisma/meetings.js.map +1 -0
  57. package/dist/adapters/prisma/messaging.js +8 -3
  58. package/dist/adapters/prisma/messaging.js.map +1 -1
  59. package/dist/adapters/prisma/registry.js +35 -9
  60. package/dist/adapters/prisma/registry.js.map +1 -1
  61. package/dist/adapters/prisma/rows.js +14 -1
  62. package/dist/adapters/prisma/rows.js.map +1 -1
  63. package/dist/adapters/prisma/schedules.d.ts +12 -0
  64. package/dist/adapters/prisma/schedules.js +255 -0
  65. package/dist/adapters/prisma/schedules.js.map +1 -0
  66. package/dist/adapters/prisma/unit-of-work.d.ts +8 -2
  67. package/dist/adapters/prisma/unit-of-work.js +9 -0
  68. package/dist/adapters/prisma/unit-of-work.js.map +1 -1
  69. package/dist/adapters/trpc/console.d.ts +1 -1
  70. package/dist/adapters/trpc/console.js +3 -6
  71. package/dist/adapters/trpc/console.js.map +1 -1
  72. package/dist/adapters/trpc/context.d.ts +30 -0
  73. package/dist/adapters/trpc/fleet.d.ts +233 -19
  74. package/dist/adapters/trpc/fleet.js +111 -11
  75. package/dist/adapters/trpc/fleet.js.map +1 -1
  76. package/dist/adapters/trpc/installation.d.ts +139 -4
  77. package/dist/adapters/trpc/installation.js +4 -4
  78. package/dist/adapters/trpc/installation.js.map +1 -1
  79. package/dist/adapters/trpc/router.d.ts +718 -19
  80. package/dist/adapters/trpc/schedule-output.d.ts +74 -0
  81. package/dist/adapters/trpc/schedule-output.js +71 -0
  82. package/dist/adapters/trpc/schedule-output.js.map +1 -0
  83. package/dist/adapters/trpc/ship-contract.js +7 -0
  84. package/dist/adapters/trpc/ship-contract.js.map +1 -1
  85. package/dist/adapters/trpc/ship-protocol.js +2 -1
  86. package/dist/adapters/trpc/ship-protocol.js.map +1 -1
  87. package/dist/adapters/trpc/ship.d.ts +397 -3
  88. package/dist/adapters/trpc/ship.js +323 -11
  89. package/dist/adapters/trpc/ship.js.map +1 -1
  90. package/dist/adapters/trpc/starting-prompt-text.js +5 -5
  91. package/dist/adapters/trpc/starting-prompt-text.js.map +1 -1
  92. package/dist/adapters/trpc/trpc.d.ts +8 -0
  93. package/dist/adapters/trpc/trpc.js +38 -2
  94. package/dist/adapters/trpc/trpc.js.map +1 -1
  95. package/dist/app.d.ts +5 -3
  96. package/dist/app.js +33 -5
  97. package/dist/app.js.map +1 -1
  98. package/dist/domain/messaging/add-to-meeting.d.ts +41 -0
  99. package/dist/domain/messaging/add-to-meeting.js +76 -0
  100. package/dist/domain/messaging/add-to-meeting.js.map +1 -0
  101. package/dist/domain/messaging/answer.d.ts +2 -1
  102. package/dist/domain/messaging/answer.js +3 -2
  103. package/dist/domain/messaging/answer.js.map +1 -1
  104. package/dist/domain/messaging/cancel-schedule.d.ts +35 -0
  105. package/dist/domain/messaging/cancel-schedule.js +45 -0
  106. package/dist/domain/messaging/cancel-schedule.js.map +1 -0
  107. package/dist/domain/messaging/change-meeting.d.ts +32 -0
  108. package/dist/domain/messaging/change-meeting.js +35 -0
  109. package/dist/domain/messaging/change-meeting.js.map +1 -0
  110. package/dist/domain/messaging/change-mic.d.ts +30 -0
  111. package/dist/domain/messaging/change-mic.js +27 -0
  112. package/dist/domain/messaging/change-mic.js.map +1 -0
  113. package/dist/domain/messaging/check-reach-to-each.d.ts +25 -0
  114. package/dist/domain/messaging/check-reach-to-each.js +21 -0
  115. package/dist/domain/messaging/check-reach-to-each.js.map +1 -0
  116. package/dist/domain/messaging/cron.d.ts +46 -0
  117. package/dist/domain/messaging/cron.js +164 -0
  118. package/dist/domain/messaging/cron.js.map +1 -0
  119. package/dist/domain/messaging/daily-message-limit.d.ts +7 -5
  120. package/dist/domain/messaging/daily-message-limit.js +8 -7
  121. package/dist/domain/messaging/daily-message-limit.js.map +1 -1
  122. package/dist/domain/messaging/dismiss-delivery.js +2 -1
  123. package/dist/domain/messaging/dismiss-delivery.js.map +1 -1
  124. package/dist/domain/messaging/list-schedules.d.ts +38 -0
  125. package/dist/domain/messaging/list-schedules.js +33 -0
  126. package/dist/domain/messaging/list-schedules.js.map +1 -0
  127. package/dist/domain/messaging/meeting-life.d.ts +76 -0
  128. package/dist/domain/messaging/meeting-life.js +136 -0
  129. package/dist/domain/messaging/meeting-life.js.map +1 -0
  130. package/dist/domain/messaging/meeting-notice.d.ts +58 -0
  131. package/dist/domain/messaging/meeting-notice.js +87 -0
  132. package/dist/domain/messaging/meeting-notice.js.map +1 -0
  133. package/dist/domain/messaging/meeting.d.ts +103 -0
  134. package/dist/domain/messaging/meeting.js +106 -0
  135. package/dist/domain/messaging/meeting.js.map +1 -0
  136. package/dist/domain/messaging/message.d.ts +68 -4
  137. package/dist/domain/messaging/message.js +163 -10
  138. package/dist/domain/messaging/message.js.map +1 -1
  139. package/dist/domain/messaging/mic.d.ts +64 -0
  140. package/dist/domain/messaging/mic.js +130 -0
  141. package/dist/domain/messaging/mic.js.map +1 -0
  142. package/dist/domain/messaging/open-meeting.d.ts +61 -0
  143. package/dist/domain/messaging/open-meeting.js +98 -0
  144. package/dist/domain/messaging/open-meeting.js.map +1 -0
  145. package/dist/domain/messaging/pause-schedule.d.ts +34 -0
  146. package/dist/domain/messaging/pause-schedule.js +44 -0
  147. package/dist/domain/messaging/pause-schedule.js.map +1 -0
  148. package/dist/domain/messaging/ports.d.ts +121 -3
  149. package/dist/domain/messaging/public.d.ts +4 -0
  150. package/dist/domain/messaging/public.js +2 -0
  151. package/dist/domain/messaging/public.js.map +1 -1
  152. package/dist/domain/messaging/push-receive-deliveries.d.ts +4 -1
  153. package/dist/domain/messaging/push-receive-deliveries.js +5 -2
  154. package/dist/domain/messaging/push-receive-deliveries.js.map +1 -1
  155. package/dist/domain/messaging/read-meeting.d.ts +67 -0
  156. package/dist/domain/messaging/read-meeting.js +61 -0
  157. package/dist/domain/messaging/read-meeting.js.map +1 -0
  158. package/dist/domain/messaging/receive-deliveries.d.ts +6 -1
  159. package/dist/domain/messaging/receive-deliveries.js +3 -0
  160. package/dist/domain/messaging/receive-deliveries.js.map +1 -1
  161. package/dist/domain/messaging/resend-delivery.js +5 -4
  162. package/dist/domain/messaging/resend-delivery.js.map +1 -1
  163. package/dist/domain/messaging/resume-schedule.d.ts +34 -0
  164. package/dist/domain/messaging/resume-schedule.js +37 -0
  165. package/dist/domain/messaging/resume-schedule.js.map +1 -0
  166. package/dist/domain/messaging/retired-participant.d.ts +36 -0
  167. package/dist/domain/messaging/retired-participant.js +38 -0
  168. package/dist/domain/messaging/retired-participant.js.map +1 -0
  169. package/dist/domain/messaging/retired-scheduler.d.ts +31 -0
  170. package/dist/domain/messaging/retired-scheduler.js +30 -0
  171. package/dist/domain/messaging/retired-scheduler.js.map +1 -0
  172. package/dist/domain/messaging/schedule-access.d.ts +20 -0
  173. package/dist/domain/messaging/schedule-access.js +21 -0
  174. package/dist/domain/messaging/schedule-access.js.map +1 -0
  175. package/dist/domain/messaging/schedule-limits.d.ts +25 -0
  176. package/dist/domain/messaging/schedule-limits.js +51 -0
  177. package/dist/domain/messaging/schedule-limits.js.map +1 -0
  178. package/dist/domain/messaging/schedule-message.d.ts +65 -0
  179. package/dist/domain/messaging/schedule-message.js +151 -0
  180. package/dist/domain/messaging/schedule-message.js.map +1 -0
  181. package/dist/domain/messaging/schedule.d.ts +238 -0
  182. package/dist/domain/messaging/schedule.js +316 -0
  183. package/dist/domain/messaging/schedule.js.map +1 -0
  184. package/dist/domain/messaging/send-due-schedules.d.ts +40 -0
  185. package/dist/domain/messaging/send-due-schedules.js +141 -0
  186. package/dist/domain/messaging/send-due-schedules.js.map +1 -0
  187. package/dist/domain/messaging/send-message.d.ts +18 -5
  188. package/dist/domain/messaging/send-message.js +149 -4
  189. package/dist/domain/messaging/send-message.js.map +1 -1
  190. package/dist/domain/messaging/send-request.d.ts +3 -2
  191. package/dist/domain/messaging/send-request.js +7 -2
  192. package/dist/domain/messaging/send-request.js.map +1 -1
  193. package/dist/domain/registry/applied-limits.d.ts +5 -7
  194. package/dist/domain/registry/applied-limits.js +5 -9
  195. package/dist/domain/registry/applied-limits.js.map +1 -1
  196. package/dist/domain/registry/check-manage.d.ts +23 -0
  197. package/dist/domain/registry/check-manage.js +19 -0
  198. package/dist/domain/registry/check-manage.js.map +1 -0
  199. package/dist/domain/registry/commission-ship.js +3 -3
  200. package/dist/domain/registry/commission-ship.js.map +1 -1
  201. package/dist/domain/registry/declare-scopes.d.ts +5 -3
  202. package/dist/domain/registry/declare-scopes.js +4 -2
  203. package/dist/domain/registry/declare-scopes.js.map +1 -1
  204. package/dist/domain/registry/define-scope.d.ts +33 -0
  205. package/dist/domain/registry/define-scope.js +30 -0
  206. package/dist/domain/registry/define-scope.js.map +1 -0
  207. package/dist/domain/registry/defined-scope.d.ts +68 -0
  208. package/dist/domain/registry/defined-scope.js +83 -0
  209. package/dist/domain/registry/defined-scope.js.map +1 -0
  210. package/dist/domain/registry/describe-scope.d.ts +31 -0
  211. package/dist/domain/registry/describe-scope.js +28 -0
  212. package/dist/domain/registry/describe-scope.js.map +1 -0
  213. package/dist/domain/registry/get-fleet-limits.d.ts +1 -1
  214. package/dist/domain/registry/get-fleet-limits.js +1 -1
  215. package/dist/domain/registry/get-fleet-limits.js.map +1 -1
  216. package/dist/domain/registry/grant-scopes.d.ts +4 -3
  217. package/dist/domain/registry/grant-scopes.js +4 -4
  218. package/dist/domain/registry/grant-scopes.js.map +1 -1
  219. package/dist/domain/registry/installation-fleet.d.ts +4 -1
  220. package/dist/domain/registry/installation-fleet.js +9 -2
  221. package/dist/domain/registry/installation-fleet.js.map +1 -1
  222. package/dist/domain/registry/label-value-texts.d.ts +16 -0
  223. package/dist/domain/registry/label-value-texts.js +15 -0
  224. package/dist/domain/registry/label-value-texts.js.map +1 -0
  225. package/dist/domain/registry/limits.d.ts +42 -7
  226. package/dist/domain/registry/limits.js +41 -6
  227. package/dist/domain/registry/limits.js.map +1 -1
  228. package/dist/domain/registry/list-scopes.d.ts +13 -6
  229. package/dist/domain/registry/list-scopes.js +15 -6
  230. package/dist/domain/registry/list-scopes.js.map +1 -1
  231. package/dist/domain/registry/named-namespaces.d.ts +18 -8
  232. package/dist/domain/registry/named-namespaces.js +11 -3
  233. package/dist/domain/registry/named-namespaces.js.map +1 -1
  234. package/dist/domain/registry/ports.d.ts +22 -0
  235. package/dist/domain/registry/public.d.ts +4 -1
  236. package/dist/domain/registry/public.js +4 -1
  237. package/dist/domain/registry/public.js.map +1 -1
  238. package/dist/domain/registry/read-built-in-rules.d.ts +2 -1
  239. package/dist/domain/registry/read-built-in-rules.js +3 -1
  240. package/dist/domain/registry/read-built-in-rules.js.map +1 -1
  241. package/dist/domain/registry/remove-scope.d.ts +29 -0
  242. package/dist/domain/registry/remove-scope.js +32 -0
  243. package/dist/domain/registry/remove-scope.js.map +1 -0
  244. package/dist/domain/registry/resolve-invitees.d.ts +27 -0
  245. package/dist/domain/registry/resolve-invitees.js +27 -0
  246. package/dist/domain/registry/resolve-invitees.js.map +1 -0
  247. package/dist/domain/registry/resolve-label-selection.d.ts +20 -0
  248. package/dist/domain/registry/resolve-label-selection.js +26 -0
  249. package/dist/domain/registry/resolve-label-selection.js.map +1 -0
  250. package/dist/domain/registry/resolve-selector.d.ts +2 -2
  251. package/dist/domain/registry/resolve-selector.js.map +1 -1
  252. package/dist/domain/registry/retire-ship.d.ts +11 -3
  253. package/dist/domain/registry/retire-ship.js +15 -1
  254. package/dist/domain/registry/retire-ship.js.map +1 -1
  255. package/dist/domain/registry/scope-grant.d.ts +6 -2
  256. package/dist/domain/registry/scope-grant.js +9 -5
  257. package/dist/domain/registry/scope-grant.js.map +1 -1
  258. package/dist/domain/registry/scope-namespace.d.ts +5 -1
  259. package/dist/domain/registry/scope-namespace.js +9 -2
  260. package/dist/domain/registry/scope-namespace.js.map +1 -1
  261. package/dist/domain/registry/set-fleet-limits.d.ts +8 -5
  262. package/dist/domain/registry/set-fleet-limits.js +38 -6
  263. package/dist/domain/registry/set-fleet-limits.js.map +1 -1
  264. package/dist/domain/registry/set-installation-settings.d.ts +4 -4
  265. package/dist/domain/registry/set-installation-settings.js +21 -15
  266. package/dist/domain/registry/set-installation-settings.js.map +1 -1
  267. package/dist/domain/registry/ship.d.ts +2 -0
  268. package/dist/domain/registry/ship.js +1 -1
  269. package/dist/domain/registry/ship.js.map +1 -1
  270. package/dist/domain/shared/close-health-snapshots.d.ts +5 -2
  271. package/dist/domain/shared/close-health-snapshots.js +12 -6
  272. package/dist/domain/shared/close-health-snapshots.js.map +1 -1
  273. package/dist/domain/shared/delivery-way.d.ts +4 -0
  274. package/dist/domain/shared/delivery-way.js +5 -2
  275. package/dist/domain/shared/delivery-way.js.map +1 -1
  276. package/dist/domain/shared/errors.d.ts +1 -1
  277. package/dist/domain/shared/errors.js.map +1 -1
  278. package/dist/domain/shared/history-pruning.d.ts +130 -0
  279. package/dist/domain/shared/history-pruning.js +74 -0
  280. package/dist/domain/shared/history-pruning.js.map +1 -0
  281. package/dist/domain/shared/history.d.ts +41 -5
  282. package/dist/domain/shared/history.js +19 -2
  283. package/dist/domain/shared/history.js.map +1 -1
  284. package/dist/domain/shared/prune-history.d.ts +39 -0
  285. package/dist/domain/shared/prune-history.js +98 -0
  286. package/dist/domain/shared/prune-history.js.map +1 -0
  287. package/dist/domain/shared/read-fleet-limits.d.ts +14 -4
  288. package/dist/domain/shared/read-fleet-limits.js +8 -4
  289. package/dist/domain/shared/read-fleet-limits.js.map +1 -1
  290. package/dist/domain/shared/read-message-deliveries.d.ts +30 -0
  291. package/dist/domain/shared/read-message-deliveries.js +24 -0
  292. package/dist/domain/shared/read-message-deliveries.js.map +1 -0
  293. package/dist/domain/shared/read-message.d.ts +4 -1
  294. package/dist/domain/shared/read-message.js +3 -2
  295. package/dist/domain/shared/read-message.js.map +1 -1
  296. package/dist/domain/shared/read-sent-message.d.ts +21 -7
  297. package/dist/domain/shared/read-sent-message.js +19 -6
  298. package/dist/domain/shared/read-sent-message.js.map +1 -1
  299. package/dist/domain/shared/selector.d.ts +32 -11
  300. package/dist/schedule-timer.d.ts +22 -0
  301. package/dist/schedule-timer.js +78 -0
  302. package/dist/schedule-timer.js.map +1 -0
  303. package/dist/wiring.d.ts +36 -0
  304. package/dist/wiring.js +38 -2
  305. package/dist/wiring.js.map +1 -1
  306. package/package.json +2 -2
  307. package/src/adapters/prisma/migrations/20261024160000_meetings/migration.sql +86 -0
  308. package/src/adapters/prisma/migrations/20261024160100_meetings_open_scope/migration.sql +64 -0
  309. package/src/adapters/prisma/migrations/20261024160200_meetings_mic/migration.sql +35 -0
  310. package/src/adapters/prisma/migrations/20261024160300_meetings_life/migration.sql +6 -0
  311. package/src/adapters/prisma/migrations/20261025090000_scheduled_messages_envelope/migration.sql +5 -0
  312. package/src/adapters/prisma/migrations/20261025090100_schedules/migration.sql +109 -0
  313. package/src/adapters/prisma/migrations/20261025120000_repeating_schedules/migration.sql +40 -0
  314. package/src/adapters/prisma/migrations/20261025130000_schedule_limits/migration.sql +11 -0
  315. package/src/adapters/prisma/migrations/20261025140000_send_to_a_label/migration.sql +16 -0
  316. package/src/adapters/prisma/migrations/20261025150000_define_scope/migration.sql +64 -0
  317. package/src/adapters/prisma/migrations/20261025150100_defined_scopes/migration.sql +15 -0
  318. package/src/adapters/prisma/migrations/20261025160000_retention/migration.sql +7 -0
  319. package/src/adapters/prisma/migrations/20261025170000_message_deliveries_page/migration.sql +7 -0
  320. package/src/adapters/prisma/migrations/20261025180000_history_pruning/migration.sql +25 -0
  321. package/src/adapters/prisma/migrations/20261025190000_history_pruning_crew_events/migration.sql +2 -0
  322. package/src/adapters/prisma/migrations/20261025200000_schedule_to_a_label/migration.sql +12 -0
  323. package/src/adapters/prisma/schema.prisma +383 -131
@@ -0,0 +1,109 @@
1
+ -- Scheduled messages (decision 0062): a ship's schedule, its send input as given, its timing and refusal
2
+ -- strategy, its state, next send time and attempt, and its last outcome; a message names the schedule it was sent for.
3
+
4
+ -- CreateEnum
5
+ CREATE TYPE "schedule_state" AS ENUM ('active', 'paused', 'ended', 'cancelled');
6
+
7
+ -- CreateEnum
8
+ CREATE TYPE "schedule_timing_kind" AS ENUM ('once');
9
+
10
+ -- CreateEnum
11
+ CREATE TYPE "refusal_strategy" AS ENUM ('skip', 'retry', 'pause');
12
+
13
+ -- CreateEnum
14
+ CREATE TYPE "schedule_outcome_kind" AS ENUM ('sent', 'refused');
15
+
16
+ -- CreateTable
17
+ CREATE TABLE "schedules" (
18
+ "id" TEXT NOT NULL,
19
+ "fleet_id" TEXT NOT NULL,
20
+ "ship_id" TEXT NOT NULL,
21
+ "selector_kind" "selector_kind" NOT NULL,
22
+ "selector_ship_id" TEXT,
23
+ "selector_ship_name" TEXT,
24
+ "selector_type" TEXT,
25
+ "payload" TEXT NOT NULL,
26
+ "content_type" TEXT NOT NULL,
27
+ "model" TEXT,
28
+ "in_reply_to_message_id" TEXT,
29
+ "is_forced" BOOLEAN NOT NULL,
30
+ "timing_kind" "schedule_timing_kind" NOT NULL,
31
+ "once_at" TIMESTAMPTZ(3) NOT NULL,
32
+ "on_refused" "refusal_strategy" NOT NULL,
33
+ "retry_window" TEXT NOT NULL,
34
+ "idempotency_key" TEXT NOT NULL,
35
+ "request_hash" TEXT NOT NULL,
36
+ "state" "schedule_state" NOT NULL,
37
+ "next_send_time" TIMESTAMPTZ(3),
38
+ "next_attempt_at" TIMESTAMPTZ(3),
39
+ "last_outcome_kind" "schedule_outcome_kind",
40
+ "last_message_id" TEXT,
41
+ "last_refusal_code" TEXT,
42
+ "last_send_time" TIMESTAMPTZ(3),
43
+ "last_outcome_at" TIMESTAMPTZ(3),
44
+ "created_at" TIMESTAMPTZ(3) NOT NULL,
45
+ "ended_at" TIMESTAMPTZ(3),
46
+ "cancelled_at" TIMESTAMPTZ(3),
47
+
48
+ CONSTRAINT "schedules_pkey" PRIMARY KEY ("id")
49
+ );
50
+
51
+ -- CreateIndex
52
+ CREATE INDEX "schedules_fleet_id_ship_id_id_idx" ON "schedules"("fleet_id", "ship_id", "id");
53
+
54
+ -- CreateIndex
55
+ CREATE INDEX "schedules_due_idx" ON "schedules"("fleet_id", "next_attempt_at", "id") WHERE (state = 'active'::schedule_state);
56
+
57
+ -- CreateIndex
58
+ CREATE INDEX "schedules_fleet_id_selector_ship_id_idx" ON "schedules"("fleet_id", "selector_ship_id");
59
+
60
+ -- CreateIndex
61
+ CREATE INDEX "schedules_fleet_id_in_reply_to_message_id_idx" ON "schedules"("fleet_id", "in_reply_to_message_id");
62
+
63
+ -- CreateIndex
64
+ CREATE INDEX "schedules_fleet_id_last_message_id_idx" ON "schedules"("fleet_id", "last_message_id");
65
+
66
+ -- CreateIndex
67
+ CREATE UNIQUE INDEX "schedules_fleet_id_id_key" ON "schedules"("fleet_id", "id");
68
+
69
+ -- CreateIndex
70
+ CREATE UNIQUE INDEX "schedules_fleet_id_ship_id_idempotency_key_key" ON "schedules"("fleet_id", "ship_id", "idempotency_key");
71
+
72
+ -- CreateIndex
73
+ CREATE INDEX "messages_fleet_id_schedule_id_idx" ON "messages"("fleet_id", "schedule_id");
74
+
75
+ -- AddForeignKey
76
+ ALTER TABLE "messages" ADD CONSTRAINT "messages_fleet_id_schedule_id_fkey" FOREIGN KEY ("fleet_id", "schedule_id") REFERENCES "schedules"("fleet_id", "id") ON DELETE RESTRICT ON UPDATE CASCADE;
77
+
78
+ -- AddForeignKey
79
+ ALTER TABLE "schedules" ADD CONSTRAINT "schedules_fleet_id_fkey" FOREIGN KEY ("fleet_id") REFERENCES "fleets"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
80
+
81
+ -- AddForeignKey
82
+ ALTER TABLE "schedules" ADD CONSTRAINT "schedules_fleet_id_ship_id_fkey" FOREIGN KEY ("fleet_id", "ship_id") REFERENCES "ships"("fleet_id", "id") ON DELETE RESTRICT ON UPDATE CASCADE;
83
+
84
+ -- AddForeignKey
85
+ ALTER TABLE "schedules" ADD CONSTRAINT "schedules_fleet_id_selector_ship_id_fkey" FOREIGN KEY ("fleet_id", "selector_ship_id") REFERENCES "ships"("fleet_id", "id") ON DELETE RESTRICT ON UPDATE CASCADE;
86
+
87
+ -- AddForeignKey
88
+ ALTER TABLE "schedules" ADD CONSTRAINT "schedules_fleet_id_in_reply_to_message_id_fkey" FOREIGN KEY ("fleet_id", "in_reply_to_message_id") REFERENCES "messages"("fleet_id", "id") ON DELETE RESTRICT ON UPDATE CASCADE;
89
+
90
+ -- AddForeignKey
91
+ ALTER TABLE "schedules" ADD CONSTRAINT "schedules_fleet_id_last_message_id_fkey" FOREIGN KEY ("fleet_id", "last_message_id") REFERENCES "messages"("fleet_id", "id") ON DELETE RESTRICT ON UPDATE CASCADE;
92
+
93
+
94
+ -- The selector as the creator gave it: a ship by id, a ship by name, or a type; never a meeting.
95
+ ALTER TABLE "schedules" ADD CONSTRAINT "schedules_one_selector" CHECK (
96
+ ("selector_kind" = 'ship' AND "selector_type" IS NULL AND (("selector_ship_id" IS NULL) <> ("selector_ship_name" IS NULL)))
97
+ OR ("selector_kind" = 'type' AND "selector_type" IS NOT NULL AND "selector_ship_id" IS NULL AND "selector_ship_name" IS NULL)
98
+ );
99
+
100
+ -- The last outcome: the message it stored, or the code it was refused with, each with its send time and when.
101
+ ALTER TABLE "schedules" ADD CONSTRAINT "schedules_last_outcome" CHECK (
102
+ ("last_outcome_kind" IS NULL AND "last_message_id" IS NULL AND "last_refusal_code" IS NULL AND "last_send_time" IS NULL AND "last_outcome_at" IS NULL)
103
+ OR ("last_outcome_kind" = 'sent' AND "last_message_id" IS NOT NULL AND "last_refusal_code" IS NULL AND "last_send_time" IS NOT NULL AND "last_outcome_at" IS NOT NULL)
104
+ OR ("last_outcome_kind" = 'refused' AND "last_message_id" IS NULL AND "last_refusal_code" IS NOT NULL AND "last_send_time" IS NOT NULL AND "last_outcome_at" IS NOT NULL)
105
+ );
106
+
107
+ -- Only an active schedule has a next attempt; an ended or cancelled one has no next send time.
108
+ ALTER TABLE "schedules" ADD CONSTRAINT "schedules_next_attempt_when_active" CHECK (("state" = 'active') = ("next_attempt_at" IS NOT NULL));
109
+ ALTER TABLE "schedules" ADD CONSTRAINT "schedules_no_send_time_when_closed" CHECK ("state" IN ('active', 'paused') OR "next_send_time" IS NULL);
@@ -0,0 +1,40 @@
1
+ -- Repeating schedules (decision 0062): every a fixed duration or a cron in its zone, from a start to an end
2
+ -- or a count of sends; what a missed send time does and its grace; a missed send time as a last outcome.
3
+ -- The new enum values are read through ::text below: Postgres refuses a value added in the same transaction.
4
+ ALTER TYPE "schedule_timing_kind" ADD VALUE 'every';
5
+ ALTER TYPE "schedule_timing_kind" ADD VALUE 'cron';
6
+ ALTER TYPE "schedule_outcome_kind" ADD VALUE 'missed';
7
+
8
+ -- CreateEnum
9
+ CREATE TYPE "missed_strategy" AS ENUM ('each', 'once', 'skip');
10
+
11
+ ALTER TABLE "schedules" ALTER COLUMN "once_at" DROP NOT NULL,
12
+ ADD COLUMN "every" TEXT,
13
+ ADD COLUMN "cron" TEXT,
14
+ ADD COLUMN "time_zone" TEXT,
15
+ ADD COLUMN "start" TIMESTAMPTZ(3),
16
+ ADD COLUMN "end" TIMESTAMPTZ(3),
17
+ ADD COLUMN "count" INTEGER,
18
+ ADD COLUMN "on_missed" "missed_strategy" NOT NULL DEFAULT 'each',
19
+ ADD COLUMN "grace" TEXT NOT NULL DEFAULT 'PT5M';
20
+
21
+ -- Every schedule states its own; the defaults only filled the ones already there.
22
+ ALTER TABLE "schedules" ALTER COLUMN "on_missed" DROP DEFAULT, ALTER COLUMN "grace" DROP DEFAULT;
23
+
24
+ -- The timing whole: once an instant; every a duration, cron an expression and its zone, each with optional bounds.
25
+ ALTER TABLE "schedules" ADD CONSTRAINT "schedules_one_timing" CHECK (
26
+ ("timing_kind"::text = 'once' AND "once_at" IS NOT NULL AND "every" IS NULL AND "cron" IS NULL AND "time_zone" IS NULL
27
+ AND "start" IS NULL AND "end" IS NULL AND "count" IS NULL)
28
+ OR ("timing_kind"::text = 'every' AND "once_at" IS NULL AND "every" IS NOT NULL AND "cron" IS NULL AND "time_zone" IS NULL)
29
+ OR ("timing_kind"::text = 'cron' AND "once_at" IS NULL AND "every" IS NULL AND "cron" IS NOT NULL AND "time_zone" IS NOT NULL)
30
+ );
31
+ ALTER TABLE "schedules" ADD CONSTRAINT "schedules_repeat_bounds" CHECK (("count" IS NULL OR "count" >= 1) AND ("start" IS NULL OR "end" IS NULL OR "end" > "start"));
32
+
33
+ -- The last outcome: the message it stored, the code it was refused with, or a send time missed, each with its send time and when.
34
+ ALTER TABLE "schedules" DROP CONSTRAINT "schedules_last_outcome";
35
+ ALTER TABLE "schedules" ADD CONSTRAINT "schedules_last_outcome" CHECK (
36
+ ("last_outcome_kind" IS NULL AND "last_message_id" IS NULL AND "last_refusal_code" IS NULL AND "last_send_time" IS NULL AND "last_outcome_at" IS NULL)
37
+ OR ("last_outcome_kind"::text = 'sent' AND "last_message_id" IS NOT NULL AND "last_refusal_code" IS NULL AND "last_send_time" IS NOT NULL AND "last_outcome_at" IS NOT NULL)
38
+ OR ("last_outcome_kind"::text = 'refused' AND "last_message_id" IS NULL AND "last_refusal_code" IS NOT NULL AND "last_send_time" IS NOT NULL AND "last_outcome_at" IS NOT NULL)
39
+ OR ("last_outcome_kind"::text = 'missed' AND "last_message_id" IS NULL AND "last_refusal_code" IS NULL AND "last_send_time" IS NOT NULL AND "last_outcome_at" IS NOT NULL)
40
+ );
@@ -0,0 +1,11 @@
1
+ -- How a fleet sets the schedules each ship may hold and the minimum interval
2
+ -- of a repeating schedule in seconds (decision 0062): its own (null for no
3
+ -- limit), or the installation default when not set.
4
+ ALTER TABLE "fleets" ADD COLUMN "schedules_per_ship_limit_set" BOOLEAN NOT NULL DEFAULT false,
5
+ ADD COLUMN "schedules_per_ship_limit" INTEGER,
6
+ ADD COLUMN "minimum_schedule_interval_set" BOOLEAN NOT NULL DEFAULT false,
7
+ ADD COLUMN "minimum_schedule_interval" INTEGER;
8
+
9
+ -- The installation's defaults for both, null for no limit.
10
+ ALTER TABLE "installation_settings" ADD COLUMN "default_schedules_per_ship_limit" INTEGER,
11
+ ADD COLUMN "default_minimum_schedule_interval" INTEGER;
@@ -0,0 +1,16 @@
1
+ -- A send to a label (decision 0065): a message keeps the label selection it was sent to, its value ids as sent.
2
+
3
+ -- AlterEnum
4
+ ALTER TYPE "selector_kind" ADD VALUE 'label';
5
+
6
+ -- AlterTable
7
+ ALTER TABLE "messages" ADD COLUMN "selector_value_ids" TEXT[] NOT NULL DEFAULT ARRAY[]::TEXT[];
8
+
9
+ -- A label selector names 1 to 20 value ids and no ship, type or meeting; every other selector names none.
10
+ ALTER TABLE "messages" DROP CONSTRAINT "messages_one_selector";
11
+ ALTER TABLE "messages" ADD CONSTRAINT "messages_one_selector" CHECK (
12
+ ("selector_kind"::text = 'ship' AND "selector_ship_id" IS NOT NULL AND "selector_type" IS NULL AND cardinality("selector_value_ids") = 0)
13
+ OR ("selector_kind"::text = 'type' AND "selector_type" IS NOT NULL AND "selector_ship_id" IS NULL AND cardinality("selector_value_ids") = 0)
14
+ OR ("selector_kind"::text = 'meeting' AND "meeting_id" IS NOT NULL AND "selector_ship_id" IS NULL AND "selector_type" IS NULL AND cardinality("selector_value_ids") = 0)
15
+ OR ("selector_kind"::text = 'label' AND cardinality("selector_value_ids") BETWEEN 1 AND 20 AND "selector_ship_id" IS NULL AND "selector_type" IS NULL AND "meeting_id" IS NULL)
16
+ );
@@ -0,0 +1,64 @@
1
+ -- scopes:define, defining the fleet's own scopes, joins the core scopes in the namespace scopes (decision 0046).
2
+ CREATE OR REPLACE FUNCTION "ships_scopes_are_known"("scopes" TEXT[]) RETURNS BOOLEAN IMMUTABLE LANGUAGE SQL AS $$
3
+ SELECT "scopes" IS NOT NULL AND NOT EXISTS (
4
+ SELECT 1 FROM unnest("scopes") AS "scope"
5
+ WHERE NOT (
6
+ "scope" = ANY(ARRAY['messages:send', 'messages:receive', 'messages:force', 'messages:resend', 'fleet:read', 'fleet:commission', 'fleet:manage', 'crew:assign', 'crew:run', 'labels:define', 'labels:assign', 'fleet:network', 'fleet:on-behalf', 'fleet:person', 'fleet:owner', 'fleet:explain', 'fleet:connect', 'labels:any', 'fleet:verify', 'scopes:declare', 'scopes:grant', 'scopes:define', 'meetings:open']::TEXT[])
7
+ OR ("scope" ~ '^[a-z][a-z0-9-]{0,31}:[a-z][a-z0-9-]{0,31}$' AND split_part("scope", ':', 1) <> ALL(ARRAY['messages', 'fleet', 'crew', 'labels', 'scopes', 'meetings']::TEXT[]))
8
+ )
9
+ )
10
+ $$;
11
+
12
+ -- argo holds every scope: every argo gets scopes:define, its scopes kept in catalogue order, a plugin's own after
13
+ -- them. Every state change writes its event: each argo it changes gets ScopesChanged, by the system, taking
14
+ -- the next number of its fleet's stream. Its id is an evt_ id as common/src/ids makes them: the time in
15
+ -- milliseconds, then 80 random bits, in lowercase Crockford base32.
16
+ DO $$
17
+ DECLARE
18
+ alphabet CONSTANT text := '0123456789abcdefghjkmnpqrstvwxyz';
19
+ catalogue CONSTANT text[] := ARRAY['messages:send', 'messages:receive', 'messages:force', 'messages:resend', 'fleet:read', 'fleet:commission', 'fleet:manage', 'crew:assign', 'crew:run', 'labels:define', 'labels:assign', 'fleet:network', 'fleet:on-behalf', 'fleet:person', 'fleet:owner', 'fleet:explain', 'fleet:connect', 'labels:any', 'fleet:verify', 'scopes:declare', 'scopes:grant', 'scopes:define', 'meetings:open'];
20
+ jobs CONSTANT text[] := ARRAY['scopes:define'];
21
+ changed record;
22
+ at timestamptz;
23
+ millis bigint;
24
+ body text;
25
+ next_seq bigint;
26
+ BEGIN
27
+ FOR changed IN
28
+ WITH "before" AS (
29
+ SELECT "id", "scopes" FROM "ships" WHERE "kind" = 'operator' AND NOT ("scopes" @> jobs) FOR UPDATE
30
+ )
31
+ UPDATE "ships" SET "scopes" = (
32
+ SELECT array_agg("scope" ORDER BY coalesce(array_position(catalogue, "scope"), cardinality(catalogue) + 1), "place")
33
+ FROM unnest("ships"."scopes" || ARRAY(SELECT "job" FROM unnest(jobs) AS "job" WHERE NOT ("job" = ANY("ships"."scopes")))) WITH ORDINALITY AS u("scope", "place")
34
+ )
35
+ FROM "before"
36
+ WHERE "ships"."id" = "before"."id"
37
+ RETURNING "ships"."fleet_id", "ships"."id",
38
+ array_to_string(ARRAY(SELECT "job" FROM unnest(jobs) AS "job" WHERE NOT ("job" = ANY("before"."scopes"))), ' ') AS "added"
39
+ LOOP
40
+ at := clock_timestamp();
41
+ millis := floor(extract(epoch FROM at) * 1000)::bigint;
42
+ body := '';
43
+ FOR position IN REVERSE 9..0 LOOP
44
+ body := body || substr(alphabet, ((millis >> (position * 5)) & 31)::integer + 1, 1);
45
+ END LOOP;
46
+ FOR position IN 1..16 LOOP
47
+ body := body || substr(alphabet, floor(random() * 32)::integer + 1, 1);
48
+ END LOOP;
49
+
50
+ UPDATE "fleets" SET "last_event_seq" = "last_event_seq" + 1 WHERE "id" = changed."fleet_id"
51
+ RETURNING "last_event_seq" INTO next_seq;
52
+ INSERT INTO "events" ("id", "fleet_id", "type", "occurred_at", "ship_id", "details", "seq")
53
+ VALUES (
54
+ 'evt_' || body,
55
+ changed."fleet_id",
56
+ 'ScopesChanged',
57
+ at,
58
+ changed."id",
59
+ jsonb_build_object('added', changed."added", 'removed', ''),
60
+ next_seq
61
+ );
62
+ END LOOP;
63
+ END;
64
+ $$;
@@ -0,0 +1,15 @@
1
+ -- The fleet's own scopes (decision 0046; design gateway-scopes, 4.1): one row per scope, with its one-line
2
+ -- description. A namespace holds either the fleet's scopes or one plugin's; core keeps that rule under the
3
+ -- namespace's advisory lock, as it keeps a plugin's namespace unique.
4
+ -- CreateTable
5
+ CREATE TABLE "defined_scopes" (
6
+ "fleet_id" TEXT NOT NULL,
7
+ "scope" TEXT NOT NULL,
8
+ "description" TEXT NOT NULL,
9
+
10
+ CONSTRAINT "defined_scopes_pkey" PRIMARY KEY ("fleet_id","scope"),
11
+ CONSTRAINT "defined_scopes_scope_check" CHECK ("scope" ~ '^[a-z][a-z0-9-]{0,31}:[a-z][a-z0-9-]{0,31}$')
12
+ );
13
+
14
+ -- AddForeignKey
15
+ ALTER TABLE "defined_scopes" ADD CONSTRAINT "defined_scopes_fleet_id_fkey" FOREIGN KEY ("fleet_id") REFERENCES "fleets"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
@@ -0,0 +1,7 @@
1
+ -- Retention as configuration (decision 0066): the installation's default
2
+ -- retention in days, and how a fleet sets its own (null for kept for good),
3
+ -- or the installation default when not set.
4
+ ALTER TABLE "installation_settings" ADD COLUMN "default_retention_days" INTEGER;
5
+
6
+ ALTER TABLE "fleets" ADD COLUMN "retention_set" BOOLEAN NOT NULL DEFAULT false,
7
+ ADD COLUMN "retention_days" INTEGER;
@@ -0,0 +1,7 @@
1
+ -- A message's deliveries are read a page at a time by id (decision 0065): one per ship of a send to a label.
2
+
3
+ -- DropIndex
4
+ DROP INDEX "deliveries_fleet_id_message_id_idx";
5
+
6
+ -- CreateIndex
7
+ CREATE INDEX "deliveries_fleet_id_message_id_id_idx" ON "deliveries"("fleet_id", "message_id", "id");
@@ -0,0 +1,25 @@
1
+ -- Pruning finished history (decision 0066). A message's in-reply-to and
2
+ -- resend-of stay as written, with no foreign key, so a kept reply may name a
3
+ -- message that is no longer kept.
4
+ ALTER TABLE "messages" DROP CONSTRAINT "messages_fleet_id_in_reply_to_message_id_fkey";
5
+
6
+ ALTER TABLE "messages" DROP CONSTRAINT "messages_fleet_id_resend_of_message_id_fkey";
7
+
8
+ -- When a fleet's last pruning pass ran, and from when it keeps its finished history.
9
+ ALTER TABLE "fleets" ADD COLUMN "kept_from" TIMESTAMPTZ(3),
10
+ ADD COLUMN "pruned_at" TIMESTAMPTZ(3);
11
+
12
+ -- The pruning pass finds the mic and participant events of ended meetings.
13
+ CREATE INDEX "events_meeting_parts_idx" ON "events"("fleet_id", "seq") WHERE (type = ANY (ARRAY['ParticipantAdded'::text, 'ParticipantLeft'::text, 'ParticipantRejoined'::text, 'ParticipantRevoked'::text, 'MicRequested'::text, 'MicRequestWithdrawn'::text, 'MicGiven'::text, 'MicReleased'::text, 'MicTaken'::text, 'MicPatternSet'::text]));
14
+
15
+ -- Events stay append-only. Two exceptions: deleting a whole fleet (decision
16
+ -- 0020) and a pruning batch (decision 0066). Each names the fleet in its own
17
+ -- transaction-local setting, and only that fleet's events may go.
18
+ CREATE OR REPLACE FUNCTION "events_reject_change"() RETURNS trigger LANGUAGE plpgsql AS $$
19
+ BEGIN
20
+ IF TG_OP = 'DELETE' AND (OLD."fleet_id" = current_setting('aeolus.deleting_fleet', true) OR OLD."fleet_id" = current_setting('aeolus.pruning_fleet', true)) THEN
21
+ RETURN OLD;
22
+ END IF;
23
+ RAISE EXCEPTION 'events are append-only: % is not allowed', TG_OP;
24
+ END;
25
+ $$;
@@ -0,0 +1,2 @@
1
+ -- The pruning pass finds a crew's session and secret events past the cutoff (decision 0066).
2
+ CREATE INDEX "events_crew_idx" ON "events"("fleet_id", "occurred_at") WHERE (type = ANY (ARRAY['ShipClaimed'::text, 'LeaseRevoked'::text, 'LeasePushed'::text, 'ShipReported'::text, 'TurnReported'::text, 'StatementSet'::text, 'CrewStatusChanged'::text, 'SignInTicketIssued'::text, 'ViewerSessionStarted'::text, 'StartingPromptIssued'::text, 'CredentialRevoked'::text]));
@@ -0,0 +1,12 @@
1
+ -- A schedule to a label (decision 0065, D6): a schedule keeps the label selection it sends to, its value ids as given.
2
+
3
+ -- AlterTable
4
+ ALTER TABLE "schedules" ADD COLUMN "selector_value_ids" TEXT[] NOT NULL DEFAULT ARRAY[]::TEXT[];
5
+
6
+ -- The selector as the creator gave it: a ship by id, a ship by name, a type, or a label selection of 1 to 20 value ids; never a meeting.
7
+ ALTER TABLE "schedules" DROP CONSTRAINT "schedules_one_selector";
8
+ ALTER TABLE "schedules" ADD CONSTRAINT "schedules_one_selector" CHECK (
9
+ ("selector_kind" = 'ship' AND "selector_type" IS NULL AND (("selector_ship_id" IS NULL) <> ("selector_ship_name" IS NULL)) AND cardinality("selector_value_ids") = 0)
10
+ OR ("selector_kind" = 'type' AND "selector_type" IS NOT NULL AND "selector_ship_id" IS NULL AND "selector_ship_name" IS NULL AND cardinality("selector_value_ids") = 0)
11
+ OR ("selector_kind" = 'label' AND cardinality("selector_value_ids") BETWEEN 1 AND 20 AND "selector_type" IS NULL AND "selector_ship_id" IS NULL AND "selector_ship_name" IS NULL)
12
+ );