@yuliaedomskikh/agentflow-client 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+This SDK follows semantic versioning.
+
+SemVer rules:
+- `MAJOR`: breaking changes such as removed methods or incompatible parameter changes
+- `MINOR`: new methods, optional parameters, or additive model fields
+- `PATCH`: bug fixes and internal changes with no public API break
+
+Deprecation policy:
+- A method or field is deprecated with a warning for one full major version before removal
+- The warning states what is deprecated, what to use instead, and in which version removal happens
+
+## [Unreleased]
+
+### Added
+- `RetryPolicy` with exponential backoff, jitter, and `Retry-After` support for transient SDK failures
+- `CircuitBreaker`, `CircuitState`, and `CircuitOpenError` exports for repeated backend failure protection
+
+### Changed
+- `AgentFlowClient` now accepts optional `retryPolicy` and `circuitBreaker` options
+- Idempotent SDK requests now retry on `429`, `502`, `503`, `504`, and transport failures before surfacing the final error
+- Added resilience-focused Vitest coverage for retry/backoff and circuit-breaker behavior
+
+## [1.0.0] - 2026-04-11
+
+### Added
+- Stable TypeScript SDK for entity, metric, batch, query, health, and SSE APIs
+- Root package exports for the client, public exception types, and response model types

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { AgentFlowClient } from "./src/client.js";
 export { CircuitBreaker, CircuitOpenError, CircuitState, } from "./src/circuitBreaker.js";
-export { AgentFlowError, AuthError, DataFreshnessError, EntityNotFoundError, RateLimitError, } from "./src/exceptions.js";
+export { AgentFlowError, AuthError, DataFreshnessError, EntityNotFoundError, PermissionDeniedError, RateLimitError, } from "./src/exceptions.js";
 export { RetryPolicy } from "./src/retry.js";
 export type { BatchItem, BatchResponse, CatalogResponse, ClientOptions, EventFilters, HealthStatus, MetricName, MetricResult, OrderEntity, PipelineEvent, ProductEntity, QueryResult, SessionEntity, TimeWindow, UserEntity, } from "./src/models.js";
 export type { CircuitBreakerOptions } from "./src/circuitBreaker.js";

package/dist/index.js

@@ -1,4 +1,4 @@
 export { AgentFlowClient } from "./src/client.js";
 export { CircuitBreaker, CircuitOpenError, CircuitState, } from "./src/circuitBreaker.js";
-export { AgentFlowError, AuthError, DataFreshnessError, EntityNotFoundError, RateLimitError, } from "./src/exceptions.js";
+export { AgentFlowError, AuthError, DataFreshnessError, EntityNotFoundError, PermissionDeniedError, RateLimitError, } from "./src/exceptions.js";
 export { RetryPolicy } from "./src/retry.js";

package/dist/src/client.d.ts

