@proconnect-gouv/proconnect.identite 1.1.0 → 1.2.0

package/dist/managers/certification/birthplace-conversion.js

@@ -0,0 +1,45 @@
+//
+import { COMMUNE_CODE_CONVERSION, COUNTRY_ISO_TO_COG, } from "#src/data/certification";
+/**
+ * Converts a commune code to a canonical representation,
+ * ensuring consistency across historical and current versions.
+ * If the code is not in the conversion table, returns the original code.
+ *
+ * @param communeCode - The commune code to convert (format: XXXXX or 2AXXX or 2BXXX)
+ * @returns The converted code, or the original if no conversion is needed
+ */
+export function convertCommuneCode(communeCode) {
+    if (!communeCode)
+        return null;
+    // Check if the code needs conversion
+    const converted = COMMUNE_CODE_CONVERSION[communeCode];
+    return converted || communeCode;
+}
+/**
+ * Converts an ISO 3166 country code (2 or 3-letter) to COG format (5-digit).
+ *
+ * @param iso3166Code - The ISO 3166 country code (e.g., "IRL", "FRA")
+ * @returns The COG code (e.g., "99136"), or null if not found
+ */
+export function convertCountryIsoToCog(iso3166Code) {
+    if (!iso3166Code)
+        return null;
+    const cogCode = COUNTRY_ISO_TO_COG[iso3166Code.toUpperCase()];
+    return cogCode || null;
+}
+/**
+ * Validates if a birthplace code has the correct COG format.
+ * Valid formats:
+ * - 5 digits (e.g., "75001")
+ * - 2A or 2B + 3 digits (e.g., "2A001", "2B042" for Corsica)
+ *
+ * @param birthplaceCode - The birthplace code to validate
+ * @returns true if the format is valid, false otherwise
+ */
+export function isValidBirthplaceFormat(birthplaceCode) {
+    if (!birthplaceCode)
+        return false;
+    // Match either 5 digits or 2A/2B + 3 digits
+    const validFormat = /^(\d{5}|2[AB]\d{3})$/;
+    return validFormat.test(birthplaceCode);
+}

package/dist/managers/certification/certification-score.d.ts

@@ -0,0 +1,22 @@
+import type { IdentityVector } from "#src/types";
+/**
+ * Calculates a certification score between identity from FranceConnect (IdentitePivot)
+ * and executive identity from business registries (SourceDirigeant).
+ *
+ * The scoring system awards 1 point for each matching criterion:
+ * - Family name (after normalization): 1 point
+ * - First name (first name only, after normalization): 1 point
+ * - Gender (match or absent in source): 1 point
+ * - Birth date (exact match): 1 point
+ * - Birth place:
+ *   - For French (birthcountry = 99100 or null): commune match or absent in source: 1 point
+ *   - For foreigners: country match: 1 point
+ *
+ * Maximum score: 5 points (required for certification)
+ *
+ * @param identitePivot - Identity from FranceConnect
+ * @param sourceDirigeant - Executive identity from business registry
+ * @returns Score from 0 to 5
+ */
+export declare function certificationScore(identitePivot: IdentityVector, sourceDirigeant: IdentityVector): number;
+//# sourceMappingURL=certification-score.d.ts.map

package/dist/managers/certification/certification-score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"certification-score.d.ts","sourceRoot":"","sources":["../../../src/managers/certification/certification-score.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,cAAc,EAC7B,eAAe,EAAE,cAAc,GAC9B,MAAM,CAkER"}

package/dist/managers/certification/certification-score.js

