telnyx 1.27.0 → 2.0.0-alpha.0

package/CHANGELOG.md

@@ -1,23 +1,66 @@
 # CHANGELOG
 
-##
+## v2
+
+### v2.0.0-alpha.0
+
+- Add Typescript default config, linter and dependencies
+- Bump default Node version to `20`
+- Update README on [Development](./README.md#development) instructions
+- Remove `yarn` in favor of `npm` 10
+- Convert SDK files to Typescript
+- Convert Resources to Typescript
+- Use ES Modules syntax
+- Update package `main` entrypoint to be compiled version of [src telnyx.ts](./src/telnyx.ts)
+- Added `Jest` and create tests in Typescript
+- Update tests expect matchers according to limitations with `prism mock`
+- Add `nock` cleanup setup
+- Make `setApiKey` TelnyxObject prototype method private
+- Moved to `moduleResolution` Bundler to support better imports and tests with `Jest`
+- Enabled `esModuleInterop` for Jest
+- Update files included when publishing
+- Remove custom resource get `generateAccessTokenFromCredential` from `TelephonyCredentials`
+- Update `AutoRechargePreferences` resource
+- Remove `RegisterCall` resource
+- Remove `ProgrammableFaxCommants` specs
+- Remove `BulkCreation` resource
+- Update `TexmlApplications` resource
+- Remove `Conferences` `dial_participant` action
+- Remove `SimCards` `deletePublicIp` and `setPublicIp`
+- Update `Queues` method names to camelCase
+- Remove `VerifiedCallsDisplayProfile` resource
+- Update examples to Typescript
+- Remove duplicated `AccessTokens` resource
+- Move custom `AdvancedOptinoptout` resource to be `AutoRespConfigs` resource
+- Remove `Billing` resource
+- Remove inexistent `Bucket` resource
+- Move `BucketUsage` resource to `StorageBuckets`
+- Remove duplicated `BulkPhoneNumberCampaigns` resource
+- Remove duplicated `BulkPhoneNumberOperations` resource
+
+## v1
 
 ### v1.26.2
+
 - Fix Brand and Campaign redirects
 - Update security
 
 ### v1.26.1
+
 - Fix porting comments
 
 ### v1.26.0
+
 - Endpoint additions
 - Package upgrades
 - Preparation for typescript migration/support
 
 ### v1.25.5
+
 - Security Updates + API Additions
 
 ### v1.23.0 (2021-10-19)
+
 - **Addresses** added `validate`
 - **AuthenticationProvider** added `list`, `create`, `retrieve`, `update`, `del`
 - **DynamicEmergency** (for `endpoints` and `addresses`) added `list`, `retrieve`, `create`, `del`

package/LICENSE

@@ -1,6 +1,6 @@
 Copyright (C) 2011 Ask Bjørn Hansen
 Copyright (C) 2013 Stripe, Inc. (https://stripe.com)
-Copyright (C) 2019 Telnyx, Inc. (https://www.telnyx.com)
+Copyright (C) 2019 Telnyx, Inc. (https://telnyx.com)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -2,7 +2,7 @@
 
 [![Version](https://img.shields.io/npm/v/telnyx.svg)](https://www.npmjs.org/package/telnyx)
 [![Build Status](https://github.com/team-telnyx/telnyx-node/workflows/CI/badge.svg)](https://github.com/team-telnyx/telnyx-node/actions)
-[![Coverage Status](https://coveralls.io/repos/github/team-telnyx/telnyx-node/badge.svg?branch=master)](https://coveralls.io/github/team-telnyx/telnyx-node?branch=master)
+Coverage Status: Pending
 [![Downloads](https://img.shields.io/npm/dm/telnyx.svg)](https://www.npmjs.com/package/telnyx)
 [![Try on RunKit](https://badge.runkitcdn.com/telnyx.svg)](https://runkit.com/npm/telnyx)
 [![Join Slack](https://img.shields.io/badge/join-slack-infomational)](https://joinslack.telnyx.com/)
@@ -26,62 +26,41 @@ The package needs to be configured with your account's API key which is
 available in your the [Telnyx Mission Control Portal][api-keys]. Require it with the key's
 value:
 
-``` js
-const telnyx = require('telnyx')('KEY123456...');
+```typescript
+import Telnyx from 'telnyx';
+
+const telnyx = new Telnyx('KEY123456...');
 
 const messagingProfile = await telnyx.messagingProfiles.create({
-  name: 'Summer Campaign'
+  name: 'Summer Campaign',
 });
 ```
 
-Or with versions of Node.js prior to v7.9:
-
-``` js
-var telnyx = require('telnyx')('KEY123456...');
-
-telnyx.messagingProfiles.create(
-  { name: 'Summer Campaign' },
-  function(err, messagingProfile) {
-    err; // null if no error occurred
-    messagingProfile; // the created messaging profile object
-  }
-);
-```
-
-Or using ES modules, this looks more like:
-
-```js
-import Telnyx from 'telnyx';
-const telnyx = Telnyx('KEY...');
-//…
-```
-
 ### Using Promises
 
 Every method returns a chainable promise which can be used instead of a regular
 callback:
 
-```js
+```typescript
 // Create a new messaging profile and then send a message using that profile:
-telnyx.MessagingProfiles.create({
-  name: 'Summer Campaign'
-}).then((messagingProfile) => {
-  return telnyx.MessagingPhoneNumbers.update(
-    '+18005554000',
-    {
-      'messaging_profile_id': messagingProfile.data.id
-    }
-  );
-}).catch((err) => {
-  // Deal with an error
-});
+telnyx.,essagingProfiles.create({
+  name: 'Summer Campaign',
+})
+  .then((messagingProfile) => {
+    return telnyx.messagingPhoneNumbers.update('+18005554000', {
+      messaging_profile_id: messagingProfile.data.id,
+    });
+  })
+  .catch((err) => {
+    // Deal with an error
+  });
 ```
 
 ### Configuring Timeout
 
 Request timeout is configurable (the default is Node's default of 120 seconds):
 
-``` js
+```typescript
 telnyx.setTimeout(20000); // in ms (this is 20 seconds)
 ```
 
@@ -90,11 +69,12 @@ telnyx.setTimeout(20000); // in ms (this is 20 seconds)
 An [https-proxy-agent][https-proxy-agent] can be configured with
 `setHttpAgent`.
 
-To use telnyx behind a proxy you can pass  to sdk:
+To use telnyx behind a proxy you can pass to sdk:
+
+```typescript
+import ProxyAgent from 'https-proxy-agent';
 
-```js
 if (process.env.http_proxy) {
-  const ProxyAgent = require('https-proxy-agent');
   telnyx.setHttpAgent(new ProxyAgent(process.env.http_proxy));
 }
 ```
@@ -105,7 +85,7 @@ Automatic network retries can be enabled with `setMaxNetworkRetries`. This will
 retry requests `n` times with exponential backoff if they fail due to an
 intermittent network problem.
 
-```js
+```typescript
 // Retry a request once before giving up
 telnyx.setMaxNetworkRetries(1);
 ```
@@ -115,21 +95,23 @@ telnyx.setMaxNetworkRetries(1);
 Some information about the response which generated a resource is available
 with the `lastResponse` property:
 
-```js
-messagingProfile.lastResponse.requestId // see: https://telnyx.com/docs/api/node#request_ids
-messagingProfile.lastResponse.statusCode
+```typescript
+messagingProfile.lastResponse.requestId; // see: https://telnyx.com/docs/api/node#request_ids
+messagingProfile.lastResponse.statusCode;
 ```
 
 ### `request` and `response` events
 
-The Telnyx object emits `request` and `response` events.  You can use them like this:
+The Telnyx object emits `request` and `response` events. You can use them like this:
+
+```typescript
+import Telnyx from 'telnyx';
 
-```js
-const telnyx = require('telnyx')('KEY...');
+const telnyx = new Telnyx('KEY...');
 
 const onRequest = (request) => {
   // Do something.
-}
+};
 
 // Add the event handler function:
 telnyx.on('request', onRequest);
@@ -139,7 +121,8 @@ telnyx.off('request', onRequest);
 ```
 
 #### `request` object
-```js
+
+```typescript
 {
   method: 'POST',
   path: '/v2/messaging_profiles'
@@ -147,7 +130,8 @@ telnyx.off('request', onRequest);
 ```
 
 #### `response` object
-```js
+
+```typescript
 {
   method: 'POST',
   path: '/v2/messaging_profiles',
@@ -171,12 +155,12 @@ You can find an example of how to use this with [Express](https://expressjs.com/
 in the [`examples/webhook-signing`](examples/webhook-signing) folder, but here's
 what it looks like:
 
-```js
+```typescript
 const event = telnyx.webhooks.constructEvent(
   webhookRawBody,
   webhookTelnyxSignatureHeader,
   webhookTelnyxTimestampHeader,
-  publicKey
+  publicKey,
 );
 ```
 
@@ -186,7 +170,7 @@ TeXML sends webhooks as form-encoded payloads instead of JSON. To validate the s
 
 You can find an example of how to use this with [Express](https://expressjs.com/) in the [`examples/webhook-signing`](examples/webhook-signing) folder.
 
-```js
+```typescript
 const timeToleranceInSeconds = 300; // Will validate signatures of webhooks up to 5 minutes after Telnyx sent the request
 try {
   telnyx.webhooks.signature.verifySignature(
@@ -194,20 +178,19 @@ try {
     webhookTelnyxSignatureHeader,
     webhookTelnyxTimestampHeader,
     publicKey,
-    timeToleranceInSeconds
+    timeToleranceInSeconds,
   );
 } catch (e) {
-  console.log("Failed to validate the signature")
+  console.log('Failed to validate the signature');
   console.log(e);
 }
-
 ```
 
 ### Writing a Plugin
 
 If you're writing a plugin that uses the library, we'd appreciate it if you identified using `telnyx.setAppInfo()`:
 
-```js
+```typescript
 telnyx.setAppInfo({
   name: 'MyAwesomePlugin',
   version: '1.2.34', // Optional
@@ -222,14 +205,13 @@ This information is passed along when the library makes calls to the Telnyx API.
 You can auto-paginate list methods. We provide a few different APIs for this to
 aid with a variety of node versions and styles.
 
-
 #### Async iterators (`for-await-of`)
 
 If you are in a Node environment that has support for [async iteration](https://github.com/tc39/proposal-async-iteration#the-async-iteration-statement-for-await-of),
 such as Node 10+ or [babel](https://babeljs.io/docs/en/babel-plugin-transform-async-generator-functions),
 the following will auto-paginate:
 
-```js
+```typescript
 for await (const messagingProfile of telnyx.messagingProfiles.list()) {
   doSomething(messagingProfile);
   if (shouldStop()) {
@@ -243,36 +225,42 @@ for await (const messagingProfile of telnyx.messagingProfiles.list()) {
 If you are in a Node environment that has support for `await`, such as Node 7.9 and greater,
 you may pass an async function to `.autoPagingEach`:
 
-```js
-await telnyx.messagingProfiles.list().autoPagingEach(async (messagingProfile) => {
-  await doSomething(messagingProfile);
-  if (shouldBreak()) {
-    return false;
-  }
-})
+```typescript
+await telnyx.messagingProfiles
+  .list()
+  .autoPagingEach(async (messagingProfile) => {
+    await doSomething(messagingProfile);
+    if (shouldBreak()) {
+      return false;
+    }
+  });
 console.log('Done iterating.');
 ```
 
 Equivalently, without `await`, you may return a Promise, which can resolve to `false` to break:
 
-```js
-telnyx.messagingProfiles.list().autoPagingEach((messagingProfile) => {
-  return doSomething(messagingProfile).then(() => {
-    if (shouldBreak()) {
-      return false;
-    }
-  });
-}).then(() => {
-  console.log('Done iterating.');
-}).catch(handleError);
+```typescript
+telnyx.messagingProfiles
+  .list()
+  .autoPagingEach((messagingProfile) => {
+    return doSomething(messagingProfile).then(() => {
+      if (shouldBreak()) {
+        return false;
+      }
+    });
+  })
+  .then(() => {
+    console.log('Done iterating.');
+  })
+  .catch(handleError);
 ```
 
 If you prefer callbacks to promises, you may also use a `next` callback and a second `onDone` callback:
 
-```js
+```typescript
 telnyx.messagingProfiles.list().autoPagingEach(
   function onItem(messagingProfile, next) {
-    doSomething(messagingProfile, function(err, result) {
+    doSomething(messagingProfile, function (err, result) {
       if (shouldStop(result)) {
         next(false); // Passing `false` breaks out of the loop.
       } else {
@@ -286,8 +274,8 @@ telnyx.messagingProfiles.list().autoPagingEach(
     } else {
       console.log('Done iterating.');
     }
-  }
-)
+  },
+);
 ```
 
 If your `onItem` function does not accept a `next` callback parameter _or_ return a Promise,
@@ -301,31 +289,41 @@ to prevent runaway list growth from consuming too much memory.
 
 Returns a promise of an array of all items across pages for a list request.
 
-```js
-const allMessagingProfiles = await telnyx.messagingProfiles.list()
+```typescript
+const allMessagingProfiles = await telnyx.messagingProfiles
+  .list()
   .autoPagingToArray({limit: 10000});
 ```
 
 ## Development
 
 ### Setup
-The test suite depends on the [Prism Mock Server](https://github.com/stoplightio/prism).
+
+Run the following to create your env file
 
 ```bash
-npm install -g @stoplight/prism-cli
+cp .env.local .env
+```
+
+> Don't forget to update your `.env` values accordingly.
 
-# OR
+Now inject envs into terminal:
 
-yarn global add @stoplight/prism-cli
+```bash
+. ./setup_env.sh
 ```
 
-Once installed, start the prism mock service with the following command:
+> Feel free to use Node `--env-file` parameter to [setup envs](https://nodejs.org/en/learn/command-line/how-to-read-environment-variables-from-nodejs) if you prefer
+
+The test suite depends on the [Prism Mock Server](https://github.com/stoplightio/prism).
+
+Start the prism mock service with the following command:
 
 ```bash
-prism mock https://raw.githubusercontent.com/team-telnyx/openapi/master/openapi/spec3.json
+npx prism mock https://raw.githubusercontent.com/team-telnyx/openapi/master/openapi/spec3.json
 ```
 
---------
+---
 
 One final step -- because the Node SDK originally expected to reach the legacy `telnyx-mock` service at port 12111 (in addition to providing a `/v2/` base path), we need to setup the [Telnyx mock proxy server](https://github.com/team-telnyx/telnyx-mock-server-proxy) to modify the request path and forward along to the prism mock server.
 
@@ -335,7 +333,7 @@ One final step -- because the Node SDK originally expected to reach the legacy `
 git clone git@github.com:team-telnyx/telnyx-prism-mock.git
 cd telnyx-prism-mock/proxy
 
-yarn install
+npm install
 node index.js
 ```
 
@@ -349,22 +347,22 @@ $ npm test
 Run all tests with a custom `telnyx-mock` port:
 
 ```bash
-$ TELNYX_MOCK_PORT=12000 npm test
+$ TELNYX_MOCK_PORT=12111 npm test
 ```
 
 Run a single test suite:
 
 ```bash
-$ npm run mocha -- test/Error.spec.js
+$ npm test -- test/Error.test.ts
 ```
 
 Run a single test (case sensitive):
 
 ```bash
-$ npm run mocha -- test/Error.spec.js --grep 'Populates with type'
+$ npm test -- test/Error.test.ts -t 'Populates with type'
 ```
 
-If you wish, you may run tests using your Telnyx *Test* API key by setting the
+If you wish, you may run tests using your Telnyx _Test_ API key by setting the
 environment variable `TELNYX_TEST_API_KEY` before running the tests:
 
 ```bash
@@ -377,10 +375,12 @@ $ npm test
 
 To inspect values in tests first import debug:
 
-```js
-var debug = require('debug')('foo');
+```typescript
+import Debug from 'debug';
+
+const debug = Debug('foo');
 //...
-debug(result)
+debug(result);
 ```
 
 Then run the tests with:
@@ -395,6 +395,24 @@ To view verbose debugging for `nock` run the tests with:
 $ DEBUG=nock.* npm test
 ```
 
+### Typescript
+
+Run:
+
+```bash
+npm run build
+```
+
+Then check output in [dist](./dist) folder
+
+### Linter (Prettier)
+
+Add an [editor integration](https://prettier.io/docs/en/editors.html) or:
+
+```bash
+$ npm run fix
+```
+
 ## Acknowledgements
 
 The contributors and maintainers of Telnyx Node would like to extend their deep gratitude to the

package/VERSION

@@ -1 +1 @@
-1.27.0
+2.0.0-alpha.0

package/dist/telnyx.node.js

@@ -0,0 +1,3 @@
+import { createTelnyx } from './telnyx';
+export const Telnyx = createTelnyx();
+export default Telnyx;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "telnyx",
-  "version": "1.27.0",
+  "version": "2.0.0-alpha.0",
   "description": "Telnyx API Node SDK",
   "keywords": [
     "telnyx",
@@ -11,57 +11,64 @@
     "sdk"
   ],
   "homepage": "https://developers.telnyx.com",
-  "author": "Telnyx <support@telnyx.com> (https://www.telnyx.com/)",
+  "author": "Telnyx <support@telnyx.com> (https://telnyx.com)",
   "contributors": [
-    "Vlad Ionash <vladi@telnyx.com> (http://www.telnyx.com/)",
-    "Gabriel Taylor Russ <gabriel@telnyx.com> (http://www.telnyx.com/)",
-    "Lucas Rosa <lucas@telnyx.com> (http://www.telnyx.com/)",
-    "Rômulo Garofalo <romulo@telnyx.com> (http://www.telnyx.com/)",
+    "Vlad Ionash <vladi@telnyx.com> (http://telnyx.com)",
+    "Gabriel Taylor Russ <gabriel@telnyx.com> (http://telnyx.com)",
+    "Lucas Rosa <lucas@telnyx.com> (http://telnyx.com)",
+    "Rômulo Garofalo <romulo@telnyx.com> (http://telnyx.com)",
     "Khalil Mohammad <khalilmohammadmirza@gmail.com> (https://khalilmohammadmirza.com)"
   ],
   "repository": {
     "type": "git",
     "url": "git://github.com/team-telnyx/telnyx-node.git"
   },
-  "bugs:": "https://github.com/team-telnyx/telnyx-node/issues",
+  "bugs": "https://github.com/team-telnyx/telnyx-node/issues",
   "engines": {
-    "node": "^6 || >=8"
+    "node": "^18 || >=20"
   },
-  "main": "lib/telnyx.js",
+  "main": "dist/telnyx.node.js",
+  "type": "module",
+  "types": "dist/types/index.d.ts",
   "devDependencies": {
-    "chai": "~4.4.1",
-    "chai-as-promised": "~7.1.1",
-    "coveralls": "^3.1.1",
+    "@eslint/js": "^9.10.0",
+    "@stoplight/prism-cli": "^5.10.0",
+    "@types/eslint__js": "^8.42.3",
+    "@types/jest": "^29.5.13",
+    "@types/node": "^22.7.3",
+    "@types/qs": "^6.9.15",
     "debug": "^4.3.4",
     "eslint": "^8.57.0",
+    "eslint-config-prettier": "^9.1.0",
     "eslint-plugin-chai-friendly": "^0.7.4",
-    "mocha": "^10.3.0",
+    "eslint-plugin-prettier": "^5.2.1",
+    "jest": "^29.7.0",
     "nock": "^13.5.4",
-    "nyc": "^15.1.0"
-  },
-  "dependencies": {
-    "lodash.isplainobject": "^4.0.6",
+    "nyc": "^15.1.0",
+    "plop": "^4.0.1",
+    "prettier": "^3.0.0",
     "qs": "^6.11.2",
-    "safe-buffer": "^5.2.1",
-    "telnyx": "^1.26.2",
+    "ts-jest": "^29.2.5",
+    "ts-node": "^10.9.2",
     "tweetnacl": "^1.0.3",
+    "typescript": "^5.6.2",
+    "typescript-eslint": "^8.8.0",
     "uuid": "^9.0.1"
   },
+  "overrides": {
+    "node-plop": {
+      "inquirer": "9.3.5"
+    }
+  },
   "license": "MIT",
   "scripts": {
-    "clean": "rm -rf ./.nyc_output ./node_modules/.cache ./coverage",
-    "mocha": "nyc mocha",
-    "test": "npm run lint && npm run mocha",
-    "lint": "eslint . --fix",
-    "report": "nyc -r text -r lcov report",
-    "coveralls": "cat coverage/lcov.info | ./node_modules/coveralls/bin/coveralls.js",
-    "release": "telnyx-npm-release"
-  },
-  "nyc": {
-    "exclude": [
-      "testUtils/**/*",
-      "test/**/*",
-      "lib/TelnyxMethod.basic.js"
-    ]
+    "prebuild": "rm -rf ./dist",
+    "build": "tsc && cp -r types dist/types",
+    "clean": "rm -rf ./.nyc_output ./node_modules/.cache ./coverage ./dist",
+    "prepack": "npm install && npm run build",
+    "test": "jest",
+    "generate": "plop",
+    "lint": "rm -rf ./dist && eslint .",
+    "fix": "npm run lint --fix"
   }
 }