@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
@@ -1,44 +1,18 @@
1
1
  import fs from "fs";
2
2
  import path from "path";
3
3
  const SERVER_NAME = "mcp-dependabot-tracker";
4
- const PACKAGE_NAME = "@imenam/mcp-dependabot-tracker";
5
- /**
6
- * Valeurs volontairement vides : chaque variable est inactive tant qu'elle n'est
7
- * pas remplie (PROXY_URL et APP_PORT vides = GUI désactivée), sauf CLONE_DIR,
8
- * obligatoire. Les dépôts suivis ne dépendent pas du projet : le répertoire des
9
- * données reste celui par défaut.
10
- */
11
- function buildServerEntry(exposure) {
12
- // Un port explicite désactive le placeholder proxy : les deux variables ne
13
- // doivent jamais être renseignées ensemble, PROXY_URL primant au runtime.
14
- const proxyUrl = exposure.appPort !== undefined ? "" : exposure.proxyUrl ?? "http://localhost:";
4
+ export const PACKAGE_NAME = "@imenam/mcp-dependabot-tracker";
5
+ /** Commande qui déclare le mode MCP avec `connection` dans le `.mcp.json` du répertoire courant. */
6
+ export function setupCommand({ serverUrl, token }) {
7
+ return `npx -y ${PACKAGE_NAME} --claude-setup-mcp --server_url=${serverUrl} --token=${token}`;
8
+ }
9
+ function buildServerEntry({ serverUrl, token }) {
15
10
  return {
16
11
  command: "npx",
17
- args: ["-y", PACKAGE_NAME],
18
- env: {
19
- GITHUB_TOKEN: "",
20
- PROXY_URL: proxyUrl,
21
- APP_PORT: exposure.appPort !== undefined ? String(exposure.appPort) : "",
22
- APP_GROUP: "",
23
- APP_NAME: "Dependabot Tracker",
24
- APP_PATH: "/dependabot-tracker",
25
- CLONE_DIR: "",
26
- MCP_DATA_DIR: "",
27
- MCP_LOG_DIR: "",
28
- },
12
+ args: ["-y", PACKAGE_NAME, "mcp"],
13
+ env: { SERVER_URL: serverUrl, AGENT_TOKEN: token },
29
14
  };
30
15
  }
31
- const GENERATED_VARS = [
32
- ["GITHUB_TOKEN", "token GitHub : Dependabot alerts (lecture), Contents et Pull requests (lecture et écriture)"],
33
- ["PROXY_URL", "URL du proxy pour exposer la GUI (compléter le port)"],
34
- ["APP_PORT", "port local si aucun proxy — la GUI est servie sur http://localhost:<port>"],
35
- ["APP_GROUP", "groupe d'affichage dans le dashboard du proxy"],
36
- ["APP_NAME", "nom affiché de la GUI dans le dashboard du proxy"],
37
- ["APP_PATH", "chemin de montage de la GUI derrière le proxy"],
38
- ["CLONE_DIR", "dossier des clones temporaires, créé s'il n'existe pas (obligatoire)"],
39
- ["MCP_DATA_DIR", "répertoire des données (défaut : ~/.mcp-dependabot-tracker)"],
40
- ["MCP_LOG_DIR", "répertoire des logs (défaut : <données>/logs)"],
41
- ];
42
16
  /** Lit `--flag=valeur` (tirets ou underscores acceptés). */
43
17
  function readFlag(argv, name) {
44
18
  const prefixes = [`--${name}=`, `--${name.replace(/_/g, "-")}=`];
@@ -49,43 +23,35 @@ function readFlag(argv, name) {
49
23
  }
50
24
  return undefined;
51
25
  }
52
- /**
53
- * Traduit `--proxy_url=` / `--app_port=` en mode d'exposition de la GUI.
54
- * Les deux ensemble sont refusés : au runtime PROXY_URL primerait toujours,
55
- * donc un fichier portant les deux serait silencieusement trompeur.
56
- */
57
- export function parseGuiExposure(argv) {
58
- const rawProxyUrl = readFlag(argv, "proxy_url");
59
- const rawAppPort = readFlag(argv, "app_port");
60
- if (rawProxyUrl !== undefined && rawAppPort !== undefined) {
61
- return { error: "--proxy_url et --app_port sont exclusifs : la GUI passe par le proxy, ou écoute sur un port local." };
26
+ /** Valide une adresse de serveur http ou https ; rend l'adresse sans barre finale, ou la raison du refus. */
27
+ export function parseServerUrl(raw, label) {
28
+ let parsed;
29
+ try {
30
+ parsed = new URL(raw);
62
31
  }
63
- if (rawProxyUrl !== undefined) {
64
- if (rawProxyUrl === "")
65
- return { error: "--proxy_url attend une URL, ex : --proxy_url=http://localhost:3000" };
66
- let parsed;
67
- try {
68
- parsed = new URL(rawProxyUrl);
69
- }
70
- catch {
71
- return { error: `--proxy_url invalide : "${rawProxyUrl}" n'est pas une URL absolue (ex : http://localhost:3000).` };
72
- }
73
- if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
74
- return { error: `--proxy_url invalide : protocole "${parsed.protocol}" non supporté (http ou https attendu).` };
75
- }
76
- // Une barre finale casserait la concaténation PROXY_URL + APP_PATH.
77
- return { exposure: { proxyUrl: rawProxyUrl.replace(/\/+$/, "") } };
32
+ catch {
33
+ return { error: `${label} invalide : "${raw}" n'est pas une URL absolue (ex : http://localhost:4700).` };
78
34
  }
79
- if (rawAppPort !== undefined) {
80
- const port = Number(rawAppPort);
81
- if (!Number.isInteger(port) || port < 1 || port > 65535) {
82
- return { error: `--app_port invalide : "${rawAppPort}" n'est pas un entier entre 1 et 65535.` };
83
- }
84
- return { exposure: { appPort: port } };
35
+ if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
36
+ return { error: `${label} invalide : protocole "${parsed.protocol}" non supporté (http ou https attendu).` };
85
37
  }
86
- return { exposure: {} };
38
+ return { url: raw.replace(/\/+$/, "") };
87
39
  }
88
- export function runSetupMcp({ cwd, force, exposure = {} }) {
40
+ /** Lit `--server_url=` et `--token=`, tous deux obligatoires. */
41
+ export function parseConnection(argv) {
42
+ const rawUrl = readFlag(argv, "server_url");
43
+ const token = readFlag(argv, "token");
44
+ if (!rawUrl)
45
+ return { error: "--server_url est obligatoire : l'adresse du serveur Dependabot Tracker, ex : --server_url=http://localhost:4700" };
46
+ if (!token)
47
+ return { error: "--token est obligatoire : un token d'agent, créé dans les réglages de l'interface du serveur." };
48
+ const url = parseServerUrl(rawUrl, "--server_url");
49
+ if ("error" in url)
50
+ return url;
51
+ return { connection: { serverUrl: url.url, token } };
52
+ }
53
+ /** Crée ou complète le `.mcp.json` de `cwd` avec l'entrée du mode MCP ; rend le code de sortie de la commande. */
54
+ export function runSetupMcp({ cwd, force, connection }) {
89
55
  const target = path.join(cwd, ".mcp.json");
90
56
  let config = {};
91
57
  const exists = fs.existsSync(target);
@@ -115,23 +81,10 @@ export function runSetupMcp({ cwd, force, exposure = {} }) {
115
81
  console.error("Relancez avec --force pour écraser cette entrée (les autres serveurs sont préservés).");
116
82
  return 1;
117
83
  }
118
- config.mcpServers[SERVER_NAME] = buildServerEntry(exposure);
84
+ config.mcpServers[SERVER_NAME] = buildServerEntry(connection);
119
85
  fs.writeFileSync(target, JSON.stringify(config, null, 2) + "\n", "utf-8");
120
86
  const action = alreadyPresent ? "remplacée" : exists ? "ajoutée" : "créée";
121
87
  console.log(`Configuration ${SERVER_NAME} ${action} dans ${target}`);
122
- console.log("");
123
- if (exposure.appPort !== undefined) {
124
- console.log(`GUI en accès direct : http://localhost:${exposure.appPort} (sans proxy).`);
125
- }
126
- else if (exposure.proxyUrl !== undefined) {
127
- console.log(`GUI exposée via le proxy ${exposure.proxyUrl}.`);
128
- }
129
- console.log('À compléter dans le champ "env" :');
130
- for (const [name, description] of GENERATED_VARS) {
131
- console.log(` ${name.padEnd(16)} ${description}`);
132
- }
133
- console.log("");
134
- console.log("Une variable laissée vide est simplement inactive, sauf CLONE_DIR : sans elle, le serveur refuse de démarrer.");
135
- console.log("PROXY_URL et APP_PORT s'excluent : PROXY_URL prime si les deux sont renseignés.");
88
+ console.log(`Le mode MCP se connecte au serveur ${connection.serverUrl}.`);
136
89
  return 0;
137
90
  }
@@ -0,0 +1,5 @@
1
+ export declare const USERS_USAGE: string;
2
+ /** QR code de `text` en caractères, pour un terminal : deux modules par caractère, sur fond clair. */
3
+ export declare function terminalQrCode(text: string): Promise<string>;
4
+ /** Exécute `user <action> …` ; rend le code de sortie. */
5
+ export declare function runUsers(argv: string[]): Promise<number>;
@@ -0,0 +1,164 @@
1
+ import readline from "readline";
2
+ import QRCode from "qrcode";
3
+ import { addUser, createAuth, currentTotpCode, disableTotp, enableTotp, listUsers, migrateAuth, prepareTotp, removeUser, setUserPassword } from "../core/auth.js";
4
+ import { resolveDataDir } from "../core/data-dir.js";
5
+ import { readAuthEnv } from "../core/server-config.js";
6
+ export const USERS_USAGE = [
7
+ " mcp-dependabot-tracker user add <email> [--name=<nom>] crée un compte (mot de passe demandé)",
8
+ " mcp-dependabot-tracker user password <email> change le mot de passe et ferme les sessions",
9
+ " mcp-dependabot-tracker user totp <email> [--remove] active la double authentification (clé TOTP, codes de secours), ou la retire",
10
+ " mcp-dependabot-tracker user remove <email> supprime le compte",
11
+ " mcp-dependabot-tracker user list liste les comptes",
12
+ ].join("\n");
13
+ /** Lit une ligne sur le terminal sans l'afficher. */
14
+ function promptHidden(question) {
15
+ return new Promise((resolve) => {
16
+ const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: true });
17
+ const output = rl;
18
+ let muted = false;
19
+ output._writeToOutput = (text) => {
20
+ if (!muted || text.includes("\n"))
21
+ output.output.write(muted ? "\n" : text);
22
+ };
23
+ rl.question(question, (answer) => {
24
+ rl.close();
25
+ resolve(answer);
26
+ });
27
+ muted = true;
28
+ });
29
+ }
30
+ /** Lit une ligne sur le terminal. */
31
+ function promptLine(question) {
32
+ return new Promise((resolve) => {
33
+ const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: true });
34
+ rl.question(question, (answer) => {
35
+ rl.close();
36
+ resolve(answer.trim());
37
+ });
38
+ });
39
+ }
40
+ /** Essais du code de l'application avant l'abandon de l'activation. */
41
+ const TOTP_CONFIRMATION_TRIES = 3;
42
+ /** QR code de `text` en caractères, pour un terminal : deux modules par caractère, sur fond clair. */
43
+ export function terminalQrCode(text) {
44
+ return QRCode.toString(text, { type: "terminal", small: true });
45
+ }
46
+ /**
47
+ * Prépare la double authentification du compte, affiche sa clé et ses codes de
48
+ * secours, puis l'active. Sur un terminal, la clé est aussi affichée en QR code,
49
+ * et l'activation attend le code affiché par l'application d'authentification ;
50
+ * sans code juste, rien n'est enregistré.
51
+ */
52
+ async function runTotp(auth, email) {
53
+ const enrollment = await prepareTotp(auth, email);
54
+ if (process.stdout.isTTY) {
55
+ console.log("QR code à scanner avec l'application d'authentification :");
56
+ console.log(await terminalQrCode(enrollment.uri));
57
+ }
58
+ console.log(`Clé à saisir dans l'application d'authentification : ${enrollment.key}`);
59
+ console.log(`Adresse de la clé : ${enrollment.uri}`);
60
+ console.log("Codes de secours, à conserver (un seul usage chacun) :");
61
+ for (const code of enrollment.backupCodes)
62
+ console.log(` ${code}`);
63
+ if (process.stdin.isTTY) {
64
+ let confirmed = false;
65
+ for (let attempt = 0; attempt < TOTP_CONFIRMATION_TRIES && !confirmed; attempt += 1) {
66
+ const code = await promptLine("Code affiché par l'application : ");
67
+ confirmed = code.replaceAll(" ", "") === (await currentTotpCode(auth, enrollment.secret));
68
+ if (!confirmed)
69
+ console.error("Code incorrect.");
70
+ }
71
+ if (!confirmed)
72
+ throw new Error("la double authentification n'est pas activée, aucun code juste n'a été saisi.");
73
+ }
74
+ await enableTotp(auth, email, enrollment);
75
+ console.log(`Double authentification activée pour ${email} ; ses sessions sont fermées.`);
76
+ return 0;
77
+ }
78
+ /** Lignes de l'entrée standard quand elle n'est pas un terminal. */
79
+ async function readStdinLines() {
80
+ const chunks = [];
81
+ for await (const chunk of process.stdin)
82
+ chunks.push(chunk);
83
+ return Buffer.concat(chunks).toString("utf8").split(/\r?\n/);
84
+ }
85
+ /**
86
+ * Nouveau mot de passe : saisi deux fois sur un terminal, ou lu sur la
87
+ * première ligne de l'entrée standard sinon.
88
+ */
89
+ async function readNewPassword() {
90
+ if (!process.stdin.isTTY) {
91
+ const [first] = await readStdinLines();
92
+ return first ?? "";
93
+ }
94
+ const password = await promptHidden("Mot de passe : ");
95
+ const confirmation = await promptHidden("Confirmation : ");
96
+ if (password !== confirmation)
97
+ throw new Error("Les deux saisies diffèrent.");
98
+ return password;
99
+ }
100
+ function readFlag(args, name) {
101
+ const prefix = `--${name}=`;
102
+ return args.find((arg) => arg.startsWith(prefix))?.slice(prefix.length);
103
+ }
104
+ function requireEmail(args, usage) {
105
+ const email = args.find((arg) => !arg.startsWith("--"));
106
+ if (!email)
107
+ throw new Error(`Adresse e-mail manquante : ${usage}`);
108
+ return email;
109
+ }
110
+ async function openAuth() {
111
+ const auth = createAuth(resolveDataDir(), readAuthEnv());
112
+ await migrateAuth(auth);
113
+ return auth;
114
+ }
115
+ /** Exécute `user <action> …` ; rend le code de sortie. */
116
+ export async function runUsers(argv) {
117
+ const [action, ...args] = argv;
118
+ try {
119
+ if (action === "add") {
120
+ const email = requireEmail(args, "user add <email> [--name=<nom>]");
121
+ const auth = await openAuth();
122
+ const password = await readNewPassword();
123
+ const user = await addUser(auth, { email, name: readFlag(args, "name") ?? "", password });
124
+ console.log(`Compte créé : ${user.email}`);
125
+ return 0;
126
+ }
127
+ if (action === "password") {
128
+ const email = requireEmail(args, "user password <email>");
129
+ const auth = await openAuth();
130
+ await setUserPassword(auth, email, await readNewPassword());
131
+ console.log(`Mot de passe changé pour ${email} ; ses sessions sont fermées.`);
132
+ return 0;
133
+ }
134
+ if (action === "totp") {
135
+ const email = requireEmail(args, "user totp <email> [--remove]");
136
+ const auth = await openAuth();
137
+ if (!args.includes("--remove"))
138
+ return await runTotp(auth, email);
139
+ await disableTotp(auth, email);
140
+ console.log(`Double authentification retirée pour ${email}.`);
141
+ return 0;
142
+ }
143
+ if (action === "remove") {
144
+ const email = requireEmail(args, "user remove <email>");
145
+ await removeUser(await openAuth(), email);
146
+ console.log(`Compte supprimé : ${email}`);
147
+ return 0;
148
+ }
149
+ if (action === "list") {
150
+ const users = await listUsers(await openAuth());
151
+ if (users.length === 0)
152
+ console.log("Aucun compte.");
153
+ for (const user of users)
154
+ console.log(`${user.email}\t${user.name}\t${user.createdAt.toISOString()}\t${user.twoFactor ? "2FA" : "sans 2FA"}`);
155
+ return 0;
156
+ }
157
+ console.error(`Usage :\n${USERS_USAGE}`);
158
+ return 1;
159
+ }
160
+ catch (err) {
161
+ console.error(`Erreur : ${err?.message ?? err}`);
162
+ return 1;
163
+ }
164
+ }
@@ -0,0 +1,15 @@
1
+ import { type AgentTokenView } from "../../shared/schemas/agent-token.schema.js";
2
+ /** Tokens d'agent, du plus récent au plus ancien. */
3
+ export declare function listAgentTokens(dataDir: string): AgentTokenView[];
4
+ /** Crée un token nommé `name` ; rend le token en clair, qui n'est plus jamais lisible ensuite. */
5
+ export declare function createAgentToken(dataDir: string, name: string): {
6
+ token: AgentTokenView;
7
+ secret: string;
8
+ };
9
+ /** Révoque un token : il cesse aussitôt d'ouvrir l'accès. */
10
+ export declare function revokeAgentToken(dataDir: string, id: string): void;
11
+ /**
12
+ * Token d'agent correspondant à `secret`, null s'il n'existe pas ou a été
13
+ * révoqué. Sa date de dernière utilisation est mise à jour.
14
+ */
15
+ export declare function authenticateAgent(dataDir: string, secret: string): AgentTokenView | null;
@@ -0,0 +1,96 @@
1
+ import crypto from "crypto";
2
+ import fs from "fs";
3
+ import path from "path";
4
+ import { AgentTokensFileSchema } from "../../shared/schemas/agent-token.schema.js";
5
+ import { NotFoundError, TrackerError } from "./errors.js";
6
+ /**
7
+ * Tokens d'accès des agents, dans `<données>/agent-tokens.json`, lisible par le
8
+ * seul compte du serveur. Un token se présente au serveur par l'en-tête
9
+ * `Authorization: Bearer <token>` ; seule son empreinte est enregistrée.
10
+ */
11
+ /** Préfixe qui rend un token d'agent reconnaissable. */
12
+ const TOKEN_PREFIX = "dtk_";
13
+ /** Écart en deçà duquel une nouvelle utilisation ne réécrit pas `lastUsedAt`. */
14
+ const LAST_USED_RESOLUTION_MS = 60_000;
15
+ function tokensPath(dataDir) {
16
+ return path.join(dataDir, "agent-tokens.json");
17
+ }
18
+ function hashOf(secret) {
19
+ return crypto.createHash("sha256").update(secret, "utf-8").digest("hex");
20
+ }
21
+ function view({ hash: _hash, ...token }) {
22
+ return token;
23
+ }
24
+ function readTokens(dataDir) {
25
+ const file = tokensPath(dataDir);
26
+ let raw;
27
+ try {
28
+ raw = fs.readFileSync(file, "utf-8");
29
+ }
30
+ catch (err) {
31
+ if (err.code === "ENOENT")
32
+ return { tokens: [] };
33
+ throw err;
34
+ }
35
+ const parsed = AgentTokensFileSchema.safeParse(JSON.parse(raw));
36
+ if (!parsed.success)
37
+ throw new TrackerError(`${file} is invalid: ${parsed.error.message}`);
38
+ return parsed.data;
39
+ }
40
+ function writeTokens(dataDir, file) {
41
+ const target = tokensPath(dataDir);
42
+ const tmp = `${target}.${crypto.randomBytes(4).toString("hex")}.tmp`;
43
+ try {
44
+ fs.writeFileSync(tmp, JSON.stringify(AgentTokensFileSchema.parse(file), null, 2), { encoding: "utf-8", mode: 0o600 });
45
+ fs.renameSync(tmp, target);
46
+ }
47
+ catch (err) {
48
+ fs.rmSync(tmp, { force: true });
49
+ throw err;
50
+ }
51
+ }
52
+ /** Tokens d'agent, du plus récent au plus ancien. */
53
+ export function listAgentTokens(dataDir) {
54
+ return readTokens(dataDir)
55
+ .tokens.map(view)
56
+ .sort((a, b) => b.createdAt.localeCompare(a.createdAt));
57
+ }
58
+ /** Crée un token nommé `name` ; rend le token en clair, qui n'est plus jamais lisible ensuite. */
59
+ export function createAgentToken(dataDir, name) {
60
+ const secret = `${TOKEN_PREFIX}${crypto.randomBytes(24).toString("base64url")}`;
61
+ const token = {
62
+ id: crypto.randomBytes(6).toString("hex"),
63
+ name: name.trim(),
64
+ hash: hashOf(secret),
65
+ hint: secret.slice(-4),
66
+ createdAt: new Date().toISOString(),
67
+ lastUsedAt: null,
68
+ };
69
+ const file = readTokens(dataDir);
70
+ writeTokens(dataDir, { tokens: [...file.tokens, token] });
71
+ return { token: view(token), secret };
72
+ }
73
+ /** Révoque un token : il cesse aussitôt d'ouvrir l'accès. */
74
+ export function revokeAgentToken(dataDir, id) {
75
+ const file = readTokens(dataDir);
76
+ if (!file.tokens.some((token) => token.id === id))
77
+ throw new NotFoundError(`Agent token "${id}" does not exist.`);
78
+ writeTokens(dataDir, { tokens: file.tokens.filter((token) => token.id !== id) });
79
+ }
80
+ /**
81
+ * Token d'agent correspondant à `secret`, null s'il n'existe pas ou a été
82
+ * révoqué. Sa date de dernière utilisation est mise à jour.
83
+ */
84
+ export function authenticateAgent(dataDir, secret) {
85
+ const file = readTokens(dataDir);
86
+ const hash = hashOf(secret);
87
+ const token = file.tokens.find((candidate) => crypto.timingSafeEqual(Buffer.from(candidate.hash, "hex"), Buffer.from(hash, "hex")));
88
+ if (!token)
89
+ return null;
90
+ const now = new Date();
91
+ if (token.lastUsedAt !== null && now.getTime() - Date.parse(token.lastUsedAt) < LAST_USED_RESOLUTION_MS)
92
+ return view(token);
93
+ const used = { ...token, lastUsedAt: now.toISOString() };
94
+ writeTokens(dataDir, { tokens: file.tokens.map((candidate) => (candidate.id === token.id ? used : candidate)) });
95
+ return view(used);
96
+ }