@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.
- package/README.md +1 -1
- package/dist/adapters/prisma/defined-scopes.d.ts +4 -0
- package/dist/adapters/prisma/defined-scopes.js +23 -0
- package/dist/adapters/prisma/defined-scopes.js.map +1 -0
- package/dist/adapters/prisma/delivery-notices.d.ts +3 -0
- package/dist/adapters/prisma/delivery-notices.js +7 -2
- package/dist/adapters/prisma/delivery-notices.js.map +1 -1
- package/dist/adapters/prisma/fleet-limit-settings.d.ts +6 -0
- package/dist/adapters/prisma/fleet-limit-settings.js +17 -0
- package/dist/adapters/prisma/fleet-limit-settings.js.map +1 -0
- package/dist/adapters/prisma/generated/browser.d.ts +35 -4
- package/dist/adapters/prisma/generated/client.d.ts +35 -4
- package/dist/adapters/prisma/generated/commonInputTypes.d.ts +226 -46
- package/dist/adapters/prisma/generated/enums.d.ts +38 -0
- package/dist/adapters/prisma/generated/enums.js +33 -1
- package/dist/adapters/prisma/generated/enums.js.map +1 -1
- package/dist/adapters/prisma/generated/internal/class.d.ts +55 -0
- package/dist/adapters/prisma/generated/internal/class.js +4 -4
- package/dist/adapters/prisma/generated/internal/class.js.map +1 -1
- package/dist/adapters/prisma/generated/internal/prismaNamespace.d.ts +524 -1
- package/dist/adapters/prisma/generated/internal/prismaNamespace.js +96 -1
- package/dist/adapters/prisma/generated/internal/prismaNamespace.js.map +1 -1
- package/dist/adapters/prisma/generated/internal/prismaNamespaceBrowser.d.ts +100 -0
- package/dist/adapters/prisma/generated/internal/prismaNamespaceBrowser.js +96 -1
- package/dist/adapters/prisma/generated/internal/prismaNamespaceBrowser.js.map +1 -1
- package/dist/adapters/prisma/generated/models/DefinedScope.d.ts +1110 -0
- package/dist/adapters/prisma/generated/models/DefinedScope.js +2 -0
- package/dist/adapters/prisma/generated/models/DefinedScope.js.map +1 -0
- package/dist/adapters/prisma/generated/models/Delivery.d.ts +1 -10
- package/dist/adapters/prisma/generated/models/Fleet.d.ts +3291 -100
- package/dist/adapters/prisma/generated/models/InstallationSettings.d.ts +108 -4
- package/dist/adapters/prisma/generated/models/Meeting.d.ts +2520 -0
- package/dist/adapters/prisma/generated/models/Meeting.js +2 -0
- package/dist/adapters/prisma/generated/models/Meeting.js.map +1 -0
- package/dist/adapters/prisma/generated/models/MeetingMicRequest.d.ts +1398 -0
- package/dist/adapters/prisma/generated/models/MeetingMicRequest.js +2 -0
- package/dist/adapters/prisma/generated/models/MeetingMicRequest.js.map +1 -0
- package/dist/adapters/prisma/generated/models/MeetingParticipant.d.ts +1630 -0
- package/dist/adapters/prisma/generated/models/MeetingParticipant.js +2 -0
- package/dist/adapters/prisma/generated/models/MeetingParticipant.js.map +1 -0
- package/dist/adapters/prisma/generated/models/Message.d.ts +664 -350
- package/dist/adapters/prisma/generated/models/Schedule.d.ts +3925 -0
- package/dist/adapters/prisma/generated/models/Schedule.js +2 -0
- package/dist/adapters/prisma/generated/models/Schedule.js.map +1 -0
- package/dist/adapters/prisma/generated/models/Ship.d.ts +2497 -67
- package/dist/adapters/prisma/generated/models.d.ts +5 -0
- package/dist/adapters/prisma/history-pruner.d.ts +3 -0
- package/dist/adapters/prisma/history-pruner.js +232 -0
- package/dist/adapters/prisma/history-pruner.js.map +1 -0
- package/dist/adapters/prisma/history.js +72 -17
- package/dist/adapters/prisma/history.js.map +1 -1
- package/dist/adapters/prisma/installation.js +27 -8
- package/dist/adapters/prisma/installation.js.map +1 -1
- package/dist/adapters/prisma/meetings.d.ts +4 -0
- package/dist/adapters/prisma/meetings.js +103 -0
- package/dist/adapters/prisma/meetings.js.map +1 -0
- package/dist/adapters/prisma/messaging.js +8 -3
- package/dist/adapters/prisma/messaging.js.map +1 -1
- package/dist/adapters/prisma/registry.js +35 -9
- package/dist/adapters/prisma/registry.js.map +1 -1
- package/dist/adapters/prisma/rows.js +14 -1
- package/dist/adapters/prisma/rows.js.map +1 -1
- package/dist/adapters/prisma/schedules.d.ts +12 -0
- package/dist/adapters/prisma/schedules.js +255 -0
- package/dist/adapters/prisma/schedules.js.map +1 -0
- package/dist/adapters/prisma/unit-of-work.d.ts +8 -2
- package/dist/adapters/prisma/unit-of-work.js +9 -0
- package/dist/adapters/prisma/unit-of-work.js.map +1 -1
- package/dist/adapters/trpc/console.d.ts +1 -1
- package/dist/adapters/trpc/console.js +3 -6
- package/dist/adapters/trpc/console.js.map +1 -1
- package/dist/adapters/trpc/context.d.ts +30 -0
- package/dist/adapters/trpc/fleet.d.ts +233 -19
- package/dist/adapters/trpc/fleet.js +111 -11
- package/dist/adapters/trpc/fleet.js.map +1 -1
- package/dist/adapters/trpc/installation.d.ts +139 -4
- package/dist/adapters/trpc/installation.js +4 -4
- package/dist/adapters/trpc/installation.js.map +1 -1
- package/dist/adapters/trpc/router.d.ts +718 -19
- package/dist/adapters/trpc/schedule-output.d.ts +74 -0
- package/dist/adapters/trpc/schedule-output.js +71 -0
- package/dist/adapters/trpc/schedule-output.js.map +1 -0
- package/dist/adapters/trpc/ship-contract.js +7 -0
- package/dist/adapters/trpc/ship-contract.js.map +1 -1
- package/dist/adapters/trpc/ship-protocol.js +2 -1
- package/dist/adapters/trpc/ship-protocol.js.map +1 -1
- package/dist/adapters/trpc/ship.d.ts +397 -3
- package/dist/adapters/trpc/ship.js +323 -11
- package/dist/adapters/trpc/ship.js.map +1 -1
- package/dist/adapters/trpc/starting-prompt-text.js +5 -5
- package/dist/adapters/trpc/starting-prompt-text.js.map +1 -1
- package/dist/adapters/trpc/trpc.d.ts +8 -0
- package/dist/adapters/trpc/trpc.js +38 -2
- package/dist/adapters/trpc/trpc.js.map +1 -1
- package/dist/app.d.ts +5 -3
- package/dist/app.js +33 -5
- package/dist/app.js.map +1 -1
- package/dist/domain/messaging/add-to-meeting.d.ts +41 -0
- package/dist/domain/messaging/add-to-meeting.js +76 -0
- package/dist/domain/messaging/add-to-meeting.js.map +1 -0
- package/dist/domain/messaging/answer.d.ts +2 -1
- package/dist/domain/messaging/answer.js +3 -2
- package/dist/domain/messaging/answer.js.map +1 -1
- package/dist/domain/messaging/cancel-schedule.d.ts +35 -0
- package/dist/domain/messaging/cancel-schedule.js +45 -0
- package/dist/domain/messaging/cancel-schedule.js.map +1 -0
- package/dist/domain/messaging/change-meeting.d.ts +32 -0
- package/dist/domain/messaging/change-meeting.js +35 -0
- package/dist/domain/messaging/change-meeting.js.map +1 -0
- package/dist/domain/messaging/change-mic.d.ts +30 -0
- package/dist/domain/messaging/change-mic.js +27 -0
- package/dist/domain/messaging/change-mic.js.map +1 -0
- package/dist/domain/messaging/check-reach-to-each.d.ts +25 -0
- package/dist/domain/messaging/check-reach-to-each.js +21 -0
- package/dist/domain/messaging/check-reach-to-each.js.map +1 -0
- package/dist/domain/messaging/cron.d.ts +46 -0
- package/dist/domain/messaging/cron.js +164 -0
- package/dist/domain/messaging/cron.js.map +1 -0
- package/dist/domain/messaging/daily-message-limit.d.ts +7 -5
- package/dist/domain/messaging/daily-message-limit.js +8 -7
- package/dist/domain/messaging/daily-message-limit.js.map +1 -1
- package/dist/domain/messaging/dismiss-delivery.js +2 -1
- package/dist/domain/messaging/dismiss-delivery.js.map +1 -1
- package/dist/domain/messaging/list-schedules.d.ts +38 -0
- package/dist/domain/messaging/list-schedules.js +33 -0
- package/dist/domain/messaging/list-schedules.js.map +1 -0
- package/dist/domain/messaging/meeting-life.d.ts +76 -0
- package/dist/domain/messaging/meeting-life.js +136 -0
- package/dist/domain/messaging/meeting-life.js.map +1 -0
- package/dist/domain/messaging/meeting-notice.d.ts +58 -0
- package/dist/domain/messaging/meeting-notice.js +87 -0
- package/dist/domain/messaging/meeting-notice.js.map +1 -0
- package/dist/domain/messaging/meeting.d.ts +103 -0
- package/dist/domain/messaging/meeting.js +106 -0
- package/dist/domain/messaging/meeting.js.map +1 -0
- package/dist/domain/messaging/message.d.ts +68 -4
- package/dist/domain/messaging/message.js +163 -10
- package/dist/domain/messaging/message.js.map +1 -1
- package/dist/domain/messaging/mic.d.ts +64 -0
- package/dist/domain/messaging/mic.js +130 -0
- package/dist/domain/messaging/mic.js.map +1 -0
- package/dist/domain/messaging/open-meeting.d.ts +61 -0
- package/dist/domain/messaging/open-meeting.js +98 -0
- package/dist/domain/messaging/open-meeting.js.map +1 -0
- package/dist/domain/messaging/pause-schedule.d.ts +34 -0
- package/dist/domain/messaging/pause-schedule.js +44 -0
- package/dist/domain/messaging/pause-schedule.js.map +1 -0
- package/dist/domain/messaging/ports.d.ts +121 -3
- package/dist/domain/messaging/public.d.ts +4 -0
- package/dist/domain/messaging/public.js +2 -0
- package/dist/domain/messaging/public.js.map +1 -1
- package/dist/domain/messaging/push-receive-deliveries.d.ts +4 -1
- package/dist/domain/messaging/push-receive-deliveries.js +5 -2
- package/dist/domain/messaging/push-receive-deliveries.js.map +1 -1
- package/dist/domain/messaging/read-meeting.d.ts +67 -0
- package/dist/domain/messaging/read-meeting.js +61 -0
- package/dist/domain/messaging/read-meeting.js.map +1 -0
- package/dist/domain/messaging/receive-deliveries.d.ts +6 -1
- package/dist/domain/messaging/receive-deliveries.js +3 -0
- package/dist/domain/messaging/receive-deliveries.js.map +1 -1
- package/dist/domain/messaging/resend-delivery.js +5 -4
- package/dist/domain/messaging/resend-delivery.js.map +1 -1
- package/dist/domain/messaging/resume-schedule.d.ts +34 -0
- package/dist/domain/messaging/resume-schedule.js +37 -0
- package/dist/domain/messaging/resume-schedule.js.map +1 -0
- package/dist/domain/messaging/retired-participant.d.ts +36 -0
- package/dist/domain/messaging/retired-participant.js +38 -0
- package/dist/domain/messaging/retired-participant.js.map +1 -0
- package/dist/domain/messaging/retired-scheduler.d.ts +31 -0
- package/dist/domain/messaging/retired-scheduler.js +30 -0
- package/dist/domain/messaging/retired-scheduler.js.map +1 -0
- package/dist/domain/messaging/schedule-access.d.ts +20 -0
- package/dist/domain/messaging/schedule-access.js +21 -0
- package/dist/domain/messaging/schedule-access.js.map +1 -0
- package/dist/domain/messaging/schedule-limits.d.ts +25 -0
- package/dist/domain/messaging/schedule-limits.js +51 -0
- package/dist/domain/messaging/schedule-limits.js.map +1 -0
- package/dist/domain/messaging/schedule-message.d.ts +65 -0
- package/dist/domain/messaging/schedule-message.js +151 -0
- package/dist/domain/messaging/schedule-message.js.map +1 -0
- package/dist/domain/messaging/schedule.d.ts +238 -0
- package/dist/domain/messaging/schedule.js +316 -0
- package/dist/domain/messaging/schedule.js.map +1 -0
- package/dist/domain/messaging/send-due-schedules.d.ts +40 -0
- package/dist/domain/messaging/send-due-schedules.js +141 -0
- package/dist/domain/messaging/send-due-schedules.js.map +1 -0
- package/dist/domain/messaging/send-message.d.ts +18 -5
- package/dist/domain/messaging/send-message.js +149 -4
- package/dist/domain/messaging/send-message.js.map +1 -1
- package/dist/domain/messaging/send-request.d.ts +3 -2
- package/dist/domain/messaging/send-request.js +7 -2
- package/dist/domain/messaging/send-request.js.map +1 -1
- package/dist/domain/registry/applied-limits.d.ts +5 -7
- package/dist/domain/registry/applied-limits.js +5 -9
- package/dist/domain/registry/applied-limits.js.map +1 -1
- package/dist/domain/registry/check-manage.d.ts +23 -0
- package/dist/domain/registry/check-manage.js +19 -0
- package/dist/domain/registry/check-manage.js.map +1 -0
- package/dist/domain/registry/commission-ship.js +3 -3
- package/dist/domain/registry/commission-ship.js.map +1 -1
- package/dist/domain/registry/declare-scopes.d.ts +5 -3
- package/dist/domain/registry/declare-scopes.js +4 -2
- package/dist/domain/registry/declare-scopes.js.map +1 -1
- package/dist/domain/registry/define-scope.d.ts +33 -0
- package/dist/domain/registry/define-scope.js +30 -0
- package/dist/domain/registry/define-scope.js.map +1 -0
- package/dist/domain/registry/defined-scope.d.ts +68 -0
- package/dist/domain/registry/defined-scope.js +83 -0
- package/dist/domain/registry/defined-scope.js.map +1 -0
- package/dist/domain/registry/describe-scope.d.ts +31 -0
- package/dist/domain/registry/describe-scope.js +28 -0
- package/dist/domain/registry/describe-scope.js.map +1 -0
- package/dist/domain/registry/get-fleet-limits.d.ts +1 -1
- package/dist/domain/registry/get-fleet-limits.js +1 -1
- package/dist/domain/registry/get-fleet-limits.js.map +1 -1
- package/dist/domain/registry/grant-scopes.d.ts +4 -3
- package/dist/domain/registry/grant-scopes.js +4 -4
- package/dist/domain/registry/grant-scopes.js.map +1 -1
- package/dist/domain/registry/installation-fleet.d.ts +4 -1
- package/dist/domain/registry/installation-fleet.js +9 -2
- package/dist/domain/registry/installation-fleet.js.map +1 -1
- package/dist/domain/registry/label-value-texts.d.ts +16 -0
- package/dist/domain/registry/label-value-texts.js +15 -0
- package/dist/domain/registry/label-value-texts.js.map +1 -0
- package/dist/domain/registry/limits.d.ts +42 -7
- package/dist/domain/registry/limits.js +41 -6
- package/dist/domain/registry/limits.js.map +1 -1
- package/dist/domain/registry/list-scopes.d.ts +13 -6
- package/dist/domain/registry/list-scopes.js +15 -6
- package/dist/domain/registry/list-scopes.js.map +1 -1
- package/dist/domain/registry/named-namespaces.d.ts +18 -8
- package/dist/domain/registry/named-namespaces.js +11 -3
- package/dist/domain/registry/named-namespaces.js.map +1 -1
- package/dist/domain/registry/ports.d.ts +22 -0
- package/dist/domain/registry/public.d.ts +4 -1
- package/dist/domain/registry/public.js +4 -1
- package/dist/domain/registry/public.js.map +1 -1
- package/dist/domain/registry/read-built-in-rules.d.ts +2 -1
- package/dist/domain/registry/read-built-in-rules.js +3 -1
- package/dist/domain/registry/read-built-in-rules.js.map +1 -1
- package/dist/domain/registry/remove-scope.d.ts +29 -0
- package/dist/domain/registry/remove-scope.js +32 -0
- package/dist/domain/registry/remove-scope.js.map +1 -0
- package/dist/domain/registry/resolve-invitees.d.ts +27 -0
- package/dist/domain/registry/resolve-invitees.js +27 -0
- package/dist/domain/registry/resolve-invitees.js.map +1 -0
- package/dist/domain/registry/resolve-label-selection.d.ts +20 -0
- package/dist/domain/registry/resolve-label-selection.js +26 -0
- package/dist/domain/registry/resolve-label-selection.js.map +1 -0
- package/dist/domain/registry/resolve-selector.d.ts +2 -2
- package/dist/domain/registry/resolve-selector.js.map +1 -1
- package/dist/domain/registry/retire-ship.d.ts +11 -3
- package/dist/domain/registry/retire-ship.js +15 -1
- package/dist/domain/registry/retire-ship.js.map +1 -1
- package/dist/domain/registry/scope-grant.d.ts +6 -2
- package/dist/domain/registry/scope-grant.js +9 -5
- package/dist/domain/registry/scope-grant.js.map +1 -1
- package/dist/domain/registry/scope-namespace.d.ts +5 -1
- package/dist/domain/registry/scope-namespace.js +9 -2
- package/dist/domain/registry/scope-namespace.js.map +1 -1
- package/dist/domain/registry/set-fleet-limits.d.ts +8 -5
- package/dist/domain/registry/set-fleet-limits.js +38 -6
- package/dist/domain/registry/set-fleet-limits.js.map +1 -1
- package/dist/domain/registry/set-installation-settings.d.ts +4 -4
- package/dist/domain/registry/set-installation-settings.js +21 -15
- package/dist/domain/registry/set-installation-settings.js.map +1 -1
- package/dist/domain/registry/ship.d.ts +2 -0
- package/dist/domain/registry/ship.js +1 -1
- package/dist/domain/registry/ship.js.map +1 -1
- package/dist/domain/shared/close-health-snapshots.d.ts +5 -2
- package/dist/domain/shared/close-health-snapshots.js +12 -6
- package/dist/domain/shared/close-health-snapshots.js.map +1 -1
- package/dist/domain/shared/delivery-way.d.ts +4 -0
- package/dist/domain/shared/delivery-way.js +5 -2
- package/dist/domain/shared/delivery-way.js.map +1 -1
- package/dist/domain/shared/errors.d.ts +1 -1
- package/dist/domain/shared/errors.js.map +1 -1
- package/dist/domain/shared/history-pruning.d.ts +130 -0
- package/dist/domain/shared/history-pruning.js +74 -0
- package/dist/domain/shared/history-pruning.js.map +1 -0
- package/dist/domain/shared/history.d.ts +41 -5
- package/dist/domain/shared/history.js +19 -2
- package/dist/domain/shared/history.js.map +1 -1
- package/dist/domain/shared/prune-history.d.ts +39 -0
- package/dist/domain/shared/prune-history.js +98 -0
- package/dist/domain/shared/prune-history.js.map +1 -0
- package/dist/domain/shared/read-fleet-limits.d.ts +14 -4
- package/dist/domain/shared/read-fleet-limits.js +8 -4
- package/dist/domain/shared/read-fleet-limits.js.map +1 -1
- package/dist/domain/shared/read-message-deliveries.d.ts +30 -0
- package/dist/domain/shared/read-message-deliveries.js +24 -0
- package/dist/domain/shared/read-message-deliveries.js.map +1 -0
- package/dist/domain/shared/read-message.d.ts +4 -1
- package/dist/domain/shared/read-message.js +3 -2
- package/dist/domain/shared/read-message.js.map +1 -1
- package/dist/domain/shared/read-sent-message.d.ts +21 -7
- package/dist/domain/shared/read-sent-message.js +19 -6
- package/dist/domain/shared/read-sent-message.js.map +1 -1
- package/dist/domain/shared/selector.d.ts +32 -11
- package/dist/schedule-timer.d.ts +22 -0
- package/dist/schedule-timer.js +78 -0
- package/dist/schedule-timer.js.map +1 -0
- package/dist/wiring.d.ts +36 -0
- package/dist/wiring.js +38 -2
- package/dist/wiring.js.map +1 -1
- package/package.json +2 -2
- package/src/adapters/prisma/migrations/20261024160000_meetings/migration.sql +86 -0
- package/src/adapters/prisma/migrations/20261024160100_meetings_open_scope/migration.sql +64 -0
- package/src/adapters/prisma/migrations/20261024160200_meetings_mic/migration.sql +35 -0
- package/src/adapters/prisma/migrations/20261024160300_meetings_life/migration.sql +6 -0
- package/src/adapters/prisma/migrations/20261025090000_scheduled_messages_envelope/migration.sql +5 -0
- package/src/adapters/prisma/migrations/20261025090100_schedules/migration.sql +109 -0
- package/src/adapters/prisma/migrations/20261025120000_repeating_schedules/migration.sql +40 -0
- package/src/adapters/prisma/migrations/20261025130000_schedule_limits/migration.sql +11 -0
- package/src/adapters/prisma/migrations/20261025140000_send_to_a_label/migration.sql +16 -0
- package/src/adapters/prisma/migrations/20261025150000_define_scope/migration.sql +64 -0
- package/src/adapters/prisma/migrations/20261025150100_defined_scopes/migration.sql +15 -0
- package/src/adapters/prisma/migrations/20261025160000_retention/migration.sql +7 -0
- package/src/adapters/prisma/migrations/20261025170000_message_deliveries_page/migration.sql +7 -0
- package/src/adapters/prisma/migrations/20261025180000_history_pruning/migration.sql +25 -0
- package/src/adapters/prisma/migrations/20261025190000_history_pruning_crew_events/migration.sql +2 -0
- package/src/adapters/prisma/migrations/20261025200000_schedule_to_a_label/migration.sql +12 -0
- package/src/adapters/prisma/schema.prisma +383 -131
|
@@ -0,0 +1,238 @@
|
|
|
1
|
+
import { type FleetId, type MessageId, type MissedStrategy, type RefusalStrategy, type ScheduleId, type ScheduleState, type ShipId } from '@aeolus-fleet/common';
|
|
2
|
+
import { type DomainError } from '../shared/errors.js';
|
|
3
|
+
import type { Actor, NewEvent } from '../shared/events.js';
|
|
4
|
+
import { type Result } from '../shared/result.js';
|
|
5
|
+
import type { ScheduleSelector } from '../shared/selector.js';
|
|
6
|
+
/**
|
|
7
|
+
* A ship's scheduled message (decision 0062): a whole send input that core
|
|
8
|
+
* sends as that ship at its send time. Plain data; the functions here change
|
|
9
|
+
* it and raise its events. Each send time gives one message, or a refusal
|
|
10
|
+
* recorded on the schedule.
|
|
11
|
+
*/
|
|
12
|
+
/** How long after its send time a refused send is tried again under retry, unless the creator says. */
|
|
13
|
+
export declare const RETRY_WINDOW_DEFAULT = "PT1H";
|
|
14
|
+
/** How long a refused send under retry waits for its next try: one pass of core. */
|
|
15
|
+
export declare const RETRY_EVERY_MS = 30000;
|
|
16
|
+
/** What a missed send time does, unless the creator says: every missed one is sent (S6). */
|
|
17
|
+
export declare const MISSED_STRATEGY_DEFAULT: MissedStrategy;
|
|
18
|
+
/** How late a pass may reach a send time before it is missed, unless the creator says (S6). */
|
|
19
|
+
export declare const GRACE_DEFAULT = "PT5M";
|
|
20
|
+
/** A cron's zone unless the creator says (S1). */
|
|
21
|
+
export declare const TIME_ZONE_DEFAULT = "UTC";
|
|
22
|
+
/** The send input, stored as the creator gave it: the selector as addressed, a name resolved only at each send time. */
|
|
23
|
+
export interface ScheduledSend {
|
|
24
|
+
selector: ScheduleSelector;
|
|
25
|
+
payload: string;
|
|
26
|
+
contentType: string;
|
|
27
|
+
/** The model the creator stated: every send states it (S13). */
|
|
28
|
+
model: string | null;
|
|
29
|
+
inReplyTo: MessageId | null;
|
|
30
|
+
isForced: boolean;
|
|
31
|
+
}
|
|
32
|
+
/** Where a repeat begins and ends: at or after its start, at or before its end, and no more sends than its count. */
|
|
33
|
+
export interface RepeatBounds {
|
|
34
|
+
start: Date | null;
|
|
35
|
+
end: Date | null;
|
|
36
|
+
count: number | null;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* When it sends (S1): once, at an instant; every fixed duration, from its
|
|
40
|
+
* start or else its creation; or at a cron's wall times in its zone.
|
|
41
|
+
*/
|
|
42
|
+
export type ScheduleTiming = {
|
|
43
|
+
kind: 'once';
|
|
44
|
+
at: Date;
|
|
45
|
+
} | ({
|
|
46
|
+
kind: 'every';
|
|
47
|
+
every: string;
|
|
48
|
+
} & RepeatBounds) | ({
|
|
49
|
+
kind: 'cron';
|
|
50
|
+
cron: string;
|
|
51
|
+
timeZone: string;
|
|
52
|
+
} & RepeatBounds);
|
|
53
|
+
/** The timing as a creator gives it: a repeat's bounds and a cron's zone are optional. */
|
|
54
|
+
export type ScheduleTimingInput = {
|
|
55
|
+
kind: 'once';
|
|
56
|
+
at: Date;
|
|
57
|
+
} | ({
|
|
58
|
+
kind: 'every';
|
|
59
|
+
every: string;
|
|
60
|
+
} & Partial<RepeatBounds>) | ({
|
|
61
|
+
kind: 'cron';
|
|
62
|
+
cron: string;
|
|
63
|
+
timeZone?: string;
|
|
64
|
+
} & Partial<RepeatBounds>);
|
|
65
|
+
/** What a send time came to: the message stored, the code it was refused with, or missed (S6). */
|
|
66
|
+
export type ScheduleOutcome = {
|
|
67
|
+
kind: 'sent';
|
|
68
|
+
messageId: MessageId;
|
|
69
|
+
sendTime: Date;
|
|
70
|
+
at: Date;
|
|
71
|
+
} | {
|
|
72
|
+
kind: 'refused';
|
|
73
|
+
code: string;
|
|
74
|
+
sendTime: Date;
|
|
75
|
+
at: Date;
|
|
76
|
+
} | {
|
|
77
|
+
kind: 'missed';
|
|
78
|
+
sendTime: Date;
|
|
79
|
+
at: Date;
|
|
80
|
+
};
|
|
81
|
+
export interface Schedule {
|
|
82
|
+
id: ScheduleId;
|
|
83
|
+
fleetId: FleetId;
|
|
84
|
+
/** The ship that made it: the only one it sends as. */
|
|
85
|
+
shipId: ShipId;
|
|
86
|
+
send: ScheduledSend;
|
|
87
|
+
timing: ScheduleTiming;
|
|
88
|
+
onRefused: RefusalStrategy;
|
|
89
|
+
/** An ISO 8601 duration of a fixed length, as the creator gave it. */
|
|
90
|
+
retryWindow: string;
|
|
91
|
+
onMissed: MissedStrategy;
|
|
92
|
+
/** How late a send time may be sent on time: an ISO 8601 duration of a fixed length. */
|
|
93
|
+
grace: string;
|
|
94
|
+
idempotencyKey: string;
|
|
95
|
+
requestHash: string;
|
|
96
|
+
state: ScheduleState;
|
|
97
|
+
/** The send time it sends next; none once it ended or was cancelled. */
|
|
98
|
+
nextSendTime: Date | null;
|
|
99
|
+
/** When core next tries: the next send time, or a pass later under retry; none unless active. */
|
|
100
|
+
nextAttemptAt: Date | null;
|
|
101
|
+
lastOutcome: ScheduleOutcome | null;
|
|
102
|
+
createdAt: Date;
|
|
103
|
+
endedAt: Date | null;
|
|
104
|
+
cancelledAt: Date | null;
|
|
105
|
+
}
|
|
106
|
+
/** Why a schedule was cancelled: by its ship, by a manager, or by its ship's retire. */
|
|
107
|
+
export type CancelReason = 'ship' | 'manager' | 'retired';
|
|
108
|
+
export type ScheduleRefusal = DomainError<'INVALID_TIMING' | 'INVALID_RETRY_WINDOW' | 'INVALID_GRACE'>;
|
|
109
|
+
/** What a creator asks for, its send checked already. */
|
|
110
|
+
export interface ScheduleToPlan {
|
|
111
|
+
scheduleId: ScheduleId;
|
|
112
|
+
fleetId: FleetId;
|
|
113
|
+
shipId: ShipId;
|
|
114
|
+
send: ScheduledSend;
|
|
115
|
+
timing: ScheduleTimingInput;
|
|
116
|
+
onRefused: RefusalStrategy | undefined;
|
|
117
|
+
retryWindow: string | undefined;
|
|
118
|
+
onMissed: MissedStrategy | undefined;
|
|
119
|
+
grace: string | undefined;
|
|
120
|
+
idempotencyKey: string;
|
|
121
|
+
requestHash: string;
|
|
122
|
+
at: Date;
|
|
123
|
+
}
|
|
124
|
+
/**
|
|
125
|
+
* A new schedule, active, its next send time its first, and ScheduleCreated
|
|
126
|
+
* on its ship. Its timing is valid and gives a send time after now: a once
|
|
127
|
+
* schedule in the future, an every of a fixed duration, a cron of five fields
|
|
128
|
+
* in a zone the server knows, an end after its start, a count of at least
|
|
129
|
+
* one. A retry window and a grace are durations of a fixed length.
|
|
130
|
+
*/
|
|
131
|
+
export declare function planSchedule(plan: ScheduleToPlan): Result<{
|
|
132
|
+
schedule: Schedule;
|
|
133
|
+
events: NewEvent[];
|
|
134
|
+
}, ScheduleRefusal>;
|
|
135
|
+
/**
|
|
136
|
+
* The schedule's first send time strictly after an instant, within its start
|
|
137
|
+
* and end; none when it has no more. An every sends on the beat of its start,
|
|
138
|
+
* or else of its creation, never at the creation itself.
|
|
139
|
+
*/
|
|
140
|
+
export declare function sendTimeAfter(schedule: Pick<Schedule, 'timing' | 'createdAt'>, after: Date): Date | undefined;
|
|
141
|
+
/**
|
|
142
|
+
* The idempotency key of the message a schedule sends at a send time: unique
|
|
143
|
+
* per sender, so a second claim of the same send time stores no second
|
|
144
|
+
* message, and a replay finds the one stored.
|
|
145
|
+
*/
|
|
146
|
+
export declare function scheduledMessageKey(scheduleId: ScheduleId, sendTime: Date): string;
|
|
147
|
+
/**
|
|
148
|
+
* The send time sent: the message is its outcome, and the schedule goes on to
|
|
149
|
+
* its next send time, or ends with ScheduleEnded past its end or its count,
|
|
150
|
+
* counting the sends so far with this one.
|
|
151
|
+
*/
|
|
152
|
+
export declare function scheduleSent(schedule: Schedule, sent: {
|
|
153
|
+
messageId: MessageId;
|
|
154
|
+
sendTime: Date;
|
|
155
|
+
at: Date;
|
|
156
|
+
sentCount: number;
|
|
157
|
+
}): {
|
|
158
|
+
schedule: Schedule;
|
|
159
|
+
events: NewEvent[];
|
|
160
|
+
};
|
|
161
|
+
/**
|
|
162
|
+
* The send time refused with its code, recorded with ScheduledSendRefused,
|
|
163
|
+
* then the creator's strategy (S7): skip goes on to the next send time, so a
|
|
164
|
+
* once schedule ends; retry keeps the send time and tries again a pass later
|
|
165
|
+
* while inside its window, then skips; pause pauses it, keeping its send
|
|
166
|
+
* time, with SchedulePaused.
|
|
167
|
+
*/
|
|
168
|
+
export declare function scheduleRefused(schedule: Schedule, refused: {
|
|
169
|
+
code: string;
|
|
170
|
+
sendTime: Date;
|
|
171
|
+
at: Date;
|
|
172
|
+
sentCount: number;
|
|
173
|
+
}): {
|
|
174
|
+
schedule: Schedule;
|
|
175
|
+
events: NewEvent[];
|
|
176
|
+
};
|
|
177
|
+
export type CancelRefusal = DomainError<'SCHEDULE_ENDED'>;
|
|
178
|
+
export type PauseRefusal = DomainError<'SCHEDULE_ENDED' | 'SCHEDULE_CANCELLED'>;
|
|
179
|
+
/** Who paused a schedule by hand: its ship, or a manager (S10). */
|
|
180
|
+
export type PauseReason = 'ship' | 'manager';
|
|
181
|
+
/**
|
|
182
|
+
* Pauses an active schedule, keeping its next send time, with SchedulePaused
|
|
183
|
+
* caused by the actor; a paused one stays as it is, with no event. An ended
|
|
184
|
+
* or cancelled one is refused.
|
|
185
|
+
*/
|
|
186
|
+
export declare function pauseSchedule(schedule: Schedule, pause: {
|
|
187
|
+
reason: PauseReason;
|
|
188
|
+
actor: Actor;
|
|
189
|
+
at: Date;
|
|
190
|
+
}): Result<{
|
|
191
|
+
schedule: Schedule;
|
|
192
|
+
events: NewEvent[];
|
|
193
|
+
}, PauseRefusal>;
|
|
194
|
+
/**
|
|
195
|
+
* Resumes a paused schedule with ScheduleResumed: the send times passed
|
|
196
|
+
* while paused are skipped, so it goes on at its first send time after now,
|
|
197
|
+
* or ends when it has none. An active one stays as it is, with no event. An
|
|
198
|
+
* ended or cancelled one is refused.
|
|
199
|
+
*/
|
|
200
|
+
export declare function resumeSchedule(schedule: Schedule, resume: {
|
|
201
|
+
actor: Actor;
|
|
202
|
+
at: Date;
|
|
203
|
+
}): Result<{
|
|
204
|
+
schedule: Schedule;
|
|
205
|
+
events: NewEvent[];
|
|
206
|
+
}, PauseRefusal>;
|
|
207
|
+
/**
|
|
208
|
+
* Cancels an active or paused schedule, with ScheduleCancelled on its ship
|
|
209
|
+
* caused by the actor; a cancelled one stays as it is, with no event, so a
|
|
210
|
+
* retry of a cancel changes nothing. An ended one is refused.
|
|
211
|
+
*/
|
|
212
|
+
export declare function cancelSchedule(schedule: Schedule, cancel: {
|
|
213
|
+
reason: CancelReason;
|
|
214
|
+
actor: Actor;
|
|
215
|
+
at: Date;
|
|
216
|
+
}): Result<{
|
|
217
|
+
schedule: Schedule;
|
|
218
|
+
events: NewEvent[];
|
|
219
|
+
}, CancelRefusal>;
|
|
220
|
+
/**
|
|
221
|
+
* Whether a due send time is sent (S6): one kept for a retry, and one the
|
|
222
|
+
* pass reaches within its grace, always; a missed one by the creator's
|
|
223
|
+
* strategy: each sends it, skip does not, once only when it is the latest
|
|
224
|
+
* missed.
|
|
225
|
+
*/
|
|
226
|
+
export declare function isSendTimeToSend(schedule: Schedule, due: {
|
|
227
|
+
sendTime: Date;
|
|
228
|
+
at: Date;
|
|
229
|
+
}): boolean;
|
|
230
|
+
/** The send time missed, not sent (S6): recorded with ScheduledSendMissed and as the last outcome, then on to the next. */
|
|
231
|
+
export declare function scheduleMissed(schedule: Schedule, missed: {
|
|
232
|
+
sendTime: Date;
|
|
233
|
+
at: Date;
|
|
234
|
+
sentCount: number;
|
|
235
|
+
}): {
|
|
236
|
+
schedule: Schedule;
|
|
237
|
+
events: NewEvent[];
|
|
238
|
+
};
|
|
@@ -0,0 +1,316 @@
|
|
|
1
|
+
import { durationMs, SCHEDULE_IDEMPOTENCY_KEY_PREFIX } from '@aeolus-fleet/common';
|
|
2
|
+
import { refuse } from '../shared/errors.js';
|
|
3
|
+
import { ok } from '../shared/result.js';
|
|
4
|
+
import { cronSendTimeAfter, isKnownTimeZone, parseCron } from './cron.js';
|
|
5
|
+
/**
|
|
6
|
+
* A ship's scheduled message (decision 0062): a whole send input that core
|
|
7
|
+
* sends as that ship at its send time. Plain data; the functions here change
|
|
8
|
+
* it and raise its events. Each send time gives one message, or a refusal
|
|
9
|
+
* recorded on the schedule.
|
|
10
|
+
*/
|
|
11
|
+
/** How long after its send time a refused send is tried again under retry, unless the creator says. */
|
|
12
|
+
export const RETRY_WINDOW_DEFAULT = 'PT1H';
|
|
13
|
+
/** How long a refused send under retry waits for its next try: one pass of core. */
|
|
14
|
+
export const RETRY_EVERY_MS = 30_000;
|
|
15
|
+
/** What a missed send time does, unless the creator says: every missed one is sent (S6). */
|
|
16
|
+
export const MISSED_STRATEGY_DEFAULT = 'each';
|
|
17
|
+
/** How late a pass may reach a send time before it is missed, unless the creator says (S6). */
|
|
18
|
+
export const GRACE_DEFAULT = 'PT5M';
|
|
19
|
+
/** A cron's zone unless the creator says (S1). */
|
|
20
|
+
export const TIME_ZONE_DEFAULT = 'UTC';
|
|
21
|
+
/**
|
|
22
|
+
* A new schedule, active, its next send time its first, and ScheduleCreated
|
|
23
|
+
* on its ship. Its timing is valid and gives a send time after now: a once
|
|
24
|
+
* schedule in the future, an every of a fixed duration, a cron of five fields
|
|
25
|
+
* in a zone the server knows, an end after its start, a count of at least
|
|
26
|
+
* one. A retry window and a grace are durations of a fixed length.
|
|
27
|
+
*/
|
|
28
|
+
export function planSchedule(plan) {
|
|
29
|
+
const { at } = plan;
|
|
30
|
+
const timing = timingOf(plan.timing);
|
|
31
|
+
if (!timing.isOk) {
|
|
32
|
+
return timing;
|
|
33
|
+
}
|
|
34
|
+
const retryWindow = plan.retryWindow ?? RETRY_WINDOW_DEFAULT;
|
|
35
|
+
if (durationMs(retryWindow) === undefined) {
|
|
36
|
+
return refuse('INVALID_RETRY_WINDOW', 'A retry window is an ISO 8601 duration of weeks, or days, hours, minutes and seconds, such as PT30M');
|
|
37
|
+
}
|
|
38
|
+
const grace = plan.grace ?? GRACE_DEFAULT;
|
|
39
|
+
if (durationMs(grace) === undefined) {
|
|
40
|
+
return refuse('INVALID_GRACE', 'A grace is an ISO 8601 duration of weeks, or days, hours, minutes and seconds, such as PT5M');
|
|
41
|
+
}
|
|
42
|
+
const firstSendTime = sendTimeAfter({ timing: timing.value, createdAt: at }, at);
|
|
43
|
+
if (firstSendTime === undefined) {
|
|
44
|
+
return refuse('INVALID_TIMING', 'This timing has no send time after now: a once schedule is in the future, and a repeat sends at least once before its end');
|
|
45
|
+
}
|
|
46
|
+
const schedule = {
|
|
47
|
+
id: plan.scheduleId,
|
|
48
|
+
fleetId: plan.fleetId,
|
|
49
|
+
shipId: plan.shipId,
|
|
50
|
+
send: plan.send,
|
|
51
|
+
timing: timing.value,
|
|
52
|
+
onRefused: plan.onRefused ?? 'skip',
|
|
53
|
+
retryWindow,
|
|
54
|
+
onMissed: plan.onMissed ?? MISSED_STRATEGY_DEFAULT,
|
|
55
|
+
grace,
|
|
56
|
+
idempotencyKey: plan.idempotencyKey,
|
|
57
|
+
requestHash: plan.requestHash,
|
|
58
|
+
state: 'active',
|
|
59
|
+
nextSendTime: firstSendTime,
|
|
60
|
+
nextAttemptAt: firstSendTime,
|
|
61
|
+
lastOutcome: null,
|
|
62
|
+
createdAt: at,
|
|
63
|
+
endedAt: null,
|
|
64
|
+
cancelledAt: null,
|
|
65
|
+
};
|
|
66
|
+
return ok({
|
|
67
|
+
schedule,
|
|
68
|
+
events: [eventOf(schedule, { type: 'ScheduleCreated', at, actor: { kind: 'ship', shipId: schedule.shipId }, details: { timing: timing.value.kind, nextSendTime: firstSendTime.toISOString() } })],
|
|
69
|
+
});
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* The schedule's first send time strictly after an instant, within its start
|
|
73
|
+
* and end; none when it has no more. An every sends on the beat of its start,
|
|
74
|
+
* or else of its creation, never at the creation itself.
|
|
75
|
+
*/
|
|
76
|
+
export function sendTimeAfter(schedule, after) {
|
|
77
|
+
const { timing } = schedule;
|
|
78
|
+
if (timing.kind === 'once') {
|
|
79
|
+
return timing.at > after ? timing.at : undefined;
|
|
80
|
+
}
|
|
81
|
+
const next = timing.kind === 'every' ? everySendTimeAfter({ every: timing.every, start: timing.start, createdAt: schedule.createdAt }, after) : cronAfter(timing, after);
|
|
82
|
+
return next !== undefined && (timing.end === null || next <= timing.end) ? next : undefined;
|
|
83
|
+
}
|
|
84
|
+
function everySendTimeAfter(every, after) {
|
|
85
|
+
const intervalMs = durationMs(every.every);
|
|
86
|
+
if (intervalMs === undefined) {
|
|
87
|
+
return undefined;
|
|
88
|
+
}
|
|
89
|
+
const anchorMs = (every.start ?? every.createdAt).getTime();
|
|
90
|
+
const beats = Math.max(every.start === null ? 1 : 0, Math.floor((after.getTime() - anchorMs) / intervalMs) + 1);
|
|
91
|
+
return new Date(anchorMs + beats * intervalMs);
|
|
92
|
+
}
|
|
93
|
+
function cronAfter(timing, after) {
|
|
94
|
+
const cron = parseCron(timing.cron);
|
|
95
|
+
if (!cron.isOk) {
|
|
96
|
+
return undefined;
|
|
97
|
+
}
|
|
98
|
+
// A send time may fall on the start itself, so look from just before it.
|
|
99
|
+
const from = timing.start !== null && timing.start > after ? new Date(timing.start.getTime() - 1) : after;
|
|
100
|
+
return cronSendTimeAfter({ cron: cron.value, timeZone: timing.timeZone }, from);
|
|
101
|
+
}
|
|
102
|
+
/** The timing as stored, its defaults filled in, or why it is not valid. */
|
|
103
|
+
function timingOf(input) {
|
|
104
|
+
if (input.kind === 'once') {
|
|
105
|
+
return ok(input);
|
|
106
|
+
}
|
|
107
|
+
const bounds = { start: input.start ?? null, end: input.end ?? null, count: input.count ?? null };
|
|
108
|
+
if (bounds.count !== null && (!Number.isInteger(bounds.count) || bounds.count < 1)) {
|
|
109
|
+
return refuse('INVALID_TIMING', `A repeat's count is a whole number of sends of at least 1, not ${bounds.count}`);
|
|
110
|
+
}
|
|
111
|
+
if (bounds.start !== null && bounds.end !== null && bounds.end <= bounds.start) {
|
|
112
|
+
return refuse('INVALID_TIMING', `A repeat's end is after its start: ${bounds.end.toISOString()} is not after ${bounds.start.toISOString()}`);
|
|
113
|
+
}
|
|
114
|
+
if (input.kind === 'every') {
|
|
115
|
+
return durationMs(input.every) === undefined
|
|
116
|
+
? refuse('INVALID_TIMING', `every is an ISO 8601 duration of weeks, or days, hours, minutes and seconds, such as PT6H: "${input.every}" is not one`)
|
|
117
|
+
: ok({ kind: 'every', every: input.every, ...bounds });
|
|
118
|
+
}
|
|
119
|
+
const cron = parseCron(input.cron);
|
|
120
|
+
if (!cron.isOk) {
|
|
121
|
+
return cron;
|
|
122
|
+
}
|
|
123
|
+
const timeZone = input.timeZone ?? TIME_ZONE_DEFAULT;
|
|
124
|
+
if (!isKnownTimeZone(timeZone)) {
|
|
125
|
+
return refuse('INVALID_TIMING', `A cron's zone is an IANA time zone, such as Europe/Brussels: "${timeZone}" is not one this server knows`);
|
|
126
|
+
}
|
|
127
|
+
return ok({ kind: 'cron', cron: input.cron, timeZone, ...bounds });
|
|
128
|
+
}
|
|
129
|
+
/**
|
|
130
|
+
* The idempotency key of the message a schedule sends at a send time: unique
|
|
131
|
+
* per sender, so a second claim of the same send time stores no second
|
|
132
|
+
* message, and a replay finds the one stored.
|
|
133
|
+
*/
|
|
134
|
+
export function scheduledMessageKey(scheduleId, sendTime) {
|
|
135
|
+
return `${SCHEDULE_IDEMPOTENCY_KEY_PREFIX}${scheduleId}:${sendTime.toISOString()}`;
|
|
136
|
+
}
|
|
137
|
+
/**
|
|
138
|
+
* The send time sent: the message is its outcome, and the schedule goes on to
|
|
139
|
+
* its next send time, or ends with ScheduleEnded past its end or its count,
|
|
140
|
+
* counting the sends so far with this one.
|
|
141
|
+
*/
|
|
142
|
+
export function scheduleSent(schedule, sent) {
|
|
143
|
+
const { messageId, sendTime, at, sentCount } = sent;
|
|
144
|
+
return advanced({ ...schedule, lastOutcome: { kind: 'sent', messageId, sendTime, at } }, { sendTime, at, sentCount, outcome: 'sent' });
|
|
145
|
+
}
|
|
146
|
+
/**
|
|
147
|
+
* The send time refused with its code, recorded with ScheduledSendRefused,
|
|
148
|
+
* then the creator's strategy (S7): skip goes on to the next send time, so a
|
|
149
|
+
* once schedule ends; retry keeps the send time and tries again a pass later
|
|
150
|
+
* while inside its window, then skips; pause pauses it, keeping its send
|
|
151
|
+
* time, with SchedulePaused.
|
|
152
|
+
*/
|
|
153
|
+
export function scheduleRefused(schedule, refused) {
|
|
154
|
+
const { at, sendTime, code, sentCount } = refused;
|
|
155
|
+
const skipped = { sendTime, at, sentCount, outcome: 'skipped' };
|
|
156
|
+
const recorded = { ...schedule, lastOutcome: { kind: 'refused', code, sendTime, at } };
|
|
157
|
+
const refusal = eventOf(schedule, {
|
|
158
|
+
type: 'ScheduledSendRefused',
|
|
159
|
+
at,
|
|
160
|
+
actor: { kind: 'ship', shipId: schedule.shipId },
|
|
161
|
+
details: { sendTime: sendTime.toISOString(), code, strategy: schedule.onRefused },
|
|
162
|
+
});
|
|
163
|
+
switch (schedule.onRefused) {
|
|
164
|
+
case 'skip':
|
|
165
|
+
return withEvent(refusal, advanced(recorded, skipped));
|
|
166
|
+
case 'retry':
|
|
167
|
+
return isInsideRetryWindow(schedule, { sendTime, at })
|
|
168
|
+
? { schedule: { ...recorded, nextAttemptAt: new Date(at.getTime() + RETRY_EVERY_MS) }, events: [refusal] }
|
|
169
|
+
: withEvent(refusal, advanced(recorded, skipped));
|
|
170
|
+
case 'pause':
|
|
171
|
+
return {
|
|
172
|
+
schedule: { ...recorded, state: 'paused', nextAttemptAt: null },
|
|
173
|
+
events: [refusal, eventOf(schedule, { type: 'SchedulePaused', at, actor: { kind: 'ship', shipId: schedule.shipId }, details: { reason: 'refused' } })],
|
|
174
|
+
};
|
|
175
|
+
}
|
|
176
|
+
}
|
|
177
|
+
/**
|
|
178
|
+
* Pauses an active schedule, keeping its next send time, with SchedulePaused
|
|
179
|
+
* caused by the actor; a paused one stays as it is, with no event. An ended
|
|
180
|
+
* or cancelled one is refused.
|
|
181
|
+
*/
|
|
182
|
+
export function pauseSchedule(schedule, pause) {
|
|
183
|
+
const closed = closedRefusal(schedule);
|
|
184
|
+
if (closed) {
|
|
185
|
+
return closed;
|
|
186
|
+
}
|
|
187
|
+
if (schedule.state === 'paused') {
|
|
188
|
+
return ok({ schedule, events: [] });
|
|
189
|
+
}
|
|
190
|
+
return ok({
|
|
191
|
+
schedule: { ...schedule, state: 'paused', nextAttemptAt: null },
|
|
192
|
+
events: [eventOf(schedule, { type: 'SchedulePaused', at: pause.at, actor: pause.actor, details: { reason: pause.reason } })],
|
|
193
|
+
});
|
|
194
|
+
}
|
|
195
|
+
/**
|
|
196
|
+
* Resumes a paused schedule with ScheduleResumed: the send times passed
|
|
197
|
+
* while paused are skipped, so it goes on at its first send time after now,
|
|
198
|
+
* or ends when it has none. An active one stays as it is, with no event. An
|
|
199
|
+
* ended or cancelled one is refused.
|
|
200
|
+
*/
|
|
201
|
+
export function resumeSchedule(schedule, resume) {
|
|
202
|
+
const closed = closedRefusal(schedule);
|
|
203
|
+
if (closed) {
|
|
204
|
+
return closed;
|
|
205
|
+
}
|
|
206
|
+
if (schedule.state === 'active') {
|
|
207
|
+
return ok({ schedule, events: [] });
|
|
208
|
+
}
|
|
209
|
+
const { at, actor } = resume;
|
|
210
|
+
const next = schedule.nextSendTime !== null && schedule.nextSendTime > at ? schedule.nextSendTime : sendTimeAfter(schedule, at);
|
|
211
|
+
if (next === undefined) {
|
|
212
|
+
const resumed = eventOf(schedule, { type: 'ScheduleResumed', at, actor, details: {} });
|
|
213
|
+
return ok(withEvent(resumed, ended({ ...schedule, state: 'active' }, { at, outcome: 'skipped' })));
|
|
214
|
+
}
|
|
215
|
+
return ok({
|
|
216
|
+
schedule: { ...schedule, state: 'active', nextSendTime: next, nextAttemptAt: next },
|
|
217
|
+
events: [eventOf(schedule, { type: 'ScheduleResumed', at, actor, details: { nextSendTime: next.toISOString() } })],
|
|
218
|
+
});
|
|
219
|
+
}
|
|
220
|
+
function closedRefusal(schedule) {
|
|
221
|
+
switch (schedule.state) {
|
|
222
|
+
case 'ended':
|
|
223
|
+
return refuse('SCHEDULE_ENDED', `Schedule ${schedule.id} ended: it sends nothing more`);
|
|
224
|
+
case 'cancelled':
|
|
225
|
+
return refuse('SCHEDULE_CANCELLED', `Schedule ${schedule.id} was cancelled: it sends nothing more`);
|
|
226
|
+
case 'active':
|
|
227
|
+
case 'paused':
|
|
228
|
+
return undefined;
|
|
229
|
+
}
|
|
230
|
+
}
|
|
231
|
+
/**
|
|
232
|
+
* Cancels an active or paused schedule, with ScheduleCancelled on its ship
|
|
233
|
+
* caused by the actor; a cancelled one stays as it is, with no event, so a
|
|
234
|
+
* retry of a cancel changes nothing. An ended one is refused.
|
|
235
|
+
*/
|
|
236
|
+
export function cancelSchedule(schedule, cancel) {
|
|
237
|
+
switch (schedule.state) {
|
|
238
|
+
case 'cancelled':
|
|
239
|
+
return ok({ schedule, events: [] });
|
|
240
|
+
case 'ended':
|
|
241
|
+
return refuse('SCHEDULE_ENDED', `Schedule ${schedule.id} ended: it sends nothing more`);
|
|
242
|
+
case 'active':
|
|
243
|
+
case 'paused':
|
|
244
|
+
return ok({
|
|
245
|
+
schedule: { ...schedule, state: 'cancelled', nextSendTime: null, nextAttemptAt: null, cancelledAt: cancel.at },
|
|
246
|
+
events: [eventOf(schedule, { type: 'ScheduleCancelled', at: cancel.at, actor: cancel.actor, details: { reason: cancel.reason } })],
|
|
247
|
+
});
|
|
248
|
+
}
|
|
249
|
+
}
|
|
250
|
+
/** Whether a refused send time may still be tried: before its send time plus the retry window. */
|
|
251
|
+
function isInsideRetryWindow(schedule, refused) {
|
|
252
|
+
return refused.at.getTime() < refused.sendTime.getTime() + (durationMs(schedule.retryWindow) ?? 0);
|
|
253
|
+
}
|
|
254
|
+
/**
|
|
255
|
+
* Whether a due send time is sent (S6): one kept for a retry, and one the
|
|
256
|
+
* pass reaches within its grace, always; a missed one by the creator's
|
|
257
|
+
* strategy: each sends it, skip does not, once only when it is the latest
|
|
258
|
+
* missed.
|
|
259
|
+
*/
|
|
260
|
+
export function isSendTimeToSend(schedule, due) {
|
|
261
|
+
const { sendTime, at } = due;
|
|
262
|
+
const { lastOutcome } = schedule;
|
|
263
|
+
if (lastOutcome?.kind === 'refused' && lastOutcome.sendTime.getTime() === sendTime.getTime()) {
|
|
264
|
+
return true;
|
|
265
|
+
}
|
|
266
|
+
if (!isMissed(schedule, { sendTime, at })) {
|
|
267
|
+
return true;
|
|
268
|
+
}
|
|
269
|
+
switch (schedule.onMissed) {
|
|
270
|
+
case 'each':
|
|
271
|
+
return true;
|
|
272
|
+
case 'skip':
|
|
273
|
+
return false;
|
|
274
|
+
case 'once': {
|
|
275
|
+
const next = sendTimeAfter(schedule, sendTime);
|
|
276
|
+
return next === undefined || next > at || !isMissed(schedule, { sendTime: next, at });
|
|
277
|
+
}
|
|
278
|
+
}
|
|
279
|
+
}
|
|
280
|
+
/** The send time missed, not sent (S6): recorded with ScheduledSendMissed and as the last outcome, then on to the next. */
|
|
281
|
+
export function scheduleMissed(schedule, missed) {
|
|
282
|
+
const { sendTime, at } = missed;
|
|
283
|
+
const record = eventOf(schedule, {
|
|
284
|
+
type: 'ScheduledSendMissed',
|
|
285
|
+
at,
|
|
286
|
+
actor: { kind: 'ship', shipId: schedule.shipId },
|
|
287
|
+
details: { sendTime: sendTime.toISOString(), strategy: schedule.onMissed },
|
|
288
|
+
});
|
|
289
|
+
return withEvent(record, advanced({ ...schedule, lastOutcome: { kind: 'missed', sendTime, at } }, { ...missed, outcome: 'missed' }));
|
|
290
|
+
}
|
|
291
|
+
/** Whether the pass reaches a send time later than its grace. */
|
|
292
|
+
function isMissed(schedule, due) {
|
|
293
|
+
return due.at.getTime() - due.sendTime.getTime() > (durationMs(schedule.grace) ?? 0);
|
|
294
|
+
}
|
|
295
|
+
/** After a send time: on to the next, or ended when it has none or its count of sends is reached. */
|
|
296
|
+
function advanced(schedule, after) {
|
|
297
|
+
const { timing } = schedule;
|
|
298
|
+
const isCountReached = timing.kind !== 'once' && timing.count !== null && after.sentCount >= timing.count;
|
|
299
|
+
const next = isCountReached ? undefined : sendTimeAfter(schedule, after.sendTime);
|
|
300
|
+
return next === undefined ? ended(schedule, after) : { schedule: { ...schedule, nextSendTime: next, nextAttemptAt: next }, events: [] };
|
|
301
|
+
}
|
|
302
|
+
/** A schedule after its last send time: ended, sending nothing more. */
|
|
303
|
+
function ended(schedule, end) {
|
|
304
|
+
return {
|
|
305
|
+
schedule: { ...schedule, state: 'ended', nextSendTime: null, nextAttemptAt: null, endedAt: end.at },
|
|
306
|
+
events: [eventOf(schedule, { type: 'ScheduleEnded', at: end.at, actor: { kind: 'ship', shipId: schedule.shipId }, details: { outcome: end.outcome } })],
|
|
307
|
+
};
|
|
308
|
+
}
|
|
309
|
+
function withEvent(first, change) {
|
|
310
|
+
return { schedule: change.schedule, events: [first, ...change.events] };
|
|
311
|
+
}
|
|
312
|
+
/** An event on the schedule's ship, naming the schedule first in its details. */
|
|
313
|
+
function eventOf(schedule, event) {
|
|
314
|
+
return { fleetId: schedule.fleetId, type: event.type, occurredAt: event.at, actor: event.actor, shipId: schedule.shipId, details: { scheduleId: schedule.id, ...event.details } };
|
|
315
|
+
}
|
|
316
|
+
//# sourceMappingURL=schedule.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"schedule.js","sourceRoot":"","sources":["../../../src/domain/messaging/schedule.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import type { FleetId, IdGenerator } from '@aeolus-fleet/common';
|
|
2
|
+
import { type FleetRepository } from '../registry/public.js';
|
|
3
|
+
import type { Clock } from '../shared/clock.js';
|
|
4
|
+
import type { UnitOfWork } from '../shared/unit-of-work.js';
|
|
5
|
+
import type { RequestHasher, ScheduleAttempts, ScheduleNotifier, ScheduleRepository } from './ports.js';
|
|
6
|
+
import { type SendMessageTx } from './send-message.js';
|
|
7
|
+
export interface SendDueSchedulesTx extends SendMessageTx {
|
|
8
|
+
schedules: Pick<ScheduleRepository, 'claimDue' | 'save' | 'sentCount'>;
|
|
9
|
+
scheduleNotifier: ScheduleNotifier;
|
|
10
|
+
}
|
|
11
|
+
/** Hears a failed schedule send, for the server's log: the pass goes on with the next. */
|
|
12
|
+
export type ScheduleSendFailed = (fleetId: FleetId, error: unknown) => void;
|
|
13
|
+
export type SendDueSchedules = (onError?: ScheduleSendFailed) => Promise<{
|
|
14
|
+
nextAttemptAt: Date | undefined;
|
|
15
|
+
}>;
|
|
16
|
+
/**
|
|
17
|
+
* Use case: sends every schedule that is due (decision 0062), run by core on
|
|
18
|
+
* a server's timer and on the 30 second pass, never through the API. Each
|
|
19
|
+
* one is its own unit of work: claim one due schedule, skipping those another
|
|
20
|
+
* server holds; for each of its due send times, oldest first, at most 100,
|
|
21
|
+
* send its message as its ship, checked as a send by that ship now (its
|
|
22
|
+
* scopes, reach, the daily limit, the selector), its payload as stored, its
|
|
23
|
+
* schedule and send time on the envelope, its key derived from both, or
|
|
24
|
+
* record it missed by its missed strategy; record the outcome on the
|
|
25
|
+
* schedule, by its refusal strategy when refused; advance it; commit. A unit of work that fails stores nothing and
|
|
26
|
+
* advances nothing, so the next pass sends that send time; a committed one
|
|
27
|
+
* advanced it, so nothing is sent again, and the derived key would find the
|
|
28
|
+
* stored message even under a second claim. A pass tries each schedule
|
|
29
|
+
* once. Answers when the earliest attempt still ahead is due, for the timer.
|
|
30
|
+
*/
|
|
31
|
+
export declare function createSendDueSchedules(deps: {
|
|
32
|
+
fleets: Pick<FleetRepository, 'list'>;
|
|
33
|
+
scheduleAttempts: ScheduleAttempts;
|
|
34
|
+
uow: UnitOfWork<SendDueSchedulesTx>;
|
|
35
|
+
clock: Clock;
|
|
36
|
+
ids: IdGenerator;
|
|
37
|
+
hasher: RequestHasher;
|
|
38
|
+
}): SendDueSchedules;
|
|
39
|
+
/** At most this many send times of one schedule in one unit of work, oldest first; the rest on the next pass (S6). */
|
|
40
|
+
export declare const SEND_TIMES_PER_PASS = 100;
|