@toa.io/extensions.fetch 1.0.0-alpha.251

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@toa.io/extensions.fetch",
+  "version": "1.0.0-alpha.251",
+  "description": "Toa Fetch extension",
+  "author": "temich <tema.gurtovoy@gmail.com>",
+  "homepage": "https://github.com/toa-io/toa#readme",
+  "main": "transpiled/index.js",
+  "types": "transpiled/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/toa-io/toa.git"
+  },
+  "bugs": {
+    "url": "https://github.com/toa-io/toa/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "transpile": "tsc"
+  },
+  "dependencies": {
+    "@toa.io/core": "1.0.0-alpha.251",
+    "openspan": "1.0.0-alpha.251"
+  },
+  "jest": {
+    "preset": "ts-jest",
+    "testEnvironment": "node"
+  }
+}

package/readme.md

@@ -0,0 +1,61 @@
+# Fetch
+
+The Fetch extension provides every Node component with a WHATWG-compatible `context.fetch()`.
+It is built in and requires no manifest declaration.
+
+```js
+const response = await context.fetch('https://example.com/items')
+```
+
+## Retry
+
+Retries are disabled unless `retry` is provided in the second argument.
+
+```js
+const response = await context.fetch('https://example.com/items', {
+  retry: {
+    attempts: 3,
+    expected: [200],
+    delay: 100,
+    factor: 2
+  }
+})
+```
+
+- `attempts` is required and includes the initial request.
+- `expected` defaults to all statuses from `200` through `299`.
+- `delay` defaults to `100` milliseconds.
+- `factor` defaults to `2`.
+
+`Retry-After` takes precedence over the calculated delay. Aborting the request also aborts a retry
+delay. After the final unexpected HTTP response, that `Response` is returned. After the final
+network failure, the error is thrown.
+
+When a response status is not expected and another attempt remains, the extension calls
+`response.body.cancel()` before waiting and retrying. The unexpected body is not exposed to the
+caller and is not buffered or drained. Cancellation is best-effort: a cancellation error does not
+prevent the next attempt. If no attempts remain, the final unexpected `Response` is returned with
+its body untouched, so the caller can consume it normally.
+
+An explicit `ReadableStream` body and a `Request` input that already contains a body cannot be
+retried because their contents cannot be recreated safely. They remain supported when retries are
+disabled or `attempts` is `1`.
+
+## Telemetry
+
+Each call creates one logical parent span whose name has the form `POST https://example.com`.
+Every actual network attempt creates a nested client span:
+
+```text
+POST https://example.com
+├── attempt 1
+├── attempt 2
+└── attempt 3
+```
+
+The parent span records the final status and total number of attempts. Each attempt span records its
+one-based attempt number and response status. A network failure marks that attempt span as failed;
+the parent is marked as failed only when the complete fetch call fails. The full URL, query string,
+headers, and bodies are not recorded.
+
+The extension does not cache responses.

package/source/Aspect.test.ts

