@ecosplay/e-brocante 1.0.2

package/dist/http/HttpClient.js

@@ -0,0 +1,222 @@
+/**
+ * @copyright 2026 Association E-Cosplay
+ * @license   Proprietary — see LICENSE
+ */
+import { stableHashKey } from '../cache/stableHashKey.js';
+import { AuthenticationError, NetworkError, NotFoundError, RateLimitError, ServerError, ValidationError, } from '../exceptions/index.js';
+import { stringifyPrimitive, trimLeadingSlash, trimTrailingSlash } from '../internal/safeStrings.js';
+export const SDK_VERSION = '1.0.2';
+/** @internal */
+export class HttpClient {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    get cache() {
+        return this.deps.cache;
+    }
+    async get(endpoint, query = {}, opts = {}) {
+        const path = this.buildPath(endpoint);
+        const cacheKey = this.makeCacheKey(endpoint, query);
+        const skipCache = opts.skipCache === true;
+        if (!skipCache) {
+            const cached = await this.deps.cache.get(cacheKey);
+            if (cached !== null && cached !== undefined) {
+                this.deps.logger.debug('cache hit', { endpoint, key: cacheKey });
+                this.deps.debugWriter?.log(`GET ${path}`, { cache: 'hit', key: cacheKey });
+                return cached;
+            }
+        }
+        const url = `${trimTrailingSlash(this.deps.baseUrl)}${path}${this.encodeQuery(query)}`;
+        const start = performance.now();
+        const response = await this.sendWithRetry(url);
+        const durationMs = Math.round(performance.now() - start);
+        const body = await response.text();
+        const payload = this.decode(body);
+        const reqId = response.headers.get('x-request-id');
+        this.deps.logger.info('api call', {
+            method: 'GET',
+            endpoint,
+            mode: this.deps.mode,
+            status: response.status,
+            duration_ms: durationMs,
+            cached: false,
+            request_id: reqId,
+        });
+        this.deps.debugWriter?.log(`GET ${path}${this.encodeQuery(query)} -> ${response.status}`, {
+            ms: durationMs,
+            cache: 'miss',
+            req: reqId,
+        });
+        if (!skipCache) {
+            await this.deps.cache.set(cacheKey, payload, opts.ttl);
+            this.deps.debugWriter?.log('cache.set', { key: cacheKey, ttl: opts.ttl ?? 'default' });
+        }
+        return payload;
+    }
+    makeCacheKey(endpoint, query) {
+        return `${this.deps.mode}:${stableHashKey(endpoint, { ...query, _broc: this.deps.brocEmail })}`;
+    }
+    buildPath(endpoint) {
+        return `/api/${this.deps.mode}/${trimLeadingSlash(endpoint)}`;
+    }
+    encodeQuery(query) {
+        const parts = [];
+        for (const [k, v] of Object.entries(query)) {
+            if (v === null || v === undefined || v === '')
+                continue;
+            const value = stringifyPrimitive(v);
+            parts.push(`${encodeURIComponent(k)}=${encodeURIComponent(value)}`);
+        }
+        return parts.length === 0 ? '' : `?${parts.join('&')}`;
+    }
+    async sendWithRetry(url) {
+        let attempt = 0;
+        while (true) {
+            attempt++;
+            const response = await this.attemptOrRetryConnect(url, attempt);
+            if (response === null)
+                continue;
+            if (response.status >= 200 && response.status < 300) {
+                return response;
+            }
+            if (this.shouldRetryStatus(response.status, attempt)) {
+                await this.applyRetryDelay(response, response.status, attempt);
+                continue;
+            }
+            throw await this.buildHttpError(response);
+        }
+    }
+    async attemptOrRetryConnect(url, attempt) {
+        const ac = new AbortController();
+        const timer = setTimeout(() => ac.abort(), this.deps.timeoutMs);
+        let response;
+        try {
+            response = await this.deps.fetchImpl(url, {
+                method: 'GET',
+                headers: {
+                    'X-KEY': this.deps.apiKey,
+                    'X-BROC': this.deps.brocEmail,
+                    Accept: 'application/json',
+                    'User-Agent': `e-brocante-js/${SDK_VERSION} (Node/Bun)`,
+                },
+                signal: ac.signal,
+            });
+        }
+        catch (cause) {
+            clearTimeout(timer);
+            return this.handleConnectError(cause, attempt);
+        }
+        clearTimeout(timer);
+        return response;
+    }
+    async handleConnectError(cause, attempt) {
+        const message = errorMessage(cause);
+        if (attempt > this.deps.maxRetries) {
+            this.deps.logger.error('connection failed (gave up)', { attempt, error: message });
+            throw new NetworkError(`Connection failed after ${this.deps.maxRetries} retries: ${message}`, {
+                cause,
+            });
+        }
+        this.deps.logger.warn('connection failed, retrying', { attempt, error: message });
+        await this.sleepBackoff(attempt);
+        return null;
+    }
+    shouldRetryStatus(status, attempt) {
+        return (status === 429 || status >= 500) && attempt <= this.deps.maxRetries;
+    }
+    async applyRetryDelay(response, status, attempt) {
+        const retryAfter = Number(response.headers.get('retry-after') ?? 0);
+        this.deps.logger.warn('retryable status, retrying', {
+            status,
+            attempt,
+            retry_after: retryAfter,
+        });
+        this.deps.debugWriter?.log('retry', { attempt, status, retry_after: retryAfter });
+        if (retryAfter > 0) {
+            await sleep(Math.min(retryAfter, 30) * 1000);
+            return;
+        }
+        await this.sleepBackoff(attempt);
+    }
+    async buildHttpError(response) {
+        const body = await response.text();
+        const message = this.extractErrorMessage(body) ?? `HTTP ${response.status}`;
+        this.deps.logger.error('api error', { status: response.status, message });
+        this.deps.debugWriter?.log('error', { status: response.status, message });
+        const status = response.status;
+        if (status === 401 || status === 403)
+            return new AuthenticationError(message, status);
+        if (status === 404 || status === 410)
+            return new NotFoundError(message, status);
+        if (status === 422)
+            return new ValidationError(message, status, body);
+        if (status === 429) {
+            const retryAfter = response.headers.get('retry-after');
+            return new RateLimitError(message, status, retryAfter ? Number(retryAfter) : 0);
+        }
+        return new ServerError(message, status);
+    }
+    async sleepBackoff(attempt) {
+        // Exponential backoff with jitter (0.5s -> 1s -> 2s -> 4s …, capped at 30s).
+        const base = Math.min(0.5 * 2 ** (attempt - 1), 30);
+        const jitter = secureJitter() / 1000;
+        await sleep((base + jitter) * 1000);
+    }
+    decode(body) {
+        if (body === '')
+            return {};
+        let decoded;
+        try {
+            decoded = JSON.parse(body);
+        }
+        catch (cause) {
+            throw new ServerError(`Invalid JSON response: ${cause.message}`, 0, { cause });
+        }
+        if (decoded === null || typeof decoded !== 'object' || Array.isArray(decoded)) {
+            throw new ServerError('Unexpected JSON response (not an object)', 0);
+        }
+        return decoded;
+    }
+    extractErrorMessage(body) {
+        if (body === '')
+            return null;
+        let decoded;
+        try {
+            decoded = JSON.parse(body);
+        }
+        catch {
+            decoded = null;
+        }
+        let candidate = null;
+        if (decoded && typeof decoded === 'object') {
+            const d = decoded;
+            const errs = d.errors;
+            if (Array.isArray(errs) && errs[0] && typeof errs[0] === 'object') {
+                const first = errs[0];
+                candidate = first.title;
+            }
+            if (typeof candidate !== 'string') {
+                candidate = d.message;
+            }
+        }
+        return typeof candidate === 'string' ? candidate : null;
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function errorMessage(cause) {
+    return cause instanceof Error ? cause.message : String(cause);
+}
+function secureJitter() {
+    // 0..250 ms, derived from a CSPRNG to satisfy SonarQube S2245.
+    const buf = new Uint32Array(1);
+    crypto.getRandomValues(buf);
+    const raw = buf[0];
+    /* v8 ignore next — buf[0] is always populated by getRandomValues */
+    if (raw === undefined)
+        return 0;
+    return Math.floor(raw % 251);
+}
+//# sourceMappingURL=HttpClient.js.map

package/dist/http/HttpClient.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * e-brocante JavaScript / TypeScript SDK — public entry point
+ *
+ * @copyright 2026 Association E-Cosplay
+ * @license   Proprietary — see LICENSE
+ */
+export { EBrocanteClient } from './EBrocanteClient.js';
+export type { EBrocanteClientOptions, EventFilters, OrgaFilters, Mode, CacheType, RequestOptions, } from './types.js';
+export type { CacheBackend } from './cache/CacheBackend.js';
+export { LocalCache } from './cache/LocalCache.js';
+export { NullCache } from './cache/NullCache.js';
+export { RedisCache, type RedisLikeClient } from './cache/RedisCache.js';
+export { type RedisConfig, DEFAULT_REDIS_CONFIG } from './cache/RedisConfig.js';
+export type { Logger, LogLevel } from './logger/Logger.js';
+export { NullLogger } from './logger/NullLogger.js';
+export { FileLogger } from './logger/FileLogger.js';
+export { DebugWriter } from './logger/DebugWriter.js';
+export { EBrocanteError, AuthenticationError, NotFoundError, ValidationError, RateLimitError, ServerError, NetworkError, } from './exceptions/index.js';
+export type { EventDto } from './models/Event.js';
+export type { OrgaDto } from './models/Orga.js';
+export { PaginatedResult, type PaginationMeta } from './models/PaginatedResult.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,YAAY,EACR,sBAAsB,EACtB,YAAY,EACZ,WAAW,EACX,IAAI,EACJ,SAAS,EACT,cAAc,GACjB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,KAAK,WAAW,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEhF,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EACH,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,cAAc,EACd,WAAW,EACX,YAAY,GACf,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,YAAY,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * e-brocante JavaScript / TypeScript SDK — public entry point
+ *
+ * @copyright 2026 Association E-Cosplay
+ * @license   Proprietary — see LICENSE
+ */
+export { EBrocanteClient } from './EBrocanteClient.js';
+export { LocalCache } from './cache/LocalCache.js';
+export { NullCache } from './cache/NullCache.js';
+export { RedisCache } from './cache/RedisCache.js';
+export { DEFAULT_REDIS_CONFIG } from './cache/RedisConfig.js';
+export { NullLogger } from './logger/NullLogger.js';
+export { FileLogger } from './logger/FileLogger.js';
+export { DebugWriter } from './logger/DebugWriter.js';
+export { EBrocanteError, AuthenticationError, NotFoundError, ValidationError, RateLimitError, ServerError, NetworkError, } from './exceptions/index.js';
+export { PaginatedResult } from './models/PaginatedResult.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAYvD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAwB,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAoB,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAGhF,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EACH,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,cAAc,EACd,WAAW,EACX,YAAY,GACf,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EAAE,eAAe,EAAuB,MAAM,6BAA6B,CAAC"}

package/dist/internal/safeStrings.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @copyright 2026 Association E-Cosplay
+ * @license   Proprietary — see LICENSE
+ *
+ * Hand-rolled string helpers used in place of unbounded regular
+ * expressions so that no input can trigger super-linear runtime
+ * (SonarQube rule S5852 / ReDoS). Every loop here is strictly O(n).
+ *
+ * @internal
+ */
+/** Strip every leading `/` from a string. O(n). */
+export declare function trimLeadingSlash(s: string): string;
+/** Strip every trailing `/` from a string. O(n). */
+export declare function trimTrailingSlash(s: string): string;
+/** Strip leading AND trailing `/`. O(n). */
+export declare function trimSlashes(s: string): string;
+/** Replace every `/` with `.`. O(n). */
+export declare function slashesToDots(s: string): string;
+/** Coerce an unknown value to a string, falling back when it isn't one. */
+export declare function asString(v: unknown, fallback?: string): string;
+/** Coerce an unknown value to a finite number, falling back when it isn't. */
+export declare function asNumber(v: unknown, fallback?: number): number;
+/** Coerce an unknown value to a boolean (truthy primitives only). */
+export declare function asBoolean(v: unknown): boolean;
+/** Returns the string value when truthy, otherwise null. */
+export declare function asNullableString(v: unknown): string | null;
+/** Parse an ISO-8601 string into a Date, returning null on garbage. */
+export declare function asDate(v: unknown): Date | null;
+/**
+ * Coerce an unknown value to a plain record. Returns an empty record
+ * on null, undefined, primitives, or arrays — never throws.
+ */
+export declare function asRecord(v: unknown): Record<string, unknown>;
+/**
+ * Coerce an unknown value to an integer, returning null when the input
+ * is empty, missing or not finite (vs. asNumber which falls back to 0).
+ */
+export declare function asNullableInt(v: unknown): number | null;
+/**
+ * Stringify a primitive value for use in URL query strings or cache keys.
+ * Refuses non-primitive values (objects, arrays, functions) to avoid the
+ * `[object Object]` foot-gun that `String(v)` produces for them.
+ */
+export declare function stringifyPrimitive(v: unknown): string;
+/**
+ * Strict, ReDoS-safe email validator. Constant-time wrt structure
+ * (single forward scan + a couple of bounded slices). Intentionally
+ * conservative — accepts the same shape as `/^[^@\s]+@[^@\s]+\.[^@\s]+$/`
+ * but with explicit upper bounds.
+ */
+export declare function isValidEmail(value: string): boolean;
+//# sourceMappingURL=safeStrings.d.ts.map

package/dist/internal/safeStrings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeStrings.d.ts","sourceRoot":"","sources":["../../src/internal/safeStrings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH,mDAAmD;AACnD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED,oDAAoD;AACpD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAInD;AAED,4CAA4C;AAC5C,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,wCAAwC;AACxC,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,2EAA2E;AAC3E,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,SAAK,GAAG,MAAM,CAE1D;AAED,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,SAAI,GAAG,MAAM,CAOzD;AAED,qEAAqE;AACrE,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAE7C;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAE1D;AAED,uEAAuE;AACvE,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAI9C;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAK5D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAIvD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAMrD;AAiCD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAMnD"}

package/dist/internal/safeStrings.js

@@ -0,0 +1,156 @@
+/**
+ * @copyright 2026 Association E-Cosplay
+ * @license   Proprietary — see LICENSE
+ *
+ * Hand-rolled string helpers used in place of unbounded regular
+ * expressions so that no input can trigger super-linear runtime
+ * (SonarQube rule S5852 / ReDoS). Every loop here is strictly O(n).
+ *
+ * @internal
+ */
+const SLASH = 0x2f;
+const AT = 0x40;
+const DOT = 0x2e;
+const SPACE = 0x20;
+const TAB = 0x09;
+const LF = 0x0a;
+const CR = 0x0d;
+const MAX_EMAIL_LENGTH = 254;
+/** Strip every leading `/` from a string. O(n). */
+export function trimLeadingSlash(s) {
+    let i = 0;
+    while (i < s.length && s.codePointAt(i) === SLASH)
+        i++;
+    return i === 0 ? s : s.slice(i);
+}
+/** Strip every trailing `/` from a string. O(n). */
+export function trimTrailingSlash(s) {
+    let end = s.length;
+    while (end > 0 && s.codePointAt(end - 1) === SLASH)
+        end--;
+    return end === s.length ? s : s.slice(0, end);
+}
+/** Strip leading AND trailing `/`. O(n). */
+export function trimSlashes(s) {
+    return trimTrailingSlash(trimLeadingSlash(s));
+}
+/** Replace every `/` with `.`. O(n). */
+export function slashesToDots(s) {
+    return s.replaceAll('/', '.');
+}
+/** Coerce an unknown value to a string, falling back when it isn't one. */
+export function asString(v, fallback = '') {
+    return typeof v === 'string' ? v : fallback;
+}
+/** Coerce an unknown value to a finite number, falling back when it isn't. */
+export function asNumber(v, fallback = 0) {
+    if (typeof v === 'number' && Number.isFinite(v))
+        return v;
+    if (typeof v === 'string' && v !== '') {
+        const n = Number(v);
+        if (Number.isFinite(n))
+            return n;
+    }
+    return fallback;
+}
+/** Coerce an unknown value to a boolean (truthy primitives only). */
+export function asBoolean(v) {
+    return v === true || v === 'true' || v === 1 || v === '1';
+}
+/** Returns the string value when truthy, otherwise null. */
+export function asNullableString(v) {
+    return typeof v === 'string' && v !== '' ? v : null;
+}
+/** Parse an ISO-8601 string into a Date, returning null on garbage. */
+export function asDate(v) {
+    if (typeof v !== 'string' || v === '')
+        return null;
+    const d = new Date(v);
+    return Number.isNaN(d.getTime()) ? null : d;
+}
+/**
+ * Coerce an unknown value to a plain record. Returns an empty record
+ * on null, undefined, primitives, or arrays — never throws.
+ */
+export function asRecord(v) {
+    if (v === null || v === undefined)
+        return {};
+    if (typeof v !== 'object')
+        return {};
+    if (Array.isArray(v))
+        return {};
+    return v;
+}
+/**
+ * Coerce an unknown value to an integer, returning null when the input
+ * is empty, missing or not finite (vs. asNumber which falls back to 0).
+ */
+export function asNullableInt(v) {
+    if (v === null || v === undefined || v === '')
+        return null;
+    const n = asNumber(v, Number.NaN);
+    return Number.isFinite(n) ? n : null;
+}
+/**
+ * Stringify a primitive value for use in URL query strings or cache keys.
+ * Refuses non-primitive values (objects, arrays, functions) to avoid the
+ * `[object Object]` foot-gun that `String(v)` produces for them.
+ */
+export function stringifyPrimitive(v) {
+    if (v === null || v === undefined)
+        return '';
+    if (typeof v === 'string')
+        return v;
+    if (typeof v === 'number' || typeof v === 'bigint')
+        return String(v);
+    if (typeof v === 'boolean')
+        return v ? 'true' : 'false';
+    throw new TypeError(`Cannot stringify ${typeof v} value as a query/cache parameter.`);
+}
+function isWhitespaceCode(code) {
+    return code === SPACE || code === TAB || code === LF || code === CR;
+}
+/** Find the index of `@` in a single forward scan, returning -1 on failure
+ *  (no `@`, multiple `@`, or any whitespace anywhere). */
+function findSingleAt(value) {
+    let at = -1;
+    for (let i = 0; i < value.length; i++) {
+        const c = value.codePointAt(i);
+        if (isWhitespaceCode(c))
+            return -1;
+        if (c === AT) {
+            if (at !== -1)
+                return -1; // more than one '@'
+            at = i;
+        }
+    }
+    return at;
+}
+/** Validate the domain part has a valid dot (not at the boundary). */
+function hasInteriorDot(domain) {
+    for (let i = 0; i < domain.length; i++) {
+        if (domain.codePointAt(i) === DOT) {
+            // Reject leading dot, trailing dot.
+            if (i === 0 || i === domain.length - 1)
+                return false;
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Strict, ReDoS-safe email validator. Constant-time wrt structure
+ * (single forward scan + a couple of bounded slices). Intentionally
+ * conservative — accepts the same shape as `/^[^@\s]+@[^@\s]+\.[^@\s]+$/`
+ * but with explicit upper bounds.
+ */
+export function isValidEmail(value) {
+    const len = value.length;
+    if (len === 0 || len > MAX_EMAIL_LENGTH)
+        return false;
+    const at = findSingleAt(value);
+    if (at < 1 || at >= len - 1)
+        return false;
+    return hasInteriorDot(value.slice(at + 1));
+}
+//# sourceMappingURL=safeStrings.js.map

package/dist/internal/safeStrings.js.map

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

package/dist/logger/DebugWriter.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @copyright 2026 Association E-Cosplay
+ * @license   Proprietary — see LICENSE
+ */
+/**
+ * Plain-text debug writer. Appends ONE LINE per SDK action to a file
+ * (default: `./DEBUG.TXT`). Designed for `tail -f DEBUG.TXT` during
+ * development; not intended for production observability — use
+ * FileLogger or a custom Logger for that.
+ *
+ * Output format:
+ *   [2026-05-10 19:30:01.123] GET /api/prod/events?city=Paris -> 200 ms=45 cache=miss req=req_xxx
+ *   [2026-05-10 19:30:01.456] cache.set key=events.list:abc ttl=300
+ *   [2026-05-10 19:30:05.789] GET /api/prod/events?city=Paris cache=hit
+ *   [2026-05-10 19:31:10.001] retry attempt=2 status=429 retry_after=3
+ *   [2026-05-10 19:32:00.555] error status=401 message="HTTP 401"
+ */
+export declare class DebugWriter {
+    readonly file: string;
+    constructor(file?: string);
+    log(action: string, fields?: Record<string, unknown>): void;
+    private stringify;
+}
+//# sourceMappingURL=DebugWriter.d.ts.map

package/dist/logger/DebugWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DebugWriter.d.ts","sourceRoot":"","sources":["../../src/logger/DebugWriter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAW;aACQ,IAAI,EAAE,MAAM;gBAAZ,IAAI,GAAE,MAAoB;IAatD,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;IAmB/D,OAAO,CAAC,SAAS;CAKpB"}

package/dist/logger/DebugWriter.js

@@ -0,0 +1,62 @@
+/**
+ * @copyright 2026 Association E-Cosplay
+ * @license   Proprietary — see LICENSE
+ */
+import { appendFileSync, existsSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { EBrocanteError } from '../exceptions/index.js';
+/**
+ * Plain-text debug writer. Appends ONE LINE per SDK action to a file
+ * (default: `./DEBUG.TXT`). Designed for `tail -f DEBUG.TXT` during
+ * development; not intended for production observability — use
+ * FileLogger or a custom Logger for that.
+ *
+ * Output format:
+ *   [2026-05-10 19:30:01.123] GET /api/prod/events?city=Paris -> 200 ms=45 cache=miss req=req_xxx
+ *   [2026-05-10 19:30:01.456] cache.set key=events.list:abc ttl=300
+ *   [2026-05-10 19:30:05.789] GET /api/prod/events?city=Paris cache=hit
+ *   [2026-05-10 19:31:10.001] retry attempt=2 status=429 retry_after=3
+ *   [2026-05-10 19:32:00.555] error status=401 message="HTTP 401"
+ */
+export class DebugWriter {
+    file;
+    constructor(file = 'DEBUG.TXT') {
+        this.file = file;
+        const dir = dirname(file);
+        if (dir && dir !== '.' && !existsSync(dir)) {
+            /* v8 ignore start — fs error mid-process (full disk, EROFS) */
+            try {
+                mkdirSync(dir, { recursive: true, mode: 0o755 });
+            }
+            catch (cause) {
+                throw new EBrocanteError(`Cannot create debug directory: ${dir}`, { cause });
+            }
+            /* v8 ignore stop */
+        }
+    }
+    log(action, fields = {}) {
+        const parts = [];
+        for (const [k, v] of Object.entries(fields)) {
+            if (v === null || v === undefined || v === '')
+                continue;
+            parts.push(`${k}=${this.stringify(v)}`);
+        }
+        const ts = new Date().toISOString().replace('T', ' ').replace('Z', '').slice(0, 23);
+        const line = parts.length > 0 ? `[${ts}] ${action} ${parts.join(' ')}` : `[${ts}] ${action}`;
+        try {
+            appendFileSync(this.file, `${line}\n`, { mode: 0o644 });
+            /* v8 ignore start — best-effort; only triggers on fs errors */
+        }
+        catch {
+            // swallowed
+        }
+        /* v8 ignore stop */
+    }
+    stringify(v) {
+        if (typeof v === 'boolean')
+            return v ? 'true' : 'false';
+        const s = String(v);
+        return s.includes(' ') ? `"${s}"` : s;
+    }
+}
+//# sourceMappingURL=DebugWriter.js.map

package/dist/logger/DebugWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DebugWriter.js","sourceRoot":"","sources":["../../src/logger/DebugWriter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,WAAW;IACQ;IAA5B,YAA4B,OAAe,WAAW;QAA1B,SAAI,GAAJ,IAAI,CAAsB;QAClD,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzC,+DAA+D;YAC/D,IAAI,CAAC;gBACD,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACrD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,MAAM,IAAI,cAAc,CAAC,kCAAkC,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YACjF,CAAC;YACD,oBAAoB;QACxB,CAAC;IACL,CAAC;IAED,GAAG,CAAC,MAAc,EAAE,SAAkC,EAAE;QACpD,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE;gBAAE,SAAS;YACxD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAEpF,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;QAC7F,IAAI,CAAC;YACD,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACxD,+DAA+D;QACnE,CAAC;QAAC,MAAM,CAAC;YACL,YAAY;QAChB,CAAC;QACD,oBAAoB;IACxB,CAAC;IAEO,SAAS,CAAC,CAAU;QACxB,IAAI,OAAO,CAAC,KAAK,SAAS;YAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;QACxD,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;CACJ"}

package/dist/logger/FileLogger.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @copyright 2026 Association E-Cosplay
+ * @license   Proprietary — see LICENSE
+ */
+import type { LogLevel, Logger } from './Logger.js';
+/**
+ * File logger that appends one JSON-line per record to a date-stamped
+ * file in the configured directory. One file per UTC day:
+ * `ebrocante-YYYY-MM-DD.log`. Suitable for log shippers (Vector,
+ * Filebeat, Fluent Bit) and `tail -f` during local development.
+ *
+ * Sensitive context keys are automatically redacted (`api_key`,
+ * `X-KEY` and `Authorization` headers).
+ */
+export declare class FileLogger implements Logger {
+    private readonly directory;
+    private readonly minLevel;
+    constructor(directory: string, minLevel?: LogLevel);
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+    private write;
+    private sanitize;
+}
+//# sourceMappingURL=FileLogger.d.ts.map

package/dist/logger/FileLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileLogger.d.ts","sourceRoot":"","sources":["../../src/logger/FileLogger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AASpD;;;;;;;;GAQG;AACH,qBAAa,UAAW,YAAW,MAAM;IAIjC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAH9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAGb,SAAS,EAAE,MAAM,EAClC,QAAQ,GAAE,QAAiB;IAqB/B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;IAInE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;IAIlE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;IAIlE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;IAInE,OAAO,CAAC,KAAK;IAqBb,OAAO,CAAC,QAAQ;CAgBnB"}