@amplitude/analytics-node 0.3.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Amplitude Analytics
+
+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.
+
+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.

package/README.md

@@ -0,0 +1,152 @@
+<p align="center">
+  <a href="https://amplitude.com" target="_blank" align="center">
+    <img src="https://static.amplitude.com/lightning/46c85bfd91905de8047f1ee65c7c93d6fa9ee6ea/static/media/amplitude-logo-with-text.4fb9e463.svg" width="280">
+  </a>
+  <br />
+</p>
+
+# @amplitude/analytics-node
+
+Official Amplitude SDK for Node.js (Beta)
+
+## Installation
+
+To get started with using Amplitude Node.js SDK, install the package to your project via NPM.
+
+### Using Node package
+
+This package is published on NPM registry and is available to be installed using npm and yarn.
+
+```sh
+# npm
+npm install @amplitude/analytics-node
+
+# yarn
+yarn add @amplitude/analytics-node
+```
+
+## Usage
+
+### Initializing SDK
+
+Initialization is necessary before any instrumentation is done. The API key for your Amplitude project is required.
+
+```typescript
+amplitude.init(API_KEY);
+```
+
+### Tracking an Event
+
+Events represent how users interact with your application. For example, "Button Clicked" may be an action you want to note.
+
+```typescript
+import { track } from '@amplitude/analytics-node';
+
+// Track a basic event
+track('Button Clicked');
+
+// Track events with additional properties
+const eventProperties = {
+  selectedColors: ['red', 'blue'],
+};
+track('Button Clicked', eventProperties);
+```
+
+### User Properties
+
+User properties help you understand your users at the time they performed some action within your app such as their device details, their preferences, or language.
+
+```typescript
+import { Identify, identify } from '@amplitude/analytics-node';
+
+const event = new Identify();
+
+// sets the value of a user property
+event.set('key1', 'value1');
+
+// sets the value of a user property only once
+event.setOnce('key1', 'value1');
+
+// increments a user property by some numerical value.
+event.add('value1', 10);
+
+// pre inserts a value or values to a user property
+event.preInsert('ab-tests', 'new-user-test');
+
+// post inserts a value or values to a user property
+event.postInsert('ab-tests', 'new-user-test');
+
+// removes a value or values to a user property
+event.remove('ab-tests', 'new-user-test')
+
+// sends identify event
+identify(event);
+```
+
+### prepend/append
+
+* append will append a value or values to a user property array.
+* prepend will prepend a value or values to a user property.
+
+### User Groups
+
+```typescript
+import { setGroup } from '@amplitude/analytics-node';
+
+// set group with single group name
+setGroup('orgId', '15');
+
+// set group with multiple group names
+setGroup('sport', ['soccer', 'tennis']);
+```
+
+### Group Identify
+
+This feature is only available to Growth and Enterprise customers who have purchased the [Accounts add-on](https://amplitude.zendesk.com/hc/en-us/articles/115001765532).
+
+Use the Group Identify API to set or update properties of particular groups. However, these updates will only affect events going forward.
+
+```typescript
+import { Identify, groupIdentify } from '@amplitude/analytics-node';
+
+const groupType = 'plan';
+const groupName = 'enterprise';
+const event = new Identify()
+event.set('key1', 'value1');
+
+groupIdentify(groupType, groupName, identify);
+```
+
+### Track Revenue
+
+Revenue instances will store each revenue transaction and allow you to define several special revenue properties (such as 'revenueType', 'productIdentifier', etc.) that are used in Amplitude's Event Segmentation and Revenue LTV charts. These Revenue instance objects are then passed into `revenue` to send as revenue events to Amplitude. This allows us to automatically display data relevant to revenue in the platform. You can use this to track both in-app and non-in-app purchases.
+
+```typescript
+import { Revenue, revenue } from '@amplitude/analytics-node';
+
+const event = new Revenue()
+  .setProductId('com.company.productId')
+  .setPrice(3.99)
+  .setQuantity(3);
+
+revenue(event);
+```
+
+### Callback
+
+All asynchronous API are optionally awaitable through a specific Promise interface. This also serves as callback interface.
+
+```typescript
+// Using async/await
+const results = await track('Button Clicked').promise;
+result.event; // {...} (The final event object sent to Amplitude)
+result.code; // 200 (The HTTP response status code of the request.
+result.message; // "Event tracked successfully" (The response message)
+
+// Using promises
+track('Button Clicked').promise.then((result) => {
+  result.event; // {...} (The final event object sent to Amplitude)
+  result.code; // 200 (The HTTP response status code of the request.
+  result.message; // "Event tracked successfully" (The response message)
+});
+```

package/lib/cjs/config.d.ts

@@ -0,0 +1,7 @@
+import { NodeOptions, NodeConfig as INodeConfig } from '@amplitude/analytics-types';
+import { Config } from '@amplitude/analytics-core';
+export declare class NodeConfig extends Config implements INodeConfig {
+    constructor(apiKey: string, options?: NodeOptions);
+}
+export declare const useNodeConfig: (apiKey: string, overrides?: NodeOptions | undefined) => INodeConfig;
+//# sourceMappingURL=config.d.ts.map

package/lib/cjs/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,IAAI,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAGnD,qBAAa,UAAW,SAAQ,MAAO,YAAW,WAAW;gBAC/C,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW;CAWlD;AAED,eAAO,MAAM,aAAa,WAAY,MAAM,0CAA4B,WAEvE,CAAC"}

package/lib/cjs/config.js

@@ -0,0 +1,23 @@
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useNodeConfig = exports.NodeConfig = void 0;
+var tslib_1 = require("tslib");
+var analytics_core_1 = require("@amplitude/analytics-core");
+var http_1 = require("./transports/http");
+var NodeConfig = /** @class */ (function (_super) {
+    (0, tslib_1.__extends)(NodeConfig, _super);
+    function NodeConfig(apiKey, options) {
+        var _a;
+        var _this = this;
+        var storageProvider = options === null || options === void 0 ? void 0 : options.storageProvider;
+        var transportProvider = (_a = options === null || options === void 0 ? void 0 : options.transportProvider) !== null && _a !== void 0 ? _a : new http_1.Http();
+        _this = _super.call(this, (0, tslib_1.__assign)((0, tslib_1.__assign)({}, options), { apiKey: apiKey, storageProvider: storageProvider, transportProvider: transportProvider })) || this;
+        return _this;
+    }
+    return NodeConfig;
+}(analytics_core_1.Config));
+exports.NodeConfig = NodeConfig;
+var useNodeConfig = function (apiKey, overrides) {
+    return new NodeConfig(apiKey, overrides);
+};
+exports.useNodeConfig = useNodeConfig;
+//# sourceMappingURL=config.js.map

package/lib/cjs/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":";;;AACA,4DAAmD;AACnD,0CAAyC;AAEzC;IAAgC,2CAAM;IACpC,oBAAY,MAAc,EAAE,OAAqB;;QAAjD,iBAUC;QATC,IAAM,eAAe,GAAG,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,eAAe,CAAC;QACjD,IAAM,iBAAiB,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,iBAAiB,mCAAI,IAAI,WAAI,EAAE,CAAC;QAEnE,QAAA,kEACK,OAAO,KACV,MAAM,QAAA,EACN,eAAe,iBAAA,EACf,iBAAiB,mBAAA,IACjB,SAAC;;IACL,CAAC;IACH,iBAAC;AAAD,CAAC,AAZD,CAAgC,uBAAM,GAYrC;AAZY,gCAAU;AAchB,IAAM,aAAa,GAAG,UAAC,MAAc,EAAE,SAAuB;IACnE,OAAO,IAAI,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAC3C,CAAC,CAAC;AAFW,QAAA,aAAa,iBAExB","sourcesContent":["import { NodeOptions, NodeConfig as INodeConfig } from '@amplitude/analytics-types';\nimport { Config } from '@amplitude/analytics-core';\nimport { Http } from './transports/http';\n\nexport class NodeConfig extends Config implements INodeConfig {\n  constructor(apiKey: string, options?: NodeOptions) {\n    const storageProvider = options?.storageProvider;\n    const transportProvider = options?.transportProvider ?? new Http();\n\n    super({\n      ...options,\n      apiKey,\n      storageProvider,\n      transportProvider,\n    });\n  }\n}\n\nexport const useNodeConfig = (apiKey: string, overrides?: NodeOptions): INodeConfig => {\n  return new NodeConfig(apiKey, overrides);\n};\n"]}

package/lib/cjs/index.d.ts

@@ -0,0 +1,4 @@
+export { add, groupIdentify, identify, init, logEvent, remove, revenue, setGroup, setOptOut, track, flush, } from './node-client';
+export { Revenue, Identify } from '@amplitude/analytics-core';
+export * as Types from '@amplitude/analytics-types';
+//# sourceMappingURL=index.d.ts.map

package/lib/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,GAAG,EACH,aAAa,EACb,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,OAAO,EACP,QAAQ,EACR,SAAS,EACT,KAAK,EACL,KAAK,GACN,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,KAAK,MAAM,4BAA4B,CAAC"}

package/lib/cjs/index.js

@@ -0,0 +1,19 @@
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Types = exports.Identify = exports.Revenue = exports.flush = exports.track = exports.setOptOut = exports.setGroup = exports.revenue = exports.remove = exports.logEvent = exports.init = exports.identify = exports.groupIdentify = exports.add = void 0;
+var node_client_1 = require("./node-client");
+Object.defineProperty(exports, "add", { enumerable: true, get: function () { return node_client_1.add; } });
+Object.defineProperty(exports, "groupIdentify", { enumerable: true, get: function () { return node_client_1.groupIdentify; } });
+Object.defineProperty(exports, "identify", { enumerable: true, get: function () { return node_client_1.identify; } });
+Object.defineProperty(exports, "init", { enumerable: true, get: function () { return node_client_1.init; } });
+Object.defineProperty(exports, "logEvent", { enumerable: true, get: function () { return node_client_1.logEvent; } });
+Object.defineProperty(exports, "remove", { enumerable: true, get: function () { return node_client_1.remove; } });
+Object.defineProperty(exports, "revenue", { enumerable: true, get: function () { return node_client_1.revenue; } });
+Object.defineProperty(exports, "setGroup", { enumerable: true, get: function () { return node_client_1.setGroup; } });
+Object.defineProperty(exports, "setOptOut", { enumerable: true, get: function () { return node_client_1.setOptOut; } });
+Object.defineProperty(exports, "track", { enumerable: true, get: function () { return node_client_1.track; } });
+Object.defineProperty(exports, "flush", { enumerable: true, get: function () { return node_client_1.flush; } });
+var analytics_core_1 = require("@amplitude/analytics-core");
+Object.defineProperty(exports, "Revenue", { enumerable: true, get: function () { return analytics_core_1.Revenue; } });
+Object.defineProperty(exports, "Identify", { enumerable: true, get: function () { return analytics_core_1.Identify; } });
+exports.Types = require("@amplitude/analytics-types");
+//# sourceMappingURL=index.js.map

package/lib/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;AAAA,6CAYuB;AAXrB,kGAAA,GAAG,OAAA;AACH,4GAAA,aAAa,OAAA;AACb,uGAAA,QAAQ,OAAA;AACR,mGAAA,IAAI,OAAA;AACJ,uGAAA,QAAQ,OAAA;AACR,qGAAA,MAAM,OAAA;AACN,sGAAA,OAAO,OAAA;AACP,uGAAA,QAAQ,OAAA;AACR,wGAAA,SAAS,OAAA;AACT,oGAAA,KAAK,OAAA;AACL,oGAAA,KAAK,OAAA;AAEP,4DAA8D;AAArD,yGAAA,OAAO,OAAA;AAAE,0GAAA,QAAQ,OAAA;AAC1B,sDAAoD","sourcesContent":["export {\n  add,\n  groupIdentify,\n  identify,\n  init,\n  logEvent,\n  remove,\n  revenue,\n  setGroup,\n  setOptOut,\n  track,\n  flush,\n} from './node-client';\nexport { Revenue, Identify } from '@amplitude/analytics-core';\nexport * as Types from '@amplitude/analytics-types';\n"]}

package/lib/cjs/node-client.d.ts

@@ -0,0 +1,138 @@
+import { AmplitudeCore } from '@amplitude/analytics-core';
+import { NodeConfig, NodeOptions } from '@amplitude/analytics-types';
+export declare class AmplitudeNode extends AmplitudeCore<NodeConfig> {
+    init(apiKey: string, options?: NodeOptions): Promise<void>;
+}
+/**
+ * Initializes the Amplitude SDK with your apiKey and optional configurations.
+ * This method must be called before any other operations.
+ *
+ * ```typescript
+ * await init(API_KEY, USER_ID, options).promise;
+ * ```
+ */
+export declare const init: (apiKey: string, options?: NodeOptions | undefined) => import("@amplitude/analytics-types").AmplitudeReturn<Promise<void>>;
+/**
+ * Adds a new plugin.
+ *
+ * ```typescript
+ * const plugin = {...};
+ * add(plugin);
+ *
+ * // alternatively, this tracking method is awaitable
+ * await add(plugin).promise;
+ * ```
+ */
+export declare const add: (plugin: import("@amplitude/analytics-types").Plugin) => import("@amplitude/analytics-types").AmplitudeReturn<Promise<void>>;
+/**
+ * Removes a plugin.
+ *
+ * ```typescript
+ * remove('myPlugin');
+ *
+ * // alternatively, this tracking method is awaitable
+ * await remove('myPlugin').promise;
+ * ```
+ */
+export declare const remove: (pluginName: string) => import("@amplitude/analytics-types").AmplitudeReturn<Promise<void>>;
+/**
+ * Tracks user-defined event, with specified type, optional event properties and optional overwrites.
+ *
+ * ```typescript
+ * // event tracking with event type only
+ * track('Page Load');
+ *
+ * // event tracking with event type and additional event properties
+ * track('Page Load', { loadTime: 1000 });
+ *
+ * // event tracking with event type, additional event properties, and overwritten event options
+ * track('Page Load', { loadTime: 1000 }, { sessionId: -1 });
+ *
+ * // alternatively, this tracking method is awaitable
+ * const result = await track('Page Load').promise;
+ * console.log(result.event); // {...}
+ * console.log(result.code); // 200
+ * console.log(result.message); // "Event tracked successfully"
+ * ```
+ */
+export declare const track: (eventInput: string | import("@amplitude/analytics-types").BaseEvent, eventProperties?: Record<string, any> | undefined, eventOptions?: import("@amplitude/analytics-types").EventOptions | undefined) => import("@amplitude/analytics-types").AmplitudeReturn<Promise<import("@amplitude/analytics-types").Result>>;
+/**
+ * Alias for track()
+ */
+export declare const logEvent: (eventInput: string | import("@amplitude/analytics-types").BaseEvent, eventProperties?: Record<string, any> | undefined, eventOptions?: import("@amplitude/analytics-types").EventOptions | undefined) => import("@amplitude/analytics-types").AmplitudeReturn<Promise<import("@amplitude/analytics-types").Result>>;
+/**
+ * Sends an identify event containing user property operations
+ *
+ * ```typescript
+ * const id = new Identify();
+ * id.set('colors', ['rose', 'gold']);
+ * identify(id);
+ *
+ * // alternatively, this tracking method is awaitable
+ * const result = await identify(id).promise;
+ * console.log(result.event); // {...}
+ * console.log(result.code); // 200
+ * console.log(result.message); // "Event tracked successfully"
+ * ```
+ */
+export declare const identify: (identify: import("@amplitude/analytics-types").Identify, eventOptions?: import("@amplitude/analytics-types").EventOptions | undefined) => import("@amplitude/analytics-types").AmplitudeReturn<Promise<import("@amplitude/analytics-types").Result>>;
+/**
+ * Sends a group identify event containing group property operations.
+ *
+ * ```typescript
+ * const id = new Identify();
+ * id.set('skills', ['js', 'ts']);
+ * const groupType = 'org';
+ * const groupName = 'engineering';
+ * groupIdentify(groupType, groupName, id);
+ *
+ * // alternatively, this tracking method is awaitable
+ * const result = await groupIdentify(groupType, groupName, id).promise;
+ * console.log(result.event); // {...}
+ * console.log(result.code); // 200
+ * console.log(result.message); // "Event tracked successfully"
+ * ```
+ */
+export declare const groupIdentify: (groupType: string, groupName: string | string[], identify: import("@amplitude/analytics-types").Identify, eventOptions?: import("@amplitude/analytics-types").EventOptions | undefined) => import("@amplitude/analytics-types").AmplitudeReturn<Promise<import("@amplitude/analytics-types").Result>>;
+export declare const setGroup: (groupType: string, groupName: string | string[]) => import("@amplitude/analytics-types").AmplitudeReturn<Promise<import("@amplitude/analytics-types").Result>>;
+/**
+ * Sends a revenue event containing revenue property operations.
+ *
+ * ```typescript
+ * const rev = new Revenue();
+ * rev.setRevenue(100);
+ * revenue(rev);
+ *
+ * // alternatively, this tracking method is awaitable
+ * const result = await revenue(rev).promise;
+ * console.log(result.event); // {...}
+ * console.log(result.code); // 200
+ * console.log(result.message); // "Event tracked successfully"
+ * ```
+ */
+export declare const revenue: (revenue: import("@amplitude/analytics-types").Revenue, eventOptions?: import("@amplitude/analytics-types").EventOptions | undefined) => import("@amplitude/analytics-types").AmplitudeReturn<Promise<import("@amplitude/analytics-types").Result>>;
+/**
+ * Sets a new optOut config value. This toggles event tracking on/off.
+ *
+ *```typescript
+ * // Stops tracking
+ * setOptOut(true);
+ *
+ * // Starts/resumes tracking
+ * setOptOut(false);
+ * ```
+ */
+export declare const setOptOut: (optOut: boolean) => void;
+/**
+ * Flush and send all the events which haven't been sent.
+ *
+ *```typescript
+ * // Send all the unsent events
+ * flush();
+ *
+ * // alternatively, this tracking method is awaitable
+ * await flush().promise;
+ * ```
+ */
+export declare const flush: () => import("@amplitude/analytics-types").AmplitudeReturn<Promise<void>>;
+//# sourceMappingURL=node-client.d.ts.map

package/lib/cjs/node-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-client.d.ts","sourceRoot":"","sources":["../../src/node-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA8B,MAAM,2BAA2B,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAIrE,qBAAa,aAAc,SAAQ,aAAa,CAAC,UAAU,CAAC;IACpD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW;CAiBjD;AAID;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,4HAA0C,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,GAAG,8HAAyC,CAAC;AAE1D;;;;;;;;;GASG;AACH,eAAO,MAAM,MAAM,6FAA4C,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,KAAK,sTAA2C,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,QAAQ,sTAA8C,CAAC;AAEpE;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,QAAQ,uPAA8C,CAAC;AAEpE;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,aAAa,wSAAmD,CAAC;AAC9E,eAAO,MAAM,QAAQ,iKAA8C,CAAC;AAEpE;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,OAAO,qPAA6C,CAAC;AAElE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,2BAAgC,CAAC;AAEvD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,KAAK,2EAA2C,CAAC"}

package/lib/cjs/node-client.js

@@ -0,0 +1,175 @@
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flush = exports.setOptOut = exports.revenue = exports.setGroup = exports.groupIdentify = exports.identify = exports.logEvent = exports.track = exports.remove = exports.add = exports.init = exports.AmplitudeNode = void 0;
+var tslib_1 = require("tslib");
+var analytics_core_1 = require("@amplitude/analytics-core");
+var context_1 = require("./plugins/context");
+var config_1 = require("./config");
+var AmplitudeNode = /** @class */ (function (_super) {
+    (0, tslib_1.__extends)(AmplitudeNode, _super);
+    function AmplitudeNode() {
+        return _super !== null && _super.apply(this, arguments) || this;
+    }
+    AmplitudeNode.prototype.init = function (apiKey, options) {
+        return (0, tslib_1.__awaiter)(this, void 0, void 0, function () {
+            var nodeOptions;
+            return (0, tslib_1.__generator)(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        nodeOptions = (0, config_1.useNodeConfig)(apiKey, (0, tslib_1.__assign)({}, options));
+                        return [4 /*yield*/, _super.prototype._init.call(this, nodeOptions)];
+                    case 1:
+                        _a.sent();
+                        return [4 /*yield*/, this.add(new context_1.Context())];
+                    case 2:
+                        _a.sent();
+                        return [4 /*yield*/, this.add(new analytics_core_1.Destination())];
+                    case 3:
+                        _a.sent();
+                        // Set timeline ready for processing events
+                        // Send existing events, which might be collected by track before init
+                        this.timeline.isReady = true;
+                        if (!this.config.optOut) {
+                            this.timeline.scheduleApply(0);
+                        }
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    return AmplitudeNode;
+}(analytics_core_1.AmplitudeCore));
+exports.AmplitudeNode = AmplitudeNode;
+var client = new AmplitudeNode();
+/**
+ * Initializes the Amplitude SDK with your apiKey and optional configurations.
+ * This method must be called before any other operations.
+ *
+ * ```typescript
+ * await init(API_KEY, USER_ID, options).promise;
+ * ```
+ */
+exports.init = (0, analytics_core_1.returnWrapper)(client.init.bind(client));
+/**
+ * Adds a new plugin.
+ *
+ * ```typescript
+ * const plugin = {...};
+ * add(plugin);
+ *
+ * // alternatively, this tracking method is awaitable
+ * await add(plugin).promise;
+ * ```
+ */
+exports.add = (0, analytics_core_1.returnWrapper)(client.add.bind(client));
+/**
+ * Removes a plugin.
+ *
+ * ```typescript
+ * remove('myPlugin');
+ *
+ * // alternatively, this tracking method is awaitable
+ * await remove('myPlugin').promise;
+ * ```
+ */
+exports.remove = (0, analytics_core_1.returnWrapper)(client.remove.bind(client));
+/**
+ * Tracks user-defined event, with specified type, optional event properties and optional overwrites.
+ *
+ * ```typescript
+ * // event tracking with event type only
+ * track('Page Load');
+ *
+ * // event tracking with event type and additional event properties
+ * track('Page Load', { loadTime: 1000 });
+ *
+ * // event tracking with event type, additional event properties, and overwritten event options
+ * track('Page Load', { loadTime: 1000 }, { sessionId: -1 });
+ *
+ * // alternatively, this tracking method is awaitable
+ * const result = await track('Page Load').promise;
+ * console.log(result.event); // {...}
+ * console.log(result.code); // 200
+ * console.log(result.message); // "Event tracked successfully"
+ * ```
+ */
+exports.track = (0, analytics_core_1.returnWrapper)(client.track.bind(client));
+/**
+ * Alias for track()
+ */
+exports.logEvent = (0, analytics_core_1.returnWrapper)(client.logEvent.bind(client));
+/**
+ * Sends an identify event containing user property operations
+ *
+ * ```typescript
+ * const id = new Identify();
+ * id.set('colors', ['rose', 'gold']);
+ * identify(id);
+ *
+ * // alternatively, this tracking method is awaitable
+ * const result = await identify(id).promise;
+ * console.log(result.event); // {...}
+ * console.log(result.code); // 200
+ * console.log(result.message); // "Event tracked successfully"
+ * ```
+ */
+exports.identify = (0, analytics_core_1.returnWrapper)(client.identify.bind(client));
+/**
+ * Sends a group identify event containing group property operations.
+ *
+ * ```typescript
+ * const id = new Identify();
+ * id.set('skills', ['js', 'ts']);
+ * const groupType = 'org';
+ * const groupName = 'engineering';
+ * groupIdentify(groupType, groupName, id);
+ *
+ * // alternatively, this tracking method is awaitable
+ * const result = await groupIdentify(groupType, groupName, id).promise;
+ * console.log(result.event); // {...}
+ * console.log(result.code); // 200
+ * console.log(result.message); // "Event tracked successfully"
+ * ```
+ */
+exports.groupIdentify = (0, analytics_core_1.returnWrapper)(client.groupIdentify.bind(client));
+exports.setGroup = (0, analytics_core_1.returnWrapper)(client.setGroup.bind(client));
+/**
+ * Sends a revenue event containing revenue property operations.
+ *
+ * ```typescript
+ * const rev = new Revenue();
+ * rev.setRevenue(100);
+ * revenue(rev);
+ *
+ * // alternatively, this tracking method is awaitable
+ * const result = await revenue(rev).promise;
+ * console.log(result.event); // {...}
+ * console.log(result.code); // 200
+ * console.log(result.message); // "Event tracked successfully"
+ * ```
+ */
+exports.revenue = (0, analytics_core_1.returnWrapper)(client.revenue.bind(client));
+/**
+ * Sets a new optOut config value. This toggles event tracking on/off.
+ *
+ *```typescript
+ * // Stops tracking
+ * setOptOut(true);
+ *
+ * // Starts/resumes tracking
+ * setOptOut(false);
+ * ```
+ */
+exports.setOptOut = client.setOptOut.bind(client);
+/**
+ * Flush and send all the events which haven't been sent.
+ *
+ *```typescript
+ * // Send all the unsent events
+ * flush();
+ *
+ * // alternatively, this tracking method is awaitable
+ * await flush().promise;
+ * ```
+ */
+exports.flush = (0, analytics_core_1.returnWrapper)(client.flush.bind(client));
+//# sourceMappingURL=node-client.js.map

package/lib/cjs/node-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-client.js","sourceRoot":"","sources":["../../src/node-client.ts"],"names":[],"mappings":";;;AAAA,4DAAsF;AAEtF,6CAA4C;AAC5C,mCAAyC;AAEzC;IAAmC,8CAAyB;IAA5D;;IAkBA,CAAC;IAjBO,4BAAI,GAAV,UAAW,MAAc,EAAE,OAAqB;;;;;;wBACxC,WAAW,GAAG,IAAA,sBAAa,EAAC,MAAM,4BACnC,OAAO,EACV,CAAC;wBAEH,qBAAM,iBAAM,KAAK,YAAC,WAAW,CAAC,EAAA;;wBAA9B,SAA8B,CAAC;wBAE/B,qBAAM,IAAI,CAAC,GAAG,CAAC,IAAI,iBAAO,EAAE,CAAC,EAAA;;wBAA7B,SAA6B,CAAC;wBAC9B,qBAAM,IAAI,CAAC,GAAG,CAAC,IAAI,4BAAW,EAAE,CAAC,EAAA;;wBAAjC,SAAiC,CAAC;wBAElC,2CAA2C;wBAC3C,sEAAsE;wBACtE,IAAI,CAAC,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;wBAC7B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;4BACvB,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;yBAChC;;;;;KACF;IACH,oBAAC;AAAD,CAAC,AAlBD,CAAmC,8BAAa,GAkB/C;AAlBY,sCAAa;AAoB1B,IAAM,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;AAEnC;;;;;;;GAOG;AACU,QAAA,IAAI,GAAG,IAAA,8BAAa,EAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAE5D;;;;;;;;;;GAUG;AACU,QAAA,GAAG,GAAG,IAAA,8BAAa,EAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAE1D;;;;;;;;;GASG;AACU,QAAA,MAAM,GAAG,IAAA,8BAAa,EAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;GAmBG;AACU,QAAA,KAAK,GAAG,IAAA,8BAAa,EAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAE9D;;GAEG;AACU,QAAA,QAAQ,GAAG,IAAA,8BAAa,EAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAEpE;;;;;;;;;;;;;;GAcG;AACU,QAAA,QAAQ,GAAG,IAAA,8BAAa,EAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAEpE;;;;;;;;;;;;;;;;GAgBG;AACU,QAAA,aAAa,GAAG,IAAA,8BAAa,EAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AACjE,QAAA,QAAQ,GAAG,IAAA,8BAAa,EAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAEpE;;;;;;;;;;;;;;GAcG;AACU,QAAA,OAAO,GAAG,IAAA,8BAAa,EAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAElE;;;;;;;;;;GAUG;AACU,QAAA,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAEvD;;;;;;;;;;GAUG;AACU,QAAA,KAAK,GAAG,IAAA,8BAAa,EAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC","sourcesContent":["import { AmplitudeCore, Destination, returnWrapper } from '@amplitude/analytics-core';\nimport { NodeConfig, NodeOptions } from '@amplitude/analytics-types';\nimport { Context } from './plugins/context';\nimport { useNodeConfig } from './config';\n\nexport class AmplitudeNode extends AmplitudeCore<NodeConfig> {\n  async init(apiKey: string, options?: NodeOptions) {\n    const nodeOptions = useNodeConfig(apiKey, {\n      ...options,\n    });\n\n    await super._init(nodeOptions);\n\n    await this.add(new Context());\n    await this.add(new Destination());\n\n    // Set timeline ready for processing events\n    // Send existing events, which might be collected by track before init\n    this.timeline.isReady = true;\n    if (!this.config.optOut) {\n      this.timeline.scheduleApply(0);\n    }\n  }\n}\n\nconst client = new AmplitudeNode();\n\n/**\n * Initializes the Amplitude SDK with your apiKey and optional configurations.\n * This method must be called before any other operations.\n *\n * ```typescript\n * await init(API_KEY, USER_ID, options).promise;\n * ```\n */\nexport const init = returnWrapper(client.init.bind(client));\n\n/**\n * Adds a new plugin.\n *\n * ```typescript\n * const plugin = {...};\n * add(plugin);\n *\n * // alternatively, this tracking method is awaitable\n * await add(plugin).promise;\n * ```\n */\nexport const add = returnWrapper(client.add.bind(client));\n\n/**\n * Removes a plugin.\n *\n * ```typescript\n * remove('myPlugin');\n *\n * // alternatively, this tracking method is awaitable\n * await remove('myPlugin').promise;\n * ```\n */\nexport const remove = returnWrapper(client.remove.bind(client));\n\n/**\n * Tracks user-defined event, with specified type, optional event properties and optional overwrites.\n *\n * ```typescript\n * // event tracking with event type only\n * track('Page Load');\n *\n * // event tracking with event type and additional event properties\n * track('Page Load', { loadTime: 1000 });\n *\n * // event tracking with event type, additional event properties, and overwritten event options\n * track('Page Load', { loadTime: 1000 }, { sessionId: -1 });\n *\n * // alternatively, this tracking method is awaitable\n * const result = await track('Page Load').promise;\n * console.log(result.event); // {...}\n * console.log(result.code); // 200\n * console.log(result.message); // \"Event tracked successfully\"\n * ```\n */\nexport const track = returnWrapper(client.track.bind(client));\n\n/**\n * Alias for track()\n */\nexport const logEvent = returnWrapper(client.logEvent.bind(client));\n\n/**\n * Sends an identify event containing user property operations\n *\n * ```typescript\n * const id = new Identify();\n * id.set('colors', ['rose', 'gold']);\n * identify(id);\n *\n * // alternatively, this tracking method is awaitable\n * const result = await identify(id).promise;\n * console.log(result.event); // {...}\n * console.log(result.code); // 200\n * console.log(result.message); // \"Event tracked successfully\"\n * ```\n */\nexport const identify = returnWrapper(client.identify.bind(client));\n\n/**\n * Sends a group identify event containing group property operations.\n *\n * ```typescript\n * const id = new Identify();\n * id.set('skills', ['js', 'ts']);\n * const groupType = 'org';\n * const groupName = 'engineering';\n * groupIdentify(groupType, groupName, id);\n *\n * // alternatively, this tracking method is awaitable\n * const result = await groupIdentify(groupType, groupName, id).promise;\n * console.log(result.event); // {...}\n * console.log(result.code); // 200\n * console.log(result.message); // \"Event tracked successfully\"\n * ```\n */\nexport const groupIdentify = returnWrapper(client.groupIdentify.bind(client));\nexport const setGroup = returnWrapper(client.setGroup.bind(client));\n\n/**\n * Sends a revenue event containing revenue property operations.\n *\n * ```typescript\n * const rev = new Revenue();\n * rev.setRevenue(100);\n * revenue(rev);\n *\n * // alternatively, this tracking method is awaitable\n * const result = await revenue(rev).promise;\n * console.log(result.event); // {...}\n * console.log(result.code); // 200\n * console.log(result.message); // \"Event tracked successfully\"\n * ```\n */\nexport const revenue = returnWrapper(client.revenue.bind(client));\n\n/**\n * Sets a new optOut config value. This toggles event tracking on/off.\n *\n *```typescript\n * // Stops tracking\n * setOptOut(true);\n *\n * // Starts/resumes tracking\n * setOptOut(false);\n * ```\n */\nexport const setOptOut = client.setOptOut.bind(client);\n\n/**\n * Flush and send all the events which haven't been sent.\n *\n *```typescript\n * // Send all the unsent events\n * flush();\n *\n * // alternatively, this tracking method is awaitable\n * await flush().promise;\n * ```\n */\nexport const flush = returnWrapper(client.flush.bind(client));\n"]}

package/lib/cjs/plugins/context.d.ts

@@ -0,0 +1,11 @@
+import { BeforePlugin, NodeConfig, Event, PluginType } from '@amplitude/analytics-types';
+export declare class Context implements BeforePlugin {
+    name: string;
+    type: PluginType.BEFORE;
+    config: NodeConfig;
+    eventId: number;
+    library: string;
+    setup(config: NodeConfig): Promise<undefined>;
+    execute(context: Event): Promise<Event>;
+}
+//# sourceMappingURL=context.d.ts.map

package/lib/cjs/plugins/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/plugins/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAIzF,qBAAa,OAAQ,YAAW,YAAY;IAC1C,IAAI,SAAa;IACjB,IAAI,oBAA8B;IAKlC,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,SAAK;IACZ,OAAO,SAAkC;IAEzC,KAAK,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAK7C,OAAO,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;CAexC"}

package/lib/cjs/plugins/context.js

@@ -0,0 +1,29 @@
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Context = void 0;
+var tslib_1 = require("tslib");
+var analytics_types_1 = require("@amplitude/analytics-types");
+var analytics_core_1 = require("@amplitude/analytics-core");
+var version_1 = require("../version");
+var Context = /** @class */ (function () {
+    function Context() {
+        this.name = 'context';
+        this.type = analytics_types_1.PluginType.BEFORE;
+        this.eventId = 0;
+        this.library = "amplitude-node-ts/".concat(version_1.VERSION);
+    }
+    Context.prototype.setup = function (config) {
+        this.config = config;
+        return Promise.resolve(undefined);
+    };
+    Context.prototype.execute = function (context) {
+        var _this = this;
+        return new Promise(function (resolve) {
+            var time = new Date().getTime();
+            var contextEvent = (0, tslib_1.__assign)((0, tslib_1.__assign)({ time: time, insert_id: (0, analytics_core_1.UUID)(), plan: _this.config.plan }, context), { event_id: _this.eventId++, library: _this.library });
+            return resolve(contextEvent);
+        });
+    };
+    return Context;
+}());
+exports.Context = Context;
+//# sourceMappingURL=context.js.map

package/lib/cjs/plugins/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/plugins/context.ts"],"names":[],"mappings":";;;AAAA,8DAAyF;AACzF,4DAAiD;AACjD,sCAAqC;AAErC;IAAA;QACE,SAAI,GAAG,SAAS,CAAC;QACjB,SAAI,GAAG,4BAAU,CAAC,MAAe,CAAC;QAMlC,YAAO,GAAG,CAAC,CAAC;QACZ,YAAO,GAAG,4BAAqB,iBAAO,CAAE,CAAC;IAsB3C,CAAC;IApBC,uBAAK,GAAL,UAAM,MAAkB;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAED,yBAAO,GAAP,UAAQ,OAAc;QAAtB,iBAcC;QAbC,OAAO,IAAI,OAAO,CAAC,UAAC,OAAO;YACzB,IAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;YAElC,IAAM,YAAY,iDAChB,IAAI,MAAA,EACJ,SAAS,EAAE,IAAA,qBAAI,GAAE,EACjB,IAAI,EAAE,KAAI,CAAC,MAAM,CAAC,IAAI,IACnB,OAAO,KACV,QAAQ,EAAE,KAAI,CAAC,OAAO,EAAE,EACxB,OAAO,EAAE,KAAI,CAAC,OAAO,GACtB,CAAC;YACF,OAAO,OAAO,CAAC,YAAY,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC;IACH,cAAC;AAAD,CAAC,AA/BD,IA+BC;AA/BY,0BAAO","sourcesContent":["import { BeforePlugin, NodeConfig, Event, PluginType } from '@amplitude/analytics-types';\nimport { UUID } from '@amplitude/analytics-core';\nimport { VERSION } from '../version';\n\nexport class Context implements BeforePlugin {\n  name = 'context';\n  type = PluginType.BEFORE as const;\n\n  // this.config is defined in setup() which will always be called first\n  // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n  // @ts-ignore\n  config: NodeConfig;\n  eventId = 0;\n  library = `amplitude-node-ts/${VERSION}`;\n\n  setup(config: NodeConfig): Promise<undefined> {\n    this.config = config;\n    return Promise.resolve(undefined);\n  }\n\n  execute(context: Event): Promise<Event> {\n    return new Promise((resolve) => {\n      const time = new Date().getTime();\n\n      const contextEvent: Event = {\n        time,\n        insert_id: UUID(),\n        plan: this.config.plan,\n        ...context,\n        event_id: this.eventId++,\n        library: this.library,\n      };\n      return resolve(contextEvent);\n    });\n  }\n}\n"]}

package/lib/cjs/transports/http.d.ts

@@ -0,0 +1,6 @@
+import { Payload, Response, Transport } from '@amplitude/analytics-types';
+import { BaseTransport } from '@amplitude/analytics-core';
+export declare class Http extends BaseTransport implements Transport {
+    send(serverUrl: string, payload: Payload): Promise<Response | null>;
+}
+//# sourceMappingURL=http.d.ts.map

package/lib/cjs/transports/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/transports/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAI1D,qBAAa,IAAK,SAAQ,aAAc,YAAW,SAAS;IAC1D,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;CAiDpE"}