@tricoteuses/senat 3.1.2 → 3.1.4

package/lib/src/git.js

@@ -1,251 +0,0 @@
-import { execSync } from "node:child_process";
-import fs from "fs-extra";
-import path from "node:path";
-const MAXBUFFER = 50 * 1024 * 1024;
-const GIT_LOCK_RETRY_DELAY_MS = 1000;
-const GIT_LOCK_RETRY_COUNT = 5;
-const GIT_LOCK_STALE_AFTER_MS = 2 * 60 * 1000;
-function asExecSyncError(error) {
-    return error;
-}
-function outputToString(output) {
-    if (output == null) {
-        return "";
-    }
-    return Buffer.isBuffer(output) ? output.toString("utf-8") : output;
-}
-function sleep(ms) {
-    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
-}
-function getIndexLockPath(repositoryDir) {
-    return path.join(repositoryDir, ".git", "index.lock");
-}
-function isIndexLockError(error) {
-    const stderr = error instanceof Error ? outputToString(asExecSyncError(error).stderr) : "";
-    return /index\.lock': File exists\./.test(stderr);
-}
-function removeStaleIndexLock(repositoryDir) {
-    const lockPath = getIndexLockPath(repositoryDir);
-    if (!fs.existsSync(lockPath)) {
-        return false;
-    }
-    const stats = fs.statSync(lockPath);
-    const ageMs = Date.now() - stats.mtimeMs;
-    if (ageMs < GIT_LOCK_STALE_AFTER_MS) {
-        return false;
-    }
-    fs.removeSync(lockPath);
-    return true;
-}
-function execGitWithIndexLockRecovery(command, repositoryDir, options) {
-    let lockRemoved = false;
-    for (let attempt = 1; attempt <= GIT_LOCK_RETRY_COUNT; attempt++) {
-        try {
-            execSync(command, {
-                cwd: repositoryDir,
-                ...options,
-            });
-            return;
-        }
-        catch (error) {
-            if (!isIndexLockError(error)) {
-                throw error;
-            }
-            if (!lockRemoved && removeStaleIndexLock(repositoryDir)) {
-                lockRemoved = true;
-                continue;
-            }
-            if (attempt === GIT_LOCK_RETRY_COUNT) {
-                throw error;
-            }
-            sleep(GIT_LOCK_RETRY_DELAY_MS);
-        }
-    }
-}
-export function initRepo(repositoryDir) {
-    if (!fs.existsSync(path.join(repositoryDir, ".git"))) {
-        fs.ensureDirSync(repositoryDir);
-        execSync("git init", {
-            cwd: repositoryDir,
-            env: process.env,
-            encoding: "utf-8",
-            stdio: ["ignore", "ignore", "pipe"],
-        });
-    }
-}
-export function commit(repositoryDir, message) {
-    initRepo(repositoryDir);
-    execGitWithIndexLockRecovery("git add .", repositoryDir, {
-        env: process.env,
-        encoding: "utf-8",
-        stdio: ["ignore", "ignore", "pipe"],
-        maxBuffer: MAXBUFFER,
-    });
-    try {
-        execSync(`git commit -m "${message}" --quiet`, {
-            cwd: repositoryDir,
-            env: process.env,
-            encoding: "utf-8",
-            stdio: ["ignore", "pipe", "pipe"],
-        });
-        return true;
-    }
-    catch (error) {
-        const childProcess = asExecSyncError(error);
-        if (childProcess.stdout === null || !/nothing to commit|rien à valider/.test(outputToString(childProcess.stdout))) {
-            console.error(childProcess.output);
-            throw childProcess;
-        }
-        return false;
-    }
-}
-export function commitAndPush(repositoryDir, message, remotes) {
-    let exitCode = 0;
-    if (commit(repositoryDir, message)) {
-        for (const remote of remotes || []) {
-            try {
-                execSync(`git push ${remote} master`, {
-                    cwd: repositoryDir,
-                    env: process.env,
-                    encoding: "utf-8",
-                    stdio: ["ignore", "ignore", "pipe"],
-                });
-            }
-            catch (error) {
-                const childProcess = asExecSyncError(error);
-                // Don't stop when push fails.
-                console.error(childProcess.output);
-                exitCode = childProcess.status ?? 1;
-            }
-        }
-    }
-    else {
-        // There was nothing to commit.
-        exitCode = 10;
-    }
-    return exitCode;
-}
-export function pull(repositoryDir, remote = "origin", branch = "master") {
-    initRepo(repositoryDir);
-    const statusOutput = execSync("git status --porcelain", {
-        cwd: repositoryDir,
-        env: process.env,
-        encoding: "utf-8",
-        stdio: ["ignore", "pipe", "pipe"],
-        maxBuffer: MAXBUFFER,
-    }).trim();
-    if (statusOutput.length > 0) {
-        return false;
-    }
-    execSync(`git pull --rebase ${remote} ${branch}`, {
-        cwd: repositoryDir,
-        env: process.env,
-        encoding: "utf-8",
-        stdio: ["ignore", "ignore", "pipe"],
-        maxBuffer: MAXBUFFER,
-    });
-    return true;
-}
-export function resetAndPull(gitDir) {
-    execSync("git reset --hard origin/master", {
-        cwd: gitDir,
-        env: process.env,
-        encoding: "utf-8",
-        stdio: ["ignore", "ignore", "pipe"],
-    });
-    execSync("git pull --rebase", {
-        cwd: gitDir,
-        env: process.env,
-        encoding: "utf-8",
-        stdio: ["ignore", "ignore", "pipe"],
-    });
-    return true;
-}
-export function clone(gitGroupUrl, gitName, workingDir) {
-    if (gitGroupUrl !== undefined) {
-        execSync(`git clone ${gitGroupUrl}/${gitName}.git`, {
-            cwd: workingDir,
-            env: process.env,
-            encoding: "utf-8",
-            stdio: ["ignore", "ignore", "pipe"],
-        });
-    }
-}
-export function run(repositoryDir, args, verbose) {
-    try {
-        if (verbose)
-            console.log(`git -C ${repositoryDir} ${args}`);
-        const output = execSync(`git ${args}`, {
-            cwd: repositoryDir,
-            maxBuffer: MAXBUFFER,
-        })
-            .toString()
-            .trim();
-        if (verbose)
-            console.log(output);
-        return output;
-    }
-    catch (error) {
-        const childProcess = asExecSyncError(error);
-        for (const output of ["stdout", "stderr"]) {
-            console.error(`${output}: ${outputToString(childProcess[output])}`);
-        }
-        throw childProcess;
-    }
-}
-export function test(repositoryDir, args, verbose) {
-    try {
-        if (verbose)
-            console.log(`git -C ${repositoryDir} ${args}`);
-        const output = execSync(`git ${args}`, {
-            cwd: repositoryDir,
-            stdio: ["ignore", "pipe", "pipe"],
-            maxBuffer: MAXBUFFER,
-        })
-            .toString()
-            .trim();
-        if (verbose)
-            console.log(output);
-        return true;
-    }
-    catch (error) {
-        const childProcess = asExecSyncError(error);
-        if (childProcess.status !== 0)
-            return false;
-        throw childProcess;
-    }
-}
-/**
- * Get the list of files that have changed since a specific commit in a git repository.
- * @param repositoryDir The directory of the git repository
- * @param sinceCommit The commit hash to compare against (e.g., "HEAD~1", "abc123", etc.)
- * @param options Options for filtering
- * @param options.diffFilter Git diff-filter string (default: "AMR").
- *        A=Added, M=Modified, D=Deleted, R=Renamed, C=Copied, T=Type changed, U=Unmerged
- * @returns A Map of file paths to their git status
- */
-export function getChangedFilesSinceCommit(repositoryDir, sinceCommit, options = {}) {
-    const { diffFilter } = options;
-    try {
-        // Using diff-filter: A = Added, M = Modified, R = Renamed, D = Deleted, etc.
-        // Default to AMR (excludes deleted files to prevent loading errors)
-        const filter = diffFilter ?? "AMR";
-        const output = run(repositoryDir, `diff --name-status --diff-filter=${filter} ${sinceCommit}`, false);
-        const changedFiles = new Map();
-        for (const line of output.split("\n")) {
-            if (line.trim().length === 0)
-                continue;
-            const parts = line.split("\t");
-            if (parts.length >= 2) {
-                const status = parts[0].charAt(0);
-                const path = parts[1];
-                changedFiles.set(path, status);
-            }
-        }
-        return changedFiles;
-    }
-    catch (error) {
-        console.error(`Error getting changed files since commit ${sinceCommit}:`, error);
-        return new Map();
-    }
-}

