@supersoniks/concorde 4.9.95 → 4.9.97-visual-stack.0

package/dist/types/core/utils/PublisherProxy.d.ts

@@ -0,0 +1,230 @@
+/**
+ * !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+ * Merci de laisser ce fichier sans la moindre dépendance en dehors de types du ceur.
+ * !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+ * **/
+import type { PublisherInterface, CoreJSType, PublisherContentType } from "../_types/types";
+import type { DataProviderKey } from "./dataProviderKey";
+export type Observable = string;
+type DynamicFillingListener = any;
+type TemplateFillingListener = {
+    propertyMap: Record<string, string>;
+} & DynamicFillingListener;
+type PublisherProxyOptions = {
+    localStorageMode?: string;
+    expirationDelayMs?: number;
+    invalidateOnPageShow?: boolean;
+};
+/** Options de `dp()` / `dataProvider()` — même surface que `PublisherManager.get()`. */
+export type DpOptions = PublisherProxyOptions;
+export declare const prefix: string;
+/**
+ * Custom Proxy contient les méthodes des publishers retournés par PublisherManager.get(publisherId) qui seront utilisées couramment
+ */
+export declare class PublisherProxy<T = any> {
+    static instances: Map<number, PublisherProxy<any>>;
+    static instancesCounter: number;
+    _proxies_: Map<string, PublisherProxy>;
+    _value_: T;
+    _is_savable_: boolean;
+    _expiration_delay_: number;
+    _invalidate_on_page_show_: boolean;
+    _invalidateListeners_: Set<VoidFunction>;
+    _formInvalidateListeners_: Set<VoidFunction>;
+    _assignListeners_: Set<(value: T) => void>;
+    _mutationListeners_: Set<VoidFunction>;
+    _fillListeners_: Set<Record<string, CoreJSType>>;
+    _templateFillListeners_: Set<any>;
+    _lockInternalMutationPublishing_: boolean;
+    _instanceCounter_: number;
+    parent: PublisherProxy | null;
+    _parentKey_?: string;
+    root: PublisherProxy;
+    constructor(target: T, parentProxPub: PublisherProxy | null, parentKey?: string);
+    /**
+     * Supprime le proxy et ses sous proxy
+     * Supprime les écouteurs associés
+     */
+    delete(): void;
+    /**
+     * Utile pour savoir si quelque chose est en écoute d'une modification sur le proxy via une des methodes associées
+     */
+    hasListener(): boolean;
+    _assignmentId_: number;
+    _publishInternalMutation_(lockInternalMutationsTransmission?: boolean): void;
+    _publishAssignement_(lockInternalMutationsTransmission?: boolean): Promise<void>;
+    _publishInvalidation_(): void;
+    _publishFormInvalidation_(): void;
+    _publishDynamicFilling_(key: string, value: CoreJSType): void;
+    _publishTemplateFilling_(key: string, value: CoreJSType): void;
+    /**
+     * Appel la fonction "handler" (passée en paramettre) lorsque la valeur gérée par le proxy change par assignation
+     * hanlder reçois alors la nouvelle valeur interne du proxy en paramètre
+     */
+    onAssign(handler: (value: T) => void, directHandlerCall?: boolean): void;
+    /**
+     * Stop les appels de la fonction "handler" (passée en paramettre) lorsque la valeur gérée par le proxy change par assignation
+     */
+    offAssign(handler: (value: T) => void): void;
+    /**
+     * Appel la fonction "handler" (passée en paramettre) lorsque la donnée est flaggée comme invalide
+     */
+    onInvalidate(handler: VoidFunction | undefined): void;
+    /**
+     * Stop les appels de la fonction "handler" (passée en paramettre) lorsque la donnée est flaggée comme invalide
+     */
+    offInvalidate(handler: VoidFunction | undefined): void;
+    /**
+     * Flag les données comme étant invalides
+     */
+    invalidate(): void;
+    /**
+     * Appel la fonction "handler" (passée en paramettre) lorsque la donnée est flaggée comme invalide
+     */
+    onFormInvalidate(handler: VoidFunction | undefined): void;
+    /**
+     * Stop les appels de la fonction "handler" (passée en paramettre) lorsque la donnée est flaggée comme invalide
+     */
+    offFormInvalidate(handler: VoidFunction | undefined): void;
+    invalidateForm(): void;
+    /**
+     * Appel la fonction "handler" (passée en paramettre) lorsque quelque chose change la valeur gérée par le proxy quelque soit la profondeur de la donnée
+     *
+     */
+    onInternalMutation(handler: VoidFunction | undefined): void;
+    /**
+     * Stop les Appels de la fonction "handler" (passée en paramettre) lorsque quelque chose change la valeur gérée par le proxy quelque soit la profondeur de la donnée
+     */
+    offInternalMutation(handler: VoidFunction | undefined): void;
+    /**
+     * Maintient le remplissage de l'objet / tableau "handler" passé en paramètre avec les valeurs du proxy
+     * Remplit uniquement les valeurs déjà présentes dans l'objet / tableau passé en paramètre
+     */
+    startTemplateFilling(handler: TemplateFillingListener): void;
+    /**
+     * Arrête  de maintenir le remplissage de l'objet / tableau "handler" passé en paramètre avec les valeurs du proxy
+     */
+    stopTemplateFilling(handler: TemplateFillingListener): void;
+    /**
+     * Maintient le remplissage de l'objet / tableau "handler" passé en paramètre avec les valeurs du proxy
+     * Remplit toute valeur qu'elle soit présente ou pas initialement dans l'objet
+     */
+    startDynamicFilling(handler: DynamicFillingListener): void;
+    stopDynamicFilling(handler: DynamicFillingListener): void;
+    /**
+     * Assigne une nouvelle valeur au proxy ce qui déclenche la transmission de la donnée en fonction des "écouteurs" associés
+     */
+    set(newValue: T, lockInternalMutationsTransmission?: boolean): boolean;
+    /**
+     * Extraire la valeur actuelle du proxy
+     */
+    _cachedGet_?: T;
+    get(): T;
+    /**
+     * retourner le webcomponent auquel le proxy est associé
+     */
+    get $tag(): string;
+}
+export declare function collectModifiedPublisher(): void;
+export declare function getModifiedPublishers(): Set<any>;
+export declare class PublisherManager {
+    static buildDate: string;
+    static changed: boolean;
+    static saving: boolean;
+    static saveId: number;
+    static instance: PublisherManager | null;
+    static instances: Map<string, PublisherManager>;
+    enabledLocaStorageProxies: string[];
+    publishers: Map<string, any>;
+    localStorageData: Record<string, {
+        lastModifiationMS: number;
+        data: PublisherContentType;
+        expirationDelayMs?: number;
+    }>;
+    isLocalStrorageReady: Promise<boolean> | null;
+    constructor();
+    private static pageShowHandlerInitialized;
+    private static initPageShowHandler;
+    private invalidateAll;
+    cleanStorageData(): Promise<unknown>;
+    /**
+     * PublisherManager est un singleton
+     */
+    static getInstance(id?: string): PublisherManager;
+    /**
+     * shortcut static pour obtenir un publisher vias sont id/adresse sans taper getInstance.
+     * Si le publisher n'existe pas, il est créé.
+     */
+    static get(id: string, options?: {
+        localStorageMode?: string;
+        expirationDelayMs?: number;
+    }): DataProvider<any>;
+    /**
+     * Obtenir un publisher vias sont id/adresse
+     * Si le publisher n'existe pas, il est créé.
+     */
+    setLocalData(publisher: PublisherInterface, id: string): Promise<void>;
+    initialisedData: string[];
+    get<T = any>(id: string, options?: PublisherProxyOptions): DataProvider<T>;
+    /**
+     * Remplace un publisher pour l'id fourni par un autre.
+     * L'autre publisher n'est pas supprimé.
+     */
+    set<T = any>(id: string, publisher: DataProvider<T>): void;
+    /**
+     * @warning
+     * !!!!! ATTENTION !!!!!
+     * Il est fort à aprier que vous ne voulez pas utiliser cette methode
+     * Il s'agit d'une supression complete
+     * * du publisher de la liste
+     * * des bindings
+     * * de même que ses sous publishers
+     *
+     * UTILISEZ PLUTÔT la méthode publisher.set({}) pour réinitialiser un publisher sans perdre les ecouteurs
+     */
+    delete(id: string): boolean;
+    saveToLocalStorage(saveId?: number): Promise<void>;
+    compress(string: string, encoding: string): Promise<string>;
+    decompress(str: string, encoding: string): Promise<string>;
+}
+/**
+ * Le Proxy Javascript
+ */
+type WithoutUnderscoreKeys<T> = {
+    [K in keyof T as K extends `_${string}_` ? never : K]: T[K];
+};
+export type DataProvider<T = any> = WithoutUnderscoreKeys<PublisherProxy<T>> & {
+    [K in keyof T]: DataProvider<T[K]>;
+};
+export declare function createPublisher<T = any>(target: T, parentProxPub?: PublisherProxy<T> | null, parentKey?: string): WithoutUnderscoreKeys<PublisherProxy<T>> & { [K in keyof T]: DataProvider<T[K]>; } & T;
+/**
+ * @deprecated @see {@link DataProvider} instead
+ */
+export default DataProvider;
+export type Publisher<T = any> = DataProvider<T>;
+export declare const getObservables: <T = any>(observable: string, options?: DpOptions) => Set<DataProvider<T>>;
+export declare function get<T>(id: DataProviderKey<T>): T;
+export declare function get<T = any>(id: string): T;
+export declare function dataProvider<T>(id: DataProviderKey<T>, options: DpOptions): DataProvider<T>;
+export declare function dataProvider<T = any>(id: string, options: DpOptions): DataProvider<T>;
+export declare function dataProvider<T>(id: DataProviderKey<T>): DataProvider<T>;
+export declare function dataProvider<T = any>(id: string): DataProvider<T>;
+export declare function dataProvider<T>(id: DataProviderKey<T>, defaultValue: T): DataProvider<T>;
+export declare function dataProvider<T = any>(id: string, defaultValue: T): DataProvider<T>;
+export declare function dp<T>(id: DataProviderKey<T>, options: DpOptions): DataProvider<T>;
+export declare function dp<T = any>(id: string, options: DpOptions): DataProvider<T>;
+export declare function dp<T>(id: DataProviderKey<T>): DataProvider<T>;
+export declare function dp<T = any>(id: string): DataProvider<T>;
+export declare function dp<T>(id: DataProviderKey<T>, defaultValue: T): DataProvider<T>;
+export declare function dp<T = any>(id: string, defaultValue: T): DataProvider<T>;
+/**
+ * Alias sémantique pour `PublisherManager.set` : enregistre `aliasKey` sur la même
+ * instance publisher que `source`. Utile pour exposer une clé legacy (`scan`) tout en
+ * stockant l'état sous une racine (`app.scan`) — `dp("scan")` et `appState.scan` partagent
+ * alors la même instance, sans copie à chaque assignation.
+ */
+export declare function mirrorDp<T>(aliasKey: string | DataProviderKey<any>, source: DataProvider<T>): void;
+export declare function mirrorDp(aliasKey: string | DataProviderKey<any>, source: string | DataProviderKey<any>): void;
+export declare function set<T>(id: DataProviderKey<T>, value: T): void;
+export declare function set<T = any>(id: string, value: T): void;
+//# sourceMappingURL=PublisherProxy.d.ts.map

