@defai.digital/contracts 13.0.3

package/dist/provider/v1/rate-limit.js

@@ -0,0 +1,165 @@
+/**
+ * Rate Limit Contract V1
+ *
+ * Provides rate limiting for provider requests using token bucket algorithm.
+ * Prevents overwhelming providers with too many requests.
+ *
+ * Invariants:
+ * - INV-RL-001: Tokens never exceed burst capacity
+ * - INV-RL-002: Tokens refill at configured rate
+ * - INV-RL-003: Strategy (reject/queue/backoff) honored
+ * - INV-RL-004: Queue never exceeds maxQueueSize
+ */
+import { z } from 'zod';
+/**
+ * Rate limit strategy when limit is reached
+ */
+export const RateLimitStrategySchema = z.enum([
+    'reject', // Immediately reject request
+    'queue', // Queue request for later
+    'backoff', // Wait with exponential backoff
+]);
+/**
+ * Rate limit state
+ */
+export const RateLimitStateEnumSchema = z.enum([
+    'normal', // Operating normally
+    'throttled', // Rate limited but requests allowed
+    'blocked', // All requests blocked
+]);
+/**
+ * Rate limit configuration
+ */
+export const RateLimitConfigSchema = z.object({
+    /** Requests per minute per provider */
+    requestsPerMinute: z.number().int().min(1).max(10000).default(60),
+    /** Tokens per minute per provider */
+    tokensPerMinute: z.number().int().min(1000).max(10000000).default(100000),
+    /** Burst allowance multiplier (INV-RL-001) */
+    burstMultiplier: z.number().min(1).max(5).default(1.5),
+    /** Strategy when limit reached (INV-RL-003) */
+    strategy: RateLimitStrategySchema.default('backoff'),
+    /** Max queue size if strategy is 'queue' (INV-RL-004) */
+    maxQueueSize: z.number().int().min(0).max(1000).default(100),
+    /** Backoff base delay in ms */
+    backoffBaseMs: z.number().int().min(100).max(10000).default(1000),
+    /** Backoff multiplier for exponential backoff */
+    backoffMultiplier: z.number().min(1).max(4).default(2),
+    /** Maximum backoff delay in ms */
+    maxBackoffMs: z.number().int().min(1000).max(60000).default(30000),
+    /** Enable token-based rate limiting */
+    enableTokenLimit: z.boolean().default(true),
+    /** Enable request-based rate limiting */
+    enableRequestLimit: z.boolean().default(true),
+});
+/**
+ * Rate limit state snapshot
+ */
+export const RateLimitStateSchema = z.object({
+    /** Current available request tokens */
+    requestTokens: z.number().min(0),
+    /** Current available output tokens */
+    outputTokens: z.number().min(0),
+    /** Requests in current window */
+    requestCount: z.number().int().min(0),
+    /** Tokens used in current window */
+    tokenCount: z.number().int().min(0),
+    /** Start of current rate limit window */
+    windowStart: z.string().datetime(),
+    /** Current queue size */
+    queueSize: z.number().int().min(0),
+    /** Next allowed request time (if rate limited) */
+    nextAllowedTime: z.string().datetime().optional(),
+    /** Current state */
+    state: RateLimitStateEnumSchema,
+    /** Last refill timestamp */
+    lastRefillTime: z.string().datetime(),
+});
+/**
+ * Rate limit result
+ */
+export const RateLimitResultSchema = z.object({
+    /** Whether request is allowed */
+    allowed: z.boolean(),
+    /** Wait time in ms (for backoff strategy) */
+    waitMs: z.number().int().min(0),
+    /** Whether request was queued */
+    queued: z.boolean().optional(),
+    /** Queue position if queued */
+    queuePosition: z.number().int().min(0).optional(),
+    /** Error code if rejected */
+    error: z.string().optional(),
+    /** Remaining requests in window */
+    remainingRequests: z.number().int().min(0).optional(),
+    /** Remaining tokens in window */
+    remainingTokens: z.number().int().min(0).optional(),
+    /** Time until rate limit resets */
+    resetInMs: z.number().int().min(0).optional(),
+});
+/**
+ * Rate limit event types
+ */
+export const RateLimitEventTypeSchema = z.enum([
+    'rateLimit.acquired',
+    'rateLimit.rejected',
+    'rateLimit.queued',
+    'rateLimit.dequeued',
+    'rateLimit.refilled',
+    'rateLimit.stateChanged',
+]);
+/**
+ * Rate limit event
+ */
+export const RateLimitEventSchema = z.object({
+    eventId: z.string().uuid(),
+    type: RateLimitEventTypeSchema,
+    providerId: z.string(),
+    timestamp: z.string().datetime(),
+    requestId: z.string().uuid().optional(),
+    details: z.record(z.unknown()).optional(),
+});
+/**
+ * Error codes for rate limit operations
+ */
+export const RateLimitErrorCodes = {
+    RATE_LIMITED: 'RATE_LIMIT_EXCEEDED',
+    QUEUE_FULL: 'RATE_LIMIT_QUEUE_FULL',
+    TOKEN_LIMIT: 'RATE_LIMIT_TOKEN_EXCEEDED',
+    REQUEST_LIMIT: 'RATE_LIMIT_REQUEST_EXCEEDED',
+    INVALID_CONFIG: 'RATE_LIMIT_INVALID_CONFIG',
+};
+/**
+ * Validates rate limit configuration
+ */
+export function validateRateLimitConfig(data) {
+    return RateLimitConfigSchema.parse(data);
+}
+/**
+ * Validates rate limit state
+ */
+export function validateRateLimitState(data) {
+    return RateLimitStateSchema.parse(data);
+}
+/**
+ * Creates default rate limit configuration
+ */
+export function createDefaultRateLimitConfig() {
+    return RateLimitConfigSchema.parse({});
+}
+/**
+ * Creates initial rate limit state
+ */
+export function createInitialRateLimitState(config) {
+    const now = new Date().toISOString();
+    return {
+        requestTokens: config.requestsPerMinute * config.burstMultiplier,
+        outputTokens: config.tokensPerMinute * config.burstMultiplier,
+        requestCount: 0,
+        tokenCount: 0,
+        windowStart: now,
+        queueSize: 0,
+        state: 'normal',
+        lastRefillTime: now,
+    };
+}
+//# sourceMappingURL=rate-limit.js.map

