@deepgram/sdk 2.1.0 → 2.2.0

package/README.md

@@ -2,109 +2,354 @@
 
 [![CI](https://github.com/deepgram/node-sdk/actions/workflows/CI.yml/badge.svg)](https://github.com/deepgram/node-sdk/actions/workflows/CI.yml) [![npm (scoped)](https://img.shields.io/npm/v/@deepgram/sdk)](https://www.npmjs.com/package/@deepgram/sdk) [![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg?style=flat-rounded)](CODE_OF_CONDUCT.md)
 
-Official Node.js SDK for [Deepgram](https://www.deepgram.com/)'s automated
-speech recognition APIs.
+Official Node.js SDK for [Deepgram](https://www.deepgram.com/). Start building with our powerful transcription & speech understanding API.
+
+> ### Deprecated JS Browser SDK
+>
+> As of version 2.x, the JS Browser SDK was removed from the Node SDK and will become an independent Client SDK.
+> To use the older SDK, please `npm i @deepgram/sdk@1.2.1` and use `@deepgram/sdk/browser`.
+
+- [Deepgram Node.js SDK](#deepgram-nodejs-sdk)
+- [Getting an API Key](#getting-an-api-key)
+- [Installation](#installation)
+- [Constructor](#constructor)
+- [Transcription](#transcription)
+  - [Remote Files](#remote-files)
+  - [Local Files](#local-files)
+  - [Live Audio](#live-audio)
+- [Projects](#projects)
+  - [Get Projects](#get-projects)
+  - [Get Project](#get-project)
+  - [Update Project](#update-project)
+  - [Delete Project](#delete-project)
+- [Keys](#keys)
+  - [List Keys](#list-keys)
+  - [Get Key](#get-key)
+  - [Create Key](#create-key)
+  - [Delete Key](#delete-key)
+- [Members](#members)
+  - [Get Members](#get-members)
+  - [Remove Member](#remove-member)
+- [Scopes](#scopes)
+  - [Get Member Scopes](#get-member-scopes)
+  - [Update Scope](#update-scope)
+- [Invitations](#invitations)
+  - [List Invites](#list-invites)
+  - [Send Invite](#send-invite)
+  - [Delete Invite](#delete-invite)
+  - [Leave Project](#leave-project)
+- [Usage](#usage)
+  - [Get All Requests](#get-all-requests)
+  - [Get Request](#get-request)
+  - [Summarize Usage](#summarize-usage)
+  - [Get Fields](#get-fields)
+- [Billing](#billing)
+  - [Get All Balances](#get-all-balances)
+  - [Get Balance](#get-balance)
+- [Development and Contributing](#development-and-contributing)
+- [Getting Help](#getting-help)
+
+# Getting an API Key
+
+🔑 To access the Deepgram API you will need a [free Deepgram API Key](https://console.deepgram.com/signup?jump=keys).
+
+# Installation
 
-> This SDK only supports hosted usage of api.deepgram.com.
+```bash
+npm install @deepgram/sdk
+# - or -
+# yarn add @deepgram/sdk
+```
 
-To access the API you will need a Deepgram account. Sign up for free at
-[signup][signup].
+# Constructor
 
-## Documentation
+```js
+const { Deepgram } = require("@deepgram/sdk");
+// - or -
+// import { Deepgram } from "@deepgram/sdk";
 
-Full documentation of the Node.js SDK can be found on the
-[Deepgram Developer Portal](https://developers.deepgram.com/sdks-tools/sdks/node-sdk/).
+const deepgram = new Deepgram(DEEPGRAM_API_KEY);
+```
 
-You can learn more about the full Deepgram API at [https://developers.deepgram.com](https://developers.deepgram.com).
+# Transcription
 
-## Installation
+## Remote Files
 
-### With NPM
+```js
+const response = await deepgram.transcription.preRecorded(
+  { url: URL_OF_FILE },
+  options
+);
+```
 
-```bash
-npm install @deepgram/sdk
+[See our API reference for more info](https://developers.deepgram.com/reference/pre-recorded).
+
+## Local Files
+
+```js
+const response = await deepgram.transcription.preRecorded(
+  {
+    stream: fs.createReadStream("/path/to/file"),
+    mimetype: MIMETYPE_OF_FILE,
+  },
+  options
+);
 ```
 
-### With Yarn
+[See our API reference for more info](https://developers.deepgram.com/reference/pre-recorded).
 
-```bash
-yarn add @deepgram/sdk
+## Live Audio
+
+```js
+const ws = dg.transcription.live(options);
+
+// source.addListener('got-some-audio', async (event) => {
+ws.send(event);
+// })
 ```
 
-## Constructor
+See an example, here: [https://github.com/deepgram-devs/node-live-example](https://github.com/deepgram-devs/node-live-example).
+
+[See our API reference for more info](https://developers.deepgram.com/reference/streaming).
+
+# Projects
+
+## Get Projects
+
+Returns all projects accessible by the API key.
 
 ```js
-const { Deepgram } = require("@deepgram/sdk");
+const result = await deepgram.projects.list();
+```
 
-const deepgram = new Deepgram(DEEPGRAM_API_KEY);
+[See our API reference for more info](https://developers.deepgram.com/reference/get-projects).
+
+## Get Project
+
+Retrieves a specific project based on the provided project_id.
+
+```js
+const result = await deepgram.projects.get(project_id);
 ```
 
-## Examples
+[See our API reference for more info](https://developers.deepgram.com/reference/get-project).
 
-### Transcribe an Existing File
+## Update Project
 
-#### Remote Files
+Update a project.
 
 ```js
-const fileSource = { url: URL_OF_FILE };
+const result = await deepgram.projects.update(project_id, options);
+```
 
-const response = await deepgram.transcription.preRecorded(fileSource, {
-  punctuate: true,
-});
+[See our API reference for more info](https://developers.deepgram.com/reference/update-project).
+
+## Delete Project
+
+Delete a project.
+
+```js
+await deepgram.projects.delete(project_id);
 ```
 
-#### Local Files
+[See our API reference for more info](https://developers.deepgram.com/reference/delete-project).
+
+# Keys
+
+## List Keys
+
+Retrieves all keys associated with the provided project_id.
 
 ```js
-const streamSource = {
-  stream: fs.createReadStream("/path/to/file"),
-  mimetype: MIMETYPE_OF_FILE,
-};
+const result = await deepgram.keys.list(project_id);
+```
+
+[See our API reference for more info](https://developers.deepgram.com/reference/list-keys).
 
-const response = await deepgram.transcription.preRecorded(streamSource, {
-  punctuate: true,
-});
+## Get Key
+
+Retrieves a specific key associated with the provided project_id.
+
+```js
+const result = await deepgram.keys.get(project_id, key_id);
 ```
 
-### Transcribe Audio in Real-Time
+[See our API reference for more info](https://developers.deepgram.com/reference/get-key).
 
-See an example real time project at https://github.com/deepgram-devs/node-live-example, or visit this [Getting Started guide](https://developers.deepgram.com/documentation/getting-started/streaming/)
+## Create Key
 
-## Samples
+Creates an API key with the provided scopes.
 
-To run the sample code, first run the following in your terminal:
+```js
+let scopes = ["member", "etc"];
+const result = await deepgram.keys.create(project_id, comment, scopes, options);
+```
 
-```bash
-npm install
-npm build
+[See our API reference for more info](https://developers.deepgram.com/reference/create-key).
+
+## Delete Key
+
+Deletes a specific key associated with the provided project_id.
+
+```js
+await deepgram.keys.delete(project_id, key_id);
 ```
 
-Then update the config object located at the top of the `index.js`
-file in the sample folder.
+[See our API reference for more info](https://developers.deepgram.com/reference/delete-key).
+
+# Members
+
+## Get Members
+
+Retrieves account objects for all of the accounts in the specified project_id.
 
 ```js
-const config = {
-  deepgramApiKey: "YOUR_DEEPGRAM_API_KEY",
-  urlToFile:
-    "https://static.deepgram.com/examples/Bueller-Life-moves-pretty-fast.wav",
-};
+const result = await deepgram.members.listMembers(project_id);
 ```
 
-Finally, run the sample code using the following command in your terminal:
+[See our API reference for more info](https://developers.deepgram.com/reference/get-members).
 
-```bash
-node sample/index.js
+## Remove Member
+
+Removes member account for specified member_id.
+
+```js
+const result = await deepgram.members.removeMember(project_id, member_id);
+```
+
+[See our API reference for more info](https://developers.deepgram.com/reference/remove-member).
+
+# Scopes
+
+## Get Member Scopes
+
+Retrieves scopes of the specified member in the specified project.
+
+```js
+const result = await deepgram.scopes.get(project_id, member_id);
+```
+
+[See our API reference for more info](https://developers.deepgram.com/reference/get-member-scopes).
+
+## Update Scope
+
+Updates the scope for the specified member in the specified project.
+
+```js
+let scope = "member:read";
+const result = await deepgram.scopes.update(project_id, member_id, scope);
+```
+
+[See our API reference for more info](https://developers.deepgram.com/reference/update-scope).
+
+# Invitations
+
+## List Invites
+
+Retrieves all invitations associated with the provided project_id.
+
+```js
+const result = await deepgram.invitations.list(project_id);
+```
+
+[See our API reference for more info](https://developers.deepgram.com/reference/list-invites).
+
+## Send Invite
+
+Sends an invitation to the provided email address.
+
+```js
+const result = await deepgram.invitation.send(project_id, options);
+```
+
+[See our API reference for more info](https://developers.deepgram.com/reference/send-invites).
+
+## Delete Invite
+
+Removes the specified invitation from the project.
+
+```js
+let email = "devrel@deepgram.com";
+const result = await deepgram.invitation.delete(project_id, email);
+```
+
+[See our API reference for more info](https://developers.deepgram.com/reference/delete-invite).
+
+## Leave Project
+
+Removes the authenticated user from the project.
+
+```js
+const result = await deepgram.invitation.leave(project_id);
+```
+
+[See our API reference for more info](https://developers.deepgram.com/reference/leave-project).
+
+# Usage
+
+## Get All Requests
+
+Retrieves all requests associated with the provided project_id based on the provided options.
+
+```js
+const result = await deepgram.usage.listRequests(project_id, options);
 ```
 
-The sample demonstrates the following uses:
+[See our API reference for more info](https://developers.deepgram.com/reference/get-all-requests).
 
-- Transcribing a prerecorded file
-- Retrieving usage for a project
-- Getting a project
-- Creating an API key
-- Deleting an API key
+## Get Request
 
-## Development and Contributing
+Retrieves a specific request associated with the provided project_id.
+
+```js
+const result = await deepgram.usage.getRequest(project_id, request_id);
+```
+
+[See our API reference for more info](https://developers.deepgram.com/reference/get-request).
+
+## Summarize Usage
+
+Retrieves usage associated with the provided project_id based on the provided options.
+
+```js
+const result = await deepgram.usage.getUsage(project_id, options);
+```
+
+[See our API reference for more info](https://developers.deepgram.com/reference/summarize-usage).
+
+## Get Fields
+
+Lists the features, models, tags, languages, and processing method used for requests in the specified project.
+
+```js
+const result = await deepgram.usage.getFields(project_id, options);
+```
+
+[See our API reference for more info](https://developers.deepgram.com/reference/get-fields).
+
+# Billing
+
+## Get All Balances
+
+Retrieves the list of balance info for the specified project.
+
+```js
+const result = await deepgram.billing.listBalances(project_id);
+```
+
+[See our API reference for more info](https://developers.deepgram.com/reference/get-all-balances).
+
+## Get Balance
+
+Retrieves the balance info for the specified project and balance_id.
+
+```js
+const result = await deepgram.billing.getBalance(project_id, balance_id);
+```
+
+[See our API reference for more info](https://developers.deepgram.com/reference/get-balance).
+
+# Development and Contributing
 
 Interested in contributing? We ❤️ pull requests!
 
@@ -112,17 +357,11 @@ To make sure our community is safe for all, be sure to review and agree to our
 [Code of Conduct](./CODE_OF_CONDUCT.md). Then see the
 [Contribution](./CONTRIBUTING.md) guidelines for more information.
 
-## Getting Help
+# Getting Help
 
 We love to hear from you so if you have questions, comments or find a bug in the
 project, let us know! You can either:
 
-- [Open an issue](https://github.com/deepgram/node-sdk/issues/new) on this repository
-- Tweet at us! We're [@DeepgramAI on Twitter](https://twitter.com/DeepgramAI)
-
-## Further Reading
-
-Check out the Developer Documentation at [https://developers.deepgram.com/](https://developers.deepgram.com/)
-
-[signup]: https://console.deepgram.com/signup?utm_medium=github&utm_source=DEVREL&utm_content=node-sdk
-[license]: LICENSE.txt
+- [Open an issue in this repository](https://github.com/deepgram/node-sdk/issues/new)
+- [Join the Deepgram Github Discussions Community](https://github.com/orgs/deepgram/discussions)
+- [Join the Deepgram Discord Community](https://discord.gg/xWRaCDBtW4)

package/dist/billing.d.ts

@@ -1,4 +1,4 @@
-import { BalanceList, Balance, RequestFunction, ErrorResponse } from "./types";
+import { BalanceList, Balance, RequestFunction } from "./types";
 export declare class Billing {
     private _credentials;
     private _apiUrl;
@@ -10,9 +10,9 @@ export declare class Billing {
      * @param {string} projectId Unique identifier of the project
      * @param {string} endpoint Custom API endpoint
      *
-     * @returns {Promise<BalanceList | ErrorResponse>}
+     * @returns {Promise<BalanceList>}
      */
-    listBalances(projectId: string, endpoint?: string): Promise<BalanceList | ErrorResponse>;
+    listBalances(projectId: string, endpoint?: string): Promise<BalanceList>;
     /**
      * Retrieves balance info of a specified balance_id in the specified project.
      * @param {string} projectId Unique identifier of the project
@@ -21,5 +21,5 @@ export declare class Billing {
      *
      * @returns {Promise<Balance>}
      */
-    getBalance(projectId: string, balanceId: string, endpoint?: string): Promise<Balance | ErrorResponse>;
+    getBalance(projectId: string, balanceId: string, endpoint?: string): Promise<Balance>;
 }

package/dist/helpers/secondsToTimestamp.d.ts

@@ -1 +1 @@
-export declare function secondsToTimestamp(seconds: number): string;
+export declare function secondsToTimestamp(seconds: number, format?: string): string;

package/dist/httpRequest.d.ts

@@ -1,3 +1,4 @@
 /// <reference types="node" />
+/// <reference types="node" />
 import { Readable } from "stream";
 export declare function _request<T>(method: string, apiKey: string, apiURL: string, requireSSL: boolean, path: string, payload?: string | Buffer | Readable, options?: Object): Promise<T>;