@classytic/loyalty 0.1.0 → 0.2.0

package/dist/models/index.mjs

@@ -1,2 +1,2 @@
-import { t as createModels } from "../models-CrZPmVxt.mjs";
-export { createModels };
+import { n as createModels, t as LoyaltyModelCollisionError } from "../models-uhh9c-7k.mjs";
+export { LoyaltyModelCollisionError, createModels };

package/dist/{models-CrZPmVxt.mjs → models-uhh9c-7k.mjs}

@@ -1,21 +1,44 @@
-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-C75GvizO.mjs";
+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 mongoose from "mongoose";
 //#region src/models/create-model.ts
 /**
-* Injects the tenant field into a schema and prepends it to ALL existing indexes.
+* Injects the tenant field into a schema and (when tenant scoping is enabled
+* at the plugin layer) prepends it to ALL existing indexes.
+*
+* The field itself is added UNCONDITIONALLY — this mirrors the
+* `@classytic/order` convention ("Child repos set `organizationId`
+* explicitly on the doc. So writes work whether the host opts into the
+* auto-wired `multiTenantPlugin` or sets `multiTenant: false` and enforces
+* scoping at its own framework layer"). Arc hosts that scope via preset /
+* `BaseController` need the schema field present so writes persist and
+* filters match; turning off the mongokit plugin wouldn't help them if
+* `organizationId` weren't a known schema path (Mongoose strict mode would
+* strip it).
+*
+* `required: true` is intentionally NOT set — mongokit's
+* `buildCrudSchemasFromModel` would forward it into arc's auto-generated
+* request body JSON Schema and Fastify would reject valid POSTs at
+* preValidation BEFORE arc's `BaseController.create` can inject orgId from
+* scope. Enforcement comes from (a) arc's BaseController writing the field
+* on every create/update and (b) mongokit's `multiTenantPlugin` (when
+* enabled) throwing on missing ctx.
+*
+* Compound-index prefixing IS gated on `enabled`, since that concerns
+* query efficiency and is only relevant when the mongokit-layer plugin
+* scopes queries.
 */
 function injectTenantField(schema, tenant) {
-	if (!tenant.enabled) return;
-	schema.add({ [tenant.field]: {
-		type: tenant.type === "ObjectId" ? mongoose.Schema.Types.ObjectId : String,
-		required: true,
+	schema.add({ [tenant.tenantField]: {
+		type: tenant.fieldType === "objectId" ? mongoose.Schema.Types.ObjectId : String,
 		index: true,
+		...tenant.enabled ? { required: true } : {},
 		...tenant.ref ? { ref: tenant.ref } : {}
 	} });
+	if (!tenant.enabled) return;
 	const existingIndexes = schema._indexes;
 	if (existingIndexes && existingIndexes.length > 0) for (const indexEntry of existingIndexes) {
 		const fields = indexEntry[0];
-		const newFields = { [tenant.field]: 1 };
+		const newFields = { [tenant.tenantField]: 1 };
 		for (const [key, val] of Object.entries(fields)) newFields[key] = val;
 		indexEntry[0] = newFields;
 	}
@@ -26,7 +49,7 @@ function injectTenantField(schema, tenant) {
 function applyUserIndexes(schema, indexes, tenant) {
 	for (const def of indexes) {
 		const fields = tenant.enabled ? {
-			[tenant.field]: 1,
+			[tenant.tenantField]: 1,
 			...def.fields
 		} : { ...def.fields };
 		schema.index(fields, def.options ?? {});
@@ -118,22 +141,16 @@ function createMemberSchema() {
 			enum: MEMBER_STATUSES,
 			default: "active"
 		},
-		cardId: {
-			type: String,
-			unique: true,
-			sparse: true
-		},
-		referralCode: {
-			type: String,
-			unique: true,
-			sparse: true
-		},
+		cardId: { type: String },
+		referralCode: { type: String },
 		tier: {
 			type: String,
 			default: null
 		},
 		tierOverride: { type: String },
 		tierOverrideReason: { type: String },
+		tierOverrideExpiresAt: { type: Date },
+		referredBy: { type: String },
 		tierQualifiedAt: { type: Date },
 		tierExpiresAt: { type: Date },
 		balance: {
@@ -165,6 +182,14 @@ function createMemberSchema() {
 		externalId: 1,
 		externalType: 1
 	}, { unique: true });
+	schema.index({ cardId: 1 }, {
+		unique: true,
+		partialFilterExpression: { cardId: { $type: "string" } }
+	});
+	schema.index({ referralCode: 1 }, {
+		unique: true,
+		partialFilterExpression: { referralCode: { $type: "string" } }
+	});
 	return schema;
 }
 //#endregion
@@ -218,10 +243,7 @@ function createPointTransactionSchema() {
 	});
 	schema.index({ idempotencyKey: 1 }, {
 		unique: true,
-		partialFilterExpression: { idempotencyKey: {
-			$exists: true,
-			$ne: null
-		} }
+		partialFilterExpression: { idempotencyKey: { $type: "string" } }
 	});
 	return schema;
 }
@@ -270,7 +292,12 @@ function createRedemptionSchema() {
 		expiresAt: { type: Date },
 		confirmedAt: { type: Date },
 		releasedAt: { type: Date },
-		transactionId: { type: mongoose.Schema.Types.ObjectId }
+		reversedAt: { type: Date },
+		reversalReason: { type: String },
+		reversalTransactionId: { type: mongoose.Schema.Types.ObjectId },
+		transactionId: { type: mongoose.Schema.Types.ObjectId },
+		initialBalance: { type: Number },
+		remainingBalance: { type: Number }
 	}, { timestamps: true });
 	schema.index({
 		ownerType: 1,
@@ -374,21 +401,52 @@ function createTierDefinitionSchema() {
 }
 //#endregion
 //#region src/models/index.ts
-function createModels(connection, tenant, indexes) {
+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.
+*/
+const DEFAULT_COLLECTIONS = {
+	Member: "loyalty_members",
+	PointTransaction: "loyalty_point_transactions",
+	EarningRule: "loyalty_earning_rules",
+	TierDefinition: "loyalty_tier_definitions",
+	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";
+	}
+};
+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();
-	if (tenant.enabled) {
-		injectTenantField(memberSchema, tenant);
-		injectTenantField(pointTransactionSchema, tenant);
-		injectTenantField(earningRuleSchema, tenant);
-		injectTenantField(tierDefinitionSchema, tenant);
-		injectTenantField(redemptionSchema, tenant);
-		injectTenantField(referralSchema, tenant);
-	}
+	injectTenantField(memberSchema, tenant);
+	injectTenantField(pointTransactionSchema, tenant);
+	injectTenantField(earningRuleSchema, tenant);
+	injectTenantField(tierDefinitionSchema, tenant);
+	injectTenantField(redemptionSchema, tenant);
+	injectTenantField(referralSchema, tenant);
 	if (indexes) {
 		const schemaMap = {
 			member: memberSchema,
@@ -403,15 +461,20 @@ function createModels(connection, tenant, indexes) {
 			if (schema && defs) applyUserIndexes(schema, defs, tenant);
 		}
 	}
-	const model = (name, schema) => connection.models[name] || connection.model(name, schema);
-	return {
-		Member: model("LoyaltyMember", memberSchema),
-		PointTransaction: model("LoyaltyPointTransaction", pointTransactionSchema),
-		EarningRule: model("LoyaltyEarningRule", earningRuleSchema),
-		TierDefinition: model("LoyaltyTierDefinition", tierDefinitionSchema),
-		Redemption: model("LoyaltyRedemption", redemptionSchema),
-		Referral: model("LoyaltyReferral", referralSchema)
+	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);
+	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)
 	};
+	applyAutoIndex(models, autoIndex);
+	return models;
 }
 //#endregion
-export { createModels as t };
+export { createModels as n, LoyaltyModelCollisionError as t };

package/dist/notifications/index.d.mts

@@ -1,4 +1,4 @@
-import { t as NotificationAdapter } from "../notification.port-BzUsH0It.mjs";
+import { t as NotificationAdapter } from "../notification.port-9B5xlzxQ.mjs";
 
 //#region src/notifications/index.d.ts
 interface NotificationsAdapterConfig {

package/dist/repositories/index.d.mts

@@ -1,2 +1,2 @@
-import { a as RedemptionRepository, c as EarningRuleRepository, i as ReferralRepository, n as createRepositories, o as PointTransactionRepository, r as TierDefinitionRepository, s as MemberRepository, t as LoyaltyRepositories } from "../index-BcoGeDco.mjs";
-export { EarningRuleRepository, LoyaltyRepositories, MemberRepository, PointTransactionRepository, RedemptionRepository, ReferralRepository, TierDefinitionRepository, createRepositories };
+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-qI1WvtNg.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, n as TierDefinitionRepository, o as MemberRepository, r as ReferralRepository, s as EarningRuleRepository, t as createRepositories } from "../repositories-qMX7Xh_y.mjs";
+import { a as PointTransactionRepository, i as RedemptionRepository, n as TierDefinitionRepository, o as MemberRepository, r as ReferralRepository, s as EarningRuleRepository, t as createRepositories } from "../repositories-ObGUgcSH.mjs";
 export { EarningRuleRepository, MemberRepository, PointTransactionRepository, RedemptionRepository, ReferralRepository, TierDefinitionRepository, createRepositories };