New Research: Supply Chain Attack on Axios Pulls Malicious Dependency from npm.Details →

Book a Demo Sign in

westfax

Package Overview

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

westfax

Interact with the WestFax Secure Cloud Fax API to send and receive faxes.

latest

Source

npm

Version: 1.0.3

Version published: last year

Weekly downloads: 0

Maintainers: 0

Weekly downloads

Created: last year

Source

WestFax NPM

A Node.js client library for interacting with the WestFax Secure Cloud Fax API. WestFax is a HIPAA Compliant Secure Cloud Fax company that specializes in high volume, high availability digital cloud fax with a primary focus on Healthcare and medical applications.

Features

Send faxes to single or multiple recipients (up to 20 per fax)
Retrieve fax documents
Manage fax filter values
Get fax descriptions
Check for inbound faxes
Get product lists

Installation

npm install westfax

Important Notes

All API calls are production - There is no "test" or "mock" API environment, so every API call you make will use real credentials and will send actual faxes.
You need a WestFax account - To use this library, you must have a WestFax account with valid credentials.
ProductId is required - Most API calls require a ProductId, which you can retrieve programmatically (see below).

Getting Started

Step 1: Get Your WestFax Credentials

Step 2: Retrieve Your ProductId

Most WestFax API calls require a ProductId. Here's how to get it programmatically:

const WestFax = require('westfax');

// Initialize client with just username and password
const client = new WestFax({
  username: 'your_username',
  password: 'your_password'
});

// Get product list and find your ProductId
async function getProductId() {
  try {
    const productList = await client.getF2EProductList();
    
    if (productList.Success && productList.Result.length > 0) {
      // The first product ID in the list
      const productId = productList.Result[0].Id;
      console.log(`Your ProductId is: ${productId}`);
      return productId;
    } else {
      console.error('No products found or API call failed');
      return null;
    }
  } catch (error) {
    console.error('Error retrieving ProductId:', error.message);
    return null;
  }
}

// Call the function to get your ProductId
getProductId();

Alternatively, you can use cURL to get your ProductId:

curl --location --request POST 'https://apisecure.westfax.com/REST/Profile_GetProductList/json' \
  --form 'Username="your_username"' \
  --form 'Password="your_password"' \
  --form 'Cookies="false"'

The response will contain your ProductId in the Id field:

{
  "Success": true,
  "Result": [
    {
      "Id": "00000000-1111-2222-3333-4444444444",  // This is your ProductId
      "Name": "FF-Acme Corp",
      "ProductType": "FaxForward",
      ...
    }
  ]
}

Step 3: Initialize the Client with All Credentials

After obtaining your ProductId, initialize the client with all required credentials:

const WestFax = require('westfax');

const client = new WestFax({
  username: 'your_username',
  password: 'your_password',
  productId: 'your_product_id',
  baseUrl: 'https://apisecure.westfax.com', // Optional, defaults to this URL
  responseEncoding: 'JSON' // Optional, defaults to 'JSON'
});

Examples

The package includes several example scripts to help you get started:

examples/get-product-id.js - Demonstrates how to retrieve your ProductId programmatically
examples/send-fax.js - Shows how to send faxes to single and multiple recipients
examples/retrieve-fax.js - Demonstrates how to retrieve and process fax documents

To run the examples:

Copy examples/.env.example to examples/.env and add your credentials
Run an example with node examples/get-product-id.js

Usage

Sending a Fax

// Send a fax to a single recipient
const sendFaxResult = await client.sendFax({
  jobName: 'Test Fax',
  header: 'Test Header',
  billingCode: 'Customer Code 1234',
  numbers: '800-555-1212', // Single string for one recipient
  file: '/path/to/document.pdf',
  csid: '0000000000',
  ani: '0000000000',
  faxQuality: 'Fine',
  feedbackEmail: 'your@email.com'
});

// Send to multiple recipients (up to 20 max)
// The library will automatically format these as Numbers1, Numbers2, Numbers3, etc.
// as required by the WestFax API
const multipleNumbersResult = await client.sendFax({
  jobName: 'Multiple Recipients',
  header: 'Important Document',
  numbers: ['800-555-1212', '800-555-1213', '800-555-1214'], // Array of recipients (max 20)
  file: '/path/to/document.pdf'
});

