@communecter/cocolight-api-client 1.0.54 → 1.0.56

package/src/utils/MultiServerFileStorageStrategy.node.js

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

package/src/utils/MultiServerTokenStorageStrategy.js

@@ -1,188 +0,0 @@
-import { TokenStorageStrategy } from "./TokenStorage.js";
-
-/** @typedef {import("./TokenStorage.js").TokenStorageStrategy} TokenStorageStrategy */
-
-/**
- * Stratégie de stockage multi-serveurs (abstraite).
- * Permet de sélectionner un `baseURL` courant via `use()` puis d'opérer get/set/clear dessus.
- * @abstract
- * @extends TokenStorageStrategy
- */
-export class MultiServerTokenStorageStrategy extends TokenStorageStrategy {
-  constructor() {
-    super();
-    /** @type {string|null} */
-    this._currentBaseURL = null;
-  }
-
-  /**
-   * Sélectionne le serveur courant (normalise en supprimant les `/` finaux).
-   * @param {string} baseURL
-   * @returns {void}
-   */
-  use(baseURL) {
-    if (!baseURL) throw new Error("baseURL est requis");
-    this._currentBaseURL = baseURL.replace(/\/+$/, "");
-  }
-
-  /** @private */
-  _ensureContext() {
-    if (!this._currentBaseURL) throw new Error("baseURL non défini. Appelez use(baseURL)");
-  }
-
-  /**
-   * Retourne la liste des serveurs connus.
-   * @abstract
-   * @returns {string[]}
-   */
-  getServers() {
-    throw new Error("getServers() doit être implémenté");
-  }
-
-  /**
-   * Exporte toutes les données stockées (par baseURL).
-   * @abstract
-   * @returns {Record<string, {accessToken?: string|null, refreshToken?: string|null}>}
-   */
-  exportAll() {
-    throw new Error("exportAll() doit être implémenté");
-  }
-}
-
-/**
- * Stockage en mémoire (multi-serveurs).
- * @implements {MultiServerTokenStorageStrategy}
- */
-export class MultiServerMemoryStorageStrategy extends MultiServerTokenStorageStrategy {
-  constructor() {
-    super();
-    /** @type {Map<string, {accessToken?: string|null, refreshToken?: string|null}>} */
-    this._storage = new Map();
-  }
-
-  /** @returns {string|null} */
-  getAccessToken() {
-    this._ensureContext();
-    return this._storage.get(this._currentBaseURL)?.accessToken ?? null;
-  }
-
-  /** @param {string|null} token */
-  setAccessToken(token) {
-    this._ensureContext();
-    const current = this._storage.get(this._currentBaseURL) || {};
-    this._storage.set(this._currentBaseURL, { ...current, accessToken: token });
-  }
-
-  /** @returns {string|null} */
-  getRefreshToken() {
-    this._ensureContext();
-    return this._storage.get(this._currentBaseURL)?.refreshToken ?? null;
-  }
-
-  /** @param {string|null} token */
-  setRefreshToken(token) {
-    this._ensureContext();
-    const current = this._storage.get(this._currentBaseURL) || {};
-    this._storage.set(this._currentBaseURL, { ...current, refreshToken: token });
-  }
-
-  /** @returns {void} */
-  clear() {
-    this._ensureContext();
-    this._storage.delete(this._currentBaseURL);
-  }
-
-  /** @returns {string[]} */
-  getServers() {
-    return [...this._storage.keys()];
-  }
-
-  /** @returns {Record<string, {accessToken?: string|null, refreshToken?: string|null}>} */
-  exportAll() {
-    return Object.fromEntries(this._storage.entries());
-  }
-}
-
-/**
- * Stockage navigateur (localStorage) multi-serveurs.
- * @implements {MultiServerTokenStorageStrategy}
- */
-export class MultiServerLocalStorageStrategy extends MultiServerTokenStorageStrategy {
-  /**
-   * @param {string} [prefix="cocolight"]
-   */
-  constructor(prefix = "cocolight") {
-    super();
-    /** @type {string} */
-    this.prefix = prefix;
-  }
-
-  /** @private */
-  _key(baseURL) {
-    return `${this.prefix}_tokens_${baseURL}`;
-  }
-
-  /** @private */
-  _getData() {
-    this._ensureContext();
-    if (typeof localStorage === "undefined") return {};
-    const raw = localStorage.getItem(this._key(this._currentBaseURL));
-    return raw ? JSON.parse(raw) : {};
-  }
-
-  /** @private */
-  _setData(data) {
-    if (typeof localStorage === "undefined") return;
-    localStorage.setItem(this._key(this._currentBaseURL), JSON.stringify(data));
-  }
-
-  /** @returns {string|null} */
-  getAccessToken() {
-    return this._getData().accessToken ?? null;
-  }
-
-  /** @param {string|null} token */
-  setAccessToken(token) {
-    const data = this._getData();
-    data.accessToken = token;
-    this._setData(data);
-  }
-
-  /** @returns {string|null} */
-  getRefreshToken() {
-    return this._getData().refreshToken ?? null;
-  }
-
-  /** @param {string|null} token */
-  setRefreshToken(token) {
-    const data = this._getData();
-    data.refreshToken = token;
-    this._setData(data);
-  }
-
-  /** @returns {void} */
-  clear() {
-    if (typeof localStorage === "undefined") return;
-    localStorage.removeItem(this._key(this._currentBaseURL));
-  }
-
-  /** @returns {string[]} */
-  getServers() {
-    if (typeof localStorage === "undefined") return [];
-    const keys = Object.keys(localStorage);
-    return keys
-      .filter(k => k.startsWith(`${this.prefix}_tokens_`))
-      .map(k => k.replace(`${this.prefix}_tokens_`, ""));
-  }
-
-  /** @returns {Record<string, {accessToken?: string|null, refreshToken?: string|null}>} */
-  exportAll() {
-    const result = {};
-    for (const baseURL of this.getServers()) {
-      const key = this._key(baseURL);
-      const raw = typeof localStorage !== "undefined" ? localStorage.getItem(key) : null;
-      if (raw) result[baseURL] = JSON.parse(raw);
-    }
-    return result;
-  }
-}

