@aeolus-fleet/core 0.31.0 → 0.32.1

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 (268) 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 +17 -3
  12. package/dist/adapters/prisma/generated/client.d.ts +17 -3
  13. package/dist/adapters/prisma/generated/commonInputTypes.d.ts +196 -46
  14. package/dist/adapters/prisma/generated/enums.d.ts +32 -0
  15. package/dist/adapters/prisma/generated/enums.js +28 -1
  16. package/dist/adapters/prisma/generated/enums.js.map +1 -1
  17. package/dist/adapters/prisma/generated/internal/class.d.ts +22 -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 +254 -1
  21. package/dist/adapters/prisma/generated/internal/prismaNamespace.js +62 -1
  22. package/dist/adapters/prisma/generated/internal/prismaNamespace.js.map +1 -1
  23. package/dist/adapters/prisma/generated/internal/prismaNamespaceBrowser.d.ts +63 -0
  24. package/dist/adapters/prisma/generated/internal/prismaNamespaceBrowser.js +62 -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/Fleet.d.ts +2128 -2
  30. package/dist/adapters/prisma/generated/models/InstallationSettings.d.ts +108 -4
  31. package/dist/adapters/prisma/generated/models/Message.d.ts +557 -516
  32. package/dist/adapters/prisma/generated/models/Schedule.d.ts +3925 -0
  33. package/dist/adapters/prisma/generated/models/Schedule.js +2 -0
  34. package/dist/adapters/prisma/generated/models/Schedule.js.map +1 -0
  35. package/dist/adapters/prisma/generated/models/Ship.d.ts +736 -3
  36. package/dist/adapters/prisma/generated/models.d.ts +2 -0
  37. package/dist/adapters/prisma/history-pruner.d.ts +3 -0
  38. package/dist/adapters/prisma/history-pruner.js +232 -0
  39. package/dist/adapters/prisma/history-pruner.js.map +1 -0
  40. package/dist/adapters/prisma/history.js +67 -14
  41. package/dist/adapters/prisma/history.js.map +1 -1
  42. package/dist/adapters/prisma/installation.js +27 -8
  43. package/dist/adapters/prisma/installation.js.map +1 -1
  44. package/dist/adapters/prisma/messaging.js +7 -3
  45. package/dist/adapters/prisma/messaging.js.map +1 -1
  46. package/dist/adapters/prisma/registry.js +28 -9
  47. package/dist/adapters/prisma/registry.js.map +1 -1
  48. package/dist/adapters/prisma/rows.js +10 -1
  49. package/dist/adapters/prisma/rows.js.map +1 -1
  50. package/dist/adapters/prisma/schedules.d.ts +12 -0
  51. package/dist/adapters/prisma/schedules.js +255 -0
  52. package/dist/adapters/prisma/schedules.js.map +1 -0
  53. package/dist/adapters/prisma/unit-of-work.d.ts +7 -2
  54. package/dist/adapters/prisma/unit-of-work.js +7 -0
  55. package/dist/adapters/prisma/unit-of-work.js.map +1 -1
  56. package/dist/adapters/trpc/console.d.ts +1 -1
  57. package/dist/adapters/trpc/console.js +3 -6
  58. package/dist/adapters/trpc/console.js.map +1 -1
  59. package/dist/adapters/trpc/context.d.ts +20 -0
  60. package/dist/adapters/trpc/fleet.d.ts +210 -8
  61. package/dist/adapters/trpc/fleet.js +111 -11
  62. package/dist/adapters/trpc/fleet.js.map +1 -1
  63. package/dist/adapters/trpc/installation.d.ts +139 -4
  64. package/dist/adapters/trpc/installation.js +4 -4
  65. package/dist/adapters/trpc/installation.js.map +1 -1
  66. package/dist/adapters/trpc/router.d.ts +508 -8
  67. package/dist/adapters/trpc/schedule-output.d.ts +74 -0
  68. package/dist/adapters/trpc/schedule-output.js +71 -0
  69. package/dist/adapters/trpc/schedule-output.js.map +1 -0
  70. package/dist/adapters/trpc/ship-contract.js +7 -0
  71. package/dist/adapters/trpc/ship-contract.js.map +1 -1
  72. package/dist/adapters/trpc/ship.d.ts +188 -3
  73. package/dist/adapters/trpc/ship.js +105 -11
  74. package/dist/adapters/trpc/ship.js.map +1 -1
  75. package/dist/adapters/trpc/starting-prompt-text.js +5 -5
  76. package/dist/adapters/trpc/starting-prompt-text.js.map +1 -1
  77. package/dist/adapters/trpc/trpc.d.ts +8 -0
  78. package/dist/adapters/trpc/trpc.js +19 -2
  79. package/dist/adapters/trpc/trpc.js.map +1 -1
  80. package/dist/app.d.ts +5 -3
  81. package/dist/app.js +30 -4
  82. package/dist/app.js.map +1 -1
  83. package/dist/domain/messaging/add-to-meeting.js +1 -1
  84. package/dist/domain/messaging/add-to-meeting.js.map +1 -1
  85. package/dist/domain/messaging/cancel-schedule.d.ts +35 -0
  86. package/dist/domain/messaging/cancel-schedule.js +45 -0
  87. package/dist/domain/messaging/cancel-schedule.js.map +1 -0
  88. package/dist/domain/messaging/check-reach-to-each.d.ts +25 -0
  89. package/dist/domain/messaging/check-reach-to-each.js +21 -0
  90. package/dist/domain/messaging/check-reach-to-each.js.map +1 -0
  91. package/dist/domain/messaging/cron.d.ts +46 -0
  92. package/dist/domain/messaging/cron.js +164 -0
  93. package/dist/domain/messaging/cron.js.map +1 -0
  94. package/dist/domain/messaging/daily-message-limit.d.ts +7 -5
  95. package/dist/domain/messaging/daily-message-limit.js +8 -7
  96. package/dist/domain/messaging/daily-message-limit.js.map +1 -1
  97. package/dist/domain/messaging/list-schedules.d.ts +38 -0
  98. package/dist/domain/messaging/list-schedules.js +33 -0
  99. package/dist/domain/messaging/list-schedules.js.map +1 -0
  100. package/dist/domain/messaging/message.d.ts +43 -4
  101. package/dist/domain/messaging/message.js +82 -4
  102. package/dist/domain/messaging/message.js.map +1 -1
  103. package/dist/domain/messaging/open-meeting.js +1 -1
  104. package/dist/domain/messaging/open-meeting.js.map +1 -1
  105. package/dist/domain/messaging/pause-schedule.d.ts +34 -0
  106. package/dist/domain/messaging/pause-schedule.js +44 -0
  107. package/dist/domain/messaging/pause-schedule.js.map +1 -0
  108. package/dist/domain/messaging/ports.d.ts +77 -3
  109. package/dist/domain/messaging/public.d.ts +1 -0
  110. package/dist/domain/messaging/public.js +1 -0
  111. package/dist/domain/messaging/public.js.map +1 -1
  112. package/dist/domain/messaging/push-receive-deliveries.d.ts +4 -1
  113. package/dist/domain/messaging/push-receive-deliveries.js +5 -2
  114. package/dist/domain/messaging/push-receive-deliveries.js.map +1 -1
  115. package/dist/domain/messaging/receive-deliveries.d.ts +4 -1
  116. package/dist/domain/messaging/receive-deliveries.js +2 -0
  117. package/dist/domain/messaging/receive-deliveries.js.map +1 -1
  118. package/dist/domain/messaging/resend-delivery.js +2 -2
  119. package/dist/domain/messaging/resend-delivery.js.map +1 -1
  120. package/dist/domain/messaging/resume-schedule.d.ts +34 -0
  121. package/dist/domain/messaging/resume-schedule.js +37 -0
  122. package/dist/domain/messaging/resume-schedule.js.map +1 -0
  123. package/dist/domain/messaging/retired-scheduler.d.ts +31 -0
  124. package/dist/domain/messaging/retired-scheduler.js +30 -0
  125. package/dist/domain/messaging/retired-scheduler.js.map +1 -0
  126. package/dist/domain/messaging/schedule-access.d.ts +20 -0
  127. package/dist/domain/messaging/schedule-access.js +21 -0
  128. package/dist/domain/messaging/schedule-access.js.map +1 -0
  129. package/dist/domain/messaging/schedule-limits.d.ts +25 -0
  130. package/dist/domain/messaging/schedule-limits.js +51 -0
  131. package/dist/domain/messaging/schedule-limits.js.map +1 -0
  132. package/dist/domain/messaging/schedule-message.d.ts +65 -0
  133. package/dist/domain/messaging/schedule-message.js +151 -0
  134. package/dist/domain/messaging/schedule-message.js.map +1 -0
  135. package/dist/domain/messaging/schedule.d.ts +238 -0
  136. package/dist/domain/messaging/schedule.js +316 -0
  137. package/dist/domain/messaging/schedule.js.map +1 -0
  138. package/dist/domain/messaging/send-due-schedules.d.ts +40 -0
  139. package/dist/domain/messaging/send-due-schedules.js +141 -0
  140. package/dist/domain/messaging/send-due-schedules.js.map +1 -0
  141. package/dist/domain/messaging/send-message.d.ts +10 -3
  142. package/dist/domain/messaging/send-message.js +78 -4
  143. package/dist/domain/messaging/send-message.js.map +1 -1
  144. package/dist/domain/messaging/send-request.d.ts +3 -2
  145. package/dist/domain/messaging/send-request.js +5 -2
  146. package/dist/domain/messaging/send-request.js.map +1 -1
  147. package/dist/domain/registry/applied-limits.d.ts +5 -7
  148. package/dist/domain/registry/applied-limits.js +5 -9
  149. package/dist/domain/registry/applied-limits.js.map +1 -1
  150. package/dist/domain/registry/check-manage.d.ts +23 -0
  151. package/dist/domain/registry/check-manage.js +19 -0
  152. package/dist/domain/registry/check-manage.js.map +1 -0
  153. package/dist/domain/registry/commission-ship.js +3 -3
  154. package/dist/domain/registry/commission-ship.js.map +1 -1
  155. package/dist/domain/registry/declare-scopes.d.ts +5 -3
  156. package/dist/domain/registry/declare-scopes.js +4 -2
  157. package/dist/domain/registry/declare-scopes.js.map +1 -1
  158. package/dist/domain/registry/define-scope.d.ts +33 -0
  159. package/dist/domain/registry/define-scope.js +30 -0
  160. package/dist/domain/registry/define-scope.js.map +1 -0
  161. package/dist/domain/registry/defined-scope.d.ts +68 -0
  162. package/dist/domain/registry/defined-scope.js +83 -0
  163. package/dist/domain/registry/defined-scope.js.map +1 -0
  164. package/dist/domain/registry/describe-scope.d.ts +31 -0
  165. package/dist/domain/registry/describe-scope.js +28 -0
  166. package/dist/domain/registry/describe-scope.js.map +1 -0
  167. package/dist/domain/registry/get-fleet-limits.d.ts +1 -1
  168. package/dist/domain/registry/get-fleet-limits.js +1 -1
  169. package/dist/domain/registry/get-fleet-limits.js.map +1 -1
  170. package/dist/domain/registry/grant-scopes.d.ts +4 -3
  171. package/dist/domain/registry/grant-scopes.js +4 -4
  172. package/dist/domain/registry/grant-scopes.js.map +1 -1
  173. package/dist/domain/registry/installation-fleet.d.ts +4 -1
  174. package/dist/domain/registry/installation-fleet.js +9 -2
  175. package/dist/domain/registry/installation-fleet.js.map +1 -1
  176. package/dist/domain/registry/label-value-texts.d.ts +16 -0
  177. package/dist/domain/registry/label-value-texts.js +15 -0
  178. package/dist/domain/registry/label-value-texts.js.map +1 -0
  179. package/dist/domain/registry/limits.d.ts +42 -7
  180. package/dist/domain/registry/limits.js +41 -6
  181. package/dist/domain/registry/limits.js.map +1 -1
  182. package/dist/domain/registry/list-scopes.d.ts +13 -6
  183. package/dist/domain/registry/list-scopes.js +15 -6
  184. package/dist/domain/registry/list-scopes.js.map +1 -1
  185. package/dist/domain/registry/named-namespaces.d.ts +18 -8
  186. package/dist/domain/registry/named-namespaces.js +11 -3
  187. package/dist/domain/registry/named-namespaces.js.map +1 -1
  188. package/dist/domain/registry/ports.d.ts +20 -0
  189. package/dist/domain/registry/public.d.ts +2 -0
  190. package/dist/domain/registry/public.js +2 -0
  191. package/dist/domain/registry/public.js.map +1 -1
  192. package/dist/domain/registry/remove-scope.d.ts +29 -0
  193. package/dist/domain/registry/remove-scope.js +32 -0
  194. package/dist/domain/registry/remove-scope.js.map +1 -0
  195. package/dist/domain/registry/resolve-label-selection.d.ts +20 -0
  196. package/dist/domain/registry/resolve-label-selection.js +26 -0
  197. package/dist/domain/registry/resolve-label-selection.js.map +1 -0
  198. package/dist/domain/registry/retire-ship.d.ts +5 -2
  199. package/dist/domain/registry/retire-ship.js +6 -1
  200. package/dist/domain/registry/retire-ship.js.map +1 -1
  201. package/dist/domain/registry/scope-grant.d.ts +6 -2
  202. package/dist/domain/registry/scope-grant.js +9 -5
  203. package/dist/domain/registry/scope-grant.js.map +1 -1
  204. package/dist/domain/registry/scope-namespace.d.ts +5 -1
  205. package/dist/domain/registry/scope-namespace.js +9 -2
  206. package/dist/domain/registry/scope-namespace.js.map +1 -1
  207. package/dist/domain/registry/set-fleet-limits.d.ts +8 -5
  208. package/dist/domain/registry/set-fleet-limits.js +38 -6
  209. package/dist/domain/registry/set-fleet-limits.js.map +1 -1
  210. package/dist/domain/registry/set-installation-settings.d.ts +4 -4
  211. package/dist/domain/registry/set-installation-settings.js +21 -15
  212. package/dist/domain/registry/set-installation-settings.js.map +1 -1
  213. package/dist/domain/registry/ship.d.ts +2 -0
  214. package/dist/domain/registry/ship.js +1 -1
  215. package/dist/domain/registry/ship.js.map +1 -1
  216. package/dist/domain/shared/delivery-way.d.ts +4 -0
  217. package/dist/domain/shared/delivery-way.js +5 -2
  218. package/dist/domain/shared/delivery-way.js.map +1 -1
  219. package/dist/domain/shared/errors.d.ts +1 -1
  220. package/dist/domain/shared/errors.js.map +1 -1
  221. package/dist/domain/shared/history-pruning.d.ts +130 -0
  222. package/dist/domain/shared/history-pruning.js +74 -0
  223. package/dist/domain/shared/history-pruning.js.map +1 -0
  224. package/dist/domain/shared/history.d.ts +33 -5
  225. package/dist/domain/shared/history.js +3 -1
  226. package/dist/domain/shared/history.js.map +1 -1
  227. package/dist/domain/shared/prune-history.d.ts +39 -0
  228. package/dist/domain/shared/prune-history.js +98 -0
  229. package/dist/domain/shared/prune-history.js.map +1 -0
  230. package/dist/domain/shared/read-fleet-limits.d.ts +14 -4
  231. package/dist/domain/shared/read-fleet-limits.js +8 -4
  232. package/dist/domain/shared/read-fleet-limits.js.map +1 -1
  233. package/dist/domain/shared/read-message-deliveries.d.ts +30 -0
  234. package/dist/domain/shared/read-message-deliveries.js +24 -0
  235. package/dist/domain/shared/read-message-deliveries.js.map +1 -0
  236. package/dist/domain/shared/read-message.d.ts +4 -1
  237. package/dist/domain/shared/read-message.js +3 -2
  238. package/dist/domain/shared/read-message.js.map +1 -1
  239. package/dist/domain/shared/read-sent-message.d.ts +21 -7
  240. package/dist/domain/shared/read-sent-message.js +19 -6
  241. package/dist/domain/shared/read-sent-message.js.map +1 -1
  242. package/dist/domain/shared/selector.d.ts +21 -8
  243. package/dist/domain/shared/stuck.d.ts +3 -2
  244. package/dist/domain/shared/stuck.js +1 -1
  245. package/dist/domain/shared/stuck.js.map +1 -1
  246. package/dist/schedule-timer.d.ts +22 -0
  247. package/dist/schedule-timer.js +78 -0
  248. package/dist/schedule-timer.js.map +1 -0
  249. package/dist/testing/temporal-setup.d.ts +1 -0
  250. package/dist/testing/temporal-setup.js +7 -0
  251. package/dist/testing/temporal-setup.js.map +1 -0
  252. package/dist/wiring.d.ts +26 -0
  253. package/dist/wiring.js +27 -1
  254. package/dist/wiring.js.map +1 -1
  255. package/package.json +3 -2
  256. package/src/adapters/prisma/migrations/20261025090000_scheduled_messages_envelope/migration.sql +5 -0
  257. package/src/adapters/prisma/migrations/20261025090100_schedules/migration.sql +109 -0
  258. package/src/adapters/prisma/migrations/20261025120000_repeating_schedules/migration.sql +40 -0
  259. package/src/adapters/prisma/migrations/20261025130000_schedule_limits/migration.sql +11 -0
  260. package/src/adapters/prisma/migrations/20261025140000_send_to_a_label/migration.sql +16 -0
  261. package/src/adapters/prisma/migrations/20261025150000_define_scope/migration.sql +64 -0
  262. package/src/adapters/prisma/migrations/20261025150100_defined_scopes/migration.sql +15 -0
  263. package/src/adapters/prisma/migrations/20261025160000_retention/migration.sql +7 -0
  264. package/src/adapters/prisma/migrations/20261025170000_message_deliveries_page/migration.sql +7 -0
  265. package/src/adapters/prisma/migrations/20261025180000_history_pruning/migration.sql +25 -0
  266. package/src/adapters/prisma/migrations/20261025190000_history_pruning_crew_events/migration.sql +2 -0
  267. package/src/adapters/prisma/migrations/20261025200000_schedule_to_a_label/migration.sql +12 -0
  268. package/src/adapters/prisma/schema.prisma +179 -26
