@communecter/cocolight-api-client 1.0.75 → 1.0.77

package/types/api/BaseEntity.d.ts

@@ -186,6 +186,11 @@ export declare class BaseEntity<TServerData = any> {
     static entityTag: string;
     static entityType?: string;
     static SCHEMA_CONSTANTS?: string | string[];
+    static VIRTUAL_SCHEMAS?: Record<string, any>;
+    static CUSTOM_FIELD_HANDLERS?: Map<string, {
+        updateMethod: string;
+        schemaConstant?: string;
+    }>;
     /**
      * Vérifie que l'objet n'a pas été supprimé.
      * @throws {ApiError} - Si l'objet a été supprimé.
@@ -593,6 +598,30 @@ export declare class BaseEntity<TServerData = any> {
      * @private
      */
     private _compareValues;
+    /**
+     * Merge deux schémas JSON en combinant leurs propriétés.
+     * @param base - Schéma de base (peut être null/undefined)
+     * @param virtual - Schéma virtuel à fusionner
+     * @returns Schéma combiné
+     * @private
+     */
+    private _mergeSchemas;
+    /**
+     * Vérifie si un champ a changé par rapport à l'état initial.
+     * @param fieldName - Nom du champ
+     * @returns true si le champ a changé
+     * @protected
+     */
+    protected _hasFieldChanged(fieldName: string): boolean;
+    /**
+     * Invoque un handler personnalisé pour un champ spécifique.
+     * @param methodName - Nom de la méthode à appeler
+     * @param value - Valeur du champ
+     * @param fieldName - Nom du champ (pour les messages d'erreur)
+     * @returns Résultat de l'appel de la méthode
+     * @protected
+     */
+    protected _invokeCustomFieldHandler(methodName: string, value: any, fieldName: string): Promise<any>;
     _extractChangedFieldsFromSchema(apiClient: ApiClient, constant: string, data: Record<string, any> | undefined, getInitialDraft: () => Record<string, any> | void, removeFields?: string[]): Record<string, any> | null;
     /**
      * Extrait tous les champs valides selon le schéma, et retourne uniquement ceux qui ont changé par rapport au draft initial.

package/types/api/EndpointApi.d.ts

@@ -1,5 +1,5 @@
 import type ApiClient from "../ApiClient.js";
-import type { 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, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeletePoiData, DeleteEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, ShareEventsData, InviteEventData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, AddVoteData, AddReportAbuseData } from "./EndpointApi.types.js";
+import type { 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, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeletePoiData, DeleteEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, ShareEventsData, InviteEventData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData } from "./EndpointApi.types.js";
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
  */
@@ -1029,5 +1029,25 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     addReportAbuse(data: AddReportAbuseData): Promise<any>;
+    /**
+     * Mettre à jour une valeur de chemin pour une entité : Met à jour une valeur spécifique dans le chemin donné pour une entité.
+     * Constant : UPDATE_PATH_VALUE
+     * @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 {ApiAuthenticationError} - En cas d'erreur d'authentification.
+     * @throws {Error} - En cas d'erreur inattendue.
+     */
+    updatePathValue(data: UpdatePathValueData): Promise<any>;
+    /**
+     * Supprimer une image/document par contexte d’entité : Supprimer des documents associés à une entité dans un contexte spécifique
+     * Constant : DELETE_DOCUMENT_BY_CONTEXT
+     * @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 {ApiAuthenticationError} - En cas d'erreur d'authentification.
+     * @throws {Error} - En cas d'erreur inattendue.
+     */
+    deleteDocumentByContext(data: DeleteDocumentByContextData): Promise<any>;
 }
 export default EndpointApi;

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

@@ -4458,3 +4458,52 @@ export interface AddReportAbuseData {
     };
     [k: string]: unknown;
 }
