@communecter/cocolight-api-client 1.0.155 → 1.0.156

package/src/types/error-guards.ts

@@ -1,230 +0,0 @@
-// types/error-guards.ts - Type guards et utilitaires pour la gestion d'erreurs
-
-import { ApiError, ApiClientError, ApiResponseError, ApiValidationError, ApiAuthenticationError, CircuitBreakerError } from "../error.js";
-
-import type { ApiErrorDetails, HttpStatusCode } from "./api-responses.js";
-
-/**
- * Type guard pour vérifier si une valeur est une Error
- */
-export function isError(value: unknown): value is Error {
-  return value instanceof Error;
-}
-
-/**
- * Type guard pour vérifier si une valeur est une ApiError
- */
-export function isApiError(value: unknown): value is ApiError {
-  return value instanceof ApiError;
-}
-
-/**
- * Type guard pour vérifier si une valeur est une ApiClientError
- */
-export function isApiClientError(value: unknown): value is ApiClientError {
-  return value instanceof ApiClientError;
-}
-
-/**
- * Type guard pour vérifier si une valeur est une ApiResponseError
- */
-export function isApiResponseError(value: unknown): value is ApiResponseError {
-  return value instanceof ApiResponseError;
-}
-
-/**
- * Type guard pour vérifier si une valeur est une ApiValidationError
- */
-export function isApiValidationError(value: unknown): value is ApiValidationError {
-  return value instanceof ApiValidationError;
-}
-
-/**
- * Type guard pour vérifier si une valeur est une ApiAuthenticationError
- */
-export function isApiAuthenticationError(value: unknown): value is ApiAuthenticationError {
-  return value instanceof ApiAuthenticationError;
-}
-
-/**
- * Type guard pour vérifier si une valeur est une CircuitBreakerError
- */
-export function isCircuitBreakerError(value: unknown): value is CircuitBreakerError {
-  return value instanceof CircuitBreakerError;
-}
-
-/**
- * Type guard pour vérifier si une erreur a une propriété response (erreurs axios)
- */
-export function hasResponse(error: unknown): error is Error & { response: { status: number; data: any } } {
-  return isError(error) && "response" in error &&
-         typeof (error as any).response === "object" &&
-         typeof (error as any).response.status === "number";
-}
-
-/**
- * Type guard pour vérifier si une erreur a un code de statut HTTP
- */
-export function hasStatusCode(error: unknown): error is Error & { status: HttpStatusCode } {
-  return isError(error) && "status" in error &&
-         typeof (error as any).status === "number";
-}
-
-/**
- * Utilitaire pour extraire le message d'erreur de façon type-safe
- */
-export function getErrorMessage(error: unknown): string {
-  if (isError(error)) {
-    return error.message;
-  }
-  if (typeof error === "string") {
-    return error;
-  }
-  if (error && typeof error === "object" && "message" in error) {
-    return String((error as any).message);
-  }
-  return "Unknown error";
-}
-
-/**
- * Utilitaire pour extraire le code de statut d'une erreur
- */
-export function getErrorStatusCode(error: unknown): HttpStatusCode | undefined {
-  if (hasStatusCode(error)) {
-    return error.status as HttpStatusCode;
-  }
-  if (hasResponse(error)) {
-    return error.response.status as HttpStatusCode;
-  }
-  if (isApiError(error)) {
-    return error.status as HttpStatusCode;
-  }
-  return undefined;
-}
-
-/**
- * Utilitaire pour extraire les détails d'erreur de façon type-safe
- */
-export function getErrorDetails(error: unknown): ApiErrorDetails | undefined {
-  if (isApiError(error)) {
-    return {
-      code: error.status as HttpStatusCode,
-      message: error.message,
-      details: (error as any).responseData
-    };
-  }
-
-  if (hasResponse(error)) {
-    return {
-      code: error.response.status as HttpStatusCode,
-      message: getErrorMessage(error),
-      details: error.response.data
-    };
-  }
-
-  const status = getErrorStatusCode(error);
-  if (status) {
-    return {
-      code: status,
-      message: getErrorMessage(error)
-    };
-  }
-
-  return undefined;
-}
-
-/**
- * Utilitaire pour créer une erreur typée
- */
-export function createTypedError(message: string, status: HttpStatusCode = 500, details?: any): ApiError {
-  return new ApiError(message, status, details);
-}
-
-/**
- * Wrapper pour les fonctions qui peuvent lever des erreurs
- */
-export async function safeCall<T>(
-  fn: () => Promise<T>,
-  fallback?: T
-): Promise<{ data: T; error: null } | { data: T | undefined; error: ApiErrorDetails }> {
-  try {
-    const data = await fn();
-    return { data, error: null };
-  } catch (error) {
-    const errorDetails = getErrorDetails(error);
-    return {
-      data: fallback,
-      error: errorDetails || {
-        code: 500,
-        message: getErrorMessage(error)
-      }
-    };
-  }
-}
-
-/**
- * Type pour les résultats d'opérations sécurisées
- */
-export type SafeResult<T> =
-  | { success: true; data: T; error: null }
-  | { success: false; data: undefined; error: ApiErrorDetails };
-
-/**
- * Version améliorée de safeCall avec indicateur de succès
- */
-export async function trySafe<T>(fn: () => Promise<T>): Promise<SafeResult<T>> {
-  try {
-    const data = await fn();
-    return { success: true, data, error: null };
-  } catch (error) {
-    const errorDetails = getErrorDetails(error);
-    return {
-      success: false,
-      data: undefined,
-      error: errorDetails || {
-        code: 500,
-        message: getErrorMessage(error)
-      }
-    };
-  }
-}
-
-/**
- * Utilitaire pour valider et normaliser les erreurs
- */
-export function normalizeError(error: unknown): ApiError {
-  if (isApiError(error)) {
-    return error;
-  }
-
-  const message = getErrorMessage(error);
-  const status = getErrorStatusCode(error) || 500;
-  const details = hasResponse(error) ? error.response.data : undefined;
-
-  return new ApiError(message, status, details);
-}
-
-/**
- * Type helper pour les fonctions qui peuvent lever des erreurs typées
- */
-export type ErrorProne<T> = () => Promise<T> | T;
-
-/**
- * Décorateur de méthode pour capturer et normaliser les erreurs
- */
-export function catchErrors<T extends any[], R>(
-  target: any,
-  propertyName: string,
-  descriptor: TypedPropertyDescriptor<(...args: T) => Promise<R>>
-) {
-  const method = descriptor.value;
-  if (!method) return;
-
-  descriptor.value = async function (...args: T): Promise<R> {
-    try {
-      return await method.apply(this, args);
-    } catch (error) {
-      throw normalizeError(error);
-    }
-  };
-}

