@aeolus-fleet/core 0.0.0 → 0.18.0

package/dist/domain/shared/read-needs-attention.d.ts

@@ -0,0 +1,12 @@
+import type { Caller } from './caller.js';
+import type { ShipHistory, UndeliverableEntry } from './history.js';
+export type ReadNeedsAttention = (caller: Caller) => Promise<UndeliverableEntry[]>;
+/**
+ * Use case: Needs attention, every undeliverable delivery of the caller's
+ * fleet, oldest first, each with its whole message, for the operator to
+ * resend or dismiss. Abandoned deliveries are never listed: they stay in the
+ * timelines only. The caller's scope (fleet:read) is checked before this runs.
+ */
+export declare function createReadNeedsAttention(deps: {
+    history: ShipHistory;
+}): ReadNeedsAttention;

package/dist/domain/shared/read-needs-attention.js

@@ -0,0 +1,10 @@
+/**
+ * Use case: Needs attention, every undeliverable delivery of the caller's
+ * fleet, oldest first, each with its whole message, for the operator to
+ * resend or dismiss. Abandoned deliveries are never listed: they stay in the
+ * timelines only. The caller's scope (fleet:read) is checked before this runs.
+ */
+export function createReadNeedsAttention(deps) {
+    return (caller) => deps.history.undeliverable(caller.fleetId);
+}
+//# sourceMappingURL=read-needs-attention.js.map

package/dist/domain/shared/read-needs-attention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-needs-attention.js","sourceRoot":"","sources":["../../../src/domain/shared/read-needs-attention.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAA8B;IACrE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAChE,CAAC"}

package/dist/domain/shared/read-ship-messages.d.ts

@@ -0,0 +1,28 @@
+import type { ShipId } from '@aeolus-fleet/common';
+import type { Caller } from './caller.js';
+import { type DomainError } from './errors.js';
+import type { HistoryMessage, ShipHistory } from './history.js';
+import { type Result } from './result.js';
+/** The most messages the ship page lists: the newest ones. */
+export declare const MESSAGES_LIMIT = 200;
+/** How much of a payload the list shows. */
+export declare const PREVIEW_LENGTH = 120;
+/** A message as the ship page lists it: its payload cut to a preview. */
+export type ListedMessage = Omit<HistoryMessage, 'payload' | 'delivery'> & {
+    preview: string;
+    delivery: Omit<HistoryMessage['delivery'], 'attempts'>;
+};
+export type ReadShipMessages = (caller: Caller, input: {
+    shipId: ShipId;
+}) => Promise<Result<ListedMessage[], DomainError<'SHIP_NOT_FOUND'>>>;
+/** The start of a payload on one line: whitespace runs become one space. */
+export declare function previewOf(payload: string): string;
+/**
+ * Use case: the messages a ship sent, was sent, or claimed as a ship of their
+ * type, newest first, each with its delivery as it stands. A message to a type
+ * shows on the page of each ship that claimed it, never on every ship of the
+ * type. The caller's scope (fleet:read) is checked before this runs.
+ */
+export declare function createReadShipMessages(deps: {
+    history: ShipHistory;
+}): ReadShipMessages;

package/dist/domain/shared/read-ship-messages.js

@@ -0,0 +1,30 @@
+import { refuse } from './errors.js';
+import { ok } from './result.js';
+/** The most messages the ship page lists: the newest ones. */
+export const MESSAGES_LIMIT = 200;
+/** How much of a payload the list shows. */
+export const PREVIEW_LENGTH = 120;
+/** The start of a payload on one line: whitespace runs become one space. */
+export function previewOf(payload) {
+    return payload.replace(/\s+/g, ' ').trim().slice(0, PREVIEW_LENGTH);
+}
+/**
+ * Use case: the messages a ship sent, was sent, or claimed as a ship of their
+ * type, newest first, each with its delivery as it stands. A message to a type
+ * shows on the page of each ship that claimed it, never on every ship of the
+ * type. The caller's scope (fleet:read) is checked before this runs.
+ */
+export function createReadShipMessages(deps) {
+    return async (caller, { shipId }) => {
+        const messages = await deps.history.messages(caller.fleetId, { shipId, limit: MESSAGES_LIMIT });
+        if (!messages) {
+            return refuse('SHIP_NOT_FOUND', `No ship ${shipId} in this fleet`);
+        }
+        return ok(messages.map(({ payload, delivery, ...message }) => ({
+            ...message,
+            preview: previewOf(payload),
+            delivery: { id: delivery.id, state: delivery.state, claimedBy: delivery.claimedBy },
+        })));
+    };
+}
+//# sourceMappingURL=read-ship-messages.js.map

