conversion-optimizer 1.0.0

package/README.md

@@ -0,0 +1,98 @@
+# Conversion Optimizer
+
+A powerful toolkit for optimizing website conversion rates through A/B testing, analytics, and data-driven optimization strategies. Built as part of the [Popupsmart](https://popupsmart.com) ecosystem.
+
+## Overview
+
+`conversion-optimizer` provides developers with essential utilities to measure, test, and improve website conversion rates. Whether you're optimizing popup campaigns, landing pages, or checkout flows, this package offers the tools you need to make data-informed decisions.
+
+## Installation
+
+```bash
+npm install conversion-optimizer
+```
+
+## Quick Start
+
+```javascript
+const { ConversionOptimizer, ABTest, Analytics } = require('conversion-optimizer');
+
+// Initialize the optimizer
+const optimizer = new ConversionOptimizer({
+  siteId: 'your-site-id',
+  trackingEnabled: true
+});
+
+// Track a conversion event
+optimizer.trackConversion('signup', {
+  value: 29.99,
+  source: 'popup-campaign'
+});
+```
+
+## Key Features
+
+- **A/B Testing Engine** - Create and manage split tests with statistical significance calculations
+- **Conversion Tracking** - Monitor user actions and measure conversion rates across your funnel
+- **Funnel Analysis** - Identify drop-off points and optimize user journeys
+- **Real-time Analytics** - Access live data on campaign performance and user behavior
+- **Popup Integration** - Seamlessly works with Popupsmart campaigns for enhanced optimization
+
+## Usage Examples
+
+### Creating an A/B Test
+
+```javascript
+const test = new ABTest({
+  name: 'popup-headline-test',
+  variants: [
+    { id: 'control', weight: 50 },
+    { id: 'variant-a', weight: 50 }
+  ]
+});
+
+const selectedVariant = test.assignVariant(userId);
+console.log(`User assigned to: ${selectedVariant}`);
+```
+
+### Tracking Funnel Events
+
+```javascript
+const analytics = new Analytics({ siteId: 'your-site-id' });
+
+// Track funnel progression
+analytics.trackFunnelStep('viewed_popup');
+analytics.trackFunnelStep('clicked_cta');
+analytics.trackFunnelStep('completed_signup');
+
+// Get funnel metrics
+const metrics = await analytics.getFunnelMetrics('signup-flow');
+console.log(`Conversion rate: ${metrics.conversionRate}%`);
+```
+
+## Configuration Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `siteId` | string | required | Your unique site identifier |
+| `trackingEnabled` | boolean | `true` | Enable/disable conversion tracking |
+| `cookieDuration` | number | `30` | Days to persist visitor data |
+| `debugMode` | boolean | `false` | Enable verbose logging |
+| `apiEndpoint` | string | `null` | Custom API endpoint for data collection |
+
+```javascript
+const optimizer = new ConversionOptimizer({
+  siteId: 'your-site-id',
+  trackingEnabled: true,
+  cookieDuration: 60,
+  debugMode: process.env.NODE_ENV === 'development'
+});
+```
+
+## About Popupsmart
+
+This package is part of the [Popupsmart](https://popupsmart.com) ecosystem — a no-code popup builder and conversion optimization platform trusted by thousands of businesses to increase leads, sales, and engagement.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

package/index.js

@@ -0,0 +1,27 @@
+/**
+ * conversion-optimizer
+ * Tools and utilities for optimizing website conversion rates
+ *
+ * @module conversion-optimizer
+ * @author Popupsmart
+ * @license MIT
+ */
+
+module.exports = {
+  name: 'conversion-optimizer',
+  version: '1.0.0',
+  description: 'Tools and utilities for optimizing website conversion rates',
+  homepage: 'https://popupsmart.com',
+
+  /**
+   * Initialize the package
+   * @returns {Object} Package information
+   */
+  init: function() {
+    return {
+      name: this.name,
+      version: this.version,
+      homepage: this.homepage
+    };
+  }
+};

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "conversion-optimizer",
+  "version": "1.0.0",
+  "description": "Tools and utilities for optimizing website conversion rates",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/popupsmart/conversion-optimizer.git"
+  },
+  "homepage": "https://popupsmart.com",
+  "keywords": [
+    "popup",
+    "marketing",
+    "conversion",
+    "popupsmart",
+    "conversion",
+    "optimizer"
+  ],
+  "author": "Popupsmart",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/popupsmart/conversion-optimizer/issues"
+  }
+}