// Send with a file buffer
const fs = require('fs');
const fileBuffer = fs.readFileSync('/path/to/document.pdf');
const bufferResult = await client.sendFax({
  jobName: 'Buffer Example',
  header: 'From Buffer',
  numbers: '800-555-1212',
  file: fileBuffer,
  filename: 'document.pdf' // Optional filename when using buffer
});

Retrieving Fax Documents

// Retrieve a single fax document
const faxId = {
  Id: '12345678-1234-1234-1234-123456789abc',
  Direction: 'Inbound'
};

const singleDocResult = await client.getFaxDocuments(faxId, 'pdf');

// Retrieve multiple fax documents
const faxIds = [
  { Id: '12345678-1234-1234-1234-123456789abc', Direction: 'Inbound' },
  { Id: '87654321-4321-4321-4321-cba987654321', Direction: 'Outbound' }
];

const multipleDocsResult = await client.getFaxDocuments(faxIds, 'pdf');

Changing Fax Filter Values

// Mark a fax as read
const faxId = {
  Id: '12345678-1234-1234-1234-123456789abc',
  Direction: 'Inbound'
};

const markAsReadResult = await client.changeFaxFilterValue(faxId, 'Retrieved');

// Delete a fax
const deleteResult = await client.changeFaxFilterValue(faxId, 'Removed');

// Reset filter (mark as unread)
const resetResult = await client.changeFaxFilterValue(faxId, 'None');

Getting Fax Descriptions

const faxId = {
  Id: '12345678-1234-1234-1234-123456789abc',
  Direction: 'Inbound'
};

const faxDescription = await client.getFaxDescriptionsUsingIds(faxId);

Getting Products with Inbound Faxes

// Get products with unread faxes
const unreadFaxProducts = await client.getProductsWithInboundFaxes('None');

// Get products with read faxes
const readFaxProducts = await client.getProductsWithInboundFaxes('Retrieved');

Getting Fax-to-Email Product List

const productList = await client.getF2EProductList();

Testing

The package includes comprehensive tests for all API methods.

Important Note: There is no "mock" API for WestFax - all API calls go to the production environment. When running tests, real credentials are required, and actual API calls will be made.

Running Tests with Your WestFax Credentials

To run tests with your WestFax credentials:

Create a .env file in the project root (or copy from .env.example)
Add your WestFax credentials:

WESTFAX_USERNAME=your_username
WESTFAX_PASSWORD=your_password
WESTFAX_PRODUCT_ID=your_product_id

Run the tests:

npm test

For integration tests that send real faxes, you can also set:

TEST_FAX_NUMBER=your_test_fax_number
TEST_FAX_FILE=path_to_test_file.pdf

Test Safety

Since all API calls are to the production environment, be careful when running tests:

All fax tests will send real faxes
All tests will use your actual account
Consider the cost implications of running tests that send faxes

If you prefer to avoid actually sending faxes during testing, you can modify the test cases to skip the actual sendFax tests.

Getting Help

If you need assistance or have questions about the WestFax API, please contact WestFax support directly.

API Reference

Constructor

`new WestFax(config)`

Creates a new WestFax client instance.

config (Object): Configuration options
- username (String): WestFax API username
- password (String): WestFax API password
- productId (String): Default product ID to use for operations
- baseUrl (String, optional): API base URL (default: 'https://apisecure.westfax.com')
- responseEncoding (String, optional): Response format (default: 'JSON')
- cookies (Boolean, optional): Whether to use cookies (default: false)

Methods

`getProductId()`

Helper method to retrieve the first available ProductId for your account. This is useful when setting up the client for the first time.

Returns: Promise resolving to the ProductId string or null if none found

`getProductList()`

Gets a list of all products the user has access to.

Returns: Promise resolving to API response object with a Result array containing product information

`getF2EProductList()`

Gets a list of fax-to-email products the user has access to.

Returns: Promise resolving to API response object with a Result array containing product information