release: 0.8.x integration safety

[romanindev]

Summary

This release introduces integration safety features to make service-to-service communication more predictable and robust.

Highlights

Response validation

Validate successful responses before they are returned:

const client = createClient({
  baseUrl: 'https://api.example.com',
  validateResponse(data) {
    return typeof data === 'object' && data !== null && 'id' in data;
  },
});

• supports client-level defaults and request-level overrides
• throws ValidationError on failure
• does not affect HTTP error handling

Validation metadata in hooks

Validation results are exposed in lifecycle hooks:

afterResponse(ctx) {
  console.log(ctx.validation);
}

Idempotency key support

Attach idempotency keys to requests:

await client.post(
  '/payments',
  { amount: 100 },
  { idempotencyKey: 'payment-123' },
);

This adds:

idempotency-key: payment-123

Safer retries for non-idempotent requests

POST and PATCH requests are not retried unless:

• the method is explicitly included in retry.retryMethods
• idempotencyKey is provided

This prevents unsafe retries by default.

Changes

• add response validation support
• introduce ValidationError
• expose validation result in hooks
• add idempotency key support
• improve retry safety for non-idempotent requests

Notes

• no breaking changes
• validation runs only after successful HTTP responses
• validation failures are not retried by default