@@ -0,0 +1,272 @@
+import { Locator } from '@toa.io/core'
+import { consoleExporter, exporting } from 'openspan'
+import { Aspect } from './Aspect'
+import type { Span } from 'openspan'
+
+const nativeFetch = globalThis.fetch
+
+let aspect: Aspect
+let fetchMock: jest.MockedFunction<typeof fetch>
+let spans: Span[]
+
+beforeEach(() => {
+  aspect = new Aspect(new Locator('users', 'identity'))
+  fetchMock = jest.fn()
+  globalThis.fetch = fetchMock
+  spans = []
+  exporting([{ export: (span) => spans.push(span) }])
+})
+
+afterEach(() => {
+  globalThis.fetch = nativeFetch
+  exporting([consoleExporter])
+})
+
+it('delegates to native fetch and returns its Response', async () => {
+  const response = new Response('ok', { status: 201, headers: { 'x-test': 'yes' } })
+
+  fetchMock.mockResolvedValue(response)
+
+  const result = await aspect.invoke('create', 'https://example.com/items?secret=yes', {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: '{}'
+  })
+
+  expect(result).toBe(response)
+  expect(fetchMock).toHaveBeenCalledTimes(1)
+
+  const request = fetchMock.mock.calls[0][0] as Request
+
+  expect(request).toBeInstanceOf(Request)
+  expect(request.method).toBe('POST')
+  expect(request.url).toBe('https://example.com/items?secret=yes')
+  await expect(request.text()).resolves.toBe('{}')
+})
+
+it('does not retry by default', async () => {
+  fetchMock.mockResolvedValue(new Response(null, { status: 503 }))
+
+  const response = await aspect.invoke('get', 'https://example.com')
+
+  expect(response.status).toBe(503)
+  expect(fetchMock).toHaveBeenCalledTimes(1)
+})
+
+it('retries unexpected responses and returns an expected response', async () => {
+  fetchMock
+    .mockResolvedValueOnce(new Response(null, { status: 503 }))
+    .mockResolvedValueOnce(new Response(null, { status: 201 }))
+
+  const response = await aspect.invoke('create', 'https://example.com', {
+    retry: { attempts: 3, expected: [201], delay: 0 }
+  })
+
+  expect(response.status).toBe(201)
+  expect(fetchMock).toHaveBeenCalledTimes(2)
+})
+
+it('cancels an unexpected response body before retrying', async () => {
+  const cancel = jest.fn()
+  const body = new ReadableStream({ cancel })
+
+  fetchMock
+    .mockResolvedValueOnce(new Response(body, { status: 503 }))
+    .mockResolvedValueOnce(new Response(null, { status: 200 }))
+
+  await aspect.invoke('get', 'https://example.com', {
+    retry: { attempts: 2, delay: 0 }
+  })
+
+  expect(cancel).toHaveBeenCalledTimes(1)
+})
+
+it('continues retrying when response body cancellation fails', async () => {
+  const body = new ReadableStream({
+    cancel: () => {
+      throw new Error('cancel failed')
+    }
+  })
+
+  fetchMock
+    .mockResolvedValueOnce(new Response(body, { status: 503 }))
+    .mockResolvedValueOnce(new Response(null, { status: 200 }))
+
+  const response = await aspect.invoke('get', 'https://example.com', {
+    retry: { attempts: 2, delay: 0 }
+  })
+
+  expect(response.status).toBe(200)
+})
+
+it('replays a regular request body', async () => {
+  fetchMock
+    .mockResolvedValueOnce(new Response(null, { status: 503 }))
+    .mockResolvedValueOnce(new Response(null, { status: 200 }))
+
+  await aspect.invoke('create', 'https://example.com', {
+    method: 'POST',
+    body: 'hello',
+    retry: { attempts: 2, delay: 0 }
+  })
+
+  const first = fetchMock.mock.calls[0][0] as Request
+  const second = fetchMock.mock.calls[1][0] as Request
+
+  await expect(first.text()).resolves.toBe('hello')
+  await expect(second.text()).resolves.toBe('hello')
+})
+
+it('honors Retry-After instead of the configured delay', async () => {
+  fetchMock
+    .mockResolvedValueOnce(new Response(null, {
+      status: 503,
+      headers: { 'retry-after': '0' }
+    }))
+    .mockResolvedValueOnce(new Response(null, { status: 200 }))
+
+  const response = await aspect.invoke('get', 'https://example.com', {
+    retry: { attempts: 2, delay: 60_000 }
+  })
+
+  expect(response.status).toBe(200)
+  expect(fetchMock).toHaveBeenCalledTimes(2)
+})
+
+it('returns the last unexpected response', async () => {
+  fetchMock
+    .mockResolvedValueOnce(new Response(null, { status: 500 }))
+    .mockResolvedValueOnce(new Response(null, { status: 502 }))
+
+  const response = await aspect.invoke('get', 'https://example.com', {
+    retry: { attempts: 2, delay: 0 }
+  })
+
+  expect(response.status).toBe(502)
+})
+
+it('retries network errors and throws the final error', async () => {
+  const first = new Error('first')
+  const last = new Error('last')
+
+  fetchMock.mockRejectedValueOnce(first).mockRejectedValueOnce(last)
+
+  await expect(aspect.invoke('get', 'https://example.com', {
+    retry: { attempts: 2, delay: 0 }
+  })).rejects.toBe(last)
+
+  expect(fetchMock).toHaveBeenCalledTimes(2)
+})
+
+it('aborts while waiting for another attempt', async () => {
+  const controller = new AbortController()
+
+  fetchMock.mockResolvedValue(new Response(null, { status: 503 }))
+
+  const promise = aspect.invoke('get', 'https://example.com', {
+    signal: controller.signal,
+    retry: { attempts: 2, delay: 60_000 }
+  })
+
+  await new Promise((resolve) => setImmediate(resolve))
+  controller.abort(new Error('cancelled'))
+
+  await expect(promise).rejects.toThrow('cancelled')
+  expect(fetchMock).toHaveBeenCalledTimes(1)
+})
+
+it('rejects invalid retry options', async () => {
+  await expect(aspect.invoke('get', 'https://example.com', {
+    retry: { attempts: 0 }
+  })).rejects.toThrow('retry.attempts')
+
+  await expect(aspect.invoke('get', 'https://example.com', {
+    retry: { attempts: 2, expected: [] }
+  })).rejects.toThrow('retry.expected')
+})
+
+it('rejects an explicit streaming body before sending it', async () => {
+  const body = new ReadableStream()
+
+  await expect(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 }
+  })).rejects.toThrow('non-replayable')
+
+  expect(fetchMock).not.toHaveBeenCalled()
+})
+
+it('rejects a Request input with a body before retrying', async () => {
+  const request = new Request('https://example.com', { method: 'POST', body: 'hello' })
+
+  await expect(aspect.invoke('create', request, {
+    retry: { attempts: 2 }
+  })).rejects.toThrow('non-replayable')
+
+  expect(fetchMock).not.toHaveBeenCalled()
+})
+
+it('creates a scoped parent span with a client span for each attempt', async () => {
+  fetchMock
+    .mockResolvedValueOnce(new Response(null, { status: 503 }))
+    .mockResolvedValueOnce(new Response(null, { status: 204 }))
+
+  await aspect.invoke('update', 'https://example.com/items?token=secret', {
+    method: 'PUT',
+    retry: { attempts: 2, delay: 0 }
+  })
+
+  expect(spans).toHaveLength(3)
+
+  const parent = spans.find((span) => span.name === 'PUT https://example.com')!
+  const attempts = spans.filter((span) => span.parentId === parent.spanId)
+
+  expect(parent).toMatchObject({
+    name: 'PUT https://example.com',
+    kind: 'internal',
+    scope: {
+      namespace: 'identity',
+      component: 'users',
+      operation: 'update'
+    },
+    attributes: {
+      'http.request.method': 'PUT',
+      'http.response.status_code': 204,
+      'url.scheme': 'https',
+      'server.address': 'example.com',
+      'retry.attempts': 2
+    }
+  })
+  expect(attempts).toMatchObject([
+    {
+      name: 'attempt 1',
+      kind: 'client',
+      attributes: {
+        'retry.attempt': 1,
+        'http.response.status_code': 503
+      }
+    },
+    {
+      name: 'attempt 2',
+      kind: 'client',
+      attributes: {
+        'retry.attempt': 2,
+        'http.response.status_code': 204
+      }
+    }
+  ])
+  expect(JSON.stringify(spans)).not.toContain('token=secret')
+})
+
+it('marks the span as failed after a final network error', async () => {
+  fetchMock.mockRejectedValue(new Error('unavailable'))
+
+  await expect(aspect.invoke('get', 'https://example.com')).rejects.toThrow('unavailable')
+
+  expect(spans).toHaveLength(2)
+  expect(spans.every((span) => span.status === 'error')).toBe(true)
+})