package/dist/types/core/utils/PublisherProxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PublisherProxy.d.ts","sourceRoot":"","sources":["../../../../src/core/utils/PublisherProxy.ts"],"names":[],"mappings":"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"}

package/dist/types/core/utils/SafariScrollGuard.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Garde Safari / WebKit : empêche les resets fantômes de scroll.
+ *
+ * - stock = dernière position user (intent + settle inertie)
+ * - jump brutal vers ~0 → JAMAIS capturé (même mid-gesture), restore
+ * - collapse Lit / slot light-DOM : observe aussi le host + sticky restore multi-frames
+ * - nested : intent uniquement sur le scroller le plus proche (composedPath)
+ */
+export type ScrollRoot = HTMLElement | Window;
+export declare function isSafariScrollEngine(): boolean;
+/**
+ * Mémorise la position courante — refuse tout gros drop d’un coup.
+ */
+export declare function captureScrollRoot(root: ScrollRoot): void;
+/**
+ * Ré-applique le stock. Ne pollue jamais le stock avec le scroll courant.
+ *
+ * Important : on peut clamper la *cible d’écriture* à maxScroll (le navigateur
+ * le ferait de toute façon), mais on ne doit JAMAIS abaisser `s.y` pour autant —
+ * pendant un re-render Lit maxScroll plonge souvent un instant (ex. 215→75) puis
+ * revient ; baisser le stock là, c’est perdre la position pour de bon.
+ */
+export declare function restoreScrollRoot(root: ScrollRoot): void;
+/** @deprecated alias */
+export declare function syncScrollRoot(root: ScrollRoot): void;
+export declare function resetScrollRoot(root: ScrollRoot, position?: {
+    x?: number;
+    y?: number;
+} | "current"): void;
+/**
+ * Branche écoute intent + scroll + resize (+ mutations).
+ * Idempotent.
+ */
+export declare function watchScrollRoot(root: ScrollRoot): void;
+export declare function installSafariScrollGuard(): void;
+//# sourceMappingURL=SafariScrollGuard.d.ts.map

