create Official EmailJS SDK for Node.js

Author: Sergey Khomushin

.eslintrc.js

@@ -0,0 +1,40 @@
+module.exports = {
+  env: {
+    jest: true,
+    node: true,
+    es2021: true,
+    browser: false,
+  },
+  plugins: ['@typescript-eslint', 'import'],
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/eslint-recommended',
+    'plugin:@typescript-eslint/recommended',
+    'plugin:@typescript-eslint/recommended-requiring-type-checking',
+    'plugin:import/errors',
+    'plugin:import/warnings',
+  ],
+  settings: {
+    'import/resolver': {
+      node: {
+        paths: ['src'],
+        extensions: ['.js', '.ts'],
+      },
+      typescript: {
+        paths: ['src'],
+        extensions: ['.js', '.ts'],
+      },
+    },
+  },
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    ecmaVersion: 'latest',
+    sourceType: 'module',
+    project: './tsconfig.json',
+  },
+  ignorePatterns: ['.eslintrc.js', 'jest.config.ts', '*.spec.ts'],
+  rules: {
+    // sometimes we are sure it is not null
+    '@typescript-eslint/no-non-null-assertion': 'off',
+  },
+};

.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+# This is a basic workflow to help you get started with Actions
+
+name: CI
+
+# Controls when the workflow will run
+on:
+  # Triggers the workflow on push or pull request events but only for the master branch
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# A workflow run is made up of one or more jobs that can run sequentially or in parallel
+jobs:
+  # This workflow contains a single job called "build"
+  build:
+    # The type of runner that the job will run on
+    runs-on: ubuntu-latest
+
+    # Steps represent a sequence of tasks that will be executed as part of the job
+    steps:
+      # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
+      - uses: actions/checkout@main
+
+      - name: Install modules
+        run: npm ci
+
+      - name: Run tests
+        run: npm run test
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v3

.gitignore

@@ -0,0 +1,13 @@
+# Specifies files to intentionally ignore when using Git
+# http://git-scm.com/docs/gitignore
+
+node_modules/
+coverage/
+.idea/
+*.swp
+.DS_Store
+Thumbs.db
+
+# dist files
+cjs/
+mjs/

.npmignore

@@ -0,0 +1,22 @@
+# Specifies files to intentionally ignore when using Git
+# http://git-scm.com/docs/gitignore
+
+# git ignore
+.github/
+node_modules/
+coverage/
+.idea/
+*.swp
+.DS_Store
+Thumbs.db
+
+# dev files
+.eslintrc.js
+.gitignore
+.npmignore
+jest.config.ts
+set-version.sh
+tsconfig.json
+
+# source code files
+src/

LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2021 EmailJS. https://www.emailjs.com
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the copyright holder nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

README.md

@@ -0,0 +1,114 @@
+# Official EmailJS SDK for Node.js
+
+SDK for [EmailJS.com](https://www.emailjs.com) customers.
+\
+Use you EmailJS account for sending emails.
+
+[![codecov](https://codecov.io/gh/emailjs-com/emailjs-nodejs/branch/main/graph/badge.svg)](https://codecov.io/gh/emailjs-com/emailjs-nodejs)
+[![npm version](https://img.shields.io/npm/v/@emailjs/nodejs.svg)](https://www.npmjs.com/package/@emailjs/nodejs)
+
+## Disclaimer
+
+This is a NodeJS-only version, otherwise use
+the [REST API](https://www.emailjs.com/docs/rest-api/send/).
+
+## Links
+
+[Official SDK Docs](https://www.emailjs.com/docs)
+
+## Intro
+
+EmailJS helps to send emails directly from your code.
+No large knowledge is required – just connect EmailJS to one of the supported
+email services, create an email template, and use our SDK
+to trigger an email.
+
+## Usage
+
+Install EmailJS SDK using [npm](https://www.npmjs.com/):
+
+```bash
+$ npm install @emailjs/nodejs
+```
+
+## Examples
+
+### ECMAScript modules
+
+**send email**
+
+```js
+import emailjs from '@emailjs/nodejs';
+
+const templateParams = {
+  name: 'James',
+  notes: 'Check this out!',
+};
+
+emailjs.send('<YOUR_SERVICE_ID>', '<YOUR_TEMPLATE_ID>', templateParams, '<YOUR_PUBLIC_KEY>').then(
+  (response) => {
+    console.log('SUCCESS!', response.status, response.text);
+  },
+  (err) => {
+    console.log('FAILED...', err);
+  },
+);
+```
+
+**init (optional)**
+
+```js
+import emailjs from '@emailjs/nodejs';
+
+// set Public Key as global settings
+emailjs.init('<YOUR_PUBLIC_KEY>');
+
+emailjs.send('<YOUR_SERVICE_ID>', '<YOUR_TEMPLATE_ID>').then(
+  (response) => {
+    console.log('SUCCESS!', response.status, response.text);
+  },
+  (err) => {
+    console.log('FAILED...', err);
+  },
+);
+```
+
+**await/async with EmailJS error handler**
+
+```js
+import { send, EmailJSResponseStatus } from '@emailjs/nodejs';
+
+try {
+  await emailjs.send('<YOUR_SERVICE_ID>', '<YOUR_TEMPLATE_ID>', {}, '<YOUR_PUBLIC_KEY>');
+  console.log('SUCCESS!');
+} catch (err) {
+  if (err instanceof EmailJSResponseStatus) {
+    console.log('EMAILJS FAILED...', err);
+    return;
+  }
+
+  console.log('ERROR', err);
+}
+```
+
+### CommonJS modules
+
+**send email**
+
+```js
+const emailjs = require('@emailjs/nodejs');
+
+var templateParams = {
+  name: 'James',
+  notes: 'Check this out!',
+};
+
+emailjs.send('<YOUR_SERVICE_ID>', '<YOUR_TEMPLATE_ID>', templateParams).then(
+  function (response) {
+    console.log('SUCCESS!', response.status, response.text);
+  },
+  function (err) {
+    console.log('FAILED...', err);
+  },
+);
+```

jest.config.ts

@@ -0,0 +1,27 @@
+import type { Config } from '@jest/types';
+
+const config: Config.InitialOptions = {
+  collectCoverage: true,
+  coverageDirectory: 'coverage',
+  transform: {
+    '^.+\\.ts?$': ['ts-jest', {
+      useESM: true,
+      diagnostics: {
+        warnOnly: true,
+      },
+    }],
+  },
+  testRegex: '((\\.|/)(spec))\\.(ts?)$',
+  moduleFileExtensions: ['ts', 'js'],
+  extensionsToTreatAsEsm: ['.ts'],
+  modulePaths: ['src'],
+  moduleNameMapper: {
+    '^(\\.{1,2}/.*)\\.js$': '$1',
+    '^#app/(.*)\\.js$': '$1',
+  },
+  testPathIgnorePatterns: ['/node_modules/'],
+  testEnvironment: 'node',
+  preset: 'ts-jest',
+};
+
+module.exports = config;