feat(infra): enhance server infrastructure with Redis connection pool and observability stack

package.json

@@ -20,6 +20,8 @@
     "packages/devreact",
     "packages/devexpo",
     "packages/devreactnative",
+    "packages/analytics-server",
+    "packages/analytics-client",
     "packages/devnext",
     "packages/deve2e",
     "packages/playground-next"

packages/analytics-client/README.md

@@ -0,0 +1 @@
+# analytics-client

packages/analytics-client/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@metamask/sdk-analytics-client",
+  "packageManager": "[email protected]",
+  "scripts": {
+    "build": "echo 'Na'",
+    "build:dev": "echo 'Na'",
+    "dev": "echo 'Na'",
+    "build:post-tsc": "echo 'Na'",
+    "build:pre-tsc": "echo 'Na'",
+    "size": "echo 'Na'",
+    "clean": "echo 'Na'",
+    "lint": "echo 'Na'",
+    "lint:changelog": "echo 'Na'",
+    "lint:eslint": "echo 'Na'",
+    "lint:fix": "echo 'Na'",
+    "lint:misc": "echo 'Na'",
+    "publish:preview": "echo 'Na'",
+    "prepack": "echo 'Na'",
+    "reset": "echo 'Na'",
+    "test": "echo 'Na'",
+    "test:e2e": "echo 'Na'",
+    "test:coverage": "echo 'Na'",
+    "test:ci": "echo 'Na'",
+    "test:dev": "echo 'Na'",
+    "watch": "echo 'Na'"
+  }
+}

packages/analytics-server/.eslintignore

@@ -0,0 +1,4 @@
+dist/
+node_modules/
+*.js
+*.d.ts 

packages/analytics-server/.eslintrc.js

@@ -0,0 +1,19 @@
+module.exports = {
+  root: true,
+  parser: '@typescript-eslint/parser',
+  plugins: ['@typescript-eslint'],
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended',
+    'prettier',
+  ],
+  env: {
+    node: true,
+    es6: true,
+  },
+  rules: {
+    '@typescript-eslint/explicit-module-boundary-types': 'off',
+    '@typescript-eslint/no-explicit-any': 'warn',
+    '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+  },
+}; 

packages/analytics-server/.gitignore

@@ -0,0 +1,29 @@
+# Dependencies
+node_modules/
+yarn.lock
+package-lock.json
+
+# Build output
+dist/
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db 

packages/analytics-server/.prettierignore

@@ -0,0 +1,7 @@
+dist/
+node_modules/
+*.js
+*.d.ts
+package.json
+package-lock.json
+yarn.lock 

packages/analytics-server/.prettierrc

@@ -0,0 +1,7 @@
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 100,
+  "tabWidth": 2
+} 

packages/analytics-server/Dockerfile

@@ -0,0 +1,33 @@
+# Build stage
+FROM node:18-alpine AS builder
+
+# Install build dependencies and build the project
+WORKDIR /app
+COPY package.json ./
+RUN yarn install
+COPY . .
+RUN yarn build
+
+# Runtime stage
+FROM node:18-alpine
+
+# Install runtime dependencies
+WORKDIR /app
+COPY --from=builder /app/package.json ./
+RUN yarn install --production
+
+# Copy built project and .env file from the build stage
+COPY --from=builder /app/dist ./dist
+# Do not copy .env file, it should be mounted separately
+# COPY .env ./
+
+# Expose the server port
+EXPOSE 2002
+
+# Start the server
+CMD ["node", "dist/src/index.js"]
+#  CMD ["sh", "-c", "DEBUG= node dist/index.js"]
+
+# Start the server with DEBUG mode enabled
+# CMD ["sh", "-c", "DEBUG=socket.io-redis-streams-adapter node dist/index.js"]
+#  CMD ["sh", "-c", "DEBUG=socket.io-redis node dist/index.js"]

packages/analytics-server/README.md

@@ -0,0 +1,53 @@
+# @metamask/analytics-server
+
+Analytics server for MetaMask SDK.
+
+## Prerequisites
+
+- Node.js
+- Yarn
+- Docker (Optional, for containerized deployment)
+
+## Local Development
+
+1.  **Install Dependencies:**
+    ```bash
+    yarn install
+    ```
+2.  **Configure Environment:**
+    Copy `.env.sample` (if it exists, otherwise create `.env`) and fill in the necessary environment variables.
+3.  **Build the Code:**
+    ```bash
+    yarn build
+    ```
+4.  **Run the Server:**
+    *   For production mode (uses compiled code):
+        ```bash
+        yarn start
+        ```
+    *   For development mode (uses ts-node):
+        ```bash
+        yarn dev
+        ```
+
+The server will typically run on the port specified in your `.env` file (defaulting to 2002 if not set).
+
+## Running with Docker
+
+1.  **Build the Docker Image:**
+    ```bash
+    docker build -t metamask/analytics-server .
+    ```
+2.  **Run the Docker Container:**
+    Make sure to provide the necessary environment variables, for example by using an `.env` file and the `--env-file` flag.
+    ```bash
+    docker run -p 2002:2002 --env-file .env metamask/analytics-server
+    ```
+    *   Replace `2002:2002` if the server uses a different port.
+    *   The container exposes port 2002 by default.
+
+## Configuration
+
+The server is configured using environment variables. These can be placed in a `.env` file in the root directory for local development. See `.env.sample` (if available) for required variables.
+
+When running with Docker, environment variables should be passed to the container (e.g., using `--env-file` or `-e` flags).

packages/analytics-server/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@metamask/analytics-server",
+  "version": "1.0.0",
+  "private": true,
+  "description": "Analytics server for MetaMask SDK",
+  "main": "dist/src/index.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/src/index.js",
+    "dev": "ts-node src/index.ts",
+    "lint": "eslint . --ext .ts",
+    "lint:fix": "eslint . --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "typecheck": "tsc --noEmit",
+    "allow-scripts": "allow-scripts"
+  },
+  "dependencies": {
+    "analytics-node": "^6.2.0",
+    "body-parser": "^1.20.2",
+    "cors": "^2.8.5",
+    "dotenv": "^16.3.1",
+    "express": "^4.18.2",
+    "express-rate-limit": "^7.1.5",
+    "helmet": "^5.1.1",
+    "ioredis": "^5.6.0",
+    "winston": "^3.11.0"
+  },
+  "devDependencies": {
+    "@lavamoat/allow-scripts": "^2.3.1",
+    "@types/analytics-node": "^3.1.13",
+    "@types/body-parser": "^1.19.4",
+    "@types/cors": "^2.8.15",
+    "@types/express": "^4.17.20",
+    "@types/node": "^20.4.1",
+    "@typescript-eslint/eslint-plugin": "^4.20.0",
+    "@typescript-eslint/parser": "^4.20.0",
+    "eslint": "^7.30.0",
+    "eslint-config-prettier": "^8.3.0",
+    "eslint-plugin-prettier": "^3.4.0",
+    "prettier": "^2.8.8",
+    "ts-node": "^10.9.1",
+    "typescript": "^4.3.2"
+  }
+}