package/dist/domain/shared/read-ship-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-ship-messages.js","sourceRoot":"","sources":["../../../src/domain/shared/read-ship-messages.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAoB,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,EAAE,EAAe,MAAM,aAAa,CAAC;AAE9C,8DAA8D;AAC9D,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAElC,4CAA4C;AAC5C,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAalC,4EAA4E;AAC5E,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;AACtE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAA8B;IACnE,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAClC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;QAChG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,MAAM,CAAC,gBAAgB,EAAE,WAAW,MAAM,gBAAgB,CAAC,CAAC;QACrE,CAAC;QACD,OAAO,EAAE,CACP,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;YACnD,GAAG,OAAO;YACV,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC;YAC3B,QAAQ,EAAE,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE;SACpF,CAAC,CAAC,CACJ,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/domain/shared/read-ship-timeline.d.ts

@@ -0,0 +1,18 @@
+import type { ShipId } from '@aeolus-fleet/common';
+import type { Caller } from './caller.js';
+import { type DomainError } from './errors.js';
+import type { ShipHistory, TimelineEntry } from './history.js';
+import { type Result } from './result.js';
+/** The most events a timeline shows: the newest ones. */
+export declare const TIMELINE_LIMIT = 200;
+export type ReadShipTimeline = (caller: Caller, input: {
+    shipId: ShipId;
+}) => Promise<Result<TimelineEntry[], DomainError<'SHIP_NOT_FOUND'>>>;
+/**
+ * Use case: every change to a ship, newest first: the events naming it and
+ * the ones it caused, such as the messages it sent. The caller's scope
+ * (fleet:read) is checked before this runs.
+ */
+export declare function createReadShipTimeline(deps: {
+    history: ShipHistory;
+}): ReadShipTimeline;

package/dist/domain/shared/read-ship-timeline.js

@@ -0,0 +1,16 @@
+import { refuse } from './errors.js';
+import { ok } from './result.js';
+/** The most events a timeline shows: the newest ones. */
+export const TIMELINE_LIMIT = 200;
+/**
+ * Use case: every change to a ship, newest first: the events naming it and
+ * the ones it caused, such as the messages it sent. The caller's scope
+ * (fleet:read) is checked before this runs.
+ */
+export function createReadShipTimeline(deps) {
+    return async (caller, { shipId }) => {
+        const timeline = await deps.history.timeline(caller.fleetId, { shipId, limit: TIMELINE_LIMIT });
+        return timeline ? ok(timeline) : refuse('SHIP_NOT_FOUND', `No ship ${shipId} in this fleet`);
+    };
+}
+//# sourceMappingURL=read-ship-timeline.js.map

package/dist/domain/shared/read-ship-timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-ship-timeline.js","sourceRoot":"","sources":["../../../src/domain/shared/read-ship-timeline.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAoB,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,EAAE,EAAe,MAAM,aAAa,CAAC;AAE9C,yDAAyD;AACzD,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAOlC;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAA8B;IACnE,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAClC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;QAChG,OAAO,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,EAAE,WAAW,MAAM,gBAAgB,CAAC,CAAC;IAC/F,CAAC,CAAC;AACJ,CAAC"}

package/dist/domain/shared/result.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The outcome of a domain operation: its value, or why the domain refused.
+ * The core never throws; only adapters throw, for system failures such as a
+ * lost database connection.
+ */
+export type Result<T, E> = Ok<T> | Err<E>;
+export interface Ok<T> {
+    readonly isOk: true;
+    readonly value: T;
+}
+export interface Err<E> {
+    readonly isOk: false;
+    readonly error: E;
+}
+export declare function ok<T>(value: T): Ok<T>;
+export declare function err<E>(error: E): Err<E>;

