feat(client): dynamic retry for "Client Retry Plugin" (#318)

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

- **New Features**
- Implemented a dynamic retry mechanism that automatically adjusts the
number of retry attempts based on request context, enhancing overall
resilience.
- **Documentation**
- Updated guidelines to clearly explain the enhanced retry behavior for
improved client operations.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Author: unnoq

apps/content/docs/plugins/client-retry.md

@@ -25,7 +25,15 @@ const link = new RPCLink<ORPCClientContext>({
   url: 'http://localhost:3000/rpc',
   plugins: [
     new ClientRetryPlugin({
-      default: {}, // Override the default context if needed
+      default: { // Optional override for default options
+        retry: (options, path) => {
+          if (path.join('.') === 'planet.list') {
+            return 2
+          }
+
+          return 0
+        }
+      },
     }),
   ],
 })

packages/client/src/plugins/retry.test.ts

@@ -52,9 +52,13 @@ describe('clientRetryPlugin', () => {
   it('should retry', async () => {
     handlerFn.mockRejectedValue(new Error('fail'))
 
-    await expect(client('hello', { context: { retry: 3, retryDelay: 0 } })).rejects.toThrow('Internal server error')
+    const retry = vi.fn(() => 3)
+
+    await expect(client('hello', { context: { retry, retryDelay: 0 } })).rejects.toThrow('Internal server error')
 
     expect(handlerFn).toHaveBeenCalledTimes(4)
+    expect(retry).toHaveBeenCalledTimes(1)
+    expect(retry).toHaveBeenCalledWith({ context: { retry, retryDelay: 0 } }, [], 'hello')
   })
 
   it('should not retry if success', async () => {

packages/client/src/plugins/retry.ts

@@ -18,7 +18,11 @@ export interface ClientRetryPluginContext {
    *
    * @default 0
    */
-  retry?: number
+  retry?: Value<number, [
+    clientOptions: ClientOptions<ClientRetryPluginContext>,
+    path: readonly string[],
+    input: unknown,
+  ]>
 
   /**
    * Delay (in ms) before retrying.
@@ -78,7 +82,13 @@ export class ClientRetryPlugin<T extends ClientRetryPluginContext> implements St
     options.interceptors ??= []
 
     options.interceptors.push(async (interceptorOptions) => {
-      const maxAttempts = interceptorOptions.options.context.retry ?? this.defaultRetry
+      const maxAttempts = await value(
+        interceptorOptions.options.context.retry ?? this.defaultRetry,
+        interceptorOptions.options,
+        interceptorOptions.path,
+        interceptorOptions.input,
+      )
+
       const retryDelay = interceptorOptions.options.context.retryDelay ?? this.defaultRetryDelay
       const shouldRetry = interceptorOptions.options.context.shouldRetry ?? this.defaultShouldRetry
       const onRetry = interceptorOptions.options.context.onRetry ?? this.defaultOnRetry