package/src/utils/OfflineQueueStorageStrategy.js

@@ -1,51 +0,0 @@
-// OfflineQueueStorageStrategy.js
-
-export class OfflineQueueStorageStrategy {
-  async loadQueue() {
-    throw new Error("loadQueue() doit être implémenté");
-  }
-  
-  // eslint-disable-next-line no-unused-vars
-  async saveQueue(queue) {
-    throw new Error("saveQueue(queue) doit être implémenté");
-  }
-}
-  
-export class MemoryOfflineStorage extends OfflineQueueStorageStrategy {
-  constructor() {
-    super();
-    this._queue = [];
-  }
-  
-  async loadQueue() {
-    return this._queue;
-  }
-  
-  async saveQueue(queue) {
-    this._queue = [...queue];
-  }
-}
-  
-export class LocalStorageOfflineStorage extends OfflineQueueStorageStrategy {
-  constructor(key = "cocolight-api-offline-queue") {
-    super();
-    this.key = key;
-  }
-  
-  async loadQueue() {
-    try {
-      const raw = localStorage.getItem(this.key);
-      return raw ? JSON.parse(raw) : [];
-    } catch {
-      return [];
-    }
-  }
-  
-  async saveQueue(queue) {
-    try {
-      localStorage.setItem(this.key, JSON.stringify(queue));
-    } catch (e) {
-      console.warn("[Offline] Échec du stockage localStorage", e);
-    }
-  }
-}

package/src/utils/TokenStorage.js

