@imrankhanjoya/visit-analytics 1.0.0 → 1.0.1

package/README.md

@@ -0,0 +1,119 @@
+# @imrankhanjoya/visit-analytics
+
+Simple MongoDB and Mongoose-based visit analytics package for Next.js and Node.js applications.
+
+Track page visits, profile visits, post visits, unique visitors, and retrieve visitor details with minimal setup.
+
+## Installation
+
+bash npm install @imrankhanjoya/visit-analytics 
+
+or
+
+bash pnpm add @imrankhanjoya/visit-analytics 
+
+## Prerequisites
+
+Install Mongoose and connect to MongoDB before using this package.
+
+bash npm install mongoose 
+
+javascript import mongoose from "mongoose";  await mongoose.connect(process.env.MONGODB_URI); 
+
+---
+
+# Exports
+
+The package exports:
+
+javascript import {   Visit,   saveVisit,   getVisits,   getVisitMembers, } from "@imrankhanjoya/visit-analytics"; 
+
+## Visit Model
+
+A ready-to-use Mongoose model.
+
+javascript import { Visit } from "@imrankhanjoya/visit-analytics";  const visits = await Visit.find(); 
+
+---
+
+## saveVisit()
+
+Create or record a visit.
+
+### Example
+
+javascript import { saveVisit } from "@imrankhanjoya/visit-analytics";  await saveVisit({   path: "john-doe",   type: "profile",   token: "visitor-token",   ip: "127.0.0.1",   userinfo: [     {       username: "imran",       image: "https://example.com/profile.jpg",     },   ], }); 
+
+### Parameters
+
+| Property | Type | Required |
+|----------|------|----------|
+| path | string | Yes |
+| type | string | Yes |
+| token | string | Yes |
+| ip | string | No |
+| userinfo | array | No |
+
+---
+
+## getVisits()
+
+Returns total visits for a path.
+
+### Example
+
+javascript import { getVisits } from "@imrankhanjoya/visit-analytics";  const totalVisits = await getVisits(   "john-doe",   "profile" );  console.log(totalVisits); 
+
+### Response
+
+javascript 25 
+
+---
+
+## getVisitMembers()
+
+Returns visitor records for a path.
+
+### Example
+
+javascript import { getVisitMembers } from "@imrankhanjoya/visit-analytics";  const visitors = await getVisitMembers(   "john-doe",   "profile" );  console.log(visitors); 
+
+### Example Response
+
+javascript [   {     token: "abc123",     path: "john-doe",     type: "profile",     ip: "127.0.0.1",     userinfo: [       {         username: "imran"       }     ]   } ] 
+
+---
+
+# Next.js Example
+
+## Record Visit
+
+javascript import { saveVisit } from "@imrankhanjoya/visit-analytics";  export async function POST(request) {   const body = await request.json();    await saveVisit({     path: body.path,     type: body.type,     token: body.token,     ip: body.ip,   });    return Response.json({     success: true,   }); } 
+
+## Get Visit Count
+
+javascript import { getVisits } from "@imrankhanjoya/visit-analytics";  const count = await getVisits(   "john-doe",   "profile" ); 
+
+---
+
+# Supported Types
+
+javascript "profile" "post" "page" "custom" 
+
+---
+
+# Visit Document Structure
+
+javascript {   token: "visitor-token",   path: "john-doe",   type: "profile",   ip: "127.0.0.1",   date: "2026-06-05",   userinfo: [],   createdAt: Date,   updatedAt: Date } 
+
+---
+
+# License
+
+MIT
+
+# Author
+
+Imran Khan
+
+Package: @imrankhanjoya/visit-analytics

package/package.json

@@ -1,13 +1,16 @@
 {
   "name": "@imrankhanjoya/visit-analytics",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "",
-  "main": "index.js",
+  "main": "./src/index.js",
+  "exports": {
+    ".": "./src/index.js"
+  },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "keywords": [],
   "author": "",
   "license": "ISC",
-  "type": "commonjs"
+  "type": "module"
 }

package/src/index.js

@@ -1,2 +1,5 @@
+export { default as Visit } from "./models/Visit.js";
 
-export { saveVisit, getVisits } from "./trackVisit.js";
+export {
+  getVisits, saveVisit, getVisitMembers
+} from "./trackVisit.js";

package/src/trackVisit.js

@@ -1,14 +1,12 @@
-const Visit = require("./models/Visit"); 
-
+import Visit from "./models/Visit.js"
 
 export const saveVisit = async (visitData) => {
   try {
-    const data = {token:token,ip:headersList,path:path,type:type,date:date,userinfo:[{username:username,image:image}]};
 
-    console.log("Visit saved successfully");
     try{
-    const val = await Visits.create(data)
-        return val
+
+      const val = await Visit.create(visitData)
+      return val
     }catch(e){
         return e
     }
@@ -20,9 +18,56 @@ export const saveVisit = async (visitData) => {
 export const getVisits = async (path) => {
   try {
     const visits = await Visit.find({ path }).sort({ date: -1 });
-    return visits;
+    return {visits, count: visits.length};
   } catch (error) {
     console.error("Error retrieving visits:", error);
+    return {visits: [], count: 0};
+  }
+}
+
+
+export const getVisitMembers = async (path,type) => {
+  
+  const data = {path:path,type:type}
+
+
+  
+  
+  try{
+    const val = await Visit.aggregate([
+      { $match: data },
+      { $unwind: "$userinfo" },
+      { $match: { "userinfo.username": { $exists: true, $ne: "" } } },
+      { $sort: { createdAt: -1 } },
+      { $group: {
+          _id: "$userinfo.username",
+          userinfo: { $first: "$userinfo" },
+          createdAt: { $first: "$createdAt" }
+        }
+      },
+      { $project: {
+          _id: 0,
+          userinfo: 1,
+          createdAt: 1
+        }
+      },
+      { $sort: { createdAt: -1 } },
+      { $limit: 10 }
+    ]).exec();
+    
+    // Add anonymous user entry with pixel art image from text
+    const anonymousImageUrl = `https://api.dicebear.com/7.x/pixel-art/svg?seed=anonymous`;
+    val.push({
+      userinfo: {
+        username: "anonymous",
+        image: anonymousImageUrl
+      },
+      createdAt: new Date()
+    });
+    
+    return val;
+  }catch(e){
     return [];
+
   }
 }