@tricoteuses/senat 3.2.0 → 3.2.2

package/lib/src/types/compte_rendu.d.ts

@@ -0,0 +1,83 @@
+export interface CompteRendu {
+    uid: string;
+    seanceRef: string;
+    sessionRef: string;
+    metadonnees: Metadonnees;
+    contenu: Contenu;
+}
+export interface Metadonnees {
+    dateSeance: string;
+    dateSeanceJour: string;
+    numSeanceJour: string;
+    numSeance: string;
+    typeAssemblee: "AN" | "SN";
+    legislature: string;
+    session: string;
+    nomFichierJo: string;
+    validite: string;
+    etat: string;
+    diffusion: string;
+    version: string;
+    environnement: string;
+    heureGeneration: Date;
+    sommaire?: Sommaire;
+}
+export interface Contenu {
+    quantiemes: Quantiemes;
+    ouvertureSeance?: Point[] | Point;
+    point: Point[] | Point;
+    finSeance?: FinSeance;
+    paragraphe?: Point[];
+}
+export interface FinSeance {
+    point: Point;
+}
+export interface Quantiemes {
+    journee: string;
+    session: string;
+}
+export interface Point {
+    ordre_absolu_seance: string;
+    code_grammaire: string;
+    roledebat?: string;
+    orateurs?: {
+        orateur: {
+            nom: string;
+            id: string;
+            qualite: string;
+        };
+    };
+    texte: {
+        _: string;
+    };
+    code_style?: string;
+}
+export interface Texte {
+    _?: string;
+    id_syceron?: string;
+    stime?: string;
+    sup?: string;
+    lienAdt?: Texte[] | Texte;
+}
+export interface Sommaire {
+    presidentSeance: Texte;
+    sommaire1: SommaireElement[] | SommaireElement;
+    sommaire3?: SommaireElement[] | SommaireElement;
+    sommaire2?: SommaireElement[] | SommaireElement;
+    para?: Texte[] | Texte;
+}
+export interface SommaireElement {
+    valeur_pts_odj: string | undefined;
+    titreStruct: TitreStruct;
+    para?: Array<Texte | string> | Texte;
+    sommaire2?: SommaireElement[] | SommaireElement;
+    sommaire3?: SommaireElement[] | SommaireElement;
+    presidentSeance?: Texte[] | Texte;
+    type_debat?: string;
+}
+export interface TitreStruct {
+    id_syceron: string;
+    intitule?: string;
+    sousIntitule?: string;
+    type_debat?: string;
+}

package/lib/src/types/compte_rendu.js

@@ -0,0 +1 @@
+export {};

package/lib/src/types/debats.d.ts

@@ -0,0 +1,2 @@
+import { debats as Debat, lecassdeb as LecAssDeb } from "../raw_types_schemats/debats";
+export type { Debat, LecAssDeb };

package/lib/src/types/debats.js

@@ -0,0 +1 @@
+export {};

package/lib/src/types/dosleg.d.ts

