@aeolus-fleet/trierarch-plugin 0.0.0 → 0.20.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +201 -0
- package/README.md +39 -1
- package/dist/adapters/crypto/idempotency-keys.d.ts +3 -0
- package/dist/adapters/crypto/idempotency-keys.js +4 -0
- package/dist/adapters/crypto/idempotency-keys.js.map +1 -0
- package/dist/adapters/crypto/request-hasher.d.ts +3 -0
- package/dist/adapters/crypto/request-hasher.js +4 -0
- package/dist/adapters/crypto/request-hasher.js.map +1 -0
- package/dist/adapters/fleet/console-sessions.d.ts +2 -0
- package/dist/adapters/fleet/console-sessions.js +23 -0
- package/dist/adapters/fleet/console-sessions.js.map +1 -0
- package/dist/adapters/fleet/rest-fleet-door.d.ts +2 -0
- package/dist/adapters/fleet/rest-fleet-door.js +122 -0
- package/dist/adapters/fleet/rest-fleet-door.js.map +1 -0
- package/dist/adapters/http/version.d.ts +6 -0
- package/dist/adapters/http/version.js +12 -0
- package/dist/adapters/http/version.js.map +1 -0
- package/dist/adapters/prisma/client.d.ts +10 -0
- package/dist/adapters/prisma/client.js +20 -0
- package/dist/adapters/prisma/client.js.map +1 -0
- package/dist/adapters/prisma/connection-store.d.ts +4 -0
- package/dist/adapters/prisma/connection-store.js +28 -0
- package/dist/adapters/prisma/connection-store.js.map +1 -0
- package/dist/adapters/prisma/fleet-forgetter.d.ts +4 -0
- package/dist/adapters/prisma/fleet-forgetter.js +10 -0
- package/dist/adapters/prisma/fleet-forgetter.js.map +1 -0
- package/dist/adapters/prisma/fleet-switches.d.ts +4 -0
- package/dist/adapters/prisma/fleet-switches.js +10 -0
- package/dist/adapters/prisma/fleet-switches.js.map +1 -0
- package/dist/adapters/prisma/generated/browser.d.ts +24 -0
- package/dist/adapters/prisma/generated/browser.js +18 -0
- package/dist/adapters/prisma/generated/browser.js.map +1 -0
- package/dist/adapters/prisma/generated/client.d.ts +43 -0
- package/dist/adapters/prisma/generated/client.js +38 -0
- package/dist/adapters/prisma/generated/client.js.map +1 -0
- package/dist/adapters/prisma/generated/commonInputTypes.d.ts +235 -0
- package/dist/adapters/prisma/generated/commonInputTypes.js +11 -0
- package/dist/adapters/prisma/generated/commonInputTypes.js.map +1 -0
- package/dist/adapters/prisma/generated/enums.d.ts +1 -0
- package/dist/adapters/prisma/generated/enums.js +12 -0
- package/dist/adapters/prisma/generated/enums.js.map +1 -0
- package/dist/adapters/prisma/generated/internal/class.d.ts +154 -0
- package/dist/adapters/prisma/generated/internal/class.js +50 -0
- package/dist/adapters/prisma/generated/internal/class.js.map +1 -0
- package/dist/adapters/prisma/generated/internal/prismaNamespace.d.ts +766 -0
- package/dist/adapters/prisma/generated/internal/prismaNamespace.js +117 -0
- package/dist/adapters/prisma/generated/internal/prismaNamespace.js.map +1 -0
- package/dist/adapters/prisma/generated/internal/prismaNamespaceBrowser.d.ts +78 -0
- package/dist/adapters/prisma/generated/internal/prismaNamespaceBrowser.js +87 -0
- package/dist/adapters/prisma/generated/internal/prismaNamespaceBrowser.js.map +1 -0
- package/dist/adapters/prisma/generated/models/Connection.d.ts +1011 -0
- package/dist/adapters/prisma/generated/models/Connection.js +2 -0
- package/dist/adapters/prisma/generated/models/Connection.js.map +1 -0
- package/dist/adapters/prisma/generated/models/FleetSwitch.d.ts +945 -0
- package/dist/adapters/prisma/generated/models/FleetSwitch.js +2 -0
- package/dist/adapters/prisma/generated/models/FleetSwitch.js.map +1 -0
- package/dist/adapters/prisma/generated/models/InstallationRequest.d.ts +1030 -0
- package/dist/adapters/prisma/generated/models/InstallationRequest.js +2 -0
- package/dist/adapters/prisma/generated/models/InstallationRequest.js.map +1 -0
- package/dist/adapters/prisma/generated/models.d.ts +4 -0
- package/dist/adapters/prisma/generated/models.js +2 -0
- package/dist/adapters/prisma/generated/models.js.map +1 -0
- package/dist/adapters/prisma/installation-requests.d.ts +4 -0
- package/dist/adapters/prisma/installation-requests.js +25 -0
- package/dist/adapters/prisma/installation-requests.js.map +1 -0
- package/dist/adapters/prisma/migrate.d.ts +5 -0
- package/dist/adapters/prisma/migrate.js +40 -0
- package/dist/adapters/prisma/migrate.js.map +1 -0
- package/dist/adapters/trpc/router.d.ts +303 -0
- package/dist/adapters/trpc/router.js +227 -0
- package/dist/adapters/trpc/router.js.map +1 -0
- package/dist/app.d.ts +42 -0
- package/dist/app.js +205 -0
- package/dist/app.js.map +1 -0
- package/dist/bin/aeolus-trierarch-plugin.d.ts +2 -0
- package/dist/bin/aeolus-trierarch-plugin.js +61 -0
- package/dist/bin/aeolus-trierarch-plugin.js.map +1 -0
- package/dist/config.d.ts +32 -0
- package/dist/config.js +49 -0
- package/dist/config.js.map +1 -0
- package/dist/core/assignment/assign-crews.d.ts +27 -0
- package/dist/core/assignment/assign-crews.js +49 -0
- package/dist/core/assignment/assign-crews.js.map +1 -0
- package/dist/core/assignment/check-crew-settings.d.ts +19 -0
- package/dist/core/assignment/check-crew-settings.js +24 -0
- package/dist/core/assignment/check-crew-settings.js.map +1 -0
- package/dist/core/assignment/placement.d.ts +59 -0
- package/dist/core/assignment/placement.js +113 -0
- package/dist/core/assignment/placement.js.map +1 -0
- package/dist/core/assignment/read-placement.d.ts +17 -0
- package/dist/core/assignment/read-placement.js +39 -0
- package/dist/core/assignment/read-placement.js.map +1 -0
- package/dist/core/connection/connect.d.ts +26 -0
- package/dist/core/connection/connect.js +44 -0
- package/dist/core/connection/connect.js.map +1 -0
- package/dist/core/connection/ports.d.ts +177 -0
- package/dist/core/connection/ports.js +2 -0
- package/dist/core/connection/ports.js.map +1 -0
- package/dist/core/connection/read-connection.d.ts +14 -0
- package/dist/core/connection/read-connection.js +24 -0
- package/dist/core/connection/read-connection.js.map +1 -0
- package/dist/core/installation/delete-fleet.d.ts +21 -0
- package/dist/core/installation/delete-fleet.js +21 -0
- package/dist/core/installation/delete-fleet.js.map +1 -0
- package/dist/core/installation/ports.d.ts +46 -0
- package/dist/core/installation/ports.js +2 -0
- package/dist/core/installation/ports.js.map +1 -0
- package/dist/core/installation/read-fleet.d.ts +18 -0
- package/dist/core/installation/read-fleet.js +9 -0
- package/dist/core/installation/read-fleet.js.map +1 -0
- package/dist/core/installation/request-id.d.ts +8 -0
- package/dist/core/installation/request-id.js +10 -0
- package/dist/core/installation/request-id.js.map +1 -0
- package/dist/core/installation/served.d.ts +12 -0
- package/dist/core/installation/served.js +8 -0
- package/dist/core/installation/served.js.map +1 -0
- package/dist/core/installation/set-fleet-enabled.d.ts +24 -0
- package/dist/core/installation/set-fleet-enabled.js +21 -0
- package/dist/core/installation/set-fleet-enabled.js.map +1 -0
- package/dist/core/machines/join-machine.d.ts +40 -0
- package/dist/core/machines/join-machine.js +35 -0
- package/dist/core/machines/join-machine.js.map +1 -0
- package/dist/core/machines/label-machines.d.ts +25 -0
- package/dist/core/machines/label-machines.js +120 -0
- package/dist/core/machines/label-machines.js.map +1 -0
- package/dist/core/machines/list-machines.d.ts +34 -0
- package/dist/core/machines/list-machines.js +47 -0
- package/dist/core/machines/list-machines.js.map +1 -0
- package/dist/core/machines/ports.d.ts +4 -0
- package/dist/core/machines/ports.js +2 -0
- package/dist/core/machines/ports.js.map +1 -0
- package/dist/core/machines/silent.d.ts +9 -0
- package/dist/core/machines/silent.js +9 -0
- package/dist/core/machines/silent.js.map +1 -0
- package/dist/core/operator/authenticate-operator.d.ts +21 -0
- package/dist/core/operator/authenticate-operator.js +26 -0
- package/dist/core/operator/authenticate-operator.js.map +1 -0
- package/dist/core/operator/ports.d.ts +15 -0
- package/dist/core/operator/ports.js +2 -0
- package/dist/core/operator/ports.js.map +1 -0
- package/dist/core/shared/clock.d.ts +4 -0
- package/dist/core/shared/clock.js +2 -0
- package/dist/core/shared/clock.js.map +1 -0
- package/dist/core/shared/errors.d.ts +10 -0
- package/dist/core/shared/errors.js +6 -0
- package/dist/core/shared/errors.js.map +1 -0
- package/dist/core/shared/result.d.ts +16 -0
- package/dist/core/shared/result.js +7 -0
- package/dist/core/shared/result.js.map +1 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.js +3 -0
- package/dist/index.js.map +1 -0
- package/package.json +47 -3
- package/prisma.config.ts +18 -0
- package/src/adapters/prisma/migrations/20261006220000_init/migration.sql +35 -0
- package/src/adapters/prisma/migrations/migration_lock.toml +3 -0
- package/src/adapters/prisma/schema.prisma +58 -0
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
import { crewSettingsSchema, NO_MACHINE_MATCHES_REASON } from '@aeolus-fleet/common';
|
|
2
|
+
import { z } from 'zod';
|
|
3
|
+
/** An issue as one line: its path, when it has one, and its message. */
|
|
4
|
+
function lineOf(issue, prefix = []) {
|
|
5
|
+
const path = [...prefix, ...issue.path.map(String)].join('.');
|
|
6
|
+
return path === '' ? issue.message : `${path}: ${issue.message}`;
|
|
7
|
+
}
|
|
8
|
+
/** Why the harness's options schema refuses the options, or undefined when it takes them. A schema it cannot read refuses them all. */
|
|
9
|
+
function optionsRefusal(schema, options) {
|
|
10
|
+
let checked;
|
|
11
|
+
try {
|
|
12
|
+
checked = z.fromJSONSchema(schema);
|
|
13
|
+
}
|
|
14
|
+
catch {
|
|
15
|
+
return 'options: the trierarch reports an options schema that cannot be read';
|
|
16
|
+
}
|
|
17
|
+
const result = checked.safeParse(options);
|
|
18
|
+
const [issue] = result.success ? [] : result.error.issues;
|
|
19
|
+
return issue === undefined ? undefined : lineOf(issue, ['options']);
|
|
20
|
+
}
|
|
21
|
+
function offersWorkspace(details, workspace) {
|
|
22
|
+
return workspace.kind === 'worktree' ? details.workspaces.repositories.includes(workspace.repository) : details.workspaces.folders.includes(workspace.name);
|
|
23
|
+
}
|
|
24
|
+
function workspaceName(workspace) {
|
|
25
|
+
return workspace.kind === 'worktree' ? `repository ${workspace.repository}` : `folder ${workspace.name}`;
|
|
26
|
+
}
|
|
27
|
+
/** Room left as a share of its cap: what placement compares. */
|
|
28
|
+
function roomShare(trierarch) {
|
|
29
|
+
return (trierarch.details.caps.ships - trierarch.assigned) / trierarch.details.caps.ships;
|
|
30
|
+
}
|
|
31
|
+
/** The trierarch to claim for the settings, or why none fits: machine labels, harness, workspace, options, then room. */
|
|
32
|
+
function fit(settings, trierarchs) {
|
|
33
|
+
if (trierarchs.length === 0) {
|
|
34
|
+
return { reason: 'no trierarch reports yet' };
|
|
35
|
+
}
|
|
36
|
+
const machineLabels = settings.machineLabels ?? [];
|
|
37
|
+
const matching = trierarchs.filter((trierarch) => machineLabels.every((valueId) => trierarch.labelValueIds.includes(valueId)));
|
|
38
|
+
if (matching.length === 0) {
|
|
39
|
+
// Allowed, not refused (#102, Q8): the request waits until a machine carries them all.
|
|
40
|
+
return { reason: NO_MACHINE_MATCHES_REASON };
|
|
41
|
+
}
|
|
42
|
+
const offering = matching.flatMap((trierarch) => {
|
|
43
|
+
const harness = trierarch.details.harnesses.find((each) => each.harness === settings.harness);
|
|
44
|
+
return harness === undefined ? [] : [{ trierarch, harness }];
|
|
45
|
+
});
|
|
46
|
+
if (offering.length === 0) {
|
|
47
|
+
return { reason: `no trierarch offers harness ${settings.harness}`, field: 'harness' };
|
|
48
|
+
}
|
|
49
|
+
const withWorkspace = offering.filter(({ trierarch }) => offersWorkspace(trierarch.details, settings.workspace));
|
|
50
|
+
if (withWorkspace.length === 0) {
|
|
51
|
+
return { reason: `no trierarch offering ${settings.harness} has ${workspaceName(settings.workspace)}`, field: 'workspace' };
|
|
52
|
+
}
|
|
53
|
+
const refusals = withWorkspace.map(({ trierarch, harness }) => ({ trierarch, refusal: optionsRefusal(harness.options, settings.options) }));
|
|
54
|
+
const taking = refusals.filter(({ refusal }) => refusal === undefined).map(({ trierarch }) => trierarch);
|
|
55
|
+
const [firstRefusal] = refusals;
|
|
56
|
+
if (taking.length === 0) {
|
|
57
|
+
return { reason: `no trierarch takes these options for ${settings.harness}: ${firstRefusal?.refusal ?? ''}`, field: 'options' };
|
|
58
|
+
}
|
|
59
|
+
const [best] = taking
|
|
60
|
+
.filter((trierarch) => trierarch.assigned < trierarch.details.caps.ships)
|
|
61
|
+
.sort((first, second) => roomShare(second) - roomShare(first) || first.commissionedAt.getTime() - second.commissionedAt.getTime() || first.shipId.localeCompare(second.shipId));
|
|
62
|
+
return best === undefined ? { reason: `no trierarch with room: all ${String(taking.length)} that fit are full` } : { trierarch: best };
|
|
63
|
+
}
|
|
64
|
+
/** The settings as crew settings, or why not: the first issue, with the field it is in. */
|
|
65
|
+
function parsed(settings) {
|
|
66
|
+
const result = crewSettingsSchema.safeParse(settings);
|
|
67
|
+
if (result.success) {
|
|
68
|
+
return { settings: result.data };
|
|
69
|
+
}
|
|
70
|
+
const [issue] = result.error.issues;
|
|
71
|
+
return { reason: `settings are not valid crew settings: ${issue === undefined ? 'unreadable' : lineOf(issue)}`, field: issue?.path[0] === undefined ? 'settings' : String(issue.path[0]) };
|
|
72
|
+
}
|
|
73
|
+
/**
|
|
74
|
+
* Policy: whether settings would be placed now, before anything is requested
|
|
75
|
+
* (#245): by the same rules as placement, against the trierarchs as they are.
|
|
76
|
+
*/
|
|
77
|
+
export function checkPlacement(settings, trierarchs) {
|
|
78
|
+
const read = parsed(settings);
|
|
79
|
+
const fitted = 'settings' in read ? fit(read.settings, trierarchs) : read;
|
|
80
|
+
if ('trierarch' in fitted) {
|
|
81
|
+
return { kind: 'fits' };
|
|
82
|
+
}
|
|
83
|
+
return fitted.field === undefined ? { kind: 'noRoom', reason: fitted.reason } : { kind: 'refused', field: fitted.field, reason: fitted.reason };
|
|
84
|
+
}
|
|
85
|
+
/**
|
|
86
|
+
* Policy: where each unassigned request goes (docs/trierarch.md,
|
|
87
|
+
* "Assignment"). Oldest request first, each to a trierarch whose ship
|
|
88
|
+
* carries every machine label it names, that offers its harness and workspace, takes its options against the schema it reports for
|
|
89
|
+
* that harness, and has room (its cap above the requests assigned to it);
|
|
90
|
+
* of those, the most room as a share of its cap, then the oldest. What it
|
|
91
|
+
* assigns counts against the room of later requests in the same pass. A
|
|
92
|
+
* request none fits gets the reason, unless that reason is written already.
|
|
93
|
+
*/
|
|
94
|
+
export function place(requests, trierarchs) {
|
|
95
|
+
const assigned = new Map(trierarchs.map((trierarch) => [trierarch.shipId, trierarch.assigned]));
|
|
96
|
+
const placements = [];
|
|
97
|
+
const oldestFirst = [...requests].sort((first, second) => first.requestedAt.getTime() - second.requestedAt.getTime() || first.shipId.localeCompare(second.shipId));
|
|
98
|
+
for (const request of oldestFirst) {
|
|
99
|
+
const read = parsed(request.settings);
|
|
100
|
+
const fitted = 'settings' in read
|
|
101
|
+
? fit(read.settings, trierarchs.map((trierarch) => ({ ...trierarch, assigned: assigned.get(trierarch.shipId) ?? trierarch.assigned })))
|
|
102
|
+
: read;
|
|
103
|
+
if ('trierarch' in fitted) {
|
|
104
|
+
assigned.set(fitted.trierarch.shipId, (assigned.get(fitted.trierarch.shipId) ?? 0) + 1);
|
|
105
|
+
placements.push({ kind: 'assign', shipId: request.shipId, trierarchShipId: fitted.trierarch.shipId });
|
|
106
|
+
}
|
|
107
|
+
else if (fitted.reason !== request.reason) {
|
|
108
|
+
placements.push({ kind: 'explain', shipId: request.shipId, reason: fitted.reason });
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
return placements;
|
|
112
|
+
}
|
|
113
|
+
//# sourceMappingURL=placement.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"placement.js","sourceRoot":"","sources":["../../../src/core/assignment/placement.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import type { FleetDoor, FleetRefusal } from '../connection/ports.js';
|
|
2
|
+
import { type Result } from '../shared/result.js';
|
|
3
|
+
import type { PlacementRequest, PlacementTrierarch } from './placement.js';
|
|
4
|
+
/**
|
|
5
|
+
* What placement reads from the fleet, whole, each time (docs/trierarch.md,
|
|
6
|
+
* "Assignment"): the unassigned requests of ships that await crew, and the
|
|
7
|
+
* trierarchs that report details and are not silent, with the requests
|
|
8
|
+
* assigned to each. A silent trierarch gets nothing new.
|
|
9
|
+
*/
|
|
10
|
+
export declare function readPlacement(door: FleetDoor, at: {
|
|
11
|
+
crewToken: string;
|
|
12
|
+
now: Date;
|
|
13
|
+
silentAfterMs: number;
|
|
14
|
+
}): Promise<Result<{
|
|
15
|
+
requests: PlacementRequest[];
|
|
16
|
+
trierarchs: PlacementTrierarch[];
|
|
17
|
+
}, FleetRefusal>>;
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
import { trierarchReportDetailsSchema } from '@aeolus-fleet/common';
|
|
2
|
+
import { TRIERARCH_TYPE } from '../machines/join-machine.js';
|
|
3
|
+
import { isSilent } from '../machines/silent.js';
|
|
4
|
+
import { ok } from '../shared/result.js';
|
|
5
|
+
/**
|
|
6
|
+
* What placement reads from the fleet, whole, each time (docs/trierarch.md,
|
|
7
|
+
* "Assignment"): the unassigned requests of ships that await crew, and the
|
|
8
|
+
* trierarchs that report details and are not silent, with the requests
|
|
9
|
+
* assigned to each. A silent trierarch gets nothing new.
|
|
10
|
+
*/
|
|
11
|
+
export async function readPlacement(door, at) {
|
|
12
|
+
const listed = await door.listShips(at.crewToken);
|
|
13
|
+
if (!listed.isOk) {
|
|
14
|
+
return listed;
|
|
15
|
+
}
|
|
16
|
+
const trierarchs = [];
|
|
17
|
+
const requests = [];
|
|
18
|
+
for (const ship of listed.value) {
|
|
19
|
+
const isTrierarch = ship.type === TRIERARCH_TYPE && ship.status !== 'retired' && !isSilent(ship.lastSeenAt, { now: at.now, silentAfterMs: at.silentAfterMs });
|
|
20
|
+
const isRequest = ship.status === 'awaitingCrew' && ship.crewRequest !== null && ship.crewRequest.assignedTo === null;
|
|
21
|
+
if (!isTrierarch && !isRequest) {
|
|
22
|
+
continue;
|
|
23
|
+
}
|
|
24
|
+
const read = await door.getShip(at.crewToken, { shipId: ship.shipId });
|
|
25
|
+
if (!read.isOk) {
|
|
26
|
+
return read;
|
|
27
|
+
}
|
|
28
|
+
const details = trierarchReportDetailsSchema.safeParse(read.value.report?.details);
|
|
29
|
+
if (isTrierarch && details.success) {
|
|
30
|
+
const assigned = listed.value.filter((each) => each.crewRequest?.assignedTo === ship.shipId).length;
|
|
31
|
+
trierarchs.push({ shipId: ship.shipId, commissionedAt: read.value.commissionedAt, details: details.data, assigned, labelValueIds: ship.labels.map((label) => label.valueId) });
|
|
32
|
+
}
|
|
33
|
+
if (isRequest && ship.crewRequest !== null) {
|
|
34
|
+
requests.push({ shipId: ship.shipId, requestedAt: ship.crewRequest.requestedAt, settings: read.value.crewSettings, reason: ship.crewRequest.reason });
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
return ok({ requests, trierarchs });
|
|
38
|
+
}
|
|
39
|
+
//# sourceMappingURL=read-placement.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"read-placement.js","sourceRoot":"","sources":["../../../src/core/assignment/read-placement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAGpE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AAGtD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAe,EACf,EAA2D;IAE3D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;IAClD,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,UAAU,GAAyB,EAAE,CAAC;IAC5C,MAAM,QAAQ,GAAuB,EAAE,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,KAAK,cAAc,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC;QAC9J,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,KAAK,cAAc,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,UAAU,KAAK,IAAI,CAAC;QACtH,IAAI,CAAC,WAAW,IAAI,CAAC,SAAS,EAAE,CAAC;YAC/B,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACvE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,OAAO,GAAG,4BAA4B,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnF,IAAI,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;YACpG,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACjL,CAAC;QACD,IAAI,SAAS,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QACxJ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;AACtC,CAAC"}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import type { FleetId, ShipId } from '@aeolus-fleet/common';
|
|
2
|
+
import type { Clock } from '../shared/clock.js';
|
|
3
|
+
import { type DomainError } from '../shared/errors.js';
|
|
4
|
+
import { type Result } from '../shared/result.js';
|
|
5
|
+
import type { ConnectionStatus, FleetDoor, ConnectionStore } from './ports.js';
|
|
6
|
+
export type ConnectRefusal = DomainError<'ALREADY_CONNECTED' | 'SECRET_REFUSED' | 'OTHER_FLEET' | 'MISSING_SCOPES'>;
|
|
7
|
+
export type Connect = (input: {
|
|
8
|
+
operatorFleetId: FleetId;
|
|
9
|
+
shipId: ShipId;
|
|
10
|
+
secret: string;
|
|
11
|
+
}) => Promise<Result<ConnectionStatus, ConnectRefusal>>;
|
|
12
|
+
/**
|
|
13
|
+
* Use case: the operator connects the trierarch plugin, as squadrons is
|
|
14
|
+
* connected. The console's server hands it its ship's secret, server to
|
|
15
|
+
* server; the trierarch plugin registers with it as a server and keeps only
|
|
16
|
+
* the crew token. The ship must be of the operator's fleet and hold
|
|
17
|
+
* fleet:read, fleet:manage and crew:assign, or the trierarch plugin lets it go
|
|
18
|
+
* again and keeps nothing. Each fleet has its own connection: connect works
|
|
19
|
+
* only while the trierarch plugin is not connected to the operator's fleet,
|
|
20
|
+
* whatever other fleets it serves. The secret is never kept or logged.
|
|
21
|
+
*/
|
|
22
|
+
export declare function createConnect(deps: {
|
|
23
|
+
door: FleetDoor;
|
|
24
|
+
store: ConnectionStore;
|
|
25
|
+
clock: Clock;
|
|
26
|
+
}): Connect;
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import { refuse } from '../shared/errors.js';
|
|
2
|
+
import { ok } from '../shared/result.js';
|
|
3
|
+
/** What the trierarch plugin's ship does (decision 0030): read the fleet, commission machines' ships and assign crew requests. */
|
|
4
|
+
const PLUGIN_SCOPES = ['fleet:read', 'fleet:manage', 'crew:assign'];
|
|
5
|
+
/**
|
|
6
|
+
* Use case: the operator connects the trierarch plugin, as squadrons is
|
|
7
|
+
* connected. The console's server hands it its ship's secret, server to
|
|
8
|
+
* server; the trierarch plugin registers with it as a server and keeps only
|
|
9
|
+
* the crew token. The ship must be of the operator's fleet and hold
|
|
10
|
+
* fleet:read, fleet:manage and crew:assign, or the trierarch plugin lets it go
|
|
11
|
+
* again and keeps nothing. Each fleet has its own connection: connect works
|
|
12
|
+
* only while the trierarch plugin is not connected to the operator's fleet,
|
|
13
|
+
* whatever other fleets it serves. The secret is never kept or logged.
|
|
14
|
+
*/
|
|
15
|
+
export function createConnect(deps) {
|
|
16
|
+
return async ({ operatorFleetId, shipId, secret }) => {
|
|
17
|
+
if (await deps.store.find(operatorFleetId)) {
|
|
18
|
+
return refuse('ALREADY_CONNECTED', 'The trierarch plugin is connected to this fleet already');
|
|
19
|
+
}
|
|
20
|
+
const registered = await deps.door.register({ shipId, secret });
|
|
21
|
+
if (!registered.isOk) {
|
|
22
|
+
return refuse('SECRET_REFUSED', `The fleet refused its ship's secret: ${registered.error.message}`);
|
|
23
|
+
}
|
|
24
|
+
const { crewToken } = registered.value;
|
|
25
|
+
const letGo = async (kind, message) => {
|
|
26
|
+
await deps.door.deregister(crewToken);
|
|
27
|
+
return refuse(kind, message);
|
|
28
|
+
};
|
|
29
|
+
const who = await deps.door.whoami(crewToken);
|
|
30
|
+
if (!who.isOk) {
|
|
31
|
+
return letGo('SECRET_REFUSED', `The fleet refused the new crew token: ${who.error.message}`);
|
|
32
|
+
}
|
|
33
|
+
if (who.value.fleetId !== operatorFleetId) {
|
|
34
|
+
return letGo('OTHER_FLEET', "The ship belongs to another fleet than the operator's");
|
|
35
|
+
}
|
|
36
|
+
const ship = await deps.door.getShip(crewToken, { shipId });
|
|
37
|
+
if (!ship.isOk || !PLUGIN_SCOPES.every((scope) => ship.value.scopes.includes(scope))) {
|
|
38
|
+
return letGo('MISSING_SCOPES', 'The ship needs fleet:read, fleet:manage and crew:assign');
|
|
39
|
+
}
|
|
40
|
+
await deps.store.save({ fleetId: who.value.fleetId, shipId, name: who.value.name, crewToken, crewedAt: deps.clock.now() });
|
|
41
|
+
return ok({ state: 'connected', ship: { shipId, name: who.value.name }, lastShipId: shipId });
|
|
42
|
+
};
|
|
43
|
+
}
|
|
44
|
+
//# sourceMappingURL=connect.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../../src/core/connection/connect.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AAOtD,kIAAkI;AAClI,MAAM,aAAa,GAAG,CAAC,YAAY,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;AAEpE;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,IAA+D;IAC3F,OAAO,KAAK,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;QACnD,IAAI,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;YAC3C,OAAO,MAAM,CAAC,mBAAmB,EAAE,yDAAyD,CAAC,CAAC;QAChG,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YACrB,OAAO,MAAM,CAAC,gBAAgB,EAAE,wCAAwC,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACtG,CAAC;QACD,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC;QACvC,MAAM,KAAK,GAAG,KAAK,EAAoC,IAAO,EAAE,OAAe,EAAE,EAAE;YACjF,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;YACtC,OAAO,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/B,CAAC,CAAC;QAEF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,KAAK,CAAC,gBAAgB,EAAE,yCAAyC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/F,CAAC;QACD,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,eAAe,EAAE,CAAC;YAC1C,OAAO,KAAK,CAAC,aAAa,EAAE,uDAAuD,CAAC,CAAC;QACvF,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACrF,OAAO,KAAK,CAAC,gBAAgB,EAAE,yDAAyD,CAAC,CAAC;QAC5F,CAAC;QAED,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC3H,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;IAChG,CAAC,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,177 @@
|
|
|
1
|
+
import type { CrewLine, FleetId, LabelId, LabelValueId, ShipId } from '@aeolus-fleet/common';
|
|
2
|
+
import type { Result } from '../shared/result.js';
|
|
3
|
+
/**
|
|
4
|
+
* Why the fleet refused a ship call: its code (CONFLICT, UNAUTHORIZED,
|
|
5
|
+
* LEASE_ENDED, ...) and its message. UNAVAILABLE: no answer came, so the call
|
|
6
|
+
* may or may not have been carried out.
|
|
7
|
+
*/
|
|
8
|
+
export interface FleetRefusal {
|
|
9
|
+
code: string;
|
|
10
|
+
message: string;
|
|
11
|
+
}
|
|
12
|
+
/** A ship's starting prompt as the fleet issues it once: the prompt, its crew lines and the secret they hold. */
|
|
13
|
+
export interface IssuedPrompt {
|
|
14
|
+
prompt: string;
|
|
15
|
+
crewLines: CrewLine[];
|
|
16
|
+
secret: string;
|
|
17
|
+
}
|
|
18
|
+
/** A ship as `fleet.list` lists it: what the trierarch plugin reads of it. */
|
|
19
|
+
export interface ListedShip {
|
|
20
|
+
shipId: ShipId;
|
|
21
|
+
name: string;
|
|
22
|
+
type: string;
|
|
23
|
+
status: 'awaitingCrew' | 'crewed' | 'retired';
|
|
24
|
+
/** When its session last called the fleet; null while no session crews it. */
|
|
25
|
+
lastSeenAt: Date | null;
|
|
26
|
+
/** Its crew request, without its settings; null when it holds none. */
|
|
27
|
+
crewRequest: {
|
|
28
|
+
requestedAt: Date;
|
|
29
|
+
assignedTo: ShipId | null;
|
|
30
|
+
reason: string | null;
|
|
31
|
+
} | null;
|
|
32
|
+
/** The label values it carries, every owner's, with their labels (#102). */
|
|
33
|
+
labels: {
|
|
34
|
+
labelId: LabelId;
|
|
35
|
+
valueId: LabelValueId;
|
|
36
|
+
}[];
|
|
37
|
+
}
|
|
38
|
+
/** A ship as `fleet.ship` shows it: what the trierarch plugin reads of it. */
|
|
39
|
+
export interface FleetShip {
|
|
40
|
+
status: 'awaitingCrew' | 'crewed' | 'retired';
|
|
41
|
+
scopes: string[];
|
|
42
|
+
commissionedAt: Date;
|
|
43
|
+
/** Its crew's last report, details included as the fleet holds them; null until its crew reports. */
|
|
44
|
+
report: {
|
|
45
|
+
state: string;
|
|
46
|
+
note: string | null;
|
|
47
|
+
reportedAt: Date;
|
|
48
|
+
details: unknown;
|
|
49
|
+
} | null;
|
|
50
|
+
/** Its crew request's settings, unread; null when it holds no crew request. */
|
|
51
|
+
crewSettings: unknown;
|
|
52
|
+
}
|
|
53
|
+
/** A label of the fleet as `fleet.labels` lists it: its key, its values and the ship that owns it (#102). */
|
|
54
|
+
export interface ListedLabel {
|
|
55
|
+
labelId: LabelId;
|
|
56
|
+
key: string;
|
|
57
|
+
values: {
|
|
58
|
+
valueId: LabelValueId;
|
|
59
|
+
value: string;
|
|
60
|
+
}[];
|
|
61
|
+
ownerShipId: ShipId;
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
* Outbound port: the fleet's public ship calls, as the trierarch plugin makes
|
|
65
|
+
* them for its own ship. The trierarch plugin is a ship like any other
|
|
66
|
+
* (decision 0030).
|
|
67
|
+
*/
|
|
68
|
+
export interface FleetDoor {
|
|
69
|
+
register(claim: {
|
|
70
|
+
shipId: ShipId;
|
|
71
|
+
secret: string;
|
|
72
|
+
}): Promise<Result<{
|
|
73
|
+
crewToken: string;
|
|
74
|
+
}, FleetRefusal>>;
|
|
75
|
+
whoami(crewToken: string): Promise<Result<{
|
|
76
|
+
shipId: ShipId;
|
|
77
|
+
fleetId: FleetId;
|
|
78
|
+
name: string;
|
|
79
|
+
type: string;
|
|
80
|
+
}, FleetRefusal>>;
|
|
81
|
+
/** A ship of the fleet, retired ones included; needs fleet:read. */
|
|
82
|
+
getShip(crewToken: string, ship: {
|
|
83
|
+
shipId: ShipId;
|
|
84
|
+
}): Promise<Result<FleetShip, FleetRefusal>>;
|
|
85
|
+
/** Ends this session's crew of its ship: the lease and the secret it claimed with. */
|
|
86
|
+
deregister(crewToken: string): Promise<Result<undefined, FleetRefusal>>;
|
|
87
|
+
/**
|
|
88
|
+
* Commissions a ship as the crew token's ship (fleet:manage) under a new
|
|
89
|
+
* idempotency key, with the fleet scopes given beside the send and receive
|
|
90
|
+
* every agent ship has: its id and its starting prompt, issued once.
|
|
91
|
+
*/
|
|
92
|
+
commission(crewToken: string, ship: {
|
|
93
|
+
name: string;
|
|
94
|
+
type: string;
|
|
95
|
+
fleetScopes: string[];
|
|
96
|
+
idempotencyKey: string;
|
|
97
|
+
}): Promise<Result<{
|
|
98
|
+
shipId: ShipId;
|
|
99
|
+
} & IssuedPrompt, FleetRefusal>>;
|
|
100
|
+
/** Every ship of the fleet, retired ones included (fleet:read). */
|
|
101
|
+
listShips(crewToken: string): Promise<Result<ListedShip[], FleetRefusal>>;
|
|
102
|
+
/** Claims a ship's crew request for a trierarch (crew:assign), only while it is unassigned: a lost claim is CONFLICT. */
|
|
103
|
+
assignCrew(crewToken: string, claim: {
|
|
104
|
+
shipId: ShipId;
|
|
105
|
+
trierarchShipId: ShipId;
|
|
106
|
+
}): Promise<Result<undefined, FleetRefusal>>;
|
|
107
|
+
/** Every label of the fleet, with its owner (fleet:read). */
|
|
108
|
+
listLabels(crewToken: string): Promise<Result<ListedLabel[], FleetRefusal>>;
|
|
109
|
+
/** Defines a label the crew token's ship owns (labels:define); a key the fleet has already is CONFLICT. */
|
|
110
|
+
defineLabel(crewToken: string, label: {
|
|
111
|
+
key: string;
|
|
112
|
+
values: string[];
|
|
113
|
+
}): Promise<Result<{
|
|
114
|
+
labelId: LabelId;
|
|
115
|
+
values: {
|
|
116
|
+
valueId: LabelValueId;
|
|
117
|
+
value: string;
|
|
118
|
+
}[];
|
|
119
|
+
}, FleetRefusal>>;
|
|
120
|
+
/** Puts one of its own label values on a ship (labels:assign). */
|
|
121
|
+
assignLabel(crewToken: string, assignment: {
|
|
122
|
+
shipId: ShipId;
|
|
123
|
+
valueId: LabelValueId;
|
|
124
|
+
}): Promise<Result<undefined, FleetRefusal>>;
|
|
125
|
+
/** Takes one of its own label values off a ship (labels:assign). */
|
|
126
|
+
unassignLabel(crewToken: string, assignment: {
|
|
127
|
+
shipId: ShipId;
|
|
128
|
+
valueId: LabelValueId;
|
|
129
|
+
}): Promise<Result<undefined, FleetRefusal>>;
|
|
130
|
+
/** Writes why no trierarch can take a ship's unassigned crew request (crew:assign). */
|
|
131
|
+
explainCrewRequest(crewToken: string, explanation: {
|
|
132
|
+
shipId: ShipId;
|
|
133
|
+
reason: string | null;
|
|
134
|
+
}): Promise<Result<undefined, FleetRefusal>>;
|
|
135
|
+
}
|
|
136
|
+
/** The crew token the trierarch plugin holds for its ship in a fleet, and when it got it. */
|
|
137
|
+
export interface PluginCrew {
|
|
138
|
+
/** The fleet the ship belongs to: the fleet the trierarch plugin serves. */
|
|
139
|
+
fleetId: FleetId;
|
|
140
|
+
shipId: ShipId;
|
|
141
|
+
/** The ship's name when the trierarch plugin connected, shown while the fleet does not answer. */
|
|
142
|
+
name: string;
|
|
143
|
+
crewToken: string;
|
|
144
|
+
crewedAt: Date;
|
|
145
|
+
}
|
|
146
|
+
/** The fleet and ship the trierarch plugin was last connected as; kept when its crew token is dropped. */
|
|
147
|
+
export interface PluginBinding {
|
|
148
|
+
fleetId: FleetId;
|
|
149
|
+
shipId: ShipId;
|
|
150
|
+
}
|
|
151
|
+
/**
|
|
152
|
+
* Outbound port: where the trierarch plugin keeps each fleet's crew token
|
|
153
|
+
* across restarts. One install serves many fleets, one connection each.
|
|
154
|
+
*/
|
|
155
|
+
export interface ConnectionStore {
|
|
156
|
+
/** The fleet's crew, while the trierarch plugin holds a crew token for it: while it is connected to that fleet. */
|
|
157
|
+
find(fleetId: FleetId): Promise<PluginCrew | undefined>;
|
|
158
|
+
/** The fleet's last connection, with or without a crew token; none before its first. */
|
|
159
|
+
binding(fleetId: FleetId): Promise<PluginBinding | undefined>;
|
|
160
|
+
/** Every fleet's crew the trierarch plugin holds a crew token for: the fleets it is connected to. */
|
|
161
|
+
connected(): Promise<PluginCrew[]>;
|
|
162
|
+
save(crew: PluginCrew): Promise<void>;
|
|
163
|
+
/** Forgets the fleet's crew token, keeping its binding: the trierarch plugin is not connected to that fleet. */
|
|
164
|
+
drop(fleetId: FleetId): Promise<void>;
|
|
165
|
+
}
|
|
166
|
+
/**
|
|
167
|
+
* Whether the trierarch plugin holds a working crew token for its ship, as
|
|
168
|
+
* which ship, and the ship it was last connected as.
|
|
169
|
+
*/
|
|
170
|
+
export interface ConnectionStatus {
|
|
171
|
+
state: 'not-connected' | 'connected';
|
|
172
|
+
ship: {
|
|
173
|
+
shipId: ShipId;
|
|
174
|
+
name: string;
|
|
175
|
+
} | null;
|
|
176
|
+
lastShipId: ShipId | null;
|
|
177
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../../src/core/connection/ports.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import type { FleetId } from '@aeolus-fleet/common';
|
|
2
|
+
import type { ConnectionStatus, FleetDoor, ConnectionStore } from './ports.js';
|
|
3
|
+
export type ReadConnection = (fleetId: FleetId) => Promise<ConnectionStatus>;
|
|
4
|
+
/**
|
|
5
|
+
* Use case: whether the trierarch plugin is connected to a fleet. The fleet's
|
|
6
|
+
* kept crew token is asked who it is: a token the fleet no longer takes (the
|
|
7
|
+
* ship was released, its session ended) is dropped, and the trierarch plugin
|
|
8
|
+
* is not connected to that fleet until its operator connects it again. When
|
|
9
|
+
* the fleet does not answer, the token is kept.
|
|
10
|
+
*/
|
|
11
|
+
export declare function createReadConnection(deps: {
|
|
12
|
+
door: FleetDoor;
|
|
13
|
+
store: ConnectionStore;
|
|
14
|
+
}): ReadConnection;
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
/** The codes with which the fleet says a crew token no longer crews its ship. */
|
|
2
|
+
const GONE = new Set(['LEASE_ENDED', 'UNAUTHORIZED']);
|
|
3
|
+
/**
|
|
4
|
+
* Use case: whether the trierarch plugin is connected to a fleet. The fleet's
|
|
5
|
+
* kept crew token is asked who it is: a token the fleet no longer takes (the
|
|
6
|
+
* ship was released, its session ended) is dropped, and the trierarch plugin
|
|
7
|
+
* is not connected to that fleet until its operator connects it again. When
|
|
8
|
+
* the fleet does not answer, the token is kept.
|
|
9
|
+
*/
|
|
10
|
+
export function createReadConnection(deps) {
|
|
11
|
+
return async (fleetId) => {
|
|
12
|
+
const crew = await deps.store.find(fleetId);
|
|
13
|
+
if (crew) {
|
|
14
|
+
const who = await deps.door.whoami(crew.crewToken);
|
|
15
|
+
if (who.isOk || !GONE.has(who.error.code)) {
|
|
16
|
+
return { state: 'connected', ship: { shipId: crew.shipId, name: who.isOk ? who.value.name : crew.name }, lastShipId: crew.shipId };
|
|
17
|
+
}
|
|
18
|
+
await deps.store.drop(fleetId);
|
|
19
|
+
}
|
|
20
|
+
const binding = await deps.store.binding(fleetId);
|
|
21
|
+
return { state: 'not-connected', ship: null, lastShipId: binding?.shipId ?? null };
|
|
22
|
+
};
|
|
23
|
+
}
|
|
24
|
+
//# sourceMappingURL=read-connection.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"read-connection.js","sourceRoot":"","sources":["../../../src/core/connection/read-connection.ts"],"names":[],"mappings":"AAMA,iFAAiF;AACjF,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAiD;IACpF,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACnD,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1C,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;YACrI,CAAC;YACD,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAClD,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,IAAI,IAAI,EAAE,CAAC;IACrF,CAAC,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import type { FleetId } from '@aeolus-fleet/common';
|
|
2
|
+
import type { Clock } from '../shared/clock.js';
|
|
3
|
+
import type { DomainError } from '../shared/errors.js';
|
|
4
|
+
import { type Result } from '../shared/result.js';
|
|
5
|
+
import type { FleetForgetter, InstallationRequests, RequestHasher } from './ports.js';
|
|
6
|
+
export type DeleteFleet = (input: {
|
|
7
|
+
requestId: string;
|
|
8
|
+
fleetId: FleetId;
|
|
9
|
+
}) => Promise<Result<Record<string, never>, DomainError<'REQUEST_ID_USED'>>>;
|
|
10
|
+
/**
|
|
11
|
+
* Use case: the hosting service deletes a fleet from the trierarch plugin (decision
|
|
12
|
+
* 0021): it forgets everything it holds of the fleet, and tells the
|
|
13
|
+
* fleet nothing (its ships stay there). The request is kept as its hash
|
|
14
|
+
* only, so nothing of the fleet stays; a replay answers the first answer.
|
|
15
|
+
*/
|
|
16
|
+
export declare function createDeleteFleet(deps: {
|
|
17
|
+
forgetter: FleetForgetter;
|
|
18
|
+
requests: InstallationRequests;
|
|
19
|
+
hasher: RequestHasher;
|
|
20
|
+
clock: Clock;
|
|
21
|
+
}): DeleteFleet;
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import { ok } from '../shared/result.js';
|
|
2
|
+
import { earlierAnswer } from './request-id.js';
|
|
3
|
+
/**
|
|
4
|
+
* Use case: the hosting service deletes a fleet from the trierarch plugin (decision
|
|
5
|
+
* 0021): it forgets everything it holds of the fleet, and tells the
|
|
6
|
+
* fleet nothing (its ships stay there). The request is kept as its hash
|
|
7
|
+
* only, so nothing of the fleet stays; a replay answers the first answer.
|
|
8
|
+
*/
|
|
9
|
+
export function createDeleteFleet(deps) {
|
|
10
|
+
return async ({ requestId, fleetId }) => {
|
|
11
|
+
const requestHash = deps.hasher.hash(`deleteFleet ${fleetId}`);
|
|
12
|
+
const earlier = await earlierAnswer(deps.requests, { requestId, requestHash });
|
|
13
|
+
if (earlier !== undefined) {
|
|
14
|
+
return 'isOk' in earlier ? earlier : ok({});
|
|
15
|
+
}
|
|
16
|
+
await deps.forgetter.forget(fleetId);
|
|
17
|
+
await deps.requests.record({ requestId, kind: 'deleteFleet', requestHash, fleetId: null, isEnabled: null, at: deps.clock.now() });
|
|
18
|
+
return ok({});
|
|
19
|
+
};
|
|
20
|
+
}
|
|
21
|
+
//# sourceMappingURL=delete-fleet.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"delete-fleet.js","sourceRoot":"","sources":["../../../src/core/installation/delete-fleet.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIhD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAwG;IACxI,OAAO,KAAK,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE;QACtC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,OAAO,EAAE,CAAC,CAAC;QAC/D,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;QAC/E,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9C,CAAC;QACD,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAClI,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import type { FleetId } from '@aeolus-fleet/common';
|
|
2
|
+
/**
|
|
3
|
+
* Whether the installation has an installation token (decision 0021): open
|
|
4
|
+
* without one, as a self-hosted trierarch plugin runs, and every fleet is served;
|
|
5
|
+
* enabled with one, and a fleet is served only once the hosting service
|
|
6
|
+
* switched it on.
|
|
7
|
+
*/
|
|
8
|
+
export type InstallationMode = 'open' | 'enabled';
|
|
9
|
+
/** Outbound port: each fleet's switch, as the hosting service set it. */
|
|
10
|
+
export interface FleetSwitches {
|
|
11
|
+
/** Whether the fleet was switched on; undefined when it never was switched. */
|
|
12
|
+
find(fleetId: FleetId): Promise<boolean | undefined>;
|
|
13
|
+
set(fleetId: FleetId, change: {
|
|
14
|
+
isEnabled: boolean;
|
|
15
|
+
at: Date;
|
|
16
|
+
}): Promise<void>;
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
* A request the installation answered, by the caller's request id. A switch
|
|
20
|
+
* names its fleet and what it set, and goes with its fleet; a delete names
|
|
21
|
+
* nothing of the fleet, only the request's hash.
|
|
22
|
+
*/
|
|
23
|
+
export interface InstallationRequest {
|
|
24
|
+
requestId: string;
|
|
25
|
+
kind: 'setEnabled' | 'deleteFleet';
|
|
26
|
+
requestHash: string;
|
|
27
|
+
fleetId: FleetId | null;
|
|
28
|
+
isEnabled: boolean | null;
|
|
29
|
+
at: Date;
|
|
30
|
+
}
|
|
31
|
+
/** Outbound port: the installation's requests, so a replay answers what the first call answered. */
|
|
32
|
+
export interface InstallationRequests {
|
|
33
|
+
find(requestId: string): Promise<InstallationRequest | undefined>;
|
|
34
|
+
record(request: InstallationRequest): Promise<void>;
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* Outbound port: forgets everything the trierarch plugin holds of a fleet,
|
|
38
|
+
* in one go: its connection, its switch and the requests that name it.
|
|
39
|
+
*/
|
|
40
|
+
export interface FleetForgetter {
|
|
41
|
+
forget(fleetId: FleetId): Promise<void>;
|
|
42
|
+
}
|
|
43
|
+
/** Outbound port: a one-way hash of a request's text, kept instead of the request. */
|
|
44
|
+
export interface RequestHasher {
|
|
45
|
+
hash(text: string): string;
|
|
46
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../../src/core/installation/ports.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import type { FleetId } from '@aeolus-fleet/common';
|
|
2
|
+
import type { ConnectionStore } from '../connection/ports.js';
|
|
3
|
+
import type { IsServed } from './served.js';
|
|
4
|
+
export type ReadFleet = (input: {
|
|
5
|
+
fleetId: FleetId;
|
|
6
|
+
}) => Promise<{
|
|
7
|
+
isEnabled: boolean;
|
|
8
|
+
isConnected: boolean;
|
|
9
|
+
}>;
|
|
10
|
+
/**
|
|
11
|
+
* Use case: a fleet as the hosting service reads it: whether the trierarch plugin serves
|
|
12
|
+
* it, and whether the trierarch plugin holds a crew token for it. Off and connected is a
|
|
13
|
+
* fleet whose connection waits for it to be on again.
|
|
14
|
+
*/
|
|
15
|
+
export declare function createReadFleet(deps: {
|
|
16
|
+
isServed: IsServed;
|
|
17
|
+
connections: ConnectionStore;
|
|
18
|
+
}): ReadFleet;
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Use case: a fleet as the hosting service reads it: whether the trierarch plugin serves
|
|
3
|
+
* it, and whether the trierarch plugin holds a crew token for it. Off and connected is a
|
|
4
|
+
* fleet whose connection waits for it to be on again.
|
|
5
|
+
*/
|
|
6
|
+
export function createReadFleet(deps) {
|
|
7
|
+
return async ({ fleetId }) => ({ isEnabled: await deps.isServed(fleetId), isConnected: (await deps.connections.find(fleetId)) !== undefined });
|
|
8
|
+
}
|
|
9
|
+
//# sourceMappingURL=read-fleet.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"read-fleet.js","sourceRoot":"","sources":["../../../src/core/installation/read-fleet.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAA0D;IACxF,OAAO,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC,CAAC;AACjJ,CAAC"}
|