@seagull/http

Http commands for the seagull framework

Usage no npm install needed!

<script type="module">
  import seagullHttp from 'https://cdn.skypack.dev/@seagull/http';
</script>

README

http (injectable)

Injectable library for http requests using http-fetch.

  • Implements seagull environment mode (cloud, connected, edge, pure)
  • Implements seed data generation for test cases

Usage

The basic fetch command can be used like this:

import { Http } from '@seagull/http'
...
class ... {
  // inject http implementation
  constructor(private http: Http) {}
  doSomething() {
    const response = await this.http.get(url)
    const json = await response.json()
  }
}

For convinience, you can use content-specific adapters as well:

import { HttpJson } from '@seagull/http'
...
class ... {
  // inject http implementation
  constructor(private http: HttpJson) {}
  doSomething() {
    try {
      const json = this.http.get(url)
    } catch (err) {
      ...
    }

  }
}

Bootstrap

import { containerModule } from '@seagull/http'
import { Container } from 'inversify'

const injector = new Container()
injector.load(containerModule)

Mode behavior

  • cloud : returns response of the external resource (as defined via url/config)
  • connected : same as cloud
  • edge : same as cloud
  • pure : returns local seed data (throws an error if no seed data is available)

Seed data generation

Use global switch to enable seed data generation while http request:

import { config } from '@seagull/http'

config.seed = true
...
// do your thing
...
config.seed = false

The seed data can be fetched in any mode except pure, as tests within the code pipeline should not call external ressources.

Configuration hooks

In case you want to modify the seed creation for a specific case, you can create a specific SeedLocalConfig by creating a TypeScript-file within the seed folder structure:

import { SeedLocalConfig } from '@seagull/commands-http/seedLocalConfig'

export default <SeedLocalConfig<SomeResponse>>{
  hook: (fixture: SomeResponse) => {
    // do something, e.g. slice some arrays within the fixture
    return fixture
  },
  expiresInDays: 14, // fixture will be re-fetched after 14 days
}

A configuration file is applied for all subsequent fixtures.