@@ -0,0 +1,70 @@
+import { Ass, Aud as AudRaw, Auteur as AuteurRaw, DateSeance as DateSeanceRaw, Deccoc, Denrap, Docatt as DocattRaw, Ecr as EcrRaw, Etaloi, Lecass as LecassRaw, Lecassrap as LecassrapRaw, Lecture as LectureRaw, Loi as LoiRaw, Org, Oritxt, Qua, Rap as RapRaw, Raporg, Scr, Texte as TexteRaw, Typatt, Typlec, Typloi, Typtxt, Typurl } from "../raw_types/dosleg.js";
+import { TxtAmeli } from "../raw_types/ameli.js";
+import { Debats } from "../raw_types/debats.js";
+import { TxtAmeliCustom } from "./ameli.js";
+export type { Deccoc as DecCoc, Denrap as DenRap, Etaloi as EtaLoi, Oritxt as OriTxt, Raporg as RapOrg, Typatt as TypAtt, Typlec as TypLec, Typloi as TypLoi, Typtxt as TypTxt, Typurl as TypUrl, };
+export interface Aud extends AudRaw {
+    org?: Org;
+}
+export interface Auteur extends AuteurRaw {
+    qua?: Qua;
+}
+export interface DateSeance extends DateSeanceRaw {
+    debat?: Debats;
+    scrids?: string[];
+    scrs?: Scr[];
+}
+export interface DocAtt extends DocattRaw {
+    rap?: RapRaw;
+    typatt?: Typatt;
+}
+export interface Ecr extends EcrRaw {
+    aut?: Auteur;
+}
+export interface LecAss extends LecassRaw {
+    ass?: Ass;
+    auds?: Aud[];
+    audcles?: AudRaw["audcle"][];
+    datesSeances?: DateSeance[];
+    datesSeancesCodes?: DateSeanceRaw["code"][];
+    debatdatseas: Date[];
+    lecassraps?: LecAssRap[];
+    lecassrapids?: string[];
+    org?: Org;
+    texcods: TexteRaw["texcod"][];
+    textes?: Texte[];
+}
+export interface LecAssRap extends LecassrapRaw {
+    rap?: RapRaw;
+}
+export interface Lecture extends LectureRaw {
+    typlec?: Typlec;
+    lecassidts?: LecassRaw["lecassidt"][];
+    lecasss?: LecAss[];
+}
+export interface Loi extends LoiRaw {
+    deccoc?: Deccoc;
+    etaloi?: Etaloi;
+    lecidts?: LectureRaw["lecidt"][];
+    lectures?: Lecture[];
+    typloi?: Typloi;
+}
+export interface Rap extends RapRaw {
+    denrap?: Denrap;
+    docattcles?: DocattRaw["docattcle"][];
+    docatts?: DocAtt[];
+    ecrnums?: EcrRaw["ecrnum"][];
+    ecrs?: Ecr[];
+    orgcods?: Raporg["orgcod"][];
+    orgs?: Org[];
+}
+export interface Texte extends TexteRaw {
+    ecrs?: Ecr[];
+    ecrnums?: EcrRaw["ecrnum"][];
+    libtypurl?: Typurl["libtypurl"];
+    org?: Org;
+    oritxt: Oritxt;
+    typtxt?: Typtxt;
+    txtAmeli?: TxtAmeliCustom;
+    txtAmeliId: TxtAmeli["id"];
+}

package/lib/src/types/dosleg.js

@@ -0,0 +1 @@
+export {};

package/lib/src/types/questions.d.ts

@@ -0,0 +1,2 @@
+import { TamQuestions } from "../raw_types/questions.js";
+export type { TamQuestions as Question };

package/lib/src/types/questions.js

@@ -0,0 +1 @@
+export {};

package/lib/src/types/sens.d.ts

@@ -0,0 +1,8 @@
+export interface Photo {
+    chemin: string;
+    cheminMosaique: string;
+    hauteur: number;
+    largeur: number;
+    xMosaique: number;
+    yMosaique: number;
+}

package/lib/src/types/sens.js

@@ -0,0 +1 @@
+export {};

package/lib/src/types/sessions.d.ts

@@ -0,0 +1,6 @@
+export declare const UNDEFINED_SESSION = 0;
+export declare const sessionOptions: readonly [1958, 1959, 1960, 1961, 1962, 1963, 1964, 1965, 1966, 1967, 1968, 1969, 1970, 1971, 1972, 1973, 1974, 1975, 1976, 1977, 1978, 1979, 1980, 1981, 1982, 1983, 1984, 1985, 1986, 1987, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023, 2024, 2025, 2026];
+export declare const sessionOptionsOrAll: readonly [0, 1958, 1959, 1960, 1961, 1962, 1963, 1964, 1965, 1966, 1967, 1968, 1969, 1970, 1971, 1972, 1973, 1974, 1975, 1976, 1977, 1978, 1979, 1980, 1981, 1982, 1983, 1984, 1985, 1986, 1987, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023, 2024, 2025, 2026];
+export type Session = (typeof sessionOptions)[number];
+export type SessionOrAll = (typeof sessionOptionsOrAll)[number];
+export declare function getSessionsFromStart(startSession: SessionOrAll): (1958 | 1959 | 1960 | 1961 | 1962 | 1963 | 1964 | 1965 | 1966 | 1967 | 1968 | 1969 | 1970 | 1971 | 1972 | 1973 | 1974 | 1975 | 1976 | 1977 | 1978 | 1979 | 1980 | 1981 | 1982 | 1983 | 1984 | 1985 | 1986 | 1987 | 1988 | 1989 | 1990 | 1991 | 1992 | 1993 | 1994 | 1995 | 1996 | 1997 | 1998 | 1999 | 2000 | 2001 | 2002 | 2003 | 2004 | 2005 | 2006 | 2007 | 2008 | 2009 | 2010 | 2011 | 2012 | 2013 | 2014 | 2015 | 2016 | 2017 | 2018 | 2019 | 2020 | 2021 | 2022 | 2023 | 2024 | 2025 | 2026)[];