@@ -1,153 +0,0 @@
-/**
- * Stratégie abstraite de stockage des tokens d'accès et de rafraîchissement.
- * 
- * @interface
- */
-export class TokenStorageStrategy {
-  /**
-   * Récupère le token d'accès actuellement stocké.
-   * 
-   * @abstract
-   * @returns {string|null} Le token d'accès, ou `null` si non défini.
-   */
-  getAccessToken() {
-    throw new Error("getAccessToken() doit être implémenté");
-  }
-
-  /**
-   * Définit le token d'accès.
-   * 
-   * @abstract
-   * @param {string} token - Le token d'accès à stocker.
-   * @returns {void}
-   */
-  // eslint-disable-next-line no-unused-vars
-  setAccessToken(token) {
-    throw new Error("setAccessToken() doit être implémenté");
-  }
-
-  /**
-   * Récupère le token de rafraîchissement actuellement stocké.
-   * 
-   * @abstract
-   * @returns {string|null} Le token de rafraîchissement, ou `null` si non défini.
-   */
-  getRefreshToken() {
-    throw new Error("getRefreshToken() doit être implémenté");
-  }
-
-  /**
-   * Définit le token de rafraîchissement.
-   * 
-   * @abstract
-   * @param {string} token - Le token de rafraîchissement à stocker.
-   * @returns {void}
-   */
-  // eslint-disable-next-line no-unused-vars
-  setRefreshToken(token) {
-    throw new Error("setRefreshToken() doit être implémenté");
-  }
-
-  /**
-   * Supprime les tokens stockés.
-   * 
-   * @abstract
-   * @returns {void}
-   */
-  clear() {
-    throw new Error("clear() doit être implémenté");
-  }
-}
-
-/**
- * Stratégie de stockage des tokens uniquement en mémoire (volatile).
- * 
- * @implements {TokenStorageStrategy}
- */
-export class MemoryStorageStrategy extends TokenStorageStrategy {
-  constructor() {
-    super();
-    /** @type {string|null} */
-    this._accessToken = null;
-    /** @type {string|null} */
-    this._refreshToken = null;
-  }
-
-  /** @inheritdoc */
-  getAccessToken() {
-    return this._accessToken;
-  }
-
-  /** @inheritdoc */
-  setAccessToken(token) {
-    this._accessToken = token;
-  }
-
-  /** @inheritdoc */
-  getRefreshToken() {
-    return this._refreshToken;
-  }
-
-  /** @inheritdoc */
-  setRefreshToken(token) {
-    this._refreshToken = token;
-  }
-
-  /** @inheritdoc */
-  clear() {
-    this._accessToken = null;
-    this._refreshToken = null;
-  }
-}
-
-/**
- * Stratégie de stockage des tokens via `localStorage` (persistance navigateur).
- * 
- * @implements {TokenStorageStrategy}
- */
-export class LocalStorageStrategy extends TokenStorageStrategy {
-  /**
-   * @param {string} [prefix="cocolight"] - Préfixe utilisé pour les clés dans `localStorage`.
-   */
-  constructor(prefix = "cocolight") {
-    super();
-    /** @type {string} */
-    this.prefix = prefix;
-  }
-
-  /** @inheritdoc */
-  getAccessToken() {
-    return typeof localStorage !== "undefined"
-      ? localStorage.getItem(`${this.prefix}_accessToken`)
-      : null;
-  }
-
-  /** @inheritdoc */
-  setAccessToken(token) {
-    if (typeof localStorage !== "undefined") {
-      localStorage.setItem(`${this.prefix}_accessToken`, token);
-    }
-  }
-
-  /** @inheritdoc */
-  getRefreshToken() {
-    return typeof localStorage !== "undefined"
-      ? localStorage.getItem(`${this.prefix}_refreshToken`)
-      : null;
-  }
-
-  /** @inheritdoc */
-  setRefreshToken(token) {
-    if (typeof localStorage !== "undefined") {
-      localStorage.setItem(`${this.prefix}_refreshToken`, token);
-    }
-  }
-
-  /** @inheritdoc */
-  clear() {
-    if (typeof localStorage !== "undefined") {
-      localStorage.removeItem(`${this.prefix}_accessToken`);
-      localStorage.removeItem(`${this.prefix}_refreshToken`);
-    }
-  }
-}

package/src/utils/createDefaultMultiServerTokenStorageStrategy.js