+export interface UpdatePathValueData {
+    /**
+     * ID de l’utilisateur
+     */
+    id: string;
+    /**
+     * Collection de l’entité
+     */
+    collection: "citoyens" | "organizations" | "projects" | "events" | "poi";
+    /**
+     * Chemin de la valeur à mettre à jour
+     */
+    path: string;
+    arrayForm?: boolean;
+    /**
+     * Valeur à mettre à jour (peut être un objet, un tableau, une chaîne, etc.)
+     */
+    value: {
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+}
+export interface DeleteDocumentByContextData {
+    /**
+     * ID de l’utilisateur
+     */
+    parentId?: string;
+    /**
+     * Type de contexte de l’entité
+     */
+    parentType?: "citoyens" | "organizations" | "projects" | "events" | "poi";
+    path: "communecter";
+    /**
+     * ID image/document à supprimer
+     */
+    ids?: string;
+    pathParams?: {
+        /**
+         * ID du contexte de l’entité
+         */
+        contextId: string;
+        /**
+         * Type de contexte de l’entité
+         */
+        contextType: "citoyens" | "organizations" | "projects" | "events" | "poi";
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+}

package/types/api/Organization.d.ts

@@ -1,12 +1,72 @@
 import { BaseEntity } from "./BaseEntity.js";
 import type { PaginatorPage } from "./BaseEntity.js";
 import type { AddOrganizationData, GetMembersAdminData, GetMembersNoAdminData } from "./EndpointApi.types.js";
+import type { OpeningHoursEntry } from "./serverDataType/common.js";
 import type { OrganizationItemNormalized } from "./serverDataType/Organization.js";
 import type { User } from "./User.js";
 export declare class Organization extends BaseEntity<OrganizationItemNormalized> {
     static entityType: string;
     static entityTag: string;
     static SCHEMA_CONSTANTS: string[];
+    static VIRTUAL_SCHEMAS: {
+        VIRTUAL_OPENING_HOURS: {
+            type: string;
+            properties: {
+                openingHours: {
+                    type: string;
+                    description: string;
+                    minItems: number;
+                    maxItems: number;
+                    items: {
+                        oneOf: ({
+                            type: string;
+                            const: string;
+                            properties?: undefined;
+                            required?: undefined;
+                            additionalProperties?: undefined;
+                        } | {
+                            type: string;
+                            properties: {
+                                dayOfWeek: {
+                                    type: string;
+                                    enum: string[];
+                                    description: string;
+                                };
+                                hours: {
+                                    type: string;
+                                    description: string;
+                                    items: {
+                                        type: string;
+                                        properties: {
+                                            opens: {
+                                                type: string;
+                                                pattern: string;
+                                                description: string;
+                                            };
+                                            closes: {
+                                                type: string;
+                                                pattern: string;
+                                                description: string;
+                                            };
+                                        };
+                                        required: string[];
+                                        additionalProperties: boolean;
+                                    };
+                                };
+                            };
+                            required: string[];
+                            additionalProperties: boolean;
+                            const?: undefined;
+                        })[];
+                    };
+                };
+            };
+        };
+    };
+    static CUSTOM_FIELD_HANDLERS: Map<"openingHours", {
+        readonly updateMethod: "updateOpeningHours";
+        readonly schemaConstant: "VIRTUAL_OPENING_HOURS";
+    }>;
     static ADD_BLOCKS: Map<"PROFIL_IMAGE" | "ADD_ORGANIZATION", "updateImageProfil" | "addOrganization">;
     static UPDATE_BLOCKS: Map<"UPDATE_BLOCK_DESCRIPTION" | "UPDATE_BLOCK_INFO" | "UPDATE_BLOCK_SOCIAL" | "UPDATE_BLOCK_LOCALITY" | "UPDATE_BLOCK_SLUG" | "PROFIL_IMAGE", "updateImageProfil" | "updateDescription" | "updateSocial" | "updateLocality" | "updateInfo" | "updateSlug">;
     defaultFields: Record<string, any>;
@@ -135,6 +195,23 @@ export declare class Organization extends BaseEntity<OrganizationItemNormalized>
      * Crée une instance de news et la récupère si nécessaire.
      */
     news(newsData?: Parameters<BaseEntity<OrganizationItemNormalized>["news"]>[0]): Promise<import("./News.js").News>;
+    /**
+     * Met à jour les horaires d'ouverture de l'organisation.
+     * Utilise UPDATE_PATH_VALUE pour modifier le champ openingHours.
+     *
+     * @param hours - Tableau de 7 entrées (une par jour de la semaine)
+     * @returns Résultat de l'appel API
+     * @throws {ApiError} Si l'organisation n'a pas d'ID
+     *
+     * @example
+     * const openingHours = [
+     *   { dayOfWeek: "Mo", hours: [{ opens: "09:00", closes: "18:00" }] },
+     *   { dayOfWeek: "Tu", hours: [{ opens: "09:00", closes: "18:00" }] },
+     *   // ... pour les 7 jours
+     * ];
+     * await org.updateOpeningHours(openingHours);
+     */
+    updateOpeningHours(hours: OpeningHoursEntry[]): Promise<unknown>;
     /**
      * ───────────────────────────────
      *  Lien utilisateur ↔ organisation