package/lib/src/loaders.d.ts

@@ -1,52 +0,0 @@
-import { AmendementResult } from "./model/ameli.js";
-import { DebatResult } from "./model/debats.js";
-import { DossierLegislatifResult } from "./model/dosleg.js";
-import { QuestionResult } from "./model/questions.js";
-import { ScrutinResult } from "./model/scrutins.js";
-import { CirconscriptionResult, OrganismeResult, SenateurResult } from "./model/sens.js";
-import { Reunion } from "./types/agenda.js";
-import { FlatTexte, DocumentMetadata } from "./types/texte.js";
-import { CompteRendu } from "./types/compte_rendu.js";
-import { DocumentResult } from "./model/documents.js";
-export { EnabledDatasets } from "./datasets.js";
-export type { DocumentResult } from "./model/documents.js";
-export declare const AGENDA_FOLDER = "agenda";
-export declare const COMPTES_RENDUS_FOLDER = "seances";
-export declare const COMMISSION_FOLDER = "commissions";
-export declare const DOSLEG_DOSSIERS_FOLDER = "dossiers";
-export declare const ENRICHED_TEXTE_FOLDER = "leg_enrichi";
-export declare const SCRUTINS_FOLDER = "scrutins";
-export declare const SENS_CIRCONSCRIPTIONS_FOLDER = "circonscriptions";
-export declare const SENS_ORGANISMES_FOLDER = "organismes";
-export declare const SENS_SENATEURS_FOLDER = "senateurs";
-export declare const TEXTE_FOLDER = "leg";
-export declare const RAPPORT_FOLDER = "rap";
-export declare const DATA_ORIGINAL_FOLDER = "original";
-export declare const DATA_TRANSFORMED_FOLDER = "transformed";
-export declare const DOCUMENT_METADATA_FILE = "metadata.json";
-export type IterItem<T> = {
-    item: T;
-    filePathFromDataset?: string;
-    legislature?: number;
-    gitStatus?: "A" | "M" | "D" | "R" | "C" | "T" | "U";
-};
-export declare function iterFilePaths(dirPath: string): Generator<string>;
-export declare function iterLoadSenatAmendements(dataDir: string, session: number | undefined, options?: {}): Generator<IterItem<AmendementResult>>;
-export declare function iterLoadSenatDebats(dataDir: string, session: number | undefined, options?: {}): Generator<IterItem<DebatResult>>;
-export declare function iterLoadSenatComptesRendusSeances(dataDir: string, session: number | undefined, options?: {}): Generator<IterItem<CompteRendu>>;
-export declare function iterLoadSenatComptesRendusCommissions(dataDir: string, session: number, options?: {}): Generator<IterItem<CompteRendu>>;
-export declare function iterLoadSenatDossiersLegislatifs(dataDir: string, session: number | undefined, options?: {}): Generator<IterItem<DossierLegislatifResult>>;
-export declare function iterLoadSenatRapportUrls(dataDir: string, session: number | undefined): Generator<IterItem<DocumentMetadata>>;
-export declare function iterLoadSenatTexteUrls(dataDir: string, session: number | undefined): Generator<IterItem<DocumentMetadata>>;
-export declare function iterLoadSenatRapports(dataDir: string, session: number | undefined, options?: {}): Generator<IterItem<DocumentResult>>;
-export declare function iterLoadSenatTextes(dataDir: string, session: number | undefined, options?: {}): Generator<IterItem<DocumentResult & Partial<FlatTexte>>>;
-export declare function loadSenatTexteContent(dataDir: string, session: number | string | null | undefined, texteId: string): IterItem<FlatTexte | null>;
-export declare function loadSenatCompteRenduContent(dataDir: string, session: number, debatId: string | number): {
-    item: CompteRendu | null;
-};
-export declare function iterLoadSenatAgendas(dataDir: string, session: number | undefined): Generator<IterItem<Reunion>>;
-export declare function iterLoadSenatCirconscriptions(dataDir: string, options?: {}): Generator<IterItem<CirconscriptionResult>>;
-export declare function iterLoadSenatOrganismes(dataDir: string, options?: {}): Generator<IterItem<OrganismeResult>>;
-export declare function iterLoadSenatSenateurs(dataDir: string, options?: {}): Generator<IterItem<SenateurResult>>;
-export declare function iterLoadSenatQuestions(dataDir: string, legislature: number, options?: {}): Generator<IterItem<QuestionResult>>;
-export declare function iterLoadSenatScrutins(dataDir: string, session: number | undefined, options?: {}): Generator<IterItem<ScrutinResult>>;

