@mswjs/interceptors 0.41.9 → 0.42.0

package/src/batch-interceptor.test.ts

@@ -0,0 +1,475 @@
+import { TypedEvent } from 'rettime'
+import { Interceptor, InterceptorReadyState } from './interceptor'
+import { BatchInterceptor } from './batch-interceptor'
+
+afterEach(() => {
+  vi.resetAllMocks()
+})
+
+it('applies child interceptors', () => {
+  class PrimaryInterceptor extends Interceptor<any> {
+    protected predicate(): boolean {
+      return true
+    }
+    protected setup(): void {}
+  }
+
+  class SecondInterceptor extends Interceptor<any> {
+    protected predicate(): boolean {
+      return true
+    }
+    protected setup(): void {}
+  }
+
+  const instances = {
+    primary: new PrimaryInterceptor(),
+    secondary: new SecondInterceptor(),
+  }
+
+  const interceptor = new BatchInterceptor({
+    name: 'batch-apply',
+    interceptors: [instances.primary, instances.secondary],
+  })
+
+  const primaryApplySpy = vi.spyOn(instances.primary, 'apply')
+  const secondaryApplySpy = vi.spyOn(instances.secondary, 'apply')
+
+  interceptor.apply()
+
+  expect(primaryApplySpy).toHaveBeenCalledTimes(1)
+  expect(secondaryApplySpy).toHaveBeenCalledTimes(1)
+})
+
+it('applies duplicate child interceptors once', () => {
+  class ChildInterceptor extends Interceptor<{
+    request: TypedEvent
+  }> {
+    protected predicate(): boolean {
+      return true
+    }
+
+    protected setup(): void {}
+  }
+
+  const childInterceptor = new ChildInterceptor()
+  const interceptor = new BatchInterceptor({
+    name: 'batch-apply-duplicate',
+    interceptors: [childInterceptor, childInterceptor],
+  })
+  const applySpy = vi.spyOn(childInterceptor, 'apply')
+  const listener = vi.fn()
+
+  interceptor.on('request', listener)
+  interceptor.apply()
+
+  expect(applySpy).toHaveBeenCalledOnce()
+  expect(childInterceptor.listenerCount('request')).toBe(1)
+
+  interceptor.dispose()
+})
+
+it('proxies event listeners to the interceptors', () => {
+  class PrimaryInterceptor extends Interceptor<{
+    hello: TypedEvent<string>
+  }> {
+    protected predicate(): boolean {
+      return true
+    }
+    protected setup(): void {}
+  }
+
+  class SecondInterceptor extends Interceptor<{
+    goodbye: TypedEvent<string>
+  }> {
+    protected predicate(): boolean {
+      return true
+    }
+    protected setup(): void {}
+  }
+
+  const instances = {
+    primary: new PrimaryInterceptor(),
+    secondary: new SecondInterceptor(),
+  }
+
+  const interceptor = new BatchInterceptor({
+    name: 'batch-proxy',
+    interceptors: [instances.primary, instances.secondary],
+  })
+
+  const helloListener = vi.fn()
+  interceptor.on('hello', helloListener)
+
+  const goodbyeListener = vi.fn()
+  interceptor.on('goodbye', goodbyeListener)
+
+  // Emulate the child interceptor emitting events.
+  const helloEvent = new TypedEvent('hello', { data: 'John' })
+  instances.primary['emitter'].emit(helloEvent)
+
+  const goodbyeEvent = new TypedEvent('goodbye', { data: 'Kate' })
+  instances.secondary['emitter'].emit(goodbyeEvent)
+
+  // Must call the batch interceptor listener.
+  expect(helloListener).toHaveBeenCalledExactlyOnceWith(helloEvent)
+  expect(goodbyeListener).toHaveBeenCalledExactlyOnceWith(goodbyeEvent)
+})
+
+it('disposes of child interceptors', async () => {
+  class PrimaryInterceptor extends Interceptor<any> {
+    protected predicate(): boolean {
+      return true
+    }
+    protected setup(): void {}
+  }
+
+  class SecondInterceptor extends Interceptor<any> {
+    protected predicate(): boolean {
+      return true
+    }
+    protected setup(): void {}
+  }
+
+  const instances = {
+    primary: new PrimaryInterceptor(),
+    secondary: new SecondInterceptor(),
+  }
+
+  const interceptor = new BatchInterceptor({
+    name: 'batch-dispose',
+    interceptors: [instances.primary, instances.secondary],
+  })
+
+  const primaryDisposeSpy = vi.spyOn(instances.primary, 'dispose')
+  const secondaryDisposeSpy = vi.spyOn(instances.secondary, 'dispose')
+
+  interceptor.apply()
+  interceptor.dispose()
+
+  expect(primaryDisposeSpy).toHaveBeenCalledTimes(1)
+  expect(secondaryDisposeSpy).toHaveBeenCalledTimes(1)
+})
+
+it('bridges events to listeners added via "on()"', () => {
+  class FirstInterceptor extends Interceptor<any> {
+    protected predicate(): boolean {
+      return true
+    }
+    protected setup(): void {}
+  }
+  class SecondInterceptor extends Interceptor<any> {
+    protected predicate(): boolean {
+      return true
+    }
+    protected setup(): void {}
+  }
+
+  const firstInterceptor = new FirstInterceptor()
+  const secondInterceptor = new SecondInterceptor()
+
+  const interceptor = new BatchInterceptor({
+    name: 'batch',
+    interceptors: [firstInterceptor, secondInterceptor],
+  })
+
+  const listener = vi.fn()
+  interceptor.on('foo', listener)
+
+  expect(firstInterceptor['emitter'].listenerCount('foo')).toBe(1)
+  expect(secondInterceptor['emitter'].listenerCount('foo')).toBe(1)
+  expect(interceptor['emitter'].listenerCount('foo')).toBe(1)
+})
+
+it('forwards listeners removal via "removeListener()"', () => {
+  type Events = {
+    foo: TypedEvent
+  }
+
+  class FirstInterceptor extends Interceptor<Events> {
+    protected predicate(): boolean {
+      return true
+    }
+    protected setup(): void {}
+  }
+  class SecondInterceptor extends Interceptor<Events> {
+    protected predicate(): boolean {
+      return true
+    }
+    protected setup(): void {}
+  }
+
+  const firstInterceptor = new FirstInterceptor()
+  const secondInterceptor = new SecondInterceptor()
+
+  const interceptor = new BatchInterceptor({
+    name: 'batch',
+    interceptors: [firstInterceptor, secondInterceptor],
+  })
+
+  const listener = vi.fn()
+  interceptor.on('foo', listener)
+  interceptor.removeListener('foo', listener)
+
+  expect(firstInterceptor['emitter'].listenerCount('foo')).toBe(0)
+  expect(secondInterceptor['emitter'].listenerCount('foo')).toBe(0)
+})
+
+it('forwards removal of all listeners by name via ".removeAllListeners()"', () => {
+  type Events = {
+    foo: TypedEvent
+    bar: TypedEvent
+  }
+
+  class FirstInterceptor extends Interceptor<Events> {
+    protected predicate(): boolean {
+      return true
+    }
+    protected setup(): void {}
+  }
+  class SecondInterceptor extends Interceptor<Events> {
+    protected predicate(): boolean {
+      return true
+    }
+    protected setup(): void {}
+  }
+
+  const firstInterceptor = new FirstInterceptor()
+  const secondInterceptor = new SecondInterceptor()
+
+  const interceptor = new BatchInterceptor({
+    name: 'batch',
+    interceptors: [firstInterceptor, secondInterceptor],
+  })
+
+  const listener = vi.fn()
+  interceptor.on('foo', listener)
+  interceptor.on('foo', listener)
+  interceptor.on('bar', listener)
+
+  expect(firstInterceptor['emitter'].listenerCount('foo')).toBe(1)
+  expect(firstInterceptor['emitter'].listenerCount('bar')).toBe(1)
+
+  expect(secondInterceptor['emitter'].listenerCount('foo')).toBe(1)
+  expect(secondInterceptor['emitter'].listenerCount('bar')).toBe(1)
+  expect(interceptor.listenerCount('foo')).toBe(2)
+  expect(interceptor.listenerCount('bar')).toBe(1)
+
+  interceptor.removeAllListeners('foo')
+
+  expect(firstInterceptor['emitter'].listenerCount('foo')).toBe(0)
+  expect(firstInterceptor['emitter'].listenerCount('bar')).toBe(1)
+  expect(secondInterceptor['emitter'].listenerCount('foo')).toBe(0)
+  expect(secondInterceptor['emitter'].listenerCount('bar')).toBe(1)
+  expect(interceptor.listenerCount('foo')).toBe(0)
+  expect(interceptor.listenerCount('bar')).toBe(1)
+})
+
+it('forwards removal of all listeners via ".removeAllListeners()"', () => {
+  class FirstInterceptor extends Interceptor<any> {
+    protected predicate(): boolean {
+      return true
+    }
+    protected setup(): void {}
+  }
+  class SecondInterceptor extends Interceptor<any> {
+    protected predicate(): boolean {
+      return true
+    }
+    protected setup(): void {}
+  }
+
+  const firstInterceptor = new FirstInterceptor()
+  const secondInterceptor = new SecondInterceptor()
+
+  const interceptor = new BatchInterceptor({
+    name: 'batch',
+    interceptors: [firstInterceptor, secondInterceptor],
+  })
+
+  const listener = vi.fn()
+  interceptor.on('foo', listener)
+  interceptor.on('foo', listener)
+  interceptor.on('bar', listener)
+
+  expect(firstInterceptor['emitter'].listenerCount('foo')).toBe(1)
+  expect(firstInterceptor['emitter'].listenerCount('bar')).toBe(1)
+  expect(secondInterceptor['emitter'].listenerCount('foo')).toBe(1)
+  expect(secondInterceptor['emitter'].listenerCount('bar')).toBe(1)
+  expect(interceptor.listenerCount()).toBe(3)
+
+  interceptor.removeAllListeners()
+
+  expect(firstInterceptor['emitter'].listenerCount('foo')).toBe(0)
+  expect(secondInterceptor['emitter'].listenerCount('foo')).toBe(0)
+  expect(firstInterceptor['emitter'].listenerCount('bar')).toBe(0)
+  expect(secondInterceptor['emitter'].listenerCount('bar')).toBe(0)
+  expect(interceptor.listenerCount()).toBe(0)
+})
+
+it('handles the same event instance only once', () => {
+  type Events = {
+    request: TypedEvent<string>
+  }
+
+  class RequestInterceptor extends Interceptor<Events> {
+    protected predicate(): boolean {
+      return true
+    }
+
+    protected setup(): void {}
+  }
+
+  const firstInterceptor = new RequestInterceptor()
+  const secondInterceptor = new RequestInterceptor()
+  const interceptor = new BatchInterceptor({
+    name: 'batch',
+    interceptors: [firstInterceptor, secondInterceptor],
+  })
+  const listener = vi.fn()
+  const requestEvent = new TypedEvent('request', { data: 'first' })
+
+  interceptor.on('request', listener)
+  firstInterceptor['emitter'].emit(requestEvent)
+  secondInterceptor['emitter'].emit(requestEvent)
+
+  expect(listener).toHaveBeenCalledExactlyOnceWith(requestEvent)
+
+  const nextRequestEvent = new TypedEvent('request', { data: 'second' })
+  secondInterceptor['emitter'].emit(nextRequestEvent)
+
+  expect(listener).toHaveBeenCalledTimes(2)
+  expect(listener).toHaveBeenLastCalledWith(nextRequestEvent)
+})
+
+it('applies "once" across all child interceptors', () => {
+  type Events = {
+    request: TypedEvent<string>
+  }
+
+  class RequestInterceptor extends Interceptor<Events> {
+    protected predicate(): boolean {
+      return true
+    }
+
+    protected setup(): void {}
+  }
+
+  const firstInterceptor = new RequestInterceptor()
+  const secondInterceptor = new RequestInterceptor()
+  const interceptor = new BatchInterceptor({
+    name: 'batch',
+    interceptors: [firstInterceptor, secondInterceptor],
+  })
+  const listener = vi.fn()
+
+  interceptor.once('request', listener)
+  firstInterceptor['emitter'].emit(new TypedEvent('request', { data: 'first' }))
+  secondInterceptor['emitter'].emit(
+    new TypedEvent('request', { data: 'second' })
+  )
+
+  expect(listener).toHaveBeenCalledOnce()
+  expect(firstInterceptor.listenerCount('request')).toBe(0)
+  expect(secondInterceptor.listenerCount('request')).toBe(0)
+})
+
+it('keeps shared child interceptors active until all batches dispose', () => {
+  type Events = {
+    message: TypedEvent<string>
+  }
+
+  const setup = vi.fn()
+  const teardown = vi.fn()
+
+  class SharedInterceptor extends Interceptor<Events> {
+    protected predicate(): boolean {
+      return true
+    }
+
+    protected setup(): void {
+      setup()
+      this.subscriptions.push(teardown)
+    }
+  }
+
+  const sharedInterceptor = new SharedInterceptor()
+  const primaryBatch = new BatchInterceptor({
+    name: 'primary-batch',
+    interceptors: [sharedInterceptor],
+  })
+  const secondaryBatch = new BatchInterceptor({
+    name: 'secondary-batch',
+    interceptors: [sharedInterceptor],
+  })
+  const primaryListener = vi.fn()
+  const secondaryListener = vi.fn()
+
+  primaryBatch.apply()
+  secondaryBatch.apply()
+  primaryBatch.on('message', primaryListener)
+  secondaryBatch.on('message', secondaryListener)
+
+  expect(setup).toHaveBeenCalledOnce()
+
+  sharedInterceptor['emitter'].emit(
+    new TypedEvent('message', { data: 'first' })
+  )
+
+  expect(primaryListener).toHaveBeenCalledTimes(1)
+  expect(secondaryListener).toHaveBeenCalledTimes(1)
+
+  primaryBatch.dispose()
+
+  expect(sharedInterceptor.readyState).toBe(InterceptorReadyState.ACTIVE)
+  expect(teardown).not.toHaveBeenCalled()
+
+  sharedInterceptor['emitter'].emit(
+    new TypedEvent('message', { data: 'second' })
+  )
+
+  expect(primaryListener).toHaveBeenCalledTimes(1)
+  expect(secondaryListener).toHaveBeenCalledTimes(2)
+
+  secondaryBatch.dispose()
+
+  expect(sharedInterceptor.readyState).toBe(InterceptorReadyState.DISPOSED)
+  expect(teardown).toHaveBeenCalledOnce()
+})
+
+it('removes only listeners owned by the batch', () => {
+  type Events = {
+    message: TypedEvent<string>
+  }
+
+  class SharedInterceptor extends Interceptor<Events> {
+    protected predicate(): boolean {
+      return true
+    }
+
+    protected setup(): void {}
+  }
+
+  const sharedInterceptor = new SharedInterceptor()
+  const primaryBatch = new BatchInterceptor({
+    name: 'primary-batch',
+    interceptors: [sharedInterceptor],
+  })
+  const secondaryBatch = new BatchInterceptor({
+    name: 'secondary-batch',
+    interceptors: [sharedInterceptor],
+  })
+  const primaryListener = vi.fn()
+  const secondaryListener = vi.fn()
+
+  primaryBatch.on('message', primaryListener)
+  secondaryBatch.on('message', secondaryListener)
+
+  primaryBatch.removeAllListeners()
+
+  sharedInterceptor['emitter'].emit(
+    new TypedEvent('message', { data: 'hello' })
+  )
+
+  expect(primaryListener).not.toHaveBeenCalled()
+  expect(secondaryListener).toHaveBeenCalledOnce()
+})

