@aeolus-fleet/gateway 0.35.0 → 0.36.0

package/dist/core/people/remove-from-basket.js

@@ -0,0 +1,52 @@
+import { refuse } from '../shared/errors.js';
+import { ok } from '../shared/result.js';
+import { handledOf } from './opened-of.js';
+import { standingBasketOf } from './read-basket.js';
+import { takeOutUnsent } from './send-basket.js';
+/**
+ * Use case: the person removes an entry from the basket (section 9). One
+ * waiting leaves it, and its question still waits on them. One the fleet
+ * refused leaves it and its question is done, as not sent; kept while the
+ * fleet does not take that, so they can remove it again. One whose question
+ * its asker withdrew or replaced leaves it, and the question is done as
+ * such; one answered elsewhere just leaves. One being sent goes as stored.
+ */
+export function createRemoveFromBasket(deps) {
+    return async ({ caller, questionId }) => {
+        const basket = await standingBasketOf(deps, caller);
+        if (!basket.isOk) {
+            return basket;
+        }
+        const found = basket.value.entries.find(({ entry }) => entry.questionId === questionId);
+        if (found === undefined) {
+            return refuse('NOT_IN_BASKET', 'That answer is not in your basket: read it again');
+        }
+        const { entry, standing } = found;
+        switch (standing.kind) {
+            case 'sending':
+                return refuse('CONFLICT', 'This answer is being sent: it goes as it was put in the basket');
+            case 'refused': {
+                const question = basket.value.opened.find(({ deliveryId }) => deliveryId === entry.deliveryId);
+                if (question !== undefined) {
+                    const handled = await handledOf(deps, { caller, delivery: question, as: { place: 'bridge', kind: 'notSent', option: entry.option } });
+                    if (!handled.isOk) {
+                        return handled;
+                    }
+                }
+                await deps.entries.remove(entry.fleetId, { shipId: entry.shipId, questionId });
+                break;
+            }
+            case 'waiting':
+                await deps.entries.remove(entry.fleetId, { shipId: entry.shipId, questionId });
+                break;
+            case 'withdrawn':
+            case 'replaced':
+            case 'dealtElsewhere':
+                await takeOutUnsent(deps, { caller, basket: basket.value, entry, standing });
+                break;
+        }
+        await deps.changes.tell({ fleetId: caller.fleetId, shipId: basket.value.crew.shipId });
+        return ok({ questionId });
+    };
+}
+//# sourceMappingURL=remove-from-basket.js.map

package/dist/core/people/remove-from-basket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-from-basket.js","sourceRoot":"","sources":["../../../src/core/people/remove-from-basket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAkC,MAAM,gBAAgB,CAAC;AAE3E,OAAO,EAAE,gBAAgB,EAAmB,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAIjD;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAA2B;IAChE,OAAO,KAAK,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE;QACtC,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;QACxF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,MAAM,CAAC,eAAe,EAAE,kDAAkD,CAAC,CAAC;QACrF,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;QAClC,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;YACtB,KAAK,SAAS;gBACZ,OAAO,MAAM,CAAC,UAAU,EAAE,gEAAgE,CAAC,CAAC;YAC9F,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC/F,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;oBAC3B,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;oBACtI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;wBAClB,OAAO,OAAO,CAAC;oBACjB,CAAC;gBACH,CAAC;gBACD,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;gBAC/E,MAAM;YACR,CAAC;YACD,KAAK,SAAS;gBACZ,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;gBAC/E,MAAM;YACR,KAAK,WAAW,CAAC;YACjB,KAAK,UAAU,CAAC;YAChB,KAAK,gBAAgB;gBACnB,MAAM,aAAa,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAC7E,MAAM;QACV,CAAC;QACD,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACvF,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IAC5B,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/people/routing.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Routing per job (docs/design/bridge, section 8): per fleet, person ship,
+ * job and place, whether the place shows the job's items besides Bridge,
+ * which always does. The person's own choice counts over the default from
+ * the gateway's configuration (CC5, CC19). A pull place, a chat, is a view:
+ * turned on, it shows every item of the job. A push place, Slack or a wake,
+ * shows only what arrives after it was turned on for the job (CC20).
+ */
+import type { FleetId, ShipId } from '@aeolus-fleet/common';
+import { type ItemJob } from './item-job.js';
+import type { PersonShip } from './ports.js';
+/** The places a person routes a job to besides Bridge (CC5). */
+export type RoutingPlace = 'slack' | 'chat' | 'web-push' | 'email';
+export declare const ITEM_JOBS: readonly ItemJob[];
+export declare const ROUTING_PLACES: readonly RoutingPlace[];
+/** A person's own choice for one job and place, with when they made it. */
+export interface Route {
+    readonly fleetId: FleetId;
+    readonly shipId: ShipId;
+    readonly job: ItemJob;
+    readonly place: RoutingPlace;
+    readonly isOn: boolean;
+    readonly changedAt: Date;
+}
+/** The jobs and places on while a person made no choice of their own, from the gateway's configuration (CC19). */
+export interface RoutingDefaults {
+    readonly onByDefault: ReadonlySet<string>;
+}
+/** Outbound port: each person's own choices, by fleet and person ship. */
+export interface Routes {
+    list(ship: PersonShip): Promise<Route[]>;
+    /** Keeps it, or keeps it anew for its job and place. */
+    save(route: Route): Promise<void>;
+}
+/** Where a person's items show, by job and place. */
+export interface Routing {
+    isOn(job: ItemJob, place: RoutingPlace): boolean;
+    /** Whether the place shows the item: its job on there, and for a push place sent since it was turned on. */
+    isShowing(place: RoutingPlace, item: {
+        readonly contentType: string;
+        readonly sentAt: Date;
+    }): boolean;
+}
+/** Whether the place only shows what the person asks it for, so it costs nothing to show what is already there (CC20). */
+export declare function isPullPlace(place: RoutingPlace): boolean;
+export declare function routingDefaultsOf(onByDefault: readonly {
+    readonly job: ItemJob;
+    readonly place: RoutingPlace;
+}[]): RoutingDefaults;
+export declare function routingOf(routes: readonly Route[], defaults: RoutingDefaults): Routing;