@@ -0,0 +1,72 @@
+//
+import { convertCommuneCode } from "./birthplace-conversion.js";
+import { extractFirstName, normalizeText } from "./normalize.js";
+//
+/**
+ * Calculates a certification score between identity from FranceConnect (IdentitePivot)
+ * and executive identity from business registries (SourceDirigeant).
+ *
+ * The scoring system awards 1 point for each matching criterion:
+ * - Family name (after normalization): 1 point
+ * - First name (first name only, after normalization): 1 point
+ * - Gender (match or absent in source): 1 point
+ * - Birth date (exact match): 1 point
+ * - Birth place:
+ *   - For French (birthcountry = 99100 or null): commune match or absent in source: 1 point
+ *   - For foreigners: country match: 1 point
+ *
+ * Maximum score: 5 points (required for certification)
+ *
+ * @param identitePivot - Identity from FranceConnect
+ * @param sourceDirigeant - Executive identity from business registry
+ * @returns Score from 0 to 5
+ */
+export function certificationScore(identitePivot, sourceDirigeant) {
+    let score = 0;
+    // 1. Family name match (after normalization)
+    const normalizedFamilyNamePivot = normalizeText(identitePivot.family_name);
+    const normalizedFamilyNameSource = normalizeText(sourceDirigeant.family_name);
+    if (normalizedFamilyNamePivot &&
+        normalizedFamilyNameSource &&
+        normalizedFamilyNamePivot === normalizedFamilyNameSource) {
+        score += 1;
+    }
+    // 2. First name match (first name only, after normalization)
+    const firstNamePivot = extractFirstName(identitePivot.given_name);
+    const firstNameSource = extractFirstName(sourceDirigeant.given_name);
+    if (firstNamePivot && firstNameSource && firstNamePivot === firstNameSource) {
+        score += 1;
+    }
+    // 3. Gender match (match or absent in source)
+    if (!sourceDirigeant.gender ||
+        identitePivot.gender === sourceDirigeant.gender) {
+        score += 1;
+    }
+    // 4. Birth date match (exact match)
+    if (identitePivot.birthdate &&
+        sourceDirigeant.birthdate &&
+        identitePivot.birthdate.getTime() === sourceDirigeant.birthdate.getTime()) {
+        score += 1;
+    }
+    // 5. Birth place match (different logic for French vs foreigners)
+    const isFrench = !identitePivot.birthcountry || identitePivot.birthcountry === "99100";
+    if (isFrench) {
+        // For French: check commune code (with conversion)
+        const communePivot = convertCommuneCode(identitePivot.birthplace);
+        const communeSource = convertCommuneCode(sourceDirigeant.birthplace);
+        // Match if equal or if source has no commune data
+        if (!communeSource || (communePivot && communePivot === communeSource)) {
+            score += 1;
+        }
+    }
+    else {
+        // For foreigners: check country code (with conversion if needed from RNE)
+        // Both should already be in COG format (99XXX)
+        if (identitePivot.birthcountry &&
+            sourceDirigeant.birthcountry &&
+            identitePivot.birthcountry === sourceDirigeant.birthcountry) {
+            score += 1;
+        }
+    }
+    return score;
+}

package/dist/managers/certification/index.d.ts

@@ -1,3 +1,3 @@
-export * from "./distance.js";
+export * from "./certification-score.js";
 export * from "./is-organization-dirigeant.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/managers/certification/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/managers/certification/index.ts"],"names":[],"mappings":"AAEA,cAAc,eAAe,CAAC;AAC9B,cAAc,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/managers/certification/index.ts"],"names":[],"mappings":"AAEA,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC"}

package/dist/managers/certification/index.js

@@ -1,3 +1,3 @@
 //
-export * from "./distance.js";
+export * from "./certification-score.js";
 export * from "./is-organization-dirigeant.js";

package/dist/managers/certification/is-organization-dirigeant.d.ts

@@ -1,15 +1,45 @@
 import type { GetFranceConnectUserInfoHandler } from "#src/repositories/user";
-import type { ApiEntrepriseInfogreffeRepository, ApiEntrepriseInseeRepository } from "@proconnect-gouv/proconnect.api_entreprise/api";
-import type { InseeApiRepository } from "@proconnect-gouv/proconnect.insee/api";
+import type { Organization } from "#src/types";
+import type { ApiEntrepriseInfogreffeRepository } from "@proconnect-gouv/proconnect.api_entreprise/api";
+import type { FindUniteLegaleBySirenHandler } from "@proconnect-gouv/proconnect.insee/api";
+import type { FindPouvoirsBySirenHandler } from "@proconnect-gouv/proconnect.registre_national_entreprises/api";
 type IsOrganizationExecutiveFactoryFactoryConfig = {
-    ApiEntrepriseInfogreffeRepository: ApiEntrepriseInfogreffeRepository;
-    ApiEntrepriseInseeRepository: Pick<ApiEntrepriseInseeRepository, "findBySiret">;
+    ApiEntrepriseInfogreffeRepository: Pick<ApiEntrepriseInfogreffeRepository, "findMandatairesSociauxBySiren">;
     EQUALITY_THRESHOLD?: number;
-    getFranceConnectUserInfo: GetFranceConnectUserInfoHandler;
-    InseeApiRepository: Pick<InseeApiRepository, "findBySiret">;
-    log?: typeof console.log;
+    FranceConnectApiRepository: {
+        getFranceConnectUserInfo: GetFranceConnectUserInfoHandler;
+    };
+    InseeApiRepository: {
+        findBySiren: FindUniteLegaleBySirenHandler;
+    };
+    RegistreNationalEntreprisesApiRepository: {
+        findPouvoirsBySiren: FindPouvoirsBySirenHandler;
+    };
 };