@@ -0,0 +1,130 @@
1
+ import { type ConsoleSessionId, type CredentialId, type DeliveryState, type EventId, type FleetId, type LeaseId, type MessageId, type ReachRefusalId } from '@aeolus-fleet/common';
2
+ /** Where a delivery's claiming lease stands: whether a re-read of an acknowledged delivery can still come (L2). */
3
+ export type ClaimingLease = 'none' | 'ended' | 'open' | 'openPushed';
4
+ /** One delivery of a candidate message, as its locked row stands. */
5
+ export interface CandidateDelivery {
6
+ state: DeliveryState;
7
+ claimingLease: ClaimingLease;
8
+ }
9
+ /** A message older than the cutoff that the port offers, with what decides whether it is finished. */
10
+ export interface PruneCandidate {
11
+ id: MessageId;
12
+ createdAt: Date;
13
+ contentType: string;
14
+ /** Whether a reply of the answer content type names it. */
15
+ isAnswered: boolean;
16
+ /** The meeting it was sent to or is the added notice of: none, not ended, or ended. */
17
+ meeting: 'none' | 'open' | 'ended';
18
+ /** Whether a schedule names it, as its in-reply-to or its last sent message: a kept row names it. */
19
+ isNamedBySchedule: boolean;
20
+ /** Whether the message or one of its deliveries was locked by another transaction and skipped. */
21
+ isLocked: boolean;
22
+ /** Whether an event of the message or of one of its deliveries is one the newest snapshot has not folded yet (R7). */
23
+ hasUnfoldedEvent: boolean;
24
+ deliveries: readonly CandidateDelivery[];
25
+ }
26
+ /**
27
+ * Final: handled, dismissed, abandoned, or acknowledged where no re-read can
28
+ * come, its claiming lease ended or never pushed (R2). Pending, received,
29
+ * handed, undeliverable and not handled never are (L1, L2).
30
+ */
31
+ export declare function isFinalDelivery(delivery: CandidateDelivery): boolean;
32
+ /**
33
+ * A message is finished when every delivery of it is final, and it is not an
34
+ * open question (L6, L21; a withdrawn or replaced one too, R15) or a
35
+ * contribution to a meeting not ended (R2); a message a schedule names stays,
36
+ * as the schedule does, and a row another transaction holds, or one with an
37
+ * event the snapshot has not folded yet (R7), waits for the next pass.
38
+ */
39
+ export declare function isFinished(candidate: PruneCandidate): boolean;
40
+ /**
41
+ * The cutoff: now minus the fleet's retention, never later than the hour of
42
+ * its newest stuck snapshot, so no event the snapshot has not folded goes
43
+ * (R7, L9).
44
+ */
45
+ export declare function pruningCutoff(input: {
46
+ now: Date;
47
+ retentionDays: number;
48
+ newestSnapshotHour: Date;
49
+ }): Date;
50
+ /**
51
+ * A crew's session events and its secret's, which name no message or
52
+ * delivery and go by age past the cutoff (R3, Q8). Every other event that
53
+ * names none is a change to the fleet itself, kept for good.
54
+ */
55
+ export declare const CREW_EVENT_TYPES: readonly ["ShipClaimed", "LeaseRevoked", "LeasePushed", "ShipReported", "TurnReported", "StatementSet", "CrewStatusChanged", "SignInTicketIssued", "ViewerSessionStarted", "StartingPromptIssued", "CredentialRevoked"];
56
+ /** How many rows of each kind one batch let go: what its HistoryPruned event says (R9). */
57
+ export interface PrunedCounts {
58
+ messages: number;
59
+ deliveries: number;
60
+ events: number;
61
+ overdueDeliveries: number;
62
+ leases: number;
63
+ credentials: number;
64
+ consoleSessions: number;
65
+ noticeDismissals: number;
66
+ guideProgress: number;
67
+ signInTickets: number;
68
+ reachRefusals: number;
69
+ }
70
+ /** Where the next batch picks up: after the last candidate the last batch read, oldest first. */
71
+ export interface PruneCursor {
72
+ createdAt: Date;
73
+ id: MessageId;
74
+ }
75
+ /** The rows that go by age past the cutoff, whatever messages go (R3, R4, R13). */
76
+ export interface AgedRows {
77
+ /** A crew's session and secret events, ones the newest snapshot folded (R3, R7). */
78
+ eventIds: readonly EventId[];
79
+ /** Ended leases no row outside the set names. */
80
+ leaseIds: readonly LeaseId[];
81
+ credentialIds: readonly CredentialId[];
82
+ /** Console sessions ended or expired, which no use renews again; each takes its notice dismissals and guide progress with it. */
83
+ consoleSessionIds: readonly ConsoleSessionId[];
84
+ /** Used or expired sign-in tickets, by their token hash. */
85
+ signInTicketHashes: readonly string[];
86
+ reachRefusalIds: readonly ReachRefusalId[];
87
+ }
88
+ /** The rows one batch chose, as one set (R16). */
89
+ export interface PruneSet extends AgedRows {
90
+ messageIds: readonly MessageId[];
91
+ /** The mic and participant events of meetings ended before the cutoff (R12). */
92
+ meetingEventIds: readonly EventId[];
93
+ }
94
+ /** Outbound port: the pruning pass's reads and its one step that makes a set go, in the batch's unit of work. */
95
+ export interface HistoryPruner {
96
+ /** Marks the fleet's pass as run at `at` when its last ran at or before `dueBefore`, or never; false when another pass ran since. */
97
+ claimPass(fleetId: FleetId, input: {
98
+ at: Date;
99
+ dueBefore: Date;
100
+ }): Promise<boolean>;
101
+ /** The hour of the fleet's newest stuck snapshot; none before its first. */
102
+ newestSnapshotHour(fleetId: FleetId): Promise<Date | undefined>;
103
+ /** The fleet's prune lock, for this unit of work, taken with try: false when another server holds it. */
104
+ tryLock(fleetId: FleetId): Promise<boolean>;
105
+ /** Up to `limit` messages created before the cutoff and after the cursor, oldest first, each row locked or marked locked. */
106
+ candidates(fleetId: FleetId, input: {
107
+ cutoff: Date;
108
+ after: PruneCursor | null;
109
+ limit: number;
110
+ }): Promise<PruneCandidate[]>;
111
+ /** Up to `limit` mic and participant events of meetings ended before the cutoff. */
112
+ meetingEvents(fleetId: FleetId, input: {
113
+ cutoff: Date;
114
+ limit: number;
115
+ }): Promise<EventId[]>;
116
+ /**
117
+ * Up to `limit` rows of each kind that ended, were used or expired, or
118
+ * happened before the cutoff (R3, R4, R13); an ended lease only when no row
119
+ * outside the set, with `messageIds` going, names it.
120
+ */
121
+ agedRows(fleetId: FleetId, input: {
122
+ cutoff: Date;
123
+ messageIds: readonly MessageId[];
124
+ limit: number;
125
+ }): Promise<AgedRows>;
126
+ /** Makes the set go, children first, taking each message's payload bytes off its day (R6, R16). */
127
+ go(fleetId: FleetId, set: PruneSet): Promise<PrunedCounts>;
128
+ /** Records where the fleet's finished history begins (R9). */
129
+ keepFrom(fleetId: FleetId, at: Date): Promise<void>;
130
+ }
@@ -0,0 +1,74 @@
1
+ import { QUESTION_CONTENT_TYPE, } from '@aeolus-fleet/common';
2
+ /**
3
+ * What a fleet's pruning pass may let go (docs/design/retention/retention.md,
4
+ * R2 to R4, R7, R12 and R13): the rules, as plain functions, and the port the pass reads
5
+ * and prunes through. The port's query only offers messages its own filter
6
+ * finds finished; these rules decide again on the rows it locked, so a row
7
+ * that changed or was skipped as locked stays.
8
+ */
9
+ const DAY_MS = 24 * 60 * 60 * 1000;
10
+ /**
11
+ * Final: handled, dismissed, abandoned, or acknowledged where no re-read can
12
+ * come, its claiming lease ended or never pushed (R2). Pending, received,
13
+ * handed, undeliverable and not handled never are (L1, L2).
14
+ */
15
+ export function isFinalDelivery(delivery) {
16
+ switch (delivery.state) {
17
+ case 'handled':
18
+ case 'dismissed':
19
+ case 'abandoned':
20
+ return true;
21
+ case 'acknowledged':
22
+ return delivery.claimingLease !== 'openPushed';
23
+ case 'pending':
24
+ case 'received':
25
+ case 'handed':
26
+ case 'notHandled':
27
+ case 'undeliverable':
28
+ return false;
29
+ }
30
+ }
31
+ /**
32
+ * A message is finished when every delivery of it is final, and it is not an
33
+ * open question (L6, L21; a withdrawn or replaced one too, R15) or a
34
+ * contribution to a meeting not ended (R2); a message a schedule names stays,
35
+ * as the schedule does, and a row another transaction holds, or one with an
36
+ * event the snapshot has not folded yet (R7), waits for the next pass.
37
+ */
38
+ export function isFinished(candidate) {
39
+ if (candidate.isLocked || candidate.hasUnfoldedEvent || candidate.isNamedBySchedule || candidate.meeting === 'open') {
40
+ return false;
41
+ }
42
+ if (candidate.contentType === QUESTION_CONTENT_TYPE && !candidate.isAnswered) {
43
+ return false;
44
+ }
45
+ return candidate.deliveries.every(isFinalDelivery);
46
+ }
47
+ /**
48
+ * The cutoff: now minus the fleet's retention, never later than the hour of
49
+ * its newest stuck snapshot, so no event the snapshot has not folded goes
50
+ * (R7, L9).
51
+ */
52
+ export function pruningCutoff(input) {
53
+ const byRetention = input.now.getTime() - input.retentionDays * DAY_MS;
54
+ return new Date(Math.min(byRetention, input.newestSnapshotHour.getTime()));
55
+ }
56
+ /**
57
+ * A crew's session events and its secret's, which name no message or
58
+ * delivery and go by age past the cutoff (R3, Q8). Every other event that
59
+ * names none is a change to the fleet itself, kept for good.
60
+ */
61
+ export const CREW_EVENT_TYPES = [
62
+ 'ShipClaimed',
63
+ 'LeaseRevoked',
64
+ 'LeasePushed',
65
+ 'ShipReported',
66
+ 'TurnReported',
67
+ 'StatementSet',
68
+ 'CrewStatusChanged',
69
+ 'SignInTicketIssued',
70
+ 'ViewerSessionStarted',
71
+ 'StartingPromptIssued',
72
+ 'CredentialRevoked',
73
+ ];
74
+ //# sourceMappingURL=history-pruning.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"history-pruning.js","sourceRoot":"","sources":["../../../src/domain/shared/history-pruning.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,GAUtB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;GAMG;AAEH,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AA6BnC;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,QAA2B;IACzD,QAAQ,QAAQ,CAAC,KAAK,EAAE,CAAC;QACvB,KAAK,SAAS,CAAC;QACf,KAAK,WAAW,CAAC;QACjB,KAAK,WAAW;YACd,OAAO,IAAI,CAAC;QACd,KAAK,cAAc;YACjB,OAAO,QAAQ,CAAC,aAAa,KAAK,YAAY,CAAC;QACjD,KAAK,SAAS,CAAC;QACf,KAAK,UAAU,CAAC;QAChB,KAAK,QAAQ,CAAC;QACd,KAAK,YAAY,CAAC;QAClB,KAAK,eAAe;YAClB,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,SAAyB;IAClD,IAAI,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,gBAAgB,IAAI,SAAS,CAAC,iBAAiB,IAAI,SAAS,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;QACpH,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,SAAS,CAAC,WAAW,KAAK,qBAAqB,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;QAC7E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAqE;IACjG,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,aAAa,GAAG,MAAM,CAAC;IACvE,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,kBAAkB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,aAAa;IACb,cAAc;IACd,aAAa;IACb,cAAc;IACd,cAAc;IACd,cAAc;IACd,mBAAmB;IACnB,oBAAoB;IACpB,sBAAsB;IACtB,sBAAsB;IACtB,mBAAmB;CACoB,CAAC"}
@@ -1,7 +1,7 @@
1
- import { DELIVERY_HISTORY_TYPES, type AccountId, type ComputerSide, type LeaseEndReason, type InboxFilter, type DeliveryId, type DeliveryState, type EventId, type EventType, type FleetId, type MeetingId, type MessageId, type ShipId } from '@aeolus-fleet/common';
1
+ import { DELIVERY_HISTORY_TYPES, type AccountId, type ComputerSide, type LeaseEndReason, type InboxFilter, type DeliveryId, type DeliveryState, type EventId, type EventType, type FleetId, type LabelValueId, type MeetingId, type MessageId, type ShipId } from '@aeolus-fleet/common';
2
2
  import type { OverdueClock } from '../messaging/public.js';