package/dist/domain/shared/result.js

@@ -0,0 +1,7 @@
+export function ok(value) {
+    return { isOk: true, value };
+}
+export function err(error) {
+    return { isOk: false, error };
+}
+//# sourceMappingURL=result.js.map

package/dist/domain/shared/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../../src/domain/shared/result.ts"],"names":[],"mappings":"AAiBA,MAAM,UAAU,EAAE,CAAI,KAAQ;IAC5B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,GAAG,CAAI,KAAQ;IAC7B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAChC,CAAC"}

package/dist/domain/shared/secrets.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Outbound port: hashes ship secrets, crew tokens and console session tokens
+ * (SHA-256). Only hashes are stored; the same input always gives the same
+ * hash, so a secret or a token is found by its hash.
+ */
+export interface SecretHasher {
+    hash(value: string): string;
+}
+/** Outbound port: unguessable random strings (256 bits, URL safe) for secrets, crew tokens and session tokens. */
+export interface RandomTokens {
+    next(): string;
+}
+/**
+ * Outbound port: hashes the operator password (Argon2id). Each hash has its
+ * own random salt, so a password is checked with `verify`, never found by its
+ * hash.
+ */
+export interface PasswordHasher {
+    hash(password: string): Promise<string>;
+    /**
+     * True when the password is the one the hash was made from. Without a hash
+     * it takes as long and is false, so a wrong email costs as much time as a
+     * wrong password and gives nothing away.
+     */
+    verify(password: string, passwordHash: string | undefined): Promise<boolean>;
+}

package/dist/domain/shared/secrets.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=secrets.js.map

package/dist/domain/shared/secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../../../src/domain/shared/secrets.ts"],"names":[],"mappings":""}

package/dist/domain/shared/selector.d.ts

@@ -0,0 +1,29 @@
+import type { ShipId } from '@aeolus-fleet/common';
+/**
+ * Who a message is for, as its sender addressed it (docs/blueprint.md,
+ * "Selector"): one ship, by id or by name, or any ship of a type. Group and
+ * fleet come later.
+ */
+export type Selector = {
+    kind: 'ship';
+    shipId: ShipId;
+} | {
+    kind: 'ship';
+    name: string;
+} | {
+    kind: 'type';
+    type: string;
+};
+/**
+ * Who a selector resolves to at send time: one ship by its id, never its
+ * name, so a rename or a reused name never redirects a sent message; or the
+ * queue of a type, which the first ship of that type to receive the delivery
+ * claims. A message keeps it as its selector; its delivery goes to it.
+ */
+export type Recipient = {
+    kind: 'ship';
+    shipId: ShipId;
+} | {
+    kind: 'type';
+    type: string;
+};

package/dist/domain/shared/selector.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=selector.js.map

package/dist/domain/shared/selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector.js","sourceRoot":"","sources":["../../../src/domain/shared/selector.ts"],"names":[],"mappings":""}

package/dist/domain/shared/unit-of-work.d.ts

@@ -0,0 +1,13 @@
+import type { Result } from './result.js';
+/**
+ * Outbound port: runs a use case in one database transaction. Everything the
+ * work writes through `tx`, events included, commits together or not at all:
+ * it commits when the work returns an ok result, and rolls back when the work
+ * returns a refusal or throws.
+ *
+ * Each use case names the ports it needs as its own `Tx` type, so it sees only
+ * those. The adapter hands every use case one object that holds them all.
+ */
+export interface UnitOfWork<Tx> {
+    run<T, E>(work: (tx: Tx) => Promise<Result<T, E>>): Promise<Result<T, E>>;
+}

package/dist/domain/shared/unit-of-work.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=unit-of-work.js.map

package/dist/domain/shared/unit-of-work.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unit-of-work.js","sourceRoot":"","sources":["../../../src/domain/shared/unit-of-work.ts"],"names":[],"mappings":""}

package/dist/domain/shared/utc-day.d.ts