package/lib/src/types/sessions.js

@@ -0,0 +1,19 @@
+export const UNDEFINED_SESSION = 0;
+export const sessionOptions = [
+    1958, 1959, 1960, 1961, 1962, 1963, 1964, 1965, 1966, 1967, 1968, 1969, 1970, 1971, 1972, 1973, 1974, 1975, 1976,
+    1977, 1978, 1979, 1980, 1981, 1982, 1983, 1984, 1985, 1986, 1987, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995,
+    1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014,
+    2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023, 2024, 2025, 2026,
+    // TO COMPLETE EVERY YEAR :)
+];
+export const sessionOptionsOrAll = [UNDEFINED_SESSION, ...sessionOptions];
+export function getSessionsFromStart(startSession) {
+    if (startSession === UNDEFINED_SESSION) {
+        return Array.from(sessionOptions);
+    }
+    const sessionIndex = sessionOptions.findIndex((session) => startSession === session);
+    if (sessionIndex >= 0) {
+        return sessionOptions.slice(sessionIndex);
+    }
+    return [];
+}

package/lib/src/types/texte.d.ts

@@ -0,0 +1,72 @@
+import { DocumentResult } from "../loaders.js";
+export declare enum DivisionType {
+    tome = 1,
+    part = 2,
+    book = 3,
+    title = 4,
+    subtitle = 5,
+    chapter = 6,
+    section = 7,
+    subsection = 8,
+    paragraph = 9,
+    article = 10,
+    alinea = 11,
+    division = 12
+}
+export type DivisionTag = keyof typeof DivisionType;
+export interface DocumentMetadata {
+    name: string;
+    session: number | null | undefined;
+    date?: string | null;
+    url_expose_des_motifs?: URL;
+    url_xml?: URL;
+    url_html: URL;
+    url_pdf: URL;
+}
+export interface FlatTexte extends Partial<DocumentResult> {
+    titre: string | null;
+    titre_court: string | null;
+    url_dossier_senat: string | null;
+    url_dossier_assemblee: string | null;
+    date_presentation: Date | null;
+    date_depot: Date | null;
+    date_publication_xml: Date | null;
+    version: Version | null;
+    divisions: Division[];
+    expose_motifs?: ExposeDesMotifs | null;
+}
+export type Version = "RECT" | "RECT_BIS" | "RECT_TER" | "RECT_QUATER" | "RECT_QUINQUIES";
+export interface Step {
+    eId: string;
+    date: Date | null;
+    type: string | null;
+    session: string | null;
+    numero: string | null;
+    version: Version | null;
+    outcome: string | null;
+}
+export interface Division {
+    index: number;
+    eId: string;
+    tag: DivisionTag;
+    level: number;
+    headings: DivisionContent[];
+}
+export interface Article extends Division {
+    alineas: Alinea[];
+}
+export interface DivisionContent {
+    text: string | null;
+    html?: string | null;
+}
+export interface Alinea extends DivisionContent {
+    eId: string;
+    heading: DivisionContent;
+    pastille: string | null;
+    text_avec_liens?: string | null;
+    html_avec_liens?: string | null;
+}
+export interface ExposeDesMotifs {
+    text: string | null;
+    html: string | null;
+}

