@reyaxyz/athena-logger 0.2.2 → 0.2.3

package/README.md

@@ -4,6 +4,28 @@
 
 <br />
 
-| Statements                                                                     | Branches                                                                   | Functions                                                                    | Lines                                                                |
-| ------------------------------------------------------------------------------ | -------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | -------------------------------------------------------------------- |
-| ![Statements](https://img.shields.io/badge/statements-0%25-red.svg?style=flat) | ![Branches](https://img.shields.io/badge/branches-100%25-brightgreen.svg?style=flat) | ![Functions](https://img.shields.io/badge/functions-0%25-red.svg?style=flat) | ![Lines](https://img.shields.io/badge/lines-0%25-red.svg?style=flat) |
+## Searching Logs in Datadog
+
+To search logs in Datadog, use the appropriate log tags. The service is customizable. Here are examples for searching user journey actions and errors:
+
+### User Journey Actions
+
+To find user journey actions, search with the tag `athena.user_journey`:
+
+```
+service:<your-service> athena.user_journey @user.walletAddress:<wallet-address>
+
+```
+
+### Errors
+
+To find errors, search with the tag athena.error:
+
+```
+service:test athena.error @user.walletAddress:0x123
+
+```
+
+| Statements                                                                     | Branches                                                                             | Functions                                                                    | Lines                                                                |
+| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------- | -------------------------------------------------------------------- |
+| ![Statements](https://img.shields.io/badge/statements-0%25-red.svg?style=flat) | ![Branches](https://img.shields.io/badge/branches-0%25-red.svg?style=flat) | ![Functions](https://img.shields.io/badge/functions-0%25-red.svg?style=flat) | ![Lines](https://img.shields.io/badge/lines-0%25-red.svg?style=flat) |

package/dist/action.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.action = void 0;
+var browser_logs_1 = require("@datadog/browser-logs");
+var logger_1 = require("./logger");
+var checkWalletAddress_1 = require("./utils/checkWalletAddress");
+var action = function (_a) {
+    var walletAddress = _a.walletAddress, action = _a.action, error = _a.error, message = _a.message, payload = _a.payload;
+    if (!(0, checkWalletAddress_1.isWalletAddressProvided)(walletAddress)) {
+        console.warn('Logger missing wallet address');
+        return;
+    }
+    if (!(0, logger_1.isLoggerInitialized)()) {
+        console.warn('Logger not initialized');
+        return;
+    }
+    browser_logs_1.datadogLogs.logger.info("athena.user_journey/".concat(action).concat(message ? ": ".concat(message) : ''), payload, error);
+};
+exports.action = action;
+//# sourceMappingURL=action.js.map

package/dist/action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.js","sourceRoot":"/","sources":["action.ts"],"names":[],"mappings":";;;AAAA,sDAAoD;AACpD,mCAA+C;AAC/C,iEAAqE;AAU9D,IAAM,MAAM,GAAG,UAAC,EAMG;QALxB,aAAa,mBAAA,EACb,MAAM,YAAA,EACN,KAAK,WAAA,EACL,OAAO,aAAA,EACP,OAAO,aAAA;IAEP,IAAI,CAAC,IAAA,4CAAuB,EAAC,aAAa,CAAC,EAAE,CAAC;QAC5C,OAAO,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC9C,OAAO;IACT,CAAC;IAED,IAAI,CAAC,IAAA,4BAAmB,GAAE,EAAE,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACvC,OAAO;IACT,CAAC;IAED,0BAAW,CAAC,MAAM,CAAC,IAAI,CACrB,8BAAuB,MAAM,SAAG,OAAO,CAAC,CAAC,CAAC,YAAK,OAAO,CAAE,CAAC,CAAC,CAAC,EAAE,CAAE,EAC/D,OAAO,EACP,KAAc,CACf,CAAC;AACJ,CAAC,CAAC;AAtBW,QAAA,MAAM,UAsBjB","sourcesContent":["import { datadogLogs } from '@datadog/browser-logs';\nimport { isLoggerInitialized } from './logger';\nimport { isWalletAddressProvided } from './utils/checkWalletAddress';\n\nexport type UserJourneyActionParams = {\n  walletAddress: string;\n  action: string;\n  error?: Error | unknown;\n  message?: string;\n  payload?: Record<string, unknown>;\n};\n\nexport const action = ({\n  walletAddress,\n  action,\n  error,\n  message,\n  payload,\n}: UserJourneyActionParams) => {\n  if (!isWalletAddressProvided(walletAddress)) {\n    console.warn('Logger missing wallet address');\n    return;\n  }\n\n  if (!isLoggerInitialized()) {\n    console.warn('Logger not initialized');\n    return;\n  }\n\n  datadogLogs.logger.info(\n    `athena.user_journey/${action}${message ? `: ${message}` : ''}`,\n    payload,\n    error as Error,\n  );\n};\n"]}

package/dist/error.js

@@ -0,0 +1,26 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.error = void 0;
+var browser_logs_1 = require("@datadog/browser-logs");
+var logger_1 = require("./logger");
+var error = function (_a) {
+    var action = _a.action, message = _a.message, metadata = _a.metadata, walletAddress = _a.walletAddress, error = _a.error;
+    if (!(0, logger_1.isLoggerInitialized)()) {
+        console.warn('Logger not initialized');
+        return;
+    }
+    browser_logs_1.datadogLogs.logger.error("athena.error/".concat(action).concat(message ? ": ".concat(message) : ''), __assign(__assign({}, metadata), (walletAddress && { user: { walletAddress: walletAddress } })), error);
+};
+exports.error = error;
+//# sourceMappingURL=error.js.map

package/dist/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"/","sources":["error.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,sDAAoD;AACpD,mCAA+C;AAWxC,IAAM,KAAK,GAAG,UAAC,EAML;QALf,MAAM,YAAA,EACN,OAAO,aAAA,EACP,QAAQ,cAAA,EACR,aAAa,mBAAA,EACb,KAAK,WAAA;IAEL,IAAI,CAAC,IAAA,4BAAmB,GAAE,EAAE,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACvC,OAAO;IACT,CAAC;IAED,0BAAW,CAAC,MAAM,CAAC,KAAK,CACtB,uBAAgB,MAAM,SAAG,OAAO,CAAC,CAAC,CAAC,YAAK,OAAO,CAAE,CAAC,CAAC,CAAC,EAAE,CAAE,wBACnD,QAAQ,GAAK,CAAC,aAAa,IAAI,EAAE,IAAI,EAAE,EAAE,aAAa,eAAA,EAAE,EAAE,CAAC,GAChE,KAAc,CACf,CAAC;AACJ,CAAC,CAAC;AAjBW,QAAA,KAAK,SAiBhB","sourcesContent":["import { datadogLogs } from '@datadog/browser-logs';\nimport { isLoggerInitialized } from './logger';\n\ntype LogErrorParams = {\n  action: string;\n  error: unknown;\n  walletAddress?: string;\n  // Optional! If not provided, will try to extract message from Error\n  message?: string;\n  metadata?: Record<string, unknown>;\n};\n\nexport const error = ({\n  action,\n  message,\n  metadata,\n  walletAddress,\n  error,\n}: LogErrorParams) => {\n  if (!isLoggerInitialized()) {\n    console.warn('Logger not initialized');\n    return;\n  }\n\n  datadogLogs.logger.error(\n    `athena.error/${action}${message ? `: ${message}` : ''}`,\n    { ...metadata, ...(walletAddress && { user: { walletAddress } }) },\n    error as Error,\n  );\n};\n"]}

package/dist/index.js

@@ -1,6 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.helloWorld = void 0;
-var helloWorld = function () { return true; };
-exports.helloWorld = helloWorld;
+exports.Athena = void 0;
+var action_1 = require("./action");
+var error_1 = require("./error");
+var logger_1 = require("./logger");
+exports.Athena = {
+    initialize: logger_1.initialize,
+    UserJourney: {
+        action: action_1.action,
+    },
+    Error: {
+        error: error_1.error,
+    },
+};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"/","sources":["index.ts"],"names":[],"mappings":";;;AAAO,IAAM,UAAU,GAAG,cAAM,OAAA,IAAI,EAAJ,CAAI,CAAC;AAAxB,QAAA,UAAU,cAAc","sourcesContent":["export const helloWorld = () => true;\n"]}
+{"version":3,"file":"index.js","sourceRoot":"/","sources":["index.ts"],"names":[],"mappings":";;;AAAA,mCAAkC;AAClC,iCAAgC;AAChC,mCAAsC;AAEzB,QAAA,MAAM,GAAG;IACpB,UAAU,qBAAA;IACV,WAAW,EAAE;QACX,MAAM,iBAAA;KACP;IACD,KAAK,EAAE;QACL,KAAK,eAAA;KACN;CACF,CAAC","sourcesContent":["import { action } from './action';\nimport { error } from './error';\nimport { initialize } from './logger';\n\nexport const Athena = {\n  initialize,\n  UserJourney: {\n    action,\n  },\n  Error: {\n    error,\n  },\n};\n"]}

package/dist/logger.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLoggingAllowed = exports.isLoggerInitialized = exports.initialize = void 0;
+var browser_logs_1 = require("@datadog/browser-logs");
+var initialized = false;
+var allowLogging = false;
+var initialize = function (_a) {
+    var clientToken = _a.clientToken, environment = _a.environment, service = _a.service, version = _a.version;
+    var isLocalhost = environment === 'localhost';
+    if (!environment || !clientToken || !service || !version) {
+        initialized = false;
+        allowLogging = false;
+        return;
+    }
+    if (isLocalhost) {
+        initialized = true;
+        allowLogging = false;
+        return;
+    }
+    try {
+        browser_logs_1.datadogLogs.init({
+            clientToken: clientToken,
+            env: environment,
+            service: service,
+            sessionSampleRate: 100,
+            site: 'datadoghq.eu',
+            forwardConsoleLogs: ['error'],
+            forwardErrorsToLogs: true,
+            version: version,
+        });
+        initialized = true;
+        allowLogging = true;
+    }
+    catch (err) {
+        initialized = false;
+        allowLogging = false;
+    }
+};
+exports.initialize = initialize;
+var isLoggerInitialized = function () { return initialized; };
+exports.isLoggerInitialized = isLoggerInitialized;
+var isLoggingAllowed = function () { return allowLogging; };
+exports.isLoggingAllowed = isLoggingAllowed;
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"/","sources":["logger.ts"],"names":[],"mappings":";;;AAAA,sDAAoD;AAEpD,IAAI,WAAW,GAAG,KAAK,CAAC;AACxB,IAAI,YAAY,GAAG,KAAK,CAAC;AASlB,IAAM,UAAU,GAAG,UAAC,EAKR;QAJjB,WAAW,iBAAA,EACX,WAAW,iBAAA,EACX,OAAO,aAAA,EACP,OAAO,aAAA;IAEP,IAAM,WAAW,GAAG,WAAW,KAAK,WAAW,CAAC;IAChD,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;QACzD,WAAW,GAAG,KAAK,CAAC;QACpB,YAAY,GAAG,KAAK,CAAC;QACrB,OAAO;IACT,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,WAAW,GAAG,IAAI,CAAC;QACnB,YAAY,GAAG,KAAK,CAAC;QACrB,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,0BAAW,CAAC,IAAI,CAAC;YACf,WAAW,aAAA;YACX,GAAG,EAAE,WAAW;YAChB,OAAO,SAAA;YACP,iBAAiB,EAAE,GAAG;YACtB,IAAI,EAAE,cAAc;YACpB,kBAAkB,EAAE,CAAC,OAAO,CAAC;YAC7B,mBAAmB,EAAE,IAAI;YACzB,OAAO,SAAA;SACR,CAAC,CAAC;QAEH,WAAW,GAAG,IAAI,CAAC;QACnB,YAAY,GAAG,IAAI,CAAC;IACtB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,WAAW,GAAG,KAAK,CAAC;QACpB,YAAY,GAAG,KAAK,CAAC;IACvB,CAAC;AACH,CAAC,CAAC;AArCW,QAAA,UAAU,cAqCrB;AAEK,IAAM,mBAAmB,GAAG,cAAM,OAAA,WAAW,EAAX,CAAW,CAAC;AAAxC,QAAA,mBAAmB,uBAAqB;AAC9C,IAAM,gBAAgB,GAAG,cAAM,OAAA,YAAY,EAAZ,CAAY,CAAC;AAAtC,QAAA,gBAAgB,oBAAsB","sourcesContent":["import { datadogLogs } from '@datadog/browser-logs';\n\nlet initialized = false;\nlet allowLogging = false;\n\ntype InitializeParams = {\n  clientToken: string;\n  environment: string;\n  service: string;\n  version: string;\n};\n\nexport const initialize = ({\n  clientToken,\n  environment,\n  service,\n  version,\n}: InitializeParams) => {\n  const isLocalhost = environment === 'localhost';\n  if (!environment || !clientToken || !service || !version) {\n    initialized = false;\n    allowLogging = false;\n    return;\n  }\n\n  if (isLocalhost) {\n    initialized = true;\n    allowLogging = false;\n    return;\n  }\n\n  try {\n    datadogLogs.init({\n      clientToken,\n      env: environment,\n      service,\n      sessionSampleRate: 100,\n      site: 'datadoghq.eu',\n      forwardConsoleLogs: ['error'],\n      forwardErrorsToLogs: true,\n      version,\n    });\n\n    initialized = true;\n    allowLogging = true;\n  } catch (err) {\n    initialized = false;\n    allowLogging = false;\n  }\n};\n\nexport const isLoggerInitialized = () => initialized;\nexport const isLoggingAllowed = () => allowLogging;\n"]}

