npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

payamsms-sdk

v2.5.5

Published

PayamSMS SMS System Provider Development Kit

Downloads

4

Readme

PayamSMS JavaScript SDK

PayamSMS is a SMS provider.

How to use this package

So, let's have a quick review of our steps.

Installation

To install PayamSMS SDK use npm command like below:

$ npm i payamsms-sdk

Configuration

Now you installed package. You need to initial it. Just require it and use PayamSMS class with 4 params.

  • username
  • password
  • organization
  • line
// Import SDK
const PayamSMS = require("payamsms-sdk");

// Initial it with your env
const sms = new PayamSMS(
    env.PAYAM_ORGANIZATION,
    env.PAYAM_USERNAME,
    env.PAYAM_PASSWORD,
    env.PAYAM_LINE
);

Methods

This SDK has 2 main methods for sending and receiving messages. One other is getting balance that

  • send
  • receive

Send

Now you want to send a message, or many messages. Ok, have fun with this method!

// Descibe messages
const messages = [
    {
        recipient: "98912xxxxxxx",
        body: "لورم ایپسوم متن ساختگی با تولید سادگی نامفهوم از صنعت چاپ",
    },
];

// Send message
const send = sms.send(messages);

Now add then and get the results.

send.then((result) => {
    console.log(result);
});

Then it returns an array contains objects like below:

  • 200 | OK
[
    {
        "code": 200,
        "message": "Message sent",
        "serverId": 10565602949
    }
]
  • 500 | Not OK
[
    {
        "code": 500,
        "message": "Error details will be describe here."
    }
]

So, you can do anything you want.

Receive

It will be completed soon . . .

balance

With balance you can get how much money your account has. Ok, just follow instructions:

const balance = sms.getBalance(messages);

balance.then((result) => {
    console.log(result.balance);
});

What result contains, is like below:

{
    "balance": "2020153"
}

Development

If you want to develop the package, it is so simple. just follow steps below.

  • Clone the project
  • Install dependencies by running $ npm install
  • Add your values in .env file
  • Start changing!
    • Link package
    • Test

Before you start: **Remember the base or code are stored in lib/payamsms.js. You need to edit there.

Cloning the project

To clone the project, you need to have git installed. Ok, now clone it same as command below.

$ git clone https://gitlab.com/BlackIQ/payamsms-sdk

installing dependencies

Next, install what package uses with npm i or npm install.

$ npm i

Add your values in .env file

Go to test directory and make a copy of .env file.

$ cp .env.example .env

Now .env is created with keys and just add your values.

Changing

To change package or anything, your need a testing environment to use linked package. Just follow steps.

Link package

We asoume you are in lib directory. Right. You can open a tmux or in another terminal to cd in test directory.

In lib directory enter link command:

$ npm link

So, in other terminal, or other tmux part, link your development package to your test directory. If you are in the test directory ok, if not, just say cd test and enter the linking command:

$ npm link payamsms-sdk

Linking step is done.

Test

Your test app is linked. Change anything in package and test it in test directory.