nestjs-http-promise
    TypeScript icon, indicating that this package has built-in type declarations

    1.2.1 • Public • Published

    nestjs-http-promise

    npm version

    description

    nestjs module that just doing little modification to the original and good nestjs http module.

    features

    • axios - the most used package for http requests in npm and the one used by nestjs official http library.
      • better axios stack trace - axios has an open issue about improvement of their stack trace. in this library there is a default interceptor that will intercept the stack trace and will add data to it.
    • promise based - most of us using the current http module that uses observable which we don't use most of the time and in order to avoid it were just calling .toPromise() every http call.
    • retries - in many cases we will want to retry a failing http call. with observable we could just add the retry operator (rxjs) but with promises we need to implement this logic ourselves. this package will make it easy for you, just pass { retries: NUMBER_OF_RETRIES } in the config of the http module. more details in the configuration section

    quick start

    installing

    Using npm:

    $ npm install nestjs-http-promise
    

    Using yarn:

    $ yarn add nestjs-http-promise
    

    usage - just like every nest.js module

    import the module:

    import { HttpModule } from 'nestjs-http-promise'
    
    @Module({ 
      imports: [HttpModule]
    })

    inject the service in the class:

    import { HttpService } from 'nestjs-http-promise'
    
    class Demo {
        constructor(private readonly httpService: HttpService) {}
    }

    use the service:

    public callSomeServer(): Promise<object> {
      return this.httpService.get('http://fakeService') 
    }

    configuration

    the service uses axios and axios-retry, so you can pass any AxiosRequestConfig And/Or AxiosRetryConfig

    just pass it in the .register() method as you would do in the original nestjs httpModule

    import { HttpModule } from 'nestjs-http-promise'
    
    @Module({
      imports: [HttpModule.register(
        {
          timeout: 1000,
          retries: 5,
            ...
        }
      )]
    })

    default configuration

    async configuration

    When you need to pass module options asynchronously instead of statically, use the registerAsync() method just like in nest httpModule.

    you have a couple of techniques to do it:

    • with the useFactory
    HttpModule.registerAsync({
        useFactory: () => ({
        timeout: 1000,
        retries: 5,
          ...
        }),
    });
    • using class
    HttpModule.registerAsync({
      useClass: HttpConfigService,
    });

    Note that in this example, the HttpConfigService has to implement HttpModuleOptionsFactory interface as shown below.

    @Injectable()
    class HttpConfigService implements HttpModuleOptionsFactory {
      async createHttpOptions(): Promise<HttpModuleOptions> {
        const configurationData = await someAsyncMethod();
        return {
          timeout: configurationData.timeout,
          retries: 5,
            ...
        };
      }
    }

    If you want to reuse an existing options provider instead of creating a copy inside the HttpModule, use the useExisting syntax.

    HttpModule.registerAsync({
      imports: [ConfigModule],
      useExisting: ConfigService,
    });

    Install

    npm i nestjs-http-promise

    DownloadsWeekly Downloads

    243

    Version

    1.2.1

    License

    MIT

    Unpacked Size

    27 kB

    Total Files

    28

    Last publish

    Collaborators

    • benhas1