@newrelic/video-videojs 3.0.2 → 3.2.0-beta-0

package/CHANGELOG.md

@@ -1,20 +1,27 @@
 # CHANGELOG
 
-## [3.0.2] - 2025-05-14
+## [3.1.1] - 2025-05-28
+
+### Changed
+
+- **Standalone Agent:** This tracker now operates independently with its own authorization details, removing the dependency on a browser agent.
+
+## [3.1.0] - 2025-05-27
 
 ### Enhancements
 
-* **Publishing to npm:** The package can now be published to npm, making it easily accessible.
+- **Publishing to npm:** The package can now be published to npm, making it easily accessible.
 
 ### Build
 
-* **Distribution Formats:** Added `cjs`, `esm`, and `umd` builds to the `dist` folder, ensuring compatibility with CommonJS, ES Modules, and UMD module formats.
+- **Distribution Formats:** Added `cjs`, `esm`, and `umd` builds to the `dist` folder, ensuring compatibility with CommonJS, ES Modules, and UMD module formats.
 
-## [3.0.1] - 2025/04/02
+## [3.0.1] - 2025-04-24
 
 ### Bug Fixes
 
 - Resolved an issue where custom attribute definitions were not accepting options as arguments.
+- **Update:** The `errorName` attribute has been deprecated and `errorMessage` is introduced as its replacement.
 
 ## [3.0.0] - 2025/02/20
 

package/LICENSE.txt

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2019 New Relic, Inc.
+   Copyright New Relic, Inc. All rights reserved.
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/README.md

@@ -2,11 +2,13 @@
 
 # New Relic Videojs Tracker Agent
 
+> **⚠️ DISCLAIMER: This is a beta version. Features and APIs may change in future releases.**
+
 The New Relic Videojs Tracker enhances your media applications by tracking video events, playback errors, and other activities, providing comprehensive insights into performance and user interactions.
 
 - The Videojs tracker is available as a ready-to-use JavaScript snippet for easy copy-paste integration.
 - New Relic Videojs tracker auto-detects events emitted by Videojs Player.