package/source/Aspect.ts

@@ -0,0 +1,230 @@
+import { Connector } from '@toa.io/core'
+import { console, type Console, type SpanOptions } from 'openspan'
+import type { Locator, extensions } from '@toa.io/core'
+
+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) {
+    super()
+
+    this.locator = locator
+  }
+
+  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)
+
+    if (retry !== undefined && retry.attempts > 1 && body instanceof ReadableStream)
+      throw new TypeError('Cannot retry a request with a non-replayable body')
+
+    const request = new Request(input, nativeInit)
+
+    const attributes: Record<string, unknown> = {
+      'http.request.method': request.method,
+      'url.scheme': requestURL(request).protocol.slice(0, -1),
+      'server.address': requestURL(request).hostname
+    }
+
+    const url = requestURL(request)
+
+    if (url.port !== '') attributes['server.port'] = Number(url.port)
+
+    const options: SpanOptions = {
+      name: `${request.method} ${url.origin}`,
+      kind: 'internal',
+      attributes
+    }
+
+    const output = this.output(operation)
+
+    return await output.span(options, async () => {
+      const response = await invoke(request, retry, { output, parentAttributes: attributes })
+
+      attributes['http.response.status_code'] = response.status
+
+      return response
+    })
+  }
+
+  private output (operation: string): Console {
+    this.consoles[operation] ??= console.fork({
+      namespace: this.locator.namespace,
+      component: this.locator.name,
+      operation
+    })
+
+    return this.consoles[operation]
+  }
+}
+
+async function invoke (request: Request, options: RetryOptions | undefined,
+  telemetry: InvocationTelemetry): Promise<Response> {
+  const retry = normalize(options)
+
+  let response: Response | undefined
+
+  for (let attempt = 1; attempt <= retry.attempts; attempt++) {
+    telemetry.parentAttributes['retry.attempts'] = attempt
+
+    try {
+      response = await send(request, attempt, telemetry)
+    } catch (error) {
+      await retryError(error, { attempt, options: retry, request })
+      continue
+    }
+
+    if (expected(response.status, retry.expected) || attempt === retry.attempts)
+      return response
+
+    const interval = retryAfter(response.headers.get('retry-after')) ?? delay(retry, attempt)
+
+    await discard(response)
+    await wait(interval, request.signal)
+  }
+
+  return response!
+}
+
+async function send (request: Request, attempt: number, telemetry: InvocationTelemetry): Promise<Response> {
+  const attributes: Record<string, unknown> = {
+    ...telemetry.parentAttributes,
+    'retry.attempt': attempt
+  }
+
+  delete attributes['retry.attempts']
+
+  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
+
+    return response
+  })
+}
+
+async function retryError (error: unknown, parameters: RetryErrorParameters): Promise<void> {
+  const { attempt, options, request } = parameters
+
+  if (attempt === options.attempts || request.signal.aborted) throw error
+
+  await wait(delay(options, attempt), request.signal)
+}
+
+async function discard (response: Response): Promise<void> {
+  try {
+    await response.body?.cancel()
+  } catch {
+    // The response is discarded regardless of whether its stream closes cleanly.
+  }
+}
+
+function normalize (options?: RetryOptions): NormalizedRetryOptions {
+  if (options === undefined)
+    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)))
+    throw new TypeError('retry.expected must contain HTTP status codes')
+
+  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))
+    throw new TypeError('retry.factor must be a non-negative number')
+
+  return {
+    attempts: options.attempts,
+    expected: options.expected,
+    delay: options.delay ?? DEFAULT_DELAY,
+    factor: options.factor ?? DEFAULT_FACTOR
+  }
+}
+
+function expected (status: number, statuses?: number[]): boolean {
+  return statuses === undefined ? status >= 200 && status < 300 : statuses.includes(status)
+}
+
+function delay (options: NormalizedRetryOptions, attempt: number): number {
+  return options.delay * Math.pow(options.factor, attempt - 1)
+}
+
+function retryAfter (value: string | null): number | undefined {
+  if (value === null) return undefined
+
+  const seconds = Number(value)
+
+  if (Number.isFinite(seconds) && seconds >= 0) return seconds * 1000
+
+  const date = Date.parse(value)
+
+  if (Number.isNaN(date)) return undefined
+
+  return Math.max(0, date - Date.now())
+}
+
+async function wait (milliseconds: number, signal: AbortSignal): Promise<void> {
+  if (signal.aborted) throw signal.reason
+
+  await new Promise<void>((resolve, reject) => {
+    const timeout = setTimeout(done, milliseconds)
+
+    signal.addEventListener('abort', aborted, { once: true })
+
+    function done (): void {
+      signal.removeEventListener('abort', aborted)
+      resolve()
+    }
+
+    function aborted (): void {
+      clearTimeout(timeout)
+      reject(signal.reason)
+    }
+  })
+}
+
+function requestURL (request: Request): URL {
+  return new URL(request.url)
+}
+
+export interface FetchInit extends RequestInit {
+  retry?: RetryOptions
+}
+
+export interface RetryOptions {
+  attempts: number
+  expected?: number[]
+  delay?: number
+  factor?: number
+}
+
+interface NormalizedRetryOptions {
+  attempts: number
+  expected?: number[]
+  delay: number
+  factor: number
+}
+
+interface RetryErrorParameters {
+  attempt: number
+  options: NormalizedRetryOptions
+  request: Request
+}
+
+interface InvocationTelemetry {
+  output: Console
+  parentAttributes: Record<string, unknown>
+}
+
+const DEFAULT_DELAY = 100
+const DEFAULT_FACTOR = 2

