@managani/express 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Helpmonks
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,55 @@
+# @managani/express
+
+Express middleware for Managani activity tracking.
+
+## Install
+
+```bash
+npm install @managani/express
+```
+
+## Usage
+
+```js
+const { managaniTracking } = require('@managani/express');
+
+app.use(managaniTracking({
+	baseUrl: process.env.MANAGANI_URL,
+	projectKey: process.env.MANAGANI_PUBLIC_KEY,
+	projectSecret: process.env.MANAGANI_PROJECT_SECRET,
+	getUser(req) {
+		return req.user;
+	},
+	getMetadata(req) {
+		return {
+			page: req.originalUrl,
+			app_instance: process.env.APP_INSTANCE,
+		};
+	},
+}));
+
+app.post('/checkout', async function(req, res) {
+	await req.managani.track('checkout_started', {
+		metadata: {
+			plan: req.body.plan,
+		},
+	});
+	res.sendStatus(204);
+});
+```
+
+## Request API
+
+The middleware attaches `req.managani`.
+
+### `req.managani.track(event, data, user)`
+
+Tracks an event for the resolved request user, or an explicit user.
+
+### `req.managani.signUser(user)`
+
+Returns a signed widget user token.
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,63 @@
+const { createManaganiClient, signUser, normalizeUser } = require('@managani/node');
+
+function managaniTracking(options) {
+	const config = options || {};
+	const client = createManaganiClient(config);
+	return function managaniTrackingMiddleware(req, res, next) {
+		req.managani = buildRequestApi(client, config, req);
+		if (!config.autoTrack) return next();
+		next();
+		if (!shouldAutoTrack(config, req)) return;
+		req.managani.track(resolveEvent(config, req), resolveMetadata(config, req)).catch(function(error) {
+			const logger = resolveOption(config.logger);
+			if (logger && typeof logger.error === 'function') {
+				logger.error('Managani auto tracking failed:', error.message || error);
+			}
+		});
+	};
+}
+
+function buildRequestApi(client, config, req) {
+	return {
+		client,
+		signUser(user, options) {
+			return client.signUser(user || resolveUser(config, req), options);
+		},
+		track(event, data, user) {
+			return client.track(user || resolveUser(config, req), event, {
+				...resolveMetadata(config, req),
+				...(data || {}),
+			});
+		},
+	};
+}
+
+function shouldAutoTrack(config, req) {
+	if (typeof config.shouldTrack === 'function') return config.shouldTrack(req) !== false;
+	return true;
+}
+
+function resolveUser(config, req) {
+	return typeof config.getUser === 'function' ? config.getUser(req) : req.user;
+}
+
+function resolveEvent(config, req) {
+	if (typeof config.getEvent === 'function') return config.getEvent(req);
+	return req.method === 'GET' ? 'pageview' : 'user_action';
+}
+
+function resolveMetadata(config, req) {
+	const metadata = typeof config.getMetadata === 'function' ? config.getMetadata(req) : {};
+	return metadata || {};
+}
+
+function resolveOption(value) {
+	return typeof value === 'function' ? value() : value;
+}
+
+module.exports = {
+	createManaganiClient,
+	managaniTracking,
+	signUser,
+	normalizeUser,
+};

package/package.json

@@ -0,0 +1,40 @@
+{
+	"name": "@managani/express",
+	"version": "0.1.0",
+	"description": "Express middleware for Managani tracking",
+	"main": "index.js",
+	"type": "commonjs",
+	"license": "MIT",
+	"files": [
+		"index.js",
+		"README.md",
+		"LICENSE"
+	],
+	"keywords": [
+		"managani",
+		"express",
+		"middleware",
+		"tracking",
+		"analytics"
+	],
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/kumbukum/managani.git",
+		"directory": "packages/express"
+	},
+	"bugs": {
+		"url": "https://github.com/kumbukum/managani/issues"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"engines": {
+		"node": ">=18"
+	},
+	"dependencies": {
+		"@managani/node": "^0.1.0"
+	},
+	"peerDependencies": {
+		"express": ">=4"
+	}
+}