-- Ensure that the **Browser agent** is successfully instrumented before deploying the media tracker.
+- **Important**: You must provide New Relic credentials in the options object when instantiating the tracker.
 - For questions and feedback on this package, please visit the [Explorer's Hub](https://discuss.newrelic.com), New Relic's community support forum.
 - Looking to contribute to the Player Name agent code base? See [DEVELOPING.md](./DEVELOPING.md) for instructions on building and testing the browser agent library, and Contributors.
 
@@ -36,25 +38,52 @@ To integrate New Relic Tracker Agent into your web application effectively, you'
 To make the tracker available to your application, install via [NPM](https://docs.npmjs.com/cli/v8/commands/npm-install) or [Yarn](https://classic.yarnpkg.com/lang/en/docs/cli/install/).
 
 ```shell
-$ npm install @newrelic/video-videojs
+$ npm install @newrelic/video-videojs@3.2.0-beta-1
 ```
 
 ```shell
-$ yarn add @newrelic/video-videojs
+$ yarn add @newrelic/video-videojs@3.2.0-beta-1
 ```
 
 ## Instantiating the Videojs Tracker
 
+**Important**: When instantiating the VideojsTracker, you must provide New Relic credentials through the options object. This is a mandatory step:
+
 ```javascript
+import VideojsTracker from '@newrelic/video-videojs';
+
+// Initialize the video player
+var player = videojs('my-video');
+
+// Configure New Relic credentials (MANDATORY)
+const options = {
+  info: {
+    beacon: 'xxxxxxxxxx',
+    errorBeacon: 'xxxxxxxxx',
+    licenseKey: 'xxxxxxxxxxx',
+    applicationID: 'xxxxxxxx',
+    sa: 1,
+  },
+};
 
-import VideojsTracker from "@newrelic/video-videojs"; 
+// Create the tracker with required credentials
+const tracker = new VideojsTracker(player, options);
+```
+
+### Additional Configuration Options
 
-// Add a VideojsTracker
-player.version = videojs.VERSION
-const tracker = new VideojsTracker(player);
+You can also include custom data along with the required credentials:
 
-//For setting custom attributes const tracker
-const tracker = new VideojsjsTracker(player, {
+```javascript
+// For setting custom attributes
+const tracker = new VideojsTracker(player, {
+  info: {
+    beacon: 'xxxxxxxxxx',
+    errorBeacon: 'xxxxxxxxx',
+    licenseKey: 'xxxxxxxxxxx',
+    applicationID: 'xxxxxxxx',
+    sa: 1,
+  },
   customData: {
     contentTitle: 'Override Existing Title',
     customPlayerName: 'myGreatPlayer',
@@ -66,8 +95,7 @@ const tracker = new VideojsjsTracker(player, {
 tracker.setUserId('userId');
 
 // For Sending custom Action with Attributes
-
-const tracker = new nrvideo.VideojsTracker(player);
+const tracker = new nrvideo.VideojsTracker(player, options);
 
 nrvideo.Core.addTracker(tracker);
 
@@ -77,6 +105,19 @@ tracker.sendCustom('CUSTOM_ACTION', 'state time', {
 });
 ```
 
+### Obtaining New Relic Credentials
+
+To get your New Relic credentials:
+
+1. Log into your New Relic account
+2. Navigate to your Browser application settings
+3. Copy the required values:
+   - `beacon`: Your data collection endpoint
+   - `errorBeacon`: Your error collection endpoint
+   - `licenseKey`: Your license key
+   - `applicationID`: Your application ID
+   - `sa`: Account ID
+
 ## Data Model
 
 To understand which actions and attributes are captured and emitted by the Videojs Player under different event types, see [DataModel.md](./DATAMODEL.md).
@@ -97,6 +138,7 @@ As noted in our [security policy](../../security/policy), New Relic is committed
 
 If you believe you have found a security vulnerability in this project or any of New Relic's products or websites, we welcome and greatly appreciate you reporting it to New Relic through [our bug bounty program](https://docs.newrelic.com/docs/security/security-privacy/information-security/report-security-vulnerabilities/).
 
-## License
+# License
 
-New Relic Videojs Tracker is licensed under the [Apache 2.0](http://apache.org/licenses/LICENSE-2.0.txt) License.
+This project is distributed under the [Apache 2.0](https://apache.org/licenses/LICENSE-2.0.txt) License.
+The video-core also uses source code from third-party libraries. Full details on which libraries are used and the terms under which they are licensed can be found in the [third-party notices document](THIRD_PARTY_NOTICES.md).

package/THIRD_PARTY_NOTICES.md

@@ -14,7 +14,7 @@ code, the source code can be found at [https://github.com/newrelic/video-videojs
 
 **[dependencies](#dependencies)**
 
-* [@rajeev-kumar/video-core](#rajeev-kumarvideo-core)
+* [@newrelic/video-core](#newrelicvideo-core)
 
 **[devDependencies](#devDependencies)**
 
@@ -26,7 +26,6 @@ code, the source code can be found at [https://github.com/newrelic/video-videojs
 * [babel-loader](#babel-loader)
 * [videojs-ima](#videojs-ima)
 * [webpack-cli](#webpack-cli)
-* [webpack-obfuscator](#webpack-obfuscator)
 * [webpack](#webpack)
 
 **[optionalDependencies](#optionalDependencies)**
@@ -35,9 +34,9 @@ code, the source code can be found at [https://github.com/newrelic/video-videojs
 
 ## dependencies
 
-### @rajeev-kumar/video-core
+### @newrelic/video-core
 
-This product includes source derived from [@rajeev-kumar/video-core](https://github.com/newrelic/video-core-js) ([v3.0.1](https://github.com/newrelic/video-core-js/tree/v3.0.1)), distributed under the [MIT License](https://github.com/newrelic/video-core-js/blob/v3.0.1/LICENSE.txt):
+This product includes source derived from [@newrelic/video-core](https://github.com/newrelic/video-core-js) ([v3.2.0-beta-1](https://github.com/newrelic/video-core-js/tree/v3.2.0-beta-1)), distributed under the [Apache-2.0 License](https://github.com/newrelic/video-core-js/blob/v3.2.0-beta-1/LICENSE):
 
 ```
                                  Apache License
@@ -228,7 +227,7 @@ This product includes source derived from [@rajeev-kumar/video-core](https://git
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2019 New Relic, Inc.
+   Copyright New Relic, Inc. All rights reserved.
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
@@ -241,7 +240,6 @@ This product includes source derived from [@rajeev-kumar/video-core](https://git
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.
-
 ```
 
 
@@ -249,7 +247,7 @@ This product includes source derived from [@rajeev-kumar/video-core](https://git
 
 ### @babel/core
 
-This product includes source derived from [@babel/core](https://github.com/babel/babel) ([v7.24.5](https://github.com/babel/babel/tree/v7.24.5)), distributed under the [MIT License](https://github.com/babel/babel/blob/v7.24.5/LICENSE):
+This product includes source derived from [@babel/core](https://github.com/babel/babel) ([v7.28.0](https://github.com/babel/babel/tree/v7.28.0)), distributed under the [MIT License](https://github.com/babel/babel/blob/v7.28.0/LICENSE):
 
 ```
 MIT License
@@ -279,7 +277,7 @@ WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 ### @babel/plugin-transform-modules-commonjs
 
-This product includes source derived from [@babel/plugin-transform-modules-commonjs](https://github.com/babel/babel) ([v7.24.1](https://github.com/babel/babel/tree/v7.24.1)), distributed under the [MIT License](https://github.com/babel/babel/blob/v7.24.1/LICENSE):
+This product includes source derived from [@babel/plugin-transform-modules-commonjs](https://github.com/babel/babel) ([v7.27.1](https://github.com/babel/babel/tree/v7.27.1)), distributed under the [MIT License](https://github.com/babel/babel/blob/v7.27.1/LICENSE):
 
 ```
 MIT License
@@ -309,7 +307,7 @@ WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 ### @babel/preset-env
 
-This product includes source derived from [@babel/preset-env](https://github.com/babel/babel) ([v7.24.5](https://github.com/babel/babel/tree/v7.24.5)), distributed under the [MIT License](https://github.com/babel/babel/blob/v7.24.5/LICENSE):
+This product includes source derived from [@babel/preset-env](https://github.com/babel/babel) ([v7.28.0](https://github.com/babel/babel/tree/v7.28.0)), distributed under the [MIT License](https://github.com/babel/babel/blob/v7.28.0/LICENSE):
 
 ```
 MIT License
@@ -547,7 +545,7 @@ This product includes source derived from [@newrelic/newrelic-oss-cli](https://g
 
 ### aws-sdk
 
-This product includes source derived from [aws-sdk](https://github.com/aws/aws-sdk-js) ([v2.1621.0](https://github.com/aws/aws-sdk-js/tree/v2.1621.0)), distributed under the [Apache-2.0 License](https://github.com/aws/aws-sdk-js/blob/v2.1621.0/LICENSE.txt):
+This product includes source derived from [aws-sdk](https://github.com/aws/aws-sdk-js) ([v2.1692.0](https://github.com/aws/aws-sdk-js/tree/v2.1692.0)), distributed under the [Apache-2.0 License](https://github.com/aws/aws-sdk-js/blob/v2.1692.0/LICENSE.txt):
 
 ```
 
@@ -757,7 +755,7 @@ This product includes source derived from [aws-sdk](https://github.com/aws/aws-s
 
 ### babel-loader
 
-This product includes source derived from [babel-loader](https://github.com/babel/babel-loader) ([v9.1.3](https://github.com/babel/babel-loader/tree/v9.1.3)), distributed under the [MIT License](https://github.com/babel/babel-loader/blob/v9.1.3/LICENSE):
+This product includes source derived from [babel-loader](https://github.com/babel/babel-loader) ([v9.2.1](https://github.com/babel/babel-loader/tree/v9.2.1)), distributed under the [MIT License](https://github.com/babel/babel-loader/blob/v9.2.1/LICENSE):
 
 ```
 Copyright (c) 2014-2019 Luís Couto <hello@luiscouto.pt>
@@ -996,58 +994,34 @@ This product includes source derived from [videojs-ima](https://github.com/googl
 
 ### webpack-cli
 
-This product includes source derived from [webpack-cli](https://github.com/webpack/webpack-cli) ([v4.9.2](https://github.com/webpack/webpack-cli/tree/v4.9.2)), distributed under the [MIT License](https://github.com/webpack/webpack-cli/blob/v4.9.2/README.md):
-
-```
-MIT License
-
-Copyright (c) <year> <copyright holders>
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and 
-associated documentation files (the "Software"), to deal in the Software without restriction, including 
-without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 
-copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the 
-following conditions:
-
-The above copyright notice and this permission notice shall be included in all copies or substantial 
-portions of the Software.
+This product includes source derived from [webpack-cli](https://github.com/webpack/webpack-cli) ([v4.10.0](https://github.com/webpack/webpack-cli/tree/v4.10.0)), distributed under the [MIT License](https://github.com/webpack/webpack-cli/blob/v4.10.0/LICENSE):
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT 
-LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO 
-EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER 
-IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE 
-USE OR OTHER DEALINGS IN THE SOFTWARE.
 ```
+Copyright JS Foundation and other contributors
 
-### webpack-obfuscator
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
 
-This product includes source derived from [webpack-obfuscator](https://github.com/javascript-obfuscator/webpack-obfuscator) ([v3.5.1](https://github.com/javascript-obfuscator/webpack-obfuscator/tree/v3.5.1)), distributed under the [BSD-2-Clause License](https://github.com/javascript-obfuscator/webpack-obfuscator/blob/v3.5.1/LICENSE.BSD):
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
 
-```
-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.
-
-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 <COPYRIGHT HOLDER> 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.
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ```
 
 ### webpack
 
-This product includes source derived from [webpack](https://github.com/webpack/webpack) ([v5.91.0](https://github.com/webpack/webpack/tree/v5.91.0)), distributed under the [MIT License](https://github.com/webpack/webpack/blob/v5.91.0/LICENSE):
+This product includes source derived from [webpack](https://github.com/webpack/webpack) ([v5.101.0](https://github.com/webpack/webpack/tree/v5.101.0)), distributed under the [MIT License](https://github.com/webpack/webpack/blob/v5.101.0/LICENSE):
 
 ```
 Copyright JS Foundation and other contributors