package/src/types/index.ts

@@ -1,41 +0,0 @@
-// types/index.ts - Point d'entrée central pour tous les types partagés
-
-// Entity types
-export type {
-  CollectionKey,
-  EntityTag
-} from "../api/EntityRegistry.js";
-
-export type {
-  EntityTypes,
-  SearchEntity,
-  TransformsMap,
-  TransformFunction,
-} from "./entities.js";
-
-// Payload types
-export type {
-  SocialNetworkPayload,
-} from "./payloads.js";
-
-// Transform types
-export type {
-  UserTransforms,
-  OrganizationTransforms,
-  ProjectTransforms,
-  EventTransforms
-} from "./transforms.js";
-
-// API Response types
-export type {
-  BaseApiResponse,
-  ApiDataResponse,
-  ApiErrorResponse,
-  PaginatedApiResponse,
-  GetElementsKeyResponse,
-  ApiResponse
-} from "./api-responses.js";
-
-// API Error types
-export type { ApiErrorDetails } from "./api-responses.js";
-export type { GenericErrorDetails } from "../error.js";

package/src/types/payloads.ts

@@ -1,21 +0,0 @@
-// types/payloads.ts - Types pour les payloads des méthodes _add et _update
- 
-
-/**
- * Types pour les réseaux sociaux
- */
-export interface SocialNetworkPayload {
-  github?: string;
-  gitlab?: string;
-  facebook?: string;
-  twitter?: string;
-  instagram?: string;
-  linkedIn?: string;
-  youtube?: string;
-  website?: string;
-  diaspora?: string;
-  mastodon?: string;
-  telegram?: string;
-  signal?: string;
-}
-

package/src/types/transforms.ts