package/dist/types/action.d.ts

@@ -0,0 +1,9 @@
+export type UserJourneyActionParams = {
+    walletAddress: string;
+    action: string;
+    error?: Error | unknown;
+    message?: string;
+    payload?: Record<string, unknown>;
+};
+export declare const action: ({ walletAddress, action, error, message, payload, }: UserJourneyActionParams) => void;
+//# sourceMappingURL=action.d.ts.map

package/dist/types/action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"/","sources":["action.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,uBAAuB,GAAG;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF,eAAO,MAAM,MAAM,wDAMhB,uBAAuB,SAgBzB,CAAC"}

package/dist/types/error.d.ts

@@ -0,0 +1,10 @@
+type LogErrorParams = {
+    action: string;
+    error: unknown;
+    walletAddress?: string;
+    message?: string;
+    metadata?: Record<string, unknown>;
+};
+export declare const error: ({ action, message, metadata, walletAddress, error, }: LogErrorParams) => void;
+export {};
+//# sourceMappingURL=error.d.ts.map

package/dist/types/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"/","sources":["error.ts"],"names":[],"mappings":"AAGA,KAAK,cAAc,GAAG;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,eAAO,MAAM,KAAK,yDAMf,cAAc,SAWhB,CAAC"}

package/dist/types/index.d.ts