3
3
  import type { Location, MessageParties } from '../registry/public.js';
4
- import type { StandingOverdue, WayCrew, WayLease } from './delivery-way.js';
4
+ import type { DeliveryStateStep, StandingOverdue, WayCrew, WayLease } from './delivery-way.js';
5
5
  import type { EventDetails } from './events.js';
6
6
  import type { Page, PageQuery } from './page.js';
7
7
  /**
@@ -15,7 +15,13 @@ export interface HistoryParty {
15
15
  id: ShipId;
16
16
  name: string;
17
17
  }
18
- /** Who a message was addressed to: one ship, or any ship of a type. */
18
+ /** A label value of a selection by its texts; both null once its label no longer has the value. */
19
+ export interface HistoryLabelValue {
20
+ valueId: LabelValueId;
21
+ key: string | null;
22
+ value: string | null;
23
+ }
24
+ /** Who a message was addressed to: one ship, any ship of a type, a meeting, or a label selection by its texts (decision 0065). */
19
25
  export type HistoryRecipient = {
20
26
  kind: 'ship';
21
27
  ship: HistoryParty;
@@ -25,6 +31,9 @@ export type HistoryRecipient = {
25
31
  } | {
26
32
  kind: 'meeting';
27
33
  meetingId: MeetingId;
34
+ } | {
35
+ kind: 'label';
36
+ values: readonly HistoryLabelValue[];
28
37
  };
29
38
  /** One event on a ship's timeline, with its parties named. */
30
39
  export interface TimelineEntry {
@@ -51,7 +60,8 @@ export interface TimelineEntry {
51
60
  * A message's parties as read reach sees them; for a type, `claimedBy` is the
52
61
  * ship that claimed it, if one has. A contribution to a meeting is read
53
62
  * through its sender or the participant its delivery went to, `claimedBy`
54
- * here, else through its sender alone (decision 0061).
63
+ * here, else through its sender alone (decision 0061); so is a send to a
64
+ * label, through the ship its delivery went to (decision 0065).
55
65
  */
56
66
  export declare function partiesOf(message: {
57
67
  sender: HistoryParty;
@@ -134,14 +144,28 @@ export interface HistoryReply {
134
144
  sender: HistoryParty;
135
145
  sentAt: Date;
136
146
  }
147
+ /**
148
+ * One delivery of a message: the ship it went to, or the ship of the type
149
+ * that claimed it (null while none has), its state, and the steps that tell
150
+ * when it entered it, newest first.
151
+ */
152
+ export interface MessageDelivery {
153
+ id: DeliveryId;
154
+ ship: HistoryParty | null;
155
+ state: DeliveryState;
156
+ steps: DeliveryStateStep[];
157
+ }
137
158
  /**
138
159
  * One message as the history reads it: its delivery's steps newest first,
139
160
  * its replies oldest first, and what its way is read from: the lease that
140
161
  * holds it or that a pending delivery to one ship waits for, the overdue
141
- * clock that stands, and the crew request of that lease's ship.
162
+ * clock that stands, and the crew request of that lease's ship. How many
163
+ * deliveries it has comes too: one per ship of a send to a label (decision
164
+ * 0065), whose first by id is the delivery above.
142
165
  */
143
166
  export type MessageRead = HistoryMessage & {
144
167
  history: DeliveryChange[];
168
+ deliveryCount: number;
145
169
  replies: HistoryReply[];
146
170
  lease: WayLease | null;
147
171
  overdue: StandingOverdue | null;
@@ -218,6 +242,10 @@ export interface ShipHistory {
218
242
  } & PageQuery<MessageId>): Promise<Page<HistoryMessage, MessageId> | undefined>;
219
243
  /** The message, with its delivery's steps newest first and what its way is read from. */
220
244
  message(fleetId: FleetId, messageId: MessageId): Promise<MessageRead | undefined>;
245
+ /** A page of the message's deliveries by id, after the delivery the cursor names; empty when the fleet has no such message. */
246
+ messageDeliveries(fleetId: FleetId, query: {
247
+ messageId: MessageId;
248
+ } & PageQuery<DeliveryId>): Promise<Page<MessageDelivery, DeliveryId>>;
221
249
  /**
222
250
  * A page of the undeliverable or not handled deliveries, or those in one
223
251
  * of the two states, the fleet's or those naming one ship, oldest first by since when, after the delivery the
@@ -3,7 +3,8 @@ import { DELIVERY_HISTORY_TYPES, isPingContentType, } from '@aeolus-fleet/common
3
3
  * A message's parties as read reach sees them; for a type, `claimedBy` is the
4
4
  * ship that claimed it, if one has. A contribution to a meeting is read
5
5
  * through its sender or the participant its delivery went to, `claimedBy`
6
- * here, else through its sender alone (decision 0061).
6
+ * here, else through its sender alone (decision 0061); so is a send to a
7
+ * label, through the ship its delivery went to (decision 0065).
7
8
  */
8
9
  export function partiesOf(message, claimedBy) {
9
10
  const { sender, recipient } = message;
@@ -20,6 +21,7 @@ function recipientParty(recipient, participant) {
20
21
  case 'type':
21
22
  return recipient;
22
23
  case 'meeting':
24
+ case 'label':
23
25
  return { kind: 'ship', shipId: participant.id };
24
26
  }
25
27
  }
@@ -1 +1 @@
1
- {"version":3,"file":"history.js","sourceRoot":"","sources":["../../../src/domain/shared/history.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAalB,MAAM,sBAAsB,CAAC;AAwC9B;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,OAA8D,EAAE,SAA8B;IACtH,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IACtC,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,EAAE;QACnB,SAAS,EAAE,cAAc,CAAC,SAAS,EAAE,SAAS,IAAI,MAAM,CAAC;QACzD,SAAS,EAAE,SAAS,EAAE,EAAE,IAAI,IAAI;KACjC,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,SAA2B,EAAE,WAAyB;IAC5E,QAAQ,SAAS,CAAC,IAAI,EAAE,CAAC;QACvB,KAAK,MAAM;YACT,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACrD,KAAK,MAAM;YACT,OAAO,SAAS,CAAC;QACnB,KAAK,SAAS;YACZ,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC;IACpD,CAAC;AACH,CAAC;AAKD,MAAM,UAAU,QAAQ,CAAoC,OAAU;IACpE,OAAO,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,iBAAiB,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;AACxE,CAAC;AAgCD,MAAM,UAAU,oBAAoB,CAAC,IAAe;IAClD,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC;AAClE,CAAC;AA6GD,+FAA+F;AAC/F,MAAM,UAAU,QAAQ,CAAC,MAAmB,EAAE,KAAoB;IAChE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,QAAQ,CAAC;QAC3E,KAAK,MAAM;YACT,OAAO,KAAK,KAAK,cAAc,CAAC;QAClC,KAAK,KAAK;YACR,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}
1
+ {"version":3,"file":"history.js","sourceRoot":"","sources":["../../../src/domain/shared/history.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAclB,MAAM,sBAAsB,CAAC;AAmD9B;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,OAA8D,EAAE,SAA8B;IACtH,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IACtC,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,EAAE;QACnB,SAAS,EAAE,cAAc,CAAC,SAAS,EAAE,SAAS,IAAI,MAAM,CAAC;QACzD,SAAS,EAAE,SAAS,EAAE,EAAE,IAAI,IAAI;KACjC,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,SAA2B,EAAE,WAAyB;IAC5E,QAAQ,SAAS,CAAC,IAAI,EAAE,CAAC;QACvB,KAAK,MAAM;YACT,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACrD,KAAK,MAAM;YACT,OAAO,SAAS,CAAC;QACnB,KAAK,SAAS,CAAC;QACf,KAAK,OAAO;YACV,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC;IACpD,CAAC;AACH,CAAC;AAKD,MAAM,UAAU,QAAQ,CAAoC,OAAU;IACpE,OAAO,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,iBAAiB,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;AACxE,CAAC;AAgCD,MAAM,UAAU,oBAAoB,CAAC,IAAe;IAClD,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC;AAClE,CAAC;AA4HD,+FAA+F;AAC/F,MAAM,UAAU,QAAQ,CAAC,MAAmB,EAAE,KAAoB;IAChE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,QAAQ,CAAC;QAC3E,KAAK,MAAM;YACT,OAAO,KAAK,KAAK,cAAc,CAAC;QAClC,KAAK,KAAK;YACR,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}
@@ -0,0 +1,39 @@
1
+ import type { FleetId, IdGenerator } from '@aeolus-fleet/common';
2
+ import { type AppliedLimitsTx, type FleetRepository } from '../registry/public.js';
3
+ import type { Clock } from './clock.js';
4
+ import { type EventLog } from './events.js';
5
+ import { type HistoryPruner } from './history-pruning.js';
6
+ import type { UnitOfWork } from './unit-of-work.js';
7
+ /** How many messages, and how many rows of each other kind, one batch reads at most: each batch stays one short transaction. */
8
+ export declare const PRUNE_BATCH = 500;
9
+ /** How long one fleet's pass prunes before it leaves the rest to the next hour (R8). */
10
+ export declare const PRUNE_BUDGET_MS = 10000;
11
+ export interface PruneHistoryTx extends AppliedLimitsTx {
12
+ historyPruner: HistoryPruner;
13
+ events: EventLog;
14
+ }
15
+ /** Prunes every due fleet; `onFleetError` (the pass always gives it) is told of a fleet whose pass threw, and the pass goes on with the next fleet. */
16
+ export type PruneHistory = (onFleetError?: (fleetId: FleetId, error: unknown) => void) => Promise<void>;
17
+ /**
18
+ * Use case: the pruning pass (docs/design/retention/retention.md, R2 to R4,
19
+ * R6 to R9, R12, R13 and R16), run by core in the 30 second pass after the
20
+ * snapshot close, never through the API. A fleet with a retention whose last pass is an
21
+ * hour old or more is claimed for this hour, then pruned in batches, each one
22
+ * unit of work under the fleet's prune lock taken with try: a batch picks the
23
+ * finished messages older than the cutoff, the mic and participant events of
24
+ * meetings ended before it, and the rows that go by age past it (a crew's
25
+ * session and secret events, ended leases, invalidated secrets, ended or
26
+ * expired console sessions, used or expired sign-in tickets and reach refusals), makes that
27
+ * one set go and writes HistoryPruned. A batch that fails rolls back whole; a fleet another server
28
+ * is pruning is skipped. Once nothing older than the cutoff is left, the
29
+ * fleet's kept from moves to the cutoff; a pass whose time budget is spent
30
+ * leaves the rest to the next hour.
31
+ */
32
+ export declare function createPruneHistory(deps: {
33
+ fleets: Pick<FleetRepository, 'list'>;
34
+ uow: UnitOfWork<PruneHistoryTx>;
35
+ clock: Clock;
36
+ ids: IdGenerator;
37
+ batch?: number;
38
+ budgetMs?: number;
39
+ }): PruneHistory;
@@ -0,0 +1,98 @@
1
+ import { appliedLimits } from '../registry/public.js';
2
+ import { recordEvent, SYSTEM } from './events.js';
3
+ import { isFinished, pruningCutoff } from './history-pruning.js';
4
+ import { ok } from './result.js';
5
+ const HOUR_MS = 60 * 60 * 1000;
6
+ /** How many messages, and how many rows of each other kind, one batch reads at most: each batch stays one short transaction. */
7
+ export const PRUNE_BATCH = 500;
8
+ /** How long one fleet's pass prunes before it leaves the rest to the next hour (R8). */
9
+ export const PRUNE_BUDGET_MS = 10_000;
10
+ /**
11
+ * Use case: the pruning pass (docs/design/retention/retention.md, R2 to R4,
12
+ * R6 to R9, R12, R13 and R16), run by core in the 30 second pass after the
13
+ * snapshot close, never through the API. A fleet with a retention whose last pass is an
14
+ * hour old or more is claimed for this hour, then pruned in batches, each one
15
+ * unit of work under the fleet's prune lock taken with try: a batch picks the
16
+ * finished messages older than the cutoff, the mic and participant events of
17
+ * meetings ended before it, and the rows that go by age past it (a crew's
18
+ * session and secret events, ended leases, invalidated secrets, ended or
19
+ * expired console sessions, used or expired sign-in tickets and reach refusals), makes that
20
+ * one set go and writes HistoryPruned. A batch that fails rolls back whole; a fleet another server
21
+ * is pruning is skipped. Once nothing older than the cutoff is left, the
22
+ * fleet's kept from moves to the cutoff; a pass whose time budget is spent
23
+ * leaves the rest to the next hour.
24
+ */
25
+ export function createPruneHistory(deps) {
26
+ const batchSize = deps.batch ?? PRUNE_BATCH;
27
+ const budgetMs = deps.budgetMs ?? PRUNE_BUDGET_MS;
28
+ const claim = (fleetId) => deps.uow.run(async (tx) => {
29
+ const retentionDays = (await appliedLimits(tx, fleetId)).retention;
30
+ const newestSnapshotHour = await tx.historyPruner.newestSnapshotHour(fleetId);
31
+ if (retentionDays === null || newestSnapshotHour === undefined) {
32
+ return ok(null);
33
+ }
34
+ const now = deps.clock.now();
35
+ if (!(await tx.historyPruner.claimPass(fleetId, { at: now, dueBefore: new Date(now.getTime() - HOUR_MS) }))) {
36
+ return ok(null);
37
+ }
38
+ return ok(pruningCutoff({ now, retentionDays, newestSnapshotHour }));
39
+ });
40
+ const pruneBatch = (fleetId, input) => deps.uow.run(async (tx) => {
41
+ const pruner = tx.historyPruner;
42
+ if (!(await pruner.tryLock(fleetId))) {
43
+ return ok({ kind: 'skipped' });
44
+ }
45
+ const [candidates, meetingEventIds] = await Promise.all([
46
+ pruner.candidates(fleetId, { cutoff: input.cutoff, after: input.after, limit: batchSize }),
47
+ pruner.meetingEvents(fleetId, { cutoff: input.cutoff, limit: batchSize }),
48
+ ]);
49
+ const messageIds = candidates.filter(isFinished).map((candidate) => candidate.id);
50
+ const aged = await pruner.agedRows(fleetId, { cutoff: input.cutoff, messageIds, limit: batchSize });
51
+ const agedKinds = [aged.eventIds, aged.leaseIds, aged.credentialIds, aged.consoleSessionIds, aged.signInTicketHashes, aged.reachRefusalIds];
52
+ if (messageIds.length > 0 || meetingEventIds.length > 0 || agedKinds.some((rows) => rows.length > 0)) {
53
+ const counts = await pruner.go(fleetId, { messageIds, meetingEventIds, ...aged });
54
+ await recordEvent({ events: tx.events, ids: deps.ids }, { fleetId, type: 'HistoryPruned', occurredAt: deps.clock.now(), actor: SYSTEM, details: { cutoff: input.cutoff.toISOString(), ...counts } });
55
+ }
56
+ const last = candidates.at(-1);
57
+ const isMoreLeft = candidates.length === batchSize || meetingEventIds.length === batchSize || agedKinds.some((rows) => rows.length === batchSize);
58
+ return ok(isMoreLeft ? { kind: 'more', after: last === undefined ? input.after : { createdAt: last.createdAt, id: last.id } } : { kind: 'done' });
59
+ });
60
+ const pruneFleet = async (fleetId) => {
61
+ const claimed = await claim(fleetId);
62
+ const cutoff = claimed.isOk ? claimed.value : null;
63
+ if (cutoff === null) {
64
+ return;
65
+ }
66
+ const startedAt = deps.clock.now().getTime();
67
+ let after = null;
68
+ for (;;) {
69
+ const result = await pruneBatch(fleetId, { cutoff, after });
70
+ const batch = result.isOk ? result.value : { kind: 'skipped' };
71
+ if (batch.kind === 'skipped') {
72
+ return;
73
+ }
74
+ if (batch.kind === 'done') {
75
+ await deps.uow.run(async (tx) => {
76
+ await tx.historyPruner.keepFrom(fleetId, cutoff);
77
+ return ok(undefined);
78
+ });
79
+ return;
80
+ }
81
+ if (deps.clock.now().getTime() - startedAt >= budgetMs) {
82
+ return;
83
+ }
84
+ after = batch.after;
85
+ }
86
+ };
87
+ return async (onFleetError) => {
88
+ for (const fleet of await deps.fleets.list()) {
89
+ try {
90
+ await pruneFleet(fleet.id);
91
+ }
92
+ catch (error) {
93
+ onFleetError?.(fleet.id, error);
94
+ }
95
+ }
96
+ };
97
+ }
98
+ //# sourceMappingURL=prune-history.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"prune-history.js","sourceRoot":"","sources":["../../../src/domain/shared/prune-history.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAA8C,MAAM,uBAAuB,CAAC;AAElG,OAAO,EAAE,WAAW,EAAE,MAAM,EAAiB,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAwC,MAAM,sBAAsB,CAAC;AACvG,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAGjC,MAAM,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAC/B,gIAAgI;AAChI,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC;AAC/B,wFAAwF;AACxF,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AAatC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAOlC;IACC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC;IAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,eAAe,CAAC;IAElD,MAAM,KAAK,GAAG,CAAC,OAAgB,EAAE,EAAE,CACjC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QACxB,MAAM,aAAa,GAAG,CAAC,MAAM,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QACnE,MAAM,kBAAkB,GAAG,MAAM,EAAE,CAAC,aAAa,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC9E,IAAI,aAAa,KAAK,IAAI,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;YAC/D,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAC5G,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEL,MAAM,UAAU,GAAG,CAAC,OAAgB,EAAE,KAAkD,EAAE,EAAE,CAC1F,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,EAAE,CAAC,aAAa,CAAC;QAChC,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YACrC,OAAO,EAAE,CAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QACxC,CAAC;QACD,MAAM,CAAC,UAAU,EAAE,eAAe,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACtD,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;YAC1F,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;SAC1E,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAClF,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACpG,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5I,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;YACrG,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,eAAe,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;YAClF,MAAM,WAAW,CACf,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,EACpC,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,CAC5I,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,KAAK,SAAS,IAAI,eAAe,CAAC,MAAM,KAAK,SAAS,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;QAClJ,OAAO,EAAE,CAAQ,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3J,CAAC,CAAC,CAAC;IAEL,MAAM,UAAU,GAAG,KAAK,EAAE,OAAgB,EAAE,EAAE;QAC5C,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QACnD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;QAC7C,IAAI,KAAK,GAAuB,IAAI,CAAC;QACrC,SAAS,CAAC;YACR,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5D,MAAM,KAAK,GAAU,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;YACtE,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC7B,OAAO;YACT,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC1B,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;oBAC9B,MAAM,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;oBACjD,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;gBACvB,CAAC,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YACD,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,GAAG,SAAS,IAAI,QAAQ,EAAE,CAAC;gBACvD,OAAO;YACT,CAAC;YACD,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QACtB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,KAAK,EAAE,YAAY,EAAE,EAAE;QAC5B,KAAK,MAAM,KAAK,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YAC7C,IAAI,CAAC;gBACH,MAAM,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC7B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,YAAY,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}
@@ -3,15 +3,18 @@ import type { Caller } from './caller.js';
3
3
  import type { Clock } from './clock.js';
4
4
  /** Outbound port: what a fleet's limits apply to, read outside a unit of work. */
5
5
  export interface FleetLimitReads {
6
- /** The ship and daily message limits that apply to the fleet now; null where none does. */
6
+ /** The ship and daily message limits and the retention in days that apply to the fleet now; null where none does. */
7
7
  applied(fleetId: FleetId): Promise<{
8
8
  ships: number | null;
9
9
  dailyMessages: number | null;
10
+ retention: number | null;
10
11
  }>;
11
12
  /** Its ships that are not retired, argo included. */
12
13
  activeShips(fleetId: FleetId): Promise<number>;
13
14
  /** The messages it stored on the UTC day that starts at `day`, of any kind and from any sender. */
14
15
  messagesOn(fleetId: FleetId, day: Date): Promise<number>;
16
+ /** Where its finished history begins: the cutoff its last finished pruning pass reached; null while no pass finished. */
17
+ keptFrom(fleetId: FleetId): Promise<Date | null>;
15
18
  }
16
19
  export interface FleetLimitsRead {
17
20
  ships: {
@@ -23,15 +26,22 @@ export interface FleetLimitsRead {
23
26
  count: number;
24
27
  resetsAt: Date;
25
28
  };
29
+ /** The days the fleet keeps its finished history, null: kept for good; and where its kept history begins, null while nothing was pruned. */
30
+ retention: {
31
+ days: number | null;
32
+ keptFrom: Date | null;
33
+ };
26
34
  }
27
35
  export type ReadFleetLimits = (caller: Caller) => Promise<FleetLimitsRead>;
28
36
  /**
29
37
  * Use case: the caller's fleet's ship and daily message limits, with what
30
38
  * each counts by the same measures the limits are enforced by: its ships that
31
39
  * are not retired, argo included, and the messages it stored since 00:00 UTC,
32
- * which count again from the next 00:00 UTC. The console shows from it when
33
- * the fleet is at a limit. The caller's scope (fleet:read) is checked before
34
- * this runs.
40
+ * which count again from the next 00:00 UTC; and its retention, so every
41
+ * fleet manager sees how long the fleet keeps its finished history and where
42
+ * it begins (the timeline, the thread and Health say so). The
43
+ * console shows from it when the fleet is at a limit. The caller's scope
44
+ * (fleet:read) is checked before this runs.
35
45
  */
36
46
  export declare function createReadFleetLimits(deps: {
37
47
  limits: FleetLimitReads;
@@ -3,21 +3,25 @@ import { nextUtcDayStart, utcDayStart } from './utc-day.js';
3
3
  * Use case: the caller's fleet's ship and daily message limits, with what
4
4
  * each counts by the same measures the limits are enforced by: its ships that
5
5
  * are not retired, argo included, and the messages it stored since 00:00 UTC,
6
- * which count again from the next 00:00 UTC. The console shows from it when
7
- * the fleet is at a limit. The caller's scope (fleet:read) is checked before
8
- * this runs.
6
+ * which count again from the next 00:00 UTC; and its retention, so every
7
+ * fleet manager sees how long the fleet keeps its finished history and where
8
+ * it begins (the timeline, the thread and Health say so). The
9
+ * console shows from it when the fleet is at a limit. The caller's scope
10
+ * (fleet:read) is checked before this runs.
9
11
  */
10
12
  export function createReadFleetLimits(deps) {
11
13
  return async ({ fleetId }) => {
12
14
  const now = deps.clock.now();
13
- const [applied, ships, messages] = await Promise.all([
15
+ const [applied, ships, messages, keptFrom] = await Promise.all([
14
16
  deps.limits.applied(fleetId),
15
17
  deps.limits.activeShips(fleetId),
16
18
  deps.limits.messagesOn(fleetId, utcDayStart(now)),
19
+ deps.limits.keptFrom(fleetId),
17
20
  ]);
18
21
  return {
19
22
  ships: { limit: applied.ships, count: ships },
20
23
  dailyMessages: { limit: applied.dailyMessages, count: messages, resetsAt: nextUtcDayStart(now) },
24
+ retention: { days: applied.retention, keptFrom },
21
25
  };
22
26
  };
23
27
  }
@@ -1 +1 @@
1
- {"version":3,"file":"read-fleet-limits.js","sourceRoot":"","sources":["../../../src/domain/shared/read-fleet-limits.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAmB5D;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAA+C;IACnF,OAAO,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACnD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC;SAClD,CAAC,CAAC;QACH,OAAO;YACL,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;YAC7C,aAAa,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE;SACjG,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"read-fleet-limits.js","sourceRoot":"","sources":["../../../src/domain/shared/read-fleet-limits.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAuB5D;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAA+C;IACnF,OAAO,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC7D,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC;YACjD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAC;QACH,OAAO;YACL,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;YAC7C,aAAa,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE;YAChG,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,SAAS,EAAE,QAAQ,EAAE;SACjD,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}
@@ -0,0 +1,30 @@
1
+ import { type DeliveryId, type DeliveryState, type MessageId } from '@aeolus-fleet/common';
2
+ import type { Caller } from './caller.js';
3
+ import { type DomainError } from './errors.js';
4
+ import { type ReadReachOf } from '../registry/public.js';
5
+ import { type HistoryParty, type ShipHistory } from './history.js';
6
+ import type { Page } from './page.js';
7
+ import { type Result } from './result.js';
8
+ /** One delivery of a message: the ship it went to or that claimed it (null while none has), its state and since when. */
9
+ export interface ListedDelivery {
10
+ id: DeliveryId;
11
+ ship: HistoryParty | null;
12
+ state: DeliveryState;
13
+ since: Date;
14
+ }
15
+ export type ReadMessageDeliveries = (caller: Caller, input: {
16
+ messageId: MessageId;
17
+ cursor?: DeliveryId;
18
+ limit?: number;
19
+ }) => Promise<Result<Page<ListedDelivery, DeliveryId>, DomainError<'MESSAGE_NOT_FOUND'>>>;
20
+ /**
21
+ * Use case: a page of the deliveries of one message of the caller's fleet, by
22
+ * id, each with its ship and where it stands: one for a ship or a type, one
23
+ * per ship for a label (decision 0065). A message outside the caller's read
24
+ * reach is answered as none, as reading the message is (decision 0034). The
25
+ * caller's scope (fleet:read) is checked before this runs.
26
+ */
27
+ export declare function createReadMessageDeliveries(deps: {
28
+ history: ShipHistory;
29
+ readReach: ReadReachOf;
30
+ }): ReadMessageDeliveries;
@@ -0,0 +1,24 @@
1
+ import { PAGE_SIZE_DEFAULT } from '@aeolus-fleet/common';
2
+ import { deliverySinceOf } from './delivery-way.js';
3
+ import { refuse } from './errors.js';
4
+ import { readsMessage } from '../registry/public.js';
5
+ import { partiesOf } from './history.js';
6
+ import { ok } from './result.js';
7
+ /**
8
+ * Use case: a page of the deliveries of one message of the caller's fleet, by
9
+ * id, each with its ship and where it stands: one for a ship or a type, one
10
+ * per ship for a label (decision 0065). A message outside the caller's read
11
+ * reach is answered as none, as reading the message is (decision 0034). The
12
+ * caller's scope (fleet:read) is checked before this runs.
13
+ */
14
+ export function createReadMessageDeliveries(deps) {
15
+ return async (caller, { messageId, cursor, limit = PAGE_SIZE_DEFAULT }) => {
16
+ const found = await deps.history.message(caller.fleetId, messageId);
17
+ if (!found || !readsMessage(await deps.readReach(caller), partiesOf(found, found.delivery.claimedBy))) {
18
+ return refuse('MESSAGE_NOT_FOUND', `No message ${messageId} in this fleet`);
19
+ }
20
+ const page = await deps.history.messageDeliveries(caller.fleetId, { messageId, cursor, limit });
21
+ return ok({ items: page.items.map(({ id, ship, state, steps }) => ({ id, ship, state, since: deliverySinceOf(steps) })), nextCursor: page.nextCursor });
22
+ };
23
+ }
24
+ //# sourceMappingURL=read-message-deliveries.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"read-message-deliveries.js","sourceRoot":"","sources":["../../../src/domain/shared/read-message-deliveries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAuD,MAAM,sBAAsB,CAAC;AAG9G,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAoB,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,YAAY,EAAoB,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,SAAS,EAAuC,MAAM,cAAc,CAAC;AAE9E,OAAO,EAAE,EAAE,EAAe,MAAM,aAAa,CAAC;AAe9C;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAAsD;IAChG,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,GAAG,iBAAiB,EAAE,EAAE,EAAE;QACxE,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACpE,IAAI,CAAC,KAAK,IAAI,CAAC,YAAY,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;YACtG,OAAO,MAAM,CAAC,mBAAmB,EAAE,cAAc,SAAS,gBAAgB,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAChG,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAC1J,CAAC,CAAC;AACJ,CAAC"}
@@ -11,6 +11,8 @@ export type MessageDetail = HistoryMessage & {
11
11
  way: DeliveryWay;
12
12
  history: DeliveryChange[];
13
13
  };
14
+ /** How many deliveries it has: one per ship for a label (decision 0065). */
15
+ deliveryCount: number;
14
16
  };
15
17
  export type ReadMessage = (caller: Caller, input: {
16
18
  messageId: MessageId;
@@ -19,7 +21,8 @@ export type ReadMessage = (caller: Caller, input: {
19
21
  * Use case: one message of the caller's fleet: its envelope, its whole
20
22
  * payload, its replies, and its delivery's way through: who holds it, since
21
23
  * when, the clocks that speak for it and every step newest first, from the
22
- * event log. A message outside the caller's read reach is answered as none,
24
+ * event log; and how many deliveries it has, one per ship for a label
25
+ * (decision 0065). A message outside the caller's read reach is answered as none,
23
26
  * so its existence does not show (decision 0034). The caller's scope
24
27
  * (fleet:read) is checked before this runs.
25
28
  */