@aeolus-fleet/core 0.36.1 → 0.37.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/README.md +1 -1
  2. package/dist/adapters/http/server.js +9 -1
  3. package/dist/adapters/http/server.js.map +1 -1
  4. package/dist/adapters/prisma/fleet-event-wakeups.js +2 -1
  5. package/dist/adapters/prisma/fleet-event-wakeups.js.map +1 -1
  6. package/dist/adapters/prisma/harbour.d.ts +37 -0
  7. package/dist/adapters/prisma/harbour.js +119 -0
  8. package/dist/adapters/prisma/harbour.js.map +1 -0
  9. package/dist/adapters/prisma/receiver-wakeups.d.ts +11 -9
  10. package/dist/adapters/prisma/receiver-wakeups.js +71 -2
  11. package/dist/adapters/prisma/receiver-wakeups.js.map +1 -1
  12. package/dist/adapters/prisma/registry.d.ts +13 -1
  13. package/dist/adapters/prisma/registry.js +6 -4
  14. package/dist/adapters/prisma/registry.js.map +1 -1
  15. package/dist/adapters/rest/openapi.d.ts +3 -3
  16. package/dist/adapters/rest/openapi.js +30 -3
  17. package/dist/adapters/rest/openapi.js.map +1 -1
  18. package/dist/adapters/rest/rest-api.d.ts +4 -0
  19. package/dist/adapters/rest/rest-api.js +107 -3
  20. package/dist/adapters/rest/rest-api.js.map +1 -1
  21. package/dist/adapters/telemetry/calls.d.ts +8 -0
  22. package/dist/adapters/telemetry/calls.js +39 -3
  23. package/dist/adapters/telemetry/calls.js.map +1 -1
  24. package/dist/adapters/telemetry/wake-streams.d.ts +6 -0
  25. package/dist/adapters/telemetry/wake-streams.js +28 -0
  26. package/dist/adapters/telemetry/wake-streams.js.map +1 -0
  27. package/dist/adapters/trpc/context.d.ts +6 -1
  28. package/dist/adapters/trpc/fleet.d.ts +31 -0
  29. package/dist/adapters/trpc/fleet.js +23 -1
  30. package/dist/adapters/trpc/fleet.js.map +1 -1
  31. package/dist/adapters/trpc/installation.js +7 -1
  32. package/dist/adapters/trpc/installation.js.map +1 -1
  33. package/dist/adapters/trpc/router.d.ts +40 -0
  34. package/dist/adapters/trpc/ship-contract.d.ts +68 -0
  35. package/dist/adapters/trpc/ship-contract.js +99 -1
  36. package/dist/adapters/trpc/ship-contract.js.map +1 -1
  37. package/dist/adapters/trpc/ship-protocol.js +1 -0
  38. package/dist/adapters/trpc/ship-protocol.js.map +1 -1
  39. package/dist/adapters/trpc/ship.d.ts +50 -13
  40. package/dist/adapters/trpc/ship.js +50 -0
  41. package/dist/adapters/trpc/ship.js.map +1 -1
  42. package/dist/adapters/trpc/trpc.js +2 -0
  43. package/dist/adapters/trpc/trpc.js.map +1 -1
  44. package/dist/app.js +2 -1
  45. package/dist/app.js.map +1 -1
  46. package/dist/domain/messaging/ports.d.ts +25 -0
  47. package/dist/domain/messaging/watch-wakeups.d.ts +41 -0
  48. package/dist/domain/messaging/watch-wakeups.js +54 -0
  49. package/dist/domain/messaging/watch-wakeups.js.map +1 -0
  50. package/dist/domain/registry/get-installation-fleet.d.ts +5 -1
  51. package/dist/domain/registry/get-installation-fleet.js +12 -3
  52. package/dist/domain/registry/get-installation-fleet.js.map +1 -1
  53. package/dist/domain/registry/harbour.d.ts +36 -0
  54. package/dist/domain/registry/harbour.js +27 -0
  55. package/dist/domain/registry/harbour.js.map +1 -0
  56. package/dist/domain/registry/ports.d.ts +25 -0
  57. package/dist/domain/registry/read-harbour.d.ts +29 -0
  58. package/dist/domain/registry/read-harbour.js +27 -0
  59. package/dist/domain/registry/read-harbour.js.map +1 -0
  60. package/dist/domain/shared/errors.d.ts +1 -1
  61. package/dist/domain/shared/errors.js.map +1 -1
  62. package/dist/wiring.d.ts +7 -1
  63. package/dist/wiring.js +5 -0
  64. package/dist/wiring.js.map +1 -1
  65. package/package.json +2 -2
package/dist/app.js CHANGED
@@ -48,6 +48,7 @@ export function createApp(options) {
48
48
  prisma,
49
49
  clock,
50
50
  wakeups,
51
+ wakeStreams: wakeups,
51
52
  fleetEventWakeups: fleetEventWakeupsOf(fleetEvents),
52
53
  receiveWaitMs: options.receiveWaitMs,
53
54
  accountTokenSignatures: accountTokenSignaturesOf(options.accountTokenIssuer, clock),
@@ -133,7 +134,7 @@ export function createApp(options) {
133
134
  });
134
135
  // Before the server stops taking requests and waits for the ones it holds:
135
136
  // a waiting receive answers no deliveries at once instead of holding it up,
136
- // and a live subscription ends.
137
+ // and a live subscription and every wake stream end.
137
138
  // Connections idle at that moment close at once (Fastify's default); one
138
139
  // whose request ends later is told to close with its answer, or it would
139
140
  // stay open, idle, until its keep-alive timeout.
package/dist/app.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"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"}
@@ -264,6 +264,31 @@ export interface ReceiverWatch {
264
264
  /** Stops watching. */
265
265
  stop(): void;
266
266
  }
267
+ /**
268
+ * How a wake stream's wait ended: a notice of a delivery pending for its ship
269
+ * or its type, the listener listening again, its time passed (a keep-alive is
270
+ * due), or the stream ended, because its crew closed it or the server stops.
271
+ */
272
+ export type WakeStreamOutcome = 'notice' | 'reconnect' | 'timedOut' | 'ended';
273
+ /**
274
+ * Outbound port: the wake streams a crew keeps open to be told to look
275
+ * (long-poll design, W1). A wake is a hint, never a delivery: the crew's look
276
+ * finds out in the database what waits for it.
277
+ */
278
+ export interface WakeStreams {
279
+ /** Starts watching the ship and its type for one stream; none while the server stops. */
280
+ open(address: ReceiverAddress): WakeStreamWatch | undefined;
281
+ }
282
+ export interface WakeStreamWatch {
283
+ /**
284
+ * Settles on the next wake, once `waitMs` has passed, or when `signal`
285
+ * aborts or the server stops. Each notice wakes once: one that comes while
286
+ * the stream is not waiting is kept for its next wait.
287
+ */
288
+ next(waitMs: number, signal: AbortSignal): Promise<WakeStreamOutcome>;
289
+ /** Stops watching. */
290
+ stop(): void;
291
+ }
267
292
  /** Outbound port: the fleet's open pushed leases, for the 10 and 60 minute clocks. Read without a lock. */
