@communecter/cocolight-api-client 1.0.54 → 1.0.56

package/src/utils/{reactive.js → reactive.ts}

@@ -1,18 +1,16 @@
-// reactive.js - Système maison combinant Signal + Proxy pour réactivité profonde et fine
+// reactive.ts - Système maison combinant Signal + Proxy pour réactivité profonde et fine
 
-const effectStack = [];
+const effectStack: (() => void)[] = [];
 const computedCache = new WeakMap();
 const signalRegistry = new WeakMap();
 let batchDepth = 0;
-const pendingEffects = new Set();
+const pendingEffects = new Set<() => void>();
 
 /**
  * Crée une fonction réactive qui se relance automatiquement
  * lorsqu'une valeur réactive qu'elle utilise change.
- * @param {Function} fn
- * @returns {Function} le wrapper exécuté
  */
-export function effect(fn) {
+export function effect(fn: () => void): () => void {
   const wrapper = () => {
     try {
       effectStack.push(wrapper);
@@ -28,10 +26,8 @@ export function effect(fn) {
 /**
  * Exécute une fonction dans un lot, en retardant l'exécution
  * des effets jusqu'à ce que le lot soit terminé.
- * @param {Function} fn
- * @returns {void}
  */
-export function batch(fn) {
+export function batch(fn: () => void): void {
   batchDepth++;
   try {
     fn();
@@ -40,17 +36,15 @@ export function batch(fn) {
     if (batchDepth === 0) {
       const effects = Array.from(pendingEffects);
       pendingEffects.clear();
-      for (const effect of effects) effect();
+      for (const effect of effects) (effect as () => void)();
     }
   }
 }
 
 /**
  * Crée un signal observable pour une valeur primitive ou complexe.
- * @param {*} initialValue
- * @returns {{value: *, subscribe: Function, __isSignal: boolean}}
  */
-function createSignal(initialValue) {
+function createSignal(initialValue?: any): any {
   let value = initialValue;
   const subscribers = new Set();
 
@@ -64,13 +58,13 @@ function createSignal(initialValue) {
       if (value !== newValue) {
         value = newValue;
         if (batchDepth > 0) {
-          subscribers.forEach((fn) => pendingEffects.add(fn));
+          subscribers.forEach((fn) => pendingEffects.add(fn as () => void));
         } else {
-          subscribers.forEach((fn) => fn());
+          subscribers.forEach((fn) => (fn as () => void)());
         }
       }
     },
-    subscribe(fn) {
+    subscribe(fn: any) {
       subscribers.add(fn);
       return () => subscribers.delete(fn);
     },
@@ -85,47 +79,62 @@ function createSignal(initialValue) {
  * @param {*} obj
  * @returns {boolean}
  */
-export function isSignal(obj) {
+export function isSignal(obj: any) {
   return obj && obj.__isSignal === true;
 }
 
-function toRaw(obj) {
+function toRaw(obj: any) {
   return isSignal(obj) ? obj.value : obj;
 }
 
-function _wrapArray(arr, path) {
+function _wrapArray(arr: any[], path: string[]): any {
   const proxy = new Proxy(arr, {
-    get(target, prop) {
-      if (typeof prop === "string" && !isNaN(prop)) {
-        const val = target[prop];
-        return isReactive(val) ? val : reactive(val, path.concat(prop));
+    get(target, prop, receiver) {
+      if (typeof prop === "string" && !isNaN(+prop)) {
+        const val = target[+prop];
+        return isReactive(val) ? val : _wrapReactive(val, [...path, prop] as any);
       }
-      return Reflect.get(target, prop);
+      return Reflect.get(target, prop, receiver);
     },
     set(target, prop, value) {
-      const val = reactive(value, path.concat(prop));
-      target[prop] = val;
+      if (typeof prop === "string" && !isNaN(+prop)) {
+        const val = _wrapReactive(value, [...path, prop] as any);
+        target[+prop] = val;
+      }
       return true;
     }
   });
   return proxy;
 }
 
-function _wrapReactive(obj, path = []) {
+function _wrapReactive(obj: any, path: any = []) {
   if (typeof obj !== "object" || obj === null) return obj;
   if (Array.isArray(obj)) return _wrapArray(obj, path);
   if (obj.__isReactive) return obj;
 
+  // Ne pas proxifier les types d'upload (Buffer, File, Blob, Stream)
+  // car cela corromprait leurs données internes
+  // Buffer (Node.js)
+  if (typeof Buffer !== "undefined" && Buffer.isBuffer(obj)) return obj;
+  // File (Browser)
+  if (typeof File !== "undefined" && obj instanceof File) return obj;
+  // Blob (Browser)
+  if (typeof Blob !== "undefined" && obj instanceof Blob) return obj;
+  // ReadableStream (Node.js)
+  if (obj && typeof obj.pipe === "function" && typeof obj.on === "function") return obj;
+  // Date objects
+  if (obj instanceof Date) return obj;
+
   const signalMap = new Map();
   const proxy = new Proxy(obj, {
-    // eslint-disable-next-line no-unused-vars
-    get(target, prop, receiver) {
+
+    get(target, prop) {
       if (prop === "__raw") return target;
       if (prop === "__isReactive") return true;
 
       if (!signalMap.has(prop)) {
         const val = target[prop];
-        const reactiveVal = _wrapReactive(val, path.concat(prop));
+        const reactiveVal = _wrapReactive(val, [...path, String(prop)] as any);
         const signal = createSignal(reactiveVal);
         signalMap.set(prop, signal);
       }
@@ -135,12 +144,12 @@ function _wrapReactive(obj, path = []) {
     },
 
     set(target, prop, value) {
-      const val = _wrapReactive(value, path.concat(prop));
+      const val = _wrapReactive(value, [...path, String(prop)] as any);
       if (!signalMap.has(prop)) {
         const signal = createSignal(val);
         signalMap.set(prop, signal);
       }
-      signalMap.get(prop).value = val;
+      signalMap.get(prop)!.value = val;
       target[prop] = toRaw(val);
       return true;
     },
@@ -160,7 +169,7 @@ function _wrapReactive(obj, path = []) {
  * @param {object} obj
  * @returns {object}
  */
-export function reactive(obj) {
+export function reactive(obj: any) {
   if (typeof obj !== "object" || obj === null) return obj;
   if (obj.__isReactive) return obj;
   return _wrapReactive(obj);
@@ -171,7 +180,7 @@ export function reactive(obj) {
  * @param {*} obj
  * @returns {boolean}
  */
-export function isReactive(obj) {
+export function isReactive(obj: any) {
   return obj !== null && typeof obj === "object" && obj.__isReactive === true;
 }
 
@@ -180,7 +189,7 @@ export function isReactive(obj) {
  * @param {Function} fn
  * @returns {{value: *}}
  */
-export function computed(fn) {
+export function computed(fn: any) {
   if (computedCache.has(fn)) return computedCache.get(fn);
 
   const result = createSignal();
@@ -194,8 +203,8 @@ export function computed(fn) {
  * @param {Function} getter
  * @param {Function} callback
  */
-export function watch(getter, callback) {
-  let oldValue;
+export function watch(getter: any, callback: any) {
+  let oldValue: any;
   effect(() => {
     const newValue = getter();
     if (newValue !== oldValue) {
@@ -206,11 +215,11 @@ export function watch(getter, callback) {
 }
 
 /**
- * Récupère les signaux internes d’un objet réactif.
+ * Récupère les signaux internes d'un objet réactif.
  * @param {object} obj
  * @returns {Map|null}
  */
-export function getSignals(obj) {
+export function getSignals(obj: any) {
   if (!isReactive(obj)) return null;
   return signalRegistry.get(obj);
 }
@@ -222,7 +231,7 @@ export function getSignals(obj) {
  * @param {(newValue: any, oldValue: any) => void} callback
  * @returns {() => void} fonction de nettoyage
  */
-export function subscribeTo(obj, key, callback) {
+export function subscribeTo(obj: any, key: any, callback: any) {
   const signals = getSignals(obj);
   if (!signals || !signals.has(key)) return () => {};
   const signal = signals.get(key);

package/src/utils/stream-utils.node.ts

@@ -0,0 +1,12 @@
+// utils/stream-utils.node.ts
+import type { Readable, PassThrough } from "stream";
+
+export async function bufferToReadable(buffer: Buffer): Promise<Readable> {
+  const { Readable } = await import("stream");
+  return Readable.from(buffer);
+}
+
+export async function createPassThrough(): Promise<PassThrough> {
+  const { PassThrough } = await import("stream");
+  return new PassThrough();
+}

package/types/Api.d.ts

@@ -1,131 +1,87 @@
-/** @typedef {import("./ApiClient.js").default} ApiClient */
-/** @typedef {import("./ApiClient.js").ApiClientOptions} ApiClientOptions */
+import { Badge } from "./api/Badge.js";
+import { Comment } from "./api/Comment.js";
+import EndpointApi from "./api/EndpointApi.js";
+import { Event } from "./api/Event.js";
+import { News } from "./api/News.js";
+import { Organization } from "./api/Organization.js";
+import { Poi } from "./api/Poi.js";
+import { Project } from "./api/Project.js";
+import { User } from "./api/User.js";
+import { UserApi } from "./api/UserApi.js";
+import type ApiClient from "./ApiClient.js";
+import type { ApiClientOptions } from "./ApiClient.js";
+/**
+ * Union type for all possible entity types
+ */
+type EntityTypes = User | Organization | Project | Event | Poi | Badge | News | Comment;
+/**
+ * Type pour récupérer une entité existante via l'API publique.
+ * Nécessite soit un id, soit un slug.
+ * Les propriétés additionnelles sont autorisées mais ignorées lors de la récupération.
+ */
+type EntityData = {
+    id: string;
+    slug?: string;
+    [key: string]: any;
+} | {
+    slug: string;
+    id?: string;
+    [key: string]: any;
+};
 export default class Api {
+    private _loggedUser;
+    private _client;
     /**
      * Authentifie l'utilisateur et retourne une instance d'Api.
-     *
-     * @param {string} email - L'adresse email.
-     * @param {string} password - Le mot de passe.
-     * @param {ApiClientOptions|ApiClient} options - Options pour l'ApiClient ou instance existante.
-     * @returns {Promise<Api>}
-     * @throws {ApiAuthenticationError|ApiClientError|ApiError}
      */
     static userLogin(email: string, password: string, options: ApiClientOptions | ApiClient): Promise<Api>;
     /**
      * Crée une instance de UserApi avec les options fournies.
-     *
-     * @param {ApiClientOptions|ApiClient} options - Options pour ApiClient ou instance d'ApiClient.
-     * @returns {UserApi}
-     * @throws {Error}
      */
     static userApi(options: ApiClientOptions | ApiClient): UserApi;
     /**
      * Connecte un utilisateur avec un UserApi existant.
-     *
-     * @param {UserApi} userApi - Instance UserApi utilisée pour l'authentification.
-     * @param {string} email - Email de l'utilisateur.
-     * @param {string} password - Mot de passe de l'utilisateur.
-     * @returns {Promise<Api>}
-     * @throws {ApiAuthenticationError|ApiClientError|ApiError}
      */
     static userApiLogin(userApi: UserApi, email: string, password: string): Promise<Api>;
     /**
      * Construit une instance d'Api.
-     *
-     * @param {User|null} loggedUser - L'utilisateur connecté ou null.
-     * @param {ApiClient} client - L'instance d'ApiClient.
      */
     constructor(loggedUser: User | null, client: ApiClient);
-    _loggedUser: User;
-    _client: import("./ApiClient.js").default;
     /**
      * Retourne l'utilisateur connecté.
-     *
-     * @returns {Promise<User>} L'utilisateur connecté.
-     * @throws {ApiAuthenticationError} Si l'utilisateur n'est pas authentifié.
      */
     me(): Promise<User>;
     /**
      * Crée une instance User (autre que le connecté).
-     *
-     * @param {{id?: string, slug?: string, [k: string]: any}} userData
-     * @returns {Promise<User>}
-     * @throws {Error}
      */
-    user(userData: {
-        id?: string;
-        slug?: string;
-        [k: string]: any;
-    }): Promise<User>;
+    user(userData: EntityData): Promise<User>;
     /**
      * Creates an Organization object and optionally retrieves its profile.
-     *
-     * @param {{id?: string, slug?: string, [k: string]: any}} organizationData - The data required to initialize the Organization object.
-     * @returns {Promise<Organization>} A promise that resolves to the created Organization object.
-     * @throws {Error} Throws an error if the organization creation or profile retrieval fails.
      */
-    organization(organizationData: {
-        id?: string;
-        slug?: string;
-        [k: string]: any;
-    }): Promise<Organization>;
+    organization(organizationData: EntityData): Promise<Organization>;
     /**
      * Creates a new Project instance and optionally retrieves its profile.
-     *
-     * @param {{id?: string, slug?: string, [k: string]: any}} projectData - The data used to initialize the Project instance.
-     * @returns {Promise<Project>} A promise that resolves to the created Project instance.
-     * @throws {Error} If an error occurs during project creation or profile retrieval.
      */
-    project(projectData: {
-        id?: string;
-        slug?: string;
-        [k: string]: any;
-    }): Promise<Project>;
+    project(projectData: EntityData): Promise<Project>;
     /**
      * Creates a new Event instance and optionally retrieves its profile.
-     *
-     * @param {{id?: string, slug?: string, [k: string]: any}} eventData
-     * @returns {Promise<Event>}
-     * @throws {Error}
      */
-    event(eventData: {
-        id?: string;
-        slug?: string;
-        [k: string]: any;
-    }): Promise<Event>;
+    event(eventData: EntityData): Promise<Event>;
     /**
      * Retourne une entité à partir d'un slug.
-     *
-     * @param {string} slug
-     * @returns {Promise<User|Organization|Project|Event|Poi|Badge|News>}
-     * @throws {ApiResponseError|ApiClientError|ApiError}
      */
-    entitySlug(slug: string): Promise<User | Organization | Project | Event | Poi | Badge | News>;
+    entitySlug(slug: string): Promise<EntityTypes>;
     /**
      * Retourne l'instance d'ApiClient.
-     * @returns {ApiClient}
      */
     get client(): ApiClient;
     /**
      * Retourne l'instance d'EndpointApi.
-     * @returns {EndpointApi}
      */
     get endpointApi(): EndpointApi;
     /**
      * Déconnecte l'utilisateur et réinitialise la session.
-     * @returns {void}
      */
     logout(): void;
-    loggedUser: any;
 }
-export type ApiClient = import("./ApiClient.js").default;
-export type ApiClientOptions = import("./ApiClient.js").ApiClientOptions;
-import { User } from "./api/User.js";
-import { Organization } from "./api/Organization.js";
-import { Project } from "./api/Project.js";
-import { Event } from "./api/Event.js";
-import { Poi } from "./api/Poi.js";
-import { Badge } from "./api/Badge.js";
-import { News } from "./api/News.js";
-import EndpointApi from "./api/EndpointApi.js";
-import { UserApi } from "./api/UserApi.js";
+export {};

package/types/Api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Api.d.ts","sourceRoot":"","sources":["../src/Api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,WAAW,MAAM,sBAAsB,CAAC;AAE/C,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAYvD;;GAEG;AACH,KAAK,WAAW,GAAG,IAAI,GAAG,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,GAAG,GAAG,KAAK,GAAG,IAAI,CAAC;AAE9E;;GAEG;AACH,UAAU,UAAU;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,CAAC,OAAO,OAAO,GAAG;IACtB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,OAAO,CAAY;IAE3B;;OAEG;WACU,SAAS,CACpB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,gBAAgB,GAAG,SAAS,GACpC,OAAO,CAAC,GAAG,CAAC;IAKf;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,GAAG,OAAO;IAU9D;;OAEG;WACU,YAAY,CACvB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,GAAG,CAAC;IAiCf;;OAEG;gBACS,UAAU,EAAE,IAAI,GAAG,IAAI,EAAE,MAAM,EAAE,SAAS;IAKtD;;OAEG;IACG,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC;IAQzB;;OAEG;IACG,IAAI,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB/C;;OAEG;IACG,YAAY,CAAC,gBAAgB,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;IAcvE;;OAEG;IACG,OAAO,CAAC,WAAW,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAcxD;;OAEG;IACG,KAAK,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC;IAclD;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA+BpD;;OAEG;IACH,IAAI,MAAM,IAAI,SAAS,CAEtB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,WAAW,CAE7B;IAED;;OAEG;IACH,MAAM,IAAI,IAAI;CAMf"}