package/source/Factory.ts

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

package/source/index.ts

@@ -0,0 +1,2 @@
+export { Factory } from './Factory'
+export type { FetchInit, RetryOptions } from './Aspect'

package/transpiled/Aspect.d.ts

@@ -0,0 +1,19 @@
+import { Connector } from '@toa.io/core';
+import type { Locator, extensions } from '@toa.io/core';
+export declare class Aspect extends Connector implements extensions.Aspect {
+    readonly name = "fetch";
+    private readonly locator;
+    private readonly consoles;
+    constructor(locator: Locator);
+    invoke(operation: string, input: RequestInfo | URL, init?: FetchInit): Promise<Response>;
+    private output;
+}
+export interface FetchInit extends RequestInit {
+    retry?: RetryOptions;
+}
+export interface RetryOptions {
+    attempts: number;
+    expected?: number[];
+    delay?: number;
+    factor?: number;
+}

package/transpiled/Aspect.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Aspect = void 0;
+const core_1 = require("@toa.io/core");
+const openspan_1 = require("openspan");
+class Aspect extends core_1.Connector {
+    name = 'fetch';
+    locator;
+    consoles = {};
+    constructor(locator) {
+        super();
+        this.locator = locator;
+    }
+    async invoke(operation, input, init) {
+        const { retry, ...nativeInit } = init ?? {};
+        const body = nativeInit.body ?? (input instanceof Request ? input.body : null);
+        if (retry !== undefined && retry.attempts > 1 && body instanceof ReadableStream)
+            throw new TypeError('Cannot retry a request with a non-replayable body');
+        const request = new Request(input, nativeInit);
+        const attributes = {
+            'http.request.method': request.method,
+            'url.scheme': requestURL(request).protocol.slice(0, -1),
+            'server.address': requestURL(request).hostname
+        };
+        const url = requestURL(request);
+        if (url.port !== '')
+            attributes['server.port'] = Number(url.port);
+        const options = {
+            name: `${request.method} ${url.origin}`,
+            kind: 'internal',
+            attributes
+        };
+        const output = this.output(operation);
+        return await output.span(options, async () => {
+            const response = await invoke(request, retry, { output, parentAttributes: attributes });
+            attributes['http.response.status_code'] = response.status;
+            return response;
+        });
+    }
+    output(operation) {
+        this.consoles[operation] ??= openspan_1.console.fork({
+            namespace: this.locator.namespace,
+            component: this.locator.name,
+            operation
+        });
+        return this.consoles[operation];
+    }
+}
+exports.Aspect = Aspect;
+async function invoke(request, options, telemetry) {
+    const retry = normalize(options);
+    let response;
+    for (let attempt = 1; attempt <= retry.attempts; attempt++) {
+        telemetry.parentAttributes['retry.attempts'] = attempt;
+        try {
+            response = await send(request, attempt, telemetry);
+        }
+        catch (error) {
+            await retryError(error, { attempt, options: retry, request });
+            continue;
+        }
+        if (expected(response.status, retry.expected) || attempt === retry.attempts)
+            return response;
+        const interval = retryAfter(response.headers.get('retry-after')) ?? delay(retry, attempt);
+        await discard(response);
+        await wait(interval, request.signal);
+    }
+    return response;
+}
+async function send(request, attempt, telemetry) {
+    const attributes = {
+        ...telemetry.parentAttributes,
+        'retry.attempt': attempt
+    };
+    delete attributes['retry.attempts'];
+    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;
+        return response;
+    });
+}
+async function retryError(error, parameters) {
+    const { attempt, options, request } = parameters;
+    if (attempt === options.attempts || request.signal.aborted)
+        throw error;
+    await wait(delay(options, attempt), request.signal);
+}
+async function discard(response) {
+    try {
+        await response.body?.cancel();
+    }
+    catch {
+        // The response is discarded regardless of whether its stream closes cleanly.
+    }
+}
+function normalize(options) {
+    if (options === undefined)
+        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)))
+        throw new TypeError('retry.expected must contain HTTP status codes');
+    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))
+        throw new TypeError('retry.factor must be a non-negative number');
+    return {
+        attempts: options.attempts,
+        expected: options.expected,
+        delay: options.delay ?? DEFAULT_DELAY,
+        factor: options.factor ?? DEFAULT_FACTOR
+    };
+}
+function expected(status, statuses) {
+    return statuses === undefined ? status >= 200 && status < 300 : statuses.includes(status);
+}
+function delay(options, attempt) {
+    return options.delay * Math.pow(options.factor, attempt - 1);
+}
+function retryAfter(value) {
+    if (value === null)
+        return undefined;
+    const seconds = Number(value);
+    if (Number.isFinite(seconds) && seconds >= 0)
+        return seconds * 1000;
+    const date = Date.parse(value);
+    if (Number.isNaN(date))
+        return undefined;
+    return Math.max(0, date - Date.now());
+}
+async function wait(milliseconds, signal) {
+    if (signal.aborted)
+        throw signal.reason;
+    await new Promise((resolve, reject) => {
+        const timeout = setTimeout(done, milliseconds);
+        signal.addEventListener('abort', aborted, { once: true });
+        function done() {
+            signal.removeEventListener('abort', aborted);
+            resolve();
+        }
+        function aborted() {
+            clearTimeout(timeout);
+            reject(signal.reason);
+        }
+    });
+}
+function requestURL(request) {
+    return new URL(request.url);
+}
+const DEFAULT_DELAY = 100;
+const DEFAULT_FACTOR = 2;
+//# sourceMappingURL=Aspect.js.map