package/dist/core/people/routing.js

@@ -0,0 +1,35 @@
+import { jobOf } from './item-job.js';
+export const ITEM_JOBS = ['decide', 'do', 'stay-aware', 'everything-else'];
+export const ROUTING_PLACES = ['slack', 'chat', 'web-push', 'email'];
+const keyOf = (job, place) => `${job}:${place}`;
+/** Whether the place only shows what the person asks it for, so it costs nothing to show what is already there (CC20). */
+export function isPullPlace(place) {
+    switch (place) {
+        case 'chat':
+            return true;
+        case 'slack':
+        case 'web-push':
+        case 'email':
+            return false;
+    }
+}
+export function routingDefaultsOf(onByDefault) {
+    return { onByDefault: new Set(onByDefault.map(({ job, place }) => keyOf(job, place))) };
+}
+export function routingOf(routes, defaults) {
+    const own = new Map(routes.map((route) => [keyOf(route.job, route.place), route]));
+    const isOn = (job, place) => own.get(keyOf(job, place))?.isOn ?? defaults.onByDefault.has(keyOf(job, place));
+    return {
+        isOn,
+        isShowing: (place, { contentType, sentAt }) => {
+            const job = jobOf(contentType);
+            if (!isOn(job, place)) {
+                return false;
+            }
+            // On by default, a place was never turned on later: it shows everything.
+            const turnedOnAt = own.get(keyOf(job, place))?.changedAt;
+            return isPullPlace(place) || turnedOnAt === undefined || sentAt.getTime() >= turnedOnAt.getTime();
+        },
+    };
+}
+//# sourceMappingURL=routing.js.map

package/dist/core/people/routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.js","sourceRoot":"","sources":["../../../src/core/people/routing.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,EAAgB,MAAM,eAAe,CAAC;AAMpD,MAAM,CAAC,MAAM,SAAS,GAAuB,CAAC,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC;AAC/F,MAAM,CAAC,MAAM,cAAc,GAA4B,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;AA+B9F,MAAM,KAAK,GAAG,CAAC,GAAY,EAAE,KAAmB,EAAU,EAAE,CAAC,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;AAE/E,0HAA0H;AAC1H,MAAM,UAAU,WAAW,CAAC,KAAmB;IAC7C,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,MAAM;YACT,OAAO,IAAI,CAAC;QACd,KAAK,OAAO,CAAC;QACb,KAAK,UAAU,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,WAA+E;IAC/G,OAAO,EAAE,WAAW,EAAE,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAwB,EAAE,QAAyB;IAC3E,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACnF,MAAM,IAAI,GAAG,CAAC,GAAY,EAAE,KAAmB,EAAW,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,EAAE,IAAI,IAAI,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;IAC7I,OAAO;QACL,IAAI;QACJ,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE;YAC5C,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,KAAK,CAAC;YACf,CAAC;YACD,yEAAyE;YACzE,MAAM,UAAU,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC;YACzD,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,UAAU,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,EAAE,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;QACpG,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/core/people/send-basket.d.ts