@@ -0,0 +1,4 @@
+/** The start of the UTC calendar day `at` falls in: when a fleet's daily message count starts again. */
+export declare function utcDayStart(at: Date): Date;
+/** The start of the next UTC calendar day after `at`. */
+export declare function nextUtcDayStart(at: Date): Date;

package/dist/domain/shared/utc-day.js

@@ -0,0 +1,9 @@
+/** The start of the UTC calendar day `at` falls in: when a fleet's daily message count starts again. */
+export function utcDayStart(at) {
+    return new Date(Date.UTC(at.getUTCFullYear(), at.getUTCMonth(), at.getUTCDate()));
+}
+/** The start of the next UTC calendar day after `at`. */
+export function nextUtcDayStart(at) {
+    return new Date(Date.UTC(at.getUTCFullYear(), at.getUTCMonth(), at.getUTCDate() + 1));
+}
+//# sourceMappingURL=utc-day.js.map

package/dist/domain/shared/utc-day.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utc-day.js","sourceRoot":"","sources":["../../../src/domain/shared/utc-day.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,MAAM,UAAU,WAAW,CAAC,EAAQ;IAClC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,cAAc,EAAE,EAAE,EAAE,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;AACpF,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,eAAe,CAAC,EAAQ;IACtC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,cAAc,EAAE,EAAE,EAAE,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;AACxF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export type { AppRouter } from './adapters/trpc/router.js';

package/dist/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/start.d.ts

@@ -0,0 +1,6 @@
+/**
+ * `aeolus-core start`: migrates the database, then serves the fleet until
+ * SIGINT or SIGTERM. A stop ends waiting receives and closes idle
+ * connections at once (see app.ts).
+ */
+export declare function start(): Promise<void>;

package/dist/start.js

@@ -0,0 +1,29 @@
+import { migrateDatabase } from './adapters/prisma/migrate.js';
+import { createApp } from './app.js';
+import { loadConfig } from './config.js';
+/**
+ * `aeolus-core start`: migrates the database, then serves the fleet until
+ * SIGINT or SIGTERM. A stop ends waiting receives and closes idle
+ * connections at once (see app.ts).
+ */
+export async function start() {
+    const config = loadConfig(process.env);
+    await migrateDatabase(config.databaseUrl);
+    const server = createApp({
+        databaseUrl: config.databaseUrl,
+        publicUrl: config.publicUrl,
+        logger: { level: config.logLevel },
+        shouldTrustProxy: config.shouldTrustProxy,
+        cookieDomain: config.cookieDomain,
+        consoleOrigin: config.consoleOrigin,
+        installationToken: config.installationToken,
+    });
+    for (const signal of ['SIGINT', 'SIGTERM']) {
+        process.once(signal, () => {
+            server.log.info({ signal }, 'shutting down');
+            void server.close().then(() => process.exit(0));
+        });
+    }
+    await server.listen({ host: config.host, port: config.port });
+}
+//# sourceMappingURL=start.js.map

package/dist/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK;IACzB,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,eAAe,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,SAAS,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE;QAClC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;KAC5C,CAAC,CAAC;IAEH,KAAK,MAAM,MAAM,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAU,EAAE,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;YACxB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC;YAC7C,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AAChE,CAAC"}

package/dist/wiring.d.ts