package/dist/types/core/utils/SafariScrollGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SafariScrollGuard.d.ts","sourceRoot":"","sources":["../../../../src/core/utils/SafariScrollGuard.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,MAAM,CAAC;AAyB9C,wBAAgB,oBAAoB,IAAI,OAAO,CAG9C;AA0ED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAWxD;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAwBxD;AAED,wBAAwB;AACxB,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAErD;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,UAAU,EAChB,QAAQ,GAAE;IAAE,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAA0B,GAChE,IAAI,CAWN;AAqBD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAoGtD;AAuFD,wBAAgB,wBAAwB,IAAI,IAAI,CAoC/C"}

package/dist/types/core/utils/Utils.d.ts

@@ -0,0 +1,6 @@
+export default class Utils {
+    static queueTaskPromise(): Promise<unknown>;
+    static delayPromise(timeoutMs: number): Promise<unknown>;
+}
+export declare const sonicClassPrefix: string;
+//# sourceMappingURL=Utils.d.ts.map

package/dist/types/core/utils/Utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Utils.d.ts","sourceRoot":"","sources":["../../../../src/core/utils/Utils.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,OAAO,KAAK;WACX,gBAAgB;WAKhB,YAAY,CAAC,SAAS,EAAE,MAAM;CAK5C;AAWD,eAAO,MAAM,gBAAgB,QACiD,CAAC"}