@@ -0,0 +1,40 @@
+import { type Result } from '../shared/result.js';
+import type { BasketEntry, BasketStanding } from './basket.js';
+import type { DealDeps } from './opened-of.js';
+import type { PersonCaller, PersonCrewError } from './person-crew.js';
+import { type BasketDeps, type StandingBasket } from './read-basket.js';
+/** An entry Send skipped and took out: its question withdrawn or replaced by its asker, or dealt with elsewhere first. */
+export interface Skipped {
+    readonly questionId: string;
+    readonly title: string;
+    readonly kind: 'withdrawn' | 'replaced' | 'dealtElsewhere';
+}
+/** What Send did: how many answers are being sent, and the entries it skipped. */
+export interface BasketSent {
+    readonly sending: number;
+    readonly skipped: Skipped[];
+}
+export type SendBasket = (caller: PersonCaller) => Promise<Result<BasketSent, PersonCrewError>>;
+/**
+ * Use case: the person presses Send N answers (section 9, rule 3); no clock
+ * sends the basket. Each entry waiting is first stored as sending, then the
+ * gateway's sender is woken to send them, each on its own, so a closed page
+ * or a restart loses none. An entry whose question its asker withdrew or
+ * replaced, or that was answered elsewhere first, is not sent: Send skips it,
+ * says so, and takes it out; the question is done as a withdrawn or replaced
+ * one is (rule 5). One the fleet refused stays until removed.
+ */
+export declare function createSendBasket(deps: BasketDeps & DealDeps & {
+    sendNow: () => void;
+}): SendBasket;
+/**
+ * Takes an entry not to be sent out of the basket; a question its asker
+ * withdrew or replaced, still opened, is done as such, as when the person
+ * looks at it (section 9).
+ */
+export declare function takeOutUnsent(deps: BasketDeps & DealDeps, taken: {
+    caller: PersonCaller;
+    basket: StandingBasket;
+    entry: BasketEntry;
+    standing: BasketStanding;
+}): Promise<void>;

package/dist/core/people/send-basket.js

@@ -0,0 +1,60 @@
+import { ok } from '../shared/result.js';
+import { doneIfStale } from './open-delivery.js';
+import { standingBasketOf } from './read-basket.js';
+/**
+ * Use case: the person presses Send N answers (section 9, rule 3); no clock
+ * sends the basket. Each entry waiting is first stored as sending, then the
+ * gateway's sender is woken to send them, each on its own, so a closed page
+ * or a restart loses none. An entry whose question its asker withdrew or
+ * replaced, or that was answered elsewhere first, is not sent: Send skips it,
+ * says so, and takes it out; the question is done as a withdrawn or replaced
+ * one is (rule 5). One the fleet refused stays until removed.
+ */
+export function createSendBasket(deps) {
+    return async (caller) => {
+        const basket = await standingBasketOf(deps, caller);
+        if (!basket.isOk) {
+            return basket;
+        }
+        const skipped = [];
+        let sending = 0;
+        for (const { entry, standing } of basket.value.entries) {
+            switch (standing.kind) {
+                case 'waiting':
+                    await deps.entries.save({ ...entry, state: 'sending' });
+                    sending += 1;
+                    break;
+                case 'sending':
+                    sending += 1;
+                    break;
+                case 'refused':
+                    break;
+                case 'withdrawn':
+                case 'replaced':
+                case 'dealtElsewhere':
+                    await takeOutUnsent(deps, { caller, basket: basket.value, entry, standing });
+                    skipped.push({ questionId: entry.questionId, title: entry.title, kind: standing.kind });
+                    break;
+            }
+        }
+        if (sending > 0) {
+            deps.sendNow();
+        }
+        await deps.changes.tell({ fleetId: caller.fleetId, shipId: basket.value.crew.shipId });
+        return ok({ sending, skipped });
+    };
+}
+/**
+ * Takes an entry not to be sent out of the basket; a question its asker
+ * withdrew or replaced, still opened, is done as such, as when the person
+ * looks at it (section 9).
+ */
+export async function takeOutUnsent(deps, taken) {
+    const { caller, basket, entry, standing } = taken;
+    await deps.entries.remove(entry.fleetId, { shipId: entry.shipId, questionId: entry.questionId });
+    const looked = basket.opened.find(({ deliveryId }) => deliveryId === entry.deliveryId);
+    if (looked !== undefined && (standing.kind === 'withdrawn' || standing.kind === 'replaced')) {
+        await doneIfStale(deps, { caller, crew: basket.crew, looked, waiting: basket.waiting, place: 'bridge' });
+    }
+}
+//# sourceMappingURL=send-basket.js.map

