@toa.io/extensions.fetch 1.0.0-alpha.284 → 1.0.0-alpha.287

package/CHANGELOG.md

@@ -3,108 +3,6 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-# [1.0.0-alpha.284](https://github.com/toa-io/toa/compare/v1.0.0-alpha.283...v1.0.0-alpha.284) (2026-09-05)
-
-**Note:** Version bump only for package @toa.io/extensions.fetch
-
-
-
-
-
-# [1.0.0-alpha.283](https://github.com/toa-io/toa/compare/v1.0.0-alpha.282...v1.0.0-alpha.283) (2026-09-04)
-
-### Features
-
-* **extensions:** an extension declares what it puts on a component's context ([133bc2a](https://github.com/toa-io/toa/commit/133bc2aad1e45a2d4aa68a08a5e44ca48d3b7414))
-
-
-# [1.0.0-alpha.282](https://github.com/toa-io/toa/compare/v1.0.0-alpha.281...v1.0.0-alpha.282) (2026-09-03)
-
-**Note:** Version bump only for package @toa.io/extensions.fetch
-
-
-
-
-
-# [1.0.0-alpha.278](https://github.com/toa-io/toa/compare/v1.0.0-alpha.277...v1.0.0-alpha.278) (2026-09-03)
-
-**Note:** Version bump only for package @toa.io/extensions.fetch
-
-
-
-
-
-# [1.0.0-alpha.277](https://github.com/toa-io/toa/compare/v1.0.0-alpha.276...v1.0.0-alpha.277) (2026-09-03)
-
-### Bug Fixes
-
-* drop the build output that landed beside the sources ([a724f69](https://github.com/toa-io/toa/commit/a724f6921190e5c9d945e33c6035bb12d832e5c8))
-
-
-# [1.0.0-alpha.273](https://github.com/toa-io/toa/compare/v1.0.0-alpha.272...v1.0.0-alpha.273) (2026-09-02)
-
-**Note:** Version bump only for package @toa.io/extensions.fetch
-
-
-
-
-
-# [1.0.0-alpha.272](https://github.com/toa-io/toa/compare/v1.0.0-alpha.271...v1.0.0-alpha.272) (2026-09-01)
-
-**Note:** Version bump only for package @toa.io/extensions.fetch
-
-
-
-
-
-# [1.0.0-alpha.270](https://github.com/toa-io/toa/compare/v1.0.0-alpha.269...v1.0.0-alpha.270) (2026-08-31)
-
-**Note:** Version bump only for package @toa.io/extensions.fetch
-
-
-
-
-
-# [1.0.0-alpha.266](https://github.com/toa-io/toa/compare/v1.0.0-alpha.265...v1.0.0-alpha.266) (2026-08-29)
-
-**Note:** Version bump only for package @toa.io/extensions.fetch
-
-
-
-
-
-# [1.0.0-alpha.265](https://github.com/toa-io/toa/compare/v1.0.0-alpha.264...v1.0.0-alpha.265) (2026-08-29)
-
-**Note:** Version bump only for package @toa.io/extensions.fetch
-
-
-
-
-
-# [1.0.0-alpha.264](https://github.com/toa-io/toa/compare/v1.0.0-alpha.263...v1.0.0-alpha.264) (2026-08-29)
-
-**Note:** Version bump only for package @toa.io/extensions.fetch
-
-
-
-
-
-# [1.0.0-alpha.262](https://github.com/toa-io/toa/compare/v1.0.0-alpha.261...v1.0.0-alpha.262) (2026-08-28)
-
-**Note:** Version bump only for package @toa.io/extensions.fetch
-
-
-
-
-
-# [1.0.0-alpha.259](https://github.com/toa-io/toa/compare/v1.0.0-alpha.258...v1.0.0-alpha.259) (2026-08-24)
-
-**Note:** Version bump only for package @toa.io/extensions.fetch
-
-
-
-
-
-# [1.0.0-alpha.257](https://github.com/toa-io/toa/compare/v1.0.0-alpha.256...v1.0.0-alpha.257) (2026-08-24)
+# [1.0.0-alpha.287](https://github.com/toa-io/toa/compare/v1.0.0-alpha.286...v1.0.0-alpha.287) (2026-09-06)
 
 **Note:** Version bump only for package @toa.io/extensions.fetch

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/extensions.fetch",
-  "version": "1.0.0-alpha.284",
+  "version": "1.0.0-alpha.287",
   "type": "module",
   "description": "Toa Fetch extension",
   "author": "temich <tema.gurtovoy@gmail.com>",
@@ -21,8 +21,8 @@
     "transpile": "tsc"
   },
   "dependencies": {
-    "@toa.io/core": "1.0.0-alpha.284",
-    "openspan": "1.0.0-alpha.277"
+    "@toa.io/core": "1.0.0-alpha.287",
+    "openspan": "1.0.0-alpha.286"
   },
-  "gitHead": "006755556879e91e8d68fa86753aa3b475bdf4bf"
+  "gitHead": "5c7944a70c16065ab6372072385cc1f02f5db77c"
 }