package/dist/types/core/utils/aesCrypto.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Génère une clé AES-256
+ */
+export declare function generateKey(): Promise<CryptoKey>;
+/**
+ * Exporte une clé AES en format JSON Web Key (JWK)
+ */
+export declare function exportKey(key: CryptoKey): Promise<JsonWebKey>;
+/**
+ * Importe une clé AES à partir d'un format JSON Web Key (JWK)
+ */
+export declare function importKey(jwk: JsonWebKey): Promise<CryptoKey>;
+/**
+ * Chiffre une donnée
+ * @param data - Les données à chiffrer
+ * @param key - La clé AES
+ * @param iv - Le vecteur d'initialisation
+ * @returns Une chaîne encodée en Base64
+ */
+export declare function encryptToBase64(data: string, key: CryptoKey, iv: Uint8Array): Promise<string>;
+/**
+ * Déchiffre une donnée
+ * @param base64Data - Les données chiffrées en Base64
+ * @param key - La clé AES
+ * @param iv - Le vecteur d'initialisation
+ * @returns Une chaîne déchiffrée
+ */
+export declare function decryptFromBase64(base64Data: string, key: CryptoKey, iv: Uint8Array): Promise<string>;
+/**
+ * USAGE
+
+import { generateKey, encryptToBase64, decryptFromBase64, exportKey, importKey } from './aesCrypto';
+
+(async () => {
+    const key = await generateKey();
+    const iv = crypto.getRandomValues(new Uint8Array(16)); // Génère un IV aléatoire
+
+    const data = "Ceci est un secret!";
+
+    // Chiffrement
+    const encryptedBase64 = await encryptToBase64(data, key, iv);
+
+    // Déchiffrement
+    const decrypted = await decryptFromBase64(encryptedBase64, key, iv);
+
+    // Exporter et importer la clé
+    const exportedKey = await exportKey(key);
+
+    const importedKey = await importKey(exportedKey);
+})();
+
+ */
+//# sourceMappingURL=aesCrypto.d.ts.map