package/lib/src/loaders.js

@@ -1,260 +0,0 @@
-import fsex from "fs-extra";
-import fs from "fs";
-import path from "path";
-import * as git from "./git.js";
-import { datasets } from "./datasets.js";
-import { UNDEFINED_SESSION } from "./types/sessions.js";
-export { EnabledDatasets } from "./datasets.js";
-export const AGENDA_FOLDER = "agenda";
-export const COMPTES_RENDUS_FOLDER = "seances";
-export const COMMISSION_FOLDER = "commissions";
-export const DOSLEG_DOSSIERS_FOLDER = "dossiers";
-export const ENRICHED_TEXTE_FOLDER = "leg_enrichi";
-export const SCRUTINS_FOLDER = "scrutins";
-export const SENS_CIRCONSCRIPTIONS_FOLDER = "circonscriptions";
-export const SENS_ORGANISMES_FOLDER = "organismes";
-export const SENS_SENATEURS_FOLDER = "senateurs";
-export const TEXTE_FOLDER = "leg";
-export const RAPPORT_FOLDER = "rap";
-export const DATA_ORIGINAL_FOLDER = "original";
-export const DATA_TRANSFORMED_FOLDER = "transformed";
-export const DOCUMENT_METADATA_FILE = "metadata.json";
-export function* iterFilePaths(dirPath) {
-    if (dirPath && fs.existsSync(dirPath)) {
-        const files = fs.readdirSync(dirPath, {
-            withFileTypes: true,
-            recursive: true,
-        });
-        for (const file of files) {
-            if (file.isFile()) {
-                yield path.join(file.parentPath, file.name);
-            }
-        }
-    }
-}
-function* iterLoadSenatItems(dataDir, dataName, legislatureOrSession, subDir, { log = false, sinceCommit } = {}) {
-    let itemsDir = path.join(dataDir, dataName);
-    if (subDir) {
-        itemsDir = path.join(itemsDir, subDir);
-    }
-    if (legislatureOrSession) {
-        itemsDir = path.join(itemsDir, String(legislatureOrSession));
-    }
-    // Get changed files if sinceCommit is specified (excluding deleted files)
-    const changedFiles = sinceCommit
-        ? git.getChangedFilesSinceCommit(itemsDir, sinceCommit, {
-            diffFilter: "AMR", // Added, Modified, Renamed
-        })
-        : null;
-    if (log && sinceCommit) {
-        console.log(`Filtering files changed since commit ${sinceCommit} in ${itemsDir}`);
-        console.log(`Found ${changedFiles?.size || 0} changed files (AMR)`);
-    }
-    for (const filePath of iterFilePaths(itemsDir)) {
-        if (!filePath.endsWith(".json")) {
-            continue;
-        }
-        const relativePath = path.relative(path.join(dataDir, dataName), filePath);
-        const gitStatus = changedFiles?.get(relativePath);
-        // Filter by changed files if sinceCommit is specified
-        if (changedFiles && !gitStatus) {
-            // Skip files not in the change set
-            continue;
-        }
-        if (log) {
-            console.log(`Loading file: ${filePath}…${gitStatus ? ` (${gitStatus})` : ""}`);
-        }
-        let item;
-        try {
-            const itemJson = fs.readFileSync(filePath, { encoding: "utf8" });
-            item = JSON.parse(itemJson);
-        }
-        catch (error) {
-            const err = error;
-            console.warn(`[iterLoadSenatItems] skipped invalid JSON: ${filePath} (${err.message})`);
-            continue;
-        }
-        const filePathFromDataset = filePath.substring(filePath.indexOf(dataName) + dataName.length);
-        yield {
-            item,
-            filePathFromDataset,
-            legislature: legislatureOrSession,
-            ...(gitStatus && { gitStatus }), // Include gitStatus
-        };
-    }
-    // Yield deleted files at the end if sinceCommit is specified
-    if (sinceCommit) {
-        const deletedFiles = git.getChangedFilesSinceCommit(itemsDir, sinceCommit, {
-            diffFilter: "D", // Deleted
-        });
-        if (log) {
-            console.log(`Found ${deletedFiles.size || 0} deleted files (D)`);
-        }
-        for (const [relativePath, status] of deletedFiles.entries()) {
-            const deletedFilePath = path.join(itemsDir, relativePath);
-            if (log) {
-                console.log(`Deleted file: ${deletedFilePath}`);
-            }
-            // Extract UID from filename (remove extension) for the placeholder item
-            const fileExtension = path.extname(relativePath) || ".json"; // Assuming files use an extension like .json
-            const filename = path.basename(relativePath, fileExtension);
-            const fakeItem = { uid: filename }; // Placeholder item using uid constraint
-            const filePathFromDataset = deletedFilePath.substring(deletedFilePath.indexOf(dataName) + dataName.length);
-            yield {
-                item: fakeItem,
-                filePathFromDataset,
-                legislature: legislatureOrSession,
-                gitStatus: status,
-            };
-        }
-    }
-}
-export function* iterLoadSenatAmendements(dataDir, session, options = {}) {
-    for (const amendementItem of iterLoadSenatItems(dataDir, datasets.ameli.database, session, undefined, options)) {
-        yield amendementItem;
-    }
-}
-export function* iterLoadSenatDebats(dataDir, session, options = {}) {
-    for (const debatItem of iterLoadSenatItems(dataDir, datasets.debats.database, session, undefined, options)) {
-        yield debatItem;
-    }
-}
-export function* iterLoadSenatComptesRendusSeances(dataDir, session, options = {}) {
-    for (const compteRenduItem of iterLoadSenatItems(dataDir, COMPTES_RENDUS_FOLDER, session, DATA_TRANSFORMED_FOLDER, options)) {
-        yield compteRenduItem;
-    }
-}
-export function* iterLoadSenatComptesRendusCommissions(dataDir, session, options = {}) {
-    for (const compteRenduItem of iterLoadSenatItems(dataDir, COMMISSION_FOLDER, session, DATA_TRANSFORMED_FOLDER, options)) {
-        yield compteRenduItem;
-    }
-}
-export function* iterLoadSenatDossiersLegislatifs(dataDir, session, options = {}) {
-    for (const dossierLegislatifItem of iterLoadSenatItems(dataDir, datasets.dosleg.database, session, DOSLEG_DOSSIERS_FOLDER, options)) {
-        yield dossierLegislatifItem;
-    }
-}
-export function* iterLoadSenatRapportUrls(dataDir, session) {
-    let itemsDir = path.join(dataDir, RAPPORT_FOLDER, DATA_ORIGINAL_FOLDER);
-    if (session) {
-        itemsDir = path.join(itemsDir, session.toString());
-    }
-    for (const filePath of iterFilePaths(itemsDir)) {
-        const parsedFilePath = path.parse(filePath);
-        if (parsedFilePath.base === DOCUMENT_METADATA_FILE) {
-            const itemJson = fs.readFileSync(filePath, { encoding: "utf8" });
-            const item = JSON.parse(itemJson);
-            yield {
-                item,
-            };
-        }
-    }
-}
-export function* iterLoadSenatTexteUrls(dataDir, session) {
-    let itemsDir = path.join(dataDir, TEXTE_FOLDER, DATA_ORIGINAL_FOLDER);
-    if (session) {
-        itemsDir = path.join(itemsDir, session.toString());
-    }
-    for (const filePath of iterFilePaths(itemsDir)) {
-        const parsedFilePath = path.parse(filePath);
-        if (parsedFilePath.base === DOCUMENT_METADATA_FILE) {
-            const itemJson = fs.readFileSync(filePath, { encoding: "utf8" });
-            const item = JSON.parse(itemJson);
-            yield {
-                item,
-            };
-        }
-    }
-}
-export function* iterLoadSenatRapports(dataDir, session, options = {}) {
-    for (const iterItem of iterLoadSenatItems(dataDir, RAPPORT_FOLDER, session, "original", options)) {
-        if (iterItem.item?.["id"]) {
-            yield iterItem;
-        }
-    }
-}
-export function* iterLoadSenatTextes(dataDir, session, options = {}) {
-    for (const iterItem of iterLoadSenatItems(dataDir, TEXTE_FOLDER, session, DATA_ORIGINAL_FOLDER, options)) {
-        if (!iterItem.item?.["id"]) {
-            continue;
-        }
-        const texteItem = iterItem;
-        const texte = texteItem.item;
-        const texteId = texte["id"];
-        if (!texteId) {
-            continue;
-        }
-        const { item: texteContent } = loadSenatTexteContent(dataDir, texte["session"], texteId);
-        if (texteContent) {
-            texteItem.item = { ...texteContent, ...texteItem.item };
-        }
-        yield texteItem;
-    }
-}
-export function loadSenatTexteContent(dataDir, session, texteId) {
-    const fullTextePath = path.join(dataDir, TEXTE_FOLDER, DATA_TRANSFORMED_FOLDER, String(session ?? UNDEFINED_SESSION), texteId, `${texteId}.json`);
-    if (!fs.existsSync(fullTextePath)) {
-        return { item: null };
-    }
-    const texteJson = fs.readFileSync(fullTextePath, { encoding: "utf8" });
-    return { item: JSON.parse(texteJson) };
-}
-export function loadSenatCompteRenduContent(dataDir, session, debatId) {
-    const fullPath = path.join(dataDir, COMPTES_RENDUS_FOLDER, DATA_TRANSFORMED_FOLDER, String(session), `${debatId}.json`);
-    if (!fs.existsSync(fullPath)) {
-        return { item: null };
-    }
-    const json = fs.readFileSync(fullPath, { encoding: "utf8" });
-    return { item: JSON.parse(json) };
-}
-export function* iterLoadSenatAgendas(dataDir, session) {
-    const baseDir = path.join(dataDir, AGENDA_FOLDER, DATA_TRANSFORMED_FOLDER, String(session ?? ""));
-    if (!fs.existsSync(baseDir))
-        return;
-    const files = (fs.readdirSync(baseDir) || []).filter((f) => f.startsWith("RUSN") && f.endsWith(".json")).sort();
-    for (const fileName of files) {
-        const filePath = path.join(baseDir, fileName);
-        let raw;
-        try {
-            raw = fsex.readJSONSync(filePath);
-        }
-        catch {
-            continue; // JSON invalide
-        }
-        if (!raw || typeof raw !== "object")
-            continue;
-        const gr = raw;
-        if (!gr.uid || !gr.date || !gr.titre)
-            continue;
-        const reunion = {
-            ...gr,
-            events: Array.isArray(gr.events) ? gr.events : [],
-        };
-        yield { item: reunion };
-    }
-}
-export function* iterLoadSenatCirconscriptions(dataDir, options = {}) {
-    for (const circonscriptionItem of iterLoadSenatItems(dataDir, datasets.sens.database, undefined, SENS_CIRCONSCRIPTIONS_FOLDER, options)) {
-        yield circonscriptionItem;
-    }
-}
-export function* iterLoadSenatOrganismes(dataDir, options = {}) {
-    for (const organismeItem of iterLoadSenatItems(dataDir, datasets.sens.database, undefined, SENS_ORGANISMES_FOLDER, options)) {
-        yield organismeItem;
-    }
-}
-export function* iterLoadSenatSenateurs(dataDir, options = {}) {
-    for (const senateurItem of iterLoadSenatItems(dataDir, datasets.sens.database, undefined, SENS_SENATEURS_FOLDER, options)) {
-        yield senateurItem;
-    }
-}
-export function* iterLoadSenatQuestions(dataDir, legislature, options = {}) {
-    for (const questionItem of iterLoadSenatItems(dataDir, datasets.questions.database, legislature, undefined, options)) {
-        yield questionItem;
-    }
-}
-export function* iterLoadSenatScrutins(dataDir, session, options = {}) {
-    for (const scrutinItem of iterLoadSenatItems(dataDir, "scrutins", session, undefined, options)) {
-        yield scrutinItem;
-    }
-}

package/lib/src/model/agenda.d.ts

@@ -1,6 +0,0 @@
-import { AgendaEvent } from "../types/agenda.js";
-export declare function getStartAndEndTimes(timeStr: string | null | undefined, dateISO: string): {
-    startTime: string | null;
-    endTime: string | null;
-};
-export declare function parseAgendaFromFile(htmlFilePath: string): Promise<AgendaEvent[] | null>;