@imenam/mcp-dependabot-tracker 1.0.23 → 1.0.25

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 (73) hide show
  1. package/README.md +187 -76
  2. package/dist/shared/schemas/agent-token.schema.d.ts +47 -0
  3. package/dist/shared/schemas/agent-token.schema.js +18 -0
  4. package/dist/shared/schemas/api.schema.d.ts +25 -23
  5. package/dist/shared/schemas/api.schema.js +8 -8
  6. package/dist/shared/schemas/deploy.schema.d.ts +174 -0
  7. package/dist/shared/schemas/deploy.schema.js +72 -0
  8. package/dist/shared/schemas/model.schema.d.ts +9 -26
  9. package/dist/shared/schemas/model.schema.js +7 -15
  10. package/dist/src/cli/setup-mcp.d.ts +19 -16
  11. package/dist/src/cli/setup-mcp.js +35 -82
  12. package/dist/src/cli/users.d.ts +5 -0
  13. package/dist/src/cli/users.js +164 -0
  14. package/dist/src/core/agent-tokens.d.ts +15 -0
  15. package/dist/src/core/agent-tokens.js +96 -0
  16. package/dist/src/core/auth.d.ts +774 -0
  17. package/dist/src/core/auth.js +191 -0
  18. package/dist/src/core/commands.d.ts +1 -1
  19. package/dist/src/core/commands.js +47 -4
  20. package/dist/src/core/config.d.ts +2 -1
  21. package/dist/src/core/config.js +1 -4
  22. package/dist/src/core/data-dir.d.ts +3 -1
  23. package/dist/src/core/data-dir.js +11 -5
  24. package/dist/src/core/deploy-servers.d.ts +77 -0
  25. package/dist/src/core/deploy-servers.js +480 -0
  26. package/dist/src/core/deployments.d.ts +75 -0
  27. package/dist/src/core/deployments.js +387 -0
  28. package/dist/src/core/github.d.ts +2 -0
  29. package/dist/src/core/github.js +8 -0
  30. package/dist/src/core/log-dir.d.ts +1 -5
  31. package/dist/src/core/log-dir.js +1 -5
  32. package/dist/src/core/npm-sandbox.d.ts +19 -3
  33. package/dist/src/core/npm-sandbox.js +87 -17
  34. package/dist/src/core/operations.d.ts +20 -18
  35. package/dist/src/core/operations.js +86 -70
  36. package/dist/src/core/repair.d.ts +0 -7
  37. package/dist/src/core/repair.js +10 -33
  38. package/dist/src/core/repos.d.ts +2 -3
  39. package/dist/src/core/repos.js +4 -7
  40. package/dist/src/core/server-config.d.ts +29 -0
  41. package/dist/src/core/server-config.js +85 -0
  42. package/dist/src/core/settings.d.ts +9 -3
  43. package/dist/src/core/settings.js +49 -10
  44. package/dist/src/core/ssh.d.ts +31 -0
  45. package/dist/src/core/ssh.js +82 -0
  46. package/dist/src/core/store.d.ts +5 -12
  47. package/dist/src/core/store.js +82 -160
  48. package/dist/src/core/vault.d.ts +10 -0
  49. package/dist/src/core/vault.js +50 -0
  50. package/dist/src/index.d.ts +9 -0
  51. package/dist/src/index.js +46 -455
  52. package/dist/src/mcp.d.ts +6 -0
  53. package/dist/src/mcp.js +59 -0
  54. package/dist/src/server/app.d.ts +47 -0
  55. package/dist/src/server/app.js +273 -0
  56. package/dist/src/server/serve.d.ts +7 -0
  57. package/dist/src/server/serve.js +178 -0
  58. package/dist/src/tools/client.d.ts +15 -0
  59. package/dist/src/tools/client.js +62 -0
  60. package/dist/src/tools/format.d.ts +4 -5
  61. package/dist/src/tools/format.js +39 -16
  62. package/dist/src/tools/tools.d.ts +101 -15
  63. package/dist/src/tools/tools.js +91 -62
  64. package/gui/dist/assets/index-FrRzRTkV.js +71 -0
  65. package/gui/dist/assets/index-o3l3BAZD.css +1 -0
  66. package/gui/dist/index.html +2 -2
  67. package/package.json +11 -4
  68. package/dist/shared/schemas/ipc.schema.d.ts +0 -26
  69. package/dist/shared/schemas/ipc.schema.js +0 -53
  70. package/dist/src/gui-worker.d.ts +0 -1
  71. package/dist/src/gui-worker.js +0 -379
  72. package/gui/dist/assets/index-CS33iXZk.css +0 -1
  73. package/gui/dist/assets/index-CZN3w6nU.js +0 -64
