@communecter/cocolight-api-client 1.0.200 → 1.0.202

package/types/index.d.ts

@@ -1,5 +1,5 @@
 import { BaseEntity } from "./api/BaseEntity.js";
-import { fromEntityJSON, reviveEntities } from "./api/EntityRegistry.js";
+import { createFromCollection, 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 @@ declare const cocolightApiClient: {
         fromEntityJSON: typeof fromEntityJSON;
         reviveEntities: typeof reviveEntities;
         restorePaginationFromJSON: typeof BaseEntity.restorePaginationFromJSON;
+        createFromCollection: typeof createFromCollection;
     };
     OfflineClientManager: typeof OfflineClientManager;
 };
@@ -44,7 +45,8 @@ export type { default as Api } from "./Api.js";
 export type { default as ApiClient } from "./ApiClient.js";
 export type { default as EndpointApi } from "./api/EndpointApi.js";
 export type { UserApi } from "./api/UserApi.js";
-export type { ApiClientOptions, CallEndpointData, CallEndpointResult, CallEndpointResponse, ApiClientOfflineEnqueueResult } from "./ApiClient.js";
+export type { Discussions, DiscussionDepth, DiscussionAudience, DiscussionMembership, DiscussionCarrierRef, DiscussionCarrierCard, DiscussionCarrier, DiscussionThread, DiscussionSpaceThread, DiscussionsListResponse, DiscussionThreadResponse, DiscussionsResponse, MarkSeenResponse, DiscussionSpaceResponse, CreateDiscussionResponse } from "./api/Discussions.js";
+export type { ApiClientOptions, ApiClientLogger, CallEndpointData, CallEndpointResult, CallEndpointResponse, ApiClientOfflineEnqueueResult } from "./ApiClient.js";
 export type { TokenStorageStrategy } from "./utils/TokenStorage.js";
 export type { MultiServerTokenStorageStrategy } from "./utils/MultiServerTokenStorageStrategy.js";
 export type { default as OfflineClientManager } from "./utils/OfflineClientManager.js";

package/types/utils/logger.d.ts

@@ -0,0 +1,29 @@
+/** Ce que l'ApiClient attend d'un logger : les quatre niveaux, rien d'autre (duck-typing, pino ou non). */
+export interface ApiClientLogger {
+    debug: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+}
+type RootLogger = ApiClientLogger & {
+    child: (bindings: object, options?: {
+        level?: string;
+    }) => ApiClientLogger;
+};
+/** Le logger racine du processus, créé au premier appel. */
+export declare function getRootLogger(): RootLogger;
+/**
+ * Le logger d'UN client. Sans `logger` fourni : un enfant du logger racine au niveau demandé (un enfant
+ * pino ne crée ni thread ni flux : vingt clients coûtent zéro thread). Avec un `logger` fourni : lui-même,
+ * sauf si `debug` est demandé ET qu'il sait faire des enfants (pino) — on lui demande alors un enfant au
+ * niveau `debug`, pour que l'option tienne sa promesse même avec le logger d'un serveur réglé sur `info`.
+ * Un logger sans `child` (console, objet maison) est rendu tel quel : `debug` est alors sans effet.
+ */
+export declare function createClientLogger(debug: boolean, logger?: ApiClientLogger | null): ApiClientLogger;
+/**
+ * Pour les tests : oublie la racine (la prochaine demande en recrée une), après avoir vidé et fermé son
+ * flux — en dev/test la racine porte un transport `pino-pretty` (worker + listener `exit`) qu'on ne
+ * veut pas orpheliner à chaque reset.
+ */
+export declare function _resetRootLoggerForTests(): Promise<void>;
+export {};

package/types/utils/validators.d.ts

@@ -0,0 +1,27 @@
+import type { ValidateFunction } from "ajv";
+export type AjvVariant = "defaults" | "noDefaults";
+/** Fonction de validation AJV. */
+export type Validator = ValidateFunction;
+/** L'instance AJV partagée d'une variante, construite au premier appel. */
+export declare function getAjv(variant: AjvVariant): any;
+/**
+ * Le validateur compilé d'un schéma.
+ * - sans `dynamic` : le schéma est un objet STABLE (contrat, ou nettoyage mémoïsé) → cache par identité,
+ *   illimité mais faible (WeakMap).
+ * - `dynamic: true` : le schéma vient d'être construit (enveloppe costum) → cache borné, indexé par `key`
+ *   (cf. `dynamicKey`) ou, à défaut, par le JSON du schéma entier.
+ */
+export declare function getValidator(schema: object, variant?: AjvVariant, opts?: {
+    dynamic?: boolean;
+    key?: string;
+}): Validator;
+/**
+ * Clé du cache borné pour un schéma recomposé à partir d'un schéma de base STABLE (identité) et d'un
+ * complément VARIABLE (sérialisé) : on ne sérialise que le complément — l'enveloppe costum, quelques
+ * champs — jamais le schéma du contrat entier (plusieurs dizaines de Ko avec ses `$defs`).
+ */
+export declare function dynamicKey(base: object, extra: unknown): string;
+/** Version nettoyée d'un schéma du contrat, la MÊME d'un appel à l'autre pour le même schéma source. */
+export declare function cleanSchemaLeftoverAlias<T>(schema: T): T;
+/** Pour les tests : taille du cache borné d'une variante. */
+export declare function _dynamicCacheSizeForTests(variant: AjvVariant): number;