package/transpiled/Aspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Aspect.js","sourceRoot":"","sources":["../source/Aspect.ts"],"names":[],"mappings":";;;AAAA,uCAAwC;AACxC,uCAAkE;AAGlE,MAAa,MAAO,SAAQ,gBAAS;IACnB,IAAI,GAAG,OAAO,CAAA;IACb,OAAO,CAAS;IAChB,QAAQ,GAA4B,EAAE,CAAA;IAEvD,YAAoB,OAAgB;QAClC,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAEM,KAAK,CAAC,MAAM,CAAE,SAAiB,EAAE,KAAwB,EAAE,IAAgB;QAChF,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,EAAE,GAAG,IAAI,IAAI,EAAE,CAAA;QAC3C,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,IAAI,CAAC,KAAK,YAAY,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAE9E,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,IAAI,IAAI,YAAY,cAAc;YAC7E,MAAM,IAAI,SAAS,CAAC,mDAAmD,CAAC,CAAA;QAE1E,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;QAE9C,MAAM,UAAU,GAA4B;YAC1C,qBAAqB,EAAE,OAAO,CAAC,MAAM;YACrC,YAAY,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACvD,gBAAgB,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,QAAQ;SAC/C,CAAA;QAED,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,CAAA;QAE/B,IAAI,GAAG,CAAC,IAAI,KAAK,EAAE;YAAE,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAEjE,MAAM,OAAO,GAAgB;YAC3B,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE;YACvC,IAAI,EAAE,UAAU;YAChB,UAAU;SACX,CAAA;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QAErC,OAAO,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;YAC3C,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,UAAU,EAAE,CAAC,CAAA;YAEvF,UAAU,CAAC,2BAA2B,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAA;YAEzD,OAAO,QAAQ,CAAA;QACjB,CAAC,CAAC,CAAA;IACJ,CAAC;IAEO,MAAM,CAAE,SAAiB;QAC/B,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,kBAAO,CAAC,IAAI,CAAC;YACxC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;YACjC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;YAC5B,SAAS;SACV,CAAC,CAAA;QAEF,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;IACjC,CAAC;CACF;AAxDD,wBAwDC;AAED,KAAK,UAAU,MAAM,CAAE,OAAgB,EAAE,OAAiC,EACxE,SAA8B;IAC9B,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;IAEhC,IAAI,QAA8B,CAAA;IAElC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC;QAC3D,SAAS,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAA;QAEtD,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAA;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;YAC7D,SAAQ;QACV,CAAC;QAED,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,OAAO,KAAK,KAAK,CAAC,QAAQ;YACzE,OAAO,QAAQ,CAAA;QAEjB,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QAEzF,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAA;QACvB,MAAM,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;IACtC,CAAC;IAED,OAAO,QAAS,CAAA;AAClB,CAAC;AAED,KAAK,UAAU,IAAI,CAAE,OAAgB,EAAE,OAAe,EAAE,SAA8B;IACpF,MAAM,UAAU,GAA4B;QAC1C,GAAG,SAAS,CAAC,gBAAgB;QAC7B,eAAe,EAAE,OAAO;KACzB,CAAA;IAED,OAAO,UAAU,CAAC,gBAAgB,CAAC,CAAA;IAEnC,OAAO,MAAM,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC;QACjC,IAAI,EAAE,WAAW,OAAO,EAAE;QAC1B,IAAI,EAAE,QAAQ;QACd,UAAU;KACX,EAAE,KAAK,IAAI,EAAE;QACZ,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;QAExD,UAAU,CAAC,2BAA2B,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAA;QAEzD,OAAO,QAAQ,CAAA;IACjB,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,KAAK,UAAU,UAAU,CAAE,KAAc,EAAE,UAAgC;IACzE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,UAAU,CAAA;IAEhD,IAAI,OAAO,KAAK,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO;QAAE,MAAM,KAAK,CAAA;IAEvE,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;AACrD,CAAC;AAED,KAAK,UAAU,OAAO,CAAE,QAAkB;IACxC,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAA;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,6EAA6E;IAC/E,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAE,OAAsB;IACxC,IAAI,OAAO,KAAK,SAAS;QACvB,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA;IAE3F,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,GAAG,CAAC;QAC7D,MAAM,IAAI,SAAS,CAAC,8DAA8D,CAAC,CAAA;IAErF,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;QAChC,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CACjE,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,GAAG,IAAI,MAAM,GAAG,GAAG,CAAC,CAAC;QAC7D,MAAM,IAAI,SAAS,CAAC,+CAA+C,CAAC,CAAA;IAEtE,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC;QACvF,MAAM,IAAI,SAAS,CAAC,2CAA2C,CAAC,CAAA;IAElE,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QAC1F,MAAM,IAAI,SAAS,CAAC,4CAA4C,CAAC,CAAA;IAEnE,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,aAAa;QACrC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,cAAc;KACzC,CAAA;AACH,CAAC;AAED,SAAS,QAAQ,CAAE,MAAc,EAAE,QAAmB;IACpD,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;AAC3F,CAAC;AAED,SAAS,KAAK,CAAE,OAA+B,EAAE,OAAe;IAC9D,OAAO,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,CAAC,CAAC,CAAA;AAC9D,CAAC;AAED,SAAS,UAAU,CAAE,KAAoB;IACvC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAA;IAEpC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAE7B,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,OAAO,GAAG,IAAI,CAAA;IAEnE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAE9B,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAA;IAExC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;AACvC,CAAC;AAED,KAAK,UAAU,IAAI,CAAE,YAAoB,EAAE,MAAmB;IAC5D,IAAI,MAAM,CAAC,OAAO;QAAE,MAAM,MAAM,CAAC,MAAM,CAAA;IAEvC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,YAAY,CAAC,CAAA;QAE9C,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QAEzD,SAAS,IAAI;YACX,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YAC5C,OAAO,EAAE,CAAA;QACX,CAAC;QAED,SAAS,OAAO;YACd,YAAY,CAAC,OAAO,CAAC,CAAA;YACrB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QACvB,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,UAAU,CAAE,OAAgB;IACnC,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;AAC7B,CAAC;AA+BD,MAAM,aAAa,GAAG,GAAG,CAAA;AACzB,MAAM,cAAc,GAAG,CAAC,CAAA"}

