@classytic/promo

Promotions engine for MongoDB — discount codes, vouchers, cashback, BOGO, and rule-based pricing.

Framework-agnostic. Works with Fastify (Arc), Express, NestJS, Next.js, or any Node.js app with a Mongoose connection.

Install

npm install @classytic/promo
# Peer deps:
npm install mongoose@^9 @classytic/mongokit@^3.5

Quick Start

import { createPromoEngine } from '@classytic/promo';
import mongoose from 'mongoose';

const engine = createPromoEngine({
  mongoose: mongoose.connection,
  tenant: { field: 'organizationId' }, // multi-tenant (or false for single)
});

// Create a discount program
const program = await engine.services.program.create({
  name: 'Summer Sale',
  type: 'discount_code',
  startsAt: new Date(),
}, ctx);

// Evaluate cart against active promotions
const result = await engine.services.evaluation.evaluate({
  cart: { items, subtotal },
}, ctx);

License

MIT