package/dist/core/people/send-basket.js.map

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

package/dist/core/people/send-stored-answers.d.ts

@@ -0,0 +1,33 @@
+import type { Clock } from '../shared/clock.js';
+import { type BasketEntries } from './basket.js';
+import type { ItemOutcomes } from './item-outcome.js';
+import type { InboxChanges, OpenedDeliveries, PersonCrews, PersonShipDoor } from './ports.js';
+/** What a round did: answers the fleet stored, kept sending for the next round, and refused. */
+export type SendStoredAnswers = () => Promise<{
+    sent: number;
+    kept: number;
+    refused: number;
+}>;
+interface SendDeps {
+    entries: BasketEntries;
+    crews: Pick<PersonCrews, 'find'>;
+    door: Pick<PersonShipDoor, 'reply' | 'handled'>;
+    opened: OpenedDeliveries;
+    outcomes: ItemOutcomes;
+    changes: InboxChanges;
+    clock: Clock;
+}
+/**
+ * Use case: the gateway sends what the basket stores as sending (section 9,
+ * rule 3), each person ship's entries on its own, in the order added, as
+ * the person ship's crew: an answer in reply to its question, under the
+ * question's key, so however often it is sent, the fleet stores it once. Each
+ * the fleet stored is reported handled, kept answered in Bridge, and out of
+ * the basket; one the fleet did not answer stays sending for the next round;
+ * one it refused stays in the basket, not sent, saying why. A question
+ * answered elsewhere first, or handled before a stop, is sent nothing. It
+ * runs at every round and after a restart: what was stored as sending goes
+ * on with the same keys, so nothing is lost and nothing is sent twice.
+ */
+export declare function createSendStoredAnswers(deps: SendDeps): SendStoredAnswers;
+export {};

package/dist/core/people/send-stored-answers.js