package/dist/types/core/utils/aesCrypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aesCrypto.d.ts","sourceRoot":"","sources":["../../../../src/core/utils/aesCrypto.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,SAAS,CAAC,CAStD;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAEnE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAQnE;AAqBD;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,SAAS,EACd,EAAE,EAAE,UAAU,GACb,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,SAAS,EACd,EAAE,EAAE,UAAU,GACb,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG"}

package/dist/types/core/utils/api.d.ts

@@ -0,0 +1,173 @@
+import { CoreJSType } from "@supersoniks/concorde/core/_types/types";
+export type APIConfiguration = {
+    serviceURL: string | null;
+    /** un flag pour indiquer de bloquer les appels suivant au même serviceurl tant que celuis-ci n'a pas terminé */
+    blockUntilDone?: boolean;
+    token: string | null;
+    userName: string | null;
+    password: string | null;
+    authToken: string | null;
+    tokenProvider: string | null;
+    addHTTPResponse?: boolean;
+    credentials?: RequestCredentials;
+    cache?: RequestCache;
+    keepAlive?: boolean;
+};
+export type CallState = "loading" | "done" | "error" | undefined;
+export type ResultTypeInterface = CoreJSType & {
+    _sonic_http_response_?: Response;
+    text?: string;
+};
+export type APICall = {
+    apiMethod: "get" | "send" | "submitFormData";
+    path: string;
+    additionalHeaders: HeadersInit | undefined;
+    method?: string | undefined;
+    data?: unknown;
+    cache?: RequestCache;
+};
+export type APIResponse = {
+    http: Response;
+    processed: ResultTypeInterface;
+};
+/** Valeur assignée par `@get`, `@post`, `@put`, `@patch`. */
+export type ApiResult<T> = {
+    request: Request;
+    /** Absent / `undefined` pour les chemins `dataProvider(...)` (pas d’appel réseau). */
+    response?: Response;
+    /** Corps utile sans `_sonic_http_response_` sur l’objet racine. */
+    result: T;
+};
+/** @deprecated Utiliser `ApiResult`. */
+export type ApiGetResult<T> = ApiResult<T>;
+declare class API {
+    /**
+     * Ce tableau static permet de ne pas appeler plusieurs fois le même service lors d'appel concurrents en GET.
+     */
+    private static loadingGetPromises;
+    /**
+     * L'url de base du service sans endpoint
+     */
+    serviceURL: string | null;
+    /**
+     * le nom de l'utilisateur si basic auth est utilisé
+     */
+    userName: string | null;
+    /**
+     * le password de l'utilisateur si basic auth est utilisé
+     */
+    password: string | null;
+    /**
+     * le bearer token a passer pour les appels REST
+     */
+    private _token;
+    set token(token: string | null | undefined);
+    get token(): string | null | undefined;
+    /**
+     * Le endPoint pour obtenir le bearer token qui sera concaténé à l'url du service
+     */
+    tokenProvider: string | null;
+    /**
+     * le bearer token à passer pour un éventuel renouvellement de token automatique
+     */
+    authToken: string | null;
+    /**
+     * credentials
+     */
+    credentials?: RequestCredentials;
+    /**
+     * Tableau static des tokens stokés en memoire vive (comportement à revoir à l'occasion)
+     */
+    private static tokens;
+    /**
+     * Tableau stockant l'ensemble des tokens invalides
+     */
+    private static invalidTokens;
+    private handleInvalidToken;
+    /**
+     * Tableau static des tentatives échouées de récupération auto du token
+     */
+    private static failledTokenUpdates;
+    /**
+     * Tableau static des flags pour savoir si le premier appel a été fait pour chaque serviceURL
+     */
+    private static firstCallDoneFlags;
+    /**
+     * Le endPoint pour obtenir le bearer token qui sera concaténé à l'url du service
+     */
+    addHTTPResponse: boolean;
+    cache: RequestCache;
+    lastResult?: Response;
+    isServiceSimulated: boolean;
+    blockUntilDone: boolean;
+    keepAlive: boolean;
+    constructor(config: APIConfiguration);
+    private handleResult;
+    /**
+     * Basic auth
+     */
+    private auth;
+    /**
+     * avec localget, on ne passe pas par le système de token
+     * on recupère path sans les searchparams nommée pathWithoutSearchParams
+     * on cherche dans PublisherManager.get(pathWithoutSearchParams).get() les données qui matchent les searchparams présents dans path
+     * on retourne les données selon le même format que le retour de get
+     *
+     * @todo netttoyer
+     */
+    localGet<T>(dataProvider: string, searchString: string): Promise<T & ResultTypeInterface>;
+    /**
+     * firstCallDone is a function that returns a promise that is resolved when the first call to the API is done for each serviceURL whatever api instance is used
+     */
+    private firstCallDone;
+    get<T>(path: string, additionalHeaders?: HeadersInit): Promise<(T & ResultTypeInterface) | null>;
+    /**
+     * S’appuie sur `get()` puis reformate la réponse : `Request` équivalent à l’appel,
+     * `Response` renseignée par `lastResult` après un GET HTTP (via `handleResult`),
+     * `result` = corps métier typé `T` (sans `_sonic_http_response_` à la racine).
+     * Pour `dataProvider(...)`, pas de `response` (pas de fetch).
+     */
+    getDetailed<T>(path: string, additionalHeaders?: HeadersInit): Promise<ApiResult<T> | undefined>;
+    /**
+     * S’appuie sur `post()` puis reformate la réponse : `Request` avec body JSON,
+     * `Response` via `lastResult`, `result` typé `T`.
+     */
+    sendDetailed<T, B>(path: string, body: B, method: "POST" | "PUT" | "PATCH", additionalHeaders?: HeadersInit): Promise<ApiResult<T> | undefined>;
+    postDetailed<T, B>(path: string, body: B, additionalHeaders?: HeadersInit): Promise<ApiResult<T> | undefined>;
+    putDetailed<T, B>(path: string, body: B, additionalHeaders?: HeadersInit): Promise<ApiResult<T> | undefined>;
+    patchDetailed<T, B>(path: string, body: B, additionalHeaders?: HeadersInit): Promise<ApiResult<T> | undefined>;
+    /**
+     * Création du header, avec authentification si besoin
+     * ajout du language via le header accept-language qui contient le langue du navigateur
+     */
+    createHeaders(additionalHeaders?: HeadersInit): Promise<Record<string, string>>;
+    /**
+     * Concatène le serviceURL et le endpoint donné en paramètre
+     */
+    computeURL(path: string, query?: Record<string, string>): string;
+    send<T, SendType = CoreJSType>(path: string, data: SendType, method?: string, additionalHeaders?: HeadersInit): Promise<T & ResultTypeInterface>;
+    /**
+     * Agit comme une soumission de formulaire, mais attends un json en réponse
+     */
+    submitFormData<T, SendType = CoreJSType>(path: string, data: SendType, method?: string, additionalHeaders?: HeadersInit): Promise<T & ResultTypeInterface>;
+    /**
+     * Appel send en utilisant le méthode PUT
+     */
+    put<T, SendType = CoreJSType>(path: string, data: SendType, additionalHeaders?: HeadersInit): Promise<T & ResultTypeInterface>;
+    /**
+     * Appel send en utilisant le méthode POST
+     */
+    post<T, SendType = CoreJSType>(path: string, data: SendType, additionalHeaders?: HeadersInit): Promise<T & ResultTypeInterface>;
+    /**
+     * Appel send en utilisant le méthode PATCH
+     */
+    patch<T, SendType = CoreJSType>(path: string, data: SendType, additionalHeaders?: HeadersInit): Promise<T & ResultTypeInterface>;
+    /**
+     * Appel send en utilisant le méthode delete
+     */
+    delete<T, SendType = CoreJSType>(path: string, data: SendType, additionalHeaders?: HeadersInit): Promise<T & ResultTypeInterface>;
+}
+export default API;
+export declare const log: (message: string, variables?: any) => Promise<void>;
+export declare const configLog: (newConfig: APIConfiguration, endPoint?: string) => void;
+//# sourceMappingURL=api.d.ts.map

