@ecosplay/e-brocante 1.0.2

package/dist/EBrocanteClient.js.map

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

package/dist/cache/CacheBackend.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @copyright 2026 Association E-Cosplay
+ * @license   Proprietary — see LICENSE
+ */
+/**
+ * Minimal cache interface used by the SDK. Implementations are local
+ * (in-memory), Redis, or a no-op when caching is disabled.
+ */
+export interface CacheBackend {
+    get(key: string): Promise<unknown>;
+    set(key: string, value: unknown, ttlSeconds?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    purge(): Promise<void>;
+    /**
+     * Bulk purge keys matching a wildcard pattern (`*` at the end). Used
+     * by the public `client.cache.purgeKey()` shortcut.
+     */
+    purgeKey(endpoint: string, params?: Record<string, unknown>): Promise<void>;
+}
+//# sourceMappingURL=CacheBackend.d.ts.map

package/dist/cache/CacheBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheBackend.d.ts","sourceRoot":"","sources":["../../src/cache/CacheBackend.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,WAAW,YAAY;IACzB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/E"}

package/dist/cache/CacheBackend.js

@@ -0,0 +1,6 @@
+/**
+ * @copyright 2026 Association E-Cosplay
+ * @license   Proprietary — see LICENSE
+ */
+export {};
+//# sourceMappingURL=CacheBackend.js.map

package/dist/cache/CacheBackend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheBackend.js","sourceRoot":"","sources":["../../src/cache/CacheBackend.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/cache/LocalCache.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @copyright 2026 Association E-Cosplay
+ * @license   Proprietary — see LICENSE
+ */
+import type { CacheBackend } from './CacheBackend.js';
+/**
+ * In-memory cache backend. Lives for the duration of a single Node/Bun
+ * process. Suitable for short scripts and single-instance apps. For
+ * multi-process deployments use RedisCache.
+ */
+export declare class LocalCache implements CacheBackend {
+    private readonly defaultTtl;
+    private readonly keyPrefix;
+    private readonly store;
+    constructor(defaultTtl?: number, keyPrefix?: string);
+    get(key: string): Promise<unknown>;
+    set(key: string, value: unknown, ttlSeconds?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    purge(): Promise<void>;
+    purgeKey(endpoint: string, params?: Record<string, unknown>): Promise<void>;
+}
+//# sourceMappingURL=LocalCache.d.ts.map

package/dist/cache/LocalCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalCache.d.ts","sourceRoot":"","sources":["../../src/cache/LocalCache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAQtD;;;;GAIG;AACH,qBAAa,UAAW,YAAW,YAAY;IAIvC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4B;gBAG7B,UAAU,GAAE,MAAY,EACxB,SAAS,GAAE,MAAW;IAGrC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAalC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQxF"}

package/dist/cache/LocalCache.js

@@ -0,0 +1,53 @@
+/**
+ * @copyright 2026 Association E-Cosplay
+ * @license   Proprietary — see LICENSE
+ */
+import { stableHashKey } from './stableHashKey.js';
+/**
+ * In-memory cache backend. Lives for the duration of a single Node/Bun
+ * process. Suitable for short scripts and single-instance apps. For
+ * multi-process deployments use RedisCache.
+ */
+export class LocalCache {
+    defaultTtl;
+    keyPrefix;
+    store = new Map();
+    constructor(defaultTtl = 300, keyPrefix = '') {
+        this.defaultTtl = defaultTtl;
+        this.keyPrefix = keyPrefix;
+    }
+    async get(key) {
+        const fullKey = this.keyPrefix + key;
+        const entry = this.store.get(fullKey);
+        if (!entry) {
+            return null;
+        }
+        if (entry.expiresAt < Date.now()) {
+            this.store.delete(fullKey);
+            return null;
+        }
+        return entry.value;
+    }
+    async set(key, value, ttlSeconds) {
+        const ttl = ttlSeconds ?? this.defaultTtl;
+        this.store.set(this.keyPrefix + key, {
+            value,
+            expiresAt: Date.now() + ttl * 1000,
+        });
+    }
+    async delete(key) {
+        this.store.delete(this.keyPrefix + key);
+    }
+    async purge() {
+        this.store.clear();
+    }
+    async purgeKey(endpoint, params = {}) {
+        const hashed = stableHashKey(endpoint, params);
+        for (const key of this.store.keys()) {
+            if (key.endsWith(hashed)) {
+                this.store.delete(key);
+            }
+        }
+    }
+}
+//# sourceMappingURL=LocalCache.js.map

package/dist/cache/LocalCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalCache.js","sourceRoot":"","sources":["../../src/cache/LocalCache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOnD;;;;GAIG;AACH,MAAM,OAAO,UAAU;IAIE;IACA;IAJJ,KAAK,GAAG,IAAI,GAAG,EAAiB,CAAC;IAElD,YACqB,aAAqB,GAAG,EACxB,YAAoB,EAAE;QADtB,eAAU,GAAV,UAAU,CAAc;QACxB,cAAS,GAAT,SAAS,CAAa;IACxC,CAAC;IAEJ,KAAK,CAAC,GAAG,CAAC,GAAW;QACjB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,IAAI,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAC/B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC3B,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,KAAK,CAAC,KAAK,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAc,EAAE,UAAmB;QACtD,MAAM,GAAG,GAAG,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC;QAC1C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,GAAG,GAAG,EAAE;YACjC,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI;SACrC,CAAC,CAAC;IACP,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACpB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,KAAK;QACP,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,SAAkC,EAAE;QACjE,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC/C,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YAClC,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACvB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC;QACL,CAAC;IACL,CAAC;CACJ"}

package/dist/cache/NullCache.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @copyright 2026 Association E-Cosplay
+ * @license   Proprietary — see LICENSE
+ */
+import type { CacheBackend } from './CacheBackend.js';
+/**
+ * No-op cache used when the SDK is constructed with `cache: false`.
+ * Every request hits the network; nothing is stored.
+ */
+export declare class NullCache implements CacheBackend {
+    get(_key: string): Promise<null>;
+    set(_key: string, _value: unknown, _ttlSeconds?: number): Promise<void>;
+    delete(_key: string): Promise<void>;
+    purge(): Promise<void>;
+    purgeKey(_endpoint: string, _params?: Record<string, unknown>): Promise<void>;
+}
+//# sourceMappingURL=NullCache.d.ts.map

package/dist/cache/NullCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NullCache.d.ts","sourceRoot":"","sources":["../../src/cache/NullCache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;GAGG;AACH,qBAAa,SAAU,YAAW,YAAY;IACpC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAGtF"}

package/dist/cache/NullCache.js

@@ -0,0 +1,26 @@
+/**
+ * @copyright 2026 Association E-Cosplay
+ * @license   Proprietary — see LICENSE
+ */
+/**
+ * No-op cache used when the SDK is constructed with `cache: false`.
+ * Every request hits the network; nothing is stored.
+ */
+export class NullCache {
+    async get(_key) {
+        return null;
+    }
+    async set(_key, _value, _ttlSeconds) {
+        /* intentional no-op */
+    }
+    async delete(_key) {
+        /* intentional no-op */
+    }
+    async purge() {
+        /* intentional no-op */
+    }
+    async purgeKey(_endpoint, _params) {
+        /* intentional no-op */
+    }
+}
+//# sourceMappingURL=NullCache.js.map

package/dist/cache/NullCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NullCache.js","sourceRoot":"","sources":["../../src/cache/NullCache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;GAGG;AACH,MAAM,OAAO,SAAS;IAClB,KAAK,CAAC,GAAG,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAY,EAAE,MAAe,EAAE,WAAoB;QACzD,uBAAuB;IAC3B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACrB,uBAAuB;IAC3B,CAAC;IAED,KAAK,CAAC,KAAK;QACP,uBAAuB;IAC3B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,SAAiB,EAAE,OAAiC;QAC/D,uBAAuB;IAC3B,CAAC;CACJ"}

package/dist/cache/RedisCache.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @copyright 2026 Association E-Cosplay
+ * @license   Proprietary — see LICENSE
+ */
+import type { CacheBackend } from './CacheBackend.js';
+import { type RedisConfig } from './RedisConfig.js';
+/**
+ * Lightweight Redis client surface required by RedisCache. Compatible
+ * with `ioredis`'s public API (and any equivalent client).
+ */
+export interface RedisLikeClient {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, mode: 'EX', seconds: number): Promise<unknown>;
+    del(...keys: string[]): Promise<number>;
+    scan(cursor: string | number, ...args: unknown[]): Promise<[string, string[]]>;
+    quit(): Promise<unknown>;
+}
+/**
+ * Redis cache backend. Uses `ioredis` by default. The connection is
+ * lazily established on the first get/set and reused for the lifetime
+ * of the cache instance.
+ */
+export declare class RedisCache implements CacheBackend {
+    private readonly config;
+    private readonly defaultTtl;
+    private readonly keyPrefix;
+    private readonly clientFactory?;
+    private client;
+    constructor(config: RedisConfig, defaultTtl?: number, keyPrefix?: string, clientFactory?: (() => Promise<RedisLikeClient>) | undefined);
+    get(key: string): Promise<unknown>;
+    set(key: string, value: unknown, ttlSeconds?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    purge(): Promise<void>;
+    purgeKey(endpoint: string, params?: Record<string, unknown>): Promise<void>;
+    private connect;
+    private realConnect;
+    private fullKey;
+}
+//# sourceMappingURL=RedisCache.d.ts.map

package/dist/cache/RedisCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisCache.d.ts","sourceRoot":"","sources":["../../src/cache/RedisCache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAwB,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG1E;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/E,GAAG,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC/E,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5B;AAED;;;;GAIG;AACH,qBAAa,UAAW,YAAW,YAAY;IAIvC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IANnC,OAAO,CAAC,MAAM,CAAgC;gBAGzB,MAAM,EAAE,WAAW,EACnB,UAAU,GAAE,MAAY,EACxB,SAAS,GAAE,MAAW,EACtB,aAAa,CAAC,GAAE,MAAM,OAAO,CAAC,eAAe,CAAC,aAAA;IAG7D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUlC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAatB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAcvE,OAAO;YAaP,WAAW;IAuBzB,OAAO,CAAC,OAAO;CAGlB"}

package/dist/cache/RedisCache.js

@@ -0,0 +1,104 @@
+/**
+ * @copyright 2026 Association E-Cosplay
+ * @license   Proprietary — see LICENSE
+ */
+import { EBrocanteError } from '../exceptions/index.js';
+import { DEFAULT_REDIS_CONFIG } from './RedisConfig.js';
+import { stableHashKey } from './stableHashKey.js';
+/**
+ * Redis cache backend. Uses `ioredis` by default. The connection is
+ * lazily established on the first get/set and reused for the lifetime
+ * of the cache instance.
+ */
+export class RedisCache {
+    config;
+    defaultTtl;
+    keyPrefix;
+    clientFactory;
+    client = null;
+    constructor(config, defaultTtl = 300, keyPrefix = '', clientFactory) {
+        this.config = config;
+        this.defaultTtl = defaultTtl;
+        this.keyPrefix = keyPrefix;
+        this.clientFactory = clientFactory;
+    }
+    async get(key) {
+        const raw = await (await this.connect()).get(this.fullKey(key));
+        if (raw === null)
+            return null;
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    async set(key, value, ttlSeconds) {
+        const encoded = JSON.stringify(value);
+        await (await this.connect()).set(this.fullKey(key), encoded, 'EX', ttlSeconds ?? this.defaultTtl);
+    }
+    async delete(key) {
+        await (await this.connect()).del(this.fullKey(key));
+    }
+    async purge() {
+        const client = await this.connect();
+        const pattern = this.fullKey('*');
+        let cursor = '0';
+        do {
+            const [next, keys] = await client.scan(cursor, 'MATCH', pattern, 'COUNT', '100');
+            cursor = next;
+            if (keys.length > 0) {
+                await client.del(...keys);
+            }
+        } while (cursor !== '0');
+    }
+    async purgeKey(endpoint, params = {}) {
+        const hashed = stableHashKey(endpoint, params);
+        const client = await this.connect();
+        const pattern = this.fullKey(`*${hashed}`);
+        let cursor = '0';
+        do {
+            const [next, keys] = await client.scan(cursor, 'MATCH', pattern, 'COUNT', '100');
+            cursor = next;
+            if (keys.length > 0) {
+                await client.del(...keys);
+            }
+        } while (cursor !== '0');
+    }
+    async connect() {
+        if (this.client)
+            return this.client;
+        /* v8 ignore start — live-Redis fallback path is integration-tested only */
+        if (!this.clientFactory) {
+            this.client = await this.realConnect();
+            return this.client;
+        }
+        /* v8 ignore stop */
+        this.client = await this.clientFactory();
+        return this.client;
+    }
+    /* v8 ignore start — exercised only against a live Redis instance */
+    async realConnect() {
+        const cfg = { ...DEFAULT_REDIS_CONFIG, ...this.config };
+        let Redis;
+        try {
+            ({ default: Redis } = (await import('ioredis')));
+        }
+        catch {
+            throw new EBrocanteError("RedisCache requires the 'ioredis' package. Install it with: bun add ioredis");
+        }
+        return new Redis({
+            host: cfg.host,
+            port: cfg.port,
+            password: cfg.password,
+            db: cfg.db,
+            connectTimeout: cfg.timeoutMs,
+            tls: cfg.tls ? {} : undefined,
+        });
+    }
+    /* v8 ignore stop */
+    fullKey(key) {
+        return `${this.config.prefix ?? DEFAULT_REDIS_CONFIG.prefix}${this.keyPrefix}${key}`;
+    }
+}
+//# sourceMappingURL=RedisCache.js.map

package/dist/cache/RedisCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisCache.js","sourceRoot":"","sources":["../../src/cache/RedisCache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,EAAE,oBAAoB,EAAoB,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAcnD;;;;GAIG;AACH,MAAM,OAAO,UAAU;IAIE;IACA;IACA;IACA;IANb,MAAM,GAA2B,IAAI,CAAC;IAE9C,YACqB,MAAmB,EACnB,aAAqB,GAAG,EACxB,YAAoB,EAAE,EACtB,aAA8C;QAH9C,WAAM,GAAN,MAAM,CAAa;QACnB,eAAU,GAAV,UAAU,CAAc;QACxB,cAAS,GAAT,SAAS,CAAa;QACtB,kBAAa,GAAb,aAAa,CAAiC;IAChE,CAAC;IAEJ,KAAK,CAAC,GAAG,CAAC,GAAW;QACjB,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QAChE,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC9B,IAAI,CAAC;YACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAc,EAAE,UAAmB;QACtD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC;IACtG,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACpB,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,KAAK;QACP,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,MAAM,GAAG,GAAG,CAAC;QACjB,GAAG,CAAC;YACA,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;YACjF,MAAM,GAAG,IAAI,CAAC;YACd,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClB,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;YAC9B,CAAC;QACL,CAAC,QAAQ,MAAM,KAAK,GAAG,EAAE;IAC7B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,SAAkC,EAAE;QACjE,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;QAC3C,IAAI,MAAM,GAAG,GAAG,CAAC;QACjB,GAAG,CAAC;YACA,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;YACjF,MAAM,GAAG,IAAI,CAAC;YACd,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClB,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;YAC9B,CAAC;QACL,CAAC,QAAQ,MAAM,KAAK,GAAG,EAAE;IAC7B,CAAC;IAEO,KAAK,CAAC,OAAO;QACjB,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC;QACpC,2EAA2E;QAC3E,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC,MAAM,CAAC;QACvB,CAAC;QACD,oBAAoB;QACpB,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,oEAAoE;IAC5D,KAAK,CAAC,WAAW;QACrB,MAAM,GAAG,GAAG,EAAE,GAAG,oBAAoB,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACxD,IAAI,KAAkD,CAAC;QACvD,IAAI,CAAC;YACD,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAE7C,CAAC,CAAC;QACP,CAAC;QAAC,MAAM,CAAC;YACL,MAAM,IAAI,cAAc,CACpB,6EAA6E,CAChF,CAAC;QACN,CAAC;QACD,OAAO,IAAI,KAAK,CAAC;YACb,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,cAAc,EAAE,GAAG,CAAC,SAAS;YAC7B,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;SAChC,CAAC,CAAC;IACP,CAAC;IACD,oBAAoB;IAEZ,OAAO,CAAC,GAAW;QACvB,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,oBAAoB,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC;IACzF,CAAC;CACJ"}

package/dist/cache/RedisConfig.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @copyright 2026 Association E-Cosplay
+ * @license   Proprietary — see LICENSE
+ */
+export interface RedisConfig {
+    host?: string;
+    port?: number;
+    password?: string;
+    db?: number;
+    prefix?: string;
+    timeoutMs?: number;
+    tls?: boolean;
+}
+export declare const DEFAULT_REDIS_CONFIG: Required<Omit<RedisConfig, 'password'>> & {
+    password?: string;
+};
+//# sourceMappingURL=RedisConfig.d.ts.map

package/dist/cache/RedisConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisConfig.d.ts","sourceRoot":"","sources":["../../src/cache/RedisConfig.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAO/F,CAAC"}

package/dist/cache/RedisConfig.js

@@ -0,0 +1,13 @@
+/**
+ * @copyright 2026 Association E-Cosplay
+ * @license   Proprietary — see LICENSE
+ */
+export const DEFAULT_REDIS_CONFIG = {
+    host: '127.0.0.1',
+    port: 6379,
+    db: 0,
+    prefix: 'ebrocante:',
+    timeoutMs: 1500,
+    tls: false,
+};
+//# sourceMappingURL=RedisConfig.js.map

package/dist/cache/RedisConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisConfig.js","sourceRoot":"","sources":["../../src/cache/RedisConfig.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,MAAM,CAAC,MAAM,oBAAoB,GAAoE;IACjG,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,IAAI;IACV,EAAE,EAAE,CAAC;IACL,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,IAAI;IACf,GAAG,EAAE,KAAK;CACb,CAAC"}

package/dist/cache/stableHashKey.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @copyright 2026 Association E-Cosplay
+ * @license   Proprietary — see LICENSE
+ */
+/**
+ * Deterministic, key-order-independent hash for cache lookups.
+ * Mirrors the PHP SDK's makeCacheKey() so both clients can share
+ * a Redis instance without collisions.
+ */
+export declare function stableHashKey(endpoint: string, params: Record<string, unknown>): string;
+//# sourceMappingURL=stableHashKey.d.ts.map

package/dist/cache/stableHashKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stableHashKey.d.ts","sourceRoot":"","sources":["../../src/cache/stableHashKey.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAcvF"}

package/dist/cache/stableHashKey.js

@@ -0,0 +1,27 @@
+/**
+ * @copyright 2026 Association E-Cosplay
+ * @license   Proprietary — see LICENSE
+ */
+import { createHash } from 'node:crypto';
+import { slashesToDots, stringifyPrimitive, trimSlashes } from '../internal/safeStrings.js';
+/**
+ * Deterministic, key-order-independent hash for cache lookups.
+ * Mirrors the PHP SDK's makeCacheKey() so both clients can share
+ * a Redis instance without collisions.
+ */
+export function stableHashKey(endpoint, params) {
+    const sortedKeys = Object.keys(params).sort((a, b) => a.localeCompare(b, 'en'));
+    const queryString = sortedKeys
+        .map((k) => {
+        const v = params[k];
+        if (v === undefined || v === null || v === '')
+            return null;
+        return `${encodeURIComponent(k)}=${encodeURIComponent(stringifyPrimitive(v))}`;
+    })
+        .filter((s) => s !== null)
+        .join('&');
+    const cleanEndpoint = slashesToDots(trimSlashes(endpoint));
+    const digest = createHash('sha256').update(queryString).digest('hex').slice(0, 32);
+    return `${cleanEndpoint}:${digest}`;
+}
+//# sourceMappingURL=stableHashKey.js.map

package/dist/cache/stableHashKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stableHashKey.js","sourceRoot":"","sources":["../../src/cache/stableHashKey.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE5F;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,MAA+B;IAC3E,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAChF,MAAM,WAAW,GAAG,UAAU;SACzB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACP,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE;YAAE,OAAO,IAAI,CAAC;QAC3D,OAAO,GAAG,kBAAkB,CAAC,CAAC,CAAC,IAAI,kBAAkB,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACnF,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;SACtC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEf,MAAM,aAAa,GAAG,aAAa,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnF,OAAO,GAAG,aAAa,IAAI,MAAM,EAAE,CAAC;AACxC,CAAC"}

package/dist/exceptions/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @copyright 2026 Association E-Cosplay
+ * @license   Proprietary — see LICENSE
+ *
+ * Typed exception hierarchy. Catch `EBrocanteError` to handle any SDK
+ * failure, or a more specific subclass for finer control.
+ */
+export declare class EBrocanteError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+/** HTTP 401 / 403 — invalid key, wrong scope, or mode mismatch. */
+export declare class AuthenticationError extends EBrocanteError {
+    readonly status: number;
+    constructor(message: string, status: number, options?: ErrorOptions);
+}
+/** HTTP 404 / 410 — resource missing or gone. */
+export declare class NotFoundError extends EBrocanteError {
+    readonly status: number;
+    constructor(message: string, status: number, options?: ErrorOptions);
+}
+/** HTTP 422 — request schema rejected. Carries the raw error body. */
+export declare class ValidationError extends EBrocanteError {
+    readonly status: number;
+    readonly body: string;
+    constructor(message: string, status: number, body: string, options?: ErrorOptions);
+}
+/** HTTP 429 — rate limit exhausted. `retryAfter` in seconds. */
+export declare class RateLimitError extends EBrocanteError {
+    readonly status: number;
+    readonly retryAfter: number;
+    constructor(message: string, status: number, retryAfter: number, options?: ErrorOptions);
+}
+/** HTTP 5xx (or any unmapped status) once retries have been exhausted. */
+export declare class ServerError extends EBrocanteError {
+    readonly status: number;
+    constructor(message: string, status: number, options?: ErrorOptions);
+}
+/** Transport-level failure (DNS, TCP timeout, broken pipe, abort, …). */
+export declare class NetworkError extends EBrocanteError {
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/exceptions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/exceptions/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qBAAa,cAAe,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAKtD;AAED,mEAAmE;AACnE,qBAAa,mBAAoB,SAAQ,cAAc;IAG/C,QAAQ,CAAC,MAAM,EAAE,MAAM;gBADvB,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,YAAY;CAI7B;AAED,iDAAiD;AACjD,qBAAa,aAAc,SAAQ,cAAc;IAGzC,QAAQ,CAAC,MAAM,EAAE,MAAM;gBADvB,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,YAAY;CAI7B;AAED,sEAAsE;AACtE,qBAAa,eAAgB,SAAQ,cAAc;IAG3C,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAFrB,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,YAAY;CAI7B;AAED,gEAAgE;AAChE,qBAAa,cAAe,SAAQ,cAAc;IAG1C,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM;gBAF3B,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAC3B,OAAO,CAAC,EAAE,YAAY;CAI7B;AAED,0EAA0E;AAC1E,qBAAa,WAAY,SAAQ,cAAc;IAGvC,QAAQ,CAAC,MAAM,EAAE,MAAM;gBADvB,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,YAAY;CAI7B;AAED,yEAAyE;AACzE,qBAAa,YAAa,SAAQ,cAAc;CAAG"}

package/dist/exceptions/index.js

@@ -0,0 +1,62 @@
+/**
+ * @copyright 2026 Association E-Cosplay
+ * @license   Proprietary — see LICENSE
+ *
+ * Typed exception hierarchy. Catch `EBrocanteError` to handle any SDK
+ * failure, or a more specific subclass for finer control.
+ */
+export class EBrocanteError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = this.constructor.name;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/** HTTP 401 / 403 — invalid key, wrong scope, or mode mismatch. */
+export class AuthenticationError extends EBrocanteError {
+    status;
+    constructor(message, status, options) {
+        super(message, options);
+        this.status = status;
+    }
+}
+/** HTTP 404 / 410 — resource missing or gone. */
+export class NotFoundError extends EBrocanteError {
+    status;
+    constructor(message, status, options) {
+        super(message, options);
+        this.status = status;
+    }
+}
+/** HTTP 422 — request schema rejected. Carries the raw error body. */
+export class ValidationError extends EBrocanteError {
+    status;
+    body;
+    constructor(message, status, body, options) {
+        super(message, options);
+        this.status = status;
+        this.body = body;
+    }
+}
+/** HTTP 429 — rate limit exhausted. `retryAfter` in seconds. */
+export class RateLimitError extends EBrocanteError {
+    status;
+    retryAfter;
+    constructor(message, status, retryAfter, options) {
+        super(message, options);
+        this.status = status;
+        this.retryAfter = retryAfter;
+    }
+}
+/** HTTP 5xx (or any unmapped status) once retries have been exhausted. */
+export class ServerError extends EBrocanteError {
+    status;
+    constructor(message, status, options) {
+        super(message, options);
+        this.status = status;
+    }
+}
+/** Transport-level failure (DNS, TCP timeout, broken pipe, abort, …). */
+export class NetworkError extends EBrocanteError {
+}
+//# sourceMappingURL=index.js.map

package/dist/exceptions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/exceptions/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,OAAO,cAAe,SAAQ,KAAK;IACrC,YAAY,OAAe,EAAE,OAAsB;QAC/C,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC;CACJ;AAED,mEAAmE;AACnE,MAAM,OAAO,mBAAoB,SAAQ,cAAc;IAGtC;IAFb,YACI,OAAe,EACN,MAAc,EACvB,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAHf,WAAM,GAAN,MAAM,CAAQ;IAI3B,CAAC;CACJ;AAED,iDAAiD;AACjD,MAAM,OAAO,aAAc,SAAQ,cAAc;IAGhC;IAFb,YACI,OAAe,EACN,MAAc,EACvB,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAHf,WAAM,GAAN,MAAM,CAAQ;IAI3B,CAAC;CACJ;AAED,sEAAsE;AACtE,MAAM,OAAO,eAAgB,SAAQ,cAAc;IAGlC;IACA;IAHb,YACI,OAAe,EACN,MAAc,EACd,IAAY,EACrB,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAJf,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAQ;IAIzB,CAAC;CACJ;AAED,gEAAgE;AAChE,MAAM,OAAO,cAAe,SAAQ,cAAc;IAGjC;IACA;IAHb,YACI,OAAe,EACN,MAAc,EACd,UAAkB,EAC3B,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAJf,WAAM,GAAN,MAAM,CAAQ;QACd,eAAU,GAAV,UAAU,CAAQ;IAI/B,CAAC;CACJ;AAED,0EAA0E;AAC1E,MAAM,OAAO,WAAY,SAAQ,cAAc;IAG9B;IAFb,YACI,OAAe,EACN,MAAc,EACvB,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAHf,WAAM,GAAN,MAAM,CAAQ;IAI3B,CAAC;CACJ;AAED,yEAAyE;AACzE,MAAM,OAAO,YAAa,SAAQ,cAAc;CAAG"}

package/dist/http/HttpClient.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @copyright 2026 Association E-Cosplay
+ * @license   Proprietary — see LICENSE
+ */
+import type { CacheBackend } from '../cache/CacheBackend.js';
+import type { DebugWriter } from '../logger/DebugWriter.js';
+import type { Logger } from '../logger/Logger.js';
+import type { Mode, RequestOptions } from '../types.js';
+export declare const SDK_VERSION = "1.0.2";
+export interface HttpClientDeps {
+    apiKey: string;
+    brocEmail: string;
+    mode: Mode;
+    baseUrl: string;
+    timeoutMs: number;
+    cache: CacheBackend;
+    logger: Logger;
+    debugWriter: DebugWriter | null;
+    maxRetries: number;
+    fetchImpl: typeof fetch;
+}
+/** @internal */
+export declare class HttpClient {
+    private readonly deps;
+    constructor(deps: HttpClientDeps);
+    get cache(): CacheBackend;
+    get(endpoint: string, query?: Record<string, unknown>, opts?: RequestOptions): Promise<Record<string, unknown>>;
+    makeCacheKey(endpoint: string, query: Record<string, unknown>): string;
+    private buildPath;
+    private encodeQuery;
+    private sendWithRetry;
+    private attemptOrRetryConnect;
+    private handleConnectError;
+    private shouldRetryStatus;
+    private applyRetryDelay;
+    private buildHttpError;
+    private sleepBackoff;
+    private decode;
+    private extractErrorMessage;
+}
+//# sourceMappingURL=HttpClient.d.ts.map

package/dist/http/HttpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpClient.d.ts","sourceRoot":"","sources":["../../src/http/HttpClient.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAW7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAExD,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,KAAK,CAAC;CAC3B;AAED,gBAAgB;AAChB,qBAAa,UAAU;IACP,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,cAAc;IAEjD,IAAI,KAAK,IAAI,YAAY,CAExB;IAEK,GAAG,CACL,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACnC,IAAI,GAAE,cAAmB,GAC1B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IA8CnC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAItE,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,WAAW;YAUL,aAAa;YAoBb,qBAAqB;YAuBrB,kBAAkB;IAahC,OAAO,CAAC,iBAAiB;YAIX,eAAe;YAef,cAAc;YAiBd,YAAY;IAO1B,OAAO,CAAC,MAAM;IAcd,OAAO,CAAC,mBAAmB;CAuB9B"}