@communecter/cocolight-api-client 1.0.150 → 1.0.152

package/types/api/BaseEntity.d.ts

@@ -1,4 +1,4 @@
-import type { UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, GetNewsData, GetGalleryData, GlobalAutocompleteCostumData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestDatesData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetOrganizationsAdminData, GetOrganizationsNoAdminData, GetProjectsAdminData, GetProjectsNoAdminData, GetPoisAdminData, GetPoisNoAdminData, GetSubscribersData, GetBadgesData, CoformAnswersSearchData, SearchMemberAutocompleteData, GetEventsData, CostumFilterCoformData, CostumFilterCoformByPathData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, FundingEnvelopeData, CoremuOperationData, UpdatePathValueData } from "./EndpointApi.types.js";
+import type { UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, GetNewsData, GetGalleryData, GlobalAutocompleteCostumData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestDatesData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetOrganizationsAdminData, GetOrganizationsNoAdminData, GetProjectsAdminData, GetProjectsNoAdminData, GetPoisAdminData, GetPoisNoAdminData, GetSubscribersData, GetBadgesData, CoformAnswersSearchData, SearchMemberAutocompleteData, GetEventsData, SearchEventsCostumData, CostumFilterCoformData, CostumFilterCoformByPathData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, FundingEnvelopeData, CoremuOperationData, UpdatePathValueData } from "./EndpointApi.types.js";
 import type { CostumRuntimeContext } from "../costum/runtime.js";
 import type { TransformsMap } from "../types/entities.js";
 import type { CountryItem } from "./serverDataType/Country.js";
@@ -179,6 +179,18 @@ export type CostumContextFields = {
     sourceKey: string[];
 };
 export type WithCostumContext<T> = T & CostumContextFields;
+/**
+ * Bornes d'agenda acceptant un `Date` (coercé en ISO par la méthode avant l'envoi — le fil reste
+ * `type:string`). Partagé par `searchEventsCostum` et `getEvents`.
+ */
+type AgendaDateInputs = {
+    startDateUTC?: Date | string;
+    endDateUTC?: Date | string;
+};
+/** Entrée de `searchEventsCostum` : la request, mais les bornes acceptent un `Date`. */
+export type SearchEventsCostumInput = Omit<Partial<SearchEventsCostumData>, keyof AgendaDateInputs> & AgendaDateInputs;
+/** Entrée de `getEvents` : la request, mais les bornes acceptent un `Date`. */
+export type GetEventsInput = Omit<Partial<GetEventsData>, keyof AgendaDateInputs> & AgendaDateInputs;
 /**
  * Une valeur distincte d'une thématique CoForm (retournée par `coformFilterByPath`).
  */