@@ -0,0 +1,96 @@
+import { ANSWER_CONTENT_TYPE } from '@aeolus-fleet/common';
+import { answerKeyOf, answerOf } from './basket.js';
+import { isEndedCrew, KEY_UNAVAILABLE } from './person-crew.js';
+/** How many person ships a round reads at a time. */
+const SHIPS_PAGE = 100;
+/**
+ * The fleet's codes for a call it did not answer, or could not take now: the
+ * answer may have been stored or not, so it is sent again under its key.
+ */
+const NOT_ANSWERED = new Set(['UNAVAILABLE', 'SERVICE_UNAVAILABLE', 'INTERNAL_SERVER_ERROR', KEY_UNAVAILABLE]);
+function isNotAnswered(refusal) {
+    return NOT_ANSWERED.has(refusal.code) || isEndedCrew(refusal);
+}
+/**
+ * Use case: the gateway sends what the basket stores as sending (section 9,
+ * rule 3), each person ship's entries on its own, in the order added, as
+ * the person ship's crew: an answer in reply to its question, under the
+ * question's key, so however often it is sent, the fleet stores it once. Each
+ * the fleet stored is reported handled, kept answered in Bridge, and out of
+ * the basket; one the fleet did not answer stays sending for the next round;
+ * one it refused stays in the basket, not sent, saying why. A question
+ * answered elsewhere first, or handled before a stop, is sent nothing. It
+ * runs at every round and after a restart: what was stored as sending goes
+ * on with the same keys, so nothing is lost and nothing is sent twice.
+ */
+export function createSendStoredAnswers(deps) {
+    return async () => {
+        const counted = { sent: 0, kept: 0, refused: 0 };
+        let after = null;
+        for (;;) {
+            const ships = await deps.entries.sendingShips({ after, limit: SHIPS_PAGE });
+            for (const ship of ships) {
+                for (const sent of await sendShip(deps, ship)) {
+                    if (sent !== 'dealtElsewhere') {
+                        counted[sent] += 1;
+                    }
+                }
+            }
+            const last = ships.at(-1);
+            if (last === undefined || ships.length < SHIPS_PAGE) {
+                return counted;
+            }
+            after = last;
+        }
+    };
+}
+/** Sends one person ship's entries stored as sending, in the order added, and tells its pages when any changed. */
+async function sendShip(deps, ship) {
+    const sending = (await deps.entries.list(ship.fleetId, ship.shipId)).filter(({ state }) => state === 'sending');
+    const crew = await deps.crews.find(ship.fleetId, ship.shipId);
+    if (crew === undefined) {
+        return sending.map(() => 'kept');
+    }
+    const outcomes = await deps.outcomes.findMany(ship.fleetId, { shipId: ship.shipId, deliveryIds: sending.map(({ deliveryId }) => deliveryId) });
+    const isDealt = new Set(outcomes.map(({ deliveryId }) => deliveryId));
+    const done = [];
+    for (const entry of sending) {
+        if (isDealt.has(entry.deliveryId)) {
+            await takeOut(deps, entry);
+            done.push('dealtElsewhere');
+        }
+        else {
+            done.push(await sendEntry(deps, { crewToken: crew.crewToken, entry }));
+        }
+    }
+    if (done.some((sent) => sent !== 'kept')) {
+        await deps.changes.tell(ship);
+    }
+    return done;
+}
+/** One answer under its question's key; once stored, reported handled and out of the basket. */
+async function sendEntry(deps, sending) {
+    const { crewToken, entry } = sending;
+    const replied = await deps.door.reply(crewToken, { to: entry.senderShipId, inReplyTo: entry.messageId, contentType: ANSWER_CONTENT_TYPE, payload: JSON.stringify(answerOf(entry)), idempotencyKey: answerKeyOf(entry) });
+    if (!replied.isOk && isNotAnswered(replied.error)) {
+        return 'kept';
+    }
+    if (!replied.isOk) {
+        await deps.entries.save({ ...entry, state: 'refused', refusal: `${entry.from} did not take the answer: ${replied.error.message}` });
+        return 'refused';
+    }
+    const handled = await deps.door.handled(crewToken, entry.deliveryId);
+    // Not answered, it is sent again under its key and reported handled at the next round; refused for good, the answer is stored all the same.
+    if (!handled.isOk && isNotAnswered(handled.error)) {
+        return 'kept';
+    }
+    await deps.outcomes.save({ fleetId: entry.fleetId, shipId: entry.shipId, deliveryId: entry.deliveryId, place: 'bridge', kind: 'answered', option: entry.option, at: deps.clock.now() });
+    await takeOut(deps, entry);
+    return 'sent';
+}
+/** Takes an entry out of the basket with the opened question it answers, which nothing waits on any more. */
+async function takeOut(deps, entry) {
+    await deps.opened.remove(entry.fleetId, { shipId: entry.shipId, deliveryId: entry.deliveryId });
+    await deps.entries.remove(entry.fleetId, { shipId: entry.shipId, questionId: entry.questionId });
+}
+//# sourceMappingURL=send-stored-answers.js.map

package/dist/core/people/send-stored-answers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-stored-answers.js","sourceRoot":"","sources":["../../../src/core/people/send-stored-answers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAA6B,MAAM,sBAAsB,CAAC;AAItF,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAwC,MAAM,aAAa,CAAC;AAE1F,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAMhE,qDAAqD;AACrD,MAAM,UAAU,GAAG,GAAG,CAAC;AAEvB;;;GAGG;AACH,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,aAAa,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,eAAe,CAAC,CAAC,CAAC;AAE/G,SAAS,aAAa,CAAC,OAAqB;IAC1C,OAAO,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;AAChE,CAAC;AAcD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAc;IACpD,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QACjD,IAAI,KAAK,GAAgD,IAAI,CAAC;QAC9D,SAAS,CAAC;YACR,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;YAC5E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,KAAK,MAAM,IAAI,IAAI,MAAM,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;oBAC9C,IAAI,IAAI,KAAK,gBAAgB,EAAE,CAAC;wBAC9B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACrB,CAAC;gBACH,CAAC;YACH,CAAC;YACD,MAAM,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;gBACpD,OAAO,OAAO,CAAC;YACjB,CAAC;YACD,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,mHAAmH;AACnH,KAAK,UAAU,QAAQ,CAAC,IAAc,EAAE,IAA0C;IAChF,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;IAChH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9D,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAC/I,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAW,EAAE,CAAC;IACxB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;YAClC,MAAM,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,MAAM,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gGAAgG;AAChG,KAAK,UAAU,SAAS,CAAC,IAAc,EAAE,OAAkD;IACzF,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IACrC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,YAAY,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,WAAW,EAAE,mBAAmB,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzN,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,IAAI,6BAA6B,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACpI,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACrE,4IAA4I;IAC5I,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACxL,MAAM,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC3B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,6GAA6G;AAC7G,KAAK,UAAU,OAAO,CAAC,IAAc,EAAE,KAAkB;IACvD,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IAChG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;AACnG,CAAC"}