package/dist/types/core/utils/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../src/core/utils/api.ts"],"names":[],"mappings":"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"}

package/dist/types/core/utils/dataProviderKey.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Type-safe navigation through composite data structures (publisher paths).
+ * Each property or index access extends the path. Retrieve the final path via toString() or path.
+ * Supports dynamic paths: use placeholders like "users.${userIndex}" in the constructor.
+ *
+ * @example
+ * const myKey = new DataProviderKey<Data>("data").items[0];
+ * myKey.toString();  // "data.items.0"
+ * myKey.path;        // same
+ *
+ * @example
+ * // U = dépendances dynamiques sur l’hôte (voir DataProviderKeyHost) — propagé sur .foo.bar
+ * new DataProviderKey<User, { userIndex: number }>("demoUsers.${userIndex}");
+ */
+type IsAny<T> = 0 extends 1 & T ? true : false;
+/**
+ * Prototype de classe décorée : propriétés minimales attendues sur l’hôte quand la clé est
+ * `DataProviderKey<…, U>` (U renseigné à la construction). Avec `U` par défaut (`any`), pas de contrainte.
+ */
+export type DataProviderKeyHost<U> = IsAny<U> extends true ? object : keyof U extends never ? object : object & U;
+/**
+ * Navigation « dot » : une propriété optionnelle `foo?: X` reste traversable (le chemin publisher
+ * existe). On retire `null` / `undefined` seulement quand la partie non-nulle est un `object`
+ * (y compris tableaux, tuples), pour que le chaînage `.bar.baz` soit typé sans `?.`.
+ * Les feuilles (`boolean | undefined`, `string`, etc.) gardent leur union telle quelle.
+ */
+type DataProviderKeyNavigate<T> = T extends (...args: unknown[]) => unknown ? T : NonNullable<T> extends infer U ? [U] extends [never] ? T : U extends object ? U : T : T;
+/**
+ * U : forme minimale du composant pour résoudre les placeholders `${…}` du path ; inchangée lors de la navigation.
+ */
+type DataProviderKeyProxy<T, U = any> = NonNullable<T> extends object ? {
+    [K in keyof NonNullable<T> as NonNullable<T>[K] extends (...args: unknown[]) => unknown ? never : K]-?: DataProviderKey<DataProviderKeyNavigate<NonNullable<T>[K]>, U>;
+} : object;
+export type DataProviderKey<T, U = any> = DataProviderKeyImpl<T, U> & DataProviderKeyProxy<T, U>;
+declare class DataProviderKeyImpl<T, U = any> {
+    readonly path: string;
+    readonly _phantom?: T;
+    readonly _phantomDeps?: U;
+    constructor(path: string);
+    toString(): string;
+}
+export interface DataProviderKeyConstructor {
+    new <T, U = any>(path: string): DataProviderKey<T, U>;
+}
+export declare function isDynamicPublisherPath(path: string): boolean;
+export type PublisherPathInput = string | {
+    path: string;
+};
+/**
+ * Resolves a static publisher path for get / set / dp.
+ * Rejects DataProviderKey templates with dynamic placeholders.
+ */
+export declare function resolveStaticPublisherPath(input: PublisherPathInput): string;
+export declare const DataProviderKey: DataProviderKeyConstructor;
+export {};
+//# sourceMappingURL=dataProviderKey.d.ts.map