package/transpiled/Aspect.test.d.ts

@@ -0,0 +1 @@
+export {};

package/transpiled/Aspect.test.js

@@ -0,0 +1,215 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@toa.io/core");
+const openspan_1 = require("openspan");
+const Aspect_1 = require("./Aspect");
+const nativeFetch = globalThis.fetch;
+let aspect;
+let fetchMock;
+let spans;
+beforeEach(() => {
+    aspect = new Aspect_1.Aspect(new core_1.Locator('users', 'identity'));
+    fetchMock = jest.fn();
+    globalThis.fetch = fetchMock;
+    spans = [];
+    (0, openspan_1.exporting)([{ export: (span) => spans.push(span) }]);
+});
+afterEach(() => {
+    globalThis.fetch = nativeFetch;
+    (0, openspan_1.exporting)([openspan_1.consoleExporter]);
+});
+it('delegates to native fetch and returns its Response', async () => {
+    const response = new Response('ok', { status: 201, headers: { 'x-test': 'yes' } });
+    fetchMock.mockResolvedValue(response);
+    const result = await aspect.invoke('create', 'https://example.com/items?secret=yes', {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: '{}'
+    });
+    expect(result).toBe(response);
+    expect(fetchMock).toHaveBeenCalledTimes(1);
+    const request = fetchMock.mock.calls[0][0];
+    expect(request).toBeInstanceOf(Request);
+    expect(request.method).toBe('POST');
+    expect(request.url).toBe('https://example.com/items?secret=yes');
+    await expect(request.text()).resolves.toBe('{}');
+});
+it('does not retry by default', async () => {
+    fetchMock.mockResolvedValue(new Response(null, { status: 503 }));
+    const response = await aspect.invoke('get', 'https://example.com');
+    expect(response.status).toBe(503);
+    expect(fetchMock).toHaveBeenCalledTimes(1);
+});
+it('retries unexpected responses and returns an expected response', async () => {
+    fetchMock
+        .mockResolvedValueOnce(new Response(null, { status: 503 }))
+        .mockResolvedValueOnce(new Response(null, { status: 201 }));
+    const response = await aspect.invoke('create', 'https://example.com', {
+        retry: { attempts: 3, expected: [201], delay: 0 }
+    });
+    expect(response.status).toBe(201);
+    expect(fetchMock).toHaveBeenCalledTimes(2);
+});
+it('cancels an unexpected response body before retrying', async () => {
+    const cancel = jest.fn();
+    const body = new ReadableStream({ cancel });
+    fetchMock
+        .mockResolvedValueOnce(new Response(body, { status: 503 }))
+        .mockResolvedValueOnce(new Response(null, { status: 200 }));
+    await aspect.invoke('get', 'https://example.com', {
+        retry: { attempts: 2, delay: 0 }
+    });
+    expect(cancel).toHaveBeenCalledTimes(1);
+});
+it('continues retrying when response body cancellation fails', async () => {
+    const body = new ReadableStream({
+        cancel: () => {
+            throw new Error('cancel failed');
+        }
+    });
+    fetchMock
+        .mockResolvedValueOnce(new Response(body, { status: 503 }))
+        .mockResolvedValueOnce(new Response(null, { status: 200 }));
+    const response = await aspect.invoke('get', 'https://example.com', {
+        retry: { attempts: 2, delay: 0 }
+    });
+    expect(response.status).toBe(200);
+});
+it('replays a regular request body', async () => {
+    fetchMock
+        .mockResolvedValueOnce(new Response(null, { status: 503 }))
+        .mockResolvedValueOnce(new Response(null, { status: 200 }));
+    await aspect.invoke('create', 'https://example.com', {
+        method: 'POST',
+        body: 'hello',
+        retry: { attempts: 2, delay: 0 }
+    });
+    const first = fetchMock.mock.calls[0][0];
+    const second = fetchMock.mock.calls[1][0];
+    await expect(first.text()).resolves.toBe('hello');
+    await expect(second.text()).resolves.toBe('hello');
+});
+it('honors Retry-After instead of the configured delay', async () => {
+    fetchMock
+        .mockResolvedValueOnce(new Response(null, {
+        status: 503,
+        headers: { 'retry-after': '0' }
+    }))
+        .mockResolvedValueOnce(new Response(null, { status: 200 }));
+    const response = await aspect.invoke('get', 'https://example.com', {
+        retry: { attempts: 2, delay: 60_000 }
+    });
+    expect(response.status).toBe(200);
+    expect(fetchMock).toHaveBeenCalledTimes(2);
+});
+it('returns the last unexpected response', async () => {
+    fetchMock
+        .mockResolvedValueOnce(new Response(null, { status: 500 }))
+        .mockResolvedValueOnce(new Response(null, { status: 502 }));
+    const response = await aspect.invoke('get', 'https://example.com', {
+        retry: { attempts: 2, delay: 0 }
+    });
+    expect(response.status).toBe(502);
+});
+it('retries network errors and throws the final error', async () => {
+    const first = new Error('first');
+    const last = new Error('last');
+    fetchMock.mockRejectedValueOnce(first).mockRejectedValueOnce(last);
+    await expect(aspect.invoke('get', 'https://example.com', {
+        retry: { attempts: 2, delay: 0 }
+    })).rejects.toBe(last);
+    expect(fetchMock).toHaveBeenCalledTimes(2);
+});
+it('aborts while waiting for another attempt', async () => {
+    const controller = new AbortController();
+    fetchMock.mockResolvedValue(new Response(null, { status: 503 }));
+    const promise = aspect.invoke('get', 'https://example.com', {
+        signal: controller.signal,
+        retry: { attempts: 2, delay: 60_000 }
+    });
+    await new Promise((resolve) => setImmediate(resolve));
+    controller.abort(new Error('cancelled'));
+    await expect(promise).rejects.toThrow('cancelled');
+    expect(fetchMock).toHaveBeenCalledTimes(1);
+});
+it('rejects invalid retry options', async () => {
+    await expect(aspect.invoke('get', 'https://example.com', {
+        retry: { attempts: 0 }
+    })).rejects.toThrow('retry.attempts');
+    await expect(aspect.invoke('get', 'https://example.com', {
+        retry: { attempts: 2, expected: [] }
+    })).rejects.toThrow('retry.expected');
+});
+it('rejects an explicit streaming body before sending it', async () => {
+    const body = new ReadableStream();
+    await expect(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 }
+    })).rejects.toThrow('non-replayable');
+    expect(fetchMock).not.toHaveBeenCalled();
+});
+it('rejects a Request input with a body before retrying', async () => {
+    const request = new Request('https://example.com', { method: 'POST', body: 'hello' });
+    await expect(aspect.invoke('create', request, {
+        retry: { attempts: 2 }
+    })).rejects.toThrow('non-replayable');
+    expect(fetchMock).not.toHaveBeenCalled();
+});
+it('creates a scoped parent span with a client span for each attempt', async () => {
+    fetchMock
+        .mockResolvedValueOnce(new Response(null, { status: 503 }))
+        .mockResolvedValueOnce(new Response(null, { status: 204 }));
+    await aspect.invoke('update', 'https://example.com/items?token=secret', {
+        method: 'PUT',
+        retry: { attempts: 2, delay: 0 }
+    });
+    expect(spans).toHaveLength(3);
+    const parent = spans.find((span) => span.name === 'PUT https://example.com');
+    const attempts = spans.filter((span) => span.parentId === parent.spanId);
+    expect(parent).toMatchObject({
+        name: 'PUT https://example.com',
+        kind: 'internal',
+        scope: {
+            namespace: 'identity',
+            component: 'users',
+            operation: 'update'
+        },
+        attributes: {
+            'http.request.method': 'PUT',
+            'http.response.status_code': 204,
+            'url.scheme': 'https',
+            'server.address': 'example.com',
+            'retry.attempts': 2
+        }
+    });
+    expect(attempts).toMatchObject([
+        {
+            name: 'attempt 1',
+            kind: 'client',
+            attributes: {
+                'retry.attempt': 1,
+                'http.response.status_code': 503
+            }
+        },
+        {
+            name: 'attempt 2',
+            kind: 'client',
+            attributes: {
+                'retry.attempt': 2,
+                'http.response.status_code': 204
+            }
+        }
+    ]);
+    expect(JSON.stringify(spans)).not.toContain('token=secret');
+});
+it('marks the span as failed after a final network error', async () => {
+    fetchMock.mockRejectedValue(new Error('unavailable'));
+    await expect(aspect.invoke('get', 'https://example.com')).rejects.toThrow('unavailable');
+    expect(spans).toHaveLength(2);
+    expect(spans.every((span) => span.status === 'error')).toBe(true);
+});
+//# sourceMappingURL=Aspect.test.js.map

