@classytic/loyalty 0.4.0 → 0.6.0

package/dist/models/index.mjs

@@ -1,2 +1,2 @@
-import { n as createModels, t as LoyaltyModelCollisionError } from "../models-Ddh62lgO.mjs";
-export { LoyaltyModelCollisionError, createModels };
+import { t as defineLoyaltyModels } from "../models-weWqS5Bc.mjs";
+export { defineLoyaltyModels };

package/dist/{models-Ddh62lgO.mjs → models-weWqS5Bc.mjs}

@@ -1,5 +1,7 @@
-import { a as MEMBER_STATUSES, c as RULE_STATUSES, l as RULE_TYPES, o as REDEMPTION_STATUSES, s as REFERRAL_STATUSES, u as TRANSACTION_TYPES } from "./constants-DkQYkOK1.mjs";
+import { a as REFERRAL_STATUSES, c as TRANSACTION_TYPES, i as REDEMPTION_STATUSES, o as RULE_STATUSES, r as MEMBER_STATUSES, s as RULE_TYPES } from "./constants-DOPBh6kt.mjs";
+import { defineModels } from "@classytic/mongokit";
 import mongoose from "mongoose";
+import { mongooseMinorUnits } from "@classytic/validation/money";
 //#region src/models/create-model.ts
 /**
 * Injects the tenant field into a schema and (when tenant scoping is enabled
@@ -31,7 +33,7 @@ function injectTenantField(schema, tenant) {
 	schema.add({ [tenant.tenantField]: {
 		type: tenant.fieldType === "objectId" ? mongoose.Schema.Types.ObjectId : String,
 		index: true,
-		...tenant.enabled ? { required: true } : {},
+		...tenant.enabled && tenant.required ? { required: true } : {},
 		...tenant.ref ? { ref: tenant.ref } : {}
 	} });
 	if (!tenant.enabled) return;
@@ -83,7 +85,11 @@ function createEarningRuleSchema() {
 			default: 0
 		},
 		conditions: {
-			minOrderAmount: { type: Number },
+			minOrderAmount: {
+				type: Number,
+				min: 0,
+				validate: mongooseMinorUnits("conditions.minOrderAmount", { nullable: true })
+			},
 			categories: [{ type: String }],
 			tiers: [{ type: String }],
 			actions: [{ type: String }],
@@ -94,8 +100,26 @@ function createEarningRuleSchema() {
 			}
 		},
 		reward: {
-			pointsPerAmount: { type: Number },
-			amountPerPoint: { type: Number },
+			pointsPerAmount: {
+				type: Number,
+				min: 0
+			},
+			rateBasis: {
+				type: Number,
+				min: 1,
+				validate: {
+					validator: (v) => v === null || v === void 0 || Number.isInteger(v),
+					message: "reward.rateBasis must be an integer >= 1 (minor units) — got {VALUE}"
+				}
+			},
+			amountPerPoint: {
+				type: Number,
+				min: 1,
+				validate: {
+					validator: (v) => v === null || v === void 0 || Number.isInteger(v),
+					message: "reward.amountPerPoint must be an integer >= 1 (minor units per point) — got {VALUE}"
+				}
+			},
 			fixedPoints: { type: Number },
 			multiplier: { type: Number },
 			roundingMode: {
@@ -113,6 +137,11 @@ function createEarningRuleSchema() {
 		endsAt: { type: Date },
 		metadata: { type: mongoose.Schema.Types.Mixed }
 	}, { timestamps: true });
+	schema.pre("validate", function() {
+		const pointsPerAmount = this.get("reward.pointsPerAmount");
+		const rateBasis = this.get("reward.rateBasis");
+		if (pointsPerAmount !== null && pointsPerAmount !== void 0 && (rateBasis === null || rateBasis === void 0)) this.invalidate("reward.rateBasis", "reward.rateBasis (integer minor units) is required when reward.pointsPerAmount is set");
+	});
 	schema.index({
 		status: 1,
 		type: 1,
@@ -282,11 +311,18 @@ function createRedemptionSchema() {
 		},
 		discountAmount: {
 			type: Number,
-			required: true
+			required: true,
+			min: 0,
+			validate: mongooseMinorUnits("discountAmount")
 		},
-		conversionRate: {
+		pointValueMinor: {
 			type: Number,
-			required: true
+			required: true,
+			min: 1,
+			validate: {
+				validator: Number.isInteger,
+				message: "pointValueMinor must be an integer >= 1 (minor units per point) — got {VALUE}"
+			}
 		},
 		status: {
 			type: String,
@@ -308,8 +344,16 @@ function createRedemptionSchema() {
 		reversalReason: { type: String },
 		reversalTransactionId: { type: mongoose.Schema.Types.ObjectId },
 		transactionId: { type: mongoose.Schema.Types.ObjectId },
-		initialBalance: { type: Number },
-		remainingBalance: { type: Number },
+		initialBalance: {
+			type: Number,
+			min: 0,
+			validate: mongooseMinorUnits("initialBalance", { nullable: true })
+		},
+		remainingBalance: {
+			type: Number,
+			min: 0,
+			validate: mongooseMinorUnits("remainingBalance", { nullable: true })
+		},
 		approvals: {
 			type: mongoose.Schema.Types.Mixed,
 			default: null
@@ -394,7 +438,11 @@ function createTierDefinitionSchema() {
 		},
 		qualificationCriteria: {
 			minLifetimePoints: { type: Number },
-			minLifetimeSpend: { type: Number },
+			minLifetimeSpend: {
+				type: Number,
+				min: 0,
+				validate: mongooseMinorUnits("qualificationCriteria.minLifetimeSpend", { nullable: true })
+			},
 			evaluationPeriodDays: { type: Number }
 		},
 		benefits: {
@@ -428,13 +476,6 @@ function createTierDefinitionSchema() {
 }
 //#endregion
 //#region src/models/index.ts
-function applyAutoIndex(models, autoIndex) {
-	if (autoIndex === void 0) return;
-	for (const [name, model] of Object.entries(models)) {
-		const value = typeof autoIndex === "boolean" ? autoIndex : autoIndex[name] ?? void 0;
-		if (value !== void 0) model.schema.set("autoIndex", value);
-	}
-}
 /**
 * Default physical collection names (see PACKAGE_RULES.md §20.1). Prefixed
 * when `collectionPrefix` is provided; used verbatim when unset.
@@ -447,61 +488,102 @@ const DEFAULT_COLLECTIONS = {
 	Redemption: "loyalty_redemptions",
 	Referral: "loyalty_referrals"
 };
-const LOYALTY_MODEL_NAMES = [
-	"LoyaltyMember",
-	"LoyaltyPointTransaction",
-	"LoyaltyEarningRule",
-	"LoyaltyTierDefinition",
-	"LoyaltyRedemption",
-	"LoyaltyReferral"
-];
-var LoyaltyModelCollisionError = class extends Error {
-	constructor(name) {
-		super(`[loyalty] Mongoose model "${name}" already exists on this connection. For hot-reload / test fixtures, pass \`forceRecreate: true\` to clobber the existing model. For two loyalty engines, use two Mongoose connections (\`mongoose.createConnection(...)\`) — each has its own model registry.`);
-		this.name = "LoyaltyModelCollisionError";
-	}
+/** The registered Mongoose model names — stable, independent of `collectionPrefix`. */
+const MODEL_NAMES = {
+	Member: "LoyaltyMember",
+	PointTransaction: "LoyaltyPointTransaction",
+	EarningRule: "LoyaltyEarningRule",
+	TierDefinition: "LoyaltyTierDefinition",
+	Redemption: "LoyaltyRedemption",
+	Referral: "LoyaltyReferral"
 };