package/dist/types/core/utils/dataProviderKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataProviderKey.d.ts","sourceRoot":"","sources":["../../../../src/core/utils/dataProviderKey.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,KAAK,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC;AAE/C;;;GAGG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAC/B,KAAK,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC,SAAS,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC;AAE/E;;;;;GAKG;AACH,KAAK,uBAAuB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GACvE,CAAC,GACD,WAAW,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,GAC5B,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GACjB,CAAC,GACD,CAAC,SAAS,MAAM,GACd,CAAC,GACD,CAAC,GACL,CAAC,CAAC;AAER;;GAEG;AACH,KAAK,oBAAoB,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,IAClC,WAAW,CAAC,CAAC,CAAC,SAAS,MAAM,GACzB;KACG,CAAC,IAAI,MAAM,WAAW,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CACtD,GAAG,IAAI,EAAE,OAAO,EAAE,KACf,OAAO,GACR,KAAK,GACL,CAAC,CAAC,CAAC,GAAG,eAAe,CACvB,uBAAuB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAC1C,CAAC,CACF;CACF,GACD,MAAM,CAAC;AAEb,MAAM,MAAM,eAAe,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,IAAI,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,GACjE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAE7B,cAAM,mBAAmB,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG;aAIN,IAAI,EAAE,MAAM;IAHxC,SAAiB,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC9B,SAAiB,YAAY,CAAC,EAAE,CAAC,CAAC;gBAEN,IAAI,EAAE,MAAM;IAExC,QAAQ,IAAI,MAAM;CAGnB;AAsBD,MAAM,WAAW,0BAA0B;IACzC,KAAK,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACvD;AAKD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAQ5E;AAGD,eAAO,MAAM,eAAe,EAAE,0BAQtB,CAAC"}