-export declare function isOrganizationDirigeantFactory(config: IsOrganizationExecutiveFactoryFactoryConfig): (siret: string, user_id: number) => Promise<boolean>;
+export declare function isOrganizationDirigeantFactory(config: IsOrganizationExecutiveFactoryFactoryConfig): (organization: Organization, user_id: number) => Promise<{
+    details: {
+        identity: {
+            birthcountry: string | null;
+            birthdate: Date | null;
+            birthplace: string | null;
+            family_name: string | null;
+            gender: "male" | "female" | null;
+            given_name: string | null;
+        };
+        source: "api.insee.fr/api-sirene/private" | "entreprise.api.gouv.fr/v3/infogreffe/rcs/unites_legales/{siren}/mandataires_sociaux" | "registre-national-entreprises.inpi.fr/api";
+        dirigeant: {
+            birthcountry: string | null;
+            birthdate: Date | null;
+            birthplace: string | null;
+            family_name: string | null;
+            gender: "male" | "female" | null;
+            given_name: string | null;
+        };
+        score: number;
+    };
+    cause: "exact_match" | "close_match" | "below_threshold";
+    ok: boolean;
+}>;
 export type IsOrganizationDirigeantHandler = ReturnType<typeof isOrganizationDirigeantFactory>;
 export {};
 //# sourceMappingURL=is-organization-dirigeant.d.ts.map