@@ -1,2 +1,21 @@
-export declare const helloWorld: () => boolean;
+export declare const Athena: {
+    initialize: ({ clientToken, environment, service, version, }: {
+        clientToken: string;
+        environment: string;
+        service: string;
+        version: string;
+    }) => void;
+    UserJourney: {
+        action: ({ walletAddress, action, error, message, payload, }: import("./action").UserJourneyActionParams) => void;
+    };
+    Error: {
+        error: ({ action, message, metadata, walletAddress, error, }: {
+            action: string;
+            error: unknown;
+            walletAddress?: string | undefined;
+            message?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        }) => void;
+    };
+};
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"/","sources":["index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,eAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"/","sources":["index.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;CAQlB,CAAC"}

package/dist/types/logger.d.ts

@@ -0,0 +1,11 @@
+type InitializeParams = {
+    clientToken: string;
+    environment: string;
+    service: string;
+    version: string;
+};
+export declare const initialize: ({ clientToken, environment, service, version, }: InitializeParams) => void;
+export declare const isLoggerInitialized: () => boolean;
+export declare const isLoggingAllowed: () => boolean;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/types/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"/","sources":["logger.ts"],"names":[],"mappings":"AAKA,KAAK,gBAAgB,GAAG;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,UAAU,oDAKpB,gBAAgB,SAgClB,CAAC;AAEF,eAAO,MAAM,mBAAmB,eAAoB,CAAC;AACrD,eAAO,MAAM,gBAAgB,eAAqB,CAAC"}

