datavault-analytics v0.0.5-Alpha

DataVault Analytics 🔍

(WORK IN PROGRESS - UNSTABLE)

Privacy-focused analytics solution with server-side logging and client-side tracking capabilities.

Features

• 🛡️ Privacy-first approach with cookie consent tracking
• 📊 Pageview and event tracking
• ⚡ Real-time performance metrics
• 📈 PostgreSQL-based storage
• 🔒 Secure middleware with rate limiting and helmet
• 📝 Comprehensive logging with Winston
• 🩺 Health check endpoints

Installation

npm install datavault-analytics
# or
yarn add datavault-analytics

Configuration

Set these environment variables in your .env file:

DATABASE_URL=postgres://user:password@host:port/database
NODE_ENV=production
LOG_DIR=/var/log/dataforge
SERVICE_NAME=my-web-app

Usage

Server-side Setup

const express = require('express');
const DataForge = require('dataforge-analytics');

const app = express();

// Initialize DataForge analytics
DataForge(app);

app.listen(3000, () => {
  console.log('Server running on port 3000');
});

Client-side Integration

Add this script to your HTML:

<script src="/dataforge/analytics/static/v1/dataforge-client.js"></script>

Event Tracking

Track events using HTML data attributes:

<button data-track-event 
        data-event-name="download"
        data-event-category="engagement">
  Download Now
</button>

Or track events programmatically:

window.trackEvent('purchase', 'ecommerce', {
  product_id: '123',
  value: 49.99
});

API Endpoints

Logging

Logs are stored in daily rotated files:

logs/
  error-2023-01-01.log
  combined-2023-01-01.log
  exceptions-2023-01-01.log

Environment Variables

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

GNU AFFERO GENERAL PUBLIC LICENSE © Tetrachrome Studios