package/dist/types/core/utils/derive.d.ts

@@ -0,0 +1,40 @@
+import { DataProviderKey, type PublisherPathInput } from "@supersoniks/concorde/core/utils/dataProviderKey";
+export type DeriveStatus = "loading" | "ready" | "error" | "empty";
+export type DeriveState = {
+    status: DeriveStatus;
+    error?: string | null;
+};
+export type DeriveCompute<I extends Record<string, unknown>, O, V> = (inputs: I, vars: V) => O | Promise<O>;
+export type DeriveOptions<I extends Record<string, unknown>, O, V = Record<string, unknown>> = {
+    inputs: {
+        [K in keyof I]: DataProviderKey<I[K]> | string;
+    };
+    compute: DeriveCompute<I, O, V>;
+    output: DataProviderKey<O> | string;
+    /** formDataProvider (ou autre DP) servant de variables `$top`, `$season`, … */
+    variables?: DataProviderKey<V> | string;
+    debounceMs?: number;
+    isEmpty?: (value: O) => boolean;
+    /** Taille max d’un tableau d’entrée (warn au-delà). Défaut 10_000. */
+    maxInputItems?: number;
+};
+export type DeriveHandle = {
+    stop: () => void;
+    /** Force un recalcul immédiat (sans debounce). */
+    recompute: () => void;
+};
+/**
+ * État de dérivation publié sur `{outputRoot}/_state_` pour `sonic-states`.
+ */
+export declare function deriveStateKey(output: PublisherPathInput): string;
+/**
+ * Primitive de données dérivées en lecture seule.
+ *
+ * Observe les DataProviders d’entrée (+ variables optionnelles), recalcule avec
+ * debounce, annule les résultats périmés (génération), publie sur `output`.
+ */
+export declare function derive<I extends Record<string, unknown>, O, V = Record<string, unknown>>(options: DeriveOptions<I, O, V>): DeriveHandle;
+export declare function derive<I extends Record<string, unknown>, O, V = Record<string, unknown>>(inputs: {
+    [K in keyof I]: DataProviderKey<I[K]> | string;
+}, compute: DeriveCompute<I, O, V>, output: DataProviderKey<O> | string, variables?: DataProviderKey<V> | string): DeriveHandle;
+//# sourceMappingURL=derive.d.ts.map

package/dist/types/core/utils/derive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../../../../src/core/utils/derive.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAEf,KAAK,kBAAkB,EACxB,MAAM,kDAAkD,CAAC;AAO1D,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAEnE,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CACnE,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,CAAC,KACJ,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEpB,MAAM,MAAM,aAAa,CACvB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,CAAC,EACD,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACzB;IACF,MAAM,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM;KAAE,CAAC;IAC3D,OAAO,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAChC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;IACpC,+EAA+E;IAC/E,SAAS,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;IAChC,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,kDAAkD;IAClD,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC;AA6FF;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAEjE;AAOD;;;;;GAKG;AACH,wBAAgB,MAAM,CACpB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,CAAC,EACD,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3B,OAAO,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,YAAY,CAAC;AACjD,wBAAgB,MAAM,CACpB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,CAAC,EACD,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAE3B,MAAM,EAAE;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM;CAAE,EAC1D,OAAO,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC/B,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,MAAM,EACnC,SAAS,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,MAAM,GACtC,YAAY,CAAC"}