268
293
  export interface PushedCrews {
269
294
  /**
@@ -0,0 +1,41 @@
1
+ import { type HoldLeaseTx, type LeaseEnded } from '../registry/public.js';
2
+ import type { Crew } from '../shared/caller.js';
3
+ import { type DomainError } from '../shared/errors.js';
4
+ import { type Result } from '../shared/result.js';
5
+ import type { UnitOfWork } from '../shared/unit-of-work.js';
6
+ import type { WakeStreams } from './ports.js';
7
+ /** Why a stream is told to look: it opened, a delivery may be pending for it, or the listener listens again. */
8
+ export type WakeReason = 'open' | 'notice' | 'reconnect';
9
+ /** What a wake stream sends: a wake, a keep-alive, or its end once the lease ended. */
10
+ export type WakeStreamItem = {
11
+ kind: 'wake';
12
+ reason: WakeReason;
13
+ } | {
14
+ kind: 'keepAlive';
15
+ } | {
16
+ kind: 'end';
17
+ refusal: LeaseEnded;
18
+ };
19
+ export type WatchWakeupsRefusal = LeaseEnded | DomainError<'SERVER_STOPPING'>;
20
+ export type WatchWakeups = (crew: Crew, closing: AbortSignal) => Promise<Result<AsyncIterable<WakeStreamItem>, WatchWakeupsRefusal>>;
21
+ /** How long a stream stays silent before a keep-alive: 25 seconds, so a half-open connection shows within the caller's 60. */
22
+ export declare const KEEP_ALIVE_MS = 25000;
23
+ /**
24
+ * Use case: a crew keeps a wake stream open (`ship.wakeups`, long-poll design
25
+ * W1) and is told to look, with a call that answers at once; the stream never
26
+ * carries a delivery. Its scope (messages:receive) is checked before this runs.
27
+ *
28
+ * It holds the lease, then watches the ship and its type before its first
29
+ * wake (reason `open`), so a delivery that commits while it opens is found by
30
+ * the look that wake starts. Then it wakes once per notice of a delivery
31
+ * pending for the ship or its type, and on `reconnect` when the listener
32
+ * listens again; it sends a keep-alive every 25 seconds without one. At each
33
+ * wake and keep-alive it holds the lease again: an ended one ends the stream
34
+ * with LEASE_ENDED. It closes when the crew closes it or the server stops.
35
+ */
36
+ export declare function createWatchWakeups(deps: {
37
+ uow: UnitOfWork<HoldLeaseTx>;
38
+ wakeStreams: WakeStreams;
39
+ /** The time between keep-alives; 25 seconds unless a test says otherwise. */
40
+ keepAliveMs?: number;
41
+ }): WatchWakeups;
@@ -0,0 +1,54 @@
1
+ import { holdLease } from '../registry/public.js';
2
+ import { refuse } from '../shared/errors.js';
3
+ import { ok } from '../shared/result.js';
4
+ /** How long a stream stays silent before a keep-alive: 25 seconds, so a half-open connection shows within the caller's 60. */
5
+ export const KEEP_ALIVE_MS = 25_000;
6
+ /**
7
+ * Use case: a crew keeps a wake stream open (`ship.wakeups`, long-poll design
8
+ * W1) and is told to look, with a call that answers at once; the stream never
9
+ * carries a delivery. Its scope (messages:receive) is checked before this runs.
10
+ *
11
+ * It holds the lease, then watches the ship and its type before its first
12
+ * wake (reason `open`), so a delivery that commits while it opens is found by
13
+ * the look that wake starts. Then it wakes once per notice of a delivery
14
+ * pending for the ship or its type, and on `reconnect` when the listener
15
+ * listens again; it sends a keep-alive every 25 seconds without one. At each
16
+ * wake and keep-alive it holds the lease again: an ended one ends the stream
17
+ * with LEASE_ENDED. It closes when the crew closes it or the server stops.
18
+ */
19
+ export function createWatchWakeups(deps) {
20
+ const keepAliveMs = deps.keepAliveMs ?? KEEP_ALIVE_MS;
21
+ async function* stream(crew, open) {
22
+ const { watch, closing } = open;
23
+ try {
24
+ yield { kind: 'wake', reason: 'open' };
25
+ for (;;) {
26
+ const outcome = await watch.next(keepAliveMs, closing);
27
+ if (outcome === 'ended') {
28
+ return;
29
+ }
30
+ const held = await deps.uow.run((tx) => holdLease(tx, crew));
31
+ if (!held.isOk) {
32
+ yield { kind: 'end', refusal: held.error };
33
+ return;
34
+ }
35
+ yield outcome === 'timedOut' ? { kind: 'keepAlive' } : { kind: 'wake', reason: outcome };
36
+ }
37
+ }
38
+ finally {
39
+ watch.stop();
40
+ }
41
+ }
42
+ return async (crew, closing) => {
43
+ const ship = await deps.uow.run((tx) => holdLease(tx, crew));
44
+ if (!ship.isOk) {
45
+ return ship;
46
+ }
47
+ const watch = deps.wakeStreams.open({ fleetId: crew.fleetId, shipId: crew.shipId, type: ship.value.type });
48
+ if (watch === undefined) {
49
+ return refuse('SERVER_STOPPING', 'The server is stopping: open the stream again shortly');
50
+ }
51
+ return ok(stream(crew, { watch, closing }));
52
+ };
53
+ }
54
+ //# sourceMappingURL=watch-wakeups.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"watch-wakeups.js","sourceRoot":"","sources":["../../../src/domain/messaging/watch-wakeups.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAqC,MAAM,uBAAuB,CAAC;AAErF,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AActD,8HAA8H;AAC9H,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC;AAEpC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAKlC;IACC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,aAAa,CAAC;IAEtD,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC,IAAU,EAAE,IAAsD;QACvF,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YACvC,SAAS,CAAC;gBACR,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;gBACvD,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;oBACxB,OAAO;gBACT,CAAC;gBACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;gBAC7D,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;oBACf,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;oBAC3C,OAAO;gBACT,CAAC;gBACD,MAAM,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;YAC3F,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QAC7B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3G,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,MAAM,CAAC,iBAAiB,EAAE,uDAAuD,CAAC,CAAC;QAC5F,CAAC;QACD,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC;AACJ,CAAC"}
@@ -6,9 +6,13 @@ import type { HealthRecords } from '../shared/health.js';
6
6
  import { type Result } from '../shared/result.js';
7
7
  import { type InstallationFleet } from './installation-fleet.js';
8
8
  import type { InstallationFleets, InstallationSettingsRepository } from './ports.js';
9
+ /** The reads one fleet's description awaits, in their order: its facts, the installation's settings, its latest stuck snapshot and its health. */
10
+ export type InstallationFleetStep = 'find' | 'settings' | 'latest' | 'health';
11
+ /** Told each step once it answered, with the milliseconds it took: a read that never answers is the first step not told (#1523). */
12
+ export type StepTaken = (step: InstallationFleetStep, ms: number) => void;
9
13
  export type GetInstallationFleet = (input: {
10
14
  fleetId: FleetId;
11
- }) => Promise<Result<InstallationFleet, DomainError<'FLEET_NOT_FOUND'>>>;
15
+ }, stepTaken?: StepTaken) => Promise<Result<InstallationFleet, DomainError<'FLEET_NOT_FOUND'>>>;
12
16
  /** Use case: one fleet of the installation, described as the list describes it. */
