@aeolus-fleet/gateway 0.38.1 → 0.38.3

package/dist/core/people/quiet-hours.js

@@ -0,0 +1,65 @@
+import { refuse } from '../shared/errors.js';
+import { ok } from '../shared/result.js';
+const MINUTES_PER_DAY = 24 * 60;
+const MS_PER_MINUTE = 60_000;
+const isMinuteOfDay = (minute) => Number.isInteger(minute) && minute >= 0 && minute < MINUTES_PER_DAY;
+function isKnownTimeZone(timeZone) {
+    try {
+        new Intl.DateTimeFormat('en-US', { timeZone });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** A quiet window, refused when either end is not a minute of the day, both ends are one, or the time zone is unknown. */
+export function quietWindowOf(window) {
+    const { fromMinute, toMinute, timeZone } = window;
+    if (!isMinuteOfDay(fromMinute) || !isMinuteOfDay(toMinute)) {
+        return refuse('INVALID_QUIET_HOURS', 'Quiet hours start and end at a time of the day');
+    }
+    if (fromMinute === toMinute) {
+        return refuse('INVALID_QUIET_HOURS', 'Quiet hours end at another time than they start');
+    }
+    if (!isKnownTimeZone(timeZone)) {
+        return refuse('INVALID_QUIET_HOURS', `No time zone is named ${timeZone}`);
+    }
+    return ok({ fromMinute, toMinute, timeZone });
+}
+function localTimeOf(instant, timeZone) {
+    const parts = new Intl.DateTimeFormat('en-US', { timeZone, hourCycle: 'h23', year: 'numeric', month: 'numeric', day: 'numeric', hour: 'numeric', minute: 'numeric' }).formatToParts(instant);
+    const part = (type) => Number(parts.find((each) => each.type === type)?.value);
+    const [year, month, day, hour, minute] = [part('year'), part('month'), part('day'), part('hour'), part('minute')];
+    return { year, month, day, minute: hour * 60 + minute, asUtcMs: Date.UTC(year, month - 1, day, hour, minute) };
+}
+/** How far the time zone's clock is ahead of UTC at the instant. */
+function offsetMsAt(instantMs, timeZone) {
+    const floored = Math.floor(instantMs / MS_PER_MINUTE) * MS_PER_MINUTE;
+    return localTimeOf(new Date(floored), timeZone).asUtcMs - floored;
+}
+/** The instant the time zone's clock shows the minute on the day, the day counted from the local day given. */
+function instantAt(local, { dayOffset, minute, timeZone }) {
+    const asUtcMs = Date.UTC(local.year, local.month - 1, local.day + dayOffset, 0, minute);
+    // The offset at a first guess, then at the instant it gives, so a change of the clocks in between is taken.
+    const guess = asUtcMs - offsetMsAt(asUtcMs, timeZone);
+    return new Date(asUtcMs - offsetMsAt(guess, timeZone));
+}
+/** The quiet hours in effect at the instant, or none while they are off or the instant is outside them. */
+export function quietSpellAt(hours, now) {
+    if (!hours.isOn) {
+        return undefined;
+    }
+    const { fromMinute, toMinute, timeZone } = hours;
+    const local = localTimeOf(now, timeZone);
+    const isCrossingMidnight = fromMinute > toMinute;
+    const isAfterStart = local.minute >= fromMinute;
+    const isBeforeEnd = local.minute < toMinute;
+    if (isCrossingMidnight ? !isAfterStart && !isBeforeEnd : !isAfterStart || !isBeforeEnd) {
+        return undefined;
+    }
+    // Crossing midnight, a spell began yesterday when it is after midnight now, and ends tomorrow when it is before.
+    const startDay = isCrossingMidnight && !isAfterStart ? -1 : 0;
+    const endDay = isCrossingMidnight && isAfterStart ? 1 : 0;
+    return { since: instantAt(local, { dayOffset: startDay, minute: fromMinute, timeZone }), until: instantAt(local, { dayOffset: endDay, minute: toMinute, timeZone }) };
+}
+//# sourceMappingURL=quiet-hours.js.map

package/dist/core/people/quiet-hours.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quiet-hours.js","sourceRoot":"","sources":["../../../src/core/people/quiet-hours.ts"],"names":[],"mappings":"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"}

package/dist/core/people/quiet-ships.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Quiet ships (preferences design): per fleet and person ship, the ships
+ * the person quieted. A quiet ship never wakes the person, through web push
+ * or email, for any job; Slack and a chat are places, not wakes, so their
+ * per job switches stand. Every item still waits whatever is chosen. A ship
+ * woken again is kept so, with when, as it wakes only for what it sends
+ * after. Kept by ship id, so a rename stays quiet and a reused name does
+ * not inherit it; the name is the one it had when quieted.
+ */
+import type { FleetId, ShipId } from '@aeolus-fleet/common';
+import type { PersonShip } from './ports.js';
+import type { Routing } from './routing.js';
+/** A ship a person quieted, or woke again, with when they did. */
+export interface QuietShip {
+    readonly fleetId: FleetId;
+    readonly shipId: ShipId;
+    readonly quietShipId: ShipId;
+    readonly name: string;
+    readonly isQuiet: boolean;
+    readonly changedAt: Date;
+}
+/** A page of the person's quiet ships, the latest quieted first, and the cursor of the next; null on the last. */
+export interface QuietShipsPage {
+    readonly ships: readonly QuietShip[];
+    readonly nextCursor: ShipId | null;
+}
+/** Outbound port: each person's quiet ships, by fleet and person ship. */
+export interface QuietShips {
+    /** What the person chose for any of these ships: quiet, or woken again. */
+    among(ship: PersonShip, shipIds: readonly ShipId[]): Promise<QuietShip[]>;
+    /** The quiet ones only, the latest quieted first, after the cursor. */
+    listQuiet(ship: PersonShip, page: {
+        cursor: ShipId | null;
+        limit: number;
+    }): Promise<QuietShipsPage>;
+    /** Keeps it, or keeps it anew for its ship. */
+    save(quietShip: QuietShip): Promise<void>;
+}
+/** Routing with the person's quiet ships: none of them wakes, and one woken again wakes for what it sent since. */
+export declare function withQuietShips(routing: Routing, quietShips: readonly QuietShip[]): Routing;

package/dist/core/people/quiet-ships.js

@@ -0,0 +1,24 @@
+/** Whether the place wakes the person, so a quiet ship keeps out of it. */
+function isWakePlace(place) {
+    switch (place) {
+        case 'web-push':
+        case 'email':
+            return true;
+        case 'slack':
+        case 'chat':
+            return false;
+    }
+}
+/** Routing with the person's quiet ships: none of them wakes, and one woken again wakes for what it sent since. */
+export function withQuietShips(routing, quietShips) {
+    const chosen = new Map(quietShips.map((quietShip) => [quietShip.quietShipId, quietShip]));
+    const isQuietFor = ({ senderShipId, sentAt }) => {
+        const quietShip = chosen.get(senderShipId);
+        return quietShip !== undefined && (quietShip.isQuiet || sentAt.getTime() < quietShip.changedAt.getTime());
+    };
+    return {
+        isOn: (job, place) => routing.isOn(job, place),
+        isShowing: (place, item) => !(isWakePlace(place) && isQuietFor(item)) && routing.isShowing(place, item),
+    };
+}
+//# sourceMappingURL=quiet-ships.js.map

package/dist/core/people/quiet-ships.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quiet-ships.js","sourceRoot":"","sources":["../../../src/core/people/quiet-ships.ts"],"names":[],"mappings":"AAwCA,2EAA2E;AAC3E,SAAS,WAAW,CAAC,KAAmB;IACtC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,UAAU,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,IAAI,CAAC;QACd,KAAK,OAAO,CAAC;QACb,KAAK,MAAM;YACT,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,mHAAmH;AACnH,MAAM,UAAU,cAAc,CAAC,OAAgB,EAAE,UAAgC;IAC/E,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAC1F,MAAM,UAAU,GAAG,CAAC,EAAE,YAAY,EAAE,MAAM,EAAc,EAAW,EAAE;QACnE,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC3C,OAAO,SAAS,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5G,CAAC,CAAC;IACF,OAAO;QACL,IAAI,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC;QAC9C,SAAS,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC;KACxG,CAAC;AACJ,CAAC"}

package/dist/core/people/read-item.d.ts

@@ -0,0 +1,31 @@
+import type { DeliveryId } from '@aeolus-fleet/common';
+import { type DomainError } from '../shared/errors.js';
+import { type Result } from '../shared/result.js';
+import type { CrewPersonShip } from './crew-person-ship.js';
+import type { HeldDeliveries } from './held-deliveries.js';
+import type { OpenedView } from './open-delivery.js';
+import { type PersonCaller, type PersonCrewError } from './person-crew.js';
+import type { OpenedDeliveries, PersonCrews, PersonShipDoor } from './ports.js';
+type ReadItemError = PersonCrewError | DomainError<'NO_SUCH_DELIVERY'>;
+export type ReadItem = (input: {
+    caller: PersonCaller;
+    deliveryId: DeliveryId;
+}) => Promise<Result<OpenedView, ReadItemError>>;
+interface ReadItemDeps {
+    crewPersonShip: CrewPersonShip;
+    crews: PersonCrews;
+    door: PersonShipDoor;
+    held: HeldDeliveries;
+    opened: Pick<OpenedDeliveries, 'list'>;
+}
+/**
+ * Use case: a person's client reads one item of their person ship whole by its
+ * delivery id, in any state, as opening gives it, and acknowledges nothing
+ * and keeps nothing. A waiting one is read from what waits, one they
+ * acknowledged and are not done with is read again from the fleet, and a
+ * done one is found in the ship's record, newest first. A delivery of
+ * another ship is none of these, so it is refused as no such delivery. A
+ * sealed message the fleet cannot unseal now is refused, as opening refuses it.
+ */
+export declare function createReadItem(deps: ReadItemDeps): ReadItem;
+export {};

package/dist/core/people/read-item.js

@@ -0,0 +1,77 @@
+import { refuse } from '../shared/errors.js';
+import { ok } from '../shared/result.js';
+import { inboxEntryOf } from './inbox-entry.js';
+import { meetingNoticeSaid } from './meeting-notice.js';
+import { asPersonCrew, KEY_UNAVAILABLE, SEALED_MESSAGE, withOwnRefusal } from './person-crew.js';
+import { waitingFor } from './read-inbox.js';
+import { RECORD_PAGE_SIZE } from './read-record.js';
+import { askingOf, staleOf } from './stale-item.js';
+/**
+ * Use case: a person's client reads one item of their person ship whole by its
+ * delivery id, in any state, as opening gives it, and acknowledges nothing
+ * and keeps nothing. A waiting one is read from what waits, one they
+ * acknowledged and are not done with is read again from the fleet, and a
+ * done one is found in the ship's record, newest first. A delivery of
+ * another ship is none of these, so it is refused as no such delivery. A
+ * sealed message the fleet cannot unseal now is refused, as opening refuses it.
+ */
+export function createReadItem(deps) {
+    return async ({ caller, deliveryId }) => {
+        const waiting = await waitingFor(deps, caller);
+        if (!waiting.isOk) {
+            return waiting;
+        }
+        const { crew, deliveries } = waiting.value;
+        const delivery = deliveries.find((each) => each.deliveryId === deliveryId);
+        const found = delivery === undefined ? await readFromFleet(deps, { caller, deliveryId }) : ok(delivery);
+        if (!found.isOk) {
+            return found;
+        }
+        const stale = await staleFor(deps, { caller, crew, delivery: found.value, waiting: deliveries });
+        return ok({ ...inboxEntryOf(found.value), contentType: found.value.contentType, payload: found.value.payload, meetingId: found.value.meetingId, said: meetingNoticeSaid({ ...found.value, from: found.value.senderName }), stale });
+    };
+}
+/** An item that no more waits: the person acknowledged it and is not done, so the fleet reads it again, or it is done, so the record holds it. */
+async function readFromFleet(deps, asked) {
+    const { caller, deliveryId } = asked;
+    const reread = await asPersonCrew(deps, { caller, run: (crew) => withOwnRefusal(deps.door.delivery(crew.crewToken, deliveryId)) });
+    if (!reread.isOk) {
+        return reread;
+    }
+    const delivery = reread.value.value;
+    if (delivery.isOk) {
+        return ok(delivery.value);
+    }
+    if (delivery.error.code === KEY_UNAVAILABLE) {
+        return refuse('KEY_UNAVAILABLE', SEALED_MESSAGE);
+    }
+    return inRecord(deps, asked);
+}
+/** Looks through the record, newest first, until the delivery or the ids older than it. */
+async function inRecord(deps, asked) {
+    const { caller, deliveryId, cursor = null } = asked;
+    const read = await asPersonCrew(deps, { caller, run: (crew) => withOwnRefusal(deps.door.record(crew.crewToken, { cursor, limit: RECORD_PAGE_SIZE })) });
+    if (!read.isOk) {
+        return read;
+    }
+    const page = read.value.value;
+    if (!page.isOk) {
+        return refuse('FLEET_UNAVAILABLE', `The item cannot be read now: ${page.error.message}. Nothing is lost`);
+    }
+    const recorded = page.value.items.find((each) => each.deliveryId === deliveryId);
+    if (recorded !== undefined) {
+        return recorded.isPayloadUnreadable ? refuse('KEY_UNAVAILABLE', SEALED_MESSAGE) : ok(recorded);
+    }
+    const oldest = page.value.items.at(-1)?.deliveryId;
+    if (oldest === undefined || oldest < deliveryId || page.value.nextCursor === null) {
+        return refuse('NO_SUCH_DELIVERY', `No delivery ${deliveryId} of your person ship waits, is opened or is done: read your inbox again`);
+    }
+    return inRecord(deps, { ...asked, cursor: page.value.nextCursor });
+}
+/** Whether its asker withdrew or replaced the question or step it asks, among what waits and what the person opened; only told, never ended. */
+async function staleFor(deps, look) {
+    const { caller, crew, delivery, waiting } = look;
+    const opened = await deps.opened.list(caller.fleetId, crew.shipId);
+    return staleOf(askingOf(delivery), [...waiting.map(askingOf), ...opened]);
+}
+//# sourceMappingURL=read-item.js.map

package/dist/core/people/read-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-item.js","sourceRoot":"","sources":["../../../src/core/people/read-item.ts"],"names":[],"mappings":"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"}

package/dist/core/people/read-quiet-among.d.ts

@@ -0,0 +1,15 @@
+import type { ShipId } from '@aeolus-fleet/common';
+import { type Result } from '../shared/result.js';
+import type { CrewPersonShip } from './crew-person-ship.js';
+import { type PersonCaller, type PersonCrewError } from './person-crew.js';
+import type { QuietShips } from './quiet-ships.js';
+import { type QuietShipView } from './read-quiet-ships.js';
+export type ReadQuietAmong = (read: {
+    caller: PersonCaller;
+    shipIds: readonly ShipId[];
+}) => Promise<Result<QuietShipView[], PersonCrewError>>;
+/** Use case: a person's client asks which of the ships it shows are quiet (preferences design), to mark them in a conversation and the list of conversations. */
+export declare function createReadQuietAmong(deps: {
+    crewPersonShip: CrewPersonShip;
+    quietShips: Pick<QuietShips, 'among'>;
+}): ReadQuietAmong;

package/dist/core/people/read-quiet-among.js

@@ -0,0 +1,15 @@
+import { ok } from '../shared/result.js';
+import { personCrewOf } from './person-crew.js';
+import { quietShipViewOf } from './read-quiet-ships.js';
+/** Use case: a person's client asks which of the ships it shows are quiet (preferences design), to mark them in a conversation and the list of conversations. */
+export function createReadQuietAmong(deps) {
+    return async ({ caller, shipIds }) => {
+        const crew = await personCrewOf(deps.crewPersonShip, caller);
+        if (!crew.isOk) {
+            return crew;
+        }
+        const chosen = await deps.quietShips.among({ fleetId: caller.fleetId, shipId: crew.value.shipId }, shipIds);
+        return ok(chosen.filter(({ isQuiet }) => isQuiet).map(quietShipViewOf));
+    };
+}
+//# sourceMappingURL=read-quiet-among.js.map

package/dist/core/people/read-quiet-among.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-quiet-among.js","sourceRoot":"","sources":["../../../src/core/people/read-quiet-among.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAA2C,MAAM,kBAAkB,CAAC;AAEzF,OAAO,EAAE,eAAe,EAAsB,MAAM,uBAAuB,CAAC;AAI5E,iKAAiK;AACjK,MAAM,UAAU,oBAAoB,CAAC,IAA+E;IAClH,OAAO,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;QACnC,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;QAC5G,OAAO,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/people/read-quiet-hours.d.ts

@@ -0,0 +1,30 @@
+import type { Clock } from '../shared/clock.js';
+import { type Result } from '../shared/result.js';
+import type { CrewPersonShip } from './crew-person-ship.js';
+import type { HeldDeliveries } from './held-deliveries.js';
+import { type PersonCaller, type PersonCrewError } from './person-crew.js';
+import type { PersonCrews, PersonShipDoor } from './ports.js';
+import { type QuietHoursStore, type QuietSpell, type QuietWindow } from './quiet-hours.js';
+/** A person's quiet hours as their client draws them: on or off, the window set, if any, and the spell in effect now with how many of what waits arrived since it began, if any. */
+export interface QuietHoursView {
+    readonly isOn: boolean;
+    readonly window: QuietWindow | null;
+    readonly quietNow: (QuietSpell & {
+        readonly arrived: number;
+    }) | null;
+}
+export type ReadQuietHours = (caller: PersonCaller) => Promise<Result<QuietHoursView, PersonCrewError>>;
+/**
+ * Use case: a person's client reads their quiet hours (preferences design);
+ * off with no window while they set none. While they are in effect, it
+ * counts what waits that arrived since they began, from what waits as the
+ * inbox reads it; outside them it asks the fleet nothing.
+ */
+export declare function createReadQuietHours(deps: {
+    crewPersonShip: CrewPersonShip;
+    crews: PersonCrews;
+    door: PersonShipDoor;
+    held: HeldDeliveries;
+    quietHours: Pick<QuietHoursStore, 'find'>;
+    clock: Clock;
+}): ReadQuietHours;

package/dist/core/people/read-quiet-hours.js

@@ -0,0 +1,35 @@
+import { ok } from '../shared/result.js';
+import { personCrewOf } from './person-crew.js';
+import { quietSpellAt } from './quiet-hours.js';
+import { waitingFor } from './read-inbox.js';
+/**
+ * Use case: a person's client reads their quiet hours (preferences design);
+ * off with no window while they set none. While they are in effect, it
+ * counts what waits that arrived since they began, from what waits as the
+ * inbox reads it; outside them it asks the fleet nothing.
+ */
+export function createReadQuietHours(deps) {
+    return async (caller) => {
+        const crew = await personCrewOf(deps.crewPersonShip, caller);
+        if (!crew.isOk) {
+            return crew;
+        }
+        const hours = await deps.quietHours.find({ fleetId: caller.fleetId, shipId: crew.value.shipId });
+        if (hours === undefined) {
+            return ok({ isOn: false, window: null, quietNow: null });
+        }
+        const { isOn, fromMinute, toMinute, timeZone } = hours;
+        const window = { fromMinute, toMinute, timeZone };
+        const spell = quietSpellAt(hours, deps.clock.now());
+        if (spell === undefined) {
+            return ok({ isOn, window, quietNow: null });
+        }
+        const waiting = await waitingFor(deps, caller);
+        if (!waiting.isOk) {
+            return waiting;
+        }
+        const arrived = waiting.value.deliveries.filter(({ sentAt }) => sentAt.getTime() >= spell.since.getTime()).length;
+        return ok({ isOn, window, quietNow: { ...spell, arrived } });
+    };
+}
+//# sourceMappingURL=read-quiet-hours.js.map

package/dist/core/people/read-quiet-hours.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-quiet-hours.js","sourceRoot":"","sources":["../../../src/core/people/read-quiet-hours.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EAAE,YAAY,EAA2C,MAAM,kBAAkB,CAAC;AAEzF,OAAO,EAAE,YAAY,EAA2D,MAAM,kBAAkB,CAAC;AACzG,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAW7C;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAiK;IACpM,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE;QACtB,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACjG,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;QACvD,MAAM,MAAM,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;QACpD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAClB,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAClH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IAC/D,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/people/read-quiet-ships.d.ts

@@ -0,0 +1,26 @@
+import type { ShipId } from '@aeolus-fleet/common';
+import { type Result } from '../shared/result.js';
+import type { CrewPersonShip } from './crew-person-ship.js';
+import { type PersonCaller, type PersonCrewError } from './person-crew.js';
+import type { QuietShip, QuietShips } from './quiet-ships.js';
+/** How many quiet ships a page holds, as preferences show them. */
+export declare const QUIET_SHIPS_PAGE_SIZE = 20;
+/** A quiet ship as a person's client shows it: its name when quieted, and since when. */
+export interface QuietShipView {
+    readonly shipId: ShipId;
+    readonly name: string;
+    readonly since: Date;
+}
+export declare function quietShipViewOf({ quietShipId, name, changedAt }: QuietShip): QuietShipView;
+export type ReadQuietShips = (read: {
+    caller: PersonCaller;
+    cursor: ShipId | null;
+}) => Promise<Result<{
+    ships: QuietShipView[];
+    nextCursor: ShipId | null;
+}, PersonCrewError>>;
+/** Use case: a person's client lists their quiet ships (preferences design), 20 at a time, the latest quieted first, after the cursor the last page answered. */
+export declare function createReadQuietShips(deps: {
+    crewPersonShip: CrewPersonShip;
+    quietShips: Pick<QuietShips, 'listQuiet'>;
+}): ReadQuietShips;

package/dist/core/people/read-quiet-ships.js

@@ -0,0 +1,19 @@
+import { ok } from '../shared/result.js';
+import { personCrewOf } from './person-crew.js';
+/** How many quiet ships a page holds, as preferences show them. */
+export const QUIET_SHIPS_PAGE_SIZE = 20;
+export function quietShipViewOf({ quietShipId, name, changedAt }) {
+    return { shipId: quietShipId, name, since: changedAt };
+}
+/** Use case: a person's client lists their quiet ships (preferences design), 20 at a time, the latest quieted first, after the cursor the last page answered. */
+export function createReadQuietShips(deps) {
+    return async ({ caller, cursor }) => {
+        const crew = await personCrewOf(deps.crewPersonShip, caller);
+        if (!crew.isOk) {
+            return crew;
+        }
+        const page = await deps.quietShips.listQuiet({ fleetId: caller.fleetId, shipId: crew.value.shipId }, { cursor, limit: QUIET_SHIPS_PAGE_SIZE });
+        return ok({ ships: page.ships.map(quietShipViewOf), nextCursor: page.nextCursor });
+    };
+}
+//# sourceMappingURL=read-quiet-ships.js.map

package/dist/core/people/read-quiet-ships.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-quiet-ships.js","sourceRoot":"","sources":["../../../src/core/people/read-quiet-ships.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAA2C,MAAM,kBAAkB,CAAC;AAGzF,mEAAmE;AACnE,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AASxC,MAAM,UAAU,eAAe,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAa;IACzE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AACzD,CAAC;AAID,iKAAiK;AACjK,MAAM,UAAU,oBAAoB,CAAC,IAAmF;IACtH,OAAO,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;QAClC,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC,CAAC;QAC/I,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IACrF,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/people/set-quiet-hours.d.ts

@@ -0,0 +1,21 @@
+import type { Clock } from '../shared/clock.js';
+import type { DomainError } from '../shared/errors.js';
+import { type Result } from '../shared/result.js';
+import type { CrewPersonShip } from './crew-person-ship.js';
+import { type PersonCaller, type PersonCrewError } from './person-crew.js';
+import { type QuietHoursStore, type QuietWindow } from './quiet-hours.js';
+export type SetQuietHours = (set: {
+    caller: PersonCaller;
+    isOn: boolean;
+} & QuietWindow) => Promise<Result<undefined, PersonCrewError | DomainError<'INVALID_QUIET_HOURS'>>>;
+/**
+ * Use case: a person sets their quiet hours (preferences design), on or off
+ * with their window, kept by fleet and person ship with when they set them.
+ * It applies at once, as every wake reads them anew. A window that is not
+ * one is refused, keeping nothing.
+ */
+export declare function createSetQuietHours(deps: {
+    crewPersonShip: CrewPersonShip;
+    quietHours: Pick<QuietHoursStore, 'save'>;
+    clock: Clock;
+}): SetQuietHours;

package/dist/core/people/set-quiet-hours.js

@@ -0,0 +1,24 @@
+import { ok } from '../shared/result.js';
+import { personCrewOf } from './person-crew.js';
+import { quietWindowOf } from './quiet-hours.js';
+/**
+ * Use case: a person sets their quiet hours (preferences design), on or off
+ * with their window, kept by fleet and person ship with when they set them.
+ * It applies at once, as every wake reads them anew. A window that is not
+ * one is refused, keeping nothing.
+ */
+export function createSetQuietHours(deps) {
+    return async ({ caller, isOn, ...asked }) => {
+        const window = quietWindowOf(asked);
+        if (!window.isOk) {
+            return window;
+        }
+        const crew = await personCrewOf(deps.crewPersonShip, caller);
+        if (!crew.isOk) {
+            return crew;
+        }
+        await deps.quietHours.save({ fleetId: caller.fleetId, shipId: crew.value.shipId, isOn, ...window.value, changedAt: deps.clock.now() });
+        return ok(undefined);
+    };
+}
+//# sourceMappingURL=set-quiet-hours.js.map

package/dist/core/people/set-quiet-hours.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-quiet-hours.js","sourceRoot":"","sources":["../../../src/core/people/set-quiet-hours.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAA2C,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,aAAa,EAA0C,MAAM,kBAAkB,CAAC;AAIzF;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAiG;IACnI,OAAO,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE;QAC1C,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACvI,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/people/turn-ship-quiet.d.ts

@@ -0,0 +1,24 @@
+import type { ShipId } from '@aeolus-fleet/common';
+import type { Clock } from '../shared/clock.js';
+import { type Result } from '../shared/result.js';
+import type { CrewPersonShip } from './crew-person-ship.js';
+import { type PersonCaller, type PersonCrewError } from './person-crew.js';
+import type { QuietShips } from './quiet-ships.js';
+export type TurnShipQuiet = (turn: {
+    caller: PersonCaller;
+    shipId: ShipId;
+    name: string;
+    isQuiet: boolean;
+}) => Promise<Result<undefined, PersonCrewError>>;
+/**
+ * Use case: a person quiets a ship, so it never wakes them, or wakes it
+ * again (preferences design), kept by fleet, person ship and ship with when.
+ * It applies at once, as every wake reads it anew. A ship already as asked
+ * is kept as it is, so a quiet ship keeps since when it was quieted; a ship
+ * never quieted needs nothing kept to wake the person.
+ */
+export declare function createTurnShipQuiet(deps: {
+    crewPersonShip: CrewPersonShip;
+    quietShips: Pick<QuietShips, 'among' | 'save'>;
+    clock: Clock;
+}): TurnShipQuiet;

package/dist/core/people/turn-ship-quiet.js

@@ -0,0 +1,25 @@
+import { ok } from '../shared/result.js';
+import { personCrewOf } from './person-crew.js';
+/**
+ * Use case: a person quiets a ship, so it never wakes them, or wakes it
+ * again (preferences design), kept by fleet, person ship and ship with when.
+ * It applies at once, as every wake reads it anew. A ship already as asked
+ * is kept as it is, so a quiet ship keeps since when it was quieted; a ship
+ * never quieted needs nothing kept to wake the person.
+ */
+export function createTurnShipQuiet(deps) {
+    return async ({ caller, shipId, name, isQuiet }) => {
+        const crew = await personCrewOf(deps.crewPersonShip, caller);
+        if (!crew.isOk) {
+            return crew;
+        }
+        const ship = { fleetId: caller.fleetId, shipId: crew.value.shipId };
+        const [chosen] = await deps.quietShips.among(ship, [shipId]);
+        if ((chosen?.isQuiet ?? false) === isQuiet) {
+            return ok(undefined);
+        }
+        await deps.quietShips.save({ ...ship, quietShipId: shipId, name, isQuiet, changedAt: deps.clock.now() });
+        return ok(undefined);
+    };
+}
+//# sourceMappingURL=turn-ship-quiet.js.map

package/dist/core/people/turn-ship-quiet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-ship-quiet.js","sourceRoot":"","sources":["../../../src/core/people/turn-ship-quiet.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAA2C,MAAM,kBAAkB,CAAC;AAKzF;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAsG;IACxI,OAAO,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;QACjD,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,IAAI,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACpE,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7D,IAAI,CAAC,MAAM,EAAE,OAAO,IAAI,KAAK,CAAC,KAAK,OAAO,EAAE,CAAC;YAC3C,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;QACvB,CAAC;QACD,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACzG,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/people/wake-person.d.ts

@@ -2,6 +2,8 @@ import type { ConnectionStore, FleetRefusal } from "../connection/ports.js";
 import type { Clock } from "../shared/clock.js";
 import { type Result } from "../shared/result.js";
 import type { RoutingDefaults, Routes } from "./routing.js";
+import { type QuietHoursStore } from "./quiet-hours.js";
+import { type QuietShips } from "./quiet-ships.js";
 import type { FocusedPages, PersonShip, PersonShipDoor, ShownElsewhere, WakeChannel, WakeChannelName, WakesSent } from "./ports.js";
 /**
  * What a wake came to: nothing left to wake (settled), a wake held back
@@ -43,7 +45,11 @@ export type WakePerson = (ship: PersonShip, crewToken: string) => Promise<Result
  * person routed there, even while a page is in focus; nothing wakes for those
  * (gateway scopes 9.5 step 5). It is asked at every wake, fresh deliveries
  * or none, so what it left unfinished is finished, and while anything is
- * left the wake counts as failed, so it is tried again.
+ * left the wake counts as failed, so it is tried again. The person's
+ * preferences are read anew at every wake too: a quiet ship's deliveries
+ * wake nobody and wait unhanded, and during quiet hours no wake goes out;
+ * the wake is held back until they end or a channel's window passes,
+ * whichever comes first, so turning them off applies by the next window.
  */
 export declare function createWakePerson(deps: {
     door: Pick<PersonShipDoor, "pushReceive" | "handed">;
@@ -55,6 +61,9 @@ export declare function createWakePerson(deps: {
     /** Where each person routed each job (Bridge, section 8), and the defaults where they chose nothing. */
     routes: Routes;
     defaults: RoutingDefaults;
+    /** The person's quiet hours and quiet ships (preferences design). */
+    quietHours: Pick<QuietHoursStore, "find">;
+    quietShips: Pick<QuietShips, "among">;
     wakesSent: WakesSent;
     focused: FocusedPages;
     /** How long a page counts in focus since it was last seen so. */

package/dist/core/people/wake-person.js

@@ -1,6 +1,8 @@
 import { RECEIVE_MAX_UPPER_BOUND } from "@aeolus-fleet/common";
 import { err, ok } from "../shared/result.js";
 import { ownStepsInBridgeOnly, routingOf } from "./routing.js";
+import { quietSpellAt } from "./quiet-hours.js";
+import { withQuietShips } from "./quiet-ships.js";
 /**
  * Use case: wakes a person for what waits on their person ship (wake a
  * person, W3, W8). It takes the ship's deliveries with the gateway as their
@@ -27,7 +29,11 @@ import { ownStepsInBridgeOnly, routingOf } from "./routing.js";
  * person routed there, even while a page is in focus; nothing wakes for those
  * (gateway scopes 9.5 step 5). It is asked at every wake, fresh deliveries
  * or none, so what it left unfinished is finished, and while anything is
- * left the wake counts as failed, so it is tried again.
+ * left the wake counts as failed, so it is tried again. The person's
+ * preferences are read anew at every wake too: a quiet ship's deliveries
+ * wake nobody and wait unhanded, and during quiet hours no wake goes out;
+ * the wake is held back until they end or a channel's window passes,
+ * whichever comes first, so turning them off applies by the next window.
  */
 export function createWakePerson(deps) {
     /** Channels that refused for good during an attempt still failing, by person ship: a retry of that attempt does not ask them again. */
@@ -87,7 +93,11 @@ export function createWakePerson(deps) {
             const refused = await handEach(allFresh, "page");
             return refused === undefined ? ok({ kind: "settled" }) : err(refused);
         }
-        const showsOf = (channel) => (delivery) => routing.isShowing(channel.name, delivery);
+        const senderShipIds = [...new Set(allFresh.map(({ senderShipId }) => senderShipId))];
+        const [quietShips, quietHours] = await Promise.all([deps.quietShips.among(ship, senderShipIds), deps.quietHours.find(ship)]);
+        // A quiet ship wakes nobody: what it sent waits unhanded.
+        const wakeRouting = withQuietShips(routing, quietShips);
+        const showsOf = (channel) => (delivery) => wakeRouting.isShowing(channel.name, delivery);
         const turnedOn = (await Promise.all(deps.channels.map(async (channel) => allFresh.some(showsOf(channel)) && (await channel.isOn(ship)) ? [channel] : []))).flat();
         if (turnedOn.length === 0) {
             return ok({ kind: "settled" });
@@ -120,6 +130,12 @@ export function createWakePerson(deps) {
         if (fresh.length === 0) {
             return ok({ kind: "settled" });
         }
+        const quiet = quietHours === undefined ? undefined : quietSpellAt(quietHours, now);
+        if (quiet !== undefined) {
+            // Looked at again once a window passes, so quiet hours turned off meanwhile wake by then.
+            const nextWindowMs = Math.min(...turnedOn.filter((channel) => fresh.some(showsOf(channel))).map(({ windowMs }) => windowMs));
+            return ok({ kind: "inWindow", until: new Date(Math.min(quiet.until.getTime(), now.getTime() + nextWindowMs)) });
+        }
         const refusedBefore = refusedInAttempt.get(attemptKey(ship)) ?? new Set();
         /** The channels still asked that show any of these deliveries, with their windows. */
         const askedFor = (deliveries) => windows.filter(({ channel }) => !refusedBefore.has(channel.name) && deliveries.some(showsOf(channel)));