-function createModels(connection, tenant, indexes, autoIndex, collectionPrefix, forceRecreate) {
-	const memberSchema = createMemberSchema();
-	const pointTransactionSchema = createPointTransactionSchema();
-	const earningRuleSchema = createEarningRuleSchema();
-	const tierDefinitionSchema = createTierDefinitionSchema();
-	const redemptionSchema = createRedemptionSchema();
-	const referralSchema = createReferralSchema();
-	injectTenantField(memberSchema, tenant);
-	injectTenantField(pointTransactionSchema, tenant);
-	injectTenantField(earningRuleSchema, tenant);
-	injectTenantField(tierDefinitionSchema, tenant);
-	injectTenantField(redemptionSchema, tenant);
-	injectTenantField(referralSchema, tenant);
-	if (indexes) {
-		const schemaMap = {
-			member: memberSchema,
-			pointTransaction: pointTransactionSchema,
-			earningRule: earningRuleSchema,
-			tierDefinition: tierDefinitionSchema,
-			redemption: redemptionSchema,
-			referral: referralSchema
-		};
-		for (const [modelName, defs] of Object.entries(indexes)) {
-			const schema = schemaMap[modelName];
-			if (schema && defs) applyUserIndexes(schema, defs, tenant);
-		}
+const ENTITIES = [
+	{
+		key: "Member",
+		modelName: MODEL_NAMES.Member,
+		collection: "Member",
+		indexKey: "member",
+		factory: createMemberSchema
+	},
+	{
+		key: "PointTransaction",
+		modelName: MODEL_NAMES.PointTransaction,
+		collection: "PointTransaction",
+		indexKey: "pointTransaction",
+		factory: createPointTransactionSchema
+	},
+	{
+		key: "EarningRule",
+		modelName: MODEL_NAMES.EarningRule,
+		collection: "EarningRule",
+		indexKey: "earningRule",
+		factory: createEarningRuleSchema
+	},
+	{
+		key: "TierDefinition",
+		modelName: MODEL_NAMES.TierDefinition,
+		collection: "TierDefinition",
+		indexKey: "tierDefinition",
+		factory: createTierDefinitionSchema
+	},
+	{
+		key: "Redemption",
+		modelName: MODEL_NAMES.Redemption,
+		collection: "Redemption",
+		indexKey: "redemption",
+		factory: createRedemptionSchema
+	},
+	{
+		key: "Referral",
+		modelName: MODEL_NAMES.Referral,
+		collection: "Referral",
+		indexKey: "referral",
+		factory: createReferralSchema
 	}
-	if (forceRecreate) {
-		for (const name of LOYALTY_MODEL_NAMES) if (connection.models[name]) connection.deleteModel(name);
-	} else for (const name of LOYALTY_MODEL_NAMES) if (connection.models[name]) throw new LoyaltyModelCollisionError(name);
+];
+/**
+* Describe the loyalty model set as a connection-free mongokit `ModelBlueprint`.
+*
+* Pure — builds no schema and registers nothing until `.bind(connection)`. This is the
+* SINGLE authoritative place the loyalty models are described: tenant-field injection,
+* user indexes, auto-index and collision policy all live here once (PACKAGE_RULES §20/§21).
+* A name collision surfaces as mongokit's typed `ModelCollisionError`.
+*/
+function defineLoyaltyModels(config) {
+	const { tenant, indexes, autoIndex, collectionPrefix, forceRecreate } = config;
 	const prefix = collectionPrefix ?? "";
-	const models = {
-		Member: connection.model("LoyaltyMember", memberSchema, prefix + DEFAULT_COLLECTIONS.Member),
-		PointTransaction: connection.model("LoyaltyPointTransaction", pointTransactionSchema, prefix + DEFAULT_COLLECTIONS.PointTransaction),
-		EarningRule: connection.model("LoyaltyEarningRule", earningRuleSchema, prefix + DEFAULT_COLLECTIONS.EarningRule),
-		TierDefinition: connection.model("LoyaltyTierDefinition", tierDefinitionSchema, prefix + DEFAULT_COLLECTIONS.TierDefinition),
-		Redemption: connection.model("LoyaltyRedemption", redemptionSchema, prefix + DEFAULT_COLLECTIONS.Redemption),
-		Referral: connection.model("LoyaltyReferral", referralSchema, prefix + DEFAULT_COLLECTIONS.Referral)
+	const resolveAutoIndex = (key) => {
+		if (autoIndex === void 0) return void 0;
+		return typeof autoIndex === "boolean" ? autoIndex : autoIndex[key];
 	};
-	applyAutoIndex(models, autoIndex);
-	return models;
+	const existing = forceRecreate ? {
+		mode: "replace",
+		environment: "test"
+	} : { mode: "throw" };
+	return defineModels({
+		models: ENTITIES.map((entity) => ({
+			name: entity.modelName,
+			collection: prefix + DEFAULT_COLLECTIONS[entity.collection],
+			existing,
+			schema: () => {
+				const schema = entity.factory();
+				injectTenantField(schema, tenant);
+				const userIndexes = indexes?.[entity.indexKey];
+				if (userIndexes) applyUserIndexes(schema, userIndexes, tenant);
+				const ai = resolveAutoIndex(entity.key);
+				if (ai !== void 0) schema.set("autoIndex", ai);
+				return schema;
+			}
+		})),
+		assemble: (models) => Object.freeze({
+			Member: models.get(MODEL_NAMES.Member),
+			PointTransaction: models.get(MODEL_NAMES.PointTransaction),
+			EarningRule: models.get(MODEL_NAMES.EarningRule),
+			TierDefinition: models.get(MODEL_NAMES.TierDefinition),
+			Redemption: models.get(MODEL_NAMES.Redemption),
+			Referral: models.get(MODEL_NAMES.Referral)
+		})
+	});
 }
 //#endregion
-export { createModels as n, LoyaltyModelCollisionError as t };
+export { defineLoyaltyModels as t };

package/dist/notifications/index.d.mts

@@ -1,5 +1,4 @@
-import { t as NotificationAdapter } from "../notification.port-CJ9nXj0k.mjs";
-
+import { t as NotificationAdapter } from "../notification.port-wY4IKimz.mjs";
 //#region src/notifications/index.d.ts
 interface NotificationsAdapterConfig {
   service: {

package/dist/repositories/index.d.mts

@@ -1,2 +1,2 @@
-import { a as ReferralRepository, d as MemberRepository, i as TierDefinitionRepository, l as EarningRuleRepository, n as LoyaltyRepositories, r as createRepositories, s as RedemptionRepository, t as CreateRepositoriesInput, u as PointTransactionRepository } from "../index-Dngaj21_.mjs";
+import { a as ReferralRepository, d as MemberRepository, i as TierDefinitionRepository, l as EarningRuleRepository, n as LoyaltyRepositories, r as createRepositories, s as RedemptionRepository, t as CreateRepositoriesInput, u as PointTransactionRepository } from "../index-CR2k7jQ8.mjs";
 export { CreateRepositoriesInput, EarningRuleRepository, LoyaltyRepositories, MemberRepository, PointTransactionRepository, RedemptionRepository, ReferralRepository, TierDefinitionRepository, createRepositories };

package/dist/repositories/index.mjs

@@ -1,2 +1,2 @@
-import { a as PointTransactionRepository, i as RedemptionRepository, l as EarningRuleRepository, n as TierDefinitionRepository, o as MemberRepository, r as ReferralRepository, t as createRepositories } from "../repositories-DEwCbLCh.mjs";
+import { a as PointTransactionRepository, i as RedemptionRepository, l as EarningRuleRepository, n as TierDefinitionRepository, o as MemberRepository, r as ReferralRepository, t as createRepositories } from "../repositories-B676z4bE.mjs";
 export { EarningRuleRepository, MemberRepository, PointTransactionRepository, RedemptionRepository, ReferralRepository, TierDefinitionRepository, createRepositories };