Gverni-test-package NPM

SMS Segment Calculator

This repo contains a package for an SMS segments calculator. The package is released as a nodeJS package as well as a browser script. A browser demo for this package can be accessed here

Usage

nodeJS

The package can be installed using:

npm install --save sms-segments-calculator

Sample usage:

const { SegmentedMessage } = require('sms-segments-calculator');

const segmentedMessage = new SegmentedMessage('Hello World');

console.log(segmentedMessage.encodingName); // "GSM-7"
console.log(segmentedMessage.segmentsCount); // "1"

Browser

You can add the library to your page using the CDN file:

<script src="https://cdn.jsdelivr.net/gh/TwilioDevEd/message-segment-calculator/docs/scripts/segmentsCalculator.js" integrity="sha256-wXuHVlXNhEWNzRKozzB87Qyi9/3p6LKskjDXFHIMInw=" crossorigin="anonymous"></script>

Alternatively you can add the library to your page using the file segmentsCalculator.js provided in docs/scripts/ and adding it to your page:

<script type="text/javascript" src="scripts/segmentsCalculator.js"></script>

And example of usage can be find in docs/index.html

Documentation

`SegmentedMessage` class

This is the main class exposed by the package

`constructor(message, encoding)`

Arguments:

message: Body of the SMS
encoding: Optional: encoding. It can be GSM-7, UCS-2, auto. Default value: auto

`encodingName`

Returns the name of the calculated encoding for the message: GSM-7 or UCS-2

`totalSize`

Total size of the message in bits (including User Data Header if present)

`messageSize`

Total size of the message in bits (excluding User Data Header if present)

`segmentsCount`

Number of segment(s)

Try the library

If you want to test the library you can use the script provided in playground/index.js. Install the dependencies (npm install) and then run:

$ node playground/index.js "👋 Hello World 🌍"

Contributing

This code is open source and welcomes contributions. All contributions are subject to our Code of Conduct.

The source code for the library is all contained in the src folder. Before submitting a PR:

Run linter using npm run lint command and make sure there are no linter error
Compile the code using npm run build command and make sure there are no errors
Execute the test using npm test and make sure all tests pass
Transpile the code using npm run webpack and test the web page in docs/index.html