README.md

Nestjs Soap

Nestjs module wrapper for soap

This package internally uses soap npm package

Install

npm install nestjs-soap

Or, if you use yarn

yarn add nestjs-soap

How to use

After installing the package, just import the SoapModule on the module you want to use the soap client.

import { Module } from '@nestjs/common';
import { SoapModule } from 'nestjs-soap';

@Module({
  imports: [
    SoapModule.registerAsync([
      { name: 'MY_SOAP_CLIENT', uri: 'http://yourserver/yourservice.wso?wsdl' },
    ]),
  ],
})
export class ExampleModule {}

The registerAsync function receives an array of SoapModuleOptions. This means you can create as many clients you need. You just need to create unique names for each one.

Then inject the client where you want to use it.

import { Inject, Injectable } from '@nestjs/common';
import { Client } from 'nestjs-soap';

@Injectable()
export class ExampleService {
  constructor(@Inject('MY_SOAP_CLIENT') private readonly mySoapClient: Client) {}

  async exampleFunction() {
    return await this.mySoapClient.YourFunctionAsync();
  }
}

The injected Client is from the soap npm package. From here, please follow the use instructions on the soap repository.

SoapModuleOptions

name: The unique client name for class injection

uri: The SOAP service uri.