package/lib/src/types/texte.js

@@ -0,0 +1,15 @@
+export var DivisionType;
+(function (DivisionType) {
+    DivisionType[DivisionType["tome"] = 1] = "tome";
+    DivisionType[DivisionType["part"] = 2] = "part";
+    DivisionType[DivisionType["book"] = 3] = "book";
+    DivisionType[DivisionType["title"] = 4] = "title";
+    DivisionType[DivisionType["subtitle"] = 5] = "subtitle";
+    DivisionType[DivisionType["chapter"] = 6] = "chapter";
+    DivisionType[DivisionType["section"] = 7] = "section";
+    DivisionType[DivisionType["subsection"] = 8] = "subsection";
+    DivisionType[DivisionType["paragraph"] = 9] = "paragraph";
+    DivisionType[DivisionType["article"] = 10] = "article";
+    DivisionType[DivisionType["alinea"] = 11] = "alinea";
+    DivisionType[DivisionType["division"] = 12] = "division";
+})(DivisionType || (DivisionType = {}));

package/lib/src/validators/config.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+export declare const configSchema: z.ZodObject<{
+    db: z.ZodObject<{
+        host: z.ZodString;
+        password: z.ZodString;
+        user: z.ZodString;
+        port: z.ZodCoercedNumber<unknown>;
+    }, z.core.$strip>;
+}, z.core.$strip>;

package/lib/src/validators/config.js

@@ -0,0 +1,10 @@
+import { z } from "zod";
+const dbSchema = z.object({
+    host: z.string().trim().min(1, "Must not be empty"),
+    password: z.string().trim().min(1, "Must not be empty"),
+    user: z.string().trim().min(1, "Must not be empty"),
+    port: z.coerce.number().int().min(0).max(65535),
+});
+export const configSchema = z.object({
+    db: dbSchema,
+});

package/lib/src/videos/match.js

