@strand-js/core 0.1.4 → 0.1.5

package/dist/index.d.mts

@@ -181,4 +181,19 @@ type ValidationResult = {
 };
 declare function validateMessages(messages: unknown, config?: RequestValidationConfig): ValidationResult;
 
-export { type AgentStatus, type AgentStep, type ContextWindowConfig, type ContextWindowStrategy, type JsonSchema, type Message, type RequestValidationConfig, type RetryConfig, type SendOptions, type Session, SessionStateMachine, type StrandClient, type StrandClientConfig, StrandError, type StreamingStatus, type TokenUsage, type ToolCall, type ToolCallState, type ToolCallStatus, ToolCallStore, type ToolDefinition, type ValidationResult, type WireEvent, applyContextWindow, createStrandClient, generateId, parseSSEStream, processWireEvent, tool, toolToJsonSchema, validateMessages, withRetry };
+interface RateLimitConfig {
+    windowMs: number;
+    maxRequests: number;
+    keyExtractor?: (identifier: string) => string;
+}
+interface RateLimitResult {
+    retryAfter: number;
+}
+declare class RateLimiter {
+    private readonly config;
+    private readonly store;
+    constructor(config: RateLimitConfig);
+    check(identifier: string): RateLimitResult | null;
+}
+
+export { type AgentStatus, type AgentStep, type ContextWindowConfig, type ContextWindowStrategy, type JsonSchema, type Message, type RateLimitConfig, type RateLimitResult, RateLimiter, type RequestValidationConfig, type RetryConfig, type SendOptions, type Session, SessionStateMachine, type StrandClient, type StrandClientConfig, StrandError, type StreamingStatus, type TokenUsage, type ToolCall, type ToolCallState, type ToolCallStatus, ToolCallStore, type ToolDefinition, type ValidationResult, type WireEvent, applyContextWindow, createStrandClient, generateId, parseSSEStream, processWireEvent, tool, toolToJsonSchema, validateMessages, withRetry };

package/dist/index.d.ts

@@ -181,4 +181,19 @@ type ValidationResult = {
 };
 declare function validateMessages(messages: unknown, config?: RequestValidationConfig): ValidationResult;
 
-export { type AgentStatus, type AgentStep, type ContextWindowConfig, type ContextWindowStrategy, type JsonSchema, type Message, type RequestValidationConfig, type RetryConfig, type SendOptions, type Session, SessionStateMachine, type StrandClient, type StrandClientConfig, StrandError, type StreamingStatus, type TokenUsage, type ToolCall, type ToolCallState, type ToolCallStatus, ToolCallStore, type ToolDefinition, type ValidationResult, type WireEvent, applyContextWindow, createStrandClient, generateId, parseSSEStream, processWireEvent, tool, toolToJsonSchema, validateMessages, withRetry };
+interface RateLimitConfig {
+    windowMs: number;
+    maxRequests: number;
+    keyExtractor?: (identifier: string) => string;
+}
+interface RateLimitResult {
+    retryAfter: number;
+}
+declare class RateLimiter {
+    private readonly config;
+    private readonly store;
+    constructor(config: RateLimitConfig);
+    check(identifier: string): RateLimitResult | null;
+}
+
+export { type AgentStatus, type AgentStep, type ContextWindowConfig, type ContextWindowStrategy, type JsonSchema, type Message, type RateLimitConfig, type RateLimitResult, RateLimiter, type RequestValidationConfig, type RetryConfig, type SendOptions, type Session, SessionStateMachine, type StrandClient, type StrandClientConfig, StrandError, type StreamingStatus, type TokenUsage, type ToolCall, type ToolCallState, type ToolCallStatus, ToolCallStore, type ToolDefinition, type ValidationResult, type WireEvent, applyContextWindow, createStrandClient, generateId, parseSSEStream, processWireEvent, tool, toolToJsonSchema, validateMessages, withRetry };

package/dist/index.js

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  RateLimiter: () => RateLimiter,
   SessionStateMachine: () => SessionStateMachine,
   StrandError: () => StrandError,
   ToolCallStore: () => ToolCallStore,
@@ -498,8 +499,36 @@ function validateMessages(messages, config = {}) {
   }
   return { ok: true };
 }
+
+// src/rate-limiter.ts
+var RateLimiter = class {
+  constructor(config) {
+    this.store = /* @__PURE__ */ new Map();
+    this.config = {
+      ...config,
+      keyExtractor: config.keyExtractor ?? ((id) => id)
+    };
+  }
+  // Returns null if allowed, or { retryAfter } if blocked
+  check(identifier) {
+    const key = this.config.keyExtractor(identifier);
+    const now = Date.now();
+    const entry = this.store.get(key);
+    if (!entry || now - entry.windowStart >= this.config.windowMs) {
+      this.store.set(key, { count: 1, windowStart: now });
+      return null;
+    }
+    if (entry.count >= this.config.maxRequests) {
+      const retryAfter = Math.ceil((this.config.windowMs - (now - entry.windowStart)) / 1e3);
+      return { retryAfter };
+    }
+    entry.count++;
+    return null;
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  RateLimiter,
   SessionStateMachine,
   StrandError,
   ToolCallStore,

package/dist/index.mjs

@@ -461,7 +461,35 @@ function validateMessages(messages, config = {}) {
   }
   return { ok: true };
 }
+
+// src/rate-limiter.ts
+var RateLimiter = class {
+  constructor(config) {
+    this.store = /* @__PURE__ */ new Map();
+    this.config = {
+      ...config,
+      keyExtractor: config.keyExtractor ?? ((id) => id)
+    };
+  }
+  // Returns null if allowed, or { retryAfter } if blocked
+  check(identifier) {
+    const key = this.config.keyExtractor(identifier);
+    const now = Date.now();
+    const entry = this.store.get(key);
+    if (!entry || now - entry.windowStart >= this.config.windowMs) {
+      this.store.set(key, { count: 1, windowStart: now });
+      return null;
+    }
+    if (entry.count >= this.config.maxRequests) {
+      const retryAfter = Math.ceil((this.config.windowMs - (now - entry.windowStart)) / 1e3);
+      return { retryAfter };
+    }
+    entry.count++;
+    return null;
+  }
+};
 export {
+  RateLimiter,
   SessionStateMachine,
   StrandError,
   ToolCallStore,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@strand-js/core",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "license": "MIT",
   "description": "Provider-agnostic AI state management — core types and client",
   "main": "./dist/index.js",