@communecter/cocolight-api-client 1.0.129 → 1.0.130

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@communecter/cocolight-api-client",
-    "version": "1.0.129",
+    "version": "1.0.130",
     "description": "Client Axios simplifié pour l'API cocolight",
     "repository": {
         "type": "git",

package/src/api/BaseEntity.ts

@@ -4835,11 +4835,22 @@ export class BaseEntity<TServerData = any> {
       ...(result.projects && {
         projects: (result.projects as FundingEnvelopeProjectItem[]).map((envelope) => {
           const inner = envelope?.project as { collection?: string } | undefined;
+          let linked: AnyEntity | object | undefined = envelope.project;
           if (inner && typeof inner === "object") {
-            const linked = this._linkEntity(inner.collection ?? "projects", inner);
-            return { ...envelope, project: linked ?? envelope.project };
+            linked = this._linkEntity(inner.collection ?? "projects", inner) ?? envelope.project;
           }
-          return envelope;
+
+          // Linker les actions imbriquées avec le Project linké comme parent sémantique.
+          // (action.parent === Project → save/refresh/isContributor cohérents)
+          const sd = (envelope as { serverData?: { actions?: unknown[] } }).serverData;
+          if (sd?.actions && Array.isArray(sd.actions)
+              && linked && typeof (linked as BaseEntity)._linkEntity === "function") {
+            sd.actions = sd.actions.map((action) =>
+              (linked as BaseEntity)._linkEntity("actions", action as object) ?? action
+            );
+          }
+
+          return { ...envelope, project: linked };
         })
       }),
       ...(result.userOrga && { userOrga: this._linkEntities(Object.values(result.userOrga)) ?? result.userOrga })

package/src/api/EntityRegistry.ts

@@ -98,6 +98,49 @@ export function fromEntityJSON(json: unknown, parent: ApiClient | BaseEntity | n
   return meta.entityClass.fromJSON(json, actualParent, meta.deps);
 }
 
+/**
+ * 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 function reviveEntities<T = unknown>(
+  obj: unknown,
+  parent: ApiClient | BaseEntity | null = null
+): T {
+  if (obj === null || obj === undefined) return obj as T;
+  if (typeof obj !== "object") return obj as T;
+  if (obj instanceof Date || obj instanceof RegExp) return obj as T;
+
+  if (isEntityJSON(obj)) {
+    return fromEntityJSON(obj, parent) as T;
+  }
+
+  if (Array.isArray(obj)) {
+    return obj.map(item => reviveEntities(item, parent)) as T;
+  }
+
+  const result: Record<string, unknown> = {};
+  for (const [key, value] of Object.entries(obj as object)) {
+    result[key] = reviveEntities(value, parent);
+  }
+  return result as T;
+}
+
 /**
  * Mappe un EntityTag vers son CollectionKey correspondant.
  */

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/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/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;