package/dist/managers/certification/is-organization-dirigeant.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"is-organization-dirigeant.d.ts","sourceRoot":"","sources":["../../../src/managers/certification/is-organization-dirigeant.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AAG9E,OAAO,KAAK,EACV,iCAAiC,EACjC,4BAA4B,EAC7B,MAAM,gDAAgD,CAAC;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAMhF,KAAK,2CAA2C,GAAG;IACjD,iCAAiC,EAAE,iCAAiC,CAAC;IACrE,4BAA4B,EAAE,IAAI,CAChC,4BAA4B,EAC5B,aAAa,CACd,CAAC;IACF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,wBAAwB,EAAE,+BAA+B,CAAC;IAC1D,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC;IAC5D,GAAG,CAAC,EAAE,OAAO,OAAO,CAAC,GAAG,CAAC;CAC1B,CAAC;AAIF,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,2CAA2C,IAYjD,OAAO,MAAM,EACb,SAAS,MAAM,sBAoFlB;AAED,MAAM,MAAM,8BAA8B,GAAG,UAAU,CACrD,OAAO,8BAA8B,CACtC,CAAC"}
+{"version":3,"file":"is-organization-dirigeant.d.ts","sourceRoot":"","sources":["../../../src/managers/certification/is-organization-dirigeant.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,gDAAgD,CAAC;AACxG,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC;AAC3F,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+DAA+D,CAAC;AAWhH,KAAK,2CAA2C,GAAG;IACjD,iCAAiC,EAAE,IAAI,CACrC,iCAAiC,EACjC,+BAA+B,CAChC,CAAC;IACF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,0BAA0B,EAAE;QAC1B,wBAAwB,EAAE,+BAA+B,CAAC;KAC3D,CAAC;IACF,kBAAkB,EAAE;QAAE,WAAW,EAAE,6BAA6B,CAAA;KAAE,CAAC;IACnE,wCAAwC,EAAE;QACxC,mBAAmB,EAAE,0BAA0B,CAAC;KACjD,CAAC;CACH,CAAC;AAqCF,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,2CAA2C,IAKjD,cAAc,YAAY,EAC1B,SAAS,MAAM;;;;;;;;;;;;;;;;;;;;;;;GA2ClB;AAED,MAAM,MAAM,8BAA8B,GAAG,UAAU,CACrD,OAAO,8BAA8B,CACtC,CAAC"}

package/dist/managers/certification/is-organization-dirigeant.js

@@ -1,60 +1,97 @@
 //
-import { NotFoundError } from "#src/errors";
-import { fromInfogreffe } from "#src/mappers/certification";
-import { fromSiret } from "#src/mappers/organization";
-import { isEntrepriseUnipersonnelle } from "#src/services/organization";
-import { formatBirthdate } from "@proconnect-gouv/proconnect.insee/formatters";
-import { distance } from "./distance.js";
+import { InvalidCertificationError, NotFoundError } from "#src/errors";
+import { match } from "ts-pattern";
+import z from "zod/v4";
+import * as ApiEntreprise from "./adapters/api_entreprise.js";
+import * as FranceConnect from "./adapters/franceconnect.js";
+import * as INSEE from "./adapters/insee.js";
+import * as RNE from "./adapters/rne.js";
+import { certificationScore } from "./certification-score.js";
 //
+async function getMandatairesSociaux({ RegistreNationalEntreprisesApiRepository, ApiEntrepriseInfogreffeRepository, }, siren) {
+    try {
+        const pouvoirs = await RegistreNationalEntreprisesApiRepository.findPouvoirsBySiren(siren);
+        const dirigeants = pouvoirs.map(RNE.toIdentityVector);
+        return {
+            dirigeants,
+            source: SourceDirigeant.enum["registre-national-entreprises.inpi.fr/api"],
+        };
+    }
+    catch {
+        const mandataires = await ApiEntrepriseInfogreffeRepository.findMandatairesSociauxBySiren(siren);
+        const dirigeants = mandataires.map(ApiEntreprise.toIdentityVector);
+        return {
+            dirigeants,
+            source: SourceDirigeant.enum["entreprise.api.gouv.fr/v3/infogreffe/rcs/unites_legales/{siren}/mandataires_sociaux"],
+        };
+    }
+}
 export function isOrganizationDirigeantFactory(config) {
-    const { EQUALITY_THRESHOLD = 0, ApiEntrepriseInseeRepository, ApiEntrepriseInfogreffeRepository, InseeApiRepository, getFranceConnectUserInfo, log = () => { }, } = config;
-    return async function isOrganizationDirigeant(siret, user_id) {
-        const establishment = await ApiEntrepriseInseeRepository.findBySiret(siret);
-        const franceconnectUserInfo = await getFranceConnectUserInfo(user_id);
+    const { InseeApiRepository, FranceConnectApiRepository } = config;
+    return async function isOrganizationDirigeant(organization, user_id) {
+        const siren = organization.siret.substring(0, 9);
+        const franceconnectUserInfo = await FranceConnectApiRepository.getFranceConnectUserInfo(user_id);
         if (!franceconnectUserInfo) {
             throw new NotFoundError("FranceConnect UserInfo not found");
         }
-        const sourceDirigeants = await getSourceDirigeantsFromEstablishment(establishment);
-        if (sourceDirigeants.length === 0) {
-            throw new NotFoundError("No mandataires found");
-        }
-        const distances = sourceDirigeants.map((sourceDirigeant) => Math.abs(distance(franceconnectUserInfo, sourceDirigeant)));
-        const closestSourceDirigeantDistance = Math.min(...distances);
-        const closestSourceDirigeant = sourceDirigeants[distances.indexOf(closestSourceDirigeantDistance)];
-        log(closestSourceDirigeant, " is the closest source dirigeant to ", franceconnectUserInfo, " with a distance of ", closestSourceDirigeantDistance);
-        return closestSourceDirigeantDistance === EQUALITY_THRESHOLD;
-    };
-    async function getSourceDirigeantsFromEstablishment(establishment) {
-        const organization = fromSiret(establishment);
-        if (isEntrepriseUnipersonnelle({
-            cached_libelle_categorie_juridique: organization.libelleCategorieJuridique,
-            cached_tranche_effectifs: organization.trancheEffectifs,
-        })) {
-            return getSourceDirigeantsFromInsseApi(establishment.siret);
-        }
-        return getSourceDirigeantsFromApiEntreprise(establishment.unite_legale.siren);
-    }
-    async function getSourceDirigeantsFromInsseApi(siret) {
-        const { uniteLegale } = await InseeApiRepository.findBySiret(siret);
-        const birthdate = formatBirthdate(String(uniteLegale?.dateNaissanceUniteLegale));
-        return [
-            {
-                birthplace: uniteLegale?.codeCommuneNaissanceUniteLegale ?? null,
-                birthdate: isNaN(birthdate.getTime()) ? null : birthdate,
-                family_name: uniteLegale?.nomUniteLegale ?? null,
-                given_name: [
-                    uniteLegale?.prenom1UniteLegale,
-                    uniteLegale?.prenom2UniteLegale,
-                    uniteLegale?.prenom3UniteLegale,
-                    uniteLegale?.prenom4UniteLegale,
-                ]
-                    .filter(Boolean)
-                    .join(" "),
+        const identity = FranceConnect.toIdentityVector(franceconnectUserInfo);
+        const prefered_source = organization.cached_libelle_categorie_juridique ===
+            "Entrepreneur individuel"
+            ? SourceDirigeant.enum["api.insee.fr/api-sirene/private"]
+            : SourceDirigeant.enum["registre-national-entreprises.inpi.fr/api"];
+        const { dirigeants, source } = await match(prefered_source)
+            .with("api.insee.fr/api-sirene/private", async () => ({
+            dirigeants: await InseeApiRepository.findBySiren(siren)
+                .then(INSEE.toIdentityVector)
+                .then((vector) => [vector]),
+            source: SourceDirigeant.enum["api.insee.fr/api-sirene/private"],
+        }))
+            .with("registre-national-entreprises.inpi.fr/api", () => getMandatairesSociaux(config, siren))
+            .exhaustive();
+        const result = match_identity_to_dirigeant(identity, dirigeants);
+        if (result.kind === "no_candidates")
+            throw new InvalidCertificationError("No candidates found");
+        return {
+            details: {
+                ...result.closest,
+                identity,
+                source,
             },
-        ];
-    }
-    async function getSourceDirigeantsFromApiEntreprise(siren) {
-        const mandataires = await ApiEntrepriseInfogreffeRepository.findMandatairesSociauxBySiren(siren);
-        return mandataires.map((mandataire) => fromInfogreffe(mandataire));
-    }
+            cause: result.kind,
+            ok: result.kind === "exact_match",
+        };
+    };
+}
+const SourceDirigeant = z.enum([
+    "api.insee.fr/api-sirene/private",
+    "entreprise.api.gouv.fr/v3/infogreffe/rcs/unites_legales/{siren}/mandataires_sociaux",
+    "registre-national-entreprises.inpi.fr/api",
+]);
+function match_identity_to_dirigeant(identity, dirigeants) {
+    if (dirigeants.length === 0)
+        return { kind: "no_candidates" };
+    const [closest] = dirigeants
+        .map((dirigeant) => ({
+        dirigeant,
+        score: certificationScore(identity, dirigeant),
+    }))
+        .toSorted((a, b) => b.score - a.score); // Sort by score descending (higher is better)
+    // According to the specification, only score of 5 (perfect match) is certified
+    return match(closest.score)
+        .with(5, () => ({
+        kind: "exact_match",
+        closest,
+    }))
+        .with(4, () => ({
+        kind: "close_match",
+        closest,
+    }))
+        .with(3, () => ({
+        kind: "close_match",
+        closest,
+    }))
+        .otherwise(() => ({
+        kind: "below_threshold",
+        closest,
+    }));
 }

package/dist/managers/certification/normalize.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Normalizes text for identity matching:
+ * - Convert to uppercase
+ * - Replace accented characters with their simple versions
+ * - Replace special characters (including ' and -) with spaces
+ * - Remove multiple consecutive spaces
+ * - Trim leading and trailing spaces
+ *
+ * @param text - The text to normalize
+ * @returns The normalized text
+ */
+export declare function normalizeText(text: string | null | undefined): string;
+/**
+ * Extracts the first name from a normalized full name string.
+ * The first name is the part before the first space.
+ *
+ * @param givenName - The full given name (may contain multiple names)
+ * @returns The first name only
+ */
+export declare function extractFirstName(givenName: string | null | undefined): string;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/managers/certification/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/managers/certification/normalize.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CA2CrE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAM7E"}

package/dist/managers/certification/normalize.js

@@ -0,0 +1,64 @@
+//
+/**
+ * Normalizes text for identity matching:
+ * - Convert to uppercase
+ * - Replace accented characters with their simple versions
+ * - Replace special characters (including ' and -) with spaces
+ * - Remove multiple consecutive spaces
+ * - Trim leading and trailing spaces
+ *
+ * @param text - The text to normalize
+ * @returns The normalized text
+ */
+export function normalizeText(text) {
+    if (!text)
+        return "";
+    // Convert to uppercase
+    let normalized = text.toUpperCase();
+    // Replace accented characters with their simple versions
+    const accentMap = {
+        À: "A",
+        Â: "A",
+        Ä: "A",
+        Ç: "C",
+        É: "E",
+        È: "E",
+        Ê: "E",
+        Ë: "E",
+        Î: "I",
+        Ï: "I",
+        Ô: "O",
+        Ö: "O",
+        Ù: "U",
+        Û: "U",
+        Ü: "U",
+        Ÿ: "Y",
+        Æ: "AE",
+        Œ: "OE",
+    };
+    for (const [accented, simple] of Object.entries(accentMap)) {
+        normalized = normalized.replaceAll(accented, simple);
+    }
+    // Replace special characters (including ' and -) with spaces
+    // Keep only letters, digits, and spaces
+    normalized = normalized.replace(/[^A-Z0-9 ]/g, " ");
+    // Remove multiple consecutive spaces
+    normalized = normalized.replace(/\s+/g, " ");
+    // Trim leading and trailing spaces
+    normalized = normalized.trim();
+    return normalized;
+}
+/**
+ * Extracts the first name from a normalized full name string.
+ * The first name is the part before the first space.
+ *
+ * @param givenName - The full given name (may contain multiple names)
+ * @returns The first name only
+ */
+export function extractFirstName(givenName) {
+    if (!givenName)
+        return "";
+    const normalized = normalizeText(givenName);
+    const parts = normalized.split(" ");
+    return parts[0] || "";
+}

package/dist/managers/franceconnect/openid-client.d.ts

@@ -23,6 +23,7 @@ export declare function getFranceConnectUserFactory(getConfiguration: GetFranceC
     expectedState: string;
 }) => Promise<{
     user_info: {
+        birthcountry: string;
         birthdate: Date;
         birthplace: string;
         family_name: string;

package/dist/managers/franceconnect/openid-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openid-client.d.ts","sourceRoot":"","sources":["../../../src/managers/franceconnect/openid-client.ts"],"names":[],"mappings":"AAMA,OAAO,EAUL,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AAKvB,MAAM,MAAM,gCAAgC,GAAG;IAC7C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAClC,MAAM,EAAE,GAAG,CAAC;CACb,CAAC;AAEF,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,gCAAgC,wDAYzC;AAED,MAAM,MAAM,oCAAoC,GAAG,UAAU,CAC3D,OAAO,oCAAoC,CAC5C,CAAC;AAEF,wBAAgB,gBAAgB;;;EAK/B;AAED,wBAAgB,kCAAkC,CAChD,gBAAgB,EAAE,oCAAoC,EACtD,UAAU,EAAE;IACV,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf,IAG0C,OAAO,MAAM,EAAE,OAAO,MAAM,kBAaxE;AAED,wBAAgB,2BAA2B,CACzC,gBAAgB,EAAE,oCAAoC,IAEX,YAAY;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,GAAG,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;;;;;;;;;;;GA0BF;AAED,wBAAgB,wCAAwC,CACtD,gBAAgB,EAAE,oCAAoC,IAGpD,eAAe,MAAM,EACrB,0BAA0B,MAAM,EAChC,OAAO,MAAM,kBAShB"}
+{"version":3,"file":"openid-client.d.ts","sourceRoot":"","sources":["../../../src/managers/franceconnect/openid-client.ts"],"names":[],"mappings":"AAMA,OAAO,EAUL,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AAKvB,MAAM,MAAM,gCAAgC,GAAG;IAC7C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAClC,MAAM,EAAE,GAAG,CAAC;CACb,CAAC;AAEF,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,gCAAgC,wDAYzC;AAED,MAAM,MAAM,oCAAoC,GAAG,UAAU,CAC3D,OAAO,oCAAoC,CAC5C,CAAC;AAEF,wBAAgB,gBAAgB;;;EAK/B;AAED,wBAAgB,kCAAkC,CAChD,gBAAgB,EAAE,oCAAoC,EACtD,UAAU,EAAE;IACV,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf,IAG0C,OAAO,MAAM,EAAE,OAAO,MAAM,kBAaxE;AAED,wBAAgB,2BAA2B,CACzC,gBAAgB,EAAE,oCAAoC,IAEX,YAAY;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,GAAG,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;;;;;;;;;;;;GA0BF;AAED,wBAAgB,wCAAwC,CACtD,gBAAgB,EAAE,oCAAoC,IAGpD,eAAe,MAAM,EACrB,0BAA0B,MAAM,EAChC,OAAO,MAAM,kBAShB"}

package/dist/managers/organization/adapters/api_entreprise.d.ts

@@ -0,0 +1,25 @@
+import "#src/types";
+import { type OrganizationInfo } from "#src/types";
+import type { InseeSireneEstablishmentSiretResponseData } from "@proconnect-gouv/proconnect.api_entreprise/types";
+export declare function toOrganizationInfo(siretData: InseeSireneEstablishmentSiretResponseData): OrganizationInfo;
+export declare function toPartialOrganization(organization_info: OrganizationInfo): {
+    cached_activite_principale: string;
+    cached_adresse: string;
+    cached_categorie_juridique: string;
+    cached_code_officiel_geographique: string;
+    cached_code_postal: string | null;
+    cached_enseigne: string;
+    cached_est_active: boolean;
+    cached_est_diffusible: boolean;
+    cached_etat_administratif: string;
+    cached_libelle_activite_principale: string;
+    cached_libelle_categorie_juridique: string;
+    cached_libelle_tranche_effectif: string;
+    cached_libelle: string;
+    cached_nom_complet: string;
+    cached_statut_diffusion: "diffusible" | "partiellement_diffusible" | "non_diffusible";
+    cached_tranche_effectifs_unite_legale: string | null;
+    cached_tranche_effectifs: "NN" | "00" | "01" | "02" | "03" | "11" | "12" | "21" | "22" | "31" | "32" | "41" | "42" | "51" | "52" | "53" | null;
+    siret: string;
+};
+//# sourceMappingURL=api_entreprise.d.ts.map

package/dist/managers/organization/adapters/api_entreprise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api_entreprise.d.ts","sourceRoot":"","sources":["../../../../src/managers/organization/adapters/api_entreprise.ts"],"names":[],"mappings":"AAEA,OAAO,YAAY,CAAC;AACpB,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AAOpB,OAAO,KAAK,EAAE,yCAAyC,EAAE,MAAM,kDAAkD,CAAC;AAKlH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,yCAAyC,GACnD,gBAAgB,CAyDlB;AAED,wBAAgB,qBAAqB,CAAC,iBAAiB,EAAE,gBAAgB;;;;;;;;;;;;;;;;;;;EA4CxE"}

package/dist/{mappers/organization/from-siret.js → managers/organization/adapters/api_entreprise.js}

@@ -1,10 +1,10 @@
 //
 import "#src/types";
-import { OrganizationInfoSchema } from "#src/types";
+import { OrganizationInfoSchema, } from "#src/types";
 import { formatAddress, formatMainActivity, formatNomComplet, libelleFromCodeEffectif, } from "@proconnect-gouv/proconnect.api_entreprise/formatters";
 import { capitalize } from "lodash-es";
 //
-export function fromSiret(siretData) {
+export function toOrganizationInfo(siretData) {
     const isPartiallyNonDiffusible = siretData.status_diffusion === "partiellement_diffusible";
     const enseigne = siretData.enseigne ?? "";
     const nomComplet = isPartiallyNonDiffusible
@@ -49,3 +49,26 @@ export function fromSiret(siretData) {
         trancheEffectifsUniteLegale,
     });
 }
+export function toPartialOrganization(organization_info) {
+    const { activitePrincipale: cached_activite_principale, adresse: cached_adresse, categorieJuridique: cached_categorie_juridique, codeOfficielGeographique: cached_code_officiel_geographique, codePostal: cached_code_postal, enseigne: cached_enseigne, estActive: cached_est_active, estDiffusible: cached_est_diffusible, etatAdministratif: cached_etat_administratif, libelle: cached_libelle, libelleActivitePrincipale: cached_libelle_activite_principale, libelleCategorieJuridique: cached_libelle_categorie_juridique, libelleTrancheEffectif: cached_libelle_tranche_effectif, nomComplet: cached_nom_complet, siret, statutDiffusion: cached_statut_diffusion, trancheEffectifs: cached_tranche_effectifs, trancheEffectifsUniteLegale: cached_tranche_effectifs_unite_legale, } = organization_info;
+    return {
+        cached_activite_principale,
+        cached_adresse,
+        cached_categorie_juridique,
+        cached_code_officiel_geographique,
+        cached_code_postal,
+        cached_enseigne,
+        cached_est_active,
+        cached_est_diffusible,
+        cached_etat_administratif,
+        cached_libelle_activite_principale,
+        cached_libelle_categorie_juridique,
+        cached_libelle_tranche_effectif,
+        cached_libelle,
+        cached_nom_complet,
+        cached_statut_diffusion,
+        cached_tranche_effectifs_unite_legale,
+        cached_tranche_effectifs,
+        siret,
+    };
+}

package/dist/managers/organization/get-organization-info.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-organization-info.d.ts","sourceRoot":"","sources":["../../../src/managers/organization/get-organization-info.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,gDAAgD,CAAC;AAQnG,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,4BAA4B,IAKlC,cAAc,MAAM,KACnB,OAAO,CAAC,gBAAgB,CAAC,CAiC7B;AAED,MAAM,MAAM,0BAA0B,GAAG,UAAU,CACjD,OAAO,0BAA0B,CAClC,CAAC"}
+{"version":3,"file":"get-organization-info.d.ts","sourceRoot":"","sources":["../../../src/managers/organization/get-organization-info.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,gDAAgD,CAAC;AASnG,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,4BAA4B,IAKlC,cAAc,MAAM,KACnB,OAAO,CAAC,gBAAgB,CAAC,CAiC7B;AAED,MAAM,MAAM,0BAA0B,GAAG,UAAU,CACjD,OAAO,0BAA0B,CAClC,CAAC"}

package/dist/managers/organization/get-organization-info.js

@@ -1,8 +1,8 @@
 //
 import { InvalidSiretError, NotFoundError } from "#src/errors";
-import { OrganizationInfoMapper } from "#src/mappers";
 import {} from "#src/types";
 import { ApiEntrepriseConnectionError, ApiEntrepriseInvalidSiret, } from "@proconnect-gouv/proconnect.api_entreprise/types";
+import * as ApiEntreprise from "./adapters/api_entreprise.js";
 //
 export function getOrganizationInfoFactory(config) {
     const { findBySiren, findBySiret } = config;
@@ -10,10 +10,10 @@ export function getOrganizationInfoFactory(config) {
         try {
             let establishment;
             if (siretOrSiren.match(/^\d{14}$/)) {
-                establishment = OrganizationInfoMapper.fromSiret(await findBySiret(siretOrSiren));
+                establishment = ApiEntreprise.toOrganizationInfo(await findBySiret(siretOrSiren));
             }
             else if (siretOrSiren.match(/^\d{9}$/)) {
-                establishment = OrganizationInfoMapper.fromSiret(await findBySiren(siretOrSiren));
+                establishment = ApiEntreprise.toOrganizationInfo(await findBySiren(siretOrSiren));
             }
             else {
                 throw new InvalidSiretError();

package/dist/repositories/organization/upsert.d.ts

@@ -1,5 +1,5 @@
 import type { DatabaseContext, Organization, OrganizationInfo } from "#src/types";
-export declare function upsertFactory({ pg }: DatabaseContext): ({ siret, organizationInfo: { libelle: cached_libelle, nomComplet: cached_nom_complet, enseigne: cached_enseigne, trancheEffectifs: cached_tranche_effectifs, trancheEffectifsUniteLegale: cached_tranche_effectifs_unite_legale, libelleTrancheEffectif: cached_libelle_tranche_effectif, etatAdministratif: cached_etat_administratif, estActive: cached_est_active, statutDiffusion: cached_statut_diffusion, estDiffusible: cached_est_diffusible, adresse: cached_adresse, codePostal: cached_code_postal, codeOfficielGeographique: cached_code_officiel_geographique, activitePrincipale: cached_activite_principale, libelleActivitePrincipale: cached_libelle_activite_principale, categorieJuridique: cached_categorie_juridique, libelleCategorieJuridique: cached_libelle_categorie_juridique, }, }: {
+export declare function upsertFactory({ pg }: DatabaseContext): ({ siret, organizationInfo, }: {
     siret: string;
     organizationInfo: OrganizationInfo;
 }) => Promise<Organization>;

package/dist/repositories/organization/upsert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upsert.d.ts","sourceRoot":"","sources":["../../../src/repositories/organization/upsert.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAKpB,wBAAgB,aAAa,CAAC,EAAE,EAAE,EAAE,EAAE,eAAe,IACtB,gxBAqB1B;IACD,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,gBAAgB,CAAC;CACpC,2BAuGF;AAED,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC"}
+{"version":3,"file":"upsert.d.ts","sourceRoot":"","sources":["../../../src/repositories/organization/upsert.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAKpB,wBAAgB,aAAa,CAAC,EAAE,EAAE,EAAE,EAAE,eAAe,IACtB,8BAG1B;IACD,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,gBAAgB,CAAC;CACpC,2BA2HF;AAED,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/repositories/organization/upsert.js

@@ -1,7 +1,8 @@
 //
 //
 export function upsertFactory({ pg }) {
-    return async function upsert({ siret, organizationInfo: { libelle: cached_libelle, nomComplet: cached_nom_complet, enseigne: cached_enseigne, trancheEffectifs: cached_tranche_effectifs, trancheEffectifsUniteLegale: cached_tranche_effectifs_unite_legale, libelleTrancheEffectif: cached_libelle_tranche_effectif, etatAdministratif: cached_etat_administratif, estActive: cached_est_active, statutDiffusion: cached_statut_diffusion, estDiffusible: cached_est_diffusible, adresse: cached_adresse, codePostal: cached_code_postal, codeOfficielGeographique: cached_code_officiel_geographique, activitePrincipale: cached_activite_principale, libelleActivitePrincipale: cached_libelle_activite_principale, categorieJuridique: cached_categorie_juridique, libelleCategorieJuridique: cached_libelle_categorie_juridique, }, }) {
+    return async function upsert({ siret, organizationInfo, }) {
+        const { cached_libelle, cached_nom_complet, cached_enseigne, cached_tranche_effectifs, cached_tranche_effectifs_unite_legale, cached_libelle_tranche_effectif, cached_etat_administratif, cached_est_active, cached_statut_diffusion, cached_est_diffusible, cached_adresse, cached_code_postal, cached_code_officiel_geographique, cached_activite_principale, cached_libelle_activite_principale, cached_categorie_juridique, cached_libelle_categorie_juridique, } = toPartialOrganization(organizationInfo);
         const { rows } = await pg.query(`
     INSERT INTO organizations
       (
@@ -101,3 +102,27 @@ export function upsertFactory({ pg }) {
         return rows.shift();
     };
 }
+//
+function toPartialOrganization(organization_info) {
+    const { activitePrincipale: cached_activite_principale, adresse: cached_adresse, categorieJuridique: cached_categorie_juridique, codeOfficielGeographique: cached_code_officiel_geographique, codePostal: cached_code_postal, enseigne: cached_enseigne, estActive: cached_est_active, estDiffusible: cached_est_diffusible, etatAdministratif: cached_etat_administratif, libelle: cached_libelle, libelleActivitePrincipale: cached_libelle_activite_principale, libelleCategorieJuridique: cached_libelle_categorie_juridique, libelleTrancheEffectif: cached_libelle_tranche_effectif, nomComplet: cached_nom_complet, siret, statutDiffusion: cached_statut_diffusion, trancheEffectifs: cached_tranche_effectifs, trancheEffectifsUniteLegale: cached_tranche_effectifs_unite_legale, } = organization_info;
+    return {
+        cached_activite_principale,
+        cached_adresse,
+        cached_categorie_juridique,
+        cached_code_officiel_geographique,
+        cached_code_postal,
+        cached_enseigne,
+        cached_est_active,
+        cached_est_diffusible,
+        cached_etat_administratif,
+        cached_libelle_activite_principale,
+        cached_libelle_categorie_juridique,
+        cached_libelle_tranche_effectif,
+        cached_libelle,
+        cached_nom_complet,
+        cached_statut_diffusion,
+        cached_tranche_effectifs_unite_legale,
+        cached_tranche_effectifs,
+        siret,
+    };
+}