13
17
  export declare function createGetInstallationFleet(deps: {
14
18
  fleets: InstallationFleets;
@@ -4,13 +4,22 @@ import { ok } from '../shared/result.js';
4
4
  import { installationFleet, messageWindow } from './installation-fleet.js';
5
5
  /** Use case: one fleet of the installation, described as the list describes it. */
6
6
  export function createGetInstallationFleet(deps) {
7
- return async ({ fleetId }) => {
7
+ return async ({ fleetId }, stepTaken = () => undefined) => {
8
+ const timed = async (step, read) => {
9
+ const started = deps.clock.now().getTime();
10
+ const answer = await read();
11
+ stepTaken(step, deps.clock.now().getTime() - started);
12
+ return answer;
13
+ };
8
14
  const now = deps.clock.now();
9
- const facts = await deps.fleets.find(fleetId, messageWindow(now));
15
+ const facts = await timed('find', () => deps.fleets.find(fleetId, messageWindow(now)));
10
16
  if (!facts) {
11
17
  return refuse('FLEET_NOT_FOUND', `The installation hosts no fleet ${fleetId}`);
12
18
  }
13
- return ok(installationFleet(facts, { now, installation: await deps.settings.read(), health: await readHealthOf({ records: deps.health, snapshots: deps.snapshots }, { fleetId, now }) }));
19
+ const installation = await timed('settings', () => deps.settings.read());
20
+ const snapshots = { ...deps.snapshots, latest: (id) => timed('latest', () => deps.snapshots.latest(id)) };
21
+ const health = await timed('health', () => readHealthOf({ records: deps.health, snapshots }, { fleetId, now }));
22
+ return ok(installationFleet(facts, { now, installation, health }));
14
23
  };
15
24
  }
16
25
  //# sourceMappingURL=get-installation-fleet.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"get-installation-fleet.js","sourceRoot":"","sources":["../../../src/domain/registry/get-installation-fleet.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAA0B,MAAM,yBAAyB,CAAC;AAKnG,mFAAmF;AACnF,MAAM,UAAU,0BAA0B,CAAC,IAM1C;IACC,OAAO,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,MAAM,CAAC,iBAAiB,EAAE,mCAAmC,OAAO,EAAE,CAAC,CAAC;QACjF,CAAC;QACD,OAAO,EAAE,CAAC,iBAAiB,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5L,CAAC,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"get-installation-fleet.js","sourceRoot":"","sources":["../../../src/domain/registry/get-installation-fleet.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAA0B,MAAM,yBAAyB,CAAC;AAWnG,mFAAmF;AACnF,MAAM,UAAU,0BAA0B,CAAC,IAM1C;IACC,OAAO,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,SAAS,GAAG,GAAG,EAAE,CAAC,SAAS,EAAE,EAAE;QACxD,MAAM,KAAK,GAAG,KAAK,EAAK,IAA2B,EAAE,IAAsB,EAAc,EAAE;YACzF,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;YAC5B,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC;YACtD,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;QACF,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACvF,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,MAAM,CAAC,iBAAiB,EAAE,mCAAmC,OAAO,EAAE,CAAC,CAAC;QACjF,CAAC;QACD,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACzE,MAAM,SAAS,GAAoB,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAC3H,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAChH,OAAO,EAAE,CAAC,iBAAiB,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC;AACJ,CAAC"}
@@ -0,0 +1,36 @@
1
+ /**
2
+ * Harbour (docs/design/fleet-overview, "The read Harbour needs"): each active
3
+ * ship in one of four states, and the five numbers. The listing computes the
4
+ * state in its statement; this is the rule it is held to.
5
+ */
6
+ import type { ReportState, ShipId, ShipKind, ShipStatus } from '@aeolus-fleet/common';
7
+ import type { HarbourState } from '@aeolus-fleet/common/rules';
8
+ /** A ship as Harbour shows it: its tile. */
9
+ export interface HarbourShip {
10
+ id: ShipId;
11
+ name: string;
12
+ kind: ShipKind;
13
+ state: HarbourState;
14
+ /** What the ship is doing: its crew's report note; null before it reports, without a note, or while no session crews it. */
15
+ note: string | null;
16
+ /** When the ship last did something: the latest of its sends, its acknowledgements and the activity its trierarch reported; null before any. */
17
+ lastActivityAt: Date | null;
18
+ }
19
+ /** Harbour's numbers: the ships it shows, and how many are in each state. */
20
+ export type HarbourCounts = {
21
+ ships: number;
22
+ } & Record<HarbourState, number>;
23
+ /**
24
+ * The state of an active ship, first match wins: an open alert is alert;
25
+ * awaiting crew or a blocked report is waiting; a working report is working;
26
+ * anything else (an idle report, or none yet) is idle.
27
+ */
28
+ export declare function harbourStateOf(ship: {
29
+ status: Exclude<ShipStatus, 'retired'>;
30
+ reportState: ReportState | null;
31
+ hasOpenAlert: boolean;
32
+ }): HarbourState;
33
+ /** The latest of the times given, none when there is none. */
34
+ export declare function latestOf(times: readonly (Date | null)[]): Date | null;
35
+ /** The numbers over the ships Harbour shows. */
36
+ export declare function harbourCountsOf(ships: readonly Pick<HarbourShip, 'state'>[]): HarbourCounts;
@@ -0,0 +1,27 @@
1
+ /**
2
+ * The state of an active ship, first match wins: an open alert is alert;
3
+ * awaiting crew or a blocked report is waiting; a working report is working;
4
+ * anything else (an idle report, or none yet) is idle.
5
+ */
6
+ export function harbourStateOf(ship) {
7
+ if (ship.hasOpenAlert) {
8
+ return 'alert';
9
+ }
10
+ if (ship.status === 'awaitingCrew' || ship.reportState === 'blocked') {
11
+ return 'waiting';
12
+ }
13
+ return ship.reportState === 'working' ? 'working' : 'idle';
14
+ }
15
+ /** The latest of the times given, none when there is none. */
16
+ export function latestOf(times) {
17
+ return times.reduce((latest, time) => (time !== null && (latest === null || time > latest) ? time : latest), null);
18
+ }
19
+ /** The numbers over the ships Harbour shows. */
20
+ export function harbourCountsOf(ships) {
21
+ const counts = { ships: ships.length, alert: 0, waiting: 0, working: 0, idle: 0 };
22
+ for (const { state } of ships) {
23
+ counts[state] += 1;
24
+ }
25
+ return counts;
26
+ }
27
+ //# sourceMappingURL=harbour.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"harbour.js","sourceRoot":"","sources":["../../../src/domain/registry/harbour.ts"],"names":[],"mappings":"AAuBA;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAwG;IACrI,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,cAAc,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACrE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;AAC7D,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,QAAQ,CAAC,KAA+B;IACtD,OAAO,KAAK,CAAC,MAAM,CAAc,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,IAAI,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;AAClI,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,eAAe,CAAC,KAA4C;IAC1E,MAAM,MAAM,GAAkB,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACjG,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,KAAK,EAAE,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
@@ -21,6 +21,7 @@ import type { ReachRefusal } from './reach-refusal.js';
21
21
  import type { DefinedScope } from './defined-scope.js';
22
22
  import type { ScopeNamespace } from './scope-namespace.js';
23
23
  import type { Commissioner, Ship } from './ship.js';
24
+ import type { HarbourCounts, HarbourShip } from './harbour.js';
24
25
  import type { ShipCounts } from './ship-counts.js';
25
26
  import type { ShipReport } from './ship-report.js';
26
27
  import type { StatedStatement } from './statement.js';
@@ -659,6 +660,15 @@ export interface ShipPage {
659
660
  sort?: ShipSort;
660
661
  reach: ReadReach;
661
662
  }
663
+ /** Which of Harbour's ships a read answers: a page after a position, or the ships asked. */
664
+ export type HarbourRead = {
665
+ reach: ReadReach;
666
+ } & ({
667
+ after?: ShipPosition;
668
+ limit: number;
669
+ } | {
670
+ shipIds: readonly ShipId[];
671
+ });
662
672
  /** The fleet snapshot's reads. Its lists, counts and types leave every removed ship out; `ship` still answers one, its remnant (decision 0070, D4 and D8). */
663
673
  export interface FleetListing {
664
674
  /** A page of the fleet's ships as `page` selects and orders them, each with its position (decision 4 of the performance design). */
@@ -670,6 +680,21 @@ export interface FleetListing {
670
680
  labels(fleetId: FleetId): Promise<ListedLabel[]>;
671
681
  /** One ship of the fleet, read the same way; undefined when the fleet has no such ship. */
672
682
  ship(fleetId: FleetId, shipId: ShipId): Promise<ShipFacts | undefined>;
683
+ /**
684
+ * Harbour's ships (docs/design/fleet-overview): the active ships in `reach`,
685
+ * the viewer ship left out, each with its state as `harbourStateOf` decides
686
+ * it, in the listing's default order after the position, at most `limit`;
687
+ * or, with `shipIds`, only those of them. A page read from the start holds
688
+ * the numbers over the same ships, as `harbourCountsOf` counts them, read
689
+ * in the same transaction; any other read holds none.
690
+ */
691
+ harbour(fleetId: FleetId, read: HarbourRead): Promise<{
692
+ ships: {
693
+ ship: HarbourShip;
694
+ position: ShipPosition;
695
+ }[];
696
+ counts: HarbourCounts | null;
697
+ }>;
673
698
  /** The ships in `reach` that `filter` selects, counted per kind as `shipCountsOf` counts them, without reading each ship. */
674
699
  counts(fleetId: FleetId, read: {
675
700
  reach: ReadReach;
@@ -0,0 +1,29 @@
1
+ import { type ShipId, type ShipPosition } from '@aeolus-fleet/common';
2
+ import type { Caller } from '../shared/caller.js';
3
+ import type { HarbourCounts, HarbourShip } from './harbour.js';
4
+ import type { FleetListing } from './ports.js';
5
+ import type { ReadReachOf } from './read-reach.js';
6
+ export type ReadHarbour = (caller: Caller, input?: {
7
+ cursor?: ShipPosition;
8
+ limit?: number;
9
+ } | {
10
+ shipIds: readonly ShipId[];
11
+ }) => Promise<{
12
+ ships: HarbourShip[];
13
+ nextCursor: ShipPosition | null;
14
+ counts: HarbourCounts | null;
15
+ }>;
16
+ /**
17
+ * Use case: Harbour's ships (docs/design/fleet-overview, "The read Harbour
18
+ * needs"): the active ships the caller reads whole (decision 0034), the
19
+ * viewer ship left out, each by id, name, kind, its state and note, argo
20
+ * first and then by name, PAGE_SIZE_MAX a page unless the caller asks
21
+ * fewer, with where the next page starts; the numbers on the first page
22
+ * only, read with it. With ship ids, only those ships, for the live reload
23
+ * of their tiles: no numbers, no next page. The caller's scope (fleet:read)
24
+ * is checked before this runs.
25
+ */
26
+ export declare function createReadHarbour(deps: {
27
+ listing: FleetListing;
28
+ readReach: ReadReachOf;
29
+ }): ReadHarbour;
@@ -0,0 +1,27 @@
1
+ import { PAGE_SIZE_MAX } from '@aeolus-fleet/common';
2
+ /**
3
+ * Use case: Harbour's ships (docs/design/fleet-overview, "The read Harbour
4
+ * needs"): the active ships the caller reads whole (decision 0034), the
5
+ * viewer ship left out, each by id, name, kind, its state and note, argo
6
+ * first and then by name, PAGE_SIZE_MAX a page unless the caller asks
7
+ * fewer, with where the next page starts; the numbers on the first page
8
+ * only, read with it. With ship ids, only those ships, for the live reload
9
+ * of their tiles: no numbers, no next page. The caller's scope (fleet:read)
10
+ * is checked before this runs.
11
+ */
12
+ export function createReadHarbour(deps) {
13
+ return async (caller, input = {}) => {
14
+ const reach = await deps.readReach(caller);
15
+ if ('shipIds' in input) {
16
+ const { ships } = await deps.listing.harbour(caller.fleetId, { reach, shipIds: input.shipIds });
17
+ return { ships: ships.map(({ ship }) => ship), nextCursor: null, counts: null };
18
+ }
19
+ const { cursor, limit = PAGE_SIZE_MAX } = input;
20
+ // One ship past the page tells whether another page follows.
21
+ const { ships, counts } = await deps.listing.harbour(caller.fleetId, { reach, after: cursor, limit: limit + 1 });
22
+ const page = ships.slice(0, limit);
23
+ const last = page.at(-1);
24
+ return { ships: page.map(({ ship }) => ship), nextCursor: ships.length > limit && last !== undefined ? last.position : null, counts };
25
+ };
26
+ }
27
+ //# sourceMappingURL=read-harbour.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"read-harbour.js","sourceRoot":"","sources":["../../../src/domain/registry/read-harbour.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkC,MAAM,sBAAsB,CAAC;AAYrF;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAuD;IACvF,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE;QAClC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;YACvB,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAChG,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAClF,CAAC;QACD,MAAM,EAAE,MAAM,EAAE,KAAK,GAAG,aAAa,EAAE,GAAG,KAAK,CAAC;QAChD,6DAA6D;QAC7D,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;QACjH,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACzB,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,MAAM,GAAG,KAAK,IAAI,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IACxI,CAAC,CAAC;AACJ,CAAC"}
@@ -1,6 +1,6 @@
1
1
  import { type Err } from './result.js';
2
2
  /** Every reason the domain refuses a request. */
3
- export type DomainErrorKind = 'ACCOUNT_TOKEN_ENDED' | 'ACCOUNT_TOKEN_INVALID' | 'ASSIGNEE_NOT_ACTIVE' | 'BASE_SCOPE' | 'CLEAR_REQUEST_LIMIT_REACHED' | 'CLEAR_REQUEST_NOT_FOUND' | 'CORE_NAMESPACE' | 'CREW_REQUEST_ALREADY_ASSIGNED' | 'CREW_REQUEST_NOT_ASSIGNED_TO_CALLER' | 'CREW_REQUEST_NOT_FOUND' | 'CREW_REQUEST_NOT_RELEASING' | 'CREW_REQUEST_RELEASING' | 'CREW_REQUEST_FINAL' | 'CREW_REQUEST_SETTINGS_CHANGED' | 'CREW_REQUEST_SETTINGS_INVALID' | 'CREW_REQUEST_SETTINGS_TOO_LARGE' | 'DELIVERY_HANDED_ONCE_MORE' | 'DELIVERY_HELD_BY_ANOTHER_SHIP' | 'DELIVERY_NOT_FOUND' | 'DELIVERY_NOT_A_PING' | 'DELIVERY_NOT_ACKNOWLEDGED' | 'DELIVERY_NOT_HANDED_ONCE_MORE' | 'DELIVERY_NOT_IN_FLIGHT' | 'DELIVERY_NOT_OPEN' | 'DELIVERY_NOT_UNDELIVERABLE' | 'FLEET_ALREADY_EXISTS' | 'FLEET_ALREADY_SEALED' | 'FLEET_NOT_SEALED' | 'FLEET_LIMIT_REACHED' | 'FORCE_NOT_ALLOWED' | 'FLEET_NOT_FOUND' | 'FEATURE_FLAG_OFF' | 'FEATURE_FLAG_IN_USE' | 'FLEET_HAS_NO_VIEWER' | 'VIEWER_TICKET_NAMES_NO_ACCOUNT' | 'INVALID_SCOPE' | 'INVALID_SCOPE_DESCRIPTION' | 'NAMESPACE_TAKEN' | 'NOTICE_NOT_FOUND' | 'NOTICE_NOT_DISMISSIBLE' | 'GUIDE_NOT_FOUND' | 'GUIDE_STEP_NOT_FOUND' | 'IDEMPOTENCY_KEY_REUSED' | 'KEY_NOT_BOUND_TO_FLEET' | 'KEY_UNAVAILABLE' | 'OWN_SHIP_SCOPES' | 'RESERVED_NAMESPACE' | 'SCOPE_DEFINED' | 'SCOPE_HELD' | 'SCOPE_NOT_DEFINED' | 'SCOPE_NOT_DECLARED' | 'SCOPE_NOT_HELD' | 'SECOND_NAMESPACE' | 'SHIP_HAS_NO_OWNER' | 'IN_REPLY_TO_NOT_FOUND' | 'MESSAGE_LIMIT_REACHED' | 'MEETING_WITHOUT_INVITEES' | 'MEETING_NOT_FOUND' | 'MEETING_ENDED' | 'SCHEDULE_NOT_FOUND' | 'ALERT_NOT_FOUND' | 'SCHEDULE_ENDED' | 'SCHEDULE_CANCELLED' | 'INVALID_TIMING' | 'INVALID_RETRY_WINDOW' | 'INVALID_GRACE' | 'FORBIDDEN' | 'CONTRIBUTION_REPLIES' | 'CONTRIBUTION_FORCED' | 'MIC_ALREADY_REQUESTED' | 'MIC_ALREADY_HELD' | 'MODERATOR_NEEDS_NO_MIC' | 'MIC_NOT_REQUESTED' | 'MIC_NOT_HELD' | 'MIC_FREE' | 'NOT_MODERATOR' | 'PARTICIPANT_NOT_FOUND' | 'PARTICIPANT_LEFT' | 'PARTICIPANT_REVOKED' | 'ALREADY_PRESENT' | 'OWNER_CANNOT_LEAVE' | 'NOT_OWNER' | 'NOT_OWNER_OR_MODERATOR' | 'MODEL_REQUIRED' | 'INVALID_HARNESS' | 'MODEL_FROM_ARGO' | 'MODEL_FROM_PERSON_APP_OR_PLUGIN' | 'INVALID_CONTENT_TYPE' | 'INVALID_EMAIL' | 'INVALID_FLEET_NAME' | 'INVALID_FOLLOW_MAX' | 'INVALID_FOLLOW_WAIT' | 'INVALID_IDEMPOTENCY_KEY' | 'INVALID_INBOX_WAIT' | 'INVALID_LABEL_KEY' | 'INVALID_LABEL_VALUE' | 'INVALID_LABEL_VALUES' | 'INVALID_LIMIT' | 'INVALID_LOCATION' | 'INVALID_OWNER' | 'INVALID_NETWORK_RULES' | 'INVALID_NETWORK_RULES_FILE' | 'INVALID_PASSWORD' | 'INVALID_RECEIVE_MAX' | 'INVALID_RECOVERY_KEY' | 'NO_RECOVERY_KEY' | 'RECOVERY_KEYS_MISMATCH' | 'INVALID_RETENTION' | 'INVALID_CREW_REQUEST_REASON' | 'INVALID_EXPECTATIONS' | 'INVALID_REPORT_DETAILS' | 'INVALID_REPORT_NOTE' | 'INVALID_REPORT_STATE' | 'INVALID_REPORT_STEP' | 'INVALID_REPORT_TASK' | 'INVALID_SHIP_NAME' | 'INVALID_SHIP_NOTE' | 'INVALID_SHIP_TYPE' | 'LABEL_CARRIED' | 'LABEL_DIFFERENCES' | 'LABEL_KEY_TAKEN' | 'ACCOUNT_OWNS_NO_LABEL' | 'LABEL_NOT_FOUND' | 'LABEL_VALUE_CARRIED' | 'LABEL_VALUE_NOT_FOUND' | 'LEASE_ENDED' | 'MESSAGE_NOT_FOUND' | 'NETWORK_SETTINGS_CHANGED' | 'NO_NETWORK_RULES_DRAFT' | 'NOT_A_TRIERARCH' | 'NOT_ALLOWED_AS_ARGO' | 'NOT_AN_AGENT_SHIP' | 'NOT_THE_LABEL_OWNER' | 'NOT_YOUR_SHIP_TO_LABEL' | 'NOT_REACHABLE' | 'BUILT_IN_RULE_FIXED' | 'NOT_THE_OPERATOR_SHIP' | 'NO_OWN_SIGN_IN' | 'OPERATOR_EMAIL_TAKEN' | 'OPERATOR_HAS_NO_PASSWORD' | 'OPERATOR_SHIP_GETS_NO_STARTING_PROMPT' | 'OPERATOR_SHIP_HAS_NO_SECRET' | 'OPERATOR_SHIP_IS_NOT_PINGED' | 'OPERATOR_SHIP_IS_PERMANENT' | 'PAYLOAD_TOO_LARGE' | 'PING_NOT_RESENT' | 'REPORT_DETAILS_TOO_LARGE' | 'RESERVED_CONTENT_TYPE' | 'SCHEDULE_INTERVAL_TOO_SHORT' | 'SCHEDULE_LIMIT_REACHED' | 'SHIP_ALREADY_RETIRED' | 'SHIP_NAME_RESERVED' | 'SHIP_NAME_TAKEN' | 'SHIP_NOT_AWAITING_CREW' | 'SHIP_NOT_CREWED' | 'SHIP_LABEL_LIMIT_REACHED' | 'SHIP_LIMIT_REACHED' | 'SHIP_NOT_FOUND' | 'SHIP_NOT_READ_ON_BEHALF' | 'SHIP_SCOPES_FIXED' | 'SIGN_IN_TICKET_INVALID' | 'TOO_MANY_SCOPES' | 'UNKNOWN_CREW_TOKEN' | 'UNRESOLVABLE_SELECTOR' | 'WRONG_EMAIL_OR_PASSWORD' | 'WRONG_PASSWORD' | 'WRONG_SHIP_ID_OR_SECRET';
3
+ export type DomainErrorKind = 'ACCOUNT_TOKEN_ENDED' | 'ACCOUNT_TOKEN_INVALID' | 'ASSIGNEE_NOT_ACTIVE' | 'BASE_SCOPE' | 'CLEAR_REQUEST_LIMIT_REACHED' | 'CLEAR_REQUEST_NOT_FOUND' | 'CORE_NAMESPACE' | 'CREW_REQUEST_ALREADY_ASSIGNED' | 'CREW_REQUEST_NOT_ASSIGNED_TO_CALLER' | 'CREW_REQUEST_NOT_FOUND' | 'CREW_REQUEST_NOT_RELEASING' | 'CREW_REQUEST_RELEASING' | 'CREW_REQUEST_FINAL' | 'CREW_REQUEST_SETTINGS_CHANGED' | 'CREW_REQUEST_SETTINGS_INVALID' | 'CREW_REQUEST_SETTINGS_TOO_LARGE' | 'DELIVERY_HANDED_ONCE_MORE' | 'DELIVERY_HELD_BY_ANOTHER_SHIP' | 'DELIVERY_NOT_FOUND' | 'DELIVERY_NOT_A_PING' | 'DELIVERY_NOT_ACKNOWLEDGED' | 'DELIVERY_NOT_HANDED_ONCE_MORE' | 'DELIVERY_NOT_IN_FLIGHT' | 'DELIVERY_NOT_OPEN' | 'DELIVERY_NOT_UNDELIVERABLE' | 'FLEET_ALREADY_EXISTS' | 'FLEET_ALREADY_SEALED' | 'FLEET_NOT_SEALED' | 'FLEET_LIMIT_REACHED' | 'FORCE_NOT_ALLOWED' | 'FLEET_NOT_FOUND' | 'FEATURE_FLAG_OFF' | 'FEATURE_FLAG_IN_USE' | 'FLEET_HAS_NO_VIEWER' | 'VIEWER_TICKET_NAMES_NO_ACCOUNT' | 'INVALID_SCOPE' | 'INVALID_SCOPE_DESCRIPTION' | 'NAMESPACE_TAKEN' | 'NOTICE_NOT_FOUND' | 'NOTICE_NOT_DISMISSIBLE' | 'GUIDE_NOT_FOUND' | 'GUIDE_STEP_NOT_FOUND' | 'IDEMPOTENCY_KEY_REUSED' | 'KEY_NOT_BOUND_TO_FLEET' | 'KEY_UNAVAILABLE' | 'OWN_SHIP_SCOPES' | 'RESERVED_NAMESPACE' | 'SCOPE_DEFINED' | 'SCOPE_HELD' | 'SCOPE_NOT_DEFINED' | 'SCOPE_NOT_DECLARED' | 'SCOPE_NOT_HELD' | 'SERVER_STOPPING' | 'SECOND_NAMESPACE' | 'SHIP_HAS_NO_OWNER' | 'IN_REPLY_TO_NOT_FOUND' | 'MESSAGE_LIMIT_REACHED' | 'MEETING_WITHOUT_INVITEES' | 'MEETING_NOT_FOUND' | 'MEETING_ENDED' | 'SCHEDULE_NOT_FOUND' | 'ALERT_NOT_FOUND' | 'SCHEDULE_ENDED' | 'SCHEDULE_CANCELLED' | 'INVALID_TIMING' | 'INVALID_RETRY_WINDOW' | 'INVALID_GRACE' | 'FORBIDDEN' | 'CONTRIBUTION_REPLIES' | 'CONTRIBUTION_FORCED' | 'MIC_ALREADY_REQUESTED' | 'MIC_ALREADY_HELD' | 'MODERATOR_NEEDS_NO_MIC' | 'MIC_NOT_REQUESTED' | 'MIC_NOT_HELD' | 'MIC_FREE' | 'NOT_MODERATOR' | 'PARTICIPANT_NOT_FOUND' | 'PARTICIPANT_LEFT' | 'PARTICIPANT_REVOKED' | 'ALREADY_PRESENT' | 'OWNER_CANNOT_LEAVE' | 'NOT_OWNER' | 'NOT_OWNER_OR_MODERATOR' | 'MODEL_REQUIRED' | 'INVALID_HARNESS' | 'MODEL_FROM_ARGO' | 'MODEL_FROM_PERSON_APP_OR_PLUGIN' | 'INVALID_CONTENT_TYPE' | 'INVALID_EMAIL' | 'INVALID_FLEET_NAME' | 'INVALID_FOLLOW_MAX' | 'INVALID_FOLLOW_WAIT' | 'INVALID_IDEMPOTENCY_KEY' | 'INVALID_INBOX_WAIT' | 'INVALID_LABEL_KEY' | 'INVALID_LABEL_VALUE' | 'INVALID_LABEL_VALUES' | 'INVALID_LIMIT' | 'INVALID_LOCATION' | 'INVALID_OWNER' | 'INVALID_NETWORK_RULES' | 'INVALID_NETWORK_RULES_FILE' | 'INVALID_PASSWORD' | 'INVALID_RECEIVE_MAX' | 'INVALID_RECOVERY_KEY' | 'NO_RECOVERY_KEY' | 'RECOVERY_KEYS_MISMATCH' | 'INVALID_RETENTION' | 'INVALID_CREW_REQUEST_REASON' | 'INVALID_EXPECTATIONS' | 'INVALID_REPORT_DETAILS' | 'INVALID_REPORT_NOTE' | 'INVALID_REPORT_STATE' | 'INVALID_REPORT_STEP' | 'INVALID_REPORT_TASK' | 'INVALID_SHIP_NAME' | 'INVALID_SHIP_NOTE' | 'INVALID_SHIP_TYPE' | 'LABEL_CARRIED' | 'LABEL_DIFFERENCES' | 'LABEL_KEY_TAKEN' | 'ACCOUNT_OWNS_NO_LABEL' | 'LABEL_NOT_FOUND' | 'LABEL_VALUE_CARRIED' | 'LABEL_VALUE_NOT_FOUND' | 'LEASE_ENDED' | 'MESSAGE_NOT_FOUND' | 'NETWORK_SETTINGS_CHANGED' | 'NO_NETWORK_RULES_DRAFT' | 'NOT_A_TRIERARCH' | 'NOT_ALLOWED_AS_ARGO' | 'NOT_AN_AGENT_SHIP' | 'NOT_THE_LABEL_OWNER' | 'NOT_YOUR_SHIP_TO_LABEL' | 'NOT_REACHABLE' | 'BUILT_IN_RULE_FIXED' | 'NOT_THE_OPERATOR_SHIP' | 'NO_OWN_SIGN_IN' | 'OPERATOR_EMAIL_TAKEN' | 'OPERATOR_HAS_NO_PASSWORD' | 'OPERATOR_SHIP_GETS_NO_STARTING_PROMPT' | 'OPERATOR_SHIP_HAS_NO_SECRET' | 'OPERATOR_SHIP_IS_NOT_PINGED' | 'OPERATOR_SHIP_IS_PERMANENT' | 'PAYLOAD_TOO_LARGE' | 'PING_NOT_RESENT' | 'REPORT_DETAILS_TOO_LARGE' | 'RESERVED_CONTENT_TYPE' | 'SCHEDULE_INTERVAL_TOO_SHORT' | 'SCHEDULE_LIMIT_REACHED' | 'SHIP_ALREADY_RETIRED' | 'SHIP_NAME_RESERVED' | 'SHIP_NAME_TAKEN' | 'SHIP_NOT_AWAITING_CREW' | 'SHIP_NOT_CREWED' | 'SHIP_LABEL_LIMIT_REACHED' | 'SHIP_LIMIT_REACHED' | 'SHIP_NOT_FOUND' | 'SHIP_NOT_READ_ON_BEHALF' | 'SHIP_SCOPES_FIXED' | 'SIGN_IN_TICKET_INVALID' | 'TOO_MANY_SCOPES' | 'UNKNOWN_CREW_TOKEN' | 'UNRESOLVABLE_SELECTOR' | 'WRONG_EMAIL_OR_PASSWORD' | 'WRONG_PASSWORD' | 'WRONG_SHIP_ID_OR_SECRET';
4
4
  /**
5
5
  * Why the domain refused a request. Adapters map the kind to their own error
6
6
  * shape (a tRPC code, an exit code); the message is safe to show a caller.
@@ -1 +1 @@
1
- {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/domain/shared/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAY,MAAM,aAAa,CAAC;AAqL5C,qDAAqD;AACrD,MAAM,UAAU,MAAM,CAA4B,IAAO,EAAE,OAAe;IACxE,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AAChC,CAAC"}
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/domain/shared/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAY,MAAM,aAAa,CAAC;AAsL5C,qDAAqD;AACrD,MAAM,UAAU,MAAM,CAA4B,IAAO,EAAE,OAAe;IACxE,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AAChC,CAAC"}
package/dist/wiring.d.ts CHANGED
@@ -39,10 +39,11 @@ import { type ResumeSchedule } from './domain/messaging/resume-schedule.js';
39
39
  import { type SendDueSchedules } from './domain/messaging/send-due-schedules.js';
40
40
  import { type AnswerPing } from './domain/messaging/answer-ping.js';
41
41
  import { type CheckInbox } from './domain/messaging/check-inbox.js';
42
+ import { type WatchWakeups } from './domain/messaging/watch-wakeups.js';
42
43
  import { type DismissDelivery } from './domain/messaging/dismiss-delivery.js';
43
44
  import { type MarkDone } from './domain/messaging/mark-done.js';
44
45
  import { type MarkRead } from './domain/messaging/mark-read.js';
45
- import type { ReceiverWakeups } from './domain/messaging/ports.js';
46
+ import type { ReceiverWakeups, WakeStreams } from './domain/messaging/ports.js';
46
47
  import { type PushReceiveDeliveries } from './domain/messaging/push-receive-deliveries.js';
47
48
  import { type ReceiveDeliveries } from './domain/messaging/receive-deliveries.js';
48
49
  import { type ReceiveReply } from './domain/messaging/receive-reply.js';
@@ -72,6 +73,7 @@ import { type GetShip } from './domain/registry/get-ship.js';
72
73
  import { type ReadOpenAlerts } from './domain/registry/read-open-alerts.js';
73
74
  import { type ReadListedShip } from './domain/registry/read-listed-ship.js';
74
75
  import { type CountShips } from './domain/registry/count-ships.js';
76
+ import { type ReadHarbour } from './domain/registry/read-harbour.js';
75
77
  import { type ListShipTypes } from './domain/registry/list-ship-types.js';
76
78
  import { type ReadOnBehalf } from './domain/registry/read-on-behalf.js';
77
79
  import { type InitialiseFleet } from './domain/registry/initialise-fleet.js';
@@ -190,6 +192,7 @@ export interface UseCases {
190
192
  getShip: GetShip;
191
193
  readListedShip: ReadListedShip;
192
194
  countShips: CountShips;
195
+ readHarbour: ReadHarbour;
193
196
  listShipTypes: ListShipTypes;
194
197
  readOnBehalf: ReadOnBehalf;
195
198
  claimShip: ClaimShip;
@@ -278,6 +281,7 @@ export interface UseCases {
278
281
  answerPing: AnswerPing;
279
282
  pingShip: PingShip;
280
283
  checkInbox: CheckInbox;
284
+ watchWakeups: WatchWakeups;
281
285
  dismissDelivery: DismissDelivery;
282
286
  resendDelivery: ResendDelivery;
283
287
  markRead: MarkRead;
@@ -353,6 +357,8 @@ export declare function createUseCases(options: {
353
357
  clock?: Clock;
354
358
  ids?: IdGenerator;
355
359
  wakeups?: ReceiverWakeups;
360
+ /** Feed the wake streams (long-poll design, W1); without them a stream wakes only at open and sends keep-alives. */
361
+ wakeStreams?: WakeStreams;
356
362
  /** Wake a waiting follow and an inbox check with a known count; without them both end only at their wait. */
357
363
  fleetEventWakeups?: FleetEventWakeups;
358
364
  /** How long a receive waits on an empty inbox; about 25 seconds unless a test says otherwise. */
package/dist/wiring.js CHANGED
@@ -54,6 +54,7 @@ import { createSendDueSchedules } from './domain/messaging/send-due-schedules.js
54
54
  import { createPrismaScheduleAttempts } from './adapters/prisma/schedules.js';
55
55
  import { createAnswerPing } from './domain/messaging/answer-ping.js';
56
56
  import { createCheckInbox } from './domain/messaging/check-inbox.js';
57
+ import { createWatchWakeups } from './domain/messaging/watch-wakeups.js';
57
58
  import { createDismissDelivery } from './domain/messaging/dismiss-delivery.js';
58
59
  import { createMarkDone } from './domain/messaging/mark-done.js';
59
60
  import { createMarkRead } from './domain/messaging/mark-read.js';
@@ -90,6 +91,7 @@ import { createGetShip } from './domain/registry/get-ship.js';
90
91
  import { createReadOpenAlerts } from './domain/registry/read-open-alerts.js';
91
92
  import { createReadListedShip } from './domain/registry/read-listed-ship.js';
92
93
  import { createCountShips } from './domain/registry/count-ships.js';
94
+ import { createReadHarbour } from './domain/registry/read-harbour.js';
93
95
  import { createListShipTypes } from './domain/registry/list-ship-types.js';
94
96
  import { createReadOnBehalf } from './domain/registry/read-on-behalf.js';
95
97
  import { createInitialiseFleet } from './domain/registry/initialise-fleet.js';
@@ -210,6 +212,7 @@ export function createUseCases(options) {
210
212
  const bulkUow = createPrismaBulkUnitOfWork(prisma);
211
213
  const secrets = { hasher: sha256Hasher, random: cryptoRandomTokens };
212
214
  const wakeups = options.wakeups ?? createReceiverWakeups();
215
+ const wakeStreams = options.wakeStreams ?? createReceiverWakeups();
213
216
  const fleetNews = options.fleetEventWakeups ?? fleetEventWakeupsOf(createFleetEventWakeups());
214
217
  const notices = createPrismaNoticeRepository(prisma);
215
218
  const dismissals = createPrismaNoticeDismissals(prisma);
@@ -281,6 +284,7 @@ export function createUseCases(options) {
281
284
  readOpenAlerts: createReadOpenAlerts({ listing: createPrismaFleetListing(prisma), readReach }),
282
285
  readListedShip: createReadListedShip({ listing: createPrismaFleetListing(prisma), readReach }),
283
286
  countShips: createCountShips({ listing: createPrismaFleetListing(prisma), readReach }),
287
+ readHarbour: createReadHarbour({ listing: createPrismaFleetListing(prisma), readReach }),
284
288
  listShipTypes: createListShipTypes({ listing: createPrismaFleetListing(prisma), readReach }),
285
289
  readOnBehalf: createReadOnBehalf({ ships: createPrismaShipRepository(prisma) }),
286
290
  claimShip: createClaimShip({ uow, clock, ids, secrets }),
@@ -386,6 +390,7 @@ export function createUseCases(options) {
386
390
  answerPing: createAnswerPing({ uow, clock, ids }),
387
391
  pingShip: createPingShip({ uow, clock, ids, hasher: sha256Hasher, sealing }),
388
392
  checkInbox: createCheckInbox({ uow, clock, wakeups, fleetNews }),
393
+ watchWakeups: createWatchWakeups({ uow, wakeStreams }),
389
394
  dismissDelivery: createDismissDelivery({ uow, clock, ids, readReach }),
390
395
  resendDelivery: createResendDelivery({ uow, clock, ids, hasher: sha256Hasher, readReach, sealing }),
391
396
  markRead: createMarkRead({ uow, clock }),