meridianjs 0.1.0

package/dist/strategies/idempotency.js

@@ -0,0 +1,55 @@
+import { IdempotencyLevel, } from "../core/types.js";
+export class IdempotencyResolver {
+    config;
+    defaultLevel;
+    constructor(config, defaultLevel = IdempotencyLevel.SAFE) {
+        this.config = {
+            defaultSafeOperations: config.defaultSafeOperations ??
+                new Set(["GET", "HEAD", "OPTIONS"]),
+            operationOverrides: config.operationOverrides ?? new Map(),
+        };
+        this.defaultLevel = defaultLevel;
+    }
+    getIdempotencyLevel(method, endpoint, _options) {
+        const operationKey = `${method} ${endpoint}`;
+        const override = this.findOverride(operationKey);
+        if (override !== null) {
+            return override;
+        }
+        if (this.config.defaultSafeOperations.has(method.toUpperCase())) {
+            return IdempotencyLevel.SAFE;
+        }
+        return this.defaultLevel;
+    }
+    findOverride(operationKey) {
+        if (this.config.operationOverrides.has(operationKey)) {
+            return this.config.operationOverrides.get(operationKey);
+        }
+        for (const [pattern, level] of this.config.operationOverrides.entries()) {
+            if (this.matchesPattern(pattern, operationKey)) {
+                return level;
+            }
+        }
+        return null;
+    }
+    matchesPattern(pattern, operationKey) {
+        const regexPattern = pattern.replace(/:[\w-]+/g, "[^/]+");
+        const regex = new RegExp(`^${regexPattern}$`);
+        return regex.test(operationKey);
+    }
+    shouldRetry(idempotencyLevel, _error, attempt, maxRetries, hasIdempotencyKey) {
+        if (idempotencyLevel === IdempotencyLevel.UNSAFE) {
+            return false;
+        }
+        if (idempotencyLevel === IdempotencyLevel.CONDITIONAL) {
+            if (!hasIdempotencyKey) {
+                return false;
+            }
+        }
+        if (attempt >= maxRetries) {
+            return false;
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=idempotency.js.map

package/dist/strategies/idempotency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.js","sourceRoot":"","sources":["../../src/strategies/idempotency.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,gBAAgB,GAGjB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,OAAO,mBAAmB;IACtB,MAAM,CAAoB;IAC1B,YAAY,CAAmB;IAEvC,YACE,MAAkC,EAClC,eAAiC,gBAAgB,CAAC,IAAI;QAEtD,IAAI,CAAC,MAAM,GAAG;YACZ,qBAAqB,EACnB,MAAM,CAAC,qBAAqB;gBAC5B,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;YACrC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,IAAI,IAAI,GAAG,EAAE;SAC3D,CAAC;QACF,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED,mBAAmB,CACjB,MAAc,EACd,QAAgB,EAChB,QAAwB;QAGxB,MAAM,YAAY,GAAG,GAAG,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;QACjD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,OAAO,QAAQ,CAAC;QAClB,CAAC;QAGD,IAAI,IAAI,CAAC,MAAM,CAAC,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YAChE,OAAO,gBAAgB,CAAC,IAAI,CAAC;QAC/B,CAAC;QAGD,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAEO,YAAY,CAAC,YAAoB;QAEvC,IAAI,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YACrD,OAAO,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,YAAY,CAAE,CAAC;QAC3D,CAAC;QAGD,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,EAAE,CAAC;YACxE,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,CAAC;gBAC/C,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,cAAc,CAAC,OAAe,EAAE,YAAoB;QAE1D,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAClC,UAAU,EACV,OAAO,CACR,CAAC;QACF,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC;QAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAClC,CAAC;IAED,WAAW,CACT,gBAAkC,EAClC,MAAa,EACb,OAAe,EACf,UAAkB,EAClB,iBAA0B;QAE1B,IAAI,gBAAgB,KAAK,gBAAgB,CAAC,MAAM,EAAE,CAAC;YACjD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,gBAAgB,KAAK,gBAAgB,CAAC,WAAW,EAAE,CAAC;YACtD,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBACvB,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,IAAI,OAAO,IAAI,UAAU,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC;QACf,CAAC;QAGD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/strategies/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./circuit-breaker.js";
+export * from "./idempotency.js";
+export * from "./rate-limit.js";
+export * from "./retry.js";
+export * from "./pagination.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/strategies/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/strategies/index.js

@@ -0,0 +1,6 @@
+export * from "./circuit-breaker.js";
+export * from "./idempotency.js";
+export * from "./rate-limit.js";
+export * from "./retry.js";
+export * from "./pagination.js";
+//# sourceMappingURL=index.js.map

package/dist/strategies/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/strategies/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/strategies/pagination.d.ts

@@ -0,0 +1,29 @@
+import type { PaginationStrategy, RawResponse, RequestOptions } from "../core/types.js";
+export declare class CursorPaginationStrategy implements PaginationStrategy {
+    private cursorHeader;
+    private cursorQueryParam;
+    private totalHeader?;
+    constructor(cursorHeader?: string, cursorQueryParam?: string, totalHeader?: string);
+    extractCursor(response: RawResponse): string | null;
+    extractTotal(response: RawResponse): number | null;
+    hasNext(response: RawResponse): boolean;
+    buildNextRequest(endpoint: string, options: RequestOptions, cursor: string): {
+        endpoint: string;
+        options: RequestOptions;
+    };
+}
+export declare class OffsetPaginationStrategy implements PaginationStrategy {
+    private offsetQueryParam;
+    private limitQueryParam;
+    private totalHeader?;
+    private defaultLimit;
+    constructor(offsetQueryParam?: string, limitQueryParam?: string, totalHeader?: string, defaultLimit?: number);
+    extractCursor(response: RawResponse): string | null;
+    extractTotal(response: RawResponse): number | null;
+    hasNext(response: RawResponse): boolean;
+    buildNextRequest(endpoint: string, options: RequestOptions, cursor: string): {
+        endpoint: string;
+        options: RequestOptions;
+    };
+}
+//# sourceMappingURL=pagination.d.ts.map

package/dist/strategies/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/strategies/pagination.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAExF,qBAAa,wBAAyB,YAAW,kBAAkB;IACjE,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,WAAW,CAAC,CAAS;gBAG3B,YAAY,GAAE,MAAmB,EACjC,gBAAgB,GAAE,MAAiB,EACnC,WAAW,CAAC,EAAE,MAAM;IAStB,aAAa,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI;IAoBnD,YAAY,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI;IAqBlD,OAAO,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO;IAKvC,gBAAgB,CACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,GACb;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,cAAc,CAAA;KAAE;CAejD;AAED,qBAAa,wBAAyB,YAAW,kBAAkB;IACjE,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,YAAY,CAAS;gBAG3B,gBAAgB,GAAE,MAAiB,EACnC,eAAe,GAAE,MAAgB,EACjC,WAAW,CAAC,EAAE,MAAM,EACpB,YAAY,GAAE,MAAY;IAU5B,aAAa,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI;IAwBnD,YAAY,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI;IAoBlD,OAAO,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO;IAKvC,gBAAgB,CACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,GACb;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,cAAc,CAAA;KAAE;CAsBjD"}

package/dist/strategies/pagination.js

@@ -0,0 +1,130 @@
+export class CursorPaginationStrategy {
+    cursorHeader;
+    cursorQueryParam;
+    totalHeader;
+    constructor(cursorHeader = "X-Cursor", cursorQueryParam = "cursor", totalHeader) {
+        this.cursorHeader = cursorHeader;
+        this.cursorQueryParam = cursorQueryParam;
+        if (totalHeader !== undefined) {
+            this.totalHeader = totalHeader;
+        }
+    }
+    extractCursor(response) {
+        const cursor = response.headers.get(this.cursorHeader);
+        if (cursor) {
+            return cursor;
+        }
+        if (typeof response.body === "object" &&
+            response.body !== null &&
+            "cursor" in response.body) {
+            const body = response.body;
+            const bodyCursor = body.cursor;
+            return bodyCursor ?? null;
+        }
+        return null;
+    }
+    extractTotal(response) {
+        if (this.totalHeader) {
+            const total = response.headers.get(this.totalHeader);
+            if (total) {
+                return parseInt(total, 10);
+            }
+        }
+        if (typeof response.body === "object" &&
+            response.body !== null &&
+            "total" in response.body) {
+            const body = response.body;
+            return body.total ?? null;
+        }
+        return null;
+    }
+    hasNext(response) {
+        const cursor = this.extractCursor(response);
+        return cursor !== null && cursor !== "";
+    }
+    buildNextRequest(endpoint, options, cursor) {
+        const url = new URL(endpoint, "http://dummy");
+        url.searchParams.set(this.cursorQueryParam, cursor);
+        return {
+            endpoint: url.pathname + url.search,
+            options: {
+                ...options,
+                query: {
+                    ...options.query,
+                    [this.cursorQueryParam]: cursor,
+                },
+            },
+        };
+    }
+}
+export class OffsetPaginationStrategy {
+    offsetQueryParam;
+    limitQueryParam;
+    totalHeader;
+    defaultLimit;
+    constructor(offsetQueryParam = "offset", limitQueryParam = "limit", totalHeader, defaultLimit = 100) {
+        this.offsetQueryParam = offsetQueryParam;
+        this.limitQueryParam = limitQueryParam;
+        if (totalHeader !== undefined) {
+            this.totalHeader = totalHeader;
+        }
+        this.defaultLimit = defaultLimit;
+    }
+    extractCursor(response) {
+        const currentOffset = typeof response.body === "object" &&
+            response.body !== null &&
+            "offset" in response.body
+            ? response.body.offset ?? 0
+            : 0;
+        const limit = typeof response.body === "object" &&
+            response.body !== null &&
+            "limit" in response.body
+            ? response.body.limit ?? this.defaultLimit
+            : this.defaultLimit;
+        const total = this.extractTotal(response);
+        if (total !== null && currentOffset + limit >= total) {
+            return null;
+        }
+        return String(currentOffset + limit);
+    }
+    extractTotal(response) {
+        if (this.totalHeader) {
+            const total = response.headers.get(this.totalHeader);
+            if (total) {
+                return parseInt(total, 10);
+            }
+        }
+        if (typeof response.body === "object" &&
+            response.body !== null &&
+            "total" in response.body) {
+            const body = response.body;
+            return body.total ?? null;
+        }
+        return null;
+    }
+    hasNext(response) {
+        const cursor = this.extractCursor(response);
+        return cursor !== null;
+    }
+    buildNextRequest(endpoint, options, cursor) {
+        const offset = parseInt(cursor, 10);
+        const limitValue = options.query?.[this.limitQueryParam];
+        const limit = typeof limitValue === "number"
+            ? limitValue
+            : typeof limitValue === "string"
+                ? parseInt(limitValue, 10)
+                : this.defaultLimit;
+        return {
+            endpoint,
+            options: {
+                ...options,
+                query: {
+                    ...options.query,
+                    [this.offsetQueryParam]: String(offset),
+                    [this.limitQueryParam]: String(limit),
+                },
+            },
+        };
+    }
+}
+//# sourceMappingURL=pagination.js.map

package/dist/strategies/pagination.js.map

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

package/dist/strategies/rate-limit.d.ts

@@ -0,0 +1,16 @@
+import type { RateLimitConfig, RateLimitInfo } from "../core/types.js";
+export declare class RateLimiter {
+    private tokens;
+    private lastRefill;
+    private config;
+    private queue;
+    private processingQueue;
+    constructor(config?: Partial<RateLimitConfig>);
+    acquire(): Promise<void>;
+    private refill;
+    private processQueue;
+    updateFromHeaders(_headers: Headers, rateLimitInfo: RateLimitInfo): void;
+    handle429(retryAfter: number): void;
+    reset(): void;
+}
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/strategies/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../src/strategies/rate-limit.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEvE,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,KAAK,CAGL;IACR,OAAO,CAAC,eAAe,CAAS;gBAEpB,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM;IAW3C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB9B,OAAO,CAAC,MAAM;YAeA,YAAY;IA0B1B,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,GAAG,IAAI;IAgCxE,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAOnC,KAAK,IAAI,IAAI;CAQd"}

package/dist/strategies/rate-limit.js

@@ -0,0 +1,94 @@
+export class RateLimiter {
+    tokens;
+    lastRefill;
+    config;
+    queue = [];
+    processingQueue = false;
+    constructor(config = {}) {
+        this.config = {
+            tokensPerSecond: config.tokensPerSecond ?? 10,
+            maxTokens: config.maxTokens ?? 100,
+            adaptiveBackoff: config.adaptiveBackoff ?? true,
+            queueSize: config.queueSize ?? 50,
+        };
+        this.tokens = this.config.maxTokens;
+        this.lastRefill = Date.now();
+    }
+    async acquire() {
+        this.refill();
+        if (this.tokens >= 1) {
+            this.tokens--;
+            return;
+        }
+        if (this.config.queueSize && this.queue.length >= this.config.queueSize) {
+            throw new Error("Rate limit queue is full");
+        }
+        return new Promise((resolve, reject) => {
+            this.queue.push({ resolve, reject });
+            this.processQueue();
+        });
+    }
+    refill() {
+        const now = Date.now();
+        const elapsed = Math.max(0, (now - this.lastRefill) / 1000);
+        const tokensToAdd = elapsed * this.config.tokensPerSecond;
+        if (tokensToAdd > 0) {
+            this.tokens = Math.min(this.config.maxTokens, this.tokens + tokensToAdd);
+            this.lastRefill = now;
+        }
+    }
+    async processQueue() {
+        if (this.processingQueue || this.queue.length === 0) {
+            return;
+        }
+        this.processingQueue = true;
+        while (this.queue.length > 0) {
+            this.refill();
+            if (this.tokens >= 1) {
+                this.tokens--;
+                const item = this.queue.shift();
+                if (item) {
+                    item.resolve();
+                }
+            }
+            else {
+                const waitTime = (1 / this.config.tokensPerSecond) * 1000;
+                await new Promise((resolve) => setTimeout(resolve, waitTime));
+            }
+        }
+        this.processingQueue = false;
+    }
+    updateFromHeaders(_headers, rateLimitInfo) {
+        if (!this.config.adaptiveBackoff) {
+            return;
+        }
+        const remaining = rateLimitInfo.remaining;
+        const limit = rateLimitInfo.limit;
+        const reset = rateLimitInfo.reset.getTime();
+        const utilization = (limit - remaining) / limit;
+        if (utilization > 0.8) {
+            this.config.tokensPerSecond = Math.max(1, this.config.tokensPerSecond * 0.5);
+        }
+        const now = Date.now();
+        const timeUntilReset = reset - now;
+        if (timeUntilReset > 0 && remaining < limit) {
+            const tokensNeeded = limit - remaining;
+            const newRate = tokensNeeded / (timeUntilReset / 1000);
+            if (newRate > 0 && newRate < this.config.tokensPerSecond) {
+                this.config.tokensPerSecond = newRate;
+            }
+        }
+    }
+    handle429(retryAfter) {
+        if (this.config.adaptiveBackoff) {
+            this.lastRefill = Date.now() + retryAfter * 1000;
+        }
+    }
+    reset() {
+        this.tokens = this.config.maxTokens;
+        this.lastRefill = Date.now();
+        this.queue.forEach((item) => item.reject(new Error("Rate limiter was reset")));
+        this.queue = [];
+    }
+}
+//# sourceMappingURL=rate-limit.js.map

package/dist/strategies/rate-limit.js.map

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

package/dist/strategies/retry.d.ts

@@ -0,0 +1,13 @@
+import type { RetryConfig } from "../core/types.js";
+import { IdempotencyLevel } from "../core/types.js";
+import type { IdempotencyResolver } from "./idempotency.js";
+export declare class RetryStrategy {
+    private config;
+    constructor(config: Partial<RetryConfig> | undefined, _idempotencyResolver: IdempotencyResolver);
+    execute<T>(fn: () => Promise<T>, idempotencyLevel: IdempotencyLevel, hasIdempotencyKey: boolean, attempt?: number): Promise<T>;
+    private isExplicitlyRetryable;
+    private isIdempotencyProven;
+    private calculateDelay;
+    private sleep;
+}
+//# sourceMappingURL=retry.d.ts.map

package/dist/strategies/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/strategies/retry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAwB;gBAGpC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,YAAK,EACjC,oBAAoB,EAAE,mBAAmB;IAWrC,OAAO,CAAC,CAAC,EACb,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,gBAAgB,EAAE,gBAAgB,EAClC,iBAAiB,EAAE,OAAO,EAC1B,OAAO,GAAE,MAAU,GAClB,OAAO,CAAC,CAAC,CAAC;IAgCb,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,mBAAmB;IAiB3B,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,KAAK;CAGd"}

package/dist/strategies/retry.js

@@ -0,0 +1,62 @@
+import { IdempotencyLevel } from "../core/types.js";
+export class RetryStrategy {
+    config;
+    constructor(config = {}, _idempotencyResolver) {
+        this.config = {
+            maxRetries: config.maxRetries ?? 0,
+            baseDelay: config.baseDelay ?? 1000,
+            maxDelay: config.maxDelay ?? 30000,
+            jitter: config.jitter ?? true,
+        };
+    }
+    async execute(fn, idempotencyLevel, hasIdempotencyKey, attempt = 0) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            if (attempt >= this.config.maxRetries) {
+                throw error;
+            }
+            if (!this.isExplicitlyRetryable(error)) {
+                throw error;
+            }
+            if (!this.isIdempotencyProven(idempotencyLevel, hasIdempotencyKey)) {
+                throw error;
+            }
+            const delay = this.calculateDelay(attempt);
+            await this.sleep(delay);
+            return this.execute(fn, idempotencyLevel, hasIdempotencyKey, attempt + 1);
+        }
+    }
+    isExplicitlyRetryable(error) {
+        if (error && typeof error === "object" && "retryable" in error) {
+            return error.retryable === true;
+        }
+        return false;
+    }
+    isIdempotencyProven(idempotencyLevel, hasIdempotencyKey) {
+        switch (idempotencyLevel) {
+            case IdempotencyLevel.SAFE:
+            case IdempotencyLevel.IDEMPOTENT:
+                return true;
+            case IdempotencyLevel.CONDITIONAL:
+                return hasIdempotencyKey;
+            case IdempotencyLevel.UNSAFE:
+                return false;
+            default:
+                return false;
+        }
+    }
+    calculateDelay(attempt) {
+        let delay = this.config.baseDelay * Math.pow(2, attempt);
+        if (this.config.jitter) {
+            const jitter = Math.random() * 1000;
+            delay += jitter;
+        }
+        return Math.min(delay, this.config.maxDelay);
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=retry.js.map

package/dist/strategies/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/strategies/retry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpD,MAAM,OAAO,aAAa;IAChB,MAAM,CAAwB;IAEtC,YACE,SAA+B,EAAE,EACjC,oBAAyC;QAEzC,IAAI,CAAC,MAAM,GAAG;YAEZ,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,CAAC;YAClC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI;YACnC,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,KAAK;YAClC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,IAAI;SAC9B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CACX,EAAoB,EACpB,gBAAkC,EAClC,iBAA0B,EAC1B,UAAkB,CAAC;QAEnB,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAGf,IAAI,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;gBACtC,MAAM,KAAK,CAAC;YACd,CAAC;YAGD,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvC,MAAM,KAAK,CAAC;YACd,CAAC;YAGD,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,EAAE,CAAC;gBACnE,MAAM,KAAK,CAAC;YACd,CAAC;YAGD,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;YAG3C,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAGxB,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAGO,qBAAqB,CAAC,KAAc;QAE1C,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,WAAW,IAAI,KAAK,EAAE,CAAC;YAC/D,OAAQ,KAAgC,CAAC,SAAS,KAAK,IAAI,CAAC;QAC9D,CAAC;QAGD,OAAO,KAAK,CAAC;IACf,CAAC;IAGO,mBAAmB,CACzB,gBAAkC,EAClC,iBAA0B;QAE1B,QAAQ,gBAAgB,EAAE,CAAC;YACzB,KAAK,gBAAgB,CAAC,IAAI,CAAC;YAC3B,KAAK,gBAAgB,CAAC,UAAU;gBAC9B,OAAO,IAAI,CAAC;YACd,KAAK,gBAAgB,CAAC,WAAW;gBAC/B,OAAO,iBAAiB,CAAC;YAC3B,KAAK,gBAAgB,CAAC,MAAM;gBAC1B,OAAO,KAAK,CAAC;YACf;gBACE,OAAO,KAAK,CAAC;QACjB,CAAC;IACH,CAAC;IAEO,cAAc,CAAC,OAAe;QAEpC,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAGzD,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;YACpC,KAAK,IAAI,MAAM,CAAC;QAClB,CAAC;QAGD,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAEO,KAAK,CAAC,EAAU;QACtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;CACF"}

package/dist/validation/drift-detector.d.ts

@@ -0,0 +1,5 @@
+import type { Schema, SchemaDrift } from "../core/types.js";
+export declare class DriftDetector {
+    detect(oldSchema: Schema, newSchema: Schema): SchemaDrift[];
+}
+//# sourceMappingURL=drift-detector.d.ts.map

package/dist/validation/drift-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift-detector.d.ts","sourceRoot":"","sources":["../../src/validation/drift-detector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE5D,qBAAa,aAAa;IACxB,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE;CA8F5D"}

package/dist/validation/drift-detector.js

@@ -0,0 +1,79 @@
+export class DriftDetector {
+    detect(oldSchema, newSchema) {
+        const drifts = [];
+        if (oldSchema.type !== newSchema.type) {
+            drifts.push({
+                type: "TYPE_CHANGED",
+                field: "type",
+                oldValue: oldSchema.type,
+                newValue: newSchema.type,
+                severity: "ERROR",
+            });
+        }
+        if (oldSchema.type === "object" && newSchema.type === "object") {
+            const oldProps = oldSchema.properties ?? {};
+            const newProps = newSchema.properties ?? {};
+            const oldRequired = new Set(oldSchema.required ?? []);
+            const newRequired = new Set(newSchema.required ?? []);
+            for (const field of Object.keys(oldProps)) {
+                if (!(field in newProps)) {
+                    drifts.push({
+                        type: "FIELD_REMOVED",
+                        field,
+                        oldValue: oldProps[field],
+                        newValue: undefined,
+                        severity: "ERROR",
+                    });
+                }
+            }
+            for (const field of Object.keys(newProps)) {
+                if (field in oldProps) {
+                    const oldField = oldProps[field];
+                    const newField = newProps[field];
+                    if (oldField && newField && oldField.type !== newField.type) {
+                        drifts.push({
+                            type: "TYPE_CHANGED",
+                            field,
+                            oldValue: oldField.type,
+                            newValue: newField.type,
+                            severity: "ERROR",
+                        });
+                    }
+                }
+            }
+            for (const field of oldRequired) {
+                if (!newRequired.has(field)) {
+                    drifts.push({
+                        type: "REQUIRED_REMOVED",
+                        field,
+                        oldValue: true,
+                        newValue: false,
+                        severity: "WARNING",
+                    });
+                }
+            }
+            for (const field of newRequired) {
+                if (!oldRequired.has(field)) {
+                    drifts.push({
+                        type: "REQUIRED_ADDED",
+                        field,
+                        oldValue: false,
+                        newValue: true,
+                        severity: "WARNING",
+                    });
+                }
+            }
+        }
+        if (oldSchema.type === "array" && newSchema.type === "array") {
+            if (oldSchema.items && newSchema.items) {
+                const itemDrifts = this.detect(oldSchema.items, newSchema.items);
+                drifts.push(...itemDrifts.map((d) => ({
+                    ...d,
+                    field: `items.${d.field}`,
+                })));
+            }
+        }
+        return drifts;
+    }
+}
+//# sourceMappingURL=drift-detector.js.map

package/dist/validation/drift-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift-detector.js","sourceRoot":"","sources":["../../src/validation/drift-detector.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,aAAa;IACxB,MAAM,CAAC,SAAiB,EAAE,SAAiB;QACzC,MAAM,MAAM,GAAkB,EAAE,CAAC;QAGjC,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,cAAc;gBACpB,KAAK,EAAE,MAAM;gBACb,QAAQ,EAAE,SAAS,CAAC,IAAI;gBACxB,QAAQ,EAAE,SAAS,CAAC,IAAI;gBACxB,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;QACL,CAAC;QAGD,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC/D,MAAM,QAAQ,GAAG,SAAS,CAAC,UAAU,IAAI,EAAE,CAAC;YAC5C,MAAM,QAAQ,GAAG,SAAS,CAAC,UAAU,IAAI,EAAE,CAAC;YAC5C,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;YACtD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;YAGtD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC1C,IAAI,CAAC,CAAC,KAAK,IAAI,QAAQ,CAAC,EAAE,CAAC;oBACzB,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI,EAAE,eAAe;wBACrB,KAAK;wBACL,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC;wBACzB,QAAQ,EAAE,SAAS;wBACnB,QAAQ,EAAE,OAAO;qBAClB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAGD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC1C,IAAI,KAAK,IAAI,QAAQ,EAAE,CAAC;oBACtB,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;oBACjC,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;oBAEjC,IAAI,QAAQ,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,EAAE,CAAC;wBAC5D,MAAM,CAAC,IAAI,CAAC;4BACV,IAAI,EAAE,cAAc;4BACpB,KAAK;4BACL,QAAQ,EAAE,QAAQ,CAAC,IAAI;4BACvB,QAAQ,EAAE,QAAQ,CAAC,IAAI;4BACvB,QAAQ,EAAE,OAAO;yBAClB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;YAGD,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;gBAChC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC5B,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI,EAAE,kBAAkB;wBACxB,KAAK;wBACL,QAAQ,EAAE,IAAI;wBACd,QAAQ,EAAE,KAAK;wBACf,QAAQ,EAAE,SAAS;qBACpB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;gBAChC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC5B,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI,EAAE,gBAAgB;wBACtB,KAAK;wBACL,QAAQ,EAAE,KAAK;wBACf,QAAQ,EAAE,IAAI;wBACd,QAAQ,EAAE,SAAS;qBACpB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAGD,IAAI,SAAS,CAAC,IAAI,KAAK,OAAO,IAAI,SAAS,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC7D,IAAI,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;gBACvC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;gBAEjE,MAAM,CAAC,IAAI,CACT,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACxB,GAAG,CAAC;oBACJ,KAAK,EAAE,SAAS,CAAC,CAAC,KAAK,EAAE;iBAC1B,CAAC,CAAC,CACJ,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/validation/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./schema-storage.js";
+export * from "./drift-detector.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}

package/dist/validation/index.js

@@ -0,0 +1,3 @@
+export * from "./schema-storage.js";
+export * from "./drift-detector.js";
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}

package/dist/validation/schema-storage.d.ts

@@ -0,0 +1,19 @@
+import type { Schema, SchemaMetadata, SchemaStorage } from "../core/types.js";
+export type { SchemaStorage } from "../core/types.js";
+export declare class FileSystemSchemaStorage implements SchemaStorage {
+    private basePath;
+    constructor(basePath?: string);
+    save(provider: string, endpoint: string, schema: Schema, version: string): Promise<void>;
+    load(provider: string, endpoint: string): Promise<Schema | null>;
+    list(provider: string): Promise<SchemaMetadata[]>;
+    private hashEndpoint;
+    private calculateChecksum;
+}
+export declare class InMemorySchemaStorage implements SchemaStorage {
+    private schemas;
+    save(provider: string, endpoint: string, schema: Schema, version: string): Promise<void>;
+    load(provider: string, endpoint: string): Promise<Schema | null>;
+    list(provider: string): Promise<SchemaMetadata[]>;
+    private calculateChecksum;
+}
+//# sourceMappingURL=schema-storage.d.ts.map

package/dist/validation/schema-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-storage.d.ts","sourceRoot":"","sources":["../../src/validation/schema-storage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAI9E,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,qBAAa,uBAAwB,YAAW,aAAa;IAC3D,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,GAAE,MAA4B;IAI5C,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAoBV,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAsBhE,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAqCvD,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,iBAAiB;CAW1B;AAGD,qBAAa,qBAAsB,YAAW,aAAa;IACzD,OAAO,CAAC,OAAO,CACH;IAEN,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAgBV,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAMhE,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAYvD,OAAO,CAAC,iBAAiB;CAU1B"}