@@ -1,119 +0,0 @@
-// types/transforms.ts - Types spécialisés pour les transformations par entité
-/* eslint-disable @typescript-eslint/no-empty-object-type */
-
-import type { TransformFunction, EntityRefsMap } from "./entities.js";
-import type { SocialNetworkPayload } from "./payloads.js";
-
-/**
- * Types pour les données d'entrée des transforms
- */
-export interface ParentData {
-  [key: string]: {
-    type?: string;
-    name?: string;
-    id?: string;
-    slug?: string;
-    _id?: any;
-  };
-}
-
-export interface OrganizerData {
-  [key: string]: {
-    type?: string;
-    name?: string;
-    id?: string;
-    slug?: string;
-    _id?: any;
-  };
-}
-
-// Alias pour SocialNetworkPayload depuis payloads.ts (évite la duplication)
-export type SocialNetworkData = SocialNetworkPayload;
-
-/**
- * Types pour les transforms spécifiques aux événements
- */
-export interface EventTransforms {
-  parent: TransformFunction<ParentData | null, EntityRefsMap>;
-  organizer: TransformFunction<OrganizerData | null, EntityRefsMap>;
-  [key: string]: TransformFunction<any, any> | undefined;
-}
-
-/**
- * Types pour les transforms spécifiques aux utilisateurs/organisations/projets (réseaux sociaux)
- */
-export interface SocialTransforms {
-  github: TransformFunction<any, string | undefined>;
-  gitlab: TransformFunction<any, string | undefined>;
-  facebook: TransformFunction<any, string | undefined>;
-  twitter: TransformFunction<any, string | undefined>;
-  instagram: TransformFunction<any, string | undefined>;
-  linkedIn?: TransformFunction<any, string | undefined>;
-  youtube?: TransformFunction<any, string | undefined>;
-  website?: TransformFunction<any, string | undefined>;
-  diaspora?: TransformFunction<any, string | undefined>;
-  mastodon?: TransformFunction<any, string | undefined>;
-  telegram?: TransformFunction<any, string | undefined>;
-  signal?: TransformFunction<any, string | undefined>;
-  [key: string]: TransformFunction<any, any> | undefined;
-}
-
-/**
- * Types pour les transforms des utilisateurs
- */
-export interface UserTransforms extends SocialTransforms {
-  // Ajouter d'autres transforms spécifiques aux utilisateurs si nécessaire
-}
-
-/**
- * Types pour les transforms des organisations
- */
-export interface OrganizationTransforms extends SocialTransforms {
-  // Ajouter d'autres transforms spécifiques aux organisations si nécessaire
-}
-
-/**
- * Types pour les transforms des projets
- */
-export interface ProjectTransforms extends SocialTransforms {
-  parent: TransformFunction<ParentData | null, EntityRefsMap>;
-}
-
-/**
- * Union de tous les types de transforms
- */
-export type EntityTransforms = EventTransforms | UserTransforms | OrganizationTransforms | ProjectTransforms;
-
-/**
- * Fonction helper pour créer des transforms d'entité avec type safety
- */
-export function createEntityRef(type: string, name?: string, id?: string, slug?: string, _id?: any) {
-  return { type, name, id, slug, _id };
-}
-
-/**
- * Fonction helper pour transformer les données parent/organizer
- */
-export function transformEntityRefs(val: ParentData | OrganizerData | null): EntityRefsMap {
-  if (!val || typeof val !== "object") return {};
-
-  return Object.fromEntries(
-    Object.entries(val).map(([key, obj]) => [
-      key,
-      {
-        type: obj?.type ?? "",
-        name: obj?.name,
-        // id: obj?.id,
-        // slug: obj?.slug
-        // _id exclu volontairement
-      }
-    ])
-  );
-}
-
-/**
- * Fonction helper pour extraire les données de réseaux sociaux
- */
-export function createSocialTransform(field: keyof SocialNetworkData): TransformFunction<any, string | undefined> {
-  return (_val: any, full?: any) => full?.socialNetwork?.[field];
-}

package/src/utils/FileOfflineStorageStrategy.node.ts

@@ -1,50 +0,0 @@
-import * as fs from "fs";
-import * as os from "os";
-import * as path from "path";
-
-import { OfflineQueueStorageStrategy } from "./OfflineQueueStorageStrategy.js";
-
-export class FileOfflineStorage<T = any> extends OfflineQueueStorageStrategy<T> {
-  public readonly dir: string;
-  public readonly filePath: string;
-
-  constructor(filename: string = "offline-queue.json", dir: string = path.join(os.homedir(), ".config", "cocolight")) {
-    super();
-    this.dir = dir;
-    this.filePath = path.join(dir, filename);
-    this._ensureDirectoryExists();
-  }
-
-  private _ensureDirectoryExists(): void {
-    if (!fs.existsSync(this.dir)) {
-      fs.mkdirSync(this.dir, { recursive: true });
-    }
-  }
-
-  private _readFile(): T[] {
-    if (!fs.existsSync(this.filePath)) return [];
-    try {
-      const json: T[] = JSON.parse(fs.readFileSync(this.filePath, "utf8"));
-      return json;
-    } catch (e) {
-      console.error("Erreur lecture offline queue :", e);
-      return [];
-    }
-  }
-
-  private _writeFile(queue: T[]): void {
-    try {
-      fs.writeFileSync(this.filePath, JSON.stringify(queue, null, 2), "utf8");
-    } catch (e) {
-      console.warn("[OfflineQueue] Erreur d'écriture:", e);
-    }
-  }
-
-  async loadQueue(): Promise<T[]> {
-    return this._readFile();
-  }
-
-  async saveQueue(queue: T[]): Promise<void> {
-    this._writeFile(queue);
-  }
-}