@@ -1,51 +0,0 @@
-import {
-  MultiServerMemoryStorageStrategy,
-  MultiServerLocalStorageStrategy,
-} from "./MultiServerTokenStorageStrategy.js";
-
-/** @typedef {import("./MultiServerTokenStorageStrategy.js").MultiServerTokenStorageStrategy} MultiServerTokenStorageStrategy */
-/** @typedef {import("./MultiServerFileStorageStrategy.node.js").MultiServerFileStorageStrategy} MultiServerFileStorageStrategy */
-
-/**
- * Crée une stratégie multi-serveurs adaptée à l’environnement.
- *
- * @param {'memory'|'localStorage'|'file'|'auto'} [strategyType="auto"]
- * @returns {Promise<MultiServerTokenStorageStrategy>}
- */
-export async function createDefaultMultiServerTokenStorageStrategy(strategyType = "auto") {
-  if (strategyType === "memory") {
-    /** @type {MultiServerTokenStorageStrategy} */
-    const s = new MultiServerMemoryStorageStrategy();
-    return s;
-  }
-
-  if (strategyType === "localStorage") {
-    if (typeof window !== "undefined" && typeof window.localStorage !== "undefined") {
-      /** @type {MultiServerTokenStorageStrategy} */
-      const s = new MultiServerLocalStorageStrategy();
-      return s;
-    }
-    throw new Error("localStorage n’est pas disponible dans cet environnement.");
-  }
-
-  if (strategyType === "file") {
-    if (typeof window !== "undefined" && typeof window.localStorage !== "undefined") {
-      throw new Error("Le stockage fichier n’est pas disponible côté navigateur.");
-    }
-    const { MultiServerFileStorageStrategy } = await import("./MultiServerFileStorageStrategy.node.js");
-    /** @type {MultiServerTokenStorageStrategy} */
-    const s = new MultiServerFileStorageStrategy();
-    return s;
-  }
-
-  // auto
-  if (typeof window !== "undefined" && typeof window.localStorage !== "undefined") {
-    /** @type {MultiServerTokenStorageStrategy} */
-    const s = new MultiServerLocalStorageStrategy();
-    return s;
-  }
-  const { MultiServerFileStorageStrategy } = await import("./MultiServerFileStorageStrategy.node.js");
-  /** @type {MultiServerTokenStorageStrategy} */
-  const s = new MultiServerFileStorageStrategy();
-  return s;
-}

package/src/utils/createDefaultTokenStorageStrategy.js

@@ -1,49 +0,0 @@
-import { LocalStorageStrategy, MemoryStorageStrategy } from "./TokenStorage.js";
-
-/** @typedef {import("./TokenStorage.js").TokenStorageStrategy} TokenStorageStrategy */
-/** @typedef {import("./FileStorageStrategy.node.js").FileStorageStrategy} FileStorageStrategy */
-
-/**
- * Crée une stratégie de stockage de jetons par défaut en fonction de l'option fournie.
- *
- * @param {'memory'|'localStorage'|'file'|'auto'} [tokenStorageStrategy='auto'] - Stratégie souhaitée.
- * @returns {Promise<TokenStorageStrategy>} Une promesse résolue avec la stratégie sélectionnée.
- * @throws {Error} Lève une erreur si la stratégie choisie n'est pas disponible.
- */
-export async function createDefaultTokenStorageStrategy(tokenStorageStrategy = "auto") {
-  if (tokenStorageStrategy === "memory") {
-    /** @type {TokenStorageStrategy} */
-    const storage = new MemoryStorageStrategy();
-    return storage;
-  }
-
-  if (tokenStorageStrategy === "localStorage") {
-    if (typeof window !== "undefined" && window.localStorage) {
-      /** @type {TokenStorageStrategy} */
-      const storage = new LocalStorageStrategy();
-      return storage;
-    }
-    throw new Error("localStorage is not available in this environment.");
-  }
-
-  if (tokenStorageStrategy === "file") {
-    if (typeof window !== "undefined" && window.localStorage) {
-      throw new Error("file storage is not available in this environment.");
-    }
-    const { FileStorageStrategy } = await import("./FileStorageStrategy.node.js");
-    /** @type {TokenStorageStrategy} */
-    const storage = new FileStorageStrategy();
-    return storage;
-  }
-
-  // 'auto'
-  if (typeof window !== "undefined" && window.localStorage) {
-    /** @type {TokenStorageStrategy} */
-    const storage = new LocalStorageStrategy();
-    return storage;
-  }
-  const { FileStorageStrategy } = await import("./FileStorageStrategy.node.js");
-  /** @type {TokenStorageStrategy} */
-  const storage = new FileStorageStrategy();
-  return storage;
-}

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

@@ -1,10 +0,0 @@
-// utils/stream-utils.node.js
-export async function bufferToReadable(buffer) {
-  const { Readable } = await import("stream");
-  return Readable.from(buffer);
-}
-  
-export async function createPassThrough() {
-  const { PassThrough } = await import("stream");
-  return new PassThrough();
-}