@@ -98,16 +98,16 @@ export async function matchOneReunion(args) {
     // Accept threshold (best must pass)
     if (best.score < minAccept) {
         if (!options["silent"])
-            console.log(`[threshold] ${agenda.uid} score=${best.score.toFixed(2)}
-          agenda title="${agenda.titre ?? ""}"
+            console.log(`[threshold] ${agenda.uid} score=${best.score.toFixed(2)}
+          agenda title="${agenda.titre ?? ""}"
           best title="${best.vtitle ?? ""}"`);
         return null;
     }
     // Margin (confidence) gate
     if (second && best.score - second.score < margin) {
         if (!options["silent"]) {
-            console.log(`[Margin] ${agenda.uid} score=${best.score.toFixed(2)}
-          agenda title="${agenda.titre ?? ""}" agenda date="${agenda.startTime ?? ""}"
+            console.log(`[Margin] ${agenda.uid} score=${best.score.toFixed(2)}
+          agenda title="${agenda.titre ?? ""}" agenda date="${agenda.startTime ?? ""}"
           best title="${best.vtitle ?? ""}" date="${best.epoch ? new Date(best.epoch * 1000).toISOString() : "null"}"`);
             console.log("second title=", second.vtitle ?? "", " score=", second.score.toFixed(2), "date=", second.epoch ? new Date(second.epoch * 1000).toISOString() : "null");
         }

package/lib/tests/parsers/plf/amendement.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/tests/parsers/plf/amendement.test.js

@@ -0,0 +1,153 @@
+import { describe, expect, it } from "vitest";
+import { normalizeMissionPlfLibelle, parseProgrammesPlf } from "../../../src/parsers/plf/amendement.js";
+const header = `
+  <tr><th>Programmes</th><th colspan="2">Autorisations d’engagement</th><th colspan="2">Crédits de paiement</th></tr>
+  <tr><th></th><th>+</th><th>−</th><th>+</th><th>−</th></tr>`;
+describe("parseProgrammesPlf", () => {
+    it("parses signed amounts and aggregates repeated programmes", () => {
+        const html = `<body><table>${header}
+      <tr><td>Programme A</td><td>1\u202f000</td><td></td><td></td><td>200</td></tr>
+      <tr><td>Programme A</td><td></td><td>250</td><td>50</td><td></td></tr>
+      <tr><td>Programme B</td><td></td><td>− 300</td><td>400</td><td></td></tr>
+      <tr><td>dont titre 2</td><td>999</td><td></td><td>999</td><td></td></tr>
+      <tr><td>TOTAL</td><td>1 000</td><td></td><td></td><td>200</td></tr>
+      <tr><td>SOLDE</td><td>1 000</td><td></td><td></td><td>−200</td></tr>
+    </table></body>`;
+        expect(parseProgrammesPlf(html)).toEqual([
+            { libelle: "Programme A", autorisation_engagement: "750", credit_paiement: "-150" },
+            {
+                libelle: "Programme B",
+                autorisation_engagement: "-300",
+                credit_paiement: "400",
+                lignes_credits: [{ libelle: "dont titre 2", autorisation_engagement: "999", credit_paiement: "999" }],
+            },
+        ]);
+    });
+    it("parses paragraph and concatenated credit lines and preserves decimals", () => {
+        const html = `<table>${header}
+      <tr><td><p><b>Programme décimal</b></p><p>dont titre 2</p></td><td>3 580 238 879,1</td><td></td><td></td><td>711 953,5</td></tr>
+      <tr><td>Programme concaténé dont titre 2</td><td>10.25</td><td></td><td></td><td>2.5</td></tr>
+    </table>`;
+        expect(parseProgrammesPlf(html)).toEqual([
+            {
+                libelle: "Programme décimal",
+                autorisation_engagement: "3580238879.1",
+                credit_paiement: "-711953.5",
+                lignes_credits: [
+                    { libelle: "dont titre 2", autorisation_engagement: "3580238879.1", credit_paiement: "-711953.5" },
+                ],
+            },
+            {
+                libelle: "Programme concaténé",
+                autorisation_engagement: "10.25",
+                credit_paiement: "-2.5",
+                lignes_credits: [{ libelle: "dont titre 2", autorisation_engagement: "10.25", credit_paiement: "-2.5" }],
+            },
+        ]);
+    });
+    it("parses distinct programme and credit-line amounts from separate paragraphs", () => {
+        const html = `<table>${header}
+      <tr>
+        <td><p><b>Programme multi-paragraphes</b></p><p>dont titre 2</p></td>
+        <td><p>120</p><p>&nbsp;</p><p>45</p></td>
+        <td><p>&nbsp;</p><p>&nbsp;</p><p>&nbsp;</p></td>
+        <td><p>100</p><p>&nbsp;</p><p>35</p></td>
+        <td><p>&nbsp;</p><p>&nbsp;</p><p>&nbsp;</p></td>
+      </tr>
+    </table>`;
+        expect(parseProgrammesPlf(html)).toEqual([
+            {
+                libelle: "Programme multi-paragraphes",
+                autorisation_engagement: "120",
+                credit_paiement: "100",
+                lignes_credits: [{ libelle: "dont titre 2", autorisation_engagement: "45", credit_paiement: "35" }],
+            },
+        ]);
+    });
+    it("does not concatenate the real multi-paragraph amounts from pjlf2026-II-455", () => {
+        const html = `<table>${header}
+      <tr>
+        <td><p><b>Enseignement scolaire public du premier degré</b></p><p>dont titre 2</p></td>
+        <td><p>93&nbsp;000&nbsp;000</p><p>&nbsp;</p><p>93&nbsp;000&nbsp;000</p></td>
+        <td><p>&nbsp;</p></td>
+        <td><p>93&nbsp;000&nbsp;000</p><p>&nbsp;</p><p>93&nbsp;000&nbsp;000</p></td>
+        <td><p>&nbsp;</p></td>
+      </tr>
+      <tr>
+        <td><p><b>Vie de l’élève</b></p><p>dont titre 2</p></td>
+        <td><p>&nbsp;</p></td><td><p>&nbsp;</p></td><td><p>&nbsp;</p></td><td><p>&nbsp;</p></td>
+      </tr>
+      <tr>
+        <td><p><b>Soutien de la politique de l’éducation nationale</b></p><p>dont titre 2</p></td>
+        <td><p>&nbsp;</p></td>
+        <td><p>190&nbsp;500 000</p><p>190&nbsp;500 000</p></td>
+        <td><p>&nbsp;</p></td>
+        <td><p>190&nbsp;500 000</p><p>190&nbsp;500 000</p></td>
+      </tr>
+    </table>`;
+        expect(parseProgrammesPlf(html)).toEqual([
+            {
+                libelle: "Enseignement scolaire public du premier degré",
+                autorisation_engagement: "93000000",
+                credit_paiement: "93000000",
+                lignes_credits: [{ libelle: "dont titre 2", autorisation_engagement: "93000000", credit_paiement: "93000000" }],
+            },
+            {
+                libelle: "Soutien de la politique de l’éducation nationale",
+                autorisation_engagement: "-190500000",
+                credit_paiement: "-190500000",
+                lignes_credits: [
+                    { libelle: "dont titre 2", autorisation_engagement: "-190500000", credit_paiement: "-190500000" },
+                ],
+            },
+        ]);
+    });
+    it("parses a credit line separated from its programme by a br", () => {
+        const html = `<table>${header}
+      <tr><td><p><b>Sport<br></b><i>dont titre 2</i></p></td><td>10 450 000</td><td></td><td>10 450 000</td><td></td></tr>
+    </table>`;
+        expect(parseProgrammesPlf(html)).toEqual([
+            {
+                libelle: "Sport",
+                autorisation_engagement: "10450000",
+                credit_paiement: "10450000",
+                lignes_credits: [{ libelle: "dont titre 2", autorisation_engagement: "10450000", credit_paiement: "10450000" }],
+            },
+        ]);
+    });
+    it("aggregates repeated programmes and credit lines independently", () => {
+        const html = `<table>${header}
+      <tr><td><p>Programme A</p><p>dont titre 2</p></td><td>11</td><td></td><td>20</td><td></td></tr>
+      <tr><td><p>Programme A</p><p>dont titre 2</p></td><td></td><td>2</td><td></td><td>5</td></tr>
+    </table>`;
+        expect(parseProgrammesPlf(html)).toEqual([
+            {
+                libelle: "Programme A",
+                autorisation_engagement: "9",
+                credit_paiement: "15",
+                lignes_credits: [{ libelle: "dont titre 2", autorisation_engagement: "9", credit_paiement: "15" }],
+            },
+        ]);
+    });
+    it("ignores non-budgetary, empty and incomplete tables", () => {
+        expect(parseProgrammesPlf(null)).toEqual([]);
+        expect(parseProgrammesPlf("<p>Modifier cet article.</p>")).toEqual([]);
+        expect(parseProgrammesPlf("<table><tr><td>Programmes</td><td>Crédits de paiement</td></tr></table>")).toEqual([]);
+    });
+    it("does not infer programmes for a sub-amendment without its own table", () => {
+        const html = "<p>Dans le programme mentionné par l’amendement II-42, remplacer 100 par 200.</p>";
+        expect(parseProgrammesPlf(html)).toEqual([]);
+    });
+});
+describe("normalizeMissionPlfLibelle", () => {
+    it.each([
+        ["Mission Solidarité, insertion et égalité des chances", "Solidarité, insertion et égalité des chances"],
+        ["Budget annexe - Contrôle et exploitation aériens", "Contrôle et exploitation aériens"],
+        ["Compte spécial - Pensions", "Pensions"],
+        ["Compte spécial — Avances aux collectivités territoriales", "Avances aux collectivités territoriales"],
+        ["Économie", "Économie"],
+        [null, null],
+    ])("normalizes %s", (source, expected) => {
+        expect(normalizeMissionPlfLibelle(source)).toBe(expected);
+    });
+});