package/src/utils/FileStorageStrategy.node.ts

@@ -1,63 +0,0 @@
-
-import * as fs from "fs";
-import * as os from "os";
-import * as path from "path";
-
-import { TokenStorageStrategy } from "./TokenStorage.js";
-
-export class FileStorageStrategy extends TokenStorageStrategy {
-  public readonly dir: string;
-  public readonly filePath: string;
-
-  constructor(filename: string = "tokens.json", dir: string = path.join(os.homedir(), ".config", "cocolight")) {
-    super();
-    this.dir = dir;
-    this.filePath = path.join(dir, filename);
-    this._ensureDirectoryExists();
-  }
-
-  private _ensureDirectoryExists(): void {
-    if (!fs.existsSync(this.dir)) {
-      fs.mkdirSync(this.dir, { recursive: true });
-    }
-  }
-
-  private _readFile(): any {
-    if (!fs.existsSync(this.filePath)) return {};
-    try {
-      return JSON.parse(fs.readFileSync(this.filePath, "utf8"));
-    } catch (e) {
-       
-      console.error("Error reading token file:", e);
-      return {};
-    }
-  }
-
-  private _writeFile(data: Record<string, any>): void {
-    fs.writeFileSync(this.filePath, JSON.stringify(data, null, 2), "utf8");
-  }
-
-  getAccessToken(): string | null {
-    return this._readFile().accessToken || null;
-  }
-
-  setAccessToken(token: string | null): void {
-    const data = this._readFile();
-    data.accessToken = token;
-    this._writeFile(data);
-  }
-
-  getRefreshToken(): string | null {
-    return this._readFile().refreshToken || null;
-  }
-
-  setRefreshToken(token: string | null): void {
-    const data = this._readFile();
-    data.refreshToken = token;
-    this._writeFile(data);
-  }
-
-  clear(): void {
-    this._writeFile({});
-  }
-}

package/src/utils/MultiServerFileStorageStrategy.node.ts

@@ -1,67 +0,0 @@
-import * as fs from "fs";
-import * as os from "os";
-import * as path from "path";
-
-import { MultiServerTokenStorageStrategy } from "./MultiServerTokenStorageStrategy.js";
-
-export class MultiServerFileStorageStrategy extends MultiServerTokenStorageStrategy {
-  public readonly filePath: string;
-
-  constructor(filename: string = "tokens.json", dir: string = path.join(os.homedir(), ".config", "cocolight")) {
-    super();
-    this.filePath = path.join(dir, filename);
-    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-  }
-
-  private _readFile(): any {
-    if (!fs.existsSync(this.filePath)) return {};
-    try {
-      return JSON.parse(fs.readFileSync(this.filePath, "utf8"));
-    } catch {
-      return {};
-    }
-  }
-
-  private _writeFile(data: Record<string, { accessToken?: string | null; refreshToken?: string | null }>): void {
-    fs.writeFileSync(this.filePath, JSON.stringify(data, null, 2), "utf8");
-  }
-
-  getAccessToken(): string | null {
-    const base = this._requireBaseURL();
-    return this._readFile()[base]?.accessToken ?? null;
-  }
-
-  setAccessToken(token: string | null): void {
-    const base = this._requireBaseURL();
-    const all = this._readFile();
-    all[base] = { ...(all[base] || {}), accessToken: token };
-    this._writeFile(all);
-  }
-
-  getRefreshToken(): string | null {
-    const base = this._requireBaseURL();
-    return this._readFile()[base]?.refreshToken ?? null;
-  }
-
-  setRefreshToken(token: string | null): void {
-    const base = this._requireBaseURL();
-    const all = this._readFile();
-    all[base] = { ...(all[base] || {}), refreshToken: token };
-    this._writeFile(all);
-  }
-
-  clear(): void {
-    const base = this._requireBaseURL();
-    const all = this._readFile();
-    delete all[base];
-    this._writeFile(all);
-  }
-
-  getServers(): string[] {
-    return Object.keys(this._readFile());
-  }
-
-  exportAll(): Record<string, { accessToken?: string | null; refreshToken?: string | null }> {
-    return this._readFile();
-  }
-}