@@ -0,0 +1,158 @@
+import { type IdGenerator } from '@aeolus-fleet/common';
+import type { PrismaClient } from './adapters/prisma/client.js';
+import { type Authenticate } from './domain/identity/authenticate.js';
+import { type DismissNotice } from './domain/identity/dismiss-notice.js';
+import { type GetGuide } from './domain/identity/get-guide.js';
+import { type GetNotices } from './domain/identity/get-notices.js';
+import { type IssueSignInTicket } from './domain/identity/issue-sign-in-ticket.js';
+import { type RedeemSignInTicket } from './domain/identity/redeem-sign-in-ticket.js';
+import { type ReadAccount } from './domain/identity/read-account.js';
+import { type ReadGuide } from './domain/identity/read-guide.js';
+import { type ReadNotices } from './domain/identity/read-notices.js';
+import { type RecordGuideProgress } from './domain/identity/record-guide-progress.js';
+import { type SetGuide } from './domain/identity/set-guide.js';
+import { type ResetOperatorPassword } from './domain/identity/reset-operator-password.js';
+import { type SetNotices } from './domain/identity/set-notices.js';
+import { type SetTheme } from './domain/identity/set-theme.js';
+import { type SignIn } from './domain/identity/sign-in.js';
+import { type SignOut } from './domain/identity/sign-out.js';
+import { type AcknowledgeDelivery } from './domain/messaging/acknowledge-delivery.js';
+import { type AnswerPing } from './domain/messaging/answer-ping.js';
+import { type CheckInbox } from './domain/messaging/check-inbox.js';
+import { type DismissDelivery } from './domain/messaging/dismiss-delivery.js';
+import { type MarkDone } from './domain/messaging/mark-done.js';
+import { type MarkRead } from './domain/messaging/mark-read.js';
+import type { ReceiverWakeups } from './domain/messaging/ports.js';
+import { type ReceiveDeliveries } from './domain/messaging/receive-deliveries.js';
+import { type ReplyToMessage } from './domain/messaging/reply-to-message.js';
+import { type ResendDelivery } from './domain/messaging/resend-delivery.js';
+import { type PingShip } from './domain/messaging/ping-ship.js';
+import { type SendMessage } from './domain/messaging/send-message.js';
+import { type ClaimShip } from './domain/registry/claim-ship.js';
+import { type CommissionShip } from './domain/registry/commission-ship.js';
+import { type Deregister } from './domain/registry/deregister.js';
+import { type GetStartingPrompt } from './domain/registry/get-starting-prompt.js';
+import { type GetShip } from './domain/registry/get-ship.js';
+import { type InitialiseFleet } from './domain/registry/initialise-fleet.js';
+import { type ListFleet } from './domain/registry/list-fleet.js';
+import { type ListFleets } from './domain/registry/list-fleets.js';
+import { type RecrewShip } from './domain/registry/recrew-ship.js';
+import { type ReleaseShip } from './domain/registry/release-ship.js';
+import { type RenameShip } from './domain/registry/rename-ship.js';
+import { type RetireShip } from './domain/registry/retire-ship.js';
+import { type Report } from './domain/registry/report.js';
+import { type RequestCrew } from './domain/registry/request-crew.js';
+import { type RemoveCrewRequest } from './domain/registry/remove-crew-request.js';
+import { type AssignCrew } from './domain/registry/assign-crew.js';
+import { type ReportCrewStatus } from './domain/registry/report-crew-status.js';
+import { type ConfirmCrewRelease } from './domain/registry/confirm-crew-release.js';
+import { type ReadAssignedCrewRequests } from './domain/registry/read-assigned-crew-requests.js';
+import { type ExplainCrewRequest } from './domain/registry/explain-crew-request.js';
+import { type ReadReportLog } from './domain/registry/report-log.js';
+import { type Whoami } from './domain/registry/whoami.js';
+import type { Clock } from './domain/shared/clock.js';
+import { type Ping } from './domain/shared/ping.js';
+import { type ReadFleetEvents } from './domain/shared/read-fleet-events.js';
+import { type FollowFleet } from './domain/shared/follow-fleet.js';
+import type { FleetEventWakeups } from './domain/shared/events.js';
+import { type CreateFleet } from './domain/registry/create-fleet.js';
+import { type GetFleetLimits } from './domain/registry/get-fleet-limits.js';
+import { type GetInstallationSettings } from './domain/registry/get-installation-settings.js';
+import { type SetFleetLimits } from './domain/registry/set-fleet-limits.js';
+import { type SetInstallationSettings } from './domain/registry/set-installation-settings.js';
+import { type ReadFleetLimits } from './domain/shared/read-fleet-limits.js';
+import { type DeleteFleet } from './domain/registry/delete-fleet.js';
+import { type GetInstallationFleet } from './domain/registry/get-installation-fleet.js';
+import { type ListInstallationFleets } from './domain/registry/list-installation-fleets.js';
+import { type ReadInbox } from './domain/shared/read-inbox.js';
+import { type ReadMessage } from './domain/shared/read-message.js';
+import { type ReadNeedsAttention } from './domain/shared/read-needs-attention.js';
+import { type ReadShipMessages } from './domain/shared/read-ship-messages.js';
+import { type ReadShipTimeline } from './domain/shared/read-ship-timeline.js';
+export interface UseCases {
+    ping: Ping;
+    initialiseFleet: InitialiseFleet;
+    listFleets: ListFleets;
+    commissionShip: CommissionShip;
+    getStartingPrompt: GetStartingPrompt;
+    releaseShip: ReleaseShip;
+    retireShip: RetireShip;
+    renameShip: RenameShip;
+    recrewShip: RecrewShip;
+    listFleet: ListFleet;
+    getShip: GetShip;
+    claimShip: ClaimShip;
+    whoami: Whoami;
+    report: Report;
+    requestCrew: RequestCrew;
+    removeCrewRequest: RemoveCrewRequest;
+    assignCrew: AssignCrew;
+    reportCrewStatus: ReportCrewStatus;
+    confirmCrewRelease: ConfirmCrewRelease;
+    readAssignedCrewRequests: ReadAssignedCrewRequests;
+    explainCrewRequest: ExplainCrewRequest;
+    reportLog: ReadReportLog;
+    deregister: Deregister;
+    sendMessage: SendMessage;
+    receiveDeliveries: ReceiveDeliveries;
+    acknowledgeDelivery: AcknowledgeDelivery;
+    answerPing: AnswerPing;
+    pingShip: PingShip;
+    checkInbox: CheckInbox;
+    dismissDelivery: DismissDelivery;
+    resendDelivery: ResendDelivery;
+    markRead: MarkRead;
+    markDone: MarkDone;
+    replyToMessage: ReplyToMessage;
+    readFleetEvents: ReadFleetEvents;
+    followFleet: FollowFleet;
+    readShipTimeline: ReadShipTimeline;
+    readShipMessages: ReadShipMessages;
+    readMessage: ReadMessage;
+    readNeedsAttention: ReadNeedsAttention;
+    readInbox: ReadInbox;
+    signIn: SignIn;
+    signOut: SignOut;
+    readAccount: ReadAccount;
+    setTheme: SetTheme;
+    setNotices: SetNotices;
+    getNotices: GetNotices;
+    readNotices: ReadNotices;
+    dismissNotice: DismissNotice;
+    setGuide: SetGuide;
+    getGuide: GetGuide;
+    readGuide: ReadGuide;
+    recordGuideProgress: RecordGuideProgress;
+    resetOperatorPassword: ResetOperatorPassword;
+    authenticate: Authenticate;
+    createFleet: CreateFleet;
+    deleteFleet: DeleteFleet;
+    listInstallationFleets: ListInstallationFleets;
+    getInstallationFleet: GetInstallationFleet;
+    issueSignInTicket: IssueSignInTicket;
+    redeemSignInTicket: RedeemSignInTicket;
+    getInstallationSettings: GetInstallationSettings;
+    setInstallationSettings: SetInstallationSettings;
+    getFleetLimits: GetFleetLimits;
+    setFleetLimits: SetFleetLimits;
+    readFleetLimits: ReadFleetLimits;
+}
+export declare const systemClock: Clock;
+/**
+ * Wires every use case to Postgres through Prisma. The HTTP app and the server
+ * commands share it.
+ *
+ * `wakeups` wake a waiting receive; the HTTP app feeds them from the delivery
+ * listener. Without them, nothing wakes a receive and it ends only at its
+ * wait: enough for the server commands, which never receive.
+ */
+export declare function createUseCases(options: {
+    prisma: PrismaClient;
+    clock?: Clock;
+    ids?: IdGenerator;
+    wakeups?: ReceiverWakeups;
+    /** Wake a waiting follow; without them a follow ends only at its wait. */
+    fleetEventWakeups?: FleetEventWakeups;
+    /** How long a receive waits on an empty inbox; about 25 seconds unless a test says otherwise. */
+    receiveWaitMs?: number;
+}): UseCases;