@@ -0,0 +1,191 @@
1
+ import crypto from "crypto";
2
+ import fs from "fs";
3
+ import path from "path";
4
+ import Database from "better-sqlite3";
5
+ import { betterAuth } from "better-auth";
6
+ import { generateRandomString, symmetricEncrypt } from "better-auth/crypto";
7
+ import { getMigrations } from "better-auth/db/migration";
8
+ import { twoFactor } from "better-auth/plugins/two-factor";
9
+ import { ConflictError, NotFoundError, TrackerError } from "./errors.js";
10
+ /**
11
+ * En-tête où le serveur écrit l'adresse du client, calculée depuis la socket
12
+ * (et X-Forwarded-For quand la socket est un proxy de confiance) ; la valeur
13
+ * reçue du client est toujours écrasée. Le limiteur de débit le lit.
14
+ */
15
+ export const CLIENT_IP_HEADER = "x-tracker-client-ip";
16
+ /** Chemin des routes de Better Auth. */
17
+ export const AUTH_BASE_PATH = "/api/auth";
18
+ const MIN_PASSWORD_LENGTH = 12;
19
+ const APP_NAME = "Dependabot Tracker";
20
+ /** Table des secrets TOTP et des codes de secours du plugin de double authentification. */
21
+ const TWO_FACTOR_TABLE = "twoFactor";
22
+ const TOTP_DIGITS = 6;
23
+ const TOTP_PERIOD_SECONDS = 30;
24
+ const BACKUP_CODE_COUNT = 10;
25
+ /** Base SQLite des comptes et des sessions, dans le répertoire des données. */
26
+ function openDatabase(dataDir) {
27
+ fs.mkdirSync(dataDir, { recursive: true, mode: 0o700 });
28
+ const db = new Database(path.join(dataDir, "auth.sqlite"));
29
+ db.pragma("journal_mode = WAL");
30
+ return db;
31
+ }
32
+ /**
33
+ * Instance Better Auth : comptes e-mail + mot de passe créés en ligne de
34
+ * commande (inscription fermée), sessions en base, limitation de débit active,
35
+ * double authentification par code TOTP ou code de secours pour les comptes qui
36
+ * l'ont activée.
37
+ */
38
+ export function createAuth(dataDir, env) {
39
+ return betterAuth({
40
+ appName: APP_NAME,
41
+ baseURL: env.appUrl,
42
+ basePath: AUTH_BASE_PATH,
43
+ secret: env.authSecret,
44
+ trustedOrigins: [env.appUrl],
45
+ database: openDatabase(dataDir),
46
+ emailAndPassword: {
47
+ enabled: true,
48
+ disableSignUp: true,
49
+ minPasswordLength: MIN_PASSWORD_LENGTH,
50
+ maxPasswordLength: 128,
51
+ },
52
+ session: {
53
+ expiresIn: 60 * 60 * 24 * 7,
54
+ updateAge: 60 * 60 * 24,
55
+ },
56
+ rateLimit: {
57
+ enabled: true,
58
+ window: 60,
59
+ max: 100,
60
+ customRules: {
61
+ "/sign-in/email": { window: 60, max: 5 },
62
+ },
63
+ },
64
+ advanced: {
65
+ ipAddress: {
66
+ ipAddressHeaders: [CLIENT_IP_HEADER],
67
+ trustedProxies: env.trustedProxies,
68
+ },
69
+ },
70
+ plugins: [twoFactor({ issuer: APP_NAME, totpOptions: { digits: TOTP_DIGITS, period: TOTP_PERIOD_SECONDS } })],
71
+ });
72
+ }
73
+ /** Crée ou complète les tables de Better Auth. */
74
+ export async function migrateAuth(auth) {
75
+ const { runMigrations } = await getMigrations(auth.options);
76
+ await runMigrations();
77
+ }
78
+ /** Nouveau secret de session : 48 octets aléatoires en base64. */
79
+ export function generateAuthSecret() {
80
+ return crypto.randomBytes(48).toString("base64");
81
+ }
82
+ function summaryOf(user) {
83
+ return { email: user.email, name: user.name, createdAt: user.createdAt, twoFactor: user.twoFactorEnabled === true };
84
+ }
85
+ function normalizeEmail(raw) {
86
+ const email = raw.trim().toLowerCase();
87
+ if (!/^[^\s@]+@[^\s@]+$/.test(email))
88
+ throw new TrackerError(`"${raw}" is not an e-mail address.`);
89
+ return email;
90
+ }
91
+ async function checkedHash(auth, password) {
92
+ const ctx = await auth.$context;
93
+ const { minPasswordLength, maxPasswordLength } = ctx.password.config;
94
+ if (password.length < minPasswordLength)
95
+ throw new TrackerError(`The password is too short: at least ${minPasswordLength} characters.`);
96
+ if (password.length > maxPasswordLength)
97
+ throw new TrackerError(`The password is too long: at most ${maxPasswordLength} characters.`);
98
+ return ctx.password.hash(password);
99
+ }
100
+ async function requireUser(auth, email) {
101
+ const ctx = await auth.$context;
102
+ const found = await ctx.internalAdapter.findUserByEmail(normalizeEmail(email));
103
+ if (!found)
104
+ throw new NotFoundError(`No account uses ${email}.`);
105
+ return found.user;
106
+ }
107
+ /** Crée un compte e-mail + mot de passe. */
108
+ export async function addUser(auth, input) {
109
+ const ctx = await auth.$context;
110
+ const email = normalizeEmail(input.email);
111
+ if (await ctx.internalAdapter.findUserByEmail(email))
112
+ throw new ConflictError(`An account already uses ${email}.`);
113
+ const hash = await checkedHash(auth, input.password);
114
+ const user = await ctx.internalAdapter.createUser({ email, name: input.name.trim() || email, emailVerified: true }, { method: "email-password" });
115
+ await ctx.internalAdapter.linkAccount({ userId: user.id, providerId: "credential", accountId: user.id, password: hash });
116
+ return summaryOf(user);
117
+ }
118
+ /** Remplace le mot de passe d'un compte et ferme toutes ses sessions. */
119
+ export async function setUserPassword(auth, email, password) {
120
+ const ctx = await auth.$context;
121
+ const user = await requireUser(auth, email);
122
+ const hash = await checkedHash(auth, password);
123
+ await ctx.internalAdapter.updatePassword(user.id, hash);
124
+ await ctx.internalAdapter.deleteUserSessions(user.id);
125
+ }
126
+ /** Supprime un compte, ses sessions et son mot de passe. */
127
+ export async function removeUser(auth, email) {
128
+ const ctx = await auth.$context;
129
+ const user = await requireUser(auth, email);
130
+ await ctx.internalAdapter.deleteUser(user.id);
131
+ }
132
+ /** Comptes existants, du plus ancien au plus récent. */
133
+ export async function listUsers(auth) {
134
+ const ctx = await auth.$context;
135
+ const users = await ctx.internalAdapter.listUsers(undefined, undefined, { field: "createdAt", direction: "asc" });
136
+ return users.map(summaryOf);
137
+ }
138
+ const BASE32_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567";
139
+ /** Encodage base32 (RFC 4648) sans remplissage, celui des clés des applications d'authentification. */
140
+ export function base32Encode(bytes) {
141
+ let bits = "";
142
+ for (const byte of bytes)
143
+ bits += byte.toString(2).padStart(8, "0");
144
+ let encoded = "";
145
+ for (let index = 0; index < bits.length; index += 5)
146
+ encoded += BASE32_ALPHABET[parseInt(bits.slice(index, index + 5).padEnd(5, "0"), 2)];
147
+ return encoded;
148
+ }
149
+ /** Prépare un secret TOTP et des codes de secours pour le compte `email`, sans rien enregistrer. */
150
+ export async function prepareTotp(auth, email) {
151
+ const user = await requireUser(auth, email);
152
+ const secret = generateRandomString(32);
153
+ const key = base32Encode(new TextEncoder().encode(secret));
154
+ const parameters = new URLSearchParams({ secret: key, issuer: APP_NAME, digits: String(TOTP_DIGITS), period: String(TOTP_PERIOD_SECONDS) });
155
+ const backupCodes = Array.from({ length: BACKUP_CODE_COUNT }, () => generateRandomString(10, "a-z", "0-9", "A-Z")).map((code) => `${code.slice(0, 5)}-${code.slice(5)}`);
156
+ return { secret, key, uri: `otpauth://totp/${encodeURIComponent(APP_NAME)}:${encodeURIComponent(user.email)}?${parameters}`, backupCodes };
157
+ }
158
+ /** Code TOTP du moment pour `secret`. */
159
+ export async function currentTotpCode(auth, secret) {
160
+ return (await auth.api.generateTOTP({ body: { secret } })).code;
161
+ }
162
+ /**
163
+ * Active la double authentification du compte avec `enrollment`, à la place de
164
+ * celle qu'il avait, et ferme toutes ses sessions.
165
+ */
166
+ export async function enableTotp(auth, email, enrollment) {
167
+ const ctx = await auth.$context;
168
+ const user = await requireUser(auth, email);
169
+ const data = {
170
+ secret: await symmetricEncrypt({ key: ctx.secretConfig, data: enrollment.secret }),
171
+ backupCodes: await symmetricEncrypt({ key: ctx.secretConfig, data: JSON.stringify(enrollment.backupCodes) }),
172
+ verified: true,
173
+ failedVerificationCount: 0,
174
+ lockedUntil: null,
175
+ };
176
+ const where = [{ field: "userId", value: user.id }];
177
+ const existing = await ctx.adapter.findOne({ model: TWO_FACTOR_TABLE, where });
178
+ if (existing)
179
+ await ctx.adapter.update({ model: TWO_FACTOR_TABLE, where, update: data });
180
+ else
181
+ await ctx.adapter.create({ model: TWO_FACTOR_TABLE, data: { ...data, userId: user.id } });
182
+ await ctx.internalAdapter.updateUser(user.id, { twoFactorEnabled: true });
183
+ await ctx.internalAdapter.deleteUserSessions(user.id);
184
+ }
185
+ /** Retire la double authentification du compte : son secret et ses codes de secours sont effacés. */
186
+ export async function disableTotp(auth, email) {
187
+ const ctx = await auth.$context;
188
+ const user = await requireUser(auth, email);
189
+ await ctx.adapter.delete({ model: TWO_FACTOR_TABLE, where: [{ field: "userId", value: user.id }] });
190
+ await ctx.internalAdapter.updateUser(user.id, { twoFactorEnabled: false });
191
+ }
@@ -17,7 +17,7 @@ export declare class CommandAbortedError extends Error {
17
17
  export declare function killTree(pid: number): void;
18
18
  /**
19
19
  * Lance `git`, `npm` ou `bwrap` sans shell, et attend sa fin. La commande reçoit
20
- * l'environnement du serveur sans GITHUB_TOKEN, plus `options.env`. Sous Windows,
20
+ * les variables système du serveur (`PASSED_ENV`), sans aucun de ses secrets, plus `options.env`. Sous Windows,
21
21
  * `npm` est un script `.cmd` que Node ne lance qu'à travers un shell : ses
22
22
  * arguments sont alors des options fixes, jamais une valeur venue de
23
23
  * l'utilisateur. Le code de sortie n'est pas interprété ici ; un dépassement de
@@ -21,14 +21,57 @@ export function killTree(pid) {
21
21
  // Le groupe de processus est déjà terminé.
22
22
  }
23
23
  }
24
- /** Environnement du serveur transmis aux commandes, sans le token GitHub. */
24
+ /**
25
+ * Variables du serveur transmises aux commandes : chemins et dossiers du
26
+ * système, compte, langue, proxy et certificats. Aucun secret du serveur
27
+ * (GITHUB_TOKEN, VAULT_KEY, AUTH_SECRET…) n'en fait partie.
28
+ */
29
+ const PASSED_ENV = [
30
+ "PATH",
31
+ "HOME",
32
+ "USER",
33
+ "LOGNAME",
34
+ "LANG",
35
+ "LC_ALL",
36
+ "TMPDIR",
37
+ "TEMP",
38
+ "TMP",
39
+ "SystemRoot",
40
+ "SystemDrive",
41
+ "windir",
42
+ "ComSpec",
43
+ "PATHEXT",
44
+ "USERPROFILE",
45
+ "HOMEDRIVE",
46
+ "HOMEPATH",
47
+ "APPDATA",
48
+ "LOCALAPPDATA",
49
+ "ProgramData",
50
+ "ProgramFiles",
51
+ "ProgramFiles(x86)",
52
+ "HTTP_PROXY",
53
+ "HTTPS_PROXY",
54
+ "NO_PROXY",
55
+ "http_proxy",
56
+ "https_proxy",
57
+ "no_proxy",
58
+ "SSL_CERT_FILE",
59
+ "SSL_CERT_DIR",
60
+ "NODE_EXTRA_CA_CERTS",
61
+ "GIT_SSL_CAINFO",
62
+ ];
63
+ /** Environnement du serveur transmis aux commandes : les seules variables de `PASSED_ENV`. */
25
64
  function inheritedEnv() {
26
- const { GITHUB_TOKEN: _token, ...env } = process.env;
65
+ const env = {};
66
+ for (const name of PASSED_ENV) {
67
+ if (process.env[name] !== undefined)
68
+ env[name] = process.env[name];
69
+ }
27
70
  return env;
28
71
  }
29
72
  /**
30
73
  * Lance `git`, `npm` ou `bwrap` sans shell, et attend sa fin. La commande reçoit
31
- * l'environnement du serveur sans GITHUB_TOKEN, plus `options.env`. Sous Windows,
74
+ * les variables système du serveur (`PASSED_ENV`), sans aucun de ses secrets, plus `options.env`. Sous Windows,
32
75
  * `npm` est un script `.cmd` que Node ne lance qu'à travers un shell : ses
33
76
  * arguments sont alors des options fixes, jamais une valeur venue de
34
77
  * l'utilisateur. Le code de sortie n'est pas interprété ici ; un dépassement de
@@ -77,7 +120,7 @@ export function runCommand(command, args, options) {
77
120
  child.stderr.on("data", (chunk) => stderr.push(chunk));
78
121
  child.on("error", (err) => {
79
122
  finish(() => reject(err.code === "ENOENT"
80
- ? new TrackerError(`"${command}" is not installed or not in the PATH of the MCP server.`)
123
+ ? new TrackerError(`"${command}" is not installed or not in the PATH of the server.`)
81
124
  : new TrackerError(`Could not run ${command}: ${err.message}`)));
82
125
  });
83
126
  child.on("close", (code) => {
@@ -1,12 +1,13 @@
1
1
  /**
2
2
  * Accès à GitHub. `apiUrl` et `serverUrl` désignent github.com par défaut ;
3
3
  * GITHUB_API_URL et GITHUB_SERVER_URL les changent pour GitHub Enterprise Server.
4
+ * `serverUrl` est l'adresse web du serveur, sans barre finale :
5
+ * `<serveur>/<propriétaire>/<nom>` est la page d'un dépôt.
4
6
  */
5
7
  export interface GitHubConfig {
6
8
  token: string;
7
9
  apiUrl: string;
8
10
  serverUrl: string;
9
11
  }
10
- export declare function githubConfigured(): boolean;
11
12
  /** Configuration GitHub lue dans l'environnement ; lève une erreur si GITHUB_TOKEN manque. */
12
13
  export declare function readGitHubConfig(): GitHubConfig;
@@ -1,14 +1,11 @@
1
1
  import { TrackerError } from "./errors.js";
2
2
  const DEFAULT_API_URL = "https://api.github.com";
3
3
  const DEFAULT_SERVER_URL = "https://github.com";
4
- export function githubConfigured() {
5
- return !!process.env.GITHUB_TOKEN?.trim();
6
- }
7
4
  /** Configuration GitHub lue dans l'environnement ; lève une erreur si GITHUB_TOKEN manque. */
8
5
  export function readGitHubConfig() {
9
6
  const token = process.env.GITHUB_TOKEN?.trim();
10
7
  if (!token) {
11
- throw new TrackerError("GITHUB_TOKEN is not set: declare a GitHub token in the env block of mcp-dependabot-tracker (Dependabot alerts: read, Contents: read and write, Pull requests: read and write).");
8
+ throw new TrackerError("GITHUB_TOKEN is not set: declare a GitHub token in the environment of the server (Dependabot alerts: read, Contents: read and write, Pull requests: read and write).");
12
9
  }
13
10
  return {
14
11
  token,
@@ -1,7 +1,9 @@
1
1
  /**
2
2
  * Répertoire des données : MCP_DATA_DIR, puis `~/.mcp-dependabot-tracker`. Les
3
3
  * dépôts suivis ne dépendent d'aucun projet : le répertoire par défaut est
4
- * propre à l'utilisateur.
4
+ * propre à l'utilisateur. Il est créé s'il n'existe pas, et réservé au compte
5
+ * du serveur (droits 700) hors de Windows : il porte les comptes, les sessions,
6
+ * les tokens et les scripts de déploiement.
5
7
  */
6
8
  export declare function resolveDataDir(): string;
7
9
  /**
@@ -1,16 +1,22 @@
1
1
  import fs from "fs";
2
2
  import os from "os";
3
3
  import path from "path";
4
+ /** Droits du répertoire des données : lecture, écriture et parcours par le seul compte du serveur. */
5
+ const DATA_DIR_MODE = 0o700;
4
6
  /**
5
7
  * Répertoire des données : MCP_DATA_DIR, puis `~/.mcp-dependabot-tracker`. Les
6
8
  * dépôts suivis ne dépendent d'aucun projet : le répertoire par défaut est
7
- * propre à l'utilisateur.
9
+ * propre à l'utilisateur. Il est créé s'il n'existe pas, et réservé au compte
10
+ * du serveur (droits 700) hors de Windows : il porte les comptes, les sessions,
11
+ * les tokens et les scripts de déploiement.
8
12
  */
9
13
  export function resolveDataDir() {
10
14
  const configured = process.env.MCP_DATA_DIR?.trim();
11
- if (configured)
12
- return path.resolve(configured);
13
- return path.join(os.homedir(), ".mcp-dependabot-tracker");
15
+ const dir = configured ? path.resolve(configured) : path.join(os.homedir(), ".mcp-dependabot-tracker");
16
+ fs.mkdirSync(dir, { recursive: true, mode: DATA_DIR_MODE });
17
+ if (process.platform !== "win32")
18
+ fs.chmodSync(dir, DATA_DIR_MODE);
19
+ return dir;
14
20
  }
15
21
  /**
16
22
  * Dossier où chaque opération crée son clone, fixé par CLONE_DIR et créé s'il
@@ -19,7 +25,7 @@ export function resolveDataDir() {
19
25
  export function resolveCloneDir() {
20
26
  const configured = process.env.CLONE_DIR?.trim();
21
27
  if (!configured) {
22
- throw new Error("CLONE_DIR is not set: declare the folder where the repositories are cloned for npm audit in the env block of mcp-dependabot-tracker.");
28
+ throw new Error("CLONE_DIR is not set: declare the folder where the repositories are cloned for npm audit in the environment of the server.");
23
29
  }
24
30
  const dir = path.resolve(configured);
25
31
  fs.mkdirSync(dir, { recursive: true });
@@ -0,0 +1,77 @@
1
+ import { type DeployServer, type DeployServerBody, type DeployServerView, type RotationResponse, type TestDeployServerResponse } from "../../shared/schemas/deploy.schema.js";
2
+ import { type SshTarget } from "./ssh.js";
3
+ /** Fichier de clés propre au tracker, relatif au dossier personnel de l'utilisateur distant. */
4
+ export declare const DEDICATED_KEY_FILE = ".ssh/authorized_keys.d/dependabot-tracker";
5
+ /** Réglage sshd qui ajoute le fichier dédié à ~/.ssh/authorized_keys. */
6
+ export declare const SSHD_DROP_IN = "/etc/ssh/sshd_config.d/10-dependabot-tracker.conf";
7
+ /** Ligne du fichier dédié : `restrict` coupe redirections, agent, X11 et pseudo-terminal ; `from` limite la clé à l'adresse du tracker. */
8
+ export declare function keyLine(publicKey: string, allowedFrom?: string | null): string;
9
+ /**
10
+ * Commande d'installation, sur une ligne : écrit la clé dans le fichier dédié,
11
+ * fait lire ce fichier à sshd en plus de ~/.ssh/authorized_keys, et ne recharge
12
+ * sshd que si la configuration est valide et prend bien le fichier dédié en
13
+ * compte ; sinon le réglage ajouté est retiré. Le service s'appelle `ssh` sur
14
+ * Debian et Ubuntu, `sshd` ailleurs ; `try-reload-or-restart` ne fait rien quand
15
+ * il est arrêté, cas de l'activation par socket où sshd lit sa configuration au
16
+ * démarrage.
17
+ */
18
+ export declare function installCommand(publicKey: string): string;
19
+ /** Commande qui retire la clé `publicKey` du fichier dédié, sans toucher aux autres lignes. */
20
+ export declare function revokeCommand(publicKey: string): string;
21
+ /** Contrôle et normalise les champs saisis pour un serveur. */
22
+ export declare function validateServerInput(input: DeployServerBody): DeployServerBody;
23
+ /** Étapes d'un renouvellement de clé. */
24
+ export declare const ROTATION_STEP_COUNT = 4;
25
+ /**
26
+ * Serveurs de déploiement : `<données>/deploy-servers.json`, lisible par le
27
+ * seul compte du serveur. La paire de clés est générée à la création ; seule la
28
+ * clé publique est lisible, la clé privée est chiffrée avec VAULT_KEY.
29
+ */
30
+ export declare class DeployServerStore {
31
+ private readonly vaultKey;
32
+ private readonly file;
33
+ constructor(dataDir: string, vaultKey: Buffer);
34
+ private read;
35
+ private mutate;
36
+ private find;
37
+ view(server: DeployServer): DeployServerView;
38
+ list(): DeployServer[];
39
+ get(id: string): DeployServer;
40
+ create(input: DeployServerBody): DeployServer;
41
+ /** Modifie les champs saisis. Un changement d'hôte ou de port oublie l'empreinte et le test : c'est une autre machine. */
42
+ update(id: string, input: DeployServerBody): DeployServer;
43
+ private patch;
44
+ /** Cible SSH du serveur, avec sa clé privée déchiffrée et l'empreinte enregistrée. */
45
+ target(id: string): SshTarget;
46
+ /** Vérifie que VAULT_KEY déchiffre toutes les clés enregistrées. */
47
+ verifyVault(): void;
48
+ /**
49
+ * Teste la connexion : enregistre l'empreinte de l'hôte au premier test, puis
50
+ * limite la ligne de la clé à l'adresse du tracker vue par le serveur.
51
+ */
52
+ test(id: string): Promise<TestDeployServerResponse>;
53
+ /**
54
+ * Relève la place de la clé et limite sa ligne à l'adresse du tracker. La
55
+ * nouvelle ligne est vérifiée par une seconde connexion, la première restant
56
+ * ouverte pour remettre la ligne d'origine si le serveur la refuse.
57
+ */
58
+ private restrictToTracker;
59
+ /**
60
+ * Remplace la clé en quatre étapes : générer, ajouter la nouvelle à côté de
61
+ * l'actuelle, l'essayer sur une seconde connexion, puis ne garder qu'elle.
62
+ * Un échec avant la fin remet le fichier dans son état d'origine.
63
+ */
64
+ rotate(id: string): Promise<RotationResponse>;
65
+ /**
66
+ * Retire la ligne de la clé du fichier dédié, vérifie que le serveur refuse
67
+ * désormais la clé, puis l'oublie. Si le serveur l'accepte encore, elle figure
68
+ * ailleurs : rien n'est effacé.
69
+ */
70
+ revoke(id: string): Promise<DeployServerView>;
71
+ /** Efface la clé sans toucher au serveur : le serveur reste enregistré, sans accès. */
72
+ forget(id: string): DeployServerView;
73
+ /** Génère une nouvelle paire pour un serveur dont la clé a été révoquée. */
74
+ installNewKey(id: string): DeployServerView;
75
+ /** Remplace la paire de clés ; la limite d'adresse suit la ligne écrite sur le serveur. */
76
+ private replaceKey;
77
+ }