package/dist/provider/v1/rate-limit.js.map

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

package/dist/resilience/v1/circuit-breaker.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Circuit Breaker Contract
+ *
+ * Prevents cascade failures by stopping calls to unhealthy providers.
+ */
+import { z } from 'zod';
+export declare const CircuitBreakerStateSchema: z.ZodEnum<["closed", "open", "half-open"]>;
+export type CircuitBreakerState = z.infer<typeof CircuitBreakerStateSchema>;
+export declare const CircuitBreakerConfigSchema: z.ZodObject<{
+    /** Number of failures before opening circuit */
+    failureThreshold: z.ZodDefault<z.ZodNumber>;
+    /** Time in ms before attempting recovery (half-open) */
+    resetTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    /** Number of test requests allowed in half-open state */
+    halfOpenMaxAttempts: z.ZodDefault<z.ZodNumber>;
+    /** Time window for counting failures in ms */
+    failureWindowMs: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    failureThreshold: number;
+    resetTimeoutMs: number;
+    halfOpenMaxAttempts: number;
+    failureWindowMs: number;
+}, {
+    failureThreshold?: number | undefined;
+    resetTimeoutMs?: number | undefined;
+    halfOpenMaxAttempts?: number | undefined;
+    failureWindowMs?: number | undefined;
+}>;
+export type CircuitBreakerConfig = z.infer<typeof CircuitBreakerConfigSchema>;
+export declare const CircuitBreakerStatsSchema: z.ZodObject<{
+    /** Current state */
+    state: z.ZodEnum<["closed", "open", "half-open"]>;
+    /** Total successful calls */
+    successCount: z.ZodNumber;
+    /** Total failed calls */
+    failureCount: z.ZodNumber;
+    /** Failures in current window */
+    recentFailures: z.ZodNumber;
+    /** Last failure timestamp */
+    lastFailureAt: z.ZodOptional<z.ZodString>;
+    /** Last success timestamp */
+    lastSuccessAt: z.ZodOptional<z.ZodString>;
+    /** When circuit opened (if open) */
+    openedAt: z.ZodOptional<z.ZodString>;
+    /** Consecutive successes in half-open */
+    halfOpenSuccesses: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    successCount: number;
+    failureCount: number;
+    state: "open" | "closed" | "half-open";
+    recentFailures: number;
+    halfOpenSuccesses: number;
+    lastFailureAt?: string | undefined;
+    lastSuccessAt?: string | undefined;
+    openedAt?: string | undefined;
+}, {
+    successCount: number;
+    failureCount: number;
+    state: "open" | "closed" | "half-open";
+    recentFailures: number;
+    halfOpenSuccesses: number;
+    lastFailureAt?: string | undefined;
+    lastSuccessAt?: string | undefined;
+    openedAt?: string | undefined;
+}>;
+export type CircuitBreakerStats = z.infer<typeof CircuitBreakerStatsSchema>;
+export declare const CircuitBreakerEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"state-change">;
+    from: z.ZodEnum<["closed", "open", "half-open"]>;
+    to: z.ZodEnum<["closed", "open", "half-open"]>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "state-change";
+    timestamp: string;
+    from: "open" | "closed" | "half-open";
+    to: "open" | "closed" | "half-open";
+}, {
+    type: "state-change";
+    timestamp: string;
+    from: "open" | "closed" | "half-open";
+    to: "open" | "closed" | "half-open";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"call-success">;
+    durationMs: z.ZodNumber;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "call-success";
+    timestamp: string;
+    durationMs: number;
+}, {
+    type: "call-success";
+    timestamp: string;
+    durationMs: number;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"call-failure">;
+    error: z.ZodString;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "call-failure";
+    timestamp: string;
+    error: string;
+}, {
+    type: "call-failure";
+    timestamp: string;
+    error: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"call-rejected">;
+    reason: z.ZodString;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "call-rejected";
+    timestamp: string;
+    reason: string;
+}, {
+    type: "call-rejected";
+    timestamp: string;
+    reason: string;
+}>]>;
+export type CircuitBreakerEvent = z.infer<typeof CircuitBreakerEventSchema>;
+export declare const CircuitBreakerErrorCodes: {
+    readonly CIRCUIT_OPEN: "CIRCUIT_BREAKER_OPEN";
+    readonly EXECUTION_FAILED: "CIRCUIT_BREAKER_EXECUTION_FAILED";
+};
+export type CircuitBreakerErrorCode = (typeof CircuitBreakerErrorCodes)[keyof typeof CircuitBreakerErrorCodes];
+export declare function validateCircuitBreakerConfig(data: unknown): CircuitBreakerConfig;
+export declare function safeValidateCircuitBreakerConfig(data: unknown): {
+    success: true;
+    data: CircuitBreakerConfig;
+} | {
+    success: false;
+    error: z.ZodError;
+};
+export declare function createDefaultCircuitBreakerConfig(): CircuitBreakerConfig;
+export declare function createCircuitBreakerStats(): CircuitBreakerStats;
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/resilience/v1/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../../src/resilience/v1/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,yBAAyB,4CAA0C,CAAC;AACjF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAM5E,eAAO,MAAM,0BAA0B;IACrC,gDAAgD;;IAGhD,wDAAwD;;IAGxD,yDAAyD;;IAGzD,8CAA8C;;;;;;;;;;;;EAE9C,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAM9E,eAAO,MAAM,yBAAyB;IACpC,oBAAoB;;IAGpB,6BAA6B;;IAG7B,yBAAyB;;IAGzB,iCAAiC;;IAGjC,6BAA6B;;IAG7B,6BAA6B;;IAG7B,oCAAoC;;IAGpC,yCAAyC;;;;;;;;;;;;;;;;;;;;EAEzC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAM5E,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAsBpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAM5E,eAAO,MAAM,wBAAwB;;;CAG3B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,OAAO,wBAAwB,CAAC,CAAC;AAM3E,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,OAAO,GAAG,oBAAoB,CAEhF;AAED,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,OAAO,GACZ;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,oBAAoB,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAA;CAAE,CAIvF;AAMD,wBAAgB,iCAAiC,IAAI,oBAAoB,CAExE;AAED,wBAAgB,yBAAyB,IAAI,mBAAmB,CAQ/D"}