@@ -1,4 +1,4 @@
-import type { BatchItem, BatchResponse, CatalogResponse, EventFilters, FetchLike, HealthStatus, MetricName, MetricResult, OrderEntity, PipelineEvent, ProductEntity, QueryResult, SessionEntity, TimeWindow, UserEntity } from "./models.js";
+import type { BatchItem, BatchResponse, CatalogResponse, ClientOptions, EventFilters, HealthStatus, MetricName, MetricResult, OrderEntity, PipelineEvent, ProductEntity, QueryResult, SessionEntity, TimeWindow, UserEntity } from "./models.js";
 import { CircuitBreaker } from "./circuitBreaker.js";
 import { RetryPolicy } from "./retry.js";
 export declare class AgentFlowClient {
@@ -11,12 +11,7 @@ export declare class AgentFlowClient {
     private readonly contractCache;
     retryPolicy: RetryPolicy;
     circuitBreaker: CircuitBreaker;
-    constructor(baseUrl: string, apiKey: string, options?: {
-        fetch?: FetchLike;
-        timeoutMs?: number;
-        headers?: HeadersInit;
-        contractVersion?: string;
-    });
+    constructor(baseUrl: string, apiKey: string, options?: ClientOptions);
     configureResilience(options: {
         retryPolicy?: RetryPolicy;
         circuitBreaker?: CircuitBreaker;

package/dist/src/client.js

@@ -1,4 +1,4 @@
-import { AgentFlowError, AuthError, DataFreshnessError, EntityNotFoundError, RateLimitError, } from "./exceptions.js";
+import { AgentFlowError, AuthError, DataFreshnessError, EntityNotFoundError, PermissionDeniedError, RateLimitError, } from "./exceptions.js";
 import { CircuitBreaker } from "./circuitBreaker.js";
 import { RETRYABLE_STATUS, RetryPolicy, isRetryableMethod, } from "./retry.js";
 import { streamSseJson } from "./stream.js";
@@ -19,15 +19,14 @@ export class AgentFlowClient {
     retryPolicy;
     circuitBreaker;
     constructor(baseUrl, apiKey, options = {}) {
-        const legacyOptions = options;
         this.baseUrl = baseUrl.replace(/\/+$/, "");
         this.apiKey = apiKey;
         this.fetchImpl = options.fetch ?? this.resolveFetch();
         this.timeoutMs = options.timeoutMs ?? 10_000;
         this.headers = options.headers;
         this.contractVersions = this.parseContractVersions(options.contractVersion);
-        this.retryPolicy = legacyOptions.retryPolicy ?? new RetryPolicy();
-        this.circuitBreaker = legacyOptions.circuitBreaker ?? new CircuitBreaker();
+        this.retryPolicy = options.retryPolicy ?? new RetryPolicy();
+        this.circuitBreaker = options.circuitBreaker ?? new CircuitBreaker();
     }
     configureResilience(options) {
         if (options.retryPolicy) {
@@ -243,7 +242,8 @@ export class AgentFlowClient {
                 if (error instanceof AgentFlowError
                     || error instanceof AuthError
                     || error instanceof RateLimitError
-                    || error instanceof EntityNotFoundError) {
+                    || error instanceof EntityNotFoundError
+                    || error instanceof PermissionDeniedError) {
                     throw error;
                 }
                 const timedOut = controller.signal.aborted && !options.signal?.aborted;
@@ -278,6 +278,9 @@ export class AgentFlowClient {
         if (response.status === 401) {
             throw new AuthError(detail ?? "Unauthorized");
         }
+        if (response.status === 403) {
+            throw new PermissionDeniedError(detail ?? "Forbidden");
+        }
         if (response.status === 429) {
             const retryAfterHeader = response.headers.get("retry-after");
             const retryAfter = retryAfterHeader ? Number(retryAfterHeader) : 0;

package/dist/src/exceptions.d.ts

@@ -5,6 +5,9 @@ export declare class AgentFlowError extends Error {
 export declare class AuthError extends AgentFlowError {
     constructor(message?: string);
 }
+export declare class PermissionDeniedError extends AgentFlowError {
+    constructor(message?: string);
+}
 export declare class RateLimitError extends AgentFlowError {
     readonly retryAfter: number;
     constructor(message?: string, retryAfter?: number);

package/dist/src/exceptions.js

@@ -12,6 +12,12 @@ export class AuthError extends AgentFlowError {
         this.name = "AuthError";
     }
 }
+export class PermissionDeniedError extends AgentFlowError {
+    constructor(message = "Forbidden") {
+        super(message, 403);
+        this.name = "PermissionDeniedError";
+    }
+}
 export class RateLimitError extends AgentFlowError {
     retryAfter;
     constructor(message = "Rate limit exceeded", retryAfter = 0) {

package/dist/src/stream.js

@@ -35,8 +35,9 @@ export async function* streamSseJson(response, signal) {
             }
         }
         buffer += decoder.decode().replace(/\r\n/g, "\n");
-        if (buffer.trim().startsWith("data:")) {
-            const data = buffer
+        const finalFrame = buffer.trim();
+        if (finalFrame) {
+            const data = finalFrame
                 .split("\n")
                 .filter((line) => line.startsWith("data:"))
                 .map((line) => line.slice(5).trimStart())

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yuliaedomskikh/agentflow-client",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "TypeScript SDK for the AgentFlow API",
   "type": "module",
   "main": "./dist/index.js",
@@ -16,14 +16,15 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "sideEffects": false,
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "typecheck": "tsc --noEmit",
-    "test:unit": "vitest run --root .. --exclude=mutants/** tests/client.test.ts sdk-ts/tests/retry.test.ts sdk-ts/tests/circuitBreaker.test.ts sdk-ts/tests/resilience-integration.test.ts",
-    "test": "vitest run --root .. --exclude=mutants/** tests/client.test.ts sdk-ts/tests/retry.test.ts sdk-ts/tests/circuitBreaker.test.ts sdk-ts/tests/resilience-integration.test.ts"
+    "test:unit": "vitest run --root .. --exclude=mutants/** tests/client.test.ts sdk-ts/tests",
+    "test": "vitest run --root .. --exclude=mutants/** tests/client.test.ts sdk-ts/tests"
   },
   "keywords": [
     "agentflow",