package/dist/core/people/stale-question.d.ts

@@ -0,0 +1,28 @@
+/**
+ * A question its asker withdrew or replaced (decision 0038; Bridge,
+ * section 9): stale, no longer answerable, out of the count. A withdrawal
+ * or a replacement names the question by its uuid, and only from the ship
+ * that asked it. A replacement asks a new question: it is a new item, and
+ * the replaced question links to it.
+ */
+import type { DeliveryId, ShipId } from '@aeolus-fleet/common';
+export interface Stale {
+    readonly kind: 'withdrawn' | 'replaced';
+    /** The delivery of the replacement, a new item; none for a withdrawn question. */
+    readonly replacementId: DeliveryId | null;
+}
+/** What a delivery to the person ship asks and withdraws, by question uuid, and who sent it. */
+export interface Asking {
+    readonly deliveryId: DeliveryId;
+    readonly senderShipId: ShipId;
+    readonly askedQuestionId: string | null;
+    readonly withdrawnQuestionId: string | null;
+}
+/** The delivery that withdraws or replaces the question this one asks, among these; none while it is open. */
+export declare function withdrawerOf(question: Asking, among: readonly Asking[]): Asking | undefined;
+/** Whether the question this one asks is withdrawn or replaced by one of these, and by which replacement. */
+export declare function staleOf(question: Asking, among: readonly Asking[]): Stale | null;
+/** How a question is stale by the delivery that withdraws or replaces it. */
+export declare function staleBy(withdrawer: Asking): Stale;
+/** The question a replacement replaces, among these, from the same asker; none for any other delivery. */
+export declare function replacedBy(replacement: Asking, among: readonly Asking[]): Asking | undefined;

package/dist/core/people/stale-question.js

@@ -0,0 +1,26 @@
+/** The delivery that withdraws or replaces the question this one asks, among these; none while it is open. */
+export function withdrawerOf(question, among) {
+    const asked = question.askedQuestionId;
+    if (asked === null) {
+        return undefined;
+    }
+    return among.find(({ deliveryId, senderShipId, withdrawnQuestionId }) => deliveryId !== question.deliveryId && senderShipId === question.senderShipId && withdrawnQuestionId === asked);
+}
+/** Whether the question this one asks is withdrawn or replaced by one of these, and by which replacement. */
+export function staleOf(question, among) {
+    const withdrawer = withdrawerOf(question, among);
+    return withdrawer === undefined ? null : staleBy(withdrawer);
+}
+/** How a question is stale by the delivery that withdraws or replaces it. */
+export function staleBy(withdrawer) {
+    return withdrawer.askedQuestionId === null ? { kind: 'withdrawn', replacementId: null } : { kind: 'replaced', replacementId: withdrawer.deliveryId };
+}
+/** The question a replacement replaces, among these, from the same asker; none for any other delivery. */
+export function replacedBy(replacement, among) {
+    const { askedQuestionId, withdrawnQuestionId } = replacement;
+    if (askedQuestionId === null || withdrawnQuestionId === null) {
+        return undefined;
+    }
+    return among.find(({ deliveryId, senderShipId, askedQuestionId: asked }) => deliveryId !== replacement.deliveryId && senderShipId === replacement.senderShipId && asked === withdrawnQuestionId);
+}
+//# sourceMappingURL=stale-question.js.map