@@ -1546,10 +1558,13 @@ export declare class BaseEntity<TServerData = any> {
     /**
      * Récupérer les événements d'une entitée : liste des événements de l'entité ou elle est "organizer" ou "attendee".
      * Constant : GET_EVENTS
+     * `startDateUTC`/`endDateUTC` acceptent un `Date` ou une string ISO (un `Date` est coercé en ISO).
+     * `recurrency` est typé `false` (garde parité, comme `searchEventsCostum`) : omettre (récurrents inclus
+     * en mode calendrier) ou passer `false` (exclure) ; jamais `true` (le legacy `=== true` l'exclurait → divergence).
      * @param data - Paramètres (partiels) de recherche/pagination.
      * @returns - Les données de réponse.
      */
-    getEvents(data?: Partial<GetEventsData>, options?: {
+    getEvents(data?: GetEventsInput, options?: {
         restoredState?: PaginatorState;
     }): Promise<PaginatorPage<EventEntity>>;
     /**
@@ -1983,6 +1998,45 @@ export declare class BaseEntity<TServerData = any> {
         restoredState?: PaginatorState;
         variant?: SearchCostumVariant;
     }): Promise<PaginatorPage<any>>;
+    /**
+     * Agenda costum-aware : events scopés au costum (`source.key`) — pendant de `searchCostum` pour les events.
+     * `_withCostumContext` injecte `costumSlug`/`contextId`/`contextType` + `sourceKey=[serverData.slug]` → les
+     * events DU site/hôte costum (au lieu du filtre attendees/organizer FORCÉ de `getEvents`). À appeler sur
+     * l'entité HÔTE du costum (ex. l'entité du déploiement). `sourceKey` surchargeable (agenda multi-sites / réseau).
+     *
+     * **Deux modes** (endpoint `/co2/search/agenda`), selon que tu passes une date ou non :
+     *
+     * 1. **CALENDRIER** — déclenché par `startDateUTC` et/ou `endDateUTC` (l'agenda d'une période) :
+     *    ramène **TOUT** ce qui matche la plage — ponctuels **+ récurrents** (`openingHours`, sauf `recurrency:false`) —
+     *    trié par **occurrence** (`startDateSort`/`startDateSortFormat` calculés côté serveur), résultat = **tableau**.
+     *    **Pas de pagination** serveur : une seule page (`next()`/`prev()` sans effet).
+     * 2. **LISTE** — déclenché par l'**absence** de date (flux paginé) :
+     *    **ponctuels uniquement** (récurrents exclus), triés par `startDate` **décroissant** (plus récents d'abord),
+     *    paginés via `indexMin`/`indexStep` (défaut 30) — `next()`/`prev()` fonctionnent. (Backend : objet keyé `_id`,
+     *    hydraté en tableau d'`Event` côté lib.)
+     *
+     * Le scope costum (`sourceKey`) s'applique dans les **deux** modes.
+     *
+     * `recurrency` est typé `false` (garde parité) : **omettre** (mode calendrier → récurrents inclus) ou passer
+     * `false` (exclure) ; **jamais `true`** — le legacy fait un test strict `=== true` qui exclurait les récurrents
+     * (divergence), valeur donc interdite au type **et** à l'AJV.
+     *
+     * `startDateUTC`/`endDateUTC` acceptent un **`Date` ou une string ISO** : un `Date` est coercé en ISO
+     * (`toISOString()`) avant l'envoi (le fil reste `type:string`). Évite le piège de l'ISO partielle
+     * (`"2026-06-01"` n'est pas un `date-time` AJV valide).
+     *
+    // Mode CALENDRIER — agenda du mois, avec de vrais Date
+     * const debut = new Date("2026-06-01T00:00:00Z");
+     * const page = await org.searchEventsCostum({ startDateUTC: debut, endDateUTC: new Date("2026-06-30T23:59:59Z") });
+     * page.results.forEach((e) => console.log(e.serverData.name, e.serverData.startDateSort));
+     *
+    // Mode LISTE — flux paginé (ponctuels, du plus récent)
+     * let p = await org.searchEventsCostum({ indexStep: 20 });
+     * if (p.hasNext) p = await p.next();
+     */
+    searchEventsCostum(data?: SearchEventsCostumInput, options?: {
+        restoredState?: PaginatorState;
+    }): Promise<PaginatorPage<EventEntity>>;
     /**
      * @param data
      *        Paramètres de recherche (partiels — les valeurs manquantes sont complétées

package/types/api/EndpointApi.d.ts

@@ -1,5 +1,5 @@
 import type ApiClient from "../ApiClient.js";
-import type { DocumentListData, PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, ProfilBannerData, GetElementsAboutData, MulticonnectData, GetNewsData, GetNewsByIdData, AddNewsData, AddImageNewsData, AddFileNewsData, DeleteNewsData, UpdateNewsData, ShareNewsData, GetCommentsData, AddCommentsData, DeleteCommentsData, UpdateCommentsData, SearchTagsData, ShowVoteData, GlobalAutocompleteData, CityAutocompleteData, CityAutocompleteByCountryData, SuggestionInputData, GetProjectsNoAdminData, GetProjectsAdminData, GetPoisNoAdminData, GetPoisAdminData, GetOrganizationsNoAdminData, GetOrganizationsAdminData, GetUserEligiblePlacesData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, ShareEventsData, InviteEventData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, NavigatorGettlData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, GetCoformByIdData, CoformUploadAnswerFileData, CoformGetAnswerFilesData, GetCoformCatalogsData, SaveCoformAnswerData, GetCoformAnswerHistoryData, GetCoformMultievalDataData, GetCoformCommontableContributorsData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData, DeleteDocumentByIdData, DemoteAdminData, CostumFilterCoformData, CostumFilterCoformByPathData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, GenerateAnswerFromFormData, FundingEnvelopeData, CoremuOperationData, CostumProjectActionRequestNewData, CostumProjectActionRequestSetStatusData, CostumProjectActionRequestSetDateData, CostumProjectActionRequestSetContributorsData, CostumProjectActionRequestCancelData, CostumProjectActionRequestArchiveData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData, PersonActivateData } from "./EndpointApi.types.js";
+import type { DocumentListData, PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, ProfilBannerData, GetElementsAboutData, MulticonnectData, GetNewsData, GetNewsByIdData, AddNewsData, AddImageNewsData, AddFileNewsData, DeleteNewsData, UpdateNewsData, ShareNewsData, GetCommentsData, AddCommentsData, DeleteCommentsData, UpdateCommentsData, SearchTagsData, ShowVoteData, GlobalAutocompleteData, CityAutocompleteData, CityAutocompleteByCountryData, SuggestionInputData, GetProjectsNoAdminData, GetProjectsAdminData, GetPoisNoAdminData, GetPoisAdminData, GetOrganizationsNoAdminData, GetOrganizationsAdminData, GetUserEligiblePlacesData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, SearchEventsCostumData, ShareEventsData, InviteEventData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, NavigatorGettlData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, GetCoformByIdData, CoformUploadAnswerFileData, CoformGetAnswerFilesData, GetCoformCatalogsData, SaveCoformAnswerData, GetCoformAnswerHistoryData, GetCoformMultievalDataData, GetCoformCommontableContributorsData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData, DeleteDocumentByIdData, DemoteAdminData, CostumFilterCoformData, CostumFilterCoformByPathData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, GenerateAnswerFromFormData, FundingEnvelopeData, CoremuOperationData, CostumProjectActionRequestNewData, CostumProjectActionRequestSetStatusData, CostumProjectActionRequestSetDateData, CostumProjectActionRequestSetContributorsData, CostumProjectActionRequestCancelData, CostumProjectActionRequestArchiveData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData, PersonActivateData } from "./EndpointApi.types.js";
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
  */
@@ -843,6 +843,15 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     getEvents(data: GetEventsData): Promise<any>;
+    /**
+     * Recherche d'events scopée costum (agenda) : Agenda costum-aware : events filtrés par sourceKey/costum + plage de dates. Même endpoint /co2/search/agenda que GET_EVENTS, mais surface costum (PAS le filtre attendees/organizer forcé de GET_EVENTS). Réponse = cible-co2-search-agenda.
+     * Constant : SEARCH_EVENTS_COSTUM
+     * @param data - Données envoyées à l'API
+     * @returns Les données de réponse.
+     * @throws {ApiResponseError} - En cas d'erreur détectée dans la réponse.
+     * @throws {Error} - En cas d'erreur inattendue.
+     */
+    searchEventsCostum(data: SearchEventsCostumData): Promise<any>;
     /**
      * Partager un événement : Partage un événement avec d’autres utilisateurs ou entités.
      * Constant : SHARE_EVENTS

package/types/api/EndpointApi.types.d.ts

@@ -2588,7 +2588,7 @@ export interface AddOrganizationData {
      * Rôle principal de l’organisation
      */
     role: "admin" | "member";
-    tags?: string[];
+    tags?: "" | string[];
     /**
      * Email de l’organisation
      */
@@ -2612,18 +2612,12 @@ export interface AddOrganizationData {
         isOpenEdition: boolean;
         [k: string]: unknown;
     };
-    /**
-     * Coordonnées géographiques
-     */
-    geo?: {
+    geo?: "" | {
         "@type"?: "GeoCoordinates";
         latitude: string | number;
         longitude: string | number;
     };
-    /**
-     * Position géographique GeoJSON
-     */
-    geoPosition?: {
+    geoPosition?: "" | {
         /**
          * Type GeoJSON (doit être 'Point')
          */
@@ -2638,7 +2632,7 @@ export interface AddOrganizationData {
         /**
          * Indicateur pour forcer la conversion en float côté serveur
          */
-        float: true;
+        float?: true;
         [k: string]: unknown;
     };
     /**
@@ -2655,7 +2649,7 @@ export interface AddOrganizationData {
             tags: string[];
         };
     };
-    address?: {
+    address?: "" | {
         "@type": "PostalAddress";
         addressCountry: string;
         codeInsee: string;
@@ -2885,7 +2879,7 @@ export interface AddProjectData {
      * Visibilité (true/false)
      */
     public: boolean;
-    tags?: string[];
+    tags?: "" | string[];
     /**
      * Description courte
      */
@@ -2909,18 +2903,12 @@ export interface AddProjectData {
         crowdfunding?: boolean;
         [k: string]: unknown;
     };
-    /**
-     * Coordonnées géographiques
-     */
-    geo?: {
+    geo?: "" | {
         "@type"?: "GeoCoordinates";
         latitude: string | number;
         longitude: string | number;
     };
-    /**
-     * Position géographique GeoJSON
-     */
-    geoPosition?: {
+    geoPosition?: "" | {
         /**
          * Type GeoJSON (doit être 'Point')
          */
@@ -2935,10 +2923,10 @@ export interface AddProjectData {
         /**
          * Indicateur pour forcer la conversion en float côté serveur
          */
-        float: true;
+        float?: true;
         [k: string]: unknown;
     };
-    address?: {
+    address?: "" | {
         "@type": "PostalAddress";
         addressCountry: string;
         codeInsee: string;
@@ -3018,23 +3006,17 @@ export interface AddPoiData {
      * Description
      */
     description?: string;
-    tags?: string[];
+    tags?: "" | string[];
     /**
      * URLs externes associées
      */
     urls?: string[];
-    /**
-     * Coordonnées géographiques
-     */
-    geo?: {
+    geo?: "" | {
         "@type"?: "GeoCoordinates";
         latitude: string | number;
         longitude: string | number;
     };
-    /**
-     * Position géographique GeoJSON
-     */
-    geoPosition?: {
+    geoPosition?: "" | {
         /**
          * Type GeoJSON (doit être 'Point')
          */
@@ -3049,10 +3031,10 @@ export interface AddPoiData {
         /**
          * Indicateur pour forcer la conversion en float côté serveur
          */
-        float: true;
+        float?: true;
         [k: string]: unknown;
     };
-    address?: {
+    address?: "" | {
         "@type": "PostalAddress";
         addressCountry: string;
         codeInsee: string;
@@ -3323,18 +3305,12 @@ export interface AddEventData {
             }[];
         })
     ];
-    /**
-     * Coordonnées géographiques
-     */
-    geo?: {
+    geo?: "" | {
         "@type"?: "GeoCoordinates";
         latitude: string | number;
         longitude: string | number;
     };
-    /**
-     * Position géographique GeoJSON
-     */
-    geoPosition?: {
+    geoPosition?: "" | {
         /**
          * Type GeoJSON (doit être 'Point')
          */
@@ -3349,7 +3325,7 @@ export interface AddEventData {
         /**
          * Indicateur pour forcer la conversion en float côté serveur
          */
-        float: true;
+        float?: true;
         [k: string]: unknown;
     };
     address?: "" | {
@@ -3743,9 +3719,9 @@ export interface GetEventsData {
     countType?: unknown[];
     fediverse: boolean;
     /**
-     * Filtrer les événements récurrents (true/false)
+     * GARDE PARITÉ legacy (identique à SEARCH_EVENTS_COSTUM) : seule valeur autorisée `false` (= exclure les récurrents) OU champ omis (= inclure, défaut). NE JAMAIS envoyer `true` — le legacy teste STRICTEMENT $recurrency === true (AgendaAction.php:65) qui échoue sur la string POST → exclut les récurrents, alors que notre backend les inclurait (divergence assumée). En interdisant `true`, omis→inclus et false→exclus se comportent pareil sur les 2 serveurs.
      */
-    recurrency?: boolean;
+    recurrency?: false;
     filters?: {
         $or?: Record<string, unknown>;
         /**
@@ -3756,6 +3732,77 @@ export interface GetEventsData {
     };
     [k: string]: unknown;
 }
+export interface SearchEventsCostumData {
+    searchType: "events"[];
+    indexMin: number;
+    indexStep: number;
+    /**
+     * Date de début (UTC)
+     */
+    startDateUTC?: string;
+    /**
+     * Date de fin (UTC)
+     */
+    endDateUTC?: string;
+    /**
+     * Nom ou terme
+     */
+    name?: string;
+    /**
+     * Type d’événement
+     */
+    type?: "workshop" | "competition" | "concert" | "contest" | "conference" | "debate" | "exhibition" | "festival" | "crowdfunding" | "fair" | "course" | "protest" | "market" | "film" | "getTogether" | "meeting" | "spectacle" | "internship" | "stand" | "others";
+    /**
+     * Liste des localités ciblées
+     */
+    locality?: {
+        /**
+         * This interface was referenced by `undefined`'s JSON-Schema definition
+         * via the `patternProperty` "^[^\s]+$".
+         */
+        [k: string]: {
+            [k: string]: unknown;
+        };
+    };
+    count?: boolean;
+    countType?: unknown[];
+    fediverse: boolean;
+    /**
+     * GARDE PARITÉ legacy : seule valeur autorisée `false` (= exclure les récurrents) OU champ omis (= inclure, défaut). NE JAMAIS envoyer `true` — le legacy teste STRICTEMENT $recurrency === true (AgendaAction.php:65) qui échoue sur la string POST → exclut les récurrents, alors que notre backend les inclurait (divergence assumée). En interdisant `true`, omis→inclus et false→exclus se comportent pareil sur les 2 serveurs.
+     */
+    recurrency?: false;
+    /**
+     * Filtres Mongo additionnels (buildFilters).
+     */
+    filters?: {
+        [k: string]: unknown;
+    };
+    /**
+     * Scope costum : events dont source.keys/reference.costum ∈ sourceKey (agenda multi-sites/réseau). Auto-injecté = [slug de l’entité] si absent.
+     */
+    sourceKey?: string[];
+    /**
+     * Filtre par tags ($in, ou $all via options.tags.verb).
+     */
+    searchTags?: string[];
+    /**
+     * Events liés (links.<type>.<id>).
+     */
+    links?: {
+        type: string;
+        id: string;
+        [k: string]: unknown;
+    }[];
+    subType?: string;
+    category?: string;
+    section?: string | string[];
+    contextId?: string;
+    contextType?: string;
+    costumSlug?: string;
+    costumId?: string;
+    costumType?: string;
+    [k: string]: unknown;
+}
 export interface ShareEventsData {
     /**
      * ID de l’événement à partager

package/types/api/User.d.ts

@@ -295,9 +295,16 @@ export declare class User extends BaseEntity<UserItemNormalized> {
      * const org = await tl.organization({ name: "Mon TL", manageModel: "Association", buildingSurfaceArea: "120" });
      * await org.save();
      *
-     * @param slug - slug d'un costum connu (registry généré). Slug hors registry => erreur (live-fetch = inc2).
+     * Deux formes :
+     *  - `me.costum(slug)` : slug d'un costum du registry (autocomplété) OU n'importe quel slug (`string`) —
+     *    le backend reste l'autorité de validité (`found`). Slug hors registry sans champ → inc1b (résolution live).
+     *  - `me.costum(entity)` : ouvre un scope FIELDLESS depuis une entité DÉJÀ CHARGÉE (org/projet/event qui porte
+     *    un costum), zéro fetch — `source.key` = slug de l'entité. Cas « créer sous ce site nu ».
+     *
+     * @param arg - slug (`KnownCostumSlug | string`) OU une entité chargée porteuse d'un costum.
      */
-    costum(slug: KnownCostumSlug): Promise<CostumScope>;
+    costum(slug: KnownCostumSlug | (string & {})): Promise<CostumScope>;
+    costum(entity: BaseEntity): Promise<CostumScope>;
     /**
      * {@inheritDoc BaseEntity#badge}
      *

package/types/api/UserApi.d.ts

@@ -44,14 +44,20 @@ export declare class UserApi {
      * @param params.username - Nom d'utilisateur.
      * @param params.email - Adresse email.
      * @param params.pwd - Mot de passe.
+     * @param params.costumSlug - (option) slug du costum de déploiement → estampille `source.key` du citoyen
+     *   côté backend (port Person::insert). `costumId`/`costumType` = entité porteuse (requis si le slug n'est
+     *   pas un doc `costum`, ex. un site porté par une org).
      * @returns Réponse brute de l'API.
      * @throws {ApiResponseError} Si l'API retourne un échec (`result === false`).
      */
-    register({ name, username, email, pwd }: {
+    register({ name, username, email, pwd, costumSlug, costumId, costumType }: {
         name: string;
         username: string;
         email: string;
         pwd: string;
+        costumSlug?: string;
+        costumId?: string;
+        costumType?: string;
     }): Promise<any>;
     /**
      * Lance une procédure de récupération de mot de passe.

package/types/costum/runtime.d.ts

@@ -62,12 +62,12 @@ export interface CostumFormDescriptor {
  * et n'altère jamais l'état partagé — chaque entité reçoit son propre `_costumCtx`.
  */
 export declare class CostumScope {
-    readonly slug: KnownCostumSlug;
+    readonly slug: KnownCostumSlug | (string & {});
     private readonly user;
     private readonly module;
     private readonly costumId;
     private readonly costumType;
-    constructor(user: BaseEntity, slug: KnownCostumSlug, module: CostumExtensionModule, costumId: string, costumType: string);
+    constructor(user: BaseEntity, slug: KnownCostumSlug | (string & {}), module: CostumExtensionModule, costumId: string, costumType: string);
     /** Construit le `CostumRuntimeContext` pour une collection donnée (null si le costum ne la couvre pas). */
     contextFor(collection: Collection): CostumRuntimeContext | null;
     /** Crée une entité de `collection` sous ce costum (presets appliqués, surchargeables par `data`). */
@@ -93,7 +93,16 @@ export declare class CostumScope {
  */
 export declare function resolveCostumCtxFromSource(sourceKey: string | undefined | null, collection: Collection): CostumRuntimeContext | null;
 /**
- * Résout un `CostumScope` pour un user connecté. Known-only (inc1) : charge le module généré
- * (code-split via dynamic import) + le meta du registry. Slug inconnu => erreur explicite.
+ * Ouvre un scope costum FIELDLESS depuis une entité DÉJÀ CHARGÉE (zéro fetch) : `costumSlug` = slug de
+ * l'entité (= `source.key` posé par le backend), `costumId/costumType` = l'entité porteuse. Pendant runtime
+ * exact de `_withCostumContext` (BaseEntity), pour la voie « entité tenue » (un site nu sans form). Le
+ * backend re-gate `found` sur l'existence d'un costum sur l'entité → un site sans costum n'estampille rien.
  */
-export declare function resolveCostumScope(user: BaseEntity, slug: KnownCostumSlug): Promise<CostumScope>;
+export declare function costumScopeFromEntity(user: BaseEntity, entity: BaseEntity): CostumScope;
+/**
+ * Résout un `CostumScope` par SLUG pour un user connecté.
+ *  - slug à champs (meta + loader) → charge le module généré (code-split via dynamic import).
+ *  - slug CONNU sans loader (fieldless) → scope d'identité nu (`collections:{}`).
+ *  - slug HORS registry → résolution LIVE via `slug/getinfo` (contextId/contextType) → scope nu (tier 3b).
+ */
+export declare function resolveCostumScope(user: BaseEntity, slug: KnownCostumSlug | (string & {})): Promise<CostumScope>;