package/source/Aspect.test.ts

@@ -58,8 +58,14 @@ it('does not retry by default', async () => {
 })
 
 it('retries unexpected responses and returns an expected response', async () => {
-  fetchMock.mock.mockImplementationOnce(async () => new Response(null, { status: 503 }), fetchMock.mock.callCount())
-  fetchMock.mock.mockImplementationOnce(async () => new Response(null, { status: 201 }), fetchMock.mock.callCount() + 1)
+  fetchMock.mock.mockImplementationOnce(
+    async () => new Response(null, { status: 503 }),
+    fetchMock.mock.callCount()
+  )
+  fetchMock.mock.mockImplementationOnce(
+    async () => new Response(null, { status: 201 }),
+    fetchMock.mock.callCount() + 1
+  )
 
   const response = await aspect.invoke('create', 'https://example.com', {
     retry: { attempts: 3, expected: [201], delay: 0 }
@@ -73,8 +79,14 @@ it('cancels an unexpected response body before retrying', async () => {
   const cancel = mock.fn()
   const body = new ReadableStream({ cancel })
 
-  fetchMock.mock.mockImplementationOnce(async () => new Response(body, { status: 503 }), fetchMock.mock.callCount())
-  fetchMock.mock.mockImplementationOnce(async () => new Response(null, { status: 200 }), fetchMock.mock.callCount() + 1)
+  fetchMock.mock.mockImplementationOnce(
+    async () => new Response(body, { status: 503 }),
+    fetchMock.mock.callCount()
+  )
+  fetchMock.mock.mockImplementationOnce(
+    async () => new Response(null, { status: 200 }),
+    fetchMock.mock.callCount() + 1
+  )
 
   await aspect.invoke('get', 'https://example.com', {
     retry: { attempts: 2, delay: 0 }
@@ -90,8 +102,14 @@ it('continues retrying when response body cancellation fails', async () => {
     }
   })
 
-  fetchMock.mock.mockImplementationOnce(async () => new Response(body, { status: 503 }), fetchMock.mock.callCount())
-  fetchMock.mock.mockImplementationOnce(async () => new Response(null, { status: 200 }), fetchMock.mock.callCount() + 1)
+  fetchMock.mock.mockImplementationOnce(
+    async () => new Response(body, { status: 503 }),
+    fetchMock.mock.callCount()
+  )
+  fetchMock.mock.mockImplementationOnce(
+    async () => new Response(null, { status: 200 }),
+    fetchMock.mock.callCount() + 1
+  )
 
   const response = await aspect.invoke('get', 'https://example.com', {
     retry: { attempts: 2, delay: 0 }
@@ -101,8 +119,14 @@ it('continues retrying when response body cancellation fails', async () => {
 })
 
 it('replays a regular request body', async () => {
-  fetchMock.mock.mockImplementationOnce(async () => new Response(null, { status: 503 }), fetchMock.mock.callCount())
-  fetchMock.mock.mockImplementationOnce(async () => new Response(null, { status: 200 }), fetchMock.mock.callCount() + 1)
+  fetchMock.mock.mockImplementationOnce(
+    async () => new Response(null, { status: 503 }),
+    fetchMock.mock.callCount()
+  )
+  fetchMock.mock.mockImplementationOnce(
+    async () => new Response(null, { status: 200 }),
+    fetchMock.mock.callCount() + 1
+  )
 
   await aspect.invoke('create', 'https://example.com', {
     method: 'POST',
@@ -118,11 +142,18 @@ it('replays a regular request body', async () => {
 })
 
 it('honors Retry-After instead of the configured delay', async () => {
-  fetchMock.mock.mockImplementationOnce(async () => new Response(null, {
-      status: 503,
-      headers: { 'retry-after': '0' }
-    }), fetchMock.mock.callCount())
-  fetchMock.mock.mockImplementationOnce(async () => new Response(null, { status: 200 }), fetchMock.mock.callCount() + 1)
+  fetchMock.mock.mockImplementationOnce(
+    async () =>
+      new Response(null, {
+        status: 503,
+        headers: { 'retry-after': '0' }
+      }),
+    fetchMock.mock.callCount()
+  )
+  fetchMock.mock.mockImplementationOnce(
+    async () => new Response(null, { status: 200 }),
+    fetchMock.mock.callCount() + 1
+  )
 
   const response = await aspect.invoke('get', 'https://example.com', {
     retry: { attempts: 2, delay: 60_000 }
@@ -133,8 +164,14 @@ it('honors Retry-After instead of the configured delay', async () => {
 })
 
 it('returns the last unexpected response', async () => {
-  fetchMock.mock.mockImplementationOnce(async () => new Response(null, { status: 500 }), fetchMock.mock.callCount())
-  fetchMock.mock.mockImplementationOnce(async () => new Response(null, { status: 502 }), fetchMock.mock.callCount() + 1)
+  fetchMock.mock.mockImplementationOnce(
+    async () => new Response(null, { status: 500 }),
+    fetchMock.mock.callCount()
+  )
+  fetchMock.mock.mockImplementationOnce(
+    async () => new Response(null, { status: 502 }),
+    fetchMock.mock.callCount() + 1
+  )
 
   const response = await aspect.invoke('get', 'https://example.com', {
     retry: { attempts: 2, delay: 0 }
@@ -147,12 +184,22 @@ it('retries network errors and throws the final error', async () => {
   const first = new Error('first')
   const last = new Error('last')
 
-  fetchMock.mock.mockImplementationOnce(async () => { throw first }, fetchMock.mock.callCount())
-  fetchMock.mock.mockImplementationOnce(async () => { throw last }, fetchMock.mock.callCount() + 1)
-
-  await assert.rejects(aspect.invoke('get', 'https://example.com', {
-    retry: { attempts: 2, delay: 0 }
-  }), (error: any) => { assert.strictEqual(error, last); return true })
+  fetchMock.mock.mockImplementationOnce(async () => {
+    throw first
+  }, fetchMock.mock.callCount())
+  fetchMock.mock.mockImplementationOnce(async () => {
+    throw last
+  }, fetchMock.mock.callCount() + 1)
+
+  await assert.rejects(
+    aspect.invoke('get', 'https://example.com', {
+      retry: { attempts: 2, delay: 0 }
+    }),
+    (error: any) => {
+      assert.strictEqual(error, last)
+      return true
+    }
+  )
 
   assert.strictEqual(fetchMock.mock.callCount(), 2)
 })
@@ -175,26 +222,35 @@ it('aborts while waiting for another attempt', async () => {
 })
 
 it('rejects invalid retry options', async () => {
-  await assert.rejects(aspect.invoke('get', 'https://example.com', {
-    retry: { attempts: 0 }
-  }), (error: any) => /retry\.attempts/.test(error.message))
-
-  await assert.rejects(aspect.invoke('get', 'https://example.com', {
-    retry: { attempts: 2, expected: [] }
-  }), (error: any) => /retry\.expected/.test(error.message))
+  await assert.rejects(
+    aspect.invoke('get', 'https://example.com', {
+      retry: { attempts: 0 }
+    }),
+    (error: any) => /retry\.attempts/.test(error.message)
+  )
+
+  await assert.rejects(
+    aspect.invoke('get', 'https://example.com', {
+      retry: { attempts: 2, expected: [] }
+    }),
+    (error: any) => /retry\.expected/.test(error.message)
+  )
 })
 
 it('rejects an explicit streaming body before sending it', async () => {
   const body = new ReadableStream()
 
-  await assert.rejects(aspect.invoke('create', 'https://example.com', {
-    method: 'POST',
-    body,
-    // Required by Node.js for a streaming request body.
-    // @ts-expect-error -- duplex is implemented by Node but absent from lib.dom RequestInit.
-    duplex: 'half',
-    retry: { attempts: 2 }
-  }), (error: any) => /non-replayable/.test(error.message))
+  await assert.rejects(
+    aspect.invoke('create', 'https://example.com', {
+      method: 'POST',
+      body,
+      // Required by Node.js for a streaming request body.
+      // @ts-expect-error -- duplex is implemented by Node but absent from lib.dom RequestInit.
+      duplex: 'half',
+      retry: { attempts: 2 }
+    }),
+    (error: any) => /non-replayable/.test(error.message)
+  )
 
   assert.strictEqual(fetchMock.mock.callCount(), 0)
 })
@@ -202,16 +258,25 @@ it('rejects an explicit streaming body before sending it', async () => {
 it('rejects a Request input with a body before retrying', async () => {
   const request = new Request('https://example.com', { method: 'POST', body: 'hello' })
 
-  await assert.rejects(aspect.invoke('create', request, {
-    retry: { attempts: 2 }
-  }), (error: any) => /non-replayable/.test(error.message))
+  await assert.rejects(
+    aspect.invoke('create', request, {
+      retry: { attempts: 2 }
+    }),
+    (error: any) => /non-replayable/.test(error.message)
+  )
 
   assert.strictEqual(fetchMock.mock.callCount(), 0)
 })
 
 it('creates a scoped parent span with a client span for each attempt', async () => {
-  fetchMock.mock.mockImplementationOnce(async () => new Response(null, { status: 503 }), fetchMock.mock.callCount())
-  fetchMock.mock.mockImplementationOnce(async () => new Response(null, { status: 204 }), fetchMock.mock.callCount() + 1)
+  fetchMock.mock.mockImplementationOnce(
+    async () => new Response(null, { status: 503 }),
+    fetchMock.mock.callCount()
+  )
+  fetchMock.mock.mockImplementationOnce(
+    async () => new Response(null, { status: 204 }),
+    fetchMock.mock.callCount() + 1
+  )
 
   await aspect.invoke('update', 'https://example.com/items?token=secret', {
     method: 'PUT',
@@ -257,14 +322,21 @@ it('creates a scoped parent span with a client span for each attempt', async ()
       }
     }
   ])
-  assert.ok(!(JSON.stringify(spans).includes('token=secret')))
+  assert.ok(!JSON.stringify(spans).includes('token=secret'))
 })
 
 it('marks the span as failed after a final network error', async () => {
-  fetchMock.mock.mockImplementation(async () => { throw new Error('unavailable') })
+  fetchMock.mock.mockImplementation(async () => {
+    throw new Error('unavailable')
+  })
 
-  await assert.rejects(aspect.invoke('get', 'https://example.com'), (error: any) => /unavailable/.test(error.message))
+  await assert.rejects(aspect.invoke('get', 'https://example.com'), (error: any) =>
+    /unavailable/.test(error.message)
+  )
 
   assert.strictEqual(spans.length, 2)
-  assert.strictEqual(spans.every((span) => span.status === 'error'), true)
+  assert.strictEqual(
+    spans.every((span) => span.status === 'error'),
+    true
+  )
 })

package/source/Aspect.ts

@@ -1,19 +1,24 @@
 import { Connector } from '@toa.io/core'
 import { console, type Console, type SpanOptions } from 'openspan'
-import type { Locator, extensions } from '@toa.io/core'
+import type { Locator } from '@toa.io/core'
+import type { extensions } from '@toa.io/core/types'
 
 export class Aspect extends Connector implements extensions.Aspect {
   public readonly name = 'fetch'
   private readonly locator: Locator
   private readonly consoles: Record<string, Console> = {}
 
-  public constructor (locator: Locator) {
+  public constructor(locator: Locator) {
     super()
 
     this.locator = locator
   }
 
-  public async invoke (operation: string, input: RequestInfo | URL, init?: FetchInit): Promise<Response> {
+  public async invoke(
+    operation: string,
+    input: RequestInfo | URL,
+    init?: FetchInit
+  ): Promise<Response> {
     const { retry, ...nativeInit } = init ?? {}
     const body = nativeInit.body ?? (input instanceof Request ? input.body : null)
 
@@ -41,7 +46,10 @@ export class Aspect extends Connector implements extensions.Aspect {
     const output = this.output(operation)
 
     return await output.span(options, async () => {
-      const response = await invoke(request, retry, { output, parentAttributes: attributes })
+      const response = await invoke(request, retry, {
+        output,
+        parentAttributes: attributes
+      })
 
       attributes['http.response.status_code'] = response.status
 
@@ -49,7 +57,7 @@ export class Aspect extends Connector implements extensions.Aspect {
     })
   }
 
-  private output (operation: string): Console {
+  private output(operation: string): Console {
     this.consoles[operation] ??= console.fork({
       namespace: this.locator.namespace,
       component: this.locator.name,
@@ -60,8 +68,11 @@ export class Aspect extends Connector implements extensions.Aspect {
   }
 }
 
-async function invoke (request: Request, options: RetryOptions | undefined,
-  telemetry: InvocationTelemetry): Promise<Response> {
+async function invoke(
+  request: Request,
+  options: RetryOptions | undefined,
+  telemetry: InvocationTelemetry
+): Promise<Response> {
   const retry = normalize(options)
 
   let response: Response | undefined
@@ -79,7 +90,8 @@ async function invoke (request: Request, options: RetryOptions | undefined,
     if (expected(response.status, retry.expected) || attempt === retry.attempts)
       return response
 
-    const interval = retryAfter(response.headers.get('retry-after')) ?? delay(retry, attempt)
+    const interval =
+      retryAfter(response.headers.get('retry-after')) ?? delay(retry, attempt)
 
     await discard(response)
     await wait(interval, request.signal)
@@ -88,7 +100,11 @@ async function invoke (request: Request, options: RetryOptions | undefined,
   return response!
 }
 
-async function send (request: Request, attempt: number, telemetry: InvocationTelemetry): Promise<Response> {
+async function send(
+  request: Request,
+  attempt: number,
+  telemetry: InvocationTelemetry
+): Promise<Response> {
   const attributes: Record<string, unknown> = {
     ...telemetry.parentAttributes,
     'retry.attempt': attempt
@@ -96,20 +112,26 @@ async function send (request: Request, attempt: number, telemetry: InvocationTel
 
   delete attributes['retry.attempts']
 
-  return await telemetry.output.span({
-    name: `attempt ${attempt}`,
-    kind: 'client',
-    attributes
-  }, async () => {
-    const response = await globalThis.fetch(request.clone())
+  return await telemetry.output.span(
+    {
+      name: `attempt ${attempt}`,
+      kind: 'client',
+      attributes
+    },
+    async () => {
+      const response = await globalThis.fetch(request.clone())
 
-    attributes['http.response.status_code'] = response.status
+      attributes['http.response.status_code'] = response.status
 
-    return response
-  })
+      return response
+    }
+  )
 }
 
-async function retryError (error: unknown, parameters: RetryErrorParameters): Promise<void> {
+async function retryError(
+  error: unknown,
+  parameters: RetryErrorParameters
+): Promise<void> {
   const { attempt, options, request } = parameters
 
   if (attempt === options.attempts || request.signal.aborted) throw error
@@ -117,7 +139,7 @@ async function retryError (error: unknown, parameters: RetryErrorParameters): Pr
   await wait(delay(options, attempt), request.signal)
 }
 
-async function discard (response: Response): Promise<void> {
+async function discard(response: Response): Promise<void> {
   try {
     await response.body?.cancel()
   } catch {
@@ -125,22 +147,37 @@ async function discard (response: Response): Promise<void> {
   }
 }
 
-function normalize (options?: RetryOptions): NormalizedRetryOptions {
+function normalize(options?: RetryOptions): NormalizedRetryOptions {
   if (options === undefined)
-    return { attempts: 1, expected: undefined, delay: DEFAULT_DELAY, factor: DEFAULT_FACTOR }
+    return {
+      attempts: 1,
+      expected: undefined,
+      delay: DEFAULT_DELAY,
+      factor: DEFAULT_FACTOR
+    }
 
   if (!Number.isInteger(options.attempts) || options.attempts < 1)
     throw new TypeError('retry.attempts must be an integer greater than or equal to 1')
 
-  if (options.expected !== undefined &&
-    (options.expected.length === 0 || options.expected.some((status) =>
-      !Number.isInteger(status) || status < 100 || status > 599)))
+  if (
+    options.expected !== undefined &&
+    (options.expected.length === 0 ||
+      options.expected.some(
+        (status) => !Number.isInteger(status) || status < 100 || status > 599
+      ))
+  )
     throw new TypeError('retry.expected must contain HTTP status codes')
 
-  if (options.delay !== undefined && (!Number.isFinite(options.delay) || options.delay < 0))
+  if (
+    options.delay !== undefined &&
+    (!Number.isFinite(options.delay) || options.delay < 0)
+  )
     throw new TypeError('retry.delay must be a non-negative number')
 
-  if (options.factor !== undefined && (!Number.isFinite(options.factor) || options.factor < 0))
+  if (
+    options.factor !== undefined &&
+    (!Number.isFinite(options.factor) || options.factor < 0)
+  )
     throw new TypeError('retry.factor must be a non-negative number')
 
   return {
@@ -151,15 +188,17 @@ function normalize (options?: RetryOptions): NormalizedRetryOptions {
   }
 }
 
-function expected (status: number, statuses?: number[]): boolean {
-  return statuses === undefined ? status >= 200 && status < 300 : statuses.includes(status)
+function expected(status: number, statuses?: number[]): boolean {
+  return statuses === undefined
+    ? status >= 200 && status < 300
+    : statuses.includes(status)
 }
 
-function delay (options: NormalizedRetryOptions, attempt: number): number {
+function delay(options: NormalizedRetryOptions, attempt: number): number {
   return options.delay * Math.pow(options.factor, attempt - 1)
 }
 
-function retryAfter (value: string | null): number | undefined {
+function retryAfter(value: string | null): number | undefined {
   if (value === null) return undefined
 
   const seconds = Number(value)
@@ -173,7 +212,7 @@ function retryAfter (value: string | null): number | undefined {
   return Math.max(0, date - Date.now())
 }
 
-async function wait (milliseconds: number, signal: AbortSignal): Promise<void> {
+async function wait(milliseconds: number, signal: AbortSignal): Promise<void> {
   if (signal.aborted) throw signal.reason
 
   await new Promise<void>((resolve, reject) => {
@@ -181,19 +220,19 @@ async function wait (milliseconds: number, signal: AbortSignal): Promise<void> {
 
     signal.addEventListener('abort', aborted, { once: true })
 
-    function done (): void {
+    function done(): void {
       signal.removeEventListener('abort', aborted)
       resolve()
     }
 
-    function aborted (): void {
+    function aborted(): void {
       clearTimeout(timeout)
       reject(signal.reason)
     }
   })
 }
 
-function requestURL (request: Request): URL {
+function requestURL(request: Request): URL {
   return new URL(request.url)
 }
 

package/source/Factory.ts

@@ -1,8 +1,9 @@
 import { Aspect } from './Aspect.js'
-import type { Locator, extensions } from '@toa.io/core'
+import type { Locator } from '@toa.io/core'
+import type { extensions } from '@toa.io/core/types'
 
 export class Factory implements extensions.Factory {
-  public aspect (locator: Locator): extensions.Aspect {
+  public aspect(locator: Locator): extensions.Aspect {
     return new Aspect(locator)
   }
 }

package/source/context.ts

@@ -1,7 +1,7 @@
-import type { Contribution } from '@toa.io/core'
+import type { Contribution } from '@toa.io/core/types'
 
 /** What this extension puts on the context of every component, being declared for all. */
-export function context (): Contribution {
+export function context(): Contribution {
   return {
     name: 'fetch',
     type: '(input: string | URL | Request, init?: FetchInit) => Promise<Response>',

package/transpiled/Aspect.d.ts

@@ -1,5 +1,6 @@
 import { Connector } from '@toa.io/core';
-import type { Locator, extensions } from '@toa.io/core';
+import type { Locator } from '@toa.io/core';
+import type { extensions } from '@toa.io/core/types';
 export declare class Aspect extends Connector implements extensions.Aspect {
     readonly name = "fetch";
     private readonly locator;