package/dist/resilience/v1/circuit-breaker.js

@@ -0,0 +1,105 @@
+/**
+ * Circuit Breaker Contract
+ *
+ * Prevents cascade failures by stopping calls to unhealthy providers.
+ */
+import { z } from 'zod';
+// ============================================================================
+// Circuit Breaker State
+// ============================================================================
+export const CircuitBreakerStateSchema = z.enum(['closed', 'open', 'half-open']);
+// ============================================================================
+// Configuration
+// ============================================================================
+export const CircuitBreakerConfigSchema = z.object({
+    /** Number of failures before opening circuit */
+    failureThreshold: z.number().int().min(1).max(100).default(5),
+    /** Time in ms before attempting recovery (half-open) */
+    resetTimeoutMs: z.number().int().min(1000).max(300000).default(30000),
+    /** Number of test requests allowed in half-open state */
+    halfOpenMaxAttempts: z.number().int().min(1).max(10).default(1),
+    /** Time window for counting failures in ms */
+    failureWindowMs: z.number().int().min(1000).max(300000).default(60000),
+});
+// ============================================================================
+// Stats
+// ============================================================================
+export const CircuitBreakerStatsSchema = z.object({
+    /** Current state */
+    state: CircuitBreakerStateSchema,
+    /** Total successful calls */
+    successCount: z.number().int().min(0),
+    /** Total failed calls */
+    failureCount: z.number().int().min(0),
+    /** Failures in current window */
+    recentFailures: z.number().int().min(0),
+    /** Last failure timestamp */
+    lastFailureAt: z.string().datetime().optional(),
+    /** Last success timestamp */
+    lastSuccessAt: z.string().datetime().optional(),
+    /** When circuit opened (if open) */
+    openedAt: z.string().datetime().optional(),
+    /** Consecutive successes in half-open */
+    halfOpenSuccesses: z.number().int().min(0),
+});
+// ============================================================================
+// Events
+// ============================================================================
+export const CircuitBreakerEventSchema = z.discriminatedUnion('type', [
+    z.object({
+        type: z.literal('state-change'),
+        from: CircuitBreakerStateSchema,
+        to: CircuitBreakerStateSchema,
+        timestamp: z.string().datetime(),
+    }),
+    z.object({
+        type: z.literal('call-success'),
+        durationMs: z.number().int().min(0),
+        timestamp: z.string().datetime(),
+    }),
+    z.object({
+        type: z.literal('call-failure'),
+        error: z.string(),
+        timestamp: z.string().datetime(),
+    }),
+    z.object({
+        type: z.literal('call-rejected'),
+        reason: z.string(),
+        timestamp: z.string().datetime(),
+    }),
+]);
+// ============================================================================
+// Error Codes
+// ============================================================================
+export const CircuitBreakerErrorCodes = {
+    CIRCUIT_OPEN: 'CIRCUIT_BREAKER_OPEN',
+    EXECUTION_FAILED: 'CIRCUIT_BREAKER_EXECUTION_FAILED',
+};
+// ============================================================================
+// Validation Functions
+// ============================================================================
+export function validateCircuitBreakerConfig(data) {
+    return CircuitBreakerConfigSchema.parse(data);
+}
+export function safeValidateCircuitBreakerConfig(data) {
+    const result = CircuitBreakerConfigSchema.safeParse(data);
+    if (result.success)
+        return { success: true, data: result.data };
+    return { success: false, error: result.error };
+}
+// ============================================================================
+// Factory Functions
+// ============================================================================
+export function createDefaultCircuitBreakerConfig() {
+    return CircuitBreakerConfigSchema.parse({});
+}
+export function createCircuitBreakerStats() {
+    return {
+        state: 'closed',
+        successCount: 0,
+        failureCount: 0,
+        recentFailures: 0,
+        halfOpenSuccesses: 0,
+    };
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/resilience/v1/circuit-breaker.js.map

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

package/dist/resilience/v1/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Resilience Contracts v1
+ *
+ * Production-grade resilience patterns: circuit breaker, rate limiter,
+ * loop guard, resource limits, and metrics.
+ */
+export { CircuitBreakerStateSchema, CircuitBreakerConfigSchema, CircuitBreakerStatsSchema, CircuitBreakerEventSchema, CircuitBreakerErrorCodes, validateCircuitBreakerConfig, safeValidateCircuitBreakerConfig, createDefaultCircuitBreakerConfig, createCircuitBreakerStats, } from './circuit-breaker.js';
+export type { CircuitBreakerState, CircuitBreakerConfig, CircuitBreakerStats, CircuitBreakerEvent, CircuitBreakerErrorCode, } from './circuit-breaker.js';
+export { RateLimiterConfigSchema, RateLimiterStatsSchema, RateLimiterAcquireResultSchema, RateLimiterErrorCodes, validateRateLimiterConfig, safeValidateRateLimiterConfig, createDefaultRateLimiterConfig, createRateLimiterStats, DEFAULT_TOKEN_WINDOW_MS, DEFAULT_CHECK_INTERVAL_MS, TIME_MULTIPLIERS, DEFAULT_TIME_RANGE_MS, } from './rate-limiter.js';
+export type { RateLimiterConfig, RateLimiterStats, RateLimiterAcquireResult, RateLimiterErrorCode, } from './rate-limiter.js';
+export { LoopGuardConfigSchema, LoopGuardContextSchema, LoopGuardResultSchema, LoopGuardErrorCodes, validateLoopGuardConfig, safeValidateLoopGuardConfig, createDefaultLoopGuardConfig, createLoopGuardContext, } from './loop-guard.js';
+export type { LoopGuardConfig, LoopGuardContext, LoopGuardResult, LoopGuardErrorCode, } from './loop-guard.js';
+export { ResourceLimitsConfigSchema, ResourceUsageSchema, ResourceCheckResultSchema, ResourceRequestInfoSchema, ResourceLimitsErrorCodes, validateResourceLimitsConfig, safeValidateResourceLimitsConfig, createDefaultResourceLimitsConfig, createResourceUsage, estimateCost, } from './resource-limits.js';
+export type { ResourceLimitsConfig, ResourceUsage, ResourceCheckResult, ResourceRequestInfo, ResourceLimitsErrorCode, } from './resource-limits.js';
+export { MetricsTimeRangeSchema, RequestMetricSchema, ErrorMetricSchema, LatencyStatsSchema, MetricsSnapshotSchema, validateRequestMetric, validateErrorMetric, validateMetricsSnapshot, createEmptyMetricsSnapshot, createRequestMetric, createErrorMetric, } from './metrics.js';
+export type { MetricsTimeRange, RequestMetric, ErrorMetric, LatencyStats, MetricsSnapshot, } from './metrics.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/resilience/v1/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resilience/v1/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,4BAA4B,EAC5B,gCAAgC,EAChC,iCAAiC,EACjC,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,8BAA8B,EAC9B,qBAAqB,EACrB,yBAAyB,EACzB,6BAA6B,EAC7B,8BAA8B,EAC9B,sBAAsB,EACtB,uBAAuB,EACvB,yBAAyB,EACzB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,2BAA2B,EAC3B,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,4BAA4B,EAC5B,gCAAgC,EAChC,iCAAiC,EACjC,mBAAmB,EACnB,YAAY,GACb,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,0BAA0B,EAC1B,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,eAAe,GAChB,MAAM,cAAc,CAAC"}

package/dist/resilience/v1/index.js

@@ -0,0 +1,17 @@
+/**
+ * Resilience Contracts v1
+ *
+ * Production-grade resilience patterns: circuit breaker, rate limiter,
+ * loop guard, resource limits, and metrics.
+ */
+// Circuit Breaker
+export { CircuitBreakerStateSchema, CircuitBreakerConfigSchema, CircuitBreakerStatsSchema, CircuitBreakerEventSchema, CircuitBreakerErrorCodes, validateCircuitBreakerConfig, safeValidateCircuitBreakerConfig, createDefaultCircuitBreakerConfig, createCircuitBreakerStats, } from './circuit-breaker.js';
+// Rate Limiter
+export { RateLimiterConfigSchema, RateLimiterStatsSchema, RateLimiterAcquireResultSchema, RateLimiterErrorCodes, validateRateLimiterConfig, safeValidateRateLimiterConfig, createDefaultRateLimiterConfig, createRateLimiterStats, DEFAULT_TOKEN_WINDOW_MS, DEFAULT_CHECK_INTERVAL_MS, TIME_MULTIPLIERS, DEFAULT_TIME_RANGE_MS, } from './rate-limiter.js';
+// Loop Guard
+export { LoopGuardConfigSchema, LoopGuardContextSchema, LoopGuardResultSchema, LoopGuardErrorCodes, validateLoopGuardConfig, safeValidateLoopGuardConfig, createDefaultLoopGuardConfig, createLoopGuardContext, } from './loop-guard.js';
+// Resource Limits
+export { ResourceLimitsConfigSchema, ResourceUsageSchema, ResourceCheckResultSchema, ResourceRequestInfoSchema, ResourceLimitsErrorCodes, validateResourceLimitsConfig, safeValidateResourceLimitsConfig, createDefaultResourceLimitsConfig, createResourceUsage, estimateCost, } from './resource-limits.js';
+// Metrics
+export { MetricsTimeRangeSchema, RequestMetricSchema, ErrorMetricSchema, LatencyStatsSchema, MetricsSnapshotSchema, validateRequestMetric, validateErrorMetric, validateMetricsSnapshot, createEmptyMetricsSnapshot, createRequestMetric, createErrorMetric, } from './metrics.js';
+//# sourceMappingURL=index.js.map

package/dist/resilience/v1/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resilience/v1/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,kBAAkB;AAClB,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,4BAA4B,EAC5B,gCAAgC,EAChC,iCAAiC,EACjC,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAU9B,eAAe;AACf,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,8BAA8B,EAC9B,qBAAqB,EACrB,yBAAyB,EACzB,6BAA6B,EAC7B,8BAA8B,EAC9B,sBAAsB,EACtB,uBAAuB,EACvB,yBAAyB,EACzB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAS3B,aAAa;AACb,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,2BAA2B,EAC3B,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AASzB,kBAAkB;AAClB,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,4BAA4B,EAC5B,gCAAgC,EAChC,iCAAiC,EACjC,mBAAmB,EACnB,YAAY,GACb,MAAM,sBAAsB,CAAC;AAU9B,UAAU;AACV,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,0BAA0B,EAC1B,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,cAAc,CAAC"}

package/dist/resilience/v1/loop-guard.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Loop Guard Contract
+ *
+ * Prevents infinite loops and runaway execution that burns resources.
+ */
+import { z } from 'zod';
+export declare const LoopGuardConfigSchema: z.ZodObject<{
+    /** Maximum iterations before hard stop */
+    maxIterations: z.ZodDefault<z.ZodNumber>;
+    /** Iteration count that triggers warning */
+    warnAtIterations: z.ZodDefault<z.ZodNumber>;
+    /** Maximum execution duration in ms */
+    maxDurationMs: z.ZodDefault<z.ZodNumber>;
+    /** Duration that triggers warning in ms */
+    warnAtDurationMs: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    maxIterations: number;
+    warnAtIterations: number;
+    maxDurationMs: number;
+    warnAtDurationMs: number;
+}, {
+    maxIterations?: number | undefined;
+    warnAtIterations?: number | undefined;
+    maxDurationMs?: number | undefined;
+    warnAtDurationMs?: number | undefined;
+}>;
+export type LoopGuardConfig = z.infer<typeof LoopGuardConfigSchema>;
+export declare const LoopGuardContextSchema: z.ZodObject<{
+    /** Unique context identifier */
+    contextId: z.ZodString;
+    /** Current iteration count */
+    iterations: z.ZodNumber;
+    /** Start time */
+    startedAt: z.ZodString;
+    /** Elapsed time in ms */
+    elapsedMs: z.ZodNumber;
+    /** Whether warning was already issued */
+    warningIssued: z.ZodBoolean;
+    /** Context metadata */
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    startedAt: string;
+    iterations: number;
+    contextId: string;
+    elapsedMs: number;
+    warningIssued: boolean;
+    metadata?: Record<string, unknown> | undefined;
+}, {
+    startedAt: string;
+    iterations: number;
+    contextId: string;
+    elapsedMs: number;
+    warningIssued: boolean;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+export type LoopGuardContext = z.infer<typeof LoopGuardContextSchema>;
+export declare const LoopGuardResultSchema: z.ZodDiscriminatedUnion<"status", [z.ZodObject<{
+    status: z.ZodLiteral<"ok">;
+    iteration: z.ZodNumber;
+    elapsedMs: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    status: "ok";
+    iteration: number;
+    elapsedMs: number;
+}, {
+    status: "ok";
+    iteration: number;
+    elapsedMs: number;
+}>, z.ZodObject<{
+    status: z.ZodLiteral<"warning">;
+    iteration: z.ZodNumber;
+    elapsedMs: z.ZodNumber;
+    message: z.ZodString;
+    warningType: z.ZodEnum<["iteration", "duration"]>;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    status: "warning";
+    iteration: number;
+    elapsedMs: number;
+    warningType: "duration" | "iteration";
+}, {
+    message: string;
+    status: "warning";
+    iteration: number;
+    elapsedMs: number;
+    warningType: "duration" | "iteration";
+}>, z.ZodObject<{
+    status: z.ZodLiteral<"blocked">;
+    iteration: z.ZodNumber;
+    elapsedMs: z.ZodNumber;
+    reason: z.ZodString;
+    blockType: z.ZodEnum<["max-iterations", "max-duration"]>;
+}, "strip", z.ZodTypeAny, {
+    status: "blocked";
+    reason: string;
+    iteration: number;
+    elapsedMs: number;
+    blockType: "max-iterations" | "max-duration";
+}, {
+    status: "blocked";
+    reason: string;
+    iteration: number;
+    elapsedMs: number;
+    blockType: "max-iterations" | "max-duration";
+}>]>;
+export type LoopGuardResult = z.infer<typeof LoopGuardResultSchema>;
+export declare const LoopGuardErrorCodes: {
+    readonly MAX_ITERATIONS: "LOOP_GUARD_MAX_ITERATIONS";
+    readonly MAX_DURATION: "LOOP_GUARD_MAX_DURATION";
+    readonly CONTEXT_NOT_FOUND: "LOOP_GUARD_CONTEXT_NOT_FOUND";
+};
+export type LoopGuardErrorCode = (typeof LoopGuardErrorCodes)[keyof typeof LoopGuardErrorCodes];
+export declare function validateLoopGuardConfig(data: unknown): LoopGuardConfig;
+export declare function safeValidateLoopGuardConfig(data: unknown): {
+    success: true;
+    data: LoopGuardConfig;
+} | {
+    success: false;
+    error: z.ZodError;
+};
+export declare function createDefaultLoopGuardConfig(): LoopGuardConfig;
+export declare function createLoopGuardContext(contextId: string): LoopGuardContext;
+//# sourceMappingURL=loop-guard.d.ts.map

package/dist/resilience/v1/loop-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-guard.d.ts","sourceRoot":"","sources":["../../../src/resilience/v1/loop-guard.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,qBAAqB;IAChC,0CAA0C;;IAG1C,4CAA4C;;IAG5C,uCAAuC;;IAGvC,2CAA2C;;;;;;;;;;;;EAE3C,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAMpE,eAAO,MAAM,sBAAsB;IACjC,gCAAgC;;IAGhC,8BAA8B;;IAG9B,iBAAiB;;IAGjB,yBAAyB;;IAGzB,yCAAyC;;IAGzC,uBAAuB;;;;;;;;;;;;;;;;EAEvB,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAMtE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAoBhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAMpE,eAAO,MAAM,mBAAmB;;;;CAItB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAC5B,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAMjE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,CAEtE;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,OAAO,GACZ;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,eAAe,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAA;CAAE,CAIlF;AAMD,wBAAgB,4BAA4B,IAAI,eAAe,CAE9D;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAQ1E"}