package/src/batch-interceptor.ts

@@ -0,0 +1,244 @@
+import {
+  type DefaultEventMap,
+  Emitter,
+  type TypedEvent,
+  type WithReservedEvents,
+} from 'rettime'
+import { Interceptor } from './interceptor'
+import { type DisposableSubscription } from './disposable'
+
+type GenericEventListener = Emitter.Listener<
+  Emitter<DefaultEventMap>,
+  string
+>
+
+function addEventBridge(
+  interceptor: Interceptor<DefaultEventMap>,
+  type: string,
+  listener: GenericEventListener
+): void {
+  interceptor.on(type, listener)
+}
+
+function removeEventBridge(
+  interceptor: Interceptor<DefaultEventMap>,
+  type: string,
+  listener: GenericEventListener
+): void {
+  interceptor.removeListener(type, listener)
+}
+
+export interface BatchInterceptorOptions<
+  InterceptorList extends ReadonlyArray<Interceptor<DefaultEventMap>>,
+> {
+  name: string
+  interceptors: InterceptorList
+}
+
+type UnionToIntersection<Union> = (
+  Union extends unknown ? (argument: Union) => void : never
+) extends (argument: infer Intersection) => void
+  ? Intersection
+  : never
+
+/**
+ * @note Merge the event maps of all the given interceptors into
+ * an intersection. A naive conditional type distributes over the
+ * interceptor union, producing a union of event maps whose `keyof`
+ * is `never` (no common keys), which would make `.on()` unusable.
+ */
+export type ExtractEventMapType<
+  InterceptorList extends ReadonlyArray<Interceptor<DefaultEventMap>>,
+> =
+  InterceptorList extends ReadonlyArray<infer InterceptorType>
+    ? UnionToIntersection<
+        InterceptorType extends Interceptor<infer EventMap> ? EventMap : never
+      >
+    : never
+
+/**
+ * A batch interceptor that exposes a single interface
+ * to apply and operate with multiple interceptors at once.
+ */
+export class BatchInterceptor<
+  InterceptorList extends ReadonlyArray<Interceptor<DefaultEventMap>>,
+  Events extends DefaultEventMap = ExtractEventMapType<InterceptorList>,
+> extends Interceptor<Events> {
+  #interceptors: InterceptorList
+  #eventBridges: Map<string, DisposableSubscription>
+  #forwardedEvents: Map<string, WeakSet<object>>
+
+  constructor(options: BatchInterceptorOptions<InterceptorList>) {
+    super()
+
+    this.#interceptors = options.interceptors
+    this.#eventBridges = new Map()
+    this.#forwardedEvents = new Map()
+
+    this.emitter.hooks.on(
+      'newListener',
+      (type) => {
+        this.#ensureEventBridge(type)
+      },
+      {
+        persist: true,
+      }
+    )
+
+    this.emitter.hooks.on(
+      'removeListener',
+      (type) => {
+        if (this.emitter.listenerCount(type) === 0) {
+          this.#removeEventBridge(type)
+        }
+      },
+      {
+        persist: true,
+      }
+    )
+  }
+
+  protected predicate(): boolean {
+    for (const interceptor of this.#interceptors) {
+      if (interceptor['predicate']()) {
+        /**
+         * @note If at least one of the provided interceptors suits the environment,
+         * treat this batch interceptor as matching. Since all the interceptors abide
+         * by the same event map, it will handle the events from any that match.
+         */
+        return true
+      }
+    }
+
+    return false
+  }
+
+  protected setup(): void {
+    const interceptors = new Set(this.#interceptors)
+
+    this.#forwardedEvents = new Map()
+
+    this.logger.verbose(
+      'applying batch %s with %d interceptors',
+      this.constructor.name,
+      interceptors.size
+    )
+
+    this.subscriptions.push(() => {
+      this.#removeAllEventBridges()
+    })
+
+    for (const interceptor of interceptors) {
+      this.logger.verbose(
+        'applying "%s" interceptor...',
+        interceptor.constructor.name
+      )
+      interceptor.apply(this)
+
+      this.logger.verbose('adding interceptor dispose subscription')
+      this.subscriptions.push(() => {
+        interceptor.dispose(this)
+      })
+    }
+  }
+
+  #ensureEventBridge(
+    type: keyof WithReservedEvents<Events> & string
+  ): void {
+    if (this.#eventBridges.has(type)) {
+      return
+    }
+
+    if (type === '*') {
+      this.#ensureWildcardEventBridge()
+      return
+    }
+
+    this.#ensureTypedEventBridge(type)
+  }
+
+  #ensureTypedEventBridge(type: keyof Events & string): void {
+    const interceptors = new Set(this.#interceptors)
+    const batchEmitter = this.emitter as Emitter<DefaultEventMap>
+    const forwardEvent: GenericEventListener = async (event) => {
+      if (this.#recordForwardedEvent(event)) {
+        this.logger.verbose('skipping duplicate "%s" event', event.type)
+        return
+      }
+
+      this.logger.verbose('forwarding "%s" event', event.type)
+      await batchEmitter.emitAsPromise(event)
+    }
+
+    for (const interceptor of interceptors) {
+      addEventBridge(interceptor, type, forwardEvent)
+    }
+
+    this.#eventBridges.set(type, () => {
+      for (const interceptor of interceptors) {
+        removeEventBridge(interceptor, type, forwardEvent)
+      }
+    })
+  }
+
+  #ensureWildcardEventBridge(): void {
+    const interceptors = new Set(this.#interceptors)
+    const batchEmitter = this.emitter as Emitter<DefaultEventMap>
+    const forwardEvent: GenericEventListener = (event: TypedEvent): void => {
+      if (this.#recordForwardedEvent(event)) {
+        this.logger.verbose('skipping duplicate "%s" event', event.type)
+        return
+      }
+
+      this.logger.verbose('forwarding wildcard "%s" event', event.type)
+      void batchEmitter.emitAsPromise(event)
+    }
+
+    for (const interceptor of interceptors) {
+      addEventBridge(interceptor, '*', forwardEvent)
+    }
+
+    this.#eventBridges.set('*', () => {
+      for (const interceptor of interceptors) {
+        removeEventBridge(interceptor, '*', forwardEvent)
+      }
+    })
+  }
+
+  #recordForwardedEvent(event: TypedEvent): boolean {
+    const forwardedEvents = this.#forwardedEvents.get(event.type)
+
+    if (forwardedEvents?.has(event)) {
+      return true
+    }
+
+    if (forwardedEvents) {
+      forwardedEvents.add(event)
+      return false
+    }
+
+    this.#forwardedEvents.set(event.type, new WeakSet([event]))
+    return false
+  }
+
+  #removeEventBridge(
+    type: keyof WithReservedEvents<Events> & string
+  ): void {
+    const disposeEventBridge = this.#eventBridges.get(type)
+
+    if (!disposeEventBridge) {
+      return
+    }
+
+    disposeEventBridge()
+    this.#eventBridges.delete(type)
+  }
+
+  #removeAllEventBridges(): void {
+    for (const disposeEventBridge of this.#eventBridges.values()) {
+      disposeEventBridge()
+    }
+
+    this.#eventBridges.clear()
+  }
+}