package/transpiled/Aspect.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Aspect.test.js","sourceRoot":"","sources":["../source/Aspect.test.ts"],"names":[],"mappings":"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"}

package/transpiled/Factory.d.ts

@@ -0,0 +1,4 @@
+import type { Locator, extensions } from '@toa.io/core';
+export declare class Factory implements extensions.Factory {
+    aspect(locator: Locator): extensions.Aspect;
+}

package/transpiled/Factory.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Factory = void 0;
+const Aspect_1 = require("./Aspect");
+class Factory {
+    aspect(locator) {
+        return new Aspect_1.Aspect(locator);
+    }
+}
+exports.Factory = Factory;
+//# sourceMappingURL=Factory.js.map

package/transpiled/Factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Factory.js","sourceRoot":"","sources":["../source/Factory.ts"],"names":[],"mappings":";;;AAAA,qCAAiC;AAGjC,MAAa,OAAO;IACX,MAAM,CAAE,OAAgB;QAC7B,OAAO,IAAI,eAAM,CAAC,OAAO,CAAC,CAAA;IAC5B,CAAC;CACF;AAJD,0BAIC"}

package/transpiled/index.d.ts

@@ -0,0 +1,2 @@
+export { Factory } from './Factory';
+export type { FetchInit, RetryOptions } from './Aspect';

package/transpiled/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Factory = void 0;
+var Factory_1 = require("./Factory");
+Object.defineProperty(exports, "Factory", { enumerable: true, get: function () { return Factory_1.Factory; } });
+//# sourceMappingURL=index.js.map

package/transpiled/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":";;;AAAA,qCAAmC;AAA1B,kGAAA,OAAO,OAAA"}

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./transpiled"
+  },
+  "include": [
+    "source"
+  ]
+}