package/dist/types/utils/checkWalletAddress/index.d.ts

@@ -0,0 +1,2 @@
+export declare const isWalletAddressProvided: (walletAddress: string) => boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/utils/checkWalletAddress/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"/","sources":["utils/checkWalletAddress/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,kBAAmB,MAAM,YACrC,CAAC"}

package/dist/utils/checkWalletAddress/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isWalletAddressProvided = void 0;
+var isWalletAddressProvided = function (walletAddress) {
+    return Boolean(walletAddress);
+};
+exports.isWalletAddressProvided = isWalletAddressProvided;
+//# sourceMappingURL=index.js.map

package/dist/utils/checkWalletAddress/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"/","sources":["utils/checkWalletAddress/index.ts"],"names":[],"mappings":";;;AAAO,IAAM,uBAAuB,GAAG,UAAC,aAAqB;IAC3D,OAAA,OAAO,CAAC,aAAa,CAAC;AAAtB,CAAsB,CAAC;AADZ,QAAA,uBAAuB,2BACX","sourcesContent":["export const isWalletAddressProvided = (walletAddress: string) =>\n  Boolean(walletAddress);\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reyaxyz/athena-logger",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
@@ -35,6 +35,12 @@
   "dependencies": {
     "@reyaxyz/common": "0.113.0"
   },
+  "devDependencies": {
+    "@datadog/browser-logs": "5.17.1"
+  },
+  "peerDependencies": {
+    "@datadog/browser-logs": "5.17.1"
+  },
   "packageManager": "pnpm@8.3.1",
-  "gitHead": "21d078afc658b56f6bfa4fd352a3bf7016ddb369"
+  "gitHead": "77a1eef6477ba500889cdda36143544126cf1840"
 }

