@communecter/cocolight-api-client 1.0.128 → 1.0.130

package/src/index.ts

@@ -1,5 +1,5 @@
 import { BaseEntity } from "./api/BaseEntity.js";
-import { fromEntityJSON } from "./api/EntityRegistry.js";
+import { fromEntityJSON, reviveEntities } from "./api/EntityRegistry.js";
 import Api from "./Api.js";
 import ApiClient from "./ApiClient.js";
 import * as error from "./error.js";
@@ -33,6 +33,7 @@ const cocolightApiClient = {
   },
   helper: {
     fromEntityJSON,
+    reviveEntities,
     restorePaginationFromJSON: BaseEntity.restorePaginationFromJSON
   },
   OfflineClientManager

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

@@ -1524,8 +1524,13 @@ export interface GetMembersNoAdminData {
     name?: string;
     /**
      * Types d'entités à inclure dans la recherche
+     *
+     * @minItems 1
      */
-    searchType: ("citoyens" | "NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative")[];
+    searchType: [
+        "citoyens" | "NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative",
+        ...("citoyens" | "NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative")[]
+    ];
     /**
      * Critère de recherche (actuellement vide)
      */
@@ -1597,8 +1602,13 @@ export interface GetMembersAdminData {
     name?: string;
     /**
      * Types d'entités à inclure dans la recherche
+     *
+     * @minItems 1
      */
-    searchType: ("citoyens" | "NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative")[];
+    searchType: [
+        "citoyens" | "NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative",
+        ...("citoyens" | "NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative")[]
+    ];
     /**
      * Critère de recherche (actuellement vide)
      */
@@ -2036,8 +2046,13 @@ export interface GetContributorsNoAdminData {
     name?: string;
     /**
      * Types d'entités à inclure dans la recherche
+     *
+     * @minItems 1
      */
-    searchType: ("citoyens" | "NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative")[];
+    searchType: [
+        "citoyens" | "NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative",
+        ...("citoyens" | "NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative")[]
+    ];
     /**
      * Critère de recherche (actuellement vide)
      */
@@ -2109,8 +2124,13 @@ export interface GetContributorsAdminData {
     name?: string;
     /**
      * Types d'entités à inclure dans la recherche
+     *
+     * @minItems 1
      */
-    searchType: ("citoyens" | "NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative")[];
+    searchType: [
+        "citoyens" | "NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative",
+        ...("citoyens" | "NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative")[]
+    ];
     /**
      * Critère de recherche (actuellement vide)
      */

package/types/api/EntityRegistry.d.ts

@@ -17,6 +17,27 @@ export declare function registerEntity(tag: EntityTag, EntityClass: EntityClass)
  * Si la collection ou la métadonnée d'entité est absente, renvoie l'objet d'origine.
  */
 export declare function fromEntityJSON(json: unknown, parent?: ApiClient | BaseEntity | null): BaseEntity | unknown | null;
+/**
+ * Walker récursif : parcourt un objet/tableau et ressuscite toutes les entités
+ * sérialisées (marqueurs `__isSerializedEntity` / `__entityTag`) rencontrées.
+ *
+ * Pensé pour les wrappers non-entité retournés par certains endpoints (ex: `fundingEnvelope`)
+ * ou pour réhydrater un état côté client après un transfert JSON (SSR, cache restore).
+ *
+ * Dates, RegExp et primitives sont préservées. Pour les entités, la chaîne de parents
+ * est reconstruite automatiquement depuis les méta embarquées par `toJSON()`.
+ *
+ * @param obj - L'objet à parcourir (wrapper, array, primitive…)
+ * @param parent - Parent racine (typiquement l'ApiClient côté client)
+ * @returns L'objet avec toutes les entités revived
+ *
+ * @example
+ * // Côté client SSR : revive l'état dehydraté
+ * const apiClient = new ApiClient({ baseURL });
+ * const envelope = reviveEntities(window.__INIT__.envelope, apiClient);
+ * envelope.projects[0].serverData.actions[0]; // Action instance
+ */
+export declare function reviveEntities<T = unknown>(obj: unknown, parent?: ApiClient | BaseEntity | null): T;
 /**
  * Crée une instance d'entité basée sur le seul nom de la collection.
  */

package/types/api/Organization.d.ts

@@ -156,7 +156,11 @@ export declare class Organization extends BaseEntity<OrganizationItemNormalized>
      * // Récupérer les membres en attente de validation pour être admin
      * const adminPendingMembers = await organization.getMembers({}, { isAdminPending: true });
      *
+     * // Restreindre la recherche : uniquement les citoyens
+     * const onlyCitoyens = await organization.getMembers({}, { searchType: "citoyens" });
      *
+     * // Restreindre la recherche : uniquement les organisations
+     * const onlyOrgas = await organization.getMembers({}, { searchType: "organizations" });
      */
     getMembers(data?: Partial<GetMembersAdminData | GetMembersNoAdminData>, options?: {
         toBeValidated?: boolean;
@@ -164,6 +168,7 @@ export declare class Organization extends BaseEntity<OrganizationItemNormalized>
         isAdminPending?: boolean;
         isInviting?: boolean;
         roles?: any[];
+        searchType?: "all" | "citoyens" | "organizations";
         restoredState?: PaginatorState;
     }): Promise<PaginatorPage<User | Organization>>;
     /**

package/types/api/Project.d.ts

@@ -91,6 +91,11 @@ export declare class Project extends BaseEntity<ProjectItemNormalized> {
      * // Récupérer les contributeurs en attente d'invitation
      * const invitingContributors = await project.getContributors({}, { isInviting: true });
      *
+     * // Restreindre la recherche : uniquement les citoyens
+     * const onlyCitoyens = await project.getContributors({}, { searchType: "citoyens" });
+     *
+     * // Restreindre la recherche : uniquement les organisations
+     * const onlyOrgas = await project.getContributors({}, { searchType: "organizations" });
      */
     getContributors(data?: Partial<GetContributorsAdminData | GetContributorsNoAdminData>, options?: {
         toBeValidated?: boolean;
@@ -98,6 +103,7 @@ export declare class Project extends BaseEntity<ProjectItemNormalized> {
         isAdminPending?: boolean;
         isInviting?: boolean;
         roles?: any[];
+        searchType?: "all" | "citoyens" | "organizations";
         restoredState?: PaginatorState;
     }): Promise<PaginatorPage<User | Organization>>;
     /**

package/types/endpoints.module.d.ts

@@ -11897,7 +11897,6 @@ declare const endpoints: {
                     type: string;
                 };
                 countType: {
-                    const: string[];
                     default: string[];
                     items: {
                         enum: string[];
@@ -12094,12 +12093,12 @@ declare const endpoints: {
                     type: string;
                 };
                 searchType: {
-                    const: string[];
                     default: string[];
                     items: {
                         enum: string[];
                         type: string;
                     };
+                    minItems: number;
                     type: string;
                 };
                 app?: undefined;
@@ -12327,7 +12326,6 @@ declare const endpoints: {
                     type: string;
                 };
                 countType: {
-                    const: string[];
                     default: string[];
                     items: {
                         enum: string[];
@@ -12566,12 +12564,12 @@ declare const endpoints: {
                     type: string;
                 };
                 searchType: {
-                    const: string[];
                     default: string[];
                     items: {
                         enum: string[];
                         type: string;
                     };
+                    minItems: number;
                     type: string;
                 };
                 app?: undefined;
@@ -14859,7 +14857,6 @@ declare const endpoints: {
                     type: string;
                 };
                 countType: {
-                    const: string[];
                     default: string[];
                     items: {
                         enum: string[];
@@ -15056,12 +15053,12 @@ declare const endpoints: {
                     type: string;
                 };
                 searchType: {
-                    const: string[];
                     default: string[];
                     items: {
                         enum: string[];
                         type: string;
                     };
+                    minItems: number;
                     type: string;
                 };
                 app?: undefined;
@@ -15289,7 +15286,6 @@ declare const endpoints: {
                     type: string;
                 };
                 countType: {
-                    const: string[];
                     default: string[];
                     items: {
                         enum: string[];
@@ -15528,12 +15524,12 @@ declare const endpoints: {
                     type: string;
                 };
                 searchType: {
-                    const: string[];
                     default: string[];
                     items: {
                         enum: string[];
                         type: string;
                     };
+                    minItems: number;
                     type: string;
                 };
                 app?: undefined;

package/types/index.d.ts

@@ -1,5 +1,5 @@
 import { BaseEntity } from "./api/BaseEntity.js";
-import { fromEntityJSON } from "./api/EntityRegistry.js";
+import { fromEntityJSON, reviveEntities } from "./api/EntityRegistry.js";
 import Api from "./Api.js";
 import ApiClient from "./ApiClient.js";
 import * as error from "./error.js";
@@ -31,6 +31,7 @@ declare const cocolightApiClient: {
     };
     helper: {
         fromEntityJSON: typeof fromEntityJSON;
+        reviveEntities: typeof reviveEntities;
         restorePaginationFromJSON: typeof BaseEntity.restorePaginationFromJSON;
     };
     OfflineClientManager: typeof OfflineClientManager;