ainamika-sdk 1.3.1 → 1.3.2

package/README.md

@@ -372,6 +372,92 @@ const analytics = new AInamikaSDK({
 });
 ```
 
+## Enterprise Self-Hosted Configuration
+
+AInamika supports **Enterprise Self-Hosted deployments** for organizations that need to keep analytics data within their own infrastructure. When your organization has enterprise mode enabled, configure the SDK to point to your self-hosted instance:
+
+### Configuring for Enterprise Mode
+
+```javascript
+const analytics = new AInamikaSDK({
+  projectKey: 'proj_xxxxxxxxxx',
+  projectSecret: 'your_secret_here',
+  autoConfig: true,
+
+  // Enterprise endpoint configuration
+  apiDetails: {
+    // Replace with your enterprise instance URL
+    apiEndPoint: 'https://your-enterprise-instance.com/api/v1/events',
+
+    // Optional: Add any custom headers required by your instance
+    headers: {
+      'X-Enterprise-Token': 'your-enterprise-token'
+    }
+  }
+});
+```
+
+### Enterprise Mode Features
+
+When using enterprise mode:
+- **Data Privacy**: All analytics data stays within your infrastructure
+- **Custom Domains**: Use your own domain for SDK endpoints
+- **Network Isolation**: Can work in air-gapped environments
+- **Full Control**: Manage data retention, backups, and compliance
+
+### How to Get Your Enterprise Endpoint
+
+1. **From Dashboard**: If your admin has enabled enterprise mode, you'll see the endpoint URL in the project settings
+2. **From IT Team**: Your IT/DevOps team who deployed the enterprise instance will provide:
+   - The ingestion endpoint URL (e.g., `https://analytics.yourcompany.com/api/v1/events`)
+   - Any required authentication headers
+3. **Default Ports**:
+   - Ingestion API: Usually port 5000 or 8080
+   - Query API: Usually port 5001 or 8080
+
+### Example Configurations
+
+**Docker Deployment:**
+```javascript
+// For Docker deployments on local network
+apiEndPoint: 'http://192.168.1.100:5000/api/v1/events'
+```
+
+**Kubernetes with Ingress:**
+```javascript
+// For K8s deployments with ingress
+apiEndPoint: 'https://analytics.yourcompany.com/api/v1/events'
+```
+
+**Behind VPN:**
+```javascript
+// For instances behind corporate VPN
+apiEndPoint: 'https://analytics.internal.company.net/api/v1/events'
+```
+
+### Verifying Enterprise Connection
+
+To verify your SDK is correctly configured for enterprise:
+
+1. **Check Network Tab**: Events should go to your enterprise endpoint, not `api.ainamika.io`
+2. **Check Response**: Should return 200 OK with `{"success": true}`
+3. **Dashboard**: Login to AInamika dashboard - it will show "Enterprise Mode: Active" when enabled
+
+### Fallback Behavior
+
+If enterprise endpoint is unreachable:
+- Events are queued locally (up to `maxEventsInQueue` limit)
+- SDK retries with exponential backoff
+- No data is sent to AInamika cloud servers
+- Events are eventually dropped if queue fills up
+
+### Security Considerations
+
+- **HTTPS Required**: Always use HTTPS in production
+- **Firewall Rules**: Ensure your app can reach the enterprise endpoint
+- **Authentication**: Use the same `projectKey` and `projectSecret` as cloud mode
+- **Network Policies**: May need to whitelist the enterprise instance in corporate networks
+
 ## Extra Config & Page Context
 
 Every event automatically includes **page context** (URL, path, query params, referrer) and any **extra config** you provide.
@@ -775,6 +861,5 @@ MIT License - see [LICENSE](LICENSE) for details.
 
 ## Support
 
-- Documentation: [https://ainamika.netlify.app/about.html](https://ainamika.netlify.app/about.html)
-- Issues: [https://github.com/adarshsingh/ainamika-sdk/issues](https://github.com/adarshsingh/ainamika-sdk/issues)
-- Email: adarshsingh061295@gmail.com
+- Documentation: [https://ainamika.com/about.html](https://ainamika.com/about.html)
+- Email: thefounder@ainamika.com

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ainamika-sdk",
-  "version": "1.3.1",
+  "version": "1.3.2",
   "description": "AI-powered analytics SDK with Web Vitals, engagement tracking, error monitoring, and real-time insights for web applications",
   "main": "dist/ainamika-sdk.js",
   "types": "dist/sdk.d.ts",
@@ -45,7 +45,7 @@
     "type": "git",
     "url": "https://github.com/adarshsingh/ainamika-sdk.git"
   },
-  "homepage": "https://ainamika.netlify.app/about.html",
+  "homepage": "https://ainamika.com/about.html",
   "bugs": {
     "url": "https://github.com/adarshsingh/ainamika-sdk/issues"
   },