@vidiemme/copilot-proxy 0.1.0

package/dist/cli.js

@@ -0,0 +1,393 @@
+#!/usr/bin/env node
+import { mkdirSync, readFileSync, writeFileSync, copyFileSync, statSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { parseArgs } from 'node:util';
+import { installAutostart, isAutostartInstalled } from './autostart.js';
+import { loadConfig } from './config.js';
+import { configDir, configFile, vscodeSettingsFile } from './paths.js';
+import { buildApp } from './server.js';
+const OVERRIDE_KEY = 'github.copilot.advanced.debug.overrideCapiUrl';
+const AUTH_TYPE_KEY = 'github.copilot.advanced.debug.overrideAuthType';
+const USAGE = `
+Proxy locale che misura il consumo di token di GitHub Copilot e lo attribuisce
+al progetto su cui si sta lavorando.
+
+  npx @vidiemme/copilot-proxy setup     configura la postazione (una volta sola)
+  npx @vidiemme/copilot-proxy start     avvia il proxy
+  npx @vidiemme/copilot-proxy doctor    verifica che tutto sia a posto
+
+Opzioni di setup:
+  --vscode                  scrive anche le impostazioni utente di VS Code
+  --autostart               avvia il proxy a ogni accesso, senza doverlo lanciare
+  --workspace-roots <a,b>   cartelle sotto cui vivono i repository (default: la home)
+  --port <n>                porta locale del proxy (default 8787)
+  --collector-url <url>     endpoint di raccolta, se diverso da quello aziendale
+  --salt <valore>           salt degli pseudonimi, se diverso da quello aziendale
+  --upstream <url>          endpoint Copilot (default https://api.githubcopilot.com)
+  --force                   sovrascrive una configurazione esistente
+
+L'unica cosa da procurarsi e' il token di raccolta, uguale per tutta l'azienda.
+Non si passa come opzione: finirebbe nella cronologia della shell e nella lista
+dei processi. Va nella variabile COLLECTOR_TOKEN, oppure lo chiede il comando in
+modo nascosto.
+
+Opzioni di start:
+  --port <n>  --log-level <livello>  --collector-url <url>  --workspace-roots <a,b>
+`.trimStart();
+/** I valori sul filo usano le stesse chiavi delle variabili d'ambiente: un solo vocabolario da documentare. */
+function readConfigFile() {
+    let raw;
+    try {
+        raw = readFileSync(configFile(), 'utf-8');
+    }
+    catch {
+        return {};
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`${configFile()} non e' un JSON valido: correggilo o rilancia "setup --force"`);
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        throw new Error(`${configFile()} deve contenere un oggetto JSON`);
+    }
+    const source = {};
+    for (const [key, value] of Object.entries(parsed)) {
+        if (typeof value === 'string' || typeof value === 'number')
+            source[key] = String(value);
+    }
+    return source;
+}
+/** Precedenza: opzioni della riga di comando, poi ambiente, poi file di configurazione. */
+function mergedSource(overrides) {
+    const merged = { ...readConfigFile() };
+    for (const [key, value] of Object.entries(process.env)) {
+        if (value !== undefined && value.trim().length > 0)
+            merged[key] = value;
+    }
+    for (const [key, value] of Object.entries(overrides)) {
+        if (value !== undefined)
+            merged[key] = value;
+    }
+    return merged;
+}
+function writeConfigFile(values) {
+    mkdirSync(configDir(), { recursive: true, mode: 0o700 });
+    // Il file contiene il token di raccolta: leggibile solo dal proprietario.
+    writeFileSync(configFile(), `${JSON.stringify(values, null, 2)}\n`, { mode: 0o600 });
+}
+/**
+ * Legge un segreto dal terminale senza mostrarlo.
+ *
+ * Serve la modalita' raw perche' `readline` non sa nascondere l'eco: si legge
+ * carattere per carattere e si stampa nulla.
+ */
+function promptSecret(question) {
+    const { stdin, stdout } = process;
+    if (!stdin.isTTY) {
+        return Promise.reject(new Error('COLLECTOR_TOKEN non impostato e nessun terminale interattivo disponibile: esporta la variabile prima di lanciare il comando'));
+    }
+    return new Promise((resolve, reject) => {
+        stdout.write(question);
+        stdin.setRawMode(true);
+        stdin.resume();
+        stdin.setEncoding('utf8');
+        let value = '';
+        const finish = (action) => {
+            stdin.setRawMode(false);
+            stdin.pause();
+            stdin.off('data', onData);
+            stdout.write('\n');
+            action();
+        };
+        const onData = (chunk) => {
+            for (const char of chunk) {
+                if (char === '\r' || char === '\n')
+                    return finish(() => resolve(value));
+                if (char === '\u0003')
+                    return finish(() => reject(new Error('interrotto')));
+                if (char === '\u007f' || char === '\b')
+                    value = value.slice(0, -1);
+                else if (char >= ' ')
+                    value += char;
+            }
+        };
+        stdin.on('data', onData);
+    });
+}
+async function commandSetup(flags) {
+    const existing = readConfigFile();
+    if (Object.keys(existing).length > 0 && flags.force !== true) {
+        console.error(`Esiste gia' ${configFile()}. Rilancia con --force per sostituirlo.`);
+        return 1;
+    }
+    const token = process.env.COLLECTOR_TOKEN ?? (await promptSecret('Token di raccolta: '));
+    if (token.trim().length === 0) {
+        console.error('Token vuoto.');
+        return 1;
+    }
+    // Si scrive solo cio' che si discosta dai default del pacchetto: un file
+    // corto e' un file che si capisce, e i default restano aggiornabili con una
+    // nuova versione invece che postazione per postazione.
+    const values = { COLLECTOR_TOKEN: token.trim() };
+    const collectorUrl = flags['collector-url'];
+    if (collectorUrl)
+        values.COLLECTOR_URL = collectorUrl;
+    const salt = flags.salt;
+    if (salt)
+        values.DEVELOPER_ID_SALT = salt;
+    const workspaceRoots = flags['workspace-roots'];
+    if (workspaceRoots)
+        values.WORKSPACE_ROOTS = workspaceRoots;
+    if (flags.port)
+        values.PORT = String(flags.port);
+    if (flags.upstream)
+        values.UPSTREAM_BASE_URL = String(flags.upstream);
+    // Meglio scoprire ora che la configurazione non regge, non al primo avvio.
+    let config;
+    try {
+        config = loadConfig({ ...values });
+    }
+    catch (error) {
+        console.error(`Configurazione non valida: ${error.message}`);
+        return 1;
+    }
+    writeConfigFile(values);
+    console.log(`Scritto ${configFile()}`);
+    console.log(`Raccolta verso ${config.collectorUrl}`);
+    console.log(`Progetti cercati sotto ${config.workspaceRoots.join(', ')}`);
+    if (flags.vscode === true)
+        applyVsCodeSettings(config.port);
+    else
+        printVsCodeSettings(config.port);
+    if (flags.autostart === true) {
+        try {
+            const service = installAutostart();
+            console.log(`\nAvvio automatico attivo: ${service.file}`);
+            console.log(`Il proxy e' gia' partito e ripartira' a ogni accesso. Per disattivarlo:\n  ${service.removeHint}`);
+            if (service.warning)
+                console.log(`\nATTENZIONE: ${service.warning}`);
+        }
+        catch (error) {
+            console.error(`\nAvvio automatico non riuscito: ${error.message}`);
+            return 1;
+        }
+        return 0;
+    }
+    console.log('\nPoi avvia il proxy con:  npx @vidiemme/copilot-proxy start');
+    console.log('Per non doverlo fare ogni volta, rilancia il setup con --autostart');
+    return 0;
+}
+function vsCodeSnippet(port) {
+    return { [OVERRIDE_KEY]: `http://127.0.0.1:${port}`, [AUTH_TYPE_KEY]: 'token' };
+}
+function printVsCodeSettings(port) {
+    console.log('\nAggiungi alle impostazioni utente di VS Code (Preferences: Open User Settings (JSON)):\n' +
+        `${JSON.stringify(vsCodeSnippet(port), null, 2)}\n` +
+        'Oppure rilancia il setup con --vscode per farlo scrivere al comando.');
+}
+function applyVsCodeSettings(port) {
+    const file = vscodeSettingsFile();
+    let current = {};
+    let exists = true;
+    try {
+        const raw = readFileSync(file, 'utf-8');
+        // `settings.json` ammette commenti e virgole finali: se non e' JSON puro,
+        // riscriverlo lo distruggerebbe. Meglio arrendersi e dire cosa aggiungere.
+        current = JSON.parse(raw);
+        copyFileSync(file, `${file}.bak`);
+    }
+    catch (error) {
+        exists = error.code !== 'ENOENT';
+        if (exists) {
+            console.log(`\nNon riesco a modificare ${file} senza rischiare di rovinarlo (contiene commenti o non e' JSON valido).`);
+            printVsCodeSettings(port);
+            return;
+        }
+    }
+    mkdirSync(dirname(file), { recursive: true });
+    writeFileSync(file, `${JSON.stringify({ ...current, ...vsCodeSnippet(port) }, null, 2)}\n`);
+    console.log(`Aggiornato ${file}${exists ? ` (backup in ${file}.bak)` : ''}`);
+    console.log("Riavvia VS Code perche' le impostazioni abbiano effetto.");
+}
+async function commandStart(flags) {
+    const overrides = {};
+    if (flags.port)
+        overrides.PORT = String(flags.port);
+    if (flags['log-level'])
+        overrides.LOG_LEVEL = String(flags['log-level']);
+    if (flags['collector-url'])
+        overrides.COLLECTOR_URL = String(flags['collector-url']);
+    if (flags['workspace-roots'])
+        overrides.WORKSPACE_ROOTS = String(flags['workspace-roots']);
+    let config;
+    try {
+        config = loadConfig(mergedSource(overrides));
+    }
+    catch (error) {
+        console.error(`${error.message}\n\nSe e' la prima volta:  npx @vidiemme/copilot-proxy setup`);
+        return 1;
+    }
+    const app = await buildApp(config);
+    await app.server.listen({ port: config.port, host: config.host });
+    const shutdown = (signal) => {
+        app.server.log.info({ signal }, 'arresto in corso');
+        void app.close().then(() => process.exit(0), (error) => {
+            app.server.log.error({ err: error }, 'arresto fallito');
+            process.exit(1);
+        });
+    };
+    process.on('SIGINT', () => shutdown('SIGINT'));
+    process.on('SIGTERM', () => shutdown('SIGTERM'));
+    return 0;
+}
+async function commandDoctor() {
+    const results = [];
+    const check = (ok, message) => {
+        results.push([ok, message]);
+    };
+    let config;
+    try {
+        config = loadConfig(mergedSource({}));
+        check(true, 'configurazione leggibile e completa');
+    }
+    catch (error) {
+        check(false, `configurazione: ${error.message}`);
+        report(results);
+        console.log('\nLancia prima:  npx @vidiemme/copilot-proxy setup');
+        return 1;
+    }
+    const roots = config.workspaceRoots;
+    if (roots.length === 0) {
+        check(false, 'WORKSPACE_ROOTS non impostato: il progetto finira\' in "unassigned"');
+    }
+    else {
+        const missing = roots.filter((root) => !existsDir(root));
+        check(missing.length === 0, missing.length === 0
+            ? `cartelle di lavoro raggiungibili (${roots.join(', ')})`
+            : `cartelle di lavoro inesistenti: ${missing.join(', ')}`);
+    }
+    // Un batch vuoto viene rifiutato dalla validazione, che pero' gira *dopo*
+    // l'autenticazione: un 400 dimostra quindi che il token e' stato accettato.
+    try {
+        const response = await fetch(config.collectorUrl, {
+            method: 'POST',
+            headers: {
+                'content-type': 'application/json',
+                authorization: `Bearer ${config.collectorToken}`,
+            },
+            body: JSON.stringify({ events: [] }),
+            signal: AbortSignal.timeout(config.collectorTimeoutMs),
+        });
+        if (response.status === 401)
+            check(false, 'il servizio di raccolta rifiuta il token');
+        else if (response.status === 400)
+            check(true, 'servizio di raccolta raggiungibile, token valido');
+        else
+            check(false, `il servizio di raccolta risponde ${response.status}, inatteso`);
+    }
+    catch (error) {
+        check(false, `servizio di raccolta irraggiungibile: ${error.message}`);
+    }
+    // Ricerca testuale e non `JSON.parse`: `settings.json` ammette commenti e
+    // virgole finali, e una diagnostica non deve fallire per quello.
+    try {
+        const raw = readFileSync(vscodeSettingsFile(), 'utf-8');
+        const match = new RegExp(`"${OVERRIDE_KEY.replace(/\./g, '\\.')}"\\s*:\\s*"([^"]*)"`).exec(raw);
+        const expected = `http://127.0.0.1:${config.port}`;
+        // `localhost` e `127.0.0.1` sono equivalenti: non vale la pena segnalarlo.
+        const ok = match !== null && new RegExp(`^https?://(127\\.0\\.0\\.1|localhost):${config.port}/?$`).test(match[1] ?? '');
+        check(ok, ok
+            ? `VS Code punta al proxy (${match?.[1] ?? expected})`
+            : match
+                ? `VS Code punta a ${match[1]}, atteso ${expected}`
+                : "VS Code non e' configurato per passare dal proxy");
+    }
+    catch {
+        check(false, `impostazioni di VS Code non trovate in ${vscodeSettingsFile()}`);
+    }
+    const pending = spoolSize(config.spoolPath);
+    check(pending === 0, pending === 0 ? 'nessun evento in attesa di consegna' : `${pending} byte di eventi in attesa nello spool`);
+    // L'avvio automatico interessa solo se il proxy non sta gia' girando: chi
+    // preferisce lanciarlo a mano non deve vedere un errore.
+    let proxyUp = false;
+    try {
+        const health = await fetch(`http://127.0.0.1:${config.port}/_health`, {
+            signal: AbortSignal.timeout(2000),
+        });
+        proxyUp = health.ok;
+    }
+    catch {
+        proxyUp = false;
+    }
+    check(proxyUp, proxyUp
+        ? `proxy in ascolto${isAutostartInstalled() ? ', con avvio automatico' : ''}`
+        : `nessun proxy in ascolto sulla porta ${config.port}: attivalo per sempre con "setup --autostart --force", o una volta sola con "start"`);
+    report(results);
+    return results.every(([ok]) => ok) ? 0 : 1;
+}
+function report(results) {
+    for (const [ok, message] of results)
+        console.log(`${ok ? 'OK  ' : 'FAIL'} ${message}`);
+}
+function existsDir(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function spoolSize(path) {
+    try {
+        return statSync(path).size;
+    }
+    catch {
+        return 0;
+    }
+}
+async function main() {
+    const { values, positionals } = parseArgs({
+        args: process.argv.slice(2),
+        allowPositionals: true,
+        options: {
+            'collector-url': { type: 'string' },
+            salt: { type: 'string' },
+            'workspace-roots': { type: 'string' },
+            port: { type: 'string' },
+            upstream: { type: 'string' },
+            'log-level': { type: 'string' },
+            vscode: { type: 'boolean' },
+            autostart: { type: 'boolean' },
+            force: { type: 'boolean' },
+            help: { type: 'boolean', short: 'h' },
+        },
+    });
+    const command = positionals[0] ?? 'start';
+    if (values.help === true || command === 'help') {
+        console.log(USAGE);
+        return;
+    }
+    switch (command) {
+        case 'setup':
+            process.exitCode = await commandSetup(values);
+            return;
+        case 'start':
+            process.exitCode = await commandStart(values);
+            return;
+        case 'doctor':
+            process.exitCode = await commandDoctor();
+            return;
+        default:
+            console.error(`Comando sconosciuto: ${command}\n`);
+            console.log(USAGE);
+            process.exitCode = 1;
+    }
+}
+main().catch((error) => {
+    console.error(error instanceof Error ? error.message : error);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/collector/forwarder.d.ts

@@ -0,0 +1,44 @@
+import { type UsageEventPayload } from '@vidiemme/copilot-usage-contract';
+import type { ClientConfig } from '../config.js';
+export interface Logger {
+    info: (obj: object, msg: string) => void;
+    warn: (obj: object, msg: string) => void;
+    error: (obj: object, msg: string) => void;
+}
+/**
+ * Inoltra gli eventi di consumo al servizio di raccolta.
+ *
+ * Il proxy non deve mai dipendere dalla raggiungibilita' del servizio: se la
+ * rete manca o il collector e' in manutenzione, le richieste Copilot devono
+ * continuare a passare e la misura non deve andare persa. Gli eventi non
+ * consegnati finiscono quindi su un file di spool e vengono ritentati; la
+ * chiave `requestId` rende i rinvii innocui, perche' il server deduplica.
+ */
+export declare class UsageForwarder {
+    private readonly config;
+    private readonly logger;
+    private queue;
+    private timer;
+    private pending;
+    private dropped;
+    private readonly batchSize;
+    private readonly spoolPath;
+    private readonly sendingPath;
+    constructor(config: ClientConfig, logger: Logger);
+    start(): void;
+    enqueue(event: UsageEventPayload): void;
+    /**
+     * Gli invii sono serializzati: due flush concorrenti si contenderebbero lo
+     * spool. Chi chiama attende il proprio turno, cosi' `close()` ha la garanzia
+     * che al ritorno non sia rimasto nulla in volo.
+     */
+    flush(): Promise<void>;
+    private runFlush;
+    close(): Promise<void>;
+    private send;
+    private drainSpool;
+    private recoverInterrupted;
+    private readEvents;
+    private spool;
+    private trimSpool;
+}

package/dist/collector/forwarder.js

@@ -0,0 +1,203 @@
+import { appendFile, readFile, rename, rm, stat, writeFile } from 'node:fs/promises';
+import { MAX_EVENTS_PER_BATCH } from '@vidiemme/copilot-usage-contract';
+/** Oltre questa soglia si scartano eventi per non far crescere la memoria del proxy. */
+const MAX_QUEUE_LENGTH = 10_000;
+/** Tetto agli eventi parcheggiati su disco: si tengono i piu' recenti. */
+const MAX_SPOOL_EVENTS = 50_000;
+function chunk(items, size) {
+    const chunks = [];
+    for (let index = 0; index < items.length; index += size) {
+        chunks.push(items.slice(index, index + size));
+    }
+    return chunks;
+}
+/**
+ * Inoltra gli eventi di consumo al servizio di raccolta.
+ *
+ * Il proxy non deve mai dipendere dalla raggiungibilita' del servizio: se la
+ * rete manca o il collector e' in manutenzione, le richieste Copilot devono
+ * continuare a passare e la misura non deve andare persa. Gli eventi non
+ * consegnati finiscono quindi su un file di spool e vengono ritentati; la
+ * chiave `requestId` rende i rinvii innocui, perche' il server deduplica.
+ */
+export class UsageForwarder {
+    config;
+    logger;
+    queue = [];
+    timer;
+    pending;
+    dropped = 0;
+    batchSize;
+    spoolPath;
+    sendingPath;
+    constructor(config, logger) {
+        this.config = config;
+        this.logger = logger;
+        this.batchSize = Math.min(config.flushMaxBatch, MAX_EVENTS_PER_BATCH);
+        this.spoolPath = config.spoolPath;
+        this.sendingPath = `${config.spoolPath}.sending`;
+    }
+    start() {
+        if (this.timer)
+            return;
+        // Un invio interrotto a meta' lascia indietro il file di lavoro: va
+        // recuperato prima di ripartire, altrimenti quegli eventi resterebbero li'.
+        // Entra nella catena, cosi' il primo flush lo trova gia' fatto.
+        this.pending = this.recoverInterrupted().catch(() => { });
+        this.timer = setInterval(() => {
+            void this.flush();
+        }, this.config.flushIntervalMs);
+        this.timer.unref();
+    }
+    enqueue(event) {
+        if (this.queue.length >= MAX_QUEUE_LENGTH) {
+            this.dropped += 1;
+            if (this.dropped % 100 === 1) {
+                this.logger.error({ dropped: this.dropped }, 'coda usage piena, eventi scartati');
+            }
+            return;
+        }
+        this.queue.push(event);
+        if (this.queue.length >= this.batchSize)
+            void this.flush();
+    }
+    /**
+     * Gli invii sono serializzati: due flush concorrenti si contenderebbero lo
+     * spool. Chi chiama attende il proprio turno, cosi' `close()` ha la garanzia
+     * che al ritorno non sia rimasto nulla in volo.
+     */
+    async flush() {
+        const run = (this.pending ?? Promise.resolve()).then(() => this.runFlush());
+        this.pending = run.catch(() => { });
+        await run;
+    }
+    async runFlush() {
+        try {
+            await this.drainSpool();
+            while (this.queue.length > 0) {
+                const batch = this.queue.splice(0, this.batchSize);
+                if (!(await this.send(batch))) {
+                    await this.spool([...batch, ...this.queue.splice(0)]);
+                    return;
+                }
+            }
+        }
+        catch (error) {
+            this.logger.error({ err: error }, 'inoltro usage fallito');
+        }
+    }
+    async close() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = undefined;
+        await this.flush();
+        // Cio' che resta viene parcheggiato: lo riprendera' il prossimo avvio.
+        if (this.queue.length > 0)
+            await this.spool(this.queue.splice(0));
+    }
+    async send(events) {
+        if (events.length === 0)
+            return true;
+        let response;
+        try {
+            response = await fetch(this.config.collectorUrl, {
+                method: 'POST',
+                headers: {
+                    'content-type': 'application/json',
+                    authorization: `Bearer ${this.config.collectorToken}`,
+                },
+                body: JSON.stringify({ events }),
+                signal: AbortSignal.timeout(this.config.collectorTimeoutMs),
+            });
+        }
+        catch (error) {
+            this.logger.warn({ err: error, events: events.length }, 'collector irraggiungibile');
+            return false;
+        }
+        if (response.ok)
+            return true;
+        // Un 4xx non si risolve ritentando: il payload e' rifiutato o le
+        // credenziali sono sbagliate. Tenerlo nello spool bloccherebbe tutto il
+        // resto della coda, quindi si scarta e si segnala.
+        const permanent = response.status >= 400 && response.status < 500 && response.status !== 429;
+        this.logger.error({ status: response.status, events: events.length, permanent }, permanent ? 'collector ha rifiutato gli eventi' : 'collector non disponibile');
+        return permanent;
+    }
+    async drainSpool() {
+        try {
+            await rename(this.spoolPath, this.sendingPath);
+        }
+        catch {
+            return;
+        }
+        const events = await this.readEvents(this.sendingPath);
+        const batches = chunk(events, this.batchSize);
+        for (let index = 0; index < batches.length; index += 1) {
+            if (await this.send(batches[index]))
+                continue;
+            await this.spool(batches.slice(index).flat());
+            break;
+        }
+        await rm(this.sendingPath, { force: true });
+    }
+    async recoverInterrupted() {
+        const events = await this.readEvents(this.sendingPath);
+        if (events.length === 0) {
+            await rm(this.sendingPath, { force: true });
+            return;
+        }
+        this.logger.warn({ events: events.length }, 'ripresi eventi da un invio interrotto');
+        await this.spool(events);
+        await rm(this.sendingPath, { force: true });
+    }
+    async readEvents(path) {
+        let content;
+        try {
+            content = await readFile(path, 'utf-8');
+        }
+        catch {
+            return [];
+        }
+        const events = [];
+        for (const line of content.split('\n')) {
+            if (line.trim().length === 0)
+                continue;
+            try {
+                events.push(JSON.parse(line));
+            }
+            catch {
+                // Riga troncata da un arresto brusco: si scarta solo quella.
+            }
+        }
+        return events;
+    }
+    async spool(events) {
+        if (events.length === 0)
+            return;
+        const lines = `${events.map((event) => JSON.stringify(event)).join('\n')}\n`;
+        try {
+            const size = await stat(this.spoolPath).then((info) => info.size, () => 0);
+            if (size === 0) {
+                await writeFile(this.spoolPath, lines, { mode: 0o600 });
+            }
+            else {
+                await appendFile(this.spoolPath, lines);
+            }
+            await this.trimSpool();
+        }
+        catch (error) {
+            this.logger.error({ err: error, events: events.length }, 'scrittura dello spool fallita');
+        }
+    }
+    async trimSpool() {
+        const events = await this.readEvents(this.spoolPath);
+        if (events.length <= MAX_SPOOL_EVENTS)
+            return;
+        const kept = events.slice(-MAX_SPOOL_EVENTS);
+        this.logger.error({ dropped: events.length - kept.length }, "spool oltre il limite, scartati gli eventi piu' vecchi");
+        await writeFile(this.spoolPath, `${kept.map((event) => JSON.stringify(event)).join('\n')}\n`, {
+            mode: 0o600,
+        });
+    }
+}
+//# sourceMappingURL=forwarder.js.map