package/dist/core/people/stale-question.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale-question.js","sourceRoot":"","sources":["../../../src/core/people/stale-question.ts"],"names":[],"mappings":"AAuBA,8GAA8G;AAC9G,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,KAAwB;IACrE,MAAM,KAAK,GAAG,QAAQ,CAAC,eAAe,CAAC;IACvC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,mBAAmB,EAAE,EAAE,EAAE,CAAC,UAAU,KAAK,QAAQ,CAAC,UAAU,IAAI,YAAY,KAAK,QAAQ,CAAC,YAAY,IAAI,mBAAmB,KAAK,KAAK,CAAC,CAAC;AAC1L,CAAC;AAED,6GAA6G;AAC7G,MAAM,UAAU,OAAO,CAAC,QAAgB,EAAE,KAAwB;IAChE,MAAM,UAAU,GAAG,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACjD,OAAO,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAC/D,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,OAAO,CAAC,UAAkB;IACxC,OAAO,UAAU,CAAC,eAAe,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,CAAC,UAAU,EAAE,CAAC;AACvJ,CAAC;AAED,0GAA0G;AAC1G,MAAM,UAAU,UAAU,CAAC,WAAmB,EAAE,KAAwB;IACtE,MAAM,EAAE,eAAe,EAAE,mBAAmB,EAAE,GAAG,WAAW,CAAC;IAC7D,IAAI,eAAe,KAAK,IAAI,IAAI,mBAAmB,KAAK,IAAI,EAAE,CAAC;QAC7D,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,UAAU,KAAK,WAAW,CAAC,UAAU,IAAI,YAAY,KAAK,WAAW,CAAC,YAAY,IAAI,KAAK,KAAK,mBAAmB,CAAC,CAAC;AACnM,CAAC"}

package/dist/core/people/step-outcome.d.ts

@@ -0,0 +1,18 @@
+/**
+ * A step outcome (Bridge, CC14): how a step the person was asked ended,
+ * done or cannot, with their note if they wrote one, sent to its asker in
+ * reply to the step. Its content type and payload are common's
+ * stepOutcomeSchema in its release after 0.35.0 (Bridge B2); they move to
+ * common's then.
+ */
+export declare const STEP_OUTCOME_CONTENT_TYPE = "application/vnd.aeolus.step-outcome+json";
+/** How a step ended: the person did it, or cannot. */
+export type StepOutcomeKind = 'done' | 'cannot';
+/** A note with text, trimmed; none for one empty or of spaces only, so the outcome goes without one. */
+export declare function noteOf(note: string | undefined): string | null;
+/** The step outcome's payload: the step's uuid, the outcome, and the note only when there is one. */
+export declare function stepOutcomePayloadOf(outcome: {
+    stepId: string;
+    kind: StepOutcomeKind;
+    note: string | null;
+}): string;

package/dist/core/people/step-outcome.js

@@ -0,0 +1,18 @@
+/**
+ * A step outcome (Bridge, CC14): how a step the person was asked ended,
+ * done or cannot, with their note if they wrote one, sent to its asker in
+ * reply to the step. Its content type and payload are common's
+ * stepOutcomeSchema in its release after 0.35.0 (Bridge B2); they move to
+ * common's then.
+ */
+export const STEP_OUTCOME_CONTENT_TYPE = 'application/vnd.aeolus.step-outcome+json';
+/** A note with text, trimmed; none for one empty or of spaces only, so the outcome goes without one. */
+export function noteOf(note) {
+    const trimmed = note?.trim() ?? '';
+    return trimmed === '' ? null : trimmed;
+}
+/** The step outcome's payload: the step's uuid, the outcome, and the note only when there is one. */
+export function stepOutcomePayloadOf(outcome) {
+    return JSON.stringify(outcome.note === null ? { stepId: outcome.stepId, outcome: outcome.kind } : { stepId: outcome.stepId, outcome: outcome.kind, note: outcome.note });
+}
+//# sourceMappingURL=step-outcome.js.map

package/dist/core/people/step-outcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-outcome.js","sourceRoot":"","sources":["../../../src/core/people/step-outcome.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,0CAA0C,CAAC;AAKpF,wGAAwG;AACxG,MAAM,UAAU,MAAM,CAAC,IAAwB;IAC7C,MAAM,OAAO,GAAG,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACnC,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;AACzC,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,oBAAoB,CAAC,OAAuE;IAC1G,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AAC3K,CAAC"}

package/dist/core/people/turn-route.d.ts