package/src/action.ts

@@ -0,0 +1,35 @@
+import { datadogLogs } from '@datadog/browser-logs';
+import { isLoggerInitialized } from './logger';
+import { isWalletAddressProvided } from './utils/checkWalletAddress';
+
+export type UserJourneyActionParams = {
+  walletAddress: string;
+  action: string;
+  error?: Error | unknown;
+  message?: string;
+  payload?: Record<string, unknown>;
+};
+
+export const action = ({
+  walletAddress,
+  action,
+  error,
+  message,
+  payload,
+}: UserJourneyActionParams) => {
+  if (!isWalletAddressProvided(walletAddress)) {
+    console.warn('Logger missing wallet address');
+    return;
+  }
+
+  if (!isLoggerInitialized()) {
+    console.warn('Logger not initialized');
+    return;
+  }
+
+  datadogLogs.logger.info(
+    `athena.user_journey/${action}${message ? `: ${message}` : ''}`,
+    payload,
+    error as Error,
+  );
+};

package/src/error.ts

@@ -0,0 +1,30 @@
+import { datadogLogs } from '@datadog/browser-logs';
+import { isLoggerInitialized } from './logger';
+
+type LogErrorParams = {
+  action: string;
+  error: unknown;
+  walletAddress?: string;
+  // Optional! If not provided, will try to extract message from Error
+  message?: string;
+  metadata?: Record<string, unknown>;
+};
+
+export const error = ({
+  action,
+  message,
+  metadata,
+  walletAddress,
+  error,
+}: LogErrorParams) => {
+  if (!isLoggerInitialized()) {
+    console.warn('Logger not initialized');
+    return;
+  }
+
+  datadogLogs.logger.error(
+    `athena.error/${action}${message ? `: ${message}` : ''}`,
+    { ...metadata, ...(walletAddress && { user: { walletAddress } }) },
+    error as Error,
+  );
+};

package/src/index.ts

@@ -1 +1,13 @@
-export const helloWorld = () => true;
+import { action } from './action';
+import { error } from './error';
+import { initialize } from './logger';
+
+export const Athena = {
+  initialize,
+  UserJourney: {
+    action,
+  },
+  Error: {
+    error,
+  },
+};

package/src/logger.ts

@@ -0,0 +1,53 @@
+import { datadogLogs } from '@datadog/browser-logs';
+
+let initialized = false;
+let allowLogging = false;
+
+type InitializeParams = {
+  clientToken: string;
+  environment: string;
+  service: string;
+  version: string;
+};
+
+export const initialize = ({
+  clientToken,
+  environment,
+  service,
+  version,
+}: InitializeParams) => {
+  const isLocalhost = environment === 'localhost';
+  if (!environment || !clientToken || !service || !version) {
+    initialized = false;
+    allowLogging = false;
+    return;
+  }
+
+  if (isLocalhost) {
+    initialized = true;
+    allowLogging = false;
+    return;
+  }
+
+  try {
+    datadogLogs.init({
+      clientToken,
+      env: environment,
+      service,
+      sessionSampleRate: 100,
+      site: 'datadoghq.eu',
+      forwardConsoleLogs: ['error'],
+      forwardErrorsToLogs: true,
+      version,
+    });
+
+    initialized = true;
+    allowLogging = true;
+  } catch (err) {
+    initialized = false;
+    allowLogging = false;
+  }
+};
+
+export const isLoggerInitialized = () => initialized;
+export const isLoggingAllowed = () => allowLogging;

package/src/utils/checkWalletAddress/index.ts

@@ -0,0 +1,2 @@
+export const isWalletAddressProvided = (walletAddress: string) =>
+  Boolean(walletAddress);