@@ -0,0 +1,34 @@
+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 { ItemJob } from './item-job.js';
+import { type PersonCaller, type PersonCrewError } from './person-crew.js';
+import { type RoutingDefaults, type RoutingPlace, type Routes } from './routing.js';
+export type TurnRoute = (turn: {
+    caller: PersonCaller;
+    job: ItemJob;
+    place: RoutingPlace;
+    isOn: boolean;
+}) => Promise<Result<undefined, PersonCrewError | DomainError<'CHANNEL_NOT_OFFERED'>>>;
+/** Whether the gateway can show anything in the place: email where it asks pagasae to send it, web push where it holds push keys. */
+export declare function isOfferedPlace(place: RoutingPlace, offered: {
+    isEmailOffered: boolean;
+    isWebPushOffered: boolean;
+}): boolean;
+/**
+ * Use case: a person turns a place on or off for a job (Bridge, section 8),
+ * kept by fleet, person ship, job and place; it applies at once, as the
+ * waiter and the chat read it anew each time. A place already as asked is
+ * kept as it is, so a push place turned on keeps showing what arrived since
+ * then (CC20). Turning a place on is refused where the gateway cannot show
+ * anything there.
+ */
+export declare function createTurnRoute(deps: {
+    crewPersonShip: CrewPersonShip;
+    routes: Routes;
+    defaults: RoutingDefaults;
+    isEmailOffered: boolean;
+    isWebPushOffered: boolean;
+    clock: Clock;
+}): TurnRoute;

package/dist/core/people/turn-route.js

@@ -0,0 +1,42 @@
+import { refuse } from '../shared/errors.js';
+import { ok } from '../shared/result.js';
+import { personCrewOf } from './person-crew.js';
+import { routingOf } from './routing.js';
+/** Whether the gateway can show anything in the place: email where it asks pagasae to send it, web push where it holds push keys. */
+export function isOfferedPlace(place, offered) {
+    switch (place) {
+        case 'email':
+            return offered.isEmailOffered;
+        case 'web-push':
+            return offered.isWebPushOffered;
+        case 'slack':
+        case 'chat':
+            return true;
+    }
+}
+/**
+ * Use case: a person turns a place on or off for a job (Bridge, section 8),
+ * kept by fleet, person ship, job and place; it applies at once, as the
+ * waiter and the chat read it anew each time. A place already as asked is
+ * kept as it is, so a push place turned on keeps showing what arrived since
+ * then (CC20). Turning a place on is refused where the gateway cannot show
+ * anything there.
+ */
+export function createTurnRoute(deps) {
+    return async ({ caller, job, place, isOn }) => {
+        if (isOn && !isOfferedPlace(place, deps)) {
+            return refuse('CHANNEL_NOT_OFFERED', place === 'email' ? 'This gateway sends no email' : 'This gateway sends no web push');
+        }
+        const crew = await personCrewOf(deps.crewPersonShip, caller);
+        if (!crew.isOk) {
+            return crew;
+        }
+        const ship = { fleetId: caller.fleetId, shipId: crew.value.shipId };
+        if (routingOf(await deps.routes.list(ship), deps.defaults).isOn(job, place) === isOn) {
+            return ok(undefined);
+        }
+        await deps.routes.save({ ...ship, job, place, isOn, changedAt: deps.clock.now() });
+        return ok(undefined);
+    };
+}
+//# sourceMappingURL=turn-route.js.map

package/dist/core/people/turn-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-route.js","sourceRoot":"","sources":["../../../src/core/people/turn-route.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EAAE,YAAY,EAA2C,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,SAAS,EAAwD,MAAM,cAAc,CAAC;AAI/F,qIAAqI;AACrI,MAAM,UAAU,cAAc,CAAC,KAAmB,EAAE,OAA+D;IACjH,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,OAAO;YACV,OAAO,OAAO,CAAC,cAAc,CAAC;QAChC,KAAK,UAAU;YACb,OAAO,OAAO,CAAC,gBAAgB,CAAC;QAClC,KAAK,OAAO,CAAC;QACb,KAAK,MAAM;YACT,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,IAAqJ;IACnL,OAAO,KAAK,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE;QAC5C,IAAI,IAAI,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;YACzC,OAAO,MAAM,CAAC,qBAAqB,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,gCAAgC,CAAC,CAAC;QAC7H,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,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACpE,IAAI,SAAS,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;YACrF,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;QACvB,CAAC;QACD,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACnF,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC,CAAC;AACJ,CAAC"}